sandly 0.2.0 → 0.3.0

package/README.md

@@ -23,13 +23,13 @@ class DatabaseService extends Tag.Service('DatabaseService') {
 	}
 }
 
-const c = container().register(DatabaseService, () => new DatabaseService());
+const container = Container.empty().register(DatabaseService, () => new DatabaseService());
 
 // ✅ TypeScript knows DatabaseService is available
-const db = await c.resolve(DatabaseService);
+const db = await container.resolve(DatabaseService);
 
 // ❌ Compile error - UserService not registered
-const user = await c.resolve(UserService); // Type error
+const user = await container.resolve(UserService); // Type error
 ```
 
 ### Modular Architecture with Layers

package/dist/index.d.ts

@@ -13,15 +13,15 @@ type TagId = string | symbol;
  *
  * @internal
  */
-declare const ValueTagIdKey = "__sandly/ValueTagIdKey__";
-declare const ServiceTagIdKey = "__sandly/ServiceTagIdKey__";
+declare const ValueTagIdKey = "sandly/ValueTagIdKey";
+declare const ServiceTagIdKey = "sandly/ServiceTagIdKey";
 /**
- * Internal symbol used to identify the type of a tagged type within the dependency injection system.
- * This symbol is used as a property key to attach metadata to both value tags and service tags.
+ * Internal string used to identify the type of a tagged type within the dependency injection system.
+ * This string is used as a property key to attach metadata to both value tags and service tags.
  * It is used to carry the type of the tagged type and should not be used directly.
  * @internal
  */
-declare const TagTypeKey: unique symbol;
+declare const TagTypeKey = "sandly/TagTypeKey";
 /**
  * Type representing a value-based dependency tag.
  *
@@ -70,9 +70,9 @@ interface ValueTag<Id extends TagId, T> {
  */
 interface ServiceTag<Id extends TagId, T> {
   new (...args: any[]): T & {
-    readonly [ServiceTagIdKey]: Id;
+    readonly [ServiceTagIdKey]?: Id;
   };
-  readonly [ServiceTagIdKey]: Id;
+  readonly [ServiceTagIdKey]?: Id;
 }
 /**
  * Utility type that extracts the service type from any dependency tag.
@@ -286,7 +286,7 @@ declare const Tag: {
    * ```
    */
   Service: <Id extends TagId>(id: Id) => ServiceTag<Id, {
-    readonly "__sandly/ServiceTagIdKey__": Id;
+    readonly "sandly/ServiceTagIdKey"?: Id;
   }>;
   /**
    * Extracts the string representation of a tag's identifier.
@@ -311,14 +311,14 @@ declare const Tag: {
    *
    * @internal - Primarily for internal use in error messages and debugging
    */
-  id: (tag: AnyTag) => TagId;
+  id: (tag: AnyTag) => TagId | undefined;
   isTag: (tag: unknown) => tag is AnyTag;
 };
 /**
- * Unique symbol used to store the original ValueTag in Inject<T> types.
+ * String used to store the original ValueTag in Inject<T> types.
  * This prevents property name collisions while allowing type-level extraction.
  */
-declare const InjectSource: unique symbol;
+declare const InjectSource = "sandly/InjectSource";
 /**
  * Helper type for injecting ValueTag dependencies in constructor parameters.
  * This allows clean specification of ValueTag dependencies while preserving
@@ -549,7 +549,7 @@ interface IContainer<TReg extends AnyTag = never> {
  *   getUser() { return this.db.query(); }
  * }
  *
- * const c = Container.empty()
+ * const container = Container.empty()
  *   .register(DatabaseService, () => new DatabaseService())
  *   .register(UserService, async (ctx) =>
  *     new UserService(await ctx.resolve(DatabaseService))
@@ -563,7 +563,7 @@ interface IContainer<TReg extends AnyTag = never> {
  * const ApiKeyTag = Tag.of('apiKey')<string>();
  * const ConfigTag = Tag.of('config')<{ dbUrl: string }>();
  *
- * const c = Container.empty()
+ * const container = Container.empty()
  *   .register(ApiKeyTag, () => process.env.API_KEY!)
  *   .register(ConfigTag, () => ({ dbUrl: 'postgresql://localhost:5432' }));
  *
@@ -578,7 +578,7 @@ interface IContainer<TReg extends AnyTag = never> {
  *   async disconnect() { return; }
  * }
  *
- * const c = Container.empty().register(
+ * const container = Container.empty().register(
  *   DatabaseConnection,
  *   async () => {
  *     const conn = new DatabaseConnection();
@@ -596,6 +596,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
   readonly [ContainerTypeId]: {
     readonly _TReg: Contravariant<TReg>;
   };
+  protected constructor();
   /**
    * Cache of instantiated dependencies as promises.
    * Ensures singleton behavior and supports concurrent access.
@@ -617,6 +618,10 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    * @internal
    */
   protected isDestroyed: boolean;
+  /**
+   * Creates a new empty container instance.
+   * @returns A new empty Container instance with no registered dependencies.
+   */
   static empty(): Container<never>;
   /**
    * Registers a dependency in the container with a factory function and optional finalizer.
@@ -642,7 +647,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *   log(message: string) { console.log(message); }
    * }
    *
-   * const c = Container.empty().register(
+   * const container = Container.empty().register(
    *   LoggerService,
    *   () => new LoggerService()
    * );
@@ -654,7 +659,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *   constructor(private db: DatabaseService, private logger: LoggerService) {}
    * }
    *
-   * const c = Container.empty()
+   * const container = Container.empty()
    *   .register(DatabaseService, () => new DatabaseService())
    *   .register(LoggerService, () => new LoggerService())
    *   .register(UserService, async (ctx) =>
@@ -667,7 +672,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *
    * @example Overriding a dependency
    * ```typescript
-   * const c = Container.empty()
+   * const container = Container.empty()
    *   .register(DatabaseService, () => new DatabaseService())
    *   .register(DatabaseService, () => new MockDatabaseService()); // Overrides the previous registration
    * ```
@@ -676,7 +681,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    * ```typescript
    * const ConfigTag = Tag.of('config')<{ apiUrl: string }>();
    *
-   * const c = Container.empty().register(
+   * const container = Container.empty().register(
    *   ConfigTag,
    *   () => ({ apiUrl: 'https://api.example.com' })
    * );
@@ -689,7 +694,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *   async close() { return; }
    * }
    *
-   * const c = Container.empty().register(
+   * const container = Container.empty().register(
    *   DatabaseConnection,
    *   async () => {
    *     const conn = new DatabaseConnection();
@@ -712,7 +717,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *
    * @example
    * ```typescript
-   * const c = Container.empty().register(DatabaseService, () => new DatabaseService());
+   * const container = Container.empty().register(DatabaseService, () => new DatabaseService());
    * console.log(c.has(DatabaseService)); // true
    * ```
    */
@@ -743,7 +748,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *
    * @example Basic usage
    * ```typescript
-   * const c = Container.empty()
+   * const container = Container.empty()
    *   .register(DatabaseService, () => new DatabaseService());
    *
    * const db = await c.resolve(DatabaseService);
@@ -764,7 +769,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *
    * @example Dependency injection in factories
    * ```typescript
-   * const c = Container.empty()
+   * const container = Container.empty()
    *   .register(DatabaseService, () => new DatabaseService())
    *   .register(UserService, async (ctx) => {
    *     const db = await ctx.resolve(DatabaseService);
@@ -793,7 +798,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *
    * @example Basic usage
    * ```typescript
-   * const c = Container.empty()
+   * const container = Container.empty()
    *   .register(DatabaseService, () => new DatabaseService())
    *   .register(LoggerService, () => new LoggerService());
    *
@@ -803,7 +808,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    * @example Mixed tag types
    * ```typescript
    * const ApiKeyTag = Tag.of('apiKey')<string>();
-   * const c = Container.empty()
+   * const container = Container.empty()
    *   .register(ApiKeyTag, () => 'secret-key')
    *   .register(UserService, () => new UserService());
    *
@@ -872,7 +877,7 @@ declare class Container<TReg extends AnyTag> implements IContainer<TReg> {
    *
    * @example Basic cleanup
    * ```typescript
-   * const c = Container.empty()
+   * const container = Container.empty()
    *   .register(DatabaseConnection,
    *     async () => {
    *       const conn = new DatabaseConnection();
@@ -995,7 +1000,7 @@ declare class ContainerDestroyedError extends ContainerError {}
  *
  * @example
  * ```typescript
- * const c = Container.empty(); // Empty container
+ * const container = Container.empty(); // Empty container
  *
  * try {
  *   await c.resolve(UnregisteredService); // This will throw
@@ -1027,7 +1032,7 @@ declare class UnknownDependencyError extends ContainerError {
  * class ServiceA extends Tag.Service('ServiceA') {}
  * class ServiceB extends Tag.Service('ServiceB') {}
  *
- * const c = Container.empty()
+ * const container = Container.empty()
  *   .register(ServiceA, async (ctx) =>
  *     new ServiceA(await ctx.resolve(ServiceB)) // Depends on B
  *   )
@@ -1065,7 +1070,7 @@ declare class CircularDependencyError extends ContainerError {
  * ```typescript
  * class DatabaseService extends Tag.Service('DatabaseService') {}
  *
- * const c = Container.empty().register(DatabaseService, () => {
+ * const container = Container.empty().register(DatabaseService, () => {
  *   throw new Error('Database connection failed');
  * });
  *
@@ -1163,7 +1168,7 @@ declare const LayerTypeId: unique symbol;
  * );
  *
  * // Apply the layer to a container
- * const c = Container.empty();
+ * const container = Container.empty();
  * const finalContainer = databaseLayer.register(c);
  *
  * const db = await finalContainer.resolve(DatabaseService);
@@ -1204,7 +1209,7 @@ interface Layer<TRequires extends AnyTag, TProvides extends AnyTag> {
    *
    * @example Basic usage
    * ```typescript
-   * const c = Container.empty();
+   * const container = Container.empty();
    * const updatedContainer = myLayer.register(c);
    * ```
    *
@@ -1505,6 +1510,11 @@ declare class ScopedContainer<TReg extends AnyTag> extends Container<TReg> {
   private parent;
   private readonly children;
   protected constructor(parent: IContainer<TReg> | null, scope: Scope);
+  /**
+   * Creates a new empty scoped container instance.
+   * @param scope - The scope identifier for this container
+   * @returns A new empty ScopedContainer instance with no registered dependencies
+   */
   static empty(scope: Scope): ScopedContainer<never>;
   /**
    * Registers a dependency in the scoped container.
@@ -1630,7 +1640,7 @@ type ConstructorParams<T extends ServiceTag<TagId, unknown>> = T extends (new (.
  * @internal
  */
 type ExtractConstructorDeps<T extends readonly unknown[]> = T extends readonly [] ? never : { [K in keyof T]: T[K] extends {
-  readonly [ServiceTagIdKey]: infer Id;
+  readonly [ServiceTagIdKey]?: infer Id;
 } ? Id extends TagId ? ServiceTag<Id, T[K]> : never : ExtractInjectTag<T[K]> extends never ? never : ExtractInjectTag<T[K]> }[number];
 /**
  * Produces an ordered tuple of constructor parameters
@@ -1638,7 +1648,9 @@ type ExtractConstructorDeps<T extends readonly unknown[]> = T extends readonly [
  * while non‑DI parameters are preserved as‑is.
  * @internal
  */
-
+type InferConstructorDepsTuple<T extends readonly unknown[]> = T extends readonly [] ? never : { [K in keyof T]: T[K] extends {
+  readonly [ServiceTagIdKey]?: infer Id;
+} ? Id extends TagId ? ServiceTag<Id, T[K]> : never : ExtractInjectTag<T[K]> extends never ? T[K] : ExtractInjectTag<T[K]> };
 /**
  * Union of all dependency tags a ServiceTag constructor requires.
  * Filters out non‑DI parameters.
@@ -1648,7 +1660,7 @@ type ServiceDependencies<T extends ServiceTag<TagId, unknown>> = ExtractConstruc
  * Ordered tuple of dependency tags (and other constructor params)
  * inferred from a ServiceTag’s constructor.
  */
-
+type ServiceDepsTuple<T extends ServiceTag<TagId, unknown>> = InferConstructorDepsTuple<ConstructorParams<T>>;
 /**
  * Creates a service layer from any tag type (ServiceTag or ValueTag) with optional parameters.
  *
@@ -1693,6 +1705,14 @@ type ServiceDependencies<T extends ServiceTag<TagId, unknown>> = ExtractConstruc
  * ```
  */
 declare function service<T extends ServiceTag<TagId, unknown>>(tag: T, spec: DependencySpec<T, ServiceDependencies<T>>): Layer<ServiceDependencies<T>, T>;
+/**
+ * Specification for autoService.
+ * Can be either a tuple of constructor parameters or an object with dependencies and finalizer.
+ */
+type AutoServiceSpec<T extends ServiceTag<TagId, unknown>> = ServiceDepsTuple<T> | {
+  dependencies: ServiceDepsTuple<T>;
+  finalizer?: Finalizer<TagType<T>>;
+};
 /**
  * Creates a service layer with automatic dependency injection by inferring constructor parameters.
  *
@@ -1784,11 +1804,14 @@ declare function service<T extends ServiceTag<TagId, unknown>>(tag: T, spec: Dep
  * // Service with automatic cleanup
  * const dbService = autoService(
  *   DatabaseService,
- *   ['postgresql://localhost:5432/mydb'],
- *   (service) => service.disconnect() // Finalizer for cleanup
+ * 	 {
+ * 		dependencies: ['postgresql://localhost:5432/mydb'],
+ * 		finalizer: (service) => service.disconnect() // Finalizer for cleanup
+ * 	 }
  * );
  * ```
  */
+declare function autoService<T extends ServiceTag<TagId, unknown>>(tag: T, spec: AutoServiceSpec<T>): Layer<ServiceDependencies<T>, T>;
 //#endregion
 //#region src/value.d.ts
 /**
@@ -1811,4 +1834,4 @@ declare function service<T extends ServiceTag<TagId, unknown>>(tag: T, spec: Dep
  */
 declare function value<Id extends TagId, T>(tag: ValueTag<Id, T>, constantValue: T): Layer<never, ValueTag<Id, T>>;
 //#endregion
-export { type AnyLayer, type AnyTag, CircularDependencyError, Container, ContainerDestroyedError, ContainerError, DependencyAlreadyInstantiatedError, DependencyCreationError, DependencyFinalizationError, type DependencyLifecycle, type DependencySpec, type Factory, type Finalizer, type IContainer, type Inject, InjectSource, Layer, type PromiseOrValue, type ResolutionContext, type Scope, ScopedContainer, type ServiceTag, Tag, type TagType, UnknownDependencyError, type ValueTag, layer, scoped, service, value };
+export { type AnyLayer, type AnyTag, CircularDependencyError, Container, ContainerDestroyedError, ContainerError, DependencyAlreadyInstantiatedError, DependencyCreationError, DependencyFinalizationError, type DependencyLifecycle, type DependencySpec, type Factory, type Finalizer, type IContainer, type Inject, InjectSource, Layer, type PromiseOrValue, type ResolutionContext, type Scope, ScopedContainer, type ServiceDependencies, type ServiceDepsTuple, type ServiceTag, Tag, type TagType, UnknownDependencyError, type ValueTag, autoService, layer, scoped, service, value };

package/dist/index.js

@@ -24,15 +24,15 @@ function getKey(obj, ...keys) {
 *
 * @internal
 */
-const ValueTagIdKey = "__sandly/ValueTagIdKey__";
-const ServiceTagIdKey = "__sandly/ServiceTagIdKey__";
+const ValueTagIdKey = "sandly/ValueTagIdKey";
+const ServiceTagIdKey = "sandly/ServiceTagIdKey";
 /**
-* Internal symbol used to identify the type of a tagged type within the dependency injection system.
-* This symbol is used as a property key to attach metadata to both value tags and service tags.
+* Internal string used to identify the type of a tagged type within the dependency injection system.
+* This string is used as a property key to attach metadata to both value tags and service tags.
 * It is used to carry the type of the tagged type and should not be used directly.
 * @internal
 */
-const TagTypeKey = Symbol.for("sandly/TagTypeKey");
+const TagTypeKey = "sandly/TagTypeKey";
 /**
 * Utility object containing factory functions for creating dependency tags.
 *
@@ -68,10 +68,10 @@ const Tag = {
 	}
 };
 /**
-* Unique symbol used to store the original ValueTag in Inject<T> types.
+* String used to store the original ValueTag in Inject<T> types.
 * This prevents property name collisions while allowing type-level extraction.
 */
-const InjectSource = Symbol("InjectSource");
+const InjectSource = "sandly/InjectSource";
 
 //#endregion
 //#region src/errors.ts
@@ -149,7 +149,7 @@ var ContainerDestroyedError = class extends ContainerError {};
 *
 * @example
 * ```typescript
-* const c = Container.empty(); // Empty container
+* const container = Container.empty(); // Empty container
 *
 * try {
 *   await c.resolve(UnregisteredService); // This will throw
@@ -183,7 +183,7 @@ var UnknownDependencyError = class extends ContainerError {
 * class ServiceA extends Tag.Service('ServiceA') {}
 * class ServiceB extends Tag.Service('ServiceB') {}
 *
-* const c = Container.empty()
+* const container = Container.empty()
 *   .register(ServiceA, async (ctx) =>
 *     new ServiceA(await ctx.resolve(ServiceB)) // Depends on B
 *   )
@@ -227,7 +227,7 @@ var CircularDependencyError = class extends ContainerError {
 * ```typescript
 * class DatabaseService extends Tag.Service('DatabaseService') {}
 *
-* const c = Container.empty().register(DatabaseService, () => {
+* const container = Container.empty().register(DatabaseService, () => {
 *   throw new Error('Database connection failed');
 * });
 *
@@ -324,7 +324,7 @@ const ContainerTypeId = Symbol.for("sandly/Container");
 *   getUser() { return this.db.query(); }
 * }
 *
-* const c = Container.empty()
+* const container = Container.empty()
 *   .register(DatabaseService, () => new DatabaseService())
 *   .register(UserService, async (ctx) =>
 *     new UserService(await ctx.resolve(DatabaseService))
@@ -338,7 +338,7 @@ const ContainerTypeId = Symbol.for("sandly/Container");
 * const ApiKeyTag = Tag.of('apiKey')<string>();
 * const ConfigTag = Tag.of('config')<{ dbUrl: string }>();
 *
-* const c = Container.empty()
+* const container = Container.empty()
 *   .register(ApiKeyTag, () => process.env.API_KEY!)
 *   .register(ConfigTag, () => ({ dbUrl: 'postgresql://localhost:5432' }));
 *
@@ -353,7 +353,7 @@ const ContainerTypeId = Symbol.for("sandly/Container");
 *   async disconnect() { return; }
 * }
 *
-* const c = Container.empty().register(
+* const container = Container.empty().register(
 *   DatabaseConnection,
 *   async () => {
 *     const conn = new DatabaseConnection();
@@ -369,6 +369,7 @@ const ContainerTypeId = Symbol.for("sandly/Container");
 */
 var Container = class Container {
 	[ContainerTypeId];
+	constructor() {}
 	/**
 	* Cache of instantiated dependencies as promises.
 	* Ensures singleton behavior and supports concurrent access.
@@ -390,6 +391,10 @@ var Container = class Container {
 	* @internal
 	*/
 	isDestroyed = false;
+	/**
+	* Creates a new empty container instance.
+	* @returns A new empty Container instance with no registered dependencies.
+	*/
 	static empty() {
 		return new Container();
 	}
@@ -417,7 +422,7 @@ var Container = class Container {
 	*   log(message: string) { console.log(message); }
 	* }
 	*
-	* const c = Container.empty().register(
+	* const container = Container.empty().register(
 	*   LoggerService,
 	*   () => new LoggerService()
 	* );
@@ -429,7 +434,7 @@ var Container = class Container {
 	*   constructor(private db: DatabaseService, private logger: LoggerService) {}
 	* }
 	*
-	* const c = Container.empty()
+	* const container = Container.empty()
 	*   .register(DatabaseService, () => new DatabaseService())
 	*   .register(LoggerService, () => new LoggerService())
 	*   .register(UserService, async (ctx) =>
@@ -442,7 +447,7 @@ var Container = class Container {
 	*
 	* @example Overriding a dependency
 	* ```typescript
-	* const c = Container.empty()
+	* const container = Container.empty()
 	*   .register(DatabaseService, () => new DatabaseService())
 	*   .register(DatabaseService, () => new MockDatabaseService()); // Overrides the previous registration
 	* ```
@@ -451,7 +456,7 @@ var Container = class Container {
 	* ```typescript
 	* const ConfigTag = Tag.of('config')<{ apiUrl: string }>();
 	*
-	* const c = Container.empty().register(
+	* const container = Container.empty().register(
 	*   ConfigTag,
 	*   () => ({ apiUrl: 'https://api.example.com' })
 	* );
@@ -464,7 +469,7 @@ var Container = class Container {
 	*   async close() { return; }
 	* }
 	*
-	* const c = Container.empty().register(
+	* const container = Container.empty().register(
 	*   DatabaseConnection,
 	*   async () => {
 	*     const conn = new DatabaseConnection();
@@ -498,7 +503,7 @@ var Container = class Container {
 	*
 	* @example
 	* ```typescript
-	* const c = Container.empty().register(DatabaseService, () => new DatabaseService());
+	* const container = Container.empty().register(DatabaseService, () => new DatabaseService());
 	* console.log(c.has(DatabaseService)); // true
 	* ```
 	*/
@@ -533,7 +538,7 @@ var Container = class Container {
 	*
 	* @example Basic usage
 	* ```typescript
-	* const c = Container.empty()
+	* const container = Container.empty()
 	*   .register(DatabaseService, () => new DatabaseService());
 	*
 	* const db = await c.resolve(DatabaseService);
@@ -554,7 +559,7 @@ var Container = class Container {
 	*
 	* @example Dependency injection in factories
 	* ```typescript
-	* const c = Container.empty()
+	* const container = Container.empty()
 	*   .register(DatabaseService, () => new DatabaseService())
 	*   .register(UserService, async (ctx) => {
 	*     const db = await ctx.resolve(DatabaseService);
@@ -604,7 +609,7 @@ var Container = class Container {
 	*
 	* @example Basic usage
 	* ```typescript
-	* const c = Container.empty()
+	* const container = Container.empty()
 	*   .register(DatabaseService, () => new DatabaseService())
 	*   .register(LoggerService, () => new LoggerService());
 	*
@@ -614,7 +619,7 @@ var Container = class Container {
 	* @example Mixed tag types
 	* ```typescript
 	* const ApiKeyTag = Tag.of('apiKey')<string>();
-	* const c = Container.empty()
+	* const container = Container.empty()
 	*   .register(ApiKeyTag, () => 'secret-key')
 	*   .register(UserService, () => new UserService());
 	*
@@ -704,7 +709,7 @@ var Container = class Container {
 	*
 	* @example Basic cleanup
 	* ```typescript
-	* const c = Container.empty()
+	* const container = Container.empty()
 	*   .register(DatabaseConnection,
 	*     async () => {
 	*       const conn = new DatabaseConnection();
@@ -907,6 +912,11 @@ var ScopedContainer = class ScopedContainer extends Container {
 		this.parent = parent;
 		this.scope = scope;
 	}
+	/**
+	* Creates a new empty scoped container instance.
+	* @param scope - The scope identifier for this container
+	* @returns A new empty ScopedContainer instance with no registered dependencies
+	*/
 	static empty(scope) {
 		return new ScopedContainer(null, scope);
 	}
@@ -1109,6 +1119,122 @@ function service(tag, spec) {
 		return container.register(tag, spec);
 	});
 }
+/**
+* Creates a service layer with automatic dependency injection by inferring constructor parameters.
+*
+* This is a convenience function that automatically resolves constructor dependencies and passes
+* both DI-managed dependencies and static values to the service constructor in the correct order.
+* It eliminates the need to manually write factory functions for services with constructor dependencies.
+*
+* @template T - The ServiceTag representing the service class
+* @param tag - The service tag (must be a ServiceTag, not a ValueTag)
+* @param deps - Tuple of constructor parameters in order - mix of dependency tags and static values
+* @param finalizer - Optional cleanup function called when the container is destroyed
+* @returns A service layer that automatically handles dependency injection
+*
+* @example Simple service with dependencies
+* ```typescript
+* class DatabaseService extends Tag.Service('DatabaseService') {
+*   constructor(private url: string) {
+*     super();
+*   }
+*   connect() { return `Connected to ${this.url}`; }
+* }
+*
+* class UserService extends Tag.Service('UserService') {
+*   constructor(private db: DatabaseService, private timeout: number) {
+*     super();
+*   }
+*   getUsers() { return this.db.query('SELECT * FROM users'); }
+* }
+*
+* // Automatically inject DatabaseService and pass static timeout value
+* const userService = autoService(UserService, [DatabaseService, 5000]);
+* ```
+*
+* @example Mixed dependencies and static values
+* ```typescript
+* class NotificationService extends Tag.Service('NotificationService') {
+*   constructor(
+*     private logger: LoggerService,
+*     private apiKey: string,
+*     private retries: number,
+*     private cache: CacheService
+*   ) {
+*     super();
+*   }
+* }
+*
+* // Mix of DI tags and static values in constructor order
+* const notificationService = autoService(NotificationService, [
+*   LoggerService,    // Will be resolved from container
+*   'secret-api-key', // Static string value
+*   3,                // Static number value
+*   CacheService      // Will be resolved from container
+* ]);
+* ```
+*
+* @example Compared to manual service creation
+* ```typescript
+* // Manual approach (more verbose)
+* const userServiceManual = service(UserService, async (ctx) => {
+*   const db = await ctx.resolve(DatabaseService);
+*   return new UserService(db, 5000);
+* });
+*
+* // Auto approach (concise)
+* const userServiceAuto = autoService(UserService, [DatabaseService, 5000]);
+* ```
+*
+* @example With finalizer for cleanup
+* ```typescript
+* class DatabaseService extends Tag.Service('DatabaseService') {
+*   constructor(private connectionString: string) {
+*     super();
+*   }
+*
+*   private connection: Connection | null = null;
+*
+*   async connect() {
+*     this.connection = await createConnection(this.connectionString);
+*   }
+*
+*   async disconnect() {
+*     if (this.connection) {
+*       await this.connection.close();
+*       this.connection = null;
+*     }
+*   }
+* }
+*
+* // Service with automatic cleanup
+* const dbService = autoService(
+*   DatabaseService,
+* 	 {
+* 		dependencies: ['postgresql://localhost:5432/mydb'],
+* 		finalizer: (service) => service.disconnect() // Finalizer for cleanup
+* 	 }
+* );
+* ```
+*/
+function autoService(tag, spec) {
+	if (Array.isArray(spec)) spec = { dependencies: spec };
+	const factory = async (ctx) => {
+		const diDeps = [];
+		for (const dep of spec.dependencies) if (Tag.isTag(dep)) diDeps.push(dep);
+		const resolved = await ctx.resolveAll(...diDeps);
+		const args = [];
+		let resolvedIndex = 0;
+		for (const dep of spec.dependencies) if (Tag.isTag(dep)) args.push(resolved[resolvedIndex++]);
+		else args.push(dep);
+		return new tag(...args);
+	};
+	const finalSpec = spec.finalizer ? {
+		factory,
+		finalizer: spec.finalizer
+	} : factory;
+	return service(tag, finalSpec);
+}
 
 //#endregion
 //#region src/value.ts
@@ -1135,4 +1261,4 @@ function value(tag, constantValue) {
 }
 
 //#endregion
-export { CircularDependencyError, Container, ContainerDestroyedError, ContainerError, DependencyAlreadyInstantiatedError, DependencyCreationError, DependencyFinalizationError, InjectSource, Layer, ScopedContainer, Tag, UnknownDependencyError, layer, scoped, service, value };
+export { CircularDependencyError, Container, ContainerDestroyedError, ContainerError, DependencyAlreadyInstantiatedError, DependencyCreationError, DependencyFinalizationError, InjectSource, Layer, ScopedContainer, Tag, UnknownDependencyError, autoService, layer, scoped, service, value };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandly",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "keywords": [
     "typescript",
     "sandly",