@osdk/integration-testing 0.0.0 → 0.1.0

package/build/esm/cli-service/FoundryCliService.js

@@ -0,0 +1,168 @@
+/*
+ * 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 { spawn } from "node:child_process";
+import { once } from "node:events";
+import invariant from "tiny-invariant";
+const MAX_CAPTURED_STDERR_CHUNKS = 32;
+export const DEFAULT_READY_TIMEOUT_MS = 30_000;
+export const DEFAULT_STOP_GRACE_MS = 5_000;
+
+/**
+ * The shared collaborators a service needs to answer questions about itself.
+ * Injected by the launcher via {@link FoundryCliService.attach} so services do
+ * not have to construct — or know how to reach — either one.
+ */
+
+const TERMINAL_STATES = new Set(["FAILED", "STOPPED"]);
+
+/**
+ * One Foundry CLI service subprocess.
+ *
+ * Subclasses supply the `foundry` subcommand to run and, where the default is
+ * wrong, how to tell that the service is up.
+ *
+ * Dependencies are declared but not enforced here: a service names what it needs
+ * and {@link CliServiceLauncher} is what orders and awaits them.
+ */
+export class FoundryCliService {
+  #foundryCliPath;
+  #projectPath;
+  #child;
+  #context;
+  #stderr = [];
+  #exit;
+  constructor(name, config) {
+    this.name = name;
+    this.dependencies = config.dependencies ?? [];
+    this.#foundryCliPath = config.foundryCliPath ?? "foundry";
+    this.#projectPath = config.projectPath;
+  }
+  getProjectPath() {
+    return this.#projectPath;
+  }
+  getCaCertPath() {
+    return this.#context?.discoverer.get(this.name)?.caCertPath ?? undefined;
+  }
+  getUrl() {
+    return this.#context?.discoverer.get(this.name)?.url;
+  }
+  getExitInfo() {
+    if (this.#exit === undefined) {
+      return undefined;
+    }
+    const {
+      code,
+      signal
+    } = this.#exit;
+    return signal ?? `code ${code}`;
+  }
+  getCapturedStderr() {
+    return this.#stderr.join("").trim();
+  }
+  getContext() {
+    const context = this.#context;
+    !(context !== undefined) ? process.env.NODE_ENV !== "production" ? invariant(false, `${this.name} is not registered with a CliServiceLauncher, so it has ` + `no discoverer or status server to consult`) : invariant(false) : void 0;
+    return context;
+  }
+  attach(context) {
+    this.#context = context;
+  }
+  async start() {
+    if (this.#child !== undefined) {
+      return;
+    }
+    await this.getContext().discoverer.refresh();
+    !!(await this.checkHealth()).ready ? process.env.NODE_ENV !== "production" ? invariant(false, `${this.name} is already running; stop it before starting a new one`) : invariant(false) : void 0;
+    await this.#spawn();
+  }
+  async #spawn() {
+    this.#exit = undefined;
+    this.#stderr = [];
+    const child = spawn(this.#foundryCliPath, [...this.getArgs()], {
+      cwd: this.#projectPath
+    });
+    this.#child = child;
+    child.stderr.setEncoding("utf-8");
+    child.stderr.on("data", chunk => {
+      if (this.#stderr.push(chunk) > MAX_CAPTURED_STDERR_CHUNKS) {
+        this.#stderr.shift();
+      }
+    });
+    child.stdout.resume(); // flush, since we don't read from stdout
+    child.on("exit", (code, signal) => {
+      this.#exit = {
+        code,
+        signal
+      };
+    });
+    await new Promise((resolve, reject) => {
+      child.once("spawn", resolve);
+      child.once("error", error => reject(new Error(`Failed to spawn ${this.name} via ${this.#foundryCliPath}`, {
+        cause: error
+      })));
+    });
+  }
+  async checkHealth() {
+    const {
+      discoverer,
+      statusServer
+    } = this.getContext();
+    const discovery = discoverer.get(this.name);
+    if (typeof discovery === "undefined") {
+      return {
+        service: this.name,
+        state: "UNDISCOVERED",
+        ready: false,
+        terminal: false
+      };
+    }
+    const status = await statusServer.getServiceStatus(this.name);
+    const state = status?.status ?? "DISCOVERED";
+    return {
+      service: this.name,
+      state,
+      ready: state === "READY",
+      terminal: TERMINAL_STATES.has(state),
+      url: discovery.url,
+      ...(status?.message != null ? {
+        message: status.message
+      } : {})
+    };
+  }
+
+  /**
+   * Signal the service and wait for the process to actually be gone.
+   */
+  async stop() {
+    const child = this.#child;
+    this.#child = undefined;
+    if (child === undefined || child.exitCode != null || child.signalCode != null) {
+      return;
+    }
+    const exited = once(child, "exit");
+    child.kill("SIGINT");
+    const escalation = setTimeout(() => {
+      child.kill("SIGKILL");
+    }, DEFAULT_STOP_GRACE_MS);
+    try {
+      await exited;
+    } finally {
+      clearTimeout(escalation);
+    }
+  }
+}
+//# sourceMappingURL=FoundryCliService.js.map

package/build/esm/cli-service/FoundryCliService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FoundryCliService.js","names":["spawn","once","invariant","MAX_CAPTURED_STDERR_CHUNKS","DEFAULT_READY_TIMEOUT_MS","DEFAULT_STOP_GRACE_MS","TERMINAL_STATES","Set","FoundryCliService","foundryCliPath","projectPath","child","context","stderr","exit","constructor","name","config","dependencies","getProjectPath","getCaCertPath","discoverer","get","caCertPath","undefined","getUrl","url","getExitInfo","code","signal","getCapturedStderr","join","trim","getContext","process","env","NODE_ENV","attach","start","refresh","checkHealth","ready","#spawn","getArgs","cwd","setEncoding","on","chunk","push","shift","stdout","resume","Promise","resolve","reject","error","Error","cause","statusServer","discovery","service","state","terminal","status","getServiceStatus","has","message","stop","exitCode","signalCode","exited","kill","escalation","setTimeout","clearTimeout"],"sources":["FoundryCliService.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 { spawn, type ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { once } from \"node:events\";\n\nimport invariant from \"tiny-invariant\";\n\nimport type { ServiceLifecycle, ServiceName } from \"../generated/cli/index.js\";\nimport type { ServiceDiscoverer } from \"./ServiceDiscoverer.js\";\nimport type { StatusServer } from \"./StatusServer.js\";\n\nconst MAX_CAPTURED_STDERR_CHUNKS = 32;\n\nexport const DEFAULT_READY_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_STOP_GRACE_MS = 5_000;\n\nexport type ServiceState = ServiceLifecycle | \"UNDISCOVERED\" | \"DISCOVERED\";\n\nexport interface ServiceHealth {\n  service: ServiceName;\n  state: ServiceState;\n  ready: boolean;\n  terminal: boolean; // Whether `state` is terminal, so waiting for readiness is unnecessary.\n  url?: string;\n  message?: string;\n}\n\n/**\n * The shared collaborators a service needs to answer questions about itself.\n * Injected by the launcher via {@link FoundryCliService.attach} so services do\n * not have to construct — or know how to reach — either one.\n */\nexport interface ServiceContext {\n  discoverer: ServiceDiscoverer;\n  statusServer: StatusServer;\n}\n\nexport interface FoundryServiceConfig {\n  /** Path to the `foundry` binary. */\n  foundryCliPath?: string;\n  /** Working directory the CLI runs in; the `.palantir/` dir hangs off it. */\n  projectPath: string;\n  /** Services that must be ready before this one may be started. */\n  dependencies?: readonly FoundryCliService[];\n}\n\nconst TERMINAL_STATES: ReadonlySet<ServiceState> = new Set<ServiceState>([\n  \"FAILED\",\n  \"STOPPED\",\n]);\n\n/**\n * One Foundry CLI service subprocess.\n *\n * Subclasses supply the `foundry` subcommand to run and, where the default is\n * wrong, how to tell that the service is up.\n *\n * Dependencies are declared but not enforced here: a service names what it needs\n * and {@link CliServiceLauncher} is what orders and awaits them.\n */\nexport abstract class FoundryCliService {\n  readonly name: ServiceName;\n  readonly dependencies: readonly FoundryCliService[];\n\n  #foundryCliPath: string;\n  #projectPath: string;\n  #child: ChildProcessWithoutNullStreams | undefined;\n  #context: ServiceContext | undefined;\n  #stderr: string[] = [];\n  #exit: { code: number | null; signal: NodeJS.Signals | null } | undefined;\n\n  protected constructor(name: ServiceName, config: FoundryServiceConfig) {\n    this.name = name;\n    this.dependencies = config.dependencies ?? [];\n    this.#foundryCliPath = config.foundryCliPath ?? \"foundry\";\n    this.#projectPath = config.projectPath;\n  }\n\n  protected abstract getArgs(): readonly string[];\n\n  getProjectPath(): string {\n    return this.#projectPath;\n  }\n\n  getCaCertPath(): string | undefined {\n    return this.#context?.discoverer.get(this.name)?.caCertPath ?? undefined;\n  }\n\n  getUrl(): string | undefined {\n    return this.#context?.discoverer.get(this.name)?.url;\n  }\n\n  getExitInfo(): string | undefined {\n    if (this.#exit === undefined) {\n      return undefined;\n    }\n    const { code, signal } = this.#exit;\n    return signal ?? `code ${code}`;\n  }\n\n  getCapturedStderr(): string {\n    return this.#stderr.join(\"\").trim();\n  }\n\n  protected getContext(): ServiceContext {\n    const context = this.#context;\n    invariant(\n      context !== undefined,\n      `${this.name} is not registered with a CliServiceLauncher, so it has ` +\n        `no discoverer or status server to consult`,\n    );\n    return context;\n  }\n\n  attach(context: ServiceContext): void {\n    this.#context = context;\n  }\n\n  async start(): Promise<void> {\n    if (this.#child !== undefined) {\n      return;\n    }\n    await this.getContext().discoverer.refresh();\n    invariant(\n      !(await this.checkHealth()).ready,\n      `${this.name} is already running; stop it before starting a new one`,\n    );\n    await this.#spawn();\n  }\n\n  async #spawn(): Promise<void> {\n    this.#exit = undefined;\n    this.#stderr = [];\n    const child = spawn(this.#foundryCliPath, [...this.getArgs()], {\n      cwd: this.#projectPath,\n    });\n    this.#child = child;\n    child.stderr.setEncoding(\"utf-8\");\n    child.stderr.on(\"data\", (chunk: string) => {\n      if (this.#stderr.push(chunk) > MAX_CAPTURED_STDERR_CHUNKS) {\n        this.#stderr.shift();\n      }\n    });\n    child.stdout.resume(); // flush, since we don't read from stdout\n    child.on(\"exit\", (code, signal) => {\n      this.#exit = { code, signal };\n    });\n    await new Promise<void>((resolve, reject) => {\n      child.once(\"spawn\", resolve);\n      child.once(\"error\", (error) =>\n        reject(\n          new Error(\n            `Failed to spawn ${this.name} via ${this.#foundryCliPath}`,\n            {\n              cause: error,\n            },\n          ),\n        ),\n      );\n    });\n  }\n\n  async checkHealth(): Promise<ServiceHealth> {\n    const { discoverer, statusServer } = this.getContext();\n    const discovery = discoverer.get(this.name);\n    if (typeof discovery === \"undefined\") {\n      return {\n        service: this.name,\n        state: \"UNDISCOVERED\",\n        ready: false,\n        terminal: false,\n      };\n    }\n    const status = await statusServer.getServiceStatus(this.name);\n    const state: ServiceState = status?.status ?? \"DISCOVERED\";\n    return {\n      service: this.name,\n      state,\n      ready: state === \"READY\",\n      terminal: TERMINAL_STATES.has(state),\n      url: discovery.url,\n      ...(status?.message != null ? { message: status.message } : {}),\n    };\n  }\n\n  /**\n   * Signal the service and wait for the process to actually be gone.\n   */\n  async stop(): Promise<void> {\n    const child = this.#child;\n    this.#child = undefined;\n    if (\n      child === undefined ||\n      child.exitCode != null ||\n      child.signalCode != null\n    ) {\n      return;\n    }\n    const exited = once(child, \"exit\");\n    child.kill(\"SIGINT\");\n    const escalation = setTimeout(() => {\n      child.kill(\"SIGKILL\");\n    }, DEFAULT_STOP_GRACE_MS);\n    try {\n      await exited;\n    } finally {\n      clearTimeout(escalation);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/cli-service/OntologyServer.js

@@ -0,0 +1,32 @@
+/*
+ * 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 path, { isAbsolute, resolve } from "node:path";
+import { FoundryCliService } from "./FoundryCliService.js";
+export class OntologyServer extends FoundryCliService {
+  #metadataPath;
+  constructor(config) {
+    super("ONTOLOGY", config);
+    this.#metadataPath = isAbsolute(config.metadataPath) ? config.metadataPath : resolve(config.projectPath, config.metadataPath);
+  }
+  getMetadataPath() {
+    return this.#metadataPath;
+  }
+  getArgs() {
+    return ["start", "ontology", "--skip-build", "--metadata", this.#metadataPath, "--discovery-path", path.resolve(this.getProjectPath(), ".palantir")];
+  }
+}
+//# sourceMappingURL=OntologyServer.js.map

package/build/esm/cli-service/OntologyServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OntologyServer.js","names":["path","isAbsolute","resolve","FoundryCliService","OntologyServer","metadataPath","constructor","config","projectPath","getMetadataPath","getArgs","getProjectPath"],"sources":["OntologyServer.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 path, { isAbsolute, resolve } from \"node:path\";\n\nimport {\n  FoundryCliService,\n  type FoundryServiceConfig,\n} from \"./FoundryCliService.js\";\n\nexport interface OntologyServerConfig extends FoundryServiceConfig {\n  metadataPath: string;\n}\n\nexport class OntologyServer extends FoundryCliService {\n  #metadataPath: string;\n\n  constructor(config: OntologyServerConfig) {\n    super(\"ONTOLOGY\", config);\n    this.#metadataPath = isAbsolute(config.metadataPath)\n      ? config.metadataPath\n      : resolve(config.projectPath, config.metadataPath);\n  }\n\n  getMetadataPath(): string {\n    return this.#metadataPath;\n  }\n\n  protected override getArgs(): readonly string[] {\n    return [\n      \"start\",\n      \"ontology\",\n      \"--skip-build\",\n      \"--metadata\",\n      this.#metadataPath,\n      \"--discovery-path\",\n      path.resolve(this.getProjectPath(), \".palantir\"),\n    ];\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,IAAI,IAAIC,UAAU,EAAEC,OAAO,QAAQ,WAAW;AAErD,SACEC,iBAAiB,QAEZ,wBAAwB;AAM/B,OAAO,MAAMC,cAAc,SAASD,iBAAiB,CAAC;EACpD,CAACE,YAAY;EAEbC,WAAWA,CAACC,MAA4B,EAAE;IACxC,KAAK,CAAC,UAAU,EAAEA,MAAM,CAAC;IACzB,IAAI,CAAC,CAACF,YAAY,GAAGJ,UAAU,CAACM,MAAM,CAACF,YAAY,CAAC,GAChDE,MAAM,CAACF,YAAY,GACnBH,OAAO,CAACK,MAAM,CAACC,WAAW,EAAED,MAAM,CAACF,YAAY,CAAC;EACtD;EAEAI,eAAeA,CAAA,EAAW;IACxB,OAAO,IAAI,CAAC,CAACJ,YAAY;EAC3B;EAEmBK,OAAOA,CAAA,EAAsB;IAC9C,OAAO,CACL,OAAO,EACP,UAAU,EACV,cAAc,EACd,YAAY,EACZ,IAAI,CAAC,CAACL,YAAY,EAClB,kBAAkB,EAClBL,IAAI,CAACE,OAAO,CAAC,IAAI,CAACS,cAAc,CAAC,CAAC,EAAE,WAAW,CAAC,CACjD;EACH;AACF","ignoreList":[]}

package/build/esm/cli-service/ServiceDiscoverer.js

@@ -0,0 +1,100 @@
+/*
+ * 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 * as fs from "node:fs/promises";
+import { join } from "node:path";
+import invariant from "tiny-invariant";
+import { isProcessAlive } from "../utils/process.js";
+import { serviceNameFromFileName } from "../utils/service.js";
+/**
+ * Reads the discovery files that running Foundry services publish into
+ * `basePath`.
+ */
+export class ServiceDiscoverer {
+  #basePath;
+  #discovered = new Map();
+  constructor(args) {
+    this.#basePath = args.basePath;
+  }
+  get discoveryDir() {
+    return this.#basePath;
+  }
+  async start() {
+    await fs.mkdir(this.#basePath, {
+      recursive: true
+    });
+    await this.refresh();
+  }
+
+  /**
+   * Re-read every discovery file in the directory.
+   */
+  async refresh() {
+    const fileNames = await fs.readdir(this.#basePath);
+    const discoveries = await Promise.all(fileNames.map(fileName => this.#read(fileName)));
+    return discoveries.filter(discovery => discovery !== undefined);
+  }
+  get(name) {
+    const discovery = this.#discovered.get(name);
+    if (typeof discovery === "undefined") {
+      return undefined;
+    }
+    if (!isProcessAlive(discovery.pid)) {
+      this.#discovered.delete(name); // Stale: the publisher died without cleaning up after itself.
+      return undefined;
+    }
+    return discovery;
+  }
+  isDiscovered(name) {
+    return this.get(name) !== undefined;
+  }
+  all() {
+    const live = new Map();
+    for (const name of this.#discovered.keys()) {
+      const discovery = this.get(name);
+      if (discovery !== undefined) {
+        live.set(name, discovery);
+      }
+    }
+    return live;
+  }
+  stop() {
+    this.#discovered.clear();
+  }
+  async #read(fileName) {
+    const serviceName = serviceNameFromFileName(fileName);
+    if (typeof serviceName === "undefined") {
+      return undefined;
+    }
+    let contents;
+    try {
+      contents = await fs.readFile(join(this.#basePath, fileName), "utf-8");
+    } catch {
+      this.#discovered.delete(serviceName);
+      return undefined;
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(contents);
+    } catch {
+      return undefined;
+    }
+    !parsed.url ? process.env.NODE_ENV !== "production" ? invariant(false, `Service URL not found`) : invariant(false) : void 0;
+    this.#discovered.set(serviceName, parsed);
+    return parsed;
+  }
+}
+//# sourceMappingURL=ServiceDiscoverer.js.map

package/build/esm/cli-service/ServiceDiscoverer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceDiscoverer.js","names":["fs","join","invariant","isProcessAlive","serviceNameFromFileName","ServiceDiscoverer","basePath","discovered","Map","constructor","args","discoveryDir","start","mkdir","recursive","refresh","fileNames","readdir","discoveries","Promise","all","map","fileName","read","filter","discovery","undefined","get","name","pid","delete","isDiscovered","live","keys","set","stop","clear","#read","serviceName","contents","readFile","parsed","JSON","parse","url","process","env","NODE_ENV"],"sources":["ServiceDiscoverer.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 * as fs from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nimport invariant from \"tiny-invariant\";\n\nimport type {\n  ComponentDiscovery,\n  ServiceName,\n} from \"../generated/cli/index.js\";\nimport { isProcessAlive } from \"../utils/process.js\";\nimport { serviceNameFromFileName } from \"../utils/service.js\";\n\nexport type ServiceDiscovererConfig = {\n  basePath: string;\n};\n\n/**\n * Reads the discovery files that running Foundry services publish into\n * `basePath`.\n */\nexport class ServiceDiscoverer {\n  #basePath: string;\n  #discovered = new Map<ServiceName, ComponentDiscovery>();\n\n  constructor(args: ServiceDiscovererConfig) {\n    this.#basePath = args.basePath;\n  }\n\n  get discoveryDir(): string {\n    return this.#basePath;\n  }\n\n  async start(): Promise<void> {\n    await fs.mkdir(this.#basePath, { recursive: true });\n    await this.refresh();\n  }\n\n  /**\n   * Re-read every discovery file in the directory.\n   */\n  async refresh(): Promise<ComponentDiscovery[]> {\n    const fileNames = await fs.readdir(this.#basePath);\n    const discoveries = await Promise.all(\n      fileNames.map((fileName) => this.#read(fileName)),\n    );\n    return discoveries.filter(\n      (discovery): discovery is ComponentDiscovery => discovery !== undefined,\n    );\n  }\n\n  get(name: ServiceName): ComponentDiscovery | undefined {\n    const discovery = this.#discovered.get(name);\n    if (typeof discovery === \"undefined\") {\n      return undefined;\n    }\n    if (!isProcessAlive(discovery.pid)) {\n      this.#discovered.delete(name); // Stale: the publisher died without cleaning up after itself.\n      return undefined;\n    }\n    return discovery;\n  }\n\n  isDiscovered(name: ServiceName): boolean {\n    return this.get(name) !== undefined;\n  }\n\n  all(): Map<ServiceName, ComponentDiscovery> {\n    const live = new Map<ServiceName, ComponentDiscovery>();\n    for (const name of this.#discovered.keys()) {\n      const discovery = this.get(name);\n      if (discovery !== undefined) {\n        live.set(name, discovery);\n      }\n    }\n    return live;\n  }\n\n  stop(): void {\n    this.#discovered.clear();\n  }\n\n  async #read(fileName: string): Promise<ComponentDiscovery | undefined> {\n    const serviceName = serviceNameFromFileName(fileName);\n    if (typeof serviceName === \"undefined\") {\n      return undefined;\n    }\n    let contents: string;\n    try {\n      contents = await fs.readFile(join(this.#basePath, fileName), \"utf-8\");\n    } catch {\n      this.#discovered.delete(serviceName);\n      return undefined;\n    }\n    let parsed: ComponentDiscovery;\n    try {\n      parsed = JSON.parse(contents) as ComponentDiscovery;\n    } catch {\n      return undefined;\n    }\n    invariant(parsed.url, `Service URL not found`);\n    this.#discovered.set(serviceName, parsed);\n    return parsed;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/cli-service/StatusServer.js

@@ -0,0 +1,91 @@
+/*
+ * 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 path from "node:path";
+import invariant from "tiny-invariant";
+import { StatusService } from "../generated/cli/index.js";
+import { FoundryCliService } from "./FoundryCliService.js";
+const HEALTH_REQUEST_TIMEOUT_MS = 2_000;
+/**
+ * The local status server, and the health authority for every other service.
+ */
+export class StatusServer extends FoundryCliService {
+  /** Shared by callers that ask while a fetch is already outstanding. */
+  #inFlight;
+  constructor(config) {
+    super("STATUS_SERVER", config);
+  }
+  getArgs() {
+    // force project path to cwd
+    return ["start", "status-server", "--discovery-path", path.resolve(this.getProjectPath(), ".palantir")];
+  }
+  async checkHealth() {
+    const discovery = this.getContext().discoverer.get("STATUS_SERVER");
+    if (discovery === undefined) {
+      return {
+        service: "STATUS_SERVER",
+        state: "UNDISCOVERED",
+        ready: false,
+        terminal: false
+      };
+    }
+    const healthy = await this.#isHealthy(discovery.url);
+    return {
+      service: "STATUS_SERVER",
+      state: healthy ? "READY" : "DISCOVERED",
+      ready: healthy,
+      terminal: false,
+      url: discovery.url
+    };
+  }
+  async #isHealthy(baseUrl) {
+    try {
+      const response = await fetch(new URL("/api/health", baseUrl), {
+        signal: AbortSignal.timeout(HEALTH_REQUEST_TIMEOUT_MS)
+      });
+      if (!response.ok) {
+        return false;
+      }
+      const body = await response.json();
+      return body.status === "healthy";
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * The lifecycle snapshot for every service.
+   */
+  async getServiceStatuses() {
+    const baseUrl = this.getContext().discoverer.get("STATUS_SERVER")?.url;
+    !baseUrl ? process.env.NODE_ENV !== "production" ? invariant(false, "Cannot get service status because the status server is not discovered yet") : invariant(false) : void 0;
+    this.#inFlight ??= StatusService.getStatus({
+      baseUrl,
+      servicePath: ""
+    }).catch(() => undefined).finally(() => {
+      this.#inFlight = undefined;
+    });
+    const result = await this.#inFlight;
+    return result ?? [];
+  }
+  async getServiceStatus(name) {
+    const statuses = await this.getServiceStatuses();
+    return statuses.find(({
+      service
+    }) => service === name);
+  }
+}
+//# sourceMappingURL=StatusServer.js.map

package/build/esm/cli-service/StatusServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusServer.js","names":["path","invariant","StatusService","FoundryCliService","HEALTH_REQUEST_TIMEOUT_MS","StatusServer","inFlight","constructor","config","getArgs","resolve","getProjectPath","checkHealth","discovery","getContext","discoverer","get","undefined","service","state","ready","terminal","healthy","isHealthy","url","#isHealthy","baseUrl","response","fetch","URL","signal","AbortSignal","timeout","ok","body","json","status","getServiceStatuses","process","env","NODE_ENV","getStatus","servicePath","catch","finally","result","getServiceStatus","name","statuses","find"],"sources":["StatusServer.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 path from \"node:path\";\n\nimport invariant from \"tiny-invariant\";\n\nimport {\n  type ServiceName,\n  type ServiceStatus,\n  StatusService,\n} from \"../generated/cli/index.js\";\nimport {\n  FoundryCliService,\n  type FoundryServiceConfig,\n  type ServiceHealth,\n} from \"./FoundryCliService.js\";\n\nconst HEALTH_REQUEST_TIMEOUT_MS = 2_000;\n\nexport type StatusServerConfig = FoundryServiceConfig;\n\n/**\n * The local status server, and the health authority for every other service.\n */\nexport class StatusServer extends FoundryCliService {\n  /** Shared by callers that ask while a fetch is already outstanding. */\n  #inFlight: Promise<ServiceStatus[] | undefined> | undefined;\n\n  constructor(config: StatusServerConfig) {\n    super(\"STATUS_SERVER\", config);\n  }\n\n  protected override getArgs(): readonly string[] {\n    // force project path to cwd\n    return [\n      \"start\",\n      \"status-server\",\n      \"--discovery-path\",\n      path.resolve(this.getProjectPath(), \".palantir\"),\n    ];\n  }\n\n  override async checkHealth(): Promise<ServiceHealth> {\n    const discovery = this.getContext().discoverer.get(\"STATUS_SERVER\");\n    if (discovery === undefined) {\n      return {\n        service: \"STATUS_SERVER\",\n        state: \"UNDISCOVERED\",\n        ready: false,\n        terminal: false,\n      };\n    }\n    const healthy = await this.#isHealthy(discovery.url);\n    return {\n      service: \"STATUS_SERVER\",\n      state: healthy ? \"READY\" : \"DISCOVERED\",\n      ready: healthy,\n      terminal: false,\n      url: discovery.url,\n    };\n  }\n\n  async #isHealthy(baseUrl: string): Promise<boolean> {\n    try {\n      const response = await fetch(new URL(\"/api/health\", baseUrl), {\n        signal: AbortSignal.timeout(HEALTH_REQUEST_TIMEOUT_MS),\n      });\n      if (!response.ok) {\n        return false;\n      }\n      const body: { status?: unknown } = await response.json();\n      return body.status === \"healthy\";\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * The lifecycle snapshot for every service.\n   */\n  async getServiceStatuses(): Promise<ServiceStatus[]> {\n    const baseUrl = this.getContext().discoverer.get(\"STATUS_SERVER\")?.url;\n    invariant(\n      baseUrl,\n      \"Cannot get service status because the status server is not discovered yet\",\n    );\n    this.#inFlight ??= StatusService.getStatus({ baseUrl, servicePath: \"\" })\n      .catch(() => undefined)\n      .finally(() => {\n        this.#inFlight = undefined;\n      });\n    const result = await this.#inFlight;\n    return result ?? [];\n  }\n\n  async getServiceStatus(\n    name: ServiceName,\n  ): Promise<ServiceStatus | undefined> {\n    const statuses = await this.getServiceStatuses();\n    return statuses.find(({ service }) => service === name);\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/createIntegrationClient.js

@@ -0,0 +1,67 @@
+/*
+ * 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 fs from "node:fs/promises";
+import { createClient } from "@osdk/client";
+import { createMockClient } from "@osdk/unit-testing";
+import { fetch as undiciFetch, Agent } from "undici";
+
+/** The definition kinds accepted by {@link Client}'s call signatures. */
+
+export async function createIntegrationClient(config) {
+  const {
+    baseUrl,
+    metadata,
+    caCertPath
+  } = config;
+  const agent = new Agent({
+    connect: caCertPath ? {
+      ca: await fs.readFile(caCertPath)
+    } : {
+      rejectUnauthorized: false
+    }
+  });
+  const realClient = createClient(baseUrl, metadata.ontology.rid, () => Promise.resolve("integration-client-token"), {}, (input, init) => undiciFetch(input, {
+    ...init,
+    dispatcher: agent
+  }));
+  const mockClient = createMockClient();
+  const client = Object.defineProperties(def => {
+    switch (def.type) {
+      case "query":
+        return mockClient(def);
+      case "action":
+        return realClient(def);
+      case "interface":
+        return realClient(def);
+      case "object":
+        return realClient(def);
+      case "experiment":
+      default:
+        return realClient(def);
+    }
+  }, {
+    ...Object.getOwnPropertyDescriptors(realClient),
+    whenQuery: {
+      value: mockClient.whenQuery.bind(undefined)
+    },
+    clearStubs: {
+      value: mockClient.clearStubs.bind(undefined)
+    }
+  });
+  return client;
+}
+//# sourceMappingURL=createIntegrationClient.js.map

package/build/esm/createIntegrationClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIntegrationClient.js","names":["fs","createClient","createMockClient","fetch","undiciFetch","Agent","createIntegrationClient","config","baseUrl","metadata","caCertPath","agent","connect","ca","readFile","rejectUnauthorized","realClient","ontology","rid","Promise","resolve","input","init","dispatcher","mockClient","client","Object","defineProperties","def","type","getOwnPropertyDescriptors","whenQuery","value","bind","undefined","clearStubs"],"sources":["createIntegrationClient.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 fs from \"node:fs/promises\";\n\nimport type {\n  ActionDefinition,\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  QueryDefinition,\n} from \"@osdk/api\";\nimport type { Experiment } from \"@osdk/api/unstable\";\nimport { createClient, type Client } from \"@osdk/client\";\nimport { createMockClient } from \"@osdk/unit-testing\";\nimport { fetch as undiciFetch, Agent } from \"undici\";\n\nimport type { IntegrationClient, IntegrationClientConfig } from \"./types.js\";\n\n/** The definition kinds accepted by {@link Client}'s call signatures. */\ntype ClientArg =\n  | ObjectTypeDefinition\n  | InterfaceDefinition\n  | ActionDefinition\n  | QueryDefinition\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  | Experiment<any>;\n\nexport async function createIntegrationClient(\n  config: IntegrationClientConfig,\n): Promise<IntegrationClient> {\n  const { baseUrl, metadata, caCertPath } = config;\n  const agent = new Agent({\n    connect: caCertPath\n      ? {\n          ca: await fs.readFile(caCertPath),\n        }\n      : {\n          rejectUnauthorized: false,\n        },\n  });\n  const fetchWithCert = ((input, init) =>\n    undiciFetch(input, {\n      ...init,\n      dispatcher: agent,\n    })) satisfies typeof undiciFetch as unknown as typeof fetch;\n  const realClient = createClient(\n    baseUrl,\n    metadata.ontology.rid,\n    () => Promise.resolve(\"integration-client-token\"),\n    {},\n    fetchWithCert,\n  );\n  const mockClient = createMockClient();\n  const clientInternal = ((def: ClientArg) => {\n    switch (def.type) {\n      case \"query\":\n        return mockClient(def);\n      case \"action\":\n        return realClient(def);\n      case \"interface\":\n        return realClient(def);\n      case \"object\":\n        return realClient(def);\n      case \"experiment\":\n      default:\n        return realClient(def);\n    }\n  }) as Client;\n  const client = Object.defineProperties<IntegrationClient>(\n    clientInternal as IntegrationClient,\n    {\n      ...Object.getOwnPropertyDescriptors(realClient),\n      whenQuery: {\n        value: mockClient.whenQuery.bind(undefined),\n      },\n      clearStubs: {\n        value: mockClient.clearStubs.bind(undefined),\n      },\n    },\n  );\n  return client;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,EAAE,MAAM,kBAAkB;AASjC,SAASC,YAAY,QAAqB,cAAc;AACxD,SAASC,gBAAgB,QAAQ,oBAAoB;AACrD,SAASC,KAAK,IAAIC,WAAW,EAAEC,KAAK,QAAQ,QAAQ;;AAIpD;;AASA,OAAO,eAAeC,uBAAuBA,CAC3CC,MAA+B,EACH;EAC5B,MAAM;IAAEC,OAAO;IAAEC,QAAQ;IAAEC;EAAW,CAAC,GAAGH,MAAM;EAChD,MAAMI,KAAK,GAAG,IAAIN,KAAK,CAAC;IACtBO,OAAO,EAAEF,UAAU,GACf;MACEG,EAAE,EAAE,MAAMb,EAAE,CAACc,QAAQ,CAACJ,UAAU;IAClC,CAAC,GACD;MACEK,kBAAkB,EAAE;IACtB;EACN,CAAC,CAAC;EAMF,MAAMC,UAAU,GAAGf,YAAY,CAC7BO,OAAO,EACPC,QAAQ,CAACQ,QAAQ,CAACC,GAAG,EACrB,MAAMC,OAAO,CAACC,OAAO,CAAC,0BAA0B,CAAC,EACjD,CAAC,CAAC,EATmB,CAACC,KAAK,EAAEC,IAAI,KACjClB,WAAW,CAACiB,KAAK,EAAE;IACjB,GAAGC,IAAI;IACPC,UAAU,EAAEZ;EACd,CAAC,CAOH,CAAC;EACD,MAAMa,UAAU,GAAGtB,gBAAgB,CAAC,CAAC;EAgBrC,MAAMuB,MAAM,GAAGC,MAAM,CAACC,gBAAgB,CAfbC,GAAc,IAAK;IAC1C,QAAQA,GAAG,CAACC,IAAI;MACd,KAAK,OAAO;QACV,OAAOL,UAAU,CAACI,GAAG,CAAC;MACxB,KAAK,QAAQ;QACX,OAAOZ,UAAU,CAACY,GAAG,CAAC;MACxB,KAAK,WAAW;QACd,OAAOZ,UAAU,CAACY,GAAG,CAAC;MACxB,KAAK,QAAQ;QACX,OAAOZ,UAAU,CAACY,GAAG,CAAC;MACxB,KAAK,YAAY;MACjB;QACE,OAAOZ,UAAU,CAACY,GAAG,CAAC;IAC1B;EACF,CAAC,EAGC;IACE,GAAGF,MAAM,CAACI,yBAAyB,CAACd,UAAU,CAAC;IAC/Ce,SAAS,EAAE;MACTC,KAAK,EAAER,UAAU,CAACO,SAAS,CAACE,IAAI,CAACC,SAAS;IAC5C,CAAC;IACDC,UAAU,EAAE;MACVH,KAAK,EAAER,UAAU,CAACW,UAAU,CAACF,IAAI,CAACC,SAAS;IAC7C;EACF,CACF,CAAC;EACD,OAAOT,MAAM;AACf","ignoreList":[]}

package/build/esm/createIntegrationServer.js

@@ -0,0 +1,115 @@
+/*
+ * 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 fs from "node:fs/promises";
+import path from "node:path";
+import { PreviewOntologyIrConverter } from "@osdk/generator-converters.preview";
+import invariant from "tiny-invariant";
+import { Agent, fetch as undiciFetch } from "undici";
+import { CliServiceLauncher } from "./cli-service/CliServiceLauncher.js";
+import { OntologyServer } from "./cli-service/OntologyServer.js";
+import { createIntegrationClient } from "./createIntegrationClient.js";
+import { createSeedClient } from "./createSeedClient.js";
+import { EMPTY_ONTOLOGY_BLOCK_DATA } from "./utils/empty-ontology-block.js";
+const transformMetadata = metadata => {
+  const transformed = PreviewOntologyIrConverter.getPreviewFullMetadataFromBlockData(EMPTY_ONTOLOGY_BLOCK_DATA, metadata);
+  return {
+    ...transformed,
+    ontology: metadata.ontology
+  };
+};
+const writeMetadata = async args => {
+  const {
+    metadataPath,
+    previewMetadata
+  } = args;
+  const stringified = JSON.stringify(previewMetadata);
+  await fs.writeFile(metadataPath, stringified);
+};
+export async function createIntegrationServer(config) {
+  const {
+    metadata,
+    projectPath = process.cwd(),
+    foundryCliPath
+  } = config;
+  const testPath = await fs.mkdtemp(path.join(projectPath, ".test-run-"));
+  const metadataPath = path.resolve(testPath, "ontology-metadata.json");
+  const previewMetadata = transformMetadata(metadata);
+  const serviceLauncher = new CliServiceLauncher({
+    projectDir: testPath,
+    foundryCliPath
+  });
+  // write metadata to metadataPath for foundry cli to read from
+  await writeMetadata({
+    previewMetadata,
+    metadataPath
+  });
+  const ontology = serviceLauncher.register(new OntologyServer({
+    projectPath: testPath,
+    metadataPath,
+    foundryCliPath
+  }));
+
+  // stateful cache of client and seed client
+  let client;
+  let seedClient;
+  return {
+    getOntologyUrl: () => ontology.getUrl(),
+    start: async () => {
+      await serviceLauncher.start();
+    },
+    stop: async () => {
+      await serviceLauncher.stop();
+      await fs.rm(testPath, {
+        recursive: true,
+        force: true
+      });
+    },
+    getSeedClient: async () => {
+      if (seedClient !== undefined) return seedClient;
+      const baseUrl = ontology.getUrl();
+      !baseUrl ? process.env.NODE_ENV !== "production" ? invariant(false, "Ontology server is not ready") : invariant(false) : void 0;
+      const caCertPath = ontology.getCaCertPath();
+      !caCertPath ? process.env.NODE_ENV !== "production" ? invariant(false, "Ontology server is not ready") : invariant(false) : void 0;
+      const agent = new Agent({
+        connect: caCertPath ? {
+          ca: await fs.readFile(caCertPath)
+        } : {
+          rejectUnauthorized: false
+        }
+      });
+      return seedClient = createSeedClient({
+        baseUrl,
+        metadata,
+        fetchFn: (input, init) => undiciFetch(input, {
+          ...init,
+          dispatcher: agent
+        })
+      });
+    },
+    getClient: async () => {
+      if (client !== undefined) return client;
+      const baseUrl = ontology.getUrl();
+      !baseUrl ? process.env.NODE_ENV !== "production" ? invariant(false, "Ontology server is not ready") : invariant(false) : void 0;
+      return client = await createIntegrationClient({
+        baseUrl,
+        metadata,
+        caCertPath: ontology.getCaCertPath()
+      });
+    }
+  };
+}
+//# sourceMappingURL=createIntegrationServer.js.map