@lovrozagar/oat 0.1.0

package/dist/spec/graph.js

@@ -0,0 +1,318 @@
+/**
+ * Builds the entity graph — the model every scenario is planned against.
+ *
+ * The central move: `x-invalidate` is read as a graph edge, not a cache hint. Inverting it
+ * gives each entity its *read surface*, the set of projections through which an instance is
+ * observable. That set is the criss-cross matrix.
+ */
+import { deriveCollectionShape, deriveIdentity, requestSchema, successSchema } from "./collection.js";
+import { GapCollector, pathParameterNames, readAsync, readCleanup, readCost, readEffects, readEntity, readFlag, readGenerated, readImmutable, readInvalidate, readInvite, readQueryCapability, readRootParams, readSoftDelete, readTenantParam, readTenantSource, singularise, } from "./extensions.js";
+import { deriveQueryConventions } from "./conventions.js";
+import { parseRouteRef } from "./load.js";
+import { MUTATING_METHODS, listEndpoints, } from "./types.js";
+/**
+ * Header names the operation's success response declares.
+ *
+ * Pagination facts do not always live in the body — `Link` is the obvious case — so a header the
+ * document publishes is part of the response contract and has to be read as such.
+ */
+function successResponseHeaders(op) {
+    const responses = (op.responses ?? {});
+    const names = new Set();
+    for (const [status, response] of Object.entries(responses)) {
+        if (!/^2\d\d$/.test(status))
+            continue;
+        for (const name of Object.keys(response?.headers ?? {}))
+            names.add(name);
+    }
+    return [...names];
+}
+export function buildModel(doc) {
+    const gaps = new GapCollector();
+    const endpoints = listEndpoints(doc);
+    const operations = endpoints.map((e) => modelOperation(e, doc, gaps));
+    demoteNonEntities(operations, gaps);
+    const byOperationId = new Map(operations.map((o) => [o.operationId, o]));
+    const byRoute = new Map(operations.map((o) => [o.route, o]));
+    const entities = buildEntities(operations, byRoute, gaps);
+    const roots = collectRoots(operations, entities);
+    return {
+        byOperationId,
+        byRoute,
+        entities,
+        gaps,
+        hasAuthOperations: operations.some((o) => /auth|login|token|session/i.test(o.path)),
+        operations,
+        rawOperations: new Map(endpoints.map((e) => [e.operationId, e.op])),
+        roots,
+        securitySchemes: Object.keys(doc.components?.securitySchemes ?? {}),
+    };
+}
+function modelOperation(endpoint, doc, gaps) {
+    const { op, method, path, operationId } = endpoint;
+    const responseSchema = successSchema(op);
+    const collection = deriveCollectionShape(responseSchema);
+    const bodySchema = requestSchema(op);
+    const entity = readEntity(endpoint, gaps);
+    const pathParams = pathParameterNames(path);
+    const lastParam = pathParams.at(-1);
+    const itemSchema = collection?.itemSchema ?? responseSchema;
+    const identity = entity?.identity ?? deriveIdentity(itemSchema, lastParam === undefined ? undefined : lastParam);
+    const security = op.security ?? doc.security ?? [];
+    const securitySchemes = [...new Set(security.flatMap((group) => Object.keys(group)))];
+    const documentedStatuses = Object.keys(op.responses ?? {})
+        .map((s) => Number.parseInt(s, 10))
+        .filter((n) => !Number.isNaN(n))
+        .sort((a, b) => a - b);
+    return {
+        action: entity?.action ?? null,
+        async: readAsync(op),
+        cleanup: readCleanup(op),
+        collection,
+        cost: readCost(op),
+        destructive: readFlag(op, "x-destructive"),
+        documentedStatuses,
+        effects: readEffects(op),
+        entity: entity?.name ?? null,
+        entitySource: entity?.source ?? null,
+        freshPrincipal: readFlag(op, "x-fresh-principal"),
+        generated: readGenerated(op, bodySchema),
+        hasRequestBody: bodySchema !== null,
+        identity,
+        idempotent: readFlag(op, "x-idempotent"),
+        immutable: readImmutable(op),
+        invalidates: readInvalidate(op),
+        isMutation: MUTATING_METHODS.has(method.toUpperCase()),
+        method: method.toUpperCase(),
+        operationId,
+        path,
+        pathParams,
+        query: collection === null ? null : readQueryCapability(endpoint, collection.itemSchema, gaps),
+        conventions: deriveQueryConventions(op.parameters ?? [], collection, ext(op, "x-query"), (message) => gaps.record(operationId, "x-query", message), successResponseHeaders(op)),
+        queryParamNames: (op.parameters ?? []).filter((p) => p.in === "query").map((p) => p.name),
+        idempotencyHeader: (op.parameters ?? []).find((p) => p.in === "header"
+            && /^(x-)?idempotenc(y|e)([-_]?key)?$/i.test(p.name.replace(/\s/g, "")))?.name ?? null,
+        rootParams: readRootParams(op),
+        route: `${method.toUpperCase()} ${path}`,
+        securitySchemes,
+        softDelete: readSoftDelete(op),
+        invite: readInvite(op),
+        tenantParam: readTenantParam(endpoint, gaps),
+        tenantSource: readTenantSource(endpoint),
+    };
+}
+function ext(op, key) {
+    const value = op[key];
+    return value === undefined ? undefined : value;
+}
+const PARAM_SEGMENT = /^\{[^}]+\}$/;
+/**
+ * The naming heuristic cannot tell a collection from a verb: `POST /tables/{id}/duplicate` and
+ * `POST /tables` are the same shape. The document itself settles it — a noun names an entity
+ * only if the API exposes an *item route* for it (`.../<noun>/{param}`), or if a GET on the
+ * collection returns a collection-shaped body.
+ *
+ * Everything else is an action on the nearest enclosing entity. Without this pass a spec with
+ * 5 entities models as 24, and every spurious one drags a full lifecycle plan behind it.
+ */
+function demoteNonEntities(operations, gaps) {
+    const nounsWithItemRoute = new Set();
+    for (const op of operations) {
+        const segments = op.path.split("/").filter(Boolean);
+        for (let i = 1; i < segments.length; i++) {
+            const seg = segments[i];
+            const prev = segments[i - 1];
+            if (seg === undefined || prev === undefined)
+                continue;
+            if (PARAM_SEGMENT.test(seg) && !PARAM_SEGMENT.test(prev)) {
+                nounsWithItemRoute.add(singularise(prev));
+            }
+        }
+    }
+    for (const op of operations) {
+        if (op.entity === null || op.entitySource === "tag")
+            continue;
+        if (nounsWithItemRoute.has(op.entity))
+            continue;
+        const collectionShaped = op.method === "GET" && op.collection !== null;
+        if (collectionShaped && !isVerbPhrase(op.path)) {
+            /* A collection-shaped GET with no item route is usually a named view of another
+             * entity (`/table-templates/mine`). oat cannot know which, so it says so. */
+            gaps.record(op.operationId, "x-entity", `returns a collection but exposes no item route, so oat treats "${op.entity}" as its ` +
+                "own entity. If it is a filtered view of another entity, name that entity explicitly");
+            continue;
+        }
+        const parent = enclosingEntity(op.path, nounsWithItemRoute);
+        op.entity = parent;
+        op.action = parent === null ? null : "action";
+    }
+}
+/**
+ * Whether the final segment reads as a verb rather than a noun — `/pet/findByStatus`,
+ * `/reports/exportAll`, `/users/searchByEmail`.
+ *
+ * Such a segment names an operation, not a collection, even though it returns a collection. Left
+ * alone it becomes an entity called "findbystatus", which is both untestable and noise in the
+ * report.
+ */
+const VERB_PREFIX = /^(find|search|query|list|get|fetch|count|export|import|download|upload|bulk|batch|lookup|resolve|mine|me|all|current|latest|recent|active|archived|default|summary|stats?|statistics|history|preview)([A-Z_-]|$)/;
+function isVerbPhrase(path) {
+    const segments = path.split("/").filter(Boolean);
+    const last = segments.at(-1);
+    if (last === undefined || PARAM_SEGMENT.test(last))
+        return false;
+    return VERB_PREFIX.test(last);
+}
+/** Nearest ancestor segment in the path that names a real entity. */
+function enclosingEntity(path, entities) {
+    const segments = path.split("/").filter(Boolean);
+    for (let i = segments.length - 1; i >= 0; i--) {
+        const seg = segments[i];
+        if (seg === undefined || PARAM_SEGMENT.test(seg))
+            continue;
+        const name = singularise(seg);
+        if (entities.has(name))
+            return name;
+    }
+    return null;
+}
+function buildEntities(operations, byRoute, gaps) {
+    const entities = new Map();
+    const get = (name) => {
+        const existing = entities.get(name);
+        if (existing !== undefined)
+            return existing;
+        const created = {
+            actions: [],
+            declaredSurface: [],
+            identity: null,
+            invite: null,
+            name,
+            readSurface: [],
+            tenantParams: [],
+            trackable: false,
+        };
+        entities.set(name, created);
+        return created;
+    };
+    for (const op of operations) {
+        if (op.entity === null || op.action === null)
+            continue;
+        const entity = get(op.entity);
+        if (entity.identity === null && op.identity !== null)
+            entity.identity = op.identity;
+        if (op.tenantParam !== null && !entity.tenantParams.includes(op.tenantParam)) {
+            entity.tenantParams.push(op.tenantParam);
+        }
+        if (entity.invite === null && op.invite !== null)
+            entity.invite = op.invite;
+        switch (op.action) {
+            case "create":
+                entity.create = op.operationId;
+                break;
+            case "list":
+                entity.list = op.operationId;
+                break;
+            case "read":
+                entity.read = op.operationId;
+                break;
+            case "update":
+                entity.update = op.operationId;
+                break;
+            case "delete":
+                entity.delete = op.operationId;
+                break;
+            case "action":
+                entity.actions.push(op.operationId);
+                break;
+        }
+    }
+    /* Invert x-invalidate: a mutator's declared read routes belong to its entity's surface. */
+    for (const op of operations) {
+        if (op.entity === null || op.invalidates.length === 0)
+            continue;
+        const entity = get(op.entity);
+        for (const ref of op.invalidates) {
+            const parsed = parseRouteRef(ref);
+            if (parsed === null || parsed.method !== "GET")
+                continue;
+            if (!entity.readSurface.includes(ref)) {
+                entity.readSurface.push(ref);
+                entity.declaredSurface.push(ref);
+            }
+            if (!byRoute.has(ref)) {
+                gaps.record(op.operationId, "x-invalidate", `names "${ref}", which is not an operation in this document`);
+            }
+        }
+    }
+    /* Sibling fallback for entities whose mutators declared nothing. */
+    for (const entity of entities.values()) {
+        if (entity.readSurface.length > 0)
+            continue;
+        for (const opId of [entity.list, entity.read]) {
+            if (opId === undefined)
+                continue;
+            const op = operations.find((o) => o.operationId === opId);
+            if (op !== undefined)
+                entity.readSurface.push(op.route);
+        }
+        if (entity.readSurface.length > 0 && (entity.create ?? entity.update ?? entity.delete)) {
+            gaps.record(entity.create ?? entity.update ?? entity.delete ?? entity.name, "x-invalidate", `entity "${entity.name}" has mutators but no declared read surface; ` +
+                `falling back to sibling routes ${entity.readSurface.join(", ")}`);
+        }
+    }
+    for (const entity of entities.values()) {
+        entity.trackable = entity.identity !== null;
+        if (!entity.trackable && (entity.create !== undefined || entity.update !== undefined)) {
+            gaps.record(entity.create ?? entity.update ?? entity.name, "x-entity.identity", `entity "${entity.name}" has no discoverable identity property, so instances cannot ` +
+                "be tracked across projections; lifecycle and criss-cross coverage disabled");
+        }
+    }
+    return entities;
+}
+/**
+ * A path parameter is a root when nothing in the document can produce it: no entity whose name
+ * matches has a create operation. Roots must be supplied by config before a run starts —
+ * discovering them late is what turns one missing fixture into a cascade of failures.
+ */
+function collectRoots(operations, entities) {
+    const roots = new Set();
+    for (const op of operations) {
+        for (const param of op.rootParams)
+            roots.add(param);
+    }
+    for (const op of operations) {
+        for (const param of op.pathParams) {
+            /* Resolve the entity from the segment the parameter qualifies, not from its name:
+             * `/table-templates/{template_id}` identifies a `table-template`, and matching on
+             * the name alone would invent a phantom `template` root. */
+            const implied = owningEntityName(op.path, param) ?? impliedEntityName(param);
+            if (implied === null)
+                continue;
+            const entity = entities.get(implied);
+            if (entity === undefined || entity.create === undefined)
+                roots.add(param);
+        }
+    }
+    return [...roots].sort();
+}
+/** The collection segment immediately preceding `{param}` in the path. */
+export function owningEntityName(path, param) {
+    const segments = path.split("/").filter(Boolean);
+    const index = segments.indexOf(`{${param}}`);
+    if (index <= 0)
+        return null;
+    const previous = segments[index - 1];
+    if (previous === undefined || PARAM_SEGMENT.test(previous))
+        return null;
+    return singularise(previous);
+}
+/** `{project_id}` → `project`, `{tableId}` → `table`. */
+export function impliedEntityName(param) {
+    const stripped = param
+        .replace(/[_.]?(id|slug|uuid|key)$/i, "")
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .toLowerCase();
+    return stripped.length === 0 ? null : stripped.replace(/_/g, "-");
+}
+//# sourceMappingURL=graph.js.map

package/dist/spec/graph.js.map

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

package/dist/spec/load.d.ts

@@ -0,0 +1,36 @@
+import type { OpenApiDocument } from "./types.ts";
+/**
+ * Loads a specification from wherever it lives, in JSON or YAML.
+ *
+ * Three forms are accepted, resolved in a fixed order so the outcome never depends on a guess
+ * about what the string "looks like":
+ *
+ *   1. an absolute `http(s)://` or `file://` URL — used as given
+ *   2. a path that exists on disk — read as a file, relative to the working directory
+ *   3. anything else, when a base URL is known — resolved against it, so `/v1/openapi/spec`
+ *      and `openapi.json` both work next to `baseUrl`
+ *
+ * When none apply the error names every location that was tried, rather than reporting the last
+ * failure as though it were the only attempt.
+ */
+export declare function loadSpec(source: string, baseUrl?: string): Promise<OpenApiDocument>;
+/**
+ * Resolves internal `$ref`s in place, sharing object identity for repeated refs so the result
+ * stays compact. Cycles are preserved as shared references rather than expanded — AJV handles
+ * recursive schemas natively, and expanding them would not terminate.
+ *
+ * External refs are left untouched and reported by the caller as a coverage gap: resolving them
+ * would mean fetching arbitrary URLs, which a test tool should not do implicitly.
+ */
+export declare function dereference(doc: OpenApiDocument): {
+    doc: OpenApiDocument;
+    externalRefs: string[];
+};
+/** Normalises `/things/:id` to `/things/{id}` so both path syntaxes compare equal. */
+export declare function normalisePath(path: string): string;
+/** `"GET /things/:id"` → `{ method: "GET", path: "/things/{id}" }` */
+export declare function parseRouteRef(ref: string): {
+    method: string;
+    path: string;
+} | null;
+//# sourceMappingURL=load.d.ts.map

package/dist/spec/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/spec/load.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA6BzF;AA8DD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG;IAClD,GAAG,EAAE,eAAe,CAAA;IACpB,YAAY,EAAE,MAAM,EAAE,CAAA;CACtB,CAkDA;AAMD,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIlF"}

package/dist/spec/load.js

@@ -0,0 +1,166 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Loads a specification from wherever it lives, in JSON or YAML.
+ *
+ * Three forms are accepted, resolved in a fixed order so the outcome never depends on a guess
+ * about what the string "looks like":
+ *
+ *   1. an absolute `http(s)://` or `file://` URL — used as given
+ *   2. a path that exists on disk — read as a file, relative to the working directory
+ *   3. anything else, when a base URL is known — resolved against it, so `/v1/openapi/spec`
+ *      and `openapi.json` both work next to `baseUrl`
+ *
+ * When none apply the error names every location that was tried, rather than reporting the last
+ * failure as though it were the only attempt.
+ */
+export async function loadSpec(source, baseUrl) {
+    const text = await readSpecSource(source, baseUrl);
+    if (text.trim() === "") {
+        throw new Error(`oat: ${source} is empty`);
+    }
+    if (looksLikeJson(text)) {
+        try {
+            return JSON.parse(text);
+        }
+        catch (error) {
+            throw new Error(`oat: ${source} starts as JSON but does not parse: ${error instanceof Error ? error.message : String(error)}. ${diagnoseJson(text)}`);
+        }
+    }
+    try {
+        const { parse } = await import("yaml");
+        return parse(text);
+    }
+    catch (error) {
+        throw new Error(`oat: could not parse ${source} as JSON or YAML: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function looksLikeJson(text) {
+    const first = text.trimStart()[0];
+    return first === "{" || first === "[";
+}
+/**
+ * Distinguishes a malformed document from a truncated one. A spec cut short by a proxy or a
+ * download limit is by far the most common cause, and reporting it as invalid syntax sends
+ * people looking for a bug in a file that is actually fine.
+ */
+function diagnoseJson(text) {
+    const opens = (text.match(/[[{]/g) ?? []).length;
+    const closes = (text.match(/[\]}]/g) ?? []).length;
+    if (opens > closes) {
+        return (`The document has ${opens - closes} more opening than closing brackets, so it is most ` +
+            `likely truncated — it ends after ${text.length} bytes. Check for a download or proxy ` +
+            "size limit.");
+    }
+    return "The document appears complete, so this is a syntax error rather than truncation.";
+}
+async function readSpecSource(source, baseUrl) {
+    if (/^https?:\/\//.test(source))
+        return fetchText(source);
+    if (source.startsWith("file://"))
+        return readFile(fileURLToPath(source), "utf8");
+    const attempted = [];
+    /* A real file wins over a route: a spec checked into the repository is the more specific
+     * intent, and silently fetching instead would hide a typo in the path. */
+    const asPath = resolve(process.cwd(), source);
+    attempted.push(asPath);
+    try {
+        return await readFile(asPath, "utf8");
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    if (baseUrl !== undefined && baseUrl !== "") {
+        const resolved = new URL(source, baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`).toString();
+        attempted.push(resolved);
+        return fetchText(resolved);
+    }
+    throw new Error(`oat: could not find a specification at "${source}". Tried:\n` +
+        attempted.map((a) => `  ${a}`).join("\n") +
+        (baseUrl === undefined
+            ? "\nPass --base-url (or set baseUrl in the config) to resolve it as a route."
+            : ""));
+}
+async function fetchText(url) {
+    const res = await fetch(url, { headers: { accept: "application/json" } });
+    if (!res.ok)
+        throw new Error(`oat: fetching ${url} returned ${res.status} ${res.statusText}`);
+    return res.text();
+}
+/**
+ * Resolves internal `$ref`s in place, sharing object identity for repeated refs so the result
+ * stays compact. Cycles are preserved as shared references rather than expanded — AJV handles
+ * recursive schemas natively, and expanding them would not terminate.
+ *
+ * External refs are left untouched and reported by the caller as a coverage gap: resolving them
+ * would mean fetching arbitrary URLs, which a test tool should not do implicitly.
+ */
+export function dereference(doc) {
+    const externalRefs = new Set();
+    const resolving = new Map();
+    function resolvePointer(ref) {
+        const path = ref.slice(2).split("/").map(decodeSegment);
+        let node = doc;
+        for (const seg of path) {
+            if (node === null || typeof node !== "object")
+                return undefined;
+            node = node[seg];
+        }
+        return node;
+    }
+    function walk(node) {
+        if (Array.isArray(node))
+            return node.map(walk);
+        if (node === null || typeof node !== "object")
+            return node;
+        const obj = node;
+        const ref = obj.$ref;
+        if (typeof ref === "string") {
+            if (!ref.startsWith("#/")) {
+                externalRefs.add(ref);
+                return node;
+            }
+            const cached = resolving.get(ref);
+            if (cached !== undefined)
+                return cached;
+            const target = resolvePointer(ref);
+            if (target === undefined) {
+                throw new Error(`oat: unresolvable $ref ${ref}`);
+            }
+            /* Placeholder registered before recursing so a cycle lands on this same object
+             * instead of recursing forever. */
+            const placeholder = {};
+            resolving.set(ref, placeholder);
+            const resolved = walk(target);
+            Object.assign(placeholder, resolved);
+            /* Sibling keys alongside $ref (OpenAPI 3.1 allows this) override the target. */
+            for (const [k, v] of Object.entries(obj)) {
+                if (k !== "$ref")
+                    placeholder[k] = walk(v);
+            }
+            return placeholder;
+        }
+        const out = {};
+        for (const [k, v] of Object.entries(obj))
+            out[k] = walk(v);
+        return out;
+    }
+    return { doc: walk(doc), externalRefs: [...externalRefs] };
+}
+function decodeSegment(seg) {
+    return seg.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+/** Normalises `/things/:id` to `/things/{id}` so both path syntaxes compare equal. */
+export function normalisePath(path) {
+    return path.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, "{$1}");
+}
+/** `"GET /things/:id"` → `{ method: "GET", path: "/things/{id}" }` */
+export function parseRouteRef(ref) {
+    const match = /^\s*([A-Za-z]+)\s+(\S+)\s*$/.exec(ref);
+    if (!match?.[1] || !match[2])
+        return null;
+    return { method: match[1].toUpperCase(), path: normalisePath(match[2]) };
+}
+//# 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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"}

package/dist/spec/types.d.ts

@@ -0,0 +1,57 @@
+/** Minimal structural view of an OpenAPI 3.x document — only what oat reads. */
+export type SchemaObject = Record<string, unknown>;
+export interface ParameterObject {
+    name: string;
+    in: "path" | "query" | "header" | "cookie";
+    required?: boolean;
+    schema?: SchemaObject;
+    description?: string;
+    [k: string]: unknown;
+}
+export interface MediaTypeObject {
+    schema?: SchemaObject;
+}
+export interface ResponseObject {
+    description?: string;
+    content?: Record<string, MediaTypeObject>;
+}
+export interface OperationObject {
+    operationId?: string;
+    summary?: string;
+    tags?: string[];
+    parameters?: ParameterObject[];
+    requestBody?: {
+        required?: boolean;
+        content?: Record<string, MediaTypeObject>;
+    };
+    responses?: Record<string, ResponseObject>;
+    security?: Array<Record<string, string[]>>;
+    [k: `x-${string}`]: unknown;
+}
+export type PathItemObject = Record<string, OperationObject | unknown>;
+export interface OpenApiDocument {
+    openapi?: string;
+    info?: Record<string, unknown>;
+    servers?: Array<{
+        url: string;
+    }>;
+    paths?: Record<string, PathItemObject>;
+    components?: {
+        schemas?: Record<string, SchemaObject>;
+        securitySchemes?: Record<string, unknown>;
+    };
+    security?: Array<Record<string, string[]>>;
+    [k: `x-${string}`]: unknown;
+}
+export declare const HTTP_METHODS: readonly ["get", "put", "post", "delete", "patch", "head", "options"];
+export type HttpMethod = (typeof HTTP_METHODS)[number];
+export declare const MUTATING_METHODS: ReadonlySet<string>;
+/** An operation lifted out of the document with its location attached. */
+export interface Endpoint {
+    operationId: string;
+    method: HttpMethod;
+    path: string;
+    op: OperationObject;
+}
+export declare function listEndpoints(doc: OpenApiDocument): Endpoint[];
+//# sourceMappingURL=types.d.ts.map

package/dist/spec/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/spec/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,EAAE,YAAY,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,eAAe;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,WAAW,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;KAAE,CAAA;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1C,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAA;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,CAAA;AAEtE,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACtC,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;IAClG,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1C,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,YAAY,uEAAwE,CAAA;AACjG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAA+C,CAAA;AAEhG,0EAA0E;AAC1E,MAAM,WAAW,QAAQ;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,eAAe,CAAA;CACnB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,QAAQ,EAAE,CAiB9D"}

package/dist/spec/types.js

@@ -0,0 +1,24 @@
+/** Minimal structural view of an OpenAPI 3.x document — only what oat reads. */
+export const HTTP_METHODS = ["get", "put", "post", "delete", "patch", "head", "options"];
+export const MUTATING_METHODS = new Set(["POST", "PUT", "PATCH", "DELETE"]);
+export function listEndpoints(doc) {
+    const out = [];
+    for (const [path, item] of Object.entries(doc.paths ?? {})) {
+        if (item === null || typeof item !== "object")
+            continue;
+        for (const method of HTTP_METHODS) {
+            const op = item[method];
+            if (op === null || typeof op !== "object")
+                continue;
+            const operation = op;
+            out.push({
+                method,
+                op: operation,
+                operationId: operation.operationId ?? `${method.toUpperCase()} ${path}`,
+                path,
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=types.js.map

package/dist/spec/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/spec/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AA6ChF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAU,CAAA;AAGjG,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AAUhG,MAAM,UAAU,aAAa,CAAC,GAAoB;IACjD,MAAM,GAAG,GAAe,EAAE,CAAA;IAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5D,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAQ;QACvD,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YACnC,MAAM,EAAE,GAAI,IAAgC,CAAC,MAAM,CAAC,CAAA;YACpD,IAAI,EAAE,KAAK,IAAI,IAAI,OAAO,EAAE,KAAK,QAAQ;gBAAE,SAAQ;YACnD,MAAM,SAAS,GAAG,EAAqB,CAAA;YACvC,GAAG,CAAC,IAAI,CAAC;gBACR,MAAM;gBACN,EAAE,EAAE,SAAS;gBACb,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE;gBACvE,IAAI;aACJ,CAAC,CAAA;QACH,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC"}