@classytic/arc 2.31.0 → 2.32.0

package/dist/testing/outboxStoreContract.mjs

@@ -1,6 +1,6 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
 import { OutboxOwnershipError } from "@classytic/primitives/outbox";
-import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
 //#region src/testing/outboxStoreContract.ts
 let seq = 0;
 /** A minimal well-formed event. Ids are unique per call. */
@@ -30,9 +30,16 @@ function runOutboxStoreContract(name, setup) {
 		afterAll(async () => {
 			if (teardown) await teardown();
 		});
+		/**
+		* Isolation for EVERY test, not just the ones that call `seed()`. Resetting inside
+		* `seed()` left any test that asserts on an empty store — or that only reads —
+		* running against its predecessor's rows.
+		*/
+		beforeEach(async () => {
+			await reset();
+		});
 		/** Save n events, oldest first. */
 		async function seed(n, type) {
-			if (reset) await reset();
 			const events = [];
 			for (let i = 0; i < n; i++) {
 				const e = event(type);
@@ -44,10 +51,10 @@ function runOutboxStoreContract(name, setup) {
 		describe("save — rejects malformed events (invariant 1)", () => {
 			it("persists a well-formed event", async () => {
 				const [e] = await seed(1);
-				expect((await store.getPending(10)).map(idOf)).toContain(idOf(e));
+				const pending = await store.getPending(10);
+				expect(pending.map(idOf)).toContain(idOf(e));
 			});
 			it("THROWS rather than persisting an event with no `type`", async () => {
-				if (reset) await reset();
 				await expect(store.save({
 					payload: {},
 					meta: { id: "no-type" }
@@ -55,7 +62,6 @@ function runOutboxStoreContract(name, setup) {
 				expect((await store.getPending(10)).length).toBe(0);
 			});
 			it("THROWS rather than persisting an event with no `meta.id`", async () => {
-				if (reset) await reset();
 				await expect(store.save({
 					type: "x",
 					payload: {},
@@ -67,7 +73,8 @@ function runOutboxStoreContract(name, setup) {
 		describe("getPending", () => {
 			it("returns events FIFO (oldest first)", async () => {
 				const saved = await seed(3);
-				expect((await store.getPending(10)).slice(0, 3).map(idOf)).toEqual(saved.map(idOf));
+				const pending = await store.getPending(10);
+				expect(pending.slice(0, 3).map(idOf)).toEqual(saved.map(idOf));
 			});
 			it("honours the limit", async () => {
 				await seed(3);
@@ -86,10 +93,11 @@ function runOutboxStoreContract(name, setup) {
 			it("claims pending events", async ({ skip }) => {
 				if (!store.claimPending) return skip();
 				await seed(2);
-				expect((await store.claimPending({
+				const claimed = await store.claimPending({
 					consumerId: "c1",
 					limit: 10
-				})).length).toBe(2);
+				});
+				expect(claimed.length).toBe(2);
 			});
 			it("two concurrent claimers NEVER receive the same event", async ({ skip }) => {
 				if (!store.claimPending) return skip();
@@ -103,7 +111,8 @@ function runOutboxStoreContract(name, setup) {
 				})]);
 				const idsA = a.map(idOf);
 				const idsB = b.map(idOf);
-				expect(idsA.filter((id) => idsB.includes(id))).toEqual([]);
+				const overlap = idsA.filter((id) => idsB.includes(id));
+				expect(overlap).toEqual([]);
 				expect(idsA.length + idsB.length).toBeLessThanOrEqual(6);
 			});
 			it("does not re-claim an event whose lease is still live", async ({ skip }) => {
@@ -114,10 +123,11 @@ function runOutboxStoreContract(name, setup) {
 					limit: 10,
 					leaseMs: 6e4
 				});
-				expect(await store.claimPending({
+				const second = await store.claimPending({
 					consumerId: "c2",
 					limit: 10
-				})).toEqual([]);
+				});
+				expect(second).toEqual([]);
 			});
 			it("RECLAIMS an event whose lease expired (crashed worker)", async ({ skip }) => {
 				if (!store.claimPending) return skip();
@@ -127,18 +137,20 @@ function runOutboxStoreContract(name, setup) {
 					limit: 10,
 					leaseMs: 0
 				});
-				expect((await store.claimPending({
+				const reclaimed = await store.claimPending({
 					consumerId: "c2",
 					limit: 10
-				})).length).toBe(1);
+				});
+				expect(reclaimed.length).toBe(1);
 			});
 			it("claims FIFO", async ({ skip }) => {
 				if (!store.claimPending) return skip();
 				const saved = await seed(3);
-				expect((await store.claimPending({
+				const claimed = await store.claimPending({
 					consumerId: "c1",
 					limit: 2
-				})).map(idOf)).toEqual(saved.slice(0, 2).map(idOf));
+				});
+				expect(claimed.map(idOf)).toEqual(saved.slice(0, 2).map(idOf));
 			});
 		});
 		describe("acknowledge", () => {
@@ -148,7 +160,6 @@ function runOutboxStoreContract(name, setup) {
 				expect((await store.getPending(10)).map(idOf)).not.toContain(idOf(e));
 			});
 			it("is a NO-OP for an unknown id — never an ownership error (invariant 4)", async () => {
-				if (reset) await reset();
 				await expect(store.acknowledge("does-not-exist")).resolves.not.toThrow();
 			});
 			it("THROWS OutboxOwnershipError when consumerId is not the lease owner (invariant 3)", async ({ skip }) => {
@@ -185,10 +196,11 @@ function runOutboxStoreContract(name, setup) {
 				});
 				if (!claimed) return skip();
 				await store.fail(idOf(claimed), { message: "boom" });
-				expect((await store.claimPending({
+				const again = await store.claimPending({
 					consumerId: "c2",
 					limit: 10
-				})).map(idOf)).toContain(idOf(claimed));
+				});
+				expect(again.map(idOf)).toContain(idOf(claimed));
 			});
 			it("THROWS OutboxOwnershipError on a consumerId mismatch (invariant 3)", async ({ skip }) => {
 				if (!store.fail || !store.claimPending) return skip();
@@ -211,10 +223,11 @@ function runOutboxStoreContract(name, setup) {
 				});
 				if (!claimed) return skip();
 				await store.fail(idOf(claimed), { message: "boom" }, { retryAt: new Date(Date.now() + 6e4) });
-				expect((await store.claimPending({
+				const again = await store.claimPending({
 					consumerId: "c2",
 					limit: 10
-				})).map(idOf)).not.toContain(idOf(claimed));
+				});
+				expect(again.map(idOf)).not.toContain(idOf(claimed));
 			});
 			it("`deadLetter: true` removes it from the pending stream", async ({ skip }) => {
 				if (!store.fail) return skip();
@@ -242,6 +255,82 @@ function runOutboxStoreContract(name, setup) {
 				expect((await store.getPending(10)).length).toBe(2);
 			});
 		});
+		/**
+		* `requeue`, `countByStatus` and `oldestPendingAgeMs` were a HOST's three extra
+		* methods before they were contract members — which is why they are pinned here.
+		* A dead-letter row an operator cannot re-drive, or a health number that lies, fails
+		* silently: the operator concludes the queue is fine, and the whole point of the
+		* table is that somebody eventually looks.
+		*/
+		describe("requeue", () => {
+			it("returns a dead-lettered event to pending and clears the attempt count", async ({ skip }) => {
+				if (!store.fail || !store.requeue) return skip();
+				const [e] = await seed(1);
+				const id = idOf(e);
+				await store.fail(id, { message: "fatal" }, { deadLetter: true });
+				expect((await store.getPending(10)).length).toBe(0);
+				expect(await store.requeue(id)).toBe(true);
+				const pending = await store.getPending(10);
+				expect(pending.length).toBe(1);
+				if (store.countByStatus) expect(await store.countByStatus("dead_letter")).toBe(0);
+			});
+			it("REFUSES a pending event — requeue is dead-letter-scoped", async ({ skip }) => {
+				if (!store.requeue) return skip();
+				const [e] = await seed(1);
+				expect(await store.requeue(idOf(e))).toBe(false);
+			});
+			it("is FALSE, not an error, for an unknown id", async ({ skip }) => {
+				if (!store.requeue) return skip();
+				expect(await store.requeue("no-such-event")).toBe(false);
+			});
+		});
+		describe("countByStatus", () => {
+			it("counts pending, and moves the count as events are delivered", async ({ skip }) => {
+				if (!store.countByStatus) return skip();
+				await seed(3);
+				expect(await store.countByStatus("pending")).toBe(3);
+				if (!store.claimPending) return skip();
+				const [claimed] = await store.claimPending({
+					consumerId: "c",
+					limit: 1,
+					leaseMs: 6e4
+				});
+				if (!claimed) return skip();
+				await store.acknowledge(idOf(claimed), { consumerId: "c" });
+				expect(await store.countByStatus("pending")).toBe(2);
+				expect(await store.countByStatus("delivered")).toBe(1);
+			});
+			it("counts dead-lettered rows — the number an alert fires on", async ({ skip }) => {
+				if (!store.countByStatus || !store.fail) return skip();
+				expect(await store.countByStatus("dead_letter")).toBe(0);
+				const [e] = await seed(1);
+				await store.fail(idOf(e), { message: "fatal" }, { deadLetter: true });
+				expect(await store.countByStatus("dead_letter")).toBe(1);
+			});
+		});
+		describe("oldestPendingAgeMs", () => {
+			it("is null on an empty queue, and a non-negative age once something pends", async ({ skip }) => {
+				if (!store.oldestPendingAgeMs) return skip();
+				expect(await store.oldestPendingAgeMs()).toBeNull();
+				await seed(1);
+				const age = await store.oldestPendingAgeMs();
+				expect(age).not.toBeNull();
+				expect(age ?? -1).toBeGreaterThanOrEqual(0);
+			});
+			it("ignores DELIVERED rows — it answers 'how long undelivered', not 'how old'", async ({ skip }) => {
+				if (!store.oldestPendingAgeMs) return skip();
+				if (!store.claimPending) return skip();
+				await seed(1);
+				const [claimed] = await store.claimPending({
+					consumerId: "c",
+					limit: 1,
+					leaseMs: 6e4
+				});
+				if (!claimed) return skip();
+				await store.acknowledge(idOf(claimed), { consumerId: "c" });
+				expect(await store.oldestPendingAgeMs()).toBeNull();
+			});
+		});
 	});
 }
 //#endregion

package/dist/testing/storageContract.mjs

@@ -1,4 +1,4 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
 //#region src/testing/storageContract.ts
 /**
@@ -89,7 +89,8 @@ function runStorageContract(name, setup) {
 				size: bytes.length
 			}, EMPTY_CTX);
 			const read = await storage.read(file.id, EMPTY_CTX);
-			expect((await readAll(read)).equals(bytes)).toBe(true);
+			const actual = await readAll(read);
+			expect(actual.equals(bytes)).toBe(true);
 			expect(read.contentType).toBe("application/octet-stream");
 			await storage.delete(file.id, EMPTY_CTX);
 		});
@@ -101,7 +102,8 @@ function runStorageContract(name, setup) {
 				mimeType: "application/octet-stream",
 				size: bytes.length
 			}, EMPTY_CTX);
-			expect(await storage.delete(file.id, EMPTY_CTX)).toBe(true);
+			const first = await storage.delete(file.id, EMPTY_CTX);
+			expect(first).toBe(true);
 			let second = "threw";
 			try {
 				second = await storage.delete(file.id, EMPTY_CTX);
@@ -169,8 +171,10 @@ function runStorageContract(name, setup) {
 				mimeType: "application/octet-stream",
 				size: bytes.length
 			}, EMPTY_CTX);
-			expect((await readAll(await storage.read(file.id, EMPTY_CTX))).equals(bytes)).toBe(true);
-			expect(await storage.delete(file.id, EMPTY_CTX)).toBe(true);
+			const before = await readAll(await storage.read(file.id, EMPTY_CTX));
+			expect(before.equals(bytes)).toBe(true);
+			const removed = await storage.delete(file.id, EMPTY_CTX);
+			expect(removed).toBe(true);
 			let rejected = false;
 			try {
 				if (!(await readAll(await storage.read(file.id, EMPTY_CTX))).equals(bytes)) rejected = true;
@@ -189,7 +193,8 @@ function runStorageContract(name, setup) {
 			}, EMPTY_CTX);
 			const result = await storage.read(file.id, EMPTY_CTX);
 			expect(result.kind === "stream" || result.kind === "buffer").toBe(true);
-			expect((await readAll(result)).equals(bytes)).toBe(true);
+			const actual = await readAll(result);
+			expect(actual.equals(bytes)).toBe(true);
 			await storage.delete(file.id, EMPTY_CTX);
 		});
 		it("read() with a mid-object range slices correctly (when adapter supports ranges)", async () => {

package/dist/{transactionContext-dAfBVUrk.mjs → transactionContext-BvLKvOIL.mjs}

@@ -1,4 +1,4 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/context/transactionContext.ts
 /**

package/dist/{typeGuards-B0ryPo3I.mjs → typeGuards-B_5-hKjJ.mjs}

@@ -1,4 +1,4 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
 //#region src/utils/typeGuards.ts
 /** Check if fastify has the events plugin registered */
 function hasEvents(instance) {

package/dist/types/index.mjs

@@ -1,2 +1,2 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
 export {};

package/dist/types/storage.mjs

@@ -1,2 +1,2 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
 export {};

package/dist/{types-CBgvkp8O.d.mts → types-CT5vu6M0.d.mts}

@@ -320,6 +320,26 @@ interface LoadResourcesOptions<TContext = unknown> {
  */
 declare function loadResources<TContext = unknown>(dir: string, options?: LoadResourcesOptions<TContext>): Promise<ResourceLike[]>;
 //#endregion
+//#region src/factory/module/disposers.d.ts
+/** Teardown callback registered by a setup phase via `defer`. */
+type ModuleDisposer = () => void | Promise<void>;
+/**
+ * Second argument to a module's setup phases (`plugins`, `bootstrap`,
+ * `afterResources`).
+ */
+interface ModuleSetupContext {
+  /**
+   * Register a teardown callback for the resource just acquired. Call it
+   * IMMEDIATELY after acquisition — that is what makes partial-init teardown
+   * exact rather than defensive.
+   *
+   * Disposers run LIFO, after this module's `onClose`, on both the rollback
+   * and shutdown paths, and exactly once. A throwing disposer is logged and
+   * never blocks the ones behind it.
+   */
+  defer(disposer: ModuleDisposer): void;
+}
+//#endregion
 //#region src/factory/module/types.d.ts
 /**
  * A module's contribution of some arm (event handlers, scheduled jobs, …).
@@ -430,8 +450,18 @@ interface ArcModule<TExports = unknown> {
    * published ecosystem packages: `plugins` = "register infra"; `bootstrap` =
    * "initialise engines (and return the public export)". Registering a plugin
    * inside `bootstrap` still works — this slot just makes the two distinct.
+   *
+   * Receives `{ defer }` to register teardown for anything it acquires, and
+   * may RETURN a single disposer as shorthand for the one-resource case:
+   *
+   * ```ts
+   * plugins: async (fastify) => {
+   *   const conn = await connect();
+   *   return () => conn.close();          // equivalent to defer(...)
+   * },
+   * ```
    */
-  plugins?: (fastify: FastifyInstance) => void | Promise<void>;
+  plugins?: (fastify: FastifyInstance, context: ModuleSetupContext) => ModuleDisposer | undefined | Promise<ModuleDisposer | undefined>;
   /**
    * Domain error mappers this module ships (see `defineErrorMapper`). Merged
    * into the app's error handler at boot, AFTER any host-declared mappers —
@@ -468,8 +498,23 @@ interface ArcModule<TExports = unknown> {
    * // arc-invoice bootstrap, composed AFTER arc-accounting:
    * const acct = getModuleExports<AccountingEngine>(fastify, "accounting");
    * ```
+   *
+   * The return value is the module's export, so teardown here goes through
+   * `defer` (the second argument) rather than a returned disposer — register
+   * each resource the moment it exists and partial-init cleanup becomes exact
+   * instead of a chain of `?.` guards:
+   *
+   * ```ts
+   * bootstrap: async (fastify, { defer }) => {
+   *   const client = await openClient();
+   *   defer(() => client.close());
+   *   const engine = await createEngine(client);   // if this throws, only
+   *   defer(() => engine.stop());                  // the client is released
+   *   return engine;
+   * },
+   * ```
    */
-  bootstrap?: (fastify: FastifyInstance) => TExports | Promise<TExports>;
+  bootstrap?: (fastify: FastifyInstance, context: ModuleSetupContext) => TExports | Promise<TExports>;
   /**
    * App-level resource NAMES this module authoritatively SUPERSEDES. When the
    * host also lists (or `resourceDir`-discovers) a resource of the same name,
@@ -489,18 +534,37 @@ interface ArcModule<TExports = unknown> {
    *     any fork exists.
    *   - Collected across ALL modules; the app-side supersession is their union.
    *
-   * **Contract (ENFORCED at boot): if you `owns` a name, PROVIDE it** — in
-   * THIS module's own `resources`. Arc resolves module resources first and
-   * fails boot when a claimed name is not among them, naming the module, the
-   * unmet names, and what it did supply. Without that check, a typo or a
-   * resource deleted without updating `owns` booted "successfully" with the
-   * app's route silently removed and nothing serving it.
+   * **Prefer `owns: "provided"`** (2.32) — arc derives the list from the
+   * resources this module actually returned, so the claim and the reality
+   * cannot disagree:
+   *
+   * ```ts
+   * defineModule({ name: "order", owns: "provided", resources: () => [...] })
+   * ```
+   *
+   * That is the whole arm for most modules. Resources are resolved exactly
+   * once, names are validated (duplicates within a module are rejected), the
+   * effective `owns` is derived, and supersession runs afterward — one atomic
+   * phase arc owns, rather than a rule each module re-states.
+   *
+   * **The explicit-array form is ENFORCED at boot: if you `owns` a name,
+   * PROVIDE it** — in THIS module's own `resources`. Arc fails boot when a
+   * claimed name is not among them, naming the module, the unmet names, and
+   * what it did supply. Without that check, a typo or a resource deleted
+   * without updating the list booted "successfully" with the app's route
+   * silently removed and nothing serving it. Two real cases, both silent 404s:
+   * a POS module claiming a checkout resource it mounted only when the host
+   * supplied a pipeline, and a device gateway claiming a name it never
+   * provided at all.
+   *
+   * Keep the explicit array only when the list is genuinely NOT the module's
+   * own resource set — e.g. pre-declaring a name before the fork exists.
    *
    * A sibling module supplying the name does NOT satisfy the claim — ownership
    * is local to the module that declares it, which is the colocation this arm
    * exists for.
    */
-  readonly owns?: readonly string[];
+  readonly owns?: readonly string[] | "provided";
   /**
    * The module's resources. Array or factory — the factory form runs AFTER all
    * bootstraps, so `defineResource(...)` receives fully-booted engines. Flows
@@ -512,8 +576,12 @@ interface ArcModule<TExports = unknown> {
    * Post-registration wiring — runs in the `afterResources` phase, once this
    * module's routes are mounted. Use for cross-resource event subscriptions the
    * module owns.
+   *
+   * Receives `{ defer }`, and may return a disposer, on the same terms as
+   * `plugins` — handy for wiring that must be unwound (a subscription, a
+   * listener) without hoisting a handle into module scope.
    */
-  afterResources?: (fastify: FastifyInstance) => void | Promise<void>;
+  afterResources?: (fastify: FastifyInstance, context: ModuleSetupContext) => ModuleDisposer | undefined | Promise<ModuleDisposer | undefined>;
   /**
    * Readiness checks this module contributes to the app's
    * `healthPlugin` (`/_health/ready`). Collected across ALL modules in
@@ -611,6 +679,14 @@ interface ArcModule<TExports = unknown> {
    *   onClose: async () => { await client?.close(); },  // still runs
    * });
    * ```
+   *
+   * Prefer `defer` (the setup phases' second argument) for anything acquired
+   * step-by-step: it registers each teardown at the point of acquisition, so
+   * the runtime knows exactly what was reached and the `?.` guards above
+   * disappear. `onClose` remains the right slot for tearing down what
+   * `bootstrap` RETURNED — the module's engine — and runs FIRST, ahead of the
+   * module's deferred disposers (see `disposers.ts` for the ordering rule).
+   * The two compose; either alone is complete.
    */
   onClose?: (fastify: FastifyInstance) => void | Promise<void>;
 }
@@ -657,4 +733,4 @@ type ArcModuleInput<TExports = unknown> = ArcModule<TExports> | Promise<ArcModul
  */
 interface ArcModuleRegistry {}
 //#endregion
-export { _default$1 as _, ModuleContribution as a, ResourceModule as c, ScheduleStats as d, SchedulesPluginOptions as f, HealthOptions as g, HealthCheck as h, EventHandlerDefinition as i, loadResources as l, schedulesPlugin as m, ArcModuleInput as n, LoadResourcesOptions as o, _default as p, ArcModuleRegistry as r, ResourceLike as s, ArcModule as t, ScheduleDefinition as u, healthPlugin as v };
+export { HealthCheck as _, ModuleContribution as a, healthPlugin as b, LoadResourcesOptions as c, loadResources as d, ScheduleDefinition as f, schedulesPlugin as g, _default as h, EventHandlerDefinition as i, ResourceLike as l, SchedulesPluginOptions as m, ArcModuleInput as n, ModuleDisposer as o, ScheduleStats as p, ArcModuleRegistry as r, ModuleSetupContext as s, ArcModule as t, ResourceModule as u, HealthOptions as v, _default$1 as y };

package/dist/{types-Cys0ko9Z.mjs → types-DXYX7dIR.mjs}

@@ -1,7 +1,7 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
-import { l as UnauthorizedError, o as OrgRequiredError } from "./errors-Cj42AntO.mjs";
-import { n as requireSingleHeaderValue } from "./headers-3zvE0rM3.mjs";
-import { t as getUserId$1 } from "./userHelpers-ChYJ6CdK.mjs";
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
+import { l as UnauthorizedError, o as OrgRequiredError } from "./errors-Bh1KK5ps.mjs";
+import { n as requireSingleHeaderValue } from "./headers-BXjQYbeC.mjs";
+import { t as getUserId$1 } from "./userHelpers-BNsOXzOd.mjs";
 //#region src/scope/types.ts
 /**
 * Request Scope — The One Standard

package/dist/{userHelpers-ChYJ6CdK.mjs → userHelpers-BNsOXzOd.mjs}

@@ -1,4 +1,4 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
 //#region src/utils/userHelpers.ts
 /**
 * Extract a user ID from a user object. Accepts `id` or `_id` — returns

package/dist/utils/index.mjs

@@ -1,11 +1,11 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
-import { a as OrgAccessDeniedError, c as ServiceUnavailableError, d as createDomainError, f as createError, i as NotFoundError, l as UnauthorizedError, n as ConflictError, o as OrgRequiredError, p as isArcError, r as ForbiddenError, s as RateLimitError, t as ArcError, u as ValidationError } from "../errors-Cj42AntO.mjs";
-import { n as requireSingleHeaderValue, t as getHeader } from "../headers-3zvE0rM3.mjs";
-import { n as getUserRoles, r as normalizeRoles, t as getUserId } from "../userHelpers-ChYJ6CdK.mjs";
-import { t as simpleEqualityMatcher } from "../simpleEqualityMatcher-DjQJ7FKA.mjs";
-import { A as createCircuitBreakerRegistry, C as defineCompensation, D as CircuitBreakerRegistry, E as CircuitBreakerError, O as CircuitState, S as defineErrorMapper, T as CircuitBreaker, _ as createQueryParser, a as deleteResponse, b as NEUTRAL_DIALECT, c as getDefaultCrudSchemas, d as listResponse, f as offsetListResponse, g as ArcQueryParser, h as responses, i as bareListResponse, k as createCircuitBreaker, l as getListQueryParams, m as queryParams, n as scheduleBackground, o as errorContractSchema, p as paginationSchema, r as aggregateListResponse, s as errorDetailSchema, t as createStateMachine, u as keysetListResponse, v as handleRaw, w as withCompensation, x as defineGuard, y as MONGO_DIALECT } from "../utils-vL8BrDE2.mjs";
-import { a as isZodSchema, i as isJsonSchema, n as convertRouteSchema, o as toJsonSchema, t as convertOpenApiSchemas } from "../schemaConverter-D--wdJM-.mjs";
-import { a as promoteStreamTokenToHeader, i as pipeUIMessageStreamToReply, n as forwardedStreamHeaders, r as isReadableStream, t as UI_MESSAGE_STREAM_HEADERS } from "../streaming-PSZwi8JV.mjs";
-import { t as openSseStream } from "../sseStream-B_5XcVVd.mjs";
-import { t as hasEvents } from "../typeGuards-B0ryPo3I.mjs";
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
+import { a as OrgAccessDeniedError, c as ServiceUnavailableError, d as createDomainError, f as createError, i as NotFoundError, l as UnauthorizedError, n as ConflictError, o as OrgRequiredError, p as isArcError, r as ForbiddenError, s as RateLimitError, t as ArcError, u as ValidationError } from "../errors-Bh1KK5ps.mjs";
+import { n as requireSingleHeaderValue, t as getHeader } from "../headers-BXjQYbeC.mjs";
+import { n as getUserRoles, r as normalizeRoles, t as getUserId } from "../userHelpers-BNsOXzOd.mjs";
+import { t as simpleEqualityMatcher } from "../simpleEqualityMatcher-C4KiMWUa.mjs";
+import { A as createCircuitBreakerRegistry, C as defineCompensation, D as CircuitBreakerRegistry, E as CircuitBreakerError, O as CircuitState, S as defineErrorMapper, T as CircuitBreaker, _ as createQueryParser, a as deleteResponse, b as NEUTRAL_DIALECT, c as getDefaultCrudSchemas, d as listResponse, f as offsetListResponse, g as ArcQueryParser, h as responses, i as bareListResponse, k as createCircuitBreaker, l as getListQueryParams, m as queryParams, n as scheduleBackground, o as errorContractSchema, p as paginationSchema, r as aggregateListResponse, s as errorDetailSchema, t as createStateMachine, u as keysetListResponse, v as handleRaw, w as withCompensation, x as defineGuard, y as MONGO_DIALECT } from "../utils-BtOha_Sp.mjs";
+import { a as isZodSchema, i as isJsonSchema, n as convertRouteSchema, o as toJsonSchema, t as convertOpenApiSchemas } from "../schemaConverter-Crjvczi_.mjs";
+import { a as promoteStreamTokenToHeader, i as pipeUIMessageStreamToReply, n as forwardedStreamHeaders, r as isReadableStream, t as UI_MESSAGE_STREAM_HEADERS } from "../streaming-DPZdQmDz.mjs";
+import { t as openSseStream } from "../sseStream-B3zb_d1h.mjs";
+import { t as hasEvents } from "../typeGuards-B_5-hKjJ.mjs";
 export { ArcError, ArcQueryParser, CircuitBreaker, CircuitBreakerError, CircuitBreakerRegistry, CircuitState, ConflictError, ForbiddenError, MONGO_DIALECT, NEUTRAL_DIALECT, NotFoundError, OrgAccessDeniedError, OrgRequiredError, RateLimitError, ServiceUnavailableError, UI_MESSAGE_STREAM_HEADERS, UnauthorizedError, ValidationError, aggregateListResponse, bareListResponse, convertOpenApiSchemas, convertRouteSchema, createCircuitBreaker, createCircuitBreakerRegistry, createDomainError, createError, createQueryParser, createStateMachine, defineCompensation, defineErrorMapper, defineGuard, deleteResponse, errorContractSchema, errorDetailSchema, forwardedStreamHeaders, getDefaultCrudSchemas, getHeader, getListQueryParams, getUserId, getUserRoles, handleRaw, hasEvents, isArcError, isJsonSchema, isReadableStream, isZodSchema, keysetListResponse, listResponse, normalizeRoles, offsetListResponse, openSseStream, paginationSchema, pipeUIMessageStreamToReply, promoteStreamTokenToHeader, queryParams, requireSingleHeaderValue, responses, scheduleBackground, simpleEqualityMatcher, toJsonSchema, withCompensation };

package/dist/{utils-vL8BrDE2.mjs → utils-BtOha_Sp.mjs}

@@ -1,7 +1,7 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
-import { m as RESERVED_QUERY_PARAMS } from "./constants-D3Dv4LAV.mjs";
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
+import { m as RESERVED_QUERY_PARAMS } from "./constants-J99LGTJI.mjs";
 import { arcLog } from "./logger/index.mjs";
-import { t as ArcError } from "./errors-Cj42AntO.mjs";
+import { t as ArcError } from "./errors-Bh1KK5ps.mjs";
 import { errorContractSchema as errorContractSchema$1, errorDetailSchema as errorDetailSchema$1 } from "@classytic/repo-core/errors";
 import { scheduleBackground } from "@classytic/repo-core/cache";
 //#region src/utils/circuitBreaker.ts

package/dist/{validate-_KbifpHF.mjs → validate-PMCPR9El.mjs}

@@ -1,5 +1,5 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
-import { t as __exportAll } from "./rolldown-runtime-CUsjNX9R.mjs";
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
+import { t as __exportAll } from "./rolldown-runtime-BhflRrBs.mjs";
 //#region src/core/aggregation/normalize.ts
 /**
 * Framework cap on URL-driven aggregation limits when the host opts

package/dist/{versioning-CHDTor3P.mjs → versioning-CKv2jz_U.mjs}

@@ -1,6 +1,6 @@
-/*! @classytic/arc v2.31.0 | MIT | https://classytic.com */
-import { t as __exportAll } from "./rolldown-runtime-CUsjNX9R.mjs";
-import { d as createDomainError } from "./errors-Cj42AntO.mjs";
+/*! @classytic/arc v2.32.0 | MIT | https://classytic.com */
+import { t as __exportAll } from "./rolldown-runtime-BhflRrBs.mjs";
+import { d as createDomainError } from "./errors-Bh1KK5ps.mjs";
 import fp from "fastify-plugin";
 //#region src/plugins/versioning.ts
 var versioning_exports = /* @__PURE__ */ __exportAll({
@@ -31,7 +31,7 @@ const versioningPlugin = async (fastify, opts) => {
 		reply.header(responseHeader, version);
 		if (deprecatedSet.has(version)) {
 			reply.header("deprecation", "true");
-			reply.header("sunset", sunset ?? new Date(Date.now() + 2160 * 60 * 60 * 1e3).toISOString());
+			reply.header("sunset", sunset ?? new Date(Date.now() + 7776e6).toISOString());
 		}
 	});
 };