@crouton-kit/crouter 0.3.40 → 0.3.41

package/dist/hearth/control-plane/types.d.ts

@@ -1,86 +0,0 @@
-import type { GuestNodeId, MachineId, TenantId } from '../../core/hearth/types.js';
-export type HearthProvider = 'blaxel';
-export type HomeId = string;
-export type UserId = string;
-export type ProviderSandboxId = MachineId;
-export type ProviderVolumeId = string;
-export type PreviewEndpoint = string;
-export type RelayAuthRef = string;
-export type HomeStatus = 'provisioning' | 'running' | 'suspended' | 'restoring' | 'terminating' | 'terminated' | 'unknown';
-export type HomeHealthVerdict = 'healthy' | 'degraded' | 'unknown';
-export interface Home {
-    home_id: HomeId;
-    tenant_id: TenantId;
-    user_id: UserId;
-    provider: HearthProvider;
-    provider_sandbox_id: ProviderSandboxId | null;
-    provider_volume_id: ProviderVolumeId | null;
-    preview_endpoint: PreviewEndpoint | null;
-    home_agent_target: GuestNodeId | null;
-    relay_auth_ref: RelayAuthRef | null;
-    status: HomeStatus;
-    template_version: string | null;
-    last_ready_at: string | null;
-    last_wake_at: string | null;
-    last_suspend_at: string | null;
-    last_wake_latency_ms: number | null;
-    health_verdict: HomeHealthVerdict;
-    created_at: string;
-    updated_at: string;
-}
-export type ResolvedHome = Home;
-export interface CreateHomeInput {
-    home_id: HomeId;
-    tenant_id: TenantId;
-    user_id: UserId;
-    provider?: HearthProvider;
-    provider_sandbox_id?: ProviderSandboxId | null;
-    provider_volume_id?: ProviderVolumeId | null;
-    preview_endpoint?: PreviewEndpoint | null;
-    home_agent_target?: GuestNodeId | null;
-    relay_auth_ref?: RelayAuthRef | null;
-    status?: HomeStatus;
-    template_version?: string | null;
-    last_ready_at?: string | null;
-    last_wake_at?: string | null;
-    last_suspend_at?: string | null;
-    last_wake_latency_ms?: number | null;
-    health_verdict?: HomeHealthVerdict;
-    created_at?: string;
-    updated_at?: string;
-}
-export interface RefreshProviderPointersInput {
-    provider_sandbox_id: ProviderSandboxId | null;
-    preview_endpoint: PreviewEndpoint | null;
-    status?: HomeStatus;
-    template_version?: string | null;
-}
-export interface TouchWakeInput {
-    at?: string;
-    latency_ms?: number | null;
-}
-export type HomePatch = Partial<Pick<Home, 'provider_sandbox_id' | 'provider_volume_id' | 'preview_endpoint' | 'relay_auth_ref' | 'status' | 'template_version' | 'last_ready_at' | 'last_wake_at' | 'last_suspend_at' | 'last_wake_latency_ms' | 'health_verdict'>>;
-export interface TenantSession {
-    tenant_id: TenantId;
-    user_id: UserId;
-}
-/** The single global auto-upgrade target row (`hearth_target`, db.ts v9).
- *  `channel` is always `'home'` (single-tenant, one image line). The DESIRED
- *  crtr version/image the fleet rolls onto; `home.template_version` is the
- *  ACTUAL running version. `last_bad_target_version`, when set, is a release
- *  whose live roll already failed — the wake-path stale predicate excludes it
- *  so no home re-rolls onto it until the target advances. */
-export interface HearthTarget {
-    channel: 'home';
-    target_template_version: string;
-    target_image_ref: string;
-    published_at: string;
-    source: string;
-    last_bad_target_version: string | null;
-}
-export interface SetHearthTargetInput {
-    target_template_version: string;
-    target_image_ref: string;
-    source: string;
-    published_at?: string;
-}

package/dist/hearth/control-plane/types.js

@@ -1 +0,0 @@
-export {};

package/dist/hearth/control-plane/wake.d.ts

@@ -1,86 +0,0 @@
-import { type HomeBackend } from '../../core/hearth/provider.js';
-import type { M0Config } from '../../core/hearth/types.js';
-import { type ControlPlaneConfig } from './config.js';
-import { getHearthTarget, recordBadTarget } from './hearth-target.js';
-import { getHomeById, refreshProviderPointers, setHealthVerdict, setHomeStatus, touchReady, touchWake } from './registry.js';
-import { resolveSecret } from './secrets.js';
-import type { HomeId, HomeStatus } from './types.js';
-export interface WakeResult {
-    preview_endpoint: string;
-    relayToken: string;
-}
-/** Normalize a provider-observed runtime status into the CP `HomeStatus`
- *  vocabulary before it is ever persisted (Q3 / P3.4 review Minor finding):
- *  the provider's `MachineState` is broad (and may include future
- *  pause/suspend/standby spellings the SDK doesn't expose yet); CP's
- *  `HomeStatus` enum does not have a `'paused'` member. Anything
- *  pause/suspend/standby-shaped collapses to `'suspended'`; an exact
- *  `'running'` passes through; everything else (provisioning, terminating,
- *  terminated, restoring, unrecognized) becomes `'unknown'` rather than
- *  guessing a more specific CP status from a provider-specific string. */
-export declare function normalizeProviderStatus(providerStatus: string | null | undefined): HomeStatus;
-/** One bounded attempt: open a WebSocket to `/node/<target>` carrying the
- *  relay token and require the upgrade to both succeed AND survive a short
- *  settle window (or yield a first frame) within `attemptTimeoutMs` — proof
- *  the in-guest web server answered AND relayed to a live broker `view.sock`
- *  (R-WAKE-2), not just that the SPA shell route is up. Every branch
- *  (success, handshake rejection, error, premature close, attempt timeout)
- *  closes the socket and resolves exactly once — a success closes gracefully
- *  (code 1000) so the guest relay does not record a false fault, anything
- *  else terminates it. */
-declare function probeNodeOnce(previewEndpoint: string, target: string, relayToken: string, attemptTimeoutMs: number): Promise<boolean>;
-/** Retry the single-shot probe until it confirms `/node/<target>` is serving
- *  or `windowMs` elapses. Always runs at least one attempt (R-WAKE-1: "a
- *  single failed probe does not abort"). Every timer this loop starts
- *  (the per-attempt abort timeout, the inter-attempt backoff) is cleared/
- *  resolved before the loop returns — nothing is left armed. */
-declare function probeNodeReady(previewEndpoint: string, target: string, relayToken: string, windowMs: number): Promise<boolean>;
-/** Indirection seam so a smoke/test script can swap any step (the provider
- *  backend, the registry setters, the secret resolver, the probe itself, the
- *  clock) without touching a real DB/provider/filesystem. Production code
- *  never reassigns these; only ad hoc verification scripts do. */
-export declare const wakeInternals: {
-    getHomeById: typeof getHomeById;
-    getHearthTarget: typeof getHearthTarget;
-    recordBadTarget: typeof recordBadTarget;
-    refreshProviderPointers: typeof refreshProviderPointers;
-    setHomeStatus: typeof setHomeStatus;
-    setHealthVerdict: typeof setHealthVerdict;
-    touchWake: typeof touchWake;
-    touchReady: typeof touchReady;
-    resolveSecret: typeof resolveSecret;
-    getHomeBackend: (config: M0Config) => HomeBackend;
-    loadM0Config: () => M0Config;
-    loadControlPlaneConfig: () => ControlPlaneConfig;
-    probeNodeOnce: typeof probeNodeOnce;
-    probeNodeReady: typeof probeNodeReady;
-    now: () => number;
-};
-/** Cheap, non-probing fast path: return a still-fresh warm-verdict cache hit
- *  for `home_id`, or `null` if there is none (expired or never confirmed).
- *  Never reads the registry and never calls the provider — callers fall back
- *  to `ensureAwake` on a `null` (Q1: "no call to provider"). */
-export declare function resolveRunning(home_id: HomeId): WakeResult | null;
-/** Drop the cached warm verdict for a home (e.g. an upstream relay forward
- *  failed) so the next `ensureAwake`/`resolveRunning` re-checks instead of
- *  trusting a stale "ready" answer. */
-export declare function invalidateWarmVerdict(home_id: HomeId): void;
-/** Clear all warm verdicts and in-flight wake coalescing. Test/smoke-script
- *  hygiene only — production never needs this (one CP process, S2). */
-export declare function resetWakeCacheForTests(): void;
-export declare function serializeError(error: unknown): string;
-/** Bring a home up and ready, returning the route to relay to once it is.
- *  Reads the registry, resolves the relay token, calls the provider
- *  wake/resume seam, ready-probes `/node/<home_agent_target>`, refreshes
- *  provider pointers on a recreate, records wake/ready timing, clears the
- *  health verdict to `healthy` on success, and returns
- *  `{ preview_endpoint, relayToken }`. Throws on a ready-probe timeout
- *  (wake-failure UX is deferred — gap note 2 — a throw is the accepted
- *  cutover behavior).
- *
- *  A fresh warm-verdict cache hit short-circuits without re-entering this
- *  pipeline at all. Otherwise concurrent callers for the SAME `home_id`
- *  coalesce onto one in-flight wake (Q1) instead of each driving their own
- *  provider call. */
-export declare function ensureAwake(home_id: HomeId): Promise<WakeResult>;
-export {};