glirastes 0.4.0 → 0.5.1

package/dist/codegen/inventory-generation.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+declare const ObservationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    path: z.ZodString;
+    method: z.ZodEnum<{
+        GET: "GET";
+        HEAD: "HEAD";
+        POST: "POST";
+        PATCH: "PATCH";
+        PUT: "PUT";
+        DELETE: "DELETE";
+    }>;
+    sourceFingerprint: z.ZodString;
+    inputSchemaDigest: z.ZodString;
+    outputSchemaDigest: z.ZodString;
+    executionKind: z.ZodLiteral<"endpoint">;
+    stableKey: z.ZodString;
+    definitionId: z.ZodString;
+    sourceKind: z.ZodOptional<z.ZodEnum<{
+        "next-app": "next-app";
+        nest: "nest";
+        openapi: "openapi";
+    }>>;
+    sourceFile: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    actionId: z.ZodOptional<z.ZodString>;
+    sourceFingerprint: z.ZodString;
+    inputSchemaDigest: z.ZodString;
+    outputSchemaDigest: z.ZodString;
+    executionKind: z.ZodLiteral<"ui">;
+    actionBindingRef: z.ZodString;
+    stableKey: z.ZodString;
+    definitionId: z.ZodString;
+}, z.core.$strict>], "executionKind">;
+/** App-local generation state; never upload this source-bearing object. */
+export declare const ExecutionGenerationStateSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    appId: z.ZodUUID;
+    inventory: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<2>;
+        targetAppKey: z.ZodString;
+        executions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            toolId: z.ZodUUID;
+            definitionId: z.ZodString;
+            stableKey: z.ZodString;
+            sourceFingerprint: z.ZodString;
+            inputSchemaDigest: z.ZodString;
+            outputSchemaDigest: z.ZodString;
+            executionKind: z.ZodLiteral<"endpoint">;
+            sourceKind: z.ZodOptional<z.ZodEnum<{
+                "next-app": "next-app";
+                nest: "nest";
+                openapi: "openapi";
+            }>>;
+            sourceFile: z.ZodString;
+            method: z.ZodEnum<{
+                GET: "GET";
+                HEAD: "HEAD";
+                POST: "POST";
+                PATCH: "PATCH";
+                PUT: "PUT";
+                DELETE: "DELETE";
+            }>;
+            path: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            toolId: z.ZodUUID;
+            definitionId: z.ZodString;
+            stableKey: z.ZodString;
+            sourceFingerprint: z.ZodString;
+            inputSchemaDigest: z.ZodString;
+            outputSchemaDigest: z.ZodString;
+            executionKind: z.ZodLiteral<"ui">;
+            actionBindingRef: z.ZodString;
+            actionId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "executionKind">>;
+    }, z.core.$strict>;
+    tombstones: z.ZodArray<z.ZodObject<{
+        toolId: z.ZodUUID;
+        stableKey: z.ZodString;
+        definitionId: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ExecutionGenerationState = z.infer<typeof ExecutionGenerationStateSchema>;
+export type ObservedExecution = z.infer<typeof ObservationSchema>;
+export interface ExecutionGenerationResult {
+    state: ExecutionGenerationState;
+    changes: {
+        added: string[];
+        changed: string[];
+        removed: string[];
+        unchanged: string[];
+    };
+}
+/**
+ * Reconcile a complete source-adapter snapshot. Does not assess semantics,
+ * grant permissions, write files, sync, or claim executable-source verification.
+ * Callers must persist state (including tombstones) and validate real sources.
+ */
+export declare function reconcileExecutionInventory(options: {
+    appId: string;
+    targetAppKey: string;
+    observed: unknown;
+    previous?: unknown;
+}): ExecutionGenerationResult;
+export {};

package/dist/codegen/inventory-generation.js

@@ -0,0 +1,119 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { FoundationDiagnosticError } from '../diagnostics/index.js';
+import { FoundationExecutionInventorySchema } from './execution-inventory.js';
+const [endpoint, ui] = FoundationExecutionInventorySchema.shape.executions.element.options;
+const ObservationSchema = z.discriminatedUnion('executionKind', [
+    endpoint.omit({ toolId: true }), ui.omit({ toolId: true }),
+]);
+const SnapshotSchema = z.object({
+    complete: z.boolean(), executions: z.array(ObservationSchema).max(5_000),
+}).strict();
+const TombstoneSchema = z.object({
+    toolId: z.uuid(), stableKey: z.string().min(1).max(2_100),
+    definitionId: z.string().min(1).max(200),
+}).strict();
+/** App-local generation state; never upload this source-bearing object. */
+export const ExecutionGenerationStateSchema = z.object({
+    schemaVersion: z.literal(1), appId: z.uuid(),
+    inventory: FoundationExecutionInventorySchema,
+    tombstones: z.array(TombstoneSchema).max(100_000),
+}).strict();
+function fail(message, remediation) {
+    throw new FoundationDiagnosticError({
+        code: 'E-INVENTORY-010', operation: 'generate.inventory', message, remediation,
+    });
+}
+function canonical(value) {
+    const sort = (item) => Array.isArray(item) ? item.map(sort)
+        : item && typeof item === 'object'
+            ? Object.fromEntries(Object.entries(item).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)
+                .map(([key, child]) => [key, sort(child)])) : item;
+    return JSON.stringify(sort(value));
+}
+// UUIDv5 scoped to app + target + stable key + removal generation. Reappearance
+// is a new identity, not revival of an old authorization/approval reference.
+function newIdentity(appId, target, key, generation) {
+    const bytes = createHash('sha1').update(Buffer.from(appId.replaceAll('-', ''), 'hex'))
+        .update(JSON.stringify(['glirastes.execution.v1', target, key, generation])).digest().subarray(0, 16);
+    bytes[6] = (bytes[6] & 0x0f) | 0x50;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function assertUnique(entries) {
+    const keys = new Set();
+    const names = new Set();
+    const fingerprints = new Set();
+    for (const entry of entries) {
+        if (keys.has(entry.stableKey) || names.has(entry.definitionId)) {
+            fail('Duplicate execution keys or definition names.', 'repair-source-observations');
+        }
+        if (fingerprints.has(entry.sourceFingerprint)) {
+            fail('Conflicting source fingerprint.', 'repair-source-observations');
+        }
+        if (entry.executionKind === 'endpoint' && entry.stableKey !== `${entry.method} ${entry.path}`) {
+            fail('Endpoint stable key does not match its method and path.', 'repair-source-observations');
+        }
+        keys.add(entry.stableKey);
+        names.add(entry.definitionId);
+        fingerprints.add(entry.sourceFingerprint);
+    }
+}
+/**
+ * Reconcile a complete source-adapter snapshot. Does not assess semantics,
+ * grant permissions, write files, sync, or claim executable-source verification.
+ * Callers must persist state (including tombstones) and validate real sources.
+ */
+export function reconcileExecutionInventory(options) {
+    const scope = z.object({ appId: z.uuid(), targetAppKey: z.string().trim().min(1).max(200) }).safeParse(options);
+    const snapshot = SnapshotSchema.safeParse(options.observed);
+    if (!scope.success || !snapshot.success)
+        fail('Invalid generation scope or source observations.', 'repair-source-observations');
+    if (!snapshot.data.complete)
+        fail('Source discovery is incomplete; prior inventory was not replaced.', 'complete-source-discovery');
+    const parsed = options.previous === undefined ? undefined : ExecutionGenerationStateSchema.safeParse(options.previous);
+    if (parsed && !parsed.success)
+        fail('Invalid previous generation state.', 'restore-generation-state');
+    const previous = parsed?.data;
+    if (previous && (previous.appId !== scope.data.appId || previous.inventory.targetAppKey !== scope.data.targetAppKey)) {
+        fail('Previous generation state belongs to a different app.', 'align-generation-scope');
+    }
+    assertUnique(snapshot.data.executions);
+    assertUnique(previous?.inventory.executions ?? []);
+    const occupied = new Set();
+    for (const entry of [...previous?.inventory.executions ?? [], ...previous?.tombstones ?? []]) {
+        if (occupied.has(entry.toolId))
+            fail('Duplicate identities in previous generation state.', 'restore-generation-state');
+        occupied.add(entry.toolId);
+    }
+    const previousByKey = new Map(previous?.inventory.executions.map((entry) => [entry.stableKey, entry]));
+    const currentKeys = new Set(snapshot.data.executions.map(({ stableKey }) => stableKey));
+    const tombstones = [...previous?.tombstones ?? []];
+    const changes = { added: [], changed: [], removed: [], unchanged: [] };
+    for (const old of previous?.inventory.executions ?? []) {
+        if (currentKeys.has(old.stableKey))
+            continue;
+        changes.removed.push(old.toolId);
+        tombstones.push({ toolId: old.toolId, stableKey: old.stableKey, definitionId: old.definitionId });
+    }
+    const executions = snapshot.data.executions.map((observation) => {
+        const old = previousByKey.get(observation.stableKey);
+        const toolId = old?.toolId ?? newIdentity(scope.data.appId, scope.data.targetAppKey, observation.stableKey, tombstones.filter(({ stableKey }) => stableKey === observation.stableKey).length);
+        if (!old && occupied.has(toolId))
+            fail('Generated execution identity conflicts with previous state.', 'restore-generation-state');
+        occupied.add(toolId);
+        const execution = { ...observation, toolId };
+        changes[!old ? 'added' : canonical(old) === canonical(execution) ? 'unchanged' : 'changed'].push(toolId);
+        return execution;
+    }).sort((a, b) => a.toolId < b.toolId ? -1 : a.toolId > b.toolId ? 1 : 0);
+    for (const list of Object.values(changes))
+        list.sort();
+    tombstones.sort((a, b) => a.toolId < b.toolId ? -1 : a.toolId > b.toolId ? 1 : 0);
+    return {
+        state: ExecutionGenerationStateSchema.parse({ schemaVersion: 1, appId: scope.data.appId,
+            inventory: { schemaVersion: 2, targetAppKey: scope.data.targetAppKey, executions }, tombstones }),
+        changes,
+    };
+}
+//# sourceMappingURL=inventory-generation.js.map

package/dist/codegen/inventory-generation.js.map

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

package/dist/codegen/next-source-generation.d.ts

@@ -0,0 +1,17 @@
+import { type ObservedExecution } from './inventory-generation.js';
+import { type ScannedRouteCandidate } from './route-scanner.js';
+export interface ResolvedEndpointContract {
+    definitionId: string;
+    inputSchemaDigest: string;
+    outputSchemaDigest: string;
+}
+/**
+ * Enumerate actual routes before resolving their local schema contracts. The
+ * setup agent supplies a thin source-schema adapter, not a static tool list.
+ * This stage does not grant exposure, infer authorization or upload sources.
+ */
+export declare function collectNextEndpointExecutions(options: {
+    rootDir: string;
+    apiDir?: string;
+    resolveContract: (candidate: ScannedRouteCandidate) => ResolvedEndpointContract | undefined | Promise<ResolvedEndpointContract | undefined>;
+}): Promise<ObservedExecution[]>;

package/dist/codegen/next-source-generation.js

@@ -0,0 +1,49 @@
+import { FoundationDiagnosticError } from '../diagnostics/index.js';
+import { scanNextAppRoutes } from './route-scanner.js';
+import { FoundationExecutionInventorySchema } from './execution-inventory.js';
+const ContractSchema = FoundationExecutionInventorySchema.shape.executions.element.options[0]
+    .pick({ definitionId: true, inputSchemaDigest: true, outputSchemaDigest: true });
+function fail(message, remediation) {
+    throw new FoundationDiagnosticError({
+        code: 'E-INVENTORY-011', operation: 'generate.next-source', message, remediation,
+    });
+}
+/**
+ * Enumerate actual routes before resolving their local schema contracts. The
+ * setup agent supplies a thin source-schema adapter, not a static tool list.
+ * This stage does not grant exposure, infer authorization or upload sources.
+ */
+export async function collectNextEndpointExecutions(options) {
+    let scan;
+    try {
+        scan = await scanNextAppRoutes({ rootDir: options.rootDir, apiDir: options.apiDir, mode: 'source-discovery' });
+    }
+    catch {
+        fail('Source discovery is incomplete; no updated inventory was produced.', 'complete-source-discovery');
+    }
+    if (scan.findings?.length)
+        fail('Source discovery is incomplete; resolve source findings first.', 'complete-source-discovery');
+    const observations = [];
+    for (const candidate of scan.candidates) {
+        let contract;
+        try {
+            contract = await options.resolveContract(structuredClone(candidate));
+        }
+        catch {
+            fail('A source contract could not be resolved. Ask the setup agent to assess it locally.', 'assess-source-contracts');
+        }
+        if (!contract)
+            fail('A source contract is unresolved. Ask the setup agent to assess it locally.', 'assess-source-contracts');
+        const parsed = ContractSchema.safeParse(contract);
+        if (!parsed.success)
+            fail('A source contract is invalid. Ask the setup agent to assess it locally.', 'assess-source-contracts');
+        observations.push({
+            ...parsed.data,
+            executionKind: 'endpoint', stableKey: `${candidate.method} ${candidate.path}`,
+            method: candidate.method, path: candidate.path,
+            sourceFile: candidate.sourceFile, sourceFingerprint: candidate.sourceFingerprint,
+        });
+    }
+    return observations;
+}
+//# sourceMappingURL=next-source-generation.js.map

package/dist/codegen/next-source-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-source-generation.js","sourceRoot":"","sources":["../../src/codegen/next-source-generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAA8B,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AAE9E,MAAM,cAAc,GAAG,kCAAkC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;KAC1F,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;AAQnF,SAAS,IAAI,CAAC,OAAe,EAAE,WAAmB;IAChD,MAAM,IAAI,yBAAyB,CAAC;QAClC,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,sBAAsB,EAAE,OAAO,EAAE,WAAW;KACjF,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,OAKnD;IACC,IAAI,IAAmD,CAAC;IACxD,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,iBAAiB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACjH,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC,oEAAoE,EAAE,2BAA2B,CAAC,CAAC;IAC1G,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM;QAAE,IAAI,CAAC,gEAAgE,EAAE,2BAA2B,CAAC,CAAC;IAC/H,MAAM,YAAY,GAAwB,EAAE,CAAC;IAC7C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,QAA8C,CAAC;QACnD,IAAI,CAAC;YAAC,QAAQ,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YACnF,IAAI,CAAC,oFAAoF,EAAE,yBAAyB,CAAC,CAAC;QACxH,CAAC;QACD,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,4EAA4E,EAAE,yBAAyB,CAAC,CAAC;QAC7H,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,IAAI,CAAC,yEAAyE,EAAE,yBAAyB,CAAC,CAAC;QAChI,YAAY,CAAC,IAAI,CAAC;YAChB,GAAG,MAAM,CAAC,IAAI;YACd,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE;YAC7E,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI;YAC9C,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;SACjF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/codegen/openapi-document.d.ts

@@ -0,0 +1,53 @@
+import type { EndpointMethod } from '../types.js';
+/** The largest OpenAPI export the generator reads. */
+export declare const OPENAPI_DOCUMENT_LIMIT: number;
+/** Operations of a path item, in OpenAPI order. */
+export declare const OPENAPI_OPERATION_KEYS: readonly ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
+/** The operations that become endpoint tools; `options` and `trace` are reported, never dropped. */
+export declare const OPENAPI_TOOL_METHODS: Readonly<Partial<Record<string, EndpointMethod>>>;
+type JsonObject = Record<string, unknown>;
+export interface OpenapiDocument {
+    openapi: string;
+    paths: Record<string, unknown>;
+    components?: unknown;
+    security?: unknown;
+}
+export interface OpenapiOperationEntry {
+    /** The path as written in the document, `{taskId}` placeholders included. */
+    documentPath: string;
+    /** The path in stable-key form (`:taskId`), or undefined when a segment mixes a placeholder with text. */
+    path: string | undefined;
+    operationKey: (typeof OPENAPI_OPERATION_KEYS)[number];
+    operation: JsonObject;
+    pathItem: JsonObject;
+}
+/** The document, or why it is not an OpenAPI 3.1 export the generator reads. */
+export declare function parseOpenapiDocument(text: string): {
+    ok: true;
+    document: OpenapiDocument;
+} | {
+    ok: false;
+    reason: string;
+};
+/** `/api/tasks/{taskId}` → `/api/tasks/:taskId`; undefined for `/files/{name}.json`. */
+export declare function colonPath(documentPath: string): string | undefined;
+export declare function operationsOf(document: OpenapiDocument): OpenapiOperationEntry[];
+export interface Dereferenced {
+    value: unknown;
+    /** Why parts of the value were replaced by `{}`: an external, missing, recursive or too deep reference. */
+    problems: string[];
+}
+/**
+ * Replace local `$ref`s by their targets. Siblings of a `$ref` (OpenAPI 3.1
+ * allows `description` next to it) win over the target's keys. A reference
+ * the generator cannot follow becomes `{}`, which accepts anything, and is
+ * named in `problems`.
+ */
+export declare function dereference(document: OpenapiDocument, value: unknown): Dereferenced;
+/**
+ * The fingerprint of one operation: its dereferenced definition, the path
+ * item's parameters and the document's global security. Any change to the
+ * schemas the server validates changes it.
+ */
+export declare function operationFingerprint(document: OpenapiDocument, entry: OpenapiOperationEntry, method: EndpointMethod, path: string): string;
+export {};

package/dist/codegen/openapi-document.js

@@ -0,0 +1,120 @@
+import { createRouteSourceFingerprint } from './route-fingerprint.js';
+import { sortKeysDeep } from './tools/canonical.js';
+/** The largest OpenAPI export the generator reads. */
+export const OPENAPI_DOCUMENT_LIMIT = 2 * 1024 * 1024;
+const MAX_REFERENCE_DEPTH = 32;
+/** Operations of a path item, in OpenAPI order. */
+export const OPENAPI_OPERATION_KEYS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'];
+/** The operations that become endpoint tools; `options` and `trace` are reported, never dropped. */
+export const OPENAPI_TOOL_METHODS = {
+    get: 'GET', head: 'HEAD', post: 'POST', put: 'PUT', patch: 'PATCH', delete: 'DELETE',
+};
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** The document, or why it is not an OpenAPI 3.1 export the generator reads. */
+export function parseOpenapiDocument(text) {
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        return { ok: false, reason: 'is not valid JSON' };
+    }
+    if (!isObject(json) || typeof json.openapi !== 'string')
+        return { ok: false, reason: 'is not an OpenAPI document' };
+    if (!/^3\.1\.\d+$/.test(json.openapi)) {
+        return { ok: false, reason: `is OpenAPI ${json.openapi}; the generator reads OpenAPI 3.1 exports (FastAPI 0.99 and later write 3.1)` };
+    }
+    if (!isObject(json.paths))
+        return { ok: false, reason: 'has no paths object' };
+    return { ok: true, document: json };
+}
+/** `/api/tasks/{taskId}` → `/api/tasks/:taskId`; undefined for `/files/{name}.json`. */
+export function colonPath(documentPath) {
+    const segments = documentPath.split('/').map((segment) => {
+        const whole = /^\{([A-Za-z_][A-Za-z0-9_]*)\}$/.exec(segment);
+        if (whole)
+            return `:${whole[1]}`;
+        return /[{}]/.test(segment) ? undefined : segment;
+    });
+    return segments.includes(undefined) ? undefined : segments.join('/');
+}
+export function operationsOf(document) {
+    const entries = [];
+    for (const [documentPath, pathItem] of Object.entries(document.paths)) {
+        if (!isObject(pathItem))
+            continue;
+        for (const operationKey of OPENAPI_OPERATION_KEYS) {
+            const operation = pathItem[operationKey];
+            if (!isObject(operation))
+                continue;
+            entries.push({ documentPath, path: colonPath(documentPath), operationKey, operation, pathItem });
+        }
+    }
+    return entries;
+}
+function pointer(document, reference) {
+    let value = document;
+    for (const raw of reference.slice(2).split('/')) {
+        const key = raw.replaceAll('~1', '/').replaceAll('~0', '~');
+        if (!isObject(value) || !(key in value))
+            return undefined;
+        value = value[key];
+    }
+    return value;
+}
+/**
+ * Replace local `$ref`s by their targets. Siblings of a `$ref` (OpenAPI 3.1
+ * allows `description` next to it) win over the target's keys. A reference
+ * the generator cannot follow becomes `{}`, which accepts anything, and is
+ * named in `problems`.
+ */
+export function dereference(document, value) {
+    const problems = [];
+    const walk = (node, stack) => {
+        if (Array.isArray(node))
+            return node.map((item) => walk(item, stack));
+        if (!isObject(node))
+            return node;
+        const reference = node.$ref;
+        if (typeof reference === 'string') {
+            const siblings = Object.fromEntries(Object.entries(node).filter(([key]) => key !== '$ref'));
+            if (!reference.startsWith('#/')) {
+                problems.push(`external reference ${reference}`);
+                return walk(siblings, stack);
+            }
+            if (stack.includes(reference)) {
+                problems.push(`recursive reference ${reference}`);
+                return walk(siblings, stack);
+            }
+            if (stack.length >= MAX_REFERENCE_DEPTH) {
+                problems.push(`reference ${reference} nested deeper than ${MAX_REFERENCE_DEPTH}`);
+                return walk(siblings, stack);
+            }
+            const target = pointer(document, reference);
+            if (target === undefined) {
+                problems.push(`missing reference ${reference}`);
+                return walk(siblings, stack);
+            }
+            const resolved = walk(target, [...stack, reference]);
+            return { ...(isObject(resolved) ? resolved : {}), ...walk(siblings, stack) };
+        }
+        return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, walk(child, stack)]));
+    };
+    return { value: walk(value, []), problems: [...new Set(problems)].sort() };
+}
+/**
+ * The fingerprint of one operation: its dereferenced definition, the path
+ * item's parameters and the document's global security. Any change to the
+ * schemas the server validates changes it.
+ */
+export function operationFingerprint(document, entry, method, path) {
+    const subject = dereference(document, {
+        operation: entry.operation,
+        parameters: entry.pathItem.parameters ?? [],
+        security: document.security ?? null,
+    }).value;
+    return createRouteSourceFingerprint(JSON.stringify(sortKeysDeep(subject)), method, path);
+}
+//# sourceMappingURL=openapi-document.js.map

package/dist/codegen/openapi-document.js.map

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

package/dist/codegen/route-exports.d.ts

@@ -0,0 +1,13 @@
+import type { EndpointMethod } from '../types.js';
+export interface RouteExportFinding {
+    code: 'route-export-unresolved' | 'route-wildcard-export-unresolved' | 'route-source-invalid';
+    exportName?: EndpointMethod;
+}
+/** Read only local export syntax. Never import or execute the scanned application. */
+export declare function readRouteExports(source: string, fileName?: string): {
+    exports: Array<{
+        method: EndpointMethod;
+        body: string;
+    }>;
+    findings: RouteExportFinding[];
+};

package/dist/codegen/route-exports.js

@@ -0,0 +1,117 @@
+import ts from 'typescript';
+const methods = new Set(['GET', 'HEAD', 'POST', 'PUT', 'PATCH', 'DELETE']);
+/** Read only local export syntax. Never import or execute the scanned application. */
+export function readRouteExports(source, fileName = 'route.ts') {
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true);
+    // A recovery AST can contain a seemingly valid export in invalid source.
+    // Use the public diagnostic API with an in-memory host: no imports, libs,
+    // filesystem reads or evaluation of application code.
+    const program = ts.createProgram([file.fileName], { noLib: true, noResolve: true, noEmit: true, allowJs: true, jsx: ts.JsxEmit.Preserve }, {
+        getSourceFile: (name) => name === file.fileName ? file : undefined,
+        getDefaultLibFileName: () => '',
+        writeFile: () => { },
+        getCurrentDirectory: () => '',
+        getCanonicalFileName: (name) => name,
+        useCaseSensitiveFileNames: () => true,
+        getNewLine: () => '\n',
+        fileExists: (name) => name === file.fileName,
+        readFile: (name) => name === file.fileName ? source : undefined,
+    });
+    if (program.getSyntacticDiagnostics(file).length > 0) {
+        return { exports: [], findings: [{ code: 'route-source-invalid' }] };
+    }
+    const locals = new Map();
+    const exports = [];
+    const findings = [];
+    const hasModifier = (node, kind) => ts.canHaveModifiers(node) && ts.getModifiers(node)?.some((modifier) => modifier.kind === kind);
+    for (const statement of file.statements) {
+        if (ts.isFunctionDeclaration(statement) && statement.name) {
+            locals.set(statement.name.text, statement);
+        }
+        else if (ts.isVariableStatement(statement)) {
+            for (const declaration of statement.declarationList.declarations) {
+                if (ts.isIdentifier(declaration.name) && declaration.initializer) {
+                    locals.set(declaration.name.text, declaration.initializer);
+                }
+            }
+        }
+    }
+    const bodyOf = (node, seen = new Set()) => {
+        if (!node)
+            return undefined;
+        if (ts.isFunctionDeclaration(node) || ts.isFunctionExpression(node) || ts.isArrowFunction(node)) {
+            return node.body?.getText(file);
+        }
+        if (ts.isParenthesizedExpression(node) || ts.isAsExpression(node) || ts.isSatisfiesExpression(node)) {
+            return bodyOf(node.expression, seen);
+        }
+        if (ts.isIdentifier(node) && !seen.has(node.text)) {
+            seen.add(node.text);
+            return bodyOf(locals.get(node.text), seen);
+        }
+        return undefined;
+    };
+    const add = (name, node) => {
+        if (!methods.has(name))
+            return;
+        const method = name;
+        const body = bodyOf(node);
+        if (body === undefined) {
+            findings.push({ exportName: method, code: 'route-export-unresolved' });
+        }
+        else if (!exports.some((entry) => entry.method === method)) {
+            exports.push({ method, body });
+        }
+    };
+    const unresolvedBinding = (name) => {
+        if (ts.isIdentifier(name)) {
+            add(name.text);
+        }
+        else {
+            for (const element of name.elements) {
+                if (!ts.isOmittedExpression(element))
+                    unresolvedBinding(element.name);
+            }
+        }
+    };
+    for (const statement of file.statements) {
+        if (hasModifier(statement, ts.SyntaxKind.DefaultKeyword))
+            continue;
+        if (ts.isExportDeclaration(statement)) {
+            if (statement.isTypeOnly)
+                continue;
+            if (!statement.exportClause) {
+                findings.push({ code: 'route-wildcard-export-unresolved' });
+            }
+            else if (ts.isNamedExports(statement.exportClause)) {
+                for (const element of statement.exportClause.elements) {
+                    if (element.isTypeOnly)
+                        continue;
+                    add(element.name.text, statement.moduleSpecifier
+                        ? undefined
+                        : locals.get((element.propertyName ?? element.name).text));
+                }
+            }
+            else if (ts.isNamespaceExport(statement.exportClause)) {
+                add(statement.exportClause.name.text);
+            }
+        }
+        else if (hasModifier(statement, ts.SyntaxKind.ExportKeyword)) {
+            if (ts.isFunctionDeclaration(statement) && statement.name) {
+                add(statement.name.text, locals.get(statement.name.text));
+            }
+            else if (ts.isVariableStatement(statement)) {
+                for (const declaration of statement.declarationList.declarations) {
+                    if (ts.isIdentifier(declaration.name)) {
+                        add(declaration.name.text, declaration.initializer);
+                    }
+                    else {
+                        unresolvedBinding(declaration.name);
+                    }
+                }
+            }
+        }
+    }
+    return { exports, findings };
+}
+//# sourceMappingURL=route-exports.js.map

package/dist/codegen/route-exports.js.map

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

package/dist/codegen/route-fingerprint.d.ts

@@ -0,0 +1,2 @@
+import type { EndpointMethod } from '../types.js';
+export declare function createRouteSourceFingerprint(source: string, method: EndpointMethod, path: string): string;