primitive-admin 1.0.52 → 1.0.54

package/dist/src/lib/codegen-shared/resolveCodegenSourceDir.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Shared source-directory resolution for the CLI codegen commands
+ * (`workflows codegen` #1442 and `databases codegen` #814, issue #1510).
+ *
+ * Both commands read a set of `*.toml` schemas out of a synced sub-directory
+ * (`workflows/` or `database-types/`) and render `*.generated.ts` beside them.
+ * Historically each command located that source directory by scanning EVERY
+ * `.primitive/sync/<env>/<appId>/<subdir>` slot and either hard-erroring on
+ * more than one (`workflows`) or silently merging across environments
+ * (`databases`, via a `seenTypes` dedup). Neither did any environment
+ * resolution, so `PRIMITIVE_ENV=dev workflows codegen` would happily generate
+ * from the `alpha` TOML while `databases codegen` followed a different env —
+ * the two generated-type trees could come from different environments in one
+ * run.
+ *
+ * This helper resolves the source directory the same way every other CLI
+ * command targets an environment: `--env` → `PRIMITIVE_ENV` →
+ * `defaultEnvironment` → single-env → error. `--sync-dir` and `--app` remain
+ * explicit overrides. It returns ONLY the resolved source directory; TOML
+ * collection, type filtering/dedup, and output-dir defaulting stay in each
+ * command.
+ *
+ * Design notes (binding, from the plan of record for #1510):
+ *   - Call `getCurrentEnvironment()` DIRECTLY when no `--sync-dir` is given.
+ *     `resolveSyncDir()`'s internal `safeEnv()` swallows the resolver's
+ *     ambiguity error and falls back to `./config`, so genuine ambiguity must
+ *     be surfaced here, not through `resolveSyncDir()`.
+ *   - Throw plain `Error`s; the calling commands keep their existing
+ *     `error(); process.exit(1)` convention (they catch at the boundary).
+ *   - Do NOT use `resolveAppId()` — it is auth-oriented and exits the process,
+ *     which is wrong for an offline codegen path.
+ *   - Preserve the `--app`-alone legacy fallback: when `--app` is given, NO
+ *     environment was explicitly requested, and env resolution fails (or there
+ *     is no project config / legacy bare-dir mode), scan
+ *     `.primitive/sync/<env>/<app>/<subdir>` for that specific app, resolving
+ *     when it appears under exactly one env and erroring (naming the candidate
+ *     envs) when it appears under more than one. This keeps the existing
+ *     integration contract
+ *     (`cli/tests/integration/workflows-codegen.test.ts`) intact.
+ *   - Do NOT fall through to that scan when an environment WAS explicitly named
+ *     (`--env` or `PRIMITIVE_ENV`) but is invalid/unknown: surface the
+ *     resolver's error instead, so an explicit env selection never silently
+ *     generates code from a different synced environment.
+ */
+export interface ResolveCodegenSourceDirOptions {
+    /** `--app <app-id>` override, if the user passed it. */
+    app?: string;
+    /** `--sync-dir <path>` override, if the user passed it. */
+    syncDir?: string;
+}
+export interface ResolveCodegenSourceDirArgs {
+    /** The synced sub-directory to resolve, e.g. "workflows" or "database-types". */
+    subdir: string;
+    /** Parsed command options (`--app`, `--sync-dir`). */
+    options: ResolveCodegenSourceDirOptions;
+    /**
+     * Working directory the legacy scan is rooted at. Defaults to
+     * `process.cwd()`; parameterised so unit tests can point it at a tmp tree
+     * (vitest workers can't `chdir`).
+     */
+    cwd?: string;
+}
+/**
+ * Resolves the single source directory a codegen command should read its
+ * `*.toml` schemas from. Throws a plain `Error` (with a user-facing message)
+ * when the directory can't be resolved unambiguously or doesn't exist.
+ */
+export declare function resolveCodegenSourceDir(args: ResolveCodegenSourceDirArgs): string;

package/dist/src/lib/codegen-shared/resolveCodegenSourceDir.js

@@ -0,0 +1,168 @@
+/**
+ * Shared source-directory resolution for the CLI codegen commands
+ * (`workflows codegen` #1442 and `databases codegen` #814, issue #1510).
+ *
+ * Both commands read a set of `*.toml` schemas out of a synced sub-directory
+ * (`workflows/` or `database-types/`) and render `*.generated.ts` beside them.
+ * Historically each command located that source directory by scanning EVERY
+ * `.primitive/sync/<env>/<appId>/<subdir>` slot and either hard-erroring on
+ * more than one (`workflows`) or silently merging across environments
+ * (`databases`, via a `seenTypes` dedup). Neither did any environment
+ * resolution, so `PRIMITIVE_ENV=dev workflows codegen` would happily generate
+ * from the `alpha` TOML while `databases codegen` followed a different env —
+ * the two generated-type trees could come from different environments in one
+ * run.
+ *
+ * This helper resolves the source directory the same way every other CLI
+ * command targets an environment: `--env` → `PRIMITIVE_ENV` →
+ * `defaultEnvironment` → single-env → error. `--sync-dir` and `--app` remain
+ * explicit overrides. It returns ONLY the resolved source directory; TOML
+ * collection, type filtering/dedup, and output-dir defaulting stay in each
+ * command.
+ *
+ * Design notes (binding, from the plan of record for #1510):
+ *   - Call `getCurrentEnvironment()` DIRECTLY when no `--sync-dir` is given.
+ *     `resolveSyncDir()`'s internal `safeEnv()` swallows the resolver's
+ *     ambiguity error and falls back to `./config`, so genuine ambiguity must
+ *     be surfaced here, not through `resolveSyncDir()`.
+ *   - Throw plain `Error`s; the calling commands keep their existing
+ *     `error(); process.exit(1)` convention (they catch at the boundary).
+ *   - Do NOT use `resolveAppId()` — it is auth-oriented and exits the process,
+ *     which is wrong for an offline codegen path.
+ *   - Preserve the `--app`-alone legacy fallback: when `--app` is given, NO
+ *     environment was explicitly requested, and env resolution fails (or there
+ *     is no project config / legacy bare-dir mode), scan
+ *     `.primitive/sync/<env>/<app>/<subdir>` for that specific app, resolving
+ *     when it appears under exactly one env and erroring (naming the candidate
+ *     envs) when it appears under more than one. This keeps the existing
+ *     integration contract
+ *     (`cli/tests/integration/workflows-codegen.test.ts`) intact.
+ *   - Do NOT fall through to that scan when an environment WAS explicitly named
+ *     (`--env` or `PRIMITIVE_ENV`) but is invalid/unknown: surface the
+ *     resolver's error instead, so an explicit env selection never silently
+ *     generates code from a different synced environment.
+ */
+import { existsSync, readdirSync } from "fs";
+import { basename, dirname, join } from "path";
+import { getCurrentEnvironment, getExplicitEnvName } from "../env-resolver.js";
+import { getCurrentAppId } from "../config.js";
+import { resolveSyncDir, assertSafePathComponent } from "../sync-paths.js";
+/**
+ * Resolves the single source directory a codegen command should read its
+ * `*.toml` schemas from. Throws a plain `Error` (with a user-facing message)
+ * when the directory can't be resolved unambiguously or doesn't exist.
+ */
+export function resolveCodegenSourceDir(args) {
+    const { subdir, options } = args;
+    const cwd = args.cwd ?? process.cwd();
+    // 1. --sync-dir is an explicit override: use <sync-dir>/<subdir> verbatim.
+    if (options.syncDir) {
+        return requireExisting(join(options.syncDir, subdir), subdir, undefined);
+    }
+    // 2. Resolve the active environment. Call getCurrentEnvironment() directly
+    //    (not via resolveSyncDir/safeEnv) so a genuinely ambiguous project
+    //    surfaces the resolver's "No environment selected… Available: …" error
+    //    with a non-zero exit — unless the caller narrowed the target with
+    //    --app AND did not name an environment, in which case we fall back to the
+    //    legacy per-app scan.
+    //
+    //    The `--app`-alone fallback only applies when NO environment was
+    //    explicitly requested (neither `--env` nor `PRIMITIVE_ENV`). When the
+    //    user DID name an env but it's invalid/unknown, getCurrentEnvironment()
+    //    throws; we must surface that error (non-zero exit) rather than silently
+    //    scanning the app under some OTHER synced environment — that would
+    //    generate code from the wrong env instead of honoring the explicit
+    //    selection.
+    const explicitEnvRequested = getExplicitEnvName() !== null || !!process.env.PRIMITIVE_ENV;
+    let env;
+    try {
+        env = getCurrentEnvironment();
+    }
+    catch (err) {
+        if (options.app && !explicitEnvRequested) {
+            return scanSyncTree({ subdir, appId: options.app, cwd });
+        }
+        throw err;
+    }
+    // 3. Project mode: resolve the app id and build the env/app-scoped path.
+    if (env) {
+        const appId = options.app ?? env.config.appId ?? getCurrentAppId();
+        if (!appId) {
+            throw new Error(`No app configured for environment "${env.name}" in .primitive/config.json ` +
+                `and no --app given. Add "appId" to the environment or pass --app <app-id>.`);
+        }
+        // resolveSyncDir re-reads the (cached) resolved env and guards appId via
+        // assertSafePathComponent, so an unsafe --app is rejected here.
+        const dir = join(resolveSyncDir({ appId }), subdir);
+        return requireExisting(dir, subdir, appId);
+    }
+    // 4. Legacy / bare-dir mode (no .primitive/config.json): scan the sync tree,
+    //    filtered to --app when given. This preserves the pre-#1510 behavior.
+    return scanSyncTree({ subdir, appId: options.app, cwd });
+}
+/**
+ * Legacy fallback: scan `<cwd>/.primitive/sync/<env>/<app>/<subdir>` for a
+ * source directory. When `appId` is given, only that app's slots are
+ * considered. Resolves to the single match; errors clearly on zero or on
+ * ambiguity (naming the candidate apps or envs).
+ */
+function scanSyncTree(args) {
+    const { subdir, appId, cwd } = args;
+    // Defence-in-depth: an --app value flows into a file-system path below, so
+    // reject separators / `..` before using it.
+    if (appId)
+        assertSafePathComponent(appId, "appId");
+    const root = join(cwd, ".primitive", "sync");
+    const found = [];
+    if (existsSync(root)) {
+        for (const envName of readdirSync(root)) {
+            const envDir = join(root, envName);
+            try {
+                for (const app of readdirSync(envDir)) {
+                    if (appId && app !== appId)
+                        continue;
+                    const candidate = join(envDir, app, subdir);
+                    if (existsSync(candidate))
+                        found.push(candidate);
+                }
+            }
+            catch {
+                // Not a directory (or unreadable) — skip.
+            }
+        }
+    }
+    if (found.length === 0) {
+        throw new Error(notFoundMessage(subdir, appId));
+    }
+    if (found.length > 1) {
+        if (appId) {
+            const envs = [
+                ...new Set(found.map((d) => basename(dirname(dirname(d))))),
+            ];
+            throw new Error(`App "${appId}" has a ${subdir}/ directory under multiple environments: ` +
+                `${envs.join(", ")}.\n` +
+                found.map((d) => `  ${d}`).join("\n") +
+                `\nPass --env <name> or --sync-dir to select one.`);
+        }
+        const apps = [...new Set(found.map((d) => basename(dirname(d))))];
+        throw new Error(`Found ${subdir}/ directories for more than one app/env:\n` +
+            found.map((d) => `  ${d}`).join("\n") +
+            `\nCodegen writes into one output dir, so it must run against one app. ` +
+            `Pass --app <app-id> (found: ${apps.join(", ")}) or --sync-dir to select one.`);
+    }
+    return found[0];
+}
+/** Verifies `dir` exists, throwing the standard "no source dir" error otherwise. */
+function requireExisting(dir, subdir, appId) {
+    if (!existsSync(dir)) {
+        throw new Error(notFoundMessage(subdir, appId));
+    }
+    return dir;
+}
+function notFoundMessage(subdir, appId) {
+    return appId
+        ? `No ${subdir}/ directory found for app "${appId}" under .primitive/sync/. ` +
+            `Check the --app id, pass --sync-dir, or run \`primitive sync pull\` first.`
+        : `No ${subdir}/ directory found. Pass --sync-dir or run \`primitive sync pull\` first.`;
+}
+//# sourceMappingURL=resolveCodegenSourceDir.js.map

package/dist/src/lib/codegen-shared/resolveCodegenSourceDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveCodegenSourceDir.js","sourceRoot":"","sources":["../../../../src/lib/codegen-shared/resolveCodegenSourceDir.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/config-toml.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Parse a TOML source string with a TOML 1.0-compliant parser.
+ * Accepts heterogeneous inline arrays that the old `@iarna` rejected.
+ */
+export declare function parseConfigToml(content: string): Record<string, any>;
+/**
+ * Serialize a config object to TOML with a TOML 1.0-compliant serializer.
+ * Emits heterogeneous arrays natively instead of falling back to a JSON string.
+ */
+export declare function stringifyConfigToml(data: any): string;

package/dist/src/lib/config-toml.js

@@ -0,0 +1,42 @@
+/**
+ * The CLI's single TOML wrapper. Every TOML parse/stringify in the CLI routes
+ * through here — config files (database-type configs, workflows, collection-type
+ * configs, v2 block configs) and non-config files alike (app.toml, prompts,
+ * integrations, cron triggers, webhooks, rule-sets, codegen, ...).
+ *
+ * Config files can carry **heterogeneous arrays**: a settings-gated pipeline
+ * produces a CEL step-reference string next to a filter object, e.g.
+ * `"$and" = ["$steps.settings.first.peerVisible", { status = "approved" }]`.
+ * TOML 1.0.0 permits heterogeneous arrays; the previous library `@iarna`
+ * targeted TOML 0.5 and threw on them in **both** directions (`stringify` and
+ * `parse`). `smol-toml` is TOML 1.0-compliant and round-trips them, so #1450
+ * swapped the config paths and #1464 finished the migration — moving every
+ * remaining site here and removing `@iarna` entirely. Keeping one library
+ * means one set of parser semantics to reason about.
+ *
+ * Behavioral notes for the smol-toml swap (measured against `@iarna@2.2.5`):
+ * every divergence is a loud error, never silent value drift. smol throws on
+ * integers beyond 2^53 (`@iarna` returned a BigInt that then broke
+ * `JSON.stringify` on push), rejects control characters in comments (TOML 1.0
+ * ban), and throws on stringifying an array containing `null` (`@iarna`
+ * silently dropped it). `null`/`undefined` data-loss guards live in
+ * `canEmitNative` (`toml-database-config.ts`), not here. `smol` re-emits with
+ * slightly different formatting (`[]` not `[ ]`, no array-of-tables indent) —
+ * a one-time reformat on the next `pull`.
+ */
+import * as smolToml from "smol-toml";
+/**
+ * Parse a TOML source string with a TOML 1.0-compliant parser.
+ * Accepts heterogeneous inline arrays that the old `@iarna` rejected.
+ */
+export function parseConfigToml(content) {
+    return smolToml.parse(content);
+}
+/**
+ * Serialize a config object to TOML with a TOML 1.0-compliant serializer.
+ * Emits heterogeneous arrays natively instead of falling back to a JSON string.
+ */
+export function stringifyConfigToml(data) {
+    return smolToml.stringify(data);
+}
+//# sourceMappingURL=config-toml.js.map

package/dist/src/lib/config-toml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-toml.js","sourceRoot":"","sources":["../../../src/lib/config-toml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAwB,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAS;IAC3C,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/lib/config.d.ts

@@ -29,6 +29,22 @@ export declare function resolveAppId(appId: string | undefined, options: {
  * the serverUrl saved in the legacy credentials file.
  */
 export declare function getServerUrl(): string;
+/**
+ * Resolves the API base URL to authenticate against, used by `primitive login`
+ * (issue #1343).
+ *
+ * Unlike getServerUrl(), this must work *before* any credentials exist (first
+ * login), so it never falls back to the stored credentials' serverUrl:
+ *
+ *   - Project mode → the active environment's `apiUrl` (canonical). Lets
+ *     getCurrentEnvironment() throw on an unresolvable env (ambiguous/unknown
+ *     --env) so the caller can fail loudly instead of silently targeting prod.
+ *   - Legacy mode (no .primitive/config.json) → DEFAULT_SERVER_URL, which
+ *     honors the PRIMITIVE_SERVER_URL escape hatch (constants.ts).
+ *
+ * The trailing slash is stripped so callers can build `${url}/admin/api/...`.
+ */
+export declare function getConfiguredServerUrl(): string;
 /**
  * Exposed so commands can check whether there's a pre-project-config
  * credentials file at ~/.primitive/credentials.json (used by migration

package/dist/src/lib/config.js

@@ -14,6 +14,8 @@
  */
 import { clearCredentialsStore, clearCurrentAppStore, loadCredentialsStore, peekLegacyCredentials, saveCredentialsStore, setCurrentAppStore, } from "./credentials-store.js";
 import { getCurrentEnvironment, getCurrentEnvNameSafe, } from "./env-resolver.js";
+import { PROJECT_CONFIG_DISPLAY_NAME } from "./project-config.js";
+import { DEFAULT_SERVER_URL } from "./constants.js";
 export function loadCredentials() {
     return loadCredentialsStore();
 }
@@ -55,6 +57,26 @@ export function getCurrentAppId() {
 export function resolveAppId(appId, options) {
     const resolved = appId || options.app || getCurrentAppId();
     if (!resolved) {
+        // When the active env declares an `appId` in .primitive/config.json but
+        // has no credentials slot, loadCredentialsStore() returns null (its
+        // null == unauthenticated contract), so getCurrentAppId() yields nothing
+        // even though an appId IS configured. In that case the accurate problem
+        // is that the user isn't authenticated for this env — not that no app was
+        // specified. (A creds slot would have blended in env.config.appId and made
+        // `resolved` truthy, so reaching here with a configured appId can only mean
+        // missing credentials.)
+        let env = null;
+        try {
+            env = getCurrentEnvironment();
+        }
+        catch {
+            // Env resolution failed (ambiguous/unknown env) — fall back to the
+            // original "No app specified." message below.
+        }
+        if (env && env.config.appId) {
+            console.error(`Not logged in to environment "${env.name}". An appId is configured in ${PROJECT_CONFIG_DISPLAY_NAME} but you're not authenticated. Run 'primitive -e ${env.name} login'.`);
+            process.exit(1);
+        }
         const envName = getCurrentEnvNameSafe();
         const hint = envName
             ? `(current environment: ${envName}). Set 'appId' in .primitive/config.json, pass --app, or run 'primitive use <app-id>'.`
@@ -85,6 +107,25 @@ export function getServerUrl() {
     }
     return credentials.serverUrl;
 }
+/**
+ * Resolves the API base URL to authenticate against, used by `primitive login`
+ * (issue #1343).
+ *
+ * Unlike getServerUrl(), this must work *before* any credentials exist (first
+ * login), so it never falls back to the stored credentials' serverUrl:
+ *
+ *   - Project mode → the active environment's `apiUrl` (canonical). Lets
+ *     getCurrentEnvironment() throw on an unresolvable env (ambiguous/unknown
+ *     --env) so the caller can fail loudly instead of silently targeting prod.
+ *   - Legacy mode (no .primitive/config.json) → DEFAULT_SERVER_URL, which
+ *     honors the PRIMITIVE_SERVER_URL escape hatch (constants.ts).
+ *
+ * The trailing slash is stripped so callers can build `${url}/admin/api/...`.
+ */
+export function getConfiguredServerUrl() {
+    const env = getCurrentEnvironment(); // may throw on an unresolvable env
+    return (env ? env.config.apiUrl : DEFAULT_SERVER_URL).replace(/\/$/, "");
+}
 /**
  * Exposed so commands can check whether there's a pre-project-config
  * credentials file at ~/.primitive/credentials.json (used by migration

package/dist/src/lib/config.js.map

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

package/dist/src/lib/constants.d.ts

@@ -1,2 +1,11 @@
 export declare const PRODUCTION_SERVER_URL = "https://primitiveapi.com";
 export declare const DEFAULT_SERVER_URL: string;
+/**
+ * The alpha deployment's canonical server URL. Mirrors
+ * `wrangler.toml [env.alpha] WORKER_URL` — keep the two in sync; if the alpha
+ * URL ever changes, update both. Used only by `primitive guides` to detect the
+ * alpha target and fetch guides from the `primitive-docs` `next` branch instead
+ * of `main` (issue #1463). This is an internal-only convenience;
+ * security-through-obscurity is acceptable.
+ */
+export declare const ALPHA_SERVER_URL = "https://js-bao-wss-alpha.primitive-labs-dev.workers.dev";

package/dist/src/lib/constants.js

@@ -1,3 +1,12 @@
 export const PRODUCTION_SERVER_URL = "https://primitiveapi.com";
 export const DEFAULT_SERVER_URL = process.env.PRIMITIVE_SERVER_URL || PRODUCTION_SERVER_URL;
+/**
+ * The alpha deployment's canonical server URL. Mirrors
+ * `wrangler.toml [env.alpha] WORKER_URL` — keep the two in sync; if the alpha
+ * URL ever changes, update both. Used only by `primitive guides` to detect the
+ * alpha target and fetch guides from the `primitive-docs` `next` branch instead
+ * of `main` (issue #1463). This is an internal-only convenience;
+ * security-through-obscurity is acceptable.
+ */
+export const ALPHA_SERVER_URL = "https://js-bao-wss-alpha.primitive-labs-dev.workers.dev";
 //# sourceMappingURL=constants.js.map

package/dist/src/lib/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE,MAAM,CAAC,MAAM,kBAAkB,GAC7B,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,qBAAqB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE,MAAM,CAAC,MAAM,kBAAkB,GAC7B,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,qBAAqB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,yDAAyD,CAAC"}

package/dist/src/lib/csv.d.ts

@@ -44,5 +44,4 @@ export interface BuildRowsResult {
  * `importCsv`.
  */
 export declare function buildRows(rows: Record<string, any>[], options: BuildRowsOptions): BuildRowsResult;
-/** Split an array into fixed-size chunks. */
-export declare function chunk<T>(items: T[], size: number): T[][];
+export { chunk } from "./batch.js";

package/dist/src/lib/csv.js

@@ -166,12 +166,7 @@ export function buildRows(rows, options) {
     }
     return { batch, rowCount: batch.length };
 }
-/** Split an array into fixed-size chunks. */
-export function chunk(items, size) {
-    const out = [];
-    for (let i = 0; i < items.length; i += size) {
-        out.push(items.slice(i, i + size));
-    }
-    return out;
-}
+// `chunk()` moved to ./batch.ts (shared with `databases import`). Re-exported
+// here so existing `import { chunk } from "../lib/csv.js"` callers keep working.
+export { chunk } from "./batch.js";
 //# sourceMappingURL=csv.js.map

package/dist/src/lib/csv.js.map

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

package/dist/src/lib/db-codegen/dbGenerator.d.ts

@@ -13,9 +13,13 @@
  *   - The banner + fingerprint header pattern and stale-output cleanup.
  *
  * Adds the OPERATIONS half (op-params interfaces + per-op result aliases)
- * that codegen-v2 has no analog for. Op return contracts are NOT stored in
- * the TOML, so result aliases are generic shapes keyed off `op.type`.
+ * that codegen-v2 has no analog for. A result alias is derived from `op.type`
+ * and, where the shape is derivable, the op's parsed `definition`: a query op's
+ * `projection` (#1439), a mutation op's step kinds (#1438), and a pipeline op's
+ * `return` step (#1437). This file resolves those into the small descriptors
+ * the templates consume; the templates stay pure string-emitters.
  */
+import { type GeneratedFileMismatch } from "../codegen-shared/generatedFiles.js";
 export interface DbCodegenInput {
     /** Database type name (drives the output filename). */
     databaseType: string;
@@ -53,15 +57,37 @@ export interface DbCodegenResult {
     /** Only populated under `--check`: files whose on-disk content is out of date. */
     mismatches: DbCheckMismatch[];
 }
-export interface DbCheckMismatch {
-    filePath: string;
-    reason: "missing" | "differs" | "stale";
-}
+/**
+ * Re-exported from the shared generated-file module so existing importers keep
+ * a stable type. The write/`--check`/cleanup lifecycle now lives in
+ * `codegen-shared/generatedFiles.ts` (shared with `workflows codegen`).
+ */
+export type DbCheckMismatch = GeneratedFileMismatch;
 /**
  * Render the in-memory `.generated.ts` content for a single database-type
  * TOML. Exported so tests can assert on the rendered string directly.
  */
 export declare function renderDbTypeFile(input: DbCodegenInput): string;
+/**
+ * Infer the scalar element TS type for op params consumed by a `$in`/`$nin`
+ * filter operator (#1488, Phase 1). Codegen-only: a param compared with
+ * `$in`/`$nin` against a model field is definitionally an array, so the
+ * typed-ops factory (#1441) should emit `<elem>[]` rather than widening an
+ * untyped/object param to `Record<string, unknown>` (which `string[]` is not
+ * assignable to).
+ *
+ * Kept a small local helper next to {@link inferRequiredRecordFields} rather
+ * than a shared cross-runtime analysis pass (sponsor decision on #1488).
+ *
+ * Returns a map of param name → element TS type. The `"unknown"` sentinel means
+ * "emit `unknown[]`" — used when the compared field is missing from the model
+ * schema (or the op has no resolvable model), when the same param is bound to
+ * fields of differing element types, or when the param is also used as a scalar
+ * elsewhere (conservative widen, mirroring #845's disagreement rule / #1488
+ * Fork 4). A param absent from the map is not consumed by any array operator
+ * and keeps its declared-type mapping (inference never widens such a param).
+ */
+export declare function inferArrayParamElementTypes(op: any, fieldTypesByModel: Map<string, Map<string, string>>): Map<string, string>;
 /**
  * Per-model result of {@link inferRequiredRecordFields}. Shaped as an object
  * (rather than a bare `Set`) so it can grow additional inferred metadata later
@@ -106,6 +132,8 @@ export interface InferredRecordModelInfo {
  */
 export declare function inferRequiredRecordFields(operations: any[]): Map<string, InferredRecordModelInfo>;
 /**
- * Run codegen end-to-end across one or more database-type TOML inputs.
+ * Run codegen end-to-end across one or more database-type TOML inputs. The
+ * disk lifecycle (write / `--check` / stale cleanup) is delegated to the
+ * shared `writeOrCheckGeneratedFiles` (shared with `workflows codegen`).
  */
 export declare function generateDbTypes(options: GenerateDbTypesOptions): Promise<DbCodegenResult>;