@lerianstudio/matcher-mcp 1.0.0-beta.5

package/dist/spec/load.js

@@ -0,0 +1,76 @@
+// Load + index the embedded matcher OpenAPI spec at boot.
+//
+// The canonical spec lives OUTSIDE mcp/ at repo `docs/openapi/openapi.yaml`. For
+// a self-contained Docker image (Phase 3) it must travel with the build, so the
+// `prebuild` script vendors it to `mcp/src/spec/openapi.yaml` and the build copies
+// that into `dist/spec/`. `loadSpec` resolves the BUNDLED copy first (relative to
+// this module — works in both `src/` dev and `dist/` runtime, mirroring
+// server.ts's package.json resolution) and falls back to the repo path for dev
+// runs where the prebuild copy has not happened.
+//
+// The spec is the engine of the generic-invoke trio: without it the server is
+// useless, so a missing or unparseable spec fails boot loudly.
+import { existsSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml } from 'yaml';
+import { buildOperationIndex } from './index.js';
+/**
+ * Candidate locations for the spec, highest priority first:
+ *  1. Bundled next to this module (`src/spec/openapi.yaml` in dev after prebuild,
+ *     `dist/spec/openapi.yaml` in the built artifact).
+ *  2. The repo source of truth, four levels up from `src/spec/` (mcp → repo root):
+ *     `<repo>/docs/openapi/openapi.yaml`. Dev fallback only — absent in the image.
+ */
+export function specCandidatePaths() {
+    const bundled = fileURLToPath(new URL('./openapi.yaml', import.meta.url));
+    // this module: <repo>/mcp/src/spec/load.ts → ../../../docs/openapi/openapi.yaml
+    const repo = fileURLToPath(new URL('../../../docs/openapi/openapi.yaml', import.meta.url));
+    return [bundled, repo];
+}
+/** Resolve the first existing spec path, or throw listing what was tried. */
+export function resolveSpecPath(candidates = specCandidatePaths()) {
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error(`matcher OpenAPI spec not found. Looked in:\n  ${candidates.join('\n  ')}\n` +
+        `Run the prebuild step to vendor docs/openapi/openapi.yaml into mcp/src/spec/.`);
+}
+/**
+ * Load, parse, and index the OpenAPI spec. Fails loudly (throws) if the spec is
+ * missing, not valid YAML, or structurally not an object with a `paths` map.
+ *
+ * `from` lets tests point at an arbitrary file; production passes nothing and
+ * uses `resolveSpecPath`.
+ */
+export function loadSpec(from) {
+    const sourcePath = from ?? resolveSpecPath();
+    let raw;
+    try {
+        raw = readFileSync(sourcePath, 'utf8');
+    }
+    catch (err) {
+        throw new Error(`failed to read matcher OpenAPI spec at ${sourcePath}: ${String(err)}`, { cause: err });
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new Error(`failed to parse matcher OpenAPI spec at ${sourcePath} as YAML: ${String(err)}`, { cause: err });
+    }
+    if (parsed === null || typeof parsed !== 'object') {
+        throw new Error(`matcher OpenAPI spec at ${sourcePath} is not a YAML object`);
+    }
+    const spec = parsed;
+    if (spec.paths === null || typeof spec.paths !== 'object') {
+        throw new Error(`matcher OpenAPI spec at ${sourcePath} has no "paths" object`);
+    }
+    const index = buildOperationIndex(spec);
+    if (index.operations.size === 0) {
+        throw new Error(`matcher OpenAPI spec at ${sourcePath} produced zero operations`);
+    }
+    return { index, sourcePath };
+}
+//# sourceMappingURL=load.js.map

package/dist/spec/load.js.map

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