@skaile/workspaces 6.16.0 → 6.17.0

package/dist/chunk-G5SUWZEU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../plugin-registry/src/errors.ts","../plugin-registry/src/internal.ts","../plugin-registry/src/deploy-handle.ts","../plugin-registry/src/deploy-helpers.ts"],"names":["target"],"mappings":"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","file":"chunk-G5SUWZEU.js","sourcesContent":["/**\n * Error types thrown by the plugin registry and deploy resolution.\n *\n * Each carries a stable `.name` so callers can branch on identity without\n * importing the class (cross-package / cross-bundle `instanceof` is unreliable).\n */\n\n/** Thrown by `register()` when a target id is already registered for its kind. */\nexport class RegistrationError extends Error {\n  constructor(kind: string, id: string) {\n    super(`A \"${kind}\" target with id \"${id}\" is already registered.`);\n    this.name = \"RegistrationError\";\n  }\n}\n\n/** Thrown when a lookup by id finds no registered target for the given kind. */\nexport class MissingTargetError extends Error {\n  constructor(kind: string, id: string) {\n    super(`No \"${kind}\" target registered with id \"${id}\".`);\n    this.name = \"MissingTargetError\";\n  }\n}\n\n/** Thrown by `register()` when a target declares an unsupported `apiVersion`. */\nexport class ApiVersionMismatchError extends Error {\n  constructor(kind: string, id: string, got: unknown) {\n    super(\n      `Target \"${id}\" (kind \"${kind}\") declares apiVersion ${String(got)}; registry requires apiVersion 1.`,\n    );\n    this.name = \"ApiVersionMismatchError\";\n  }\n}\n\n/** Thrown by `resolveDeployTarget()` when the requested deploy target id is unknown. */\nexport class DeployTargetNotFoundError extends Error {\n  constructor(id: string) {\n    super(`No deploy target registered with id \"${id}\".`);\n    this.name = \"DeployTargetNotFoundError\";\n  }\n}\n","/**\n * Map-backed `PluginRegistry` implementation + the process-wide singleton.\n *\n * Storage is one Map per kind. Registration rejects duplicate ids\n * (`RegistrationError`) and any target not on `apiVersion: 1`\n * (`ApiVersionMismatchError`).\n */\n\nimport { ApiVersionMismatchError, RegistrationError } from \"./errors.js\";\nimport type { PluginRegistry, Target, TargetKind, TargetMeta } from \"./registry.js\";\n\ntype AnyTarget = { id: string; displayName: string; apiVersion: unknown };\n\nclass MapPluginRegistry implements PluginRegistry {\n  readonly apiVersion = 1 as const;\n\n  // One Map per kind keeps lookups kind-scoped — a harness and a connector may\n  // share an id without colliding.\n  private readonly stores: Record<TargetKind, Map<string, AnyTarget>> = {\n    harness: new Map(),\n    connector: new Map(),\n    deployTarget: new Map(),\n  };\n\n  /** The store of `kind`; a retired or unknown kind is a loud error, not a silent no-op. */\n  private storeFor(kind: string): Map<string, AnyTarget> {\n    if (Object.hasOwn(this.stores, kind)) return this.stores[kind as TargetKind];\n    if (kind === \"driver\") {\n      throw new Error(\n        'plugin kind \"driver\" was renamed to \"harness\" in @skaile/workspaces 6.0.0; register(\"harness\", …)',\n      );\n    }\n    throw new Error(`unknown plugin kind \"${kind}\"`);\n  }\n\n  register<K extends TargetKind>(kind: K, target: Target<K>): void {\n    const store = this.storeFor(kind);\n    const t = target as unknown as AnyTarget;\n    if (t.apiVersion !== 1) {\n      throw new ApiVersionMismatchError(kind, t.id, t.apiVersion);\n    }\n    if (store.has(t.id)) {\n      throw new RegistrationError(kind, t.id);\n    }\n    store.set(t.id, t);\n  }\n\n  unregister<K extends TargetKind>(kind: K, id: string): boolean {\n    return this.storeFor(kind).delete(id);\n  }\n\n  get<K extends TargetKind>(kind: K, id: string): Target<K> | undefined {\n    return this.storeFor(kind).get(id) as Target<K> | undefined;\n  }\n\n  list<K extends TargetKind>(kind: K): readonly TargetMeta[] {\n    return [...this.storeFor(kind).values()].map((t) => ({\n      id: t.id,\n      displayName: t.displayName,\n    }));\n  }\n}\n\n/** Create a fresh, isolated registry — used by tests so cases never share state. */\nexport function createPluginRegistry(): PluginRegistry {\n  return new MapPluginRegistry();\n}\n\n/** Process-wide default registry. Built-ins and loaded plugins register here. */\nexport const pluginRegistry: PluginRegistry = createPluginRegistry();\n","/**\n * Deploy handle contract + the `resolveDeployTarget` precedence resolver.\n *\n * A `DeployHandle` is the live, restorable result of standing up a workspace on\n * a deploy target. `resolveDeployTarget` picks which target+config to use with\n * an explicit override > yaml > default chain.\n */\n\nimport { DeployTargetNotFoundError } from \"./errors.js\";\nimport { pluginRegistry } from \"./internal.js\";\nimport type { PluginRegistry, TargetMeta } from \"./registry.js\";\nimport type { DeployTarget } from \"./targets.js\";\n\n/**\n * Live handle to a deployed workspace. `payload` is the target's own opaque\n * persistence slice (written to `.skaile/deploy/handle.json` and fed back into\n * `restore()`); the registry wrapper never inspects it.\n */\nexport interface DeployHandle<S = unknown> {\n  readonly wsUrl: string;\n  /** Redacted form of the auth token, safe to log. */\n  readonly wsAuth?: string;\n  readonly state: \"starting\" | \"ready\" | \"stopping\" | \"stopped\" | \"errored\";\n  readonly payload: S;\n  waitReady(timeoutMs?: number): Promise<void>;\n  health(): Promise<{ healthy: boolean; detail?: string }>;\n  logs?(opts?: { sinceMs?: number; follow?: boolean }): AsyncIterable<{ ts: number; line: string }>;\n  stop(): Promise<void>;\n}\n\n/**\n * List the registered deploy targets as lightweight `{ id, displayName }` rows,\n * the symmetric counterpart to `listHarnesses()` / `listConnectors()`. Reads the\n * process-wide `pluginRegistry` by default, so call\n * `registerBuiltinDeployTargets()` (and load any plugins) first — unregistered\n * targets do not appear. Enough to populate a target picker without resolving a\n * config; use `getDeployTarget(id)` for the full target.\n */\nexport function listDeployTargets(\n  registry: PluginRegistry = pluginRegistry,\n): readonly TargetMeta[] {\n  return registry.list(\"deployTarget\");\n}\n\n/**\n * Look up a single registered deploy target by id, or `undefined` if none is\n * registered under that id. Thin wrapper over `pluginRegistry.get`, mirroring\n * `getConnector()`; unlike `resolveDeployTarget` it neither applies the\n * override/yaml/default precedence nor parses a config.\n */\nexport function getDeployTarget(\n  id: string,\n  registry: PluginRegistry = pluginRegistry,\n): DeployTarget | undefined {\n  return registry.get(\"deployTarget\", id);\n}\n\n/** Outcome of `resolveDeployTarget`: the chosen target, its parsed config, and where it came from. */\nexport interface DeployResolution {\n  target: DeployTarget;\n  config: unknown;\n  provenance: { source: \"default\" | \"yaml\" | \"override\"; reason?: string };\n}\n\n/**\n * Resolve which deploy target + config to use, with explicit precedence:\n * CLI override > `skaile.yaml` `deploy:` block > the built-in `local` default.\n * Config is parsed through the chosen target's `configSchema`, so validation\n * failures propagate to the caller.\n */\nexport async function resolveDeployTarget(\n  yaml: { deploy?: { target: string; config?: unknown } },\n  override?: { target: string; config?: unknown; reason: string },\n  registry: PluginRegistry = pluginRegistry,\n): Promise<DeployResolution> {\n  if (override) {\n    const target = registry.get(\"deployTarget\", override.target);\n    if (!target) throw new DeployTargetNotFoundError(override.target);\n    return {\n      target,\n      config: target.configSchema.parse(override.config ?? {}),\n      provenance: { source: \"override\", reason: override.reason },\n    };\n  }\n  if (yaml.deploy) {\n    const target = registry.get(\"deployTarget\", yaml.deploy.target);\n    if (!target) throw new DeployTargetNotFoundError(yaml.deploy.target);\n    return {\n      target,\n      config: target.configSchema.parse(yaml.deploy.config ?? {}),\n      provenance: { source: \"yaml\" },\n    };\n  }\n  const target = registry.get(\"deployTarget\", \"local\");\n  if (!target) throw new DeployTargetNotFoundError(\"local\");\n  return {\n    target,\n    config: target.configSchema.parse({}),\n    provenance: { source: \"default\" },\n  };\n}\n","/**\n * Shared building blocks for `DeployTarget` implementations.\n *\n * These lift the byte-for-byte duplication that had accumulated across the\n * provider packages (the `buildStrategy` enum, an abort-aware `sleep`, the\n * poll-until-ready loop, and the `DeployHandle` wrapper) into one authoritative\n * place — the package that already owns the `DeployHandle` contract.\n */\n\nimport * as z from \"zod\";\nimport type { DeployContext } from \"./context.js\";\nimport type { DeployHandle } from \"./deploy-handle.js\";\n\n/**\n * The authoritative build-strategy enum shared by every deploy target.\n * `local`/`managed` need an operator-supplied image; `remote` builds one.\n */\nexport const buildStrategySchema = z.enum([\"local\", \"remote\", \"managed\"]);\n\nexport type BuildStrategy = z.infer<typeof buildStrategySchema>;\n\n/**\n * Abort-aware sleep. Resolves after `ms`, or rejects immediately if `signal`\n * aborts first (so a cancelled deploy stops polling promptly).\n */\nexport async function sleep(ms: number, signal: AbortSignal): Promise<void> {\n  return await new Promise<void>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      signal.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(new Error(\"aborted while polling\"));\n    };\n    if (signal.aborted) onAbort();\n    else signal.addEventListener(\"abort\", onAbort);\n  });\n}\n\n/** Options for {@link pollUntil}. */\nexport interface PollUntilOptions {\n  /** Predicate polled until it returns true. */\n  check: () => Promise<boolean>;\n  /** Deadline relative to `Date.now()` at the first failing check. */\n  timeoutMs: number;\n  /** Delay between attempts, via the abort-aware {@link sleep}. */\n  intervalMs: number;\n  signal: AbortSignal;\n  /** Descriptive message for the timeout error; defaults to \"timed out\". */\n  timeoutMessage?: string;\n}\n\n/**\n * Poll `check()` until it returns true. Sleeps `intervalMs` between attempts\n * and throws once `Date.now()` passes the deadline. Generalizes the readiness\n * loops the deploy providers each re-implemented.\n */\nexport async function pollUntil(opts: PollUntilOptions): Promise<void> {\n  const deadline = Date.now() + opts.timeoutMs;\n  for (;;) {\n    if (await opts.check()) return;\n    if (Date.now() > deadline) {\n      throw new Error(opts.timeoutMessage ?? \"timed out\");\n    }\n    await sleep(opts.intervalMs, opts.signal);\n  }\n}\n\n/** Options for {@link makeDeployHandle}. */\nexport interface MakeDeployHandleOptions<S> {\n  wsUrl: string;\n  /** Source of `wsAuth` redaction and the abort `signal` for the ready routine. */\n  ctx: DeployContext;\n  payload: S;\n  initialState: DeployHandle[\"state\"];\n  /** Timeout passed to `ready` when `waitReady` is called without one. */\n  defaultReadyTimeoutMs: number;\n  /** Readiness routine; receives the EFFECTIVE timeout (caller's or the default). */\n  ready: (timeoutMs: number, signal: AbortSignal) => Promise<void>;\n  health: () => Promise<{ healthy: boolean; detail?: string }>;\n  stop: () => Promise<void>;\n  logs?: DeployHandle<S>[\"logs\"];\n}\n\n/**\n * Build a `DeployHandle` from per-target seams, replacing the wrapper each\n * provider had copy-pasted. Unlike those wrappers, `waitReady(timeoutMs)`\n * forwards the caller's timeout to `ready` instead of discarding it.\n */\nexport function makeDeployHandle<S>(opts: MakeDeployHandleOptions<S>): DeployHandle<S> {\n  let state: DeployHandle[\"state\"] = opts.initialState;\n  const handle: DeployHandle<S> = {\n    wsUrl: opts.wsUrl,\n    wsAuth: opts.ctx.wsAuth ? \"<redacted>\" : undefined,\n    get state() {\n      return state;\n    },\n    payload: opts.payload,\n    async waitReady(timeoutMs?: number) {\n      const effective = timeoutMs ?? opts.defaultReadyTimeoutMs;\n      try {\n        await opts.ready(effective, opts.ctx.signal);\n        state = \"ready\";\n      } catch (err) {\n        state = \"errored\";\n        throw err;\n      }\n    },\n    health: opts.health,\n    async stop() {\n      state = \"stopping\";\n      await opts.stop();\n      state = \"stopped\";\n    },\n  };\n  if (opts.logs) handle.logs = opts.logs;\n  return handle;\n}\n"]}