@gonvex/cli 0.5.2-staging.2 → 0.5.2-staging.21

package/dist/local-bindings.js

@@ -0,0 +1,106 @@
+import { nativeLocalBindings } from "./native-local-bindings.js";
+import { rolldown } from "rolldown";
+import { createHash } from "node:crypto";
+import { readFile, readdir, writeFile, mkdir } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { compileLocalSchema } from "./local-schema.js";
+export async function projectLocalSchema(root) {
+    const migrationDirectory = join(root, "migrations");
+    const names = (await readdir(migrationDirectory).catch(() => [])).filter((name) => name.endsWith(".sql")).sort();
+    const migrations = await Promise.all(names.map(async (name) => ({ name, sql: await readFile(join(migrationDirectory, name), "utf8") })));
+    const tenantMigrations = migrations.filter(({ sql }) => !/gonvex:scope\s+(control|landlord)/.test(sql));
+    const digest = createHash("sha256").update("local-schema-v1").update(JSON.stringify(tenantMigrations)).digest("hex");
+    const cacheFile = join(root, "gonvex", "_build", `local-schema-${digest}.json`);
+    let schema;
+    try {
+        schema = JSON.parse(await readFile(cacheFile, "utf8"));
+    }
+    catch {
+        schema = await compileLocalSchema(tenantMigrations);
+        await mkdir(dirname(cacheFile), { recursive: true });
+        await writeFile(cacheFile, JSON.stringify(schema));
+    }
+    return schema;
+}
+export async function localBindings(root, manifest) {
+    const reducers = Object.entries(manifest.functions).filter(([, entry]) => entry.localExecution === 1);
+    if (!reducers.length)
+        return {};
+    const schema = await projectLocalSchema(root);
+    const generatedDirectory = join(root, "gonvex", "_generated");
+    const imports = reducers.map(([, entry], index) => {
+        let file = relative(generatedDirectory, resolve(root, entry.file)).replaceAll("\\", "/").replace(/\.(?:tsx?|mts|cts)$/, ".js");
+        if (!file.startsWith("."))
+            file = `./${file}`;
+        return `import { ${entry.handler} as reducer${index} } from ${JSON.stringify(file)};`;
+    });
+    const entryFile = join(root, "gonvex", "_build", "local-entry.ts");
+    await mkdir(dirname(entryFile), { recursive: true });
+    await writeFile(entryFile, `${imports.join("\n")}\nexport const localReducers = {${reducers.map(([path], index) => `${JSON.stringify(path)}: reducer${index}`).join(",")}};`);
+    const bundle = await rolldown({
+        input: entryFile, cwd: root, platform: "browser", tsconfig: false,
+        // These declarations describe server entry points. Their definitions and
+        // schema construction are unnecessary when only Reducer exports are used.
+        treeshake: { manualPureFunctions: ["action", "internalReducer", "query", "internalQuery", "liveQuery", "replicaCollection", "visibility", "cron", "tenantCron", "schema"] },
+        resolve: { conditionNames: ["browser", "import", "default"], mainFields: ["browser", "module", "main"] },
+    });
+    let localCode;
+    const webChunks = {};
+    try {
+        const output = await bundle.generate({ format: "esm", codeSplitting: false });
+        if (output.output.length !== 1 || output.output[0]?.type !== "chunk")
+            throw new Error("Local Reducers must compile into one self-contained module");
+        localCode = output.output[0].code;
+        // Browser controls preload their own Reducers. Unopened features keep
+        // their code on disk instead of importing every application module at boot.
+        const lazyEntry = join(root, 'gonvex', '_build', 'local-lazy-entry.ts');
+        const loaders = reducers.map(([path, entry]) => {
+            let file = relative(dirname(lazyEntry), resolve(root, entry.file)).replaceAll('\\', '/').replace(/\.(?:tsx?|mts|cts)$/, '.js');
+            if (!file.startsWith('.'))
+                file = `./${file}`;
+            return `${JSON.stringify(path)}: () => import(${JSON.stringify(file)}).then(module => module.${entry.handler})`;
+        });
+        await writeFile(lazyEntry, `export const localReducers = {${loaders.join(',')}};`);
+        const lazyBundle = await rolldown({ input: lazyEntry, cwd: root, platform: 'browser', tsconfig: false,
+            treeshake: { manualPureFunctions: ['action', 'internalReducer', 'query', 'internalQuery', 'liveQuery', 'replicaCollection', 'visibility', 'cron', 'tenantCron', 'schema'] },
+            resolve: { conditionNames: ['browser', 'import', 'default'], mainFields: ['browser', 'module', 'main'] },
+        });
+        let web;
+        try {
+            web = await lazyBundle.generate({ format: 'esm', entryFileNames: 'local-reducers.js', chunkFileNames: 'local-reducer-[name]-[hash].js' });
+        }
+        finally {
+            await lazyBundle.close();
+        }
+        for (const chunk of web.output) {
+            if (chunk.type !== "chunk")
+                throw new Error("Unexpected local Reducer asset");
+            webChunks[chunk.fileName] = chunk.code;
+        }
+    }
+    finally {
+        await bundle.close();
+    }
+    const contractBytes = manifest.module.files["client-contract.json"];
+    const clientContract = contractBytes ? JSON.parse(Buffer.from(contractBytes, "base64").toString()) : undefined;
+    const header = "// Generated by Gonvex. Do not edit.\n";
+    // Tables each locally executing Reducer needs resident, limited to tables the
+    // client can actually hydrate through a generated local collection.
+    const localTables = new Set(Object.entries(manifest.functions).filter(([path]) => path.startsWith("__local.")).map(([, entry]) => entry.replica?.table));
+    const localDependencies = Object.fromEntries(reducers
+        .map(([path, entry]) => [path, (entry.localDependencies ?? []).filter((table) => localTables.has(table))])
+        .filter(([, tables]) => tables.length > 0));
+    const native = await nativeLocalBindings(root, localCode, schema, {
+        clientContract, artifactHash: manifest.module.hash, tables: Object.keys(schema),
+        collections: Object.entries(manifest.functions).filter(([path]) => path.startsWith("__local.")).map(([path, entry]) => ({ kind: "query", path, delivery: "replica", replica: entry.replica })),
+    });
+    return {
+        ...native,
+        "local-schema.ts": `${header}export const localSchema = ${JSON.stringify(schema)} as const;\n`,
+        ...Object.fromEntries(Object.entries(webChunks).map(([name, code]) => [name, header + code])),
+        "local-reducers.d.ts": `${header}import type { ReducerDefinition } from "@gonvex/module-sdk";\nexport declare const localReducers: Readonly<Record<string, () => Promise<ReducerDefinition<any, any>>>>;\n`,
+        "local-runtime.ts": `${header}export {localRuntime} from "./local-executor.js";\n`,
+        "local-executor.ts": `${header}import { createPortableReducer } from "@gonvex/local-runtime/portable-client";\nimport { localSchema } from "./local-schema.js";\nimport { localReducers } from "./local-reducers.js";\nexport const localRuntime = { mode: "portable" as const, clientContract: ${JSON.stringify(clientContract)}, artifactHash: ${JSON.stringify(manifest.module.hash)}, tables: ${JSON.stringify(Object.keys(schema))}, collections: ${JSON.stringify(Object.entries(manifest.functions).filter(([path]) => path.startsWith("__local.")).map(([path, entry]) => ({ kind: "query", path, delivery: "replica", replica: entry.replica })))} as const, localDependencies: ${JSON.stringify(localDependencies)} as const, create: () => createPortableReducer({schema: localSchema, reducers: localReducers, artifactHash: ${JSON.stringify(manifest.module.hash)}}) };\n`,
+    };
+}
+//# sourceMappingURL=local-bindings.js.map

package/dist/local-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-bindings.js","sourceRoot":"","sources":["../src/local-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7H,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzI,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,mCAAmC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxG,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,MAAM,OAAO,CAAC,CAAC;IAChF,IAAI,MAAmB,CAAC;IACxB,IAAI,CAAC;QAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAgB,CAAC;IAAC,CAAC;IAC9E,MAAM,CAAC;QACL,MAAM,GAAG,MAAM,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,QAAkB;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,CAAC,CAAC;IACtG,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE;QAChD,IAAI,IAAI,GAAG,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC/H,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,YAAY,KAAK,CAAC,OAAO,cAAc,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;IACxF,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACnE,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mCAAmC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9K,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;QAC5B,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK;QACjE,yEAAyE;QACzE,0EAA0E;QAC1E,SAAS,EAAE,EAAE,mBAAmB,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;QAC3K,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;KACzG,CAAC,CAAC;IACH,IAAI,SAAiB,CAAC;IACtB,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QACpJ,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClC,sEAAsE;QACtE,4EAA4E;QAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;YAC7C,IAAI,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;YAC/H,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,OAAO,GAAG,CAAC;QAClH,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,iCAAiC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK;YACnG,SAAS,EAAE,EAAE,mBAAmB,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;YAC3K,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;SACzG,CAAC,CAAC;QACH,IAAI,GAAG,CAAC;QACR,IAAI,CAAC;YAAC,GAAG,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,gCAAgC,EAAE,CAAC,CAAC;QAAC,CAAC;gBAC1I,CAAC;YAAC,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC9E,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;QACzC,CAAC;IACH,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;IACnC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACpE,MAAM,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/G,MAAM,MAAM,GAAG,wCAAwC,CAAC;IACxD,8EAA8E;IAC9E,oEAAoE;IACpE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACzJ,MAAM,iBAAiB,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ;SAClD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAU,CAAC;SAClH,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE;QAChE,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/E,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAC,IAAI,EAAC,OAAO,EAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,OAAO,EAAC,KAAK,CAAC,OAAO,EAAC,CAAC,CAAC;KACtL,CAAC,CAAC;IACH,OAAO;QACL,GAAG,MAAM;QACT,iBAAiB,EAAE,GAAG,MAAM,8BAA8B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc;QAC9F,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7F,qBAAqB,EAAE,GAAG,MAAM,2KAA2K;QAC3M,kBAAkB,EAAE,GAAG,MAAM,qDAAqD;QAClF,mBAAmB,EAAE,GAAG,MAAM,oQAAoQ,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAC,IAAI,EAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAC,SAAS,EAAE,OAAO,EAAC,KAAK,CAAC,OAAO,EAAC,CAAC,CAAC,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,+GAA+G,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;KACp1B,CAAC;AACJ,CAAC"}

package/dist/local-dependencies.d.ts

@@ -0,0 +1,58 @@
+export type LocalTableAccess = {
+    table: string;
+    operation: string;
+    /** False only for inserts with an intent-generated key: they never read locally. */
+    reads: boolean;
+    /** Project-relative `file:line`. */
+    site: string;
+};
+export type UnresolvedLocalAccess = {
+    operation: string;
+    site: string;
+    expression: string;
+};
+export type LocalReducerAnalysis = {
+    path: string;
+    accesses: LocalTableAccess[];
+    unresolved: UnresolvedLocalAccess[];
+    rawQueries: string[];
+};
+export type LocalReducerSource = {
+    /** Public function path. */
+    path: string;
+    /** Project-relative module file. */
+    file: string;
+    /** Exported binding that holds the Reducer definition. */
+    exportName: string;
+};
+export type LocalDependencyViolation = {
+    reducer: string;
+    table: string;
+    operation: string;
+    site: string;
+    reason: string;
+};
+/**
+ * Whether an access reads the table locally. The analysis checks inserts for
+ * an explicit `_id`; a table keyed by another column is treated as read by any
+ * insert, since the row may carry that key.
+ */
+export declare function readsLocally(access: LocalTableAccess, tableKeys: ReadonlyMap<string, string>): boolean;
+/** Tables a Reducer needs in the Local Replica to run locally, sorted. */
+export declare function localDependencyTables(analysis: LocalReducerAnalysis, tableKeys: ReadonlyMap<string, string>): string[];
+/** Accesses a local run cannot complete. `tableKeys` maps every local-schema table to its key. */
+export declare function localDependencyViolations(analyses: readonly LocalReducerAnalysis[], localTables: ReadonlySet<string>, tableKeys: ReadonlyMap<string, string>): LocalDependencyViolation[];
+/** A readable report grouped by table, for CLI errors and warnings. */
+export declare function formatLocalDependencyViolations(violations: readonly LocalDependencyViolation[]): string;
+/**
+ * Analyze the table dependencies of locally executing Reducers. Loads the
+ * TypeScript compiler bundled with the CLI on first use.
+ */
+export declare function analyzeLocalReducerDependencies(input: {
+    root: string;
+    backendDir: string;
+    files: readonly string[];
+    reducers: readonly LocalReducerSource[];
+    /** Project-relative tsconfig whose compiler options (paths, resolution) apply to the backend. */
+    tsconfig?: string;
+}): Promise<LocalReducerAnalysis[]>;