@ir-kit/kit 0.0.0-stage → 1.0.0

package/dist/fn-schema/core/types.d.ts

@@ -0,0 +1,265 @@
+import type { JSONSchema7 } from "json-schema";
+export type JSONSchema = JSONSchema7;
+export type FunctionKind = "function" | "arrow" | "method" | "constructor" | "expression";
+export interface SourceLocation {
+    line: number;
+    column: number;
+}
+export interface ParameterInfo {
+    name: string;
+    index: number;
+    optional: boolean;
+    rest: boolean;
+    /** Raw type text as written in source (best-effort, language-specific). */
+    typeText?: string;
+}
+export interface JSDocInfo {
+    description?: string;
+    tags: Record<string, string | true>;
+}
+/**
+ * Discovered function — language-agnostic IR. Produced by an `Extractor`,
+ * consumed by both filters and schema generation.
+ */
+export interface FunctionInfo {
+    /** Stable identifier within (file, language) scope; usually the source name. */
+    name: string;
+    file: string;
+    location: SourceLocation;
+    kind: FunctionKind;
+    language: string;
+    exported: boolean;
+    async: boolean;
+    generic: boolean;
+    parameters: ParameterInfo[];
+    jsDoc?: JSDocInfo;
+    /** Class name when `kind === "method"`. */
+    className?: string;
+    /** Decorator names when `kind === "method"`. */
+    decorators?: string[];
+}
+/** Per-extractor init payload. Extractors decide which fields they need. */
+export interface ExtractorInitOptions {
+    tsConfigPath?: string;
+    cwd?: string;
+}
+export interface SignaturePair {
+    input: JSONSchema | JSONSchema[];
+    output: JSONSchema;
+    definitions?: Record<string, JSONSchema>;
+    coverage?: CoverageReport;
+}
+/**
+ * Where a coverage note fired — which overload, which side of the signature,
+ * and (for input parameters) which slot. Lets downstream tools render
+ * per-occurrence diagnostics instead of collapsing repeats by type name.
+ */
+export interface CoverageOccurrence {
+    side: "input" | "output";
+    /** Index into the resolved overload list (0 = first / oldest). */
+    overloadIndex: number;
+    /** Parameter slot index (input only). */
+    paramIndex?: number;
+    /** Parameter binding name (input only). */
+    paramName?: string;
+}
+export interface CoverageEntry {
+    name: string;
+    count: number;
+    occurrences: CoverageOccurrence[];
+}
+export interface LossyCoverageEntry extends CoverageEntry {
+    reason: string;
+}
+export interface CoverageReport {
+    mapped: CoverageEntry[];
+    lossy: LossyCoverageEntry[];
+    notRepresentable: CoverageEntry[];
+}
+export interface Extractor {
+    /** File extensions claimed by this extractor (e.g. [".ts", ".tsx"]). */
+    readonly extensions: readonly string[];
+    readonly language: string;
+    init(opts: ExtractorInitOptions): Promise<ExtractorInstance>;
+}
+export interface ExtractorInstance {
+    discover(files: readonly string[], filter: ResolvedFilter): Promise<FunctionInfo[]>;
+    toSchemas(fn: FunctionInfo, opts: ResolvedSignatureOptions & ResolvedSchemaOptions): Promise<SignaturePair>;
+    refresh(files: readonly string[]): void;
+    dispose(): void;
+}
+export type NamePattern = string | RegExp;
+export interface IncludeFilter {
+    exported?: boolean;
+    name?: NamePattern | NamePattern[];
+    jsDocTag?: string | string[];
+    kind?: FunctionKind[];
+    decorator?: NamePattern;
+}
+export type ExcludeFilter = IncludeFilter;
+export interface ResolvedFilter {
+    exported: boolean;
+    name: RegExp[] | null;
+    jsDocTag: string[] | null;
+    kind: FunctionKind[] | null;
+    decorator: RegExp | null;
+    exclude: {
+        name: RegExp[] | null;
+        jsDocTag: string[] | null;
+        kind: FunctionKind[] | null;
+        decorator: RegExp | null;
+    };
+    custom: ((fn: FunctionInfo) => boolean) | null;
+}
+export type NamingStrategy = "function-name" | "file-function" | "jsdoc-tag" | ((fn: FunctionInfo) => string);
+export type ParametersStrategy = "array" | "first-only" | "object";
+export type GenericsStrategy = "skip" | "erase" | "error";
+export type OverloadStrategy = "all" | "first" | "last" | "merge";
+export interface SignatureOptions {
+    parameters?: ParametersStrategy;
+    unwrapPromise?: boolean;
+    generics?: GenericsStrategy;
+    overloads?: OverloadStrategy;
+    skipParameter?: (p: ParameterInfo) => boolean;
+}
+export interface ResolvedSignatureOptions {
+    parameters: ParametersStrategy;
+    unwrapPromise: boolean;
+    generics: GenericsStrategy;
+    overloads: OverloadStrategy;
+    skipParameter: ((p: ParameterInfo) => boolean) | null;
+}
+export type SchemaDialect = "draft-07" | "draft-2020-12" | "openapi-3.1";
+export type RefStrategy = "inline" | "definitions" | "external";
+export interface SchemaOptions {
+    dialect?: SchemaDialect;
+    refStrategy?: RefStrategy;
+    definitionsPath?: string;
+    topRef?: boolean;
+    additionalProperties?: boolean;
+    encodeRefs?: boolean;
+    expose?: "all" | "export" | "none";
+    /**
+     * Map TS type names to canonical JSON Schema. Merged on top of built-ins
+     * (Date, URL, RegExp, File, Blob, Buffer, Uint8Array, ArrayBuffer, bigint).
+     * User entries override built-ins.
+     */
+    typeMappers?: Record<string, JSONSchema>;
+    /**
+     * Attach the originating TS type name to mapped + named-type schemas via a
+     * vendor-extension keyword. Pass `false` (default) for pure JSON Schema, or
+     * a key name (typically `"x-fn-schema-ts"`) to opt in. Required for
+     * canvas-style nominal-type matching across functions.
+     */
+    identity?: false | string;
+    /**
+     * Attach a transport hint (`"multipart"` / `"base64"` / `"json"`) to
+     * binary-shaped schemas (File/Blob/Buffer/Uint8Array/ArrayBuffer) under a
+     * vendor-extension keyword. Pass `false` (default) or a key name (typically
+     * `"x-fn-schema-transport"`). Lets frontends pick the wire format.
+     */
+    transport?: false | string;
+    /**
+     * Attach the source-file location of every named type as a vendor-extension
+     * keyword. `false` (default) or a key name (typically `"x-fn-schema-source"`).
+     */
+    sourceLocations?: false | string;
+}
+export interface ResolvedSchemaOptions {
+    dialect: SchemaDialect;
+    refStrategy: RefStrategy;
+    definitionsPath: string;
+    topRef: boolean;
+    additionalProperties: boolean;
+    encodeRefs: boolean;
+    expose: "all" | "export" | "none";
+    typeMappers: Record<string, JSONSchema>;
+    identity: false | string;
+    transport: false | string;
+    sourceLocations: false | string;
+}
+export interface SchemaContext {
+    function: FunctionInfo;
+    position: "input" | "output" | "parameter";
+    parameterIndex?: number;
+}
+export interface ExtractHooks {
+    onFunction?: (fn: FunctionInfo) => FunctionInfo | null | void;
+    onSchema?: (schema: JSONSchema, ctx: SchemaContext) => JSONSchema;
+}
+export interface TargetRef {
+    /** "src/api.ts#createUser" or "src/api.ts#User.create" */
+    value: string;
+}
+export interface InMemorySource {
+    code: string;
+    path?: string;
+}
+export interface ExtractOptions {
+    files?: string | string[];
+    source?: InMemorySource;
+    targets?: (string | TargetRef)[];
+    cwd?: string;
+    tsConfigPath?: string;
+    include?: IncludeFilter;
+    exclude?: ExcludeFilter;
+    filter?: (fn: FunctionInfo) => boolean;
+    signature?: SignatureOptions;
+    schema?: SchemaOptions;
+    naming?: NamingStrategy;
+    hooks?: ExtractHooks;
+    onDiagnostic?: (d: Diagnostic) => void;
+    failFast?: boolean;
+}
+export interface SignatureEntry {
+    id: string;
+    name: string;
+    file: string;
+    location: SourceLocation;
+    kind: FunctionKind;
+    language: string;
+    jsDoc?: JSDocInfo;
+    input: JSONSchema | JSONSchema[];
+    output: JSONSchema;
+    async: boolean;
+    generic: boolean;
+    coverage?: CoverageReport;
+}
+export interface ExtractStats {
+    filesScanned: number;
+    functionsFound: number;
+    durationMs: number;
+}
+export interface ExtractResult {
+    signatures: SignatureEntry[];
+    definitions: Record<string, JSONSchema>;
+    diagnostics: Diagnostic[];
+    stats: ExtractStats;
+}
+export type DiagnosticSeverity = "error" | "warning" | "info";
+export type DiagnosticCode = "GENERIC_SKIPPED" | "OVERLOAD_PICKED" | "UNRESOLVED_TYPE" | "EMPTY_RESULT" | "EXTRACTOR_FAILURE" | "FILE_READ_ERROR" | "INVALID_TARGET" | "DUPLICATE_ID" | "NO_EXTRACTOR" | "TYPE_MAPPED" | "LOSSY_MAPPING" | "NOT_REPRESENTABLE";
+export interface Diagnostic {
+    severity: DiagnosticSeverity;
+    code: DiagnosticCode;
+    message: string;
+    file?: string;
+    location?: SourceLocation;
+    function?: string;
+}
+export interface ProjectOptions {
+    extractors: Extractor[];
+    cwd?: string;
+    tsConfigPath?: string;
+}
+export interface DiscoverResult {
+    signatures: FunctionInfo[];
+    diagnostics: Diagnostic[];
+    stats: ExtractStats;
+}
+export interface Project {
+    extract(options?: Partial<ExtractOptions>): Promise<ExtractResult>;
+    discover(options?: Partial<ExtractOptions>): Promise<DiscoverResult>;
+    refresh(paths?: string[]): void;
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/fn-schema/core/types.d.ts.map

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

package/dist/fn-schema/core/types.js

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

package/dist/fn-schema/core/types.js.map

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

package/dist/fn-schema/load-typescript.d.ts

@@ -0,0 +1,2 @@
+export declare const loadTypescriptExtractor: () => Promise<typeof import("./typescript/extractor.js").typescript>;
+//# sourceMappingURL=load-typescript.d.ts.map

package/dist/fn-schema/load-typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-typescript.d.ts","sourceRoot":"","sources":["../../src/fn-schema/load-typescript.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB,sEAMtB,CAAC"}

package/dist/fn-schema/load-typescript.js

@@ -0,0 +1,6 @@
+import { loadOptional } from "../optional.js";
+export const loadTypescriptExtractor = async () => (await loadOptional(() => import("./typescript/index.js"), "fn-schema", [
+    "ts-morph",
+    "ts-json-schema-generator",
+])).typescript;
+//# sourceMappingURL=load-typescript.js.map

package/dist/fn-schema/load-typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-typescript.js","sourceRoot":"","sources":["../../src/fn-schema/load-typescript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,IAAI,EAAE,CAChD,CACE,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,EAAE,WAAW,EAAE;IACrE,UAAU;IACV,0BAA0B;CAC3B,CAAC,CACH,CAAC,UAAU,CAAC"}

package/dist/fn-schema/loader/index.d.ts

@@ -0,0 +1,3 @@
+export { createReader, type Reader } from "./reader.js";
+export { type Bundle, type BundleSignature, DEFAULT_IDENTITY_KEY, DEFINITIONS_PREFIX, type DefinitionName, type Match, type SignatureId, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/fn-schema/loader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/loader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC"}

package/dist/fn-schema/loader/index.js

@@ -0,0 +1,3 @@
+export { createReader } from "./reader.js";
+export { DEFAULT_IDENTITY_KEY, DEFINITIONS_PREFIX, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/fn-schema/loader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fn-schema/loader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AACxD,OAAO,EAGL,oBAAoB,EACpB,kBAAkB,GAInB,MAAM,YAAY,CAAC"}

package/dist/fn-schema/loader/reader.d.ts

@@ -0,0 +1,15 @@
+import { type Bundle, type DefinitionName, type Match, type SignatureId } from "./types.js";
+export interface Reader<T extends Bundle> {
+    readonly bundle: T;
+    get<K extends SignatureId<T>>(id: K): T["signatures"][K] | undefined;
+    has<K extends string>(id: K): id is K & SignatureId<T>;
+    resolve<K extends DefinitionName<T>>(name: K): T["definitions"][K] | undefined;
+    resolveRef(ref: string): Record<string, unknown> | undefined;
+    inputOf<K extends SignatureId<T>>(id: K): unknown;
+    outputOf<K extends SignatureId<T>>(id: K): unknown;
+    findByIdentity(name: string, identityKey?: string): Match[];
+    listSignatures(): SignatureId<T>[];
+    listDefinitions(): DefinitionName<T>[];
+}
+export declare function createReader<T extends Bundle>(bundle: T): Reader<T>;
+//# sourceMappingURL=reader.d.ts.map

package/dist/fn-schema/loader/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/loader/reader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAIX,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,MAAM;IACtC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,GAAG,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACrE,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,EACjC,IAAI,EAAE,CAAC,GACN,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7D,OAAO,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC;IAClD,QAAQ,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC;IACnD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IAC5D,cAAc,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,eAAe,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;CACxC;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CA2FnE"}

package/dist/fn-schema/loader/reader.js

@@ -0,0 +1,96 @@
+import { DEFAULT_IDENTITY_KEY, DEFINITIONS_PREFIX, } from "./types.js";
+export function createReader(bundle) {
+    const signatures = bundle.signatures;
+    const definitions = bundle.definitions;
+    const hasOwn = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key);
+    const resolveRef = (ref) => {
+        if (!ref.startsWith(DEFINITIONS_PREFIX))
+            return undefined;
+        const name = ref.slice(DEFINITIONS_PREFIX.length);
+        return hasOwn(definitions, name) ? definitions[name] : undefined;
+    };
+    const followRef = (schema) => {
+        if (!schema || typeof schema !== "object")
+            return schema;
+        const ref = schema.$ref;
+        if (typeof ref === "string") {
+            const resolved = resolveRef(ref);
+            if (resolved !== undefined)
+                return resolved;
+        }
+        return schema;
+    };
+    return {
+        bundle,
+        get(id) {
+            return hasOwn(signatures, id)
+                ? signatures[id]
+                : undefined;
+        },
+        has(id) {
+            return hasOwn(signatures, id);
+        },
+        resolve(name) {
+            return hasOwn(definitions, name)
+                ? definitions[name]
+                : undefined;
+        },
+        resolveRef,
+        inputOf(id) {
+            if (!hasOwn(signatures, id))
+                return undefined;
+            const sig = signatures[id];
+            if (Array.isArray(sig.input))
+                return sig.input.map(followRef);
+            return followRef(sig.input);
+        },
+        outputOf(id) {
+            if (!hasOwn(signatures, id))
+                return undefined;
+            const sig = signatures[id];
+            return followRef(sig.output);
+        },
+        findByIdentity(name, identityKey = DEFAULT_IDENTITY_KEY) {
+            const out = [];
+            const matchesIdentity = (schema) => {
+                if (!schema || typeof schema !== "object")
+                    return false;
+                const direct = schema[identityKey] === name;
+                if (direct)
+                    return true;
+                const ref = schema.$ref;
+                if (typeof ref === "string") {
+                    const resolved = resolveRef(ref);
+                    if (resolved &&
+                        resolved[identityKey] === name) {
+                        return true;
+                    }
+                }
+                return false;
+            };
+            for (const [id, sig] of Object.entries(signatures)) {
+                if (Array.isArray(sig.input)) {
+                    for (const part of sig.input) {
+                        if (matchesIdentity(part)) {
+                            out.push({ signatureId: id, position: "input", schema: part });
+                        }
+                    }
+                }
+                else if (matchesIdentity(sig.input)) {
+                    out.push({ signatureId: id, position: "input", schema: sig.input });
+                }
+                if (matchesIdentity(sig.output)) {
+                    out.push({ signatureId: id, position: "output", schema: sig.output });
+                }
+            }
+            return out;
+        },
+        listSignatures() {
+            return Object.keys(signatures);
+        },
+        listDefinitions() {
+            return Object.keys(definitions);
+        },
+    };
+}
+//# sourceMappingURL=reader.js.map

package/dist/fn-schema/loader/reader.js.map

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

package/dist/fn-schema/loader/types.d.ts

@@ -0,0 +1,28 @@
+export interface BundleSignature {
+    /** Original TS function name (independent of the `id` it's keyed by). */
+    name?: string;
+    /** Absolute path of the source file the signature was extracted from. */
+    file?: string;
+    input: unknown;
+    output: unknown;
+}
+/**
+ * Bundles carry vendor-extension keywords (`x-fn-schema-ts`, etc.), so
+ * definition values are typed as plain objects rather than `JSONSchema7` —
+ * the strict @types/json-schema type rejects unknown keys at construction.
+ */
+export interface Bundle {
+    $schema?: string;
+    signatures: Record<string, BundleSignature>;
+    definitions: Record<string, Record<string, unknown>>;
+}
+export type SignatureId<T extends Bundle> = keyof T["signatures"] & string;
+export type DefinitionName<T extends Bundle> = keyof T["definitions"] & string;
+export interface Match {
+    signatureId: string;
+    position: "input" | "output";
+    schema: unknown;
+}
+export declare const DEFAULT_IDENTITY_KEY = "x-fn-schema-ts";
+export declare const DEFINITIONS_PREFIX = "#/definitions/";
+//# sourceMappingURL=types.d.ts.map

package/dist/fn-schema/loader/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/loader/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,CAAC,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;AAC3E,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,CAAC,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC;AAE/E,MAAM,WAAW,KAAK;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC"}

package/dist/fn-schema/loader/types.js

@@ -0,0 +1,3 @@
+export const DEFAULT_IDENTITY_KEY = "x-fn-schema-ts";
+export const DEFINITIONS_PREFIX = "#/definitions/";
+//# sourceMappingURL=types.js.map

package/dist/fn-schema/loader/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/fn-schema/loader/types.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC"}

package/dist/fn-schema/transformer/index.d.ts

@@ -0,0 +1,37 @@
+import ts from "typescript";
+export interface TransformerOptions {
+    /**
+     * Path to a bundle JSON produced by `fn-schema --bundle ...`. Resolved
+     * relative to `cwd` (default: process.cwd()) when not absolute.
+     */
+    bundlePath: string;
+    cwd?: string;
+}
+/**
+ * TypeScript transformer that inlines pre-extracted JSON Schemas at compile
+ * time. Replaces every `schemaOf(fn)` / `inputSchemaOf(fn)` / `outputSchemaOf(fn)`
+ * call with the literal schema object pulled from the bundle, so consuming code
+ * pays zero runtime cost and ships zero ts-morph dependency.
+ *
+ * Bundle lookup goes through three fallbacks: id-as-key (works when the
+ * extractor used `naming: "function-name"`), name field (set by core's
+ * `emit.toBundle` since 0.x — survives `naming: "file-function"` and renamed
+ * imports), and finally type-checker symbol resolution for aliased imports
+ * like `import { createUser as makeUser } from "./api"`.
+ *
+ * Usage with ts-patch:
+ * ```jsonc
+ * {
+ *   "compilerOptions": {
+ *     "plugins": [
+ *       {
+ *         "transform": "@ir-kit/kit/fn-schema/transformer",
+ *         "bundlePath": "./generated/schemas.json"
+ *       }
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+export default function transformer(program: ts.Program, options: TransformerOptions): ts.TransformerFactory<ts.SourceFile>;
+//# sourceMappingURL=index.d.ts.map

package/dist/fn-schema/transformer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fn-schema/transformer/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,OAAO,EAAE,EAAE,CAAC,OAAO,EACnB,OAAO,EAAE,kBAAkB,GAC1B,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,UAAU,CAAC,CAuEtC"}

package/dist/fn-schema/transformer/index.js

@@ -0,0 +1,121 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import ts from "typescript";
+const RUNTIME_FNS = new Set(["schemaOf", "inputSchemaOf", "outputSchemaOf"]);
+/**
+ * TypeScript transformer that inlines pre-extracted JSON Schemas at compile
+ * time. Replaces every `schemaOf(fn)` / `inputSchemaOf(fn)` / `outputSchemaOf(fn)`
+ * call with the literal schema object pulled from the bundle, so consuming code
+ * pays zero runtime cost and ships zero ts-morph dependency.
+ *
+ * Bundle lookup goes through three fallbacks: id-as-key (works when the
+ * extractor used `naming: "function-name"`), name field (set by core's
+ * `emit.toBundle` since 0.x — survives `naming: "file-function"` and renamed
+ * imports), and finally type-checker symbol resolution for aliased imports
+ * like `import { createUser as makeUser } from "./api"`.
+ *
+ * Usage with ts-patch:
+ * ```jsonc
+ * {
+ *   "compilerOptions": {
+ *     "plugins": [
+ *       {
+ *         "transform": "@ir-kit/kit/fn-schema/transformer",
+ *         "bundlePath": "./generated/schemas.json"
+ *       }
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+export default function transformer(program, options) {
+    if (!options?.bundlePath) {
+        throw new Error('fn-schema-transformer: `bundlePath` is required. Run `fn-schema --bundle <path>` to produce one, then point the plugin at it via { "bundlePath": "..." }.');
+    }
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const abs = path.isAbsolute(options.bundlePath)
+        ? options.bundlePath
+        : path.resolve(cwd, options.bundlePath);
+    let bundle = null;
+    let nameIndex = null;
+    const loadBundle = () => {
+        if (bundle && nameIndex)
+            return { bundle, byName: nameIndex };
+        const raw = readFileSync(abs, "utf-8");
+        bundle = JSON.parse(raw);
+        nameIndex = new Map();
+        for (const [id, sig] of Object.entries(bundle.signatures)) {
+            if (sig.name)
+                nameIndex.set(sig.name, sig);
+            // Always also index by the id itself so id-as-key lookups still work.
+            nameIndex.set(id, sig);
+        }
+        return { bundle, byName: nameIndex };
+    };
+    const checker = program.getTypeChecker();
+    const lookupSig = (arg) => {
+        const { byName } = loadBundle();
+        // Layer 1 — direct match on the local identifier text.
+        const direct = byName.get(arg.text);
+        if (direct)
+            return direct;
+        // Layer 2 — resolve via type checker so `import { createUser as makeUser }`
+        // finds the entry under its exported name.
+        const sym = checker.getSymbolAtLocation(arg);
+        if (!sym)
+            return undefined;
+        const aliased = (sym.flags & ts.SymbolFlags.Alias) !== 0
+            ? checker.getAliasedSymbol(sym)
+            : sym;
+        const exportedName = aliased.getName();
+        return byName.get(exportedName);
+    };
+    return (context) => (sourceFile) => {
+        const visit = (node) => {
+            if (ts.isCallExpression(node) &&
+                ts.isIdentifier(node.expression) &&
+                RUNTIME_FNS.has(node.expression.text)) {
+                const arg = node.arguments[0];
+                if (arg && ts.isIdentifier(arg)) {
+                    const sig = lookupSig(arg);
+                    if (sig) {
+                        switch (node.expression.text) {
+                            case "schemaOf":
+                                return jsonToLiteral({ input: sig.input, output: sig.output });
+                            case "inputSchemaOf":
+                                return jsonToLiteral(sig.input);
+                            case "outputSchemaOf":
+                                return jsonToLiteral(sig.output);
+                        }
+                    }
+                }
+            }
+            return ts.visitEachChild(node, visit, context);
+        };
+        return ts.visitNode(sourceFile, visit);
+    };
+}
+function jsonToLiteral(value) {
+    if (value === null)
+        return ts.factory.createNull();
+    if (value === undefined)
+        return ts.factory.createIdentifier("undefined");
+    if (typeof value === "string")
+        return ts.factory.createStringLiteral(value);
+    if (typeof value === "number")
+        return value < 0
+            ? ts.factory.createPrefixUnaryExpression(ts.SyntaxKind.MinusToken, ts.factory.createNumericLiteral(-value))
+            : ts.factory.createNumericLiteral(value);
+    if (typeof value === "boolean")
+        return value ? ts.factory.createTrue() : ts.factory.createFalse();
+    if (Array.isArray(value)) {
+        return ts.factory.createArrayLiteralExpression(value.map(jsonToLiteral));
+    }
+    if (typeof value === "object") {
+        return ts.factory.createObjectLiteralExpression(Object.entries(value).map(([k, v]) => ts.factory.createPropertyAssignment(/^[A-Za-z_$][\w$]*$/.test(k)
+            ? ts.factory.createIdentifier(k)
+            : ts.factory.createStringLiteral(k), jsonToLiteral(v))), true);
+    }
+    return ts.factory.createIdentifier("undefined");
+}
+//# sourceMappingURL=index.js.map