@relkit/openapi 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @relkit/openapi
+
+Unsupported internal OpenAPI generator for RELKIT; use @relkit/cli.
+
+See [@relkit/app](https://github.com/rel-kit/relkit) for supported application APIs.

package/dist/generate-request.d.ts

@@ -0,0 +1,7 @@
+import type { JsonValue } from "@relkit/contracts";
+import type { OpenApiOperation, OpenApiParameter } from "./generate.js";
+export declare function buildRequest(mapping: JsonValue, root: JsonValue, routePath: string): {
+    readonly parameters: OpenApiParameter[];
+    readonly body?: OpenApiOperation["requestBody"];
+};
+//# sourceMappingURL=generate-request.d.ts.map

package/dist/generate-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-request.d.ts","sourceRoot":"","sources":["../src/generate-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAEV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,eAAe,CAAC;AASvB,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,MAAM,GAChB;IAAE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;CAAE,CAiC9F"}

package/dist/generate-request.js

@@ -0,0 +1,112 @@
+export function buildRequest(mapping, root, routePath) {
+    const parameters = [];
+    const bodies = [];
+    collect(mapping, [], root, parameters, bodies, false, false);
+    const routeNames = routeParameters(routePath);
+    const declared = new Set(routeNames);
+    const matching = parameters.filter((entry) => entry.in !== "path" || declared.has(entry.name));
+    const parameterKeys = new Set(matching.map((entry) => `${entry.in}:${entry.name}`));
+    for (const name of routeNames) {
+        if (!parameterKeys.has(`path:${name}`))
+            matching.push({ name, in: "path", required: true, schema: { type: "string" } });
+    }
+    matching.sort((left, right) => `${left.in}:${left.name}`.localeCompare(`${right.in}:${right.name}`));
+    if (bodies.length === 0)
+        return { parameters: matching };
+    const groups = new Map();
+    for (const entry of bodies) {
+        const media = entry.kind.startsWith("multipart") ? "multipart/form-data" : "application/json";
+        const group = groups.get(media) ?? [];
+        group.push(entry);
+        groups.set(media, group);
+    }
+    const content = {};
+    let required = false;
+    for (const [media, entries] of [...groups.entries()].sort(([left], [right]) => left.localeCompare(right))) {
+        required ||= entries.some((entry) => entry.required);
+        const whole = entries.length === 1 && entries[0]?.kind === "whole-body";
+        content[media] = { schema: whole ? entries[0].schema : objectSchema(entries) };
+    }
+    return { parameters: matching, body: { required, content } };
+}
+function collect(value, path, root, parameters, bodies, optional, defaulted) {
+    if (!isRecord(value) || typeof value.kind !== "string")
+        return;
+    if ((value.kind === "input" || value.kind === "nested") && isRecord(value.fields)) {
+        for (const [name, child] of Object.entries(value.fields))
+            collect(child, [...path, name], root, parameters, bodies, optional, defaulted);
+        return;
+    }
+    if (value.kind === "optional" || value.kind === "default" || value.kind === "transform") {
+        collect(value.value, path, root, parameters, bodies, optional || value.kind === "optional", defaulted || value.kind === "default");
+        return;
+    }
+    const schema = schemaAt(root, path) ?? {};
+    if (isParameterKind(value.kind)) {
+        const name = typeof value.name === "string" ? value.name : (path.at(-1) ?? "value");
+        parameters.push({
+            name,
+            in: value.kind === "path-segments" ? "path" : value.kind,
+            required: value.kind === "path" || value.kind === "path-segments" || (!optional && !defaulted),
+            schema: value.kind === "path-segments" ? { type: "string" } : schema,
+        });
+    }
+    else if (value.kind === "body" ||
+        value.kind === "multipart" ||
+        value.kind === "multipart-all" ||
+        value.kind === "whole-body") {
+        bodies.push({
+            kind: value.kind,
+            ...(typeof value.name === "string" ? { name: value.name } : {}),
+            schema,
+            required: !optional && !defaulted,
+        });
+    }
+}
+function objectSchema(entries) {
+    const properties = {};
+    const required = [];
+    for (const entry of [...entries].sort((left, right) => String(left.name).localeCompare(String(right.name)))) {
+        if (entry.name === undefined)
+            return entry.schema;
+        properties[entry.name] = entry.schema;
+        if (entry.required)
+            required.push(entry.name);
+    }
+    return { type: "object", properties, ...(required.length === 0 ? {} : { required }) };
+}
+function schemaValue(value) {
+    if (!isRecord(value))
+        return undefined;
+    return value.$relkit === "schema" && isRecord(value.jsonSchema)
+        ? value.jsonSchema
+        : value;
+}
+function schemaAt(root, path) {
+    let current = schemaValue(root);
+    for (const name of path) {
+        const properties = current?.properties;
+        if (!isRecord(properties))
+            return undefined;
+        current = schemaValue(properties[name]);
+    }
+    return current;
+}
+function routeParameters(path) {
+    return path.split("/").flatMap((segment, index) => {
+        if (segment.startsWith(":"))
+            return [parameterName(segment.slice(1), index)];
+        return segment.startsWith("*") ? [parameterName(segment.slice(1), index, "wildcard")] : [];
+    });
+}
+function parameterName(value, index, fallback = "param") {
+    const result = value.replace(/[^A-Za-z0-9_.-]/g, "_");
+    return result || `${fallback}${index}`;
+}
+function isParameterKind(value) {
+    return ["path", "path-segments", "query", "header", "cookie"].includes(value);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=generate-request.js.map

package/dist/generate-request.js.map

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

package/dist/generate-response.d.ts

@@ -0,0 +1,5 @@
+import type { JsonValue } from "@relkit/contracts";
+import type { FunctionNode } from "@relkit/graph";
+import type { OpenApiResponse } from "./generate.js";
+export declare function buildResponses(values: JsonValue, target: FunctionNode): Record<string, OpenApiResponse>;
+//# sourceMappingURL=generate-response.d.ts.map

package/dist/generate-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-response.d.ts","sourceRoot":"","sources":["../src/generate-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,eAAe,CAAC;AA+BpE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAgCjC"}

package/dist/generate-response.js

@@ -0,0 +1,150 @@
+const validationSchema = {
+    type: "object",
+    required: ["error", "issues"],
+    properties: {
+        error: { const: "validation", type: "string" },
+        issues: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["code", "message", "path"],
+                properties: {
+                    code: { type: "string" },
+                    message: { type: "string" },
+                    path: { type: "array", items: { anyOf: [{ type: "string" }, { type: "integer" }] } },
+                },
+            },
+        },
+    },
+};
+const rateLimitSchema = {
+    type: "object",
+    required: ["error", "retryAfterMs"],
+    properties: {
+        error: { const: "rate-limit", type: "string" },
+        retryAfterMs: { type: "integer", minimum: 0 },
+    },
+};
+export function buildResponses(values, target) {
+    const result = {};
+    const entries = (Array.isArray(values) ? values : [])
+        .filter(isRecord)
+        .sort((left, right) => Number(left.status) - Number(right.status) ||
+        String(left.id).localeCompare(String(right.id)));
+    const hasValidation = entries.some((entry) => entry.kind === "validation-error");
+    for (const entry of entries) {
+        const status = String(entry.status);
+        const schema = entry.kind === "success"
+            ? (schemaValue(entry.schema) ?? schemaValue(target.output))
+            : entry.kind === "validation-error"
+                ? (schemaValue(entry.schema) ?? validationSchema)
+                : entry.kind === "error"
+                    ? errorSchema(entry, target)
+                    : schemaValue(entry.schema);
+        const rateLimited = status === "429" && String(entry.id).startsWith("rate-limit");
+        const next = makeResponse(rateLimited ? "Rate limit exceeded" : description(entry), status === "204" || status === "304"
+            ? undefined
+            : (schema ?? (rateLimited ? rateLimitSchema : undefined)), rateLimited);
+        result[status] = result[status] === undefined ? next : mergeResponses(result[status], next);
+    }
+    if (!hasValidation)
+        result["422"] = makeResponse("Validation error", validationSchema);
+    return result;
+}
+function errorSchema(entry, target) {
+    const errorId = typeof entry.errorId === "string" ? entry.errorId : String(entry.id ?? "error");
+    const definition = Array.isArray(target.errors)
+        ? target.errors.filter(isRecord).find((item) => item.id === errorId)
+        : undefined;
+    const definitionHttp = isRecord(definition?.http) ? definition.http : undefined;
+    const status = typeof definitionHttp?.status === "number" ? definitionHttp.status : undefined;
+    const retry = definition?.retry === "never" || definition?.retry === "later" ? definition.retry : undefined;
+    const data = schemaValue(entry.schema) ??
+        (definition === undefined ? undefined : schemaValue(definition.data));
+    return {
+        type: "object",
+        required: [
+            "kind",
+            "outcome",
+            "code",
+            "message",
+            ...(data === undefined ? [] : ["data"]),
+            ...(status === undefined ? [] : ["status"]),
+            "retry",
+        ],
+        properties: {
+            kind: { const: "application", type: "string" },
+            outcome: { const: "declared-error", type: "string" },
+            code: { const: errorId, type: "string" },
+            message: { type: "string" },
+            ...(data === undefined ? {} : { data }),
+            ...(status === undefined
+                ? { status: { type: "integer", minimum: 100, maximum: 599 } }
+                : { status: { const: status, type: "integer" } }),
+            retry: retry === undefined ? { enum: ["never", "later"] } : { const: retry, type: "string" },
+        },
+    };
+}
+function mergeResponses(left, right) {
+    const a = left.content?.["application/json"]?.schema;
+    const b = right.content?.["application/json"]?.schema;
+    if (!a || !b) {
+        return {
+            description: `${left.description}; ${right.description}`,
+            ...(left.content === undefined ? right.content : { content: left.content }),
+        };
+    }
+    return {
+        description: `${left.description}; ${right.description}`,
+        content: { "application/json": { schema: { oneOf: [a, b] } } },
+    };
+}
+function makeResponse(description, schema, rateLimited = false) {
+    return {
+        description,
+        ...(schema === undefined ? {} : { content: { "application/json": { schema } } }),
+        ...(rateLimited ? { headers: rateLimitHeaders } : {}),
+    };
+}
+const rateLimitHeaders = {
+    "RateLimit-Policy": {
+        description: "Limit and window policy applied to the route",
+        schema: { type: "string" },
+    },
+    "RateLimit-Limit": {
+        description: "Request limit for the active window",
+        schema: { type: "integer" },
+    },
+    "RateLimit-Remaining": {
+        description: "Requests remaining in the active window",
+        schema: { type: "integer" },
+    },
+    "RateLimit-Reset": {
+        description: "Seconds until the active window resets",
+        schema: { type: "integer" },
+    },
+    "Retry-After": {
+        description: "Seconds before another request should be attempted",
+        schema: { type: "integer" },
+    },
+};
+function description(entry) {
+    if (entry.kind === "success")
+        return "Successful response";
+    if (entry.kind === "validation-error")
+        return "Validation error";
+    if (entry.kind === "error")
+        return `Declared error ${String(entry.errorId ?? entry.id)}`;
+    return `Response ${String(entry.id)}`;
+}
+function schemaValue(value) {
+    if (!isRecord(value))
+        return undefined;
+    return value.$relkit === "schema" && isRecord(value.jsonSchema)
+        ? value.jsonSchema
+        : value;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=generate-response.js.map

package/dist/generate-response.js.map

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

package/dist/generate-services.d.ts

@@ -0,0 +1,10 @@
+import type { ApplicationGraph, FunctionNode, ServiceNode } from "@relkit/graph";
+import type { HttpGraphTrigger } from "./generate.js";
+export interface OpenApiServiceContext {
+    readonly byId: Map<string, ServiceNode>;
+    readonly byFunction: Map<string, ServiceNode>;
+    readonly sources: ServiceNode[];
+}
+export declare function serviceContext(graph: ApplicationGraph): OpenApiServiceContext;
+export declare function serviceFor(context: OpenApiServiceContext, trigger: HttpGraphTrigger, target: FunctionNode): ServiceNode | undefined;
+//# sourceMappingURL=generate-services.d.ts.map

package/dist/generate-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-services.d.ts","sourceRoot":"","sources":["../src/generate-services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAa,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;CACjC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,qBAAqB,CAS7E;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,YAAY,GACnB,WAAW,GAAG,SAAS,CAYzB"}

package/dist/generate-services.js

@@ -0,0 +1,49 @@
+export function serviceContext(graph) {
+    const sources = graph.nodes.filter(isServiceNode);
+    const byId = new Map(sources.map((service) => [service.id, service]));
+    const byFunction = new Map();
+    for (const service of sources)
+        for (const member of service.members)
+            byFunction.set(member.functionId, service);
+    for (const node of graph.nodes)
+        if (node.kind === "function")
+            registerExplicitService(node, byId, byFunction, sources);
+    return { byId, byFunction, sources };
+}
+export function serviceFor(context, trigger, target) {
+    const memberService = context.byFunction.get(target.id);
+    if (memberService !== undefined)
+        return memberService;
+    const id = serviceId(trigger);
+    if (id === undefined)
+        return undefined;
+    const existing = context.byId.get(id);
+    if (existing !== undefined)
+        return existing;
+    const service = syntheticService(id, trigger.source);
+    context.byId.set(id, service);
+    context.byFunction.set(target.id, service);
+    context.sources.push(service);
+    return service;
+}
+function isServiceNode(node) {
+    return node.kind === "service";
+}
+function registerExplicitService(node, byId, byFunction, sources) {
+    const id = serviceId(node);
+    if (id === undefined || byFunction.has(node.id))
+        return;
+    const service = byId.get(id) ?? syntheticService(id, node.source);
+    byId.set(id, service);
+    byFunction.set(node.id, service);
+    if (!sources.some((entry) => entry.id === id))
+        sources.push(service);
+}
+function syntheticService(id, source) {
+    return { kind: "service", id, source, members: [], middleware: [] };
+}
+function serviceId(value) {
+    const id = value.serviceId;
+    return typeof id === "string" && id.length > 0 ? id : undefined;
+}
+//# sourceMappingURL=generate-services.js.map

package/dist/generate-services.js.map

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

package/dist/generate-tags.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceNode } from "@relkit/graph";
+export interface OpenApiTag {
+    readonly name: string;
+    readonly description?: string;
+}
+type ServiceTagSource = Pick<ServiceNode, "id" | "title" | "description" | "tags">;
+export declare function serviceTagNames(service: ServiceTagSource): readonly string[];
+export declare function operationTags(service: ServiceTagSource | undefined, routeTags: readonly string[] | undefined): readonly string[];
+export declare function documentTags(services: readonly ServiceTagSource[], routeTags: readonly string[]): readonly OpenApiTag[];
+export {};
+//# sourceMappingURL=generate-tags.d.ts.map

package/dist/generate-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tags.d.ts","sourceRoot":"","sources":["../src/generate-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,KAAK,gBAAgB,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC,CAAC;AAEnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,MAAM,EAAE,CAG5E;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACvC,SAAS,MAAM,EAAE,CAMnB;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,SAAS,UAAU,EAAE,CAavB"}

package/dist/generate-tags.js

@@ -0,0 +1,27 @@
+export function serviceTagNames(service) {
+    const names = [...new Set((service.tags ?? []).filter((tag) => tag.length > 0))].sort();
+    return names.length === 0 ? [service.id] : names;
+}
+export function operationTags(service, routeTags) {
+    return [
+        ...new Set([...(service === undefined ? [] : serviceTagNames(service)), ...(routeTags ?? [])]),
+    ]
+        .filter((tag) => tag.length > 0)
+        .sort();
+}
+export function documentTags(services, routeTags) {
+    const tags = new Map();
+    for (const service of [...services].sort((left, right) => left.id.localeCompare(right.id))) {
+        for (const name of serviceTagNames(service)) {
+            if (!tags.has(name)) {
+                const description = service.description ?? service.title;
+                tags.set(name, description === undefined ? { name } : { name, description });
+            }
+        }
+    }
+    for (const name of [...new Set(routeTags)].filter((tag) => tag.length > 0).sort())
+        if (!tags.has(name))
+            tags.set(name, { name });
+    return [...tags.values()].sort((left, right) => left.name.localeCompare(right.name));
+}
+//# sourceMappingURL=generate-tags.js.map

package/dist/generate-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tags.js","sourceRoot":"","sources":["../src/generate-tags.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxF,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAAqC,EACrC,SAAwC;IAExC,OAAO;QACL,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;KAC/F;SACE,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAqC,EACrC,SAA4B;IAE5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC3C,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC3F,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;gBACzD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;QAC/E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/dist/generate-utils.d.ts

@@ -0,0 +1,5 @@
+import type { FunctionNode, ServiceNode } from "@relkit/graph";
+import type { HttpGraphTrigger, OpenApiOperation } from "./generate.js";
+export declare function buildOperation(trigger: HttpGraphTrigger, target: FunctionNode, routePath?: string, operationId?: string, service?: ServiceNode): OpenApiOperation;
+export declare function openApiPath(value: string): string;
+//# sourceMappingURL=generate-utils.d.ts.map

package/dist/generate-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-utils.d.ts","sourceRoot":"","sources":["../src/generate-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKxE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,YAAY,EACpB,SAAS,SAAsB,EAC/B,WAAW,SAAa,EACxB,OAAO,CAAC,EAAE,WAAW,GACpB,gBAAgB,CAsBlB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYjD"}

package/dist/generate-utils.js

@@ -0,0 +1,43 @@
+import { buildRequest } from "./generate-request.js";
+import { buildResponses } from "./generate-response.js";
+import { operationTags } from "./generate-tags.js";
+export function buildOperation(trigger, target, routePath = trigger.config.path, operationId = trigger.id, service) {
+    const request = buildRequest(trigger.config.request, target.input, routePath);
+    const tags = operationTags(service, trigger.config.tags);
+    return {
+        operationId,
+        ...(trigger.config.title === undefined ? {} : { summary: trigger.config.title }),
+        ...(trigger.config.description === undefined
+            ? {}
+            : { description: trigger.config.description }),
+        ...(tags.length === 0 ? {} : { tags }),
+        ...(request.parameters.length === 0 ? {} : { parameters: request.parameters }),
+        ...(request.body === undefined ? {} : { requestBody: request.body }),
+        responses: buildResponses(trigger.config.responses, target),
+        "x-relkit": {
+            routeId: trigger.id,
+            functionId: target.id,
+            ...(service === undefined ? {} : { serviceId: service.id }),
+            middleware: trigger.config.middleware.map((entry) => ({ ...entry })),
+            transforms: trigger.config.transforms.map((entry) => entry.id),
+            ...(trigger.config.rateLimit === undefined ? {} : { rateLimit: trigger.config.rateLimit }),
+        },
+    };
+}
+export function openApiPath(value) {
+    return (value
+        .split("/")
+        .map((segment, index) => {
+        if (segment.startsWith(":"))
+            return `{${parameterName(segment.slice(1), index)}}`;
+        if (segment.startsWith("*"))
+            return `{${parameterName(segment.slice(1), index, "wildcard")}}`;
+        return segment;
+    })
+        .join("/") || "/");
+}
+function parameterName(value, index, fallback = "param") {
+    const result = value.replace(/[^A-Za-z0-9_.-]/g, "_");
+    return result || `${fallback}${index}`;
+}
+//# sourceMappingURL=generate-utils.js.map

package/dist/generate-utils.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,79 @@
+import { type JsonValue } from "@relkit/contracts";
+import type { ApplicationGraph, GraphNode, HttpTriggerConfig } from "@relkit/graph";
+import { type OpenApiTag } from "./generate-tags.js";
+export type OpenApiSchema = {
+    readonly [key: string]: JsonValue;
+};
+export interface OpenApiParameter {
+    readonly name: string;
+    readonly in: "path" | "query" | "header" | "cookie";
+    readonly required: boolean;
+    readonly schema: OpenApiSchema;
+}
+export interface OpenApiMediaType {
+    readonly schema: OpenApiSchema;
+}
+export interface OpenApiResponse {
+    readonly description: string;
+    readonly content?: Readonly<Record<string, OpenApiMediaType>>;
+    readonly headers?: Readonly<Record<string, {
+        readonly description: string;
+        readonly schema: OpenApiSchema;
+    }>>;
+}
+export interface OpenApiOperation {
+    readonly operationId: string;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly parameters?: readonly OpenApiParameter[];
+    readonly requestBody?: {
+        readonly required: boolean;
+        readonly content: Readonly<Record<string, OpenApiMediaType>>;
+    };
+    readonly responses: Readonly<Record<string, OpenApiResponse>>;
+    readonly "x-relkit": {
+        readonly routeId: string;
+        readonly functionId: string;
+        readonly serviceId?: string;
+        readonly middleware: readonly {
+            readonly id: string;
+            readonly path: string;
+            readonly order: number;
+            readonly match: "always" | "conditional";
+        }[];
+        readonly transforms: readonly string[];
+        readonly rateLimit?: JsonValue;
+    };
+}
+export interface OpenApiPathItem {
+    readonly [method: string]: OpenApiOperation | undefined;
+}
+export interface OpenApiDocument {
+    readonly openapi: "3.1.0";
+    readonly info: {
+        readonly title: string;
+        readonly version: string;
+    };
+    readonly jsonSchemaDialect: string;
+    readonly tags?: readonly OpenApiTag[];
+    readonly paths: Readonly<Record<string, OpenApiPathItem>>;
+    readonly "x-relkit": {
+        readonly version: number;
+        readonly contractVersion: number;
+        readonly graphVersion: number;
+        readonly generatorVersion: number;
+    };
+}
+export type HttpGraphTrigger = Extract<GraphNode, {
+    readonly kind: "trigger";
+}> & {
+    readonly triggerType: "http";
+    readonly config: HttpTriggerConfig;
+};
+export type { OpenApiTag } from "./generate-tags.js";
+/** Generates a deterministic OpenAPI 3.1 document from the serializable graph contract. */
+export declare function generateOpenApi(graph: ApplicationGraph): OpenApiDocument;
+/** Serializes OpenAPI with the repository's canonical JSON ordering. */
+export declare function generateOpenApiJson(graph: ApplicationGraph): string;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAgB,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElG,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGnE,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAClE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AACD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AACD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CACzB,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CACjF,CAAC;CACH;AACD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;KAC9D,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS;YAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC;SAC1C,EAAE,CAAC;QACJ,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;KAChC,CAAC;CACH;AACD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;CACzD;AACD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;KACnC,CAAC;CACH;AACD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAAG;IAChF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC,CAAC;AACF,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe,CA2DxE;AAYD,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEnE"}

package/dist/generate.js

@@ -0,0 +1,71 @@
+import { canonicalJson, CONTRACT_VERSION, GENERATOR_VERSION, GRAPH_VERSION, } from "@relkit/contracts";
+import { buildOperation, openApiPath } from "./generate-utils.js";
+import { documentTags } from "./generate-tags.js";
+import { serviceContext, serviceFor } from "./generate-services.js";
+/** Generates a deterministic OpenAPI 3.1 document from the serializable graph contract. */
+export function generateOpenApi(graph) {
+    const functions = new Map(graph.nodes
+        .filter((node) => node.kind === "function")
+        .map((node) => [node.id, node]));
+    const triggers = graph.nodes
+        .filter(isHttpTrigger)
+        .sort((left, right) => openApiPath(left.config.path).localeCompare(openApiPath(right.config.path)) ||
+        left.config.method.localeCompare(right.config.method) ||
+        left.id.localeCompare(right.id));
+    const services = serviceContext(graph);
+    const paths = {};
+    for (const trigger of triggers) {
+        const target = functions.get(trigger.targetFunctionId);
+        if (target === undefined) {
+            throw new TypeError(`HTTP trigger "${trigger.id}" targets missing function "${trigger.targetFunctionId}".`);
+        }
+        const service = serviceFor(services, trigger, target);
+        for (const [index, routePath] of openApiPaths(trigger.config.path).entries()) {
+            const path = openApiPath(routePath);
+            const method = trigger.config.method.toLowerCase();
+            const item = paths[path] ?? {};
+            if (item[method] !== undefined)
+                throw new TypeError(`Duplicate OpenAPI route "${method.toUpperCase()} ${path}".`);
+            paths[path] = {
+                ...item,
+                [method]: buildOperation(trigger, target, routePath, index === 0 ? trigger.id : `${trigger.id}.catch-all`, service),
+            };
+        }
+    }
+    const tags = documentTags(services.sources, triggers.flatMap((trigger) => trigger.config.tags ?? []));
+    return {
+        openapi: "3.1.0",
+        info: { title: graph.appId ?? "RelKit application", version: String(CONTRACT_VERSION) },
+        jsonSchemaDialect: "https://json-schema.org/draft/2020-12/schema",
+        ...(tags.length === 0 ? {} : { tags }),
+        paths,
+        "x-relkit": {
+            version: CONTRACT_VERSION,
+            contractVersion: CONTRACT_VERSION,
+            graphVersion: GRAPH_VERSION,
+            generatorVersion: GENERATOR_VERSION,
+        },
+    };
+}
+function openApiPaths(path) {
+    const segments = path.split("/");
+    const optional = segments.findIndex((segment) => segment.startsWith("*") && segment.endsWith("?"));
+    if (optional < 0)
+        return [path];
+    const base = segments.slice(0, optional).join("/") || "/";
+    return [base, path.replace(/\?$/, "")];
+}
+/** Serializes OpenAPI with the repository's canonical JSON ordering. */
+export function generateOpenApiJson(graph) {
+    return `${canonicalJson(generateOpenApi(graph))}\n`;
+}
+function isHttpTrigger(node) {
+    return (node.kind === "trigger" &&
+        node.triggerType === "http" &&
+        isRecord(node.config) &&
+        node.config.rawHandler !== true);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./generate.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,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./generate.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,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@relkit/openapi",
+  "version": "0.0.0",
+  "description": "Unsupported internal OpenAPI generator for RELKIT; use @relkit/cli.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rel-kit/relkit.git",
+    "directory": "packages/openapi"
+  },
+  "homepage": "https://github.com/rel-kit/relkit#readme",
+  "bugs": {
+    "url": "https://github.com/rel-kit/relkit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@relkit/contracts": "0.0.0",
+    "@relkit/graph": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "typecheck": "tsc -b --pretty false"
+  }
+}