orpc-fn 0.5.0 → 0.5.1

package/README.md

@@ -243,7 +243,7 @@ Sanitized tool-name collisions between distinct procedures throw; identical alia
 
 ## `orpc-fn/cli`
 
-Optional peer: `hanzio` ^3.1.0 (`hanzio/cli`).
+Uses `hanzio/cli`, which orpc-fn depends on (`hanzio` ^3.1.0). Your `defineCli` must come from the same `hanzio` copy, so keep your own `hanzio` on a matching major.
 
 ```ts
 import { defineCli } from 'hanzio/cli'

package/dist/cli.js

@@ -1,56 +1,45 @@
 #!/usr/bin/env node
-// biome-ignore-all lint/suspicious/noConsole: a CLI reports on the console
 import { readFile, writeFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { parseArgs } from 'node:util';
+import { CliError, defineCli, defineCommand } from 'hanzio/cli';
+import { z } from 'zod';
 import { createStreamManifestAsync, renderStreamManifest } from './router.js';
-const usage = `Usage: orpc-fn stream-manifest <module>[#export] --out <file.ts|file.json> [--name streamPaths] [--check]
-
-Imports the router (export "default" unless #export is given) and writes the
-paths of its streaming routes for createRpcLink({ streamPaths }). The file is
-only written when its content changes. --check writes nothing and exits 1 when
-the file is missing or stale. Importing the router runs its module code; run
-TypeScript routers with a runtime that loads .ts (bun, tsx, node >= 22.18).`;
-async function run(argv) {
-    const { positionals, values } = parseArgs({
-        args: [...argv],
-        allowPositionals: true,
-        options: {
-            out: { type: 'string' },
-            name: { type: 'string' },
-            check: { type: 'boolean' },
-            help: { type: 'boolean', short: 'h' }
-        }
-    });
-    const [command, target] = positionals;
-    if (values.help || command !== 'stream-manifest' || !target || !values.out) {
-        console.error(usage);
-        return values.help ? 0 : 2;
+const streamManifest = defineCommand({
+    description: "Write the paths of a router's streaming routes for createRpcLink({ streamPaths }), only when they change. Importing the router runs its module code: load .ts routers with bun, tsx or node >= 22.18.",
+    input: z.object({
+        module: z
+            .string()
+            .describe('Router module, with #export for a named export')
+            .meta({ positional: true }),
+        out: z.string().describe('Manifest to write: file.ts or file.json'),
+        name: z
+            .string()
+            .optional()
+            .describe('Exported constant name in a .ts file'),
+        check: z.boolean().describe('Exit 1 when the file is missing or stale')
+    }),
+    run: async (input) => {
+        const [modulePath = '', exportName = 'default'] = input.module.split('#');
+        const loaded = await import(pathToFileURL(resolve(modulePath)).href);
+        const router = loaded[exportName];
+        if (!router || typeof router !== 'object')
+            throw new CliError(`orpc-fn: ${modulePath} has no router export "${exportName}"`, { exitCode: 2 });
+        const out = resolve(input.out);
+        const source = renderStreamManifest(await createStreamManifestAsync(router), { format: out.endsWith('.json') ? 'json' : 'ts', name: input.name });
+        const current = await readFile(out, 'utf8').catch(() => undefined);
+        if (current === source)
+            return;
+        if (input.check)
+            throw new CliError(`orpc-fn: ${input.out} is stale; rerun without --check to update it`);
+        await writeFile(out, source);
+        return `orpc-fn: wrote ${input.out}`;
     }
-    const [modulePath = '', exportName = 'default'] = target.split('#');
-    const loaded = await import(pathToFileURL(resolve(modulePath)).href);
-    const router = loaded[exportName];
-    if (!router || typeof router !== 'object') {
-        console.error(`orpc-fn: ${modulePath} has no router export "${exportName}"`);
-        return 2;
-    }
-    const out = resolve(values.out);
-    const source = renderStreamManifest(await createStreamManifestAsync(router), { format: out.endsWith('.json') ? 'json' : 'ts', name: values.name });
-    const current = await readFile(out, 'utf8').catch(() => undefined);
-    if (current === source)
-        return 0;
-    if (values.check) {
-        console.error(`orpc-fn: ${values.out} is stale; rerun without --check to update it`);
-        return 1;
-    }
-    await writeFile(out, source);
-    console.log(`orpc-fn: wrote ${values.out}`);
-    return 0;
-}
-// Exit explicitly: the imported router may hold open database or broker handles.
-run(process.argv.slice(2)).then((code) => process.exit(code), (error) => {
-    console.error(error);
-    process.exit(1);
 });
+const cli = defineCli({
+    name: 'orpc-fn',
+    commands: { 'stream-manifest': streamManifest }
+});
+// Exit explicitly: the imported router may hold open database or broker handles.
+process.exit(await cli.run());
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n// biome-ignore-all lint/suspicious/noConsole: a CLI reports on the console\nimport { readFile, writeFile } from 'node:fs/promises'\nimport { resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { parseArgs } from 'node:util'\nimport type { AnyRouter } from '@orpc/server'\nimport { createStreamManifestAsync, renderStreamManifest } from './router.js'\n\nconst usage = `Usage: orpc-fn stream-manifest <module>[#export] --out <file.ts|file.json> [--name streamPaths] [--check]\n\nImports the router (export \"default\" unless #export is given) and writes the\npaths of its streaming routes for createRpcLink({ streamPaths }). The file is\nonly written when its content changes. --check writes nothing and exits 1 when\nthe file is missing or stale. Importing the router runs its module code; run\nTypeScript routers with a runtime that loads .ts (bun, tsx, node >= 22.18).`\n\nasync function run(argv: readonly string[]): Promise<number> {\n\tconst { positionals, values } = parseArgs({\n\t\targs: [...argv],\n\t\tallowPositionals: true,\n\t\toptions: {\n\t\t\tout: { type: 'string' },\n\t\t\tname: { type: 'string' },\n\t\t\tcheck: { type: 'boolean' },\n\t\t\thelp: { type: 'boolean', short: 'h' }\n\t\t}\n\t})\n\tconst [command, target] = positionals\n\tif (values.help || command !== 'stream-manifest' || !target || !values.out) {\n\t\tconsole.error(usage)\n\t\treturn values.help ? 0 : 2\n\t}\n\tconst [modulePath = '', exportName = 'default'] = target.split('#')\n\tconst loaded: Record<string, unknown> = await import(\n\t\tpathToFileURL(resolve(modulePath)).href\n\t)\n\tconst router = loaded[exportName]\n\tif (!router || typeof router !== 'object') {\n\t\tconsole.error(`orpc-fn: ${modulePath} has no router export \"${exportName}\"`)\n\t\treturn 2\n\t}\n\tconst out = resolve(values.out)\n\tconst source = renderStreamManifest(\n\t\tawait createStreamManifestAsync(router as AnyRouter),\n\t\t{ format: out.endsWith('.json') ? 'json' : 'ts', name: values.name }\n\t)\n\tconst current = await readFile(out, 'utf8').catch(() => undefined)\n\tif (current === source) return 0\n\tif (values.check) {\n\t\tconsole.error(\n\t\t\t`orpc-fn: ${values.out} is stale; rerun without --check to update it`\n\t\t)\n\t\treturn 1\n\t}\n\tawait writeFile(out, source)\n\tconsole.log(`orpc-fn: wrote ${values.out}`)\n\treturn 0\n}\n\n// Exit explicitly: the imported router may hold open database or broker handles.\nrun(process.argv.slice(2)).then(\n\t(code) => process.exit(code),\n\t(error) => {\n\t\tconsole.error(error)\n\t\tprocess.exit(1)\n\t}\n)\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAE7E,MAAM,cAAc,GAAG,aAAa,CAAC;IACpC,WAAW,EACV,uMAAuM;IACxM,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CAAC,gDAAgD,CAAC;aAC1D,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACnE,IAAI,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,sCAAsC,CAAC;QAClD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;KACvE,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,CAAC,UAAU,GAAG,EAAE,EAAE,UAAU,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACzE,MAAM,MAAM,GAA4B,MAAM,MAAM,CACnD,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CACvC,CAAA;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;QACjC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YACxC,MAAM,IAAI,QAAQ,CACjB,YAAY,UAAU,0BAA0B,UAAU,GAAG,EAC7D,EAAE,QAAQ,EAAE,CAAC,EAAE,CACf,CAAA;QACF,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,MAAM,GAAG,oBAAoB,CAClC,MAAM,yBAAyB,CAAC,MAAmB,CAAC,EACpD,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CACnE,CAAA;QACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAClE,IAAI,OAAO,KAAK,MAAM;YAAE,OAAM;QAC9B,IAAI,KAAK,CAAC,KAAK;YACd,MAAM,IAAI,QAAQ,CACjB,YAAY,KAAK,CAAC,GAAG,+CAA+C,CACpE,CAAA;QACF,MAAM,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC5B,OAAO,kBAAkB,KAAK,CAAC,GAAG,EAAE,CAAA;IACrC,CAAC;CACD,CAAC,CAAA;AAEF,MAAM,GAAG,GAAG,SAAS,CAAC;IACrB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,EAAE,iBAAiB,EAAE,cAAc,EAAE;CAC/C,CAAC,CAAA;AAEF,iFAAiF;AACjF,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA","sourcesContent":["#!/usr/bin/env node\nimport { readFile, writeFile } from 'node:fs/promises'\nimport { resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport type { AnyRouter } from '@orpc/server'\nimport { CliError, defineCli, defineCommand } from 'hanzio/cli'\nimport { z } from 'zod'\nimport { createStreamManifestAsync, renderStreamManifest } from './router.js'\n\nconst streamManifest = defineCommand({\n\tdescription:\n\t\t\"Write the paths of a router's streaming routes for createRpcLink({ streamPaths }), only when they change. Importing the router runs its module code: load .ts routers with bun, tsx or node >= 22.18.\",\n\tinput: z.object({\n\t\tmodule: z\n\t\t\t.string()\n\t\t\t.describe('Router module, with #export for a named export')\n\t\t\t.meta({ positional: true }),\n\t\tout: z.string().describe('Manifest to write: file.ts or file.json'),\n\t\tname: z\n\t\t\t.string()\n\t\t\t.optional()\n\t\t\t.describe('Exported constant name in a .ts file'),\n\t\tcheck: z.boolean().describe('Exit 1 when the file is missing or stale')\n\t}),\n\trun: async (input) => {\n\t\tconst [modulePath = '', exportName = 'default'] = input.module.split('#')\n\t\tconst loaded: Record<string, unknown> = await import(\n\t\t\tpathToFileURL(resolve(modulePath)).href\n\t\t)\n\t\tconst router = loaded[exportName]\n\t\tif (!router || typeof router !== 'object')\n\t\t\tthrow new CliError(\n\t\t\t\t`orpc-fn: ${modulePath} has no router export \"${exportName}\"`,\n\t\t\t\t{ exitCode: 2 }\n\t\t\t)\n\t\tconst out = resolve(input.out)\n\t\tconst source = renderStreamManifest(\n\t\t\tawait createStreamManifestAsync(router as AnyRouter),\n\t\t\t{ format: out.endsWith('.json') ? 'json' : 'ts', name: input.name }\n\t\t)\n\t\tconst current = await readFile(out, 'utf8').catch(() => undefined)\n\t\tif (current === source) return\n\t\tif (input.check)\n\t\t\tthrow new CliError(\n\t\t\t\t`orpc-fn: ${input.out} is stale; rerun without --check to update it`\n\t\t\t)\n\t\tawait writeFile(out, source)\n\t\treturn `orpc-fn: wrote ${input.out}`\n\t}\n})\n\nconst cli = defineCli({\n\tname: 'orpc-fn',\n\tcommands: { 'stream-manifest': streamManifest }\n})\n\n// Exit explicitly: the imported router may hold open database or broker handles.\nprocess.exit(await cli.run())\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "orpc-fn",
-	"version": "0.5.0",
+	"version": "0.5.1",
 	"description": "Define a backend function once: a typed oRPC procedure with tracing, logging, guards, injected handler extras, nested calls and live queries over Redis.",
 	"type": "module",
 	"license": "MIT",
@@ -127,6 +127,9 @@
 		"test:types-performance": "bun scripts/check-types-performance.ts",
 		"test:client-bundle": "bun scripts/check-client-bundle.ts"
 	},
+	"dependencies": {
+		"hanzio": "^3.1.0"
+	},
 	"peerDependencies": {
 		"@mastra/core": "^1.51.0",
 		"@opentelemetry/api": "^1.9.0",
@@ -136,7 +139,6 @@
 		"@orpc/openapi": "^1.14.0",
 		"@orpc/server": "^1.14.0",
 		"@orpc/zod": "^1.14.0",
-		"hanzio": "^3.1.0",
 		"hono": "^4.0.0",
 		"ioredis": "^5.0.0",
 		"zod": "^4.0.0",
@@ -163,9 +165,6 @@
 		"@orpc/zod": {
 			"optional": true
 		},
-		"hanzio": {
-			"optional": true
-		},
 		"hono": {
 			"optional": true
 		},
@@ -212,7 +211,6 @@
 		"@types/node": "^22.0.0",
 		"@types/react": "19",
 		"@types/react-test-renderer": "19",
-		"hanzio": "^3.1.0",
 		"hono": "^4.12.31",
 		"ioredis": "5.8.2",
 		"publint": "^0.3.12",

package/src/cli.ts

@@ -1,68 +1,58 @@
 #!/usr/bin/env node
-// biome-ignore-all lint/suspicious/noConsole: a CLI reports on the console
 import { readFile, writeFile } from 'node:fs/promises'
 import { resolve } from 'node:path'
 import { pathToFileURL } from 'node:url'
-import { parseArgs } from 'node:util'
 import type { AnyRouter } from '@orpc/server'
+import { CliError, defineCli, defineCommand } from 'hanzio/cli'
+import { z } from 'zod'
 import { createStreamManifestAsync, renderStreamManifest } from './router.js'
 
-const usage = `Usage: orpc-fn stream-manifest <module>[#export] --out <file.ts|file.json> [--name streamPaths] [--check]
-
-Imports the router (export "default" unless #export is given) and writes the
-paths of its streaming routes for createRpcLink({ streamPaths }). The file is
-only written when its content changes. --check writes nothing and exits 1 when
-the file is missing or stale. Importing the router runs its module code; run
-TypeScript routers with a runtime that loads .ts (bun, tsx, node >= 22.18).`
-
-async function run(argv: readonly string[]): Promise<number> {
-	const { positionals, values } = parseArgs({
-		args: [...argv],
-		allowPositionals: true,
-		options: {
-			out: { type: 'string' },
-			name: { type: 'string' },
-			check: { type: 'boolean' },
-			help: { type: 'boolean', short: 'h' }
-		}
-	})
-	const [command, target] = positionals
-	if (values.help || command !== 'stream-manifest' || !target || !values.out) {
-		console.error(usage)
-		return values.help ? 0 : 2
-	}
-	const [modulePath = '', exportName = 'default'] = target.split('#')
-	const loaded: Record<string, unknown> = await import(
-		pathToFileURL(resolve(modulePath)).href
-	)
-	const router = loaded[exportName]
-	if (!router || typeof router !== 'object') {
-		console.error(`orpc-fn: ${modulePath} has no router export "${exportName}"`)
-		return 2
-	}
-	const out = resolve(values.out)
-	const source = renderStreamManifest(
-		await createStreamManifestAsync(router as AnyRouter),
-		{ format: out.endsWith('.json') ? 'json' : 'ts', name: values.name }
-	)
-	const current = await readFile(out, 'utf8').catch(() => undefined)
-	if (current === source) return 0
-	if (values.check) {
-		console.error(
-			`orpc-fn: ${values.out} is stale; rerun without --check to update it`
+const streamManifest = defineCommand({
+	description:
+		"Write the paths of a router's streaming routes for createRpcLink({ streamPaths }), only when they change. Importing the router runs its module code: load .ts routers with bun, tsx or node >= 22.18.",
+	input: z.object({
+		module: z
+			.string()
+			.describe('Router module, with #export for a named export')
+			.meta({ positional: true }),
+		out: z.string().describe('Manifest to write: file.ts or file.json'),
+		name: z
+			.string()
+			.optional()
+			.describe('Exported constant name in a .ts file'),
+		check: z.boolean().describe('Exit 1 when the file is missing or stale')
+	}),
+	run: async (input) => {
+		const [modulePath = '', exportName = 'default'] = input.module.split('#')
+		const loaded: Record<string, unknown> = await import(
+			pathToFileURL(resolve(modulePath)).href
 		)
-		return 1
+		const router = loaded[exportName]
+		if (!router || typeof router !== 'object')
+			throw new CliError(
+				`orpc-fn: ${modulePath} has no router export "${exportName}"`,
+				{ exitCode: 2 }
+			)
+		const out = resolve(input.out)
+		const source = renderStreamManifest(
+			await createStreamManifestAsync(router as AnyRouter),
+			{ format: out.endsWith('.json') ? 'json' : 'ts', name: input.name }
+		)
+		const current = await readFile(out, 'utf8').catch(() => undefined)
+		if (current === source) return
+		if (input.check)
+			throw new CliError(
+				`orpc-fn: ${input.out} is stale; rerun without --check to update it`
+			)
+		await writeFile(out, source)
+		return `orpc-fn: wrote ${input.out}`
 	}
-	await writeFile(out, source)
-	console.log(`orpc-fn: wrote ${values.out}`)
-	return 0
-}
+})
+
+const cli = defineCli({
+	name: 'orpc-fn',
+	commands: { 'stream-manifest': streamManifest }
+})
 
 // Exit explicitly: the imported router may hold open database or broker handles.
-run(process.argv.slice(2)).then(
-	(code) => process.exit(code),
-	(error) => {
-		console.error(error)
-		process.exit(1)
-	}
-)
+process.exit(await cli.run())