@ir-kit/fn-schema-transformer 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ahmed Rowaihi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# @ir-kit/fn-schema-transformer
+
+TypeScript compiler-API transformer that **inlines fn-schema results into emitted JS at compile time**. Replaces every `schemaOf(fn)` call with a literal JSON Schema object pulled from a pre-extracted bundle.
+
+## When to use this — and when not to
+
+Use it when you want zero runtime cost: no `JSON.parse` on cold start, no `schemas.json` artifact at runtime, no ts-morph dep in your shipped bundle.
+
+For 95% of users the [`loader`](../loader/README.md) is the right answer — simpler to set up and works in every TS toolchain. Only reach for the transformer when you've measured a real cost (cold-start latency, bundle size) or your deployment target forbids JSON files.
+
+|                          | loader                    | transformer                        |
+| ------------------------ | ------------------------- | ---------------------------------- |
+| setup                    | `import`                  | `ts-patch` + tsconfig plugin entry |
+| runtime cost             | one `JSON.parse`          | none                               |
+| live updates             | yes (re-extract + import) | no (rebuild required)              |
+| works with vanilla `tsc` | yes                       | no (needs `tspc`)                  |
+
+## Install
+
+```bash
+pnpm add -D @ir-kit/fn-schema-transformer ts-patch
+```
+
+## Setup
+
+### 1. Produce a bundle
+
+Either path works — the transformer just needs a `schemas.json` on disk before tsc runs.
+
+**Programmatic** (in a build script):
+
+```ts
+import { extract } from "@ir-kit/fn-schema-typescript";
+import { emit } from "@ir-kit/fn-schema-core";
+import { writeFile, mkdir } from "node:fs/promises";
+
+const result = await extract({ files: ["src/api/**/*.ts"] });
+await mkdir("generated", { recursive: true });
+await writeFile("generated/schemas.json", emit.toBundle(result));
+```
+
+**CLI**:
+
+```bash
+npx fn-schema extract 'src/api/**/*.ts' --bundle generated/schemas.json --pretty
+```
+
+### 2. Configure ts-patch
+
+```jsonc
+// tsconfig.json
+{
+  "compilerOptions": {
+    "plugins": [
+      {
+        "transform": "@ir-kit/fn-schema-transformer",
+        "bundlePath": "./generated/schemas.json",
+      },
+    ],
+  },
+}
+```
+
+```jsonc
+// package.json — bundle must exist before tspc runs
+{
+  "scripts": {
+    "build:schemas": "node scripts/extract.mjs",
+    "build:ts": "tspc",
+    "build": "pnpm build:schemas && pnpm build:ts",
+  },
+}
+```
+
+`tspc` is `ts-patch`'s patched compiler (replaces `tsc`).
+
+### 3. Use the runtime markers
+
+```ts
+import {
+  schemaOf,
+  inputSchemaOf,
+  outputSchemaOf,
+} from "@ir-kit/fn-schema-transformer/runtime";
+import { createUser } from "./api/handlers";
+
+const meta = schemaOf(createUser);
+const inputSchema = inputSchemaOf(createUser);
+const outputSchema = outputSchemaOf(createUser);
+```
+
+After transformation, the emitted JS has:
+
+```js
+const meta = { input: { type: "object", properties: { ... } }, output: { ... } }
+const inputSchema = { type: "object", properties: { ... } }
+const outputSchema = { ... }
+```
+
+The runtime stubs return `undefined` if the transformer is NOT applied, so dev tooling that doesn't run the transformer (`tsx`, `vitest`, etc.) doesn't break — calls just return `undefined`.
+
+## What gets replaced
+
+Direct calls only:
+
+```ts
+schemaOf(myFunction); // ✅ inlined
+inputSchemaOf(myFunction); // ✅
+outputSchemaOf(myFunction); // ✅
+
+const fn = myFunction;
+schemaOf(fn); // ❌ not inlined (argument is a binding, not the original identifier)
+
+schemaOf(makeFn()); // ❌ not inlined (call expression)
+```
+
+Lookup is by the argument identifier's name. If `myFunction` isn't in the bundle, the call is left alone — no error, but you get `undefined` at runtime via the stub.
+
+## Limitations
+
+- TS transformers are **synchronous**. The bundle must exist on disk before tsc runs — wire your build chain so extraction completes first.
+- Doesn't work with vanilla `tsc` — needs [`ts-patch`](https://github.com/nonara/ts-patch)'s `tspc` (or another tool supporting custom transformers).
+- Source-map fidelity is best-effort.

package/dist/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/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/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/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/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/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

package/dist/index.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Marker functions consumers call in their app. The transformer replaces every
+ * call site with the literal JSON Schema at compile time. The runtime stubs
+ * below exist only so tsc / dev mode resolve the import — they never execute
+ * after transformation.
+ *
+ * If the transformer is NOT applied, `schemaOf` returns `undefined` and
+ * `inputSchemaOf` / `outputSchemaOf` likewise — useful for early adopters who
+ * want a graceful fallback in environments where the transformer can't run.
+ */
+export interface FnSchemaPair<I = unknown, O = unknown> {
+    input: I;
+    output: O;
+}
+export declare function schemaOf<F extends (...args: never[]) => unknown>(_fn: F): FnSchemaPair | undefined;
+export declare function inputSchemaOf<F extends (...args: never[]) => unknown>(_fn: F): unknown;
+export declare function outputSchemaOf<F extends (...args: never[]) => unknown>(_fn: F): unknown;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACpD,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,CAAC,CAAC;CACX;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAC9D,GAAG,EAAE,CAAC,GACL,YAAY,GAAG,SAAS,CAE1B;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACnE,GAAG,EAAE,CAAC,GACL,OAAO,CAET;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACpE,GAAG,EAAE,CAAC,GACL,OAAO,CAET"}

package/dist/runtime.js

@@ -0,0 +1,20 @@
+/**
+ * Marker functions consumers call in their app. The transformer replaces every
+ * call site with the literal JSON Schema at compile time. The runtime stubs
+ * below exist only so tsc / dev mode resolve the import — they never execute
+ * after transformation.
+ *
+ * If the transformer is NOT applied, `schemaOf` returns `undefined` and
+ * `inputSchemaOf` / `outputSchemaOf` likewise — useful for early adopters who
+ * want a graceful fallback in environments where the transformer can't run.
+ */
+export function schemaOf(_fn) {
+    return undefined;
+}
+export function inputSchemaOf(_fn) {
+    return undefined;
+}
+export function outputSchemaOf(_fn) {
+    return undefined;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,UAAU,QAAQ,CACtB,GAAM;IAEN,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,GAAM;IAEN,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,GAAM;IAEN,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@ir-kit/fn-schema-transformer",
+  "version": "0.1.0",
+  "description": "TypeScript compiler-API transformer that inlines fn-schema results into emitted code. Replaces `schemaOf(myFunction)` calls with the literal JSON Schema at build time, eliminating runtime extraction cost. Plug into ts-patch, swc, esbuild, or any tool that accepts a custom TS transformer.",
+  "keywords": [
+    "json-schema",
+    "function-signature",
+    "typescript-transformer",
+    "compile-time"
+  ],
+  "homepage": "https://github.com/ir-kit/ir-kit/tree/main/packages/fn-schema/transformer",
+  "bugs": {
+    "url": "https://github.com/ir-kit/ir-kit/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Ahmed Rowaihi",
+    "email": "ahmedrowaihi@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ir-kit/ir-kit.git",
+    "directory": "packages/fn-schema/transformer"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@ir-kit/fn-schema-core": "0.1.0",
+    "@ir-kit/fn-schema-typescript": "0.1.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "5.9.3",
+    "vitest": "^4.0.0",
+    "@ir-kit/tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}