@warlock.js/core 5.30.0 → 5.31.0

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"}

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

@@ -0,0 +1,134 @@
+import { clock } from "../../utils/clock.mjs";
+import { FakeAssertionError, describeRecorded } from "./fake-assertion-error.mjs";
+
+//#region ../../packages/core/src/tests/fakes/queue-fake.ts
+const INTERCEPTOR_KEY = Symbol.for("warlock.queue.dispatchInterceptor");
+const pushed = [];
+let sequence = 0;
+let previous;
+let installed = false;
+function nameOf(job) {
+	return typeof job === "string" ? job : job.name;
+}
+function isSubset(expected, actual) {
+	if (expected === actual) return true;
+	if (typeof expected !== "object" || expected === null) return false;
+	if (typeof actual !== "object" || actual === null) return false;
+	return Object.entries(expected).every(([key, value]) => isSubset(value, actual[key]));
+}
+function matches(job, matcher) {
+	if (matcher === void 0) return true;
+	if (typeof matcher === "function") return matcher(job);
+	return isSubset(matcher, job.payload);
+}
+function describeJob(job) {
+	return `${job.name} on "${job.queue}" with ${JSON.stringify(job.payload)}`;
+}
+const interceptor = {
+	dispatch({ name, queue, payload, options }) {
+		const explicitId = typeof options.jobId === "string" ? options.jobId : void 0;
+		const existing = explicitId ? pushed.find((job) => job.id === explicitId) : void 0;
+		if (existing) return {
+			id: existing.id,
+			name: existing.name,
+			queue: existing.queue
+		};
+		sequence += 1;
+		const job = {
+			id: explicitId ?? `fake-${sequence}`,
+			name,
+			queue,
+			payload,
+			options: { ...options },
+			pushedAt: clock.now()
+		};
+		pushed.push(job);
+		return {
+			id: job.id,
+			name,
+			queue
+		};
+	},
+	find({ name, id }) {
+		const job = pushed.find((entry) => entry.id === id && entry.name === name);
+		if (!job) return void 0;
+		return {
+			id: job.id,
+			name: job.name,
+			queue: job.queue,
+			state: "waiting",
+			payload: job.payload,
+			progress: 0,
+			attemptsMade: 0,
+			createdAt: job.pushedAt
+		};
+	}
+};
+/**
+* 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);
+*/
+const queueFake = {
+	/** Start recording (idempotent). Clears anything recorded before. */
+	install() {
+		const holder = globalThis;
+		if (!installed) {
+			previous = holder[INTERCEPTOR_KEY];
+			installed = true;
+		}
+		holder[INTERCEPTOR_KEY] = interceptor;
+		queueFake.clear();
+	},
+	/** Stop recording; dispatches reach the broker again. */
+	restore() {
+		if (!installed) return;
+		globalThis[INTERCEPTOR_KEY] = previous;
+		previous = void 0;
+		installed = false;
+		queueFake.clear();
+	},
+	isInstalled() {
+		return installed;
+	},
+	/** Forget recorded jobs. */
+	clear() {
+		pushed.length = 0;
+		sequence = 0;
+	},
+	/** Recorded jobs, oldest first; optionally only one job type. */
+	pushed(job, matcher) {
+		return pushed.filter((entry) => (job === void 0 || entry.name === nameOf(job)) && matches(entry, matcher));
+	},
+	/** Assert `job` was pushed (with a payload matching `matcher`); returns the first match. */
+	assertPushed(job, matcher) {
+		const found = queueFake.pushed(job, matcher)[0];
+		if (!found) throw new FakeAssertionError(`Expected ${nameOf(job)} to be pushed${matcher === void 0 ? "" : " with a matching payload"}. ${describeRecorded(pushed, describeJob, "pushed")}`);
+		return found;
+	},
+	/** Assert `job` was not pushed (with a matching payload). */
+	assertNotPushed(job, matcher) {
+		const found = queueFake.pushed(job, matcher);
+		if (found.length > 0) throw new FakeAssertionError(`Expected ${nameOf(job)} not to be pushed. ${describeRecorded(found, describeJob, "pushed")}`);
+	},
+	/** Assert exactly `count` jobs were pushed — of type `job` when given. */
+	assertPushedCount(count, job) {
+		const found = queueFake.pushed(job);
+		if (found.length !== count) throw new FakeAssertionError(`Expected ${count} ${job === void 0 ? "job(s)" : nameOf(job)} pushed, found ${found.length}. ${describeRecorded(pushed, describeJob, "pushed")}`);
+	},
+	/** Assert nothing was pushed. */
+	assertNothingPushed() {
+		queueFake.assertPushedCount(0);
+	}
+};
+
+//#endregion
+export { queueFake };
+//# sourceMappingURL=queue-fake.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-fake.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/queue-fake.ts"],"sourcesContent":["import { clock } from \"../../utils/clock\";\nimport { FakeAssertionError, describeRecorded } from \"./fake-assertion-error\";\n\n/**\n * One job `dispatch()`ed while the fake was installed.\n *\n * Structural on purpose: core has no dependency on `@warlock.js/queue`. The\n * fake talks to it through the global dispatch-interceptor slot that package\n * reads (`setDispatchInterceptor`).\n */\nexport type PushedJob = {\n  id: string;\n  name: string;\n  queue: string;\n  payload: unknown;\n  /** The dispatch options (`delay`, `priority`, `jobId`, ...). */\n  options: Record<string, unknown>;\n  pushedAt: Date;\n};\n\n/** A job name, or anything with a `name` — the object `defineJob()` returns. */\nexport type JobReference = string | { readonly name: string };\n\n/** Which pushed jobs an assertion is about: a predicate, or a payload subset. */\nexport type PushedJobMatcher = ((job: PushedJob) => boolean) | Record<string, unknown>;\n\nconst INTERCEPTOR_KEY = Symbol.for(\"warlock.queue.dispatchInterceptor\");\n\ntype Interceptor = {\n  dispatch(job: {\n    name: string;\n    queue: string;\n    payload: unknown;\n    options: Record<string, unknown>;\n  }): { id: string; name: string; queue: string };\n  find(job: { name: string; id: string }): unknown;\n};\n\ntype InterceptorHolder = { [INTERCEPTOR_KEY]?: Interceptor };\n\nconst pushed: PushedJob[] = [];\nlet sequence = 0;\nlet previous: Interceptor | undefined;\nlet installed = false;\n\nfunction nameOf(job: JobReference): string {\n  return typeof job === \"string\" ? job : job.name;\n}\n\nfunction isSubset(expected: unknown, actual: unknown): boolean {\n  if (expected === actual) return true;\n  if (typeof expected !== \"object\" || expected === null) return false;\n  if (typeof actual !== \"object\" || actual === null) return false;\n\n  return Object.entries(expected).every(([key, value]) =>\n    isSubset(value, (actual as Record<string, unknown>)[key]),\n  );\n}\n\nfunction matches(job: PushedJob, matcher: PushedJobMatcher | undefined): boolean {\n  if (matcher === undefined) return true;\n  if (typeof matcher === \"function\") return matcher(job);\n\n  return isSubset(matcher, job.payload);\n}\n\nfunction describeJob(job: PushedJob): string {\n  return `${job.name} on \"${job.queue}\" with ${JSON.stringify(job.payload)}`;\n}\n\nconst interceptor: Interceptor = {\n  dispatch({ name, queue, payload, options }) {\n    // An explicit jobId makes a real dispatch idempotent; keep that contract.\n    const explicitId = typeof options.jobId === \"string\" ? options.jobId : undefined;\n    const existing = explicitId ? pushed.find((job) => job.id === explicitId) : undefined;\n\n    if (existing) return { id: existing.id, name: existing.name, queue: existing.queue };\n\n    sequence += 1;\n\n    const job: PushedJob = {\n      id: explicitId ?? `fake-${sequence}`,\n      name,\n      queue,\n      payload,\n      options: { ...options },\n      pushedAt: clock.now(),\n    };\n\n    pushed.push(job);\n\n    return { id: job.id, name, queue };\n  },\n\n  find({ name, id }) {\n    const job = pushed.find((entry) => entry.id === id && entry.name === name);\n\n    if (!job) return undefined;\n\n    return {\n      id: job.id,\n      name: job.name,\n      queue: job.queue,\n      state: \"waiting\",\n      payload: job.payload,\n      progress: 0,\n      attemptsMade: 0,\n      createdAt: job.pushedAt,\n    };\n  },\n};\n\n/**\n * Records every `@warlock.js/queue` dispatch instead of pushing it to Redis.\n *\n * Installed by default in the test environment. Jobs are recorded, not run:\n * call the job's handler directly to test what it does.\n *\n * @example\n * await placeOrder(order);\n *\n * queueFake.assertPushed(sendInvoice, { orderId: order.id });\n * queueFake.assertPushedCount(1);\n */\nexport const queueFake = {\n  /** Start recording (idempotent). Clears anything recorded before. */\n  install(): void {\n    const holder = globalThis as InterceptorHolder;\n\n    if (!installed) {\n      previous = holder[INTERCEPTOR_KEY];\n      installed = true;\n    }\n\n    holder[INTERCEPTOR_KEY] = interceptor;\n    queueFake.clear();\n  },\n\n  /** Stop recording; dispatches reach the broker again. */\n  restore(): void {\n    if (!installed) return;\n\n    (globalThis as InterceptorHolder)[INTERCEPTOR_KEY] = previous;\n    previous = undefined;\n    installed = false;\n    queueFake.clear();\n  },\n\n  isInstalled(): boolean {\n    return installed;\n  },\n\n  /** Forget recorded jobs. */\n  clear(): void {\n    pushed.length = 0;\n    sequence = 0;\n  },\n\n  /** Recorded jobs, oldest first; optionally only one job type. */\n  pushed(job?: JobReference, matcher?: PushedJobMatcher): PushedJob[] {\n    return pushed.filter(\n      (entry) => (job === undefined || entry.name === nameOf(job)) && matches(entry, matcher),\n    );\n  },\n\n  /** Assert `job` was pushed (with a payload matching `matcher`); returns the first match. */\n  assertPushed(job: JobReference, matcher?: PushedJobMatcher): PushedJob {\n    const found = queueFake.pushed(job, matcher)[0];\n\n    if (!found) {\n      throw new FakeAssertionError(\n        `Expected ${nameOf(job)} to be pushed${matcher === undefined ? \"\" : \" with a matching payload\"}. ${describeRecorded(pushed, describeJob, \"pushed\")}`,\n      );\n    }\n\n    return found;\n  },\n\n  /** Assert `job` was not pushed (with a matching payload). */\n  assertNotPushed(job: JobReference, matcher?: PushedJobMatcher): void {\n    const found = queueFake.pushed(job, matcher);\n\n    if (found.length > 0) {\n      throw new FakeAssertionError(\n        `Expected ${nameOf(job)} not to be pushed. ${describeRecorded(found, describeJob, \"pushed\")}`,\n      );\n    }\n  },\n\n  /** Assert exactly `count` jobs were pushed — of type `job` when given. */\n  assertPushedCount(count: number, job?: JobReference): void {\n    const found = queueFake.pushed(job);\n\n    if (found.length !== count) {\n      throw new FakeAssertionError(\n        `Expected ${count} ${job === undefined ? \"job(s)\" : nameOf(job)} pushed, found ${found.length}. ${describeRecorded(pushed, describeJob, \"pushed\")}`,\n      );\n    }\n  },\n\n  /** Assert nothing was pushed. */\n  assertNothingPushed(): void {\n    queueFake.assertPushedCount(0);\n  },\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,31 @@
+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
+ * local temporary directory.
+ *
+ * Installed by default in the test environment: uploads and `storage.put()`
+ * calls land on disk under one temp root (a folder per driver name), never in
+ * a bucket and never in the app's real `storage/` folder. The root is shared
+ * with the HTTP test server, so a file an HTTP request stored is visible to
+ * the test that sent it. The process that created the root deletes it on
+ * restore.
+ *
+ * @example
+ * await uploadAvatar(user, file);
+ *
+ * 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. */
+  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. */
+  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

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

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

@@ -0,0 +1,122 @@
+import { storageConfigurations } from "../../storage/config.mjs";
+import { storage } from "../../storage/storage.mjs";
+import "../../storage/index.mjs";
+import { FakeAssertionError } from "./fake-assertion-error.mjs";
+import path from "node:path";
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, rmSync } from "node:fs";
+import os from "node:os";
+
+//#region ../../packages/core/src/tests/fakes/storage-fake.ts
+/**
+* The env var that carries the fake storage root from the process that
+* created it (the HTTP test server, in `globalSetup`) to the test workers it
+* spawns, so both sides read and write the same files. Like
+* `WARLOCK_TEST_SERVER_PORT`, it is plumbing between the kit's own processes.
+*/
+const TEST_STORAGE_ROOT_ENV_KEY = "WARLOCK_TEST_STORAGE_ROOT";
+let root;
+let ownsRoot = false;
+let installed = false;
+let wasInitialized = false;
+function currentRoot() {
+	if (!root) throw new FakeAssertionError("storageFake is not installed. It installs by default in the test environment; check `tests.fakes` in src/config/tests.ts, or call storageFake.install().");
+	return root;
+}
+function listFiles(directory, base) {
+	if (!existsSync(directory)) return [];
+	return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+		const absolute = path.join(directory, entry.name);
+		return entry.isDirectory() ? listFiles(absolute, base) : [path.relative(base, absolute).split(path.sep).join("/")];
+	});
+}
+/**
+* Points every configured storage driver — local, S3, R2, Spaces — at a
+* local temporary directory.
+*
+* Installed by default in the test environment: uploads and `storage.put()`
+* calls land on disk under one temp root (a folder per driver name), never in
+* a bucket and never in the app's real `storage/` folder. The root is shared
+* with the HTTP test server, so a file an HTTP request stored is visible to
+* the test that sent it. The process that created the root deletes it on
+* restore.
+*
+* @example
+* await uploadAvatar(user, file);
+*
+* await storageFake.assertExists(`avatars/${user.id}.png`);
+*/
+const storageFake = {
+	/** Re-register every driver as a local one under the temp root. */
+	async install() {
+		if (!installed) {
+			wasInitialized = storage.isInitialized;
+			installed = true;
+		}
+		if (!root) {
+			const shared = process.env[TEST_STORAGE_ROOT_ENV_KEY];
+			if (shared) {
+				root = shared;
+				ownsRoot = false;
+			} else {
+				root = mkdtempSync(path.join(os.tmpdir(), "warlock-test-storage-"));
+				ownsRoot = true;
+				process.env[TEST_STORAGE_ROOT_ENV_KEY] = root;
+			}
+		}
+		await storage.init();
+		const fakeRoot = root;
+		for (const name of storage.driverNames()) {
+			const driverRoot = path.join(fakeRoot, name);
+			mkdirSync(driverRoot, { recursive: true });
+			storage.register(name, storageConfigurations.local({
+				root: driverRoot,
+				urlPrefix: `/test-storage/${name}`
+			}));
+		}
+		const defaultName = storage.getDefaultName();
+		if (defaultName) storage.setDefault(defaultName);
+	},
+	/** Drop the fake drivers; the real configuration is read again on next use. */
+	async restore() {
+		if (!installed) return;
+		installed = false;
+		storage.reset();
+		if (wasInitialized) await storage.init();
+		if (root && ownsRoot) {
+			rmSync(root, {
+				recursive: true,
+				force: true
+			});
+			if (process.env["WARLOCK_TEST_STORAGE_ROOT"] === root) delete process.env[TEST_STORAGE_ROOT_ENV_KEY];
+		}
+		root = void 0;
+		ownsRoot = false;
+	},
+	isInstalled() {
+		return installed;
+	},
+	/** The temp directory every fake driver lives under. */
+	root() {
+		return currentRoot();
+	},
+	/** Every stored file, as `<driver>/<path>`, sorted. */
+	files(driver) {
+		const base = currentRoot();
+		const directory = driver ? path.join(base, driver) : base;
+		return listFiles(directory, directory).sort();
+	},
+	/** Assert a file exists, on the default driver unless `driver` is given. */
+	async assertExists(location, driver) {
+		currentRoot();
+		if (!await (driver ? storage.use(driver) : storage).exists(location)) throw new FakeAssertionError(`Expected ${JSON.stringify(location)} to be stored${driver ? ` on "${driver}"` : ""}. Stored files: ${JSON.stringify(storageFake.files())}.`);
+	},
+	/** Assert a file does not exist, on the default driver unless `driver` is given. */
+	async assertMissing(location, driver) {
+		currentRoot();
+		if (await (driver ? storage.use(driver) : storage).exists(location)) throw new FakeAssertionError(`Expected ${JSON.stringify(location)} not to be stored${driver ? ` on "${driver}"` : ""}, but it is.`);
+	}
+};
+
+//#endregion
+export { storageFake };
+//# sourceMappingURL=storage-fake.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-fake.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tests/fakes/storage-fake.ts"],"sourcesContent":["import { existsSync, mkdirSync, mkdtempSync, readdirSync, rmSync } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { storage } from \"../../storage\";\nimport { storageConfigurations } from \"../../storage/config\";\nimport type { StorageDriverName } from \"../../storage/types\";\nimport { FakeAssertionError } from \"./fake-assertion-error\";\n\n/**\n * The env var that carries the fake storage root from the process that\n * created it (the HTTP test server, in `globalSetup`) to the test workers it\n * spawns, so both sides read and write the same files. Like\n * `WARLOCK_TEST_SERVER_PORT`, it is plumbing between the kit's own processes.\n */\nexport const TEST_STORAGE_ROOT_ENV_KEY = \"WARLOCK_TEST_STORAGE_ROOT\";\n\nlet root: string | undefined;\nlet ownsRoot = false;\nlet installed = false;\nlet wasInitialized = false;\n\nfunction currentRoot(): string {\n  if (!root) {\n    throw new FakeAssertionError(\n      \"storageFake is not installed. It installs by default in the test environment; check `tests.fakes` in src/config/tests.ts, or call storageFake.install().\",\n    );\n  }\n\n  return root;\n}\n\nfunction listFiles(directory: string, base: string): string[] {\n  if (!existsSync(directory)) return [];\n\n  return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {\n    const absolute = path.join(directory, entry.name);\n\n    return entry.isDirectory()\n      ? listFiles(absolute, base)\n      : [path.relative(base, absolute).split(path.sep).join(\"/\")];\n  });\n}\n\n/**\n * Points every configured storage driver — local, S3, R2, Spaces — at a\n * local temporary directory.\n *\n * Installed by default in the test environment: uploads and `storage.put()`\n * calls land on disk under one temp root (a folder per driver name), never in\n * a bucket and never in the app's real `storage/` folder. The root is shared\n * with the HTTP test server, so a file an HTTP request stored is visible to\n * the test that sent it. The process that created the root deletes it on\n * restore.\n *\n * @example\n * await uploadAvatar(user, file);\n *\n * await storageFake.assertExists(`avatars/${user.id}.png`);\n */\nexport const storageFake = {\n  /** Re-register every driver as a local one under the temp root. */\n  async install(): Promise<void> {\n    if (!installed) {\n      wasInitialized = storage.isInitialized;\n      installed = true;\n    }\n\n    if (!root) {\n      const shared = process.env[TEST_STORAGE_ROOT_ENV_KEY];\n\n      if (shared) {\n        root = shared;\n        ownsRoot = false;\n      } else {\n        root = mkdtempSync(path.join(os.tmpdir(), \"warlock-test-storage-\"));\n        ownsRoot = true;\n        process.env[TEST_STORAGE_ROOT_ENV_KEY] = root;\n      }\n    }\n\n    await storage.init();\n\n    const fakeRoot = root;\n\n    for (const name of storage.driverNames()) {\n      const driverRoot = path.join(fakeRoot, name);\n\n      mkdirSync(driverRoot, { recursive: true });\n      storage.register(\n        name,\n        storageConfigurations.local({ root: driverRoot, urlPrefix: `/test-storage/${name}` }),\n      );\n    }\n\n    const defaultName = storage.getDefaultName();\n\n    if (defaultName) storage.setDefault(defaultName);\n  },\n\n  /** Drop the fake drivers; the real configuration is read again on next use. */\n  async restore(): Promise<void> {\n    if (!installed) return;\n\n    installed = false;\n    storage.reset();\n\n    if (wasInitialized) await storage.init();\n\n    if (root && ownsRoot) {\n      rmSync(root, { recursive: true, force: true });\n\n      if (process.env[TEST_STORAGE_ROOT_ENV_KEY] === root) {\n        delete process.env[TEST_STORAGE_ROOT_ENV_KEY];\n      }\n    }\n\n    root = undefined;\n    ownsRoot = false;\n  },\n\n  isInstalled(): boolean {\n    return installed;\n  },\n\n  /** The temp directory every fake driver lives under. */\n  root(): string {\n    return currentRoot();\n  },\n\n  /** Every stored file, as `<driver>/<path>`, sorted. */\n  files(driver?: StorageDriverName): string[] {\n    const base = currentRoot();\n    const directory = driver ? path.join(base, driver) : base;\n\n    return listFiles(directory, directory).sort();\n  },\n\n  /** Assert a file exists, on the default driver unless `driver` is given. */\n  async assertExists(location: string, driver?: StorageDriverName): Promise<void> {\n    currentRoot();\n\n    const target = driver ? storage.use(driver) : storage;\n\n    if (!(await target.exists(location))) {\n      throw new FakeAssertionError(\n        `Expected ${JSON.stringify(location)} to be stored${driver ? ` on \"${driver}\"` : \"\"}. Stored files: ${JSON.stringify(storageFake.files())}.`,\n      );\n    }\n  },\n\n  /** Assert a file does not exist, on the default driver unless `driver` is given. */\n  async assertMissing(location: string, driver?: StorageDriverName): Promise<void> {\n    currentRoot();\n\n    const target = driver ? storage.use(driver) : storage;\n\n    if (await target.exists(location)) {\n      throw new FakeAssertionError(\n        `Expected ${JSON.stringify(location)} not to be stored${driver ? ` on \"${driver}\"` : \"\"}, but it is.`,\n      );\n    }\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,4BAA4B;AAEzC,IAAI;AACJ,IAAI,WAAW;AACf,IAAI,YAAY;AAChB,IAAI,iBAAiB;AAErB,SAAS,cAAsB;CAC7B,IAAI,CAAC,MACH,MAAM,IAAI,mBACR,0JACF;CAGF,OAAO;AACT;AAEA,SAAS,UAAU,WAAmB,MAAwB;CAC5D,IAAI,CAAC,WAAW,SAAS,GAAG,OAAO,CAAC;CAEpC,OAAO,YAAY,WAAW,EAAE,eAAe,KAAK,CAAC,CAAC,CAAC,SAAS,UAAU;EACxE,MAAM,WAAW,KAAK,KAAK,WAAW,MAAM,IAAI;EAEhD,OAAO,MAAM,YAAY,IACrB,UAAU,UAAU,IAAI,IACxB,CAAC,KAAK,SAAS,MAAM,QAAQ,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;CAC9D,CAAC;AACH;;;;;;;;;;;;;;;;;AAkBA,MAAa,cAAc;;CAEzB,MAAM,UAAyB;EAC7B,IAAI,CAAC,WAAW;GACd,iBAAiB,QAAQ;GACzB,YAAY;EACd;EAEA,IAAI,CAAC,MAAM;GACT,MAAM,SAAS,QAAQ,IAAI;GAE3B,IAAI,QAAQ;IACV,OAAO;IACP,WAAW;GACb,OAAO;IACL,OAAO,YAAY,KAAK,KAAK,GAAG,OAAO,GAAG,uBAAuB,CAAC;IAClE,WAAW;IACX,QAAQ,IAAI,6BAA6B;GAC3C;EACF;EAEA,MAAM,QAAQ,KAAK;EAEnB,MAAM,WAAW;EAEjB,KAAK,MAAM,QAAQ,QAAQ,YAAY,GAAG;GACxC,MAAM,aAAa,KAAK,KAAK,UAAU,IAAI;GAE3C,UAAU,YAAY,EAAE,WAAW,KAAK,CAAC;GACzC,QAAQ,SACN,MACA,sBAAsB,MAAM;IAAE,MAAM;IAAY,WAAW,iBAAiB;GAAO,CAAC,CACtF;EACF;EAEA,MAAM,cAAc,QAAQ,eAAe;EAE3C,IAAI,aAAa,QAAQ,WAAW,WAAW;CACjD;;CAGA,MAAM,UAAyB;EAC7B,IAAI,CAAC,WAAW;EAEhB,YAAY;EACZ,QAAQ,MAAM;EAEd,IAAI,gBAAgB,MAAM,QAAQ,KAAK;EAEvC,IAAI,QAAQ,UAAU;GACpB,OAAO,MAAM;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;GAE7C,IAAI,QAAQ,qCAAmC,MAC7C,OAAO,QAAQ,IAAI;EAEvB;EAEA,OAAO;EACP,WAAW;CACb;CAEA,cAAuB;EACrB,OAAO;CACT;;CAGA,OAAe;EACb,OAAO,YAAY;CACrB;;CAGA,MAAM,QAAsC;EAC1C,MAAM,OAAO,YAAY;EACzB,MAAM,YAAY,SAAS,KAAK,KAAK,MAAM,MAAM,IAAI;EAErD,OAAO,UAAU,WAAW,SAAS,CAAC,CAAC,KAAK;CAC9C;;CAGA,MAAM,aAAa,UAAkB,QAA2C;EAC9E,YAAY;EAIZ,IAAI,CAAE,OAFS,SAAS,QAAQ,IAAI,MAAM,IAAI,QAE5B,CAAC,OAAO,QAAQ,GAChC,MAAM,IAAI,mBACR,YAAY,KAAK,UAAU,QAAQ,EAAE,eAAe,SAAS,QAAQ,OAAO,KAAK,GAAG,kBAAkB,KAAK,UAAU,YAAY,MAAM,CAAC,EAAE,EAC5I;CAEJ;;CAGA,MAAM,cAAc,UAAkB,QAA2C;EAC/E,YAAY;EAIZ,IAAI,OAFW,SAAS,QAAQ,IAAI,MAAM,IAAI,QAE9B,CAAC,OAAO,QAAQ,GAC9B,MAAM,IAAI,mBACR,YAAY,KAAK,UAAU,QAAQ,EAAE,mBAAmB,SAAS,QAAQ,OAAO,KAAK,GAAG,aAC1F;CAEJ;AACF"}