@relayfile/adapter-core 0.1.0

package/dist/src/docs/updater.js

@@ -0,0 +1,133 @@
+import YAML from "yaml";
+import { SpecGenerator } from "./generator.js";
+import { MappingGenerator } from "./mapping-generator.js";
+export class SpecUpdater {
+    update(options) {
+        const existing = asRecord(YAML.parse(options.existingSpec));
+        const next = new SpecGenerator().generateDocument(options.extracted, options);
+        const changes = [];
+        const warnings = [];
+        const merged = structuredClone(existing);
+        merged.openapi = next.openapi;
+        merged.info = mergeNode(existing.info, next.info, "info", changes, warnings);
+        merged.components = mergeComponents(asRecord(existing.components) ?? {}, asRecord(next.components) ?? {}, changes, warnings);
+        merged["x-docs-source"] = next["x-docs-source"];
+        merged["x-webhooks"] = mergeMapSection(asRecord(existing["x-webhooks"]) ?? {}, asRecord(next["x-webhooks"]) ?? {}, "x-webhooks", changes, warnings);
+        merged.paths = mergePaths(asRecord(existing.paths) ?? {}, asRecord(next.paths) ?? {}, changes, warnings);
+        const mapping = new MappingGenerator().generate(options.extracted, {
+            serviceName: options.serviceNameForMapping ??
+                options.apiName.toLowerCase().replace(/[^a-z0-9]+/g, "-"),
+            docsSource: options.docsSource,
+            sync: options.sync,
+            llm: options.llm,
+        });
+        return {
+            changed: changes.length > 0,
+            changes,
+            spec: YAML.stringify(merged, { lineWidth: 0 }),
+            mapping,
+            warnings,
+        };
+    }
+}
+function mergeComponents(existing, next, changes, warnings) {
+    return {
+        ...existing,
+        securitySchemes: mergeMapSection(asRecord(existing.securitySchemes) ?? {}, asRecord(next.securitySchemes) ?? {}, "components.securitySchemes", changes, warnings),
+        schemas: mergeMapSection(asRecord(existing.schemas) ?? {}, asRecord(next.schemas) ?? {}, "components.schemas", changes, warnings),
+    };
+}
+function mergePaths(existing, next, changes, warnings) {
+    const merged = { ...existing };
+    const methods = ["delete", "get", "patch", "post", "put"];
+    for (const [path, nextItem] of Object.entries(next)) {
+        const existingItem = asRecord(existing[path]) ?? {};
+        const nextRecord = asRecord(nextItem) ?? {};
+        const mergedItem = { ...existingItem };
+        for (const method of methods) {
+            const nextOperation = nextRecord[method];
+            if (!nextOperation) {
+                continue;
+            }
+            const label = `paths.${path}.${method}`;
+            if (!(method in existingItem)) {
+                mergedItem[method] = nextOperation;
+                changes.push({
+                    type: "added",
+                    path: label,
+                    detail: "Added new operation from docs",
+                });
+                continue;
+            }
+            mergedItem[method] = mergeNode(existingItem[method], nextOperation, label, changes, warnings);
+        }
+        for (const method of methods) {
+            if (!(method in nextRecord) && method in existingItem) {
+                const operation = asRecord(existingItem[method]) ?? {};
+                if (isHumanEdited(operation)) {
+                    warnings.push(`${path} ${method} removed from docs but preserved because it is marked x-human-edited`);
+                    continue;
+                }
+                if (operation.deprecated !== true) {
+                    mergedItem[method] = { ...operation, deprecated: true };
+                    changes.push({
+                        type: "deprecated",
+                        path: `paths.${path}.${method}`,
+                        detail: "Operation no longer present in docs; marked deprecated",
+                    });
+                }
+            }
+        }
+        merged[path] = mergedItem;
+    }
+    for (const [path, existingItem] of Object.entries(existing)) {
+        if (!(path in merged)) {
+            merged[path] = existingItem;
+        }
+    }
+    return merged;
+}
+function mergeMapSection(existing, next, section, changes, warnings) {
+    const merged = { ...existing };
+    for (const [key, value] of Object.entries(next)) {
+        const path = `${section}.${key}`;
+        if (!(key in existing)) {
+            merged[key] = value;
+            changes.push({ type: "added", path, detail: "Added from docs" });
+            continue;
+        }
+        merged[key] = mergeNode(existing[key], value, path, changes, warnings);
+    }
+    return merged;
+}
+function mergeNode(existing, next, path, changes, warnings) {
+    if (isHumanEdited(existing)) {
+        if (JSON.stringify(existing) !== JSON.stringify(next)) {
+            warnings.push(`${path} differs from docs but was preserved because it is marked x-human-edited`);
+            changes.push({
+                type: "preserved",
+                path,
+                detail: "Preserved x-human-edited section",
+            });
+        }
+        return existing;
+    }
+    if (JSON.stringify(existing) !== JSON.stringify(next)) {
+        changes.push({
+            type: "modified",
+            path,
+            detail: "Updated from docs",
+        });
+    }
+    return next;
+}
+function isHumanEdited(value) {
+    const record = asRecord(value);
+    return record?.["x-human-edited"] === true;
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : {};
+}
+//# sourceMappingURL=updater.js.map

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

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

package/dist/src/drift/drift-checker.d.ts

@@ -0,0 +1,13 @@
+import type { ServiceSpec } from "../ingest/types.js";
+export interface DriftItem {
+    type: string;
+    path: string;
+    message: string;
+}
+export interface DriftReport {
+    breaking: DriftItem[];
+    warnings: DriftItem[];
+    additions: DriftItem[];
+}
+export declare function detectDrift(baseline: ServiceSpec, current: ServiceSpec): DriftReport;
+//# sourceMappingURL=drift-checker.d.ts.map

package/dist/src/drift/drift-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-checker.d.ts","sourceRoot":"","sources":["../../../src/drift/drift-checker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,WAAW,GACnB,WAAW,CAYb"}

package/dist/src/drift/drift-checker.js

@@ -0,0 +1,200 @@
+export function detectDrift(baseline, current) {
+    const report = {
+        breaking: [],
+        warnings: [],
+        additions: [],
+    };
+    compareEndpoints(baseline, current, report);
+    compareSchemas("components", baseline.schemas, current.schemas, report, current);
+    compareSchemas("webhooks", baseline.webhookSchemas, current.webhookSchemas, report, current);
+    return report;
+}
+function compareEndpoints(baseline, current, report) {
+    const currentByKey = new Map(current.endpoints.map((endpoint) => [endpoint.key, endpoint]));
+    for (const endpoint of baseline.endpoints) {
+        const next = currentByKey.get(endpoint.key);
+        if (!next) {
+            report.breaking.push({
+                type: "endpoint_removed",
+                path: endpoint.key,
+                message: `Endpoint ${endpoint.key} was removed`,
+            });
+            continue;
+        }
+        const baselineParameters = new Map(endpoint.parameters.map((parameter) => [parameter.name, parameter]));
+        const nextParameters = new Map(next.parameters.map((parameter) => [parameter.name, parameter]));
+        for (const [name, parameter] of baselineParameters) {
+            const nextParameter = nextParameters.get(name);
+            if (!nextParameter) {
+                report.breaking.push({
+                    type: "parameter_removed",
+                    path: `${endpoint.key}#${name}`,
+                    message: `Parameter ${name} was removed`,
+                });
+            }
+            else if ((parameter.schema?.type ?? "unknown") !== (nextParameter.schema?.type ?? "unknown")) {
+                report.breaking.push({
+                    type: "parameter_type_changed",
+                    path: `${endpoint.key}#${name}`,
+                    message: `Parameter ${name} changed type from ${parameter.schema?.type ?? "unknown"} to ${nextParameter.schema?.type ?? "unknown"}`,
+                });
+            }
+        }
+        for (const [name, parameter] of nextParameters) {
+            if (!baselineParameters.has(name)) {
+                report.additions.push({
+                    type: parameter.required ? "required_parameter_added" : "parameter_added",
+                    path: `${endpoint.key}#${name}`,
+                    message: `Parameter ${name} was added`,
+                });
+            }
+        }
+    }
+    const baselineKeys = new Set(baseline.endpoints.map((endpoint) => endpoint.key));
+    for (const endpoint of current.endpoints) {
+        if (!baselineKeys.has(endpoint.key)) {
+            report.additions.push({
+                type: "endpoint_added",
+                path: endpoint.key,
+                message: `Endpoint ${endpoint.key} was added`,
+            });
+        }
+    }
+}
+function compareSchemas(group, baselineSchemas, currentSchemas, report, currentSpec) {
+    for (const [name, schema] of Object.entries(baselineSchemas)) {
+        const next = currentSchemas[name];
+        if (!next) {
+            report.breaking.push({
+                type: "schema_removed",
+                path: `${group}.${name}`,
+                message: `Schema ${name} was removed`,
+            });
+            continue;
+        }
+        const baselineFields = flattenSchema(schema, currentSpec, name);
+        const currentFields = flattenSchema(next, currentSpec, name);
+        const parentAdds = new Map();
+        const parentRemovals = new Map();
+        for (const [path, descriptor] of baselineFields) {
+            const nextDescriptor = currentFields.get(path);
+            if (!nextDescriptor) {
+                report.breaking.push({
+                    type: "field_removed",
+                    path: `${group}.${name}.${path}`,
+                    message: `Field ${path} was removed`,
+                });
+                pushGrouped(parentRemovals, parentPath(path), path);
+                continue;
+            }
+            if (descriptor.type !== nextDescriptor.type) {
+                report.breaking.push({
+                    type: "field_type_changed",
+                    path: `${group}.${name}.${path}`,
+                    message: `Field ${path} changed type from ${descriptor.type} to ${nextDescriptor.type}`,
+                });
+            }
+        }
+        for (const [path, descriptor] of currentFields) {
+            if (!baselineFields.has(path)) {
+                const bucket = descriptor.required ? report.breaking : report.additions;
+                bucket.push({
+                    type: descriptor.required ? "required_field_added" : "field_added",
+                    path: `${group}.${name}.${path}`,
+                    message: `Field ${path} was added`,
+                });
+                pushGrouped(parentAdds, parentPath(path), path);
+            }
+        }
+        for (const [parent, removed] of parentRemovals) {
+            const added = parentAdds.get(parent);
+            if (!added) {
+                continue;
+            }
+            for (const removedPath of removed) {
+                const removedType = baselineFields.get(removedPath)?.type;
+                const similar = added.find((addedPath) => currentFields.get(addedPath)?.type === removedType);
+                if (similar) {
+                    report.warnings.push({
+                        type: "possible_rename",
+                        path: `${group}.${name}.${parent}`,
+                        message: `Possible rename detected: ${removedPath} -> ${similar}`,
+                    });
+                }
+            }
+        }
+    }
+    for (const name of Object.keys(currentSchemas)) {
+        if (!(name in baselineSchemas)) {
+            report.additions.push({
+                type: "schema_added",
+                path: `${group}.${name}`,
+                message: `Schema ${name} was added`,
+            });
+        }
+    }
+}
+function flattenSchema(schema, serviceSpec, name, prefix = "", seen = new Set()) {
+    const output = new Map();
+    const node = dereference(schema, serviceSpec, seen);
+    const properties = node.properties ?? {};
+    const required = new Set(node.required ?? []);
+    for (const [key, value] of Object.entries(properties)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        const resolved = dereference(value, serviceSpec, seen);
+        output.set(path, {
+            type: describeType(resolved),
+            required: required.has(key),
+        });
+        for (const [childPath, childValue] of flattenSchema(resolved, serviceSpec, name, path, seen)) {
+            output.set(childPath, childValue);
+        }
+    }
+    if (node.items) {
+        const itemPath = prefix ? `${prefix}[]` : `${name}[]`;
+        output.set(itemPath, {
+            type: describeType(node.items),
+            required: true,
+        });
+        for (const [childPath, childValue] of flattenSchema(node.items, serviceSpec, name, itemPath, seen)) {
+            output.set(childPath, childValue);
+        }
+    }
+    return output;
+}
+function dereference(schema, serviceSpec, seen) {
+    if (!schema.ref) {
+        return schema;
+    }
+    const refName = schema.ref.replace(/^#\/components\/schemas\//, "");
+    if (seen.has(refName)) {
+        return schema;
+    }
+    seen.add(refName);
+    return serviceSpec.schemas[refName] ?? schema;
+}
+function describeType(schema) {
+    if (schema.ref) {
+        return `ref:${schema.ref}`;
+    }
+    if (schema.oneOf?.length) {
+        return schema.oneOf.map(describeType).join("|");
+    }
+    if (schema.anyOf?.length) {
+        return schema.anyOf.map(describeType).join("|");
+    }
+    if (schema.allOf?.length) {
+        return schema.allOf.map(describeType).join("&");
+    }
+    return schema.type ?? "unknown";
+}
+function parentPath(path) {
+    const index = path.lastIndexOf(".");
+    return index === -1 ? "" : path.slice(0, index);
+}
+function pushGrouped(store, key, value) {
+    const current = store.get(key) ?? [];
+    current.push(value);
+    store.set(key, current);
+}
+//# sourceMappingURL=drift-checker.js.map

package/dist/src/drift/drift-checker.js.map

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

package/dist/src/generate/adapter-generator.d.ts

@@ -0,0 +1,4 @@
+import type { ServiceSpec } from "../ingest/types.js";
+import type { MappingSpec } from "../spec/types.js";
+export declare function generateAdapterModule(spec: MappingSpec, serviceSpec: ServiceSpec): string;
+//# sourceMappingURL=adapter-generator.d.ts.map

package/dist/src/generate/adapter-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-generator.d.ts","sourceRoot":"","sources":["../../../src/generate/adapter-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,WAAW,GACvB,MAAM,CAsHR"}

package/dist/src/generate/adapter-generator.js

@@ -0,0 +1,115 @@
+export function generateAdapterModule(spec, serviceSpec) {
+    const serializedSpec = JSON.stringify(spec, null, 2);
+    const serializedSummary = JSON.stringify({
+        title: serviceSpec.title,
+        version: serviceSpec.version,
+        sourceKind: serviceSpec.sourceKind,
+        endpoints: serviceSpec.endpoints.map((endpoint) => endpoint.key),
+        webhooks: Object.keys(serviceSpec.webhookSchemas),
+    }, null, 2);
+    return `/* eslint-disable */
+// Generated from ${serviceSpec.sourceKind}: ${serviceSpec.sourceLocation}
+
+export const mappingSpec = ${serializedSpec} as const;
+export const serviceSummary = ${serializedSummary} as const;
+
+type WebhookEvent = {
+  eventType: string;
+  objectType: string;
+  payload: Record<string, unknown>;
+};
+
+type WritebackMatch = {
+  name: string;
+  endpoint: string;
+  params: Record<string, string>;
+} | null;
+
+export function computePath(event: WebhookEvent): string {
+  const mapping = resolveWebhookMapping(event);
+  return interpolate(mapping.path, event.payload);
+}
+
+export function normalizeWebhook(event: WebhookEvent): Record<string, unknown> {
+  const mapping = resolveWebhookMapping(event);
+  if (!mapping.extract || mapping.extract.length === 0) {
+    return event.payload;
+  }
+
+  const output: Record<string, unknown> = {};
+  for (const field of mapping.extract) {
+    const value = get(event.payload, field);
+    if (value !== undefined) {
+      output[field] = value;
+    }
+  }
+  return output;
+}
+
+export function matchWriteback(path: string): WritebackMatch {
+  const writebacks = mappingSpec.writebacks ?? {};
+  for (const [name, mapping] of Object.entries(writebacks)) {
+    if (!globMatch(mapping.match, path)) {
+      continue;
+    }
+    const params = captureWritebackParams(mapping.match, mapping.endpoint, path);
+    return { name, endpoint: mapping.endpoint, params };
+  }
+  return null;
+}
+
+function resolveWebhookMapping(event: WebhookEvent) {
+  const root = event.eventType.split(".")[0] ?? event.eventType;
+  return (
+    mappingSpec.webhooks[event.eventType] ??
+    mappingSpec.webhooks[event.objectType] ??
+    mappingSpec.webhooks[root]
+  );
+}
+
+function get(input: unknown, field: string): unknown {
+  const segments = field.split(".");
+  let cursor = input;
+  for (const segment of segments) {
+    if (!cursor || typeof cursor !== "object") {
+      return undefined;
+    }
+    cursor = (cursor as Record<string, unknown>)[segment];
+  }
+  return cursor;
+}
+
+function interpolate(template: string, payload: Record<string, unknown>): string {
+  return template.replace(/\\{\\{\\s*([^}]+?)\\s*\\}\\}/g, (_match, field) => {
+    const value = get(payload, field);
+    if (value === undefined || value === null) {
+      throw new Error(\`Missing template field "\${field}"\`);
+    }
+    return encodeURIComponent(String(value));
+  });
+}
+
+function globMatch(pattern: string, value: string): boolean {
+  const escaped = pattern.split("*").map(escapeRegex).join(".*");
+  return new RegExp(\`^\${escaped}$\`).test(value);
+}
+
+function captureWritebackParams(
+  matchPattern: string,
+  endpoint: string,
+  actualPath: string
+): Record<string, string> {
+  const regex = new RegExp(
+    \`^\${matchPattern.split("*").map(escapeRegex).join("(.+?)")}$\`
+  );
+  const captures = actualPath.match(regex)?.slice(1) ?? [];
+  const params = [...endpoint.matchAll(/\\{([^}]+)\\}/g)].map((item) => item[1]);
+  return Object.fromEntries(params.map((param, index) => [param, decodeURIComponent(captures[index] ?? "")]));
+}
+
+function escapeRegex(value: string): string {
+  return value.replace(/[.*+?^\\\${}()|[\\\\]\\\\]/g, "\\\\$&");
+}
+`;
+}
+//# sourceMappingURL=adapter-generator.js.map

package/dist/src/generate/adapter-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-generator.js","sourceRoot":"","sources":["../../../src/generate/adapter-generator.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CACnC,IAAiB,EACjB,WAAwB;IAExB,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrD,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CACtC;QACE,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;QAChE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;KAClD,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IAEF,OAAO;oBACW,WAAW,CAAC,UAAU,KAAK,WAAW,CAAC,cAAc;;6BAE5C,cAAc;gCACX,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmGhD,CAAC;AACF,CAAC"}

package/dist/src/generate/types-generator.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceSpec } from "../ingest/types.js";
+export declare function generateTypeDefinitions(serviceSpec: ServiceSpec): string;
+//# sourceMappingURL=types-generator.d.ts.map

package/dist/src/generate/types-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-generator.d.ts","sourceRoot":"","sources":["../../../src/generate/types-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElE,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAkBxE"}

package/dist/src/generate/types-generator.js

@@ -0,0 +1,105 @@
+export function generateTypeDefinitions(serviceSpec) {
+    const lines = [
+        "/* eslint-disable */",
+        `// Generated from ${serviceSpec.sourceKind}: ${serviceSpec.sourceLocation}`,
+        "",
+    ];
+    for (const [name, schema] of Object.entries(serviceSpec.schemas)) {
+        lines.push(renderNamedType(name, schema));
+        lines.push("");
+    }
+    for (const [name, schema] of Object.entries(serviceSpec.webhookSchemas)) {
+        lines.push(renderNamedType(`${toPascalCase(name)}Webhook`, schema));
+        lines.push("");
+    }
+    return `${lines.join("\n").trim()}\n`;
+}
+function renderNamedType(name, schema) {
+    const typeName = toPascalCase(name);
+    const body = renderType(schema, { rootName: typeName });
+    if (schema.type === "object" && schema.properties) {
+        return `export interface ${typeName} ${body}`;
+    }
+    return `export type ${typeName} = ${body};`;
+}
+function renderType(schema, context) {
+    if (schema.ref) {
+        return toPascalCase(schema.ref.replace(/^#\/components\/schemas\//, ""));
+    }
+    const unions = schema.oneOf ?? schema.anyOf;
+    if (unions && unions.length > 0) {
+        return unions.map((item, index) => renderType(item, {
+            rootName: `${context.rootName}${index + 1}`,
+        })).join(" | ");
+    }
+    if (schema.allOf && schema.allOf.length > 0) {
+        return schema.allOf.map((item, index) => renderType(item, {
+            rootName: `${context.rootName}${index + 1}`,
+        })).join(" & ");
+    }
+    if (schema.enum && schema.enum.length > 0) {
+        return schema.enum.map((item) => JSON.stringify(item)).join(" | ");
+    }
+    let baseType;
+    switch (schema.type) {
+        case "array":
+            baseType = `${renderType(schema.items ?? {}, { rootName: `${context.rootName}Item` })}[]`;
+            break;
+        case "boolean":
+            baseType = "boolean";
+            break;
+        case "integer":
+        case "number":
+            baseType = "number";
+            break;
+        case "null":
+            baseType = "null";
+            break;
+        case "object":
+            baseType = renderObjectType(schema, context);
+            break;
+        case "string":
+            baseType = "string";
+            break;
+        default:
+            baseType = "unknown";
+            break;
+    }
+    return schema.nullable ? `${baseType} | null` : baseType;
+}
+function renderObjectType(schema, context) {
+    const properties = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const entries = Object.entries(properties);
+    if (entries.length === 0 && schema.additionalProperties) {
+        if (schema.additionalProperties === true) {
+            return "Record<string, unknown>";
+        }
+        return `Record<string, ${renderType(schema.additionalProperties, {
+            rootName: `${context.rootName}Value`,
+        })}>`;
+    }
+    const lines = ["{"];
+    for (const [key, value] of entries) {
+        const optional = required.has(key) ? "" : "?";
+        lines.push(`  ${JSON.stringify(key)}${optional}: ${renderType(value, {
+            rootName: `${context.rootName}${toPascalCase(key)}`,
+        })};`);
+    }
+    if (schema.additionalProperties && schema.additionalProperties !== true) {
+        lines.push(`  [key: string]: ${renderType(schema.additionalProperties, {
+            rootName: `${context.rootName}Value`,
+        })};`);
+    }
+    lines.push("}");
+    return lines.join("\n");
+}
+function toPascalCase(value) {
+    return value
+        .replace(/^[^a-zA-Z]+/, "")
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((segment) => segment[0].toUpperCase() + segment.slice(1))
+        .join("") || "Anonymous";
+}
+//# sourceMappingURL=types-generator.js.map

package/dist/src/generate/types-generator.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,22 @@
+export * from "./spec/types.js";
+export * from "./spec/template.js";
+export * from "./spec/parser.js";
+export * from "./ingest/types.js";
+export * from "./ingest/index.js";
+export * from "./ingest/openapi.js";
+export * from "./ingest/postman.js";
+export * from "./ingest/sample.js";
+export * from "./runtime/schema-adapter.js";
+export * from "./generate/adapter-generator.js";
+export * from "./generate/types-generator.js";
+export * from "./drift/drift-checker.js";
+export * from "./docs/types.js";
+export * from "./docs/crawler.js";
+export * from "./docs/extractor.js";
+export * from "./docs/generator.js";
+export * from "./docs/mapping-generator.js";
+export * from "./docs/change-detector.js";
+export * from "./docs/updater.js";
+export { IntegrationAdapter } from "@relayfile/sdk";
+export type { AdapterWebhook, AdapterWebhookMetadata, IngestError, IngestResult, } from "@relayfile/sdk";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAC"}