alepha 0.20.3 → 0.20.4

package/dist/core/index.native.js

@@ -1,8 +1,8 @@
 import { Type } from "typebox";
 import Format from "typebox/format";
 import { Settings } from "typebox/system";
-import * as Value from "typebox/value";
 import { Compile } from "typebox/compile";
+import * as Value from "typebox/value";
 import { createMiddleware as createMiddleware$1 } from "alepha";
 //#region ../../src/core/constants/KIND.ts
 /**
@@ -115,6 +115,24 @@ const __alephaRef = {};
 *
 * One main goal of Alepha is working with classes but without the class verbosity.
 * Forcing to pass Alepha instance in constructors would be a step back in that direction!
+*
+* ---------------------------------------------------------------------------------------------------------------------
+*
+* TODO: harden the cursor against mid-instantiation throws.
+*
+* Today, the cleanup of `__alephaRef.alepha`, `__alephaRef.service`, `__alephaRef.parent`
+* is performed by the caller after the synchronous instantiation returns. If the
+* instantiation throws (e.g., a primitive factory blows up, or a user constructor
+* raises), the cursor can be left holding stale references until the next
+* instantiation overwrites them. In practice this is harmless because Alepha is
+* single-threaded synchronous during boot and the next inject() rewrites the
+* cursor — but it is a sharp edge for debuggers (frame inspection shows ghost
+* state) and any future tooling that introspects __alephaRef out-of-band.
+*
+* Plan: wrap each cursor mutation in Alepha.ts in a try/finally that snapshots
+* the previous value and restores it on exit (even on throw). Equivalent to a
+* lexically-scoped "with" — pushes/pops cleanly. Should be a 5-line refactor in
+* Alepha.ts:1131-1132 once we touch it.
 */
 //#endregion
 //#region ../../src/core/primitives/$context.ts
@@ -1356,6 +1374,12 @@ var SchemaValidator = class {
 			throw error;
 		}
 	}
+	/**
+	* Deep clone a schema. Useful when a schema is going to be mutated.
+	*/
+	clone(schema) {
+		return Value.Clone(schema);
+	}
 	getValidator(schema) {
 		if (this.cache.has(schema)) return this.cache.get(schema);
 		const validator = Compile(schema);
@@ -2446,7 +2470,7 @@ var Alepha = class Alepha {
 		return this;
 	}
 	/**
-	* Alias for {@link Alepha#with}.
+	* @alias {@link Alepha#with}.
 	*/
 	register(serviceEntry) {
 		return this.with(serviceEntry);
@@ -3307,6 +3331,6 @@ const run = (entry, opts) => {
 	return alepha;
 };
 //#endregion
-export { $atom, $context, $env, $hook, $inject, $memoize, $mode, $module, $pipeline, $scope, $state, ALS_PARENT, Alepha, AlephaError, AlsProvider, AppNotStartedError, Atom, CircularDependencyError, CodecManager, ContainerLockedError, EventManager, Format, HookPrimitive, InjectPrimitive, Json, JsonSchemaCodec, KIND, KeylessJsonSchemaCodec, Module, OPTIONS, PipelineHandler, PipelinePrimitive, Primitive, SchemaCodec, StateManager, TooLateSubstitutionError, Type, TypeBoxError, TypeGuard, TypeProvider, Value, __alephaRef, createMiddleware, createPagination, createPrimitive, isClass, isFileLike, isTypeFile, jsonSchemaToTypeBox, pageMetadataSchema, pageQuerySchema, pageSchema, run, t };
+export { $atom, $context, $env, $hook, $inject, $memoize, $mode, $module, $pipeline, $scope, $state, ALS_PARENT, Alepha, AlephaError, AlsProvider, AppNotStartedError, Atom, CircularDependencyError, CodecManager, ContainerLockedError, EventManager, Format, HookPrimitive, InjectPrimitive, Json, JsonSchemaCodec, KIND, KeylessJsonSchemaCodec, Module, OPTIONS, PipelineHandler, PipelinePrimitive, Primitive, SchemaCodec, SchemaValidator, StateManager, TooLateSubstitutionError, Type, TypeBoxError, TypeGuard, TypeProvider, __alephaRef, createMiddleware, createPagination, createPrimitive, isClass, isFileLike, isTypeFile, jsonSchemaToTypeBox, pageMetadataSchema, pageQuerySchema, pageSchema, run, t };
 
 //# sourceMappingURL=index.native.js.map