@sixthsummit/ship-api 0.0.0-stage → 4.1.1

package/lib/app/health/HealthCheck.js

@@ -0,0 +1,151 @@
+/**
+ * Pluggable health-check primitive.
+ *
+ * The framework exposes two HTTP endpoints (`/livez` and `/readyz`) backed
+ * by a `HealthCheckRegistry`:
+ *
+ *   - `/livez` — process is up. Always 200 with no checks. Used by load
+ *     balancers / orchestrators to decide "should I restart this pod?"
+ *   - `/readyz` — runs every registered check. 200 if all pass; 503 with
+ *     a structured `{ checks: [...] }` body otherwise. Used to decide
+ *     "should I send traffic to this pod?"
+ *
+ * `createApp()` mounts both routes by default (see `http/app/health.ts`).
+ * Modules / consumer code register checks via `healthCheckRegistry.add(...)`.
+ * Built-in checks: `createDb()` registers a `db.primary` check on its pool by
+ * default; `redisHealthCheck(provider)` is a factory you add yourself.
+ *
+ * Duplicate names: the first registration of a name wins and later ones are
+ * skipped (logged), except that a check added with `{ replaceable: true }`
+ * (what framework defaults such as `createDb`'s `db.primary` use) gives way
+ * to a later explicit registration of the same name. So a consumer that
+ * registers its own `db.primary` after `createDb()` gets exactly one check:
+ * its own.
+ */
+import { logger } from "../../observability/logger.js";
+/**
+ * Container for registered checks. One framework-wide singleton (below);
+ * tests construct their own via `new HealthCheckRegistry()`.
+ */
+export class HealthCheckRegistry {
+    checks = [];
+    replaceable = new Set();
+    /**
+     * Register a check. Returns `true` when the check is now registered,
+     * `false` when it was skipped because a check of that name already exists.
+     *
+     * Duplicate names never throw and never run twice:
+     *   - existing check is `replaceable` and the new one is not → the new
+     *     check replaces it (debug log);
+     *   - otherwise the existing check wins and the new one is skipped (debug
+     *     log when either side is `replaceable`, warn log when both are
+     *     explicit registrations, since that is usually a consumer bug).
+     */
+    add(check, opts = {}) {
+        const index = this.checks.findIndex((c) => c.name === check.name);
+        if (index === -1) {
+            this.checks.push(check);
+            if (opts.replaceable)
+                this.replaceable.add(check);
+            return true;
+        }
+        const existing = this.checks[index];
+        const existingReplaceable = this.replaceable.has(existing);
+        if (existingReplaceable && !opts.replaceable) {
+            this.replaceable.delete(existing);
+            this.checks[index] = check;
+            logger.debug({ check: check.name }, "Health check replaced the framework default registered under the same name");
+            return true;
+        }
+        const message = "Health check with this name is already registered; keeping the first one";
+        if (existingReplaceable || opts.replaceable)
+            logger.debug({ check: check.name }, message);
+        else
+            logger.warn({ check: check.name }, message);
+        return false;
+    }
+    /** Test / admin helper. */
+    remove(name) {
+        const before = this.checks.length;
+        this.checks = this.checks.filter((c) => {
+            if (c.name !== name)
+                return true;
+            this.replaceable.delete(c);
+            return false;
+        });
+        return this.checks.length < before;
+    }
+    list() {
+        return [...this.checks];
+    }
+    size() {
+        return this.checks.length;
+    }
+    clear() {
+        this.checks = [];
+        this.replaceable.clear();
+    }
+    async runAll(opts = {}) {
+        const timeoutMs = opts.timeoutMs ?? 3_000;
+        const reportFailure = (failure) => {
+            try {
+                opts.onCheckFailure?.(failure);
+            }
+            catch {
+                // A logging callback must never break readiness reporting.
+            }
+        };
+        const results = await Promise.all(this.checks.map(async (check) => {
+            const start = performance.now();
+            let ok = true;
+            let error;
+            let details;
+            let timer;
+            const timedOut = Symbol("timeout");
+            try {
+                const result = await Promise.race([
+                    Promise.resolve(check.check()),
+                    new Promise((resolve) => {
+                        timer = setTimeout(() => resolve(timedOut), timeoutMs);
+                    }),
+                ]);
+                if (result === timedOut) {
+                    ok = false;
+                    error = "timeout";
+                    reportFailure({ name: check.name, error: new Error("timeout"), timedOut: true });
+                }
+                else {
+                    ok = result.ok;
+                    error = result.error;
+                    details = result.details;
+                    if (!ok) {
+                        reportFailure({
+                            name: check.name,
+                            error: result.error,
+                            timedOut: false,
+                            ...(typeof result.error === "string" ? { reason: result.error } : {}),
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                ok = false;
+                error = err instanceof Error ? err.message : String(err);
+                reportFailure({ name: check.name, error: err, timedOut: false });
+            }
+            finally {
+                if (timer !== undefined)
+                    clearTimeout(timer);
+            }
+            const latencyMs = Math.round(performance.now() - start);
+            return { name: check.name, ok, latencyMs, error, details };
+        }));
+        return {
+            ok: results.every((r) => r.ok),
+            checks: results,
+        };
+    }
+}
+/** Framework-wide registry. Bootstrappers / modules add checks here. */
+export const healthCheckRegistry = new HealthCheckRegistry();
+//# sourceMappingURL=HealthCheck.js.map

package/lib/app/health/HealthCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthCheck.js","sourceRoot":"","sources":["../../../src/app/health/HealthCheck.ts"],"names":[],"mappings":"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"}

package/lib/app/health/redisHealthCheck.d.ts

@@ -0,0 +1,14 @@
+import type { RedisProvider } from "../services/RedisProvider.js";
+import type { HealthCheck } from "./HealthCheck.js";
+/**
+ * Built-in health check that pings a `RedisProvider`.
+ *
+ * Returned by a factory rather than a class so consumers can register it
+ * declaratively without a `new`. The `check()` call uses
+ * `RedisProvider.ping()`, which never throws — it returns `false` on
+ * failure. We surface that as `ok: false` with `error: "ping failed"`.
+ */
+export declare function redisHealthCheck(provider: RedisProvider, opts?: {
+    name?: string;
+}): HealthCheck;
+//# sourceMappingURL=redisHealthCheck.d.ts.map

package/lib/app/health/redisHealthCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redisHealthCheck.d.ts","sourceRoot":"","sources":["../../../src/app/health/redisHealthCheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,kBAAkB,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EACvB,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3B,WAAW,CAWb"}

package/lib/app/health/redisHealthCheck.js

@@ -0,0 +1,21 @@
+/**
+ * Built-in health check that pings a `RedisProvider`.
+ *
+ * Returned by a factory rather than a class so consumers can register it
+ * declaratively without a `new`. The `check()` call uses
+ * `RedisProvider.ping()`, which never throws — it returns `false` on
+ * failure. We surface that as `ok: false` with `error: "ping failed"`.
+ */
+export function redisHealthCheck(provider, opts = {}) {
+    const name = opts.name ?? "redis";
+    return {
+        name,
+        async check() {
+            const start = performance.now();
+            const ok = await provider.ping();
+            const latencyMs = Math.round(performance.now() - start);
+            return ok ? { ok: true, latencyMs } : { ok: false, latencyMs, error: "ping failed" };
+        },
+    };
+}
+//# sourceMappingURL=redisHealthCheck.js.map

package/lib/app/health/redisHealthCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redisHealthCheck.js","sourceRoot":"","sources":["../../../src/app/health/redisHealthCheck.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAuB,EACvB,OAA0B,EAAE;IAE5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC;IAClC,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,KAAK;YACT,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAChC,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;YACxD,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QACvF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/app/lifecycle/Bootstrapper.d.ts

@@ -0,0 +1,92 @@
+/**
+ * v4 `Bootstrapper` contract — formalizes the order in which app-init steps
+ * run. Replaces v3's "ordered array of `BootstrapperImplementation`s"
+ * pattern with a priority-and-dependsOn graph that the framework validates
+ * at boot.
+ *
+ * Each bootstrapper declares:
+ *   - `name`: stable identifier (referenced by other bootstrappers' `dependsOn`)
+ *   - `priority`: numeric — lower runs first; ties resolve by registration order
+ *   - `dependsOn?`: optional list of bootstrapper names that MUST run earlier
+ *   - `init(ctx)`: the actual work; receives a context object the framework supplies
+ *
+ * The plan's standard priorities (documented in the modernization plan):
+ *
+ * | Priority | Bootstrapper       | Notes                                      |
+ * |---------:|--------------------|---------------------------------------------|
+ * |        0 | InitObservability  | OTel SDK shutdown registration              |
+ * |       10 | InitFirebaseApp    | Firebase Admin SDK init                     |
+ * |       20 | InitDatabase       | Drizzle pool + db:migrate                   |
+ * |       30 | InitRedis          | Redis connection + readiness                |
+ * |       40 | InitMetricsServer  | Prometheus port                             |
+ * |       50 | InitModules        | Route registration                          |
+ * |       60 | InitJobs           | Needs Redis + Modules                       |
+ * |       65 | InitCron           | Needs Jobs (BullMQ repeatable)              |
+ * |       85 | InitDevRoutes      | `/dev/routes` HTML view; gated by env       |
+ * |       90 | InitCustomRoutes   | Downstream override hook                    |
+ * |      100 | InitCustomData     | Last; seeds + custom init                   |
+ *
+ * Health routes are not a bootstrapper: `createApp()` mounts `/livez` and
+ * `/readyz` itself, and `createDb()` registers the `db.primary` check.
+ *
+ * Validation runs at boot. Misordered configs (a bootstrapper with
+ * `dependsOn: ["X"]` where X has higher priority, or X doesn't exist)
+ * throw at startup, not at first request — fail loudly, fail early.
+ */
+export interface BootstrapperContext {
+    /**
+     * Free-form bag the framework / consumers populate during boot. Each
+     * bootstrapper can read what earlier bootstrappers wrote and write its
+     * own outputs. Typed as `Record<string, unknown>` so the framework
+     * stays agnostic of which keys consumers add.
+     *
+     * Convention: each bootstrapper writes under a single key matching its
+     * function (e.g. InitDatabase writes `ctx.db`, InitRedis writes
+     * `ctx.redis`). The eventual App.ts narrows this to a typed view.
+     */
+    [key: string]: unknown;
+}
+export interface Bootstrapper {
+    /** Stable name. Unique within a single boot. */
+    readonly name: string;
+    /** Lower priority runs first; ties resolve by registration order. */
+    readonly priority: number;
+    /** Names of bootstrappers that MUST run earlier. Validated at boot. */
+    readonly dependsOn?: readonly string[];
+    /** Run the init step. Throw to abort boot. */
+    init(ctx: BootstrapperContext): Promise<void> | void;
+}
+export declare class BootstrapperOrderingError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate the registration order:
+ *   - No duplicate names
+ *   - Every `dependsOn` reference resolves to a registered bootstrapper
+ *   - Every `dependsOn` reference has strictly lower priority (ties not allowed —
+ *     a bootstrapper depending on a same-priority peer is ambiguous)
+ *
+ * Throws `BootstrapperOrderingError` on the first violation.
+ */
+export declare function validateBootstrappers(bootstrappers: readonly Bootstrapper[]): void;
+/**
+ * Sort bootstrappers by `priority` ascending, with ties resolved by
+ * original registration order (stable sort — `Array.prototype.sort` is
+ * stable in modern JS engines / TC39 spec).
+ */
+export declare function sortBootstrappers(bootstrappers: readonly Bootstrapper[]): Bootstrapper[];
+export interface RunBootstrappersOptions {
+    /** Initial context. Bootstrappers mutate it as they run. */
+    context?: BootstrapperContext;
+    /**
+     * Skip the validation pass — useful only when the caller has already
+     * validated (e.g., during hot reload). Default false.
+     */
+    skipValidation?: boolean;
+}
+/**
+ * Validate (unless skipped), sort, and run each bootstrapper sequentially.
+ * Returns the populated context. Throws on the first failed `init`.
+ */
+export declare function runBootstrappers(bootstrappers: readonly Bootstrapper[], opts?: RunBootstrappersOptions): Promise<BootstrapperContext>;
+//# sourceMappingURL=Bootstrapper.d.ts.map

package/lib/app/lifecycle/Bootstrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bootstrapper.d.ts","sourceRoot":"","sources":["../../../src/app/lifecycle/Bootstrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,8CAA8C;IAC9C,IAAI,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtD;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAyBlF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CAOxF;AAED,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,SAAS,YAAY,EAAE,EACtC,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAQ9B"}

package/lib/app/lifecycle/Bootstrapper.js

@@ -0,0 +1,99 @@
+/**
+ * v4 `Bootstrapper` contract — formalizes the order in which app-init steps
+ * run. Replaces v3's "ordered array of `BootstrapperImplementation`s"
+ * pattern with a priority-and-dependsOn graph that the framework validates
+ * at boot.
+ *
+ * Each bootstrapper declares:
+ *   - `name`: stable identifier (referenced by other bootstrappers' `dependsOn`)
+ *   - `priority`: numeric — lower runs first; ties resolve by registration order
+ *   - `dependsOn?`: optional list of bootstrapper names that MUST run earlier
+ *   - `init(ctx)`: the actual work; receives a context object the framework supplies
+ *
+ * The plan's standard priorities (documented in the modernization plan):
+ *
+ * | Priority | Bootstrapper       | Notes                                      |
+ * |---------:|--------------------|---------------------------------------------|
+ * |        0 | InitObservability  | OTel SDK shutdown registration              |
+ * |       10 | InitFirebaseApp    | Firebase Admin SDK init                     |
+ * |       20 | InitDatabase       | Drizzle pool + db:migrate                   |
+ * |       30 | InitRedis          | Redis connection + readiness                |
+ * |       40 | InitMetricsServer  | Prometheus port                             |
+ * |       50 | InitModules        | Route registration                          |
+ * |       60 | InitJobs           | Needs Redis + Modules                       |
+ * |       65 | InitCron           | Needs Jobs (BullMQ repeatable)              |
+ * |       85 | InitDevRoutes      | `/dev/routes` HTML view; gated by env       |
+ * |       90 | InitCustomRoutes   | Downstream override hook                    |
+ * |      100 | InitCustomData     | Last; seeds + custom init                   |
+ *
+ * Health routes are not a bootstrapper: `createApp()` mounts `/livez` and
+ * `/readyz` itself, and `createDb()` registers the `db.primary` check.
+ *
+ * Validation runs at boot. Misordered configs (a bootstrapper with
+ * `dependsOn: ["X"]` where X has higher priority, or X doesn't exist)
+ * throw at startup, not at first request — fail loudly, fail early.
+ */
+export class BootstrapperOrderingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BootstrapperOrderingError";
+    }
+}
+/**
+ * Validate the registration order:
+ *   - No duplicate names
+ *   - Every `dependsOn` reference resolves to a registered bootstrapper
+ *   - Every `dependsOn` reference has strictly lower priority (ties not allowed —
+ *     a bootstrapper depending on a same-priority peer is ambiguous)
+ *
+ * Throws `BootstrapperOrderingError` on the first violation.
+ */
+export function validateBootstrappers(bootstrappers) {
+    const byName = new Map();
+    for (const b of bootstrappers) {
+        if (byName.has(b.name)) {
+            throw new BootstrapperOrderingError(`Duplicate bootstrapper name: "${b.name}"`);
+        }
+        byName.set(b.name, b);
+    }
+    for (const b of bootstrappers) {
+        for (const dep of b.dependsOn ?? []) {
+            const target = byName.get(dep);
+            if (!target) {
+                throw new BootstrapperOrderingError(`Bootstrapper "${b.name}" depends on "${dep}", which is not registered`);
+            }
+            if (target.priority >= b.priority) {
+                throw new BootstrapperOrderingError(`Bootstrapper "${b.name}" (priority ${b.priority}) depends on "${target.name}" ` +
+                    `(priority ${target.priority}); dependencies must run strictly earlier`);
+            }
+        }
+    }
+}
+/**
+ * Sort bootstrappers by `priority` ascending, with ties resolved by
+ * original registration order (stable sort — `Array.prototype.sort` is
+ * stable in modern JS engines / TC39 spec).
+ */
+export function sortBootstrappers(bootstrappers) {
+    // Pair with index so we can be explicit about tie-breaking even if the
+    // engine's sort weren't stable.
+    return bootstrappers
+        .map((b, i) => ({ b, i }))
+        .sort((a, b) => a.b.priority - b.b.priority || a.i - b.i)
+        .map((p) => p.b);
+}
+/**
+ * Validate (unless skipped), sort, and run each bootstrapper sequentially.
+ * Returns the populated context. Throws on the first failed `init`.
+ */
+export async function runBootstrappers(bootstrappers, opts = {}) {
+    if (!opts.skipValidation)
+        validateBootstrappers(bootstrappers);
+    const ordered = sortBootstrappers(bootstrappers);
+    const ctx = opts.context ?? {};
+    for (const b of ordered) {
+        await b.init(ctx);
+    }
+    return ctx;
+}
+//# sourceMappingURL=Bootstrapper.js.map

package/lib/app/lifecycle/Bootstrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bootstrapper.js","sourceRoot":"","sources":["../../../src/app/lifecycle/Bootstrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AA2BH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,aAAsC;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,yBAAyB,CAAC,iCAAiC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,yBAAyB,CACjC,iBAAiB,CAAC,CAAC,IAAI,iBAAiB,GAAG,4BAA4B,CACxE,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAClC,MAAM,IAAI,yBAAyB,CACjC,iBAAiB,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,QAAQ,iBAAiB,MAAM,CAAC,IAAI,IAAI;oBAC9E,aAAa,MAAM,CAAC,QAAQ,2CAA2C,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAAsC;IACtE,uEAAuE;IACvE,gCAAgC;IAChC,OAAO,aAAa;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC;AAYD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,aAAsC,EACtC,OAAgC,EAAE;IAElC,IAAI,CAAC,IAAI,CAAC,cAAc;QAAE,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,GAAG,GAAwB,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/app/registry/routes.d.ts

@@ -0,0 +1,89 @@
+import type { ZodType } from "zod";
+/**
+ * Runtime route registry — load-bearing primitive for agent introspection.
+ *
+ * Replaces what OpenAPI was buying us in earlier plan drafts. For *agents*
+ * specifically this is more powerful than OpenAPI: we capture auth provider
+ * identity, permission slugs, rate-limit policy, idempotency, deprecation,
+ * and module ownership — none of which OpenAPI represents natively. And the
+ * registry stays live with the running code (no generation step, never stale).
+ *
+ * Populated by `createApp`'s route-method interceptors when consumer code
+ * calls `app.METHOD(path, ...handlers)`. The middleware factories
+ * (`validate`, `requireAuth`, `requirePermission`, `rateLimit`, `idempotency`)
+ * tag their returned handler via metaTags symbols; the interceptor walks the
+ * handler list and reads those tags to assemble a `RouteEntry`.
+ *
+ * Consumers:
+ * - MCP `list_routes` / `describe_route` / `find_route_collisions` /
+ *   `execute_route` tools.
+ * - The `/dev/routes` HTML debug endpoint.
+ * - The `ship-reviewer` Claude plugin agent (convention enforcement).
+ * - `ship-api g doctor` (schema-less mutating routes flag, etc.).
+ * - v4.x OpenAPI compatibility layer (the OpenAPI generator reads from the
+ *   same registry — no duplication, no two-source drift).
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+export type RouteMethod = HttpMethod | "WS";
+export interface RouteSchemas {
+    json?: ZodType;
+    query?: ZodType;
+    param?: ZodType;
+    header?: ZodType;
+}
+export interface RouteEntry {
+    method: RouteMethod;
+    path: string;
+    /** Module that registered this route (set by InitModules during discovery). */
+    module?: string;
+    auth: {
+        required: boolean;
+        provider?: string;
+    };
+    permissions: string[];
+    rateLimit?: {
+        windowMs: number;
+        max: number;
+        scope?: string;
+    };
+    idempotent?: boolean;
+    schemas: RouteSchemas;
+    description?: string;
+    tags?: string[];
+    deprecated?: boolean;
+}
+export interface RouteFilter {
+    method?: RouteMethod;
+    path?: string;
+    module?: string;
+    tag?: string;
+}
+export declare class RouteRegistry {
+    private entries;
+    /** Module currently being registered — set by InitModules so each captured
+     *  route gets `module` populated. */
+    private currentModule;
+    /** Push a new entry. Called by `createApp`'s interceptors. */
+    add(entry: RouteEntry): void;
+    /** Run `fn` with `module` set so any routes registered inside are tagged. */
+    withModule<T>(name: string, fn: () => Promise<T> | T): Promise<T>;
+    /** All entries (defensively cloned). */
+    list(filter?: RouteFilter): RouteEntry[];
+    /** First entry matching `(method, path)` — exact path match. */
+    find(method: RouteMethod, path: string): RouteEntry | undefined;
+    /**
+     * Find routes that would collide with a proposed `(method, path)`. Returns
+     * exact matches only (not param-pattern overlap — that's a separate
+     * route-tree concern). Empty array means safe to add.
+     */
+    findCollisions(method: RouteMethod, path: string): RouteEntry[];
+    size(): number;
+    /** Remove all entries — primarily for tests. */
+    clear(): void;
+}
+/**
+ * Default framework-wide registry. `createApp` populates this. Tests should
+ * call `routeRegistry.clear()` in `afterEach` to avoid cross-test bleed.
+ */
+export declare const routeRegistry: RouteRegistry;
+//# sourceMappingURL=routes.d.ts.map

package/lib/app/registry/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/app/registry/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1F,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAoB;IACnC;yCACqC;IACrC,OAAO,CAAC,aAAa,CAAqB;IAE1C,8DAA8D;IAC9D,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQ5B,6EAA6E;IACvE,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAUvE,wCAAwC;IACxC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,EAAE;IAIxC,gEAAgE;IAChE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAK/D;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE;IAM/D,IAAI,IAAI,MAAM;IAId,gDAAgD;IAChD,KAAK,IAAI,IAAI;CAId;AAWD;;;GAGG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/lib/app/registry/routes.js

@@ -0,0 +1,72 @@
+export class RouteRegistry {
+    entries = [];
+    /** Module currently being registered — set by InitModules so each captured
+     *  route gets `module` populated. */
+    currentModule;
+    /** Push a new entry. Called by `createApp`'s interceptors. */
+    add(entry) {
+        if (this.currentModule !== undefined && entry.module === undefined) {
+            this.entries.push({ ...entry, module: this.currentModule });
+        }
+        else {
+            this.entries.push(entry);
+        }
+    }
+    /** Run `fn` with `module` set so any routes registered inside are tagged. */
+    async withModule(name, fn) {
+        const previous = this.currentModule;
+        this.currentModule = name;
+        try {
+            return await fn();
+        }
+        finally {
+            this.currentModule = previous;
+        }
+    }
+    /** All entries (defensively cloned). */
+    list(filter) {
+        return this.entries.filter((e) => matches(e, filter)).map((e) => ({ ...e }));
+    }
+    /** First entry matching `(method, path)` — exact path match. */
+    find(method, path) {
+        const match = this.entries.find((e) => e.method === method && e.path === path);
+        return match ? { ...match } : undefined;
+    }
+    /**
+     * Find routes that would collide with a proposed `(method, path)`. Returns
+     * exact matches only (not param-pattern overlap — that's a separate
+     * route-tree concern). Empty array means safe to add.
+     */
+    findCollisions(method, path) {
+        return this.entries
+            .filter((e) => e.method === method && e.path === path)
+            .map((e) => ({ ...e }));
+    }
+    size() {
+        return this.entries.length;
+    }
+    /** Remove all entries — primarily for tests. */
+    clear() {
+        this.entries = [];
+        this.currentModule = undefined;
+    }
+}
+function matches(entry, filter) {
+    if (!filter)
+        return true;
+    if (filter.method && entry.method !== filter.method)
+        return false;
+    if (filter.path && entry.path !== filter.path)
+        return false;
+    if (filter.module && entry.module !== filter.module)
+        return false;
+    if (filter.tag && !(entry.tags ?? []).includes(filter.tag))
+        return false;
+    return true;
+}
+/**
+ * Default framework-wide registry. `createApp` populates this. Tests should
+ * call `routeRegistry.clear()` in `afterEach` to avoid cross-test bleed.
+ */
+export const routeRegistry = new RouteRegistry();
+//# sourceMappingURL=routes.js.map

package/lib/app/registry/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/app/registry/routes.ts"],"names":[],"mappings":"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"}