@veloxts/router 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @veloxts/router - Procedure API with hybrid tRPC/REST routing
+ *
+ * Core routing abstraction that enables type-safe API endpoints with
+ * automatic tRPC and REST adapter generation from procedure definitions.
+ *
+ * @example
+ * ```typescript
+ * import { procedure, defineProcedures } from '@veloxts/router';
+ * import { z } from '@veloxts/validation';
+ *
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string(),
+ *   email: z.string().email(),
+ * });
+ *
+ * export const userProcedures = defineProcedures('users', {
+ *   getUser: procedure()
+ *     .input(z.object({ id: z.string().uuid() }))
+ *     .output(UserSchema)
+ *     .query(async ({ input, ctx }) => {
+ *       // input is typed as { id: string }
+ *       // ctx is typed as BaseContext
+ *       // return type must match UserSchema
+ *       return ctx.db.user.findUnique({ where: { id: input.id } });
+ *     }),
+ *
+ *   createUser: procedure()
+ *     .input(z.object({ name: z.string(), email: z.string().email() }))
+ *     .output(UserSchema)
+ *     .mutation(async ({ input, ctx }) => {
+ *       return ctx.db.user.create({ data: input });
+ *     }),
+ * });
+ * ```
+ *
+ * @module @veloxts/router
+ */
+export declare const ROUTER_VERSION: "0.1.0";
+export type { CompiledProcedure, ContextExtensions, ContextFactory, ExtendedContext, HttpMethod, InferProcedureContext, InferProcedureInput, InferProcedureOutput, InferProcedureTypes, MiddlewareArgs, MiddlewareFunction, MiddlewareNext, MiddlewareResult, ProcedureCollection, ProcedureHandler, ProcedureHandlerArgs, ProcedureRecord, ProcedureType, RestRouteOverride, } from './types.js';
+export { PROCEDURE_METHOD_MAP, } from './types.js';
+export { defineProcedures, executeProcedure, isCompiledProcedure, isProcedureCollection, procedure, } from './procedure/builder.js';
+export type { BuilderRuntimeState, InferProcedures, InferSchemaOutput, ProcedureBuilder, ProcedureBuilderState, ProcedureDefinitions, ValidSchema, } from './procedure/types.js';
+export type { RestAdapterOptions, RestMapping, RestRoute } from './rest/index.js';
+export { buildRestPath, createRoutesRegistrar, followsNamingConvention, generateRestRoutes, getRouteSummary, inferResourceName, parseNamingConvention, registerRestRoutes, } from './rest/index.js';
+export type { AnyRouter, InferAppRouter, TRPCInstance, TRPCPluginOptions, } from './trpc/index.js';
+export { buildTRPCRouter, createAppRouter, createTRPC, createTRPCContextFactory, registerTRPCPlugin, veloxErrorToTRPCError, } from './trpc/index.js';
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,eAAO,MAAM,cAAc,EAAG,OAAgB,CAAC;AAO/C,YAAY,EAEV,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EAEnB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAEhB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAEL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAEV,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAS9B,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EAEV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,eAAe,EACf,eAAe,EACf,UAAU,EACV,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,55 @@
+/**
+ * @veloxts/router - Procedure API with hybrid tRPC/REST routing
+ *
+ * Core routing abstraction that enables type-safe API endpoints with
+ * automatic tRPC and REST adapter generation from procedure definitions.
+ *
+ * @example
+ * ```typescript
+ * import { procedure, defineProcedures } from '@veloxts/router';
+ * import { z } from '@veloxts/validation';
+ *
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string(),
+ *   email: z.string().email(),
+ * });
+ *
+ * export const userProcedures = defineProcedures('users', {
+ *   getUser: procedure()
+ *     .input(z.object({ id: z.string().uuid() }))
+ *     .output(UserSchema)
+ *     .query(async ({ input, ctx }) => {
+ *       // input is typed as { id: string }
+ *       // ctx is typed as BaseContext
+ *       // return type must match UserSchema
+ *       return ctx.db.user.findUnique({ where: { id: input.id } });
+ *     }),
+ *
+ *   createUser: procedure()
+ *     .input(z.object({ name: z.string(), email: z.string().email() }))
+ *     .output(UserSchema)
+ *     .mutation(async ({ input, ctx }) => {
+ *       return ctx.db.user.create({ data: input });
+ *     }),
+ * });
+ * ```
+ *
+ * @module @veloxts/router
+ */
+// Version constant
+export const ROUTER_VERSION = '0.1.0';
+export { 
+// Constants
+PROCEDURE_METHOD_MAP, } from './types.js';
+// ============================================================================
+// Procedure Builder
+// ============================================================================
+export { 
+// Builder functions
+defineProcedures, executeProcedure, isCompiledProcedure, isProcedureCollection, procedure, } from './procedure/builder.js';
+export { buildRestPath, createRoutesRegistrar, followsNamingConvention, generateRestRoutes, getRouteSummary, inferResourceName, parseNamingConvention, registerRestRoutes, } from './rest/index.js';
+export { 
+// tRPC utilities
+buildTRPCRouter, createAppRouter, createTRPC, createTRPCContextFactory, registerTRPCPlugin, veloxErrorToTRPCError, } from './trpc/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,mBAAmB;AACnB,MAAM,CAAC,MAAM,cAAc,GAAG,OAAgB,CAAC;AA+B/C,OAAO;AACL,YAAY;AACZ,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,OAAO;AACL,oBAAoB;AACpB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAoBhC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAazB,OAAO;AACL,iBAAiB;AACjB,eAAe,EACf,eAAe,EACf,UAAU,EACV,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/procedure/builder.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Procedure builder implementation
+ *
+ * Implements the fluent builder pattern for defining type-safe procedures.
+ * Uses a functional approach where each method returns a new builder instance
+ * with accumulated state, enabling immutable building with proper type inference.
+ *
+ * @module procedure/builder
+ */
+import type { BaseContext } from '@veloxts/core';
+import type { CompiledProcedure, ProcedureCollection } from '../types.js';
+import type { InferProcedures, ProcedureBuilder, ProcedureDefinitions } from './types.js';
+/**
+ * Creates a new procedure builder instance
+ *
+ * This is the primary entry point for defining procedures. The builder uses
+ * TypeScript's generic inference to track types through the fluent chain.
+ *
+ * @returns New procedure builder with void input, unknown output, and BaseContext
+ *
+ * @example
+ * ```typescript
+ * const getUser = procedure()
+ *   .input(z.object({ id: z.string().uuid() }))
+ *   .output(UserSchema)
+ *   .query(async ({ input, ctx }) => {
+ *     // input is { id: string }
+ *     // ctx is BaseContext
+ *     // return type must match UserSchema
+ *     return ctx.db.user.findUnique({ where: { id: input.id } });
+ *   });
+ * ```
+ */
+export declare function procedure(): ProcedureBuilder<unknown, unknown, BaseContext>;
+/**
+ * Defines a collection of procedures under a namespace
+ *
+ * Groups related procedures together for registration with routers.
+ * The namespace determines the base path for REST routes.
+ *
+ * @template TProcedures - The record of named procedures
+ * @param namespace - Resource namespace (e.g., 'users', 'posts')
+ * @param procedures - Object containing named procedures
+ * @returns Procedure collection with preserved types
+ *
+ * @example
+ * ```typescript
+ * export const userProcedures = defineProcedures('users', {
+ *   getUser: procedure()
+ *     .input(z.object({ id: z.string().uuid() }))
+ *     .query(async ({ input, ctx }) => {
+ *       return ctx.db.user.findUnique({ where: { id: input.id } });
+ *     }),
+ *
+ *   createUser: procedure()
+ *     .input(CreateUserSchema)
+ *     .mutation(async ({ input, ctx }) => {
+ *       return ctx.db.user.create({ data: input });
+ *     }),
+ * });
+ *
+ * // Types are fully preserved:
+ * // userProcedures.procedures.getUser.inputSchema -> { id: string }
+ * // userProcedures.procedures.createUser -> mutation type
+ * ```
+ */
+export declare function defineProcedures<TProcedures extends ProcedureDefinitions>(namespace: string, procedures: TProcedures): ProcedureCollection<InferProcedures<TProcedures>>;
+/**
+ * Executes a compiled procedure with the given input and context
+ *
+ * This function handles:
+ * 1. Input validation (if schema provided)
+ * 2. Middleware chain execution (using pre-compiled executor when available)
+ * 3. Handler execution
+ * 4. Output validation (if schema provided)
+ *
+ * PERFORMANCE: Uses pre-compiled middleware executor when available,
+ * eliminating the overhead of building the middleware chain on every request.
+ *
+ * @template TInput - The input type
+ * @template TOutput - The output type
+ * @template TContext - The context type
+ * @param procedure - The compiled procedure to execute
+ * @param rawInput - Raw input data to validate and pass to handler
+ * @param ctx - Request context
+ * @returns Promise resolving to the handler output
+ *
+ * @example
+ * ```typescript
+ * const result = await executeProcedure(
+ *   userProcedures.procedures.getUser,
+ *   { id: '123' },
+ *   context
+ * );
+ * ```
+ */
+export declare function executeProcedure<TInput, TOutput, TContext extends BaseContext>(procedure: CompiledProcedure<TInput, TOutput, TContext>, rawInput: unknown, ctx: TContext): Promise<TOutput>;
+/**
+ * Type guard to check if a value is a compiled procedure
+ */
+export declare function isCompiledProcedure(value: unknown): value is CompiledProcedure;
+/**
+ * Type guard to check if a value is a procedure collection
+ */
+export declare function isProcedureCollection(value: unknown): value is ProcedureCollection;
+//# sourceMappingURL=builder.d.ts.map

package/dist/procedure/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/procedure/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EACV,iBAAiB,EAEjB,mBAAmB,EAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAEV,eAAe,EAEf,gBAAgB,EAChB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,IAAI,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAO3E;AA8LD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,SAAS,oBAAoB,EACvE,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,WAAW,GACtB,mBAAmB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAKnD;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,SAAS,WAAW,EAClF,SAAS,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EACvD,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAkDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAY9E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAYlF"}

package/dist/procedure/builder.js

@@ -0,0 +1,341 @@
+/**
+ * Procedure builder implementation
+ *
+ * Implements the fluent builder pattern for defining type-safe procedures.
+ * Uses a functional approach where each method returns a new builder instance
+ * with accumulated state, enabling immutable building with proper type inference.
+ *
+ * @module procedure/builder
+ */
+// ============================================================================
+// Builder Factory
+// ============================================================================
+/**
+ * Creates a new procedure builder instance
+ *
+ * This is the primary entry point for defining procedures. The builder uses
+ * TypeScript's generic inference to track types through the fluent chain.
+ *
+ * @returns New procedure builder with void input, unknown output, and BaseContext
+ *
+ * @example
+ * ```typescript
+ * const getUser = procedure()
+ *   .input(z.object({ id: z.string().uuid() }))
+ *   .output(UserSchema)
+ *   .query(async ({ input, ctx }) => {
+ *     // input is { id: string }
+ *     // ctx is BaseContext
+ *     // return type must match UserSchema
+ *     return ctx.db.user.findUnique({ where: { id: input.id } });
+ *   });
+ * ```
+ */
+export function procedure() {
+    return createBuilder({
+        inputSchema: undefined,
+        outputSchema: undefined,
+        middlewares: [],
+        restOverride: undefined,
+    });
+}
+// ============================================================================
+// Internal Builder Implementation
+// ============================================================================
+/**
+ * Creates a builder instance with the given runtime state
+ *
+ * This internal function constructs the builder object with all methods bound
+ * to the current state. Each method returns a new builder with updated state.
+ *
+ * @internal
+ */
+function createBuilder(state) {
+    return {
+        /**
+         * Sets the input validation schema
+         */
+        input(schema) {
+            // Return new builder with updated input schema
+            // The type parameter extracts the schema's output type
+            return createBuilder({
+                ...state,
+                inputSchema: schema,
+            });
+        },
+        /**
+         * Sets the output validation schema
+         */
+        output(schema) {
+            // Return new builder with updated output schema
+            return createBuilder({
+                ...state,
+                outputSchema: schema,
+            });
+        },
+        /**
+         * Adds middleware to the chain
+         */
+        use(middleware) {
+            // Add middleware to the chain
+            // Cast is safe because we're building up the chain incrementally
+            const typedMiddleware = middleware;
+            return createBuilder({
+                ...state,
+                middlewares: [...state.middlewares, typedMiddleware],
+            });
+        },
+        /**
+         * Sets REST route override
+         */
+        rest(config) {
+            return createBuilder({
+                ...state,
+                restOverride: config,
+            });
+        },
+        /**
+         * Finalizes as a query procedure
+         */
+        query(handler) {
+            return compileProcedure('query', handler, state);
+        },
+        /**
+         * Finalizes as a mutation procedure
+         */
+        mutation(handler) {
+            return compileProcedure('mutation', handler, state);
+        },
+    };
+}
+/**
+ * Compiles a procedure from the builder state
+ *
+ * Creates the final CompiledProcedure object with all metadata and handlers.
+ * PERFORMANCE: Pre-compiles the middleware chain during procedure definition
+ * instead of building it on every request.
+ *
+ * @internal
+ */
+function compileProcedure(type, handler, state) {
+    const typedMiddlewares = state.middlewares;
+    // Pre-compile the middleware chain executor if middlewares exist
+    // This avoids rebuilding the chain on every request
+    const precompiledExecutor = typedMiddlewares.length > 0
+        ? createPrecompiledMiddlewareExecutor(typedMiddlewares, handler)
+        : undefined;
+    // Create the final procedure object
+    const procedure = {
+        type,
+        handler,
+        inputSchema: state.inputSchema,
+        outputSchema: state.outputSchema,
+        middlewares: typedMiddlewares,
+        restOverride: state.restOverride,
+        // Store pre-compiled executor for performance
+        _precompiledExecutor: precompiledExecutor,
+    };
+    return procedure;
+}
+/**
+ * Creates a pre-compiled middleware chain executor
+ *
+ * PERFORMANCE: This function builds the middleware chain once during procedure
+ * compilation, creating a single reusable function that executes the entire chain.
+ * This eliminates the need to rebuild closures on every request.
+ *
+ * @internal
+ */
+function createPrecompiledMiddlewareExecutor(middlewares, handler) {
+    // Pre-build the chain executor once
+    return async (input, ctx) => {
+        // Create mutable context copy for middleware extensions
+        const mutableCtx = ctx;
+        // Build the handler wrapper
+        const executeHandler = async () => {
+            const output = await handler({ input, ctx: mutableCtx });
+            return { output };
+        };
+        // Build chain from end to start (only done once per request, not per middleware)
+        let next = executeHandler;
+        for (let i = middlewares.length - 1; i >= 0; i--) {
+            const middleware = middlewares[i];
+            const currentNext = next;
+            next = async () => {
+                return middleware({
+                    input,
+                    ctx: mutableCtx,
+                    next: async (opts) => {
+                        if (opts?.ctx) {
+                            Object.assign(mutableCtx, opts.ctx);
+                        }
+                        return currentNext();
+                    },
+                });
+            };
+        }
+        const result = await next();
+        return result.output;
+    };
+}
+// ============================================================================
+// Procedure Collection Factory
+// ============================================================================
+/**
+ * Defines a collection of procedures under a namespace
+ *
+ * Groups related procedures together for registration with routers.
+ * The namespace determines the base path for REST routes.
+ *
+ * @template TProcedures - The record of named procedures
+ * @param namespace - Resource namespace (e.g., 'users', 'posts')
+ * @param procedures - Object containing named procedures
+ * @returns Procedure collection with preserved types
+ *
+ * @example
+ * ```typescript
+ * export const userProcedures = defineProcedures('users', {
+ *   getUser: procedure()
+ *     .input(z.object({ id: z.string().uuid() }))
+ *     .query(async ({ input, ctx }) => {
+ *       return ctx.db.user.findUnique({ where: { id: input.id } });
+ *     }),
+ *
+ *   createUser: procedure()
+ *     .input(CreateUserSchema)
+ *     .mutation(async ({ input, ctx }) => {
+ *       return ctx.db.user.create({ data: input });
+ *     }),
+ * });
+ *
+ * // Types are fully preserved:
+ * // userProcedures.procedures.getUser.inputSchema -> { id: string }
+ * // userProcedures.procedures.createUser -> mutation type
+ * ```
+ */
+export function defineProcedures(namespace, procedures) {
+    return {
+        namespace,
+        procedures: procedures,
+    };
+}
+// ============================================================================
+// Procedure Execution
+// ============================================================================
+/**
+ * Executes a compiled procedure with the given input and context
+ *
+ * This function handles:
+ * 1. Input validation (if schema provided)
+ * 2. Middleware chain execution (using pre-compiled executor when available)
+ * 3. Handler execution
+ * 4. Output validation (if schema provided)
+ *
+ * PERFORMANCE: Uses pre-compiled middleware executor when available,
+ * eliminating the overhead of building the middleware chain on every request.
+ *
+ * @template TInput - The input type
+ * @template TOutput - The output type
+ * @template TContext - The context type
+ * @param procedure - The compiled procedure to execute
+ * @param rawInput - Raw input data to validate and pass to handler
+ * @param ctx - Request context
+ * @returns Promise resolving to the handler output
+ *
+ * @example
+ * ```typescript
+ * const result = await executeProcedure(
+ *   userProcedures.procedures.getUser,
+ *   { id: '123' },
+ *   context
+ * );
+ * ```
+ */
+export async function executeProcedure(procedure, rawInput, ctx) {
+    // Step 1: Validate input if schema provided
+    const input = procedure.inputSchema
+        ? procedure.inputSchema.parse(rawInput)
+        : rawInput;
+    // Step 2: Execute handler (with or without middleware)
+    let result;
+    if (procedure._precompiledExecutor) {
+        // PERFORMANCE: Use pre-compiled middleware chain executor
+        result = await procedure._precompiledExecutor(input, ctx);
+    }
+    else if (procedure.middlewares.length === 0) {
+        // No middleware - execute handler directly
+        result = await procedure.handler({ input, ctx });
+    }
+    else {
+        // Fallback: Build middleware chain dynamically (should not normally happen)
+        result = await executeMiddlewareChainFallback(procedure.middlewares, input, ctx, async () => procedure.handler({ input, ctx }));
+    }
+    // Step 3: Validate output if schema provided
+    if (procedure.outputSchema) {
+        return procedure.outputSchema.parse(result);
+    }
+    return result;
+}
+/**
+ * Fallback middleware chain executor for edge cases
+ *
+ * This function is only used when _precompiledExecutor is not available,
+ * which should be rare in normal operation.
+ *
+ * @internal
+ */
+async function executeMiddlewareChainFallback(middlewares, input, ctx, handler) {
+    // Build the chain from the end (handler) back to the start
+    let next = async () => {
+        const output = await handler();
+        return { output };
+    };
+    // Wrap each middleware from last to first
+    for (let i = middlewares.length - 1; i >= 0; i--) {
+        const middleware = middlewares[i];
+        const currentNext = next;
+        next = async () => {
+            return middleware({
+                input,
+                ctx,
+                next: async (opts) => {
+                    // Allow middleware to extend context
+                    if (opts?.ctx) {
+                        Object.assign(ctx, opts.ctx);
+                    }
+                    return currentNext();
+                },
+            });
+        };
+    }
+    const result = await next();
+    return result.output;
+}
+// ============================================================================
+// Type Utilities
+// ============================================================================
+/**
+ * Type guard to check if a value is a compiled procedure
+ */
+export function isCompiledProcedure(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return ((obj.type === 'query' || obj.type === 'mutation') &&
+        typeof obj.handler === 'function' &&
+        Array.isArray(obj.middlewares));
+}
+/**
+ * Type guard to check if a value is a procedure collection
+ */
+export function isProcedureCollection(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.namespace === 'string' &&
+        typeof obj.procedures === 'object' &&
+        obj.procedures !== null);
+}
+//# sourceMappingURL=builder.js.map

package/dist/procedure/builder.js.map

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