Published Sites and hosted frontends

npm install @arg/sdk

import { arg } from "@arg/sdk";

await arg.ready;
const viewer = await arg.auth.principal();
const settings = await arg.fs.readJSON("./settings.json");

try {
  await arg.ready;
} catch (error) {
  if (error.code === "bridge_unavailable") showSignedOut();
  else throw error;
}

import { createHostedClient } from "@arg/sdk/hosted";

const arg = await createHostedClient({ endpoint: "/api/arg-sdk" });
const principal = await arg.auth.principal();

import { createGateway } from "@arg/sdk/gateway";
import { createServerTransport } from "@arg/sdk/server";

export const handleSdk = createGateway({
  origin: "https://app.example.com",
  path: "/api/arg-sdk",
  async authenticate(request) {
    const session = await sessions.fromCookie(request); // your own session store
    if (!session || session.revoked) return null;
    return {
      transport: createServerTransport({
        workspaceId: session.workspaceId,
        auth: { kind: "api-key", key: keyFor(session) },
      }),
      operations: ["auth.principal", "fs.read", "fs.readJSON", "fs.list", "actions.run"],
      authorize: ({ operation, args }) =>
        operation !== "actions.run" || ALLOWED_ACTIONS.has(String(args[0])),
    };
  },
});