@keystrokehq/hosting 0.1.14 → 0.1.16

package/dist/org-artifacts.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./runtime-CV7pSfMl.cjs");
+exports.encodeOrgArtifacts = require_runtime.encodeOrgArtifacts;
+exports.parseOrgArtifactsFromEnv = require_runtime.parseOrgArtifactsFromEnv;

package/dist/org-artifacts.d.cts

@@ -0,0 +1,2 @@
+import { a as ProjectRuntimeDatabase, c as ProjectRuntimeInput, d as encodeOrgArtifacts, f as parseOrgArtifactsFromEnv, i as ProjectRuntime, l as ProjectRuntimeReconcileInput, n as OrgProjectDeploy, o as ProjectRuntimeDestroyInput, r as ProjectPingTarget, s as ProjectRuntimeHosting, t as OrgArtifactSpec, u as ProjectRuntimeResult } from "./runtime-B0jF0oMv.cjs";
+export { type OrgArtifactSpec, type OrgProjectDeploy, type ProjectPingTarget, type ProjectRuntime, type ProjectRuntimeDatabase, type ProjectRuntimeDestroyInput, type ProjectRuntimeHosting, type ProjectRuntimeInput, type ProjectRuntimeReconcileInput, type ProjectRuntimeResult, encodeOrgArtifacts, parseOrgArtifactsFromEnv };

package/dist/org-artifacts.d.mts

@@ -0,0 +1,2 @@
+import { a as ProjectRuntimeDatabase, c as ProjectRuntimeInput, d as encodeOrgArtifacts, f as parseOrgArtifactsFromEnv, i as ProjectRuntime, l as ProjectRuntimeReconcileInput, n as OrgProjectDeploy, o as ProjectRuntimeDestroyInput, r as ProjectPingTarget, s as ProjectRuntimeHosting, t as OrgArtifactSpec, u as ProjectRuntimeResult } from "./runtime-B0jF0oMv.mjs";
+export { type OrgArtifactSpec, type OrgProjectDeploy, type ProjectPingTarget, type ProjectRuntime, type ProjectRuntimeDatabase, type ProjectRuntimeDestroyInput, type ProjectRuntimeHosting, type ProjectRuntimeInput, type ProjectRuntimeReconcileInput, type ProjectRuntimeResult, encodeOrgArtifacts, parseOrgArtifactsFromEnv };

package/dist/org-artifacts.mjs

@@ -0,0 +1,2 @@
+import { n as parseOrgArtifactsFromEnv, t as encodeOrgArtifacts } from "./runtime-BmfsHLrk.mjs";
+export { encodeOrgArtifacts, parseOrgArtifactsFromEnv };

package/dist/plugin-is5oPt6x.d.cts

@@ -0,0 +1,44 @@
+import { i as ProjectRuntime, r as ProjectPingTarget } from "./runtime-B0jF0oMv.cjs";
+
+//#region src/worker-runtime-config.d.ts
+/** Resolved platform ↔ project-server worker auth contract. */
+type WorkerRuntimeConfig = {
+  /** Platform API base URL reachable from the project-server runtime. */platformUrl: string; /** Bearer token for platform `/internal` routes. */
+  workerToken: string;
+};
+declare class WorkerRuntimeConfigError extends Error {
+  readonly missing: readonly string[];
+  constructor(missing: string[]);
+}
+/** Fail fast when the platform cannot start worker-mode project servers. */
+declare function resolveWorkerRuntimeConfig(source?: NodeJS.ProcessEnv): WorkerRuntimeConfig;
+//#endregion
+//#region src/plugin.d.ts
+type HostingOptions = {
+  image?: string;
+  env?: NodeJS.ProcessEnv;
+  fetchImpl?: typeof fetch;
+  healthTimeoutMs?: number;
+};
+type OrganizationHostingInput = {
+  organizationId: string;
+  name: string;
+};
+type OrganizationHostingResult = {
+  appName: string;
+};
+type HostingPlugin = {
+  name: string; /** Validated at plugin creation — shared by platform internal routes and project-server containers. */
+  workerRuntime: WorkerRuntimeConfig;
+  createRuntime(): ProjectRuntime;
+  provisionOrganization?(input: OrganizationHostingInput): Promise<OrganizationHostingResult>;
+  deprovisionOrganization?(result: OrganizationHostingResult): Promise<void>;
+  canPingTarget?(target: ProjectPingTarget): target is {
+    baseUrl: string;
+    runtimeId: string | null;
+  };
+  pingRequestHeaders?(runtimeId: string | null): Record<string, string>;
+};
+//#endregion
+export { WorkerRuntimeConfig as a, OrganizationHostingResult as i, HostingPlugin as n, WorkerRuntimeConfigError as o, OrganizationHostingInput as r, resolveWorkerRuntimeConfig as s, HostingOptions as t };
+//# sourceMappingURL=plugin-is5oPt6x.d.cts.map

package/dist/plugin-is5oPt6x.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-is5oPt6x.d.cts","names":[],"sources":["../src/worker-runtime-config.ts","../src/plugin.ts"],"mappings":";;;;KAGY,mBAAA;yEAEV,WAAA,UAF6B;EAI7B,WAAW;AAAA;AAAA,cAGA,wBAAA,SAAiC,KAAK;EAAA,SACxC,OAAA;cAEG,OAAA;AAAA;;iBAWE,0BAAA,CACd,MAAA,GAAQ,MAAA,CAAO,UAAA,GACd,mBAAmB;;;KCvBV,cAAA;EACV,KAAA;EACA,GAAA,GAAM,MAAA,CAAO,UAAA;EACb,SAAA,UAAmB,KAAK;EACxB,eAAA;AAAA;AAAA,KAGU,wBAAA;EACV,cAAA;EACA,IAAI;AAAA;AAAA,KAGM,yBAAA;EACV,OAAO;AAAA;AAAA,KAGG,aAAA;EACV,IAAA,UDP6B;ECS7B,aAAA,EAAe,mBAAA;EACf,aAAA,IAAiB,cAAA;EACjB,qBAAA,EAAuB,KAAA,EAAO,wBAAA,GAA2B,OAAA,CAAQ,yBAAA;EACjE,uBAAA,EAAyB,MAAA,EAAQ,yBAAA,GAA4B,OAAA;EAC7D,aAAA,EACE,MAAA,EAAQ,iBAAA,GACP,MAAA;IAAY,OAAA;IAAiB,SAAA;EAAA;EAChC,kBAAA,EAAoB,SAAA,kBAA2B,MAAA;AAAA"}

package/dist/plugin-qEl5Sx4m.d.mts

@@ -0,0 +1,44 @@
+import { i as ProjectRuntime, r as ProjectPingTarget } from "./runtime-B0jF0oMv.mjs";
+
+//#region src/worker-runtime-config.d.ts
+/** Resolved platform ↔ project-server worker auth contract. */
+type WorkerRuntimeConfig = {
+  /** Platform API base URL reachable from the project-server runtime. */platformUrl: string; /** Bearer token for platform `/internal` routes. */
+  workerToken: string;
+};
+declare class WorkerRuntimeConfigError extends Error {
+  readonly missing: readonly string[];
+  constructor(missing: string[]);
+}
+/** Fail fast when the platform cannot start worker-mode project servers. */
+declare function resolveWorkerRuntimeConfig(source?: NodeJS.ProcessEnv): WorkerRuntimeConfig;
+//#endregion
+//#region src/plugin.d.ts
+type HostingOptions = {
+  image?: string;
+  env?: NodeJS.ProcessEnv;
+  fetchImpl?: typeof fetch;
+  healthTimeoutMs?: number;
+};
+type OrganizationHostingInput = {
+  organizationId: string;
+  name: string;
+};
+type OrganizationHostingResult = {
+  appName: string;
+};
+type HostingPlugin = {
+  name: string; /** Validated at plugin creation — shared by platform internal routes and project-server containers. */
+  workerRuntime: WorkerRuntimeConfig;
+  createRuntime(): ProjectRuntime;
+  provisionOrganization?(input: OrganizationHostingInput): Promise<OrganizationHostingResult>;
+  deprovisionOrganization?(result: OrganizationHostingResult): Promise<void>;
+  canPingTarget?(target: ProjectPingTarget): target is {
+    baseUrl: string;
+    runtimeId: string | null;
+  };
+  pingRequestHeaders?(runtimeId: string | null): Record<string, string>;
+};
+//#endregion
+export { WorkerRuntimeConfig as a, OrganizationHostingResult as i, HostingPlugin as n, WorkerRuntimeConfigError as o, OrganizationHostingInput as r, resolveWorkerRuntimeConfig as s, HostingOptions as t };
+//# sourceMappingURL=plugin-qEl5Sx4m.d.mts.map

package/dist/plugin-qEl5Sx4m.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-qEl5Sx4m.d.mts","names":[],"sources":["../src/worker-runtime-config.ts","../src/plugin.ts"],"mappings":";;;;KAGY,mBAAA;yEAEV,WAAA,UAF6B;EAI7B,WAAW;AAAA;AAAA,cAGA,wBAAA,SAAiC,KAAK;EAAA,SACxC,OAAA;cAEG,OAAA;AAAA;;iBAWE,0BAAA,CACd,MAAA,GAAQ,MAAA,CAAO,UAAA,GACd,mBAAmB;;;KCvBV,cAAA;EACV,KAAA;EACA,GAAA,GAAM,MAAA,CAAO,UAAA;EACb,SAAA,UAAmB,KAAK;EACxB,eAAA;AAAA;AAAA,KAGU,wBAAA;EACV,cAAA;EACA,IAAI;AAAA;AAAA,KAGM,yBAAA;EACV,OAAO;AAAA;AAAA,KAGG,aAAA;EACV,IAAA,UDP6B;ECS7B,aAAA,EAAe,mBAAA;EACf,aAAA,IAAiB,cAAA;EACjB,qBAAA,EAAuB,KAAA,EAAO,wBAAA,GAA2B,OAAA,CAAQ,yBAAA;EACjE,uBAAA,EAAyB,MAAA,EAAQ,yBAAA,GAA4B,OAAA;EAC7D,aAAA,EACE,MAAA,EAAQ,iBAAA,GACP,MAAA;IAAY,OAAA;IAAiB,SAAA;EAAA;EAChC,kBAAA,EAAoB,SAAA,kBAA2B,MAAA;AAAA"}

package/dist/runtime-B0jF0oMv.d.cts

@@ -0,0 +1,69 @@
+//#region src/runtime.d.ts
+type ProjectRuntimeDatabase = {
+  host: string;
+  port: number;
+  database: string;
+  user: string;
+  password: string;
+  searchPath: string;
+  organizationId: string; /** @deprecated Per-project workers only — org workers omit this. */
+  projectId?: string;
+};
+type OrgProjectDeploy = {
+  projectId: string;
+  name: string;
+  artifactId: string;
+  artifactStorageKey: string;
+  artifactVersion: number;
+};
+type OrgArtifactSpec = {
+  projectId: string;
+  artifactStorageKey: string;
+  artifactId: string; /** Monotonic per-project artifact version from the platform database. */
+  artifactVersion: number;
+};
+type ProjectRuntimeHosting = {
+  appName: string;
+};
+type ProjectRuntimeInput = {
+  organizationId: string;
+  projects: OrgProjectDeploy[];
+  database: ProjectRuntimeDatabase;
+  hosting?: ProjectRuntimeHosting; /** Extra env merged into the project server launch spec (e.g. from an llmProxy plugin). */
+  env?: Record<string, string>; /** Previous runtime to retire after a successful cutover. */
+  previousRuntimeId?: string | null;
+};
+/** Builds base64 `KEYSTROKE_ORG_ARTIFACTS` payload for org worker containers. */
+declare function encodeOrgArtifacts(artifacts: OrgArtifactSpec[]): string;
+declare function parseOrgArtifactsFromEnv(env?: NodeJS.ProcessEnv): OrgArtifactSpec[] | undefined;
+type ProjectRuntimeDestroyInput = {
+  runtimeId: string;
+  hosting?: ProjectRuntimeHosting;
+};
+type ProjectRuntimeReconcileInput = {
+  organizationId: string; /** The runtime to keep — every other runtime belonging to this org should be destroyed. */
+  keepRuntimeId: string;
+  hosting?: ProjectRuntimeHosting;
+};
+type ProjectRuntimeResult = {
+  runtimeId: string;
+  baseUrl: string;
+};
+type ProjectRuntime = {
+  start(input: ProjectRuntimeInput): Promise<ProjectRuntimeResult>;
+  destroy?(input: ProjectRuntimeDestroyInput): Promise<void>;
+  /**
+   * Sweep away every runtime for this org except `keepRuntimeId`, retrying
+   * transient failures instead of giving up after one attempt. This catches
+   * orphans that a single {@link destroy} call missed (e.g. a previous deploy's
+   * destroy failed silently), not just the one runtime recorded as "previous."
+   */
+  reconcile?(input: ProjectRuntimeReconcileInput): Promise<void>;
+};
+type ProjectPingTarget = {
+  baseUrl: string | null;
+  runtimeId: string | null;
+};
+//#endregion
+export { ProjectRuntimeDatabase as a, ProjectRuntimeInput as c, encodeOrgArtifacts as d, parseOrgArtifactsFromEnv as f, ProjectRuntime as i, ProjectRuntimeReconcileInput as l, OrgProjectDeploy as n, ProjectRuntimeDestroyInput as o, ProjectPingTarget as r, ProjectRuntimeHosting as s, OrgArtifactSpec as t, ProjectRuntimeResult as u };
+//# sourceMappingURL=runtime-B0jF0oMv.d.cts.map

package/dist/runtime-B0jF0oMv.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-B0jF0oMv.d.cts","names":[],"sources":["../src/runtime.ts"],"mappings":";KAAY,sBAAA;EACV,IAAA;EACA,IAAA;EACA,QAAA;EACA,IAAA;EACA,QAAA;EACA,UAAA;EACA,cAAA,UAHA;EAKA,SAAA;AAAA;AAAA,KAGU,gBAAA;EACV,SAAA;EACA,IAAA;EACA,UAAA;EACA,kBAAA;EACA,eAAA;AAAA;AAAA,KAGU,eAAA;EACV,SAAA;EACA,kBAAA;EACA,UAAA,UAPA;EASA,eAAA;AAAA;AAAA,KAGU,qBAAA;EACV,OAAO;AAAA;AAAA,KAGG,mBAAA;EACV,cAAA;EACA,QAAA,EAAU,gBAAA;EACV,QAAA,EAAU,sBAAA;EACV,OAAA,GAAU,qBAAA,EAXV;EAaA,GAAA,GAAM,MAAA,kBAbS;EAef,iBAAA;AAAA;;iBAIc,kBAAA,CAAmB,SAA4B,EAAjB,eAAe;AAAA,iBAI7C,wBAAA,CACd,GAAA,GAAK,MAAA,CAAO,UAAA,GACX,eAAe;AAAA,KA6BN,0BAAA;EACV,SAAA;EACA,OAAA,GAAU,qBAAqB;AAAA;AAAA,KAGrB,4BAAA;EACV,cAAA,UA/CM;EAiDN,aAAA;EACA,OAAA,GAAU,qBAAqB;AAAA;AAAA,KAGrB,oBAAA;EACV,SAAA;EACA,OAAO;AAAA;AAAA,KAGG,cAAA;EACV,KAAA,CAAM,KAAA,EAAO,mBAAA,GAAsB,OAAA,CAAQ,oBAAA;EAC3C,OAAA,EAAS,KAAA,EAAO,0BAAA,GAA6B,OAAA;EA5DvC;;;AAEW;AAInB;;EA6DE,SAAA,EAAW,KAAA,EAAO,4BAAA,GAA+B,OAAA;AAAA;AAAA,KAGvC,iBAAA;EACV,OAAA;EACA,SAAS;AAAA"}

package/dist/runtime-B0jF0oMv.d.mts

@@ -0,0 +1,69 @@
+//#region src/runtime.d.ts
+type ProjectRuntimeDatabase = {
+  host: string;
+  port: number;
+  database: string;
+  user: string;
+  password: string;
+  searchPath: string;
+  organizationId: string; /** @deprecated Per-project workers only — org workers omit this. */
+  projectId?: string;
+};
+type OrgProjectDeploy = {
+  projectId: string;
+  name: string;
+  artifactId: string;
+  artifactStorageKey: string;
+  artifactVersion: number;
+};
+type OrgArtifactSpec = {
+  projectId: string;
+  artifactStorageKey: string;
+  artifactId: string; /** Monotonic per-project artifact version from the platform database. */
+  artifactVersion: number;
+};
+type ProjectRuntimeHosting = {
+  appName: string;
+};
+type ProjectRuntimeInput = {
+  organizationId: string;
+  projects: OrgProjectDeploy[];
+  database: ProjectRuntimeDatabase;
+  hosting?: ProjectRuntimeHosting; /** Extra env merged into the project server launch spec (e.g. from an llmProxy plugin). */
+  env?: Record<string, string>; /** Previous runtime to retire after a successful cutover. */
+  previousRuntimeId?: string | null;
+};
+/** Builds base64 `KEYSTROKE_ORG_ARTIFACTS` payload for org worker containers. */
+declare function encodeOrgArtifacts(artifacts: OrgArtifactSpec[]): string;
+declare function parseOrgArtifactsFromEnv(env?: NodeJS.ProcessEnv): OrgArtifactSpec[] | undefined;
+type ProjectRuntimeDestroyInput = {
+  runtimeId: string;
+  hosting?: ProjectRuntimeHosting;
+};
+type ProjectRuntimeReconcileInput = {
+  organizationId: string; /** The runtime to keep — every other runtime belonging to this org should be destroyed. */
+  keepRuntimeId: string;
+  hosting?: ProjectRuntimeHosting;
+};
+type ProjectRuntimeResult = {
+  runtimeId: string;
+  baseUrl: string;
+};
+type ProjectRuntime = {
+  start(input: ProjectRuntimeInput): Promise<ProjectRuntimeResult>;
+  destroy?(input: ProjectRuntimeDestroyInput): Promise<void>;
+  /**
+   * Sweep away every runtime for this org except `keepRuntimeId`, retrying
+   * transient failures instead of giving up after one attempt. This catches
+   * orphans that a single {@link destroy} call missed (e.g. a previous deploy's
+   * destroy failed silently), not just the one runtime recorded as "previous."
+   */
+  reconcile?(input: ProjectRuntimeReconcileInput): Promise<void>;
+};
+type ProjectPingTarget = {
+  baseUrl: string | null;
+  runtimeId: string | null;
+};
+//#endregion
+export { ProjectRuntimeDatabase as a, ProjectRuntimeInput as c, encodeOrgArtifacts as d, parseOrgArtifactsFromEnv as f, ProjectRuntime as i, ProjectRuntimeReconcileInput as l, OrgProjectDeploy as n, ProjectRuntimeDestroyInput as o, ProjectPingTarget as r, ProjectRuntimeHosting as s, OrgArtifactSpec as t, ProjectRuntimeResult as u };
+//# sourceMappingURL=runtime-B0jF0oMv.d.mts.map

package/dist/runtime-B0jF0oMv.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-B0jF0oMv.d.mts","names":[],"sources":["../src/runtime.ts"],"mappings":";KAAY,sBAAA;EACV,IAAA;EACA,IAAA;EACA,QAAA;EACA,IAAA;EACA,QAAA;EACA,UAAA;EACA,cAAA,UAHA;EAKA,SAAA;AAAA;AAAA,KAGU,gBAAA;EACV,SAAA;EACA,IAAA;EACA,UAAA;EACA,kBAAA;EACA,eAAA;AAAA;AAAA,KAGU,eAAA;EACV,SAAA;EACA,kBAAA;EACA,UAAA,UAPA;EASA,eAAA;AAAA;AAAA,KAGU,qBAAA;EACV,OAAO;AAAA;AAAA,KAGG,mBAAA;EACV,cAAA;EACA,QAAA,EAAU,gBAAA;EACV,QAAA,EAAU,sBAAA;EACV,OAAA,GAAU,qBAAA,EAXV;EAaA,GAAA,GAAM,MAAA,kBAbS;EAef,iBAAA;AAAA;;iBAIc,kBAAA,CAAmB,SAA4B,EAAjB,eAAe;AAAA,iBAI7C,wBAAA,CACd,GAAA,GAAK,MAAA,CAAO,UAAA,GACX,eAAe;AAAA,KA6BN,0BAAA;EACV,SAAA;EACA,OAAA,GAAU,qBAAqB;AAAA;AAAA,KAGrB,4BAAA;EACV,cAAA,UA/CM;EAiDN,aAAA;EACA,OAAA,GAAU,qBAAqB;AAAA;AAAA,KAGrB,oBAAA;EACV,SAAA;EACA,OAAO;AAAA;AAAA,KAGG,cAAA;EACV,KAAA,CAAM,KAAA,EAAO,mBAAA,GAAsB,OAAA,CAAQ,oBAAA;EAC3C,OAAA,EAAS,KAAA,EAAO,0BAAA,GAA6B,OAAA;EA5DvC;;;AAEW;AAInB;;EA6DE,SAAA,EAAW,KAAA,EAAO,4BAAA,GAA+B,OAAA;AAAA;AAAA,KAGvC,iBAAA;EACV,OAAA;EACA,SAAS;AAAA"}

package/dist/runtime-BmfsHLrk.mjs

@@ -0,0 +1,19 @@
+//#region src/runtime.ts
+/** Builds base64 `KEYSTROKE_ORG_ARTIFACTS` payload for org worker containers. */
+function encodeOrgArtifacts(artifacts) {
+	return Buffer.from(JSON.stringify(artifacts)).toString("base64");
+}
+function parseOrgArtifactsFromEnv(env = process.env) {
+	const raw = env.KEYSTROKE_ORG_ARTIFACTS?.trim();
+	if (!raw) return;
+	const parsed = JSON.parse(Buffer.from(raw, "base64").toString("utf8"));
+	if (!Array.isArray(parsed)) throw new Error("KEYSTROKE_ORG_ARTIFACTS must decode to a JSON array");
+	return parsed.map((entry) => {
+		if (!entry || typeof entry !== "object" || typeof entry.projectId !== "string" || typeof entry.artifactStorageKey !== "string" || typeof entry.artifactId !== "string" || typeof entry.artifactVersion !== "number") throw new Error("KEYSTROKE_ORG_ARTIFACTS entries require projectId, artifactStorageKey, artifactId, and artifactVersion");
+		return entry;
+	});
+}
+//#endregion
+export { parseOrgArtifactsFromEnv as n, encodeOrgArtifacts as t };
+
+//# sourceMappingURL=runtime-BmfsHLrk.mjs.map

package/dist/runtime-BmfsHLrk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-BmfsHLrk.mjs","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["export type ProjectRuntimeDatabase = {\n  host: string;\n  port: number;\n  database: string;\n  user: string;\n  password: string;\n  searchPath: string;\n  organizationId: string;\n  /** @deprecated Per-project workers only — org workers omit this. */\n  projectId?: string;\n};\n\nexport type OrgProjectDeploy = {\n  projectId: string;\n  name: string;\n  artifactId: string;\n  artifactStorageKey: string;\n  artifactVersion: number;\n};\n\nexport type OrgArtifactSpec = {\n  projectId: string;\n  artifactStorageKey: string;\n  artifactId: string;\n  /** Monotonic per-project artifact version from the platform database. */\n  artifactVersion: number;\n};\n\nexport type ProjectRuntimeHosting = {\n  appName: string;\n};\n\nexport type ProjectRuntimeInput = {\n  organizationId: string;\n  projects: OrgProjectDeploy[];\n  database: ProjectRuntimeDatabase;\n  hosting?: ProjectRuntimeHosting;\n  /** Extra env merged into the project server launch spec (e.g. from an llmProxy plugin). */\n  env?: Record<string, string>;\n  /** Previous runtime to retire after a successful cutover. */\n  previousRuntimeId?: string | null;\n};\n\n/** Builds base64 `KEYSTROKE_ORG_ARTIFACTS` payload for org worker containers. */\nexport function encodeOrgArtifacts(artifacts: OrgArtifactSpec[]): string {\n  return Buffer.from(JSON.stringify(artifacts)).toString(\"base64\");\n}\n\nexport function parseOrgArtifactsFromEnv(\n  env: NodeJS.ProcessEnv = process.env,\n): OrgArtifactSpec[] | undefined {\n  const raw = env.KEYSTROKE_ORG_ARTIFACTS?.trim();\n  if (!raw) {\n    return undefined;\n  }\n\n  const parsed = JSON.parse(Buffer.from(raw, \"base64\").toString(\"utf8\")) as unknown;\n  if (!Array.isArray(parsed)) {\n    throw new Error(\"KEYSTROKE_ORG_ARTIFACTS must decode to a JSON array\");\n  }\n\n  return parsed.map((entry) => {\n    if (\n      !entry ||\n      typeof entry !== \"object\" ||\n      typeof (entry as OrgArtifactSpec).projectId !== \"string\" ||\n      typeof (entry as OrgArtifactSpec).artifactStorageKey !== \"string\" ||\n      typeof (entry as OrgArtifactSpec).artifactId !== \"string\" ||\n      typeof (entry as OrgArtifactSpec).artifactVersion !== \"number\"\n    ) {\n      throw new Error(\n        \"KEYSTROKE_ORG_ARTIFACTS entries require projectId, artifactStorageKey, artifactId, and artifactVersion\",\n      );\n    }\n\n    return entry as OrgArtifactSpec;\n  });\n}\n\nexport type ProjectRuntimeDestroyInput = {\n  runtimeId: string;\n  hosting?: ProjectRuntimeHosting;\n};\n\nexport type ProjectRuntimeReconcileInput = {\n  organizationId: string;\n  /** The runtime to keep — every other runtime belonging to this org should be destroyed. */\n  keepRuntimeId: string;\n  hosting?: ProjectRuntimeHosting;\n};\n\nexport type ProjectRuntimeResult = {\n  runtimeId: string;\n  baseUrl: string;\n};\n\nexport type ProjectRuntime = {\n  start(input: ProjectRuntimeInput): Promise<ProjectRuntimeResult>;\n  destroy?(input: ProjectRuntimeDestroyInput): Promise<void>;\n  /**\n   * Sweep away every runtime for this org except `keepRuntimeId`, retrying\n   * transient failures instead of giving up after one attempt. This catches\n   * orphans that a single {@link destroy} call missed (e.g. a previous deploy's\n   * destroy failed silently), not just the one runtime recorded as \"previous.\"\n   */\n  reconcile?(input: ProjectRuntimeReconcileInput): Promise<void>;\n};\n\nexport type ProjectPingTarget = {\n  baseUrl: string | null;\n  runtimeId: string | null;\n};\n"],"mappings":";;AA4CA,SAAgB,mBAAmB,WAAsC;CACvE,OAAO,OAAO,KAAK,KAAK,UAAU,SAAS,CAAC,EAAE,SAAS,QAAQ;AACjE;AAEA,SAAgB,yBACd,MAAyB,QAAQ,KACF;CAC/B,MAAM,MAAM,IAAI,yBAAyB,KAAK;CAC9C,IAAI,CAAC,KACH;CAGF,MAAM,SAAS,KAAK,MAAM,OAAO,KAAK,KAAK,QAAQ,EAAE,SAAS,MAAM,CAAC;CACrE,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,MAAM,qDAAqD;CAGvE,OAAO,OAAO,KAAK,UAAU;EAC3B,IACE,CAAC,SACD,OAAO,UAAU,YACjB,OAAQ,MAA0B,cAAc,YAChD,OAAQ,MAA0B,uBAAuB,YACzD,OAAQ,MAA0B,eAAe,YACjD,OAAQ,MAA0B,oBAAoB,UAEtD,MAAM,IAAI,MACR,wGACF;EAGF,OAAO;CACT,CAAC;AACH"}

package/dist/runtime-CV7pSfMl.cjs

@@ -0,0 +1,30 @@
+//#region src/runtime.ts
+/** Builds base64 `KEYSTROKE_ORG_ARTIFACTS` payload for org worker containers. */
+function encodeOrgArtifacts(artifacts) {
+	return Buffer.from(JSON.stringify(artifacts)).toString("base64");
+}
+function parseOrgArtifactsFromEnv(env = process.env) {
+	const raw = env.KEYSTROKE_ORG_ARTIFACTS?.trim();
+	if (!raw) return;
+	const parsed = JSON.parse(Buffer.from(raw, "base64").toString("utf8"));
+	if (!Array.isArray(parsed)) throw new Error("KEYSTROKE_ORG_ARTIFACTS must decode to a JSON array");
+	return parsed.map((entry) => {
+		if (!entry || typeof entry !== "object" || typeof entry.projectId !== "string" || typeof entry.artifactStorageKey !== "string" || typeof entry.artifactId !== "string" || typeof entry.artifactVersion !== "number") throw new Error("KEYSTROKE_ORG_ARTIFACTS entries require projectId, artifactStorageKey, artifactId, and artifactVersion");
+		return entry;
+	});
+}
+//#endregion
+Object.defineProperty(exports, "encodeOrgArtifacts", {
+	enumerable: true,
+	get: function() {
+		return encodeOrgArtifacts;
+	}
+});
+Object.defineProperty(exports, "parseOrgArtifactsFromEnv", {
+	enumerable: true,
+	get: function() {
+		return parseOrgArtifactsFromEnv;
+	}
+});
+
+//# sourceMappingURL=runtime-CV7pSfMl.cjs.map

package/dist/runtime-CV7pSfMl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-CV7pSfMl.cjs","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["export type ProjectRuntimeDatabase = {\n  host: string;\n  port: number;\n  database: string;\n  user: string;\n  password: string;\n  searchPath: string;\n  organizationId: string;\n  /** @deprecated Per-project workers only — org workers omit this. */\n  projectId?: string;\n};\n\nexport type OrgProjectDeploy = {\n  projectId: string;\n  name: string;\n  artifactId: string;\n  artifactStorageKey: string;\n  artifactVersion: number;\n};\n\nexport type OrgArtifactSpec = {\n  projectId: string;\n  artifactStorageKey: string;\n  artifactId: string;\n  /** Monotonic per-project artifact version from the platform database. */\n  artifactVersion: number;\n};\n\nexport type ProjectRuntimeHosting = {\n  appName: string;\n};\n\nexport type ProjectRuntimeInput = {\n  organizationId: string;\n  projects: OrgProjectDeploy[];\n  database: ProjectRuntimeDatabase;\n  hosting?: ProjectRuntimeHosting;\n  /** Extra env merged into the project server launch spec (e.g. from an llmProxy plugin). */\n  env?: Record<string, string>;\n  /** Previous runtime to retire after a successful cutover. */\n  previousRuntimeId?: string | null;\n};\n\n/** Builds base64 `KEYSTROKE_ORG_ARTIFACTS` payload for org worker containers. */\nexport function encodeOrgArtifacts(artifacts: OrgArtifactSpec[]): string {\n  return Buffer.from(JSON.stringify(artifacts)).toString(\"base64\");\n}\n\nexport function parseOrgArtifactsFromEnv(\n  env: NodeJS.ProcessEnv = process.env,\n): OrgArtifactSpec[] | undefined {\n  const raw = env.KEYSTROKE_ORG_ARTIFACTS?.trim();\n  if (!raw) {\n    return undefined;\n  }\n\n  const parsed = JSON.parse(Buffer.from(raw, \"base64\").toString(\"utf8\")) as unknown;\n  if (!Array.isArray(parsed)) {\n    throw new Error(\"KEYSTROKE_ORG_ARTIFACTS must decode to a JSON array\");\n  }\n\n  return parsed.map((entry) => {\n    if (\n      !entry ||\n      typeof entry !== \"object\" ||\n      typeof (entry as OrgArtifactSpec).projectId !== \"string\" ||\n      typeof (entry as OrgArtifactSpec).artifactStorageKey !== \"string\" ||\n      typeof (entry as OrgArtifactSpec).artifactId !== \"string\" ||\n      typeof (entry as OrgArtifactSpec).artifactVersion !== \"number\"\n    ) {\n      throw new Error(\n        \"KEYSTROKE_ORG_ARTIFACTS entries require projectId, artifactStorageKey, artifactId, and artifactVersion\",\n      );\n    }\n\n    return entry as OrgArtifactSpec;\n  });\n}\n\nexport type ProjectRuntimeDestroyInput = {\n  runtimeId: string;\n  hosting?: ProjectRuntimeHosting;\n};\n\nexport type ProjectRuntimeReconcileInput = {\n  organizationId: string;\n  /** The runtime to keep — every other runtime belonging to this org should be destroyed. */\n  keepRuntimeId: string;\n  hosting?: ProjectRuntimeHosting;\n};\n\nexport type ProjectRuntimeResult = {\n  runtimeId: string;\n  baseUrl: string;\n};\n\nexport type ProjectRuntime = {\n  start(input: ProjectRuntimeInput): Promise<ProjectRuntimeResult>;\n  destroy?(input: ProjectRuntimeDestroyInput): Promise<void>;\n  /**\n   * Sweep away every runtime for this org except `keepRuntimeId`, retrying\n   * transient failures instead of giving up after one attempt. This catches\n   * orphans that a single {@link destroy} call missed (e.g. a previous deploy's\n   * destroy failed silently), not just the one runtime recorded as \"previous.\"\n   */\n  reconcile?(input: ProjectRuntimeReconcileInput): Promise<void>;\n};\n\nexport type ProjectPingTarget = {\n  baseUrl: string | null;\n  runtimeId: string | null;\n};\n"],"mappings":";;AA4CA,SAAgB,mBAAmB,WAAsC;CACvE,OAAO,OAAO,KAAK,KAAK,UAAU,SAAS,CAAC,EAAE,SAAS,QAAQ;AACjE;AAEA,SAAgB,yBACd,MAAyB,QAAQ,KACF;CAC/B,MAAM,MAAM,IAAI,yBAAyB,KAAK;CAC9C,IAAI,CAAC,KACH;CAGF,MAAM,SAAS,KAAK,MAAM,OAAO,KAAK,KAAK,QAAQ,EAAE,SAAS,MAAM,CAAC;CACrE,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,MAAM,qDAAqD;CAGvE,OAAO,OAAO,KAAK,UAAU;EAC3B,IACE,CAAC,SACD,OAAO,UAAU,YACjB,OAAQ,MAA0B,cAAc,YAChD,OAAQ,MAA0B,uBAAuB,YACzD,OAAQ,MAA0B,eAAe,YACjD,OAAQ,MAA0B,oBAAoB,UAEtD,MAAM,IAAI,MACR,wGACF;EAGF,OAAO;CACT,CAAC;AACH"}