@relkit/compiler 0.0.0

package/dist/generate-manifest.js

@@ -0,0 +1,89 @@
+import { GENERATOR_VERSION, MANIFEST_VERSION } from "@relkit/contracts";
+import { createDiagnostic, sortDiagnostics } from "@relkit/diagnostics";
+import { hashGraph } from "@relkit/graph";
+import { descriptorsOf, importBindings, collectModules, providerFactoryKeys, uniqueById, generatedFunctionDescriptors, } from "./generate-manifest-utils.js";
+import { applicationExpressionFor, descriptorExpressionsFor, functionExpressionsFor, functionTargetExpressionsFor, hookExpressionsFor, middlewareExpressionsFor, transformExpressionsFor, } from "./generate-manifest-expressions.js";
+import { renderManifest } from "./generate-manifest-format.js";
+import { identityBindingStatements } from "./generate-manifest-identities.js";
+export const MANIFEST_CODES = Object.freeze({
+    handler: "RELKIT_MANIFEST_HANDLER_MISSING",
+    middleware: "RELKIT_MANIFEST_MIDDLEWARE_MISSING",
+    transform: "RELKIT_MANIFEST_TRANSFORM_MISSING",
+    mismatch: "RELKIT_GRAPH_MANIFEST_MISMATCH",
+});
+/** Generates the executable manifest source after graph and semantic validation. */
+export function generateManifest(input) {
+    const existing = input.diagnostics ?? [];
+    if (existing.some((diagnostic) => diagnostic.severity === "error")) {
+        return result("", [], false);
+    }
+    const diagnostics = [];
+    if (input.graph !== undefined &&
+        hashGraph(input.graph, pathOptions(input.projectRoot)) !== input.graphHash) {
+        diagnostics.push(createDiagnostic({
+            code: MANIFEST_CODES.mismatch,
+            severity: "error",
+            message: "Runtime manifest graph hash does not match the canonical graph.",
+        }, pathOptions(input.projectRoot)));
+    }
+    const functions = [
+        ...descriptorsOf(input.descriptors, "function"),
+        ...generatedFunctionDescriptors(input.descriptors),
+    ];
+    const application = descriptorsOf(input.descriptors, "app")[0];
+    const middleware = descriptorsOf(input.middleware ?? input.descriptors, "middleware");
+    const transforms = descriptorsOf(input.transforms ?? input.descriptors, "transform");
+    const agents = descriptorsOf(input.descriptors, "agent");
+    const tools = descriptorsOf(input.descriptors, "tool");
+    const routes = descriptorsOf(input.descriptors, "route");
+    const constants = descriptorsOf(input.descriptors, "constants");
+    const prompts = descriptorsOf(input.descriptors, "prompt");
+    const dataModel = descriptorsOf(input.descriptors, "data-model")[0];
+    const services = descriptorsOf(input.descriptors, "service");
+    const events = descriptorsOf(input.descriptors, "event");
+    const functionById = uniqueById(functions, diagnostics);
+    const modules = collectModules(functions, middleware, transforms, input, application, [
+        ...input.descriptors,
+        ...agents,
+        ...tools,
+        ...events,
+    ]);
+    const bindings = importBindings(modules);
+    const identityBindings = identityBindingStatements(input.descriptors, bindings, input);
+    const functionExpressions = functionExpressionsFor(functions, functionById, bindings, input, diagnostics);
+    const targetExpressions = functionTargetExpressionsFor(functions, bindings, input);
+    const applicationExpression = applicationExpressionFor(application, bindings, input);
+    const agentExpressions = descriptorExpressionsFor(agents, bindings, input);
+    const toolExpressions = descriptorExpressionsFor(tools, bindings, input);
+    const routeExpressions = descriptorExpressionsFor(routes, bindings, input);
+    const constantExpressions = descriptorExpressionsFor(constants, bindings, input);
+    const promptExpressionsById = descriptorExpressionsFor(prompts, bindings, input);
+    const dataModelExpression = dataModel === undefined
+        ? undefined
+        : descriptorExpressionsFor([dataModel], bindings, input).get(dataModel.id);
+    const promptExpressions = new Map(prompts.flatMap((descriptor) => {
+        const expression = promptExpressionsById.get(descriptor.id);
+        return expression === undefined ? [] : [[descriptor.exportName, expression]];
+    }));
+    const serviceExpressions = descriptorExpressionsFor(services, bindings, input);
+    const transformExpressions = transformExpressionsFor(transforms, bindings, input, diagnostics);
+    const middlewareExpressions = middlewareExpressionsFor(middleware, bindings, input, diagnostics);
+    const hookExpressions = hookExpressionsFor([...functions, ...tools], bindings, input);
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return result("", diagnostics, false);
+    }
+    return result(renderManifest(input, bindings, functionExpressions, targetExpressions, middlewareExpressions, hookExpressions, transformExpressions, providerFactoryKeys(input.descriptors), applicationExpression, agentExpressions, toolExpressions, routeExpressions, constantExpressions, promptExpressions, dataModelExpression, serviceExpressions, identityBindings), diagnostics, true);
+}
+function result(source, diagnostics, activatable) {
+    return Object.freeze({
+        source,
+        diagnostics: Object.freeze([...sortDiagnostics(diagnostics)]),
+        activatable,
+    });
+}
+export const MANIFEST_CONTRACT_VERSION = MANIFEST_VERSION;
+export const MANIFEST_GENERATOR_VERSION = GENERATOR_VERSION;
+function pathOptions(projectRoot) {
+    return projectRoot === undefined ? {} : { projectRoot };
+}
+//# sourceMappingURL=generate-manifest.js.map

package/dist/generate-manifest.js.map

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

package/dist/generated-artifacts.d.ts

@@ -0,0 +1,69 @@
+import type { Diagnostic } from "@relkit/diagnostics";
+import type { GeneratedOutputs, NormalizedGraph } from "./normalize-types.js";
+export declare const GENERATED_ARTIFACT_FILES: Readonly<{
+    readonly graph: "application.graph.json";
+    readonly manifest: "runtime.manifest.ts";
+    readonly diagnostics: "diagnostics.json";
+    readonly contract: "contract.ts";
+    readonly clientContract: "client-contract.json";
+}>;
+export declare const GENERATED_ARTIFACT_VERSIONS: Readonly<{
+    readonly graph: 5;
+    readonly manifest: 5;
+    readonly diagnostics: 2;
+    readonly generator: 2;
+}>;
+export declare const GENERATED_EXTENSION_VERSIONS: Readonly<{
+    readonly openapi: Readonly<{
+        fileName: "openapi.json";
+        version: 1;
+    }>;
+    readonly client: Readonly<{
+        fileName: "client.ts";
+        version: 1;
+    }>;
+    readonly deploymentPlan: Readonly<{
+        fileName: "deployment.plan.json";
+        version: 1;
+    }>;
+}>;
+export type GeneratedExtensionKind = keyof typeof GENERATED_EXTENSION_VERSIONS;
+/** A future generator's versioned artifact input. Deployment is opt-in by passing it. */
+export interface GeneratedOutputExtension {
+    readonly kind: GeneratedExtensionKind;
+    readonly version: number;
+    readonly content: string;
+}
+export interface GeneratedArtifact {
+    readonly fileName: string;
+    readonly content: string;
+    readonly version: number;
+}
+export interface ArtifactWriteResult {
+    readonly fileName: string;
+    readonly path: string;
+    readonly changed: boolean;
+    readonly bytes: number;
+}
+export interface GeneratedArtifactsWriteOptions {
+    readonly directory: string;
+    readonly extensions?: readonly GeneratedOutputExtension[];
+}
+export interface GeneratedArtifactsWriteReport {
+    readonly writes: readonly ArtifactWriteResult[];
+    readonly changed: boolean;
+}
+/** Builds the three compiler-owned artifacts without adding time or process metadata. */
+export declare function generatedArtifacts(outputs: GeneratedOutputs): readonly GeneratedArtifact[];
+/** Creates the future OpenAPI/client/deployment extension seam with its pinned version. */
+export declare function createGeneratedOutputExtension(kind: GeneratedExtensionKind, content: string): GeneratedOutputExtension;
+/** Writes changed bytes only; the unchanged path is never opened for writing. */
+export declare function writeIfChanged(filePath: string, content: string): Promise<ArtifactWriteResult>;
+/** Writes compiler artifacts plus content-aware OpenAPI/client and explicit extensions. */
+export declare function writeGeneratedArtifacts(outputs: GeneratedOutputs, options: GeneratedArtifactsWriteOptions): Promise<GeneratedArtifactsWriteReport>;
+export interface GeneratedOutputExtensionContext {
+    readonly graph: NormalizedGraph;
+    readonly graphHash: string;
+    readonly diagnostics: readonly Diagnostic[];
+}
+//# sourceMappingURL=generated-artifacts.d.ts.map

package/dist/generated-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-artifacts.d.ts","sourceRoot":"","sources":["../src/generated-artifacts.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE9E,eAAO,MAAM,wBAAwB;;;;;;EAM1B,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;;;EAK7B,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;EAI9B,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,4BAA4B,CAAC;AAE/E,yFAAyF;AACzF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,iBAAiB,EAAE,CAgB1F;AAED,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,MAAM,GACd,wBAAwB,CAG1B;AAED,iFAAiF;AACjF,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAwB9B;AAED,2FAA2F;AAC3F,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAkCxC;AAiCD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C"}

package/dist/generated-artifacts.js

@@ -0,0 +1,124 @@
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { CONTRACT_VERSION, GENERATOR_VERSION, GRAPH_VERSION, MANIFEST_VERSION, } from "@relkit/contracts";
+export const GENERATED_ARTIFACT_FILES = Object.freeze({
+    graph: "application.graph.json",
+    manifest: "runtime.manifest.ts",
+    diagnostics: "diagnostics.json",
+    contract: "contract.ts",
+    clientContract: "client-contract.json",
+});
+export const GENERATED_ARTIFACT_VERSIONS = Object.freeze({
+    graph: GRAPH_VERSION,
+    manifest: MANIFEST_VERSION,
+    diagnostics: CONTRACT_VERSION,
+    generator: GENERATOR_VERSION,
+});
+export const GENERATED_EXTENSION_VERSIONS = Object.freeze({
+    openapi: Object.freeze({ fileName: "openapi.json", version: 1 }),
+    client: Object.freeze({ fileName: "client.ts", version: 1 }),
+    deploymentPlan: Object.freeze({ fileName: "deployment.plan.json", version: 1 }),
+});
+/** Builds the three compiler-owned artifacts without adding time or process metadata. */
+export function generatedArtifacts(outputs) {
+    return Object.freeze([
+        artifact(GENERATED_ARTIFACT_FILES.graph, outputs.graph, GENERATED_ARTIFACT_VERSIONS.graph),
+        artifact(GENERATED_ARTIFACT_FILES.manifest, outputs.manifest, GENERATED_ARTIFACT_VERSIONS.manifest),
+        artifact(GENERATED_ARTIFACT_FILES.diagnostics, outputs.diagnostics, GENERATED_ARTIFACT_VERSIONS.diagnostics),
+        artifact(GENERATED_ARTIFACT_FILES.contract, outputs.contract, CONTRACT_VERSION),
+        artifact(GENERATED_ARTIFACT_FILES.clientContract, outputs.clientContract, CONTRACT_VERSION),
+    ]);
+}
+/** Creates the future OpenAPI/client/deployment extension seam with its pinned version. */
+export function createGeneratedOutputExtension(kind, content) {
+    if (typeof content !== "string")
+        throw new TypeError("Generated artifact content must be text.");
+    return Object.freeze({ kind, version: GENERATED_EXTENSION_VERSIONS[kind].version, content });
+}
+/** Writes changed bytes only; the unchanged path is never opened for writing. */
+export async function writeIfChanged(filePath, content) {
+    const next = Buffer.from(content, "utf8");
+    let unchanged = false;
+    try {
+        unchanged = (await readFile(filePath)).equals(next);
+    }
+    catch (error) {
+        if (!isMissingFile(error))
+            throw error;
+    }
+    if (!unchanged) {
+        await mkdir(dirname(filePath), { recursive: true });
+        const temporary = `${filePath}.${process.pid}.${crypto.randomUUID()}.tmp`;
+        try {
+            await writeFile(temporary, next, { flag: "wx" });
+            await rename(temporary, filePath);
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+    }
+    return Object.freeze({
+        fileName: basename(filePath),
+        path: filePath,
+        changed: !unchanged,
+        bytes: next.byteLength,
+    });
+}
+/** Writes compiler artifacts plus content-aware OpenAPI/client and explicit extensions. */
+export async function writeGeneratedArtifacts(outputs, options) {
+    const explicitExtensions = options.extensions ?? [];
+    const extensionKinds = new Set();
+    for (const extension of explicitExtensions) {
+        if (extensionKinds.has(extension.kind)) {
+            throw new TypeError(`Generated ${extension.kind} extension was supplied more than once.`);
+        }
+        extensionKinds.add(extension.kind);
+    }
+    const contentExtensions = (await Promise.all(["openapi", "client"].map(async (kind) => {
+        if (extensionKinds.has(kind))
+            return undefined;
+        const content = outputs[kind];
+        const filePath = join(options.directory, GENERATED_EXTENSION_VERSIONS[kind].fileName);
+        if (content === "" && !(await fileExists(filePath)))
+            return undefined;
+        return createGeneratedOutputExtension(kind, content);
+    }))).filter((extension) => extension !== undefined);
+    const artifacts = [
+        ...generatedArtifacts(outputs),
+        ...contentExtensions.map(extensionArtifact),
+        ...explicitExtensions.map(extensionArtifact),
+    ].sort((left, right) => left.fileName.localeCompare(right.fileName));
+    const results = await Promise.all(artifacts.map((entry) => writeIfChanged(join(options.directory, entry.fileName), entry.content)));
+    return Object.freeze({
+        writes: Object.freeze(results),
+        changed: results.some((result) => result.changed),
+    });
+}
+function artifact(fileName, content, version) {
+    return Object.freeze({ fileName, content, version });
+}
+function extensionArtifact(extension) {
+    const expected = GENERATED_EXTENSION_VERSIONS[extension.kind];
+    if (extension.version !== expected.version) {
+        throw new TypeError(`Generated ${extension.kind} version ${extension.version} is unsupported; expected ${expected.version}.`);
+    }
+    if (typeof extension.content !== "string") {
+        throw new TypeError(`Generated ${extension.kind} content must be text.`);
+    }
+    return artifact(expected.fileName, extension.content, extension.version);
+}
+function isMissingFile(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+async function fileExists(filePath) {
+    try {
+        await readFile(filePath);
+        return true;
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return false;
+        throw error;
+    }
+}
+//# sourceMappingURL=generated-artifacts.js.map

package/dist/generated-artifacts.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./conventions.js";
+export * from "./config-loader.js";
+export * from "./discovery/ast-prefilter.js";
+export * from "./discovery/data-model-isolation.js";
+export * from "./discovery/evaluator.js";
+export * from "./discovery/extract.js";
+export * from "./discovery/source-map.js";
+export * from "./discovery/source-id.js";
+export * from "./generate-manifest.js";
+export * from "./event-registry.js";
+export * from "./context-registry.js";
+export * from "./generated-artifacts.js";
+export * from "./normalize.js";
+export * from "./project-typecheck.js";
+export * from "./route-file.js";
+export * from "./watch.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+export * from "./conventions.js";
+export * from "./config-loader.js";
+export * from "./discovery/ast-prefilter.js";
+export * from "./discovery/data-model-isolation.js";
+export * from "./discovery/evaluator.js";
+export * from "./discovery/extract.js";
+export * from "./discovery/source-map.js";
+export * from "./discovery/source-id.js";
+export * from "./generate-manifest.js";
+export * from "./event-registry.js";
+export * from "./context-registry.js";
+export * from "./generated-artifacts.js";
+export * from "./normalize.js";
+export * from "./project-typecheck.js";
+export * from "./route-file.js";
+export * from "./watch.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/middleware-coverage.d.ts

@@ -0,0 +1,12 @@
+import type { NormalizedDescriptor, NormalizationWork } from "./normalize-types.js";
+export type MiddlewareRouteMatch = "always" | "conditional";
+export interface MiddlewareRouteReference {
+    readonly id: string;
+    readonly path: string;
+    readonly order: number;
+    readonly match: MiddlewareRouteMatch;
+}
+export declare function isMiddlewarePath(value: unknown): value is string;
+export declare function middlewareForRoute(route: NormalizedDescriptor, work: NormalizationWork): readonly MiddlewareRouteReference[];
+export declare function pathRelation(middlewarePath: string, routePath: string): MiddlewareRouteMatch | undefined;
+//# sourceMappingURL=middleware-coverage.d.ts.map

package/dist/middleware-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-coverage.d.ts","sourceRoot":"","sources":["../src/middleware-coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGpF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE5D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAShE;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,iBAAiB,GACtB,SAAS,wBAAwB,EAAE,CAmBrC;AAED,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,oBAAoB,GAAG,SAAS,CA+BlC"}

package/dist/middleware-coverage.js

@@ -0,0 +1,90 @@
+import { isRecord } from "./normalize-utils.js";
+export function isMiddlewarePath(value) {
+    if (value === "*")
+        return true;
+    if (typeof value !== "string" || !value.startsWith("/"))
+        return false;
+    if (value === "/")
+        return true;
+    const parts = value.slice(1).split("/");
+    return parts.every((part, index) => {
+        if (part === "*")
+            return index === parts.length - 1;
+        return part !== "" && (/^:[A-Za-z_][A-Za-z0-9_]*$/.test(part) || !/[*:?{}]/.test(part));
+    });
+}
+export function middlewareForRoute(route, work) {
+    const routeValue = isRecord(route.value) ? route.value : {};
+    const paths = runtimePaths(routeValue);
+    return [...work.middlewareReferences.values()]
+        .sort((left, right) => left.id.localeCompare(right.id))
+        .flatMap((middleware, order) => {
+        const value = isRecord(middleware.value) ? middleware.value : {};
+        if (typeof value.path !== "string")
+            return [];
+        const matches = paths.map((path) => pathRelation(value.path, path));
+        if (matches.every((match) => match === undefined))
+            return [];
+        return [
+            {
+                id: middleware.id,
+                path: value.path,
+                order,
+                match: matches.every((match) => match === "always") ? "always" : "conditional",
+            },
+        ];
+    });
+}
+export function pathRelation(middlewarePath, routePath) {
+    if (middlewarePath === "*")
+        return "always";
+    const middleware = segments(middlewarePath);
+    const route = segments(routePath);
+    const middlewareWildcard = middleware.at(-1) === "*";
+    const middlewarePrefix = middlewareWildcard ? middleware.slice(0, -1) : middleware;
+    const routeWildcard = route.findIndex(isRouteWildcard);
+    const fixedRoute = routeWildcard < 0;
+    const shared = Math.min(middlewarePrefix.length, fixedRoute ? route.length : routeWildcard);
+    for (let index = 0; index < shared; index += 1) {
+        if (!overlaps(middlewarePrefix[index] ?? "", route[index] ?? ""))
+            return undefined;
+    }
+    if (fixedRoute) {
+        if (!middlewareWildcard && middlewarePrefix.length !== route.length)
+            return undefined;
+        if (middlewareWildcard && route.length < middlewarePrefix.length)
+            return undefined;
+        return middlewarePrefix.every((segment, index) => index >= route.length || covers(segment, route[index] ?? ""))
+            ? "always"
+            : "conditional";
+    }
+    if (middlewarePrefix.length < routeWildcard && !middlewareWildcard)
+        return undefined;
+    if (middlewareWildcard && middlewarePrefix.length <= routeWildcard) {
+        return middlewarePrefix.every((segment, index) => covers(segment, route[index] ?? ""))
+            ? "always"
+            : "conditional";
+    }
+    return "conditional";
+}
+function runtimePaths(value) {
+    if (Array.isArray(value.runtimePaths)) {
+        const paths = value.runtimePaths.filter((entry) => typeof entry === "string");
+        if (paths.length > 0)
+            return paths;
+    }
+    return [typeof value.path === "string" ? value.path : ""];
+}
+function segments(path) {
+    return path === "/" ? [] : path.replace(/^\//, "").split("/");
+}
+function overlaps(middleware, route) {
+    return middleware.startsWith(":") || route.startsWith(":") || middleware === route;
+}
+function covers(middleware, route) {
+    return middleware.startsWith(":") || (!route.startsWith(":") && middleware === route);
+}
+function isRouteWildcard(segment) {
+    return segment.startsWith("*") || /^:[^{]+\{\.\+\}$/.test(segment);
+}
+//# sourceMappingURL=middleware-coverage.js.map

package/dist/middleware-coverage.js.map

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

package/dist/normalize-compat.d.ts

@@ -0,0 +1,26 @@
+import { type JsonValue } from "@relkit/contracts";
+import { type StandardSchemaV1 } from "@relkit/schema";
+import type { NormalizedDescriptor, NormalizeInput } from "./normalize-types.js";
+export interface SchemaResult {
+    readonly ok: boolean;
+    readonly schema?: JsonValue;
+    readonly reason?: string;
+}
+export declare function schema(value: unknown): SchemaResult;
+export declare function isSchema(value: unknown): value is StandardSchemaV1;
+export declare function schemaEquivalent(left: unknown, right: unknown): boolean;
+export declare function schemaProperties(value: unknown): {
+    readonly properties: Readonly<Record<string, JsonValue>>;
+    readonly required: readonly string[];
+} | undefined;
+export declare function mappingFields(value: unknown): readonly string[];
+export declare function mappingCompatible(mapping: unknown, target: unknown): string | undefined;
+export declare function jobCompatible(input: unknown, target: unknown): string | undefined;
+export declare function targetId(value: unknown): string | undefined;
+export declare function selectorEntries(value: unknown): readonly string[];
+export declare function matchingEvents(pattern: string, events: readonly NormalizedDescriptor[]): readonly string[];
+export declare function schemaEntries(descriptor: NormalizedDescriptor): readonly [string, unknown][];
+export declare function cronLike(value: unknown): boolean;
+export declare function providerProfiles(input: NormalizeInput): ReadonlyMap<string, readonly string[]>;
+export declare function isJsonMetadata(value: unknown): value is JsonValue;
+//# sourceMappingURL=normalize-compat.d.ts.map

package/dist/normalize-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-compat.d.ts","sourceRoot":"","sources":["../src/normalize-compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGjF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAYnD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAOlE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAIvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAC3C;IACE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GACD,SAAS,CAcZ;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAS/D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUvF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOjF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CASjE;AASD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,oBAAoB,EAAE,GACtC,SAAS,MAAM,EAAE,CAOnB;AAqBD,wBAAgB,aAAa,CAAC,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAQ5F;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAe9F;AAUD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAEjE"}