@ir-kit/kit 0.0.1 → 1.0.0

package/dist/recon/types.d.ts

@@ -0,0 +1,102 @@
+import type { JSONSchemaDraft2020_12 } from "@hey-api/spec-types";
+/** A JSON Schema 2020-12 document — alias for the namespace's `Document` type. */
+export type Schema = JSONSchemaDraft2020_12.Document;
+/** Lowercase HTTP method. */
+export type HttpMethod = "get" | "put" | "post" | "delete" | "options" | "head" | "patch" | "trace";
+/** A single captured request/response pair, normalized for inference. */
+export interface Sample {
+    method: HttpMethod;
+    /** Origin (scheme + host + port). e.g. `https://api.example.com` */
+    origin: string;
+    /** URL pathname only. e.g. `/pets/42` */
+    pathname: string;
+    /** Query parameters as a flat string→string map. Multi-value keys collapse to last. */
+    query: Record<string, string>;
+    /** Request headers, lower-cased keys. Sanitized before storage. */
+    requestHeaders: Record<string, string>;
+    /** Bare media type of the request (e.g. `application/json`), or null. */
+    requestContentType: string | null;
+    /**
+     * Request body: a parsed JSON value when content-type is JSON-like, a
+     * string for text-like content, or null for missing/unreadable bodies.
+     */
+    requestBody: unknown;
+    /** Detected auth scheme id from request headers, if any. */
+    authSchemeId: string | null;
+    /** Response status code. */
+    status: number;
+    /** Response headers, lower-cased keys. */
+    responseHeaders: Record<string, string>;
+    /** Bare media type of the response, or null when not provided. */
+    responseContentType: string | null;
+    /**
+     * Response body: a parsed JSON value when content-type is JSON-like, a
+     * string for text-like content, or null when missing/binary/unreadable.
+     */
+    responseBody: unknown;
+}
+/**
+ * Capped, dedup-by-canonical-JSON set of example payloads.
+ * Key = canonical JSON string of the value (stable, sorted keys).
+ * Value = the parsed example (so emitters don't have to re-parse).
+ */
+export type ExampleBucket = Map<string, unknown>;
+/**
+ * Aggregate of all samples for one (status, content-type) tuple.
+ * `schema` is `null` for non-JSON content (text/yaml/xml/...) where we
+ * carry examples but don't infer a structural schema.
+ */
+export interface ResponseContent {
+    schema: Schema | null;
+    examples: ExampleBucket;
+}
+/** Inferred operation: aggregates samples for one (origin, templated path, method). */
+export interface OperationObservation {
+    /** Original concrete pathnames seen (for path templating). */
+    rawPathnames: Set<string>;
+    /** Templated path with `{param}` placeholders; null until templating runs. */
+    templatedPath: string | null;
+    /** Inferred path-parameter names → primitive type. */
+    pathParams: Record<string, "string" | "integer">;
+    /**
+     * Per-content-type aggregate request body. Each entry carries a schema
+     * (JSON only) and bounded examples.
+     */
+    requestContent: Map<string, ResponseContent>;
+    /**
+     * Per-status-code, per-content-type aggregate response. A status with no
+     * body still gets an entry (empty inner map) so the emitted spec shows
+     * the real status code instead of falling through to `default`.
+     */
+    responseContent: Map<number, Map<string, ResponseContent>>;
+    /** Query-parameter names → primitive type. */
+    queryParams: Record<string, "string" | "integer" | "boolean">;
+    /** Number of samples folded into this observation. */
+    sampleCount: number;
+    /** Auth scheme ids observed across samples (e.g. `bearerAuth`). */
+    authSchemes: Set<string>;
+}
+/** Configuration for `createRecon`. */
+export interface ReconConfig {
+    /** Header names to redact entirely (lower-case). Defaults include common auth headers. */
+    redactHeaders?: ReadonlyArray<string>;
+    /** When true, attempt path templating; when false, every distinct path is its own operation. */
+    pathTemplating?: boolean;
+    /** OpenAPI document title to emit. @default "Reverse-engineered API" */
+    title?: string;
+    /** OpenAPI document version to emit. @default "0.0.0" */
+    version?: string;
+    /**
+     * Maximum number of distinct example payloads kept per request body and
+     * per response status code. Distinct = different canonical JSON. Set to
+     * `0` to disable example capture entirely. @default 3
+     */
+    maxExamples?: number;
+    /**
+     * Hoist repeated/recursive object shapes into `components.schemas` and
+     * replace inline occurrences with `$ref`. Minimum number of occurrences
+     * before a shape is hoisted. Set to `0` to disable. @default 2
+     */
+    refDedupeThreshold?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/recon/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,kFAAkF;AAClF,MAAM,MAAM,MAAM,GAAG,sBAAsB,CAAC,QAAQ,CAAC;AAErD,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,KAAK,GACL,MAAM,GACN,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,kEAAkE;IAClE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IACjD;;;OAGG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C;;;;OAIG;IACH,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAC3D,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;IAC9D,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,gGAAgG;IAChG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/recon/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/recon/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recon/types.ts"],"names":[],"mappings":""}

package/dist/schema/adapters/heyapi.d.ts

@@ -0,0 +1,58 @@
+import type { Schema } from "../types.js";
+type Extensions = {
+    [key: `x-${string}`]: unknown;
+};
+type SchemaType = "array" | "boolean" | "enum" | "integer" | "never" | "null" | "number" | "object" | "string" | "tuple" | "undefined" | "unknown" | "void";
+/**
+ * JSON Schema 2020-12 plus a few normalized forms: `type: "enum"` with
+ * `items[].const`, `type: "tuple"`, and `items` + `logicalOperator` for
+ * unions and intersections.
+ */
+export interface HeyApiSchema extends Extensions {
+    $ref?: string;
+    type?: SchemaType;
+    format?: string;
+    title?: string;
+    description?: string;
+    deprecated?: boolean;
+    default?: unknown;
+    const?: unknown;
+    example?: unknown;
+    accessScope?: "read" | "write";
+    properties?: Record<string, HeyApiSchema>;
+    required?: ReadonlyArray<string>;
+    additionalProperties?: HeyApiSchema | false;
+    patternProperties?: Record<string, HeyApiSchema>;
+    propertyNames?: HeyApiSchema;
+    items?: ReadonlyArray<HeyApiSchema>;
+    logicalOperator?: "and" | "or";
+    discriminator?: {
+        propertyName: string;
+        mapping?: Record<string, string>;
+    };
+    omit?: ReadonlyArray<string>;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+}
+/**
+ * Adapt `HeyApiSchema` (hey-api's normalized intermediate form) to
+ * canonical {@link Schema}.
+ *
+ * Normalizations:
+ *  - `type:"enum"` + `items[].const` → `enum: [...]`
+ *  - `type:"tuple"`                  → `type:"array"` + `prefixItems`
+ *  - `type:"void"|"never"|"undefined"` → `type` left unset
+ *  - `logicalOperator:"or"|"and"`      → `oneOf` / `allOf`
+ *  - untyped + items[]                 → `oneOf` (hey-api's implicit
+ *                                        union convention)
+ */
+export declare function fromHeyApi(s: HeyApiSchema): Schema;
+export {};
+//# sourceMappingURL=heyapi.d.ts.map

package/dist/schema/adapters/heyapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heyapi.d.ts","sourceRoot":"","sources":["../../../src/schema/adapters/heyapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAuB,MAAM,aAAa,CAAC;AAE/D,KAAK,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAA;CAAE,CAAC;AAEpD,KAAK,UAAU,GACX,OAAO,GACP,SAAS,GACT,MAAM,GACN,SAAS,GACT,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,WAAW,GACX,SAAS,GACT,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,oBAAoB,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,KAAK,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACpC,eAAe,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC3E,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAsGlD"}

package/dist/schema/adapters/heyapi.js

@@ -0,0 +1,137 @@
+/**
+ * Adapt `HeyApiSchema` (hey-api's normalized intermediate form) to
+ * canonical {@link Schema}.
+ *
+ * Normalizations:
+ *  - `type:"enum"` + `items[].const` → `enum: [...]`
+ *  - `type:"tuple"`                  → `type:"array"` + `prefixItems`
+ *  - `type:"void"|"never"|"undefined"` → `type` left unset
+ *  - `logicalOperator:"or"|"and"`      → `oneOf` / `allOf`
+ *  - untyped + items[]                 → `oneOf` (hey-api's implicit
+ *                                        union convention)
+ */
+export function fromHeyApi(s) {
+    const out = {};
+    if (s.$ref) {
+        out.$ref = s.$ref;
+    }
+    else {
+        // hey-api's post-resolution marker for a generated symbol —
+        // express it canonically as a $ref into `#/components/schemas`.
+        const sym = s.symbolRef;
+        if (sym?.name)
+            out.$ref = `#/components/schemas/${sym.name}`;
+    }
+    if (s.title)
+        out.title = s.title;
+    if (s.description)
+        out.description = s.description;
+    if (s.deprecated !== undefined)
+        out.deprecated = s.deprecated;
+    if (s.default !== undefined)
+        out.default = s.default;
+    if (s.format)
+        out.format = s.format;
+    if (s.pattern)
+        out.pattern = s.pattern;
+    if (s.minLength !== undefined)
+        out.minLength = s.minLength;
+    if (s.maxLength !== undefined)
+        out.maxLength = s.maxLength;
+    if (s.minimum !== undefined)
+        out.minimum = s.minimum;
+    if (s.maximum !== undefined)
+        out.maximum = s.maximum;
+    if (typeof s.exclusiveMinimum === "number")
+        out.exclusiveMinimum = s.exclusiveMinimum;
+    if (typeof s.exclusiveMaximum === "number")
+        out.exclusiveMaximum = s.exclusiveMaximum;
+    if (s.const !== undefined)
+        out.const = s.const;
+    if (s.logicalOperator === "and" && Array.isArray(s.items)) {
+        out.allOf = s.items.map(fromHeyApi);
+    }
+    else if (s.logicalOperator === "or" && Array.isArray(s.items)) {
+        out.oneOf = s.items.map(fromHeyApi);
+    }
+    else if (!s.type && Array.isArray(s.items) && s.items.length > 0) {
+        out.oneOf = s.items.map(fromHeyApi);
+    }
+    if (s.properties) {
+        out.properties = {};
+        for (const [k, v] of Object.entries(s.properties)) {
+            out.properties[k] = fromHeyApi(v);
+        }
+    }
+    if (s.required && s.required.length > 0)
+        out.required = [...s.required];
+    if (s.additionalProperties !== undefined) {
+        const ap = s.additionalProperties;
+        if (typeof ap === "boolean") {
+            out.additionalProperties = ap;
+        }
+        else if (ap.type === "never" ||
+            ap.type === "void" ||
+            ap.type === "undefined") {
+            // hey-api represents `additionalProperties: false` as a never/void/
+            // undefined-typed schema after normalization — collapse back to
+            // the canonical boolean form so emitters can sealed-detect.
+            out.additionalProperties = false;
+        }
+        else {
+            out.additionalProperties = fromHeyApi(ap);
+        }
+    }
+    switch (s.type) {
+        case "enum": {
+            const values = (s.items ?? [])
+                .map((i) => i.const)
+                .filter((v) => typeof v === "string" ||
+                typeof v === "number" ||
+                typeof v === "boolean");
+            if (values.length > 0)
+                out.enum = values;
+            out.type = inferEnumType(values);
+            break;
+        }
+        case "tuple": {
+            out.type = "array";
+            if (Array.isArray(s.items) && s.items.length > 0) {
+                out.prefixItems = s.items.map(fromHeyApi);
+            }
+            break;
+        }
+        case "array": {
+            out.type = "array";
+            const elem = Array.isArray(s.items) ? s.items[0] : undefined;
+            if (elem)
+                out.items = fromHeyApi(elem);
+            break;
+        }
+        case "void":
+        case "never":
+        case "undefined":
+            break;
+        case "object":
+        case "string":
+        case "number":
+        case "integer":
+        case "boolean":
+        case "null":
+            out.type = s.type;
+            break;
+    }
+    return out;
+}
+function inferEnumType(values) {
+    if (values.every((v) => typeof v === "string"))
+        return "string";
+    if (values.every((v) => typeof v === "number" && Number.isInteger(v)))
+        return "integer";
+    if (values.every((v) => typeof v === "number"))
+        return "number";
+    if (values.every((v) => typeof v === "boolean"))
+        return "boolean";
+    return undefined;
+}
+//# sourceMappingURL=heyapi.js.map

package/dist/schema/adapters/heyapi.js.map

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

package/dist/schema/adapters/jsonschema.d.ts

@@ -0,0 +1,16 @@
+import type { Schema } from "../types.js";
+export type JsonSchemaDialect = "draft-04" | "draft-06" | "draft-07" | "2019-09" | "2020-12";
+export interface FromJsonSchemaOptions {
+    /** Source dialect — drives normalization of legacy quirks (boolean
+     *  `exclusiveMinimum`, array-form `items` as tuple, `definitions` →
+     *  `$defs`). Defaults to `2020-12` (pass-through). */
+    dialect?: JsonSchemaDialect;
+}
+/**
+ * Adapt raw JSON Schema (any draft) → canonical {@link Schema}. Pure
+ * conversion: no validation, no ref resolution. Unknown keywords are
+ * dropped. OpenAPI 3.0's `nullable: true` is folded into the type
+ * array regardless of dialect (it's a common quirk).
+ */
+export declare function fromJsonSchema(raw: unknown, opts?: FromJsonSchemaOptions): Schema;
+//# sourceMappingURL=jsonschema.d.ts.map

package/dist/schema/adapters/jsonschema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonschema.d.ts","sourceRoot":"","sources":["../../../src/schema/adapters/jsonschema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAuB,MAAM,aAAa,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,UAAU,GACV,UAAU,GACV,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,qBAAqB;IACpC;;0DAEsD;IACtD,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAYD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE,qBAA0B,GAC/B,MAAM,CAwIR"}

package/dist/schema/adapters/jsonschema.js

@@ -0,0 +1,161 @@
+const PRIMITIVE_TYPES = new Set([
+    "string",
+    "number",
+    "integer",
+    "boolean",
+    "null",
+    "object",
+    "array",
+]);
+/**
+ * Adapt raw JSON Schema (any draft) → canonical {@link Schema}. Pure
+ * conversion: no validation, no ref resolution. Unknown keywords are
+ * dropped. OpenAPI 3.0's `nullable: true` is folded into the type
+ * array regardless of dialect (it's a common quirk).
+ */
+export function fromJsonSchema(raw, opts = {}) {
+    if (typeof raw !== "object" || raw === null)
+        return {};
+    const r = raw;
+    const dialect = opts.dialect ?? "2020-12";
+    const out = {};
+    if (typeof r.$ref === "string")
+        out.$ref = r.$ref;
+    if (typeof r.title === "string")
+        out.title = r.title;
+    if (typeof r.description === "string")
+        out.description = r.description;
+    if (typeof r.deprecated === "boolean")
+        out.deprecated = r.deprecated;
+    if (typeof r.readOnly === "boolean")
+        out.readOnly = r.readOnly;
+    if (typeof r.writeOnly === "boolean")
+        out.writeOnly = r.writeOnly;
+    if (r.default !== undefined)
+        out.default = r.default;
+    if (typeof r.format === "string")
+        out.format = r.format;
+    if (typeof r.pattern === "string")
+        out.pattern = r.pattern;
+    if (typeof r.minLength === "number")
+        out.minLength = r.minLength;
+    if (typeof r.maxLength === "number")
+        out.maxLength = r.maxLength;
+    if (typeof r.minimum === "number")
+        out.minimum = r.minimum;
+    if (typeof r.maximum === "number")
+        out.maximum = r.maximum;
+    if (typeof r.multipleOf === "number")
+        out.multipleOf = r.multipleOf;
+    if (typeof r.minItems === "number")
+        out.minItems = r.minItems;
+    if (typeof r.maxItems === "number")
+        out.maxItems = r.maxItems;
+    if (typeof r.uniqueItems === "boolean")
+        out.uniqueItems = r.uniqueItems;
+    if (r.const !== undefined)
+        out.const = r.const;
+    if (Array.isArray(r.enum) && r.enum.length > 0)
+        out.enum = r.enum;
+    if (Array.isArray(r.examples))
+        out.examples = r.examples;
+    if (Array.isArray(r.required)) {
+        const req = r.required.filter((x) => typeof x === "string");
+        if (req.length > 0)
+            out.required = req;
+    }
+    if (dialect === "draft-04") {
+        if (r.exclusiveMinimum === true && typeof r.minimum === "number") {
+            out.exclusiveMinimum = r.minimum;
+        }
+        else if (typeof r.exclusiveMinimum === "number") {
+            out.exclusiveMinimum = r.exclusiveMinimum;
+        }
+        if (r.exclusiveMaximum === true && typeof r.maximum === "number") {
+            out.exclusiveMaximum = r.maximum;
+        }
+        else if (typeof r.exclusiveMaximum === "number") {
+            out.exclusiveMaximum = r.exclusiveMaximum;
+        }
+    }
+    else {
+        if (typeof r.exclusiveMinimum === "number")
+            out.exclusiveMinimum = r.exclusiveMinimum;
+        if (typeof r.exclusiveMaximum === "number")
+            out.exclusiveMaximum = r.exclusiveMaximum;
+    }
+    const nullable = r.nullable === true;
+    if (typeof r.type === "string" && isPrimitiveTag(r.type)) {
+        out.type = nullable && r.type !== "null" ? [r.type, "null"] : r.type;
+    }
+    else if (Array.isArray(r.type)) {
+        const tags = r.type.filter((t) => typeof t === "string" && isPrimitiveTag(t));
+        if (tags.length > 0) {
+            out.type = nullable && !tags.includes("null") ? [...tags, "null"] : tags;
+        }
+    }
+    else if (nullable) {
+        out.type = ["null"];
+    }
+    if (Array.isArray(r.oneOf))
+        out.oneOf = r.oneOf.map((b) => fromJsonSchema(b, opts));
+    if (Array.isArray(r.anyOf))
+        out.anyOf = r.anyOf.map((b) => fromJsonSchema(b, opts));
+    if (Array.isArray(r.allOf))
+        out.allOf = r.allOf.map((b) => fromJsonSchema(b, opts));
+    if (r.not && typeof r.not === "object")
+        out.not = fromJsonSchema(r.not, opts);
+    if (r.properties && typeof r.properties === "object") {
+        out.properties = {};
+        for (const [k, v] of Object.entries(r.properties)) {
+            out.properties[k] = fromJsonSchema(v, opts);
+        }
+    }
+    if (r.patternProperties && typeof r.patternProperties === "object") {
+        out.patternProperties = {};
+        for (const [k, v] of Object.entries(r.patternProperties)) {
+            out.patternProperties[k] = fromJsonSchema(v, opts);
+        }
+    }
+    if (typeof r.additionalProperties === "boolean") {
+        out.additionalProperties = r.additionalProperties;
+    }
+    else if (r.additionalProperties &&
+        typeof r.additionalProperties === "object") {
+        out.additionalProperties = fromJsonSchema(r.additionalProperties, opts);
+    }
+    if (r.propertyNames && typeof r.propertyNames === "object") {
+        out.propertyNames = fromJsonSchema(r.propertyNames, opts);
+    }
+    if (Array.isArray(r.items)) {
+        out.prefixItems = r.items.map((b) => fromJsonSchema(b, opts));
+    }
+    else if (r.items && typeof r.items === "object") {
+        out.items = fromJsonSchema(r.items, opts);
+    }
+    if (Array.isArray(r.prefixItems)) {
+        out.prefixItems = r.prefixItems.map((b) => fromJsonSchema(b, opts));
+    }
+    const defs = (r.$defs ?? r.definitions);
+    if (defs && typeof defs === "object") {
+        out.$defs = {};
+        for (const [k, v] of Object.entries(defs)) {
+            out.$defs[k] = fromJsonSchema(v, opts);
+        }
+    }
+    if (r.discriminator &&
+        typeof r.discriminator === "object" &&
+        typeof r.discriminator.propertyName ===
+            "string") {
+        const d = r.discriminator;
+        out.discriminator = {
+            propertyName: d.propertyName,
+            ...(d.mapping ? { mapping: d.mapping } : {}),
+        };
+    }
+    return out;
+}
+function isPrimitiveTag(t) {
+    return PRIMITIVE_TYPES.has(t);
+}
+//# sourceMappingURL=jsonschema.js.map

package/dist/schema/adapters/jsonschema.js.map

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

package/dist/schema/enum.d.ts

@@ -0,0 +1,30 @@
+import { type Schema } from "./types.js";
+export type EnumLiteral = string | number | boolean;
+export type EnumKind = "string" | "integer" | "number" | "boolean" | "mixed";
+/**
+ * Extract enum literals from a schema. Recognises both explicit
+ * `enum: [...]` and `oneOf`/`anyOf` of `{const}` branches. Returns
+ * `undefined` when neither shape is present.
+ */
+export declare function extractEnumValues(schema: Schema): ReadonlyArray<unknown> | undefined;
+/**
+ * The value domain of an enum's literals. `string` / `integer` become
+ * real enums; `number` / `boolean` degrade to the matching primitive;
+ * `mixed` (or empty) becomes the target's untyped fallback.
+ */
+export declare function classifyEnumLiterals(values: ReadonlyArray<unknown>): EnumKind;
+export interface EnumEntryIdent<T extends string | number> {
+    identifier: string;
+    raw: T;
+}
+/**
+ * Assign every distinct raw value its own identifier. Duplicate raws
+ * collapse to one entry; raws whose identifiers clash (`"ASC"` / `"asc"`)
+ * get deterministic suffixes from `disambiguate`.
+ */
+export declare function uniqueEnumEntries<T extends string | number>(raws: ReadonlyArray<T>, identifier: (raw: T) => string, disambiguate?: (base: string, n: number) => string): EnumEntryIdent<T>[];
+/** The enum's string, number and boolean values; `null` and objects are dropped. */
+export declare function getEnumLiterals(schema: Schema): EnumLiteral[];
+/** A `string` schema whose values aren't restricted to an enum. */
+export declare function isPlainString(schema: Schema | undefined): boolean;
+//# sourceMappingURL=enum.d.ts.map

package/dist/schema/enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/schema/enum.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GACb,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,CAWpC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,QAAQ,CAQ7E;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,CAAC,CAAC;CACR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACzD,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EACtB,UAAU,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,EAC9B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GACjD,cAAc,CAAC,CAAC,CAAC,EAAE,CAUrB;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAK7D;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE"}

package/dist/schema/enum.js

@@ -0,0 +1,67 @@
+import { Namespace } from "../codegen/index.js";
+import { isSchemaObject } from "./types.js";
+/**
+ * Extract enum literals from a schema. Recognises both explicit
+ * `enum: [...]` and `oneOf`/`anyOf` of `{const}` branches. Returns
+ * `undefined` when neither shape is present.
+ */
+export function extractEnumValues(schema) {
+    if (Array.isArray(schema.enum) && schema.enum.length > 0)
+        return schema.enum;
+    const branches = schema.oneOf ?? schema.anyOf;
+    if (!branches)
+        return undefined;
+    const consts = [];
+    for (const b of branches) {
+        if (!isSchemaObject(b))
+            return undefined;
+        if (Object.hasOwn(b, "const"))
+            consts.push(b.const);
+        else
+            return undefined;
+    }
+    return consts.length > 0 ? consts : undefined;
+}
+/**
+ * The value domain of an enum's literals. `string` / `integer` become
+ * real enums; `number` / `boolean` degrade to the matching primitive;
+ * `mixed` (or empty) becomes the target's untyped fallback.
+ */
+export function classifyEnumLiterals(values) {
+    if (values.length === 0)
+        return "mixed";
+    if (values.every((v) => typeof v === "string"))
+        return "string";
+    if (values.every((v) => typeof v === "boolean"))
+        return "boolean";
+    if (values.every((v) => typeof v === "number")) {
+        return values.every((v) => Number.isInteger(v)) ? "integer" : "number";
+    }
+    return "mixed";
+}
+/**
+ * Assign every distinct raw value its own identifier. Duplicate raws
+ * collapse to one entry; raws whose identifiers clash (`"ASC"` / `"asc"`)
+ * get deterministic suffixes from `disambiguate`.
+ */
+export function uniqueEnumEntries(raws, identifier, disambiguate) {
+    const ns = new Namespace({ normalize: (s) => s, disambiguate });
+    const seen = new Set();
+    const out = [];
+    for (const raw of raws) {
+        if (seen.has(raw))
+            continue;
+        seen.add(raw);
+        out.push({ raw, identifier: ns.claim(String(raw), identifier(raw)) });
+    }
+    return out;
+}
+/** The enum's string, number and boolean values; `null` and objects are dropped. */
+export function getEnumLiterals(schema) {
+    return (extractEnumValues(schema) ?? []).filter((v) => typeof v === "string" || typeof v === "number" || typeof v === "boolean");
+}
+/** A `string` schema whose values aren't restricted to an enum. */
+export function isPlainString(schema) {
+    return schema?.type === "string" && extractEnumValues(schema) === undefined;
+}
+//# sourceMappingURL=enum.js.map

package/dist/schema/enum.js.map

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

package/dist/schema/index.d.ts

@@ -0,0 +1,7 @@
+export { classifyEnumLiterals, type EnumEntryIdent, type EnumKind, type EnumLiteral, extractEnumValues, getEnumLiterals, isPlainString, uniqueEnumEntries, } from "./enum.js";
+export { classifyObject, iterateObjectProperties, type ObjectProperty, type ObjectShape, } from "./object.js";
+export { isPrimitive, isPrimitiveTag, primitiveTag, } from "./primitive.js";
+export { refName } from "./ref.js";
+export { isNullable, isRefOnly, isSchemaObject, type Schema, type SchemaDiscriminator, type SchemaOrBool, type SchemaPrimitiveType, typeList, } from "./types.js";
+export { classifyUnion, isUnionShape, type UnionShape, } from "./union.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EACL,UAAU,EACV,SAAS,EACT,cAAc,EACd,KAAK,MAAM,EACX,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC"}