@ir-kit/kit 0.0.0-stage → 1.0.0

package/dist/recon/from-har.d.ts

@@ -0,0 +1,65 @@
+import { type Recon } from "./recon.js";
+import type { ReconConfig } from "./types.js";
+/**
+ * Minimal [HAR 1.2](https://w3c.github.io/web-performance/specs/HAR/Overview.html)
+ * shape — just the fields `fromHAR` reads. Strict full-HAR is a superset of this.
+ */
+export interface HarFile {
+    log: {
+        entries: ReadonlyArray<HarEntry>;
+    };
+}
+export interface HarEntry {
+    request: HarRequest;
+    response: HarResponse;
+}
+export interface HarRequest {
+    method: string;
+    url: string;
+    headers: ReadonlyArray<HarHeader>;
+    postData?: {
+        text?: string;
+        mimeType?: string;
+    };
+}
+export interface HarResponse {
+    status: number;
+    headers: ReadonlyArray<HarHeader>;
+    content: {
+        text?: string;
+        mimeType?: string;
+    };
+}
+export interface HarHeader {
+    name: string;
+    value: string;
+}
+/**
+ * Input for {@link fromHAR}. Strings are HAR JSON *content*, not file paths —
+ * the package stays runtime-agnostic (works in browsers, Workers, Deno).
+ * For Node file reading, pass `await readFile(path, "utf8")` yourself.
+ */
+export type HarSource = string | HarFile;
+/**
+ * Fold a HAR 1.2 source into a new {@link Recon} instance. Each entry becomes
+ * a Web Fetch `Request` / `Response` pair, then runs through `observe()`.
+ *
+ * Entries that can't be turned into valid Fetch objects (bad URLs, illegal
+ * header names) are skipped silently. HTTP/2 pseudo-headers (`:authority`,
+ * `:method`, `:path`, `:scheme`) are dropped — Fetch rejects them. Bodies
+ * on `GET`/`HEAD` are dropped — Fetch rejects them too.
+ *
+ * @example File-system path (Node)
+ * ```ts
+ * import { readFile } from "node:fs/promises";
+ * const recon = await fromHAR(await readFile("./traffic.har", "utf8"));
+ * const spec = recon.toOpenAPI();
+ * ```
+ *
+ * @example Pre-parsed object (any runtime)
+ * ```ts
+ * const recon = await fromHAR(harJson, { title: "My API" });
+ * ```
+ */
+export declare function fromHAR(source: HarSource, config?: ReconConfig): Promise<Recon>;
+//# sourceMappingURL=from-har.d.ts.map

package/dist/recon/from-har.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-har.d.ts","sourceRoot":"","sources":["../../src/recon/from-har.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE;QACH,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAchB"}

package/dist/recon/from-har.js

@@ -0,0 +1,79 @@
+import { createRecon } from "./recon.js";
+/**
+ * Fold a HAR 1.2 source into a new {@link Recon} instance. Each entry becomes
+ * a Web Fetch `Request` / `Response` pair, then runs through `observe()`.
+ *
+ * Entries that can't be turned into valid Fetch objects (bad URLs, illegal
+ * header names) are skipped silently. HTTP/2 pseudo-headers (`:authority`,
+ * `:method`, `:path`, `:scheme`) are dropped — Fetch rejects them. Bodies
+ * on `GET`/`HEAD` are dropped — Fetch rejects them too.
+ *
+ * @example File-system path (Node)
+ * ```ts
+ * import { readFile } from "node:fs/promises";
+ * const recon = await fromHAR(await readFile("./traffic.har", "utf8"));
+ * const spec = recon.toOpenAPI();
+ * ```
+ *
+ * @example Pre-parsed object (any runtime)
+ * ```ts
+ * const recon = await fromHAR(harJson, { title: "My API" });
+ * ```
+ */
+export async function fromHAR(source, config) {
+    const har = typeof source === "string" ? JSON.parse(source) : source;
+    const recon = createRecon(config);
+    for (const entry of har.log?.entries ?? []) {
+        const req = harRequestToFetch(entry.request);
+        if (!req)
+            continue;
+        const res = harResponseToFetch(entry.response);
+        if (!res)
+            continue;
+        await recon.observe(req, res);
+    }
+    return recon;
+}
+const METHODS_NO_BODY = new Set(["GET", "HEAD"]);
+function harRequestToFetch(req) {
+    try {
+        const init = {
+            method: req.method,
+            headers: harHeadersToFetch(req.headers),
+        };
+        if (req.postData?.text && !METHODS_NO_BODY.has(req.method.toUpperCase())) {
+            init.body = req.postData.text;
+        }
+        return new Request(req.url, init);
+    }
+    catch {
+        return null;
+    }
+}
+function harResponseToFetch(res) {
+    try {
+        return new Response(res.content?.text ?? "", {
+            status: res.status,
+            headers: harHeadersToFetch(res.headers),
+        });
+    }
+    catch {
+        return null;
+    }
+}
+function harHeadersToFetch(headers) {
+    const h = new Headers();
+    for (const { name, value } of headers) {
+        // HTTP/2 pseudo-headers (`:authority`, `:method`, …) — Fetch's Headers rejects them.
+        if (name.startsWith(":"))
+            continue;
+        try {
+            h.append(name, value);
+        }
+        catch {
+            // Other illegal header — skip silently rather than fail the whole entry.
+        }
+    }
+    return h;
+}
+//# sourceMappingURL=from-har.js.map

package/dist/recon/from-har.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-har.js","sourceRoot":"","sources":["../../src/recon/from-har.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AA2CrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAiB,EACjB,MAAoB;IAEpB,MAAM,GAAG,GACP,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAa,CAAC,CAAC,CAAC,MAAM,CAAC;IACxE,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjD,SAAS,iBAAiB,CAAC,GAAe;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAgB;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;SACxC,CAAC;QACF,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAgB;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE;YAC3C,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAiC;IAC1D,MAAM,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;IACxB,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QACtC,qFAAqF;QACrF,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC;YACH,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;QAC3E,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/recon/index.d.ts

@@ -0,0 +1,9 @@
+export type { HarEntry, HarFile, HarHeader, HarRequest, HarResponse, HarSource, } from "./from-har.js";
+export { fromHAR } from "./from-har.js";
+export type { TemplatedPath } from "./infer/path.js";
+export { templatePaths, templateSinglePath } from "./infer/path.js";
+export { inferSchema, mergeSchema } from "./infer/schema.js";
+export { createRecon, type Recon } from "./recon.js";
+export { DEFAULT_REDACTED_HEADERS, sanitizeHeaders } from "./sanitize.js";
+export type { HttpMethod, OperationObservation, ReconConfig, Sample, Schema, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recon/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,WAAW,EACX,MAAM,EACN,MAAM,GACP,MAAM,YAAY,CAAC"}

package/dist/recon/index.js

@@ -0,0 +1,6 @@
+export { fromHAR } from "./from-har.js";
+export { templatePaths, templateSinglePath } from "./infer/path.js";
+export { inferSchema, mergeSchema } from "./infer/schema.js";
+export { createRecon } from "./recon.js";
+export { DEFAULT_REDACTED_HEADERS, sanitizeHeaders } from "./sanitize.js";
+//# sourceMappingURL=index.js.map

package/dist/recon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recon/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/recon/infer/auth.d.ts

@@ -0,0 +1,16 @@
+import type { OpenAPIV3_1 } from "@hey-api/spec-types";
+/** Stable id for emitted security scheme entries. */
+export type AuthSchemeId = "bearerAuth" | "basicAuth" | "apiKeyAuth";
+export interface DetectedAuth {
+    id: AuthSchemeId;
+    scheme: OpenAPIV3_1.SecuritySchemeObject;
+}
+/**
+ * Inspect request headers for known auth shapes. Returns scheme metadata
+ * suitable for `components.securitySchemes` + the corresponding `security`
+ * requirement on the operation. Returns `null` if no auth is observed.
+ *
+ * Detection order: Bearer → Basic → API key (X-API-Key / X-Auth-Token).
+ */
+export declare function detectAuthScheme(headers: Record<string, string>): DetectedAuth | null;
+//# sourceMappingURL=auth.d.ts.map

package/dist/recon/infer/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/recon/infer/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC,oBAAoB,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,YAAY,GAAG,IAAI,CAyBrB"}

package/dist/recon/infer/auth.js

@@ -0,0 +1,34 @@
+/**
+ * Inspect request headers for known auth shapes. Returns scheme metadata
+ * suitable for `components.securitySchemes` + the corresponding `security`
+ * requirement on the operation. Returns `null` if no auth is observed.
+ *
+ * Detection order: Bearer → Basic → API key (X-API-Key / X-Auth-Token).
+ */
+export function detectAuthScheme(headers) {
+    const auth = headers.authorization;
+    if (auth) {
+        const lower = auth.trim().toLowerCase();
+        if (lower.startsWith("bearer ")) {
+            return {
+                id: "bearerAuth",
+                scheme: { type: "http", scheme: "bearer" },
+            };
+        }
+        if (lower.startsWith("basic ")) {
+            return {
+                id: "basicAuth",
+                scheme: { type: "http", scheme: "basic" },
+            };
+        }
+    }
+    const apiKey = ["x-api-key", "x-auth-token"].find((h) => headers[h]);
+    if (apiKey) {
+        return {
+            id: "apiKeyAuth",
+            scheme: { type: "apiKey", in: "header", name: apiKey },
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=auth.js.map

package/dist/recon/infer/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/recon/infer/auth.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA+B;IAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IACnC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,EAAE,EAAE,YAAY;gBAChB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE;aAC3C,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,EAAE,EAAE,WAAW;gBACf,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;aAC1C,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,EAAE,EAAE,YAAY;YAChB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;SACvD,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/recon/infer/canonical.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Canonical JSON stringification — deterministic key ordering, used as a
+ * dedup key for `ExampleBucket` and as a structural hash for `$ref`
+ * dedupe. Assumes the input is the result of `JSON.parse` (no cycles, no
+ * functions, no `undefined`).
+ */
+export declare function canonicalJSON(value: unknown): string;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/recon/infer/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../../src/recon/infer/canonical.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/recon/infer/canonical.js

@@ -0,0 +1,21 @@
+/**
+ * Canonical JSON stringification — deterministic key ordering, used as a
+ * dedup key for `ExampleBucket` and as a structural hash for `$ref`
+ * dedupe. Assumes the input is the result of `JSON.parse` (no cycles, no
+ * functions, no `undefined`).
+ */
+export function canonicalJSON(value) {
+    return JSON.stringify(canonicalize(value));
+}
+function canonicalize(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    const entries = Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    const out = {};
+    for (const [k, v] of entries)
+        out[k] = canonicalize(v);
+    return out;
+}
+//# sourceMappingURL=canonical.js.map

package/dist/recon/infer/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../../src/recon/infer/canonical.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,IAAI,CACnE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3C,CAAC;IACF,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/recon/infer/format.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Format detection for primitive values. Applied during single-sample
+ * inference. Multiple samples that disagree on format → format is dropped
+ * during merge (in `mergeSchema`).
+ *
+ * The patterns here intentionally err toward false-NEGATIVES — emitting an
+ * unnecessary string is better than mislabeling a date as a UUID.
+ */
+export declare function detectStringFormat(value: string): string | undefined;
+/**
+ * Detect an integer format. Numbers in JSON have no native distinction
+ * between int32/int64 — we use range as a heuristic.
+ */
+export declare function detectIntegerFormat(value: number): "int32" | "int64";
+//# sourceMappingURL=format.d.ts.map

package/dist/recon/infer/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/recon/infer/format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAEpE"}

package/dist/recon/infer/format.js

@@ -0,0 +1,46 @@
+/**
+ * Format detection for primitive values. Applied during single-sample
+ * inference. Multiple samples that disagree on format → format is dropped
+ * during merge (in `mergeSchema`).
+ *
+ * The patterns here intentionally err toward false-NEGATIVES — emitting an
+ * unnecessary string is better than mislabeling a date as a UUID.
+ */
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+// Restrictive email pattern — RFC 5322 is too permissive for inference.
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;
+// ISO 8601 date-time. Accepts both `Z` and `±hh:mm` offsets, optional fractional seconds.
+const DATE_TIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
+// ISO 8601 date only.
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+// Absolute http(s) URL — covers the common case without trying to be RFC-correct.
+const URI_RE = /^https?:\/\/[^\s]+$/i;
+// IPv4 dotted quad with each octet 0-255.
+const IPV4_RE = /^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]?\d)$/;
+const INT32_MIN = -2147483648;
+const INT32_MAX = 2147483647;
+export function detectStringFormat(value) {
+    if (value.length < 4 || value.length > 4096)
+        return undefined;
+    if (UUID_RE.test(value))
+        return "uuid";
+    if (EMAIL_RE.test(value))
+        return "email";
+    if (DATE_TIME_RE.test(value))
+        return "date-time";
+    if (DATE_RE.test(value))
+        return "date";
+    if (URI_RE.test(value))
+        return "uri";
+    if (IPV4_RE.test(value))
+        return "ipv4";
+    return undefined;
+}
+/**
+ * Detect an integer format. Numbers in JSON have no native distinction
+ * between int32/int64 — we use range as a heuristic.
+ */
+export function detectIntegerFormat(value) {
+    return value >= INT32_MIN && value <= INT32_MAX ? "int32" : "int64";
+}
+//# sourceMappingURL=format.js.map

package/dist/recon/infer/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/recon/infer/format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,GACX,4EAA4E,CAAC;AAE/E,wEAAwE;AACxE,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAEjD,0FAA0F;AAC1F,MAAM,YAAY,GAChB,sEAAsE,CAAC;AAEzE,sBAAsB;AACtB,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,kFAAkF;AAClF,MAAM,MAAM,GAAG,sBAAsB,CAAC;AAEtC,0CAA0C;AAC1C,MAAM,OAAO,GACX,qFAAqF,CAAC;AAExF,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC;AAC9B,MAAM,SAAS,GAAG,UAAU,CAAC;AAE7B,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IACjD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,IAAI,SAAS,IAAI,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACtE,CAAC"}

package/dist/recon/infer/path.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Templating heuristic — given multiple concrete paths observed for the same
+ * operation, produce an OpenAPI path template (`{paramName}`) and infer the
+ * primitive type for each templated segment.
+ */
+export interface TemplatedPath {
+    template: string;
+    paramTypes: Record<string, "string" | "integer">;
+}
+/** A single observation can't be templated — return it as-is, no params. */
+export declare function templateSinglePath(pathname: string): TemplatedPath;
+/**
+ * Template `rawPath` segment by segment. A segment becomes a parameter when it
+ * is a strong id (integer, UUID, long hex) on its own, or when it is id-like
+ * and peers with the same shape and prefix carry other id-like values there.
+ * Other segments stay literal, so `/users/me` and `/users/{userId}` coexist.
+ */
+export declare function templatePathFor(rawPath: string, allPaths: ReadonlyArray<string>): TemplatedPath;
+/**
+ * Template a set of paths that all share the same operation (same method).
+ * Returns `null` if the paths can't be safely unified — callers should fall
+ * back to per-path templating (e.g. `templateSinglePath`).
+ *
+ * Safety rule: at every segment position where values differ, EVERY value
+ * must be id-like (numeric, UUID, or slug-with-digit). Mixed cases like
+ * `/users/me` vs `/users/123` are refused — collapsing them into
+ * `/users/{userId}` would silently merge a static endpoint with a dynamic
+ * one.
+ */
+export declare function templatePaths(paths: ReadonlyArray<string>): TemplatedPath | null;
+//# sourceMappingURL=path.d.ts.map

package/dist/recon/infer/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/recon/infer/path.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;CAClD;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,aAAa,CAkCf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,aAAa,GAAG,IAAI,CAiCtB"}

package/dist/recon/infer/path.js

@@ -0,0 +1,153 @@
+/**
+ * Templating heuristic — given multiple concrete paths observed for the same
+ * operation, produce an OpenAPI path template (`{paramName}`) and infer the
+ * primitive type for each templated segment.
+ */
+const INT_RE = /^\d+$/;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const HEX_ID_RE = /^[0-9a-f]{16,}$/i;
+/** Segments that are identifiers on their own, without needing peers to vary: integers, UUIDs, long hex ids. */
+function isStrongId(value) {
+    return INT_RE.test(value) || UUID_RE.test(value) || HEX_ID_RE.test(value);
+}
+// "ID-like" = numeric, UUID, or a slug containing at least one digit (`item-12ab`).
+// Pure-alphabetic words like `active`, `me`, `latest` are NOT id-like — leaving
+// them as literal segments avoids the `/users/active` vs `/users/123` collision.
+function isIdLike(value) {
+    if (isStrongId(value))
+        return true;
+    return /\d/.test(value) && /^[A-Za-z0-9._~-]+$/.test(value);
+}
+/** A single observation can't be templated — return it as-is, no params. */
+export function templateSinglePath(pathname) {
+    return { template: pathname, paramTypes: {} };
+}
+/**
+ * Template `rawPath` segment by segment. A segment becomes a parameter when it
+ * is a strong id (integer, UUID, long hex) on its own, or when it is id-like
+ * and peers with the same shape and prefix carry other id-like values there.
+ * Other segments stay literal, so `/users/me` and `/users/{userId}` coexist.
+ */
+export function templatePathFor(rawPath, allPaths) {
+    const segs = rawPath.split("/");
+    const peers = allPaths
+        .map((p) => p.split("/"))
+        .filter((p) => p.length === segs.length);
+    const segments = [];
+    const paramTypes = {};
+    const usedNames = new Set();
+    segs.forEach((value, i) => {
+        const varied = peers
+            .filter((peer) => segments.every((seg, j) => seg.startsWith("{") ? isIdLike(peer[j]) : peer[j] === seg))
+            .map((peer) => peer[i])
+            .filter((v) => v !== value && isIdLike(v));
+        const isParam = value !== "" &&
+            (isStrongId(value) || (isIdLike(value) && varied.length > 0));
+        if (!isParam) {
+            segments.push(value);
+            return;
+        }
+        const name = paramNameFromContext(segments, usedNames);
+        usedNames.add(name);
+        paramTypes[name] = [value, ...varied].every((v) => INT_RE.test(v))
+            ? "integer"
+            : "string";
+        segments.push(`{${name}}`);
+    });
+    return { template: segments.join("/"), paramTypes };
+}
+/**
+ * Template a set of paths that all share the same operation (same method).
+ * Returns `null` if the paths can't be safely unified — callers should fall
+ * back to per-path templating (e.g. `templateSinglePath`).
+ *
+ * Safety rule: at every segment position where values differ, EVERY value
+ * must be id-like (numeric, UUID, or slug-with-digit). Mixed cases like
+ * `/users/me` vs `/users/123` are refused — collapsing them into
+ * `/users/{userId}` would silently merge a static endpoint with a dynamic
+ * one.
+ */
+export function templatePaths(paths) {
+    if (paths.length === 0)
+        return { template: "/", paramTypes: {} };
+    if (paths.length === 1)
+        return templateSinglePath(paths[0]);
+    const split = paths.map((p) => p.split("/"));
+    const segCount = split[0].length;
+    if (!split.every((s) => s.length === segCount))
+        return null;
+    const segments = [];
+    const paramTypes = {};
+    const usedNames = new Set();
+    for (let i = 0; i < segCount; i++) {
+        const values = split.map((s) => s[i]);
+        const distinct = new Set(values);
+        if (distinct.size === 1) {
+            segments.push(values[0]);
+            continue;
+        }
+        if (!values.every(isIdLike))
+            return null;
+        const type = values.every((v) => INT_RE.test(v))
+            ? "integer"
+            : "string";
+        const baseName = paramNameFromContext(segments, usedNames);
+        usedNames.add(baseName);
+        paramTypes[baseName] = type;
+        segments.push(`{${baseName}}`);
+    }
+    return { template: segments.join("/"), paramTypes };
+}
+/**
+ * Derive a parameter name from the previous literal segment.
+ * `/users/{?}` → `userId`. If no usable predecessor, fall back to `paramN`.
+ */
+function paramNameFromContext(prior, used) {
+    for (let i = prior.length - 1; i >= 0; i--) {
+        const seg = prior[i];
+        if (!seg || seg.startsWith("{"))
+            continue;
+        const cleaned = seg.replace(/[^a-zA-Z0-9]/g, "");
+        if (!cleaned)
+            continue;
+        const candidate = `${toCamelCase(singularize(cleaned))}Id`;
+        if (!used.has(candidate))
+            return candidate;
+        let n = 2;
+        while (used.has(`${candidate}${n}`))
+            n++;
+        return `${candidate}${n}`;
+    }
+    let n = 1;
+    while (used.has(`param${n}`))
+        n++;
+    return `param${n}`;
+}
+/** Crude singularizer — strip trailing `s` if present. Good enough for path segment naming. */
+function singularize(word) {
+    if (word.length > 1 && word.endsWith("s") && !word.endsWith("ss")) {
+        return word.slice(0, -1);
+    }
+    return word;
+}
+/**
+ * Lowercase camelCase. Splits on case transitions and non-alphanumeric chars,
+ * then joins with a leading-lowercase / Title-cased word pattern. Pure JS —
+ * no external dep so the package stays browser-clean.
+ */
+function toCamelCase(s) {
+    if (!s)
+        return s;
+    const words = s
+        .replace(/([a-z\d])([A-Z])/g, "$1 $2")
+        .replace(/([A-Z])([A-Z][a-z])/g, "$1 $2")
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean);
+    return words
+        .map((w, i) => {
+        const lower = w.toLowerCase();
+        return i === 0 ? lower : lower[0].toUpperCase() + lower.slice(1);
+    })
+        .join("");
+}
+//# sourceMappingURL=path.js.map

package/dist/recon/infer/path.js.map

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

package/dist/recon/infer/schema.d.ts

@@ -0,0 +1,10 @@
+import type { Schema } from "../types.js";
+export declare function inferSchema(value: unknown): Schema;
+/**
+ * Merge two schemas inferred from different samples of the same field.
+ * Required-field rule: a property is `required` only if it's required in
+ * BOTH inputs (intersection). Type widening: same type → keep; different
+ * primitive types → emit `type` array (e.g. `["string", "null"]`).
+ */
+export declare function mergeSchema(a: Schema, b: Schema): Schema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/recon/infer/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/recon/infer/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAyClD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAmCxD"}