primitive-admin 1.1.0-alpha.43 → 1.1.0-alpha.45

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/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/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>;