@palantir/pack.document-schema.type-gen 0.13.0 → 0.15.0

package/README.md

@@ -53,6 +53,25 @@ Generate schemas from Intermediate Representation format:
 type-gen ir zod -s <schema.json> -r <records.json> -o <output.ts>
 ```
 
+Deploy and update document types directly from an IR file (the wire schema and version are sourced
+from the IR):
+
+```bash
+# Create a third-party document type (default)
+type-gen ir deploy -i <ir.json> -b <base-url> -a <token> -p <parent-folder-rid> [-f ARTIFACTS|COMPASS]
+
+# Create a first-party document type
+type-gen ir deploy -i <ir.json> -b <base-url> -a <token> --first-party -o <ontology-rid> \
+  [-f ARTIFACTS|COMPASS] [--first-party-prefix /api/gotham]
+
+# Update an existing document type's schema
+type-gen ir update-schema -i <ir.json> -b <base-url> -a <token> -o <ontology-rid> \
+  [--force-overwrite] [--first-party-prefix /api/gotham]
+```
+
+`ir asset` (generate an asset JSON consumed by backpack's asset-track loader) remains available;
+the deploy/update-schema REST commands are IR-sourced.
+
 ### Examples
 
 #### Generating TypeScript Types from YAML

package/build/esm/cli.js

@@ -15,14 +15,12 @@
  */
 
 import { Command } from "commander";
-import { registerAssetCommands } from "./commands/asset/registerAssetCommands.js";
 import { registerIrCommands } from "./commands/ir/registerIrCommands.js";
 import { registerSchemaCommands } from "./commands/schema/registerSchemaCommands.js";
 import { registerStepsCommands } from "./commands/steps/registerStepsCommands.js";
 export function cli(args) {
   const program = new Command();
   program.name("document-schema-type-gen").description("Document schema type generation CLI").version("0.0.1");
-  registerAssetCommands(program);
   registerIrCommands(program);
   registerSchemaCommands(program);
   registerStepsCommands(program);

package/build/esm/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":["Command","registerAssetCommands","registerIrCommands","registerSchemaCommands","registerStepsCommands","cli","args","program","name","description","version","parse"],"sources":["cli.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 { Command } from \"commander\";\nimport { registerAssetCommands } from \"./commands/asset/registerAssetCommands.js\";\nimport { registerIrCommands } from \"./commands/ir/registerIrCommands.js\";\nimport { registerSchemaCommands } from \"./commands/schema/registerSchemaCommands.js\";\nimport { registerStepsCommands } from \"./commands/steps/registerStepsCommands.js\";\n\nexport function cli(args: string[]): void {\n  const program = new Command();\n\n  program\n    .name(\"document-schema-type-gen\")\n    .description(\"Document schema type generation CLI\")\n    .version(\"0.0.1\");\n\n  registerAssetCommands(program);\n  registerIrCommands(program);\n  registerSchemaCommands(program);\n  registerStepsCommands(program);\n\n  program.parse(args);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAQ,WAAW;AACnC,SAASC,qBAAqB,QAAQ,2CAA2C;AACjF,SAASC,kBAAkB,QAAQ,qCAAqC;AACxE,SAASC,sBAAsB,QAAQ,6CAA6C;AACpF,SAASC,qBAAqB,QAAQ,2CAA2C;AAEjF,OAAO,SAASC,GAAGA,CAACC,IAAc,EAAQ;EACxC,MAAMC,OAAO,GAAG,IAAIP,OAAO,CAAC,CAAC;EAE7BO,OAAO,CACJC,IAAI,CAAC,0BAA0B,CAAC,CAChCC,WAAW,CAAC,qCAAqC,CAAC,CAClDC,OAAO,CAAC,OAAO,CAAC;EAEnBT,qBAAqB,CAACM,OAAO,CAAC;EAC9BL,kBAAkB,CAACK,OAAO,CAAC;EAC3BJ,sBAAsB,CAACI,OAAO,CAAC;EAC/BH,qBAAqB,CAACG,OAAO,CAAC;EAE9BA,OAAO,CAACI,KAAK,CAACL,IAAI,CAAC;AACrB","ignoreList":[]}
+{"version":3,"file":"cli.js","names":["Command","registerIrCommands","registerSchemaCommands","registerStepsCommands","cli","args","program","name","description","version","parse"],"sources":["cli.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 { Command } from \"commander\";\nimport { registerIrCommands } from \"./commands/ir/registerIrCommands.js\";\nimport { registerSchemaCommands } from \"./commands/schema/registerSchemaCommands.js\";\nimport { registerStepsCommands } from \"./commands/steps/registerStepsCommands.js\";\n\nexport function cli(args: string[]): void {\n  const program = new Command();\n\n  program\n    .name(\"document-schema-type-gen\")\n    .description(\"Document schema type generation CLI\")\n    .version(\"0.0.1\");\n\n  registerIrCommands(program);\n  registerSchemaCommands(program);\n  registerStepsCommands(program);\n\n  program.parse(args);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAQ,WAAW;AACnC,SAASC,kBAAkB,QAAQ,qCAAqC;AACxE,SAASC,sBAAsB,QAAQ,6CAA6C;AACpF,SAASC,qBAAqB,QAAQ,2CAA2C;AAEjF,OAAO,SAASC,GAAGA,CAACC,IAAc,EAAQ;EACxC,MAAMC,OAAO,GAAG,IAAIN,OAAO,CAAC,CAAC;EAE7BM,OAAO,CACJC,IAAI,CAAC,0BAA0B,CAAC,CAChCC,WAAW,CAAC,qCAAqC,CAAC,CAClDC,OAAO,CAAC,OAAO,CAAC;EAEnBR,kBAAkB,CAACK,OAAO,CAAC;EAC3BJ,sBAAsB,CAACI,OAAO,CAAC;EAC/BH,qBAAqB,CAACG,OAAO,CAAC;EAE9BA,OAAO,CAACI,KAAK,CAACL,IAAI,CAAC;AACrB","ignoreList":[]}

package/build/esm/commands/ir/__tests__/resolveIrInput.test.js

@@ -0,0 +1,88 @@
+/*
+ * Copyright 2026 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 { describe, expect, it } from "vitest";
+import { resolveIrInput } from "../resolveIrInput.js";
+function ir(version) {
+  return {
+    name: `Test v${version}`,
+    description: "Test schema",
+    version,
+    primaryModelKeys: [],
+    models: {}
+  };
+}
+describe("resolveIrInput", () => {
+  it("passes through legacy single-version IR", () => {
+    const resolved = resolveIrInput(ir(2), "legacy.json");
+    expect(resolved).toEqual({
+      ir: ir(2),
+      latestVersion: 2,
+      minSupportedVersion: 2
+    });
+  });
+  it("selects the latest entry from a versioned IR chain", () => {
+    const resolved = resolveIrInput({
+      latestVersion: 3,
+      minSupportedVersion: 1,
+      chain: [{
+        version: 1,
+        ir: ir(1)
+      }, {
+        version: 3,
+        ir: ir(3)
+      }]
+    }, "chain.json");
+    expect(resolved).toEqual({
+      ir: ir(3),
+      latestVersion: 3,
+      minSupportedVersion: 1
+    });
+  });
+  it("defaults chain minSupportedVersion to latestVersion", () => {
+    const resolved = resolveIrInput({
+      latestVersion: 3,
+      chain: [{
+        version: 1,
+        ir: ir(1)
+      }, {
+        version: 3,
+        ir: ir(3)
+      }]
+    }, "chain.json");
+    expect(resolved.minSupportedVersion).toBe(3);
+  });
+  it("rejects an empty chain", () => {
+    expect(() => resolveIrInput({
+      latestVersion: 1,
+      chain: []
+    }, "empty.json")).toThrow("chain");
+  });
+  it("rejects a chain with an invalid minSupportedVersion", () => {
+    expect(() => resolveIrInput({
+      latestVersion: 3,
+      minSupportedVersion: 2,
+      chain: [{
+        version: 1,
+        ir: ir(1)
+      }, {
+        version: 3,
+        ir: ir(3)
+      }]
+    }, "missing.json")).toThrow("minSupportedVersion 2");
+  });
+});
+//# sourceMappingURL=resolveIrInput.test.js.map

package/build/esm/commands/ir/__tests__/resolveIrInput.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveIrInput.test.js","names":["describe","expect","it","resolveIrInput","ir","version","name","description","primaryModelKeys","models","resolved","toEqual","latestVersion","minSupportedVersion","chain","toBe","toThrow"],"sources":["resolveIrInput.test.ts"],"sourcesContent":["/*\n * Copyright 2026 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 { describe, expect, it } from \"vitest\";\nimport type { IRealTimeDocumentSchema } from \"../../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { resolveIrInput } from \"../resolveIrInput.js\";\n\nfunction ir(version: number): IRealTimeDocumentSchema {\n  return {\n    name: `Test v${version}`,\n    description: \"Test schema\",\n    version,\n    primaryModelKeys: [],\n    models: {},\n  };\n}\n\ndescribe(\"resolveIrInput\", () => {\n  it(\"passes through legacy single-version IR\", () => {\n    const resolved = resolveIrInput(ir(2), \"legacy.json\");\n\n    expect(resolved).toEqual({\n      ir: ir(2),\n      latestVersion: 2,\n      minSupportedVersion: 2,\n    });\n  });\n\n  it(\"selects the latest entry from a versioned IR chain\", () => {\n    const resolved = resolveIrInput({\n      latestVersion: 3,\n      minSupportedVersion: 1,\n      chain: [\n        { version: 1, ir: ir(1) },\n        { version: 3, ir: ir(3) },\n      ],\n    }, \"chain.json\");\n\n    expect(resolved).toEqual({\n      ir: ir(3),\n      latestVersion: 3,\n      minSupportedVersion: 1,\n    });\n  });\n\n  it(\"defaults chain minSupportedVersion to latestVersion\", () => {\n    const resolved = resolveIrInput({\n      latestVersion: 3,\n      chain: [\n        { version: 1, ir: ir(1) },\n        { version: 3, ir: ir(3) },\n      ],\n    }, \"chain.json\");\n\n    expect(resolved.minSupportedVersion).toBe(3);\n  });\n\n  it(\"rejects an empty chain\", () => {\n    expect(() =>\n      resolveIrInput({\n        latestVersion: 1,\n        chain: [],\n      }, \"empty.json\")\n    ).toThrow(\"chain\");\n  });\n\n  it(\"rejects a chain with an invalid minSupportedVersion\", () => {\n    expect(() =>\n      resolveIrInput({\n        latestVersion: 3,\n        minSupportedVersion: 2,\n        chain: [\n          { version: 1, ir: ir(1) },\n          { version: 3, ir: ir(3) },\n        ],\n      }, \"missing.json\")\n    ).toThrow(\"minSupportedVersion 2\");\n  });\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAE7C,SAASC,cAAc,QAAQ,sBAAsB;AAErD,SAASC,EAAEA,CAACC,OAAe,EAA2B;EACpD,OAAO;IACLC,IAAI,EAAE,SAASD,OAAO,EAAE;IACxBE,WAAW,EAAE,aAAa;IAC1BF,OAAO;IACPG,gBAAgB,EAAE,EAAE;IACpBC,MAAM,EAAE,CAAC;EACX,CAAC;AACH;AAEAT,QAAQ,CAAC,gBAAgB,EAAE,MAAM;EAC/BE,EAAE,CAAC,yCAAyC,EAAE,MAAM;IAClD,MAAMQ,QAAQ,GAAGP,cAAc,CAACC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC;IAErDH,MAAM,CAACS,QAAQ,CAAC,CAACC,OAAO,CAAC;MACvBP,EAAE,EAAEA,EAAE,CAAC,CAAC,CAAC;MACTQ,aAAa,EAAE,CAAC;MAChBC,mBAAmB,EAAE;IACvB,CAAC,CAAC;EACJ,CAAC,CAAC;EAEFX,EAAE,CAAC,oDAAoD,EAAE,MAAM;IAC7D,MAAMQ,QAAQ,GAAGP,cAAc,CAAC;MAC9BS,aAAa,EAAE,CAAC;MAChBC,mBAAmB,EAAE,CAAC;MACtBC,KAAK,EAAE,CACL;QAAET,OAAO,EAAE,CAAC;QAAED,EAAE,EAAEA,EAAE,CAAC,CAAC;MAAE,CAAC,EACzB;QAAEC,OAAO,EAAE,CAAC;QAAED,EAAE,EAAEA,EAAE,CAAC,CAAC;MAAE,CAAC;IAE7B,CAAC,EAAE,YAAY,CAAC;IAEhBH,MAAM,CAACS,QAAQ,CAAC,CAACC,OAAO,CAAC;MACvBP,EAAE,EAAEA,EAAE,CAAC,CAAC,CAAC;MACTQ,aAAa,EAAE,CAAC;MAChBC,mBAAmB,EAAE;IACvB,CAAC,CAAC;EACJ,CAAC,CAAC;EAEFX,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9D,MAAMQ,QAAQ,GAAGP,cAAc,CAAC;MAC9BS,aAAa,EAAE,CAAC;MAChBE,KAAK,EAAE,CACL;QAAET,OAAO,EAAE,CAAC;QAAED,EAAE,EAAEA,EAAE,CAAC,CAAC;MAAE,CAAC,EACzB;QAAEC,OAAO,EAAE,CAAC;QAAED,EAAE,EAAEA,EAAE,CAAC,CAAC;MAAE,CAAC;IAE7B,CAAC,EAAE,YAAY,CAAC;IAEhBH,MAAM,CAACS,QAAQ,CAACG,mBAAmB,CAAC,CAACE,IAAI,CAAC,CAAC,CAAC;EAC9C,CAAC,CAAC;EAEFb,EAAE,CAAC,wBAAwB,EAAE,MAAM;IACjCD,MAAM,CAAC,MACLE,cAAc,CAAC;MACbS,aAAa,EAAE,CAAC;MAChBE,KAAK,EAAE;IACT,CAAC,EAAE,YAAY,CACjB,CAAC,CAACE,OAAO,CAAC,OAAO,CAAC;EACpB,CAAC,CAAC;EAEFd,EAAE,CAAC,qDAAqD,EAAE,MAAM;IAC9DD,MAAM,CAAC,MACLE,cAAc,CAAC;MACbS,aAAa,EAAE,CAAC;MAChBC,mBAAmB,EAAE,CAAC;MACtBC,KAAK,EAAE,CACL;QAAET,OAAO,EAAE,CAAC;QAAED,EAAE,EAAEA,EAAE,CAAC,CAAC;MAAE,CAAC,EACzB;QAAEC,OAAO,EAAE,CAAC;QAAED,EAAE,EAAEA,EAAE,CAAC,CAAC;MAAE,CAAC;IAE7B,CAAC,EAAE,cAAc,CACnB,CAAC,CAACY,OAAO,CAAC,uBAAuB,CAAC;EACpC,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/build/esm/commands/ir/irDeployHandler.js

@@ -14,38 +14,90 @@
  * limitations under the License.
  */
 
-import { createPlatformClient } from "@osdk/client";
+import { createPlatformClient, PalantirApiError } from "@osdk/client";
 import { DocumentTypes } from "@osdk/foundry.pack";
 import { CommanderError } from "commander";
 import { consola } from "consola";
 import { readFileSync } from "fs";
 import { resolve } from "path";
 import { convertIrToWireSchema } from "../../utils/ir/convertIrToWireSchema.js";
+import { buildPrefixRewriteFetch, DEFAULT_API_PREFIX } from "../utils/firstPartyPrefix.js";
+import { resolveIrInput } from "./resolveIrInput.js";
 export async function irDeployHandler(options) {
   try {
     const irPath = resolve(options.ir);
     consola.info(`Reading schema from: ${irPath}`);
-    const irContent = readFileSync(irPath, "utf8");
-
-    // TODO: conjureToZod based validation that IR content matches the conjure IR shape
-    const ir = JSON.parse(irContent);
-    const osdkClient = createPlatformClient(options.baseUrl, () => Promise.resolve(options.auth));
+    const {
+      ir,
+      latestVersion
+    } = resolveIrInput(JSON.parse(readFileSync(irPath, "utf8")), irPath);
     const schema = convertIrToWireSchema(ir);
-    const request = {
-      name: ir.name,
-      parentFolderRid: options.parentFolder,
-      schema
-    };
-    if (options.fileSystemType != null) {
-      request.fileSystemType = options.fileSystemType;
+    const fileSystemType = options.fileSystemType ?? "ARTIFACTS";
+    if (options.firstParty) {
+      await deployFirstParty(options, ir.name, schema, latestVersion, fileSystemType);
+    } else {
+      await deployThirdParty(options, ir.name, schema, fileSystemType);
     }
-    consola.info("Creating document type with schema", request);
-    await DocumentTypes.create(osdkClient, request, {
-      preview: true
-    });
   } catch (error) {
+    if (error instanceof CommanderError) {
+      throw error;
+    }
     consola.error("❌ Error during Deploy:", error);
     throw new CommanderError(1, "ERRIRMDEPLOY", "Error deploying IR document schema");
   }
 }
+async function deployThirdParty(options, name, schema, fileSystemType) {
+  if (options.parentFolder == null) {
+    throw new CommanderError(1, "EINVAL", "--parent-folder is required when deploying a third-party document type");
+  }
+  const osdkClient = createPlatformClient(options.baseUrl, () => Promise.resolve(options.auth));
+  const request = {
+    name,
+    parentFolderRid: options.parentFolder,
+    schema,
+    fileSystemType
+  };
+  consola.info("Creating document type with schema", request);
+  const result = await DocumentTypes.create(osdkClient, request, {
+    preview: true
+  });
+  consola.success("Successfully created document type", result);
+}
+async function deployFirstParty(options, name, schema, version, fileSystemType) {
+  if (options.ontologyRid == null) {
+    throw new CommanderError(1, "EINVAL", "--ontology-rid is required when deploying a first-party document type");
+  }
+  const fetchFn = options.firstPartyPrefix != null ? buildPrefixRewriteFetch(options.firstPartyPrefix) : undefined;
+  if (fetchFn != null) {
+    consola.info(`Rewriting OSDK '${DEFAULT_API_PREFIX}' -> '${options.firstPartyPrefix}'`);
+  }
+  const osdkClient = createPlatformClient(options.baseUrl, () => Promise.resolve(options.auth), undefined, fetchFn);
+  const request = {
+    requestBody: {
+      name,
+      ontologyRid: options.ontologyRid,
+      schema,
+      version,
+      fileSystemType
+    }
+  };
+  consola.info("Creating first-party document type", request);
+  try {
+    const result = await DocumentTypes.createFirstParty(osdkClient, request, {
+      preview: true
+    });
+    consola.success("Successfully created first-party document type", result);
+  } catch (error) {
+    if (error instanceof PalantirApiError) {
+      const {
+        message,
+        errorName,
+        errorCode
+      } = error;
+      const details = [errorName, errorCode].filter(Boolean).join(" ");
+      consola.error(`❌ Error during first-party deploy: ${message}${details ? ` [${details}]` : ""}`);
+    }
+    throw error;
+  }
+}
 //# sourceMappingURL=irDeployHandler.js.map

package/build/esm/commands/ir/irDeployHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"irDeployHandler.js","names":["createPlatformClient","DocumentTypes","CommanderError","consola","readFileSync","resolve","convertIrToWireSchema","irDeployHandler","options","irPath","ir","info","irContent","JSON","parse","osdkClient","baseUrl","Promise","auth","schema","request","name","parentFolderRid","parentFolder","fileSystemType","create","preview","error"],"sources":["irDeployHandler.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 { createPlatformClient } from \"@osdk/client\";\nimport type { CreateDocumentTypeRequest } from \"@osdk/foundry.pack\";\nimport { DocumentTypes } from \"@osdk/foundry.pack\";\nimport { CommanderError } from \"commander\";\nimport { consola } from \"consola\";\nimport { readFileSync } from \"fs\";\nimport { resolve } from \"path\";\nimport type { IRealTimeDocumentSchema } from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { convertIrToWireSchema } from \"../../utils/ir/convertIrToWireSchema.js\";\nimport type { FileSystemType } from \"../types.js\";\n\ninterface DeployOptions {\n  readonly ir: string;\n  readonly baseUrl: string;\n  readonly auth: string;\n  readonly parentFolder: string;\n  readonly fileSystemType: FileSystemType;\n}\n\nexport async function irDeployHandler(options: DeployOptions): Promise<void> {\n  try {\n    const irPath = resolve(options.ir);\n\n    consola.info(`Reading schema from: ${irPath}`);\n\n    const irContent = readFileSync(irPath, \"utf8\");\n\n    // TODO: conjureToZod based validation that IR content matches the conjure IR shape\n    const ir = JSON.parse(irContent) as IRealTimeDocumentSchema;\n\n    const osdkClient = createPlatformClient(\n      options.baseUrl,\n      () => Promise.resolve(options.auth),\n    );\n\n    const schema = convertIrToWireSchema(ir);\n\n    const request: CreateDocumentTypeRequest = {\n      name: ir.name,\n      parentFolderRid: options.parentFolder,\n      schema,\n    };\n\n    if (options.fileSystemType != null) {\n      request.fileSystemType = options.fileSystemType;\n    }\n\n    consola.info(\"Creating document type with schema\", request);\n\n    await DocumentTypes.create(osdkClient, request, { preview: true });\n  } catch (error) {\n    consola.error(\"❌ Error during Deploy:\", error);\n    throw new CommanderError(1, \"ERRIRMDEPLOY\", \"Error deploying IR document schema\");\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,oBAAoB,QAAQ,cAAc;AAEnD,SAASC,aAAa,QAAQ,oBAAoB;AAClD,SAASC,cAAc,QAAQ,WAAW;AAC1C,SAASC,OAAO,QAAQ,SAAS;AACjC,SAASC,YAAY,QAAQ,IAAI;AACjC,SAASC,OAAO,QAAQ,MAAM;AAE9B,SAASC,qBAAqB,QAAQ,yCAAyC;AAW/E,OAAO,eAAeC,eAAeA,CAACC,OAAsB,EAAiB;EAC3E,IAAI;IACF,MAAMC,MAAM,GAAGJ,OAAO,CAACG,OAAO,CAACE,EAAE,CAAC;IAElCP,OAAO,CAACQ,IAAI,CAAC,wBAAwBF,MAAM,EAAE,CAAC;IAE9C,MAAMG,SAAS,GAAGR,YAAY,CAACK,MAAM,EAAE,MAAM,CAAC;;IAE9C;IACA,MAAMC,EAAE,GAAGG,IAAI,CAACC,KAAK,CAACF,SAAS,CAA4B;IAE3D,MAAMG,UAAU,GAAGf,oBAAoB,CACrCQ,OAAO,CAACQ,OAAO,EACf,MAAMC,OAAO,CAACZ,OAAO,CAACG,OAAO,CAACU,IAAI,CACpC,CAAC;IAED,MAAMC,MAAM,GAAGb,qBAAqB,CAACI,EAAE,CAAC;IAExC,MAAMU,OAAkC,GAAG;MACzCC,IAAI,EAAEX,EAAE,CAACW,IAAI;MACbC,eAAe,EAAEd,OAAO,CAACe,YAAY;MACrCJ;IACF,CAAC;IAED,IAAIX,OAAO,CAACgB,cAAc,IAAI,IAAI,EAAE;MAClCJ,OAAO,CAACI,cAAc,GAAGhB,OAAO,CAACgB,cAAc;IACjD;IAEArB,OAAO,CAACQ,IAAI,CAAC,oCAAoC,EAAES,OAAO,CAAC;IAE3D,MAAMnB,aAAa,CAACwB,MAAM,CAACV,UAAU,EAAEK,OAAO,EAAE;MAAEM,OAAO,EAAE;IAAK,CAAC,CAAC;EACpE,CAAC,CAAC,OAAOC,KAAK,EAAE;IACdxB,OAAO,CAACwB,KAAK,CAAC,wBAAwB,EAAEA,KAAK,CAAC;IAC9C,MAAM,IAAIzB,cAAc,CAAC,CAAC,EAAE,cAAc,EAAE,oCAAoC,CAAC;EACnF;AACF","ignoreList":[]}
+{"version":3,"file":"irDeployHandler.js","names":["createPlatformClient","PalantirApiError","DocumentTypes","CommanderError","consola","readFileSync","resolve","convertIrToWireSchema","buildPrefixRewriteFetch","DEFAULT_API_PREFIX","resolveIrInput","irDeployHandler","options","irPath","ir","info","latestVersion","JSON","parse","schema","fileSystemType","firstParty","deployFirstParty","name","deployThirdParty","error","parentFolder","osdkClient","baseUrl","Promise","auth","request","parentFolderRid","result","create","preview","success","version","ontologyRid","fetchFn","firstPartyPrefix","undefined","requestBody","createFirstParty","message","errorName","errorCode","details","filter","Boolean","join"],"sources":["irDeployHandler.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 { createPlatformClient, PalantirApiError } from \"@osdk/client\";\nimport type {\n  CreateDocumentTypeRequest,\n  CreateFirstPartyDocumentTypeRequest,\n} from \"@osdk/foundry.pack\";\nimport { DocumentTypes } from \"@osdk/foundry.pack\";\nimport { CommanderError } from \"commander\";\nimport { consola } from \"consola\";\nimport { readFileSync } from \"fs\";\nimport { resolve } from \"path\";\nimport { convertIrToWireSchema } from \"../../utils/ir/convertIrToWireSchema.js\";\nimport type { FileSystemType } from \"../types.js\";\nimport { buildPrefixRewriteFetch, DEFAULT_API_PREFIX } from \"../utils/firstPartyPrefix.js\";\nimport { resolveIrInput } from \"./resolveIrInput.js\";\n\ninterface DeployOptions {\n  readonly ir: string;\n  readonly baseUrl: string;\n  readonly auth: string;\n  readonly fileSystemType?: FileSystemType;\n  readonly firstParty?: boolean;\n  /** Required for third-party deploys. */\n  readonly parentFolder?: string;\n  /** Required for first-party deploys. */\n  readonly ontologyRid?: string;\n  /** Overrides the API prefix for first-party deploys (e.g. /api/gotham). */\n  readonly firstPartyPrefix?: string;\n}\n\nexport async function irDeployHandler(options: DeployOptions): Promise<void> {\n  try {\n    const irPath = resolve(options.ir);\n    consola.info(`Reading schema from: ${irPath}`);\n\n    const { ir, latestVersion } = resolveIrInput(\n      JSON.parse(readFileSync(irPath, \"utf8\")) as unknown,\n      irPath,\n    );\n    const schema = convertIrToWireSchema(ir);\n    const fileSystemType = options.fileSystemType ?? \"ARTIFACTS\";\n\n    if (options.firstParty) {\n      await deployFirstParty(options, ir.name, schema, latestVersion, fileSystemType);\n    } else {\n      await deployThirdParty(options, ir.name, schema, fileSystemType);\n    }\n  } catch (error) {\n    if (error instanceof CommanderError) {\n      throw error;\n    }\n    consola.error(\"❌ Error during Deploy:\", error);\n    throw new CommanderError(1, \"ERRIRMDEPLOY\", \"Error deploying IR document schema\");\n  }\n}\n\ntype DocumentTypeSchema = CreateDocumentTypeRequest[\"schema\"];\n\nasync function deployThirdParty(\n  options: DeployOptions,\n  name: string,\n  schema: DocumentTypeSchema,\n  fileSystemType: FileSystemType,\n): Promise<void> {\n  if (options.parentFolder == null) {\n    throw new CommanderError(\n      1,\n      \"EINVAL\",\n      \"--parent-folder is required when deploying a third-party document type\",\n    );\n  }\n\n  const osdkClient = createPlatformClient(options.baseUrl, () => Promise.resolve(options.auth));\n\n  const request: CreateDocumentTypeRequest = {\n    name,\n    parentFolderRid: options.parentFolder,\n    schema,\n    fileSystemType,\n  };\n\n  consola.info(\"Creating document type with schema\", request);\n  const result = await DocumentTypes.create(osdkClient, request, { preview: true });\n  consola.success(\"Successfully created document type\", result);\n}\n\nasync function deployFirstParty(\n  options: DeployOptions,\n  name: string,\n  schema: DocumentTypeSchema,\n  version: number,\n  fileSystemType: FileSystemType,\n): Promise<void> {\n  if (options.ontologyRid == null) {\n    throw new CommanderError(\n      1,\n      \"EINVAL\",\n      \"--ontology-rid is required when deploying a first-party document type\",\n    );\n  }\n\n  const fetchFn = options.firstPartyPrefix != null\n    ? buildPrefixRewriteFetch(options.firstPartyPrefix)\n    : undefined;\n  if (fetchFn != null) {\n    consola.info(`Rewriting OSDK '${DEFAULT_API_PREFIX}' -> '${options.firstPartyPrefix}'`);\n  }\n\n  const osdkClient = createPlatformClient(\n    options.baseUrl,\n    () => Promise.resolve(options.auth),\n    undefined,\n    fetchFn,\n  );\n\n  const request: CreateFirstPartyDocumentTypeRequest = {\n    requestBody: {\n      name,\n      ontologyRid: options.ontologyRid,\n      schema,\n      version,\n      fileSystemType,\n    },\n  };\n\n  consola.info(\"Creating first-party document type\", request);\n  try {\n    const result = await DocumentTypes.createFirstParty(osdkClient, request, { preview: true });\n    consola.success(\"Successfully created first-party document type\", result);\n  } catch (error) {\n    if (error instanceof PalantirApiError) {\n      const { message, errorName, errorCode } = error;\n      const details = [errorName, errorCode].filter(Boolean).join(\" \");\n      consola.error(\n        `❌ Error during first-party deploy: ${message}${details ? ` [${details}]` : \"\"}`,\n      );\n    }\n    throw error;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/commands/ir/irGenAssetHandler.js

@@ -20,36 +20,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { basename, dirname, extname, join, resolve } from "path";
 import { GENERATED_JSON_COMMENT } from "../../utils/generatedFileHeader.js";
 import { convertIrToWireSchema } from "../../utils/ir/convertIrToWireSchema.js";
-import { resolveMinVersion } from "../../utils/schema/resolveSchemaChain.js";
-function isChainPayload(parsed) {
-  return typeof parsed === "object" && parsed != null && "chain" in parsed && Array.isArray(parsed.chain) && typeof parsed.latestVersion === "number";
-}
-function resolveFromChain(payload, irPath) {
-  if (payload.chain.length === 0) {
-    throw new CommanderError(1, "EINVAL", `Invalid IR chain payload at ${irPath}: 'chain' is empty`);
-  }
-  const {
-    latestVersion,
-    minVersion
-  } = resolveMinVersion(payload.chain, payload.minSupportedVersion);
-  const latestEntry = payload.chain.find(c => c.version === latestVersion);
-  if (latestEntry == null) {
-    throw new CommanderError(1, "EINVAL", `IR chain payload at ${irPath} has no entry matching latestVersion ${latestVersion}`);
-  }
-  return {
-    ir: latestEntry.ir,
-    latestVersion,
-    minSupportedVersion: minVersion
-  };
-}
-function resolveFromSingleIr(ir) {
-  // Legacy single-IR input has no chain, so min defaults to max (no back-compat claim).
-  return {
-    ir,
-    latestVersion: ir.version,
-    minSupportedVersion: ir.version
-  };
-}
+import { resolveIrInput } from "./resolveIrInput.js";
 function deriveCompatibilityRangePath(assetOutputPath) {
   const stem = basename(assetOutputPath, extname(assetOutputPath));
   return join(dirname(assetOutputPath), `${stem}-schema-compatibility-range.json`);
@@ -84,7 +55,7 @@ export function irGenAssetHandler(options) {
     }
     consola.info(`Reading IR schema from: ${irPath}`);
     const parsed = JSON.parse(readFileSync(irPath, "utf8"));
-    const resolved = isChainPayload(parsed) ? resolveFromChain(parsed, irPath) : resolveFromSingleIr(parsed);
+    const resolved = resolveIrInput(parsed, irPath);
     const {
       ir: irSchema,
       latestVersion,
@@ -110,9 +81,7 @@ export function irGenAssetHandler(options) {
         documentTypeName,
         documentStorageType: {
           type: "yjs",
-          yjs: {
-            schema: wireSchema
-          }
+          schema: wireSchema
         },
         fileSystemType,
         schemaVersion: latestVersion

package/build/esm/commands/ir/irGenAssetHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"irGenAssetHandler.js","names":["CommanderError","consola","existsSync","mkdirSync","readFileSync","writeFileSync","basename","dirname","extname","join","resolve","GENERATED_JSON_COMMENT","convertIrToWireSchema","resolveMinVersion","isChainPayload","parsed","Array","isArray","chain","latestVersion","resolveFromChain","payload","irPath","length","minVersion","minSupportedVersion","latestEntry","find","c","version","ir","resolveFromSingleIr","deriveCompatibilityRangePath","assetOutputPath","stem","irGenAssetHandler","options","outputPath","output","info","JSON","parse","resolved","irSchema","name","documentTypeName","wireSchema","fileSystemType","outputDir","recursive","__comment","documentStorageType","type","yjs","schema","schemaVersion","stringify","compatibilityRangePath","compatibilityRangeOutput","compatibilityRangeDir","min","max","success","error"],"sources":["irGenAssetHandler.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 { CommanderError } from \"commander\";\nimport { consola } from \"consola\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { basename, dirname, extname, join, resolve } from \"path\";\nimport type { IRealTimeDocumentSchema } from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { GENERATED_JSON_COMMENT } from \"../../utils/generatedFileHeader.js\";\nimport { convertIrToWireSchema } from \"../../utils/ir/convertIrToWireSchema.js\";\nimport { type IrChainPayload, resolveMinVersion } from \"../../utils/schema/resolveSchemaChain.js\";\nimport type { DocumentTypeAsset, FileSystemType } from \"../types.js\";\n\ninterface IrGenAssetOptions {\n  readonly ir: string;\n  readonly output: string;\n  readonly fileSystemType?: FileSystemType;\n  readonly compatibilityRangeOutput?: string;\n}\n\ninterface SchemaCompatibilityRangeFile {\n  readonly min: number;\n  readonly max: number;\n}\n\ninterface ResolvedIrInput {\n  readonly ir: IRealTimeDocumentSchema;\n  readonly latestVersion: number;\n  readonly minSupportedVersion: number;\n}\n\nfunction isChainPayload(parsed: unknown): parsed is IrChainPayload {\n  return (\n    typeof parsed === \"object\"\n    && parsed != null\n    && \"chain\" in parsed\n    && Array.isArray((parsed as IrChainPayload).chain)\n    && typeof (parsed as IrChainPayload).latestVersion === \"number\"\n  );\n}\n\nfunction resolveFromChain(payload: IrChainPayload, irPath: string): ResolvedIrInput {\n  if (payload.chain.length === 0) {\n    throw new CommanderError(\n      1,\n      \"EINVAL\",\n      `Invalid IR chain payload at ${irPath}: 'chain' is empty`,\n    );\n  }\n  const { latestVersion, minVersion } = resolveMinVersion(\n    payload.chain,\n    payload.minSupportedVersion,\n  );\n  const latestEntry = payload.chain.find(c => c.version === latestVersion);\n  if (latestEntry == null) {\n    throw new CommanderError(\n      1,\n      \"EINVAL\",\n      `IR chain payload at ${irPath} has no entry matching latestVersion ${latestVersion}`,\n    );\n  }\n  return { ir: latestEntry.ir, latestVersion, minSupportedVersion: minVersion };\n}\n\nfunction resolveFromSingleIr(ir: IRealTimeDocumentSchema): ResolvedIrInput {\n  // Legacy single-IR input has no chain, so min defaults to max (no back-compat claim).\n  return { ir, latestVersion: ir.version, minSupportedVersion: ir.version };\n}\n\nfunction deriveCompatibilityRangePath(assetOutputPath: string): string {\n  const stem = basename(assetOutputPath, extname(assetOutputPath));\n  return join(dirname(assetOutputPath), `${stem}-schema-compatibility-range.json`);\n}\n\n/**\n * Generates a document type asset JSON file (and a sibling schema\n * compatibility range JSON file) from an IR schema.\n *\n * The input IR may be either:\n *  - a chain payload `{ latestVersion, minSupportedVersion?, chain }` produced\n *    by `schema ir`. The latest entry's `ir` is used as the wire schema; the\n *    asset's `schemaVersion` is `latestVersion`; the compatibility range is\n *    `{ min: minSupportedVersion ?? latestVersion, max: latestVersion }`.\n *  - a bare single-version `IRealTimeDocumentSchema` (legacy). The compat\n *    range defaults to `{ min: version, max: version }` since no chain\n *    information is available.\n *\n * This command is intended for internal platform applications where the\n * document type asset must exist on disk so the platform can discover it and\n * register the document type automatically at deploy time. Most users should\n * use `ir deploy` to register document types via the Foundry API instead.\n *\n * If you are unsure whether you need this command, you almost certainly do not.\n */\nexport function irGenAssetHandler(options: IrGenAssetOptions): void {\n  try {\n    const irPath = resolve(options.ir);\n    const outputPath = resolve(options.output);\n\n    if (!existsSync(irPath)) {\n      throw new CommanderError(1, \"ENOENT\", `IR file does not exist: ${irPath}`);\n    }\n\n    consola.info(`Reading IR schema from: ${irPath}`);\n    const parsed = JSON.parse(readFileSync(irPath, \"utf8\")) as unknown;\n\n    const resolved = isChainPayload(parsed)\n      ? resolveFromChain(parsed, irPath)\n      : resolveFromSingleIr(parsed as IRealTimeDocumentSchema);\n\n    const { ir: irSchema, latestVersion, minSupportedVersion } = resolved;\n    const { name: documentTypeName } = irSchema;\n    const wireSchema = convertIrToWireSchema(irSchema);\n\n    const fileSystemType = options.fileSystemType ?? \"ARTIFACTS\";\n    if (fileSystemType !== \"ARTIFACTS\" && fileSystemType !== \"COMPASS\") {\n      throw new CommanderError(\n        1,\n        \"EINVAL\",\n        `Invalid fileSystemType \"${fileSystemType}\". Must be \"ARTIFACTS\" or \"COMPASS\".`,\n      );\n    }\n\n    const asset: DocumentTypeAsset = {\n      documentTypeName,\n      documentStorageType: {\n        type: \"yjs\",\n        yjs: {\n          schema: wireSchema,\n        },\n      },\n      fileSystemType,\n      schemaVersion: latestVersion,\n    };\n\n    const outputDir = dirname(outputPath);\n    if (!existsSync(outputDir)) {\n      mkdirSync(outputDir, { recursive: true });\n    }\n    const output = { __comment: GENERATED_JSON_COMMENT, ...asset };\n    writeFileSync(outputPath, JSON.stringify(output, null, 2), \"utf8\");\n\n    const compatibilityRange: SchemaCompatibilityRangeFile = {\n      min: minSupportedVersion,\n      max: latestVersion,\n    };\n    const compatibilityRangePath = resolve(\n      options.compatibilityRangeOutput ?? deriveCompatibilityRangePath(outputPath),\n    );\n    const compatibilityRangeDir = dirname(compatibilityRangePath);\n    if (!existsSync(compatibilityRangeDir)) {\n      mkdirSync(compatibilityRangeDir, { recursive: true });\n    }\n    const compatibilityRangeOutput = {\n      __comment: GENERATED_JSON_COMMENT,\n      ...compatibilityRange,\n    };\n    writeFileSync(\n      compatibilityRangePath,\n      JSON.stringify(compatibilityRangeOutput, null, 2),\n      \"utf8\",\n    );\n\n    consola.success(\"Successfully generated document type asset\");\n    consola.info(`   Output: ${outputPath}`);\n    consola.info(`   Compatibility range output: ${compatibilityRangePath}`);\n    consola.info(`   Document type: ${documentTypeName}`);\n    consola.info(`   Schema version: ${latestVersion}`);\n    consola.info(`   Compatibility range: [${minSupportedVersion}, ${latestVersion}]`);\n    consola.info(`   File system type: ${fileSystemType}`);\n  } catch (error) {\n    if (error instanceof CommanderError) {\n      throw error;\n    }\n    consola.error(\"Error generating document type asset:\", error);\n    throw new CommanderError(1, \"IR_ASSET_ERROR\", \"Failed to generate document type asset\");\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"irGenAssetHandler.js","names":["CommanderError","consola","existsSync","mkdirSync","readFileSync","writeFileSync","basename","dirname","extname","join","resolve","GENERATED_JSON_COMMENT","convertIrToWireSchema","resolveIrInput","deriveCompatibilityRangePath","assetOutputPath","stem","irGenAssetHandler","options","irPath","ir","outputPath","output","info","parsed","JSON","parse","resolved","irSchema","latestVersion","minSupportedVersion","name","documentTypeName","wireSchema","fileSystemType","outputDir","recursive","__comment","documentStorageType","type","schema","schemaVersion","stringify","compatibilityRangePath","compatibilityRangeOutput","compatibilityRangeDir","min","max","success","error"],"sources":["irGenAssetHandler.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 { CommanderError } from \"commander\";\nimport { consola } from \"consola\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { basename, dirname, extname, join, resolve } from \"path\";\nimport { GENERATED_JSON_COMMENT } from \"../../utils/generatedFileHeader.js\";\nimport { convertIrToWireSchema } from \"../../utils/ir/convertIrToWireSchema.js\";\nimport type { DocumentTypeAsset, FileSystemType } from \"../types.js\";\nimport { resolveIrInput } from \"./resolveIrInput.js\";\n\ninterface IrGenAssetOptions {\n  readonly ir: string;\n  readonly output: string;\n  readonly fileSystemType?: FileSystemType;\n  readonly compatibilityRangeOutput?: string;\n}\n\ninterface SchemaCompatibilityRangeFile {\n  readonly min: number;\n  readonly max: number;\n}\n\nfunction deriveCompatibilityRangePath(assetOutputPath: string): string {\n  const stem = basename(assetOutputPath, extname(assetOutputPath));\n  return join(dirname(assetOutputPath), `${stem}-schema-compatibility-range.json`);\n}\n\n/**\n * Generates a document type asset JSON file (and a sibling schema\n * compatibility range JSON file) from an IR schema.\n *\n * The input IR may be either:\n *  - a chain payload `{ latestVersion, minSupportedVersion?, chain }` produced\n *    by `schema ir`. The latest entry's `ir` is used as the wire schema; the\n *    asset's `schemaVersion` is `latestVersion`; the compatibility range is\n *    `{ min: minSupportedVersion ?? latestVersion, max: latestVersion }`.\n *  - a bare single-version `IRealTimeDocumentSchema` (legacy). The compat\n *    range defaults to `{ min: version, max: version }` since no chain\n *    information is available.\n *\n * This command is intended for internal platform applications where the\n * document type asset must exist on disk so the platform can discover it and\n * register the document type automatically at deploy time. Most users should\n * use `ir deploy` to register document types via the Foundry API instead.\n *\n * If you are unsure whether you need this command, you almost certainly do not.\n */\nexport function irGenAssetHandler(options: IrGenAssetOptions): void {\n  try {\n    const irPath = resolve(options.ir);\n    const outputPath = resolve(options.output);\n\n    if (!existsSync(irPath)) {\n      throw new CommanderError(1, \"ENOENT\", `IR file does not exist: ${irPath}`);\n    }\n\n    consola.info(`Reading IR schema from: ${irPath}`);\n    const parsed = JSON.parse(readFileSync(irPath, \"utf8\")) as unknown;\n\n    const resolved = resolveIrInput(parsed, irPath);\n\n    const { ir: irSchema, latestVersion, minSupportedVersion } = resolved;\n    const { name: documentTypeName } = irSchema;\n    const wireSchema = convertIrToWireSchema(irSchema);\n\n    const fileSystemType = options.fileSystemType ?? \"ARTIFACTS\";\n    if (fileSystemType !== \"ARTIFACTS\" && fileSystemType !== \"COMPASS\") {\n      throw new CommanderError(\n        1,\n        \"EINVAL\",\n        `Invalid fileSystemType \"${fileSystemType}\". Must be \"ARTIFACTS\" or \"COMPASS\".`,\n      );\n    }\n\n    const asset: DocumentTypeAsset = {\n      documentTypeName,\n      documentStorageType: {\n        type: \"yjs\",\n        schema: wireSchema,\n      },\n      fileSystemType,\n      schemaVersion: latestVersion,\n    };\n\n    const outputDir = dirname(outputPath);\n    if (!existsSync(outputDir)) {\n      mkdirSync(outputDir, { recursive: true });\n    }\n    const output = { __comment: GENERATED_JSON_COMMENT, ...asset };\n    writeFileSync(outputPath, JSON.stringify(output, null, 2), \"utf8\");\n\n    const compatibilityRange: SchemaCompatibilityRangeFile = {\n      min: minSupportedVersion,\n      max: latestVersion,\n    };\n    const compatibilityRangePath = resolve(\n      options.compatibilityRangeOutput ?? deriveCompatibilityRangePath(outputPath),\n    );\n    const compatibilityRangeDir = dirname(compatibilityRangePath);\n    if (!existsSync(compatibilityRangeDir)) {\n      mkdirSync(compatibilityRangeDir, { recursive: true });\n    }\n    const compatibilityRangeOutput = {\n      __comment: GENERATED_JSON_COMMENT,\n      ...compatibilityRange,\n    };\n    writeFileSync(\n      compatibilityRangePath,\n      JSON.stringify(compatibilityRangeOutput, null, 2),\n      \"utf8\",\n    );\n\n    consola.success(\"Successfully generated document type asset\");\n    consola.info(`   Output: ${outputPath}`);\n    consola.info(`   Compatibility range output: ${compatibilityRangePath}`);\n    consola.info(`   Document type: ${documentTypeName}`);\n    consola.info(`   Schema version: ${latestVersion}`);\n    consola.info(`   Compatibility range: [${minSupportedVersion}, ${latestVersion}]`);\n    consola.info(`   File system type: ${fileSystemType}`);\n  } catch (error) {\n    if (error instanceof CommanderError) {\n      throw error;\n    }\n    consola.error(\"Error generating document type asset:\", error);\n    throw new CommanderError(1, \"IR_ASSET_ERROR\", \"Failed to generate document type asset\");\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/commands/{asset/assetUpdateSchemaHandler.js → ir/irUpdateSchemaHandler.js}

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ * Copyright 2026 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.
@@ -14,33 +14,39 @@
  * limitations under the License.
  */
 
-import { createPlatformClient, PalantirApiError } from "@osdk/client";
+import { createPlatformClient } from "@osdk/client";
 import { DocumentTypes } from "@osdk/foundry.pack";
 import { CommanderError } from "commander";
 import { consola } from "consola";
 import { readFileSync } from "fs";
 import { resolve } from "path";
-import { buildPrefixRewriteFetch } from "./assetDeployHandler.js";
-const DEFAULT_API_PREFIX = "/api";
-
-/** Updates the schema of an existing document type using a generated asset JSON file. */
-export async function assetUpdateSchemaHandler(options) {
+import { convertIrToWireSchema } from "../../utils/ir/convertIrToWireSchema.js";
+import { buildPrefixRewriteFetch, DEFAULT_API_PREFIX } from "../utils/firstPartyPrefix.js";
+import { resolveIrInput } from "./resolveIrInput.js";
+/**
+ * Updates the schema of an existing document type from an IR file. Sources the wire schema and version directly from
+ * the IR (the same single source of truth used by `ir deploy`), avoiding a separately-generated asset file.
+ */
+export async function irUpdateSchemaHandler(options) {
   try {
-    const assetPath = resolve(options.input);
-    consola.info(`Reading asset file from: ${assetPath}`);
-    const assetContent = readFileSync(assetPath, "utf8");
-    const asset = JSON.parse(assetContent);
+    const irPath = resolve(options.ir);
+    consola.info(`Reading schema from: ${irPath}`);
+    const {
+      ir,
+      latestVersion
+    } = resolveIrInput(JSON.parse(readFileSync(irPath, "utf8")), irPath);
+    const schema = convertIrToWireSchema(ir);
     const fetchFn = options.firstPartyPrefix != null ? buildPrefixRewriteFetch(options.firstPartyPrefix) : undefined;
     if (fetchFn != null) {
       consola.info(`Rewriting OSDK '${DEFAULT_API_PREFIX}' -> '${options.firstPartyPrefix}'`);
     }
     const osdkClient = createPlatformClient(options.baseUrl, () => Promise.resolve(options.auth), undefined, fetchFn);
     const request = {
-      documentTypeName: asset.documentTypeName,
+      documentTypeName: ir.name,
       requestBody: {
         ontologyRid: options.ontologyRid,
-        schema: asset.documentStorageType.yjs.schema,
-        version: asset.schemaVersion,
+        schema,
+        version: latestVersion,
         ...(options.forceOverwrite ? {
           forceOverwrite: true
         } : {})
@@ -49,7 +55,7 @@ export async function assetUpdateSchemaHandler(options) {
     if (options.forceOverwrite) {
       consola.warn("--force-overwrite is set: backwards-compatibility validation will be skipped.");
     }
-    consola.info(`Updating schema for document type "${asset.documentTypeName}" -> version ${asset.schemaVersion}`);
+    consola.info(`Updating schema for document type "${ir.name}" -> version ${latestVersion}`);
     const result = await DocumentTypes.updateSchema(osdkClient, request, {
       preview: true
     });
@@ -59,26 +65,15 @@ export async function assetUpdateSchemaHandler(options) {
     }
     consola.error(`Schema validation failed with ${result.violations.length} violation(s):`);
     for (const violation of result.violations) {
-      consola.error(`  - ${violation.fieldPath}\t${violation.violationType}\t${violation.message}`);
+      consola.error(`  - ${violation.fieldPath}: ${violation.message} (${violation.violationType})`);
     }
-    consola.info("Hint: re-run with --force-overwrite to skip validation.");
-    throw new CommanderError(1, "ERRSCHEMAVALIDATION", "Schema validation failed during update");
+    throw new CommanderError(1, "ERRIRUPDATESCHEMA", "Schema validation failed");
   } catch (error) {
     if (error instanceof CommanderError) {
       throw error;
     }
-    if (error instanceof PalantirApiError) {
-      const {
-        message,
-        errorName,
-        errorCode
-      } = error;
-      const details = [errorName, errorCode].filter(Boolean).join(" ");
-      consola.error(`❌ Error during schema update: ${message}${details ? ` [${details}]` : ""}`);
-    } else {
-      consola.error("❌ Error during schema update:", error);
-    }
-    throw new CommanderError(1, "ERRASSETUPDATESCHEMA", "Error updating document type schema");
+    consola.error("❌ Error during update-schema:", error);
+    throw new CommanderError(1, "ERRIRUPDATESCHEMA", "Error updating schema from IR");
   }
 }
-//# sourceMappingURL=assetUpdateSchemaHandler.js.map
+//# sourceMappingURL=irUpdateSchemaHandler.js.map

package/build/esm/commands/ir/irUpdateSchemaHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"irUpdateSchemaHandler.js","names":["createPlatformClient","DocumentTypes","CommanderError","consola","readFileSync","resolve","convertIrToWireSchema","buildPrefixRewriteFetch","DEFAULT_API_PREFIX","resolveIrInput","irUpdateSchemaHandler","options","irPath","ir","info","latestVersion","JSON","parse","schema","fetchFn","firstPartyPrefix","undefined","osdkClient","baseUrl","Promise","auth","request","documentTypeName","name","requestBody","ontologyRid","version","forceOverwrite","warn","result","updateSchema","preview","type","success","error","violations","length","violation","fieldPath","message","violationType"],"sources":["irUpdateSchemaHandler.ts"],"sourcesContent":["/*\n * Copyright 2026 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 { createPlatformClient } from \"@osdk/client\";\nimport type { UpdateSchemaDocumentTypeRequest } from \"@osdk/foundry.pack\";\nimport { DocumentTypes } from \"@osdk/foundry.pack\";\nimport { CommanderError } from \"commander\";\nimport { consola } from \"consola\";\nimport { readFileSync } from \"fs\";\nimport { resolve } from \"path\";\nimport { convertIrToWireSchema } from \"../../utils/ir/convertIrToWireSchema.js\";\nimport { buildPrefixRewriteFetch, DEFAULT_API_PREFIX } from \"../utils/firstPartyPrefix.js\";\nimport { resolveIrInput } from \"./resolveIrInput.js\";\n\ninterface IrUpdateSchemaOptions {\n  readonly ir: string;\n  readonly baseUrl: string;\n  readonly auth: string;\n  readonly ontologyRid: string;\n  readonly forceOverwrite?: boolean;\n  readonly firstPartyPrefix?: string;\n}\n\n/**\n * Updates the schema of an existing document type from an IR file. Sources the wire schema and version directly from\n * the IR (the same single source of truth used by `ir deploy`), avoiding a separately-generated asset file.\n */\nexport async function irUpdateSchemaHandler(options: IrUpdateSchemaOptions): Promise<void> {\n  try {\n    const irPath = resolve(options.ir);\n    consola.info(`Reading schema from: ${irPath}`);\n\n    const { ir, latestVersion } = resolveIrInput(\n      JSON.parse(readFileSync(irPath, \"utf8\")) as unknown,\n      irPath,\n    );\n    const schema = convertIrToWireSchema(ir);\n\n    const fetchFn = options.firstPartyPrefix != null\n      ? buildPrefixRewriteFetch(options.firstPartyPrefix)\n      : undefined;\n    if (fetchFn != null) {\n      consola.info(`Rewriting OSDK '${DEFAULT_API_PREFIX}' -> '${options.firstPartyPrefix}'`);\n    }\n\n    const osdkClient = createPlatformClient(\n      options.baseUrl,\n      () => Promise.resolve(options.auth),\n      undefined,\n      fetchFn,\n    );\n\n    const request: UpdateSchemaDocumentTypeRequest = {\n      documentTypeName: ir.name,\n      requestBody: {\n        ontologyRid: options.ontologyRid,\n        schema,\n        version: latestVersion,\n        ...(options.forceOverwrite ? { forceOverwrite: true } : {}),\n      },\n    };\n\n    if (options.forceOverwrite) {\n      consola.warn(\"--force-overwrite is set: backwards-compatibility validation will be skipped.\");\n    }\n    consola.info(`Updating schema for document type \"${ir.name}\" -> version ${latestVersion}`);\n\n    const result = await DocumentTypes.updateSchema(osdkClient, request, { preview: true });\n\n    if (result.type === \"success\") {\n      consola.success(`Schema updated successfully (version ${result.version})`);\n      return;\n    }\n\n    consola.error(`Schema validation failed with ${result.violations.length} violation(s):`);\n    for (const violation of result.violations) {\n      consola.error(\n        `  - ${violation.fieldPath}: ${violation.message} (${violation.violationType})`,\n      );\n    }\n    throw new CommanderError(1, \"ERRIRUPDATESCHEMA\", \"Schema validation failed\");\n  } catch (error) {\n    if (error instanceof CommanderError) {\n      throw error;\n    }\n    consola.error(\"❌ Error during update-schema:\", error);\n    throw new CommanderError(1, \"ERRIRUPDATESCHEMA\", \"Error updating schema from IR\");\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/commands/ir/registerIrCommands.js

@@ -19,12 +19,14 @@ import { irGenAssetHandler } from "./irGenAssetHandler.js";
 import { irGenModelsHandler } from "./irGenModelsHandler.js";
 import { irGenTypesHandler } from "./irGenTypesHandler.js";
 import { irGenZodHandler } from "./irGenZodHandler.js";
+import { irUpdateSchemaHandler } from "./irUpdateSchemaHandler.js";
 export function registerIrCommands(program) {
   const irCmd = program.command("ir").description("IR (Intermediate Representation) based generation commands");
   irCmd.command("gen-types").description("Generate versioned SDK files (types, schemas, internal/, models.ts, versions.ts, versionedDocRef.ts, index.ts) from a versioned IR chain JSON.").requiredOption("-s, --schema <file>", "Path to versioned IR chain JSON file").requiredOption("-o, --output <dir>", "Output directory for generated SDK files").action(irGenTypesHandler);
   irCmd.command("zod").description("Generate Zod schemas from IR document schema definitions").requiredOption("-s, --schema <file>", "Path to schema JSON file").requiredOption("-o, --output <file>", "Output file path for generated Zod schemas").option("-t, --type-import-path <path>", "Path to import types from (enables satisfies operators)").action(irGenZodHandler);
   irCmd.command("models").description("Generate Model constants from IR document schema definitions").requiredOption("-s, --schema <file>", "Path to schema JSON file").requiredOption("-o, --output <file>", "Output file path for generated Model constants").option("-t, --type-import-path <path>", "Path to import types from", "./types.js").option("--schema-import-path <path>", "Path to import schemas from", "./schema.js").action(irGenModelsHandler);
-  irCmd.command("deploy").description("Create a document type on a Foundry stack using an IR document schema").requiredOption("-i, --ir <file>", "Path to IR JSON file").requiredOption("-b, --base-url <url>", "Base URL for Foundry API").requiredOption("-a, --auth <token>", "Authentication token for Foundry API").requiredOption("-p, --parent-folder <rid>", "Parent folder RID for the document type").requiredOption("-f, --file-system-type <type>", "File system type for the document type (ARTIFACTS or COMPASS)").action(irDeployHandler);
+  irCmd.command("deploy").description("Create a document type on a Foundry stack using an IR document schema. Deploys via the general " + "(third-party) path by default, or the first-party path with --first-party.").requiredOption("-i, --ir <file>", "Path to IR JSON file (chain payload from 'schema ir', or legacy single-version IR)").requiredOption("-b, --base-url <url>", "Base URL for Foundry API").requiredOption("-a, --auth <token>", "Authentication token for Foundry API").option("-p, --parent-folder <rid>", "Parent folder RID for the document type (required for third-party deploys)").option("--first-party", "Deploy as a first-party document type (uses the first-party endpoint; requires --ontology-rid)", false).option("-o, --ontology-rid <rid>", "Target ontology RID (required for first-party deploys)").option("-f, --file-system-type <type>", "File system type for the document type (ARTIFACTS or COMPASS)").option("--first-party-prefix <path>", "Override the API prefix used for first-party requests (e.g. /api/gotham). Defaults to /api.").action(irDeployHandler);
+  irCmd.command("update-schema").description("Update the schema of an existing document type using an IR document schema").requiredOption("-i, --ir <file>", "Path to IR JSON file (chain payload from 'schema ir', or legacy single-version IR)").requiredOption("-b, --base-url <url>", "Base URL for Foundry API").requiredOption("-a, --auth <token>", "Authentication token for Foundry API").requiredOption("-o, --ontology-rid <rid>", "Target ontology RID").option("--force-overwrite", "Skip backwards-compatibility validation when updating the schema", false).option("--first-party-prefix <path>", "Override the API prefix used for first-party requests (e.g. /api/gotham). Defaults to /api.").action(irUpdateSchemaHandler);
   irCmd.command("asset").description("Generate document type asset JSON and a sibling schema compatibility range JSON from an IR file (advanced — most users should use 'ir deploy' instead). The minimum supported schema version is sourced from the IR payload's 'minSupportedVersion' field (set by 'schema ir --config <pack-config.json>'); legacy single-IR inputs default to min == max.").requiredOption("-i, --ir <file>", "Path to IR JSON file (chain payload from 'schema ir', or legacy single-version IR)").requiredOption("-o, --output <file>", "Output file path for asset JSON").option("-f, --file-system-type <type>", "File system type (ARTIFACTS or COMPASS)", "ARTIFACTS").option("--compatibility-range-output <file>", "Output path for the schema compatibility range JSON (defaults to a sibling of --output with '-schema-compatibility-range' suffix)").action(irGenAssetHandler);
 }
 //# sourceMappingURL=registerIrCommands.js.map

package/build/esm/commands/ir/registerIrCommands.js.map

@@ -1 +1 @@
-{"version":3,"file":"registerIrCommands.js","names":["irDeployHandler","irGenAssetHandler","irGenModelsHandler","irGenTypesHandler","irGenZodHandler","registerIrCommands","program","irCmd","command","description","requiredOption","action","option"],"sources":["registerIrCommands.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 { Command } from \"commander\";\nimport { irDeployHandler } from \"./irDeployHandler.js\";\nimport { irGenAssetHandler } from \"./irGenAssetHandler.js\";\nimport { irGenModelsHandler } from \"./irGenModelsHandler.js\";\nimport { irGenTypesHandler } from \"./irGenTypesHandler.js\";\nimport { irGenZodHandler } from \"./irGenZodHandler.js\";\n\nexport function registerIrCommands(program: Command): void {\n  const irCmd = program\n    .command(\"ir\")\n    .description(\"IR (Intermediate Representation) based generation commands\");\n\n  irCmd\n    .command(\"gen-types\")\n    .description(\n      \"Generate versioned SDK files (types, schemas, internal/, models.ts, versions.ts, versionedDocRef.ts, index.ts) from a versioned IR chain JSON.\",\n    )\n    .requiredOption(\"-s, --schema <file>\", \"Path to versioned IR chain JSON file\")\n    .requiredOption(\"-o, --output <dir>\", \"Output directory for generated SDK files\")\n    .action(irGenTypesHandler);\n\n  irCmd\n    .command(\"zod\")\n    .description(\"Generate Zod schemas from IR document schema definitions\")\n    .requiredOption(\"-s, --schema <file>\", \"Path to schema JSON file\")\n    .requiredOption(\"-o, --output <file>\", \"Output file path for generated Zod schemas\")\n    .option(\n      \"-t, --type-import-path <path>\",\n      \"Path to import types from (enables satisfies operators)\",\n    )\n    .action(irGenZodHandler);\n\n  irCmd\n    .command(\"models\")\n    .description(\"Generate Model constants from IR document schema definitions\")\n    .requiredOption(\"-s, --schema <file>\", \"Path to schema JSON file\")\n    .requiredOption(\"-o, --output <file>\", \"Output file path for generated Model constants\")\n    .option(\n      \"-t, --type-import-path <path>\",\n      \"Path to import types from\",\n      \"./types.js\",\n    )\n    .option(\n      \"--schema-import-path <path>\",\n      \"Path to import schemas from\",\n      \"./schema.js\",\n    )\n    .action(irGenModelsHandler);\n\n  irCmd\n    .command(\"deploy\")\n    .description(\"Create a document type on a Foundry stack using an IR document schema\")\n    .requiredOption(\"-i, --ir <file>\", \"Path to IR JSON file\")\n    .requiredOption(\"-b, --base-url <url>\", \"Base URL for Foundry API\")\n    .requiredOption(\"-a, --auth <token>\", \"Authentication token for Foundry API\")\n    .requiredOption(\"-p, --parent-folder <rid>\", \"Parent folder RID for the document type\")\n    .requiredOption(\n      \"-f, --file-system-type <type>\",\n      \"File system type for the document type (ARTIFACTS or COMPASS)\",\n    )\n    .action(irDeployHandler);\n\n  irCmd\n    .command(\"asset\")\n    .description(\n      \"Generate document type asset JSON and a sibling schema compatibility range JSON from an IR file (advanced — most users should use 'ir deploy' instead). The minimum supported schema version is sourced from the IR payload's 'minSupportedVersion' field (set by 'schema ir --config <pack-config.json>'); legacy single-IR inputs default to min == max.\",\n    )\n    .requiredOption(\n      \"-i, --ir <file>\",\n      \"Path to IR JSON file (chain payload from 'schema ir', or legacy single-version IR)\",\n    )\n    .requiredOption(\"-o, --output <file>\", \"Output file path for asset JSON\")\n    .option(\n      \"-f, --file-system-type <type>\",\n      \"File system type (ARTIFACTS or COMPASS)\",\n      \"ARTIFACTS\",\n    )\n    .option(\n      \"--compatibility-range-output <file>\",\n      \"Output path for the schema compatibility range JSON (defaults to a sibling of --output with '-schema-compatibility-range' suffix)\",\n    )\n    .action(irGenAssetHandler);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,eAAe,QAAQ,sBAAsB;AACtD,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,kBAAkB,QAAQ,yBAAyB;AAC5D,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,eAAe,QAAQ,sBAAsB;AAEtD,OAAO,SAASC,kBAAkBA,CAACC,OAAgB,EAAQ;EACzD,MAAMC,KAAK,GAAGD,OAAO,CAClBE,OAAO,CAAC,IAAI,CAAC,CACbC,WAAW,CAAC,4DAA4D,CAAC;EAE5EF,KAAK,CACFC,OAAO,CAAC,WAAW,CAAC,CACpBC,WAAW,CACV,gJACF,CAAC,CACAC,cAAc,CAAC,qBAAqB,EAAE,sCAAsC,CAAC,CAC7EA,cAAc,CAAC,oBAAoB,EAAE,0CAA0C,CAAC,CAChFC,MAAM,CAACR,iBAAiB,CAAC;EAE5BI,KAAK,CACFC,OAAO,CAAC,KAAK,CAAC,CACdC,WAAW,CAAC,0DAA0D,CAAC,CACvEC,cAAc,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CACjEA,cAAc,CAAC,qBAAqB,EAAE,4CAA4C,CAAC,CACnFE,MAAM,CACL,+BAA+B,EAC/B,yDACF,CAAC,CACAD,MAAM,CAACP,eAAe,CAAC;EAE1BG,KAAK,CACFC,OAAO,CAAC,QAAQ,CAAC,CACjBC,WAAW,CAAC,8DAA8D,CAAC,CAC3EC,cAAc,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CACjEA,cAAc,CAAC,qBAAqB,EAAE,gDAAgD,CAAC,CACvFE,MAAM,CACL,+BAA+B,EAC/B,2BAA2B,EAC3B,YACF,CAAC,CACAA,MAAM,CACL,6BAA6B,EAC7B,6BAA6B,EAC7B,aACF,CAAC,CACAD,MAAM,CAACT,kBAAkB,CAAC;EAE7BK,KAAK,CACFC,OAAO,CAAC,QAAQ,CAAC,CACjBC,WAAW,CAAC,uEAAuE,CAAC,CACpFC,cAAc,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,CACzDA,cAAc,CAAC,sBAAsB,EAAE,0BAA0B,CAAC,CAClEA,cAAc,CAAC,oBAAoB,EAAE,sCAAsC,CAAC,CAC5EA,cAAc,CAAC,2BAA2B,EAAE,yCAAyC,CAAC,CACtFA,cAAc,CACb,+BAA+B,EAC/B,+DACF,CAAC,CACAC,MAAM,CAACX,eAAe,CAAC;EAE1BO,KAAK,CACFC,OAAO,CAAC,OAAO,CAAC,CAChBC,WAAW,CACV,4VACF,CAAC,CACAC,cAAc,CACb,iBAAiB,EACjB,oFACF,CAAC,CACAA,cAAc,CAAC,qBAAqB,EAAE,iCAAiC,CAAC,CACxEE,MAAM,CACL,+BAA+B,EAC/B,yCAAyC,EACzC,WACF,CAAC,CACAA,MAAM,CACL,qCAAqC,EACrC,mIACF,CAAC,CACAD,MAAM,CAACV,iBAAiB,CAAC;AAC9B","ignoreList":[]}
+{"version":3,"file":"registerIrCommands.js","names":["irDeployHandler","irGenAssetHandler","irGenModelsHandler","irGenTypesHandler","irGenZodHandler","irUpdateSchemaHandler","registerIrCommands","program","irCmd","command","description","requiredOption","action","option"],"sources":["registerIrCommands.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 { Command } from \"commander\";\nimport { irDeployHandler } from \"./irDeployHandler.js\";\nimport { irGenAssetHandler } from \"./irGenAssetHandler.js\";\nimport { irGenModelsHandler } from \"./irGenModelsHandler.js\";\nimport { irGenTypesHandler } from \"./irGenTypesHandler.js\";\nimport { irGenZodHandler } from \"./irGenZodHandler.js\";\nimport { irUpdateSchemaHandler } from \"./irUpdateSchemaHandler.js\";\n\nexport function registerIrCommands(program: Command): void {\n  const irCmd = program\n    .command(\"ir\")\n    .description(\"IR (Intermediate Representation) based generation commands\");\n\n  irCmd\n    .command(\"gen-types\")\n    .description(\n      \"Generate versioned SDK files (types, schemas, internal/, models.ts, versions.ts, versionedDocRef.ts, index.ts) from a versioned IR chain JSON.\",\n    )\n    .requiredOption(\"-s, --schema <file>\", \"Path to versioned IR chain JSON file\")\n    .requiredOption(\"-o, --output <dir>\", \"Output directory for generated SDK files\")\n    .action(irGenTypesHandler);\n\n  irCmd\n    .command(\"zod\")\n    .description(\"Generate Zod schemas from IR document schema definitions\")\n    .requiredOption(\"-s, --schema <file>\", \"Path to schema JSON file\")\n    .requiredOption(\"-o, --output <file>\", \"Output file path for generated Zod schemas\")\n    .option(\n      \"-t, --type-import-path <path>\",\n      \"Path to import types from (enables satisfies operators)\",\n    )\n    .action(irGenZodHandler);\n\n  irCmd\n    .command(\"models\")\n    .description(\"Generate Model constants from IR document schema definitions\")\n    .requiredOption(\"-s, --schema <file>\", \"Path to schema JSON file\")\n    .requiredOption(\"-o, --output <file>\", \"Output file path for generated Model constants\")\n    .option(\n      \"-t, --type-import-path <path>\",\n      \"Path to import types from\",\n      \"./types.js\",\n    )\n    .option(\n      \"--schema-import-path <path>\",\n      \"Path to import schemas from\",\n      \"./schema.js\",\n    )\n    .action(irGenModelsHandler);\n\n  irCmd\n    .command(\"deploy\")\n    .description(\n      \"Create a document type on a Foundry stack using an IR document schema. Deploys via the general \"\n        + \"(third-party) path by default, or the first-party path with --first-party.\",\n    )\n    .requiredOption(\n      \"-i, --ir <file>\",\n      \"Path to IR JSON file (chain payload from 'schema ir', or legacy single-version IR)\",\n    )\n    .requiredOption(\"-b, --base-url <url>\", \"Base URL for Foundry API\")\n    .requiredOption(\"-a, --auth <token>\", \"Authentication token for Foundry API\")\n    .option(\n      \"-p, --parent-folder <rid>\",\n      \"Parent folder RID for the document type (required for third-party deploys)\",\n    )\n    .option(\n      \"--first-party\",\n      \"Deploy as a first-party document type (uses the first-party endpoint; requires --ontology-rid)\",\n      false,\n    )\n    .option(\n      \"-o, --ontology-rid <rid>\",\n      \"Target ontology RID (required for first-party deploys)\",\n    )\n    .option(\n      \"-f, --file-system-type <type>\",\n      \"File system type for the document type (ARTIFACTS or COMPASS)\",\n    )\n    .option(\n      \"--first-party-prefix <path>\",\n      \"Override the API prefix used for first-party requests (e.g. /api/gotham). Defaults to /api.\",\n    )\n    .action(irDeployHandler);\n\n  irCmd\n    .command(\"update-schema\")\n    .description(\"Update the schema of an existing document type using an IR document schema\")\n    .requiredOption(\n      \"-i, --ir <file>\",\n      \"Path to IR JSON file (chain payload from 'schema ir', or legacy single-version IR)\",\n    )\n    .requiredOption(\"-b, --base-url <url>\", \"Base URL for Foundry API\")\n    .requiredOption(\"-a, --auth <token>\", \"Authentication token for Foundry API\")\n    .requiredOption(\"-o, --ontology-rid <rid>\", \"Target ontology RID\")\n    .option(\n      \"--force-overwrite\",\n      \"Skip backwards-compatibility validation when updating the schema\",\n      false,\n    )\n    .option(\n      \"--first-party-prefix <path>\",\n      \"Override the API prefix used for first-party requests (e.g. /api/gotham). Defaults to /api.\",\n    )\n    .action(irUpdateSchemaHandler);\n\n  irCmd\n    .command(\"asset\")\n    .description(\n      \"Generate document type asset JSON and a sibling schema compatibility range JSON from an IR file (advanced — most users should use 'ir deploy' instead). The minimum supported schema version is sourced from the IR payload's 'minSupportedVersion' field (set by 'schema ir --config <pack-config.json>'); legacy single-IR inputs default to min == max.\",\n    )\n    .requiredOption(\n      \"-i, --ir <file>\",\n      \"Path to IR JSON file (chain payload from 'schema ir', or legacy single-version IR)\",\n    )\n    .requiredOption(\"-o, --output <file>\", \"Output file path for asset JSON\")\n    .option(\n      \"-f, --file-system-type <type>\",\n      \"File system type (ARTIFACTS or COMPASS)\",\n      \"ARTIFACTS\",\n    )\n    .option(\n      \"--compatibility-range-output <file>\",\n      \"Output path for the schema compatibility range JSON (defaults to a sibling of --output with '-schema-compatibility-range' suffix)\",\n    )\n    .action(irGenAssetHandler);\n}\n"],"mappings":"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","ignoreList":[]}