silgi 0.52.0 → 0.52.2

package/dist/core/handler.mjs

@@ -170,7 +170,7 @@ function createFetchHandler(routerDef, contextFactory, hooks, prefix, bridge) {
 			});
 			if (prepareResult) await prepareResult;
 			if (!route.passthrough) rawInput = await parseInput(request, url, qMark);
-			if (match.params && Object.keys(match.params).length > 0) rawInput = rawInput != null && typeof rawInput === "object" ? {
+			if (match.params) rawInput = rawInput != null && typeof rawInput === "object" ? {
 				...match.params,
 				...rawInput
 			} : match.params;

package/dist/core/router-utils.d.mts

@@ -0,0 +1,43 @@
+import { ProcedureDef, RouterDef } from "../types.mjs";
+import { compileRouter } from "../compile.mjs";
+
+//#region src/core/router-utils.d.ts
+declare function isProcedureDef(value: unknown): value is ProcedureDef;
+/**
+ * Walk a router tree and invoke `cb` for every procedure.
+ *
+ * @remarks
+ * Depth-first traversal. `path` is the segment list from the router
+ * root to the procedure (e.g. `['users', 'list']`). Use this when you
+ * need the live `ProcedureDef` reference (e.g. to read `.input`,
+ * `.output`, `.route`, `.meta`). For a flat list of paths only, use
+ * {@link getProcedurePaths}.
+ */
+declare function collectProcedures(router: RouterDef, cb: (path: string[], proc: ProcedureDef) => void): void;
+/**
+ * Flat list of every procedure in a router tree.
+ *
+ * @remarks
+ * Each entry carries the dot-joined path (e.g. `'users.list'`), the
+ * effective HTTP path (from `$route({ path })` or auto-derived), the
+ * method, the procedure kind and a direct reference to the
+ * `ProcedureDef`. Useful for generating client stubs, auditing the
+ * surface, or writing custom dashboards.
+ */
+interface ProcedureSummary {
+  /** Dot-joined segment path, e.g. `'users.list'`. */
+  name: string;
+  /** Router tree segments, e.g. `['users', 'list']`. */
+  segments: string[];
+  /** HTTP path used by the handler (auto or `$route`-overridden). */
+  httpPath: string;
+  /** HTTP method (uppercase), or `'*'` when wildcarded. */
+  method: string;
+  /** Procedure kind — `'query'`, `'mutation'`, `'subscription'`. */
+  type: ProcedureDef['type'];
+  /** Live `ProcedureDef` reference. */
+  procedure: ProcedureDef;
+}
+declare function getProcedurePaths(router: RouterDef): ProcedureSummary[];
+//#endregion
+export { ProcedureSummary, collectProcedures, getProcedurePaths, isProcedureDef };

package/dist/core/router-utils.mjs

@@ -4,6 +4,43 @@ const routerCache = /* @__PURE__ */ new WeakMap();
 function isProcedureDef(value) {
 	return typeof value === "object" && value !== null && "type" in value && "resolve" in value && typeof value.resolve === "function";
 }
+/**
+* Walk a router tree and invoke `cb` for every procedure.
+*
+* @remarks
+* Depth-first traversal. `path` is the segment list from the router
+* root to the procedure (e.g. `['users', 'list']`). Use this when you
+* need the live `ProcedureDef` reference (e.g. to read `.input`,
+* `.output`, `.route`, `.meta`). For a flat list of paths only, use
+* {@link getProcedurePaths}.
+*/
+function collectProcedures(router, cb) {
+	walk(router, [], cb);
+}
+function walk(node, path, cb) {
+	if (isProcedureDef(node)) {
+		cb(path, node);
+		return;
+	}
+	if (typeof node === "object" && node !== null) for (const [key, child] of Object.entries(node)) walk(child, [...path, key], cb);
+}
+function getProcedurePaths(router) {
+	const out = [];
+	walk(router, [], (segments, proc) => {
+		const route = proc.route;
+		const httpPath = route?.path ?? "/" + segments.join("/");
+		const method = route?.method?.toUpperCase() ?? "POST";
+		out.push({
+			name: segments.join("."),
+			segments,
+			httpPath,
+			method,
+			type: proc.type,
+			procedure: proc
+		});
+	});
+	return out;
+}
 function assignPaths(def, prefix = []) {
 	const result = {};
 	for (const [key, value] of Object.entries(def)) {
@@ -19,4 +56,4 @@ function assignPaths(def, prefix = []) {
 	return result;
 }
 //#endregion
-export { assignPaths, isProcedureDef, routerCache };
+export { assignPaths, collectProcedures, getProcedurePaths, isProcedureDef, routerCache };

package/dist/index.d.mts

@@ -16,5 +16,6 @@ import { CallableOptions, callable } from "./callable.mjs";
 import { LifecycleHooks, lifecycleWrap } from "./lifecycle.mjs";
 import { mapInput } from "./map-input.mjs";
 import { compileProcedure, compileRouter, createContext } from "./compile.mjs";
+import { ProcedureSummary, collectProcedures, getProcedurePaths, isProcedureDef } from "./core/router-utils.mjs";
 import { LazyRouter, isLazy, lazy, resolveLazy } from "./lazy.mjs";
-export { type AnySchema, AsyncIteratorClass, type BaseContext, type CallableOptions, type ContextBridge, type ConvertOptions, type Driver, type ErrorDef, type ErrorDefItem, type EventMeta, type FailFn, type GuardDef, type GuardFn, type InferClient, type InferContextFromUse, type InferGuardOutput, type InferSchemaInput, type InferSchemaOutput, type JSONSchema, type LazyRouter, type LifecycleHooks, type Meta, type MiddlewareDef, type ProcedureBuilder, type ProcedureBuilderWithOutput, type ProcedureDef, type ProcedureType, type ResolveContext, type RouterDef, type ScalarOptions, type ScheduledTaskInfo, type Schema, type SchemaConverter, type SchemaRegistry, type ServeOptions, type SilgiConfig, SilgiError, type SilgiErrorCode, type SilgiErrorJSON, type SilgiErrorOptions, type SilgiInstance, type SilgiServer, type Storage, type StorageConfig, type StorageValue, type TaskDef, type TaskEvent, ValidationError, type WrapDef, type WrapFn, callable, collectCronTasks, compileProcedure, compileRouter, createContext, createContextBridge, createSchemaRegistry, generateOpenAPI, getEventMeta, getScheduledTasks, initStorage, isDefinedError, isLazy, isSilgiError, lazy, lifecycleWrap, mapAsyncIterator, mapInput, resetStorage, resolveLazy, runTask, scalarHTML, schemaToJsonSchema, setTaskAnalytics, silgi, startCronJobs, stopCronJobs, toSilgiError, type, useStorage, validateSchema, withEventMeta };
+export { type AnySchema, AsyncIteratorClass, type BaseContext, type CallableOptions, type ContextBridge, type ConvertOptions, type Driver, type ErrorDef, type ErrorDefItem, type EventMeta, type FailFn, type GuardDef, type GuardFn, type InferClient, type InferContextFromUse, type InferGuardOutput, type InferSchemaInput, type InferSchemaOutput, type JSONSchema, type LazyRouter, type LifecycleHooks, type Meta, type MiddlewareDef, type ProcedureBuilder, type ProcedureBuilderWithOutput, type ProcedureDef, type ProcedureSummary, type ProcedureType, type ResolveContext, type RouterDef, type ScalarOptions, type ScheduledTaskInfo, type Schema, type SchemaConverter, type SchemaRegistry, type ServeOptions, type SilgiConfig, SilgiError, type SilgiErrorCode, type SilgiErrorJSON, type SilgiErrorOptions, type SilgiInstance, type SilgiServer, type Storage, type StorageConfig, type StorageValue, type TaskDef, type TaskEvent, ValidationError, type WrapDef, type WrapFn, callable, collectCronTasks, collectProcedures, compileProcedure, compileRouter, createContext, createContextBridge, createSchemaRegistry, generateOpenAPI, getEventMeta, getProcedurePaths, getScheduledTasks, initStorage, isDefinedError, isLazy, isProcedureDef, isSilgiError, lazy, lifecycleWrap, mapAsyncIterator, mapInput, resetStorage, resolveLazy, runTask, scalarHTML, schemaToJsonSchema, setTaskAnalytics, silgi, startCronJobs, stopCronJobs, toSilgiError, type, useStorage, validateSchema, withEventMeta };

package/dist/index.mjs

@@ -1,6 +1,7 @@
 import { ValidationError, type, validateSchema } from "./core/schema.mjs";
 import { collectCronTasks, getScheduledTasks, runTask, setTaskAnalytics, startCronJobs, stopCronJobs } from "./core/task.mjs";
 import { SilgiError, isDefinedError, isSilgiError, toSilgiError } from "./core/error.mjs";
+import { collectProcedures, getProcedurePaths, isProcedureDef } from "./core/router-utils.mjs";
 import { compileProcedure, compileRouter, createContext } from "./compile.mjs";
 import { createContextBridge } from "./core/context-bridge.mjs";
 import { AsyncIteratorClass, mapAsyncIterator } from "./core/iterator.mjs";
@@ -13,4 +14,4 @@ import { mapInput } from "./map-input.mjs";
 import { isLazy, lazy, resolveLazy } from "./lazy.mjs";
 import { initStorage, resetStorage, useStorage } from "./core/storage.mjs";
 import { generateOpenAPI, scalarHTML } from "./scalar.mjs";
-export { AsyncIteratorClass, SilgiError, ValidationError, callable, collectCronTasks, compileProcedure, compileRouter, createContext, createContextBridge, createSchemaRegistry, generateOpenAPI, getEventMeta, getScheduledTasks, initStorage, isDefinedError, isLazy, isSilgiError, lazy, lifecycleWrap, mapAsyncIterator, mapInput, resetStorage, resolveLazy, runTask, scalarHTML, schemaToJsonSchema, setTaskAnalytics, silgi, startCronJobs, stopCronJobs, toSilgiError, type, useStorage, validateSchema, withEventMeta };
+export { AsyncIteratorClass, SilgiError, ValidationError, callable, collectCronTasks, collectProcedures, compileProcedure, compileRouter, createContext, createContextBridge, createSchemaRegistry, generateOpenAPI, getEventMeta, getProcedurePaths, getScheduledTasks, initStorage, isDefinedError, isLazy, isProcedureDef, isSilgiError, lazy, lifecycleWrap, mapAsyncIterator, mapInput, resetStorage, resolveLazy, runTask, scalarHTML, schemaToJsonSchema, setTaskAnalytics, silgi, startCronJobs, stopCronJobs, toSilgiError, type, useStorage, validateSchema, withEventMeta };

package/dist/integrations/ai/index.mjs

@@ -1,3 +1,4 @@
+import { collectProcedures } from "../../core/router-utils.mjs";
 import { compileProcedure } from "../../compile.mjs";
 import { jsonSchema, tool } from "ai";
 //#region src/integrations/ai/index.ts
@@ -53,23 +54,13 @@ function procedureToTool(name, procedure, options) {
 */
 function routerToTools(router, options) {
 	const tools = {};
-	collectProcedures(router, [], (path, proc) => {
+	collectProcedures(router, (path, proc) => {
 		const flatName = path.join("_");
 		if (options?.filter && !options.filter(flatName, proc)) return;
 		tools[flatName] = procedureToTool(flatName, proc, { description: options?.descriptions?.[flatName] });
 	});
 	return tools;
 }
-function isProcedureDef(v) {
-	return typeof v === "object" && v !== null && "type" in v && "resolve" in v;
-}
-function collectProcedures(node, path, cb) {
-	if (isProcedureDef(node)) {
-		cb(path, node);
-		return;
-	}
-	if (typeof node === "object" && node !== null) for (const [key, child] of Object.entries(node)) collectProcedures(child, [...path, key], cb);
-}
 /** Simple Zod → JSON Schema for AI tool parameters */
 function zodToJsonSchemaSimple(schema) {
 	const zod = schema?._zod ?? schema?._def;

package/dist/scalar.mjs

@@ -1,3 +1,4 @@
+import { collectProcedures } from "./core/router-utils.mjs";
 import { schemaToJsonSchema } from "./core/schema-converter.mjs";
 //#region src/scalar.ts
 /**
@@ -35,7 +36,7 @@ function generateOpenAPI(router, options = {}, basePath = "", registry) {
 	const schemaToJsonSchema$1 = (schema, strategy = "input") => schemaToJsonSchema(schema, strategy, registry);
 	const paths = {};
 	const tags = /* @__PURE__ */ new Map();
-	collectProcedures(router, [], (path, proc) => {
+	collectProcedures(router, (path, proc) => {
 		const route = proc.route;
 		const { httpPath: routePath, pathParams } = toOpenAPIPath(route?.path ?? "/" + path.join("/"));
 		const httpPath = basePath ? basePath.replace(/\/$/, "") + routePath : routePath;
@@ -260,16 +261,6 @@ function scalarHTML(specUrl, options = {}) {
 function escapeHtml(s) {
 	return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
-function isProcedureDef(value) {
-	return typeof value === "object" && value !== null && "type" in value && "resolve" in value && typeof value.resolve === "function";
-}
-function collectProcedures(node, path, cb) {
-	if (isProcedureDef(node)) {
-		cb(path, node);
-		return;
-	}
-	if (typeof node === "object" && node !== null) for (const [key, child] of Object.entries(node)) collectProcedures(child, [...path, key], cb);
-}
 function objectSchemaToParams(schema) {
 	if (schema.type !== "object" || !schema.properties) return [];
 	const required = new Set(schema.required ?? []);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "silgi",
-  "version": "0.52.0",
+  "version": "0.52.2",
   "private": false,
   "description": "The fastest end-to-end type-safe RPC framework for TypeScript — compiled pipelines, single package, every runtime",
   "keywords": [