class-resolver 2.0.0 → 2.1.1

package/README.md

@@ -119,8 +119,8 @@ From version 2.0.0, class-resolver supports generic types for better type safety
 
 ```typescript
 // Define the interface with generics
-interface ResolveTarget<TArgs extends any[] = any[], TReturn = any> {
-  supports(type: string): boolean;
+interface ResolveTarget<TArgs extends any[] = any[], TReturn = any, TType = string> {
+  supports(type: TType): boolean;
   handle(...args: TArgs): TReturn;
 }
 
@@ -141,6 +141,67 @@ const formatter = resolver.resolve('string-format');
 const result = formatter.handle('hello'); // result is typed as string
 ```
 
+### Advanced Type Support
+
+You can now use any type for the `supports` method, not just strings. This is particularly useful for handling complex objects like Stripe events:
+
+```typescript
+// Define a complex event type
+interface StripeEvent {
+  id: string;
+  type: string;
+  data: {
+    object: {
+      id: string;
+      amount: number;
+    };
+  };
+}
+
+// Create handlers for specific event types
+class PaymentEventHandler implements ResolveTarget<[StripeEvent], string, StripeEvent> {
+  supports(event: StripeEvent): boolean {
+    return event.type === 'payment_intent.succeeded';
+  }
+  
+  handle(event: StripeEvent): string {
+    return `Payment succeeded: ${event.data.object.amount}`;
+  }
+}
+
+class RefundEventHandler implements ResolveTarget<[StripeEvent], string, StripeEvent> {
+  supports(event: StripeEvent): boolean {
+    return event.type === 'charge.refunded';
+  }
+  
+  handle(event: StripeEvent): string {
+    return `Refund processed: ${event.data.object.amount}`;
+  }
+}
+
+// Create a resolver that handles StripeEvent types
+const resolver = new Resolver<ResolveTarget<[StripeEvent], string, StripeEvent>, StripeEvent>(
+  new PaymentEventHandler(),
+  new RefundEventHandler()
+);
+
+// Handle different event types
+const paymentEvent: StripeEvent = {
+  id: 'evt_123',
+  type: 'payment_intent.succeeded',
+  data: { object: { id: 'pi_123', amount: 1000 } }
+};
+
+const handler = resolver.resolve(paymentEvent);
+console.log(handler.handle(paymentEvent)); // Output: Payment succeeded: 1000
+```
+
+This advanced type support allows you to:
+- Use complex objects as type identifiers instead of simple strings
+- Maintain full type safety throughout the resolution process
+- Handle domain-specific objects like Stripe events, database records, or custom business objects
+- Create more expressive and type-safe event handling systems
+
 ## Use Cases
 
 1. **Command Pattern Implementation**: Handle different types of commands with specific handlers
@@ -172,8 +233,8 @@ Version 2.0.0 introduces generic type support for better type safety. This chang
    }
    
    // After (2.0.0)
-   interface ResolveTarget<TArgs extends any[] = any[], TReturn = any> {
-     supports(type: string): boolean;
+   interface ResolveTarget<TArgs extends any[] = any[], TReturn = any, TType = string> {
+     supports(type: TType): boolean;
      handle(...args: TArgs): TReturn;
    }
    ```
@@ -186,11 +247,30 @@ Version 2.0.0 introduces generic type support for better type safety. This chang
    }
    
    // After (2.0.0)
-   class Resolver<TBase extends ResolveTarget = ResolveTarget> {
+   class Resolver<TBase extends ResolveTarget<any[], any, any> = ResolveTarget<any[], any, any>, TType = string> {
      // ...
    }
    ```
 
+3. **New in 2.0.0**: You can now specify custom types for the `supports` method:
+   ```typescript
+   // Use custom types instead of strings
+   interface CustomEvent {
+     type: string;
+     data: any;
+   }
+   
+   class CustomHandler implements ResolveTarget<[CustomEvent], string, CustomEvent> {
+     supports(event: CustomEvent): boolean {
+       return event.type === 'custom-type';
+     }
+     
+     handle(event: CustomEvent): string {
+       return `Handled: ${event.type}`;
+     }
+   }
+   ```
+
 #### Migration Steps
 
 1. If you're using TypeScript with default `any` types, your code should continue to work without changes.

package/dist/interface.d.ts

@@ -1,13 +1,13 @@
 /**
  * Interface that classes which are targets for the resolver should implement
  */
-export interface ResolveTarget<TArgs extends any[] = any[], TReturn = any> {
+export interface ResolveTarget<TArgs extends any[] = any[], TReturn = any, TType = string> {
     /**
      * Determines whether the specified type is supported
      * @param type The type to check for support
      * @returns true if supported, false otherwise
      */
-    supports(type: string): boolean;
+    supports(type: TType): boolean;
     /**
      * Handles the request
      * @param args Arguments needed for processing
@@ -16,8 +16,8 @@ export interface ResolveTarget<TArgs extends any[] = any[], TReturn = any> {
     handle(...args: TArgs): TReturn;
 }
 export declare namespace interfaces {
-    interface ResolveTarget<TArgs extends any[] = any[], TReturn = any> {
-        supports(type: string): boolean;
+    interface ResolveTarget<TArgs extends any[] = any[], TReturn = any, TType = string> {
+        supports(type: TType): boolean;
         handle(...args: TArgs): TReturn;
     }
 }

package/dist/resolver.d.ts

@@ -3,7 +3,7 @@ import { ResolveTarget } from './interface';
  * Resolver class implementing the Chain of Responsibility pattern
  * Resolves handlers for specific types
  */
-declare class Resolver<TBase extends ResolveTarget = ResolveTarget> {
+declare class Resolver<TBase extends ResolveTarget<any[], any, any> = ResolveTarget<any[], any, any>, TType = string> {
     /**
      * Array of registered resolver targets
      * @private
@@ -43,6 +43,6 @@ declare class Resolver<TBase extends ResolveTarget = ResolveTarget> {
      * @throws {Error} When no resolver targets are registered
      * @throws {Error} When no resolver target supporting the specified type is found
      */
-    resolve(type: string): TBase;
+    resolve(type: TType): TBase;
 }
 export default Resolver;

package/dist/resolver.js

@@ -58,11 +58,15 @@ class Resolver {
      */
     resolve(type) {
         if (this.updaters.length < 1) {
-            throw new Error('Unasigned resolve target.');
+            throw new Error('Unassigned resolve target.');
         }
         const target = this.updaters.find(updater => updater.supports(type));
         if (!target) {
-            throw new Error(`Unsupported type: ${type}`);
+            // Determine the string representation of the unsupported type
+            // If it's a non-null object, use JSON.stringify for detailed output
+            // Otherwise, use String() for basic conversion
+            const typeString = typeof type === 'object' && type !== null ? JSON.stringify(type) : String(type);
+            throw new Error(`Unsupported type: ${typeString}`);
         }
         return target;
     }

package/dist/resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../libs/resolver.ts"],"names":[],"mappings":";;AAEA;;;GAGG;AACH,MAAM,QAAQ;IAOZ;;;OAGG;IACH,YAAY,GAAG,IAAa;QAV5B;;;WAGG;QACK,aAAQ,GAAY,EAAE,CAAC;QAO7B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,OAAO,CAAC,IAAa;QAC3B,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACnB,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,QAAiB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,GAAG,IAAa;QACjC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,OAAc;QAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACI,OAAO,CAAC,IAAY;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAErE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,kBAAe,QAAQ,CAAC"}
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../libs/resolver.ts"],"names":[],"mappings":";;AAEA;;;GAGG;AACH,MAAM,QAAQ;IAOZ;;;OAGG;IACH,YAAY,GAAG,IAAa;QAV5B;;;WAGG;QACK,aAAQ,GAAY,EAAE,CAAC;QAO7B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,OAAO,CAAC,IAAa;QAC3B,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACnB,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,QAAiB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,GAAG,IAAa;QACjC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,OAAc;QAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACI,OAAO,CAAC,IAAW;QACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAErE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,8DAA8D;YAC9D,oEAAoE;YACpE,+CAA+C;YAC/C,MAAM,UAAU,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnG,MAAM,IAAI,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,kBAAe,QAAQ,CAAC"}

package/libs/interface.ts

@@ -1,13 +1,13 @@
 /**
  * Interface that classes which are targets for the resolver should implement
  */
-export interface ResolveTarget<TArgs extends any[] = any[], TReturn = any> {
+export interface ResolveTarget<TArgs extends any[] = any[], TReturn = any, TType = string> {
   /**
    * Determines whether the specified type is supported
    * @param type The type to check for support
    * @returns true if supported, false otherwise
    */
-  supports(type: string): boolean
+  supports(type: TType): boolean
   
   /**
    * Handles the request
@@ -19,8 +19,8 @@ export interface ResolveTarget<TArgs extends any[] = any[], TReturn = any> {
 
 // Maintain namespace for backward compatibility
 export namespace interfaces {
-  export interface ResolveTarget<TArgs extends any[] = any[], TReturn = any> {
-    supports(type: string): boolean
+  export interface ResolveTarget<TArgs extends any[] = any[], TReturn = any, TType = string> {
+    supports(type: TType): boolean
     handle(...args: TArgs): TReturn
   }
 }

package/libs/resolver.ts

@@ -4,7 +4,7 @@ import { ResolveTarget } from './interface'
  * Resolver class implementing the Chain of Responsibility pattern
  * Resolves handlers for specific types
  */
-class Resolver<TBase extends ResolveTarget = ResolveTarget> {
+class Resolver<TBase extends ResolveTarget<any[], any, any> = ResolveTarget<any[], any, any>, TType = string> {
   /**
    * Array of registered resolver targets
    * @private
@@ -62,15 +62,19 @@ class Resolver<TBase extends ResolveTarget = ResolveTarget> {
    * @throws {Error} When no resolver targets are registered
    * @throws {Error} When no resolver target supporting the specified type is found
    */
-  public resolve(type: string): TBase {
+  public resolve(type: TType): TBase {
     if (this.updaters.length < 1) {
-      throw new Error('Unasigned resolve target.');
+      throw new Error('Unassigned resolve target.');
     }
     
     const target = this.updaters.find(updater => updater.supports(type));
     
     if (!target) {
-      throw new Error(`Unsupported type: ${type}`);
+      // Determine the string representation of the unsupported type
+      // If it's a non-null object, use JSON.stringify for detailed output
+      // Otherwise, use String() for basic conversion
+      const typeString = typeof type === 'object' && type !== null ? JSON.stringify(type) : String(type);
+      throw new Error(`Unsupported type: ${typeString}`);
     }
     
     return target;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "class-resolver",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "Simple class resolver.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,7 +32,12 @@
       "js"
     ],
     "transform": {
-      "^.+\\.(ts|tsx)$": ["ts-jest", { "tsconfig": "tsconfig.json" }]
+      "^.+\\.(ts|tsx)$": [
+        "ts-jest",
+        {
+          "tsconfig": "tsconfig.json"
+        }
+      ]
     },
     "testMatch": [
       "**/__tests__/*.+(ts|tsx|js)"