@relkit/compiler 0.0.0

package/dist/normalize-reference-validation.js

@@ -0,0 +1,88 @@
+import { add, targetFields, validateDependencies } from "./normalize-pass-utils.js";
+import { referenceFor } from "./normalize-reference-index.js";
+import { id, isRecord, refId, refKind } from "./normalize-utils.js";
+import { NORMALIZE_CODES, } from "./normalize-types.js";
+import { validateRateLimitStore } from "./normalize-rate-limit.js";
+const SERVICE_OWNERSHIP_CODE = "RELKIT_SERVICE_OWNERSHIP";
+/** Resolves descriptor, middleware, and named-transform references without importing code. */
+export function passReferences(work) {
+    const serviceOwners = new Map();
+    for (const descriptor of work.descriptors) {
+        const value = isRecord(descriptor.value) ? descriptor.value : {};
+        for (const [name, kind] of targetFields(descriptor.kind)) {
+            if (descriptor.kind === "route" && value.raw === true)
+                continue;
+            if (referenceFor(work, value[name], kind) === undefined) {
+                add(work, descriptor, NORMALIZE_CODES.missingTarget, `${descriptor.kind} target ${name} does not resolve to a ${kind}.`);
+            }
+        }
+        if (descriptor.kind === "function")
+            validateDependencies(work, descriptor, value.dependencies);
+        if (descriptor.kind === "route") {
+            collectTransforms(work, descriptor, value.request);
+            validateRateLimitStore(work, descriptor, value.rateLimit);
+        }
+        if (descriptor.kind === "service")
+            validateService(work, descriptor, value, serviceOwners);
+    }
+    for (const descriptor of work.descriptors.filter((entry) => entry.kind === "transform")) {
+        if (!work.transformReferences.has(descriptor.id)) {
+            add(work, descriptor, NORMALIZE_CODES.missingTransform, "Named transform is not indexed.");
+        }
+    }
+}
+function validateService(work, service, value, owners) {
+    const functions = isRecord(value.functions) ? value.functions : undefined;
+    if (functions === undefined || Object.keys(functions).length === 0) {
+        add(work, service, NORMALIZE_CODES.descriptor, "A service must declare at least one function.");
+    }
+    else {
+        for (const target of Object.values(functions)) {
+            const resolved = referenceFor(work, target, "function");
+            if (resolved === undefined) {
+                add(work, service, NORMALIZE_CODES.missingTarget, "Service member does not resolve to a function.");
+                continue;
+            }
+            const previous = owners.get(resolved.id);
+            if (previous !== undefined && previous.id !== service.id) {
+                add(work, service, SERVICE_OWNERSHIP_CODE, `Function "${resolved.id}" is already owned by service "${previous.id}".`, "error", previous);
+            }
+            else {
+                owners.set(resolved.id, service);
+            }
+        }
+    }
+    if (value.middleware === undefined)
+        return;
+    if (!Array.isArray(value.middleware)) {
+        add(work, service, NORMALIZE_CODES.descriptor, "Service middleware must be an array.");
+        return;
+    }
+    for (const entry of value.middleware) {
+        if (refKind(entry) !== "service-middleware" || refId(entry) === undefined) {
+            add(work, service, NORMALIZE_CODES.descriptor, "Service middleware reference is invalid.");
+        }
+    }
+}
+function collectTransforms(work, owner, value) {
+    if (!isRecord(value))
+        return;
+    if (value.kind === "transform") {
+        const transformId = id(value.transformId);
+        if (transformId === undefined || !work.transformReferences.has(transformId)) {
+            add(work, owner, NORMALIZE_CODES.missingTransform, `Request transform "${String(value.transformId)}" is missing.`);
+        }
+        collectTransforms(work, owner, value.value);
+        return;
+    }
+    if (value.kind === "input" || value.kind === "nested") {
+        if (isRecord(value.fields)) {
+            for (const field of Object.values(value.fields))
+                collectTransforms(work, owner, field);
+        }
+        return;
+    }
+    if (value.kind === "optional" || value.kind === "default")
+        collectTransforms(work, owner, value.value);
+}
+//# sourceMappingURL=normalize-reference-validation.js.map

package/dist/normalize-reference-validation.js.map

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

package/dist/normalize-route-file.d.ts

@@ -0,0 +1,4 @@
+import { type NormalizedDescriptor, type NormalizationWork } from "./normalize-types.js";
+/** Adds file- and export-derived transport metadata to one authored route. */
+export declare function bindRouteFile(work: NormalizationWork, descriptor: NormalizedDescriptor, value: Record<string, any>): void;
+//# sourceMappingURL=normalize-route-file.d.ts.map

package/dist/normalize-route-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-file.d.ts","sourceRoot":"","sources":["../src/normalize-route-file.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,8EAA8E;AAC9E,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,IAAI,CAiDN"}

package/dist/normalize-route-file.js

@@ -0,0 +1,41 @@
+import { method, path } from "./normalize-utils.js";
+import { add } from "./normalize-pass-utils.js";
+import { parseRouteFilePath } from "./route-file.js";
+import { NORMALIZE_CODES, } from "./normalize-types.js";
+/** Adds file- and export-derived transport metadata to one authored route. */
+export function bindRouteFile(work, descriptor, value) {
+    if (descriptor.reference === undefined) {
+        const nextMethod = method(value.method);
+        const nextPath = path(value.path);
+        if (nextMethod !== undefined)
+            value.method = nextMethod;
+        if (nextPath !== undefined)
+            value.path = nextPath;
+        return;
+    }
+    if (value.method !== undefined || value.path !== undefined) {
+        add(work, descriptor, NORMALIZE_CODES.routeTransport, "Remove method and path from defineRoute; export it as GET, POST, PUT, PATCH, DELETE, HEAD, or OPTIONS from src/routes/**/route.ts.");
+    }
+    try {
+        const parsed = parseRouteFilePath(descriptor.source.file);
+        value.path = parsed.canonicalPath;
+        value.runtimePaths = parsed.runtimePaths;
+    }
+    catch (error) {
+        add(work, descriptor, NORMALIZE_CODES.routeFile, `Move this route to src/routes/**/route.ts. ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const nextMethod = method(descriptor.exportName);
+    if (descriptor.exportKind !== "named" || nextMethod === undefined) {
+        add(work, descriptor, NORMALIZE_CODES.routeExport, "Export the route with a named HTTP method such as `export const GET = defineRoute(...)`; default route exports are not supported.");
+    }
+    else {
+        value.method = nextMethod;
+        if ((nextMethod === "ALL") !== (value.raw === true)) {
+            add(work, descriptor, NORMALIZE_CODES.routeExport, "ALL is reserved for raw-handler routes, and raw-handler routes must use ALL.");
+        }
+    }
+    const nextPath = path(value.path);
+    if (nextPath !== undefined)
+        value.path = nextPath;
+}
+//# sourceMappingURL=normalize-route-file.js.map

package/dist/normalize-route-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-file.js","sourceRoot":"","sources":["../src/normalize-route-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAE9B,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAC3B,IAAuB,EACvB,UAAgC,EAChC,KAA0B;IAE1B,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC;QACxD,IAAI,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC;QAClD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3D,GAAG,CACD,IAAI,EACJ,UAAU,EACV,eAAe,CAAC,cAAc,EAC9B,oIAAoI,CACrI,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC;QAClC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CACD,IAAI,EACJ,UAAU,EACV,eAAe,CAAC,SAAS,EACzB,8CAA8C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvG,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,UAAU,CAAC,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAClE,GAAG,CACD,IAAI,EACJ,UAAU,EACV,eAAe,CAAC,WAAW,EAC3B,mIAAmI,CACpI,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC;QAC1B,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC;YACpD,GAAG,CACD,IAAI,EACJ,UAAU,EACV,eAAe,CAAC,WAAW,EAC3B,8EAA8E,CAC/E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC;AACpD,CAAC"}

package/dist/normalize-route-inference.d.ts

@@ -0,0 +1,4 @@
+import { type NormalizedDescriptor, type NormalizationWork } from "./normalize-types.js";
+/** Infers the routine route mapping from the target's runtime schemas. */
+export declare function inferRouteContract(work: NormalizationWork, descriptor: NormalizedDescriptor, value: Record<string, any>): void;
+//# sourceMappingURL=normalize-route-inference.d.ts.map

package/dist/normalize-route-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-inference.d.ts","sourceRoot":"","sources":["../src/normalize-route-inference.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAI9B,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,IAAI,CAKN"}

package/dist/normalize-route-inference.js

@@ -0,0 +1,117 @@
+import { schema, schemaProperties } from "./normalize-compat.js";
+import { add } from "./normalize-pass-utils.js";
+import { isErrorDescriptorLike, isRecord } from "./normalize-utils.js";
+import { NORMALIZE_CODES, } from "./normalize-types.js";
+const QUERY_METHODS = new Set(["GET", "HEAD", "DELETE", "OPTIONS"]);
+/** Infers the routine route mapping from the target's runtime schemas. */
+export function inferRouteContract(work, descriptor, value) {
+    if (value.raw === true)
+        return;
+    const target = isRecord(value.target) ? value.target : {};
+    if (value.request === undefined)
+        value.request = inferRequest(work, descriptor, value, target);
+    if (value.responses === undefined)
+        value.responses = inferResponses(value, target);
+}
+function inferRequest(work, descriptor, route, target) {
+    const projection = schemaProperties(target.input);
+    if (projection === undefined) {
+        add(work, descriptor, NORMALIZE_CODES.mapping, "Route request inference needs an object input schema; add an explicit request mapping.");
+        return { kind: "input", fields: {} };
+    }
+    const fields = {};
+    const parameters = pathParameters(String(route.path ?? ""));
+    for (const parameter of parameters) {
+        const property = projection.properties[parameter.name];
+        if (property === undefined)
+            continue;
+        if (parameter.catchAll && !allowsArray(property)) {
+            add(work, descriptor, NORMALIZE_CODES.mapping, `Catch-all path segment "${parameter.name}" must use an array schema.`);
+        }
+        const source = {
+            kind: parameter.catchAll ? "path-segments" : "path",
+            name: parameter.name,
+        };
+        fields[parameter.name] = parameter.optional ? { kind: "optional", value: source } : source;
+    }
+    const required = new Set(projection.required);
+    const body = !QUERY_METHODS.has(String(route.method));
+    for (const name of Object.keys(projection.properties).sort()) {
+        if (fields[name] !== undefined)
+            continue;
+        const property = projection.properties[name];
+        const source = body ? bodySource(route.accept, name, property) : { kind: "query", name };
+        const defaultValue = schemaDefault(property);
+        fields[name] =
+            defaultValue === undefined
+                ? required.has(name)
+                    ? source
+                    : { kind: "optional", value: source }
+                : { kind: "default", value: source, default: defaultValue };
+    }
+    return { kind: "input", fields };
+}
+function bodySource(accept, name, property) {
+    if (accept !== "multipart/form-data")
+        return { kind: "body", name };
+    return { kind: allowsArray(property) ? "multipart-all" : "multipart", name };
+}
+function inferResponses(route, target) {
+    const output = schema(target.output);
+    const status = route.successStatus ?? (isVoidSchema(output.schema) ? 204 : 200);
+    const responses = [
+        {
+            kind: "success",
+            id: `success.${status}`,
+            status,
+            ...(status === 204 || isVoidSchema(output.schema) ? {} : { schema: target.output }),
+        },
+    ];
+    for (const error of Array.isArray(target.errors) ? target.errors : []) {
+        if (!isErrorDescriptorLike(error))
+            continue;
+        const status = isRecord(error.http) && typeof error.http.status === "number" ? error.http.status : 500;
+        responses.push({
+            kind: "error",
+            id: `error.${String(error.id)}.${status}`,
+            status,
+            errorId: error.id,
+            ...(error.data === undefined ? {} : { schema: error.data }),
+        });
+    }
+    responses.push({ kind: "validation-error", id: "validation.422", status: 422 });
+    if (route.rateLimit !== undefined) {
+        responses.push({ kind: "response", id: "rate-limit.429", status: 429 });
+    }
+    return responses;
+}
+function pathParameters(path) {
+    const result = [];
+    for (const segment of path.split("/")) {
+        if (segment.startsWith(":")) {
+            result.push({ name: segment.slice(1), catchAll: false, optional: false });
+        }
+        if (segment.startsWith("*")) {
+            result.push({
+                name: segment.slice(1).replace(/\?$/, ""),
+                catchAll: true,
+                optional: segment.endsWith("?"),
+            });
+        }
+    }
+    return result;
+}
+function allowsArray(value) {
+    if (!isRecord(value))
+        return false;
+    if (value.type === "array")
+        return true;
+    return [value.anyOf, value.oneOf].some((variants) => Array.isArray(variants) && variants.some(allowsArray));
+}
+function schemaDefault(value) {
+    return isRecord(value) && "default" in value ? value.default : undefined;
+}
+function isVoidSchema(value) {
+    return isRecord(value) && value["x-relkit-void"] === true;
+}
+//# sourceMappingURL=normalize-route-inference.js.map

package/dist/normalize-route-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-inference.js","sourceRoot":"","sources":["../src/normalize-route-inference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAChC,IAAuB,EACvB,UAAgC,EAChC,KAA0B;IAE1B,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO;IAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/F,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,YAAY,CACnB,IAAuB,EACvB,UAAgC,EAChC,KAA0B,EAC1B,MAA2B;IAE3B,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,GAAG,CACD,IAAI,EACJ,UAAU,EACV,eAAe,CAAC,OAAO,EACvB,wFAAwF,CACzF,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS;QACrC,IAAI,SAAS,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjD,GAAG,CACD,IAAI,EACJ,UAAU,EACV,eAAe,CAAC,OAAO,EACvB,2BAA2B,SAAS,CAAC,IAAI,6BAA6B,CACvE,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM;YACnD,IAAI,EAAE,SAAS,CAAC,IAAI;SACrB,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7F,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7D,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS;QACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzF,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,YAAY,KAAK,SAAS;gBACxB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;oBAClB,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE;gBACvC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,UAAU,CACjB,MAAe,EACf,IAAY,EACZ,QAAiB;IAEjB,IAAI,MAAM,KAAK,qBAAqB;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACpE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;AAC/E,CAAC;AAED,SAAS,cAAc,CACrB,KAA0B,EAC1B,MAA2B;IAE3B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChF,MAAM,SAAS,GAA8B;QAC3C;YACE,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,WAAW,MAAM,EAAE;YACvB,MAAM;YACN,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;SACpF;KACF,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtE,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC;YAAE,SAAS;QAC5C,MAAM,MAAM,GACV,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1F,SAAS,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,OAAO;YACb,EAAE,EAAE,SAAS,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE;YACzC,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAQD,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;gBACzC,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CACpC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;AAC5D,CAAC"}

package/dist/normalize-schema-validation.d.ts

@@ -0,0 +1,3 @@
+import { type NormalizationWork } from "./normalize-types.js";
+export declare function passSchemas(work: NormalizationWork): void;
+//# sourceMappingURL=normalize-schema-validation.d.ts.map

package/dist/normalize-schema-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-schema-validation.d.ts","sourceRoot":"","sources":["../src/normalize-schema-validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CA6BzD"}

package/dist/normalize-schema-validation.js

@@ -0,0 +1,50 @@
+import { schema, schemaEntries } from "./normalize-compat.js";
+import { add } from "./normalize-pass-utils.js";
+import { NORMALIZE_CODES } from "./normalize-types.js";
+import { schemaKey } from "./normalize-utils.js";
+export function passSchemas(work) {
+    const seen = new Set();
+    const descriptors = [...work.descriptors, ...work.transformReferences.values()];
+    for (const descriptor of descriptors) {
+        if (seen.has(descriptor.value))
+            continue;
+        seen.add(descriptor.value);
+        for (const [key, value] of schemaEntries(descriptor)) {
+            validateSchema(work, descriptor, key, value);
+        }
+        const value = isRecord(descriptor.value) ? descriptor.value : {};
+        for (const field of requiredSchemaFields(descriptor.kind)) {
+            if (value[field] === undefined)
+                validateSchema(work, descriptor, schemaKey(descriptor.id, field), value[field]);
+        }
+        if (descriptor.kind === "transform")
+            validateSchema(work, descriptor, `${descriptor.id}:transform`, value.schema);
+        if (descriptor.kind === "route" && Array.isArray(value.responses)) {
+            for (const response of value.responses) {
+                if (isRecord(response) && response.schema !== undefined) {
+                    validateSchema(work, descriptor, `${descriptor.id}:response:${String(response.id)}`, response.schema);
+                }
+            }
+        }
+    }
+}
+function requiredSchemaFields(kind) {
+    return ({
+        function: ["input", "output"],
+        job: ["input"],
+        event: ["payload"],
+        cache: ["key", "value"],
+        agent: ["input", "output"],
+    }[kind] ?? []);
+}
+function validateSchema(work, descriptor, key, value) {
+    const result = schema(value);
+    if (!result.ok)
+        add(work, descriptor, NORMALIZE_CODES.schema, `${key} cannot produce deterministic JSON Schema: ${result.reason ?? "unavailable"}.`);
+    else if (result.schema !== undefined)
+        work.schemas.set(key, result.schema);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=normalize-schema-validation.js.map

package/dist/normalize-schema-validation.js.map

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

package/dist/normalize-source-identities.d.ts

@@ -0,0 +1,3 @@
+import { type NormalizedDescriptor, type NormalizationWork } from "./normalize-types.js";
+export declare function normalizeSourceIdentities(work: NormalizationWork, descriptors: readonly NormalizedDescriptor[]): NormalizedDescriptor[];
+//# sourceMappingURL=normalize-source-identities.d.ts.map

package/dist/normalize-source-identities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-source-identities.d.ts","sourceRoot":"","sources":["../src/normalize-source-identities.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAgB9B,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,SAAS,oBAAoB,EAAE,GAC3C,oBAAoB,EAAE,CA6CxB"}

package/dist/normalize-source-identities.js

@@ -0,0 +1,158 @@
+import { encodeErrorId, encodeMemberId, encodeSourceId } from "./discovery/source-id.js";
+import { add } from "./normalize-pass-utils.js";
+import { id, isRecord, refId } from "./normalize-utils.js";
+import { rewriteIdentityRef, rewriteIdentityValues } from "./normalize-identity-rewrite.js";
+import { NORMALIZE_CODES, } from "./normalize-types.js";
+const SOURCE_SCOPED_KINDS = new Set([
+    "app",
+    "constants",
+    "prompt",
+    "data-model",
+    "function",
+    "route",
+    "service",
+    "tool",
+    "agent",
+    "error",
+    "middleware",
+    "transform",
+    "service-middleware",
+]);
+export function normalizeSourceIdentities(work, descriptors) {
+    const candidates = descriptors.map(candidate);
+    const identities = new Map();
+    for (const entry of candidates) {
+        if (!entry.inferred)
+            continue;
+        const resolved = derive(entry.descriptor, work);
+        if (resolved === undefined) {
+            add(work, entry.descriptor, NORMALIZE_CODES.identityAmbiguous, `Cannot infer a stable ${entry.descriptor.kind} ID from this source binding.`, "error", undefined, "Provide an explicit id or export/bind the descriptor in a statically identifiable form.");
+            continue;
+        }
+        entry.resolved = resolved;
+        identities.set(entry.originalId, resolved);
+    }
+    addServiceMemberIdentities(candidates, identities);
+    addNestedErrorIdentities(candidates, identities);
+    return descriptors.map((descriptor, index) => {
+        const entry = candidates[index];
+        const resolved = entry.resolved ?? descriptor.id;
+        const rewritten = rewriteIdentityValues(descriptor.value, identities, new Set());
+        const value = isRecord(rewritten) && entry.resolved !== undefined
+            ? {
+                ...rewritten,
+                id: resolved,
+                ref: rewriteIdentityRef(rewritten.ref, identities, descriptor.kind, resolved),
+            }
+            : rewritten;
+        return {
+            ...descriptor,
+            id: resolved,
+            identity: entry.inferred ? "inferred" : "explicit",
+            value,
+            ...(descriptor.reference === undefined
+                ? {}
+                : { reference: { ...descriptor.reference, descriptorId: resolved } }),
+        };
+    });
+}
+function candidate(descriptor) {
+    const factory = descriptor.exportFact?.factory;
+    const presence = descriptor.exportFact?.errorBinding?.id ?? factory?.id;
+    const inferred = SOURCE_SCOPED_KINDS.has(descriptor.kind) &&
+        ((descriptor.kind === "data-model" && descriptor.id.startsWith("unbound.")) ||
+            presence === "omitted" ||
+            ((presence === undefined || descriptor.kind === "middleware") &&
+                descriptor.id.startsWith("unbound.")));
+    return { descriptor, originalId: descriptor.id, inferred };
+}
+function derive(descriptor, work) {
+    const value = isRecord(descriptor.value) ? descriptor.value : {};
+    const fact = descriptor.exportFact;
+    if (descriptor.kind === "data-model")
+        return encodeSourceId({
+            kind: "data-model",
+            source: descriptor.source.file,
+            ...(work.input.projectRoot === undefined ? {} : { projectRoot: work.input.projectRoot }),
+            exportName: descriptor.exportName,
+            exportKind: descriptor.exportKind,
+        });
+    if (fact === undefined)
+        return undefined;
+    if (descriptor.kind === "app")
+        return work.input.appId;
+    const binding = fact?.binding ?? fact?.factory?.binding;
+    if (descriptor.kind === "error" || fact?.errorBinding !== undefined) {
+        const errorBinding = fact?.errorBinding?.binding ?? binding;
+        return errorBinding === undefined
+            ? undefined
+            : encodeErrorId(descriptor.source.file, errorBinding, undefined, work.input.projectRoot);
+    }
+    if (!SOURCE_SCOPED_KINDS.has(descriptor.kind) || fact.factory?.idOptional !== true)
+        return undefined;
+    const route = descriptor.kind === "route"
+        ? {
+            ...(typeof value.method === "string" ? { method: value.method } : {}),
+            ...(typeof value.path === "string" ? { path: value.path } : {}),
+        }
+        : {};
+    return encodeSourceId({
+        kind: descriptor.kind,
+        source: descriptor.source.file,
+        ...(work.input.projectRoot === undefined ? {} : { projectRoot: work.input.projectRoot }),
+        exportName: descriptor.exportName,
+        exportKind: descriptor.exportKind,
+        ...(binding === undefined ? {} : { binding }),
+        ...route,
+    });
+}
+function addServiceMemberIdentities(candidates, identities) {
+    for (const entry of candidates.filter(({ descriptor }) => descriptor.kind === "service")) {
+        const serviceId = entry.resolved ?? (entry.inferred ? undefined : entry.descriptor.id);
+        if (serviceId === undefined)
+            continue;
+        const value = isRecord(entry.descriptor.value) ? entry.descriptor.value : {};
+        const functions = isRecord(value.functions) ? value.functions : {};
+        for (const [member, target] of Object.entries(functions)) {
+            const targetId = id(isRecord(target) ? target.id : refId(target));
+            if (targetId === undefined || !targetId.startsWith("unbound."))
+                continue;
+            const memberId = encodeMemberId(serviceId, member);
+            if (memberId !== undefined)
+                identities.set(targetId, memberId);
+        }
+    }
+}
+function addNestedErrorIdentities(candidates, identities) {
+    for (const { descriptor } of candidates) {
+        const bindings = (descriptor.facts?.errorBindings ?? []).filter(({ id: presence }) => presence === "omitted");
+        const errors = collect(descriptor.value, "error").filter(({ id }) => id.startsWith("unbound."));
+        for (const [index, binding] of bindings.entries()) {
+            const error = errors[index];
+            const errorId = error === undefined ? undefined : encodeErrorId(descriptor.source.file, binding.binding);
+            if (error !== undefined && errorId !== undefined)
+                identities.set(error.id, errorId);
+        }
+    }
+}
+function collect(value, kind, active = new Set()) {
+    if (Array.isArray(value)) {
+        if (active.has(value))
+            return [];
+        active.add(value);
+        const result = value.flatMap((child) => collect(child, kind, active));
+        active.delete(value);
+        return result;
+    }
+    if (!isRecord(value))
+        return [];
+    if (active.has(value))
+        return [];
+    active.add(value);
+    const result = value.kind === kind ? [value] : [];
+    for (const child of Object.values(value))
+        result.push(...collect(child, kind, active));
+    active.delete(value);
+    return result;
+}
+//# sourceMappingURL=normalize-source-identities.js.map

package/dist/normalize-source-identities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-source-identities.js","sourceRoot":"","sources":["../src/normalize-source-identities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAC9B,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,KAAK;IACL,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,OAAO;IACP,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;IACP,YAAY;IACZ,WAAW;IACX,oBAAoB;CACrB,CAAC,CAAC;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAuB,EACvB,WAA4C;IAE5C,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,SAAS;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,GAAG,CACD,IAAI,EACJ,KAAK,CAAC,UAAU,EAChB,eAAe,CAAC,iBAAiB,EACjC,yBAAyB,KAAK,CAAC,UAAU,CAAC,IAAI,+BAA+B,EAC7E,OAAO,EACP,SAAS,EACT,yFAAyF,CAC1F,CAAC;YACF,SAAS;QACX,CAAC;QACD,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC1B,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IACD,0BAA0B,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACnD,wBAAwB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,UAAU,CAAC,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,qBAAqB,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACjF,MAAM,KAAK,GACT,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YACjD,CAAC,CAAC;gBACE,GAAG,SAAS;gBACZ,EAAE,EAAE,QAAQ;gBACZ,GAAG,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;aAC9E;YACH,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO;YACL,GAAG,UAAU;YACb,EAAE,EAAE,QAAQ;YACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;YAClD,KAAK;YACL,GAAG,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS;gBACpC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,CAAC;SACxE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAOD,SAAS,SAAS,CAAC,UAAgC;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,IAAI,OAAO,EAAE,EAAE,CAAC;IACxE,MAAM,QAAQ,GACZ,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QACxC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,YAAY,IAAI,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACzE,QAAQ,KAAK,SAAS;YACtB,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,YAAY,CAAC;gBAC3D,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC;AAC7D,CAAC;AACD,SAAS,MAAM,CAAC,UAAgC,EAAE,IAAuB;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC;IACnC,IAAI,UAAU,CAAC,IAAI,KAAK,YAAY;QAClC,OAAO,cAAc,CAAC;YACpB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;YAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACxF,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,UAAU,EAAE,UAAU,CAAC,UAAU;SAClC,CAAC,CAAC;IACL,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;IACxD,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QACpE,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,EAAE,OAAO,IAAI,OAAO,CAAC;QAC5D,OAAO,YAAY,KAAK,SAAS;YAC/B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI;QAChF,OAAO,SAAS,CAAC;IACnB,MAAM,KAAK,GACT,UAAU,CAAC,IAAI,KAAK,OAAO;QACzB,CAAC,CAAC;YACE,GAAG,CAAC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE;QACH,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,UAAU,CAAC,IAAoD;QACrE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;QAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACxF,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,GAAG,KAAK;KACT,CAAC,CAAC;AACL,CAAC;AACD,SAAS,0BAA0B,CACjC,UAAwC,EACxC,UAA+B;IAE/B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;QACzF,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACvF,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS;QACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAClE,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,SAAS;YACzE,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACnD,IAAI,QAAQ,KAAK,SAAS;gBAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;AACH,CAAC;AACD,SAAS,wBAAwB,CAC/B,UAAwC,EACxC,UAA+B;IAE/B,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,UAAU,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAC7D,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,CAC7C,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QAChG,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,OAAO,GACX,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3F,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;gBAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;AACH,CAAC;AACD,SAAS,OAAO,CAAC,KAAc,EAAE,IAAY,EAAE,SAAS,IAAI,GAAG,EAAU;IACvE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACvF,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}