@palantir/pack.document-schema.type-gen 0.24.0 → 0.25.0

package/README.md

@@ -72,6 +72,20 @@ type-gen ir update-schema -i <ir.json> -b <base-url> -a <token> -o <ontology-rid
 `ir asset` (generate an asset JSON consumed by backpack's asset-track loader) remains available;
 the deploy/update-schema REST commands are IR-sourced.
 
+```bash
+# Generate the asset JSON (plus a sibling schema compatibility range JSON)
+type-gen ir asset -i <ir.json> -o <asset.json> [-f ARTIFACTS|COMPASS] [--force-overwrite]
+```
+
+`--force-overwrite` writes `forceOverwrite: true` onto the asset so the platform skips
+backwards-compatibility validation when it processes it. Note the flag lands on the underlying `ir asset`
+invocation, so passing it through a `build:asset` package script differs by package manager:
+
+```bash
+pnpm run build:asset --force-overwrite      # pnpm forwards a literal `--`, so omit it
+npm  run build:asset -- --force-overwrite   # npm requires `--`
+```
+
 ### Examples
 
 #### Generating TypeScript Types from YAML

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

@@ -0,0 +1,237 @@
+/*
+ * 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 { CommanderError } from "commander";
+import { consola } from "consola";
+import { readFileSync } from "fs";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { irDeployHandler } from "../irDeployHandler.js";
+const {
+  osdkCreateMock,
+  createPlatformClientMock
+} = vi.hoisted(() => ({
+  osdkCreateMock: vi.fn(),
+  createPlatformClientMock: vi.fn(() => ({}))
+}));
+vi.mock("@osdk/foundry.pack", () => ({
+  DocumentTypes: {
+    create: osdkCreateMock
+  }
+}));
+vi.mock("@osdk/client", () => ({
+  createPlatformClient: createPlatformClientMock
+}));
+
+// Minimal single-version IR: exercises resolveIrInput + convertIrToWireSchema with no models.
+const MIN_IR = {
+  name: "com.palantir.pack.test.foo",
+  version: 1,
+  primaryModelKeys: [],
+  models: {}
+};
+const WIRE_SCHEMA = {
+  primaryModelKeys: [],
+  models: {}
+};
+vi.mock("fs", async importOriginal => ({
+  ...(await importOriginal()),
+  readFileSync: vi.fn(() => JSON.stringify(MIN_IR))
+}));
+const FIRST_PARTY_OPTIONS = {
+  ir: "ir.json",
+  baseUrl: "https://stack.example.com",
+  auth: "test-token",
+  firstParty: true,
+  firstPartyApiUrl: "https://stack.example.com/first-party/api"
+};
+const PUBLISH_URL = "https://stack.example.com/first-party/api/publish-first-party-document-type";
+const originalFetch = globalThis.fetch;
+let fetchMock;
+function jsonResponse(status, body) {
+  return {
+    ok: status >= 200 && status < 300,
+    status,
+    json: () => Promise.resolve(body)
+  };
+}
+function fetchCall() {
+  const call = fetchMock.mock.calls[0];
+  return {
+    url: call[0],
+    init: call[1]
+  };
+}
+function publishedBody() {
+  return JSON.parse(fetchCall().init.body);
+}
+function silenceConsola() {
+  vi.spyOn(consola, "info").mockImplementation(() => {});
+  vi.spyOn(consola, "success").mockImplementation(() => {});
+  vi.spyOn(consola, "warn").mockImplementation(() => {});
+  vi.spyOn(consola, "error").mockImplementation(() => {});
+}
+describe("irDeployHandler — first-party publish", () => {
+  beforeEach(() => {
+    fetchMock = vi.fn(() => Promise.resolve(jsonResponse(200, {
+      name: MIN_IR.name
+    })));
+    globalThis.fetch = fetchMock;
+    vi.mocked(readFileSync).mockReturnValue(JSON.stringify(MIN_IR));
+    silenceConsola();
+  });
+  afterEach(() => {
+    globalThis.fetch = originalFetch;
+    vi.restoreAllMocks();
+  });
+  it("PUTs to the publish endpoint with bearer auth and the yjs storage shape", async () => {
+    await irDeployHandler({
+      ...FIRST_PARTY_OPTIONS
+    });
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const {
+      url,
+      init
+    } = fetchCall();
+    expect(url).toBe(PUBLISH_URL);
+    expect(init.method).toBe("PUT");
+    expect(init.headers.Authorization).toBe("Bearer test-token");
+    const body = publishedBody();
+    expect(body).toMatchObject({
+      name: MIN_IR.name,
+      storage: {
+        type: "yjs",
+        yjs: {
+          schema: WIRE_SCHEMA
+        }
+      },
+      fileSystemType: "ARTIFACTS"
+    });
+    expect(body).not.toHaveProperty("ontologyRid");
+    expect(body).not.toHaveProperty("version");
+  });
+  it("passes an explicit --file-system-type through", async () => {
+    await irDeployHandler({
+      ...FIRST_PARTY_OPTIONS,
+      fileSystemType: "COMPASS"
+    });
+    expect(publishedBody()).toMatchObject({
+      fileSystemType: "COMPASS"
+    });
+  });
+  it("normalizes a trailing slash on --first-party-api-url", async () => {
+    await irDeployHandler({
+      ...FIRST_PARTY_OPTIONS,
+      firstPartyApiUrl: "https://stack.example.com/first-party/api/"
+    });
+    expect(fetchCall().url).toBe(PUBLISH_URL);
+  });
+  it("fails with a CommanderError when --first-party-api-url is missing", async () => {
+    await expect(irDeployHandler({
+      ir: "ir.json",
+      baseUrl: "https://stack.example.com",
+      auth: "test-token",
+      firstParty: true
+    })).rejects.toBeInstanceOf(CommanderError);
+    expect(fetchMock).not.toHaveBeenCalled();
+  });
+  it("includes owningApplicationId when the IR chain payload provides one", async () => {
+    vi.mocked(readFileSync).mockReturnValue(JSON.stringify({
+      latestVersion: 1,
+      owningApplicationId: "pack-app-123",
+      chain: [{
+        version: 1,
+        ir: MIN_IR
+      }]
+    }));
+    await irDeployHandler({
+      ...FIRST_PARTY_OPTIONS
+    });
+    expect(publishedBody()).toMatchObject({
+      owningApplicationId: "pack-app-123"
+    });
+  });
+  it("omits owningApplicationId when the IR does not provide one", async () => {
+    await irDeployHandler({
+      ...FIRST_PARTY_OPTIONS
+    });
+    expect(publishedBody()).not.toHaveProperty("owningApplicationId");
+  });
+  it("warns about and ignores a deprecated --ontology-rid", async () => {
+    await irDeployHandler({
+      ...FIRST_PARTY_OPTIONS,
+      ontologyRid: "ri.ontology.main.ontology.test"
+    });
+    expect(consola.warn).toHaveBeenCalledWith(expect.stringContaining("--ontology-rid is ignored"));
+    expect(publishedBody()).not.toHaveProperty("ontologyRid");
+  });
+  it("warns about and ignores a deprecated --first-party-prefix (no prefix rewrite applied)", async () => {
+    await irDeployHandler({
+      ...FIRST_PARTY_OPTIONS,
+      firstPartyPrefix: "/some/prefix"
+    });
+    expect(consola.warn).toHaveBeenCalledWith(expect.stringContaining("--first-party-prefix is ignored"));
+    expect(fetchCall().url).toBe(PUBLISH_URL);
+  });
+  it("surfaces the Conjure errorName and fails with a CommanderError on non-2xx", async () => {
+    fetchMock.mockResolvedValue(jsonResponse(400, {
+      errorCode: "INVALID_ARGUMENT",
+      errorName: "BackpackCollaboration:MissingDocumentTypeSchema",
+      errorInstanceId: "err-1"
+    }));
+    await expect(irDeployHandler({
+      ...FIRST_PARTY_OPTIONS
+    })).rejects.toBeInstanceOf(CommanderError);
+    expect(consola.error).toHaveBeenCalledWith(expect.stringContaining("BackpackCollaboration:MissingDocumentTypeSchema"));
+  });
+  it("still fails with a CommanderError when the error body is not JSON", async () => {
+    fetchMock.mockResolvedValue({
+      ok: false,
+      status: 503,
+      json: () => Promise.reject(new Error("not json"))
+    });
+    await expect(irDeployHandler({
+      ...FIRST_PARTY_OPTIONS
+    })).rejects.toBeInstanceOf(CommanderError);
+    expect(consola.error).toHaveBeenCalledWith(expect.stringContaining("HTTP 503"));
+  });
+});
+describe("irDeployHandler — third-party (regression: unaffected by the swap)", () => {
+  beforeEach(() => {
+    fetchMock = vi.fn(() => Promise.resolve(jsonResponse(200, {})));
+    globalThis.fetch = fetchMock;
+    osdkCreateMock.mockReset().mockResolvedValue({
+      rid: "ri.pack.main.type.x"
+    });
+    createPlatformClientMock.mockClear();
+    vi.mocked(readFileSync).mockReturnValue(JSON.stringify(MIN_IR));
+    silenceConsola();
+  });
+  afterEach(() => {
+    globalThis.fetch = originalFetch;
+    vi.restoreAllMocks();
+  });
+  it("still deploys via the OSDK DocumentTypes.create path and never hits the publish endpoint", async () => {
+    await irDeployHandler({
+      ir: "ir.json",
+      baseUrl: "https://stack.example.com",
+      auth: "test-token",
+      parentFolder: "ri.compass.main.folder.abc"
+    });
+    expect(osdkCreateMock).toHaveBeenCalledTimes(1);
+    expect(fetchMock).not.toHaveBeenCalled();
+  });
+});
+//# sourceMappingURL=irDeployFirstParty.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"irDeployFirstParty.test.js","names":["CommanderError","consola","readFileSync","afterEach","beforeEach","describe","expect","it","vi","irDeployHandler","osdkCreateMock","createPlatformClientMock","hoisted","fn","mock","DocumentTypes","create","createPlatformClient","MIN_IR","name","version","primaryModelKeys","models","WIRE_SCHEMA","importOriginal","JSON","stringify","FIRST_PARTY_OPTIONS","ir","baseUrl","auth","firstParty","firstPartyApiUrl","PUBLISH_URL","originalFetch","globalThis","fetch","fetchMock","jsonResponse","status","body","ok","json","Promise","resolve","fetchCall","call","calls","url","init","publishedBody","parse","silenceConsola","spyOn","mockImplementation","mocked","mockReturnValue","restoreAllMocks","toHaveBeenCalledTimes","toBe","method","headers","Authorization","toMatchObject","storage","type","yjs","schema","fileSystemType","not","toHaveProperty","rejects","toBeInstanceOf","toHaveBeenCalled","latestVersion","owningApplicationId","chain","ontologyRid","warn","toHaveBeenCalledWith","stringContaining","firstPartyPrefix","mockResolvedValue","errorCode","errorName","errorInstanceId","error","reject","Error","mockReset","rid","mockClear","parentFolder"],"sources":["irDeployFirstParty.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 { CommanderError } from \"commander\";\nimport { consola } from \"consola\";\nimport type * as FsModule from \"fs\";\nimport { readFileSync } from \"fs\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { irDeployHandler } from \"../irDeployHandler.js\";\n\nconst { osdkCreateMock, createPlatformClientMock } = vi.hoisted(() => ({\n  osdkCreateMock: vi.fn(),\n  createPlatformClientMock: vi.fn(() => ({})),\n}));\n\nvi.mock(\"@osdk/foundry.pack\", () => ({ DocumentTypes: { create: osdkCreateMock } }));\n\nvi.mock(\"@osdk/client\", () => ({ createPlatformClient: createPlatformClientMock }));\n\n// Minimal single-version IR: exercises resolveIrInput + convertIrToWireSchema with no models.\nconst MIN_IR = {\n  name: \"com.palantir.pack.test.foo\",\n  version: 1,\n  primaryModelKeys: [],\n  models: {},\n};\nconst WIRE_SCHEMA = { primaryModelKeys: [], models: {} };\n\nvi.mock(\"fs\", async importOriginal => ({\n  ...(await importOriginal<typeof FsModule>()),\n  readFileSync: vi.fn(() => JSON.stringify(MIN_IR)),\n}));\n\nconst FIRST_PARTY_OPTIONS = {\n  ir: \"ir.json\",\n  baseUrl: \"https://stack.example.com\",\n  auth: \"test-token\",\n  firstParty: true,\n  firstPartyApiUrl: \"https://stack.example.com/first-party/api\",\n} as const;\n\nconst PUBLISH_URL = \"https://stack.example.com/first-party/api/publish-first-party-document-type\";\n\nconst originalFetch = globalThis.fetch;\nlet fetchMock: ReturnType<typeof vi.fn>;\n\nfunction jsonResponse(status: number, body: unknown): Response {\n  return {\n    ok: status >= 200 && status < 300,\n    status,\n    json: () => Promise.resolve(body),\n  } as unknown as Response;\n}\n\nfunction fetchCall(): { url: string; init: RequestInit } {\n  const call = fetchMock.mock.calls[0]! as [string, RequestInit];\n  return { url: call[0], init: call[1] };\n}\n\nfunction publishedBody(): Record<string, unknown> {\n  return JSON.parse(fetchCall().init.body as string) as Record<string, unknown>;\n}\n\nfunction silenceConsola(): void {\n  vi.spyOn(consola, \"info\").mockImplementation(() => {});\n  vi.spyOn(consola, \"success\").mockImplementation(() => {});\n  vi.spyOn(consola, \"warn\").mockImplementation(() => {});\n  vi.spyOn(consola, \"error\").mockImplementation(() => {});\n}\n\ndescribe(\"irDeployHandler — first-party publish\", () => {\n  beforeEach(() => {\n    fetchMock = vi.fn(() => Promise.resolve(jsonResponse(200, { name: MIN_IR.name })));\n    globalThis.fetch = fetchMock as unknown as typeof globalThis.fetch;\n    vi.mocked(readFileSync).mockReturnValue(JSON.stringify(MIN_IR));\n    silenceConsola();\n  });\n\n  afterEach(() => {\n    globalThis.fetch = originalFetch;\n    vi.restoreAllMocks();\n  });\n\n  it(\"PUTs to the publish endpoint with bearer auth and the yjs storage shape\", async () => {\n    await irDeployHandler({ ...FIRST_PARTY_OPTIONS });\n\n    expect(fetchMock).toHaveBeenCalledTimes(1);\n    const { url, init } = fetchCall();\n    expect(url).toBe(PUBLISH_URL);\n    expect(init.method).toBe(\"PUT\");\n    expect((init.headers as Record<string, string>).Authorization).toBe(\"Bearer test-token\");\n\n    const body = publishedBody();\n    expect(body).toMatchObject({\n      name: MIN_IR.name,\n      storage: { type: \"yjs\", yjs: { schema: WIRE_SCHEMA } },\n      fileSystemType: \"ARTIFACTS\",\n    });\n    expect(body).not.toHaveProperty(\"ontologyRid\");\n    expect(body).not.toHaveProperty(\"version\");\n  });\n\n  it(\"passes an explicit --file-system-type through\", async () => {\n    await irDeployHandler({ ...FIRST_PARTY_OPTIONS, fileSystemType: \"COMPASS\" });\n\n    expect(publishedBody()).toMatchObject({ fileSystemType: \"COMPASS\" });\n  });\n\n  it(\"normalizes a trailing slash on --first-party-api-url\", async () => {\n    await irDeployHandler({\n      ...FIRST_PARTY_OPTIONS,\n      firstPartyApiUrl: \"https://stack.example.com/first-party/api/\",\n    });\n\n    expect(fetchCall().url).toBe(PUBLISH_URL);\n  });\n\n  it(\"fails with a CommanderError when --first-party-api-url is missing\", async () => {\n    await expect(\n      irDeployHandler({\n        ir: \"ir.json\",\n        baseUrl: \"https://stack.example.com\",\n        auth: \"test-token\",\n        firstParty: true,\n      }),\n    ).rejects.toBeInstanceOf(CommanderError);\n\n    expect(fetchMock).not.toHaveBeenCalled();\n  });\n\n  it(\"includes owningApplicationId when the IR chain payload provides one\", async () => {\n    vi.mocked(readFileSync).mockReturnValue(\n      JSON.stringify({\n        latestVersion: 1,\n        owningApplicationId: \"pack-app-123\",\n        chain: [{ version: 1, ir: MIN_IR }],\n      }),\n    );\n\n    await irDeployHandler({ ...FIRST_PARTY_OPTIONS });\n\n    expect(publishedBody()).toMatchObject({ owningApplicationId: \"pack-app-123\" });\n  });\n\n  it(\"omits owningApplicationId when the IR does not provide one\", async () => {\n    await irDeployHandler({ ...FIRST_PARTY_OPTIONS });\n\n    expect(publishedBody()).not.toHaveProperty(\"owningApplicationId\");\n  });\n\n  it(\"warns about and ignores a deprecated --ontology-rid\", async () => {\n    await irDeployHandler({\n      ...FIRST_PARTY_OPTIONS,\n      ontologyRid: \"ri.ontology.main.ontology.test\",\n    });\n\n    expect(consola.warn).toHaveBeenCalledWith(expect.stringContaining(\"--ontology-rid is ignored\"));\n    expect(publishedBody()).not.toHaveProperty(\"ontologyRid\");\n  });\n\n  it(\"warns about and ignores a deprecated --first-party-prefix (no prefix rewrite applied)\", async () => {\n    await irDeployHandler({ ...FIRST_PARTY_OPTIONS, firstPartyPrefix: \"/some/prefix\" });\n\n    expect(consola.warn).toHaveBeenCalledWith(\n      expect.stringContaining(\"--first-party-prefix is ignored\"),\n    );\n    expect(fetchCall().url).toBe(PUBLISH_URL);\n  });\n\n  it(\"surfaces the Conjure errorName and fails with a CommanderError on non-2xx\", async () => {\n    fetchMock.mockResolvedValue(\n      jsonResponse(400, {\n        errorCode: \"INVALID_ARGUMENT\",\n        errorName: \"BackpackCollaboration:MissingDocumentTypeSchema\",\n        errorInstanceId: \"err-1\",\n      }),\n    );\n\n    await expect(irDeployHandler({ ...FIRST_PARTY_OPTIONS })).rejects.toBeInstanceOf(\n      CommanderError,\n    );\n    expect(consola.error).toHaveBeenCalledWith(\n      expect.stringContaining(\"BackpackCollaboration:MissingDocumentTypeSchema\"),\n    );\n  });\n\n  it(\"still fails with a CommanderError when the error body is not JSON\", async () => {\n    fetchMock.mockResolvedValue({\n      ok: false,\n      status: 503,\n      json: () => Promise.reject(new Error(\"not json\")),\n    } as unknown as Response);\n\n    await expect(irDeployHandler({ ...FIRST_PARTY_OPTIONS })).rejects.toBeInstanceOf(\n      CommanderError,\n    );\n    expect(consola.error).toHaveBeenCalledWith(expect.stringContaining(\"HTTP 503\"));\n  });\n});\n\ndescribe(\"irDeployHandler — third-party (regression: unaffected by the swap)\", () => {\n  beforeEach(() => {\n    fetchMock = vi.fn(() => Promise.resolve(jsonResponse(200, {})));\n    globalThis.fetch = fetchMock as unknown as typeof globalThis.fetch;\n    osdkCreateMock.mockReset().mockResolvedValue({ rid: \"ri.pack.main.type.x\" });\n    createPlatformClientMock.mockClear();\n    vi.mocked(readFileSync).mockReturnValue(JSON.stringify(MIN_IR));\n    silenceConsola();\n  });\n\n  afterEach(() => {\n    globalThis.fetch = originalFetch;\n    vi.restoreAllMocks();\n  });\n\n  it(\"still deploys via the OSDK DocumentTypes.create path and never hits the publish endpoint\", async () => {\n    await irDeployHandler({\n      ir: \"ir.json\",\n      baseUrl: \"https://stack.example.com\",\n      auth: \"test-token\",\n      parentFolder: \"ri.compass.main.folder.abc\",\n    });\n\n    expect(osdkCreateMock).toHaveBeenCalledTimes(1);\n    expect(fetchMock).not.toHaveBeenCalled();\n  });\n});\n"],"mappings":"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","ignoreList":[]}

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

@@ -14,30 +14,42 @@
  * 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 { convertIrToConjureSchema } from "../../utils/ir/convertIrToConjureSchema.js";
 import { convertIrToWireSchema } from "../../utils/ir/convertIrToWireSchema.js";
-import { buildPrefixRewriteFetch, DEFAULT_API_PREFIX } from "../utils/firstPartyPrefix.js";
 import { resolveIrInput } from "./resolveIrInput.js";
+/**
+ * Handler for `ir deploy`, which creates a document type from a resolved IR.
+ *
+ * - Third-party (default): creates a versioned document type via the public OSDK
+ *   (`DocumentTypes.create`) under `--parent-folder`.
+ * - First-party (`--first-party`): publishes a global, name-keyed type in DEV MODE via the
+ *   first-party document type API. The schema is unversioned (dev sentinel, version -1), no RID is
+ *   minted, and re-running with the same name overwrites the definition so you can iterate freely.
+ *   This path is dev-only — promoting a type to a real, versioned schema is done separately via an
+ *   asset deploy, not this command.
+ *
+ *   When you call create for this new doc-type, a RID is minted in the resolved ontology.
+ */
 export async function irDeployHandler(options) {
   try {
     const irPath = resolve(options.ir);
     consola.info(`Reading schema from: ${irPath}`);
     const {
       ir,
-      latestVersion,
       owningApplicationId
     } = resolveIrInput(JSON.parse(readFileSync(irPath, "utf8")), irPath);
-    const schema = convertIrToWireSchema(ir);
     const fileSystemType = options.fileSystemType ?? "ARTIFACTS";
     if (options.firstParty) {
-      await deployFirstParty(options, ir.name, schema, latestVersion, fileSystemType, owningApplicationId);
+      // The first-party publish endpoint expects the nested-union Conjure shape, not the flat OSDK shape.
+      await deployFirstParty(options, ir.name, convertIrToConjureSchema(ir), fileSystemType, owningApplicationId);
     } else {
-      await deployThirdParty(options, ir.name, schema, fileSystemType);
+      await deployThirdParty(options, ir.name, convertIrToWireSchema(ir), fileSystemType);
     }
   } catch (error) {
     if (error instanceof CommanderError) {
@@ -64,44 +76,72 @@ async function deployThirdParty(options, name, schema, fileSystemType) {
   });
   consola.success("Successfully created document type", result);
 }
-async function deployFirstParty(options, name, schema, version, fileSystemType, owningApplicationId) {
-  if (options.ontologyRid == null) {
-    throw new CommanderError(1, "EINVAL", "--ontology-rid is required when deploying a first-party document type");
+
+/** Subset of the Conjure error body that we surface to the user. */
+
+/**
+ * Publishes a global, name-keyed first-party document type in DEV MODE, via the internal-only
+ * `publishFirstPartyDocumentType` endpoint (a direct authenticated PUT to the first-party Conjure
+ * REST API — this is not part of the public Foundry API / OSDK, and its generated client lives in
+ * an internal registry this public package cannot depend on).
+ *
+ * Dev-mode semantics: the schema is recorded unversioned at the dev sentinel (version -1), no RID
+ * is minted, and the per-ontology instance is created lazily on first document creation. Re-running
+ * with the SAME document type name overwrites the definition, so you can iterate on the schema
+ * freely — there is no version bump or backwards-compatibility check until the type graduates to a
+ * real version via an asset deploy.
+ *
+ * Note: a name that already exists as an old-world RID-keyed (non-dev) type is rejected until the
+ * one-time backfill migrates it into the asset store; brand-new names publish immediately.
+ */
+async function deployFirstParty(options, name, schema, fileSystemType, owningApplicationId) {
+  if (options.firstPartyApiUrl == null || options.firstPartyApiUrl.length === 0) {
+    throw new CommanderError(1, "EINVAL", "--first-party-api-url is required for first-party deploys. Pass your stack's first-party " + "document type REST API base URL.");
   }
-  const fetchFn = options.firstPartyPrefix != null ? buildPrefixRewriteFetch(options.firstPartyPrefix) : undefined;
-  if (fetchFn != null) {
-    consola.info(`Rewriting OSDK '${DEFAULT_API_PREFIX}' -> '${options.firstPartyPrefix}'`);
+  if (options.ontologyRid != null) {
+    consola.warn("--ontology-rid is ignored for first-party deploys: publishFirstPartyDocumentType has no " + "ontology binding (the per-ontology instance is created lazily on first document creation).");
   }
-  const osdkClient = createPlatformClient(options.baseUrl, () => Promise.resolve(options.auth), undefined, fetchFn);
-  const request = {
-    requestBody: {
-      name,
-      ontologyRid: options.ontologyRid,
-      schema,
-      version,
-      fileSystemType,
-      ...(owningApplicationId != null ? {
-        owningApplicationId
-      } : {})
-    }
+  if (options.firstPartyPrefix != null) {
+    consola.warn("--first-party-prefix is ignored: first-party deploys now call the first-party API directly. " + "Pass its base URL via --first-party-api-url instead.");
+  }
+  const url = options.firstPartyApiUrl.replace(/\/+$/, "") + "/publish-first-party-document-type";
+
+  // Conjure wire shape for PublishFirstPartyDocumentTypeRequest; the yjs storage union serializes
+  // as { type: "yjs", yjs: { schema } }.
+  const body = {
+    name,
+    storage: {
+      type: "yjs",
+      yjs: {
+        schema
+      }
+    },
+    fileSystemType,
+    ...(owningApplicationId != null ? {
+      owningApplicationId
+    } : {})
   };
-  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;
+  consola.info("Publishing first-party document type", {
+    name,
+    url
+  });
+  const response = await fetch(url, {
+    method: "PUT",
+    headers: {
+      "Authorization": `Bearer ${options.auth}`,
+      "Content-Type": "application/json",
+      "Accept": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok) {
+    const errorBody = await response.json().catch(() => undefined);
+    const errorName = errorBody?.errorName ?? `HTTP ${response.status}`;
+    const instance = errorBody?.errorInstanceId != null ? ` [${errorBody.errorInstanceId}]` : "";
+    consola.error(`❌ Error during first-party publish: ${errorName}${instance}`);
+    throw new CommanderError(1, "ERRFPPUBLISH", errorName);
   }
+  const result = await response.json();
+  consola.success(`Successfully published first-party document type '${result.name}'`);
 }
 //# sourceMappingURL=irDeployHandler.js.map

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

@@ -1 +1 @@
-{"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","owningApplicationId","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  FileSystemType,\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 { 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, owningApplicationId } = 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(\n        options,\n        ir.name,\n        schema,\n        latestVersion,\n        fileSystemType,\n        owningApplicationId,\n      );\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  owningApplicationId: string | undefined,\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      ...(owningApplicationId != null ? { owningApplicationId } : {}),\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":[]}
+{"version":3,"file":"irDeployHandler.js","names":["createPlatformClient","DocumentTypes","CommanderError","consola","readFileSync","resolve","convertIrToConjureSchema","convertIrToWireSchema","resolveIrInput","irDeployHandler","options","irPath","ir","info","owningApplicationId","JSON","parse","fileSystemType","firstParty","deployFirstParty","name","deployThirdParty","error","schema","parentFolder","osdkClient","baseUrl","Promise","auth","request","parentFolderRid","result","create","preview","success","firstPartyApiUrl","length","ontologyRid","warn","firstPartyPrefix","url","replace","body","storage","type","yjs","response","fetch","method","headers","stringify","ok","errorBody","json","catch","undefined","errorName","status","instance","errorInstanceId"],"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, FileSystemType } 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 { ConjureDocumentTypeSchema } from \"../../utils/ir/convertIrToConjureSchema.js\";\nimport { convertIrToConjureSchema } from \"../../utils/ir/convertIrToConjureSchema.js\";\nimport { convertIrToWireSchema } from \"../../utils/ir/convertIrToWireSchema.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  /** Deprecated/ignored for first-party deploys (publish has no ontology binding); kept so existing invocations don't fail. */\n  readonly ontologyRid?: string;\n  /** Deprecated/ignored; first-party deploys call the first-party API directly (use firstPartyApiUrl). Kept so existing invocations don't fail. */\n  readonly firstPartyPrefix?: string;\n  /**\n   * First-party document type REST API base URL, REQUIRED for first-party deploys. The context path\n   * is installation-dependent, so pass the value for your stack.\n   */\n  readonly firstPartyApiUrl?: string;\n}\n\n/**\n * Handler for `ir deploy`, which creates a document type from a resolved IR.\n *\n * - Third-party (default): creates a versioned document type via the public OSDK\n *   (`DocumentTypes.create`) under `--parent-folder`.\n * - First-party (`--first-party`): publishes a global, name-keyed type in DEV MODE via the\n *   first-party document type API. The schema is unversioned (dev sentinel, version -1), no RID is\n *   minted, and re-running with the same name overwrites the definition so you can iterate freely.\n *   This path is dev-only — promoting a type to a real, versioned schema is done separately via an\n *   asset deploy, not this command.\n *\n *   When you call create for this new doc-type, a RID is minted in the resolved ontology.\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, owningApplicationId } = resolveIrInput(\n      JSON.parse(readFileSync(irPath, \"utf8\")) as unknown,\n      irPath,\n    );\n    const fileSystemType = options.fileSystemType ?? \"ARTIFACTS\";\n\n    if (options.firstParty) {\n      // The first-party publish endpoint expects the nested-union Conjure shape, not the flat OSDK shape.\n      await deployFirstParty(\n        options,\n        ir.name,\n        convertIrToConjureSchema(ir),\n        fileSystemType,\n        owningApplicationId,\n      );\n    } else {\n      await deployThirdParty(options, ir.name, convertIrToWireSchema(ir), 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\n/** Subset of the Conjure error body that we surface to the user. */\ninterface ConjureErrorBody {\n  readonly errorName?: string;\n  readonly errorInstanceId?: string;\n}\n\n/**\n * Publishes a global, name-keyed first-party document type in DEV MODE, via the internal-only\n * `publishFirstPartyDocumentType` endpoint (a direct authenticated PUT to the first-party Conjure\n * REST API — this is not part of the public Foundry API / OSDK, and its generated client lives in\n * an internal registry this public package cannot depend on).\n *\n * Dev-mode semantics: the schema is recorded unversioned at the dev sentinel (version -1), no RID\n * is minted, and the per-ontology instance is created lazily on first document creation. Re-running\n * with the SAME document type name overwrites the definition, so you can iterate on the schema\n * freely — there is no version bump or backwards-compatibility check until the type graduates to a\n * real version via an asset deploy.\n *\n * Note: a name that already exists as an old-world RID-keyed (non-dev) type is rejected until the\n * one-time backfill migrates it into the asset store; brand-new names publish immediately.\n */\nasync function deployFirstParty(\n  options: DeployOptions,\n  name: string,\n  schema: ConjureDocumentTypeSchema,\n  fileSystemType: FileSystemType,\n  owningApplicationId: string | undefined,\n): Promise<void> {\n  if (options.firstPartyApiUrl == null || options.firstPartyApiUrl.length === 0) {\n    throw new CommanderError(\n      1,\n      \"EINVAL\",\n      \"--first-party-api-url is required for first-party deploys. Pass your stack's first-party \"\n        + \"document type REST API base URL.\",\n    );\n  }\n  if (options.ontologyRid != null) {\n    consola.warn(\n      \"--ontology-rid is ignored for first-party deploys: publishFirstPartyDocumentType has no \"\n        + \"ontology binding (the per-ontology instance is created lazily on first document creation).\",\n    );\n  }\n  if (options.firstPartyPrefix != null) {\n    consola.warn(\n      \"--first-party-prefix is ignored: first-party deploys now call the first-party API directly. \"\n        + \"Pass its base URL via --first-party-api-url instead.\",\n    );\n  }\n\n  const url = options.firstPartyApiUrl.replace(/\\/+$/, \"\") + \"/publish-first-party-document-type\";\n\n  // Conjure wire shape for PublishFirstPartyDocumentTypeRequest; the yjs storage union serializes\n  // as { type: \"yjs\", yjs: { schema } }.\n  const body = {\n    name,\n    storage: { type: \"yjs\", yjs: { schema } },\n    fileSystemType,\n    ...(owningApplicationId != null ? { owningApplicationId } : {}),\n  };\n\n  consola.info(\"Publishing first-party document type\", { name, url });\n  const response = await fetch(url, {\n    method: \"PUT\",\n    headers: {\n      \"Authorization\": `Bearer ${options.auth}`,\n      \"Content-Type\": \"application/json\",\n      \"Accept\": \"application/json\",\n    },\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    const errorBody = (await response.json().catch(() => undefined)) as\n      | ConjureErrorBody\n      | undefined;\n    const errorName = errorBody?.errorName ?? `HTTP ${response.status}`;\n    const instance = errorBody?.errorInstanceId != null ? ` [${errorBody.errorInstanceId}]` : \"\";\n    consola.error(`❌ Error during first-party publish: ${errorName}${instance}`);\n    throw new CommanderError(1, \"ERRFPPUBLISH\", errorName);\n  }\n\n  const result = (await response.json()) as { name: string };\n  consola.success(`Successfully published first-party document type '${result.name}'`);\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -44,6 +44,10 @@ function deriveCompatibilityRangePath(assetOutputPath) {
  * register the document type automatically at deploy time. Most users should
  * use `ir deploy` to register document types via the Foundry API instead.
  *
+ * `--force-overwrite` writes `forceOverwrite: true` onto the asset, telling the
+ * platform to skip incremental schema validation when it picks the asset up. It
+ * is a transient processing directive, not persisted with the document type.
+ *
  * If you are unsure whether you need this command, you almost certainly do not.
  */
 export function irGenAssetHandler(options) {
@@ -81,8 +85,14 @@ export function irGenAssetHandler(options) {
       schemaVersion: latestVersion,
       ...(owningApplicationId != null ? {
         owningApplicationId
+      } : {}),
+      ...(options.forceOverwrite ? {
+        forceOverwrite: true
       } : {})
     };
+    if (options.forceOverwrite) {
+      consola.warn("--force-overwrite is set: the platform will skip backwards-compatibility validation when processing this asset.");
+    }
     const outputDir = dirname(outputPath);
     if (!existsSync(outputDir)) {
       mkdirSync(outputDir, {
@@ -115,6 +125,9 @@ export function irGenAssetHandler(options) {
     if (owningApplicationId != null) {
       consola.info(`   Owning application id: ${owningApplicationId}`);
     }
+    if (options.forceOverwrite) {
+      consola.info("   Force overwrite: true");
+    }
   } catch (error) {
     if (error instanceof CommanderError) {
       throw error;

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","resolveIrInput","deriveCompatibilityRangePath","assetOutputPath","stem","irGenAssetHandler","options","irPath","ir","outputPath","output","info","parsed","JSON","parse","resolved","irSchema","latestVersion","minSupportedVersion","owningApplicationId","name","documentTypeName","wireSchema","fileSystemType","asset","comment","documentStorageType","type","schema","schemaVersion","outputDir","recursive","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 type { DocumentTypeAsset, FileSystemType } from \"@osdk/foundry.pack\";\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 { 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, owningApplicationId } = 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      comment: GENERATED_JSON_COMMENT,\n      documentTypeName,\n      documentStorageType: {\n        type: \"yjs\",\n        schema: wireSchema,\n      },\n      fileSystemType,\n      schemaVersion: latestVersion,\n      ...(owningApplicationId != null ? { owningApplicationId } : {}),\n    };\n\n    const outputDir = dirname(outputPath);\n    if (!existsSync(outputDir)) {\n      mkdirSync(outputDir, { recursive: true });\n    }\n    writeFileSync(outputPath, JSON.stringify(asset, 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    if (owningApplicationId != null) {\n      consola.info(`   Owning application id: ${owningApplicationId}`);\n    }\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","owningApplicationId","name","documentTypeName","wireSchema","fileSystemType","asset","comment","documentStorageType","type","schema","schemaVersion","forceOverwrite","warn","outputDir","recursive","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 type { DocumentTypeAsset, FileSystemType } from \"@osdk/foundry.pack\";\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 { resolveIrInput } from \"./resolveIrInput.js\";\n\ninterface IrGenAssetOptions {\n  readonly ir: string;\n  readonly output: string;\n  readonly fileSystemType?: FileSystemType;\n  readonly compatibilityRangeOutput?: string;\n  readonly forceOverwrite?: boolean;\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 * `--force-overwrite` writes `forceOverwrite: true` onto the asset, telling the\n * platform to skip incremental schema validation when it picks the asset up. It\n * is a transient processing directive, not persisted with the document type.\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, owningApplicationId } = 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      comment: GENERATED_JSON_COMMENT,\n      documentTypeName,\n      documentStorageType: {\n        type: \"yjs\",\n        schema: wireSchema,\n      },\n      fileSystemType,\n      schemaVersion: latestVersion,\n      ...(owningApplicationId != null ? { owningApplicationId } : {}),\n      ...(options.forceOverwrite ? { forceOverwrite: true } : {}),\n    };\n\n    if (options.forceOverwrite) {\n      consola.warn(\n        \"--force-overwrite is set: the platform will skip backwards-compatibility validation when processing this asset.\",\n      );\n    }\n\n    const outputDir = dirname(outputPath);\n    if (!existsSync(outputDir)) {\n      mkdirSync(outputDir, { recursive: true });\n    }\n    writeFileSync(outputPath, JSON.stringify(asset, 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    if (owningApplicationId != null) {\n      consola.info(`   Owning application id: ${owningApplicationId}`);\n    }\n    if (options.forceOverwrite) {\n      consola.info(\"   Force overwrite: true\");\n    }\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/ir/registerIrCommands.js

@@ -25,8 +25,8 @@ export function registerIrCommands(program) {
   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. 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("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", "Publish a first-party document type in dev mode: schema is unversioned (version -1) and you " + "can re-run with the same name to iterate on it. Requires --first-party-api-url.", false).option("-o, --ontology-rid <rid>", "[deprecated] Ignored for first-party deploys (publish has no ontology binding)").option("-f, --file-system-type <type>", "File system type for the document type (ARTIFACTS or COMPASS)").option("--first-party-api-url <url>", "First-party document type REST API base URL, required for first-party deploys (installation-dependent)").option("--first-party-prefix <path>", "[deprecated] Ignored; use --first-party-api-url for first-party deploys").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);
+  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)").option("--force-overwrite", "Mark the asset so backwards-compatibility validation is skipped when the platform processes it", false).action(irGenAssetHandler);
 }
 //# sourceMappingURL=registerIrCommands.js.map