@veloxts/router 0.6.56 → 0.6.57

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @veloxts/router
 
+## 0.6.57
+
+### Patch Changes
+
+- feat: add DI support to ecosystem packages and main packages
+- Updated dependencies
+  - @veloxts/core@0.6.57
+  - @veloxts/validation@0.6.57
+
 ## 0.6.56
 
 ### Patch Changes

package/dist/index.d.ts

@@ -59,3 +59,25 @@ export type { ContractDefinition, ContractEntry, HttpMethodRoute, InferContract,
 export { defineContract, defineRoutes } from './contracts.js';
 export type { ServeOptions } from './expose.js';
 export { serve } from './expose.js';
+/**
+ * DI tokens and providers for @veloxts/router
+ *
+ * Use these to integrate router services with the @veloxts/core DI container.
+ *
+ * @example
+ * ```typescript
+ * import { Container } from '@veloxts/core';
+ * import { registerRouterProviders, TRPC_INSTANCE, APP_ROUTER } from '@veloxts/router';
+ *
+ * const container = new Container();
+ * registerRouterProviders(container, {
+ *   procedures: [userProcedures, postProcedures],
+ * });
+ *
+ * const t = container.resolve(TRPC_INSTANCE);
+ * const router = container.resolve(APP_ROUTER);
+ * ```
+ */
+export { appRouterProvider, registerRouterProviders, trpcInstanceProvider, trpcPluginOptionsProvider, } from './providers.js';
+export type { RestAdapterConfig, RouterConfig } from './tokens.js';
+export { APP_ROUTER, PROCEDURE_COLLECTIONS, REST_ADAPTER_CONFIG, ROUTER_CONFIG, TRPC_INSTANCE, TRPC_PLUGIN_OPTIONS, } from './tokens.js';

package/dist/index.js

@@ -61,3 +61,28 @@ appRouter, buildTRPCRouter, createTRPCContextFactory, registerTRPCPlugin, trpc,
 export { DiscoveryError, DiscoveryErrorCode, directoryNotFound, discoverProcedures, discoverProceduresVerbose, fileLoadError, invalidExport, invalidFileType, isDiscoveryError, noProceduresFound, permissionDenied, } from './discovery/index.js';
 export { defineContract, defineRoutes } from './contracts.js';
 export { serve } from './expose.js';
+// ============================================================================
+// Dependency Injection
+// ============================================================================
+/**
+ * DI tokens and providers for @veloxts/router
+ *
+ * Use these to integrate router services with the @veloxts/core DI container.
+ *
+ * @example
+ * ```typescript
+ * import { Container } from '@veloxts/core';
+ * import { registerRouterProviders, TRPC_INSTANCE, APP_ROUTER } from '@veloxts/router';
+ *
+ * const container = new Container();
+ * registerRouterProviders(container, {
+ *   procedures: [userProcedures, postProcedures],
+ * });
+ *
+ * const t = container.resolve(TRPC_INSTANCE);
+ * const router = container.resolve(APP_ROUTER);
+ * ```
+ */
+// Provider exports - factory functions for registering services
+export { appRouterProvider, registerRouterProviders, trpcInstanceProvider, trpcPluginOptionsProvider, } from './providers.js';
+export { APP_ROUTER, PROCEDURE_COLLECTIONS, REST_ADAPTER_CONFIG, ROUTER_CONFIG, TRPC_INSTANCE, TRPC_PLUGIN_OPTIONS, } from './tokens.js';

package/dist/providers.d.ts

@@ -0,0 +1,90 @@
+/**
+ * DI Providers for @veloxts/router
+ *
+ * Factory provider functions for registering router services with the DI container.
+ * These providers allow services to be managed by the container for testability and flexibility.
+ *
+ * @module router/providers
+ *
+ * @example
+ * ```typescript
+ * import { Container } from '@veloxts/core';
+ * import { registerRouterProviders, TRPC_INSTANCE, APP_ROUTER } from '@veloxts/router';
+ *
+ * const container = new Container();
+ * registerRouterProviders(container, {
+ *   procedures: [userProcedures, postProcedures],
+ * });
+ *
+ * const t = container.resolve(TRPC_INSTANCE);
+ * const router = container.resolve(APP_ROUTER);
+ * ```
+ */
+import { type Container, type FactoryProvider } from '@veloxts/core';
+import type { RouterConfig } from './tokens.js';
+import type { AnyRouter, TRPCInstance, TRPCPluginOptions } from './trpc/index.js';
+/**
+ * Creates a factory provider for the tRPC instance
+ *
+ * The tRPC instance is the foundation for building type-safe routers.
+ *
+ * @example
+ * ```typescript
+ * container.register(trpcInstanceProvider());
+ * const t = container.resolve(TRPC_INSTANCE);
+ * ```
+ */
+export declare function trpcInstanceProvider(): FactoryProvider<TRPCInstance>;
+/**
+ * Creates a factory provider for the app router
+ *
+ * Requires TRPC_INSTANCE and PROCEDURE_COLLECTIONS to be registered.
+ *
+ * @example
+ * ```typescript
+ * container.register({ provide: PROCEDURE_COLLECTIONS, useValue: [userProcedures] });
+ * container.register(trpcInstanceProvider());
+ * container.register(appRouterProvider());
+ *
+ * const router = container.resolve(APP_ROUTER);
+ * export type AppRouter = typeof router;
+ * ```
+ */
+export declare function appRouterProvider(): FactoryProvider<AnyRouter>;
+/**
+ * Creates a factory provider for tRPC plugin options
+ *
+ * Requires APP_ROUTER and ROUTER_CONFIG to be registered.
+ *
+ * @example
+ * ```typescript
+ * const options = container.resolve(TRPC_PLUGIN_OPTIONS);
+ * await registerTRPCPlugin(server, options);
+ * ```
+ */
+export declare function trpcPluginOptionsProvider(): FactoryProvider<TRPCPluginOptions>;
+/**
+ * Registers core router providers with a container
+ *
+ * This registers the tRPC instance and app router for DI-enabled routing.
+ *
+ * @param container - The DI container to register providers with
+ * @param config - Router configuration with procedure collections
+ *
+ * @example
+ * ```typescript
+ * import { Container } from '@veloxts/core';
+ * import { registerRouterProviders, TRPC_INSTANCE, APP_ROUTER } from '@veloxts/router';
+ *
+ * const container = new Container();
+ * registerRouterProviders(container, {
+ *   procedures: [userProcedures, postProcedures],
+ *   apiPrefix: '/api',
+ *   rpcPrefix: '/trpc',
+ * });
+ *
+ * const t = container.resolve(TRPC_INSTANCE);
+ * const router = container.resolve(APP_ROUTER);
+ * ```
+ */
+export declare function registerRouterProviders(container: Container, config?: RouterConfig): void;

package/dist/providers.js

@@ -0,0 +1,145 @@
+/**
+ * DI Providers for @veloxts/router
+ *
+ * Factory provider functions for registering router services with the DI container.
+ * These providers allow services to be managed by the container for testability and flexibility.
+ *
+ * @module router/providers
+ *
+ * @example
+ * ```typescript
+ * import { Container } from '@veloxts/core';
+ * import { registerRouterProviders, TRPC_INSTANCE, APP_ROUTER } from '@veloxts/router';
+ *
+ * const container = new Container();
+ * registerRouterProviders(container, {
+ *   procedures: [userProcedures, postProcedures],
+ * });
+ *
+ * const t = container.resolve(TRPC_INSTANCE);
+ * const router = container.resolve(APP_ROUTER);
+ * ```
+ */
+import { Scope } from '@veloxts/core';
+import { APP_ROUTER, PROCEDURE_COLLECTIONS, REST_ADAPTER_CONFIG, ROUTER_CONFIG, TRPC_INSTANCE, TRPC_PLUGIN_OPTIONS, } from './tokens.js';
+import { appRouter, trpc } from './trpc/index.js';
+// ============================================================================
+// Core Router Providers
+// ============================================================================
+/**
+ * Creates a factory provider for the tRPC instance
+ *
+ * The tRPC instance is the foundation for building type-safe routers.
+ *
+ * @example
+ * ```typescript
+ * container.register(trpcInstanceProvider());
+ * const t = container.resolve(TRPC_INSTANCE);
+ * ```
+ */
+export function trpcInstanceProvider() {
+    return {
+        provide: TRPC_INSTANCE,
+        useFactory: () => trpc(),
+        inject: [],
+        scope: Scope.SINGLETON,
+    };
+}
+/**
+ * Creates a factory provider for the app router
+ *
+ * Requires TRPC_INSTANCE and PROCEDURE_COLLECTIONS to be registered.
+ *
+ * @example
+ * ```typescript
+ * container.register({ provide: PROCEDURE_COLLECTIONS, useValue: [userProcedures] });
+ * container.register(trpcInstanceProvider());
+ * container.register(appRouterProvider());
+ *
+ * const router = container.resolve(APP_ROUTER);
+ * export type AppRouter = typeof router;
+ * ```
+ */
+export function appRouterProvider() {
+    return {
+        provide: APP_ROUTER,
+        useFactory: (t, collections) => appRouter(t, collections),
+        inject: [TRPC_INSTANCE, PROCEDURE_COLLECTIONS],
+        scope: Scope.SINGLETON,
+    };
+}
+/**
+ * Creates a factory provider for tRPC plugin options
+ *
+ * Requires APP_ROUTER and ROUTER_CONFIG to be registered.
+ *
+ * @example
+ * ```typescript
+ * const options = container.resolve(TRPC_PLUGIN_OPTIONS);
+ * await registerTRPCPlugin(server, options);
+ * ```
+ */
+export function trpcPluginOptionsProvider() {
+    return {
+        provide: TRPC_PLUGIN_OPTIONS,
+        useFactory: (router, config) => ({
+            prefix: config.rpcPrefix ?? '/trpc',
+            router,
+        }),
+        inject: [APP_ROUTER, ROUTER_CONFIG],
+        scope: Scope.SINGLETON,
+    };
+}
+// ============================================================================
+// Bulk Registration Helpers
+// ============================================================================
+/**
+ * Registers core router providers with a container
+ *
+ * This registers the tRPC instance and app router for DI-enabled routing.
+ *
+ * @param container - The DI container to register providers with
+ * @param config - Router configuration with procedure collections
+ *
+ * @example
+ * ```typescript
+ * import { Container } from '@veloxts/core';
+ * import { registerRouterProviders, TRPC_INSTANCE, APP_ROUTER } from '@veloxts/router';
+ *
+ * const container = new Container();
+ * registerRouterProviders(container, {
+ *   procedures: [userProcedures, postProcedures],
+ *   apiPrefix: '/api',
+ *   rpcPrefix: '/trpc',
+ * });
+ *
+ * const t = container.resolve(TRPC_INSTANCE);
+ * const router = container.resolve(APP_ROUTER);
+ * ```
+ */
+export function registerRouterProviders(container, config = {}) {
+    // Register config
+    container.register({
+        provide: ROUTER_CONFIG,
+        useValue: config,
+    });
+    // Register procedure collections
+    container.register({
+        provide: PROCEDURE_COLLECTIONS,
+        useValue: config.procedures ?? [],
+    });
+    // Register REST adapter config
+    container.register({
+        provide: REST_ADAPTER_CONFIG,
+        useValue: {
+            prefix: config.apiPrefix ?? '/api',
+        },
+    });
+    // Register tRPC instance provider
+    container.register(trpcInstanceProvider());
+    // Only register app router if procedures are provided
+    if (config.procedures && config.procedures.length > 0) {
+        container.register(appRouterProvider());
+        container.register(trpcPluginOptionsProvider());
+    }
+}

package/dist/tokens.d.ts

@@ -0,0 +1,107 @@
+/**
+ * DI Tokens for @veloxts/router
+ *
+ * Symbol-based tokens for type-safe dependency injection.
+ * These tokens allow router services to be registered, resolved, and mocked via the DI container.
+ *
+ * @module router/tokens
+ *
+ * @example
+ * ```typescript
+ * import { Container } from '@veloxts/core';
+ * import { TRPC_INSTANCE, trpcInstanceProvider, registerRouterProviders } from '@veloxts/router';
+ *
+ * const container = new Container();
+ * registerRouterProviders(container);
+ *
+ * const t = container.resolve(TRPC_INSTANCE);
+ * ```
+ */
+import type { TRPCPluginOptions } from './trpc/index.js';
+import type { ProcedureCollection } from './types.js';
+/**
+ * Router configuration for DI registration
+ */
+export interface RouterConfig {
+    /**
+     * Procedure collections to register
+     */
+    procedures?: ProcedureCollection[];
+    /**
+     * REST API prefix
+     * @default '/api'
+     */
+    apiPrefix?: string;
+    /**
+     * tRPC endpoint prefix
+     * @default '/trpc'
+     */
+    rpcPrefix?: string;
+}
+/**
+ * REST adapter configuration for DI
+ */
+export interface RestAdapterConfig {
+    /**
+     * API prefix for routes
+     * @default '/api'
+     */
+    prefix?: string;
+}
+/**
+ * tRPC instance token
+ *
+ * The tRPC instance used for building routers and procedures.
+ * This is created by `trpc()` and provides the base for procedure definitions.
+ *
+ * @example
+ * ```typescript
+ * const t = container.resolve(TRPC_INSTANCE);
+ * const router = t.router({
+ *   hello: t.procedure.query(() => 'Hello World'),
+ * });
+ * ```
+ */
+export declare const TRPC_INSTANCE: import("@veloxts/core").SymbolToken<import("@trpc/server").TRPCRootObject<import("@veloxts/core").BaseContext, object, import("@trpc/server").TRPCRuntimeConfigOptions<import("@veloxts/core").BaseContext, object>, {
+    ctx: import("@veloxts/core").BaseContext;
+    meta: object;
+    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+    transformer: false;
+}>>;
+/**
+ * App router token
+ *
+ * The merged tRPC router from all procedure collections.
+ * This is the router exported for type inference on the client.
+ *
+ * @example
+ * ```typescript
+ * const router = container.resolve(APP_ROUTER);
+ * export type AppRouter = typeof router;
+ * ```
+ */
+export declare const APP_ROUTER: import("@veloxts/core").SymbolToken<import("@trpc/server").AnyRouter>;
+/**
+ * Router configuration token
+ *
+ * Contains router settings including procedure collections and prefixes.
+ */
+export declare const ROUTER_CONFIG: import("@veloxts/core").SymbolToken<RouterConfig>;
+/**
+ * REST adapter configuration token
+ *
+ * Configuration for the REST adapter including prefix settings.
+ */
+export declare const REST_ADAPTER_CONFIG: import("@veloxts/core").SymbolToken<RestAdapterConfig>;
+/**
+ * tRPC plugin options token
+ *
+ * Configuration for the tRPC Fastify plugin including prefix and router.
+ */
+export declare const TRPC_PLUGIN_OPTIONS: import("@veloxts/core").SymbolToken<TRPCPluginOptions>;
+/**
+ * Procedure collections token
+ *
+ * Array of procedure collections to register with the router.
+ */
+export declare const PROCEDURE_COLLECTIONS: import("@veloxts/core").SymbolToken<ProcedureCollection<import("./types.js").ProcedureRecord>[]>;

package/dist/tokens.js

@@ -0,0 +1,78 @@
+/**
+ * DI Tokens for @veloxts/router
+ *
+ * Symbol-based tokens for type-safe dependency injection.
+ * These tokens allow router services to be registered, resolved, and mocked via the DI container.
+ *
+ * @module router/tokens
+ *
+ * @example
+ * ```typescript
+ * import { Container } from '@veloxts/core';
+ * import { TRPC_INSTANCE, trpcInstanceProvider, registerRouterProviders } from '@veloxts/router';
+ *
+ * const container = new Container();
+ * registerRouterProviders(container);
+ *
+ * const t = container.resolve(TRPC_INSTANCE);
+ * ```
+ */
+import { token } from '@veloxts/core';
+// ============================================================================
+// Core Router Tokens
+// ============================================================================
+/**
+ * tRPC instance token
+ *
+ * The tRPC instance used for building routers and procedures.
+ * This is created by `trpc()` and provides the base for procedure definitions.
+ *
+ * @example
+ * ```typescript
+ * const t = container.resolve(TRPC_INSTANCE);
+ * const router = t.router({
+ *   hello: t.procedure.query(() => 'Hello World'),
+ * });
+ * ```
+ */
+export const TRPC_INSTANCE = token.symbol('TRPC_INSTANCE');
+/**
+ * App router token
+ *
+ * The merged tRPC router from all procedure collections.
+ * This is the router exported for type inference on the client.
+ *
+ * @example
+ * ```typescript
+ * const router = container.resolve(APP_ROUTER);
+ * export type AppRouter = typeof router;
+ * ```
+ */
+export const APP_ROUTER = token.symbol('APP_ROUTER');
+// ============================================================================
+// Configuration Tokens
+// ============================================================================
+/**
+ * Router configuration token
+ *
+ * Contains router settings including procedure collections and prefixes.
+ */
+export const ROUTER_CONFIG = token.symbol('ROUTER_CONFIG');
+/**
+ * REST adapter configuration token
+ *
+ * Configuration for the REST adapter including prefix settings.
+ */
+export const REST_ADAPTER_CONFIG = token.symbol('REST_ADAPTER_CONFIG');
+/**
+ * tRPC plugin options token
+ *
+ * Configuration for the tRPC Fastify plugin including prefix and router.
+ */
+export const TRPC_PLUGIN_OPTIONS = token.symbol('TRPC_PLUGIN_OPTIONS');
+/**
+ * Procedure collections token
+ *
+ * Array of procedure collections to register with the router.
+ */
+export const PROCEDURE_COLLECTIONS = token.symbol('PROCEDURE_COLLECTIONS');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/router",
-  "version": "0.6.56",
+  "version": "0.6.57",
   "description": "Procedure definitions with tRPC and REST routing for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -35,8 +35,8 @@
   "dependencies": {
     "@trpc/server": "11.8.0",
     "fastify": "5.6.2",
-    "@veloxts/validation": "0.6.56",
-    "@veloxts/core": "0.6.56"
+    "@veloxts/core": "0.6.57",
+    "@veloxts/validation": "0.6.57"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.16",