aquinas 0.0.1 → 0.0.2

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("inversify");function r(){const r=new e.Container,n=new Set,t=new Map;function o(e){const t=r.bind(e.id);return"symbol"==typeof e.id&&n.add(e),t}function i(e){if("id"in e)return r.get(e.id);const n={};for(const t in e)n[t]=r.get(e[t].id);return n}const c={referenceRegistry:n,bindingRegistry:t,merge(...o){const i=o.map(r=>new e.ContainerModule(({bind:e})=>{for(const o of r.referenceRegistry){const i=r.bindingRegistry.get(o);if(!i)throw new Error("Missing factory during merge");n.add(o),t.set(o,i),e(o.id).toDynamicValue(()=>i(c)).inSingletonScope()}}));r.loadSync(...i)},register(...e){for(const r of e)n.add(r.reference),t.set(r.reference,r.factory),o(r.reference).toDynamicValue(()=>r.factory(c)).inSingletonScope()},overwrite(...e){for(const i of e)r.isBound(i.reference.id)&&r.unbind(i.reference.id),n.add(i.reference),t.set(i.reference,i.factory),o(i.reference).toDynamicValue(()=>i.factory(c)).inSingletonScope()},getContainer:()=>r,get:i,safeGet(e){try{return i(e)}catch{return}}};return c}function n(e,r){if(!e||"object"!=typeof e)throw new Error("Invalid references object provided");const n={};for(const[t,o]of Object.entries(e)){if(!o||"object"!=typeof o)throw new Error(`Invalid dependency reference for key: ${t}`);if(!("__INJECTION_REFERENCE_FLAG"in o)||!o.__INJECTION_REFERENCE_FLAG)throw new Error(`Invalid dependency reference flag for key: ${t}`);try{n[t]=r.get(o)}catch(e){throw new Error(`Failed to resolve dependency for key: ${t}. ${e instanceof Error?e.message:String(e)}`)}}return n}function t(e){return e?{get:r=>e.get(r),safeGet:r=>{try{return e.get(r)}catch{return}},dock:e}:{get:()=>{throw new Error("Dock not available in this context")},safeGet:()=>{throw new Error("Dock not available in this context")},dock:r()}}var o=e=>({id:Symbol.for(e),name:e,__INJECTION_REFERENCE_FLAG:!0,__type:null,toJSON:()=>e});exports.derivedReference=function(e,r){return o(`${e}:${r.toJSON()}`)},exports.dock=r,exports.injectable=function(e){const r={};let o;return function i(){return{deps:e=>(Object.assign(r,e),i()),init:e=>(o=e,i()),implements:i=>({reference:e,factory:e=>{const c=n(r,e),f={...c,...o?o(c):{},ctx:t(e)};return i(f)},instantiate:(e={})=>{const r={...e,...o?o(e):{},ctx:t()};return i(r)}})}}()},exports.reference=o,exports.resolveReferences=n;

package/dist/index.d.cts

@@ -0,0 +1,59 @@
+import { Container } from 'inversify';
+
+interface Reference<T> {
+    id: symbol;
+    name: string;
+    __INJECTION_REFERENCE_FLAG: boolean;
+    __type: T;
+    toJSON: () => string;
+}
+declare const reference: <T>(name: string) => Reference<T>;
+declare function derivedReference<T>(base: string, ref: Reference<any>): Reference<T>;
+
+type Bindable<T> = {
+    reference: Reference<T>;
+    factory: (dock: Dock) => T;
+};
+interface Dock {
+    referenceRegistry: Set<Reference<any>>;
+    bindingRegistry: Map<Reference<any>, (dock: Dock) => any>;
+    merge(...sources: Dock[]): void;
+    register(...bindables: Bindable<any>[]): void;
+    overwrite(...bindables: Bindable<any>[]): void;
+    getContainer(): Container;
+    get<U>(reference: Reference<U>): U;
+    get<T extends Record<string, Reference<any>>>(reference: T): {
+        [K in keyof T]: T[K] extends Reference<infer V> ? V : never;
+    };
+    safeGet<U>(reference: Reference<U>): U | undefined;
+}
+declare function dock(): Dock;
+
+type BaseObject = {};
+type InjectableObjectFactory<Refs extends BaseObject, Type, State extends BaseObject> = (context: Refs & State) => Type;
+interface ContextHelper {
+    get<T>(ref: Reference<T>): T;
+    safeGet<T>(ref: Reference<T>): T | undefined;
+    dock: Dock;
+}
+interface InjectableBuilder<ResolvedRefs extends BaseObject, Type, State extends BaseObject> {
+    deps<NewDepsConfig extends Record<string, Reference<any>>, NewlyResolvedRefs extends {
+        [K in keyof NewDepsConfig]: NewDepsConfig[K] extends Reference<infer R> ? R : never;
+    }>(references: NewDepsConfig): InjectableBuilder<ResolvedRefs & NewlyResolvedRefs, Type, State>;
+    init<NewState extends BaseObject>(initFactory: (refs: ResolvedRefs) => NewState): InjectableBuilder<ResolvedRefs, Type, NewState>;
+    implements(factory: InjectableObjectFactory<ResolvedRefs & {
+        ctx: ContextHelper;
+    }, Type, State>): Injectable<ResolvedRefs, Type>;
+}
+interface Injectable<ResolvedRefs extends BaseObject, Type> {
+    reference: Reference<Type>;
+    factory: (dock: Dock) => Type;
+    instantiate: (deps?: ResolvedRefs) => Type;
+}
+declare function injectable<Type>(reference: Reference<Type>): InjectableBuilder<BaseObject, Type, BaseObject>;
+
+declare function resolveReferences<Refs extends Record<string, Reference<unknown>>>(references: Refs, dock: Dock): {
+    [K in keyof Refs]: Refs[K] extends Reference<infer T> ? T : never;
+};
+
+export { type Dock, type Injectable, type Reference, derivedReference, dock, injectable, reference, resolveReferences };

package/package.json

@@ -1,5 +1,68 @@
 {
   "name": "aquinas",
-  "version": "0.0.1",
-  "license": "MIT"
+  "description": "dependency inversion w/o classes",
+  "author": "Fernando Coelho",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.0.2",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fgcoelho/aquinas.git"
+  },
+  "homepage": "https://aquinas.vercel.app",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "IOC",
+    "dependency-injection",
+    "dependency-inversion",
+    "di",
+    "design-patterns",
+    "clean-architecture",
+    "solid"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": "./dist/index.cjs"
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/index.d.cts"
+      ]
+    }
+  },
+  "devDependencies": {
+    "@types/node": "24.6.0",
+    "esbuild": "0.25.10",
+    "terser": "5.44.0",
+    "tsup": "8.5.0",
+    "typescript": "5.9.3",
+    "@biomejs/biome": "2.2.4"
+  },
+  "dependencies": {
+    "inversify": "7.10.2"
+  },
+  "scripts": {
+    "------------- toolchain -------------": "-------------",
+    "format": "biome format --write",
+    "lint": "biome lint --error-on-warnings",
+    "checktypes": "tsc --noEmit",
+    "check": "pnpm checktypes && pnpm lint",
+    "test": "vitest",
+    "------------- dev -------------": "-------------",
+    "dev": "pnpm tsup --env.mode dev",
+    "------------- build -------------": "-------------",
+    "build": "rm -rf dist && pnpm tsup --env.mode release",
+    "bundlesize": "pnpm build --metafile && npm pack --dry-run",
+    "bundlesize:dev": "pnpm tsup --metafile && npm pack --dry-run",
+    "------------- publishing -------------": "-------------",
+    "release": "pnpm check && pnpm build && pnpm publish --no-git-checks",
+    "release:rc": "pnpm check && pnpm build && pnpm version prerelease --preid=rc"
+  }
 }