@warlock.js/core 5.29.0 → 5.31.0

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

@@ -0,0 +1,79 @@
+import { FakeAssertionError } from "./fake-assertion-error.mjs";
+import { MemoryCacheDriver, cache } from "@warlock.js/cache";
+import { isDeepStrictEqual } from "node:util";
+
+//#region ../../packages/core/src/tests/fakes/cache-fake.ts
+let fakeDriver;
+let previousDriver;
+let installed = false;
+function driver() {
+	if (!fakeDriver) throw new FakeAssertionError("cacheFake is not installed. It installs by default in the test environment; check `tests.fakes` in src/config/tests.ts, or call cacheFake.install().");
+	return fakeDriver;
+}
+/**
+* Swaps the cache's current driver for a fresh in-memory one.
+*
+* Installed by default in the test environment, so tests never need Redis
+* and never see another test's keys. Everything goes through the real cache
+* manager and the real memory driver: TTLs, tags, namespaces and locks behave
+* as they do in production.
+*
+* @example
+* await getDashboardStats(); // caches under "stats.dashboard"
+*
+* await cacheFake.assertHas("stats.dashboard");
+*/
+const cacheFake = {
+	/** Start a fresh in-memory store (idempotent: a second call empties it). */
+	async install() {
+		if (!installed) {
+			previousDriver = cache.currentDriver;
+			installed = true;
+		}
+		await fakeDriver?.disconnect();
+		const next = new MemoryCacheDriver();
+		next.setOptions({});
+		await next.connect();
+		fakeDriver = next;
+		await cache.use(next);
+	},
+	/** Put the previous driver back and drop the in-memory store. */
+	async restore() {
+		if (!installed) return;
+		const fake = fakeDriver;
+		fakeDriver = void 0;
+		installed = false;
+		if (previousDriver) await cache.use(previousDriver);
+		else cache.currentDriver = void 0;
+		previousDriver = void 0;
+		await fake?.disconnect();
+	},
+	isInstalled() {
+		return installed;
+	},
+	/** The in-memory driver standing in for the configured one. */
+	driver() {
+		return driver();
+	},
+	/** Empty the store. */
+	async clear() {
+		await driver().flush();
+	},
+	/** Assert `key` is cached. */
+	async assertHas(key) {
+		if (!await driver().has(key)) throw new FakeAssertionError(`Expected cache key ${JSON.stringify(key)} to be set. Cached keys: ${JSON.stringify(Object.keys(driver().data))}.`);
+	},
+	/** Assert `key` is not cached. */
+	async assertMissing(key) {
+		if (await driver().has(key)) throw new FakeAssertionError(`Expected cache key ${JSON.stringify(key)} not to be set, but it holds ${JSON.stringify(await driver().get(key))}.`);
+	},
+	/** Assert `key` holds a value deeply equal to `value`. */
+	async assertStored(key, value) {
+		const stored = await driver().get(key);
+		if (!isDeepStrictEqual(stored, value)) throw new FakeAssertionError(`Expected cache key ${JSON.stringify(key)} to hold ${JSON.stringify(value)}, but it holds ${JSON.stringify(stored)}.`);
+	}
+};
+
+//#endregion
+export { cacheFake };
+//# sourceMappingURL=cache-fake.mjs.map

package/esm/tests/fakes/cache-fake.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-fake.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/cache-fake.ts"],"sourcesContent":["import { type CacheDriver, type CacheKey, MemoryCacheDriver, cache } from \"@warlock.js/cache\";\nimport { isDeepStrictEqual } from \"node:util\";\nimport { FakeAssertionError } from \"./fake-assertion-error\";\n\nlet fakeDriver: MemoryCacheDriver | undefined;\nlet previousDriver: CacheDriver<unknown, unknown> | undefined;\nlet installed = false;\n\nfunction driver(): MemoryCacheDriver {\n  if (!fakeDriver) {\n    throw new FakeAssertionError(\n      \"cacheFake is not installed. It installs by default in the test environment; check `tests.fakes` in src/config/tests.ts, or call cacheFake.install().\",\n    );\n  }\n\n  return fakeDriver;\n}\n\n/**\n * Swaps the cache's current driver for a fresh in-memory one.\n *\n * Installed by default in the test environment, so tests never need Redis\n * and never see another test's keys. Everything goes through the real cache\n * manager and the real memory driver: TTLs, tags, namespaces and locks behave\n * as they do in production.\n *\n * @example\n * await getDashboardStats(); // caches under \"stats.dashboard\"\n *\n * await cacheFake.assertHas(\"stats.dashboard\");\n */\nexport const cacheFake = {\n  /** Start a fresh in-memory store (idempotent: a second call empties it). */\n  async install(): Promise<void> {\n    if (!installed) {\n      previousDriver = cache.currentDriver;\n      installed = true;\n    }\n\n    await fakeDriver?.disconnect();\n\n    const next = new MemoryCacheDriver();\n\n    next.setOptions({});\n    await next.connect();\n\n    fakeDriver = next;\n    await cache.use(next);\n  },\n\n  /** Put the previous driver back and drop the in-memory store. */\n  async restore(): Promise<void> {\n    if (!installed) return;\n\n    const fake = fakeDriver;\n\n    fakeDriver = undefined;\n    installed = false;\n\n    if (previousDriver) await cache.use(previousDriver);\n    else cache.currentDriver = undefined;\n\n    previousDriver = undefined;\n\n    await fake?.disconnect();\n  },\n\n  isInstalled(): boolean {\n    return installed;\n  },\n\n  /** The in-memory driver standing in for the configured one. */\n  driver(): MemoryCacheDriver {\n    return driver();\n  },\n\n  /** Empty the store. */\n  async clear(): Promise<void> {\n    await driver().flush();\n  },\n\n  /** Assert `key` is cached. */\n  async assertHas(key: CacheKey): Promise<void> {\n    if (!(await driver().has(key))) {\n      throw new FakeAssertionError(\n        `Expected cache key ${JSON.stringify(key)} to be set. Cached keys: ${JSON.stringify(Object.keys(driver().data))}.`,\n      );\n    }\n  },\n\n  /** Assert `key` is not cached. */\n  async assertMissing(key: CacheKey): Promise<void> {\n    if (await driver().has(key)) {\n      throw new FakeAssertionError(\n        `Expected cache key ${JSON.stringify(key)} not to be set, but it holds ${JSON.stringify(await driver().get(key))}.`,\n      );\n    }\n  },\n\n  /** Assert `key` holds a value deeply equal to `value`. */\n  async assertStored(key: CacheKey, value: unknown): Promise<void> {\n    const stored: unknown = await driver().get(key);\n\n    if (!isDeepStrictEqual(stored, value)) {\n      throw new FakeAssertionError(\n        `Expected cache key ${JSON.stringify(key)} to hold ${JSON.stringify(value)}, but it holds ${JSON.stringify(stored)}.`,\n      );\n    }\n  },\n};\n"],"mappings":";;;;;AAIA,IAAI;AACJ,IAAI;AACJ,IAAI,YAAY;AAEhB,SAAS,SAA4B;CACnC,IAAI,CAAC,YACH,MAAM,IAAI,mBACR,sJACF;CAGF,OAAO;AACT;;;;;;;;;;;;;;AAeA,MAAa,YAAY;;CAEvB,MAAM,UAAyB;EAC7B,IAAI,CAAC,WAAW;GACd,iBAAiB,MAAM;GACvB,YAAY;EACd;EAEA,MAAM,YAAY,WAAW;EAE7B,MAAM,OAAO,IAAI,kBAAkB;EAEnC,KAAK,WAAW,CAAC,CAAC;EAClB,MAAM,KAAK,QAAQ;EAEnB,aAAa;EACb,MAAM,MAAM,IAAI,IAAI;CACtB;;CAGA,MAAM,UAAyB;EAC7B,IAAI,CAAC,WAAW;EAEhB,MAAM,OAAO;EAEb,aAAa;EACb,YAAY;EAEZ,IAAI,gBAAgB,MAAM,MAAM,IAAI,cAAc;OAC7C,MAAM,gBAAgB;EAE3B,iBAAiB;EAEjB,MAAM,MAAM,WAAW;CACzB;CAEA,cAAuB;EACrB,OAAO;CACT;;CAGA,SAA4B;EAC1B,OAAO,OAAO;CAChB;;CAGA,MAAM,QAAuB;EAC3B,MAAM,OAAO,CAAC,CAAC,MAAM;CACvB;;CAGA,MAAM,UAAU,KAA8B;EAC5C,IAAI,CAAE,MAAM,OAAO,CAAC,CAAC,IAAI,GAAG,GAC1B,MAAM,IAAI,mBACR,sBAAsB,KAAK,UAAU,GAAG,EAAE,2BAA2B,KAAK,UAAU,OAAO,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAClH;CAEJ;;CAGA,MAAM,cAAc,KAA8B;EAChD,IAAI,MAAM,OAAO,CAAC,CAAC,IAAI,GAAG,GACxB,MAAM,IAAI,mBACR,sBAAsB,KAAK,UAAU,GAAG,EAAE,+BAA+B,KAAK,UAAU,MAAM,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,EACnH;CAEJ;;CAGA,MAAM,aAAa,KAAe,OAA+B;EAC/D,MAAM,SAAkB,MAAM,OAAO,CAAC,CAAC,IAAI,GAAG;EAE9C,IAAI,CAAC,kBAAkB,QAAQ,KAAK,GAClC,MAAM,IAAI,mBACR,sBAAsB,KAAK,UAAU,GAAG,EAAE,WAAW,KAAK,UAAU,KAAK,EAAE,iBAAiB,KAAK,UAAU,MAAM,EAAE,EACrH;CAEJ;AACF"}

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

@@ -0,0 +1,32 @@
+//#region ../../packages/core/src/tests/fakes/clock-fake.d.ts
+/**
+ * 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;
+/**
+ * A frozen `clock` (from `@warlock.js/core`) that only moves when told to.
+ *
+ * Installed by default in the test environment, frozen at
+ * {@link DEFAULT_FAKE_NOW}. It replaces only the framework clock: `Date`,
+ * `setTimeout` and drivers keep real time, so nothing stalls.
+ *
+ * @example
+ * const token = await issueResetToken(user); // expires in 15 minutes
+ *
+ * clockFake.travel(16 * 60_000);
+ *
+ * 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. */
+  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. */
+  now(): Date;
+};
+//#endregion
+export { DEFAULT_FAKE_NOW, clockFake };
+//# sourceMappingURL=clock-fake.d.mts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,69 @@
+import { setClockSource } from "../../utils/clock.mjs";
+
+//#region ../../packages/core/src/tests/fakes/clock-fake.ts
+/**
+* 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.
+*/
+const DEFAULT_FAKE_NOW = Date.UTC(2026, 0, 1, 0, 0, 0, 0);
+let now = DEFAULT_FAKE_NOW;
+let installed = false;
+function toTimestamp(value) {
+	const timestamp = value instanceof Date ? value.getTime() : new Date(value).getTime();
+	if (Number.isNaN(timestamp)) throw new RangeError(`clockFake cannot travel to ${JSON.stringify(value)}: not a valid date.`);
+	return timestamp;
+}
+/**
+* A frozen `clock` (from `@warlock.js/core`) that only moves when told to.
+*
+* Installed by default in the test environment, frozen at
+* {@link DEFAULT_FAKE_NOW}. It replaces only the framework clock: `Date`,
+* `setTimeout` and drivers keep real time, so nothing stalls.
+*
+* @example
+* const token = await issueResetToken(user); // expires in 15 minutes
+*
+* clockFake.travel(16 * 60_000);
+*
+* expect(await isResetTokenValid(token)).toBe(false);
+*/
+const clockFake = {
+	/** Freeze the clock at `at` (default {@link DEFAULT_FAKE_NOW}). */
+	install(at = DEFAULT_FAKE_NOW) {
+		now = toTimestamp(at);
+		installed = true;
+		setClockSource({ now: () => now });
+	},
+	/** Hand the clock back to real time. */
+	restore() {
+		installed = false;
+		now = DEFAULT_FAKE_NOW;
+		setClockSource(void 0);
+	},
+	isInstalled() {
+		return installed;
+	},
+	/** Freeze at a given instant (installs the fake if needed). */
+	freeze(at = installed ? now : DEFAULT_FAKE_NOW) {
+		clockFake.install(at);
+		return new Date(now);
+	},
+	/** Move the frozen clock by `milliseconds` (negative goes back). */
+	travel(milliseconds) {
+		if (!installed) clockFake.install();
+		now += milliseconds;
+		return new Date(now);
+	},
+	/** Jump the frozen clock to an instant. */
+	travelTo(at) {
+		return clockFake.freeze(at);
+	},
+	/** The fake clock's current time. */
+	now() {
+		return new Date(now);
+	}
+};
+
+//#endregion
+export { DEFAULT_FAKE_NOW, clockFake };
+//# sourceMappingURL=clock-fake.mjs.map

package/esm/tests/fakes/clock-fake.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock-fake.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/clock-fake.ts"],"sourcesContent":["import { setClockSource } from \"../../utils/clock\";\n\n/**\n * The instant the fake clock starts at: 2026-01-01T00:00:00.000Z. Fixed so a\n * snapshot or an expiry computed in a test is the same on every run.\n */\nexport const DEFAULT_FAKE_NOW = Date.UTC(2026, 0, 1, 0, 0, 0, 0);\n\nlet now = DEFAULT_FAKE_NOW;\nlet installed = false;\n\nfunction toTimestamp(value: Date | string | number): number {\n  const timestamp = value instanceof Date ? value.getTime() : new Date(value).getTime();\n\n  if (Number.isNaN(timestamp)) {\n    throw new RangeError(`clockFake cannot travel to ${JSON.stringify(value)}: not a valid date.`);\n  }\n\n  return timestamp;\n}\n\n/**\n * A frozen `clock` (from `@warlock.js/core`) that only moves when told to.\n *\n * Installed by default in the test environment, frozen at\n * {@link DEFAULT_FAKE_NOW}. It replaces only the framework clock: `Date`,\n * `setTimeout` and drivers keep real time, so nothing stalls.\n *\n * @example\n * const token = await issueResetToken(user); // expires in 15 minutes\n *\n * clockFake.travel(16 * 60_000);\n *\n * expect(await isResetTokenValid(token)).toBe(false);\n */\nexport const clockFake = {\n  /** Freeze the clock at `at` (default {@link DEFAULT_FAKE_NOW}). */\n  install(at: Date | string | number = DEFAULT_FAKE_NOW): void {\n    now = toTimestamp(at);\n    installed = true;\n    setClockSource({ now: () => now });\n  },\n\n  /** Hand the clock back to real time. */\n  restore(): void {\n    installed = false;\n    now = DEFAULT_FAKE_NOW;\n    setClockSource(undefined);\n  },\n\n  isInstalled(): boolean {\n    return installed;\n  },\n\n  /** Freeze at a given instant (installs the fake if needed). */\n  freeze(at: Date | string | number = installed ? now : DEFAULT_FAKE_NOW): Date {\n    clockFake.install(at);\n\n    return new Date(now);\n  },\n\n  /** Move the frozen clock by `milliseconds` (negative goes back). */\n  travel(milliseconds: number): Date {\n    if (!installed) clockFake.install();\n\n    now += milliseconds;\n\n    return new Date(now);\n  },\n\n  /** Jump the frozen clock to an instant. */\n  travelTo(at: Date | string | number): Date {\n    return clockFake.freeze(at);\n  },\n\n  /** The fake clock's current time. */\n  now(): Date {\n    return new Date(now);\n  },\n};\n"],"mappings":";;;;;;;AAMA,MAAa,mBAAmB,KAAK,IAAI,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE/D,IAAI,MAAM;AACV,IAAI,YAAY;AAEhB,SAAS,YAAY,OAAuC;CAC1D,MAAM,YAAY,iBAAiB,OAAO,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC,QAAQ;CAEpF,IAAI,OAAO,MAAM,SAAS,GACxB,MAAM,IAAI,WAAW,8BAA8B,KAAK,UAAU,KAAK,EAAE,oBAAoB;CAG/F,OAAO;AACT;;;;;;;;;;;;;;;AAgBA,MAAa,YAAY;;CAEvB,QAAQ,KAA6B,kBAAwB;EAC3D,MAAM,YAAY,EAAE;EACpB,YAAY;EACZ,eAAe,EAAE,WAAW,IAAI,CAAC;CACnC;;CAGA,UAAgB;EACd,YAAY;EACZ,MAAM;EACN,eAAe,MAAS;CAC1B;CAEA,cAAuB;EACrB,OAAO;CACT;;CAGA,OAAO,KAA6B,YAAY,MAAM,kBAAwB;EAC5E,UAAU,QAAQ,EAAE;EAEpB,OAAO,IAAI,KAAK,GAAG;CACrB;;CAGA,OAAO,cAA4B;EACjC,IAAI,CAAC,WAAW,UAAU,QAAQ;EAElC,OAAO;EAEP,OAAO,IAAI,KAAK,GAAG;CACrB;;CAGA,SAAS,IAAkC;EACzC,OAAO,UAAU,OAAO,EAAE;CAC5B;;CAGA,MAAY;EACV,OAAO,IAAI,KAAK,GAAG;CACrB;AACF"}

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

@@ -0,0 +1,13 @@
+//#region ../../packages/core/src/tests/fakes/fake-assertion-error.d.ts
+/**
+ * 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 {
+  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;
+//#endregion
+export { FakeAssertionError, describeRecorded };
+//# sourceMappingURL=fake-assertion-error.d.mts.map

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

@@ -0,0 +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"}

package/esm/tests/fakes/fake-assertion-error.mjs

@@ -0,0 +1,20 @@
+//#region ../../packages/core/src/tests/fakes/fake-assertion-error.ts
+/**
+* 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.
+*/
+var FakeAssertionError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "FakeAssertionError";
+	}
+};
+/** Render recorded entries for an assertion message, one per line. */
+function describeRecorded(entries, describe, noun) {
+	if (entries.length === 0) return `Nothing was ${noun}.`;
+	return `${entries.length} ${entries.length === 1 ? "entry was" : "entries were"} ${noun}:\n${entries.map((entry, index) => `  ${index + 1}. ${describe(entry)}`).join("\n")}`;
+}
+
+//#endregion
+export { FakeAssertionError, describeRecorded };
+//# sourceMappingURL=fake-assertion-error.mjs.map

package/esm/tests/fakes/fake-assertion-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-assertion-error.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/fake-assertion-error.ts"],"sourcesContent":["/**\n * Thrown by a fake's `assert*` helper. The message says what was expected and\n * lists what the fake actually recorded, so a failing test explains itself.\n */\nexport class FakeAssertionError extends Error {\n  public constructor(message: string) {\n    super(message);\n\n    this.name = \"FakeAssertionError\";\n  }\n}\n\n/** Render recorded entries for an assertion message, one per line. */\nexport function describeRecorded<T>(\n  entries: readonly T[],\n  describe: (entry: T) => string,\n  noun: string,\n): string {\n  if (entries.length === 0) return `Nothing was ${noun}.`;\n\n  return `${entries.length} ${entries.length === 1 ? \"entry was\" : \"entries were\"} ${noun}:\\n${entries\n    .map((entry, index) => `  ${index + 1}. ${describe(entry)}`)\n    .join(\"\\n\")}`;\n}\n"],"mappings":";;;;;AAIA,IAAa,qBAAb,cAAwC,MAAM;CAC5C,AAAO,YAAY,SAAiB;EAClC,MAAM,OAAO;EAEb,KAAK,OAAO;CACd;AACF;;AAGA,SAAgB,iBACd,SACA,UACA,MACQ;CACR,IAAI,QAAQ,WAAW,GAAG,OAAO,eAAe,KAAK;CAErD,OAAO,GAAG,QAAQ,OAAO,GAAG,QAAQ,WAAW,IAAI,cAAc,eAAe,GAAG,KAAK,KAAK,QAC1F,KAAK,OAAO,UAAU,KAAK,QAAQ,EAAE,IAAI,SAAS,KAAK,GAAG,CAAC,CAC3D,KAAK,IAAI;AACd"}

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

@@ -0,0 +1,22 @@
+//#region ../../packages/core/src/tests/fakes/ids-fake.d.ts
+/**
+ * Deterministic `ids` (from `@warlock.js/core`): numbered UUIDs and tokens.
+ *
+ * Installed by default in the test environment. Each sequence restarts on
+ * install and on `reset()`, so the n-th id in a test is the same on every run.
+ *
+ * @example
+ * const file = await storeReport(report); // named ids.uuid() + ".pdf"
+ *
+ * expect(file.path).toBe("reports/00000000-0000-4000-8000-000000000001.pdf");
+ */
+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). */
+  uuid(n: number): string;
+};
+//#endregion
+export { idsFake };
+//# sourceMappingURL=ids-fake.d.mts.map

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

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

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

@@ -0,0 +1,57 @@
+import { setIdsSource } from "../../utils/ids.mjs";
+
+//#region ../../packages/core/src/tests/fakes/ids-fake.ts
+let uuidSequence = 0;
+let tokenSequence = 0;
+let installed = false;
+/** `00000000-0000-4000-8000-000000000001` for 1: a valid v4-shaped UUID. */
+function sequentialUuid(value) {
+	return `00000000-0000-4000-8000-${String(value).padStart(12, "0")}`;
+}
+/** `token0001token0001…` cut to `length`: URL-safe and readable in a diff. */
+function sequentialToken(value, length) {
+	const unit = `token${String(value).padStart(4, "0")}`;
+	return unit.repeat(Math.ceil(length / unit.length)).slice(0, length);
+}
+/**
+* Deterministic `ids` (from `@warlock.js/core`): numbered UUIDs and tokens.
+*
+* Installed by default in the test environment. Each sequence restarts on
+* install and on `reset()`, so the n-th id in a test is the same on every run.
+*
+* @example
+* const file = await storeReport(report); // named ids.uuid() + ".pdf"
+*
+* expect(file.path).toBe("reports/00000000-0000-4000-8000-000000000001.pdf");
+*/
+const idsFake = {
+	install() {
+		installed = true;
+		idsFake.reset();
+		setIdsSource({
+			uuid: () => sequentialUuid(++uuidSequence),
+			token: (length) => sequentialToken(++tokenSequence, length)
+		});
+	},
+	restore() {
+		installed = false;
+		idsFake.reset();
+		setIdsSource(void 0);
+	},
+	isInstalled() {
+		return installed;
+	},
+	/** Restart both sequences. */
+	reset() {
+		uuidSequence = 0;
+		tokenSequence = 0;
+	},
+	/** The UUID the n-th `ids.uuid()` call returns (1-based). */
+	uuid(n) {
+		return sequentialUuid(n);
+	}
+};
+
+//#endregion
+export { idsFake };
+//# sourceMappingURL=ids-fake.mjs.map

package/esm/tests/fakes/ids-fake.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids-fake.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/ids-fake.ts"],"sourcesContent":["import { setIdsSource } from \"../../utils/ids\";\n\nlet uuidSequence = 0;\nlet tokenSequence = 0;\nlet installed = false;\n\n/** `00000000-0000-4000-8000-000000000001` for 1: a valid v4-shaped UUID. */\nfunction sequentialUuid(value: number): string {\n  return `00000000-0000-4000-8000-${String(value).padStart(12, \"0\")}`;\n}\n\n/** `token0001token0001…` cut to `length`: URL-safe and readable in a diff. */\nfunction sequentialToken(value: number, length: number): string {\n  const unit = `token${String(value).padStart(4, \"0\")}`;\n\n  return unit.repeat(Math.ceil(length / unit.length)).slice(0, length);\n}\n\n/**\n * Deterministic `ids` (from `@warlock.js/core`): numbered UUIDs and tokens.\n *\n * Installed by default in the test environment. Each sequence restarts on\n * install and on `reset()`, so the n-th id in a test is the same on every run.\n *\n * @example\n * const file = await storeReport(report); // named ids.uuid() + \".pdf\"\n *\n * expect(file.path).toBe(\"reports/00000000-0000-4000-8000-000000000001.pdf\");\n */\nexport const idsFake = {\n  install(): void {\n    installed = true;\n    idsFake.reset();\n    setIdsSource({\n      uuid: () => sequentialUuid(++uuidSequence),\n      token: (length) => sequentialToken(++tokenSequence, length),\n    });\n  },\n\n  restore(): void {\n    installed = false;\n    idsFake.reset();\n    setIdsSource(undefined);\n  },\n\n  isInstalled(): boolean {\n    return installed;\n  },\n\n  /** Restart both sequences. */\n  reset(): void {\n    uuidSequence = 0;\n    tokenSequence = 0;\n  },\n\n  /** The UUID the n-th `ids.uuid()` call returns (1-based). */\n  uuid(n: number): string {\n    return sequentialUuid(n);\n  },\n};\n"],"mappings":";;;AAEA,IAAI,eAAe;AACnB,IAAI,gBAAgB;AACpB,IAAI,YAAY;;AAGhB,SAAS,eAAe,OAAuB;CAC7C,OAAO,2BAA2B,OAAO,KAAK,CAAC,CAAC,SAAS,IAAI,GAAG;AAClE;;AAGA,SAAS,gBAAgB,OAAe,QAAwB;CAC9D,MAAM,OAAO,QAAQ,OAAO,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG;CAElD,OAAO,KAAK,OAAO,KAAK,KAAK,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM;AACrE;;;;;;;;;;;;AAaA,MAAa,UAAU;CACrB,UAAgB;EACd,YAAY;EACZ,QAAQ,MAAM;EACd,aAAa;GACX,YAAY,eAAe,EAAE,YAAY;GACzC,QAAQ,WAAW,gBAAgB,EAAE,eAAe,MAAM;EAC5D,CAAC;CACH;CAEA,UAAgB;EACd,YAAY;EACZ,QAAQ,MAAM;EACd,aAAa,MAAS;CACxB;CAEA,cAAuB;EACrB,OAAO;CACT;;CAGA,QAAc;EACZ,eAAe;EACf,gBAAgB;CAClB;;CAGA,KAAK,GAAmB;EACtB,OAAO,eAAe,CAAC;CACzB;AACF"}

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

@@ -0,0 +1,8 @@
+import { TEST_FAKE_NAMES, TestFakeName, TestFakesSelection, installTestFakes, installedTestFakes, readConfiguredFakes, resolveTestFakes, restoreTestFakes } from "./test-fakes.mjs";
+import { cacheFake } from "./cache-fake.mjs";
+import { DEFAULT_FAKE_NOW, clockFake } from "./clock-fake.mjs";
+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";

package/esm/tests/fakes/index.mjs

@@ -0,0 +1,10 @@
+import { FakeAssertionError, describeRecorded } from "./fake-assertion-error.mjs";
+import { cacheFake } from "./cache-fake.mjs";
+import { DEFAULT_FAKE_NOW, clockFake } from "./clock-fake.mjs";
+import { idsFake } from "./ids-fake.mjs";
+import { mailFake } from "./mail-fake.mjs";
+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 {  };

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

@@ -0,0 +1,41 @@
+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) | {
+  to?: string;
+  subject?: string | RegExp;
+  from?: string; /** Text the HTML or plain-text body contains. */
+  contains?: string;
+};
+/**
+ * Captures every `sendMail()` / `Mail` send instead of delivering it.
+ *
+ * Installed by default in the test environment (see `installTestFakes`). It
+ * switches the mailer to its `test` mode, which records into the test mailbox
+ * and never opens an SMTP or SES connection.
+ *
+ * @example
+ * await registerUser({ email: "ada@example.test" });
+ *
+ * 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. */
+  assertNothingSent(): void;
+};
+//#endregion
+export { MailMatcher, mailFake };
+//# sourceMappingURL=mail-fake.d.mts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,111 @@
+import { getExplicitMailMode, resetMailMode, setMailMode } from "../../mail/config.mjs";
+import { clearTestMailbox, getTestMailbox } from "../../mail/test-mailbox.mjs";
+import { FakeAssertionError, describeRecorded } from "./fake-assertion-error.mjs";
+
+//#region ../../packages/core/src/tests/fakes/mail-fake.ts
+function fromAddress(mail) {
+	const from = mail.normalized?.from ?? mail.options.from;
+	if (!from) return "";
+	return typeof from === "string" ? from : from.address;
+}
+function recipients(mail) {
+	const list = (value) => value === void 0 ? [] : Array.isArray(value) ? value : [value];
+	return [
+		...list(mail.options.to),
+		...list(mail.options.cc),
+		...list(mail.options.bcc)
+	];
+}
+function matches(mail, matcher) {
+	if (matcher === void 0) return true;
+	if (typeof matcher === "function") return matcher(mail);
+	if (matcher.to !== void 0 && !recipients(mail).includes(matcher.to)) return false;
+	if (matcher.subject !== void 0) {
+		const subject = mail.options.subject;
+		if (!(typeof matcher.subject === "string" ? subject === matcher.subject : matcher.subject.test(subject))) return false;
+	}
+	if (matcher.from !== void 0 && fromAddress(mail) !== matcher.from) return false;
+	if (matcher.contains !== void 0) {
+		if (!`${mail.normalized?.html ?? mail.options.html ?? ""}\n${mail.normalized?.text ?? mail.options.text ?? ""}`.includes(matcher.contains)) return false;
+	}
+	return true;
+}
+function describeMatcher(matcher) {
+	if (matcher === void 0) return "any mail";
+	if (typeof matcher === "function") return "a mail matching the predicate";
+	return `a mail with ${JSON.stringify(matcher, (_key, value) => value instanceof RegExp ? String(value) : value)}`;
+}
+function describeMail(mail) {
+	return `to ${recipients(mail).join(", ") || "(nobody)"} — "${mail.options.subject}"`;
+}
+let previousMode;
+let installed = false;
+/**
+* Captures every `sendMail()` / `Mail` send instead of delivering it.
+*
+* Installed by default in the test environment (see `installTestFakes`). It
+* switches the mailer to its `test` mode, which records into the test mailbox
+* and never opens an SMTP or SES connection.
+*
+* @example
+* await registerUser({ email: "ada@example.test" });
+*
+* mailFake.assertSent({ to: "ada@example.test", subject: /welcome/i });
+* mailFake.assertSentCount(1);
+*/
+const mailFake = {
+	/** Start capturing (idempotent). Clears anything captured before. */
+	install() {
+		if (!installed) {
+			previousMode = getExplicitMailMode();
+			installed = true;
+		}
+		setMailMode("test");
+		clearTestMailbox();
+	},
+	/** Stop capturing and restore the mode that was in force before. */
+	restore() {
+		if (!installed) return;
+		if (previousMode === void 0) resetMailMode();
+		else setMailMode(previousMode);
+		clearTestMailbox();
+		previousMode = void 0;
+		installed = false;
+	},
+	/** Whether the fake is installed. */
+	isInstalled() {
+		return installed;
+	},
+	/** Forget captured mails, e.g. in `beforeEach`. */
+	clear() {
+		clearTestMailbox();
+	},
+	/** The captured mails, oldest first, optionally filtered. */
+	sent(matcher) {
+		return getTestMailbox().filter((mail) => matches(mail, matcher));
+	},
+	/** Assert at least one matching mail was sent; returns the first. */
+	assertSent(matcher) {
+		const found = mailFake.sent(matcher)[0];
+		if (!found) throw new FakeAssertionError(`Expected ${describeMatcher(matcher)} to be sent. ${describeRecorded(getTestMailbox(), describeMail, "sent")}`);
+		return found;
+	},
+	/** Assert no matching mail was sent. */
+	assertNotSent(matcher) {
+		const found = mailFake.sent(matcher);
+		if (found.length > 0) throw new FakeAssertionError(`Expected ${describeMatcher(matcher)} not to be sent. ${describeRecorded(found, describeMail, "sent")}`);
+	},
+	/** Assert exactly `count` matching mails were sent. */
+	assertSentCount(count, matcher) {
+		const found = mailFake.sent(matcher);
+		if (found.length !== count) throw new FakeAssertionError(`Expected ${count} × ${describeMatcher(matcher)}, found ${found.length}. ${describeRecorded(getTestMailbox(), describeMail, "sent")}`);
+	},
+	/** Assert nothing at all was sent. */
+	assertNothingSent() {
+		mailFake.assertNotSent();
+	}
+};
+
+//#endregion
+export { mailFake };
+//# sourceMappingURL=mail-fake.mjs.map

package/esm/tests/fakes/mail-fake.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-fake.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/mail-fake.ts"],"sourcesContent":["import { getExplicitMailMode, resetMailMode, setMailMode } from \"../../mail/config\";\nimport { clearTestMailbox, getTestMailbox } from \"../../mail/test-mailbox\";\nimport type { CapturedMail, MailMode } from \"../../mail/types\";\nimport { FakeAssertionError, describeRecorded } from \"./fake-assertion-error\";\n\n/**\n * Which mails an assertion is about: a predicate, or fields that must all\n * match. `to` matches any recipient (to, cc or bcc); `subject` is an exact\n * string or a pattern.\n */\nexport type MailMatcher =\n  | ((mail: CapturedMail) => boolean)\n  | {\n      to?: string;\n      subject?: string | RegExp;\n      from?: string;\n      /** Text the HTML or plain-text body contains. */\n      contains?: string;\n    };\n\nfunction fromAddress(mail: CapturedMail): string {\n  const from = mail.normalized?.from ?? mail.options.from;\n\n  if (!from) return \"\";\n\n  return typeof from === \"string\" ? from : from.address;\n}\n\nfunction recipients(mail: CapturedMail): string[] {\n  const list = (value: string | string[] | undefined) =>\n    value === undefined ? [] : Array.isArray(value) ? value : [value];\n\n  return [...list(mail.options.to), ...list(mail.options.cc), ...list(mail.options.bcc)];\n}\n\nfunction matches(mail: CapturedMail, matcher: MailMatcher | undefined): boolean {\n  if (matcher === undefined) return true;\n  if (typeof matcher === \"function\") return matcher(mail);\n\n  if (matcher.to !== undefined && !recipients(mail).includes(matcher.to)) return false;\n\n  if (matcher.subject !== undefined) {\n    const subject = mail.options.subject;\n    const ok =\n      typeof matcher.subject === \"string\"\n        ? subject === matcher.subject\n        : matcher.subject.test(subject);\n\n    if (!ok) return false;\n  }\n\n  if (matcher.from !== undefined && fromAddress(mail) !== matcher.from) return false;\n\n  if (matcher.contains !== undefined) {\n    const body = `${mail.normalized?.html ?? mail.options.html ?? \"\"}\\n${mail.normalized?.text ?? mail.options.text ?? \"\"}`;\n\n    if (!body.includes(matcher.contains)) return false;\n  }\n\n  return true;\n}\n\nfunction describeMatcher(matcher: MailMatcher | undefined): string {\n  if (matcher === undefined) return \"any mail\";\n  if (typeof matcher === \"function\") return \"a mail matching the predicate\";\n\n  return `a mail with ${JSON.stringify(matcher, (_key, value: unknown) =>\n    value instanceof RegExp ? String(value) : value,\n  )}`;\n}\n\nfunction describeMail(mail: CapturedMail): string {\n  return `to ${recipients(mail).join(\", \") || \"(nobody)\"} — \"${mail.options.subject}\"`;\n}\n\nlet previousMode: MailMode | undefined;\nlet installed = false;\n\n/**\n * Captures every `sendMail()` / `Mail` send instead of delivering it.\n *\n * Installed by default in the test environment (see `installTestFakes`). It\n * switches the mailer to its `test` mode, which records into the test mailbox\n * and never opens an SMTP or SES connection.\n *\n * @example\n * await registerUser({ email: \"ada@example.test\" });\n *\n * mailFake.assertSent({ to: \"ada@example.test\", subject: /welcome/i });\n * mailFake.assertSentCount(1);\n */\nexport const mailFake = {\n  /** Start capturing (idempotent). Clears anything captured before. */\n  install(): void {\n    if (!installed) {\n      previousMode = getExplicitMailMode();\n      installed = true;\n    }\n\n    setMailMode(\"test\");\n    clearTestMailbox();\n  },\n\n  /** Stop capturing and restore the mode that was in force before. */\n  restore(): void {\n    if (!installed) return;\n\n    if (previousMode === undefined) resetMailMode();\n    else setMailMode(previousMode);\n\n    clearTestMailbox();\n    previousMode = undefined;\n    installed = false;\n  },\n\n  /** Whether the fake is installed. */\n  isInstalled(): boolean {\n    return installed;\n  },\n\n  /** Forget captured mails, e.g. in `beforeEach`. */\n  clear(): void {\n    clearTestMailbox();\n  },\n\n  /** The captured mails, oldest first, optionally filtered. */\n  sent(matcher?: MailMatcher): CapturedMail[] {\n    return getTestMailbox().filter((mail) => matches(mail, matcher));\n  },\n\n  /** Assert at least one matching mail was sent; returns the first. */\n  assertSent(matcher?: MailMatcher): CapturedMail {\n    const found = mailFake.sent(matcher)[0];\n\n    if (!found) {\n      throw new FakeAssertionError(\n        `Expected ${describeMatcher(matcher)} to be sent. ${describeRecorded(getTestMailbox(), describeMail, \"sent\")}`,\n      );\n    }\n\n    return found;\n  },\n\n  /** Assert no matching mail was sent. */\n  assertNotSent(matcher?: MailMatcher): void {\n    const found = mailFake.sent(matcher);\n\n    if (found.length > 0) {\n      throw new FakeAssertionError(\n        `Expected ${describeMatcher(matcher)} not to be sent. ${describeRecorded(found, describeMail, \"sent\")}`,\n      );\n    }\n  },\n\n  /** Assert exactly `count` matching mails were sent. */\n  assertSentCount(count: number, matcher?: MailMatcher): void {\n    const found = mailFake.sent(matcher);\n\n    if (found.length !== count) {\n      throw new FakeAssertionError(\n        `Expected ${count} × ${describeMatcher(matcher)}, found ${found.length}. ${describeRecorded(getTestMailbox(), describeMail, \"sent\")}`,\n      );\n    }\n  },\n\n  /** Assert nothing at all was sent. */\n  assertNothingSent(): void {\n    mailFake.assertNotSent();\n  },\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,48 @@
+//#region ../../packages/core/src/tests/fakes/queue-fake.d.ts
+/**
+ * One job `dispatch()`ed while the fake was installed.
+ *
+ * Structural on purpose: core has no dependency on `@warlock.js/queue`. The
+ * fake talks to it through the global dispatch-interceptor slot that package
+ * reads (`setDispatchInterceptor`).
+ */
+type PushedJob = {
+  id: string;
+  name: string;
+  queue: string;
+  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 | {
+  readonly name: string;
+};
+/** Which pushed jobs an assertion is about: a predicate, or a payload subset. */
+type PushedJobMatcher = ((job: PushedJob) => boolean) | Record<string, unknown>;
+/**
+ * Records every `@warlock.js/queue` dispatch instead of pushing it to Redis.
+ *
+ * Installed by default in the test environment. Jobs are recorded, not run:
+ * call the job's handler directly to test what it does.
+ *
+ * @example
+ * await placeOrder(order);
+ *
+ * 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. */
+  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. */
+  assertNothingPushed(): void;
+};
+//#endregion
+export { JobReference, PushedJob, PushedJobMatcher, queueFake };
+//# sourceMappingURL=queue-fake.d.mts.map

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

@@ -0,0 +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"}