@goodie-ts/decorators 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GOOD Code ApS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/eager.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Marks a singleton bean for eager instantiation during context creation.
+ * By default, singletons are lazy (created on first `get()`).
+ *
+ * @example
+ * @Eager()
+ * @Singleton()
+ * class StartupService { ... }
+ */
+export declare function Eager(): ClassDecorator_Stage3;
+type ClassDecorator_Stage3 = (target: new (...args: any[]) => any, context: ClassDecoratorContext) => void;
+export {};
+//# sourceMappingURL=eager.d.ts.map

package/dist/eager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eager.d.ts","sourceRoot":"","sources":["../src/eager.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAI7C;AAED,KAAK,qBAAqB,GAAG,CAC3B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnC,OAAO,EAAE,qBAAqB,KAC3B,IAAI,CAAC"}

package/dist/eager.js

@@ -0,0 +1,16 @@
+import { META, setMeta } from './metadata.js';
+/**
+ * Marks a singleton bean for eager instantiation during context creation.
+ * By default, singletons are lazy (created on first `get()`).
+ *
+ * @example
+ * @Eager()
+ * @Singleton()
+ * class StartupService { ... }
+ */
+export function Eager() {
+    return (_target, context) => {
+        setMeta(context.metadata, META.EAGER, true);
+    };
+}
+//# sourceMappingURL=eager.js.map

package/dist/eager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eager.js","sourceRoot":"","sources":["../src/eager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,UAAU,KAAK;IACnB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,OAAO,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { Eager } from './eager.js';
+export { Inject } from './inject.js';
+export { Injectable } from './injectable.js';
+export { getClassMetadata, META, pushMeta, setMeta } from './metadata.js';
+export type { ModuleOptions } from './module.js';
+export { Module } from './module.js';
+export { Named } from './named.js';
+export { Optional } from './optional.js';
+export { PreDestroy } from './pre-destroy.js';
+export { Provides } from './provides.js';
+export { Singleton } from './singleton.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,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { Eager } from './eager.js';
+export { Inject } from './inject.js';
+export { Injectable } from './injectable.js';
+export { getClassMetadata, META, pushMeta, setMeta } from './metadata.js';
+export { Module } from './module.js';
+export { Named } from './named.js';
+export { Optional } from './optional.js';
+export { PreDestroy } from './pre-destroy.js';
+export { Provides } from './provides.js';
+export { Singleton } from './singleton.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,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/inject.d.ts

@@ -0,0 +1,17 @@
+import type { InjectionToken } from '@goodie-ts/core';
+/**
+ * Accessor decorator to inject a dependency by qualifier name or InjectionToken.
+ *
+ * Note: Native Stage 3 decorators don't support parameter decorators.
+ * Use `@Inject` on auto-accessor fields only. Constructor parameter injection
+ * is handled by the Phase 2 transformer via AST analysis.
+ *
+ * @example
+ * @Singleton()
+ * class UserService {
+ *   @Inject('primary') accessor repo!: UserRepository
+ *   @Inject(DB_URL) accessor url!: string
+ * }
+ */
+export declare function Inject(qualifier: string | InjectionToken<unknown>): (target: ClassAccessorDecoratorTarget<unknown, unknown>, context: ClassAccessorDecoratorContext) => void;
+//# sourceMappingURL=inject.d.ts.map

package/dist/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,GAC1C,CACD,MAAM,EAAE,4BAA4B,CAAC,OAAO,EAAE,OAAO,CAAC,EACtD,OAAO,EAAE,6BAA6B,KACnC,IAAI,CAOR"}

package/dist/inject.js

@@ -0,0 +1,24 @@
+import { META, pushMeta } from './metadata.js';
+/**
+ * Accessor decorator to inject a dependency by qualifier name or InjectionToken.
+ *
+ * Note: Native Stage 3 decorators don't support parameter decorators.
+ * Use `@Inject` on auto-accessor fields only. Constructor parameter injection
+ * is handled by the Phase 2 transformer via AST analysis.
+ *
+ * @example
+ * @Singleton()
+ * class UserService {
+ *   @Inject('primary') accessor repo!: UserRepository
+ *   @Inject(DB_URL) accessor url!: string
+ * }
+ */
+export function Inject(qualifier) {
+    return (_target, context) => {
+        pushMeta(context.metadata, META.INJECT, {
+            fieldName: context.name,
+            qualifier,
+        });
+    };
+}
+//# sourceMappingURL=inject.js.map

package/dist/inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,MAAM,CACpB,SAA2C;IAK3C,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,QAAQ,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,MAAM,EAAE;YACvC,SAAS,EAAE,OAAO,CAAC,IAAI;YACvB,SAAS;SACV,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/injectable.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Marks a class as injectable with prototype scope.
+ *
+ * @example
+ * @Injectable()
+ * class UserRepository { ... }
+ */
+export declare function Injectable(): ClassDecorator_Stage3;
+type ClassDecorator_Stage3 = (target: new (...args: any[]) => any, context: ClassDecoratorContext) => void;
+export {};
+//# sourceMappingURL=injectable.d.ts.map

package/dist/injectable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.d.ts","sourceRoot":"","sources":["../src/injectable.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAIlD;AAED,KAAK,qBAAqB,GAAG,CAC3B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnC,OAAO,EAAE,qBAAqB,KAC3B,IAAI,CAAC"}

package/dist/injectable.js

@@ -0,0 +1,14 @@
+import { META, setMeta } from './metadata.js';
+/**
+ * Marks a class as injectable with prototype scope.
+ *
+ * @example
+ * @Injectable()
+ * class UserRepository { ... }
+ */
+export function Injectable() {
+    return (_target, context) => {
+        setMeta(context.metadata, META.SCOPE, 'prototype');
+    };
+}
+//# sourceMappingURL=injectable.js.map

package/dist/injectable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.js","sourceRoot":"","sources":["../src/injectable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,OAAO,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,KAAK,EAAE,WAA2B,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Metadata helpers for Stage 3 decorators.
+ *
+ * Stage 3 decorators provide `context.metadata` — an object that gets
+ * attached to the class via `Symbol.metadata`. We use well-known keys
+ * (Symbols) to avoid collisions with user metadata.
+ */
+/** Well-known metadata keys used by goodie decorators. */
+export declare const META: {
+    readonly SCOPE: symbol;
+    readonly NAME: symbol;
+    readonly EAGER: symbol;
+    readonly MODULE: symbol;
+    readonly PROVIDES: symbol;
+    readonly INJECT: symbol;
+    readonly OPTIONAL: symbol;
+    readonly PRE_DESTROY: symbol;
+};
+type MetadataObject = DecoratorMetadataObject | Record<PropertyKey, unknown>;
+/**
+ * Set a single metadata value on the decorator context metadata object.
+ */
+export declare function setMeta(metadata: MetadataObject, key: symbol, value: unknown): void;
+/**
+ * Push a value onto an array stored under `key`. Creates the array if needed.
+ */
+export declare function pushMeta(metadata: MetadataObject, key: symbol, value: unknown): void;
+/**
+ * Read the metadata object stashed on a class by Stage 3 decorators.
+ * Returns `undefined` if no decorators have run on the class.
+ */
+export declare function getClassMetadata(cls: abstract new (...args: any[]) => any): Record<PropertyKey, unknown> | undefined;
+export {};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0DAA0D;AAC1D,eAAO,MAAM,IAAI;;;;;;;;;CASP,CAAC;AAEX,KAAK,cAAc,GAAG,uBAAuB,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAE7E;;GAEG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GACxC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,SAAS,CAI1C"}

package/dist/metadata.js

@@ -0,0 +1,40 @@
+/**
+ * Metadata helpers for Stage 3 decorators.
+ *
+ * Stage 3 decorators provide `context.metadata` — an object that gets
+ * attached to the class via `Symbol.metadata`. We use well-known keys
+ * (Symbols) to avoid collisions with user metadata.
+ */
+/** Well-known metadata keys used by goodie decorators. */
+export const META = {
+    SCOPE: Symbol('goodie:scope'),
+    NAME: Symbol('goodie:name'),
+    EAGER: Symbol('goodie:eager'),
+    MODULE: Symbol('goodie:module'),
+    PROVIDES: Symbol('goodie:provides'),
+    INJECT: Symbol('goodie:inject'),
+    OPTIONAL: Symbol('goodie:optional'),
+    PRE_DESTROY: Symbol('goodie:pre-destroy'),
+};
+/**
+ * Set a single metadata value on the decorator context metadata object.
+ */
+export function setMeta(metadata, key, value) {
+    metadata[key] = value;
+}
+/**
+ * Push a value onto an array stored under `key`. Creates the array if needed.
+ */
+export function pushMeta(metadata, key, value) {
+    const arr = metadata[key] ?? [];
+    arr.push(value);
+    metadata[key] = arr;
+}
+/**
+ * Read the metadata object stashed on a class by Stage 3 decorators.
+ * Returns `undefined` if no decorators have run on the class.
+ */
+export function getClassMetadata(cls) {
+    return cls[Symbol.metadata];
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,iBAAiB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,iBAAiB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC,oBAAoB,CAAC;CACjC,CAAC;AAIX;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,QAAwB,EACxB,GAAW,EACX,KAAc;IAEd,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,QAAwB,EACxB,GAAW,EACX,KAAc;IAEd,MAAM,GAAG,GAAI,QAAQ,CAAC,GAAG,CAAe,IAAI,EAAE,CAAC;IAC/C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,QAAQ,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAyC;IAEzC,OACE,GACD,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACrB,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,19 @@
+export interface ModuleOptions {
+    /** Other modules to import (compose). */
+    imports?: Array<new (...args: any[]) => any>;
+}
+/**
+ * Marks a class as a DI module. Modules group `@Provides()` factory methods
+ * and can import other modules.
+ *
+ * @example
+ * @Module({ imports: [DatabaseModule] })
+ * class AppModule {
+ *   @Provides()
+ *   dbUrl(): string { return process.env.DATABASE_URL! }
+ * }
+ */
+export declare function Module(options?: ModuleOptions): ClassDecorator_Stage3;
+type ClassDecorator_Stage3 = (target: new (...args: any[]) => any, context: ClassDecoratorContext) => void;
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,OAAO,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,qBAAqB,CAMzE;AAED,KAAK,qBAAqB,GAAG,CAC3B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnC,OAAO,EAAE,qBAAqB,KAC3B,IAAI,CAAC"}

package/dist/module.js

@@ -0,0 +1,20 @@
+import { META, setMeta } from './metadata.js';
+/**
+ * Marks a class as a DI module. Modules group `@Provides()` factory methods
+ * and can import other modules.
+ *
+ * @example
+ * @Module({ imports: [DatabaseModule] })
+ * class AppModule {
+ *   @Provides()
+ *   dbUrl(): string { return process.env.DATABASE_URL! }
+ * }
+ */
+export function Module(options = {}) {
+    return (_target, context) => {
+        setMeta(context.metadata, META.MODULE, {
+            imports: options.imports ?? [],
+        });
+    };
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAO9C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAAC,UAAyB,EAAE;IAChD,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,OAAO,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,MAAM,EAAE;YACtC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/named.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Assigns a qualifier name to a bean, used for disambiguation
+ * when multiple implementations exist for the same type.
+ *
+ * @example
+ * @Named('primary')
+ * @Singleton()
+ * class PrimaryUserRepository implements UserRepository { ... }
+ */
+export declare function Named(name: string): ClassDecorator_Stage3;
+type ClassDecorator_Stage3 = (target: new (...args: any[]) => any, context: ClassDecoratorContext) => void;
+export {};
+//# sourceMappingURL=named.d.ts.map

package/dist/named.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.d.ts","sourceRoot":"","sources":["../src/named.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAIzD;AAED,KAAK,qBAAqB,GAAG,CAC3B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnC,OAAO,EAAE,qBAAqB,KAC3B,IAAI,CAAC"}

package/dist/named.js

@@ -0,0 +1,16 @@
+import { META, setMeta } from './metadata.js';
+/**
+ * Assigns a qualifier name to a bean, used for disambiguation
+ * when multiple implementations exist for the same type.
+ *
+ * @example
+ * @Named('primary')
+ * @Singleton()
+ * class PrimaryUserRepository implements UserRepository { ... }
+ */
+export function Named(name) {
+    return (_target, context) => {
+        setMeta(context.metadata, META.NAME, name);
+    };
+}
+//# sourceMappingURL=named.js.map

package/dist/named.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.js","sourceRoot":"","sources":["../src/named.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,OAAO,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC;AACJ,CAAC"}

package/dist/optional.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Accessor decorator marking a dependency as optional.
+ * If no provider is registered, the field resolves to `undefined`.
+ *
+ * @example
+ * @Singleton()
+ * class MetricsService {
+ *   @Optional() accessor tracer: Tracer | undefined
+ * }
+ */
+export declare function Optional(): (target: ClassAccessorDecoratorTarget<unknown, unknown>, context: ClassAccessorDecoratorContext) => void;
+//# sourceMappingURL=optional.d.ts.map

package/dist/optional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional.d.ts","sourceRoot":"","sources":["../src/optional.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,IAAI,CAC1B,MAAM,EAAE,4BAA4B,CAAC,OAAO,EAAE,OAAO,CAAC,EACtD,OAAO,EAAE,6BAA6B,KACnC,IAAI,CAMR"}

package/dist/optional.js

@@ -0,0 +1,19 @@
+import { META, pushMeta } from './metadata.js';
+/**
+ * Accessor decorator marking a dependency as optional.
+ * If no provider is registered, the field resolves to `undefined`.
+ *
+ * @example
+ * @Singleton()
+ * class MetricsService {
+ *   @Optional() accessor tracer: Tracer | undefined
+ * }
+ */
+export function Optional() {
+    return (_target, context) => {
+        pushMeta(context.metadata, META.OPTIONAL, {
+            fieldName: context.name,
+        });
+    };
+}
+//# sourceMappingURL=optional.js.map

package/dist/optional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional.js","sourceRoot":"","sources":["../src/optional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ;IAItB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,QAAQ,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,QAAQ,EAAE;YACzC,SAAS,EAAE,OAAO,CAAC,IAAI;SACxB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/pre-destroy.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Marks a method to be called when the ApplicationContext is closed.
+ *
+ * Only effective on `@Singleton` / `@Injectable` classes. The method
+ * will be invoked during `close()` in reverse-topological order
+ * (dependents destroyed before their dependencies).
+ *
+ * @example
+ * @Singleton()
+ * class DatabasePool {
+ *   @PreDestroy()
+ *   async shutdown() {
+ *     await this.pool.end();
+ *   }
+ * }
+ */
+export declare function PreDestroy(): MethodDecorator_Stage3;
+type MethodDecorator_Stage3 = (target: (...args: never) => unknown, context: ClassMethodDecoratorContext) => void;
+export {};
+//# sourceMappingURL=pre-destroy.d.ts.map

package/dist/pre-destroy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-destroy.d.ts","sourceRoot":"","sources":["../src/pre-destroy.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,IAAI,sBAAsB,CAMnD;AAED,KAAK,sBAAsB,GAAG,CAC5B,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACnC,OAAO,EAAE,2BAA2B,KACjC,IAAI,CAAC"}

package/dist/pre-destroy.js

@@ -0,0 +1,25 @@
+import { META, pushMeta } from './metadata.js';
+/**
+ * Marks a method to be called when the ApplicationContext is closed.
+ *
+ * Only effective on `@Singleton` / `@Injectable` classes. The method
+ * will be invoked during `close()` in reverse-topological order
+ * (dependents destroyed before their dependencies).
+ *
+ * @example
+ * @Singleton()
+ * class DatabasePool {
+ *   @PreDestroy()
+ *   async shutdown() {
+ *     await this.pool.end();
+ *   }
+ * }
+ */
+export function PreDestroy() {
+    return (_target, context) => {
+        pushMeta(context.metadata, META.PRE_DESTROY, {
+            methodName: context.name,
+        });
+    };
+}
+//# sourceMappingURL=pre-destroy.js.map

package/dist/pre-destroy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-destroy.js","sourceRoot":"","sources":["../src/pre-destroy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,QAAQ,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,WAAW,EAAE;YAC5C,UAAU,EAAE,OAAO,CAAC,IAAI;SACzB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/provides.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Marks a method inside a `@Module()` class as a bean factory.
+ *
+ * @example
+ * @Module()
+ * class AppModule {
+ *   @Provides()
+ *   databaseClient(): DatabaseClient { return new DatabaseClient() }
+ * }
+ */
+export declare function Provides(): MethodDecorator_Stage3;
+type MethodDecorator_Stage3 = (target: (...args: never) => unknown, context: ClassMethodDecoratorContext) => void;
+export {};
+//# sourceMappingURL=provides.d.ts.map

package/dist/provides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provides.d.ts","sourceRoot":"","sources":["../src/provides.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,IAAI,sBAAsB,CAMjD;AAED,KAAK,sBAAsB,GAAG,CAC5B,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACnC,OAAO,EAAE,2BAA2B,KACjC,IAAI,CAAC"}

package/dist/provides.js

@@ -0,0 +1,19 @@
+import { META, pushMeta } from './metadata.js';
+/**
+ * Marks a method inside a `@Module()` class as a bean factory.
+ *
+ * @example
+ * @Module()
+ * class AppModule {
+ *   @Provides()
+ *   databaseClient(): DatabaseClient { return new DatabaseClient() }
+ * }
+ */
+export function Provides() {
+    return (_target, context) => {
+        pushMeta(context.metadata, META.PROVIDES, {
+            methodName: context.name,
+        });
+    };
+}
+//# sourceMappingURL=provides.js.map

package/dist/provides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provides.js","sourceRoot":"","sources":["../src/provides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,QAAQ,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,QAAQ,EAAE;YACzC,UAAU,EAAE,OAAO,CAAC,IAAI;SACzB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/singleton.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Marks a class as a singleton bean.
+ *
+ * @example
+ * @Singleton()
+ * class UserService { ... }
+ */
+export declare function Singleton(): ClassDecorator_Stage3;
+type ClassDecorator_Stage3 = (target: new (...args: any[]) => any, context: ClassDecoratorContext) => void;
+export {};
+//# sourceMappingURL=singleton.d.ts.map

package/dist/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,qBAAqB,CAIjD;AAED,KAAK,qBAAqB,GAAG,CAC3B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnC,OAAO,EAAE,qBAAqB,KAC3B,IAAI,CAAC"}

package/dist/singleton.js

@@ -0,0 +1,14 @@
+import { META, setMeta } from './metadata.js';
+/**
+ * Marks a class as a singleton bean.
+ *
+ * @example
+ * @Singleton()
+ * class UserService { ... }
+ */
+export function Singleton() {
+    return (_target, context) => {
+        setMeta(context.metadata, META.SCOPE, 'singleton');
+    };
+}
+//# sourceMappingURL=singleton.js.map

package/dist/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,OAAO,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,KAAK,EAAE,WAA2B,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@goodie-ts/decorators",
+  "version": "0.1.0",
+  "description": "Stage 3 decorators for goodie-ts compile-time dependency injection",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GOOD-Code-ApS/goodie.git",
+    "directory": "packages/decorators"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@goodie-ts/core": "0.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}