jazz-tools 2.0.0-alpha.1 → 2.0.0-alpha.10

package/bin/jazz-tools.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { accessSync, chmodSync, constants, existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const BINARIES = {
@@ -18,6 +18,65 @@ function fail(message) {
   process.exit(1);
 }
 
+function ensureExecutable(binaryPath, name) {
+  if (process.platform === "win32") {
+    return;
+  }
+
+  try {
+    accessSync(binaryPath, constants.X_OK);
+    return;
+  } catch {}
+
+  try {
+    chmodSync(binaryPath, 0o755);
+  } catch (error) {
+    const details = error instanceof Error ? error.message : String(error);
+    fail(`Bundled binary ${name} is not executable and chmod failed: ${details}`);
+  }
+
+  try {
+    accessSync(binaryPath, constants.X_OK);
+  } catch {
+    fail(`Bundled binary ${name} is not executable after chmod.`);
+  }
+}
+
+function parseSchemaDir(args) {
+  let schemaDir = "./schema";
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--schema-dir" && args[i + 1]) {
+      schemaDir = args[++i];
+      continue;
+    }
+
+    const prefix = "--schema-dir=";
+    if (arg.startsWith(prefix)) {
+      schemaDir = arg.slice(prefix.length);
+    }
+  }
+
+  return schemaDir;
+}
+
+function exitWithSpawnResult(result, name) {
+  if (result.error) {
+    fail(`Failed to execute ${name}: ${result.error.message}`);
+  }
+
+  if (typeof result.status === "number") {
+    process.exit(result.status);
+  }
+
+  if (result.signal) {
+    process.kill(process.pid, result.signal);
+  }
+
+  process.exit(1);
+}
+
 const key = `${process.platform}-${process.arch}`;
 const binaryName = BINARIES[key];
 const here = dirname(fileURLToPath(import.meta.url));
@@ -47,21 +106,33 @@ if (!binaryPath) {
   fail(lines.join("\n"));
 }
 
-const result = spawnSync(binaryPath, process.argv.slice(2), {
-  stdio: "inherit",
-  env: process.env,
-});
+ensureExecutable(binaryPath, binaryName ?? localBinaryName);
 
-if (result.error) {
-  fail(`Failed to execute ${binaryName}: ${result.error.message}`);
-}
+const args = process.argv.slice(2);
+const command = args[0];
 
-if (typeof result.status === "number") {
-  process.exit(result.status);
-}
+if (command === "build") {
+  const schemaDirArg = parseSchemaDir(args.slice(1));
+  const schemaDir = resolve(process.cwd(), schemaDirArg);
+  const currentSqlPath = join(schemaDir, "current.sql");
+  const currentTsPath = join(schemaDir, "current.ts");
+  const tsCliPath = join(here, "..", "dist", "cli.js");
 
-if (result.signal) {
-  process.kill(process.pid, result.signal);
+  if (!existsSync(currentSqlPath) && existsSync(currentTsPath) && existsSync(tsCliPath)) {
+    console.log(
+      `Detected ${schemaDirArg}/current.ts without current.sql. Running TypeScript schema build bootstrap.`,
+    );
+    const tsBuildResult = spawnSync(
+      process.execPath,
+      [tsCliPath, "build", "--schema-dir", schemaDirArg, "--jazz-bin", binaryPath],
+      {
+        stdio: "inherit",
+        env: process.env,
+      },
+    );
+    exitWithSpawnResult(tsBuildResult, "TypeScript schema build");
+  }
 }
 
-process.exit(1);
+const result = spawnSync(binaryPath, args, { stdio: "inherit", env: process.env });
+exitWithSpawnResult(result, binaryName ?? binaryPath);

package/dist/backend/create-jazz-context.d.ts

@@ -0,0 +1,57 @@
+import type { WasmSchema } from "../drivers/types.js";
+import { JazzClient, type RequestLike, type SessionClient } from "../runtime/client.js";
+import type { AppContext, Session } from "../runtime/context.js";
+export interface BackendSchemaSource {
+    wasmSchema: WasmSchema;
+}
+export interface BackendQuerySchemaSource {
+    _schema: WasmSchema;
+}
+export type BackendSchemaInput = WasmSchema | BackendSchemaSource | BackendQuerySchemaSource;
+export interface BackendContextConfig extends Omit<AppContext, "schema" | "driver" | "clientId" | "tier"> {
+    /** Path to the SurrealKV file used by the server runtime. */
+    dataPath: string;
+    /** Optional default schema source (typically generated `app` export). */
+    app?: BackendSchemaSource;
+    /** Optional persistence tier for ack semantics. */
+    tier?: "worker" | "edge" | "core";
+}
+/**
+ * Server-side Jazz context with lazy runtime setup.
+ *
+ * The first call to `client()`, `forRequest()`, or `forSession()` initializes
+ * a NAPI runtime and JazzClient using the provided app/schema source. Later
+ * calls reuse the same initialized runtime.
+ */
+export declare class JazzContext {
+    private readonly config;
+    private readonly defaultSchemaInput?;
+    private initializedSchemaJson?;
+    private runtime?;
+    private clientInstance?;
+    constructor(config: BackendContextConfig);
+    private resolveSchema;
+    private createClient;
+    /**
+     * Get the shared Jazz client, lazily creating it on first access.
+     */
+    client(source?: BackendSchemaInput): JazzClient;
+    /**
+     * Build a requester-scoped client from an authenticated request.
+     */
+    forRequest(request: RequestLike, source?: BackendSchemaInput): SessionClient;
+    /**
+     * Build a session-scoped client for server-side impersonation flows.
+     */
+    forSession(session: Session, source?: BackendSchemaInput): SessionClient;
+    /**
+     * Flush the underlying runtime if initialized.
+     */
+    flush(): void;
+    /**
+     * Shutdown the context and release runtime resources.
+     */
+    shutdown(): Promise<void>;
+}
+export declare function createJazzContext(config: BackendContextConfig): JazzContext;
+//# sourceMappingURL=create-jazz-context.d.ts.map

package/dist/backend/create-jazz-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-jazz-context.d.ts","sourceRoot":"","sources":["../../src/backend/create-jazz-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGjE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAE7F,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,UAAU,EACV,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAC1C;IACC,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,mDAAmD;IACnD,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CACnC;AAwCD;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAqB;IACzD,OAAO,CAAC,qBAAqB,CAAC,CAAS;IACvC,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAa;gBAExB,MAAM,EAAE,oBAAoB;IAKxC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAgCpB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,UAAU;IAiB/C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,aAAa;IAI5E;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,aAAa;IAIxE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAWhC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,WAAW,CAE3E"}

package/dist/backend/create-jazz-context.js

@@ -0,0 +1,122 @@
+import { NapiRuntime } from "jazz-napi";
+import { serializeRuntimeSchema } from "../drivers/schema-wire.js";
+import { JazzClient } from "../runtime/client.js";
+import { resolveLocalAuthDefaults } from "../runtime/local-auth.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isTableSchema(value) {
+    return isRecord(value) && Array.isArray(value.columns);
+}
+function isWasmSchema(value) {
+    return (isRecord(value) &&
+        !("_schema" in value) &&
+        !("wasmSchema" in value) &&
+        Object.values(value).every((table) => isTableSchema(table)));
+}
+function resolveSchema(input) {
+    if (isWasmSchema(input)) {
+        return input;
+    }
+    if (isRecord(input) && "_schema" in input && isWasmSchema(input._schema)) {
+        return input._schema;
+    }
+    if (isRecord(input) && "wasmSchema" in input && isWasmSchema(input.wasmSchema)) {
+        return input.wasmSchema;
+    }
+    throw new Error("Invalid schema source. Pass a WasmSchema, a generated app object, or a generated query/table object.");
+}
+/**
+ * Server-side Jazz context with lazy runtime setup.
+ *
+ * The first call to `client()`, `forRequest()`, or `forSession()` initializes
+ * a NAPI runtime and JazzClient using the provided app/schema source. Later
+ * calls reuse the same initialized runtime.
+ */
+export class JazzContext {
+    config;
+    defaultSchemaInput;
+    initializedSchemaJson;
+    runtime;
+    clientInstance;
+    constructor(config) {
+        this.config = resolveLocalAuthDefaults(config);
+        this.defaultSchemaInput = config.app;
+    }
+    resolveSchema(source) {
+        const selected = source ?? this.defaultSchemaInput;
+        if (!selected) {
+            throw new Error("No schema source provided. Pass `app` to createJazzContext or provide a schema source when calling client()/forRequest()/forSession().");
+        }
+        return resolveSchema(selected);
+    }
+    createClient(schema) {
+        const schemaJson = serializeRuntimeSchema(schema);
+        this.initializedSchemaJson = schemaJson;
+        this.runtime = new NapiRuntime(schemaJson, this.config.appId, this.config.env ?? "dev", this.config.userBranch ?? "main", this.config.dataPath, this.config.tier);
+        const context = {
+            appId: this.config.appId,
+            schema,
+            serverUrl: this.config.serverUrl,
+            serverPathPrefix: this.config.serverPathPrefix,
+            env: this.config.env,
+            userBranch: this.config.userBranch,
+            jwtToken: this.config.jwtToken,
+            localAuthMode: this.config.localAuthMode,
+            localAuthToken: this.config.localAuthToken,
+            backendSecret: this.config.backendSecret,
+            adminSecret: this.config.adminSecret,
+            tier: this.config.tier,
+        };
+        this.clientInstance = JazzClient.connectWithRuntime(this.runtime, context);
+        return this.clientInstance;
+    }
+    /**
+     * Get the shared Jazz client, lazily creating it on first access.
+     */
+    client(source) {
+        const schema = this.resolveSchema(source);
+        const schemaJson = serializeRuntimeSchema(schema);
+        if (!this.clientInstance) {
+            return this.createClient(schema);
+        }
+        if (this.initializedSchemaJson !== schemaJson) {
+            throw new Error("JazzContext is already initialized with a different schema. Create a separate context for each schema/app.");
+        }
+        return this.clientInstance;
+    }
+    /**
+     * Build a requester-scoped client from an authenticated request.
+     */
+    forRequest(request, source) {
+        return this.client(source).forRequest(request);
+    }
+    /**
+     * Build a session-scoped client for server-side impersonation flows.
+     */
+    forSession(session, source) {
+        return this.client(source).forSession(session);
+    }
+    /**
+     * Flush the underlying runtime if initialized.
+     */
+    flush() {
+        this.runtime?.flush();
+    }
+    /**
+     * Shutdown the context and release runtime resources.
+     */
+    async shutdown() {
+        const client = this.clientInstance;
+        this.clientInstance = undefined;
+        this.runtime = undefined;
+        this.initializedSchemaJson = undefined;
+        if (client) {
+            await client.shutdown();
+        }
+    }
+}
+export function createJazzContext(config) {
+    return new JazzContext(config);
+}
+//# sourceMappingURL=create-jazz-context.js.map

package/dist/backend/create-jazz-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-jazz-context.js","sourceRoot":"","sources":["../../src/backend/create-jazz-context.ts"],"names":[],"mappings":"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"}

package/dist/backend/create-jazz-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-jazz-context.test.d.ts.map

package/dist/backend/create-jazz-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-jazz-context.test.d.ts","sourceRoot":"","sources":["../../src/backend/create-jazz-context.test.ts"],"names":[],"mappings":""}

package/dist/backend/create-jazz-context.test.js

@@ -0,0 +1,141 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { serializeRuntimeSchema } from "../drivers/schema-wire.js";
+import { createJazzContext } from "./create-jazz-context.js";
+const mocks = vi.hoisted(() => {
+    const resolveLocalAuthDefaults = vi.fn();
+    const runtimeCtor = vi.fn();
+    const runtimeInstances = [];
+    const clients = [];
+    const connectWithRuntime = vi.fn((_runtime, _context) => {
+        const client = {
+            forRequest: vi.fn(() => ({ kind: "request-client" })),
+            forSession: vi.fn(() => ({ kind: "session-client" })),
+            shutdown: vi.fn(async () => undefined),
+        };
+        clients.push(client);
+        return client;
+    });
+    class MockNapiRuntime {
+        flush = vi.fn();
+        constructor(schemaJson, appId, env, userBranch, dataPath, tier) {
+            runtimeCtor(schemaJson, appId, env, userBranch, dataPath, tier);
+            runtimeInstances.push(this);
+        }
+    }
+    class MockJazzClient {
+        static connectWithRuntime = connectWithRuntime;
+    }
+    return {
+        MockNapiRuntime,
+        MockJazzClient,
+        resolveLocalAuthDefaults,
+        runtimeCtor,
+        runtimeInstances,
+        connectWithRuntime,
+        clients,
+        reset() {
+            resolveLocalAuthDefaults.mockReset();
+            runtimeCtor.mockReset();
+            runtimeInstances.length = 0;
+            connectWithRuntime.mockClear();
+            clients.length = 0;
+        },
+    };
+});
+vi.mock("jazz-napi", () => ({
+    NapiRuntime: mocks.MockNapiRuntime,
+}));
+vi.mock("../runtime/client.js", async () => {
+    const actual = await vi.importActual("../runtime/client.js");
+    return {
+        ...actual,
+        JazzClient: mocks.MockJazzClient,
+    };
+});
+vi.mock("../runtime/local-auth.js", () => ({
+    resolveLocalAuthDefaults: mocks.resolveLocalAuthDefaults,
+}));
+const SCHEMA_A = {};
+const SCHEMA_B = { todos: { columns: [] } };
+describe("backend/create-jazz-context", () => {
+    beforeEach(() => {
+        mocks.reset();
+        mocks.resolveLocalAuthDefaults.mockImplementation((config) => config);
+    });
+    it("BC-U01: lazily initializes runtime/client on first access", () => {
+        const context = createJazzContext({
+            appId: "server-app",
+            app: { wasmSchema: SCHEMA_A },
+            dataPath: "/tmp/jazz.db",
+        });
+        expect(mocks.runtimeCtor).not.toHaveBeenCalled();
+        expect(mocks.connectWithRuntime).not.toHaveBeenCalled();
+        const clientA = context.client();
+        const clientB = context.client();
+        expect(clientA).toBe(clientB);
+        expect(mocks.runtimeCtor).toHaveBeenCalledTimes(1);
+        expect(mocks.connectWithRuntime).toHaveBeenCalledTimes(1);
+        expect(mocks.runtimeCtor).toHaveBeenCalledWith(serializeRuntimeSchema(SCHEMA_A), "server-app", "dev", "main", "/tmp/jazz.db", undefined);
+    });
+    it("BC-U02: supports request/session-scoped helpers", () => {
+        const context = createJazzContext({
+            appId: "server-app",
+            app: { wasmSchema: SCHEMA_A },
+            dataPath: "/tmp/jazz.db",
+            backendSecret: "secret",
+        });
+        const req = {
+            header: (name) => (name === "authorization" ? "Bearer a.b.c" : undefined),
+        };
+        const session = { user_id: "u1", claims: {} };
+        const requestClient = context.forRequest(req);
+        const sessionClient = context.forSession(session);
+        expect(requestClient).toEqual({ kind: "request-client" });
+        expect(sessionClient).toEqual({ kind: "session-client" });
+        expect(mocks.clients).toHaveLength(1);
+        expect(mocks.clients[0].forRequest).toHaveBeenCalledWith(req);
+        expect(mocks.clients[0].forSession).toHaveBeenCalledWith(session);
+    });
+    it("BC-U03: throws when no schema source is available", () => {
+        const context = createJazzContext({
+            appId: "server-app",
+            dataPath: "/tmp/jazz.db",
+        });
+        expect(() => context.client()).toThrow("No schema source provided");
+    });
+    it("BC-U04: rejects switching to a different schema after initialization", () => {
+        const context = createJazzContext({
+            appId: "server-app",
+            dataPath: "/tmp/jazz.db",
+        });
+        context.client({ wasmSchema: SCHEMA_A });
+        expect(() => context.client({ wasmSchema: SCHEMA_B })).toThrow("already initialized with a different schema");
+    });
+    it("BC-U05: flush is safe before init and delegates after init", () => {
+        const context = createJazzContext({
+            appId: "server-app",
+            app: { wasmSchema: SCHEMA_A },
+            dataPath: "/tmp/jazz.db",
+        });
+        expect(() => context.flush()).not.toThrow();
+        context.client();
+        context.flush();
+        expect(mocks.runtimeInstances).toHaveLength(1);
+        expect(mocks.runtimeInstances[0].flush).toHaveBeenCalledTimes(1);
+    });
+    it("BC-U06: shutdown releases client and allows re-init", async () => {
+        const context = createJazzContext({
+            appId: "server-app",
+            app: { wasmSchema: SCHEMA_A },
+            dataPath: "/tmp/jazz.db",
+        });
+        context.client();
+        expect(mocks.clients).toHaveLength(1);
+        await context.shutdown();
+        expect(mocks.clients[0].shutdown).toHaveBeenCalledTimes(1);
+        context.client();
+        expect(mocks.connectWithRuntime).toHaveBeenCalledTimes(2);
+        expect(mocks.runtimeCtor).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=create-jazz-context.test.js.map

package/dist/backend/create-jazz-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-jazz-context.test.js","sourceRoot":"","sources":["../../src/backend/create-jazz-context.test.ts"],"names":[],"mappings":"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"}

package/dist/backend/index.d.ts

@@ -0,0 +1,4 @@
+export { createJazzContext, JazzContext, type BackendContextConfig, type BackendQuerySchemaSource, type BackendSchemaInput, type BackendSchemaSource, } from "./create-jazz-context.js";
+export type { Value, WasmSchema } from "../drivers/types.js";
+export * from "../runtime/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,cAAc,qBAAqB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,3 @@
+export { createJazzContext, JazzContext, } from "./create-jazz-context.js";
+export * from "../runtime/index.js";
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,WAAW,GAKZ,MAAM,0BAA0B,CAAC;AAElC,cAAc,qBAAqB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+export interface BuildOptions {
+    jazzBin: string;
+    schemaDir: string;
+}
+export declare function build(options: BuildOptions): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAiBA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAySD,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDhE"}