@ir-kit/fn-schema-core 0.1.0

package/dist/naming.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+export function resolveNaming(strategy, fn, cwd) {
+    const s = strategy ?? "function-name";
+    if (typeof s === "function")
+        return s(fn);
+    switch (s) {
+        case "function-name":
+            return qualifiedName(fn);
+        case "file-function": {
+            const rel = path.relative(cwd, fn.file).replace(/\\/g, "/");
+            const base = rel
+                .replace(/\.(m|c)?(ts|tsx|js|jsx)$/, "")
+                .replace(/\//g, ".");
+            return `${base}.${qualifiedName(fn)}`;
+        }
+        case "jsdoc-tag": {
+            const tag = fn.jsDoc?.tags?.schema;
+            if (typeof tag === "string" && tag.length > 0)
+                return tag;
+            return qualifiedName(fn);
+        }
+    }
+}
+function qualifiedName(fn) {
+    // `className` is set for class methods and object-literal members alike;
+    // qualify whenever it's present so naming reflects the surface API.
+    if (fn.className)
+        return `${fn.className}.${fn.name}`;
+    return fn.name;
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,UAAU,aAAa,CAC3B,QAAoC,EACpC,EAAgB,EAChB,GAAW;IAEX,MAAM,CAAC,GAAG,QAAQ,IAAI,eAAe,CAAC;IACtC,IAAI,OAAO,CAAC,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAE1C,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,eAAe;YAClB,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;QAC3B,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5D,MAAM,IAAI,GAAG,GAAG;iBACb,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC;iBACvC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACvB,OAAO,GAAG,IAAI,IAAI,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC;YACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC;YAC1D,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,EAAgB;IACrC,yEAAyE;IACzE,oEAAoE;IACpE,IAAI,EAAE,CAAC,SAAS;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,EAAE,CAAC,IAAI,CAAC;AACjB,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,3 @@
+import type { Project, ProjectOptions } from "./types.js";
+export declare function createProject(opts: ProjectOptions): Project;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAWV,OAAO,EACP,cAAc,EAKf,MAAM,YAAY,CAAC;AAOpB,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CA6C3D"}

package/dist/project.js

@@ -0,0 +1,335 @@
+import { resolveSchemaOptions, resolveSignatureOptions } from "./defaults.js";
+import { DiagnosticSink } from "./diagnostics.js";
+import { applyFilter, resolveFilter } from "./filter.js";
+import { resolveNaming } from "./naming.js";
+export function createProject(opts) {
+    if (opts.extractors.length === 0) {
+        throw new Error("createProject: at least one extractor is required (e.g. @ir-kit/fn-schema-typescript)");
+    }
+    const cwd = opts.cwd ?? process.cwd();
+    let entries = null;
+    const ensureInit = async () => {
+        if (entries)
+            return entries;
+        entries = await Promise.all(opts.extractors.map(async (extractor) => ({
+            extractor,
+            instance: await extractor.init({
+                cwd,
+                tsConfigPath: opts.tsConfigPath,
+            }),
+        })));
+        return entries;
+    };
+    return {
+        async extract(callOpts) {
+            const merged = mergeOptions(opts, callOpts);
+            const init = await ensureInit();
+            return runExtract(init, merged, cwd);
+        },
+        async discover(callOpts) {
+            const merged = mergeOptions(opts, callOpts);
+            const init = await ensureInit();
+            return runDiscover(init, merged);
+        },
+        refresh(paths) {
+            if (!entries)
+                return;
+            const list = paths ?? [];
+            for (const e of entries)
+                e.instance.refresh(list);
+        },
+        dispose() {
+            if (!entries)
+                return;
+            for (const e of entries)
+                e.instance.dispose();
+            entries = null;
+        },
+    };
+}
+function mergeOptions(project, call) {
+    return {
+        cwd: project.cwd,
+        tsConfigPath: project.tsConfigPath,
+        ...(call ?? {}),
+    };
+}
+async function runExtract(entries, options, cwd) {
+    const start = Date.now();
+    const sink = new DiagnosticSink(options.onDiagnostic, options.failFast);
+    const filter = resolveFilter(options.include, options.exclude, options.filter);
+    const sigOpts = resolveSignatureOptions(options.signature);
+    const schemaOpts = resolveSchemaOptions(options.schema);
+    const { discovered: allDiscovered, filesScanned } = await runDiscoverPass(entries, options, sink, filter);
+    const signatures = [];
+    const definitions = {};
+    const seenIds = new Set();
+    for (const { entry, fn } of allDiscovered) {
+        try {
+            const pair = await entry.instance.toSchemas(fn, {
+                ...sigOpts,
+                ...schemaOpts,
+            });
+            const finalised = applySchemaHooks(fn, pair, options.hooks);
+            const id = uniqueId(resolveNaming(options.naming, fn, cwd), seenIds, sink, fn);
+            signatures.push({
+                id,
+                name: fn.name,
+                file: fn.file,
+                location: fn.location,
+                kind: fn.kind,
+                language: fn.language,
+                jsDoc: fn.jsDoc,
+                input: finalised.input,
+                output: finalised.output,
+                async: fn.async,
+                generic: fn.generic,
+                coverage: finalised.coverage,
+            });
+            if (finalised.definitions) {
+                for (const [k, v] of Object.entries(finalised.definitions)) {
+                    const prior = definitions[k];
+                    if (prior && !shallowSchemaEqual(prior, v)) {
+                        sink.push({
+                            severity: "warning",
+                            code: "DUPLICATE_ID",
+                            message: `Definition "${k}" emitted with conflicting shapes from "${fn.name}"; later schema overwrites the earlier one (cross-file types with the same name should be renamed or aliased)`,
+                            file: fn.file,
+                            function: fn.name,
+                        });
+                    }
+                    definitions[k] = v;
+                }
+            }
+            if (finalised.coverage) {
+                emitCoverageDiagnostics(finalised.coverage, fn, sink);
+            }
+        }
+        catch (err) {
+            const skipped = err instanceof Error && err.name === "SignatureSkipped";
+            sink.push({
+                severity: skipped ? "warning" : "error",
+                code: skipped ? "GENERIC_SKIPPED" : "EXTRACTOR_FAILURE",
+                message: skipped
+                    ? errMessage(err)
+                    : `Failed to build schema for "${fn.name}": ${errMessage(err)}`,
+                file: fn.file,
+                location: fn.location,
+                function: fn.name,
+            });
+        }
+    }
+    if (signatures.length === 0) {
+        sink.push({
+            severity: "info",
+            code: "EMPTY_RESULT",
+            message: "No signatures extracted. Check `files` glob, `include` filter, or `tsConfigPath`.",
+        });
+    }
+    return {
+        signatures,
+        definitions,
+        diagnostics: sink.all(),
+        stats: {
+            filesScanned,
+            functionsFound: signatures.length,
+            durationMs: Date.now() - start,
+        },
+    };
+}
+async function runDiscover(entries, options) {
+    const start = Date.now();
+    const sink = new DiagnosticSink(options.onDiagnostic, options.failFast);
+    const filter = resolveFilter(options.include, options.exclude, options.filter);
+    const { discovered, filesScanned } = await runDiscoverPass(entries, options, sink, filter);
+    return {
+        signatures: discovered.map((d) => d.fn),
+        diagnostics: sink.all(),
+        stats: {
+            filesScanned,
+            functionsFound: discovered.length,
+            durationMs: Date.now() - start,
+        },
+    };
+}
+async function runDiscoverPass(entries, options, sink, filter) {
+    const filesByExtractor = groupFiles(entries, options, sink);
+    let filesScanned = 0;
+    const discovered = [];
+    for (const [language, { files, entry }] of filesByExtractor) {
+        if (files.length === 0)
+            continue;
+        filesScanned += files.length;
+        try {
+            const found = await entry.instance.discover(files, filter);
+            for (const fn of found) {
+                if (!applyFilter(fn, filter))
+                    continue;
+                const transformed = applyOnFunctionHook(fn, options.hooks);
+                if (!transformed)
+                    continue;
+                discovered.push({ entry, fn: transformed });
+            }
+        }
+        catch (err) {
+            sink.push({
+                severity: "error",
+                code: "EXTRACTOR_FAILURE",
+                message: `Extractor "${language}" failed during discover: ${errMessage(err)}`,
+            });
+        }
+    }
+    return { discovered, filesScanned };
+}
+function groupFiles(entries, options, sink) {
+    const result = new Map();
+    const collected = collectFilePaths(options, sink);
+    for (const entry of entries) {
+        result.set(entry.extractor.language, { files: [], entry });
+    }
+    for (const file of collected) {
+        const ext = extOf(file);
+        const match = entries.find((e) => e.extractor.extensions.includes(ext));
+        if (!match) {
+            sink.push({
+                severity: "warning",
+                code: "NO_EXTRACTOR",
+                message: `No extractor registered for "${ext}" (file: ${file})`,
+                file,
+            });
+            continue;
+        }
+        result.get(match.extractor.language).files.push(file);
+    }
+    return result;
+}
+function collectFilePaths(options, sink) {
+    const acc = [];
+    if (options.files) {
+        const arr = Array.isArray(options.files) ? options.files : [options.files];
+        for (const f of arr) {
+            if (looksLikeGlob(f)) {
+                sink.push({
+                    severity: "warning",
+                    code: "FILE_READ_ERROR",
+                    message: `Glob "${f}" passed to core; expand globs in the caller (CLI or app).`,
+                });
+                continue;
+            }
+            acc.push(f);
+        }
+    }
+    if (options.source?.path)
+        acc.push(options.source.path);
+    return Array.from(new Set(acc));
+}
+function looksLikeGlob(p) {
+    return /[*?[\]{}]/.test(p);
+}
+function extOf(file) {
+    const i = file.lastIndexOf(".");
+    return i === -1 ? "" : file.slice(i);
+}
+function applyOnFunctionHook(fn, hooks) {
+    if (!hooks?.onFunction)
+        return fn;
+    const r = hooks.onFunction(fn);
+    if (r === null)
+        return null;
+    return r ?? fn;
+}
+function applySchemaHooks(fn, pair, hooks) {
+    if (!hooks?.onSchema)
+        return pair;
+    const onSchema = hooks.onSchema;
+    const ctxBase = { function: fn };
+    const transformInput = (s) => {
+        if (Array.isArray(s)) {
+            return s.map((schema, i) => onSchema(schema, {
+                ...ctxBase,
+                position: "parameter",
+                parameterIndex: i,
+            }));
+        }
+        return onSchema(s, { ...ctxBase, position: "input" });
+    };
+    return {
+        input: transformInput(pair.input),
+        output: onSchema(pair.output, { ...ctxBase, position: "output" }),
+        definitions: pair.definitions,
+    };
+}
+function uniqueId(desired, seen, sink, fn) {
+    if (!seen.has(desired)) {
+        seen.add(desired);
+        return desired;
+    }
+    let n = 2;
+    while (seen.has(`${desired}__${n}`))
+        n++;
+    const suffixed = `${desired}__${n}`;
+    seen.add(suffixed);
+    sink.push({
+        severity: "warning",
+        code: "DUPLICATE_ID",
+        message: `Naming collision on "${desired}"; renamed to "${suffixed}"`,
+        file: fn.file,
+        function: fn.name,
+    });
+    return suffixed;
+}
+function errMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+/** Equality via stable-key JSON — distinguishes a real shape conflict from two
+ *  functions referencing the same shared type. */
+function shallowSchemaEqual(a, b) {
+    return stableStringify(a) === stableStringify(b);
+}
+function emitCoverageDiagnostics(coverage, fn, sink) {
+    for (const m of coverage.mapped) {
+        sink.push({
+            severity: "info",
+            code: "TYPE_MAPPED",
+            message: `"${m.name}" mapped to canonical JSON Schema`,
+            file: fn.file,
+            location: fn.location,
+            function: fn.name,
+        });
+    }
+    for (const l of coverage.lossy) {
+        sink.push({
+            severity: "warning",
+            code: "LOSSY_MAPPING",
+            message: `"${l.name}" mapped lossily — ${l.reason}`,
+            file: fn.file,
+            location: fn.location,
+            function: fn.name,
+        });
+    }
+    for (const n of coverage.notRepresentable) {
+        sink.push({
+            severity: "error",
+            code: "NOT_REPRESENTABLE",
+            message: `"${n.name}" has no JSON Schema representation`,
+            file: fn.file,
+            location: fn.location,
+            function: fn.name,
+        });
+    }
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(",")}]`;
+    }
+    const keys = Object.keys(value).sort();
+    const body = keys
+        .map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`)
+        .join(",");
+    return `{${body}}`;
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/targets.d.ts

@@ -0,0 +1,12 @@
+import type { TargetRef } from "./types.js";
+export interface ParsedTarget {
+    file: string;
+    functionName: string;
+    className?: string;
+}
+/**
+ * Parse "src/api.ts#createUser" or "src/api.ts#User.create".
+ * Returns null on malformed input — caller emits an INVALID_TARGET diagnostic.
+ */
+export declare function parseTarget(input: string | TargetRef): ParsedTarget | null;
+//# sourceMappingURL=targets.d.ts.map

package/dist/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAc1E"}

package/dist/targets.js

@@ -0,0 +1,23 @@
+/**
+ * Parse "src/api.ts#createUser" or "src/api.ts#User.create".
+ * Returns null on malformed input — caller emits an INVALID_TARGET diagnostic.
+ */
+export function parseTarget(input) {
+    const raw = typeof input === "string" ? input : input.value;
+    const hash = raw.lastIndexOf("#");
+    if (hash <= 0 || hash === raw.length - 1)
+        return null;
+    const file = raw.slice(0, hash);
+    const member = raw.slice(hash + 1);
+    const dot = member.indexOf(".");
+    if (dot === -1)
+        return { file, functionName: member };
+    if (dot === 0 || dot === member.length - 1)
+        return null;
+    return {
+        file,
+        className: member.slice(0, dot),
+        functionName: member.slice(dot + 1),
+    };
+}
+//# sourceMappingURL=targets.js.map

package/dist/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IACtD,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;KACpC,CAAC;AACJ,CAAC"}