@classytic/arc 2.11.3 → 2.13.1

package/dist/plugins/index.d.mts

@@ -1,8 +1,9 @@
-import { Pt as AnyRecord, Q as MiddlewareConfig, ft as RouteSchemaOptions, gn as HookSystem, lt as RouteDefinition, tt as PresetHook, z as ResourceRegistry } from "../index-6u4_Gg6G.mjs";
-import { t as ExternalOpenApiPaths } from "../externalPaths-Bapitwvd.mjs";
-import { a as MetricsCollector, c as metricsPlugin, d as ssePlugin, f as CachingOptions, h as cachingPlugin, i as MetricEntry, l as SSEOptions, m as _default$1, n as _default$7, o as MetricsOptions, p as CachingRule, r as versioningPlugin, s as _default$4, t as VersioningOptions, u as _default$6 } from "../versioning-M9lNLhO8.mjs";
-import { i as errorHandlerPlugin, n as ErrorMapper, r as defaultIsDuplicateKeyError, t as ErrorHandlerOptions } from "../errorHandler-Co3lnVmJ.mjs";
-import { t as TracingOptions } from "../tracing-DokiEsuz.mjs";
+import { En as HookSystem, Q as MiddlewareConfig, Wt as AnyRecord, ft as RouteSchemaOptions, lt as RouteDefinition, tt as PresetHook, z as ResourceRegistry } from "../index-BtW7qYwa.mjs";
+import { t as ExternalOpenApiPaths } from "../externalPaths-BD5nw6St.mjs";
+import { a as MetricsCollector, c as metricsPlugin, d as ssePlugin, f as CachingOptions, h as cachingPlugin, i as MetricEntry, l as SSEOptions, m as _default$1, n as _default$7, o as MetricsOptions, p as CachingRule, r as versioningPlugin, s as _default$4, t as VersioningOptions, u as _default$6 } from "../versioning-DTTvc80y.mjs";
+import { i as errorHandlerPlugin, n as ErrorMapper, r as defaultIsDuplicateKeyError, t as ErrorHandlerOptions } from "../errorHandler-DFr45ZG4.mjs";
+import { t as TracingOptions } from "../tracing-QJVprktp.mjs";
+import { PaginatedResult } from "@classytic/repo-core/pagination";
 import { FastifyInstance, FastifyPluginAsync } from "fastify";
 import * as _$node_stream0 from "node:stream";
 
@@ -172,38 +173,22 @@ declare const _default$3: FastifyPluginAsync<HealthOptions>;
 //#region src/plugins/replyHelpers.d.ts
 declare module "fastify" {
   interface FastifyReply {
-    /** Send a success response with data */
-    ok<T>(data: T, statusCode?: number): FastifyReply;
-    /** Send an error response */
-    fail(error: string | string[], statusCode?: number): FastifyReply;
-    /** Send a paginated list response */
-    paginated<T>(result: {
-      docs: T[];
-      total: number;
-      page: number;
-      limit: number;
-      [key: string]: unknown;
-    }): FastifyReply;
+    /**
+     * Send a list response, normalised to the canonical wire shape.
+     *
+     * Accepts either a bare array (endpoints that don't paginate) or any
+     * kit-shaped pagination result (`OffsetPaginationResult`,
+     * `KeysetPaginationResult`, `AggregatePaginationResult`). Routes
+     * through `toCanonicalList` from `@classytic/repo-core/pagination`
+     * so server and typed-client (`@classytic/arc-next`) share one
+     * declaration — the `method` discriminant cannot drift between them.
+     */
+    sendList<T>(input: T[] | readonly T[] | PaginatedResult<T>): FastifyReply;
     /**
      * Stream a readable source as a file download or raw stream.
      *
      * @example
-     * ```typescript
-     * // CSV export
-     * return reply.stream(csvReadableStream, {
-     *   contentType: 'text/csv',
-     *   filename: 'export.csv',
-     * });
-     *
-     * // PDF download
-     * return reply.stream(pdfBuffer, {
-     *   contentType: 'application/pdf',
-     *   filename: 'report.pdf',
-     * });
-     *
-     * // Raw stream (no Content-Disposition)
-     * return reply.stream(dataStream, { contentType: 'application/octet-stream' });
-     * ```
+     * return reply.stream(csvReadable, { contentType: 'text/csv', filename: 'export.csv' });
      */
     stream(source: _$node_stream0.Readable | Buffer | AsyncIterable<unknown>, options: {
       contentType: string;

package/dist/plugins/index.mjs

@@ -1,15 +1,15 @@
-import { p as MUTATION_OPERATIONS } from "../constants-BhY1OHoH.mjs";
-import { o as getOrgId } from "../types-AOD8fxIw.mjs";
-import { t as requestContext } from "../requestContext-C5XeK3VA.mjs";
-import { t as hasEvents } from "../typeGuards-CcFZXgU7.mjs";
-import { t as HookSystem } from "../HookSystem-CGsMd6oK.mjs";
-import { t as ResourceRegistry } from "../ResourceRegistry-DkAeAuTX.mjs";
-import { n as caching_default, t as cachingPlugin } from "../caching-CheW3m-S.mjs";
-import { n as errorHandlerPlugin, t as defaultIsDuplicateKeyError } from "../errorHandler-BQm8ZxTK.mjs";
-import { n as metrics_default, t as metricsPlugin } from "../metrics-Csh4nsvv.mjs";
-import { t as replyHelpersPlugin } from "../replyHelpers-ByllIXXV.mjs";
-import { n as sse_default, t as ssePlugin } from "../sse-V7aXc3bW.mjs";
-import { n as versioning_default, t as versioningPlugin } from "../versioning-CGPjkqAg.mjs";
+import { p as MUTATION_OPERATIONS } from "../constants-Cxde4rpC.mjs";
+import { c as getOrgId } from "../types-C_s5moIu.mjs";
+import { t as requestContext } from "../requestContext-SSaaTgW8.mjs";
+import { t as hasEvents } from "../typeGuards-BzkXkvVv.mjs";
+import { t as HookSystem } from "../HookSystem-Iiebom92.mjs";
+import { t as ResourceRegistry } from "../ResourceRegistry-CTERg_2x.mjs";
+import { n as caching_default, t as cachingPlugin } from "../caching-SM8gghN6.mjs";
+import { n as errorHandlerPlugin, t as defaultIsDuplicateKeyError } from "../errorHandler-Bk-AGhkU.mjs";
+import { n as metrics_default, t as metricsPlugin } from "../metrics-Qnvwc-LQ.mjs";
+import { t as replyHelpersPlugin } from "../replyHelpers-CK-FNO8E.mjs";
+import { n as sse_default, t as ssePlugin } from "../sse-Bz-5ZeTt.mjs";
+import { n as versioning_default, t as versioningPlugin } from "../versioning-BUrT5aP4.mjs";
 import { randomUUID } from "node:crypto";
 import fp from "fastify-plugin";
 //#region src/core/arcCorePlugin.ts
@@ -198,6 +198,26 @@ function createHttpMetrics() {
 const healthPlugin = async (fastify, opts = {}) => {
 	const { prefix = "/_health", checks = [], metrics = false, metricsCollector, version, collectHttpMetrics = metrics } = opts;
 	const httpMetrics = createHttpMetrics();
+	fastify.get(prefix, { schema: {
+		tags: ["Health"],
+		summary: "Liveness probe (alias for /live)",
+		description: "Returns 200 if the process is alive",
+		response: { 200: {
+			type: "object",
+			properties: {
+				status: {
+					type: "string",
+					enum: ["ok"]
+				},
+				timestamp: { type: "string" },
+				version: { type: "string" }
+			}
+		} }
+	} }, async () => ({
+		status: "ok",
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		...version ? { version } : {}
+	}));
 	fastify.get(`${prefix}/live`, { schema: {
 		tags: ["Health"],
 		summary: "Liveness probe",
@@ -331,7 +351,7 @@ const healthPlugin = async (fastify, opts = {}) => {
 			httpMetrics._ringIndex = httpMetrics._ringIndex + 1;
 		});
 	}
-	fastify.log?.debug?.(`Health plugin registered at ${prefix}`);
+	fastify.log?.debug?.(`Health plugin registered at ${prefix} (alias), ${prefix}/live, ${prefix}/ready${metrics ? `, ${prefix}/metrics` : ""}`);
 };
 /**
 * Run all health checks with timeout

package/dist/plugins/response-cache.mjs

@@ -1,4 +1,4 @@
-import { t as hasEvents } from "../typeGuards-CcFZXgU7.mjs";
+import { t as hasEvents } from "../typeGuards-BzkXkvVv.mjs";
 import fp from "fastify-plugin";
 //#region src/plugins/response-cache.ts
 /**

package/dist/plugins/tracing-entry.d.mts

@@ -1,2 +1,2 @@
-import { a as traced, i as isTracingAvailable, n as _default, r as createSpan, t as TracingOptions } from "../tracing-DokiEsuz.mjs";
+import { a as traced, i as isTracingAvailable, n as _default, r as createSpan, t as TracingOptions } from "../tracing-QJVprktp.mjs";
 export { type TracingOptions, createSpan, isTracingAvailable, traced, _default as tracingPlugin };

package/dist/plugins/tracing-entry.mjs

@@ -58,7 +58,7 @@ try {
 function createTracerProvider(options) {
 	if (!isAvailable || !NodeTracerProvider || !BatchSpanProcessor || !OTLPTraceExporter) return null;
 	const { serviceName = "@classytic/arc", serviceVersion, exporterUrl = "http://localhost:4318/v1/traces" } = options;
-	const resolvedVersion = serviceVersion ?? "2.11.3";
+	const resolvedVersion = serviceVersion ?? "2.13.1";
 	const exporter = new OTLPTraceExporter({ url: exporterUrl });
 	const provider = new NodeTracerProvider({ resource: { attributes: {
 		"service.name": serviceName,

package/dist/presets/filesUpload.d.mts

@@ -1,7 +1,7 @@
-import { nt as PresetResult } from "../index-6u4_Gg6G.mjs";
-import { r as RequestScope } from "../types-tgR4Pt8F.mjs";
-import { c as PermissionCheck } from "../fields-C8Y0XLAu.mjs";
-import { a as StorageReadResult, i as StorageReadRange, n as StorageContext, o as StorageUploadInput, r as StorageFile, t as Storage } from "../storage-BwGQXUpd.mjs";
+import { nt as PresetResult } from "../index-BtW7qYwa.mjs";
+import { i as RequestScope } from "../types-CTYvcwHe.mjs";
+import { c as PermissionCheck } from "../fields-COhcH3fk.mjs";
+import { a as StorageReadResult, i as StorageReadRange, n as StorageContext, o as StorageUploadInput, r as StorageFile, t as Storage } from "../storage-Dfzt4VTl.mjs";
 
 //#region src/presets/filesUpload.d.ts
 interface FilesUploadPresetRoutes {
@@ -27,7 +27,7 @@ interface FilesUploadPresetPermissions {
  * - function: custom policy. Return a string to *transform* the filename,
  *   `false` to reject (triggers `ValidationError`), or `true`/`void` to accept.
  */
-type FilenamePolicy = boolean | "*" | ((filename: string) => string | boolean | void);
+type FilenamePolicy = boolean | "*" | ((filename: string) => string | boolean | undefined);
 interface FilesUploadPresetOptions {
   /** Any implementation of the `Storage` interface. App owns it. */
   storage: Storage;

package/dist/presets/filesUpload.mjs

@@ -1,7 +1,7 @@
-import { o as getOrgId, p as getUserId } from "../types-AOD8fxIw.mjs";
-import { C as requireAuth, y as allowPublic } from "../permissions-gd_aUWrR.mjs";
-import { i as NotFoundError, u as ValidationError } from "../errors-D5c-5BJL.mjs";
-import { t as multipartBody } from "../multipartBody-CvTR1Un6.mjs";
+import { i as NotFoundError, u as ValidationError } from "../errors-j4aJm1Wg.mjs";
+import { c as getOrgId, h as getUserId } from "../types-C_s5moIu.mjs";
+import { C as allowPublic, D as requireAuth } from "../permissions-ohQyv50e.mjs";
+import { t as multipartBody } from "../multipartBody-BOvVSVCD.mjs";
 //#region src/presets/filesUpload.ts
 const DEFAULT_FIELD_NAME = "file";
 const DEFAULT_MAX_FILE_SIZE = 10 * 1024 * 1024;
@@ -29,7 +29,7 @@ function buildStorageContext(request, contextFrom) {
 * to the full-object response (per RFC 7233 §4.1 a server MAY ignore ranges).
 */
 function parseRangeHeader(header, totalSize) {
-	if (!header || !header.startsWith("bytes=")) return void 0;
+	if (!header?.startsWith("bytes=")) return void 0;
 	const spec = header.slice(6).split(",")[0]?.trim();
 	if (!spec) return void 0;
 	const dashIndex = spec.indexOf("-");
@@ -102,10 +102,7 @@ function makeUploadHandler(deps) {
 			mimeType: file.mimetype,
 			size: file.size
 		}, ctx);
-		return reply.code(201).send({
-			success: true,
-			data: toResponseFile(result)
-		});
+		return reply.code(201).send(toResponseFile(result));
 	};
 }
 function toResponseFile(file) {

package/dist/presets/index.d.mts

@@ -1,4 +1,4 @@
-import { Pt as AnyRecord, _t as IControllerResponse, at as ResourceConfig, d as PaginationResult, nt as PresetResult, vt as IRequestContext } from "../index-6u4_Gg6G.mjs";
+import { Wt as AnyRecord, _t as IControllerResponse, at as ResourceConfig, d as PaginationResult, nt as PresetResult, vt as IRequestContext } from "../index-BtW7qYwa.mjs";
 import { FilesUploadPresetOptions, FilesUploadPresetPermissions, FilesUploadPresetRoutes, filesUploadPreset } from "./filesUpload.mjs";
 import { MultiTenantOptions, TenantFieldSpec, multiTenantPreset } from "./multiTenant.mjs";
 import { SearchHandler, SearchPresetOptions, SearchRouteConfig, searchPreset } from "./search.mjs";

package/dist/presets/index.mjs

@@ -1,5 +1,5 @@
 import { multiTenantPreset } from "./multiTenant.mjs";
-import { a as registerPreset, c as auditedPreset, d as ownedByUserPreset, i as getPreset, l as softDeletePreset, n as flexibleMultiTenantPreset, o as treePreset, r as getAvailablePresets, s as bulkPreset, t as applyPresets, u as slugLookupPreset } from "../presets-Z7P5w4gF.mjs";
+import { a as registerPreset, c as auditedPreset, d as ownedByUserPreset, i as getPreset, l as softDeletePreset, n as flexibleMultiTenantPreset, o as treePreset, r as getAvailablePresets, s as bulkPreset, t as applyPresets, u as slugLookupPreset } from "../presets-BbkjdPeH.mjs";
 import { filesUploadPreset } from "./filesUpload.mjs";
 import { searchPreset } from "./search.mjs";
 export { applyPresets, auditedPreset, bulkPreset, filesUploadPreset, flexibleMultiTenantPreset, getAvailablePresets, getPreset, multiTenantPreset, ownedByUserPreset, registerPreset, searchPreset, slugLookupPreset, softDeletePreset, treePreset };

package/dist/presets/multiTenant.d.mts

@@ -1,4 +1,4 @@
-import { J as CrudRouteKey, nt as PresetResult } from "../index-6u4_Gg6G.mjs";
+import { J as CrudRouteKey, nt as PresetResult } from "../index-BtW7qYwa.mjs";
 
 //#region src/presets/multiTenant.d.ts
 /**

package/dist/presets/multiTenant.mjs

@@ -1,5 +1,5 @@
-import "../constants-BhY1OHoH.mjs";
-import { _ as isElevated, c as getRequestScope, f as getTeamId, h as hasOrgAccess, l as getScopeContext, o as getOrgId } from "../types-AOD8fxIw.mjs";
+import "../constants-Cxde4rpC.mjs";
+import { _ as hasOrgAccess, c as getOrgId, d as getScopeContext, m as getTeamId, u as getRequestScope, y as isElevated } from "../types-C_s5moIu.mjs";
 //#region src/presets/multiTenant.ts
 /**
 * Resolve a single TenantFieldSpec against the current scope.

package/dist/presets/search.d.mts

@@ -1,5 +1,5 @@
-import { lt as RouteDefinition, nt as PresetResult, pt as ControllerHandler, ut as RouteMcpConfig } from "../index-6u4_Gg6G.mjs";
-import { c as PermissionCheck } from "../fields-C8Y0XLAu.mjs";
+import { lt as RouteDefinition, nt as PresetResult, pt as ControllerHandler, ut as RouteMcpConfig } from "../index-BtW7qYwa.mjs";
+import { c as PermissionCheck } from "../fields-COhcH3fk.mjs";
 
 //#region src/presets/search.d.ts
 /**

package/dist/presets/search.mjs

@@ -1,4 +1,4 @@
-import { C as requireAuth, y as allowPublic } from "../permissions-gd_aUWrR.mjs";
+import { C as allowPublic, D as requireAuth } from "../permissions-ohQyv50e.mjs";
 //#region src/presets/search.ts
 const BUILTINS = [
 	{
@@ -28,17 +28,15 @@ const BUILTINS = [
 ];
 /**
 * Wrap the user handler to normalise the return shape into arc's envelope.
-* If the handler already returns `{ success, data }`, arc passes it through;
-* otherwise we wrap the raw return value so callers don't have to.
+* If the handler already returns an `IControllerResponse` envelope (carrying
+* a `data` slot), arc passes it through; otherwise we wrap the raw return
+* value so callers don't have to.
 */
 function wrapEnvelope(handler) {
 	return async (req) => {
 		const out = await handler(req);
-		if (out !== null && typeof out === "object" && "success" in out) return out;
-		return {
-			success: true,
-			data: out
-		};
+		if (out !== null && typeof out === "object" && "data" in out) return out;
+		return { data: out };
 	};
 }
 /**

package/dist/{presets-Z7P5w4gF.mjs → presets-BbkjdPeH.mjs}

@@ -1,5 +1,5 @@
-import { _ as isElevated, n as PUBLIC_SCOPE } from "./types-AOD8fxIw.mjs";
-import { C as requireAuth, T as requireRoles, y as allowPublic } from "./permissions-gd_aUWrR.mjs";
+import { n as PUBLIC_SCOPE, y as isElevated } from "./types-C_s5moIu.mjs";
+import { C as allowPublic, D as requireAuth, k as requireRoles } from "./permissions-ohQyv50e.mjs";
 import { multiTenantPreset } from "./presets/multiTenant.mjs";
 //#region src/presets/ownedByUser.ts
 /**
@@ -169,17 +169,7 @@ function bulkPreset(opts) {
 						} },
 						required: ["items"]
 					},
-					response: { 201: {
-						type: "object",
-						properties: {
-							success: { type: "boolean" },
-							data: { type: "array" },
-							meta: {
-								type: "object",
-								properties: { count: { type: "number" } }
-							}
-						}
-					} }
+					response: { 201: { type: "array" } }
 				}
 			});
 			if (operations.includes("updateMany")) routes.push({
@@ -201,14 +191,8 @@ function bulkPreset(opts) {
 					response: { 200: {
 						type: "object",
 						properties: {
-							success: { type: "boolean" },
-							data: {
-								type: "object",
-								properties: {
-									matchedCount: { type: "number" },
-									modifiedCount: { type: "number" }
-								}
-							}
+							matchedCount: { type: "number" },
+							modifiedCount: { type: "number" }
 						}
 					} }
 				}
@@ -228,13 +212,7 @@ function bulkPreset(opts) {
 					},
 					response: { 200: {
 						type: "object",
-						properties: {
-							success: { type: "boolean" },
-							data: {
-								type: "object",
-								properties: { deletedCount: { type: "number" } }
-							}
-						}
+						properties: { deletedCount: { type: "number" } }
 					} }
 				}
 			});

package/dist/{queryCachePlugin-BUXBSm4F.d.mts → queryCachePlugin-CqMdLI2-.d.mts}

@@ -1,5 +1,5 @@
-import { r as CacheStore } from "./interface-Da0r7Lna.mjs";
-import { i as QueryCache } from "./QueryCache-DOBNHBE0.mjs";
+import { r as CacheStore } from "./interface-beEtJyWM.mjs";
+import { i as QueryCache } from "./QueryCache-D41bfdBB.mjs";
 import { FastifyPluginAsync } from "fastify";
 
 //#region src/cache/queryCachePlugin.d.ts

package/dist/{queryCachePlugin-Bq6bO6vc.mjs → queryCachePlugin-m1XsgAIJ.mjs}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./chunk-BpYLSNr0.mjs";
-import { i as versionKey, r as tagVersionKey } from "./keys-CARyUjiR.mjs";
-import { t as MemoryCacheStore } from "./memory-DikHSvWa.mjs";
-import { t as hasEvents } from "./typeGuards-CcFZXgU7.mjs";
+import { t as MemoryCacheStore } from "./memory-UBydS5ku.mjs";
+import { t as hasEvents } from "./typeGuards-BzkXkvVv.mjs";
+import { i as versionKey, r as tagVersionKey } from "./keys-CGcCbNyu.mjs";
 import fp from "fastify-plugin";
 //#region src/cache/QueryCache.ts
 var QueryCache = class {

package/dist/{redis-Cm1gnRDf.d.mts → redis-DiMkdHEl.d.mts}

@@ -1,4 +1,4 @@
-import { n as IdempotencyResult, r as IdempotencyStore } from "./interface-CkkWm5uR.mjs";
+import { n as IdempotencyResult, r as IdempotencyStore } from "./interface-DfLGcus7.mjs";
 
 //#region src/idempotency/stores/redis.d.ts
 interface RedisClient {

package/dist/redis-stream-D6HzR1Z_.d.mts

@@ -0,0 +1,232 @@
+import { a as EventTransport, i as EventLogger, n as DomainEvent, r as EventHandler } from "./EventTransport-CT_52aWU.mjs";
+
+//#region src/events/transports/redis-stream.d.ts
+interface RedisStreamLike {
+  xadd(key: string, id: string, ...fieldValues: string[]): Promise<string | null>;
+  xreadgroup(command: "GROUP", group: string, consumer: string, ...args: (string | number)[]): Promise<Array<[string, Array<[string, string[]]>]> | null>;
+  xack(key: string, group: string, ...ids: string[]): Promise<number>;
+  xgroup(command: string, key: string, group: string, ...args: string[]): Promise<unknown>;
+  xpending(key: string, group: string, ...args: (string | number)[]): Promise<Array<[string, string, number, number]>>;
+  xclaim(key: string, group: string, consumer: string, minIdleTime: number, ...ids: string[]): Promise<Array<[string, string[]]>>;
+  xlen(key: string): Promise<number>;
+  /**
+   * Read a range of entries by id. When present, the DLQ writer uses this
+   * to fetch the original message payload so dead-lettered events are
+   * **fully replayable** (a re-publish of `envelope.event` is sufficient).
+   *
+   * Optional to preserve back-compat with custom Redis wrappers that
+   * satisfied the pre-2.11.3 shape. When missing, the DLQ envelope still
+   * carries the **error reason + attempt accounting** (operator-grade
+   * triage info survives), but `envelope.event.payload` is `null` and
+   * `envelope.event.type` is `<unknown>` — replay is NOT possible without
+   * upgrading the client. A one-shot warning fires per process so this
+   * isn't silent.
+   */
+  xrange?(key: string, start: string, end: string): Promise<Array<[string, string[]]>>;
+  /** Graceful close — flushes queued commands then closes. ioredis-style. */
+  quit(): Promise<unknown>;
+  /**
+   * Force-disconnect — closes the socket immediately, abandoning any
+   * pending command (including a live `XREADGROUP BLOCK`). Optional because
+   * non-ioredis clients may not expose a force path; `close()` falls back
+   * to `quit()` when this is missing, accepting a longer shutdown wait.
+   */
+  disconnect?(): void;
+}
+interface RedisStreamTransportOptions {
+  /**
+   * Redis stream key name.
+   * @default 'arc:events'
+   */
+  stream?: string;
+  /**
+   * Consumer group name. Each group receives every event independently.
+   * Multiple instances of the same service should share a group name.
+   * @default 'default'
+   */
+  group?: string;
+  /**
+   * Consumer name within the group. Must be unique per instance.
+   * @default 'consumer-<random>'
+   */
+  consumer?: string;
+  /**
+   * Block time in ms when waiting for new events.
+   * @default 5000
+   */
+  blockTimeMs?: number;
+  /**
+   * Max events to read per batch.
+   * @default 10
+   */
+  batchSize?: number;
+  /**
+   * Max delivery attempts before moving to dead letter stream.
+   * @default 5
+   */
+  maxRetries?: number;
+  /**
+   * Idle time in ms before pending entries are claimed by this consumer.
+   * Handles crash recovery — if a consumer dies mid-processing, another
+   * consumer will claim its pending entries after this timeout.
+   * @default 30000
+   */
+  claimTimeoutMs?: number;
+  /**
+   * Dead letter stream name. Failed events are moved here after maxRetries.
+   * Set to `false` to disable DLQ (failed events are acked and dropped).
+   * @default 'arc:events:dlq'
+   */
+  deadLetterStream?: string | false;
+  /**
+   * Max stream length (approximate). Uses XADD MAXLEN ~ to trim old entries.
+   * Set to 0 to disable trimming.
+   * @default 10000
+   */
+  maxLen?: number;
+  /**
+   * Max event payload size in bytes. Publish rejects events exceeding this limit
+   * to prevent Redis memory exhaustion from oversized payloads.
+   * @default 1_000_000 (1 MB)
+   */
+  maxPayloadBytes?: number;
+  /**
+   * If `true`, `close()` does NOT call `redis.quit()` — useful when the host
+   * manages the Redis connection lifecycle externally (shared client across
+   * multiple transports / cache stores). Without this, every transport
+   * `close()` would tear down a shared client and break siblings.
+   *
+   * Mirror of `RedisEventTransportOptions.externalLifecycle`.
+   * @default false
+   */
+  externalLifecycle?: boolean;
+  /**
+   * Hard cap on how long `close()` waits for the in-flight `XREADGROUP BLOCK`
+   * iteration to drain. Tests and serverless shutdowns would otherwise hang
+   * up to `blockTimeMs` (default 5s) per close.
+   *
+   * Behaviour after timeout:
+   *   - `externalLifecycle: false` (default) — `redis.disconnect()` (or
+   *     `quit()` if the client lacks `disconnect`) breaks the BLOCK
+   *     immediately. Strict bounded close.
+   *   - `externalLifecycle: true` — arc CANNOT touch the host's connection,
+   *     so the poll loop is left to drain in the background when its
+   *     XREADGROUP returns. `close()` returns within `closeTimeoutMs` but
+   *     the loop's eventual completion is silently absorbed (no log spam,
+   *     no unhandled rejection). The contract here is "bounded return,
+   *     background drain" — set `blockTimeMs` low (e.g. 500ms) under
+   *     externalLifecycle to keep the drain window short.
+   *
+   * @default 1000
+   */
+  closeTimeoutMs?: number;
+  /**
+   * Logger for error messages (default: console).
+   * Pass `fastify.log` to integrate with your application logger.
+   */
+  logger?: EventLogger;
+}
+declare class RedisStreamTransport implements EventTransport {
+  readonly name = "redis-stream";
+  private redis;
+  private stream;
+  private group;
+  private consumer;
+  private blockTimeMs;
+  private batchSize;
+  private maxRetries;
+  private claimTimeoutMs;
+  private deadLetterStream;
+  private maxLen;
+  private maxPayloadBytes;
+  private logger;
+  /** Tracks the lifecycle policy — set in constructor, read in close(). */
+  private externalLifecycle;
+  private closeTimeoutMs;
+  private handlers;
+  private running;
+  private pollPromise;
+  /**
+   * Monotonic counter bumped every time the poll loop should stop —
+   * `unsubscribe` (last handler removed) and `close()` increment it. Each
+   * `pollLoop` instance captures its generation at start and exits when
+   * `this.generation` no longer matches. Prevents the
+   * subscribe → unsubscribe → fast-resubscribe race where the old loop
+   * would still be in `XREADGROUP BLOCK` while a new loop started, leading
+   * to two concurrent poll loops on the same consumer name.
+   */
+  private generation;
+  private groupCreated;
+  /**
+   * Last-seen failure context per message id, populated when an in-process
+   * handler throws in {@link processEntry}. Consumed (and cleared) by
+   * {@link moveToDlq} so the dead-letter envelope carries the actual error
+   * message instead of opaque "reclaimed without context". Bounded by
+   * `maxRetries × consumer-throughput` — entries are deleted on ack and
+   * on DLQ write, so the map naturally drains.
+   */
+  private failureContext;
+  /** One-shot guard so the "client lacks xrange" warning fires once per process. */
+  private xrangeWarningEmitted;
+  constructor(redis: RedisStreamLike, options?: RedisStreamTransportOptions);
+  publish(event: DomainEvent): Promise<void>;
+  subscribe(pattern: string, handler: EventHandler): Promise<() => void>;
+  /**
+   * Stop polling and release transport state.
+   *
+   * **Two close contracts** — pick the one that matches your deployment:
+   *
+   * 1. **Default (`externalLifecycle: false`) — strict bounded close.**
+   *    `close()` waits up to `closeTimeoutMs` for the in-flight
+   *    `XREADGROUP BLOCK` to drain. On timeout it calls `redis.disconnect()`
+   *    (or `quit()` if the client lacks `disconnect`) to break the BLOCK
+   *    immediately, then awaits the loop's exit. After `close()` returns
+   *    the transport is fully closed and the connection is released.
+   *
+   * 2. **`externalLifecycle: true` — bounded RETURN, background drain.**
+   *    Arc must NOT touch a connection it doesn't own. `close()` returns
+   *    within `closeTimeoutMs`, but the poll loop is left to drain on its
+   *    own when its outstanding `XREADGROUP BLOCK` returns (up to
+   *    `blockTimeMs`). Arc silently absorbs the loop's eventual completion
+   *    so the host doesn't see unhandled rejections / log spam against a
+   *    transport it considers closed. The host's own `redis.quit()` /
+   *    process exit is what ultimately tears the connection down.
+   *
+   *    Practical implication: under `externalLifecycle: true`, set
+   *    `blockTimeMs` low (e.g. 500ms) so the background drain window is
+   *    short. The transport is "closed enough" to stop dispatching to
+   *    handlers (handlers map is cleared and generation is bumped) but is
+   *    not "fully closed" in the connection-lifecycle sense until the host
+   *    closes the underlying client.
+   *
+   * In both modes the generation counter is bumped, so a follow-up
+   * `subscribe()` spawns a fresh poll loop with a new generation — the
+   * stale loop exits on its next iteration and never overlaps the new one.
+   */
+  close(): Promise<void>;
+  private ensureGroup;
+  private pollLoop;
+  private readNewMessages;
+  private claimPending;
+  private processEntry;
+  private getMatchingHandlers;
+  private matchesPattern;
+  private moveToDlq;
+  /**
+   * Reconstruct a `DeadLetteredEvent` for a message id. Reads the original
+   * entry via `xrange` (when the client supports it) and merges in any
+   * in-process failure context. Returns `null` only when BOTH sources are
+   * missing — callers ack-and-drop rather than re-queuing a ghost.
+   *
+   * Graceful degradation paths:
+   *   - Client lacks `xrange` (older custom wrappers) → log once, build the
+   *     envelope from `failureContext` alone. Payload is absent but the
+   *     error reason + attempt accounting still survive.
+   *   - `xrange` throws (network blip, ACL) → same fallback.
+   *   - Source entry trimmed before DLQ write → same fallback.
+   */
+  private buildDlqEnvelope;
+  private sleep;
+}
+//#endregion
+export { RedisStreamTransport as n, RedisStreamTransportOptions as r, RedisStreamLike as t };

package/dist/registry/index.d.mts

@@ -1,4 +1,4 @@
-import { R as RegisterOptions, k as IntrospectionPluginOptions, z as ResourceRegistry } from "../index-6u4_Gg6G.mjs";
+import { R as RegisterOptions, k as IntrospectionPluginOptions, z as ResourceRegistry } from "../index-BtW7qYwa.mjs";
 import { FastifyPluginAsync } from "fastify";
 
 //#region src/registry/introspectionPlugin.d.ts

package/dist/registry/index.mjs

@@ -1,3 +1,3 @@
-import { n as introspectionPlugin_default, t as introspectionPlugin } from "../registry-D63ee7fl.mjs";
-import { t as ResourceRegistry } from "../ResourceRegistry-DkAeAuTX.mjs";
+import { n as introspectionPlugin_default, t as introspectionPlugin } from "../registry-I-ogLgL9.mjs";
+import { t as ResourceRegistry } from "../ResourceRegistry-CTERg_2x.mjs";
 export { ResourceRegistry, introspectionPlugin_default as introspectionPlugin, introspectionPlugin as introspectionPluginFn };

package/dist/{replyHelpers-ByllIXXV.mjs → replyHelpers-CK-FNO8E.mjs}

@@ -1,29 +1,11 @@
 import { t as __exportAll } from "./chunk-BpYLSNr0.mjs";
+import { toCanonicalList } from "@classytic/repo-core/pagination";
 import fp from "fastify-plugin";
 //#region src/plugins/replyHelpers.ts
 var replyHelpers_exports = /* @__PURE__ */ __exportAll({ replyHelpersPlugin: () => replyHelpersPlugin });
 async function replyHelpersPluginFn(fastify) {
-	fastify.decorateReply("ok", function(data, statusCode = 200) {
-		return this.code(statusCode).send({
-			success: true,
-			data
-		});
-	});
-	fastify.decorateReply("fail", function(error, statusCode = 400) {
-		if (Array.isArray(error)) return this.code(statusCode).send({
-			success: false,
-			errors: error
-		});
-		return this.code(statusCode).send({
-			success: false,
-			error
-		});
-	});
-	fastify.decorateReply("paginated", function(result) {
-		return this.code(200).send({
-			success: true,
-			...result
-		});
+	fastify.decorateReply("sendList", function(input) {
+		return this.code(200).send(toCanonicalList(input));
 	});
 	fastify.decorateReply("stream", function(source, options) {
 		this.code(options.statusCode ?? 200);