@osdk/seed-compiler 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @osdk/seed-compiler
+
+## 0.2.0
+
+### Minor Changes
+
+- d6f67f6: add seed data compiler. New `@osdk/seed-helpers` package exports `createSeed` and `SeedBuilder` for declaring typed seed objects and links. New `@osdk/seed-compiler` package compiles all top-level `.mts` files in a directory into a merged seed JSON (sorted by filename for deterministic output) for foundry-cli's local ontology server to load into SQLite on startup. Schema-aware validation (primary-key uniqueness, string format checks for `timestamp`/`date`/`datetime`/`long`/`decimal`) reads from `ontology-metadata.json` produced by the SDK generator, so the same compiler works against both ontology-as-code projects and imported ontologies.
+
+### Patch Changes
+
+- Updated dependencies [d6f67f6]
+  - @osdk/seed-helpers@0.2.0

package/README.md

@@ -0,0 +1,80 @@
+# @osdk/seed-compiler
+
+Compiles seed data files (`.mts`) into a single merged JSON output for the
+local ontology server to load into SQLite on startup.
+
+## Usage
+
+### CLI
+
+```bash
+seed-compiler \
+  --metadata path/to/ontology-metadata.json \
+  --seed-dir path/to/seed/ \
+  --output path/to/seed-data.json
+```
+
+| Flag         | Description                                                                                                                                                                 |
+| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--metadata` | Path to the `ontology-metadata.json` file written by the SDK generator. Provides per-property wire types for format validation and per-object-type primary key field names. |
+| `--seed-dir` | Directory containing seed `.mts` files. All top-level `.mts` files are loaded, sorted by filename for deterministic output, and merged.                                     |
+| `--output`   | Path where the merged seed JSON is written.                                                                                                                                 |
+
+## Authoring seed files
+
+Seed files use `@osdk/seed-helpers` and the user's generated `@ontology/sdk`:
+
+```ts
+import { Product, Seller } from "@ontology/sdk";
+import { createSeed } from "@osdk/seed-helpers";
+
+export default createSeed((seed) => {
+  const widget = seed.add(Product, {
+    pk: "prod-001",
+    title: "Widget",
+    price: 100,
+  });
+  const alice = seed.add(Seller, {
+    pk: "seller-001",
+    name: "Alice",
+  });
+
+  // Link by reference — full compile-time validation on link names and target types.
+  seed.link("widget-seller", widget, "sellers", alice, "products");
+});
+```
+
+The `link()` method also supports a type + primary-key form for cases where
+keeping refs in scope is awkward:
+
+```ts
+seed.add(Product, { pk: "prod-001", title: "Widget", price: 100 });
+seed.add(Seller, { pk: "seller-001", name: "Alice" });
+
+seed.link(
+  "widget-seller",
+  Product,
+  "prod-001",
+  "sellers",
+  Seller,
+  "seller-001",
+  "products",
+);
+```
+
+Both forms produce identical output.
+
+## Validation
+
+The compiler validates:
+
+- **Object types** in seed data must be defined in the ontology (via the metadata file).
+- **Primary keys** must be unique within an object type, across all seed files in the directory.
+- **String-encoded property values** must match the regex format for their wire type
+  (`timestamp`, `date`, `datetime`, `long`, `decimal`).
+- **Links** must reference objects that were `add`-ed in the same seed file.
+  Cross-file linking is not supported — the link source and target must be
+  registered in the same `createSeed(...)` call.
+
+Duplicate links (same source, target, link type) across files are deduplicated
+with a warning rather than an error.

package/bin/seed-compiler.mjs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// @ts-check
+
+import cli from "../build/esm/cli/main.js";
+
+cli();

package/build/browser/cli/main.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "consola";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import invariant from "tiny-invariant";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { compileSeedData } from "../compileSeedData.js";
+import { schemaFromMetadata } from "../schema.js";
+export default async function main(args = process.argv) {
+  const opts = await yargs(hideBin(args)).version("0.2.0" ?? "").wrap(Math.min(120, yargs().terminalWidth())).strict().help().options({
+    metadata: {
+      describe: "Path to the ontology-metadata.json file written by the SDK generator. " + "Provides primary-key field names and property wire types.",
+      type: "string",
+      demandOption: true,
+      coerce: path.resolve
+    },
+    seedDir: {
+      describe: "Directory containing seed data .mts files. All top-level .mts " + "files are compiled (sorted by filename for deterministic output).",
+      type: "string",
+      demandOption: true,
+      coerce: path.resolve
+    },
+    output: {
+      alias: "o",
+      describe: "Output path for the compiled seed data JSON.",
+      type: "string",
+      demandOption: true,
+      coerce: path.resolve
+    }
+  }).parseAsync();
+  const metadataStat = fs.statSync(opts.metadata);
+  !metadataStat.isFile() ? process.env.NODE_ENV !== "production" ? invariant(false, `--metadata '${opts.metadata}' is not a file`) : invariant(false) : void 0;
+  const metadata = JSON.parse(fs.readFileSync(opts.metadata, "utf-8"));
+  const seedDirStat = fs.statSync(opts.seedDir);
+  !seedDirStat.isDirectory() ? process.env.NODE_ENV !== "production" ? invariant(false, `--seed-dir '${opts.seedDir}' is not a directory`) : invariant(false) : void 0;
+  const seedFiles = fs.readdirSync(opts.seedDir).filter(f => f.endsWith(".mts")).sort().map(f => path.join(opts.seedDir, f));
+  if (seedFiles.length === 0) {
+    consola.warn(`No .mts seed files found in ${opts.seedDir}`);
+    return;
+  }
+  const schema = schemaFromMetadata(metadata);
+  await compileSeedData(seedFiles, opts.output, schema);
+}
+//# sourceMappingURL=main.js.map

package/build/browser/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","names":["consola","fs","path","invariant","yargs","hideBin","compileSeedData","schemaFromMetadata","main","args","process","argv","opts","version","wrap","Math","min","terminalWidth","strict","help","options","metadata","describe","type","demandOption","coerce","resolve","seedDir","output","alias","parseAsync","metadataStat","statSync","isFile","env","NODE_ENV","JSON","parse","readFileSync","seedDirStat","isDirectory","seedFiles","readdirSync","filter","f","endsWith","sort","map","join","length","warn","schema"],"sources":["main.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { OntologyFullMetadata } from \"@osdk/foundry.ontologies\";\nimport { consola } from \"consola\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport invariant from \"tiny-invariant\";\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\nimport { compileSeedData } from \"../compileSeedData.js\";\nimport { schemaFromMetadata } from \"../schema.js\";\n\nexport default async function main(\n  args: string[] = process.argv,\n): Promise<void> {\n  const opts: {\n    metadata: string;\n    seedDir: string;\n    output: string;\n  } = await yargs(hideBin(args))\n    .version(process.env.PACKAGE_VERSION ?? \"\")\n    .wrap(Math.min(120, yargs().terminalWidth()))\n    .strict()\n    .help()\n    .options({\n      metadata: {\n        describe:\n          \"Path to the ontology-metadata.json file written by the SDK generator. \"\n          + \"Provides primary-key field names and property wire types.\",\n        type: \"string\" as const,\n        demandOption: true,\n        coerce: path.resolve,\n      },\n      seedDir: {\n        describe:\n          \"Directory containing seed data .mts files. All top-level .mts \"\n          + \"files are compiled (sorted by filename for deterministic output).\",\n        type: \"string\" as const,\n        demandOption: true,\n        coerce: path.resolve,\n      },\n      output: {\n        alias: \"o\",\n        describe: \"Output path for the compiled seed data JSON.\",\n        type: \"string\" as const,\n        demandOption: true,\n        coerce: path.resolve,\n      },\n    })\n    .parseAsync();\n\n  const metadataStat = fs.statSync(opts.metadata);\n  invariant(\n    metadataStat.isFile(),\n    `--metadata '${opts.metadata}' is not a file`,\n  );\n  const metadata = JSON.parse(\n    fs.readFileSync(opts.metadata, \"utf-8\"),\n  ) as OntologyFullMetadata;\n\n  const seedDirStat = fs.statSync(opts.seedDir);\n  invariant(\n    seedDirStat.isDirectory(),\n    `--seed-dir '${opts.seedDir}' is not a directory`,\n  );\n  const seedFiles = fs.readdirSync(opts.seedDir)\n    .filter((f) => f.endsWith(\".mts\"))\n    .sort()\n    .map((f) => path.join(opts.seedDir, f));\n\n  if (seedFiles.length === 0) {\n    consola.warn(`No .mts seed files found in ${opts.seedDir}`);\n    return;\n  }\n\n  const schema = schemaFromMetadata(metadata);\n  await compileSeedData(seedFiles, opts.output, schema);\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/compileSeedData.js

@@ -0,0 +1,322 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "consola";
+import { createJiti } from "jiti";
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+/**
+ * One string-format validation failure (e.g., a timestamp value that doesn't
+ * match the wire format regex). Format failures are collected across the
+ * whole output and reported together at the end so users can fix many
+ * content mistakes in one pass. Structural failures (unknown object type,
+ * unknown property name, null value, wrong JS type) throw immediately
+ * instead — they're not aggregated, so they don't need this struct.
+ */
+
+/**
+ * Expected runtime JS type for each cataloged wire type.
+ *
+ * Used to fail fast on `as any` callers that pass a value of the wrong shape
+ * (e.g., `age: "30"` when `age` is an integer). Wire types not listed here
+ * are not strictly typed by this validator — currently `attachment`,
+ * `mediaReference`, `geopoint`, `geoshape`, `vector`, `array`, `struct`,
+ * which have non-primitive runtime shapes that need bespoke validation.
+ */
+const EXPECTED_JS_TYPE = {
+  // string-encoded primitives
+  string: "string",
+  marking: "string",
+  timestamp: "string",
+  date: "string",
+  datetime: "string",
+  long: "string",
+  decimal: "string",
+  ipAddress: "string",
+  cipherText: "string",
+  // numeric primitives
+  integer: "number",
+  byte: "number",
+  short: "number",
+  double: "number",
+  float: "number",
+  // boolean
+  boolean: "boolean"
+};
+
+/**
+ * Regex patterns for string-encoded wire types that TypeScript cannot validate.
+ *
+ * These patterns are aligned with the Rust backend's actual parsing behavior:
+ * - timestamp: RFC 3339 parse on the Rust side — requires timezone, rejects trailing garbage
+ * - date: stored as raw string, but only YYYY-MM-DD works in SQLite queries
+ * - datetime: stored as raw string, same YYYY-MM-DD requirement for query correctness
+ * - long: strict decimal integer parse on the Rust side — no scientific notation
+ * - decimal: Rust stores any string (no validation), but we enforce numeric format
+ *   to prevent obviously invalid values from silently passing through
+ */
+const WIRE_TYPE_FORMAT = {
+  timestamp: {
+    pattern: /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/,
+    example: "2025-01-01T00:00:00Z"
+  },
+  date: {
+    pattern: /^\d{4}-\d{2}-\d{2}$/,
+    example: "2025-01-01"
+  },
+  datetime: {
+    pattern: /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/,
+    example: "2025-01-01T12:00:00Z"
+  },
+  long: {
+    // Strict decimal integer — matches Rust's str::parse::<i64>().
+    // No scientific notation, no decimal point, no whitespace.
+    pattern: /^-?\d+$/,
+    example: "9007199254740993"
+  },
+  decimal: {
+    // Numeric string with optional decimal point. Anchored.
+    // Rust stores any string (no validation), but we reject obviously invalid values.
+    pattern: /^-?\d+(\.\d+)?$/,
+    example: "123.45"
+  }
+};
+
+/**
+ * Compiles one or more seed data files into a single merged JSON output.
+ *
+ * Pipeline: load each file → merge → validate against schema → write JSON.
+ *
+ * @param seedFiles - Absolute paths to seed `.mts` / `.ts` files.
+ * @param outputPath - Where to write the merged seed JSON.
+ * @param schema - Per-object-type schema, typically built from
+ *                 {@link import("./schema.js").schemaFromMetadata}.
+ * @throws if any seed file fails to compile or has an invalid export, if any
+ *         object type or property name is unknown to the schema, if any
+ *         primary key is duplicated across files, if any property value is
+ *         null/undefined or has the wrong JS type, or if any string-encoded
+ *         value has an invalid format.
+ */
+export async function compileSeedData(seedFiles, outputPath, schema) {
+  consola.info(`Compiling seed data from ${seedFiles.length} file(s)...`);
+  const outputs = [];
+  for (const seedFile of seedFiles) {
+    outputs.push(await loadSeedFile(seedFile));
+  }
+  const merged = mergeSeedOutputs(outputs, schema);
+  validateSeedOutput(merged, schema);
+  const totalObjects = Object.values(merged.objects).reduce((sum, arr) => sum + arr.length, 0);
+  const outputDir = path.dirname(outputPath);
+  await fs.promises.mkdir(outputDir, {
+    recursive: true
+  });
+  await fs.promises.writeFile(outputPath, JSON.stringify(merged, null, 2));
+  consola.success(`Seed data compiled successfully (${totalObjects} objects, ${merged.links.length} links)`);
+}
+
+/**
+ * Merges multiple {@link SeedOutput}s into one.
+ *
+ * - Objects for the same type combine additively.
+ * - Duplicate primary keys across files cause an error (checked by the actual
+ *   PK field from the schema, not by comparing the full serialized object).
+ * - Duplicate links (same source, target, and link type) are deduplicated
+ *   with a warning logged to the console.
+ *
+ * @param outputs - The individual seed outputs to merge.
+ * @param schemaMap - Used to resolve the primary key field name per object type.
+ * @returns A single merged SeedOutput ready for validation and writing.
+ * @throws if any primary key appears in more than one file for the same type.
+ */
+export function mergeSeedOutputs(outputs, schemaMap) {
+  const merged = {
+    objects: {},
+    links: []
+  };
+  const seenPks = new Map();
+  const seenLinks = new Set();
+  for (const output of outputs) {
+    mergeObjectsInto(merged, output.objects, schemaMap, seenPks);
+    mergeLinksInto(merged, output.links, seenLinks);
+  }
+  return merged;
+}
+function mergeObjectsInto(merged, source, schemaMap, seenPks) {
+  for (const [apiName, objects] of Object.entries(source)) {
+    const schema = schemaMap.get(apiName);
+    if (!schema) {
+      throw new Error(`Object type '${apiName}' in seed data is not defined in the ontology`);
+    }
+    const bucket = merged.objects[apiName] ??= [];
+    const pkSet = getOrInit(seenPks, apiName, () => new Set());
+    for (const obj of objects) {
+      const pk = String(obj[schema.primaryKeyApiName] ?? "");
+      if (pkSet.has(pk)) {
+        throw new Error(`Duplicate primary key '${pk}' for '${apiName}' across seed files`);
+      }
+      pkSet.add(pk);
+      bucket.push(obj);
+    }
+  }
+}
+function mergeLinksInto(merged, source, seenLinks) {
+  for (const link of source) {
+    const key = linkKey(link);
+    if (seenLinks.has(key)) {
+      consola.warn(`Duplicate link deduplicated: ${link.linkType}` + ` from ${link.sourceObjectType}:${link.sourceKey}` + ` to ${link.targetObjectType}:${link.targetKey}`);
+      continue;
+    }
+    seenLinks.add(key);
+    merged.links.push(link);
+  }
+}
+function linkKey(link) {
+  return `${link.sourceObjectType}:${link.sourceKey}` + `:${link.linkType}` + `:${link.targetObjectType}:${link.targetKey}`;
+}
+function getOrInit(map, key, init) {
+  let value = map.get(key);
+  if (value === undefined) {
+    value = init();
+    map.set(key, value);
+  }
+  return value;
+}
+
+/**
+ * Validates the seed output against the ontology schema.
+ *
+ * Hard errors (thrown immediately) for any of:
+ *
+ *   - Object types in the seed output not defined in the ontology.
+ *   - Property names on a seed object not defined on that type.
+ *   - `null`/`undefined` property values. Typed callers can't reach this
+ *     (the builder's `SeedProps<Q>` rejects `null`); any null at runtime is
+ *     a sign of `as any` or a hand-rolled output.
+ *   - JS type mismatches against the cataloged wire-type-to-JS-type map
+ *     (e.g., `age: "30"` when `age` is an integer, or `score: 30` when
+ *     `score` is a long).
+ *
+ * For wire types whose runtime shape this validator doesn't catalog
+ * (`attachment`, `mediaReference`, `geopoint`, `geoshape`, `vector`,
+ * `array`, `struct`), JS-type checking is skipped — they have non-primitive
+ * shapes that would need bespoke validation. They still go through the
+ * earlier object-type / property-name / null checks.
+ *
+ * After JS-type validation, string values are checked against the format
+ * regex for their wire type (timestamp, date, datetime, long, decimal).
+ * The one thing TypeScript cannot distinguish on its own is whether a
+ * `string` value matches its wire format (e.g., `"not-a-date"` vs
+ * `"2025-01-01T00:00:00Z"` are both valid `string` to the type system);
+ * format validation fills that gap.
+ *
+ * @throws Error on any structural violation listed above, or listing all
+ *         format failures grouped by object type.
+ */
+export function validateSeedOutput(output, schemaMap) {
+  const errors = validateAndCollectFormatErrors(output, schemaMap);
+  if (errors.length > 0) {
+    throw new Error(formatValidationErrors(errors));
+  }
+}
+function validateAndCollectFormatErrors(output, schemaMap) {
+  const errors = [];
+  for (const [apiName, objects] of Object.entries(output.objects)) {
+    const schema = schemaMap.get(apiName);
+    if (!schema) {
+      throw new Error(`Object type '${apiName}' in seed data is not defined in the ontology`);
+    }
+    for (const [i, obj] of objects.entries()) {
+      for (const [key, value] of Object.entries(obj)) {
+        const wireType = schema.properties.get(key);
+        if (wireType === undefined) {
+          throw new Error(`Property '${key}' on '${apiName}' object` + ` (index ${i}) is not defined in the ontology`);
+        }
+        if (value == null) {
+          throw new Error(`Property '${key}' on '${apiName}' object` + ` (index ${i}) is null or undefined`);
+        }
+        const expectedJsType = EXPECTED_JS_TYPE[wireType];
+        if (expectedJsType !== undefined && typeof value !== expectedJsType) {
+          throw new Error(`Property '${key}' on '${apiName}' object` + ` (index ${i}) expects ${wireType} (a ${expectedJsType})` + ` but got ${typeof value}`);
+        }
+        const format = WIRE_TYPE_FORMAT[wireType];
+        if (!format) continue;
+
+        // Format regex only applies to string-encoded wire types, all of
+        // which have EXPECTED_JS_TYPE === "string"; the cast is safe here
+        // because the JS-type check above would have thrown otherwise.
+        if (format.pattern.test(value)) continue;
+        errors.push({
+          objectType: apiName,
+          objectIndex: i,
+          field: key,
+          message: `property '${key}' has invalid ${wireType}` + ` format: '${String(value)}'. Expected format like '${format.example}'`
+        });
+      }
+    }
+  }
+  return errors;
+}
+function formatValidationErrors(errors) {
+  const grouped = new Map();
+  for (const err of errors) {
+    const messages = getOrInit(grouped, err.objectType, () => []);
+    messages.push(`  object[${err.objectIndex}]: ${err.message}`);
+  }
+  const body = [...grouped.entries()].map(([type, msgs]) => `${type}:\n${msgs.join("\n")}`).join("\n\n");
+  const errorWord = errors.length === 1 ? "error" : "errors";
+  const typeWord = grouped.size === 1 ? "object type" : "object types";
+  return `Seed data validation failed ` + `(${errors.length} ${errorWord} across ${grouped.size} ${typeWord}` + `):\n\n${body}`;
+}
+
+/**
+ * Loads a single seed file via jiti and extracts its default export.
+ *
+ * jiti.import() fully executes the module — the `createSeed()` builder
+ * function runs during import and the default export is the resulting
+ * SeedOutput.
+ *
+ * @throws with a contextual message wrapping the original error and filename.
+ */
+async function loadSeedFile(seedFile) {
+  consola.info(`Loading seed file: ${seedFile}`);
+  let seedModule;
+  try {
+    const jiti = createJiti(seedFile, {
+      moduleCache: false,
+      debug: false
+    });
+    seedModule = await jiti.import(seedFile);
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e);
+    throw new Error(`Seed file '${path.basename(seedFile)}' failed to compile:\n  ${message}`);
+  }
+  if (!seedModule.default || typeof seedModule.default !== "object") {
+    throw new Error(`Seed file '${path.basename(seedFile)}' must have a default export. ` + `Use createSeed() from @osdk/seed-helpers.`);
+  }
+  const output = seedModule.default;
+  if (!output.objects || typeof output.objects !== "object") {
+    throw new Error(`Seed file '${path.basename(seedFile)}' default export is not a valid` + ` SeedOutput. Use createSeed() from @osdk/seed-helpers.`);
+  }
+
+  // Normalize: links are optional in the export but required in SeedOutput.
+  // Spread to avoid mutating the module's exported object.
+  return {
+    ...output,
+    links: output.links ?? []
+  };
+}
+//# sourceMappingURL=compileSeedData.js.map

package/build/browser/compileSeedData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compileSeedData.js","names":["consola","createJiti","fs","path","EXPECTED_JS_TYPE","string","marking","timestamp","date","datetime","long","decimal","ipAddress","cipherText","integer","byte","short","double","float","boolean","WIRE_TYPE_FORMAT","pattern","example","compileSeedData","seedFiles","outputPath","schema","info","length","outputs","seedFile","push","loadSeedFile","merged","mergeSeedOutputs","validateSeedOutput","totalObjects","Object","values","objects","reduce","sum","arr","outputDir","dirname","promises","mkdir","recursive","writeFile","JSON","stringify","success","links","schemaMap","seenPks","Map","seenLinks","Set","output","mergeObjectsInto","mergeLinksInto","source","apiName","entries","get","Error","bucket","pkSet","getOrInit","obj","pk","String","primaryKeyApiName","has","add","link","key","linkKey","warn","linkType","sourceObjectType","sourceKey","targetObjectType","targetKey","map","init","value","undefined","set","errors","validateAndCollectFormatErrors","formatValidationErrors","i","wireType","properties","expectedJsType","format","test","objectType","objectIndex","field","message","grouped","err","messages","body","type","msgs","join","errorWord","typeWord","size","seedModule","jiti","moduleCache","debug","import","e","basename","default"],"sources":["compileSeedData.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { SeedLinkEntry, SeedOutput } from \"@osdk/seed-helpers\";\nimport { consola } from \"consola\";\nimport { createJiti } from \"jiti\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { SchemaMap } from \"./schema.js\";\n\n/**\n * One string-format validation failure (e.g., a timestamp value that doesn't\n * match the wire format regex). Format failures are collected across the\n * whole output and reported together at the end so users can fix many\n * content mistakes in one pass. Structural failures (unknown object type,\n * unknown property name, null value, wrong JS type) throw immediately\n * instead — they're not aggregated, so they don't need this struct.\n */\ninterface FormatError {\n  objectType: string;\n  objectIndex: number;\n  field: string;\n  message: string;\n}\n\n/**\n * Expected runtime JS type for each cataloged wire type.\n *\n * Used to fail fast on `as any` callers that pass a value of the wrong shape\n * (e.g., `age: \"30\"` when `age` is an integer). Wire types not listed here\n * are not strictly typed by this validator — currently `attachment`,\n * `mediaReference`, `geopoint`, `geoshape`, `vector`, `array`, `struct`,\n * which have non-primitive runtime shapes that need bespoke validation.\n */\nconst EXPECTED_JS_TYPE: Record<string, \"string\" | \"number\" | \"boolean\"> = {\n  // string-encoded primitives\n  string: \"string\",\n  marking: \"string\",\n  timestamp: \"string\",\n  date: \"string\",\n  datetime: \"string\",\n  long: \"string\",\n  decimal: \"string\",\n  ipAddress: \"string\",\n  cipherText: \"string\",\n  // numeric primitives\n  integer: \"number\",\n  byte: \"number\",\n  short: \"number\",\n  double: \"number\",\n  float: \"number\",\n  // boolean\n  boolean: \"boolean\",\n};\n\n/**\n * Regex patterns for string-encoded wire types that TypeScript cannot validate.\n *\n * These patterns are aligned with the Rust backend's actual parsing behavior:\n * - timestamp: RFC 3339 parse on the Rust side — requires timezone, rejects trailing garbage\n * - date: stored as raw string, but only YYYY-MM-DD works in SQLite queries\n * - datetime: stored as raw string, same YYYY-MM-DD requirement for query correctness\n * - long: strict decimal integer parse on the Rust side — no scientific notation\n * - decimal: Rust stores any string (no validation), but we enforce numeric format\n *   to prevent obviously invalid values from silently passing through\n */\nconst WIRE_TYPE_FORMAT: Record<string, { pattern: RegExp; example: string }> = {\n  timestamp: {\n    pattern: /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$/,\n    example: \"2025-01-01T00:00:00Z\",\n  },\n  date: {\n    pattern: /^\\d{4}-\\d{2}-\\d{2}$/,\n    example: \"2025-01-01\",\n  },\n  datetime: {\n    pattern:\n      /^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})?)?$/,\n    example: \"2025-01-01T12:00:00Z\",\n  },\n  long: {\n    // Strict decimal integer — matches Rust's str::parse::<i64>().\n    // No scientific notation, no decimal point, no whitespace.\n    pattern: /^-?\\d+$/,\n    example: \"9007199254740993\",\n  },\n  decimal: {\n    // Numeric string with optional decimal point. Anchored.\n    // Rust stores any string (no validation), but we reject obviously invalid values.\n    pattern: /^-?\\d+(\\.\\d+)?$/,\n    example: \"123.45\",\n  },\n};\n\n/**\n * Compiles one or more seed data files into a single merged JSON output.\n *\n * Pipeline: load each file → merge → validate against schema → write JSON.\n *\n * @param seedFiles - Absolute paths to seed `.mts` / `.ts` files.\n * @param outputPath - Where to write the merged seed JSON.\n * @param schema - Per-object-type schema, typically built from\n *                 {@link import(\"./schema.js\").schemaFromMetadata}.\n * @throws if any seed file fails to compile or has an invalid export, if any\n *         object type or property name is unknown to the schema, if any\n *         primary key is duplicated across files, if any property value is\n *         null/undefined or has the wrong JS type, or if any string-encoded\n *         value has an invalid format.\n */\nexport async function compileSeedData(\n  seedFiles: string[],\n  outputPath: string,\n  schema: SchemaMap,\n): Promise<void> {\n  consola.info(`Compiling seed data from ${seedFiles.length} file(s)...`);\n\n  const outputs: SeedOutput[] = [];\n  for (const seedFile of seedFiles) {\n    outputs.push(await loadSeedFile(seedFile));\n  }\n\n  const merged = mergeSeedOutputs(outputs, schema);\n  validateSeedOutput(merged, schema);\n\n  const totalObjects = Object.values(merged.objects)\n    .reduce((sum, arr) => sum + arr.length, 0);\n\n  const outputDir = path.dirname(outputPath);\n  await fs.promises.mkdir(outputDir, { recursive: true });\n  await fs.promises.writeFile(outputPath, JSON.stringify(merged, null, 2));\n\n  consola.success(\n    `Seed data compiled successfully (${totalObjects} objects, ${merged.links.length} links)`,\n  );\n}\n\n/**\n * Merges multiple {@link SeedOutput}s into one.\n *\n * - Objects for the same type combine additively.\n * - Duplicate primary keys across files cause an error (checked by the actual\n *   PK field from the schema, not by comparing the full serialized object).\n * - Duplicate links (same source, target, and link type) are deduplicated\n *   with a warning logged to the console.\n *\n * @param outputs - The individual seed outputs to merge.\n * @param schemaMap - Used to resolve the primary key field name per object type.\n * @returns A single merged SeedOutput ready for validation and writing.\n * @throws if any primary key appears in more than one file for the same type.\n */\nexport function mergeSeedOutputs(\n  outputs: SeedOutput[],\n  schemaMap: SchemaMap,\n): SeedOutput {\n  const merged: SeedOutput = { objects: {}, links: [] };\n  const seenPks = new Map<string, Set<string>>();\n  const seenLinks = new Set<string>();\n\n  for (const output of outputs) {\n    mergeObjectsInto(merged, output.objects, schemaMap, seenPks);\n    mergeLinksInto(merged, output.links, seenLinks);\n  }\n  return merged;\n}\n\nfunction mergeObjectsInto(\n  merged: SeedOutput,\n  source: SeedOutput[\"objects\"],\n  schemaMap: SchemaMap,\n  seenPks: Map<string, Set<string>>,\n): void {\n  for (const [apiName, objects] of Object.entries(source)) {\n    const schema = schemaMap.get(apiName);\n    if (!schema) {\n      throw new Error(\n        `Object type '${apiName}' in seed data is not defined in the ontology`,\n      );\n    }\n\n    const bucket = (merged.objects[apiName] ??= []);\n    const pkSet = getOrInit(seenPks, apiName, () => new Set<string>());\n\n    for (const obj of objects) {\n      const pk = String(obj[schema.primaryKeyApiName] ?? \"\");\n      if (pkSet.has(pk)) {\n        throw new Error(\n          `Duplicate primary key '${pk}' for '${apiName}' across seed files`,\n        );\n      }\n      pkSet.add(pk);\n      bucket.push(obj);\n    }\n  }\n}\n\nfunction mergeLinksInto(\n  merged: SeedOutput,\n  source: SeedOutput[\"links\"],\n  seenLinks: Set<string>,\n): void {\n  for (const link of source) {\n    const key = linkKey(link);\n    if (seenLinks.has(key)) {\n      consola.warn(\n        `Duplicate link deduplicated: ${link.linkType}`\n          + ` from ${link.sourceObjectType}:${link.sourceKey}`\n          + ` to ${link.targetObjectType}:${link.targetKey}`,\n      );\n      continue;\n    }\n    seenLinks.add(key);\n    merged.links.push(link);\n  }\n}\n\nfunction linkKey(link: SeedLinkEntry): string {\n  return `${link.sourceObjectType}:${link.sourceKey}`\n    + `:${link.linkType}`\n    + `:${link.targetObjectType}:${link.targetKey}`;\n}\n\nfunction getOrInit<K, V>(map: Map<K, V>, key: K, init: () => V): V {\n  let value = map.get(key);\n  if (value === undefined) {\n    value = init();\n    map.set(key, value);\n  }\n  return value;\n}\n\n/**\n * Validates the seed output against the ontology schema.\n *\n * Hard errors (thrown immediately) for any of:\n *\n *   - Object types in the seed output not defined in the ontology.\n *   - Property names on a seed object not defined on that type.\n *   - `null`/`undefined` property values. Typed callers can't reach this\n *     (the builder's `SeedProps<Q>` rejects `null`); any null at runtime is\n *     a sign of `as any` or a hand-rolled output.\n *   - JS type mismatches against the cataloged wire-type-to-JS-type map\n *     (e.g., `age: \"30\"` when `age` is an integer, or `score: 30` when\n *     `score` is a long).\n *\n * For wire types whose runtime shape this validator doesn't catalog\n * (`attachment`, `mediaReference`, `geopoint`, `geoshape`, `vector`,\n * `array`, `struct`), JS-type checking is skipped — they have non-primitive\n * shapes that would need bespoke validation. They still go through the\n * earlier object-type / property-name / null checks.\n *\n * After JS-type validation, string values are checked against the format\n * regex for their wire type (timestamp, date, datetime, long, decimal).\n * The one thing TypeScript cannot distinguish on its own is whether a\n * `string` value matches its wire format (e.g., `\"not-a-date\"` vs\n * `\"2025-01-01T00:00:00Z\"` are both valid `string` to the type system);\n * format validation fills that gap.\n *\n * @throws Error on any structural violation listed above, or listing all\n *         format failures grouped by object type.\n */\nexport function validateSeedOutput(\n  output: SeedOutput,\n  schemaMap: SchemaMap,\n): void {\n  const errors = validateAndCollectFormatErrors(output, schemaMap);\n  if (errors.length > 0) {\n    throw new Error(formatValidationErrors(errors));\n  }\n}\n\nfunction validateAndCollectFormatErrors(\n  output: SeedOutput,\n  schemaMap: SchemaMap,\n): FormatError[] {\n  const errors: FormatError[] = [];\n\n  for (const [apiName, objects] of Object.entries(output.objects)) {\n    const schema = schemaMap.get(apiName);\n    if (!schema) {\n      throw new Error(\n        `Object type '${apiName}' in seed data is not defined in the ontology`,\n      );\n    }\n\n    for (const [i, obj] of objects.entries()) {\n      for (const [key, value] of Object.entries(obj)) {\n        const wireType = schema.properties.get(key);\n        if (wireType === undefined) {\n          throw new Error(\n            `Property '${key}' on '${apiName}' object`\n              + ` (index ${i}) is not defined in the ontology`,\n          );\n        }\n\n        if (value == null) {\n          throw new Error(\n            `Property '${key}' on '${apiName}' object`\n              + ` (index ${i}) is null or undefined`,\n          );\n        }\n\n        const expectedJsType = EXPECTED_JS_TYPE[wireType];\n        if (expectedJsType !== undefined && typeof value !== expectedJsType) {\n          throw new Error(\n            `Property '${key}' on '${apiName}' object`\n              + ` (index ${i}) expects ${wireType} (a ${expectedJsType})`\n              + ` but got ${typeof value}`,\n          );\n        }\n\n        const format = WIRE_TYPE_FORMAT[wireType];\n        if (!format) continue;\n\n        // Format regex only applies to string-encoded wire types, all of\n        // which have EXPECTED_JS_TYPE === \"string\"; the cast is safe here\n        // because the JS-type check above would have thrown otherwise.\n        if (format.pattern.test(value as string)) continue;\n\n        errors.push({\n          objectType: apiName,\n          objectIndex: i,\n          field: key,\n          message: `property '${key}' has invalid ${wireType}`\n            + ` format: '${\n              String(value)\n            }'. Expected format like '${format.example}'`,\n        });\n      }\n    }\n  }\n\n  return errors;\n}\n\nfunction formatValidationErrors(errors: FormatError[]): string {\n  const grouped = new Map<string, string[]>();\n  for (const err of errors) {\n    const messages = getOrInit(grouped, err.objectType, () => []);\n    messages.push(`  object[${err.objectIndex}]: ${err.message}`);\n  }\n\n  const body = [...grouped.entries()]\n    .map(([type, msgs]) => `${type}:\\n${msgs.join(\"\\n\")}`)\n    .join(\"\\n\\n\");\n\n  const errorWord = errors.length === 1 ? \"error\" : \"errors\";\n  const typeWord = grouped.size === 1 ? \"object type\" : \"object types\";\n\n  return `Seed data validation failed `\n    + `(${errors.length} ${errorWord} across ${grouped.size} ${typeWord}`\n    + `):\\n\\n${body}`;\n}\n\n/**\n * Loads a single seed file via jiti and extracts its default export.\n *\n * jiti.import() fully executes the module — the `createSeed()` builder\n * function runs during import and the default export is the resulting\n * SeedOutput.\n *\n * @throws with a contextual message wrapping the original error and filename.\n */\nasync function loadSeedFile(seedFile: string): Promise<SeedOutput> {\n  consola.info(`Loading seed file: ${seedFile}`);\n\n  let seedModule: { default: SeedOutput };\n  try {\n    const jiti = createJiti(seedFile, {\n      moduleCache: false,\n      debug: false,\n    });\n    seedModule = await jiti.import(seedFile) as { default: SeedOutput };\n  } catch (e: unknown) {\n    const message = e instanceof Error ? e.message : String(e);\n    throw new Error(\n      `Seed file '${path.basename(seedFile)}' failed to compile:\\n  ${message}`,\n    );\n  }\n\n  if (!seedModule.default || typeof seedModule.default !== \"object\") {\n    throw new Error(\n      `Seed file '${path.basename(seedFile)}' must have a default export. `\n        + `Use createSeed() from @osdk/seed-helpers.`,\n    );\n  }\n\n  const output = seedModule.default;\n\n  if (!output.objects || typeof output.objects !== \"object\") {\n    throw new Error(\n      `Seed file '${path.basename(seedFile)}' default export is not a valid`\n        + ` SeedOutput. Use createSeed() from @osdk/seed-helpers.`,\n    );\n  }\n\n  // Normalize: links are optional in the export but required in SeedOutput.\n  // Spread to avoid mutating the module's exported object.\n  return { ...output, links: output.links ?? [] };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/index.js

@@ -0,0 +1,19 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export { compileSeedData, mergeSeedOutputs, validateSeedOutput } from "./compileSeedData.js";
+export { schemaFromMetadata } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/build/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["compileSeedData","mergeSeedOutputs","validateSeedOutput","schemaFromMetadata"],"sources":["index.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport {\n  compileSeedData,\n  mergeSeedOutputs,\n  validateSeedOutput,\n} from \"./compileSeedData.js\";\nexport { schemaFromMetadata } from \"./schema.js\";\nexport type { ObjectTypeSchema, SchemaMap } from \"./schema.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SACEA,eAAe,EACfC,gBAAgB,EAChBC,kBAAkB,QACb,sBAAsB;AAC7B,SAASC,kBAAkB,QAAQ,aAAa","ignoreList":[]}

package/build/browser/schema.js

@@ -0,0 +1,51 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Minimal schema for one object type — only what the compiler needs.
+ *
+ * - `properties`: property API name → wire type (e.g. `"timestamp"`, `"long"`),
+ *   used by the validator to enforce property existence, JS-type expectations,
+ *   and string format regexes.
+ * - `primaryKeyApiName`: PK field name (for cross-file duplicate detection in merge).
+ */
+
+/** Maps object type API name → its schema. */
+
+/**
+ * Builds a {@link SchemaMap} from an `OntologyFullMetadata` document — the
+ * shape produced by the OSDK SDK generator and serialized to
+ * `ontology-metadata.json` alongside the generated `@ontology/sdk` package.
+ *
+ * Only `objectTypes` are read; the other top-level fields (action types,
+ * query types, interfaces, etc.) are not relevant to seed validation.
+ */
+export function schemaFromMetadata(metadata) {
+  const map = new Map();
+  for (const [apiName, full] of Object.entries(metadata.objectTypes)) {
+    const ot = full.objectType;
+    const properties = new Map();
+    for (const [propApiName, prop] of Object.entries(ot.properties)) {
+      properties.set(propApiName, prop.dataType.type);
+    }
+    map.set(apiName, {
+      properties,
+      primaryKeyApiName: ot.primaryKey
+    });
+  }
+  return map;
+}
+//# sourceMappingURL=schema.js.map

package/build/browser/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":["schemaFromMetadata","metadata","map","Map","apiName","full","Object","entries","objectTypes","ot","objectType","properties","propApiName","prop","set","dataType","type","primaryKeyApiName","primaryKey"],"sources":["schema.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { OntologyFullMetadata } from \"@osdk/foundry.ontologies\";\n\n/**\n * Minimal schema for one object type — only what the compiler needs.\n *\n * - `properties`: property API name → wire type (e.g. `\"timestamp\"`, `\"long\"`),\n *   used by the validator to enforce property existence, JS-type expectations,\n *   and string format regexes.\n * - `primaryKeyApiName`: PK field name (for cross-file duplicate detection in merge).\n */\nexport interface ObjectTypeSchema {\n  properties: Map<string, string>;\n  primaryKeyApiName: string;\n}\n\n/** Maps object type API name → its schema. */\nexport type SchemaMap = Map<string, ObjectTypeSchema>;\n\n/**\n * Builds a {@link SchemaMap} from an `OntologyFullMetadata` document — the\n * shape produced by the OSDK SDK generator and serialized to\n * `ontology-metadata.json` alongside the generated `@ontology/sdk` package.\n *\n * Only `objectTypes` are read; the other top-level fields (action types,\n * query types, interfaces, etc.) are not relevant to seed validation.\n */\nexport function schemaFromMetadata(\n  metadata: OntologyFullMetadata,\n): SchemaMap {\n  const map: SchemaMap = new Map();\n\n  for (const [apiName, full] of Object.entries(metadata.objectTypes)) {\n    const ot = full.objectType;\n\n    const properties = new Map<string, string>();\n    for (const [propApiName, prop] of Object.entries(ot.properties)) {\n      properties.set(propApiName, prop.dataType.type);\n    }\n\n    map.set(apiName, {\n      properties,\n      primaryKeyApiName: ot.primaryKey,\n    });\n  }\n\n  return map;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,kBAAkBA,CAChCC,QAA8B,EACnB;EACX,MAAMC,GAAc,GAAG,IAAIC,GAAG,CAAC,CAAC;EAEhC,KAAK,MAAM,CAACC,OAAO,EAAEC,IAAI,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACN,QAAQ,CAACO,WAAW,CAAC,EAAE;IAClE,MAAMC,EAAE,GAAGJ,IAAI,CAACK,UAAU;IAE1B,MAAMC,UAAU,GAAG,IAAIR,GAAG,CAAiB,CAAC;IAC5C,KAAK,MAAM,CAACS,WAAW,EAAEC,IAAI,CAAC,IAAIP,MAAM,CAACC,OAAO,CAACE,EAAE,CAACE,UAAU,CAAC,EAAE;MAC/DA,UAAU,CAACG,GAAG,CAACF,WAAW,EAAEC,IAAI,CAACE,QAAQ,CAACC,IAAI,CAAC;IACjD;IAEAd,GAAG,CAACY,GAAG,CAACV,OAAO,EAAE;MACfO,UAAU;MACVM,iBAAiB,EAAER,EAAE,CAACS;IACxB,CAAC,CAAC;EACJ;EAEA,OAAOhB,GAAG;AACZ","ignoreList":[]}