@riktajs/core 0.7.0 → 0.8.0

package/dist/core/container/abstract-class.utils.d.ts

@@ -0,0 +1,10 @@
+import { Constructor } from '../types';
+export declare const IMPLEMENTS_METADATA: unique symbol;
+export declare const PRIMARY_METADATA: unique symbol;
+export declare function isAbstractClass(target: unknown): target is Constructor;
+export declare function extendsFrom(derived: Constructor, base: Constructor): boolean;
+export declare function getImplementedAbstract(target: Constructor): Constructor | undefined;
+export declare function isPrimaryImplementation(target: Constructor): boolean;
+export declare function setImplementsMetadata(target: Constructor, abstractClass: Constructor): void;
+export declare function setPrimaryMetadata(target: Constructor): void;
+export declare function markAsAbstract(target: Constructor): void;

package/dist/core/container/abstract-class.utils.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRIMARY_METADATA = exports.IMPLEMENTS_METADATA = void 0;
+exports.isAbstractClass = isAbstractClass;
+exports.extendsFrom = extendsFrom;
+exports.getImplementedAbstract = getImplementedAbstract;
+exports.isPrimaryImplementation = isPrimaryImplementation;
+exports.setImplementsMetadata = setImplementsMetadata;
+exports.setPrimaryMetadata = setPrimaryMetadata;
+exports.markAsAbstract = markAsAbstract;
+exports.IMPLEMENTS_METADATA = Symbol('rikta:implements');
+exports.PRIMARY_METADATA = Symbol('rikta:primary');
+function isAbstractClass(target) {
+    if (typeof target !== 'function') {
+        return false;
+    }
+    const isMarkedAbstract = Reflect.getMetadata(exports.IMPLEMENTS_METADATA, target) === undefined
+        && Reflect.hasMetadata('abstract:class', target);
+    if (isMarkedAbstract) {
+        return true;
+    }
+    return Reflect.getMetadata('abstract:class', target) === true;
+}
+function extendsFrom(derived, base) {
+    if (!derived || !base) {
+        return false;
+    }
+    if (derived === base) {
+        return false;
+    }
+    let current = Object.getPrototypeOf(derived);
+    while (current && current !== Function.prototype) {
+        if (current === base) {
+            return true;
+        }
+        current = Object.getPrototypeOf(current);
+    }
+    return false;
+}
+function getImplementedAbstract(target) {
+    return Reflect.getMetadata(exports.IMPLEMENTS_METADATA, target);
+}
+function isPrimaryImplementation(target) {
+    return Reflect.getMetadata(exports.PRIMARY_METADATA, target) === true;
+}
+function setImplementsMetadata(target, abstractClass) {
+    Reflect.defineMetadata(exports.IMPLEMENTS_METADATA, abstractClass, target);
+}
+function setPrimaryMetadata(target) {
+    Reflect.defineMetadata(exports.PRIMARY_METADATA, true, target);
+}
+function markAsAbstract(target) {
+    Reflect.defineMetadata('abstract:class', true, target);
+}

package/dist/core/container/container.d.ts

@@ -17,9 +17,12 @@ export declare class Container {
     resolve<T>(token: Token<T>): T;
     resolveOptional<T>(token: Token<T>): T | undefined;
     private resolveToken;
+    private resolveAbstractClass;
     private resolveProvider;
     private resolveClass;
     private injectProperties;
+    private resolveWithName;
+    private resolveWithNameOptional;
     registerInstance<T>(target: Constructor<T>, instance: T): void;
     getProviders(): Token[];
     clearSingletons(): void;

package/dist/core/container/container.js

@@ -4,6 +4,8 @@ exports.container = exports.Container = void 0;
 require("reflect-metadata");
 const constants_1 = require("../constants");
 const injection_token_1 = require("./injection-token");
+const registry_1 = require("../registry");
+const abstract_class_utils_1 = require("./abstract-class.utils");
 class Container {
     static instance;
     singletons = new Map();
@@ -70,12 +72,20 @@ class Container {
         }
         const config = this.providers.get(token);
         if (!config) {
+            if (typeof token === 'function') {
+                const implementation = this.resolveAbstractClass(token);
+                if (implementation) {
+                    const instance = this.resolveClass(implementation);
+                    this.singletons.set(token, instance);
+                    return instance;
+                }
+                if (!(0, abstract_class_utils_1.isAbstractClass)(token)) {
+                    return this.resolveClass(token);
+                }
+            }
             if (optional) {
                 return undefined;
             }
-            if (typeof token === 'function') {
-                return this.resolveClass(token);
-            }
             throw new Error(`No provider found for token: ${this.getTokenName(token)}`);
         }
         if (config.provider && typeof config.provider !== 'function') {
@@ -86,6 +96,16 @@ class Container {
         }
         throw new Error(`Cannot resolve token: ${this.getTokenName(token)}`);
     }
+    resolveAbstractClass(abstractClass, name) {
+        if (name) {
+            return registry_1.registry.resolveImplementation(abstractClass, name);
+        }
+        const config = this.providers.get(abstractClass);
+        if (config?.provider && 'useClass' in config.provider) {
+            return config.provider.useClass;
+        }
+        return registry_1.registry.resolveImplementation(abstractClass);
+    }
     resolveProvider(provider, scope) {
         if (typeof provider === 'function') {
             return this.resolveClass(provider);
@@ -142,6 +162,7 @@ class Container {
                 const injectOverride = injectMeta.find(m => m.index === index);
                 const token = injectOverride?.token ?? paramType;
                 const isOptional = injectOverride?.optional ?? false;
+                const name = injectOverride?.name;
                 if (!token) {
                     if (isOptional) {
                         dependencies.push(undefined);
@@ -159,8 +180,8 @@ class Container {
                         `Use @Autowired(token) decorator.`);
                 }
                 dependencies.push(isOptional
-                    ? this.resolveOptional(token)
-                    : this.resolve(token));
+                    ? this.resolveWithNameOptional(token, name)
+                    : this.resolveWithName(token, name));
             }
             const instance = new target(...dependencies);
             this.injectProperties(target, instance);
@@ -181,8 +202,8 @@ class Container {
             const isOptional = meta.optional ?? false;
             try {
                 const value = isOptional
-                    ? this.resolveOptional(meta.token)
-                    : this.resolve(meta.token);
+                    ? this.resolveWithNameOptional(meta.token, meta.name)
+                    : this.resolveWithName(meta.token, meta.name);
                 instance[meta.propertyKey] = value;
             }
             catch (error) {
@@ -192,6 +213,24 @@ class Container {
             }
         }
     }
+    resolveWithName(token, name) {
+        if (name && typeof token === 'function') {
+            const implementation = this.resolveAbstractClass(token, name);
+            if (implementation) {
+                return this.resolveClass(implementation);
+            }
+            throw new Error(`No implementation named '${name}' found for ${this.getTokenName(token)}`);
+        }
+        return this.resolve(token);
+    }
+    resolveWithNameOptional(token, name) {
+        try {
+            return this.resolveWithName(token, name);
+        }
+        catch {
+            return undefined;
+        }
+    }
     registerInstance(target, instance) {
         this.providers.set(target, { scope: 'singleton' });
         this.singletons.set(target, instance);

package/dist/core/container/implements.decorator.d.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import { AnyConstructor } from '../types';
+export declare function Implements<T extends AnyConstructor>(abstractClass: T): ClassDecorator;
+export declare function Primary(): ClassDecorator;
+export declare function Named(name: string): ClassDecorator;
+export declare function AbstractClass(): ClassDecorator;

package/dist/core/container/implements.decorator.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Implements = Implements;
+exports.Primary = Primary;
+exports.Named = Named;
+exports.AbstractClass = AbstractClass;
+require("reflect-metadata");
+const abstract_class_utils_1 = require("./abstract-class.utils");
+const registry_1 = require("../registry");
+function Implements(abstractClass) {
+    return (target) => {
+        (0, abstract_class_utils_1.setImplementsMetadata)(target, abstractClass);
+        (0, abstract_class_utils_1.markAsAbstract)(abstractClass);
+        const name = Reflect.getMetadata('rikta:named', target);
+        registry_1.registry.registerAbstractImplementation(abstractClass, target, name);
+        const isPrimary = Reflect.getMetadata('rikta:is-primary', target) === true;
+        if (isPrimary) {
+            registry_1.registry.setPrimaryImplementation(abstractClass, target);
+        }
+    };
+}
+function Primary() {
+    return (target) => {
+        (0, abstract_class_utils_1.setPrimaryMetadata)(target);
+        const abstractClass = Reflect.getMetadata(abstract_class_utils_1.IMPLEMENTS_METADATA, target);
+        if (abstractClass) {
+            registry_1.registry.setPrimaryImplementation(abstractClass, target);
+        }
+        Reflect.defineMetadata('rikta:is-primary', true, target);
+    };
+}
+function Named(name) {
+    return (target) => {
+        Reflect.defineMetadata('rikta:named', name, target);
+        const abstractClass = Reflect.getMetadata(abstract_class_utils_1.IMPLEMENTS_METADATA, target);
+        if (abstractClass) {
+            registry_1.registry.setImplementationName(abstractClass, target, name);
+        }
+    };
+}
+function AbstractClass() {
+    return (target) => {
+        (0, abstract_class_utils_1.markAsAbstract)(target);
+    };
+}

package/dist/core/container/index.d.ts

@@ -1,2 +1,4 @@
 export * from './container';
 export * from './injection-token';
+export * from './abstract-class.utils';
+export * from './implements.decorator';

package/dist/core/container/index.js

@@ -16,3 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./container"), exports);
 __exportStar(require("./injection-token"), exports);
+__exportStar(require("./abstract-class.utils"), exports);
+__exportStar(require("./implements.decorator"), exports);

package/dist/core/decorators/autowired.decorator.d.ts

@@ -5,6 +5,7 @@ export interface AutowiredMetadata {
     index?: number;
     propertyKey?: string;
     optional?: boolean;
+    name?: string;
 }
-export declare function Autowired(token?: Token): ParameterDecorator & PropertyDecorator;
+export declare function Autowired(token?: Token, name?: string): ParameterDecorator & PropertyDecorator;
 export declare function Optional(): ParameterDecorator & PropertyDecorator;

package/dist/core/decorators/autowired.decorator.js

@@ -4,7 +4,7 @@ exports.Autowired = Autowired;
 exports.Optional = Optional;
 require("reflect-metadata");
 const constants_1 = require("../constants");
-function Autowired(token) {
+function Autowired(token, name) {
     return (target, propertyKey, parameterIndex) => {
         if (typeof parameterIndex === 'number') {
             const paramTypes = Reflect.getMetadata('design:paramtypes', target) ?? [];
@@ -18,6 +18,7 @@ function Autowired(token) {
             existingInjects.push({
                 token: resolvedToken,
                 index: parameterIndex,
+                name,
             });
             Reflect.defineMetadata(constants_1.INJECT_METADATA, existingInjects, target);
         }
@@ -32,6 +33,7 @@ function Autowired(token) {
             existingAutowires.push({
                 token: resolvedToken,
                 propertyKey: String(propertyKey),
+                name,
             });
             Reflect.defineMetadata(constants_1.AUTOWIRED_METADATA, existingAutowires, target.constructor);
         }

package/dist/core/registry.d.ts

@@ -3,12 +3,18 @@ interface ConfigProviderRegistration {
     token: string;
     providerClass: Constructor;
 }
+interface AbstractImplementation {
+    implementation: Constructor;
+    isPrimary: boolean;
+    name?: string;
+}
 declare class Registry {
     private static instance;
     private controllers;
     private providers;
     private customProviders;
     private configProviderMap;
+    private abstractImplementations;
     private constructor();
     static getInstance(): Registry;
     static reset(): void;
@@ -24,6 +30,14 @@ declare class Registry {
     registerConfigProvider(token: string, providerClass: Constructor): void;
     getConfigProviderRegistrations(): ConfigProviderRegistration[];
     clearConfigProviders(): void;
+    registerAbstractImplementation(abstractClass: Constructor, implementation: Constructor, name?: string): void;
+    setImplementationName(abstractClass: Constructor, implementation: Constructor, name: string): void;
+    setPrimaryImplementation(abstractClass: Constructor, implementation: Constructor): void;
+    getImplementations(abstractClass: Constructor): AbstractImplementation[];
+    resolveImplementation(abstractClass: Constructor, name?: string): Constructor | undefined;
+    getNamedImplementation(abstractClass: Constructor, name: string): Constructor | undefined;
+    hasImplementation(abstractClass: Constructor): boolean;
+    clearAbstractImplementations(): void;
 }
 export declare const registry: Registry;
 export { Registry };

package/dist/core/registry.js

@@ -8,6 +8,7 @@ class Registry {
     providers = new Set();
     customProviders = new Set();
     configProviderMap = new Map();
+    abstractImplementations = new Map();
     constructor() { }
     static getInstance() {
         if (!Registry.instance) {
@@ -62,6 +63,82 @@ class Registry {
     clearConfigProviders() {
         this.configProviderMap.clear();
     }
+    registerAbstractImplementation(abstractClass, implementation, name) {
+        const implementations = this.abstractImplementations.get(abstractClass) ?? [];
+        const existing = implementations.find(i => i.implementation === implementation);
+        if (!existing) {
+            implementations.push({
+                implementation,
+                isPrimary: false,
+                name,
+            });
+            this.abstractImplementations.set(abstractClass, implementations);
+        }
+        else if (name && !existing.name) {
+            existing.name = name;
+        }
+    }
+    setImplementationName(abstractClass, implementation, name) {
+        const implementations = this.abstractImplementations.get(abstractClass);
+        if (!implementations) {
+            return;
+        }
+        const impl = implementations.find(i => i.implementation === implementation);
+        if (impl) {
+            impl.name = name;
+        }
+    }
+    setPrimaryImplementation(abstractClass, implementation) {
+        const implementations = this.abstractImplementations.get(abstractClass);
+        if (!implementations) {
+            return;
+        }
+        for (const impl of implementations) {
+            impl.isPrimary = impl.implementation === implementation;
+        }
+    }
+    getImplementations(abstractClass) {
+        return this.abstractImplementations.get(abstractClass) ?? [];
+    }
+    resolveImplementation(abstractClass, name) {
+        const implementations = this.abstractImplementations.get(abstractClass);
+        if (!implementations || implementations.length === 0) {
+            return undefined;
+        }
+        if (name) {
+            const named = implementations.find(i => i.name === name);
+            if (named) {
+                return named.implementation;
+            }
+            throw new Error(`No implementation named '${name}' found for abstract class ${abstractClass.name}. ` +
+                `Available names: ${implementations.filter(i => i.name).map(i => i.name).join(', ') || 'none'}`);
+        }
+        if (implementations.length === 1) {
+            return implementations[0].implementation;
+        }
+        const primary = implementations.find(i => i.isPrimary);
+        if (primary) {
+            return primary.implementation;
+        }
+        const implNames = implementations.map(i => i.implementation.name).join(', ');
+        throw new Error(`Multiple implementations found for abstract class ${abstractClass.name}: ${implNames}. ` +
+            `Use @Primary() to mark one as the default, or @Named() for qualified injection.`);
+    }
+    getNamedImplementation(abstractClass, name) {
+        const implementations = this.abstractImplementations.get(abstractClass);
+        if (!implementations) {
+            return undefined;
+        }
+        const named = implementations.find(i => i.name === name);
+        return named?.implementation;
+    }
+    hasImplementation(abstractClass) {
+        const implementations = this.abstractImplementations.get(abstractClass);
+        return !!implementations && implementations.length > 0;
+    }
+    clearAbstractImplementations() {
+        this.abstractImplementations.clear();
+    }
 }
 exports.Registry = Registry;
 exports.registry = Registry.getInstance();

package/dist/core/types.d.ts

@@ -1,6 +1,8 @@
 import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
 import { Container } from "@rikta/core/container";
 export type Constructor<T = any> = new (...args: any[]) => T;
+export type AbstractConstructor<T = any> = abstract new (...args: any[]) => T;
+export type AnyConstructor<T = any> = Constructor<T> | AbstractConstructor<T>;
 export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD';
 export interface RouteContext {
     request: FastifyRequest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riktajs/core",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "A fast and modern TypeScript backend framework with zero-config autowiring, powered by Fastify",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,7 +26,7 @@
     "dependency-injection",
     "nestjs-like"
   ],
-  "author": "",
+  "author": "riktar",
   "license": "MIT",
   "dependencies": {
     "dotenv": "^17.2.3",