getbox 1.1.0 → 1.2.0

package/README.md

@@ -172,6 +172,23 @@ const ApiUrl = factory((box: Box) => {
 const apiUrl = box.get(ApiUrl); // "https://example.com/api"
 ```
 
+## Transient factories
+
+Use the `transient` helper to create a factory whose result is never cached. The factory is called on every resolution, even when retrieved via `box.get()`.
+
+```ts
+import { Box, transient } from "getbox";
+
+const RequestId = transient(() => crypto.randomUUID());
+
+const box = new Box();
+
+const id1 = box.get(RequestId);
+const id2 = box.get(RequestId);
+
+console.log(id1 === id2); // false
+```
+
 ## Resolving multiple constructors
 
 Use `box.all.get()` to resolve multiple constructors at once. Pass an object to get an object of instances, or an array to get an array of instances.

package/dist/index.cjs

@@ -16,7 +16,26 @@
 function factory(init) {
 	return { init };
 }
-const constantSymbol = Symbol("Box constant");
+const noCacheSymbol = Symbol("Box constant");
+/**
+* Creates a {@link Constructor} from a factory function whose result is never cached.
+* The factory is called on every resolution, always returning a fresh value
+* even when retrieved via {@link Box.get}.
+*
+* @example
+* ```ts
+* const RequestId = transient(() => crypto.randomUUID());
+* const id1 = box.get(RequestId);
+* const id2 = box.get(RequestId);
+* console.log(id1 === id2); // false
+* ```
+*/
+function transient(init) {
+	return {
+		init,
+		[noCacheSymbol]: true
+	};
+}
 /**
 * Creates a {@link Constructor} that always resolves to the given constant value.
 * Constant values are never cached since they are already fixed.
@@ -30,7 +49,7 @@ const constantSymbol = Symbol("Box constant");
 function constant(value) {
 	return {
 		init: () => value,
-		[constantSymbol]: true
+		[noCacheSymbol]: true
 	};
 }
 /**
@@ -79,7 +98,7 @@ var Box = class {
 	get(constructor) {
 		if (this.cache.has(constructor)) return this.cache.get(constructor);
 		const value = this.new(constructor);
-		if (!(constantSymbol in constructor && constructor[constantSymbol])) this.cache.set(constructor, value);
+		if (!(noCacheSymbol in constructor && constructor[noCacheSymbol])) this.cache.set(constructor, value);
 		return value;
 	}
 	/** Resolves multiple constructors at once. */
@@ -183,4 +202,5 @@ var Construct = class {
 exports.Box = Box;
 exports.Construct = Construct;
 exports.constant = constant;
-exports.factory = factory;
+exports.factory = factory;
+exports.transient = transient;

package/dist/index.d.cts

@@ -25,6 +25,20 @@ type ConstructorInstanceType<T> = T extends Constructor<infer U> ? U : never;
  * ```
  */
 declare function factory<T>(init: (box: Box) => T): Constructor<T>;
+/**
+ * Creates a {@link Constructor} from a factory function whose result is never cached.
+ * The factory is called on every resolution, always returning a fresh value
+ * even when retrieved via {@link Box.get}.
+ *
+ * @example
+ * ```ts
+ * const RequestId = transient(() => crypto.randomUUID());
+ * const id1 = box.get(RequestId);
+ * const id2 = box.get(RequestId);
+ * console.log(id1 === id2); // false
+ * ```
+ */
+declare function transient<T>(init: (box: Box) => T): Constructor<T>;
 /**
  * Creates a {@link Constructor} that always resolves to the given constant value.
  * Constant values are never cached since they are already fixed.
@@ -166,4 +180,4 @@ type ClassConstructor<T> = {
 /** Maps each constructor parameter to its corresponding {@link Constructor} type. */
 type ClassConstructorArgs<T extends ClassConstructor<any>, Args = ConstructorParameters<T>> = { [K in keyof Args]: Constructor<Args[K]> };
 //#endregion
-export { Box, Construct, Constructor, ConstructorInstanceType, constant, factory };
+export { Box, Construct, Constructor, ConstructorInstanceType, constant, factory, transient };

package/dist/index.d.mts

@@ -25,6 +25,20 @@ type ConstructorInstanceType<T> = T extends Constructor<infer U> ? U : never;
  * ```
  */
 declare function factory<T>(init: (box: Box) => T): Constructor<T>;
+/**
+ * Creates a {@link Constructor} from a factory function whose result is never cached.
+ * The factory is called on every resolution, always returning a fresh value
+ * even when retrieved via {@link Box.get}.
+ *
+ * @example
+ * ```ts
+ * const RequestId = transient(() => crypto.randomUUID());
+ * const id1 = box.get(RequestId);
+ * const id2 = box.get(RequestId);
+ * console.log(id1 === id2); // false
+ * ```
+ */
+declare function transient<T>(init: (box: Box) => T): Constructor<T>;
 /**
  * Creates a {@link Constructor} that always resolves to the given constant value.
  * Constant values are never cached since they are already fixed.
@@ -166,4 +180,4 @@ type ClassConstructor<T> = {
 /** Maps each constructor parameter to its corresponding {@link Constructor} type. */
 type ClassConstructorArgs<T extends ClassConstructor<any>, Args = ConstructorParameters<T>> = { [K in keyof Args]: Constructor<Args[K]> };
 //#endregion
-export { Box, Construct, Constructor, ConstructorInstanceType, constant, factory };
+export { Box, Construct, Constructor, ConstructorInstanceType, constant, factory, transient };

package/dist/index.mjs

@@ -15,7 +15,26 @@
 function factory(init) {
 	return { init };
 }
-const constantSymbol = Symbol("Box constant");
+const noCacheSymbol = Symbol("Box constant");
+/**
+* Creates a {@link Constructor} from a factory function whose result is never cached.
+* The factory is called on every resolution, always returning a fresh value
+* even when retrieved via {@link Box.get}.
+*
+* @example
+* ```ts
+* const RequestId = transient(() => crypto.randomUUID());
+* const id1 = box.get(RequestId);
+* const id2 = box.get(RequestId);
+* console.log(id1 === id2); // false
+* ```
+*/
+function transient(init) {
+	return {
+		init,
+		[noCacheSymbol]: true
+	};
+}
 /**
 * Creates a {@link Constructor} that always resolves to the given constant value.
 * Constant values are never cached since they are already fixed.
@@ -29,7 +48,7 @@ const constantSymbol = Symbol("Box constant");
 function constant(value) {
 	return {
 		init: () => value,
-		[constantSymbol]: true
+		[noCacheSymbol]: true
 	};
 }
 /**
@@ -78,7 +97,7 @@ var Box = class {
 	get(constructor) {
 		if (this.cache.has(constructor)) return this.cache.get(constructor);
 		const value = this.new(constructor);
-		if (!(constantSymbol in constructor && constructor[constantSymbol])) this.cache.set(constructor, value);
+		if (!(noCacheSymbol in constructor && constructor[noCacheSymbol])) this.cache.set(constructor, value);
 		return value;
 	}
 	/** Resolves multiple constructors at once. */
@@ -179,4 +198,4 @@ var Construct = class {
 };
 
 //#endregion
-export { Box, Construct, constant, factory };
+export { Box, Construct, constant, factory, transient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getbox",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Lightweight dependency injection for TypeScript",
   "private": false,
   "main": "./dist/index.cjs",