@warlock.js/core 5.31.0 → 5.32.0

package/esm/storage/utils/storage-capability-error.d.mts

@@ -1,5 +1,4 @@
 import { StorageError } from "./storage-error.mjs";
-
 //#region ../../packages/core/src/storage/utils/storage-capability-error.d.ts
 /**
  * Thrown when an operation needs an optional driver capability that the
@@ -9,7 +8,7 @@ import { StorageError } from "./storage-error.mjs";
  * Callers can probe first (`storage.supportsPutIfAbsent()`) or branch on
  * `instanceof StorageCapabilityError`.
  */
-declare class StorageCapabilityError extends StorageError {
+export declare class StorageCapabilityError extends StorageError {
   /**
    * The missing capability (e.g. "putIfAbsent").
    */
@@ -21,5 +20,4 @@ declare class StorageCapabilityError extends StorageError {
   constructor(capability: string, driverName: string);
 }
 //#endregion
-export { StorageCapabilityError };
 //# sourceMappingURL=storage-capability-error.d.mts.map

package/esm/storage/utils/storage-capability-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-capability-error.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/storage-capability-error.ts"],"mappings":";;;;;AAUA;;;;;;cAAa,sBAAA,SAA+B,YAAY;;;;WAItC,UAAA;EAOyC;;;EAAA,SAFzC,UAAA;cAEG,UAAA,UAAoB,UAAA;AAAA"}
+{"version":3,"file":"storage-capability-error.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/storage-capability-error.ts"],"mappings":";;;;;;;;;;qBAUa,+BAA+B;;;;WAI1B;;;;WAKA;EAEhB,YAAmB,oBAAoB"}

package/esm/storage/utils/storage-error.d.mts

@@ -11,7 +11,7 @@
  * mirroring the convention used by `@warlock.js/ai`'s error classes — it is
  * for logs and telemetry, treated as opaque by consumers.
  */
-type StorageErrorOptions = {
+export type StorageErrorOptions = {
   cause?: unknown;
   context?: Record<string, unknown>;
 };
@@ -19,7 +19,7 @@ type StorageErrorOptions = {
  * Error thrown by storage drivers for refused or invalid operations
  * (path-traversal attempts, blocked outbound fetches, oversized downloads).
  */
-declare class StorageError extends Error {
+export declare class StorageError extends Error {
   /**
    * Optional original thrown value preserved through re-wrapping.
    */
@@ -31,5 +31,4 @@ declare class StorageError extends Error {
   constructor(message: string, options?: StorageErrorOptions);
 }
 //#endregion
-export { StorageError, StorageErrorOptions };
 //# sourceMappingURL=storage-error.d.mts.map

package/esm/storage/utils/storage-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-error.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/storage-error.ts"],"mappings":";;AAYA;;;;;;;;AAEkB;AAOlB;;KATY,mBAAA;EACV,KAAA;EACA,OAAA,GAAU,MAAM;AAAA;;;;;cAOL,YAAA,SAAqB,KAAA;EASN;;;EAAA,SALV,KAAA;EAOoB;;AAA6B;EAA7B,SAFpB,OAAA,GAAU,MAAA;cAEP,OAAA,UAAiB,OAAA,GAAU,mBAAA;AAAA"}
+{"version":3,"file":"storage-error.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/storage-error.ts"],"mappings":";;;;;;;;;;;;;YAYY;EACV;EACA,UAAU;;;;;;qBAOC,qBAAqB;;;;WAIhB;;;;WAKA,UAAU;EAE1B,YAAmB,iBAAiB,UAAU"}

package/esm/storage/utils/storage-not-initialized-error.d.mts

@@ -12,7 +12,7 @@
  * process, so `Storage#init()` was never called and `_driver` stayed
  * `null`. This error names that cause and the fix directly instead.
  */
-declare class StorageNotInitializedError extends Error {
+export declare class StorageNotInitializedError extends Error {
   /** Stable Warlock error code; `warlock explain WL2006` prints the fix. */
   readonly code = "WL2006";
   constructor(options?: {
@@ -20,5 +20,4 @@ declare class StorageNotInitializedError extends Error {
   });
 }
 //#endregion
-export { StorageNotInitializedError };
 //# sourceMappingURL=storage-not-initialized-error.d.mts.map

package/esm/storage/utils/storage-not-initialized-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-not-initialized-error.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/storage-not-initialized-error.ts"],"mappings":";;AAaA;;;;;;;;;;AAIkD;;cAJrC,0BAAA,SAAmC,KAAK;;WAEnC,IAAA;cAEG,OAAA;IAAY,KAAA;EAAA;AAAA"}
+{"version":3,"file":"storage-not-initialized-error.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/storage-not-initialized-error.ts"],"mappings":";;;;;;;;;;;;;;qBAaa,mCAAmC;;WAE9B;EAEhB,YAAmB;IAAY"}

package/esm/tests/authenticated-test-client.d.mts

@@ -1,21 +1,21 @@
 import { TestRequestClient, testDelete, testGet, testPatch, testPost, testPut, testRequest } from "./test-helpers.mjs";
-
 //#region ../../packages/core/src/tests/authenticated-test-client.d.ts
 /** Structural auth contract: an Auth model satisfies this without a runtime auth import. */
-interface TestAuthenticableUser {
+export interface TestAuthenticableUser {
   generateAccessToken(): Promise<{
     token: string;
   }>;
   removeAccessToken(token: string): Promise<void>;
 }
 /** An isolated HTTP client using one real issued access token. */
-type AuthenticatedTestClient = {
+export type AuthenticatedTestClient = {
   request: typeof testRequest;
   get: typeof testGet;
   post: typeof testPost;
   put: typeof testPut;
   patch: typeof testPatch;
-  delete: typeof testDelete; /** Revoke only this client's token; fixtures still own their user/data cleanup. */
+  delete: typeof testDelete;
+  /** Revoke only this client's token; fixtures still own their user/data cleanup. */
   dispose(): Promise<void>;
 };
 /**
@@ -26,7 +26,6 @@ type AuthenticatedTestClient = {
  * Requests go to the shared test server, or through `client` — e.g. the one
  * `createTestHttpServer()` returns (its own `actingAs()` passes it).
  */
-declare function actingAs(user: TestAuthenticableUser, client?: TestRequestClient): Promise<AuthenticatedTestClient>;
+export declare function actingAs(user: TestAuthenticableUser, client?: TestRequestClient): Promise<AuthenticatedTestClient>;
 //#endregion
-export { AuthenticatedTestClient, TestAuthenticableUser, actingAs };
 //# sourceMappingURL=authenticated-test-client.d.mts.map

package/esm/tests/authenticated-test-client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"authenticated-test-client.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/authenticated-test-client.ts"],"mappings":";;;;UAaiB,qBAAA;EACf,mBAAA,IAAuB,OAAA;IAAU,KAAA;EAAA;EACjC,iBAAA,CAAkB,KAAA,WAAgB,OAAO;AAAA;;KAI/B,uBAAA;EACV,OAAA,SAAgB,WAAA;EAChB,GAAA,SAAY,OAAA;EACZ,IAAA,SAAa,QAAA;EACb,GAAA,SAAY,OAAA;EACZ,KAAA,SAAc,SAAA;EACd,MAAA,SAAe,UAAA,EANkB;EAQjC,OAAA,IAAW,OAAA;AAAA;;;;;;;;;iBAWS,QAAA,CACpB,IAAA,EAAM,qBAAA,EACN,MAAA,GAAQ,iBAAA,GACP,OAAA,CAAQ,uBAAA"}
+{"version":3,"file":"authenticated-test-client.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/authenticated-test-client.ts"],"mappings":";;;iBAaiB;EACf,uBAAuB;IAAU;;EACjC,kBAAkB,gBAAgB;;;YAIxB;EACV,gBAAgB;EAChB,YAAY;EACZ,aAAa;EACb,YAAY;EACZ,cAAc;EACd,eAAe;;EAEf,WAAW;;;;;;;;;;wBAWS,SACpB,MAAM,uBACN,SAAQ,oBACP,QAAQ"}

package/esm/tests/factories.d.mts

@@ -1,41 +1,56 @@
 import { ChildModel, Model, ModelSchema } from "@warlock.js/cascade";
-
 //#region ../../packages/core/src/tests/factories.d.ts
 /** A model's schema type. */
 type SchemaOf<TModel extends Model> = TModel extends Model<infer TSchema> ? TSchema : ModelSchema;
 /** The attributes a model is created from: a partial of its schema, as `Model.create()` takes. */
-type FactoryAttributes<TModel extends Model> = Partial<SchemaOf<TModel>>;
+export type FactoryAttributes<TModel extends Model> = Partial<SchemaOf<TModel>>;
 /**
  * Deterministic values for one record, derived only from its sequence number:
  * the n-th record a factory builds is the same on every run, with no faker
  * and no randomness.
  */
-type FactorySeed = {
-  /** 1 for the first record this factory builds, 2 for the second, ... */readonly sequence: number; /** Position within the current `makeMany()` / `createMany()` call, from 0. */
-  readonly index: number; /** `"<prefix> <sequence>"`, e.g. `text("Post")` → `"Post 3"`. */
-  text(prefix?: string): string; /** `"<prefix><sequence>@example.test"`, e.g. `"user3@example.test"`. */
-  email(prefix?: string): string; /** A valid v4-shaped UUID numbered by the sequence. */
-  uuid(): string; /** 2026-01-01T00:00:00Z plus `offsetDays` days. */
-  date(offsetDays?: number): Date; /** An integer in `[min, max]`, cycling with the sequence. */
-  number(min?: number, max?: number): number; /** One of `values`, cycling with the sequence. */
+export type FactorySeed = {
+  /** 1 for the first record this factory builds, 2 for the second, ... */
+  readonly sequence: number;
+  /** Position within the current `makeMany()` / `createMany()` call, from 0. */
+  readonly index: number;
+  /** `"<prefix> <sequence>"`, e.g. `text("Post")` → `"Post 3"`. */
+  text(prefix?: string): string;
+  /** `"<prefix><sequence>@example.test"`, e.g. `"user3@example.test"`. */
+  email(prefix?: string): string;
+  /** A valid v4-shaped UUID numbered by the sequence. */
+  uuid(): string;
+  /** 2026-01-01T00:00:00Z plus `offsetDays` days. */
+  date(offsetDays?: number): Date;
+  /** An integer in `[min, max]`, cycling with the sequence. */
+  number(min?: number, max?: number): number;
+  /** One of `values`, cycling with the sequence. */
   pick<T>(values: readonly T[]): T;
 };
 /** Overrides: a partial, or a function of the seed returning one. */
-type FactoryOverrides<TAttributes> = Partial<TAttributes> | ((seed: FactorySeed) => Partial<TAttributes>);
+export type FactoryOverrides<TAttributes> = Partial<TAttributes> | ((seed: FactorySeed) => Partial<TAttributes>);
 /** A named variation, applied on top of the definition (and earlier states). */
-type FactoryState<TAttributes> = (seed: FactorySeed, attributes: TAttributes) => Partial<TAttributes>;
-type Factory<TModel extends Model, TAttributes = FactoryAttributes<TModel>> = {
-  /** Build attributes without saving anything — no database needed. */make(overrides?: FactoryOverrides<TAttributes>): TAttributes; /** Build `count` attribute sets without saving anything. */
-  makeMany(count: number, overrides?: FactoryOverrides<TAttributes>): TAttributes[]; /** Create and save one record through `Model.create()`. */
-  create(overrides?: FactoryOverrides<TAttributes>): Promise<TModel>; /** Create and save `count` records, one `Model.create()` each, in order. */
-  create(count: number, overrides?: FactoryOverrides<TAttributes>): Promise<TModel[]>; /** Same as `create(count, overrides)`. */
-  createMany(count: number, overrides?: FactoryOverrides<TAttributes>): Promise<TModel[]>; /** Register a named state on this factory; returns the factory for chaining. */
-  state(name: string, state: FactoryState<TAttributes>): Factory<TModel, TAttributes>; /** A factory that applies the named states, in order, on top of the definition. */
-  with(...states: string[]): Factory<TModel, TAttributes>; /** Restart this factory's sequence at 1. */
+export type FactoryState<TAttributes> = (seed: FactorySeed, attributes: TAttributes) => Partial<TAttributes>;
+export type Factory<TModel extends Model, TAttributes = FactoryAttributes<TModel>> = {
+  /** Build attributes without saving anything — no database needed. */
+  make(overrides?: FactoryOverrides<TAttributes>): TAttributes;
+  /** Build `count` attribute sets without saving anything. */
+  makeMany(count: number, overrides?: FactoryOverrides<TAttributes>): TAttributes[];
+  /** Create and save one record through `Model.create()`. */
+  create(overrides?: FactoryOverrides<TAttributes>): Promise<TModel>;
+  /** Create and save `count` records, one `Model.create()` each, in order. */
+  create(count: number, overrides?: FactoryOverrides<TAttributes>): Promise<TModel[]>;
+  /** Same as `create(count, overrides)`. */
+  createMany(count: number, overrides?: FactoryOverrides<TAttributes>): Promise<TModel[]>;
+  /** Register a named state on this factory; returns the factory for chaining. */
+  state(name: string, state: FactoryState<TAttributes>): Factory<TModel, TAttributes>;
+  /** A factory that applies the named states, in order, on top of the definition. */
+  with(...states: string[]): Factory<TModel, TAttributes>;
+  /** Restart this factory's sequence at 1. */
   resetSequence(): void;
 };
 /** Restart every factory's sequence, e.g. in `beforeEach`. */
-declare function resetFactorySequences(): void;
+export declare function resetFactorySequences(): void;
 /**
  * Define a model factory: deterministic attributes for tests and seeders.
  *
@@ -53,7 +68,7 @@ declare function resetFactorySequences(): void;
  * const admin = await userFactory.with("admin").create();
  * const users = await userFactory.create(3);
  */
-declare function defineFactory<TModel extends Model>(model: ChildModel<TModel>, definition: (seed: FactorySeed) => FactoryAttributes<TModel>): Factory<TModel>;
+export declare function defineFactory<TModel extends Model>(model: ChildModel<TModel>, definition: (seed: FactorySeed) => FactoryAttributes<TModel>): Factory<TModel>;
 //#endregion
-export { Factory, FactoryAttributes, FactoryOverrides, FactorySeed, FactoryState, defineFactory, resetFactorySequences };
+export {};
 //# sourceMappingURL=factories.d.mts.map

package/esm/tests/factories.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"factories.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/factories.ts"],"mappings":";;;;KAIK,QAAA,gBAAwB,KAAA,IAAS,MAAA,SAAe,KAAA,kBAAuB,OAAA,GAAU,WAAA;AAJZ;AAAA,KAO9D,iBAAA,gBAAiC,KAAA,IAAS,OAAA,CAAQ,QAAA,CAAS,MAAA;;;;;;KAO3D,WAAA;EAVqF,iFAYtF,QAAA,UAZkB;EAAA,SAclB,KAAA,UAd0C;EAgBnD,IAAA,CAAK,MAAA,oBAhBqE;EAkB1E,KAAA,CAAM,MAAA,oBAlByF;EAoB/F,IAAA,YAjBU;EAmBV,IAAA,CAAK,UAAA,YAAsB,IAAA,EAnBA;EAqB3B,MAAA,CAAO,GAAA,WAAc,GAAA,oBArBgD;EAuBrE,IAAA,IAAQ,MAAA,WAAiB,CAAA,KAAM,CAAA;AAAA;;KAIrB,gBAAA,gBACR,OAAA,CAAQ,WAAA,MACN,IAAA,EAAM,WAAA,KAAgB,OAAA,CAAQ,WAAA;;KAGxB,YAAA,iBACV,IAAA,EAAM,WAAA,EACN,UAAA,EAAY,WAAA,KACT,OAAA,CAAQ,WAAA;AAAA,KAED,OAAA,gBAAuB,KAAA,gBAAqB,iBAAA,CAAkB,MAAA;EArCZ,qEAuC5D,IAAA,CAAK,SAAA,GAAY,gBAAA,CAAiB,WAAA,IAAe,WAAA,EAvC0B;EAyC3E,QAAA,CAAS,KAAA,UAAe,SAAA,GAAY,gBAAA,CAAiB,WAAA,IAAe,WAAA,IAlC1D;EAoCV,MAAA,CAAO,SAAA,GAAY,gBAAA,CAAiB,WAAA,IAAe,OAAA,CAAQ,MAAA,GApCtC;EAsCrB,MAAA,CAAO,KAAA,UAAe,SAAA,GAAY,gBAAA,CAAiB,WAAA,IAAe,OAAA,CAAQ,MAAA,KAtBjD;EAwBzB,UAAA,CAAW,KAAA,UAAe,SAAA,GAAY,gBAAA,CAAiB,WAAA,IAAe,OAAA,CAAQ,MAAA,KAxB9C;EA0BhC,KAAA,CAAM,IAAA,UAAc,KAAA,EAAO,YAAA,CAAa,WAAA,IAAe,OAAA,CAAQ,MAAA,EAAQ,WAAA,GAxC9D;EA0CT,IAAA,IAAQ,MAAA,aAAmB,OAAA,CAAQ,MAAA,EAAQ,WAAA,GAtC3C;EAwCA,aAAA;AAAA;;iBAQc,qBAAA;;;;;;;;;;;;;AAtCkB;AAIlC;;;;iBAuKgB,aAAA,gBAA6B,KAAA,EAC3C,KAAA,EAAO,UAAA,CAAW,MAAA,GAClB,UAAA,GAAa,IAAA,EAAM,WAAA,KAAgB,iBAAA,CAAkB,MAAA,IACpD,OAAA,CAAQ,MAAA"}
+{"version":3,"file":"factories.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/tests/factories.ts"],"mappings":";;;KAIK,SAAS,eAAe,SAAS,eAAe,YAAY,WAAW,UAAU;;YAG1E,kBAAkB,eAAe,SAAS,QAAQ,SAAS;;;;;;YAO3D;;WAED;;WAEA;;EAET,KAAK;;EAEL,MAAM;;EAEN;;EAEA,KAAK,sBAAsB;;EAE3B,OAAO,cAAc;;EAErB,KAAK,GAAG,iBAAiB,MAAM;;;YAIrB,iBAAiB,eACzB,QAAQ,iBACN,MAAM,gBAAgB,QAAQ;;YAGxB,aAAa,gBACvB,MAAM,aACN,YAAY,gBACT,QAAQ;YAED,QAAQ,eAAe,OAAO,cAAc,kBAAkB;;EAExE,KAAK,YAAY,iBAAiB,eAAe;;EAEjD,SAAS,eAAe,YAAY,iBAAiB,eAAe;;EAEpE,OAAO,YAAY,iBAAiB,eAAe,QAAQ;;EAE3D,OAAO,eAAe,YAAY,iBAAiB,eAAe,QAAQ;;EAE1E,WAAW,eAAe,YAAY,iBAAiB,eAAe,QAAQ;;EAE9E,MAAM,cAAc,OAAO,aAAa,eAAe,QAAQ,QAAQ;;EAEvE,QAAQ,mBAAmB,QAAQ,QAAQ;;EAE3C;;;wBAQc;;;;;;;;;;;;;;;;;;wBAqIA,cAAc,eAAe,OAC3C,OAAO,WAAW,SAClB,aAAa,MAAM,gBAAgB,kBAAkB,UACpD,QAAQ"}

package/esm/tests/fakes/cache-fake.d.mts

@@ -1,5 +1,4 @@
 import { CacheKey, MemoryCacheDriver } from "@warlock.js/cache";
-
 //#region ../../packages/core/src/tests/fakes/cache-fake.d.ts
 /**
  * Swaps the cache's current driver for a fresh in-memory one.
@@ -14,16 +13,22 @@ import { CacheKey, MemoryCacheDriver } from "@warlock.js/cache";
  *
  * await cacheFake.assertHas("stats.dashboard");
  */
-declare const cacheFake: {
-  /** Start a fresh in-memory store (idempotent: a second call empties it). */install(): Promise<void>; /** Put the previous driver back and drop the in-memory store. */
+export declare const cacheFake: {
+  /** Start a fresh in-memory store (idempotent: a second call empties it). */
+  install(): Promise<void>;
+  /** Put the previous driver back and drop the in-memory store. */
   restore(): Promise<void>;
-  isInstalled(): boolean; /** The in-memory driver standing in for the configured one. */
-  driver(): MemoryCacheDriver; /** Empty the store. */
-  clear(): Promise<void>; /** Assert `key` is cached. */
-  assertHas(key: CacheKey): Promise<void>; /** Assert `key` is not cached. */
-  assertMissing(key: CacheKey): Promise<void>; /** Assert `key` holds a value deeply equal to `value`. */
+  isInstalled(): boolean;
+  /** The in-memory driver standing in for the configured one. */
+  driver(): MemoryCacheDriver;
+  /** Empty the store. */
+  clear(): Promise<void>;
+  /** Assert `key` is cached. */
+  assertHas(key: CacheKey): Promise<void>;
+  /** Assert `key` is not cached. */
+  assertMissing(key: CacheKey): Promise<void>;
+  /** Assert `key` holds a value deeply equal to `value`. */
   assertStored(key: CacheKey, value: unknown): Promise<void>;
 };
 //#endregion
-export { cacheFake };
 //# sourceMappingURL=cache-fake.d.mts.map

package/esm/tests/fakes/cache-fake.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/cache-fake.ts"],"mappings":";;;;;AA+BA;;;;;;;;;;;cAAa,SAAA;EAqEwC,uFAnElC,OAAA,QAmEyC;aAjDzC,OAAA;;YAqBP,iBAAA;WAKK,OAAA,QALL;iBAUW,QAAA,GAAW,OAAA,QALjB;qBAcU,QAAA,GAAW,OAAA,QATf;oBAkBG,QAAA,EAAQ,KAAA,YAAmB,OAAA;AAAA"}
+{"version":3,"file":"cache-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/cache-fake.ts"],"mappings":";;;;;;;;;;;;;;;qBA+Ba;;EAEL,WAAW;;EAkBX,WAAW;EAgBjB;;EAKA,UAAU;;EAKJ,SAAS;;EAKT,UAAS,KAAM,WAAW;;EAS1B,cAAa,KAAM,WAAW;;EAS9B,aAAY,KAAM,UAAQ,iBAAmB"}

package/esm/tests/fakes/clock-fake.d.mts

@@ -3,7 +3,7 @@
  * The instant the fake clock starts at: 2026-01-01T00:00:00.000Z. Fixed so a
  * snapshot or an expiry computed in a test is the same on every run.
  */
-declare const DEFAULT_FAKE_NOW: number;
+export declare const DEFAULT_FAKE_NOW: number;
 /**
  * A frozen `clock` (from `@warlock.js/core`) that only moves when told to.
  *
@@ -18,15 +18,20 @@ declare const DEFAULT_FAKE_NOW: number;
  *
  * expect(await isResetTokenValid(token)).toBe(false);
  */
-declare const clockFake: {
-  /** Freeze the clock at `at` (default {@link DEFAULT_FAKE_NOW}). */install(at?: Date | string | number): void; /** Hand the clock back to real time. */
+export declare const clockFake: {
+  /** Freeze the clock at `at` (default {@link DEFAULT_FAKE_NOW}). */
+  install(at?: Date | string | number): void;
+  /** Hand the clock back to real time. */
   restore(): void;
-  isInstalled(): boolean; /** Freeze at a given instant (installs the fake if needed). */
-  freeze(at?: Date | string | number): Date; /** Move the frozen clock by `milliseconds` (negative goes back). */
-  travel(milliseconds: number): Date; /** Jump the frozen clock to an instant. */
-  travelTo(at: Date | string | number): Date; /** The fake clock's current time. */
+  isInstalled(): boolean;
+  /** Freeze at a given instant (installs the fake if needed). */
+  freeze(at?: Date | string | number): Date;
+  /** Move the frozen clock by `milliseconds` (negative goes back). */
+  travel(milliseconds: number): Date;
+  /** Jump the frozen clock to an instant. */
+  travelTo(at: Date | string | number): Date;
+  /** The fake clock's current time. */
   now(): Date;
 };
 //#endregion
-export { DEFAULT_FAKE_NOW, clockFake };
 //# sourceMappingURL=clock-fake.d.mts.map

package/esm/tests/fakes/clock-fake.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"clock-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/clock-fake.ts"],"mappings":";;AAMA;;;cAAa,gBAAA;AAAmD;AA6BhE;;;;;;;;;;;;;AA7BgE,cA6BnD,SAAA;kFAEC,IAAA;;;cAkBD,IAAA,qBAA8D,IAAA;gCAO3C,IAAA,EAAA;eASjB,IAAA,qBAAyB,IAAA,EAAzB;SAKN,IAAA;AAAA"}
+{"version":3,"file":"clock-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/clock-fake.ts"],"mappings":";;;;;qBAMa;;;;;;;;;;;;;;;qBA6BA;;EAEX,QAAO,KAAK;;EAOZ;EAMA;;EAKA,OAAM,KAAK,yBAA8D;;EAOzE,OAAM,uBAAwB;;EAS9B,SAAQ,IAAK,yBAAyB;;EAKtC,OAAO"}

package/esm/tests/fakes/fake-assertion-error.d.mts

@@ -3,11 +3,10 @@
  * Thrown by a fake's `assert*` helper. The message says what was expected and
  * lists what the fake actually recorded, so a failing test explains itself.
  */
-declare class FakeAssertionError extends Error {
+export declare class FakeAssertionError extends Error {
   constructor(message: string);
 }
 /** Render recorded entries for an assertion message, one per line. */
-declare function describeRecorded<T>(entries: readonly T[], describe: (entry: T) => string, noun: string): string;
+export declare function describeRecorded<T>(entries: readonly T[], describe: (entry: T) => string, noun: string): string;
 //#endregion
-export { FakeAssertionError, describeRecorded };
 //# sourceMappingURL=fake-assertion-error.d.mts.map

package/esm/tests/fakes/fake-assertion-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"fake-assertion-error.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/fake-assertion-error.ts"],"mappings":";;AAIA;;;cAAa,kBAAA,SAA2B,KAAK;cACxB,OAAA;AAAA;;iBAQL,gBAAA,IACd,OAAA,WAAkB,CAAA,IAClB,QAAA,GAAW,KAAA,EAAO,CAAC,aACnB,IAAA"}
+{"version":3,"file":"fake-assertion-error.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/fake-assertion-error.ts"],"mappings":";;;;;qBAIa,2BAA2B;EACtC,YAAmB;;;wBAQL,iBAAiB,GAC/B,kBAAkB,KAClB,WAAW,OAAO,cAClB"}

package/esm/tests/fakes/ids-fake.d.mts

@@ -10,13 +10,14 @@
  *
  * expect(file.path).toBe("reports/00000000-0000-4000-8000-000000000001.pdf");
  */
-declare const idsFake: {
+export declare const idsFake: {
   install(): void;
   restore(): void;
-  isInstalled(): boolean; /** Restart both sequences. */
-  reset(): void; /** The UUID the n-th `ids.uuid()` call returns (1-based). */
+  isInstalled(): boolean;
+  /** Restart both sequences. */
+  reset(): void;
+  /** The UUID the n-th `ids.uuid()` call returns (1-based). */
   uuid(n: number): string;
 };
 //#endregion
-export { idsFake };
 //# sourceMappingURL=ids-fake.d.mts.map

package/esm/tests/fakes/ids-fake.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ids-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/ids-fake.ts"],"mappings":";;AA6BA;;;;;;;;;;cAAa,OAAA"}
+{"version":3,"file":"ids-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/ids-fake.ts"],"mappings":";;;;;;;;;;;;qBA6Ba;EACX;EASA;EAMA;;EAKA;;EAMA,KAAI"}

package/esm/tests/fakes/index.d.mts

@@ -5,4 +5,5 @@ import { FakeAssertionError, describeRecorded } from "./fake-assertion-error.mjs
 import { idsFake } from "./ids-fake.mjs";
 import { MailMatcher, mailFake } from "./mail-fake.mjs";
 import { JobReference, PushedJob, PushedJobMatcher, queueFake } from "./queue-fake.mjs";
-import { storageFake } from "./storage-fake.mjs";
+import { storageFake } from "./storage-fake.mjs";
+export { DEFAULT_FAKE_NOW, FakeAssertionError, JobReference, MailMatcher, PushedJob, PushedJobMatcher, TEST_FAKE_NAMES, TestFakeName, TestFakesSelection, cacheFake, clockFake, describeRecorded, idsFake, installTestFakes, installedTestFakes, mailFake, queueFake, readConfiguredFakes, resolveTestFakes, restoreTestFakes, storageFake };

package/esm/tests/fakes/index.mjs

@@ -7,4 +7,4 @@ import { queueFake } from "./queue-fake.mjs";
 import { storageFake } from "./storage-fake.mjs";
 import { TEST_FAKE_NAMES, installTestFakes, installedTestFakes, readConfiguredFakes, resolveTestFakes, restoreTestFakes } from "./test-fakes.mjs";
 
-export {  };
+export { DEFAULT_FAKE_NOW, FakeAssertionError, TEST_FAKE_NAMES, cacheFake, clockFake, describeRecorded, idsFake, installTestFakes, installedTestFakes, mailFake, queueFake, readConfiguredFakes, resolveTestFakes, restoreTestFakes, storageFake };

package/esm/tests/fakes/mail-fake.d.mts

@@ -1,15 +1,15 @@
 import { CapturedMail } from "../../mail/types.mjs";
-
 //#region ../../packages/core/src/tests/fakes/mail-fake.d.ts
 /**
  * Which mails an assertion is about: a predicate, or fields that must all
  * match. `to` matches any recipient (to, cc or bcc); `subject` is an exact
  * string or a pattern.
  */
-type MailMatcher = ((mail: CapturedMail) => boolean) | {
+export type MailMatcher = ((mail: CapturedMail) => boolean) | {
   to?: string;
   subject?: string | RegExp;
-  from?: string; /** Text the HTML or plain-text body contains. */
+  from?: string;
+  /** Text the HTML or plain-text body contains. */
   contains?: string;
 };
 /**
@@ -25,17 +25,25 @@ type MailMatcher = ((mail: CapturedMail) => boolean) | {
  * mailFake.assertSent({ to: "ada@example.test", subject: /welcome/i });
  * mailFake.assertSentCount(1);
  */
-declare const mailFake: {
-  /** Start capturing (idempotent). Clears anything captured before. */install(): void; /** Stop capturing and restore the mode that was in force before. */
-  restore(): void; /** Whether the fake is installed. */
-  isInstalled(): boolean; /** Forget captured mails, e.g. in `beforeEach`. */
-  clear(): void; /** The captured mails, oldest first, optionally filtered. */
-  sent(matcher?: MailMatcher): CapturedMail[]; /** Assert at least one matching mail was sent; returns the first. */
-  assertSent(matcher?: MailMatcher): CapturedMail; /** Assert no matching mail was sent. */
-  assertNotSent(matcher?: MailMatcher): void; /** Assert exactly `count` matching mails were sent. */
-  assertSentCount(count: number, matcher?: MailMatcher): void; /** Assert nothing at all was sent. */
+export declare const mailFake: {
+  /** Start capturing (idempotent). Clears anything captured before. */
+  install(): void;
+  /** Stop capturing and restore the mode that was in force before. */
+  restore(): void;
+  /** Whether the fake is installed. */
+  isInstalled(): boolean;
+  /** Forget captured mails, e.g. in `beforeEach`. */
+  clear(): void;
+  /** The captured mails, oldest first, optionally filtered. */
+  sent(matcher?: MailMatcher): CapturedMail[];
+  /** Assert at least one matching mail was sent; returns the first. */
+  assertSent(matcher?: MailMatcher): CapturedMail;
+  /** Assert no matching mail was sent. */
+  assertNotSent(matcher?: MailMatcher): void;
+  /** Assert exactly `count` matching mails were sent. */
+  assertSentCount(count: number, matcher?: MailMatcher): void;
+  /** Assert nothing at all was sent. */
   assertNothingSent(): void;
 };
 //#endregion
-export { MailMatcher, mailFake };
 //# sourceMappingURL=mail-fake.d.mts.map

package/esm/tests/fakes/mail-fake.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mail-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/mail-fake.ts"],"mappings":";;;;;AAUA;;;KAAY,WAAA,KACN,IAAA,EAAM,YAAA;EAEN,EAAA;EACA,OAAA,YAAmB,MAAM;EACzB,IAAA,WADA;EAGA,QAAA;AAAA;;;AAAQ;AA0Ed;;;;;;;;;;cAAa,QAAA;;;;;iBAmCI,WAAA,GAAc,YAAA;uBAKR,WAAA,GAAc,YAAA;0BAaX,WAAA;iCAWK,OAAA,GAAY,WAAA"}
+{"version":3,"file":"mail-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/mail-fake.ts"],"mappings":";;;;;;;YAUY,gBACN,MAAM;EAEN;EACA,mBAAmB;EACnB;;EAEA;;;;;;;;;;;;;;;qBA0EO;;EAEX;;EAWA;;EAYA;;EAKA;;EAKA,KAAI,UAAW,cAAc;;EAK7B,WAAU,UAAW,cAAc;;EAanC,cAAa,UAAW;;EAWxB,gBAAe,eAAc,UAAY;;EAWzC"}

package/esm/tests/fakes/queue-fake.d.mts

@@ -6,20 +6,21 @@
  * fake talks to it through the global dispatch-interceptor slot that package
  * reads (`setDispatchInterceptor`).
  */
-type PushedJob = {
+export type PushedJob = {
   id: string;
   name: string;
   queue: string;
-  payload: unknown; /** The dispatch options (`delay`, `priority`, `jobId`, ...). */
+  payload: unknown;
+  /** The dispatch options (`delay`, `priority`, `jobId`, ...). */
   options: Record<string, unknown>;
   pushedAt: Date;
 };
 /** A job name, or anything with a `name` — the object `defineJob()` returns. */
-type JobReference = string | {
+export type JobReference = string | {
   readonly name: string;
 };
 /** Which pushed jobs an assertion is about: a predicate, or a payload subset. */
-type PushedJobMatcher = ((job: PushedJob) => boolean) | Record<string, unknown>;
+export type PushedJobMatcher = ((job: PushedJob) => boolean) | Record<string, unknown>;
 /**
  * Records every `@warlock.js/queue` dispatch instead of pushing it to Redis.
  *
@@ -32,17 +33,24 @@ type PushedJobMatcher = ((job: PushedJob) => boolean) | Record<string, unknown>;
  * queueFake.assertPushed(sendInvoice, { orderId: order.id });
  * queueFake.assertPushedCount(1);
  */
-declare const queueFake: {
-  /** Start recording (idempotent). Clears anything recorded before. */install(): void; /** Stop recording; dispatches reach the broker again. */
+export declare const queueFake: {
+  /** Start recording (idempotent). Clears anything recorded before. */
+  install(): void;
+  /** Stop recording; dispatches reach the broker again. */
   restore(): void;
-  isInstalled(): boolean; /** Forget recorded jobs. */
-  clear(): void; /** Recorded jobs, oldest first; optionally only one job type. */
-  pushed(job?: JobReference, matcher?: PushedJobMatcher): PushedJob[]; /** Assert `job` was pushed (with a payload matching `matcher`); returns the first match. */
-  assertPushed(job: JobReference, matcher?: PushedJobMatcher): PushedJob; /** Assert `job` was not pushed (with a matching payload). */
-  assertNotPushed(job: JobReference, matcher?: PushedJobMatcher): void; /** Assert exactly `count` jobs were pushed — of type `job` when given. */
-  assertPushedCount(count: number, job?: JobReference): void; /** Assert nothing was pushed. */
+  isInstalled(): boolean;
+  /** Forget recorded jobs. */
+  clear(): void;
+  /** Recorded jobs, oldest first; optionally only one job type. */
+  pushed(job?: JobReference, matcher?: PushedJobMatcher): PushedJob[];
+  /** Assert `job` was pushed (with a payload matching `matcher`); returns the first match. */
+  assertPushed(job: JobReference, matcher?: PushedJobMatcher): PushedJob;
+  /** Assert `job` was not pushed (with a matching payload). */
+  assertNotPushed(job: JobReference, matcher?: PushedJobMatcher): void;
+  /** Assert exactly `count` jobs were pushed — of type `job` when given. */
+  assertPushedCount(count: number, job?: JobReference): void;
+  /** Assert nothing was pushed. */
   assertNothingPushed(): void;
 };
 //#endregion
-export { JobReference, PushedJob, PushedJobMatcher, queueFake };
 //# sourceMappingURL=queue-fake.d.mts.map

package/esm/tests/fakes/queue-fake.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"queue-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/queue-fake.ts"],"mappings":";;AAUA;;;;;;KAAY,SAAA;EACV,EAAA;EACA,IAAA;EACA,KAAA;EACA,OAAA,WAGU;EADV,OAAA,EAAS,MAAA;EACT,QAAA,EAAU,IAAI;AAAA;;KAIJ,YAAA;EAAA,SAAmC,IAAI;AAAA;AAGnD;AAAA,KAAY,gBAAA,KAAqB,GAAA,EAAK,SAAA,gBAAyB,MAAM;;;;;;;AAAA;AAoGrE;;;;;cAAa,SAAA;EA0CO,sFAA2C;;0BAwBtB;iBAAY;eA/BtC,YAAA,EAAY,OAAA,GAAY,gBAAA,GAAmB,SAAA;oBAOtC,YAAA,EAAY,OAAA,GAAY,gBAAA,GAAmB,SAAA;uBAaxC,YAAA,EAAY,OAAA,GAAY,gBAAA,SApBhC;mCA+BkB,GAAA,GAAQ,YAAA,SA/BF"}
+{"version":3,"file":"queue-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/queue-fake.ts"],"mappings":";;;;;;;;YAUY;EACV;EACA;EACA;EACA;;EAEA,SAAS;EACT,UAAU;;;YAIA;WAAmC;;;YAGnC,qBAAqB,KAAK,yBAAyB;;;;;;;;;;;;;qBAoGlD;;EAEX;;EAaA;EASA;;EAKA;;EAMA,OAAM,MAAO,cAAY,UAAY,mBAAmB;;EAOxD,aAAY,KAAM,cAAY,UAAY,mBAAmB;;EAa7D,gBAAe,KAAM,cAAY,UAAY;;EAW7C,kBAAiB,eAAc,MAAQ;;EAWvC"}

package/esm/tests/fakes/storage-fake.d.mts

@@ -1,5 +1,4 @@
 import { StorageDriverName } from "../../storage/types.mjs";
-
 //#region ../../packages/core/src/tests/fakes/storage-fake.d.ts
 /**
  * Points every configured storage driver — local, S3, R2, Spaces — at a
@@ -17,15 +16,20 @@ import { StorageDriverName } from "../../storage/types.mjs";
  *
  * await storageFake.assertExists(`avatars/${user.id}.png`);
  */
-declare const storageFake: {
-  /** Re-register every driver as a local one under the temp root. */install(): Promise<void>; /** Drop the fake drivers; the real configuration is read again on next use. */
+export declare const storageFake: {
+  /** Re-register every driver as a local one under the temp root. */
+  install(): Promise<void>;
+  /** Drop the fake drivers; the real configuration is read again on next use. */
   restore(): Promise<void>;
-  isInstalled(): boolean; /** The temp directory every fake driver lives under. */
-  root(): string; /** Every stored file, as `<driver>/<path>`, sorted. */
-  files(driver?: StorageDriverName): string[]; /** Assert a file exists, on the default driver unless `driver` is given. */
-  assertExists(location: string, driver?: StorageDriverName): Promise<void>; /** Assert a file does not exist, on the default driver unless `driver` is given. */
+  isInstalled(): boolean;
+  /** The temp directory every fake driver lives under. */
+  root(): string;
+  /** Every stored file, as `<driver>/<path>`, sorted. */
+  files(driver?: StorageDriverName): string[];
+  /** Assert a file exists, on the default driver unless `driver` is given. */
+  assertExists(location: string, driver?: StorageDriverName): Promise<void>;
+  /** Assert a file does not exist, on the default driver unless `driver` is given. */
   assertMissing(location: string, driver?: StorageDriverName): Promise<void>;
 };
 //#endregion
-export { storageFake };
 //# sourceMappingURL=storage-fake.d.mts.map

package/esm/tests/fakes/storage-fake.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/storage-fake.ts"],"mappings":";;;;;;;;;;;;;;;;;;;cA2Da,WAAA;gFAEM,OAAA,QA6EkB;aAtClB,OAAA;;kBAmDmB;iBArBrB,iBAAA,aAqB2D;iCAbvC,MAAA,GAAW,iBAAA,GAAoB,OAAA;kCAa9B,MAAA,GAAW,iBAAA,GAAoB,OAAA;AAAA"}
+{"version":3,"file":"storage-fake.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/storage-fake.ts"],"mappings":";;;;;;;;;;;;;;;;;;qBA2Da;;EAEL,WAAW;;EAuCX,WAAW;EAoBjB;;EAKA;;EAKA,MAAK,SAAU;;EAQT,aAAY,kBAAiB,SAAW,oBAAoB;;EAa5D,cAAa,kBAAiB,SAAW,oBAAoB"}

package/esm/tests/fakes/storage-fake.mjs

@@ -118,5 +118,5 @@ const storageFake = {
 };
 
 //#endregion
-export { storageFake };
+export { TEST_STORAGE_ROOT_ENV_KEY, storageFake };
 //# sourceMappingURL=storage-fake.mjs.map

package/esm/tests/fakes/test-fakes.d.mts

@@ -1,7 +1,7 @@
 //#region ../../packages/core/src/tests/fakes/test-fakes.d.ts
 /** The fakes the test kit installs. */
-declare const TEST_FAKE_NAMES: readonly ["mail", "queue", "cache", "storage", "clock", "ids"];
-type TestFakeName = (typeof TEST_FAKE_NAMES)[number];
+export declare const TEST_FAKE_NAMES: readonly ["mail", "queue", "cache", "storage", "clock", "ids"];
+export type TestFakeName = (typeof TEST_FAKE_NAMES)[number];
 /**
  * Which fakes to install.
  *
@@ -10,15 +10,15 @@ type TestFakeName = (typeof TEST_FAKE_NAMES)[number];
  * - an object — all of them except the ones set to `false`, e.g.
  *   `{ cache: false }` keeps the configured cache driver.
  */
-type TestFakesSelection = boolean | Partial<Record<TestFakeName, boolean>>;
+export type TestFakesSelection = boolean | Partial<Record<TestFakeName, boolean>>;
 /** Read `tests.fakes` from `src/config/tests.ts`, or `undefined` when unset. */
-declare function readConfiguredFakes(): TestFakesSelection | undefined;
+export declare function readConfiguredFakes(): TestFakesSelection | undefined;
 /**
  * The fakes to install. Precedence: an explicit selection (the `fakes`
  * option of `setupTest()` / `startHttpTestServer()`) > `tests.fakes` in
  * `src/config/tests.ts` > all on.
  */
-declare function resolveTestFakes(explicit?: TestFakesSelection): TestFakeName[];
+export declare function resolveTestFakes(explicit?: TestFakesSelection): TestFakeName[];
 /**
  * Install the selected fakes. Called by `setupTest()` and
  * `startHttpTestServer()` once their connectors are up; call it yourself only
@@ -26,14 +26,13 @@ declare function resolveTestFakes(explicit?: TestFakesSelection): TestFakeName[]
  *
  * @returns the fakes that are now installed.
  */
-declare function installTestFakes(explicit?: TestFakesSelection): Promise<TestFakeName[]>;
+export declare function installTestFakes(explicit?: TestFakesSelection): Promise<TestFakeName[]>;
 /**
  * Restore every installed fake, in reverse order. Every fake is restored even
  * when one fails; the failures are rethrown together afterwards.
  */
-declare function restoreTestFakes(): Promise<void>;
+export declare function restoreTestFakes(): Promise<void>;
 /** The fakes installed right now. */
-declare function installedTestFakes(): TestFakeName[];
+export declare function installedTestFakes(): TestFakeName[];
 //#endregion
-export { TEST_FAKE_NAMES, TestFakeName, TestFakesSelection, installTestFakes, installedTestFakes, readConfiguredFakes, resolveTestFakes, restoreTestFakes };
 //# sourceMappingURL=test-fakes.d.mts.map

package/esm/tests/fakes/test-fakes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"test-fakes.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/test-fakes.ts"],"mappings":";;cAUa,eAAA;AAAA,KAED,YAAA,WAAuB,eAAe;;;AAF2C;AAE7F;;;;AAAkD;KAUtC,kBAAA,aAA+B,OAAA,CAAQ,MAAA,CAAO,YAAA;;iBAiB1C,mBAAA,IAAuB,kBAAkB;;;;;;iBA0CzC,gBAAA,CAAiB,QAAA,GAAW,kBAAA,GAAqB,YAAY;;;;AA3DP;AAiBtE;;;iBA2DsB,gBAAA,CAAiB,QAAA,GAAW,kBAAA,GAAqB,OAAA,CAAQ,YAAA;AA3DtB;AA0CzD;;;AA1CyD,iBA2EnC,gBAAA,IAAoB,OAAO;;iBAiBjC,kBAAA,IAAsB,YAAY"}
+{"version":3,"file":"test-fakes.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/test-fakes.ts"],"mappings":";;qBAUa;YAED,uBAAuB;;;;;;;;;YAUvB,+BAA+B,QAAQ,OAAO;;wBAiB1C,uBAAuB;;;;;;wBA0CvB,iBAAiB,WAAW,qBAAqB;;;;;;;;wBAiB3C,iBAAiB,WAAW,qBAAqB,QAAQ;;;;;wBAgBzD,oBAAoB;;wBAiB1B,sBAAsB"}