@apitap/core 1.5.3 → 1.6.0

package/dist/skill/merge.d.ts

@@ -0,0 +1,29 @@
+import type { SkillFile, SkillEndpoint, ImportMeta, MergeResult } from '../types.js';
+/**
+ * Normalize a parameterized path by replacing all named param placeholders
+ * with the generic `:_` placeholder, enabling matching across different param
+ * naming conventions (e.g. `:id` vs `:userId` vs `:user_id`).
+ *
+ * @example
+ *   normalizePath('/repos/:owner/:repo') // → '/repos/:_/:_'
+ *   normalizePath('/users/list')          // → '/users/list'
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Pure function — no I/O.
+ *
+ * Merges imported OpenAPI endpoints into an existing skill file.
+ *
+ * Captured data is sacred: it always wins on confidence, examples, and
+ * endpoint provenance. Spec data can only enrich (add description, specSource,
+ * query param enum/required/type) or fill gaps (add missing endpoints).
+ *
+ * Match logic: METHOD + normalizePath(path). This allows `:owner` and `:user`
+ * to be considered the same parameter slot.
+ *
+ * @param existing  The existing skill file on disk, or null if none exists.
+ * @param imported  Endpoints parsed from the OpenAPI spec.
+ * @param importMeta  Metadata about the import (spec URL, version, etc.).
+ * @returns MergeResult with the updated SkillFile and a diff summary.
+ */
+export declare function mergeSkillFile(existing: SkillFile | null, imported: SkillEndpoint[], importMeta: ImportMeta): MergeResult;

package/dist/skill/merge.js

@@ -0,0 +1,252 @@
+/**
+ * Normalize a parameterized path by replacing all named param placeholders
+ * with the generic `:_` placeholder, enabling matching across different param
+ * naming conventions (e.g. `:id` vs `:userId` vs `:user_id`).
+ *
+ * @example
+ *   normalizePath('/repos/:owner/:repo') // → '/repos/:_/:_'
+ *   normalizePath('/users/list')          // → '/users/list'
+ */
+export function normalizePath(path) {
+    return path.replace(/:[a-zA-Z_]\w*/g, ':_');
+}
+/**
+ * Build a match key for endpoint deduplication: METHOD + normalized path.
+ */
+function matchKey(method, path) {
+    return `${method.toUpperCase()} ${normalizePath(path)}`;
+}
+/**
+ * Merge query params from a captured endpoint with params from an imported
+ * spec endpoint.
+ *
+ * Rules:
+ * - Captured `example` values are preserved (captured data is sacred).
+ * - Spec `type`, `required`, `enum` augment the captured params.
+ * - New params that only exist in the spec are added wholesale.
+ */
+function mergeQueryParams(captured, specParams) {
+    const merged = { ...captured };
+    for (const [name, specParam] of Object.entries(specParams)) {
+        if (name in merged) {
+            // Param exists in captured — keep captured example, augment with spec metadata
+            const existing = merged[name];
+            merged[name] = {
+                ...existing,
+                // Take spec type only if captured has generic 'string' and spec is more specific
+                type: existing.type === 'string' && specParam.type !== 'string' ? specParam.type : existing.type,
+                // Always preserve captured example value
+                example: existing.example,
+                // Add spec enum if present
+                ...(specParam.enum !== undefined ? { enum: specParam.enum } : {}),
+                // Add spec required flag if present
+                ...(specParam.required !== undefined ? { required: specParam.required } : {}),
+                // Mark as also coming from spec
+                ...(specParam.fromSpec ? { fromSpec: true } : {}),
+            };
+        }
+        else {
+            // New param only in spec — add it
+            merged[name] = specParam;
+        }
+    }
+    return merged;
+}
+/**
+ * Determine whether an imported endpoint would enrich an existing captured
+ * endpoint (i.e. adds new metadata not already present).
+ */
+function wouldEnrich(existing, imported) {
+    if (!existing.description && imported.description)
+        return true;
+    if (!existing.specSource && imported.specSource)
+        return true;
+    // Check if any new query params would be added or enriched
+    for (const [name, specParam] of Object.entries(imported.queryParams)) {
+        if (!(name in existing.queryParams))
+            return true;
+        const ep = existing.queryParams[name];
+        if (!ep.enum && specParam.enum)
+            return true;
+        if (ep.required === undefined && specParam.required !== undefined)
+            return true;
+        if (ep.type === 'string' && specParam.type !== 'string')
+            return true;
+    }
+    return false;
+}
+/**
+ * Pure function — no I/O.
+ *
+ * Merges imported OpenAPI endpoints into an existing skill file.
+ *
+ * Captured data is sacred: it always wins on confidence, examples, and
+ * endpoint provenance. Spec data can only enrich (add description, specSource,
+ * query param enum/required/type) or fill gaps (add missing endpoints).
+ *
+ * Match logic: METHOD + normalizePath(path). This allows `:owner` and `:user`
+ * to be considered the same parameter slot.
+ *
+ * @param existing  The existing skill file on disk, or null if none exists.
+ * @param imported  Endpoints parsed from the OpenAPI spec.
+ * @param importMeta  Metadata about the import (spec URL, version, etc.).
+ * @returns MergeResult with the updated SkillFile and a diff summary.
+ */
+export function mergeSkillFile(existing, imported, importMeta) {
+    const now = new Date().toISOString();
+    let preserved = 0;
+    let added = 0;
+    let enriched = 0;
+    let skipped = 0;
+    // --- Case: no existing file — create a new SkillFile from imported endpoints ---
+    if (existing === null) {
+        const endpoints = imported.map(ep => ({
+            ...ep,
+            normalizedPath: normalizePath(ep.path),
+        }));
+        const skillFile = {
+            version: '1.2',
+            domain: extractDomainFromMeta(importMeta),
+            capturedAt: now,
+            baseUrl: extractBaseUrlFromMeta(importMeta),
+            endpoints,
+            metadata: {
+                captureCount: 0,
+                filteredCount: 0,
+                toolVersion: '1.0.0',
+                importHistory: [{
+                        specUrl: importMeta.specUrl,
+                        specVersion: importMeta.specVersion,
+                        importedAt: now,
+                        endpointsAdded: endpoints.length,
+                        endpointsEnriched: 0,
+                    }],
+            },
+            provenance: 'imported',
+        };
+        added = endpoints.length;
+        return {
+            skillFile,
+            diff: { preserved, added, enriched, skipped },
+        };
+    }
+    // --- Case: existing file present — merge into it ---
+    // Build a map from match-key → existing endpoint (mutable copy)
+    const existingMap = new Map();
+    for (const ep of existing.endpoints) {
+        existingMap.set(matchKey(ep.method, ep.path), ep);
+    }
+    // Build a map from match-key → imported endpoint
+    const importedMap = new Map();
+    for (const ep of imported) {
+        const key = matchKey(ep.method, ep.path);
+        // If multiple imported endpoints map to the same key, last wins
+        if (importedMap.has(key)) {
+            process.stderr.write(`[openapi-import] Warning: ${ep.method} ${ep.path} collides with existing import after normalization\n`);
+        }
+        importedMap.set(key, ep);
+    }
+    // Process: update or preserve existing endpoints
+    const resultEndpoints = [];
+    for (const [key, existingEp] of existingMap) {
+        const importedEp = importedMap.get(key);
+        if (!importedEp) {
+            // Not in import — preserve as-is (captured endpoint with no match in spec)
+            resultEndpoints.push({
+                ...existingEp,
+                normalizedPath: normalizePath(existingEp.path),
+            });
+            preserved++;
+            continue;
+        }
+        // Imported endpoint matches an existing one — check if it would add anything new
+        if (!wouldEnrich(existingEp, importedEp)) {
+            resultEndpoints.push({
+                ...existingEp,
+                normalizedPath: normalizePath(existingEp.path),
+            });
+            // "skipped" means the import is redundant — existing already has spec metadata.
+            // "preserved" means the captured endpoint is untouched (import had nothing for it,
+            // or both sides are bare with no spec data to exchange).
+            const existingHasSpecData = !!(existingEp.specSource || existingEp.description);
+            const importHasSpecData = !!(importedEp.specSource || importedEp.description);
+            if (existingHasSpecData || importHasSpecData) {
+                // Spec data was already integrated (or import tried to add it but it's already present)
+                skipped++;
+            }
+            else {
+                // Neither side has spec enrichment data — captured endpoint simply preserved
+                preserved++;
+            }
+            continue;
+        }
+        // Enrich the captured endpoint with spec metadata
+        const mergedQueryParams = mergeQueryParams(existingEp.queryParams, importedEp.queryParams);
+        const enrichedEp = {
+            ...existingEp,
+            normalizedPath: normalizePath(existingEp.path),
+            // Augment with spec fields (only if not already present)
+            ...(importedEp.description && !existingEp.description ? { description: importedEp.description } : {}),
+            ...(importedEp.specSource && !existingEp.specSource ? { specSource: importedEp.specSource } : {}),
+            // Confidence never downgrades
+            confidence: Math.max(existingEp.confidence ?? 0, importedEp.confidence ?? 0) || existingEp.confidence,
+            // Keep captured provenance
+            endpointProvenance: existingEp.endpointProvenance,
+            queryParams: mergedQueryParams,
+        };
+        resultEndpoints.push(enrichedEp);
+        enriched++;
+    }
+    // Add endpoints from import that don't exist in the existing file
+    for (const [key, importedEp] of importedMap) {
+        if (!existingMap.has(key)) {
+            resultEndpoints.push({
+                ...importedEp,
+                normalizedPath: normalizePath(importedEp.path),
+            });
+            added++;
+        }
+    }
+    // Build updated import history
+    const prevHistory = existing.metadata.importHistory ?? [];
+    const newHistoryEntry = {
+        specUrl: importMeta.specUrl,
+        specVersion: importMeta.specVersion,
+        importedAt: now,
+        endpointsAdded: added,
+        endpointsEnriched: enriched,
+    };
+    const skillFile = {
+        ...existing,
+        endpoints: resultEndpoints,
+        metadata: {
+            ...existing.metadata,
+            importHistory: [...prevHistory, newHistoryEntry],
+        },
+    };
+    return {
+        skillFile,
+        diff: { preserved, added, enriched, skipped },
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function extractDomainFromMeta(meta) {
+    try {
+        return new URL(meta.specUrl).hostname;
+    }
+    catch {
+        throw new Error(`Cannot determine domain from specUrl: ${meta.specUrl}`);
+    }
+}
+function extractBaseUrlFromMeta(meta) {
+    try {
+        const u = new URL(meta.specUrl);
+        return `${u.protocol}//${u.hostname}`;
+    }
+    catch {
+        throw new Error(`Cannot determine base URL from specUrl: ${meta.specUrl}`);
+    }
+}
+//# sourceMappingURL=merge.js.map

package/dist/skill/merge.js.map

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

package/dist/skill/openapi-converter.d.ts

@@ -0,0 +1,31 @@
+import type { ImportResult } from '../types.js';
+/**
+ * Resolve a JSON $ref pointer in an OpenAPI spec.
+ * Uses a visited set to detect cycles and a depth limit as safety net.
+ */
+export declare function resolveRef(obj: any, spec: Record<string, any>, visited?: Set<string>, depth?: number): any;
+export declare function extractDomainAndBasePath(spec: Record<string, any>, specUrl: string): {
+    domain: string;
+    basePath: string;
+};
+export interface ConfidenceInput {
+    method: string;
+    hasExamples: boolean;
+    requiresAuth: boolean;
+}
+export declare function computeConfidence(input: ConfidenceInput): number;
+export type AuthType = 'apiKey' | 'oauth2' | 'bearer' | 'basic' | 'openIdConnect';
+export declare function detectAuth(spec: Record<string, any>): {
+    requiresAuth: boolean;
+    authType?: AuthType;
+};
+export declare function generateEndpointId(method: string, path: string, operationId: string | undefined, seen: Set<string>): string;
+/**
+ * Detect whether a parsed JSON object is an OpenAPI/Swagger spec.
+ * Returns false for SkillFile objects (which have version+domain+baseUrl+endpoints).
+ */
+export declare function isOpenAPISpec(obj: unknown): boolean;
+/**
+ * Convert an OpenAPI 3.x or Swagger 2.0 spec into an ImportResult.
+ */
+export declare function convertOpenAPISpec(spec: Record<string, any>, specUrl: string): ImportResult;