@gate-forge/http-contract 0.1.0

package/dist/join.js

@@ -0,0 +1,280 @@
+/**
+ * Deterministic one-to-one join engine (ADR 0004 D3).
+ *
+ * A frontend consumption exists only when one frontend-call fact joins
+ * exactly one distinct backend route identity: equal uppercase method,
+ * position-wise segment match where a frontend `{}` matches any single
+ * route segment (param or literal) and a trailing route `{*}` matches one
+ * or more trailing call segments.
+ *
+ * LITERAL PRECEDENCE (phase 3 refinement). Positional candidates are
+ * partitioned by match quality before the exactly-one check:
+ *
+ *  - A match is *literal* when it consumed no slot generality: every
+ *    matched position is exact segment equality — literal==literal, or the
+ *    call's own `{}` mirrored by the route's `{}` (the route then declares
+ *    exactly the shape the call already has; nothing is absorbed beyond
+ *    what the call itself carries).
+ *  - A match is *parameter* otherwise: a route `{}` absorbed a call
+ *    literal, a call `{}` was relaxed onto a route literal, or any `{*}`
+ *    absorption happened. A wildcard match is never a literal match.
+ *
+ * If any literal matches exist they are THE candidates; parameter-only
+ * matches are considered only when zero literal matches exist. This
+ * mirrors runtime routing truth: FastAPI — like every major router —
+ * resolves literal path segments before parameterized ones, so a request
+ * to `/messages/search` always hits the literal route and never reaches
+ * `/messages/{}` with id="search". The static join must agree: a
+ * template call `/messages/${id}` joins `/messages/{}` despite literal
+ * siblings, and a literal call `/messages/unread-count` joins only the
+ * literal route.
+ *
+ * Never guess: zero selected candidates and multiple distinct selected
+ * candidates (in either tier) are typed blocks — there is no scoring, no
+ * fuzzy distance, and no first-match-wins beyond the documented partition.
+ *
+ * The result is a pure function of the input facts: identical inputs in
+ * any permutation produce byte-identical output (total order everywhere).
+ */
+import { createHash } from 'node:crypto';
+import { FRONTEND_ROUTE_AMBIGUOUS, FRONTEND_ROUTE_UNWIRED, HTTP_METHOD_DYNAMIC, } from './codes.js';
+import { HTTP_PARAM_SLOT, HTTP_WILDCARD_SLOT, pathSegments } from './normalize.js';
+/** Canonical identity string for a method/path pair. */
+export function canonicalEndpointIdentity(method, canonicalPath) {
+    return `${method} ${canonicalPath}`;
+}
+/**
+ * Deterministic, collision-safe endpoint resource name (ADR 0004 D1):
+ * `http-<method>-<path-slug>-<sha8>`. The slug keeps reports readable; the
+ * identity hash suffix makes distinct endpoints collision-free even when
+ * sanitization would coincide (dot vs dash), and is invariant under
+ * parameter-name changes because it hashes the canonical form.
+ */
+export function endpointResourceName(method, canonicalPath) {
+    const identity = canonicalEndpointIdentity(method, canonicalPath);
+    const slug = canonicalPath
+        .split('/')
+        .filter((segment) => segment !== '')
+        .map((segment) => {
+        if (segment === HTTP_PARAM_SLOT)
+            return 'param';
+        if (segment === HTTP_WILDCARD_SLOT)
+            return 'wildcard';
+        return segment
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '');
+    })
+        .filter((segment) => segment !== '')
+        .join('-');
+    const hash = createHash('sha256').update(identity).digest('hex').slice(0, 8);
+    const base = slug.length > 0 ? slug : 'root';
+    return `http-${method.toLowerCase()}-${base}-${hash}`;
+}
+/** Positional segment match for a route without a trailing wildcard. */
+function segmentsMatchExact(routeSegments, callSegments) {
+    if (routeSegments.length !== callSegments.length)
+        return false;
+    for (let index = 0; index < routeSegments.length; index += 1) {
+        const routeSegment = routeSegments[index] ?? '';
+        const callSegment = callSegments[index] ?? '';
+        if (routeSegment === callSegment)
+            continue; // literal==literal or slot==slot
+        if (routeSegment === HTTP_PARAM_SLOT)
+            continue; // backend param matches any call segment
+        if (callSegment === HTTP_PARAM_SLOT)
+            continue; // frontend slot matches any route segment
+        return false;
+    }
+    return true;
+}
+/**
+ * Wildcard rule (ADR 0004 D3, the only one): a trailing route `{*}`
+ * matches one or more trailing call segments; everything before it must
+ * match positionally. Non-trailing wildcards never join.
+ */
+function segmentsMatchWildcard(routeSegments, callSegments) {
+    const wildcardIndex = routeSegments.length - 1;
+    if (callSegments.length < routeSegments.length)
+        return false; // needs >=1 absorbed segment
+    for (let index = 0; index < wildcardIndex; index += 1) {
+        const routeSegment = routeSegments[index] ?? '';
+        const callSegment = callSegments[index] ?? '';
+        if (routeSegment === callSegment)
+            continue;
+        if (routeSegment === HTTP_PARAM_SLOT)
+            continue;
+        if (callSegment === HTTP_PARAM_SLOT)
+            continue;
+        return false;
+    }
+    return true;
+}
+/**
+ * Classifies one call/route pair by match quality, or returns `null` when
+ * the pair does not match under the documented positional rules. Pure and
+ * order-independent; `routeMatchesCall` is exactly `kind !== null`.
+ */
+export function routeMatchKind(route, call) {
+    if (route.method === 'ANY' || call.method === 'ANY')
+        return null;
+    if (route.method !== call.method)
+        return null;
+    const routeSegments = pathSegments(route.normalizedPath);
+    const callSegments = pathSegments(call.normalizedPath);
+    if (routeSegments.length === 0 || callSegments.length === 0) {
+        // Root matches root, and only root: a vacuous all-literal match.
+        return routeSegments.length === 0 && callSegments.length === 0 ? 'literal' : null;
+    }
+    const wildcard = routeSegments[routeSegments.length - 1] === HTTP_WILDCARD_SLOT;
+    if (wildcard) {
+        // Absorption is generality, not equality — see the wildcard rule and
+        // the LITERAL PRECEDENCE note in the module docstring.
+        return segmentsMatchWildcard(routeSegments, callSegments) ? 'parameter' : null;
+    }
+    if (!segmentsMatchExact(routeSegments, callSegments))
+        return null;
+    for (let index = 0; index < routeSegments.length; index += 1) {
+        // Any position where the strings differ (route `{}` vs call literal,
+        // or call `{}` vs route literal) consumed slot generality.
+        if (routeSegments[index] !== callSegments[index])
+            return 'parameter';
+    }
+    return 'literal';
+}
+/** Whether one call fact can join one route fact at all. */
+export function routeMatchesCall(route, call) {
+    return routeMatchKind(route, call) !== null;
+}
+/**
+ * Joins frontend-call facts against server-route facts.
+ *
+ * Candidate selection applies LITERAL PRECEDENCE (see the module
+ * docstring): literal matches shadow parameter matches, mirroring how
+ * routers resolve literal segments before parameterized ones at runtime.
+ *
+ * `ANY` routes participate in the inventory (they carry exposure evidence)
+ * but never join: a catch-all registration cannot prove which concrete
+ * method the frontend exercised. Calls with a non-concrete method produce
+ * `HTTP_METHOD_DYNAMIC` blocks.
+ */
+export function joinFrontendCalls(routes, calls) {
+    const byIdentity = new Map();
+    for (const route of routes) {
+        if (route.role !== 'server-route' || route.method === 'ANY')
+            continue;
+        const identity = canonicalEndpointIdentity(route.method, route.normalizedPath);
+        const entry = byIdentity.get(identity);
+        if (entry) {
+            pushUniqueFact(entry.routes, route);
+        }
+        else {
+            byIdentity.set(identity, { identity, routes: [route], calls: [] });
+        }
+    }
+    const blocks = [];
+    const seenBlockKeys = new Set();
+    for (const call of calls) {
+        if (call.role !== 'frontend-call')
+            continue;
+        if (call.method === 'ANY') {
+            pushBlock(blocks, seenBlockKeys, {
+                code: HTTP_METHOD_DYNAMIC,
+                detail: `frontend call to '${call.rawPath}' has no statically provable method`,
+                location: call.source,
+                candidates: [],
+            });
+            continue;
+        }
+        // Step 1 — all positional candidates, computed exactly as before.
+        const candidates = [];
+        for (const entry of byIdentity.values()) {
+            const route = entry.routes[0];
+            if (!route)
+                continue;
+            const kind = routeMatchKind(route, call);
+            if (kind !== null)
+                candidates.push({ entry, kind });
+        }
+        if (candidates.length === 0) {
+            pushBlock(blocks, seenBlockKeys, {
+                code: FRONTEND_ROUTE_UNWIRED,
+                detail: `frontend call '${call.method} ${call.rawPath}' matches no backend route`,
+                location: call.source,
+                candidates: [],
+            });
+            continue;
+        }
+        // Steps 2/3 — LITERAL PRECEDENCE partition. Literal matches shadow
+        // parameter matches because routers (FastAPI included) resolve literal
+        // segments before parameterized ones at runtime; a wildcard match is a
+        // parameter match and never shadows. Parameter-only candidates keep
+        // today's behavior. No scoring: the partition is all-or-nothing.
+        const selected = candidates.some((candidate) => candidate.kind === 'literal')
+            ? candidates.filter((candidate) => candidate.kind === 'literal')
+            : candidates;
+        const distinct = new Map();
+        for (const { entry } of selected) {
+            const route = entry.routes[0];
+            if (route)
+                distinct.set(entry.identity, entry);
+        }
+        if (distinct.size > 1) {
+            pushBlock(blocks, seenBlockKeys, {
+                code: FRONTEND_ROUTE_AMBIGUOUS,
+                detail: `frontend call '${call.method} ${call.rawPath}' matches ${distinct.size} distinct backend routes`,
+                location: call.source,
+                candidates: [...distinct.keys()].sort(compareStrings),
+            });
+            continue;
+        }
+        const matched = selected[0]?.entry;
+        if (matched) {
+            pushUniqueFact(matched.calls, call);
+        }
+    }
+    const endpoints = [...byIdentity.values()]
+        .filter((entry) => entry.calls.length > 0)
+        .map((entry) => {
+        const route = entry.routes[0];
+        const method = route?.method ?? 'GET';
+        return {
+            method,
+            canonicalPath: route?.normalizedPath ?? '/',
+            identity: entry.identity,
+            resourceName: endpointResourceName(method, route?.normalizedPath ?? '/'),
+            routes: sortFacts(entry.routes),
+            calls: sortFacts(entry.calls),
+        };
+    })
+        .sort((a, b) => compareStrings(a.identity, b.identity));
+    return { endpoints, blocks: sortBlocks(blocks) };
+}
+function pushUniqueFact(list, fact) {
+    const key = JSON.stringify(fact);
+    if (!list.some((existing) => JSON.stringify(existing) === key))
+        list.push(fact);
+}
+function pushBlock(list, seen, block) {
+    const key = JSON.stringify([block.code, block.detail, block.location, block.candidates]);
+    if (seen.has(key))
+        return;
+    seen.add(key);
+    list.push(block);
+}
+function sortFacts(facts) {
+    return [...facts].sort((a, b) => compareStrings(JSON.stringify(a), JSON.stringify(b)));
+}
+function sortBlocks(blocks) {
+    return [...blocks].sort((a, b) => compareStrings(a.location.file, b.location.file) ||
+        (a.location.line || 0) - (b.location.line || 0) ||
+        (a.location.col || 0) - (b.location.col || 0) ||
+        compareStrings(a.code, b.code) ||
+        compareStrings(a.detail, b.detail));
+}
+function compareStrings(a, b) {
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+//# sourceMappingURL=join.js.map

package/dist/join.js.map

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

package/dist/linkage.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Path-derived business-resource name candidate (ADR 0004 D5).
+ *
+ * Mirrors `resourceNameFromPath` in pack-http and the fastapi wrapper:
+ * the LAST non-empty, non-parameter, non-numeric path segment,
+ * lower-cased, extension stripped, dashes normalized to underscores
+ * (kebab-case route segments derive their snake_case form, e.g.
+ * `/email-accounts/{id}` derives `email_accounts`). This is a
+ * NON-AUTHORITATIVE linkage
+ * CANDIDATE only — the endpoint compiler links an endpoint to a business
+ * resource solely when the derived name matches exactly one discovered
+ * business resource; ambiguity is `ENDPOINT_RESOURCE_LINK_UNRESOLVED`.
+ */
+export declare function derivePathResourceName(rawPath: string): string | null;
+//# sourceMappingURL=linkage.d.ts.map

package/dist/linkage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkage.d.ts","sourceRoot":"","sources":["../src/linkage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBrE"}

package/dist/linkage.js

@@ -0,0 +1,38 @@
+/**
+ * Path-derived business-resource name candidate (ADR 0004 D5).
+ *
+ * Mirrors `resourceNameFromPath` in pack-http and the fastapi wrapper:
+ * the LAST non-empty, non-parameter, non-numeric path segment,
+ * lower-cased, extension stripped, dashes normalized to underscores
+ * (kebab-case route segments derive their snake_case form, e.g.
+ * `/email-accounts/{id}` derives `email_accounts`). This is a
+ * NON-AUTHORITATIVE linkage
+ * CANDIDATE only — the endpoint compiler links an endpoint to a business
+ * resource solely when the derived name matches exactly one discovered
+ * business resource; ambiguity is `ENDPOINT_RESOURCE_LINK_UNRESOLVED`.
+ */
+export function derivePathResourceName(rawPath) {
+    const withoutTail = rawPath.split('?')[0]?.split('#')[0] ?? rawPath;
+    const segments = withoutTail.split('/').filter((segment) => segment !== '');
+    for (let index = segments.length - 1; index >= 0; index -= 1) {
+        const segment = segments[index] ?? '';
+        if (segment.startsWith(':') || segment.startsWith('{') || segment.startsWith('*'))
+            continue;
+        if (/^\d+$/.test(segment))
+            continue;
+        if (segment.includes('$') && segment.includes('{'))
+            continue; // unresolved slot
+        const cleaned = segment.replace(/\.(json|xml|txt|html)$/i, '');
+        if (cleaned.length === 0)
+            continue;
+        // Dash→underscore NAME-FORM normalization only: kebab-case route
+        // segments must derive the snake_case form so the candidate can link
+        // an existing snake_case resource. Fail-closed doctrine: this never
+        // guesses a plane, mints a new identity, or widens matching — a
+        // candidate that names no discovered resource stays unlinked exactly
+        // as before.
+        return cleaned.toLowerCase().replaceAll('-', '_');
+    }
+    return null;
+}
+//# sourceMappingURL=linkage.js.map

package/dist/linkage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkage.js","sourceRoot":"","sources":["../src/linkage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACpE,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IAC5E,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5F,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,SAAS;QACpC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,kBAAkB;QAChF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,iEAAiE;QACjE,qEAAqE;QACrE,oEAAoE;QACpE,gEAAgE;QAChE,qEAAqE;QACrE,aAAa;QACb,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Canonical HTTP path and method normalization (ADR 0004 D2).
+ *
+ * Total and deterministic: the same input always yields the same result,
+ * and the canonical form is invariant under parameter-name changes
+ * (`/accounts/{account_id}` and `/accounts/{id}` both canonicalize to
+ * `/accounts/{}`). There is no fuzzy matching here — unresolvable shapes
+ * return a typed `HTTP_PATH_DYNAMIC` outcome instead of a best effort.
+ */
+import type { HttpMethod } from './schema.js';
+/** Canonical single-segment positional parameter slot. */
+export declare const HTTP_PARAM_SLOT = "{}";
+/** Canonical wildcard slot (FastAPI `{name:path}` converters, `*` catch-alls). */
+export declare const HTTP_WILDCARD_SLOT = "{*}";
+export declare const NormalizeDynamicCode = "HTTP_PATH_DYNAMIC";
+export interface NormalizePathOk {
+    ok: true;
+    /** Canonical path: leading `/`, no trailing slash (except root), no query/fragment, positional slots. */
+    canonical: string;
+    /** True when the path contains at least one positional or wildcard slot. */
+    hasParameters: boolean;
+}
+export interface NormalizePathDynamic {
+    ok: false;
+    code: typeof NormalizeDynamicCode;
+    detail: string;
+}
+export type NormalizePathResult = NormalizePathOk | NormalizePathDynamic;
+export interface NormalizePathOptions {
+    /**
+     * Hosts whose absolute URLs are treated as same-origin: their path
+     * portion is canonicalized. Hosts are matched case-insensitively and
+     * without port normalization (declare exactly what you deploy).
+     */
+    sameOriginHosts?: readonly string[];
+}
+/**
+ * Normalizes one raw path expression to canonical positional form.
+ *
+ * Rules (ADR 0004 D2), applied in order:
+ *  1. strip query (`?...`) and fragment (`#...`);
+ *  2. collapse duplicate slashes, ensure one leading slash, strip trailing
+ *     slashes (root `/` stays `/`);
+ *  3. `${...}` template expressions become `{}`;
+ *  4. FastAPI `{name}` / `{name:type}` params become `{}` (names are not
+ *     identity); `{name:path}` converters become `{*}`;
+ *  5. bare `*` / `*name` catch-all segments become `{*}`;
+ *  6. absolute URLs canonicalize only for configured same-origin hosts —
+ *     anything else is a typed dynamic outcome, never host-stripped;
+ *  7. `..` escape segments are rejected.
+ */
+export declare function normalizeHttpPath(rawPath: string, options?: NormalizePathOptions): NormalizePathResult;
+/**
+ * Normalizes one raw method expression. Returns `null` for dynamic or
+ * unknown methods — the caller must emit `HTTP_METHOD_DYNAMIC`; defaulting
+ * to `GET` is forbidden (ADR 0004 D2 rule 7).
+ */
+export declare function normalizeHttpMethod(rawMethod: string): HttpMethod | null;
+/** Splits a canonical path into segments (empty segments dropped). */
+export declare function pathSegments(canonicalPath: string): string[];
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,0DAA0D;AAC1D,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,eAAO,MAAM,oBAAoB,sBAAoB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,IAAI,CAAC;IACT,yGAAyG;IACzG,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,OAAO,oBAAoB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAwErB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAKxE;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D"}

package/dist/normalize.js

@@ -0,0 +1,145 @@
+/**
+ * Canonical HTTP path and method normalization (ADR 0004 D2).
+ *
+ * Total and deterministic: the same input always yields the same result,
+ * and the canonical form is invariant under parameter-name changes
+ * (`/accounts/{account_id}` and `/accounts/{id}` both canonicalize to
+ * `/accounts/{}`). There is no fuzzy matching here — unresolvable shapes
+ * return a typed `HTTP_PATH_DYNAMIC` outcome instead of a best effort.
+ */
+import { HTTP_PATH_DYNAMIC } from './codes.js';
+/** Canonical single-segment positional parameter slot. */
+export const HTTP_PARAM_SLOT = '{}';
+/** Canonical wildcard slot (FastAPI `{name:path}` converters, `*` catch-alls). */
+export const HTTP_WILDCARD_SLOT = '{*}';
+export const NormalizeDynamicCode = HTTP_PATH_DYNAMIC;
+const ABSOLUTE_URL_RE = /^https?:\/\/([^/?#\s]+)/i;
+/**
+ * Normalizes one raw path expression to canonical positional form.
+ *
+ * Rules (ADR 0004 D2), applied in order:
+ *  1. strip query (`?...`) and fragment (`#...`);
+ *  2. collapse duplicate slashes, ensure one leading slash, strip trailing
+ *     slashes (root `/` stays `/`);
+ *  3. `${...}` template expressions become `{}`;
+ *  4. FastAPI `{name}` / `{name:type}` params become `{}` (names are not
+ *     identity); `{name:path}` converters become `{*}`;
+ *  5. bare `*` / `*name` catch-all segments become `{*}`;
+ *  6. absolute URLs canonicalize only for configured same-origin hosts —
+ *     anything else is a typed dynamic outcome, never host-stripped;
+ *  7. `..` escape segments are rejected.
+ */
+export function normalizeHttpPath(rawPath, options = {}) {
+    if (typeof rawPath !== 'string' || rawPath.length === 0) {
+        return dynamic('path is empty');
+    }
+    let working = rawPath;
+    const absolute = ABSOLUTE_URL_RE.exec(working);
+    if (absolute !== null) {
+        const host = (absolute[1] ?? '').toLowerCase();
+        const allowed = (options.sameOriginHosts ?? []).some((candidate) => candidate.toLowerCase() === host);
+        if (!allowed) {
+            return dynamic(`absolute URL host '${host}' is not a configured same-origin host`);
+        }
+        const pathStart = working.indexOf('/', absolute.index + absolute[0].length - host.length);
+        working = pathStart === -1 ? '/' : working.slice(pathStart);
+    }
+    else if (!working.startsWith('/')) {
+        // Relative expressions have no statically knowable base; resolving
+        // them would be a guess (ADR 0004 D2 rule 6).
+        return dynamic(`path '${rawPath}' is neither path-absolute nor a configured same-origin URL`);
+    }
+    // 1. query/fragment strip (first occurrence wins; inside-template edge
+    // cases are the detector's responsibility — facts carry resolved paths).
+    const queryStart = findFirstOutsideTemplate(working, ['?', '#']);
+    if (queryStart !== -1) {
+        working = working.slice(0, queryStart);
+    }
+    // 2. slash normalization. Trailing slashes are NOT significant: runtime
+    //    frameworks treat `/api/v2/accounts` and `/api/v2/accounts/` as the
+    //    same resource (routers normalize or redirect-accept the variant),
+    //    so the canonical form strips them and the static join mirrors that
+    //    equivalence — a frontend call written with a trailing slash still
+    //    joins the route declared without one. The root `/` is the bare
+    //    resource and stays.
+    working = working.replace(/\/{2,}/g, '/');
+    if (!working.startsWith('/')) {
+        working = `/${working}`;
+    }
+    if (working.length > 1) {
+        working = working.replace(/\/+$/, '');
+    }
+    if (working === '') {
+        working = '/';
+    }
+    // 3. template expressions -> positional slots.
+    working = working.replace(/\$\{[^}]*\}/g, HTTP_PARAM_SLOT);
+    // 4/5. FastAPI params, typed converters, catch-all segments.
+    const segments = working.split('/').map((segment) => {
+        if (segment === '*' || /^\*[\w:.-]*$/.test(segment))
+            return HTTP_WILDCARD_SLOT;
+        const param = /^\{([^{}]+)\}$/.exec(segment);
+        if (param === null)
+            return segment;
+        // `{name:path}` converters absorb one-or-more trailing segments;
+        // every other `{name}` / `{name:type}` form is a single positional slot.
+        return (param[1] ?? '').endsWith(':path') ? HTTP_WILDCARD_SLOT : HTTP_PARAM_SLOT;
+    });
+    working = segments.join('/');
+    // 7. escape rejection — after normalization so the message quotes the
+    // canonical shape the detector would have relied on.
+    if (segments.includes('..')) {
+        return dynamic(`path '${rawPath}' contains a '..' escape segment`);
+    }
+    const hasParameters = working.includes(HTTP_PARAM_SLOT) || working.includes(HTTP_WILDCARD_SLOT);
+    return { ok: true, canonical: working, hasParameters };
+}
+/**
+ * Normalizes one raw method expression. Returns `null` for dynamic or
+ * unknown methods — the caller must emit `HTTP_METHOD_DYNAMIC`; defaulting
+ * to `GET` is forbidden (ADR 0004 D2 rule 7).
+ */
+export function normalizeHttpMethod(rawMethod) {
+    const upper = rawMethod.trim().toUpperCase();
+    if (upper === 'ANY' || upper === '*')
+        return 'ANY';
+    if (HTTP_METHOD_SET.has(upper))
+        return upper;
+    return null;
+}
+/** Splits a canonical path into segments (empty segments dropped). */
+export function pathSegments(canonicalPath) {
+    return canonicalPath.split('/').filter((segment) => segment !== '');
+}
+const HTTP_METHOD_SET = new Set([
+    'GET',
+    'HEAD',
+    'POST',
+    'PUT',
+    'PATCH',
+    'DELETE',
+    'OPTIONS',
+]);
+function dynamic(detail) {
+    return { ok: false, code: NormalizeDynamicCode, detail };
+}
+/** Finds the first index of any of `chars` outside a `${...}` template. */
+function findFirstOutsideTemplate(input, chars) {
+    let depth = 0;
+    for (let index = 0; index < input.length; index += 1) {
+        const char = input[index] ?? '';
+        if (char === '$' && input[index + 1] === '{') {
+            depth += 1;
+            index += 1;
+            continue;
+        }
+        if (depth > 0 && char === '}') {
+            depth -= 1;
+            continue;
+        }
+        if (depth === 0 && chars.includes(char))
+            return index;
+    }
+    return -1;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AA2BtD,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,UAAgC,EAAE;IAElC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,GAAG,OAAO,CAAC;IAEtB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,CAClD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,IAAI,CAChD,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,sBAAsB,IAAI,wCAAwC,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1F,OAAO,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;SAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,mEAAmE;QACnE,8CAA8C;QAC9C,OAAO,OAAO,CAAC,SAAS,OAAO,6DAA6D,CAAC,CAAC;IAChG,CAAC;IAED,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACjE,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,uEAAuE;IACvE,wEAAwE;IACxE,uEAAuE;IACvE,oEAAoE;IACpE,yBAAyB;IACzB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,GAAG,GAAG,CAAC;IAChB,CAAC;IAED,+CAA+C;IAC/C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAE3D,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAU,EAAE;QAC1D,IAAI,OAAO,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,kBAAkB,CAAC;QAC/E,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;QACnC,iEAAiE;QACjE,yEAAyE;QACzE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC;IACnF,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE7B,sEAAsE;IACtE,qDAAqD;IACrD,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,SAAS,OAAO,kCAAkC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,aAAa,GACjB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC5E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAmB,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,aAAqB;IAChD,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC;IACnD,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,SAAS;CACV,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,MAAc;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED,2EAA2E;AAC3E,SAAS,wBAAwB,CAAC,KAAa,EAAE,KAAwB;IACvE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAW,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC7C,KAAK,IAAI,CAAC,CAAC;YACX,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC9B,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}