@relayfile/adapter-core 0.1.0

package/dist/src/docs/generator.js

@@ -0,0 +1,368 @@
+import YAML from "yaml";
+export class SpecGenerator {
+    generate(extracted, options) {
+        const document = this.generateDocument(extracted, options);
+        validateOpenApiDocument(document);
+        return YAML.stringify(document, { lineWidth: 0 });
+    }
+    generateDocument(extracted, options) {
+        const registry = new SchemaRegistry();
+        const document = {
+            openapi: "3.0.3",
+            info: {
+                title: options.apiName,
+                version: options.apiVersion ?? "1.0.0",
+                description: options.apiDescription ?? extracted.description,
+            },
+            paths: {},
+            components: {
+                schemas: {},
+                securitySchemes: {},
+            },
+            "x-webhooks": {},
+        };
+        if (options.docsSource) {
+            document["x-docs-source"] = toSpecMetadata(options.docsSource, options.sync, options.llm);
+        }
+        const paths = document.paths;
+        for (const endpoint of extracted.endpoints) {
+            const pathItem = (paths[endpoint.path] ??= {});
+            const operation = {
+                summary: endpoint.summary,
+                description: endpoint.description,
+                operationId: toOperationId(endpoint.method, endpoint.path),
+                parameters: endpoint.parameters
+                    .filter((parameter) => parameter.in !== "body")
+                    .map((parameter) => ({
+                    name: parameter.name,
+                    in: parameter.in,
+                    required: parameter.required || parameter.in === "path",
+                    description: parameter.description,
+                    schema: simpleTypeSchema(parameter.type),
+                })),
+                responses: {
+                    "200": {
+                        description: "Successful response",
+                    },
+                },
+            };
+            if (endpoint.requestShape) {
+                operation.requestBody = {
+                    required: true,
+                    content: {
+                        "application/json": {
+                            schema: registry.referenceFor(endpoint.requestShape, `${registry.baseName(endpoint.method, endpoint.path)}Request`),
+                        },
+                    },
+                };
+            }
+            else {
+                const bodyParameter = endpoint.parameters.find((parameter) => parameter.in === "body");
+                if (bodyParameter) {
+                    operation.requestBody = {
+                        required: bodyParameter.required,
+                        content: {
+                            "application/json": {
+                                schema: simpleTypeSchema(bodyParameter.type),
+                            },
+                        },
+                    };
+                }
+            }
+            if (endpoint.responseShape) {
+                operation.responses = {
+                    "200": {
+                        description: "Successful response",
+                        content: {
+                            "application/json": {
+                                schema: registry.referenceFor(endpoint.responseShape, `${registry.baseName(endpoint.method, endpoint.path)}Response`),
+                            },
+                        },
+                    },
+                };
+            }
+            pathItem[endpoint.method.toLowerCase()] = operation;
+        }
+        const webhooks = document["x-webhooks"];
+        for (const webhook of extracted.webhooks) {
+            const webhookOperation = {
+                summary: webhook.summary,
+                requestBody: {
+                    required: true,
+                    content: {
+                        "application/json": {
+                            schema: registry.referenceFor(webhook.payloadShape ?? {}, `${toPascalCase(webhook.event)}Webhook`),
+                        },
+                    },
+                },
+                responses: {
+                    "200": {
+                        description: "Webhook accepted",
+                    },
+                },
+            };
+            if (webhook.deliveryFormat) {
+                webhookOperation["x-delivery-format"] = webhook.deliveryFormat;
+            }
+            webhooks[webhook.event] = { post: webhookOperation };
+        }
+        if (extracted.auth && extracted.auth.type !== "none") {
+            const scheme = authToSecurityScheme(extracted.auth);
+            if (scheme) {
+                document.components.securitySchemes.DefaultAuth = scheme;
+                for (const pathItem of Object.values(paths)) {
+                    for (const operation of Object.values(pathItem)) {
+                        if (operation && typeof operation === "object") {
+                            operation.security = [
+                                { DefaultAuth: [] },
+                            ];
+                        }
+                    }
+                }
+            }
+        }
+        const errors = extracted.errors ?? [];
+        if (errors.length > 0) {
+            const errorSchema = errors.reduce((shape, error) => mergeShape(shape, error.shape ?? {}), {});
+            document.components.schemas.Error = registry.inlineSchema(errorSchema);
+        }
+        document.components.schemas = {
+            ...document.components.schemas,
+            ...registry.schemas,
+        };
+        return document;
+    }
+}
+function validateOpenApiDocument(document) {
+    if (document.openapi !== "3.0.3") {
+        throw new Error("Generated document must target OpenAPI 3.0.3");
+    }
+    const info = asRecord(document.info);
+    if (!info?.title || !info.version) {
+        throw new Error("Generated document is missing info.title or info.version");
+    }
+    if (!isPlainObject(document.paths)) {
+        throw new Error("Generated document is missing paths");
+    }
+    if (!isPlainObject(document.components)) {
+        throw new Error("Generated document is missing components");
+    }
+}
+function toSpecMetadata(docsSource, sync, llm) {
+    return {
+        url: docsSource.url,
+        crawlPaths: docsSource.crawlPaths,
+        selectors: docsSource.selectors,
+        sync: sync
+            ? {
+                trigger: sync.trigger,
+                feedUrl: sync.feedUrl,
+                repo: sync.repo,
+            }
+            : undefined,
+        llm: llm
+            ? {
+                provider: llm.provider,
+                endpoint: llm.endpoint,
+                model: llm.model,
+                maxTokens: llm.maxTokens,
+                concurrency: llm.concurrency,
+                chunkSize: llm.chunkSize,
+            }
+            : undefined,
+    };
+}
+function simpleTypeSchema(type) {
+    switch (type.toLowerCase()) {
+        case "boolean":
+            return { type: "boolean" };
+        case "integer":
+            return { type: "integer" };
+        case "number":
+            return { type: "number" };
+        case "object":
+            return { type: "object", additionalProperties: true };
+        case "array":
+            return { type: "array", items: {} };
+        default:
+            return { type: "string" };
+    }
+}
+function authToSecurityScheme(auth) {
+    if (!auth) {
+        return undefined;
+    }
+    if (auth.type === "bearer") {
+        return { type: "http", scheme: "bearer" };
+    }
+    if (auth.type === "basic") {
+        return { type: "http", scheme: "basic" };
+    }
+    if (auth.type === "oauth2") {
+        return {
+            type: "oauth2",
+            flows: {
+                authorizationCode: {
+                    authorizationUrl: "https://example.com/oauth/authorize",
+                    tokenUrl: "https://example.com/oauth/token",
+                    scopes: {},
+                },
+            },
+        };
+    }
+    if (auth.type === "api-key") {
+        return {
+            type: "apiKey",
+            in: auth.location ?? "header",
+            name: auth.headerName ?? auth.name ?? "X-API-Key",
+        };
+    }
+    return undefined;
+}
+class SchemaRegistry {
+    schemas = {};
+    hashes = new Map();
+    baseName(method, path) {
+        return toPascalCase(`${method.toLowerCase()} ${path.replace(/[{}]/g, "")}`);
+    }
+    referenceFor(shape, preferredName) {
+        const schema = this.inlineSchema(shape);
+        const hash = JSON.stringify(schema);
+        const existing = this.hashes.get(hash);
+        if (existing) {
+            return { $ref: `#/components/schemas/${existing}` };
+        }
+        const name = this.uniqueName(preferredName);
+        this.hashes.set(hash, name);
+        this.schemas[name] = schema;
+        return { $ref: `#/components/schemas/${name}` };
+    }
+    inlineSchema(shape) {
+        if (looksLikeSchema(shape)) {
+            return normalizeSchemaLike(shape);
+        }
+        if (Array.isArray(shape)) {
+            return {
+                type: "array",
+                items: shape.length > 0 ? this.inlineSchema(shape[0]) : {},
+            };
+        }
+        if (isPlainObject(shape)) {
+            return {
+                type: "object",
+                properties: Object.fromEntries(Object.entries(shape).map(([key, value]) => [key, this.inlineSchema(value)])),
+                required: Object.keys(shape),
+            };
+        }
+        if (typeof shape === "boolean") {
+            return { type: "boolean", example: shape };
+        }
+        if (typeof shape === "number") {
+            return {
+                type: Number.isInteger(shape) ? "integer" : "number",
+                example: shape,
+            };
+        }
+        if (typeof shape === "string") {
+            return { type: "string", example: shape };
+        }
+        return {};
+    }
+    uniqueName(name) {
+        let candidate = toPascalCase(name);
+        let suffix = 2;
+        while (this.schemas[candidate]) {
+            candidate = `${toPascalCase(name)}${suffix}`;
+            suffix += 1;
+        }
+        return candidate;
+    }
+}
+function normalizeSchemaLike(shape) {
+    const record = asRecord(shape) ?? {};
+    const properties = asRecord(record.properties);
+    return {
+        ...(typeof record.type === "string" ? { type: record.type } : {}),
+        ...(typeof record.description === "string"
+            ? { description: record.description }
+            : {}),
+        ...(Array.isArray(record.required) ? { required: record.required } : {}),
+        ...(Array.isArray(record.enum) ? { enum: record.enum } : {}),
+        ...(record.nullable === true ? { nullable: true } : {}),
+        ...(properties
+            ? {
+                properties: Object.fromEntries(Object.entries(properties).map(([key, value]) => [
+                    key,
+                    normalizeSchemaLike(value),
+                ])),
+            }
+            : {}),
+        ...(record.items ? { items: normalizeSchemaLike(record.items) } : {}),
+        ...(Array.isArray(record.oneOf)
+            ? { oneOf: record.oneOf.map(normalizeSchemaLike) }
+            : {}),
+        ...(Array.isArray(record.anyOf)
+            ? { anyOf: record.anyOf.map(normalizeSchemaLike) }
+            : {}),
+        ...(Array.isArray(record.allOf)
+            ? { allOf: record.allOf.map(normalizeSchemaLike) }
+            : {}),
+        ...(record.additionalProperties !== undefined
+            ? {
+                additionalProperties: record.additionalProperties === true ||
+                    record.additionalProperties === false
+                    ? record.additionalProperties
+                    : normalizeSchemaLike(record.additionalProperties),
+            }
+            : {}),
+    };
+}
+function looksLikeSchema(shape) {
+    const record = asRecord(shape);
+    if (!record) {
+        return false;
+    }
+    return [
+        "additionalProperties",
+        "allOf",
+        "anyOf",
+        "enum",
+        "items",
+        "nullable",
+        "oneOf",
+        "properties",
+        "required",
+        "type",
+    ].some((key) => key in record);
+}
+function mergeShape(left, right) {
+    const output = { ...left };
+    for (const [key, value] of Object.entries(right)) {
+        const existing = output[key];
+        if (isPlainObject(existing) && isPlainObject(value)) {
+            output[key] = mergeShape(existing, value);
+            continue;
+        }
+        if (existing === undefined) {
+            output[key] = value;
+        }
+    }
+    return output;
+}
+function asRecord(value) {
+    return isPlainObject(value) ? value : undefined;
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toPascalCase(value) {
+    return value
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part[0]?.toUpperCase() + part.slice(1))
+        .join("");
+}
+function toOperationId(method, path) {
+    return `${method.toLowerCase()}${toPascalCase(path)}`;
+}
+//# sourceMappingURL=generator.js.map

package/dist/src/docs/generator.js.map

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

package/dist/src/docs/mapping-generator.d.ts

@@ -0,0 +1,13 @@
+import type { MappingSpec } from "../spec/types.js";
+import type { DocsLlmConfig, DocsSourceConfig, DocsSyncConfig, ExtractedAPI } from "./types.js";
+export interface MappingGeneratorOptions {
+    serviceName: string;
+    docsSource?: DocsSourceConfig;
+    sync?: DocsSyncConfig;
+    llm?: DocsLlmConfig;
+}
+export declare class MappingGenerator {
+    generate(extracted: ExtractedAPI, options: MappingGeneratorOptions): string;
+    generateObject(extracted: ExtractedAPI, options: MappingGeneratorOptions): MappingSpec;
+}
+//# sourceMappingURL=mapping-generator.d.ts.map

package/dist/src/docs/mapping-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-generator.d.ts","sourceRoot":"","sources":["../../../src/docs/mapping-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB;AAED,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM;IAM3E,cAAc,CACZ,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,uBAAuB,GAC/B,WAAW;CA8Cf"}

package/dist/src/docs/mapping-generator.js

@@ -0,0 +1,104 @@
+import YAML from "yaml";
+export class MappingGenerator {
+    generate(extracted, options) {
+        return YAML.stringify(this.generateObject(extracted, options), {
+            lineWidth: 0,
+        });
+    }
+    generateObject(extracted, options) {
+        const webhooks = Object.fromEntries(extracted.webhooks.map((webhook) => [
+            webhook.event,
+            {
+                path: inferWebhookPath(options.serviceName, webhook),
+            },
+        ]));
+        const resources = Object.fromEntries(extracted.endpoints
+            .filter((endpoint) => endpoint.method.toUpperCase() === "GET")
+            .map((endpoint) => [
+            inferResourceName(endpoint),
+            {
+                endpoint: `${endpoint.method.toUpperCase()} ${endpoint.path}`,
+                path: inferResourcePath(options.serviceName, endpoint),
+            },
+        ]));
+        return {
+            adapter: {
+                name: options.serviceName,
+                version: "1.0.0",
+                source: {
+                    docs: options.docsSource,
+                    sync: options.sync,
+                    llm: options.llm
+                        ? {
+                            provider: options.llm.provider,
+                            endpoint: options.llm.endpoint,
+                            model: options.llm.model,
+                            maxTokens: options.llm.maxTokens,
+                            concurrency: options.llm.concurrency,
+                            chunkSize: options.llm.chunkSize,
+                        }
+                        : undefined,
+                },
+            },
+            webhooks,
+            resources,
+            writebacks: {},
+        };
+    }
+}
+function inferWebhookPath(serviceName, webhook) {
+    const slug = slugify(webhook.event);
+    const idField = webhook.idField ??
+        inferIdentifierField(webhook.payloadShape) ??
+        "id";
+    return `/${serviceName}/events/${slug}/{{${idField}}}.json`;
+}
+function inferResourcePath(serviceName, endpoint) {
+    const rawSegments = endpoint.path.split("/").filter(Boolean);
+    const segments = rawSegments.map((segment) => segment.startsWith("{") && segment.endsWith("}")
+        ? `{{${segment.slice(1, -1)}}}`
+        : slugify(segment));
+    const last = segments[segments.length - 1];
+    if (!last) {
+        return `/${serviceName}/index.json`;
+    }
+    if (last.startsWith("{{")) {
+        return `/${serviceName}/${segments.join("/")}/metadata.json`;
+    }
+    return `/${serviceName}/${segments.join("/")}/index.json`;
+}
+function inferResourceName(endpoint) {
+    const segments = endpoint.path
+        .split("/")
+        .filter(Boolean)
+        .filter((segment) => !(segment.startsWith("{") && segment.endsWith("}")));
+    return slugify([endpoint.method.toLowerCase(), ...segments].join("-"));
+}
+function inferIdentifierField(shape) {
+    if (!shape) {
+        return undefined;
+    }
+    const candidates = ["id", "data.id", "event.id", "object.id"];
+    return candidates.find((candidate) => hasPath(shape, candidate));
+}
+function hasPath(value, path) {
+    const [head, ...rest] = path.split(".");
+    if (!(head in value)) {
+        return false;
+    }
+    if (rest.length === 0) {
+        return true;
+    }
+    const child = value[head];
+    return typeof child === "object" && child !== null && !Array.isArray(child)
+        ? hasPath(child, rest.join("."))
+        : false;
+}
+function slugify(value) {
+    return value
+        .replace(/[{}]/g, "")
+        .replace(/[^a-zA-Z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .toLowerCase();
+}
+//# sourceMappingURL=mapping-generator.js.map

package/dist/src/docs/mapping-generator.js.map

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

package/dist/src/docs/types.d.ts

@@ -0,0 +1,110 @@
+export interface DocsSelectorConfig {
+    content?: string;
+    codeBlock?: string;
+    pagination?: string;
+}
+export interface DocsSourceConfig {
+    url: string;
+    crawlPaths?: string[];
+    selectors?: DocsSelectorConfig;
+    maxPages?: number;
+    rateLimitMs?: number;
+}
+export type DocsSyncTrigger = "changelog-rss" | "content-hash" | "github-release";
+export interface DocsSyncConfig {
+    trigger: DocsSyncTrigger;
+    feedUrl?: string;
+    repo?: string;
+    stateFile?: string;
+}
+export interface DocsLlmConfig {
+    provider?: "anthropic" | "custom" | "openai";
+    endpoint?: string;
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+    concurrency?: number;
+    chunkSize?: number;
+    headers?: Record<string, string>;
+}
+export interface DocPage {
+    url: string;
+    title: string;
+    content: string;
+}
+export interface ExtractedParameter {
+    name: string;
+    in: "body" | "header" | "path" | "query";
+    type: string;
+    required: boolean;
+    description?: string;
+}
+export interface ExtractedEndpoint {
+    method: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    parameters: ExtractedParameter[];
+    requestShape?: Record<string, unknown>;
+    responseShape?: Record<string, unknown>;
+}
+export interface ExtractedWebhook {
+    event: string;
+    summary?: string;
+    payloadShape?: Record<string, unknown>;
+    deliveryFormat?: string;
+    idField?: string;
+}
+export interface ExtractedAuth {
+    type: "api-key" | "basic" | "bearer" | "none" | "oauth2";
+    headerName?: string;
+    location?: "cookie" | "header" | "query";
+    name?: string;
+}
+export interface ExtractedError {
+    status?: string;
+    description?: string;
+    shape?: Record<string, unknown>;
+}
+export interface ExtractedAPI {
+    title?: string;
+    description?: string;
+    endpoints: ExtractedEndpoint[];
+    webhooks: ExtractedWebhook[];
+    auth?: ExtractedAuth;
+    rateLimits?: string[];
+    errors?: ExtractedError[];
+}
+export interface Change {
+    type: "added" | "deprecated" | "modified" | "preserved";
+    path: string;
+    detail: string;
+}
+export interface UpdateResult {
+    changed: boolean;
+    changes: Change[];
+    spec: string;
+    mapping?: string;
+    warnings: string[];
+}
+export interface ChangeDetectionResult {
+    changed: boolean;
+    reason?: string;
+    previousHash?: string;
+    currentHash?: string;
+    stateKey: string;
+}
+export interface DocsToSpecResult {
+    pages: DocPage[];
+    extracted: ExtractedAPI;
+    spec: string;
+    mapping: string;
+}
+export interface DocsSpecMetadata {
+    url: string;
+    crawlPaths?: string[];
+    selectors?: DocsSelectorConfig;
+    sync?: Omit<DocsSyncConfig, "stateFile">;
+    llm?: Omit<DocsLlmConfig, "apiKey" | "headers">;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/docs/types.d.ts.map

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

package/dist/src/docs/types.js

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

package/dist/src/docs/types.js.map

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

package/dist/src/docs/updater.d.ts

@@ -0,0 +1,11 @@
+import { type SpecGeneratorOptions } from "./generator.js";
+import type { ExtractedAPI, UpdateResult } from "./types.js";
+export interface SpecUpdaterOptions extends SpecGeneratorOptions {
+    existingSpec: string;
+    extracted: ExtractedAPI;
+    serviceNameForMapping?: string;
+}
+export declare class SpecUpdater {
+    update(options: SpecUpdaterOptions): UpdateResult;
+}
+//# sourceMappingURL=updater.d.ts.map

package/dist/src/docs/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../../../src/docs/updater.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,KAAK,EAAU,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,YAAY,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,WAAW;IACtB,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY;CA+ClD"}