@relkit/compiler 0.0.0

package/dist/discovery/extract.js

@@ -0,0 +1,60 @@
+import { createSourceLocation, normalizeSourcePath } from "@relkit/contracts";
+import { mapSourceLocations, } from "./source-map.js";
+import { resolve } from "node:path";
+/** Extracts only evaluator snapshots and data-only executable reference instructions. */
+export function extractDescriptors(input, options = {}) {
+    const response = isResponse(input);
+    const modules = response ? input.modules : input;
+    const generationId = response ? input.generationId : (options.generationId ?? "unknown");
+    const root = resolveRoot(options.projectRoot);
+    const sourceMap = options.sourceMap ?? mapSourceLocations(modules, { ...options, projectRoot: root });
+    const locations = new Map(sourceMap.map((entry) => [entryKey(entry.module, entry.exportName), entry]));
+    const extracted = [...modules]
+        .sort((left, right) => left.file.localeCompare(right.file))
+        .flatMap((module) => [...module.exports]
+        .sort((left, right) => left.exportName.localeCompare(right.exportName))
+        .map((exported) => {
+        const moduleFile = normalizeSourcePath(module.file, root);
+        const sourceEntry = locations.get(entryKey(moduleFile, exported.exportName));
+        const location = sourceEntry?.source ?? createSourceLocation(moduleFile, 1, 1, root);
+        const reference = findReference(module, exported, generationId);
+        return Object.freeze({
+            descriptor: exported.descriptor,
+            exportName: exported.exportName,
+            exportKind: exportKind(exported.exportName),
+            source: Object.freeze(location),
+            ...(sourceEntry?.facts === undefined ? {} : { facts: sourceEntry.facts }),
+            ...(sourceEntry?.exportFact === undefined
+                ? {}
+                : { exportFact: sourceEntry.exportFact }),
+            reference: Object.freeze(reference),
+        });
+    }));
+    return Object.freeze(extracted);
+}
+function findReference(module, exported, generationId) {
+    const existing = module.manifestReferences.find((reference) => reference.module === module.file &&
+        reference.exportName === exported.exportName &&
+        reference.descriptorId === exported.descriptor.id &&
+        reference.kind === exported.descriptor.kind);
+    return (existing ?? {
+        generationId,
+        descriptorId: exported.descriptor.id,
+        kind: exported.descriptor.kind,
+        module: module.file,
+        exportName: exported.exportName,
+    });
+}
+function entryKey(module, exportName) {
+    return `${module}\0${exportName}`;
+}
+function exportKind(name) {
+    return name === "default" ? "default" : "named";
+}
+function resolveRoot(projectRoot) {
+    return resolve(projectRoot ?? process.cwd());
+}
+function isResponse(input) {
+    return !Array.isArray(input);
+}
+//# sourceMappingURL=extract.js.map

package/dist/discovery/extract.js.map

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

package/dist/discovery/source-facts-factory.d.ts

@@ -0,0 +1,5 @@
+import * as ts from "typescript";
+import type { FactoryBindingFact, ServiceMemberFact } from "./source-facts-types.js";
+export declare function factoryFor(initializer: ts.Expression | undefined, binding: string | undefined, position: number): FactoryBindingFact | undefined;
+export declare function membersFor(factory: FactoryBindingFact, initializer: ts.Expression | undefined, sourceFile: ts.SourceFile): readonly ServiceMemberFact[];
+//# sourceMappingURL=source-facts-factory.d.ts.map

package/dist/discovery/source-facts-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-facts-factory.d.ts","sourceRoot":"","sources":["../../src/discovery/source-facts-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EACV,kBAAkB,EAElB,iBAAiB,EAElB,MAAM,yBAAyB,CAAC;AA6BjC,wBAAgB,UAAU,CACxB,WAAW,EAAE,EAAE,CAAC,UAAU,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,SAAS,CAchC;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,EAAE,CAAC,UAAU,GAAG,SAAS,EACtC,UAAU,EAAE,EAAE,CAAC,UAAU,GACxB,SAAS,iBAAiB,EAAE,CAwB9B"}

package/dist/discovery/source-facts-factory.js

@@ -0,0 +1,109 @@
+import * as ts from "typescript";
+const FACTORIES = Object.freeze({
+    defineConfig: { kind: "app", idOptional: true },
+    defineConstants: { kind: "constants", idOptional: true },
+    definePrompt: { kind: "prompt", idOptional: true },
+    defineDataModel: { kind: "data-model", idOptional: true },
+    defineFunction: { kind: "function", idOptional: true },
+    defineError: { kind: "error", idOptional: true },
+    defineRoute: { kind: "route", idOptional: true },
+    defineJob: { kind: "job", idOptional: false },
+    defineEvent: { kind: "event", idOptional: false },
+    onEvent: { kind: "event-trigger", idOptional: false },
+    defineBucket: { kind: "bucket", idOptional: false },
+    defineCache: { kind: "cache", idOptional: false },
+    defineTool: { kind: "tool", idOptional: true },
+    defineAgent: { kind: "agent", idOptional: true },
+    defineMiddleware: { kind: "middleware", idOptional: true },
+    defineService: { kind: "service", idOptional: true },
+    defineServiceMiddleware: { kind: "service-middleware", idOptional: true },
+    defineTransform: { kind: "transform", idOptional: true },
+    defineRequestTransform: { kind: "transform", idOptional: true },
+});
+export function factoryFor(initializer, binding, position) {
+    const call = unwrap(initializer);
+    if (!call || !ts.isCallExpression(call))
+        return undefined;
+    const factory = lastSegment(call.expression);
+    const definition = factory === undefined ? undefined : FACTORIES[factory];
+    if (definition === undefined || factory === undefined)
+        return undefined;
+    return Object.freeze({
+        ...(binding === undefined ? {} : { binding }),
+        factory,
+        kind: definition.kind,
+        idOptional: definition.idOptional,
+        id: idPresence(call.arguments[0]),
+        position,
+    });
+}
+export function membersFor(factory, initializer, sourceFile) {
+    if (factory.kind !== "service" || factory.binding === undefined)
+        return [];
+    const call = unwrap(initializer);
+    const options = call && ts.isCallExpression(call) ? unwrap(call.arguments[0]) : undefined;
+    if (!options || !ts.isObjectLiteralExpression(options))
+        return [];
+    const functions = options.properties.find((property) => propertyName(property.name) === "functions");
+    if (!functions || !ts.isPropertyAssignment(functions))
+        return [];
+    const map = unwrap(functions.initializer);
+    if (!map || !ts.isObjectLiteralExpression(map))
+        return [];
+    return map.properties.flatMap((property) => {
+        const member = propertyName(property.name);
+        if (member === undefined || ts.isSpreadAssignment(property))
+            return [];
+        const targetBinding = memberTarget(property);
+        return [
+            Object.freeze({
+                service: factory.binding,
+                member,
+                ...(targetBinding === undefined ? {} : { targetBinding }),
+                position: property.name?.getStart(sourceFile) ?? property.getStart(sourceFile),
+            }),
+        ];
+    });
+}
+function memberTarget(property) {
+    if (ts.isShorthandPropertyAssignment(property))
+        return property.name.text;
+    return ts.isPropertyAssignment(property) && ts.isIdentifier(property.initializer)
+        ? property.initializer.text
+        : undefined;
+}
+function idPresence(argument) {
+    const value = unwrap(argument);
+    if (!value || !ts.isObjectLiteralExpression(value))
+        return "unknown";
+    return value.properties.some((property) => propertyName(property.name) === "id")
+        ? "explicit"
+        : "omitted";
+}
+function propertyName(name) {
+    if (name === undefined)
+        return undefined;
+    if (ts.isIdentifier(name) || ts.isStringLiteralLike(name) || ts.isNumericLiteral(name)) {
+        return name.text;
+    }
+    return undefined;
+}
+function lastSegment(expression) {
+    if (ts.isIdentifier(expression))
+        return expression.text;
+    if (ts.isPropertyAccessExpression(expression))
+        return expression.name.text;
+    return undefined;
+}
+function unwrap(value) {
+    let current = value;
+    while (current !== undefined &&
+        (ts.isParenthesizedExpression(current) ||
+            ts.isAsExpression(current) ||
+            ts.isTypeAssertionExpression(current) ||
+            ts.isSatisfiesExpression(current))) {
+        current = current.expression;
+    }
+    return current;
+}
+//# sourceMappingURL=source-facts-factory.js.map

package/dist/discovery/source-facts-factory.js.map

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

package/dist/discovery/source-facts-types.d.ts

@@ -0,0 +1,52 @@
+import type { DescriptorKind } from "@relkit/contracts";
+export type SourceFactoryKind = DescriptorKind | "error" | "middleware" | "service-middleware" | "transform";
+export type FactoryIdPresence = "explicit" | "omitted" | "unknown";
+export interface FactoryBindingFact {
+    readonly binding?: string;
+    readonly factory: string;
+    readonly kind: SourceFactoryKind;
+    readonly idOptional: boolean;
+    readonly id: FactoryIdPresence;
+    readonly position: number;
+}
+export interface RouteOperationFact {
+    readonly exportName: string;
+    readonly method: string;
+    readonly binding?: string;
+    readonly position: number;
+}
+export interface ServiceMemberFact {
+    readonly service: string;
+    readonly member: string;
+    readonly targetBinding?: string;
+    readonly position: number;
+}
+export interface ErrorBindingFact {
+    readonly binding: string;
+    readonly position: number;
+    readonly id: FactoryIdPresence;
+}
+export interface ExportFact {
+    readonly position: number;
+    readonly binding?: string;
+    readonly factory?: FactoryBindingFact;
+    readonly routeOperation?: RouteOperationFact;
+    readonly errorBinding?: ErrorBindingFact;
+    readonly origin?: {
+        readonly module: string;
+        readonly name: string;
+    };
+}
+export interface ExportFacts {
+    readonly exports: ReadonlyMap<string, ExportFact>;
+    readonly stars: readonly {
+        readonly module: string;
+        readonly position: number;
+    }[];
+    readonly factoryBindings: readonly FactoryBindingFact[];
+    readonly routeOperations: readonly RouteOperationFact[];
+    readonly serviceMembers: readonly ServiceMemberFact[];
+    readonly errorBindings: readonly ErrorBindingFact[];
+}
+export type SourceFacts = ExportFacts;
+//# sourceMappingURL=source-facts-types.d.ts.map

package/dist/discovery/source-facts-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-facts-types.d.ts","sourceRoot":"","sources":["../../src/discovery/source-facts-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAC3B,cAAc,GAAG,OAAO,GAAG,YAAY,GAAG,oBAAoB,GAAG,WAAW,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClF,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxD,QAAQ,CAAC,cAAc,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtD,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACrD;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC"}

package/dist/discovery/source-facts-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source-facts-types.js.map

package/dist/discovery/source-facts-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-facts-types.js","sourceRoot":"","sources":["../../src/discovery/source-facts-types.ts"],"names":[],"mappings":""}

package/dist/discovery/source-facts.d.ts

@@ -0,0 +1,6 @@
+import * as ts from "typescript";
+import type { ExportFacts } from "./source-facts-types.js";
+export type { ErrorBindingFact, ExportFact, ExportFacts, FactoryBindingFact, FactoryIdPresence, RouteOperationFact, ServiceMemberFact, SourceFacts, SourceFactoryKind, } from "./source-facts-types.js";
+/** Reads source identity facts using TypeScript syntax only. It never imports or evaluates code. */
+export declare function readFacts(sourceFile: ts.SourceFile): ExportFacts;
+//# sourceMappingURL=source-facts.d.ts.map

package/dist/discovery/source-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-facts.d.ts","sourceRoot":"","sources":["../../src/discovery/source-facts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,KAAK,EAGV,WAAW,EAIZ,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAWjC,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,WAAW,CA0HhE"}

package/dist/discovery/source-facts.js

@@ -0,0 +1,141 @@
+import * as ts from "typescript";
+import { factoryFor, membersFor } from "./source-facts-factory.js";
+const ROUTE_METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "ALL"]);
+/** Reads source identity facts using TypeScript syntax only. It never imports or evaluates code. */
+export function readFacts(sourceFile) {
+    const locals = new Map();
+    const exports = new Map();
+    const factoryBindings = [];
+    const routeOperations = [];
+    const serviceMembers = [];
+    const errorBindings = [];
+    const stars = [];
+    for (const statement of sourceFile.statements) {
+        if (ts.isVariableStatement(statement)) {
+            for (const declaration of statement.declarationList.declarations) {
+                if (!ts.isIdentifier(declaration.name))
+                    continue;
+                const position = declaration.initializer?.getStart(sourceFile) ?? declaration.name.getStart(sourceFile);
+                const factory = factoryFor(declaration.initializer, declaration.name.text, position);
+                const error = statement.declarationList.flags & ts.NodeFlags.Const && factory?.factory === "defineError"
+                    ? { binding: declaration.name.text, position, id: factory.id }
+                    : undefined;
+                const local = {
+                    binding: declaration.name.text,
+                    position,
+                    ...(factory === undefined ? {} : { factory }),
+                    ...(error === undefined ? {} : { error }),
+                };
+                locals.set(declaration.name.text, local);
+                if (factory !== undefined) {
+                    factoryBindings.push(factory);
+                    serviceMembers.push(...membersFor(factory, declaration.initializer, sourceFile));
+                }
+                if (error !== undefined)
+                    errorBindings.push(Object.freeze(error));
+                if (hasModifier(statement, ts.SyntaxKind.ExportKeyword)) {
+                    exports.set(declaration.name.text, exportFact(local));
+                }
+            }
+        }
+        if (ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement)) {
+            if (statement.name === undefined)
+                continue;
+            const local = {
+                binding: statement.name.text,
+                position: statement.getStart(sourceFile),
+            };
+            locals.set(statement.name.text, local);
+            if (hasModifier(statement, ts.SyntaxKind.ExportKeyword)) {
+                exports.set(statement.name.text, exportFact(local));
+            }
+            if (hasModifier(statement, ts.SyntaxKind.DefaultKeyword)) {
+                exports.set("default", exportFact(local));
+            }
+        }
+    }
+    for (const statement of sourceFile.statements) {
+        if (ts.isExportAssignment(statement) && !statement.isExportEquals) {
+            const expression = statement.expression;
+            const local = ts.isIdentifier(expression) ? locals.get(expression.text) : undefined;
+            const position = local?.position ?? expression.getStart(sourceFile);
+            const factory = local?.factory ?? factoryFor(expression, undefined, position);
+            if (factory !== undefined && local === undefined)
+                factoryBindings.push(factory);
+            exports.set("default", local === undefined
+                ? { position, ...(factory === undefined ? {} : { factory }) }
+                : exportFact(local));
+        }
+        if (!ts.isExportDeclaration(statement) || statement.isTypeOnly)
+            continue;
+        const module = statement.moduleSpecifier && ts.isStringLiteralLike(statement.moduleSpecifier)
+            ? statement.moduleSpecifier.text
+            : undefined;
+        if (statement.exportClause === undefined) {
+            if (module !== undefined)
+                stars.push({ module, position: statement.getStart(sourceFile) });
+            continue;
+        }
+        if (!ts.isNamedExports(statement.exportClause))
+            continue;
+        for (const element of statement.exportClause.elements) {
+            if (element.isTypeOnly)
+                continue;
+            const name = element.name.text;
+            const localName = element.propertyName?.text ?? name;
+            if (module !== undefined) {
+                exports.set(name, {
+                    position: element.getStart(sourceFile),
+                    origin: { module, name: localName },
+                });
+                continue;
+            }
+            const local = locals.get(localName);
+            exports.set(name, exportFact(local ?? {
+                binding: localName,
+                position: element.getStart(sourceFile),
+            }));
+        }
+    }
+    for (const [exportName, fact] of exports) {
+        const method = routeMethod(exportName);
+        if (method === undefined || fact.factory?.kind !== "route")
+            continue;
+        const operation = Object.freeze({
+            exportName,
+            method,
+            ...(fact.binding === undefined ? {} : { binding: fact.binding }),
+            position: fact.position,
+        });
+        routeOperations.push(operation);
+        exports.set(exportName, { ...fact, routeOperation: operation });
+    }
+    return {
+        exports,
+        stars: Object.freeze(stars),
+        factoryBindings: Object.freeze(sortFacts(factoryBindings)),
+        routeOperations: Object.freeze(sortFacts(routeOperations)),
+        serviceMembers: Object.freeze(sortFacts(serviceMembers)),
+        errorBindings: Object.freeze(sortFacts(errorBindings)),
+    };
+}
+function exportFact(local) {
+    return {
+        position: local.position,
+        binding: local.binding,
+        ...(local.factory === undefined ? {} : { factory: local.factory }),
+        ...(local.error === undefined ? {} : { errorBinding: local.error }),
+    };
+}
+function routeMethod(value) {
+    const method = value.toUpperCase();
+    return ROUTE_METHODS.has(method) ? method : undefined;
+}
+function sortFacts(values) {
+    return [...values].sort((left, right) => left.position - right.position);
+}
+function hasModifier(node, kind) {
+    return (ts.canHaveModifiers(node) &&
+        ts.getModifiers(node)?.some((modifier) => modifier.kind === kind) === true);
+}
+//# sourceMappingURL=source-facts.js.map

package/dist/discovery/source-facts.js.map

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

package/dist/discovery/source-id-route.d.ts

@@ -0,0 +1,3 @@
+/** Encodes a route identity without placing slashes or transport punctuation in the ID. */
+export declare function encodeRouteId(method: string, routePath: string, explicitId?: unknown): string | undefined;
+//# sourceMappingURL=source-id-route.d.ts.map

package/dist/discovery/source-id-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-id-route.d.ts","sourceRoot":"","sources":["../../src/discovery/source-id-route.ts"],"names":[],"mappings":"AAIA,2FAA2F;AAC3F,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM,GAAG,SAAS,CAQpB"}

package/dist/discovery/source-id-route.js

@@ -0,0 +1,61 @@
+import { normalizeId } from "@relkit/contracts";
+const HTTP_METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "ALL"]);
+/** Encodes a route identity without placing slashes or transport punctuation in the ID. */
+export function encodeRouteId(method, routePath, explicitId) {
+    if (explicitId !== undefined)
+        return normalizeId(explicitId);
+    const normalizedMethod = method.trim().toUpperCase();
+    if (!HTTP_METHODS.has(normalizedMethod))
+        return undefined;
+    const segments = routeSegments(routePath);
+    if (segments === undefined)
+        return undefined;
+    const value = ["route", normalizedMethod.toLowerCase(), ...segments].join(".");
+    return normalizeId(value);
+}
+function routeSegments(value) {
+    const normalized = value.trim().replaceAll("\\", "/");
+    if (!normalized.startsWith("/"))
+        return undefined;
+    const raw = normalized.split("/").filter(Boolean);
+    if (raw.length === 0)
+        return ["root"];
+    const result = [];
+    for (const segment of raw) {
+        const dynamic = /^:([A-Za-z_][A-Za-z0-9_]*)$/.exec(segment) ?? /^\{([^{}]+)\}$/.exec(segment);
+        if (dynamic !== null) {
+            const name = kebab(dynamic[1]);
+            if (name === undefined)
+                return undefined;
+            result.push(`by-${name}`);
+            continue;
+        }
+        const catchAll = /^(\*|\.\.\.)([A-Za-z_][A-Za-z0-9_]*)(\?)?$/.exec(segment);
+        if (catchAll !== null) {
+            const name = kebab(catchAll[2]);
+            if (name === undefined)
+                return undefined;
+            result.push(catchAll[3] === "?" ? `optional-catch-all-${name}` : `catch-all-${name}`);
+            continue;
+        }
+        const staticSegment = kebab(segment);
+        if (staticSegment === undefined)
+            return undefined;
+        result.push(staticSegment);
+    }
+    return result;
+}
+function kebab(value) {
+    if (value === undefined)
+        return undefined;
+    const normalized = value
+        .normalize("NFKC")
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
+        .replace(/[^A-Za-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-+/g, "-")
+        .toLowerCase();
+    return normalized === "" ? undefined : normalized;
+}
+//# sourceMappingURL=source-id-route.js.map

package/dist/discovery/source-id-route.js.map

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

package/dist/discovery/source-id.d.ts

@@ -0,0 +1,36 @@
+import type { ExportFact, SourceFactoryKind } from "./source-facts-types.js";
+export { encodeRouteId } from "./source-id-route.js";
+export interface SourceIdInput {
+    readonly kind: SourceFactoryKind;
+    readonly source: string;
+    readonly projectRoot?: string;
+    readonly explicitId?: unknown;
+    readonly exportName?: string;
+    readonly exportKind?: "default" | "named";
+    readonly binding?: string;
+    readonly serviceId?: string;
+    readonly member?: string;
+    readonly method?: string;
+    readonly path?: string;
+}
+export interface ExportIdInput {
+    readonly source: string;
+    readonly projectRoot?: string;
+    readonly kind: SourceFactoryKind;
+    readonly exportName: string;
+    readonly exportKind: "default" | "named";
+    readonly binding?: string;
+    readonly explicitId?: unknown;
+    readonly exportFact?: ExportFact;
+}
+/** Returns the normalized source hierarchy after conventional path stripping. */
+export declare function encodeSourceHierarchy(source: string, kind: SourceFactoryKind, projectRoot?: string): string | undefined;
+/** Encodes a named/default export, returning undefined when syntax cannot identify it. */
+export declare function encodeExportId(input: ExportIdInput): string | undefined;
+/** Encodes a source-local declared error while retaining its binding spelling. */
+export declare function encodeErrorId(source: string, binding: string, explicitId?: unknown, projectRoot?: string): string | undefined;
+/** Encodes a service member identity from the already-resolved service identity. */
+export declare function encodeMemberId(serviceId: string, member: string, explicitId?: unknown): string | undefined;
+/** Selects explicit identity first, then the applicable source/member/route encoder. */
+export declare function encodeSourceId(input: SourceIdInput): string | undefined;
+//# sourceMappingURL=source-id.d.ts.map

package/dist/discovery/source-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-id.d.ts","sourceRoot":"","sources":["../../src/discovery/source-id.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AA4BD,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAGpB;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAQvE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,OAAO,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAIpB;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,OAAO,GACnB,MAAM,GAAG,SAAS,CAKpB;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAmBvE"}