@osdk/seed-helpers 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @osdk/seed-helpers
+
+## 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
+
+- @osdk/api@2.18.0

package/build/browser/SeedBuilder.js

@@ -0,0 +1,196 @@
+/*
+ * 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.
+ */
+
+/** Internal representation of a resolved link before validation. */
+
+/** Checks whether a value is a {@link SeedRef} returned by `SeedBuilder.add()`. */
+function isSeedRef(value) {
+  return typeof value === "object" && value != null && "__objectTypeApiName" in value && "__primaryKey" in value;
+}
+
+/**
+ * Resolves a link from two {@link SeedRef} instances.
+ * Extracts the object type and primary key from each ref.
+ */
+function resolveFromRefs(src, srcLinkName, dst) {
+  return {
+    sourceObjectType: src.__objectTypeApiName,
+    sourceKey: String(src.__primaryKey),
+    linkType: srcLinkName,
+    targetObjectType: dst.__objectTypeApiName,
+    targetKey: String(dst.__primaryKey)
+  };
+}
+
+/**
+ * Resolves a link from two {@link ObjectTypeDefinition} instances and explicit primary keys.
+ * Reads the `apiName` from each type definition.
+ */
+function resolveFromTypes(srcType, srcPk, srcLinkName, dstType, dstPk) {
+  return {
+    sourceObjectType: srcType.apiName,
+    sourceKey: String(srcPk),
+    linkType: srcLinkName,
+    targetObjectType: dstType.apiName,
+    targetKey: String(dstPk)
+  };
+}
+
+/**
+ * A lightweight, type-safe builder for constructing seed data.
+ *
+ * TypeScript catches everything expressible at the call site: property
+ * names and value types, required primary keys, link names valid on the
+ * source type, and link target types matching what the link points to.
+ */
+export class SeedBuilder {
+  #objects = new Map();
+  #refs = new Set();
+  #links = [];
+
+  /**
+   * Register a seed object and return a typed reference for use in {@link link}.
+   *
+   * Property names and value types are validated at compile time against the
+   * generated SDK type. Non-nullable properties (including the primary key)
+   * are required.
+   *
+   * @param type  - The generated SDK object type definition (e.g., `Product`).
+   * @param props - Property values for the object. Must match the SDK type's property schema.
+   * @returns A frozen {@link SeedRef} carrying the object type and primary key.
+   * @throws if the primary key is null, undefined, or already registered for this type.
+   * @throws if the object type definition is missing `apiName` or `primaryKeyApiName`.
+   */
+  add(type, props) {
+    // Runtime guards for callers who bypass the type system with `as any`.
+    // Properly-typed ObjectTypeDefinition values can't reach these.
+    const apiName = type.apiName;
+    const pkApiName = type.primaryKeyApiName;
+    if (!apiName) {
+      throw new Error("Object type is missing apiName");
+    }
+    if (!pkApiName) {
+      throw new Error(`[${apiName}] Object type is missing primaryKeyApiName`);
+    }
+    const record = props;
+    const pkValue = record[pkApiName];
+    if (pkValue == null) {
+      throw new Error(`[${apiName}] Primary key '${pkApiName}' is null or undefined`);
+    }
+    const pk = String(pkValue);
+    let typeMap = this.#objects.get(apiName);
+    if (!typeMap) {
+      typeMap = new Map();
+      this.#objects.set(apiName, typeMap);
+    }
+    if (typeMap.has(pk)) {
+      throw new Error(`[${apiName}] Duplicate primary key '${pk}'`);
+    }
+    typeMap.set(pk, {
+      ...record
+    });
+    this.#refs.add(`${apiName}:${pk}`);
+    return Object.freeze({
+      __objectTypeApiName: apiName,
+      __primaryKey: pkValue
+    });
+  }
+
+  /**
+   * Register a link between two seed objects.
+   *
+   * Supports two calling conventions that produce identical output:
+   * by-reference (passing `SeedRef`s returned from {@link add}) or by-type
+   * and primary-key. See the `@osdk/seed-compiler` README for usage examples.
+   *
+   * @param name - A descriptive label for this link (included in seed output and error messages).
+   * @throws if either source or target object was not registered via {@link add}.
+   */
+
+  link(name, srcOrType, linkNameOrPk, dstOrLinkName, typeOrLinkName, dstPk) {
+    const resolved = isSeedRef(srcOrType) ? resolveFromRefs(srcOrType, linkNameOrPk, dstOrLinkName) : resolveFromTypes(srcOrType, linkNameOrPk, dstOrLinkName, typeOrLinkName, dstPk);
+    this.#assertRegistered(resolved.sourceObjectType, resolved.sourceKey, "Source", name);
+    this.#assertRegistered(resolved.targetObjectType, resolved.targetKey, "Target", name);
+    this.#links.push({
+      name,
+      ...resolved
+    });
+  }
+
+  /**
+   * Asserts that an object with the given type and key was registered via {@link add}.
+   * @throws with a descriptive message including the link name for context.
+   */
+  #assertRegistered(objectType, key, role, linkName) {
+    const ref = `${objectType}:${key}`;
+    if (!this.#refs.has(ref)) {
+      throw new Error(`${role} '${ref}' not registered (link '${linkName}')`);
+    }
+  }
+
+  /**
+   * Build the final {@link SeedOutput} from all registered objects and links.
+   *
+   * The returned arrays are fresh copies, so a subsequent `add()` or `link()`
+   * call does not retroactively grow or shrink an array that was already
+   * returned. The property records inside the arrays, however, are shared
+   * references with the builder's internal storage — mutating
+   * `output.objects.Employee[0].name = "x"` *will* propagate into the
+   * builder and into anything else holding a previous output. Treat the
+   * output as read-only, or deep-clone it before mutating.
+   *
+   * Inputs to {@link add} are still safe to mutate after calling: `add` stores
+   * a shallow copy of the props record on registration.
+   */
+  build() {
+    const objects = {};
+    for (const [apiName, typeMap] of this.#objects) {
+      objects[apiName] = [...typeMap.values()];
+    }
+    return {
+      objects,
+      links: [...this.#links]
+    };
+  }
+}
+
+/**
+ * Create seed data using a builder function.
+ *
+ * The builder is created, passed to `fn`, and the resulting {@link SeedOutput}
+ * is returned as the module's default export for consumption by the seed compiler.
+ *
+ * @param fn - A function that registers objects and links on the provided {@link SeedBuilder}.
+ * @returns The built {@link SeedOutput} containing all registered objects and links.
+ *
+ * @example
+ * ```ts
+ * import { Product, Seller } from "@ontology/sdk";
+ * import { createSeed } from "@osdk/seed-helpers";
+ *
+ * export default createSeed((seed) => {
+ *   const prod = seed.add(Product, { pk: "prod-001", title: "Widget", price: 100 });
+ *   const alice = seed.add(Seller, { pk: "seller-001", name: "Alice" });
+ *   seed.link("widget-seller", prod, "sellers", alice, "products");
+ * });
+ * ```
+ */
+export function createSeed(fn) {
+  const builder = new SeedBuilder();
+  fn(builder);
+  return builder.build();
+}
+//# sourceMappingURL=SeedBuilder.js.map

package/build/browser/SeedBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedBuilder.js","names":["isSeedRef","value","resolveFromRefs","src","srcLinkName","dst","sourceObjectType","__objectTypeApiName","sourceKey","String","__primaryKey","linkType","targetObjectType","targetKey","resolveFromTypes","srcType","srcPk","dstType","dstPk","apiName","SeedBuilder","objects","Map","refs","Set","links","add","type","props","pkApiName","primaryKeyApiName","Error","record","pkValue","pk","typeMap","get","set","has","Object","freeze","link","name","srcOrType","linkNameOrPk","dstOrLinkName","typeOrLinkName","resolved","assertRegistered","push","#assertRegistered","objectType","key","role","linkName","ref","build","values","createSeed","fn","builder"],"sources":["SeedBuilder.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 { LinkedType, LinkNames, ObjectTypeDefinition } from \"@osdk/api\";\nimport type { SeedLinkEntry, SeedOutput, SeedProps, SeedRef } from \"./types.js\";\n\n/** Internal representation of a resolved link before validation. */\ninterface ResolvedLink {\n  sourceObjectType: string;\n  sourceKey: string;\n  linkType: string;\n  targetObjectType: string;\n  targetKey: string;\n}\n\n/** Checks whether a value is a {@link SeedRef} returned by `SeedBuilder.add()`. */\nfunction isSeedRef(value: unknown): value is SeedRef {\n  return typeof value === \"object\"\n    && value != null\n    && \"__objectTypeApiName\" in value\n    && \"__primaryKey\" in value;\n}\n\n/**\n * Resolves a link from two {@link SeedRef} instances.\n * Extracts the object type and primary key from each ref.\n */\nfunction resolveFromRefs(\n  src: SeedRef,\n  srcLinkName: string,\n  dst: SeedRef,\n): ResolvedLink {\n  return {\n    sourceObjectType: src.__objectTypeApiName,\n    sourceKey: String(src.__primaryKey),\n    linkType: srcLinkName,\n    targetObjectType: dst.__objectTypeApiName,\n    targetKey: String(dst.__primaryKey),\n  };\n}\n\n/**\n * Resolves a link from two {@link ObjectTypeDefinition} instances and explicit primary keys.\n * Reads the `apiName` from each type definition.\n */\nfunction resolveFromTypes(\n  srcType: ObjectTypeDefinition,\n  srcPk: string | number,\n  srcLinkName: string,\n  dstType: ObjectTypeDefinition,\n  dstPk: string | number,\n): ResolvedLink {\n  return {\n    sourceObjectType: srcType.apiName,\n    sourceKey: String(srcPk),\n    linkType: srcLinkName,\n    targetObjectType: dstType.apiName,\n    targetKey: String(dstPk),\n  };\n}\n\n/**\n * A lightweight, type-safe builder for constructing seed data.\n *\n * TypeScript catches everything expressible at the call site: property\n * names and value types, required primary keys, link names valid on the\n * source type, and link target types matching what the link points to.\n */\nexport class SeedBuilder {\n  readonly #objects = new Map<string, Map<string, Record<string, unknown>>>();\n  readonly #refs = new Set<string>();\n  readonly #links: SeedLinkEntry[] = [];\n\n  /**\n   * Register a seed object and return a typed reference for use in {@link link}.\n   *\n   * Property names and value types are validated at compile time against the\n   * generated SDK type. Non-nullable properties (including the primary key)\n   * are required.\n   *\n   * @param type  - The generated SDK object type definition (e.g., `Product`).\n   * @param props - Property values for the object. Must match the SDK type's property schema.\n   * @returns A frozen {@link SeedRef} carrying the object type and primary key.\n   * @throws if the primary key is null, undefined, or already registered for this type.\n   * @throws if the object type definition is missing `apiName` or `primaryKeyApiName`.\n   */\n  add<Q extends ObjectTypeDefinition>(\n    type: Q,\n    props: SeedProps<Q>,\n  ): SeedRef<Q> {\n    // Runtime guards for callers who bypass the type system with `as any`.\n    // Properly-typed ObjectTypeDefinition values can't reach these.\n    const apiName = type.apiName;\n    const pkApiName = type.primaryKeyApiName;\n\n    if (!apiName) {\n      throw new Error(\"Object type is missing apiName\");\n    }\n    if (!pkApiName) {\n      throw new Error(`[${apiName}] Object type is missing primaryKeyApiName`);\n    }\n\n    const record = props as Record<string, unknown>;\n    const pkValue = record[pkApiName];\n\n    if (pkValue == null) {\n      throw new Error(\n        `[${apiName}] Primary key '${pkApiName}' is null or undefined`,\n      );\n    }\n\n    const pk = String(pkValue);\n\n    let typeMap = this.#objects.get(apiName);\n    if (!typeMap) {\n      typeMap = new Map();\n      this.#objects.set(apiName, typeMap);\n    }\n\n    if (typeMap.has(pk)) {\n      throw new Error(`[${apiName}] Duplicate primary key '${pk}'`);\n    }\n\n    typeMap.set(pk, { ...record });\n    this.#refs.add(`${apiName}:${pk}`);\n\n    return Object.freeze({\n      __objectTypeApiName: apiName,\n      __primaryKey: pkValue as string | number,\n    }) as SeedRef<Q>;\n  }\n\n  /**\n   * Register a link between two seed objects.\n   *\n   * Supports two calling conventions that produce identical output:\n   * by-reference (passing `SeedRef`s returned from {@link add}) or by-type\n   * and primary-key. See the `@osdk/seed-compiler` README for usage examples.\n   *\n   * @param name - A descriptive label for this link (included in seed output and error messages).\n   * @throws if either source or target object was not registered via {@link add}.\n   */\n  link<\n    S extends ObjectTypeDefinition,\n    SL extends LinkNames<S>,\n    D extends LinkedType<S, SL>,\n    DL extends LinkNames<D>,\n  >(\n    name: string,\n    src: SeedRef<S>,\n    srcLinkName: SL,\n    dst: SeedRef<D>,\n    dstLinkName: DL,\n  ): void;\n  link<\n    S extends ObjectTypeDefinition,\n    SL extends LinkNames<S>,\n    D extends LinkedType<S, SL>,\n    DL extends LinkNames<D>,\n  >(\n    name: string,\n    srcType: S,\n    srcPk: string | number,\n    srcLinkName: SL,\n    dstType: D,\n    dstPk: string | number,\n    dstLinkName: DL,\n  ): void;\n  link(\n    name: string,\n    srcOrType: SeedRef | ObjectTypeDefinition,\n    linkNameOrPk: string | number,\n    dstOrLinkName: SeedRef | ObjectTypeDefinition | string,\n    typeOrLinkName?: ObjectTypeDefinition | string,\n    dstPk?: string | number,\n    _dstLinkName?: string,\n  ): void {\n    const resolved = isSeedRef(srcOrType)\n      ? resolveFromRefs(\n        srcOrType,\n        linkNameOrPk as string,\n        dstOrLinkName as SeedRef,\n      )\n      : resolveFromTypes(\n        srcOrType,\n        linkNameOrPk,\n        dstOrLinkName as string,\n        typeOrLinkName as ObjectTypeDefinition,\n        dstPk!,\n      );\n\n    this.#assertRegistered(\n      resolved.sourceObjectType,\n      resolved.sourceKey,\n      \"Source\",\n      name,\n    );\n    this.#assertRegistered(\n      resolved.targetObjectType,\n      resolved.targetKey,\n      \"Target\",\n      name,\n    );\n\n    this.#links.push({ name, ...resolved });\n  }\n\n  /**\n   * Asserts that an object with the given type and key was registered via {@link add}.\n   * @throws with a descriptive message including the link name for context.\n   */\n  #assertRegistered(\n    objectType: string,\n    key: string,\n    role: \"Source\" | \"Target\",\n    linkName: string,\n  ): void {\n    const ref = `${objectType}:${key}`;\n    if (!this.#refs.has(ref)) {\n      throw new Error(\n        `${role} '${ref}' not registered (link '${linkName}')`,\n      );\n    }\n  }\n\n  /**\n   * Build the final {@link SeedOutput} from all registered objects and links.\n   *\n   * The returned arrays are fresh copies, so a subsequent `add()` or `link()`\n   * call does not retroactively grow or shrink an array that was already\n   * returned. The property records inside the arrays, however, are shared\n   * references with the builder's internal storage — mutating\n   * `output.objects.Employee[0].name = \"x\"` *will* propagate into the\n   * builder and into anything else holding a previous output. Treat the\n   * output as read-only, or deep-clone it before mutating.\n   *\n   * Inputs to {@link add} are still safe to mutate after calling: `add` stores\n   * a shallow copy of the props record on registration.\n   */\n  build(): SeedOutput {\n    const objects: Record<string, Array<Record<string, unknown>>> = {};\n    for (const [apiName, typeMap] of this.#objects) {\n      objects[apiName] = [...typeMap.values()];\n    }\n    return { objects, links: [...this.#links] };\n  }\n}\n\n/**\n * Create seed data using a builder function.\n *\n * The builder is created, passed to `fn`, and the resulting {@link SeedOutput}\n * is returned as the module's default export for consumption by the seed compiler.\n *\n * @param fn - A function that registers objects and links on the provided {@link SeedBuilder}.\n * @returns The built {@link SeedOutput} containing all registered objects and links.\n *\n * @example\n * ```ts\n * import { Product, Seller } from \"@ontology/sdk\";\n * import { createSeed } from \"@osdk/seed-helpers\";\n *\n * export default createSeed((seed) => {\n *   const prod = seed.add(Product, { pk: \"prod-001\", title: \"Widget\", price: 100 });\n *   const alice = seed.add(Seller, { pk: \"seller-001\", name: \"Alice\" });\n *   seed.link(\"widget-seller\", prod, \"sellers\", alice, \"products\");\n * });\n * ```\n */\nexport function createSeed(fn: (seed: SeedBuilder) => void): SeedOutput {\n  const builder = new SeedBuilder();\n  fn(builder);\n  return builder.build();\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/index.js

@@ -0,0 +1,18 @@
+/*
+ * 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 { createSeed, SeedBuilder } from "./SeedBuilder.js";
+//# sourceMappingURL=index.js.map

package/build/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["createSeed","SeedBuilder"],"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 { createSeed, SeedBuilder } from \"./SeedBuilder.js\";\nexport type { SeedLinkEntry, SeedOutput, SeedProps, SeedRef } from \"./types.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,UAAU,EAAEC,WAAW,QAAQ,kBAAkB","ignoreList":[]}

package/build/browser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["types.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 { CompileTimeMetadata, ObjectTypeDefinition } from \"@osdk/api\";\n\n/**\n * Makes nullable properties optional while keeping non-nullable ones required.\n * `{ id: string; title: string | undefined }` becomes `{ id: string; title?: string }`.\n * This ensures required fields like primary keys must always be provided.\n */\ntype PartialForOptionalProperties<T> =\n  & {\n    [K in keyof T as undefined extends T[K] ? K : never]?: NonNullable<T[K]>;\n  }\n  & {\n    [K in keyof T as undefined extends T[K] ? never : K]-?: T[K];\n  };\n\n/**\n * Derives the property types for seed data from the generated SDK type.\n * Uses CompileTimeMetadata<T>[\"props\"] which resolves to the Props interface\n * on generated types (e.g., Employee.Props). Non-nullable properties like the\n * primary key are required; nullable properties are optional.\n */\nexport type SeedProps<T extends ObjectTypeDefinition> =\n  PartialForOptionalProperties<\n    CompileTimeMetadata<T>[\"props\"]\n  >;\n\n/**\n * Unique symbol used to brand {@link SeedRef} instances. A branded type prevents\n * manually constructed objects from satisfying the interface — only `SeedBuilder.add()`\n * can produce a valid `SeedRef`. This ensures `link()` generics always have the\n * correct object type for compile-time link name and target type validation.\n */\ndeclare const SEED_REF_BRAND: unique symbol;\n\n/**\n * A typed reference returned by SeedBuilder.add(). The branded symbol field\n * carries the object type as a generic, enabling compile-time link validation.\n *\n * Cannot be constructed manually — the unique symbol key is not exported and\n * only `SeedBuilder.add()` can produce a valid `SeedRef` via an `as` cast.\n */\nexport interface SeedRef<\n  Q extends ObjectTypeDefinition = ObjectTypeDefinition,\n> {\n  readonly __objectTypeApiName: string;\n  readonly __primaryKey: string | number;\n  /** @internal Brand field — never set at runtime. Enforces nominal typing. */\n  readonly [SEED_REF_BRAND]: Q;\n}\n\n/** A link entry in the seed output. */\nexport interface SeedLinkEntry {\n  name: string;\n  linkType: string;\n  sourceObjectType: string;\n  sourceKey: string;\n  targetObjectType: string;\n  targetKey: string;\n}\n\n/** The final serializable seed data output. */\nexport interface SeedOutput {\n  objects: Record<string, Array<Record<string, unknown>>>;\n  links: SeedLinkEntry[];\n}\n"],"mappings":"","ignoreList":[]}

package/build/cjs/index.cjs

@@ -0,0 +1,137 @@
+'use strict';
+
+// src/SeedBuilder.ts
+function isSeedRef(value) {
+  return typeof value === "object" && value != null && "__objectTypeApiName" in value && "__primaryKey" in value;
+}
+function resolveFromRefs(src, srcLinkName, dst) {
+  return {
+    sourceObjectType: src.__objectTypeApiName,
+    sourceKey: String(src.__primaryKey),
+    linkType: srcLinkName,
+    targetObjectType: dst.__objectTypeApiName,
+    targetKey: String(dst.__primaryKey)
+  };
+}
+function resolveFromTypes(srcType, srcPk, srcLinkName, dstType, dstPk) {
+  return {
+    sourceObjectType: srcType.apiName,
+    sourceKey: String(srcPk),
+    linkType: srcLinkName,
+    targetObjectType: dstType.apiName,
+    targetKey: String(dstPk)
+  };
+}
+var SeedBuilder = class {
+  #objects = /* @__PURE__ */ new Map();
+  #refs = /* @__PURE__ */ new Set();
+  #links = [];
+  /**
+   * Register a seed object and return a typed reference for use in {@link link}.
+   *
+   * Property names and value types are validated at compile time against the
+   * generated SDK type. Non-nullable properties (including the primary key)
+   * are required.
+   *
+   * @param type  - The generated SDK object type definition (e.g., `Product`).
+   * @param props - Property values for the object. Must match the SDK type's property schema.
+   * @returns A frozen {@link SeedRef} carrying the object type and primary key.
+   * @throws if the primary key is null, undefined, or already registered for this type.
+   * @throws if the object type definition is missing `apiName` or `primaryKeyApiName`.
+   */
+  add(type, props) {
+    const apiName = type.apiName;
+    const pkApiName = type.primaryKeyApiName;
+    if (!apiName) {
+      throw new Error("Object type is missing apiName");
+    }
+    if (!pkApiName) {
+      throw new Error(`[${apiName}] Object type is missing primaryKeyApiName`);
+    }
+    const record = props;
+    const pkValue = record[pkApiName];
+    if (pkValue == null) {
+      throw new Error(`[${apiName}] Primary key '${pkApiName}' is null or undefined`);
+    }
+    const pk = String(pkValue);
+    let typeMap = this.#objects.get(apiName);
+    if (!typeMap) {
+      typeMap = /* @__PURE__ */ new Map();
+      this.#objects.set(apiName, typeMap);
+    }
+    if (typeMap.has(pk)) {
+      throw new Error(`[${apiName}] Duplicate primary key '${pk}'`);
+    }
+    typeMap.set(pk, {
+      ...record
+    });
+    this.#refs.add(`${apiName}:${pk}`);
+    return Object.freeze({
+      __objectTypeApiName: apiName,
+      __primaryKey: pkValue
+    });
+  }
+  /**
+   * Register a link between two seed objects.
+   *
+   * Supports two calling conventions that produce identical output:
+   * by-reference (passing `SeedRef`s returned from {@link add}) or by-type
+   * and primary-key. See the `@osdk/seed-compiler` README for usage examples.
+   *
+   * @param name - A descriptive label for this link (included in seed output and error messages).
+   * @throws if either source or target object was not registered via {@link add}.
+   */
+  link(name, srcOrType, linkNameOrPk, dstOrLinkName, typeOrLinkName, dstPk, _dstLinkName) {
+    const resolved = isSeedRef(srcOrType) ? resolveFromRefs(srcOrType, linkNameOrPk, dstOrLinkName) : resolveFromTypes(srcOrType, linkNameOrPk, dstOrLinkName, typeOrLinkName, dstPk);
+    this.#assertRegistered(resolved.sourceObjectType, resolved.sourceKey, "Source", name);
+    this.#assertRegistered(resolved.targetObjectType, resolved.targetKey, "Target", name);
+    this.#links.push({
+      name,
+      ...resolved
+    });
+  }
+  /**
+   * Asserts that an object with the given type and key was registered via {@link add}.
+   * @throws with a descriptive message including the link name for context.
+   */
+  #assertRegistered(objectType, key, role, linkName) {
+    const ref = `${objectType}:${key}`;
+    if (!this.#refs.has(ref)) {
+      throw new Error(`${role} '${ref}' not registered (link '${linkName}')`);
+    }
+  }
+  /**
+   * Build the final {@link SeedOutput} from all registered objects and links.
+   *
+   * The returned arrays are fresh copies, so a subsequent `add()` or `link()`
+   * call does not retroactively grow or shrink an array that was already
+   * returned. The property records inside the arrays, however, are shared
+   * references with the builder's internal storage — mutating
+   * `output.objects.Employee[0].name = "x"` *will* propagate into the
+   * builder and into anything else holding a previous output. Treat the
+   * output as read-only, or deep-clone it before mutating.
+   *
+   * Inputs to {@link add} are still safe to mutate after calling: `add` stores
+   * a shallow copy of the props record on registration.
+   */
+  build() {
+    const objects = {};
+    for (const [apiName, typeMap] of this.#objects) {
+      objects[apiName] = [...typeMap.values()];
+    }
+    return {
+      objects,
+      links: [...this.#links]
+    };
+  }
+};
+function createSeed(fn) {
+  const builder = new SeedBuilder();
+  fn(builder);
+  return builder.build();
+}
+
+exports.SeedBuilder = SeedBuilder;
+exports.createSeed = createSeed;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/build/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/SeedBuilder.ts"],"names":[],"mappings":"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","file":"index.cjs","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\n/** Internal representation of a resolved link before validation. */\n\n/** Checks whether a value is a {@link SeedRef} returned by `SeedBuilder.add()`. */\nfunction isSeedRef(value) {\n  return typeof value === \"object\" && value != null && \"__objectTypeApiName\" in value && \"__primaryKey\" in value;\n}\n\n/**\n * Resolves a link from two {@link SeedRef} instances.\n * Extracts the object type and primary key from each ref.\n */\nfunction resolveFromRefs(src, srcLinkName, dst) {\n  return {\n    sourceObjectType: src.__objectTypeApiName,\n    sourceKey: String(src.__primaryKey),\n    linkType: srcLinkName,\n    targetObjectType: dst.__objectTypeApiName,\n    targetKey: String(dst.__primaryKey)\n  };\n}\n\n/**\n * Resolves a link from two {@link ObjectTypeDefinition} instances and explicit primary keys.\n * Reads the `apiName` from each type definition.\n */\nfunction resolveFromTypes(srcType, srcPk, srcLinkName, dstType, dstPk) {\n  return {\n    sourceObjectType: srcType.apiName,\n    sourceKey: String(srcPk),\n    linkType: srcLinkName,\n    targetObjectType: dstType.apiName,\n    targetKey: String(dstPk)\n  };\n}\n\n/**\n * A lightweight, type-safe builder for constructing seed data.\n *\n * TypeScript catches everything expressible at the call site: property\n * names and value types, required primary keys, link names valid on the\n * source type, and link target types matching what the link points to.\n */\nexport class SeedBuilder {\n  #objects = new Map();\n  #refs = new Set();\n  #links = [];\n\n  /**\n   * Register a seed object and return a typed reference for use in {@link link}.\n   *\n   * Property names and value types are validated at compile time against the\n   * generated SDK type. Non-nullable properties (including the primary key)\n   * are required.\n   *\n   * @param type  - The generated SDK object type definition (e.g., `Product`).\n   * @param props - Property values for the object. Must match the SDK type's property schema.\n   * @returns A frozen {@link SeedRef} carrying the object type and primary key.\n   * @throws if the primary key is null, undefined, or already registered for this type.\n   * @throws if the object type definition is missing `apiName` or `primaryKeyApiName`.\n   */\n  add(type, props) {\n    // Runtime guards for callers who bypass the type system with `as any`.\n    // Properly-typed ObjectTypeDefinition values can't reach these.\n    const apiName = type.apiName;\n    const pkApiName = type.primaryKeyApiName;\n    if (!apiName) {\n      throw new Error(\"Object type is missing apiName\");\n    }\n    if (!pkApiName) {\n      throw new Error(`[${apiName}] Object type is missing primaryKeyApiName`);\n    }\n    const record = props;\n    const pkValue = record[pkApiName];\n    if (pkValue == null) {\n      throw new Error(`[${apiName}] Primary key '${pkApiName}' is null or undefined`);\n    }\n    const pk = String(pkValue);\n    let typeMap = this.#objects.get(apiName);\n    if (!typeMap) {\n      typeMap = new Map();\n      this.#objects.set(apiName, typeMap);\n    }\n    if (typeMap.has(pk)) {\n      throw new Error(`[${apiName}] Duplicate primary key '${pk}'`);\n    }\n    typeMap.set(pk, {\n      ...record\n    });\n    this.#refs.add(`${apiName}:${pk}`);\n    return Object.freeze({\n      __objectTypeApiName: apiName,\n      __primaryKey: pkValue\n    });\n  }\n\n  /**\n   * Register a link between two seed objects.\n   *\n   * Supports two calling conventions that produce identical output:\n   * by-reference (passing `SeedRef`s returned from {@link add}) or by-type\n   * and primary-key. See the `@osdk/seed-compiler` README for usage examples.\n   *\n   * @param name - A descriptive label for this link (included in seed output and error messages).\n   * @throws if either source or target object was not registered via {@link add}.\n   */\n\n  link(name, srcOrType, linkNameOrPk, dstOrLinkName, typeOrLinkName, dstPk, _dstLinkName) {\n    const resolved = isSeedRef(srcOrType) ? resolveFromRefs(srcOrType, linkNameOrPk, dstOrLinkName) : resolveFromTypes(srcOrType, linkNameOrPk, dstOrLinkName, typeOrLinkName, dstPk);\n    this.#assertRegistered(resolved.sourceObjectType, resolved.sourceKey, \"Source\", name);\n    this.#assertRegistered(resolved.targetObjectType, resolved.targetKey, \"Target\", name);\n    this.#links.push({\n      name,\n      ...resolved\n    });\n  }\n\n  /**\n   * Asserts that an object with the given type and key was registered via {@link add}.\n   * @throws with a descriptive message including the link name for context.\n   */\n  #assertRegistered(objectType, key, role, linkName) {\n    const ref = `${objectType}:${key}`;\n    if (!this.#refs.has(ref)) {\n      throw new Error(`${role} '${ref}' not registered (link '${linkName}')`);\n    }\n  }\n\n  /**\n   * Build the final {@link SeedOutput} from all registered objects and links.\n   *\n   * The returned arrays are fresh copies, so a subsequent `add()` or `link()`\n   * call does not retroactively grow or shrink an array that was already\n   * returned. The property records inside the arrays, however, are shared\n   * references with the builder's internal storage — mutating\n   * `output.objects.Employee[0].name = \"x\"` *will* propagate into the\n   * builder and into anything else holding a previous output. Treat the\n   * output as read-only, or deep-clone it before mutating.\n   *\n   * Inputs to {@link add} are still safe to mutate after calling: `add` stores\n   * a shallow copy of the props record on registration.\n   */\n  build() {\n    const objects = {};\n    for (const [apiName, typeMap] of this.#objects) {\n      objects[apiName] = [...typeMap.values()];\n    }\n    return {\n      objects,\n      links: [...this.#links]\n    };\n  }\n}\n\n/**\n * Create seed data using a builder function.\n *\n * The builder is created, passed to `fn`, and the resulting {@link SeedOutput}\n * is returned as the module's default export for consumption by the seed compiler.\n *\n * @param fn - A function that registers objects and links on the provided {@link SeedBuilder}.\n * @returns The built {@link SeedOutput} containing all registered objects and links.\n *\n * @example\n * ```ts\n * import { Product, Seller } from \"@ontology/sdk\";\n * import { createSeed } from \"@osdk/seed-helpers\";\n *\n * export default createSeed((seed) => {\n *   const prod = seed.add(Product, { pk: \"prod-001\", title: \"Widget\", price: 100 });\n *   const alice = seed.add(Seller, { pk: \"seller-001\", name: \"Alice\" });\n *   seed.link(\"widget-seller\", prod, \"sellers\", alice, \"products\");\n * });\n * ```\n */\nexport function createSeed(fn) {\n  const builder = new SeedBuilder();\n  fn(builder);\n  return builder.build();\n}"]}

package/build/cjs/index.d.cts

@@ -0,0 +1,120 @@
+import { ObjectTypeDefinition, CompileTimeMetadata, LinkNames, LinkedType } from '@osdk/api';
+
+/**
+ * Makes nullable properties optional while keeping non-nullable ones required.
+ * `{ id: string; title: string | undefined }` becomes `{ id: string; title?: string }`.
+ * This ensures required fields like primary keys must always be provided.
+ */
+type PartialForOptionalProperties<T> = {
+    [K in keyof T as undefined extends T[K] ? K : never]?: NonNullable<T[K]>;
+} & {
+    [K in keyof T as undefined extends T[K] ? never : K]-?: T[K];
+};
+/**
+ * Derives the property types for seed data from the generated SDK type.
+ * Uses CompileTimeMetadata<T>["props"] which resolves to the Props interface
+ * on generated types (e.g., Employee.Props). Non-nullable properties like the
+ * primary key are required; nullable properties are optional.
+ */
+type SeedProps<T extends ObjectTypeDefinition> = PartialForOptionalProperties<CompileTimeMetadata<T>["props"]>;
+/**
+ * A typed reference returned by SeedBuilder.add(). The branded symbol field
+ * carries the object type as a generic, enabling compile-time link validation.
+ *
+ * Cannot be constructed manually — the unique symbol key is not exported and
+ * only `SeedBuilder.add()` can produce a valid `SeedRef` via an `as` cast.
+ */
+interface SeedRef<Q extends ObjectTypeDefinition = ObjectTypeDefinition> {
+    readonly __objectTypeApiName: string;
+    readonly __primaryKey: string | number;
+}
+/** A link entry in the seed output. */
+interface SeedLinkEntry {
+    name: string;
+    linkType: string;
+    sourceObjectType: string;
+    sourceKey: string;
+    targetObjectType: string;
+    targetKey: string;
+}
+/** The final serializable seed data output. */
+interface SeedOutput {
+    objects: Record<string, Array<Record<string, unknown>>>;
+    links: SeedLinkEntry[];
+}
+
+/**
+ * A lightweight, type-safe builder for constructing seed data.
+ *
+ * TypeScript catches everything expressible at the call site: property
+ * names and value types, required primary keys, link names valid on the
+ * source type, and link target types matching what the link points to.
+ */
+declare class SeedBuilder {
+    #private;
+    /**
+     * Register a seed object and return a typed reference for use in {@link link}.
+     *
+     * Property names and value types are validated at compile time against the
+     * generated SDK type. Non-nullable properties (including the primary key)
+     * are required.
+     *
+     * @param type  - The generated SDK object type definition (e.g., `Product`).
+     * @param props - Property values for the object. Must match the SDK type's property schema.
+     * @returns A frozen {@link SeedRef} carrying the object type and primary key.
+     * @throws if the primary key is null, undefined, or already registered for this type.
+     * @throws if the object type definition is missing `apiName` or `primaryKeyApiName`.
+     */
+    add<Q extends ObjectTypeDefinition>(type: Q, props: SeedProps<Q>): SeedRef<Q>;
+    /**
+     * Register a link between two seed objects.
+     *
+     * Supports two calling conventions that produce identical output:
+     * by-reference (passing `SeedRef`s returned from {@link add}) or by-type
+     * and primary-key. See the `@osdk/seed-compiler` README for usage examples.
+     *
+     * @param name - A descriptive label for this link (included in seed output and error messages).
+     * @throws if either source or target object was not registered via {@link add}.
+     */
+    link<S extends ObjectTypeDefinition, SL extends LinkNames<S>, D extends LinkedType<S, SL>, DL extends LinkNames<D>>(name: string, src: SeedRef<S>, srcLinkName: SL, dst: SeedRef<D>, dstLinkName: DL): void;
+    link<S extends ObjectTypeDefinition, SL extends LinkNames<S>, D extends LinkedType<S, SL>, DL extends LinkNames<D>>(name: string, srcType: S, srcPk: string | number, srcLinkName: SL, dstType: D, dstPk: string | number, dstLinkName: DL): void;
+    /**
+     * Build the final {@link SeedOutput} from all registered objects and links.
+     *
+     * The returned arrays are fresh copies, so a subsequent `add()` or `link()`
+     * call does not retroactively grow or shrink an array that was already
+     * returned. The property records inside the arrays, however, are shared
+     * references with the builder's internal storage — mutating
+     * `output.objects.Employee[0].name = "x"` *will* propagate into the
+     * builder and into anything else holding a previous output. Treat the
+     * output as read-only, or deep-clone it before mutating.
+     *
+     * Inputs to {@link add} are still safe to mutate after calling: `add` stores
+     * a shallow copy of the props record on registration.
+     */
+    build(): SeedOutput;
+}
+/**
+ * Create seed data using a builder function.
+ *
+ * The builder is created, passed to `fn`, and the resulting {@link SeedOutput}
+ * is returned as the module's default export for consumption by the seed compiler.
+ *
+ * @param fn - A function that registers objects and links on the provided {@link SeedBuilder}.
+ * @returns The built {@link SeedOutput} containing all registered objects and links.
+ *
+ * @example
+ * ```ts
+ * import { Product, Seller } from "@ontology/sdk";
+ * import { createSeed } from "@osdk/seed-helpers";
+ *
+ * export default createSeed((seed) => {
+ *   const prod = seed.add(Product, { pk: "prod-001", title: "Widget", price: 100 });
+ *   const alice = seed.add(Seller, { pk: "seller-001", name: "Alice" });
+ *   seed.link("widget-seller", prod, "sellers", alice, "products");
+ * });
+ * ```
+ */
+declare function createSeed(fn: (seed: SeedBuilder) => void): SeedOutput;
+
+export { SeedBuilder, type SeedLinkEntry, type SeedOutput, type SeedProps, type SeedRef, createSeed };

package/build/esm/SeedBuilder.js

@@ -0,0 +1,196 @@
+/*
+ * 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.
+ */
+
+/** Internal representation of a resolved link before validation. */
+
+/** Checks whether a value is a {@link SeedRef} returned by `SeedBuilder.add()`. */
+function isSeedRef(value) {
+  return typeof value === "object" && value != null && "__objectTypeApiName" in value && "__primaryKey" in value;
+}
+
+/**
+ * Resolves a link from two {@link SeedRef} instances.
+ * Extracts the object type and primary key from each ref.
+ */
+function resolveFromRefs(src, srcLinkName, dst) {
+  return {
+    sourceObjectType: src.__objectTypeApiName,
+    sourceKey: String(src.__primaryKey),
+    linkType: srcLinkName,
+    targetObjectType: dst.__objectTypeApiName,
+    targetKey: String(dst.__primaryKey)
+  };
+}
+
+/**
+ * Resolves a link from two {@link ObjectTypeDefinition} instances and explicit primary keys.
+ * Reads the `apiName` from each type definition.
+ */
+function resolveFromTypes(srcType, srcPk, srcLinkName, dstType, dstPk) {
+  return {
+    sourceObjectType: srcType.apiName,
+    sourceKey: String(srcPk),
+    linkType: srcLinkName,
+    targetObjectType: dstType.apiName,
+    targetKey: String(dstPk)
+  };
+}
+
+/**
+ * A lightweight, type-safe builder for constructing seed data.
+ *
+ * TypeScript catches everything expressible at the call site: property
+ * names and value types, required primary keys, link names valid on the
+ * source type, and link target types matching what the link points to.
+ */
+export class SeedBuilder {
+  #objects = new Map();
+  #refs = new Set();
+  #links = [];
+
+  /**
+   * Register a seed object and return a typed reference for use in {@link link}.
+   *
+   * Property names and value types are validated at compile time against the
+   * generated SDK type. Non-nullable properties (including the primary key)
+   * are required.
+   *
+   * @param type  - The generated SDK object type definition (e.g., `Product`).
+   * @param props - Property values for the object. Must match the SDK type's property schema.
+   * @returns A frozen {@link SeedRef} carrying the object type and primary key.
+   * @throws if the primary key is null, undefined, or already registered for this type.
+   * @throws if the object type definition is missing `apiName` or `primaryKeyApiName`.
+   */
+  add(type, props) {
+    // Runtime guards for callers who bypass the type system with `as any`.
+    // Properly-typed ObjectTypeDefinition values can't reach these.
+    const apiName = type.apiName;
+    const pkApiName = type.primaryKeyApiName;
+    if (!apiName) {
+      throw new Error("Object type is missing apiName");
+    }
+    if (!pkApiName) {
+      throw new Error(`[${apiName}] Object type is missing primaryKeyApiName`);
+    }
+    const record = props;
+    const pkValue = record[pkApiName];
+    if (pkValue == null) {
+      throw new Error(`[${apiName}] Primary key '${pkApiName}' is null or undefined`);
+    }
+    const pk = String(pkValue);
+    let typeMap = this.#objects.get(apiName);
+    if (!typeMap) {
+      typeMap = new Map();
+      this.#objects.set(apiName, typeMap);
+    }
+    if (typeMap.has(pk)) {
+      throw new Error(`[${apiName}] Duplicate primary key '${pk}'`);
+    }
+    typeMap.set(pk, {
+      ...record
+    });
+    this.#refs.add(`${apiName}:${pk}`);
+    return Object.freeze({
+      __objectTypeApiName: apiName,
+      __primaryKey: pkValue
+    });
+  }
+
+  /**
+   * Register a link between two seed objects.
+   *
+   * Supports two calling conventions that produce identical output:
+   * by-reference (passing `SeedRef`s returned from {@link add}) or by-type
+   * and primary-key. See the `@osdk/seed-compiler` README for usage examples.
+   *
+   * @param name - A descriptive label for this link (included in seed output and error messages).
+   * @throws if either source or target object was not registered via {@link add}.
+   */
+
+  link(name, srcOrType, linkNameOrPk, dstOrLinkName, typeOrLinkName, dstPk) {
+    const resolved = isSeedRef(srcOrType) ? resolveFromRefs(srcOrType, linkNameOrPk, dstOrLinkName) : resolveFromTypes(srcOrType, linkNameOrPk, dstOrLinkName, typeOrLinkName, dstPk);
+    this.#assertRegistered(resolved.sourceObjectType, resolved.sourceKey, "Source", name);
+    this.#assertRegistered(resolved.targetObjectType, resolved.targetKey, "Target", name);
+    this.#links.push({
+      name,
+      ...resolved
+    });
+  }
+
+  /**
+   * Asserts that an object with the given type and key was registered via {@link add}.
+   * @throws with a descriptive message including the link name for context.
+   */
+  #assertRegistered(objectType, key, role, linkName) {
+    const ref = `${objectType}:${key}`;
+    if (!this.#refs.has(ref)) {
+      throw new Error(`${role} '${ref}' not registered (link '${linkName}')`);
+    }
+  }
+
+  /**
+   * Build the final {@link SeedOutput} from all registered objects and links.
+   *
+   * The returned arrays are fresh copies, so a subsequent `add()` or `link()`
+   * call does not retroactively grow or shrink an array that was already
+   * returned. The property records inside the arrays, however, are shared
+   * references with the builder's internal storage — mutating
+   * `output.objects.Employee[0].name = "x"` *will* propagate into the
+   * builder and into anything else holding a previous output. Treat the
+   * output as read-only, or deep-clone it before mutating.
+   *
+   * Inputs to {@link add} are still safe to mutate after calling: `add` stores
+   * a shallow copy of the props record on registration.
+   */
+  build() {
+    const objects = {};
+    for (const [apiName, typeMap] of this.#objects) {
+      objects[apiName] = [...typeMap.values()];
+    }
+    return {
+      objects,
+      links: [...this.#links]
+    };
+  }
+}
+
+/**
+ * Create seed data using a builder function.
+ *
+ * The builder is created, passed to `fn`, and the resulting {@link SeedOutput}
+ * is returned as the module's default export for consumption by the seed compiler.
+ *
+ * @param fn - A function that registers objects and links on the provided {@link SeedBuilder}.
+ * @returns The built {@link SeedOutput} containing all registered objects and links.
+ *
+ * @example
+ * ```ts
+ * import { Product, Seller } from "@ontology/sdk";
+ * import { createSeed } from "@osdk/seed-helpers";
+ *
+ * export default createSeed((seed) => {
+ *   const prod = seed.add(Product, { pk: "prod-001", title: "Widget", price: 100 });
+ *   const alice = seed.add(Seller, { pk: "seller-001", name: "Alice" });
+ *   seed.link("widget-seller", prod, "sellers", alice, "products");
+ * });
+ * ```
+ */
+export function createSeed(fn) {
+  const builder = new SeedBuilder();
+  fn(builder);
+  return builder.build();
+}
+//# sourceMappingURL=SeedBuilder.js.map

package/build/esm/SeedBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedBuilder.js","names":["isSeedRef","value","resolveFromRefs","src","srcLinkName","dst","sourceObjectType","__objectTypeApiName","sourceKey","String","__primaryKey","linkType","targetObjectType","targetKey","resolveFromTypes","srcType","srcPk","dstType","dstPk","apiName","SeedBuilder","objects","Map","refs","Set","links","add","type","props","pkApiName","primaryKeyApiName","Error","record","pkValue","pk","typeMap","get","set","has","Object","freeze","link","name","srcOrType","linkNameOrPk","dstOrLinkName","typeOrLinkName","resolved","assertRegistered","push","#assertRegistered","objectType","key","role","linkName","ref","build","values","createSeed","fn","builder"],"sources":["SeedBuilder.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 { LinkedType, LinkNames, ObjectTypeDefinition } from \"@osdk/api\";\nimport type { SeedLinkEntry, SeedOutput, SeedProps, SeedRef } from \"./types.js\";\n\n/** Internal representation of a resolved link before validation. */\ninterface ResolvedLink {\n  sourceObjectType: string;\n  sourceKey: string;\n  linkType: string;\n  targetObjectType: string;\n  targetKey: string;\n}\n\n/** Checks whether a value is a {@link SeedRef} returned by `SeedBuilder.add()`. */\nfunction isSeedRef(value: unknown): value is SeedRef {\n  return typeof value === \"object\"\n    && value != null\n    && \"__objectTypeApiName\" in value\n    && \"__primaryKey\" in value;\n}\n\n/**\n * Resolves a link from two {@link SeedRef} instances.\n * Extracts the object type and primary key from each ref.\n */\nfunction resolveFromRefs(\n  src: SeedRef,\n  srcLinkName: string,\n  dst: SeedRef,\n): ResolvedLink {\n  return {\n    sourceObjectType: src.__objectTypeApiName,\n    sourceKey: String(src.__primaryKey),\n    linkType: srcLinkName,\n    targetObjectType: dst.__objectTypeApiName,\n    targetKey: String(dst.__primaryKey),\n  };\n}\n\n/**\n * Resolves a link from two {@link ObjectTypeDefinition} instances and explicit primary keys.\n * Reads the `apiName` from each type definition.\n */\nfunction resolveFromTypes(\n  srcType: ObjectTypeDefinition,\n  srcPk: string | number,\n  srcLinkName: string,\n  dstType: ObjectTypeDefinition,\n  dstPk: string | number,\n): ResolvedLink {\n  return {\n    sourceObjectType: srcType.apiName,\n    sourceKey: String(srcPk),\n    linkType: srcLinkName,\n    targetObjectType: dstType.apiName,\n    targetKey: String(dstPk),\n  };\n}\n\n/**\n * A lightweight, type-safe builder for constructing seed data.\n *\n * TypeScript catches everything expressible at the call site: property\n * names and value types, required primary keys, link names valid on the\n * source type, and link target types matching what the link points to.\n */\nexport class SeedBuilder {\n  readonly #objects = new Map<string, Map<string, Record<string, unknown>>>();\n  readonly #refs = new Set<string>();\n  readonly #links: SeedLinkEntry[] = [];\n\n  /**\n   * Register a seed object and return a typed reference for use in {@link link}.\n   *\n   * Property names and value types are validated at compile time against the\n   * generated SDK type. Non-nullable properties (including the primary key)\n   * are required.\n   *\n   * @param type  - The generated SDK object type definition (e.g., `Product`).\n   * @param props - Property values for the object. Must match the SDK type's property schema.\n   * @returns A frozen {@link SeedRef} carrying the object type and primary key.\n   * @throws if the primary key is null, undefined, or already registered for this type.\n   * @throws if the object type definition is missing `apiName` or `primaryKeyApiName`.\n   */\n  add<Q extends ObjectTypeDefinition>(\n    type: Q,\n    props: SeedProps<Q>,\n  ): SeedRef<Q> {\n    // Runtime guards for callers who bypass the type system with `as any`.\n    // Properly-typed ObjectTypeDefinition values can't reach these.\n    const apiName = type.apiName;\n    const pkApiName = type.primaryKeyApiName;\n\n    if (!apiName) {\n      throw new Error(\"Object type is missing apiName\");\n    }\n    if (!pkApiName) {\n      throw new Error(`[${apiName}] Object type is missing primaryKeyApiName`);\n    }\n\n    const record = props as Record<string, unknown>;\n    const pkValue = record[pkApiName];\n\n    if (pkValue == null) {\n      throw new Error(\n        `[${apiName}] Primary key '${pkApiName}' is null or undefined`,\n      );\n    }\n\n    const pk = String(pkValue);\n\n    let typeMap = this.#objects.get(apiName);\n    if (!typeMap) {\n      typeMap = new Map();\n      this.#objects.set(apiName, typeMap);\n    }\n\n    if (typeMap.has(pk)) {\n      throw new Error(`[${apiName}] Duplicate primary key '${pk}'`);\n    }\n\n    typeMap.set(pk, { ...record });\n    this.#refs.add(`${apiName}:${pk}`);\n\n    return Object.freeze({\n      __objectTypeApiName: apiName,\n      __primaryKey: pkValue as string | number,\n    }) as SeedRef<Q>;\n  }\n\n  /**\n   * Register a link between two seed objects.\n   *\n   * Supports two calling conventions that produce identical output:\n   * by-reference (passing `SeedRef`s returned from {@link add}) or by-type\n   * and primary-key. See the `@osdk/seed-compiler` README for usage examples.\n   *\n   * @param name - A descriptive label for this link (included in seed output and error messages).\n   * @throws if either source or target object was not registered via {@link add}.\n   */\n  link<\n    S extends ObjectTypeDefinition,\n    SL extends LinkNames<S>,\n    D extends LinkedType<S, SL>,\n    DL extends LinkNames<D>,\n  >(\n    name: string,\n    src: SeedRef<S>,\n    srcLinkName: SL,\n    dst: SeedRef<D>,\n    dstLinkName: DL,\n  ): void;\n  link<\n    S extends ObjectTypeDefinition,\n    SL extends LinkNames<S>,\n    D extends LinkedType<S, SL>,\n    DL extends LinkNames<D>,\n  >(\n    name: string,\n    srcType: S,\n    srcPk: string | number,\n    srcLinkName: SL,\n    dstType: D,\n    dstPk: string | number,\n    dstLinkName: DL,\n  ): void;\n  link(\n    name: string,\n    srcOrType: SeedRef | ObjectTypeDefinition,\n    linkNameOrPk: string | number,\n    dstOrLinkName: SeedRef | ObjectTypeDefinition | string,\n    typeOrLinkName?: ObjectTypeDefinition | string,\n    dstPk?: string | number,\n    _dstLinkName?: string,\n  ): void {\n    const resolved = isSeedRef(srcOrType)\n      ? resolveFromRefs(\n        srcOrType,\n        linkNameOrPk as string,\n        dstOrLinkName as SeedRef,\n      )\n      : resolveFromTypes(\n        srcOrType,\n        linkNameOrPk,\n        dstOrLinkName as string,\n        typeOrLinkName as ObjectTypeDefinition,\n        dstPk!,\n      );\n\n    this.#assertRegistered(\n      resolved.sourceObjectType,\n      resolved.sourceKey,\n      \"Source\",\n      name,\n    );\n    this.#assertRegistered(\n      resolved.targetObjectType,\n      resolved.targetKey,\n      \"Target\",\n      name,\n    );\n\n    this.#links.push({ name, ...resolved });\n  }\n\n  /**\n   * Asserts that an object with the given type and key was registered via {@link add}.\n   * @throws with a descriptive message including the link name for context.\n   */\n  #assertRegistered(\n    objectType: string,\n    key: string,\n    role: \"Source\" | \"Target\",\n    linkName: string,\n  ): void {\n    const ref = `${objectType}:${key}`;\n    if (!this.#refs.has(ref)) {\n      throw new Error(\n        `${role} '${ref}' not registered (link '${linkName}')`,\n      );\n    }\n  }\n\n  /**\n   * Build the final {@link SeedOutput} from all registered objects and links.\n   *\n   * The returned arrays are fresh copies, so a subsequent `add()` or `link()`\n   * call does not retroactively grow or shrink an array that was already\n   * returned. The property records inside the arrays, however, are shared\n   * references with the builder's internal storage — mutating\n   * `output.objects.Employee[0].name = \"x\"` *will* propagate into the\n   * builder and into anything else holding a previous output. Treat the\n   * output as read-only, or deep-clone it before mutating.\n   *\n   * Inputs to {@link add} are still safe to mutate after calling: `add` stores\n   * a shallow copy of the props record on registration.\n   */\n  build(): SeedOutput {\n    const objects: Record<string, Array<Record<string, unknown>>> = {};\n    for (const [apiName, typeMap] of this.#objects) {\n      objects[apiName] = [...typeMap.values()];\n    }\n    return { objects, links: [...this.#links] };\n  }\n}\n\n/**\n * Create seed data using a builder function.\n *\n * The builder is created, passed to `fn`, and the resulting {@link SeedOutput}\n * is returned as the module's default export for consumption by the seed compiler.\n *\n * @param fn - A function that registers objects and links on the provided {@link SeedBuilder}.\n * @returns The built {@link SeedOutput} containing all registered objects and links.\n *\n * @example\n * ```ts\n * import { Product, Seller } from \"@ontology/sdk\";\n * import { createSeed } from \"@osdk/seed-helpers\";\n *\n * export default createSeed((seed) => {\n *   const prod = seed.add(Product, { pk: \"prod-001\", title: \"Widget\", price: 100 });\n *   const alice = seed.add(Seller, { pk: \"seller-001\", name: \"Alice\" });\n *   seed.link(\"widget-seller\", prod, \"sellers\", alice, \"products\");\n * });\n * ```\n */\nexport function createSeed(fn: (seed: SeedBuilder) => void): SeedOutput {\n  const builder = new SeedBuilder();\n  fn(builder);\n  return builder.build();\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/index.js

@@ -0,0 +1,18 @@
+/*
+ * 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 { createSeed, SeedBuilder } from "./SeedBuilder.js";
+//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["createSeed","SeedBuilder"],"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 { createSeed, SeedBuilder } from \"./SeedBuilder.js\";\nexport type { SeedLinkEntry, SeedOutput, SeedProps, SeedRef } from \"./types.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,UAAU,EAAEC,WAAW,QAAQ,kBAAkB","ignoreList":[]}

package/build/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["types.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 { CompileTimeMetadata, ObjectTypeDefinition } from \"@osdk/api\";\n\n/**\n * Makes nullable properties optional while keeping non-nullable ones required.\n * `{ id: string; title: string | undefined }` becomes `{ id: string; title?: string }`.\n * This ensures required fields like primary keys must always be provided.\n */\ntype PartialForOptionalProperties<T> =\n  & {\n    [K in keyof T as undefined extends T[K] ? K : never]?: NonNullable<T[K]>;\n  }\n  & {\n    [K in keyof T as undefined extends T[K] ? never : K]-?: T[K];\n  };\n\n/**\n * Derives the property types for seed data from the generated SDK type.\n * Uses CompileTimeMetadata<T>[\"props\"] which resolves to the Props interface\n * on generated types (e.g., Employee.Props). Non-nullable properties like the\n * primary key are required; nullable properties are optional.\n */\nexport type SeedProps<T extends ObjectTypeDefinition> =\n  PartialForOptionalProperties<\n    CompileTimeMetadata<T>[\"props\"]\n  >;\n\n/**\n * Unique symbol used to brand {@link SeedRef} instances. A branded type prevents\n * manually constructed objects from satisfying the interface — only `SeedBuilder.add()`\n * can produce a valid `SeedRef`. This ensures `link()` generics always have the\n * correct object type for compile-time link name and target type validation.\n */\ndeclare const SEED_REF_BRAND: unique symbol;\n\n/**\n * A typed reference returned by SeedBuilder.add(). The branded symbol field\n * carries the object type as a generic, enabling compile-time link validation.\n *\n * Cannot be constructed manually — the unique symbol key is not exported and\n * only `SeedBuilder.add()` can produce a valid `SeedRef` via an `as` cast.\n */\nexport interface SeedRef<\n  Q extends ObjectTypeDefinition = ObjectTypeDefinition,\n> {\n  readonly __objectTypeApiName: string;\n  readonly __primaryKey: string | number;\n  /** @internal Brand field — never set at runtime. Enforces nominal typing. */\n  readonly [SEED_REF_BRAND]: Q;\n}\n\n/** A link entry in the seed output. */\nexport interface SeedLinkEntry {\n  name: string;\n  linkType: string;\n  sourceObjectType: string;\n  sourceKey: string;\n  targetObjectType: string;\n  targetKey: string;\n}\n\n/** The final serializable seed data output. */\nexport interface SeedOutput {\n  objects: Record<string, Array<Record<string, unknown>>>;\n  links: SeedLinkEntry[];\n}\n"],"mappings":"","ignoreList":[]}

package/build/types/SeedBuilder.d.ts

@@ -0,0 +1,85 @@
+import type { LinkedType, LinkNames, ObjectTypeDefinition } from "@osdk/api";
+import type { SeedOutput, SeedProps, SeedRef } from "./types.js";
+/**
+* A lightweight, type-safe builder for constructing seed data.
+*
+* TypeScript catches everything expressible at the call site: property
+* names and value types, required primary keys, link names valid on the
+* source type, and link target types matching what the link points to.
+*/
+export declare class SeedBuilder {
+	#private;
+	/**
+	* Register a seed object and return a typed reference for use in {@link link}.
+	*
+	* Property names and value types are validated at compile time against the
+	* generated SDK type. Non-nullable properties (including the primary key)
+	* are required.
+	*
+	* @param type  - The generated SDK object type definition (e.g., `Product`).
+	* @param props - Property values for the object. Must match the SDK type's property schema.
+	* @returns A frozen {@link SeedRef} carrying the object type and primary key.
+	* @throws if the primary key is null, undefined, or already registered for this type.
+	* @throws if the object type definition is missing `apiName` or `primaryKeyApiName`.
+	*/
+	add<Q extends ObjectTypeDefinition>(type: Q, props: SeedProps<Q>): SeedRef<Q>;
+	/**
+	* Register a link between two seed objects.
+	*
+	* Supports two calling conventions that produce identical output:
+	* by-reference (passing `SeedRef`s returned from {@link add}) or by-type
+	* and primary-key. See the `@osdk/seed-compiler` README for usage examples.
+	*
+	* @param name - A descriptive label for this link (included in seed output and error messages).
+	* @throws if either source or target object was not registered via {@link add}.
+	*/
+	link<
+		S extends ObjectTypeDefinition,
+		SL extends LinkNames<S>,
+		D extends LinkedType<S, SL>,
+		DL extends LinkNames<D>
+	>(name: string, src: SeedRef<S>, srcLinkName: SL, dst: SeedRef<D>, dstLinkName: DL): void;
+	link<
+		S extends ObjectTypeDefinition,
+		SL extends LinkNames<S>,
+		D extends LinkedType<S, SL>,
+		DL extends LinkNames<D>
+	>(name: string, srcType: S, srcPk: string | number, srcLinkName: SL, dstType: D, dstPk: string | number, dstLinkName: DL): void;
+	/**
+	* Build the final {@link SeedOutput} from all registered objects and links.
+	*
+	* The returned arrays are fresh copies, so a subsequent `add()` or `link()`
+	* call does not retroactively grow or shrink an array that was already
+	* returned. The property records inside the arrays, however, are shared
+	* references with the builder's internal storage — mutating
+	* `output.objects.Employee[0].name = "x"` *will* propagate into the
+	* builder and into anything else holding a previous output. Treat the
+	* output as read-only, or deep-clone it before mutating.
+	*
+	* Inputs to {@link add} are still safe to mutate after calling: `add` stores
+	* a shallow copy of the props record on registration.
+	*/
+	build(): SeedOutput;
+}
+/**
+* Create seed data using a builder function.
+*
+* The builder is created, passed to `fn`, and the resulting {@link SeedOutput}
+* is returned as the module's default export for consumption by the seed compiler.
+*
+* @param fn - A function that registers objects and links on the provided {@link SeedBuilder}.
+* @returns The built {@link SeedOutput} containing all registered objects and links.
+*
+* @example
+* ```ts
+* import { Product, Seller } from "@ontology/sdk";
+* import { createSeed } from "@osdk/seed-helpers";
+*
+* export default createSeed((seed) => {
+*   const prod = seed.add(Product, { pk: "prod-001", title: "Widget", price: 100 });
+*   const alice = seed.add(Seller, { pk: "seller-001", name: "Alice" });
+*   seed.link("widget-seller", prod, "sellers", alice, "products");
+* });
+* ```
+*/
+export declare function createSeed(fn: (seed: SeedBuilder) => void): SeedOutput;

package/build/types/SeedBuilder.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,YAAY,WAAW,4BAA4B,WAAY;AAC7E,cAA6B,YAAY,WAAW,eAAe,YAAa;;;;;;;;AAgEhF,OAAO,cAAM,YAAY;;;;;;;;;;;;;;;CAkBvB,IAAI,UAAU,sBACZA,MAAM,GACNC,OAAO,UAAU,KAChB,QAAQ;;;;;;;;;;;CAqDX;EACE,UAAU;EACV,WAAW,UAAU;EACrB,UAAU,WAAW,GAAG;EACxB,WAAW,UAAU;GAErBC,cACAC,KAAK,QAAQ,IACbC,aAAa,IACbC,KAAK,QAAQ,IACbC,aAAa;CAEf;EACE,UAAU;EACV,WAAW,UAAU;EACrB,UAAU,WAAW,GAAG;EACxB,WAAW,UAAU;GAErBJ,cACAK,SAAS,GACTC,wBACAJ,aAAa,IACbK,SAAS,GACTC,wBACAJ,aAAa;;;;;;;;;;;;;;;CAyEf,SAAS;AAOV;;;;;;;;;;;;;;;;;;;;;;AAuBD,OAAO,iBAAS,WAAWK,KAAKC,MAAM,uBAAuB","names":["type: Q","props: SeedProps<Q>","name: string","src: SeedRef<S>","srcLinkName: SL","dst: SeedRef<D>","dstLinkName: DL","srcType: S","srcPk: string | number","dstType: D","dstPk: string | number","fn: (seed: SeedBuilder) => void","seed: SeedBuilder"],"sources":["../../src/SeedBuilder.ts"],"version":3,"file":"SeedBuilder.d.ts"}

package/build/types/index.d.ts

@@ -0,0 +1,2 @@
+export { createSeed, SeedBuilder } from "./SeedBuilder.js";
+export type { SeedLinkEntry, SeedOutput, SeedProps, SeedRef } from "./types.js";

package/build/types/index.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,SAAS,YAAY,mBAAmB;AACxC,cAAc,eAAe,YAAY,WAAW,eAAe","names":[],"sources":["../../src/index.ts"],"version":3,"file":"index.d.ts"}

package/build/types/types.d.ts

@@ -0,0 +1,40 @@
+import type { CompileTimeMetadata, ObjectTypeDefinition } from "@osdk/api";
+/**
+* Makes nullable properties optional while keeping non-nullable ones required.
+* `{ id: string; title: string | undefined }` becomes `{ id: string; title?: string }`.
+* This ensures required fields like primary keys must always be provided.
+*/
+type PartialForOptionalProperties<T> = { [K in keyof T as undefined extends T[K] ? K : never]? : NonNullable<T[K]> } & { [K in keyof T as undefined extends T[K] ? never : K]-? : T[K] };
+/**
+* Derives the property types for seed data from the generated SDK type.
+* Uses CompileTimeMetadata<T>["props"] which resolves to the Props interface
+* on generated types (e.g., Employee.Props). Non-nullable properties like the
+* primary key are required; nullable properties are optional.
+*/
+export type SeedProps<T extends ObjectTypeDefinition> = PartialForOptionalProperties<CompileTimeMetadata<T>["props"]>;
+/**
+* A typed reference returned by SeedBuilder.add(). The branded symbol field
+* carries the object type as a generic, enabling compile-time link validation.
+*
+* Cannot be constructed manually — the unique symbol key is not exported and
+* only `SeedBuilder.add()` can produce a valid `SeedRef` via an `as` cast.
+*/
+export interface SeedRef<Q extends ObjectTypeDefinition = ObjectTypeDefinition> {
+	readonly __objectTypeApiName: string;
+	readonly __primaryKey: string | number;
+}
+/** A link entry in the seed output. */
+export interface SeedLinkEntry {
+	name: string;
+	linkType: string;
+	sourceObjectType: string;
+	sourceKey: string;
+	targetObjectType: string;
+	targetKey: string;
+}
+/** The final serializable seed data output. */
+export interface SeedOutput {
+	objects: Record<string, Array<Record<string, unknown>>>;
+	links: SeedLinkEntry[];
+}
+export {};

package/build/types/types.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,qBAAqB,4BAA4B,WAAY;;;;;;KAOtE,6BAA6B,QAE7B,WAAW,uBAAuB,EAAE,KAAK,cAAa,YAAY,EAAE,WAGpE,WAAW,uBAAuB,EAAE,aAAa,OAAM,EAAE;;;;;;;AAS9D,YAAY,UAAU,UAAU,wBAC9B,6BACE,oBAAoB,GAAG;;;;;;;;AAkB3B,iBAAiB,QACf,UAAU,uBAAuB,sBACjC;UACS;UACA;AAGV;;AAGD,iBAAiB,cAAc;CAC7B;CACA;CACA;CACA;CACA;CACA;AACD;;AAGD,iBAAiB,WAAW;CAC1B,SAAS,eAAe,MAAM;CAC9B,OAAO;AACR","names":[],"sources":["../../src/types.ts"],"version":3,"file":"types.d.ts"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@osdk/seed-helpers",
+  "version": "0.2.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/palantir/osdk-ts.git"
+  },
+  "exports": {
+    ".": {
+      "browser": "./build/browser/index.js",
+      "import": {
+        "types": "./build/types/index.d.ts",
+        "default": "./build/esm/index.js"
+      },
+      "require": "./build/cjs/index.cjs",
+      "default": "./build/browser/index.js"
+    },
+    "./*": {
+      "browser": "./build/browser/public/*.js",
+      "import": {
+        "types": "./build/types/public/*.d.ts",
+        "default": "./build/esm/public/*.js"
+      },
+      "require": "./build/cjs/public/*.cjs",
+      "default": "./build/browser/public/*.js"
+    }
+  },
+  "dependencies": {
+    "@osdk/api": "~2.18.0"
+  },
+  "devDependencies": {
+    "typescript": "~5.5.4",
+    "vitest": "^3.2.4",
+    "@osdk/monorepo.api-extractor": "~0.7.0",
+    "@osdk/monorepo.tsconfig": "~0.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "build/cjs",
+    "build/esm",
+    "build/browser",
+    "build/types",
+    "CHANGELOG.md",
+    "package.json",
+    "templates",
+    "*.d.ts"
+  ],
+  "main": "./build/cjs/index.cjs",
+  "module": "./build/esm/index.js",
+  "types": "./build/cjs/index.d.cts",
+  "type": "module",
+  "scripts": {
+    "check-attw": "attw --pack .",
+    "check-spelling": "cspell --quiet .",
+    "clean": "rm -rf lib dist types build tsconfig.tsbuildinfo",
+    "fix-lint": "eslint . --fix && dprint fmt",
+    "lint": "eslint . && dprint check",
+    "test": "vitest run",
+    "transpileBrowser": "monorepo.tool.transpile -f esm -m normal -t browser",
+    "transpileCjs": "monorepo.tool.transpile -f cjs -m bundle -t node",
+    "transpileEsm": "monorepo.tool.transpile -f esm -m normal -t node",
+    "transpileTypes": "monorepo.tool.transpile -f esm -m types -t node",
+    "typecheck": "tsc --noEmit --emitDeclarationOnly false"
+  }
+}