@nifrajs/core 1.3.1 → 1.5.0

package/dist/diff.d.ts

@@ -0,0 +1,66 @@
+/**
+ * API breaking-change detection over route reflection.
+ *
+ * `snapshotRoutes` turns an app (or reflected descriptors) into a plain-JSON snapshot — the
+ * `standard` validators are dropped, so a snapshot survives `JSON.stringify` and can be committed
+ * as a CI baseline. `diffRouteSnapshots` compares two snapshots and classifies every change by
+ * wire compatibility, direction-aware:
+ *
+ *   request direction (body/query — what clients SEND):  a new required field, a removed field, or
+ *     a narrowed type breaks existing callers; widening (new optional field, enum superset,
+ *     required→optional) is compatible.
+ *   response direction (response/sse/errors — what clients RECEIVE): a removed field, a field made
+ *     optional, or a widened type breaks existing readers; narrowing (new field, optional→required,
+ *     enum subset) is compatible.
+ *
+ * The classifier FAILS CLOSED: a schema change it cannot prove compatible is reported as breaking.
+ * Schemas without JSON Schema metadata (validation-only Standard Schemas) cannot be compared and
+ * yield `info` — never a silent pass presented as proof.
+ */
+import { type JsonSchema, type ReflectedSchemaField } from "./reflection.js";
+/** One schema position in a snapshot: JSON Schema metadata only, no validator. */
+export interface SchemaSnapshot {
+    readonly jsonSchema?: JsonSchema;
+    readonly fields?: readonly ReflectedSchemaField[];
+}
+export interface RouteSnapshotSchema {
+    readonly body?: SchemaSnapshot;
+    readonly query?: SchemaSnapshot;
+    readonly response?: SchemaSnapshot;
+    readonly sse?: SchemaSnapshot;
+    readonly errors?: Readonly<Record<string, SchemaSnapshot>>;
+}
+/** One route in a snapshot — plain JSON, safe to persist as a CI baseline. */
+export interface RouteSnapshot {
+    readonly method: string;
+    readonly path: string;
+    readonly schema?: RouteSnapshotSchema;
+}
+export type DiffSeverity = "breaking" | "compatible" | "info";
+export interface RouteChange {
+    readonly severity: DiffSeverity;
+    readonly method: string;
+    readonly path: string;
+    /** Which part of the contract changed; "route" for add/remove of the whole route. */
+    readonly section: "route" | "body" | "query" | "response" | "sse" | "errors";
+    /** The top-level field (or error status) the change is about, when field-granular. */
+    readonly field?: string;
+    readonly message: string;
+}
+export interface RoutesDiff {
+    readonly changes: readonly RouteChange[];
+    /** True when any change is `breaking` — the CI-gate signal. */
+    readonly hasBreaking: boolean;
+}
+/**
+ * Snapshot an app's routes (anything `reflectRoutes` accepts) as plain JSON. Validators are
+ * dropped; only introspectable JSON Schema metadata is kept, so the result round-trips through
+ * `JSON.stringify` unchanged.
+ */
+export declare function snapshotRoutes(source: unknown): readonly RouteSnapshot[];
+/**
+ * Diff two route snapshots (`snapshotRoutes` output, possibly restored from JSON). Every change is
+ * classified breaking/compatible/info; `hasBreaking` is the CI-gate bit.
+ */
+export declare function diffRouteSnapshots(before: readonly RouteSnapshot[], after: readonly RouteSnapshot[]): RoutesDiff;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,oBAAoB,EAE1B,MAAM,iBAAiB,CAAA;AAExB,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAA;CAClD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;CAC3D;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;CACtC;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAA;AAE7D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC5E,sFAAsF;IACtF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAC9B;AAiBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,aAAa,EAAE,CAExE;AA+OD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,UAAU,CA+CZ"}

package/dist/diff.js

@@ -0,0 +1,264 @@
+/**
+ * API breaking-change detection over route reflection.
+ *
+ * `snapshotRoutes` turns an app (or reflected descriptors) into a plain-JSON snapshot — the
+ * `standard` validators are dropped, so a snapshot survives `JSON.stringify` and can be committed
+ * as a CI baseline. `diffRouteSnapshots` compares two snapshots and classifies every change by
+ * wire compatibility, direction-aware:
+ *
+ *   request direction (body/query — what clients SEND):  a new required field, a removed field, or
+ *     a narrowed type breaks existing callers; widening (new optional field, enum superset,
+ *     required→optional) is compatible.
+ *   response direction (response/sse/errors — what clients RECEIVE): a removed field, a field made
+ *     optional, or a widened type breaks existing readers; narrowing (new field, optional→required,
+ *     enum subset) is compatible.
+ *
+ * The classifier FAILS CLOSED: a schema change it cannot prove compatible is reported as breaking.
+ * Schemas without JSON Schema metadata (validation-only Standard Schemas) cannot be compared and
+ * yield `info` — never a silent pass presented as proof.
+ */
+import { reflectRoutes, } from "./reflection.js";
+const schemaSnapshot = (reflection) => {
+    if (reflection === undefined)
+        return undefined;
+    return {
+        ...(reflection.jsonSchema !== undefined ? { jsonSchema: reflection.jsonSchema } : {}),
+        ...(reflection.fields !== undefined ? { fields: reflection.fields } : {}),
+    };
+};
+/**
+ * Snapshot an app's routes (anything `reflectRoutes` accepts) as plain JSON. Validators are
+ * dropped; only introspectable JSON Schema metadata is kept, so the result round-trips through
+ * `JSON.stringify` unchanged.
+ */
+export function snapshotRoutes(source) {
+    return reflectRoutes(source).map((route) => snapshotRoute(route));
+}
+const snapshotRoute = (route) => {
+    const schema = route.schema;
+    if (schema === undefined)
+        return { method: route.method, path: route.path };
+    const errors = {};
+    for (const [status, reflection] of Object.entries(schema.errors ?? {})) {
+        const snapped = schemaSnapshot(reflection);
+        if (snapped !== undefined)
+            errors[status] = snapped;
+    }
+    const body = schemaSnapshot(schema.body);
+    const query = schemaSnapshot(schema.query);
+    const response = schemaSnapshot(schema.response);
+    const sse = schemaSnapshot(schema.sse);
+    const snapped = {
+        ...(body !== undefined ? { body } : {}),
+        ...(query !== undefined ? { query } : {}),
+        ...(response !== undefined ? { response } : {}),
+        ...(sse !== undefined ? { sse } : {}),
+        ...(Object.keys(errors).length > 0 ? { errors } : {}),
+    };
+    return {
+        method: route.method,
+        path: route.path,
+        ...(Object.keys(snapped).length > 0 ? { schema: snapped } : {}),
+    };
+};
+const jsonEqual = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+const enumOf = (schema) => {
+    if (typeof schema !== "object" || schema === null)
+        return undefined;
+    const candidate = schema.enum;
+    return Array.isArray(candidate) ? candidate : undefined;
+};
+const withoutEnum = (schema) => {
+    if (typeof schema !== "object" || schema === null)
+        return schema;
+    const { enum: _omitted, ...rest } = schema;
+    return rest;
+};
+const isSuperset = (outer, inner) => {
+    const keys = new Set(outer.map((value) => JSON.stringify(value)));
+    return inner.every((value) => keys.has(JSON.stringify(value)));
+};
+/**
+ * Compare two JSON Schemas for one position. Returns the change severity, or `undefined` when
+ * they are equivalent. The only refinement proven compatible is an enum-only change in the
+ * safe direction (request may widen, response may narrow); everything else fails closed.
+ */
+const compareJsonSchema = (direction, before, after) => {
+    if (jsonEqual(before, after))
+        return undefined;
+    const beforeEnum = enumOf(before);
+    const afterEnum = enumOf(after);
+    if (beforeEnum !== undefined &&
+        afterEnum !== undefined &&
+        jsonEqual(withoutEnum(before), withoutEnum(after))) {
+        const compatible = direction === "request"
+            ? isSuperset(afterEnum, beforeEnum)
+            : isSuperset(beforeEnum, afterEnum);
+        return compatible ? "compatible" : "breaking";
+    }
+    return "breaking";
+};
+const push = (ctx, severity, message, field) => {
+    ctx.changes.push({
+        severity,
+        method: ctx.method,
+        path: ctx.path,
+        section: ctx.section,
+        ...(field !== undefined ? { field } : {}),
+        message,
+    });
+};
+const fieldMap = (snapshot) => {
+    if (snapshot.fields === undefined)
+        return undefined;
+    return new Map(snapshot.fields.map((field) => [field.name, field]));
+};
+const diffFields = (ctx, before, after) => {
+    const beforeFields = fieldMap(before);
+    const afterFields = fieldMap(after);
+    if (beforeFields === undefined || afterFields === undefined) {
+        // Non-object schemas: compare the whole JSON Schema in one step.
+        const severity = compareJsonSchema(ctx.direction, before.jsonSchema, after.jsonSchema);
+        if (severity !== undefined)
+            push(ctx, severity, `${ctx.section} schema changed`);
+        return;
+    }
+    for (const [name, beforeField] of beforeFields) {
+        const afterField = afterFields.get(name);
+        if (afterField === undefined) {
+            // Request: strict validators reject payloads still sending the field. Response: readers lose it.
+            push(ctx, "breaking", `field "${name}" removed`, name);
+            continue;
+        }
+        if (beforeField.required !== afterField.required) {
+            const nowRequired = afterField.required;
+            const breaking = ctx.direction === "request" ? nowRequired : !nowRequired;
+            push(ctx, breaking ? "breaking" : "compatible", `field "${name}" is now ${nowRequired ? "required" : "optional"}`, name);
+        }
+        const severity = compareJsonSchema(ctx.direction, beforeField.schema, afterField.schema);
+        if (severity !== undefined)
+            push(ctx, severity, `field "${name}" type changed`, name);
+    }
+    for (const [name, afterField] of afterFields) {
+        if (beforeFields.has(name))
+            continue;
+        if (ctx.direction === "request") {
+            push(ctx, afterField.required ? "breaking" : "compatible", `${afterField.required ? "required" : "optional"} field "${name}" added`, name);
+        }
+        else {
+            push(ctx, "compatible", `field "${name}" added`, name);
+        }
+    }
+};
+const diffSchemaSection = (ctx, before, after) => {
+    if (before === undefined && after === undefined)
+        return;
+    if (before === undefined) {
+        // A new request contract rejects payloads old clients send freely; a new response contract
+        // only documents what was already returned.
+        push(ctx, ctx.direction === "request" ? "breaking" : "compatible", `${ctx.section} schema added`);
+        return;
+    }
+    if (after === undefined) {
+        // Dropping a request contract loosens validation; dropping a response contract removes a
+        // documented shape clients (and typed consumers) rely on.
+        push(ctx, ctx.direction === "request" ? "compatible" : "breaking", `${ctx.section} schema removed`);
+        return;
+    }
+    if (before.jsonSchema === undefined || after.jsonSchema === undefined) {
+        // Validation-only schemas expose no JSON Schema metadata — nothing provable either way.
+        if (before.jsonSchema !== after.jsonSchema || before.fields !== after.fields) {
+            push(ctx, "info", `${ctx.section} schema is not introspectable — cannot verify compatibility`);
+        }
+        return;
+    }
+    diffFields(ctx, before, after);
+};
+const diffErrors = (method, path, changes, before, after) => {
+    const beforeEntries = before ?? {};
+    const afterEntries = after ?? {};
+    for (const [status, beforeSchema] of Object.entries(beforeEntries)) {
+        const afterSchema = afterEntries[status];
+        if (afterSchema === undefined) {
+            // Clients parsing this structured error body lose a documented shape.
+            changes.push({
+                severity: "breaking",
+                method,
+                path,
+                section: "errors",
+                field: status,
+                message: `error ${status} removed from the contract`,
+            });
+            continue;
+        }
+        const ctx = { method, path, section: "errors", direction: "response", changes };
+        if (beforeSchema.jsonSchema === undefined || afterSchema.jsonSchema === undefined) {
+            if (!jsonEqual(beforeSchema, afterSchema)) {
+                push(ctx, "info", `error ${status} schema is not introspectable`, status);
+            }
+            continue;
+        }
+        const severity = compareJsonSchema("response", beforeSchema.jsonSchema, afterSchema.jsonSchema);
+        if (severity !== undefined)
+            push(ctx, severity, `error ${status} schema changed`, status);
+    }
+    for (const status of Object.keys(afterEntries)) {
+        if (status in beforeEntries)
+            continue;
+        changes.push({
+            severity: "compatible",
+            method,
+            path,
+            section: "errors",
+            field: status,
+            message: `error ${status} added to the contract`,
+        });
+    }
+};
+const routeKey = (route) => `${route.method.toUpperCase()} ${route.path}`;
+/**
+ * Diff two route snapshots (`snapshotRoutes` output, possibly restored from JSON). Every change is
+ * classified breaking/compatible/info; `hasBreaking` is the CI-gate bit.
+ */
+export function diffRouteSnapshots(before, after) {
+    const changes = [];
+    const afterByKey = new Map(after.map((route) => [routeKey(route), route]));
+    const beforeKeys = new Set(before.map((route) => routeKey(route)));
+    for (const beforeRoute of before) {
+        const afterRoute = afterByKey.get(routeKey(beforeRoute));
+        if (afterRoute === undefined) {
+            changes.push({
+                severity: "breaking",
+                method: beforeRoute.method,
+                path: beforeRoute.path,
+                section: "route",
+                message: "route removed",
+            });
+            continue;
+        }
+        const method = beforeRoute.method;
+        const path = beforeRoute.path;
+        const beforeSchema = beforeRoute.schema ?? {};
+        const afterSchema = afterRoute.schema ?? {};
+        for (const section of ["body", "query"]) {
+            diffSchemaSection({ method, path, section, direction: "request", changes }, beforeSchema[section], afterSchema[section]);
+        }
+        for (const section of ["response", "sse"]) {
+            diffSchemaSection({ method, path, section, direction: "response", changes }, beforeSchema[section], afterSchema[section]);
+        }
+        diffErrors(method, path, changes, beforeSchema.errors, afterSchema.errors);
+    }
+    for (const afterRoute of after) {
+        if (beforeKeys.has(routeKey(afterRoute)))
+            continue;
+        changes.push({
+            severity: "compatible",
+            method: afterRoute.method,
+            path: afterRoute.path,
+            section: "route",
+            message: "route added",
+        });
+    }
+    return { changes, hasBreaking: changes.some((change) => change.severity === "breaking") };
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/index.d.ts

@@ -11,10 +11,12 @@
  * (it shipped at "0.0.0" through 1.0.0 before those guards existed). Kept narrow (`as const`) so
  * consumers can pin it at the type level — see `test/version.test-d.ts`.
  */
-export declare const VERSION: "1.3.1";
+export declare const VERSION: "1.5.0";
 export type Version = typeof VERSION;
+export * from "./diff.js";
 export { FrameworkError, RouteConfigError, type RouteConfigErrorCode } from "./errors.js";
 export { FRAMEWORK_NAME, type FrameworkName } from "./internal/brand.js";
+export * from "./reflection.js";
 export { METHODS, type Method, Router, type RouterMatch } from "./router/router.js";
 export type { InferInput, InferOutput, StandardIssue, StandardResult, StandardSchemaV1, StandardTypes, ValidationOutcome, } from "./schema/standard.js";
 export { validateStandard } from "./schema/standard.js";
@@ -24,8 +26,8 @@ export { type ContextForOp, type ContractShape, defineContract, type HandlersFor
 export { type CookieOptions, parseCookies, serializeCookie, signValue, unsignValue, } from "./server/cookies.js";
 export { commonSecretPatterns, jsonLogger, type LogFields, type Logger, type RedactOptions, redactLogFields, silentLogger, } from "./server/logger.js";
 export type { Registry, RouteInfo } from "./server/registry.js";
-export { type AnyServer, type DurableObjectNamespaceLike, defineIdentityPlugin, definePlugin, defineRouterPlugin, type ExecutionContext, type Handler, type IdentityPlugin, type McpPromptDescriptor, type McpResourceDescriptor, type Middleware, type NifraPlugin, type NodeServeOutcome, type OnRequestResult, type PromptArgument, type PromptMessage, type RouteDescriptor, type RunningServer, type ScheduledController, type ScheduledHandler, Server, type ServerOptions, server, type ToolAnnotations, toFetchHandler, } from "./server/server.js";
-export { type SSEContext, type SSEInit, type SSEMessage, type SSEStream, sse, } from "./server/sse.js";
+export { type AnyServer, type DurableObjectNamespaceLike, defineIdentityPlugin, definePlugin, defineRouterPlugin, type ExecutionContext, type Handler, type IdentityPlugin, type McpPromptDescriptor, type McpResourceDescriptor, type Middleware, type NifraPlugin, type NodeServeOutcome, type OnRequestResult, type PromptArgument, type PromptMessage, type ResponseFinalization, type RouteDescriptor, type RunningServer, type ScheduledController, type ScheduledHandler, Server, type ServerOptions, server, type ToolAnnotations, toFetchHandler, } from "./server/server.js";
+export { type SSEContext, type SSEInit, type SSEMessage, type SSEStream, sse, type TypedSSEStream, typedSSEStream, } from "./server/sse.js";
 export { type SignatureEncoding, type VerifyWebhookOptions, verifyWebhook, type WebhookFailureReason, type WebhookProvider, type WebhookResult, } from "./server/webhook.js";
 export type { NifraWebSocket, StandardWebSocket, WebSocketContext, WebSocketData, WebSocketHandler, WebSocketUpgradeOutcome, } from "./server/websocket.js";
 export { attachWebSocket, TopicRegistry } from "./server/websocket.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAG,OAAgB,CAAA;AAEvC,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAA;AAEpC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACzF,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACnF,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,MAAM,EACN,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,OAAO,GACR,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,WAAW,EAChB,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,aAAa,EAClB,YAAY,EACZ,eAAe,EACf,SAAS,EACT,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EACL,KAAK,SAAS,EACd,KAAK,0BAA0B,EAC/B,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,MAAM,EACN,KAAK,aAAa,EAClB,MAAM,EACN,KAAK,eAAe,EACpB,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,SAAS,EACd,GAAG,GACJ,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -11,9 +11,11 @@
  * (it shipped at "0.0.0" through 1.0.0 before those guards existed). Kept narrow (`as const`) so
  * consumers can pin it at the type level — see `test/version.test-d.ts`.
  */
-export const VERSION = "1.3.1";
+export const VERSION = "1.5.0";
+export * from "./diff.js";
 export { FrameworkError, RouteConfigError } from "./errors.js";
 export { FRAMEWORK_NAME } from "./internal/brand.js";
+export * from "./reflection.js";
 export { METHODS, Router } from "./router/router.js";
 export { validateStandard } from "./schema/standard.js";
 export { robots, sitemap, } from "./seo.js";
@@ -21,7 +23,7 @@ export { defineContract, implement, } from "./server/contract.js";
 export { parseCookies, serializeCookie, signValue, unsignValue, } from "./server/cookies.js";
 export { commonSecretPatterns, jsonLogger, redactLogFields, silentLogger, } from "./server/logger.js";
 export { defineIdentityPlugin, definePlugin, defineRouterPlugin, Server, server, toFetchHandler, } from "./server/server.js";
-export { sse, } from "./server/sse.js";
+export { sse, typedSSEStream, } from "./server/sse.js";
 export { verifyWebhook, } from "./server/webhook.js";
 export { attachWebSocket, TopicRegistry } from "./server/websocket.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAgB,CAAA;AAIvC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAA6B,MAAM,aAAa,CAAA;AACzF,OAAO,EAAE,cAAc,EAAsB,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,OAAO,EAAe,MAAM,EAAoB,MAAM,oBAAoB,CAAA;AAUnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAGL,MAAM,EAIN,OAAO,GACR,MAAM,UAAU,CAAA;AASjB,OAAO,EAGL,cAAc,EAEd,SAAS,GAKV,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAEL,YAAY,EACZ,eAAe,EACf,SAAS,EACT,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,oBAAoB,EACpB,UAAU,EAIV,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAGL,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAgBlB,MAAM,EAEN,MAAM,EAEN,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAKL,GAAG,GACJ,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,aAAa,GAId,MAAM,qBAAqB,CAAA;AAS5B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAgB,CAAA;AAIvC,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAA6B,MAAM,aAAa,CAAA;AACzF,OAAO,EAAE,cAAc,EAAsB,MAAM,qBAAqB,CAAA;AACxE,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,OAAO,EAAe,MAAM,EAAoB,MAAM,oBAAoB,CAAA;AAUnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAGL,MAAM,EAIN,OAAO,GACR,MAAM,UAAU,CAAA;AASjB,OAAO,EAGL,cAAc,EAEd,SAAS,GAKV,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAEL,YAAY,EACZ,eAAe,EACf,SAAS,EACT,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,oBAAoB,EACpB,UAAU,EAIV,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAGL,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAiBlB,MAAM,EAEN,MAAM,EAEN,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAKL,GAAG,EAEH,cAAc,GACf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,aAAa,GAId,MAAM,qBAAqB,CAAA;AAS5B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/reflection.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Runtime reflection for schemas and registered routes.
+ *
+ * Standard Schema deliberately standardizes validation, not introspection. This module makes that
+ * distinction explicit: `standard` is present when a value can validate, while `jsonSchema` and
+ * `fields` are present only when the value carries inspectable JSON Schema metadata. The implementation
+ * recognizes Nifra/TypeBox carriers and raw JSON Schema without depending on a validator package.
+ */
+import type { StandardSchemaV1 } from "./schema/standard.js";
+import type { ToolAnnotations } from "./server/server.js";
+/** JSON Schema permits either a schema object or the boolean schemas `true` and `false`. */
+export type JsonSchema = boolean | Readonly<Record<string, unknown>>;
+/** One top-level property of an introspectable object schema. */
+export interface ReflectedSchemaField {
+    readonly name: string;
+    readonly required: boolean;
+    readonly schema: JsonSchema;
+}
+/** Validation and introspection capabilities discovered for one schema-like value. */
+export interface SchemaReflection {
+    /** The Standard Schema validator, when the value implements Standard Schema v1. */
+    readonly standard: StandardSchemaV1 | undefined;
+    /** Raw JSON Schema metadata, when the value exposes it or is itself a raw JSON Schema. */
+    readonly jsonSchema: JsonSchema | undefined;
+    /** Top-level object fields, or `undefined` when the JSON Schema is absent/non-object. */
+    readonly fields: readonly ReflectedSchemaField[] | undefined;
+}
+export interface ReflectedRouteSchema {
+    readonly body?: SchemaReflection;
+    readonly query?: SchemaReflection;
+    readonly response?: SchemaReflection;
+    readonly errors?: Readonly<Record<string, SchemaReflection>>;
+    /** The SSE event-payload schema of a typed streaming route (`app.sse()`). */
+    readonly sse?: SchemaReflection;
+}
+export interface ReflectedRoute {
+    readonly method: string;
+    readonly path: string;
+    readonly schema?: ReflectedRouteSchema;
+    readonly tool?: {
+        readonly name: string;
+        readonly description: string;
+        readonly annotations?: ToolAnnotations;
+    };
+}
+/**
+ * Reflect a Standard Schema, Nifra/TypeBox schema carrier, or raw JSON Schema. Never throws.
+ * Validation-only schemas have `standard` but no `jsonSchema`; raw JSON Schema has the reverse.
+ */
+export declare function reflectSchema(value: unknown): SchemaReflection;
+/**
+ * Safely enumerate and normalize route descriptors from an app or descriptor array. Invalid entries
+ * are ignored; a missing/throwing `routes()` method yields an empty array.
+ */
+export declare function reflectRoutes(source: unknown): readonly ReflectedRoute[];
+//# sourceMappingURL=reflection.d.ts.map

package/dist/reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection.d.ts","sourceRoot":"","sources":["../src/reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,4FAA4F;AAC5F,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEpE,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAC5B;AAED,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAC/C,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAA;IAC3C,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,GAAG,SAAS,CAAA;CAC7D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;IAC5D,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAA;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAA;KACvC,CAAA;CACF;AAyED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAI9D;AA6CD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,cAAc,EAAE,CAexE"}

package/dist/reflection.js

@@ -0,0 +1,154 @@
+/**
+ * Runtime reflection for schemas and registered routes.
+ *
+ * Standard Schema deliberately standardizes validation, not introspection. This module makes that
+ * distinction explicit: `standard` is present when a value can validate, while `jsonSchema` and
+ * `fields` are present only when the value carries inspectable JSON Schema metadata. The implementation
+ * recognizes Nifra/TypeBox carriers and raw JSON Schema without depending on a validator package.
+ */
+const recordOf = (value) => value !== null && typeof value === "object"
+    ? value
+    : undefined;
+const standardOf = (value) => {
+    const record = recordOf(value);
+    const standard = recordOf(record?.["~standard"]);
+    return standard?.version === 1 && typeof standard.validate === "function"
+        ? value
+        : undefined;
+};
+const jsonSchemaOf = (value, standard) => {
+    const record = recordOf(value);
+    if (record !== undefined && "jsonSchema" in record) {
+        const carried = record.jsonSchema;
+        return normalizeJsonSchema(carried);
+    }
+    // Some Standard Schema implementations (including TypeBox-shaped adapters) expose an object
+    // schema directly rather than through `.jsonSchema`. Only treat an inspectable object shape as
+    // metadata here; validation-library internals are otherwise intentionally opaque.
+    if (standard !== undefined) {
+        return recordOf(record?.properties) !== undefined ? normalizeJsonSchema(record) : undefined;
+    }
+    // A malformed/opaque Standard Schema marker is not raw JSON Schema metadata.
+    if (record !== undefined && "~standard" in record)
+        return undefined;
+    if (typeof value === "boolean" || record !== undefined)
+        return normalizeJsonSchema(value);
+    return undefined;
+};
+/** Strip symbol keys and other non-JSON metadata carried by schema-builder objects. */
+const normalizeJsonSchema = (value) => {
+    if (typeof value === "boolean")
+        return value;
+    if (recordOf(value) === undefined)
+        return undefined;
+    try {
+        const normalized = JSON.parse(JSON.stringify(value));
+        if (typeof normalized === "boolean")
+            return normalized;
+        const record = recordOf(normalized);
+        if (record === undefined)
+            return undefined;
+        // `~standard` is a Standard Schema *validation* marker, never valid JSON Schema. A TypeBox-shaped
+        // carrier (a JSON Schema object that also carries `~standard`, with no separate `.jsonSchema`) would
+        // otherwise leak the marker into emitted OpenAPI / mock / form output.
+        if (!("~standard" in record))
+            return record;
+        const { ["~standard"]: _omitted, ...rest } = record;
+        return rest;
+    }
+    catch {
+        return undefined;
+    }
+};
+const fieldsOf = (schema) => {
+    const record = recordOf(schema);
+    const properties = recordOf(record?.properties);
+    if (properties === undefined)
+        return undefined;
+    const required = new Set(Array.isArray(record?.required)
+        ? record.required.filter((name) => typeof name === "string")
+        : []);
+    const fields = [];
+    for (const [name, property] of Object.entries(properties)) {
+        if (typeof property !== "boolean" && recordOf(property) === undefined)
+            continue;
+        fields.push({ name, required: required.has(name), schema: property });
+    }
+    return fields;
+};
+/**
+ * Reflect a Standard Schema, Nifra/TypeBox schema carrier, or raw JSON Schema. Never throws.
+ * Validation-only schemas have `standard` but no `jsonSchema`; raw JSON Schema has the reverse.
+ */
+export function reflectSchema(value) {
+    const standard = standardOf(value);
+    const jsonSchema = jsonSchemaOf(value, standard);
+    return { standard, jsonSchema, fields: fieldsOf(jsonSchema) };
+}
+const routeCandidates = (source) => {
+    if (Array.isArray(source))
+        return source;
+    const record = recordOf(source);
+    if (typeof record?.routes !== "function")
+        return [];
+    try {
+        const routes = record.routes();
+        return Array.isArray(routes) ? routes : [];
+    }
+    catch {
+        return [];
+    }
+};
+const reflectedRouteSchema = (value) => {
+    const schema = recordOf(value);
+    if (schema === undefined)
+        return undefined;
+    const errors = recordOf(schema.errors);
+    const reflectedErrors = {};
+    if (errors !== undefined) {
+        for (const [status, errorSchema] of Object.entries(errors)) {
+            reflectedErrors[status] = reflectSchema(errorSchema);
+        }
+    }
+    return {
+        ...(schema.body !== undefined ? { body: reflectSchema(schema.body) } : {}),
+        ...(schema.query !== undefined ? { query: reflectSchema(schema.query) } : {}),
+        ...(schema.response !== undefined ? { response: reflectSchema(schema.response) } : {}),
+        ...(Object.keys(reflectedErrors).length > 0 ? { errors: reflectedErrors } : {}),
+        ...(schema.sse !== undefined ? { sse: reflectSchema(schema.sse) } : {}),
+    };
+};
+const reflectedTool = (value) => {
+    const tool = recordOf(value);
+    if (typeof tool?.name !== "string" || typeof tool.description !== "string")
+        return undefined;
+    return {
+        name: tool.name,
+        description: tool.description,
+        ...(recordOf(tool.annotations) !== undefined
+            ? { annotations: tool.annotations }
+            : {}),
+    };
+};
+/**
+ * Safely enumerate and normalize route descriptors from an app or descriptor array. Invalid entries
+ * are ignored; a missing/throwing `routes()` method yields an empty array.
+ */
+export function reflectRoutes(source) {
+    const reflected = [];
+    for (const candidate of routeCandidates(source)) {
+        const route = recordOf(candidate);
+        if (typeof route?.method !== "string" || typeof route.path !== "string")
+            continue;
+        const schema = reflectedRouteSchema(route.schema);
+        const tool = reflectedTool(route.tool);
+        reflected.push({
+            method: route.method.toUpperCase(),
+            path: route.path,
+            ...(schema !== undefined ? { schema } : {}),
+            ...(tool !== undefined ? { tool } : {}),
+        });
+    }
+    return reflected;
+}
+//# sourceMappingURL=reflection.js.map