forgeos 0.1.0-alpha.0

package/src/forge/_generated/appMap.md

@@ -0,0 +1,35 @@
+// @forge-generated generator=0.0.0 input=0f239a86204cc7defecd480434184061126bd738c7c4e908a7fe1cf56725e059 content=39b5a42a6214087649bb1cc5ff26437a6d01243fefef6a28b6233d983cd1e731
+# App Map
+
+## Data
+
+## Commands
+
+## Queries
+
+## Live Queries
+
+## Actions
+
+## Workflows
+
+## Frontend
+
+Present: no
+Framework: none
+
+### Routes
+
+### Components
+
+### Client Bindings
+
+- none
+
+### Runtime Endpoints
+
+- none
+
+### Full-Stack Route Bindings
+
+- none

package/src/forge/_generated/artifactManifest.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=6b855b87f2f57fce3e0939076b81cc0263cccfeae7bb969d2662613867b1c8ee content=677c1cdf8c4c954a56d712b7b354f35b1413ab3b5905985e9701fbf07acd295e
+{"artifacts":[],"diagnostics":[],"releaseId":"forgeos@0.1.0-alpha.0+unknown","schemaVersion":"0.1.0"}

package/src/forge/_generated/artifactManifest.ts

@@ -0,0 +1,7 @@
+// @forge-generated generator=0.0.0 input=6b855b87f2f57fce3e0939076b81cc0263cccfeae7bb969d2662613867b1c8ee content=b05ab478d5c0e02d43ce8b5d647fe0954009346b4bb72f1fd13a47c1bbd44df4
+export const artifactManifest = {
+  "artifacts": [],
+  "diagnostics": [],
+  "releaseId": "forgeos@0.1.0-alpha.0+unknown",
+  "schemaVersion": "0.1.0"
+} as const;

package/src/forge/_generated/authClaims.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=c9bda2f6e9efc218ecd5cf8504fc1115b75c98927021cd1a6a48b49c7df32798
+{"claims":{"email":"email","name":"name","permissions":"permissions","role":"role","roles":"roles","tenantId":"tenant_id","userId":"sub"},"schemaVersion":"0.1.0"}

package/src/forge/_generated/authClaims.ts

@@ -0,0 +1,13 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=de95cece618768716693e2af73b236224507426781ce72787dfd87ce4bf286c2
+export const authClaims = {
+  "claims": {
+    "email": "email",
+    "name": "name",
+    "permissions": "permissions",
+    "role": "role",
+    "roles": "roles",
+    "tenantId": "tenant_id",
+    "userId": "sub"
+  },
+  "schemaVersion": "0.1.0"
+} as const;

package/src/forge/_generated/authConfig.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=7e85a943f955729dbee32461491b254b819595d84ce79d8e56bc522066654bba
+{"algorithmsEnv":"FORGE_AUTH_ALGORITHMS","audienceEnv":"FORGE_AUTH_AUDIENCE","defaultMode":"dev-headers","issuerEnv":"FORGE_AUTH_ISSUER","jwksUriEnv":"FORGE_AUTH_JWKS_URI","modeEnv":"FORGE_AUTH_MODE","modes":["dev-headers","jwt","oidc","disabled"],"requiresTenant":false,"schemaVersion":"0.1.0"}

package/src/forge/_generated/authConfig.ts

@@ -0,0 +1,17 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=ffd5e95a6107ad58380a0a171f1602594eca9c5bef9feb12f9d4568013e3e9d2
+export const authConfig = {
+  "algorithmsEnv": "FORGE_AUTH_ALGORITHMS",
+  "audienceEnv": "FORGE_AUTH_AUDIENCE",
+  "defaultMode": "dev-headers",
+  "issuerEnv": "FORGE_AUTH_ISSUER",
+  "jwksUriEnv": "FORGE_AUTH_JWKS_URI",
+  "modeEnv": "FORGE_AUTH_MODE",
+  "modes": [
+    "dev-headers",
+    "jwt",
+    "oidc",
+    "disabled"
+  ],
+  "requiresTenant": false,
+  "schemaVersion": "0.1.0"
+} as const;

package/src/forge/_generated/authContext.ts

@@ -0,0 +1,23 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=cf170e035d456c3ac698211e5b5a5b65a5743332654a8d5987281c050002cf99
+export type AuthContext =
+  | {
+      kind: "user";
+      userId: string;
+      tenantId?: string;
+      role?: string;
+      roles?: string[];
+      permissions?: string[];
+      email?: string;
+      name?: string;
+      token?: {
+        issuer: string;
+        audience: string | string[];
+        subject: string;
+        expiresAt?: number;
+        issuedAt?: number;
+        authProvider: string;
+      };
+      claims?: Record<string, unknown>;
+    }
+  | { kind: "system"; tenantId?: string; triggeredBy?: AuthContext }
+  | { kind: "anonymous" };

package/src/forge/_generated/authRegistry.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=0b60f773fa78808792114ca707760eaf310233136c684ee57e1df018a24f8d4c
+{"algorithmsEnv":"FORGE_AUTH_ALGORITHMS","audienceEnv":"FORGE_AUTH_AUDIENCE","claims":{"email":"email","name":"name","permissions":"permissions","role":"role","roles":"roles","tenantId":"tenant_id","userId":"sub"},"defaultMode":"dev-headers","issuerEnv":"FORGE_AUTH_ISSUER","jwksUriEnv":"FORGE_AUTH_JWKS_URI","modes":["dev-headers","jwt","oidc","disabled"],"requiresTenant":false,"schemaVersion":"0.1.0"}

package/src/forge/_generated/authRegistry.ts

@@ -0,0 +1,25 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=737febf357ddca0e97368d301087ceced8b4223b213fde817240434825a77b1e
+export const authRegistry = {
+  "algorithmsEnv": "FORGE_AUTH_ALGORITHMS",
+  "audienceEnv": "FORGE_AUTH_AUDIENCE",
+  "claims": {
+    "email": "email",
+    "name": "name",
+    "permissions": "permissions",
+    "role": "role",
+    "roles": "roles",
+    "tenantId": "tenant_id",
+    "userId": "sub"
+  },
+  "defaultMode": "dev-headers",
+  "issuerEnv": "FORGE_AUTH_ISSUER",
+  "jwksUriEnv": "FORGE_AUTH_JWKS_URI",
+  "modes": [
+    "dev-headers",
+    "jwt",
+    "oidc",
+    "disabled"
+  ],
+  "requiresTenant": false,
+  "schemaVersion": "0.1.0"
+} as const;

package/src/forge/_generated/buildInfo.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=045a6cb4b35ff84e44e490cddac563a732ab9b3c9d9e921ed9a1b1d279b62b2b content=0134625164b039e25cc1b1e1a14d2bd5327b1de97619c98b10d0ec2d82535f88
+{"generatedHash":"045a6cb4b35ff84e44e490cddac563a732ab9b3c9d9e921ed9a1b1d279b62b2b","gitSha":"unknown","packageName":"forgeos","packageVersion":"0.1.0-alpha.0","releaseId":"forgeos@0.1.0-alpha.0+unknown","schemaVersion":"0.1.0"}

package/src/forge/_generated/buildInfo.ts

@@ -0,0 +1,9 @@
+// @forge-generated generator=0.0.0 input=045a6cb4b35ff84e44e490cddac563a732ab9b3c9d9e921ed9a1b1d279b62b2b content=45d5d62ebcb24ac585a17009fc267ac74861661bf038751bb0ce208b6b97e504
+export const buildInfo = {
+  "generatedHash": "045a6cb4b35ff84e44e490cddac563a732ab9b3c9d9e921ed9a1b1d279b62b2b",
+  "gitSha": "unknown",
+  "packageName": "forgeos",
+  "packageVersion": "0.1.0-alpha.0",
+  "releaseId": "forgeos@0.1.0-alpha.0+unknown",
+  "schemaVersion": "0.1.0"
+} as const;

package/src/forge/_generated/capabilityMap.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=6b855b87f2f57fce3e0939076b81cc0263cccfeae7bb969d2662613867b1c8ee content=2efc90b09bab5763aed2f2a81c93ef0a552d5f35dd56b50a721749bb1e43bac5
+{"diagnostics":[],"entries":[],"generatorVersion":"0.0.0","project":{"name":"forgeos","type":"forgeos-app"},"schemaVersion":"0.1.0","summary":{"backendOnly":0,"covered":0,"frontendOnly":0,"warnings":0}}

package/src/forge/_generated/capabilityMap.md

@@ -0,0 +1,15 @@
+// @forge-generated generator=0.0.0 input=6b855b87f2f57fce3e0939076b81cc0263cccfeae7bb969d2662613867b1c8ee content=b43b8f016935ebd1e3e8eb40b01ae80c052ab5907ece3edfca511372c7f0bd60
+# Capability Map
+
+Project: forgeos
+
+## Summary
+
+- Covered: 0
+- Backend-only: 0
+- Frontend-only: 0
+- Warnings: 0
+
+## Capabilities
+
+- none

package/src/forge/_generated/capabilityMap.ts

@@ -0,0 +1,17 @@
+// @forge-generated generator=0.0.0 input=6b855b87f2f57fce3e0939076b81cc0263cccfeae7bb969d2662613867b1c8ee content=0692cb62856b7b541f171470693fa652dabb9821396dacc2edf9be0a08791edc
+export const capabilityMap = {
+  "diagnostics": [],
+  "entries": [],
+  "generatorVersion": "0.0.0",
+  "project": {
+    "name": "forgeos",
+    "type": "forgeos-app"
+  },
+  "schemaVersion": "0.1.0",
+  "summary": {
+    "backendOnly": 0,
+    "covered": 0,
+    "frontendOnly": 0,
+    "warnings": 0
+  }
+} as const;

package/src/forge/_generated/client.ts

@@ -0,0 +1,282 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=9b27e66a63e6abbf0c65ca5d8c1d64c7992fc7249842a9174b97b4a99c72a4bd
+import { api } from "./api.ts";
+import type {
+  ForgeAuthProvider,
+  ForgeClient,
+  ForgeClientConfig,
+  LiveQueryOptions,
+  LiveSnapshot,
+} from "./clientTypes.ts";
+import { ForgeError } from "./clientTypes.ts";
+
+export { api };
+export { ForgeError } from "./clientTypes.ts";
+export type {
+  ForgeAuthProvider,
+  ForgeClient,
+  ForgeClientConfig,
+  ForgeStaticAuth,
+  QueryName,
+  CommandName,
+  LiveQueryName,
+  ForgeResolvedAuth,
+  LiveQueryOptions,
+  LiveSnapshot,
+  Unsubscribe,
+} from "./clientTypes.ts";
+
+async function resolveAuthHeaders(
+  auth?: ForgeAuthProvider,
+): Promise<Record<string, string>> {
+  if (!auth) {
+    return {};
+  }
+
+  const resolved = typeof auth === "function" ? await auth() : auth;
+  const authRecord = resolved as Record<string, unknown>;
+  const headers: Record<string, string> = {
+    ...(resolved.headers ?? {}),
+  };
+
+  const token =
+    typeof resolved.getToken === "function"
+      ? await resolved.getToken()
+      : resolved.token;
+  if (typeof token === "string" && token.length > 0) {
+    headers.authorization = `Bearer ${token}`;
+  }
+
+  for (const [key, value] of Object.entries(authRecord)) {
+    if (
+      typeof value === "string" &&
+      key !== "userId" &&
+      key !== "tenantId" &&
+      key !== "role" &&
+      key !== "token"
+    ) {
+      headers[key] = value;
+    }
+  }
+
+  if (resolved.userId) {
+    headers["x-forge-user-id"] = resolved.userId;
+  }
+  if (resolved.tenantId) {
+    headers["x-forge-tenant-id"] = resolved.tenantId;
+  }
+  if (resolved.role) {
+    headers["x-forge-role"] = resolved.role;
+  }
+
+  return headers;
+}
+
+function toForgeError(error: unknown, code: string): ForgeError {
+  if (error instanceof ForgeError) {
+    return error;
+  }
+  return new ForgeError(error instanceof Error ? error.message : String(error), {
+    code,
+  });
+}
+
+function parseJsonPayload(body: unknown): {
+  ok?: boolean;
+  result?: unknown;
+  traceId?: string;
+  error?: { code: string; message: string; details?: unknown };
+  diagnostics?: { code: string; message: string }[];
+} {
+  return body as {
+    ok?: boolean;
+    result?: unknown;
+    traceId?: string;
+    error?: { code: string; message: string; details?: unknown };
+    diagnostics?: { code: string; message: string }[];
+  };
+}
+
+class ForgeHttpClient implements ForgeClient {
+  lastTraceId?: string;
+
+  constructor(private readonly config: ForgeClientConfig) {}
+
+  query(name: string, args: unknown): Promise<unknown> {
+    return this.invoke("queries", name, args);
+  }
+
+  command(name: string, args: unknown): Promise<unknown> {
+    return this.invoke("commands", name, args);
+  }
+
+  liveQuery(
+    name: string,
+    args: unknown,
+    onSnapshot: (snapshot: LiveSnapshot<unknown>) => void,
+    onError?: (error: ForgeError) => void,
+    options?: LiveQueryOptions,
+  ) {
+    const controller = new AbortController();
+    const externalSignal = options?.signal;
+    const abort = () => controller.abort();
+    externalSignal?.addEventListener("abort", abort, { once: true });
+
+    void this.openLiveQuery(name, args, onSnapshot, onError, controller.signal)
+      .catch((error) => {
+        if (controller.signal.aborted) {
+          return;
+        }
+        onError?.(
+          toForgeError(error, "FORGE_LIVEQUERY_SUBSCRIPTION_FAILED"),
+        );
+      })
+      .finally(() => externalSignal?.removeEventListener("abort", abort));
+
+    return () => controller.abort();
+  }
+
+  private async invoke(
+    kind: "queries" | "commands",
+    name: string,
+    args: unknown,
+  ): Promise<unknown> {
+    const baseUrl = this.config.url.replace(/\/$/, "");
+    const url = `${baseUrl}/${kind}/${encodeURIComponent(name)}`;
+    const authHeaders = await resolveAuthHeaders(this.config.auth);
+
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...authHeaders,
+      },
+      body: JSON.stringify({ args }),
+    });
+
+    let body: unknown;
+    try {
+      body = await response.json();
+    } catch {
+      throw new ForgeError(`HTTP ${response.status}`, {
+        code: "FORGE_HTTP_ERROR",
+        status: response.status,
+      });
+    }
+
+    const payload = parseJsonPayload(body);
+    this.lastTraceId = payload.traceId;
+
+    if (!response.ok || payload.ok === false) {
+      const diagnostic = payload.diagnostics?.find((entry) => entry.code);
+      const code =
+        payload.error?.code ?? diagnostic?.code ?? "FORGE_REQUEST_FAILED";
+      const message =
+        payload.error?.message ??
+        diagnostic?.message ??
+        `Request failed with status ${response.status}`;
+      throw new ForgeError(message, {
+        code,
+        traceId: payload.traceId,
+        status: response.status,
+        details: payload.error?.details ?? payload.diagnostics,
+      });
+    }
+
+    return payload.result;
+  }
+
+  private async openLiveQuery(
+    name: string,
+    args: unknown,
+    onSnapshot: (snapshot: LiveSnapshot<unknown>) => void,
+    onError: ((error: ForgeError) => void) | undefined,
+    signal: AbortSignal,
+  ): Promise<void> {
+    const baseUrl = this.config.url.replace(/\/$/, "");
+    const encodedArgs = encodeURIComponent(JSON.stringify(args ?? {}));
+    const url = `${baseUrl}/live/${encodeURIComponent(name)}?args=${encodedArgs}`;
+    const authHeaders = await resolveAuthHeaders(this.config.auth);
+
+    const response = await fetch(url, {
+      method: "GET",
+      headers: authHeaders,
+      signal,
+    });
+
+    if (!response.ok || !response.body) {
+      throw new ForgeError(`Live query failed with status ${response.status}`, {
+        code: "FORGE_LIVEQUERY_SUBSCRIPTION_FAILED",
+        status: response.status,
+      });
+    }
+
+    const decoder = new TextDecoder();
+    const reader = response.body.getReader();
+    let buffer = "";
+
+    while (!signal.aborted) {
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      buffer += decoder.decode(value, { stream: true });
+      let boundary = buffer.indexOf("\n\n");
+      while (boundary !== -1) {
+        const frame = buffer.slice(0, boundary);
+        buffer = buffer.slice(boundary + 2);
+        this.handleSseFrame(frame, onSnapshot, onError);
+        boundary = buffer.indexOf("\n\n");
+      }
+    }
+  }
+
+  private handleSseFrame(
+    frame: string,
+    onSnapshot: (snapshot: LiveSnapshot<unknown>) => void,
+    onError?: (error: ForgeError) => void,
+  ): void {
+    const lines = frame.split(/\r?\n/);
+    const event = lines.find((line) => line.startsWith("event:"))?.slice(6).trim();
+    const data = lines
+      .filter((line) => line.startsWith("data:"))
+      .map((line) => line.slice(5).trimStart())
+      .join("\n");
+    if (!data) {
+      return;
+    }
+
+    const payload = JSON.parse(data) as {
+      type?: string;
+      subscriptionId?: string;
+      revision?: number;
+      data?: unknown;
+      traceId?: string;
+      error?: { code: string; message: string; traceId?: string };
+    };
+
+    if (event === "snapshot" || payload.type === "snapshot") {
+      this.lastTraceId = payload.traceId;
+      onSnapshot({
+        subscriptionId: String(payload.subscriptionId),
+        revision: Number(payload.revision),
+        data: payload.data,
+        traceId: payload.traceId,
+      });
+      return;
+    }
+
+    if (event === "error" || payload.type === "error") {
+      onError?.(
+        new ForgeError(payload.error?.message ?? "liveQuery failed", {
+          code: payload.error?.code ?? "FORGE_LIVEQUERY_SUBSCRIPTION_FAILED",
+          traceId: payload.error?.traceId,
+          details: payload.error,
+        }),
+      );
+    }
+  }
+}
+
+export function createForgeClient(config: ForgeClientConfig): ForgeClient {
+  return new ForgeHttpClient(config);
+}

package/src/forge/_generated/clientApi.ts

@@ -0,0 +1,9 @@
+// @forge-generated generator=0.0.0 input=8f74d80244f472bdbd28e32d310c3754a3301ecc0276cb8fb06d23335cf21d46 content=d331e860feeb8e9f3bcdcf45c3ff0ab2ebcd41bb96fbf204bb83dc7fcfda1ab3
+import { api } from "./api.ts";
+
+/** Client-side typed API surface (queries, commands; no server adapters). */
+export const clientApi = {
+  queries: api.queries,
+  commands: api.commands,
+  liveQueries: api.liveQueries,
+} as const;

package/src/forge/_generated/clientManifest.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=eb8d78e749f083957f69f7f316aa4efc3faf5ccd81ff63e3cf32bf7fb7f705ac content=7da423246720e2e4972289e827c48cb434df99762d79a6a35a95797cc7cbfed7
+{"commands":[],"excluded":{"actions":[],"serverAdapters":["ai.anthropic.server.ts","ai.gateway.server.ts","ai.openai.server.ts"],"serverPackages":["@ai-sdk/anthropic","@ai-sdk/openai","ai"],"workflows":[]},"generatorVersion":"0.0.0","inputHash":"569f9f5c780d0d433f502c0b0168b39b23b6f5ad64e1ac3345ea975bbf94940a","liveQueries":[],"queries":[],"react":{"entrypoint":"src/forge/_generated/react.ts","hooks":["ForgeProvider","useForgeClient","useAuth","useQuery","useCommand","useLiveQuery"]},"schemaVersion":"1.0.0","transport":{"commands":"POST /commands/:name","liveQueries":"GET /live/:name","queries":"POST /queries/:name"}}

package/src/forge/_generated/clientManifest.ts

@@ -0,0 +1,39 @@
+// @forge-generated generator=0.0.0 input=eb8d78e749f083957f69f7f316aa4efc3faf5ccd81ff63e3cf32bf7fb7f705ac content=4227699863c769957be3c9f14c10825a5760ba56ee713dacdfbc3c4e14c6f3a0
+export const clientManifest = {
+  "schemaVersion": "1.0.0",
+  "generatorVersion": "0.0.0",
+  "inputHash": "569f9f5c780d0d433f502c0b0168b39b23b6f5ad64e1ac3345ea975bbf94940a",
+  "queries": [],
+  "commands": [],
+  "liveQueries": [],
+  "transport": {
+    "queries": "POST /queries/:name",
+    "commands": "POST /commands/:name",
+    "liveQueries": "GET /live/:name"
+  },
+  "react": {
+    "entrypoint": "src/forge/_generated/react.ts",
+    "hooks": [
+      "ForgeProvider",
+      "useForgeClient",
+      "useAuth",
+      "useQuery",
+      "useCommand",
+      "useLiveQuery"
+    ]
+  },
+  "excluded": {
+    "actions": [],
+    "workflows": [],
+    "serverAdapters": [
+      "ai.anthropic.server.ts",
+      "ai.gateway.server.ts",
+      "ai.openai.server.ts"
+    ],
+    "serverPackages": [
+      "@ai-sdk/anthropic",
+      "@ai-sdk/openai",
+      "ai"
+    ]
+  }
+} as const;

package/src/forge/_generated/clientTypes.ts

@@ -0,0 +1,78 @@
+// @forge-generated generator=0.0.0 input=7171fcf9ca7de84a957a459b54022eb79e88a37d5572ddc6f5c425365f9b334d content=39ad42ec98ed7aebc56e061aa399738c1175f0a7b4261b5bf2df70eb59afcfe2
+export type ForgeStaticAuth = {
+  userId?: string;
+  tenantId?: string;
+  role?: string;
+  token?: string;
+  getToken?: () => string | Promise<string>;
+  headers?: Record<string, string>;
+  [key: string]: unknown;
+};
+
+export type ForgeResolvedAuth = {
+  userId?: string;
+  tenantId?: string;
+  role?: string;
+  token?: string;
+  getToken?: () => string | Promise<string>;
+  headers?: Record<string, string>;
+  [key: string]: unknown;
+};
+
+export type ForgeAuthProvider =
+  | ForgeResolvedAuth
+  | (() => Promise<ForgeResolvedAuth>);
+
+export type ForgeClientConfig = {
+  url: string;
+  auth?: ForgeAuthProvider;
+};
+
+export class ForgeError extends Error {
+  code: string;
+  traceId?: string;
+  status?: number;
+  details?: unknown;
+
+  constructor(
+    message: string,
+    options: { code: string; traceId?: string; status?: number; details?: unknown },
+  ) {
+    super(message);
+    this.name = "ForgeError";
+    this.code = options.code;
+    this.traceId = options.traceId;
+    this.status = options.status;
+    this.details = options.details;
+  }
+}
+
+export type QueryName = keyof typeof import("./api.ts").api.queries;
+export type CommandName = keyof typeof import("./api.ts").api.commands;
+export type LiveQueryName = keyof typeof import("./api.ts").api.liveQueries;
+
+export type LiveSnapshot<T> = {
+  subscriptionId: string;
+  revision: number;
+  data: T;
+  traceId?: string;
+};
+
+export type LiveQueryOptions = {
+  signal?: AbortSignal;
+};
+
+export type Unsubscribe = () => void;
+
+export type ForgeClient = {
+  readonly lastTraceId?: string;
+  query<Name extends QueryName>(name: Name, args: unknown): Promise<unknown>;
+  command<Name extends CommandName>(name: Name, args: unknown): Promise<unknown>;
+  liveQuery<Name extends LiveQueryName>(
+    name: Name,
+    args: unknown,
+    onSnapshot: (snapshot: LiveSnapshot<unknown>) => void,
+    onError?: (error: ForgeError) => void,
+    options?: LiveQueryOptions,
+  ): Unsubscribe;
+};

package/src/forge/_generated/configRegistry.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=a364a2ec435f1ad252c1d418c40d3d787ffd94db8ab078dc670d129e1ab2d4fd content=48ddd915b14870e3230c517f0d28dfa3bf01e62ce885807bf4b66172c4378ad5
+{"configs":[]}

package/src/forge/_generated/configRegistry.ts

@@ -0,0 +1,4 @@
+// @forge-generated generator=0.0.0 input=a364a2ec435f1ad252c1d418c40d3d787ffd94db8ab078dc670d129e1ab2d4fd content=c67952f1bae9aeedf0c0188f162d06dfb747b265c3c6ee7fdb1ef75782e76f3b
+export const configRegistry = {
+  "configs": []
+} as const;

package/src/forge/_generated/dataGraph.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=eb8d78e749f083957f69f7f316aa4efc3faf5ccd81ff63e3cf32bf7fb7f705ac content=fc0d281603e828838682d235c18fa761b58267e7d0138a6ef7f39b8698249f30
+{"analyzerVersion":"0.1.0","generatorVersion":"0.0.0","inputHash":"dd356f5b886d56bc39e3633c018d348746ab64c4d5e7778b0ba47687e421f568","schemaVersion":"1.0.0","tables":[]}

package/src/forge/_generated/dataGraph.ts

@@ -0,0 +1,8 @@
+// @forge-generated generator=0.0.0 input=eb8d78e749f083957f69f7f316aa4efc3faf5ccd81ff63e3cf32bf7fb7f705ac content=b09c0eb4548cab06eeb136aa02f74dba18a1cdd685cdb7c84405ca907d33c1bf
+export const dataGraph = {
+  "analyzerVersion": "0.1.0",
+  "generatorVersion": "0.0.0",
+  "inputHash": "dd356f5b886d56bc39e3633c018d348746ab64c4d5e7778b0ba47687e421f568",
+  "schemaVersion": "1.0.0",
+  "tables": []
+} as const;

package/src/forge/_generated/db.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=a364a2ec435f1ad252c1d418c40d3d787ffd94db8ab078dc670d129e1ab2d4fd content=15ac2222f939e36b4d437bd5e54aa65ec9c2027a53825883f8a4b9e2710d65d3
+{"tableMap":{}}

package/src/forge/_generated/db.ts

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=a364a2ec435f1ad252c1d418c40d3d787ffd94db8ab078dc670d129e1ab2d4fd content=34af9d0c4498776568d3d0171658539c0a25ebe08af51c34526617eb944fe106
+export const tableMap = {} as const;

package/src/forge/_generated/dbSecurityManifest.json

@@ -0,0 +1,2 @@
+// @forge-generated generator=0.0.0 input=f11e57b5e60f8dd644c175522378a3f5b708201af219373e6a6bc8c32e87aaac content=2990ae1c7d12671f2204605202c9e7d982b0156793644525ae0f7df2c0e18f6e
+{"authoritativeAdapters":["postgres"],"diagnostics":[],"nonAuthoritativeAdapters":["pglite","memory"],"provider":"postgres","schemaVersion":"0.1.0","tables":[],"tenantIsolation":"postgres-rls"}

package/src/forge/_generated/dbSecurityManifest.ts

@@ -0,0 +1,15 @@
+// @forge-generated generator=0.0.0 input=f11e57b5e60f8dd644c175522378a3f5b708201af219373e6a6bc8c32e87aaac content=7c04c09131fcff86b3da6eae92a195c39c0bb2c0be618f597422f7a38dda024c
+export const dbSecurityManifest = {
+  "authoritativeAdapters": [
+    "postgres"
+  ],
+  "diagnostics": [],
+  "nonAuthoritativeAdapters": [
+    "pglite",
+    "memory"
+  ],
+  "provider": "postgres",
+  "schemaVersion": "0.1.0",
+  "tables": [],
+  "tenantIsolation": "postgres-rls"
+} as const;