@classytic/arc 2.43.0 → 2.45.0

package/dist/utils/index.d.mts

@@ -1,19 +1,19 @@
 
 import { F as getHeader, I as requireSingleHeaderValue, P as ArcHeaders } from "../types-Ddl9OjmE.mjs";
 import { f as getUserId, m as normalizeRoles, p as getUserRoles, t as AnyRecord } from "../base-CZyixEQR.mjs";
-import { Y as OpenApiSchemas, h as QueryParserInterface, p as ParsedQuery } from "../index-mqaqZNpe.mjs";
+import { Y as OpenApiSchemas, h as QueryParserInterface, p as ParsedQuery } from "../index-WH7xgvxS.mjs";
 import { n as ErrorMapper } from "../errorHandler--4rSMMvq.mjs";
 import { a as NotFoundError, c as RateLimitError, d as ValidationError, f as createDomainError, i as ForbiddenError, l as ServiceUnavailableError, m as isArcError, n as ConflictError, o as OrgAccessDeniedError, p as createError, r as ErrorOptions, s as OrgRequiredError, t as ArcError, u as UnauthorizedError } from "../errors-JYc9vwqE.mjs";
 import { errorContractSchema } from "@classytic/repo-core/errors";
 import { FilterClause } from "@classytic/repo-core/query-parser";
 import { FastifyInstance, FastifyReply, FastifyRequest, RouteHandlerMethod } from "fastify";
 //#region src/utils/circuitBreaker.d.ts
-declare const CircuitState: {
+export declare const CircuitState: {
   readonly CLOSED: "CLOSED";
   readonly OPEN: "OPEN";
   readonly HALF_OPEN: "HALF_OPEN";
 };
-type CircuitState = (typeof CircuitState)[keyof typeof CircuitState];
+export type CircuitState = (typeof CircuitState)[keyof typeof CircuitState];
 /**
  * Generic constraint for "any async function" that survives strict TS.
  *
@@ -174,13 +174,13 @@ interface CircuitBreakerStats {
  * error handler sends it as `Retry-After`, so well-behaved clients back off
  * for as long as the breaker is actually going to refuse them.
  */
-declare class CircuitBreakerError extends ArcError {
+export declare class CircuitBreakerError extends ArcError {
   readonly state: CircuitState;
   /** Seconds until the circuit next probes, when known. */
   readonly retryAfter?: number;
   constructor(message: string, state: CircuitState, retryAfter?: number);
 }
-declare class CircuitBreaker<T extends AnyAsyncFn> {
+export declare class CircuitBreaker<T extends AnyAsyncFn> {
   private state;
   private failures;
   private successes;
@@ -267,11 +267,11 @@ declare class CircuitBreaker<T extends AnyAsyncFn> {
  *   { name: 'email-service' }
  * );
  */
-declare function createCircuitBreaker<T extends AnyAsyncFn>(fn: T, options?: CircuitBreakerOptions): CircuitBreaker<T>;
+export declare function createCircuitBreaker<T extends AnyAsyncFn>(fn: T, options?: CircuitBreakerOptions): CircuitBreaker<T>;
 /**
  * Circuit breaker registry for managing multiple breakers
  */
-declare class CircuitBreakerRegistry {
+export declare class CircuitBreakerRegistry {
   private breakers;
   /**
    * Register a circuit breaker
@@ -306,7 +306,7 @@ declare class CircuitBreakerRegistry {
  * Create a new CircuitBreakerRegistry instance.
  * Use this instead of a global singleton — attach to fastify.arc or pass explicitly.
  */
-declare function createCircuitBreakerRegistry(): CircuitBreakerRegistry;
+export declare function createCircuitBreakerRegistry(): CircuitBreakerRegistry;
 //#endregion
 //#region src/utils/circuitBreakerRedis.d.ts
 /**
@@ -336,7 +336,7 @@ interface RedisCircuitBreakerStateOptions {
   windowMs?: number;
 }
 /** Fixed-window cluster failure counter. See the module header. */
-declare class RedisCircuitBreakerState implements CircuitBreakerSharedState {
+export declare class RedisCircuitBreakerState implements CircuitBreakerSharedState {
   #private;
   readonly name = "redis";
   constructor(options: RedisCircuitBreakerStateOptions);
@@ -446,12 +446,12 @@ type CompensationResult = {
  *
  * @typeParam TCtx - Context type shared across steps (defaults to Record<string, unknown>)
  */
-declare function withCompensation<TCtx extends Record<string, unknown> = Record<string, unknown>>(_name: string, steps: readonly CompensationStep<TCtx>[], initialContext?: TCtx, hooks?: CompensationHooks): Promise<CompensationResult>;
+export declare function withCompensation<TCtx extends Record<string, unknown> = Record<string, unknown>>(_name: string, steps: readonly CompensationStep<TCtx>[], initialContext?: TCtx, hooks?: CompensationHooks): Promise<CompensationResult>;
 interface CompensationDefinition<TCtx extends Record<string, unknown> = Record<string, unknown>> {
   readonly name: string;
   readonly execute: (initialContext?: TCtx, hooks?: CompensationHooks) => Promise<CompensationResult>;
 }
-declare function defineCompensation<TCtx extends Record<string, unknown> = Record<string, unknown>>(name: string, steps: readonly CompensationStep<TCtx>[]): CompensationDefinition<TCtx>;
+export declare function defineCompensation<TCtx extends Record<string, unknown> = Record<string, unknown>>(name: string, steps: readonly CompensationStep<TCtx>[]): CompensationDefinition<TCtx>;
 //#endregion
 //#region src/utils/defineErrorMapper.d.ts
 /**
@@ -467,7 +467,7 @@ declare function defineCompensation<TCtx extends Record<string, unknown> = Recor
  * called with a non-`T` error at runtime. This helper codifies that invariant
  * in one place.
  */
-declare function defineErrorMapper<T extends Error>(mapper: ErrorMapper<T>): ErrorMapper;
+export declare function defineErrorMapper<T extends Error>(mapper: ErrorMapper<T>): ErrorMapper;
 //#endregion
 //#region src/utils/defineGuard.d.ts
 interface GuardConfig<T> {
@@ -494,7 +494,7 @@ interface Guard<T> {
 /**
  * Create a typed guard. See module JSDoc for usage.
  */
-declare function defineGuard<T>(config: GuardConfig<T>): Guard<T>;
+export declare function defineGuard<T>(config: GuardConfig<T>): Guard<T>;
 //#endregion
 //#region src/utils/filter-dialect.d.ts
 interface FilterDialect {
@@ -503,12 +503,12 @@ interface FilterDialect {
   /** The operator tokens this dialect can emit — for audits and docs. */
   readonly tokens: readonly string[];
 }
-declare const MONGO_DIALECT: FilterDialect;
+export declare const MONGO_DIALECT: FilterDialect;
 /**
  * Store-neutral: `{ field: { <op>: value } }` with the grammar's own operator names, for a host
  * that compiles the canonical clauses itself.
  */
-declare const NEUTRAL_DIALECT: FilterDialect;
+export declare const NEUTRAL_DIALECT: FilterDialect;
 //#endregion
 //#region src/utils/handleRaw.d.ts
 /**
@@ -521,7 +521,7 @@ declare const NEUTRAL_DIALECT: FilterDialect;
  * @returns The reply, so Fastify waits for it: resolving `undefined` after `reply.send()` while an
  *   async `preSerialization` hook (idempotency, encryption) is pending re-sends an empty body.
  */
-declare function handleRaw<T>(handler: (request: FastifyRequest, reply: FastifyReply) => Promise<T>, statusCode?: number): (request: FastifyRequest, reply: FastifyReply) => Promise<FastifyReply>;
+export declare function handleRaw<T>(handler: (request: FastifyRequest, reply: FastifyReply) => Promise<T>, statusCode?: number): (request: FastifyRequest, reply: FastifyReply) => Promise<FastifyReply>;
 //#endregion
 //#region src/utils/queryParser.d.ts
 interface ArcQueryParserOptions {
@@ -555,7 +555,7 @@ interface ArcQueryParserOptions {
  *   avoids collisions with reserved keys (`page`, `sort`, ...)
  * - Search `?search=`, populate `?populate=a,b`, select `?select=a,-b`
  */
-declare class ArcQueryParser implements QueryParserInterface {
+export declare class ArcQueryParser implements QueryParserInterface {
   /**
    * Public so `QueryResolver` reuses this cap instead of stacking its own
    * (independent caps silently truncate to the lowest).
@@ -597,7 +597,7 @@ declare class ArcQueryParser implements QueryParserInterface {
   };
 }
 /** Create a new ArcQueryParser instance. */
-declare function createQueryParser(options?: ArcQueryParserOptions): ArcQueryParser;
+export declare function createQueryParser(options?: ArcQueryParserOptions): ArcQueryParser;
 //#endregion
 //#region src/utils/responseSchemas.d.ts
 interface JsonSchema {
@@ -624,7 +624,7 @@ interface JsonSchema {
  * Runtime format (flat fields):
  * { page, limit, total, pages, hasNext, hasPrev }
  */
-declare const paginationSchema: JsonSchema;
+export declare const paginationSchema: JsonSchema;
 /**
  * List response schema — accepts every wire shape `toCanonicalList` can
  * emit. Hosts who know their endpoint only ever produces one variant can
@@ -646,18 +646,18 @@ declare const paginationSchema: JsonSchema;
  * per-response branch validation. The list route also serves count, exists
  * and distinct dispatch verbs, so no field is common to every valid shape.
  */
-declare function listResponse(itemSchema: JsonSchema): JsonSchema;
+export declare function listResponse(itemSchema: JsonSchema): JsonSchema;
 /** Offset variant — `{ method: 'offset', data, page, limit, total, pages, hasNext, hasPrev }`. */
-declare function offsetListResponse(itemSchema: JsonSchema): JsonSchema;
+export declare function offsetListResponse(itemSchema: JsonSchema): JsonSchema;
 /** Keyset variant — `{ method: 'keyset', data, limit, hasMore, next: string | null }`. */
-declare function keysetListResponse(itemSchema: JsonSchema): JsonSchema;
+export declare function keysetListResponse(itemSchema: JsonSchema): JsonSchema;
 /** Aggregate variant — same shape as offset, discriminated by `method: 'aggregate'`. */
-declare function aggregateListResponse(itemSchema: JsonSchema): JsonSchema;
+export declare function aggregateListResponse(itemSchema: JsonSchema): JsonSchema;
 /** Bare variant — `{ data }`, no `method` discriminant. */
-declare function bareListResponse(itemSchema: JsonSchema): JsonSchema;
+export declare function bareListResponse(itemSchema: JsonSchema): JsonSchema;
 /** Delete response — flat shape mirroring the canonical delete envelope. */
-declare function deleteResponse(): JsonSchema;
-declare const responses: {
+export declare function deleteResponse(): JsonSchema;
+export declare const responses: {
   200: (schema: JsonSchema) => {
     description: string;
     content: {
@@ -1033,7 +1033,7 @@ declare const responses: {
     };
   };
 };
-declare const queryParams: {
+export declare const queryParams: {
   pagination: {
     page: {
       type: string;
@@ -1070,7 +1070,7 @@ declare const queryParams: {
 /**
  * Get standard list query parameters schema
  */
-declare function getListQueryParams(): AnyRecord;
+export declare function getListQueryParams(): AnyRecord;
 /**
  * Get default response schemas for all CRUD operations.
  *
@@ -1082,7 +1082,7 @@ declare function getListQueryParams(): AnyRecord;
  * Note: `example` properties are stripped from defaults so they work with
  * any Fastify instance (not just createApp which adds `keywords: ['example']`).
  */
-declare function getDefaultCrudSchemas(): Record<string, Record<string, unknown>>;
+export declare function getDefaultCrudSchemas(): Record<string, Record<string, unknown>>;
 //#endregion
 //#region src/utils/runtimeCapabilities.d.ts
 /** What a subsystem declares about the state it holds. */
@@ -1106,7 +1106,7 @@ interface RuntimeCapabilityDeclaration {
  * and encapsulated children of any of them — which is the point: the audit
  * sees what the constructor-time guard cannot.
  */
-declare function declareRuntimeCapability(fastify: FastifyInstance, decl: RuntimeCapabilityDeclaration): void;
+export declare function declareRuntimeCapability(fastify: FastifyInstance, decl: RuntimeCapabilityDeclaration): void;
 //#endregion
 //#region src/utils/schemaConverter.d.ts
 /**
@@ -1127,11 +1127,11 @@ type SchemaIo = "input" | "output";
  * Returns true if it has JSON Schema markers (`type`, `properties`, `$ref`,
  * `allOf`, `anyOf`, `oneOf`, `items`, `enum`) and does NOT have Zod markers.
  */
-declare function isJsonSchema(input: unknown): input is Record<string, unknown>;
+export declare function isJsonSchema(input: unknown): input is Record<string, unknown>;
 /**
  * Check if an object is a Zod schema (has `_zod` marker from Zod v4).
  */
-declare function isZodSchema(input: unknown): boolean;
+export declare function isZodSchema(input: unknown): boolean;
 /**
  * How `toJsonSchema` reacts when a Zod schema CANNOT be converted (zod not
  * installed/loaded, zod v3, or `z.toJSONSchema()` threw):
@@ -1165,7 +1165,7 @@ type UnconvertibleMode = "warn" | "throw";
  *               docblock. Defaults to `'output'`, matching Zod's own default;
  *               arc's request-side call sites pass `'input'` explicitly.
  */
-declare function toJsonSchema(input: unknown, target?: JsonSchemaTarget, mode?: UnconvertibleMode, io?: SchemaIo): Record<string, unknown> | undefined;
+export declare function toJsonSchema(input: unknown, target?: JsonSchemaTarget, mode?: UnconvertibleMode, io?: SchemaIo): Record<string, unknown> | undefined;
 /**
  * Convert all schema fields in an OpenApiSchemas object.
  * JSON Schema values pass through unchanged. Only Zod schemas are converted.
@@ -1173,7 +1173,7 @@ declare function toJsonSchema(input: unknown, target?: JsonSchemaTarget, mode?:
  * Defaults to the `openapi-3.0` target since this function feeds OpenAPI doc
  * generation, not Fastify route validation.
  */
-declare function convertOpenApiSchemas(schemas: OpenApiSchemas, target?: JsonSchemaTarget): OpenApiSchemas;
+export declare function convertOpenApiSchemas(schemas: OpenApiSchemas, target?: JsonSchemaTarget): OpenApiSchemas;
 /**
  * Convert schema values in a Fastify route schema record.
  *
@@ -1187,7 +1187,7 @@ declare function convertOpenApiSchemas(schemas: OpenApiSchemas, target?: JsonSch
  * Defaults to `draft-7` so Fastify v5's bundled AJV 8 accepts the output.
  * Pass `openapi-3.0` (or `openapi-3.1`) when generating OpenAPI documents.
  */
-declare function convertRouteSchema(schema: Record<string, unknown>, target?: JsonSchemaTarget): Record<string, unknown>;
+export declare function convertRouteSchema(schema: Record<string, unknown>, target?: JsonSchemaTarget): Record<string, unknown>;
 //#endregion
 //#region src/utils/shutdown.d.ts
 interface ShutdownParticipant {
@@ -1197,9 +1197,9 @@ interface ShutdownParticipant {
   drain?(): void | Promise<void>;
 }
 /** Descendants of admitted work may finish their causal publications during shutdown. */
-declare function runAdmittedWork<T>(work: () => T | Promise<T>): Promise<T>;
+export declare function runAdmittedWork<T>(work: () => T | Promise<T>): Promise<T>;
 /** A participant's stop must prevent new work; drain waits for work already admitted. */
-declare function registerShutdownParticipant(fastify: FastifyInstance, participant: ShutdownParticipant): void;
+export declare function registerShutdownParticipant(fastify: FastifyInstance, participant: ShutdownParticipant): void;
 //#endregion
 //#region src/utils/simpleEqualityMatcher.d.ts
 /**
@@ -1226,7 +1226,7 @@ declare function registerShutdownParticipant(fastify: FastifyInstance, participa
  *                                matchesFilter: simpleEqualityMatcher };
  * ```
  */
-declare function simpleEqualityMatcher(item: unknown, filters: Record<string, unknown>): boolean;
+export declare function simpleEqualityMatcher(item: unknown, filters: Record<string, unknown>): boolean;
 //#endregion
 //#region src/utils/sseStream.d.ts
 interface SseStreamOptions {
@@ -1258,7 +1258,7 @@ interface SseStream {
  * gate (auth, permissions, validation) has passed — after `hijack()` no
  * JSON error can be sent.
  */
-declare function openSseStream(request: FastifyRequest, reply: FastifyReply, options?: SseStreamOptions): SseStream;
+export declare function openSseStream(request: FastifyRequest, reply: FastifyReply, options?: SseStreamOptions): SseStream;
 //#endregion
 //#region src/utils/stateMachine.d.ts
 /**
@@ -1369,7 +1369,7 @@ type TransitionConfig = Record<string, string[] | {
  *   },
  * }, { trackHistory: true });
  */
-declare function createStateMachine(name: string, transitions?: TransitionConfig, options?: {
+export declare function createStateMachine(name: string, transitions?: TransitionConfig, options?: {
   trackHistory?: boolean;
 }): StateMachine;
 //#endregion
@@ -1381,7 +1381,7 @@ declare function createStateMachine(name: string, transitions?: TransitionConfig
  * client uses to detect the v1 UI message stream protocol (vs the older
  * data stream protocol). Surfaced as a constant so hosts don't memorise it.
  */
-declare const UI_MESSAGE_STREAM_HEADERS: {
+export declare const UI_MESSAGE_STREAM_HEADERS: {
   readonly "content-type": "text/event-stream";
   readonly "cache-control": "no-cache";
   readonly connection: "keep-alive";
@@ -1438,7 +1438,7 @@ interface PipeUIMessageStreamOptions {
  * });
  * ```
  */
-declare function pipeUIMessageStreamToReply(reply: FastifyReply, stream: ReadableStream<unknown>, options?: PipeUIMessageStreamOptions): Promise<void>;
+export declare function pipeUIMessageStreamToReply(reply: FastifyReply, stream: ReadableStream<unknown>, options?: PipeUIMessageStreamOptions): Promise<void>;
 /**
  * Promote a stream auth token from the query string into the `Authorization`
  * header, in place, so the standard `fastify.authenticate` decorator can read it.
@@ -1462,7 +1462,7 @@ declare function pipeUIMessageStreamToReply(reply: FastifyReply, stream: Readabl
  *
  * @param queryParam name of the query parameter carrying the token (default `token`).
  */
-declare function promoteStreamTokenToHeader(request: FastifyRequest, queryParam?: string): void;
+export declare function promoteStreamTokenToHeader(request: FastifyRequest, queryParam?: string): void;
 /**
  * Collect the CORS / `Vary` headers a plugin (e.g. `@fastify/cors`, whose default
  * `onRequest` hook runs BEFORE the route handler) has already set on the reply, so
@@ -1476,7 +1476,7 @@ declare function promoteStreamTokenToHeader(request: FastifyRequest, queryParam?
  * honors the host's configured policy (origin allowlist, credentials) rather than
  * re-deriving it. Returns lowercased header names suitable for `writeHead`.
  */
-declare function forwardedStreamHeaders(reply: FastifyReply): Record<string, string>;
+export declare function forwardedStreamHeaders(reply: FastifyReply): Record<string, string>;
 /**
  * Heuristic — does this value look like a Web `ReadableStream`?
  *
@@ -1486,7 +1486,7 @@ declare function forwardedStreamHeaders(reply: FastifyReply): Record<string, str
  * the Streams spec mandates: `getReader`, `cancel`, and the `locked`
  * getter.
  */
-declare function isReadableStream(value: unknown): value is ReadableStream<unknown>;
+export declare function isReadableStream(value: unknown): value is ReadableStream<unknown>;
 //#endregion
 //#region src/utils/typeGuards.d.ts
 interface EventsDecorator {
@@ -1499,8 +1499,8 @@ interface EventsDecorator {
   transportName: string;
 }
 /** Check if fastify has the events plugin registered */
-declare function hasEvents(instance: FastifyInstance): instance is FastifyInstance & {
+export declare function hasEvents(instance: FastifyInstance): instance is FastifyInstance & {
   events: EventsDecorator;
 };
 //#endregion
-export { type AnyAsyncFn, ArcError, type ArcHeaders, ArcQueryParser, type ArcQueryParserOptions, CircuitBreaker, CircuitBreakerError, type CircuitBreakerOptions, type CircuitBreakerRedisLike, CircuitBreakerRegistry, type CircuitBreakerSharedState, type CircuitBreakerStats, CircuitState, type CompensationDefinition, type CompensationError, type CompensationHooks, type CompensationResult, type CompensationStep, ConflictError, type ErrorOptions, type EventsDecorator, type FilterDialect, ForbiddenError, type Guard, type GuardConfig, type JsonSchema, type JsonSchemaTarget, MONGO_DIALECT, NEUTRAL_DIALECT, NotFoundError, OrgAccessDeniedError, OrgRequiredError, type PipeUIMessageStreamOptions, RateLimitError, RedisCircuitBreakerState, type RedisCircuitBreakerStateOptions, type RuntimeCapabilityDeclaration, type SchemaIo, ServiceUnavailableError, type ShutdownParticipant, type SseStream, type SseStreamOptions, type StateMachine, type TransitionConfig, UI_MESSAGE_STREAM_HEADERS, UnauthorizedError, type UnconvertibleMode, ValidationError, aggregateListResponse, bareListResponse, convertOpenApiSchemas, convertRouteSchema, createCircuitBreaker, createCircuitBreakerRegistry, createDomainError, createError, createQueryParser, createStateMachine, declareRuntimeCapability, defineCompensation, defineErrorMapper, defineGuard, deleteResponse, errorContractSchema, forwardedStreamHeaders, getDefaultCrudSchemas, getHeader, getListQueryParams, getUserId, getUserRoles, handleRaw, hasEvents, isArcError, isJsonSchema, isReadableStream, isZodSchema, keysetListResponse, listResponse, normalizeRoles, offsetListResponse, openSseStream, paginationSchema, pipeUIMessageStreamToReply, promoteStreamTokenToHeader, queryParams, registerShutdownParticipant, requireSingleHeaderValue, responses, runAdmittedWork, simpleEqualityMatcher, toJsonSchema, withCompensation };
+export { type AnyAsyncFn, ArcError, type ArcHeaders, type ArcQueryParserOptions, type CircuitBreakerOptions, type CircuitBreakerRedisLike, type CircuitBreakerSharedState, type CircuitBreakerStats, type CompensationDefinition, type CompensationError, type CompensationHooks, type CompensationResult, type CompensationStep, ConflictError, type ErrorOptions, type EventsDecorator, type FilterDialect, ForbiddenError, type Guard, type GuardConfig, type JsonSchema, type JsonSchemaTarget, NotFoundError, OrgAccessDeniedError, OrgRequiredError, type PipeUIMessageStreamOptions, RateLimitError, type RedisCircuitBreakerStateOptions, type RuntimeCapabilityDeclaration, type SchemaIo, ServiceUnavailableError, type ShutdownParticipant, type SseStream, type SseStreamOptions, type StateMachine, type TransitionConfig, UnauthorizedError, type UnconvertibleMode, ValidationError, createDomainError, createError, errorContractSchema, getHeader, getUserId, getUserRoles, isArcError, normalizeRoles, requireSingleHeaderValue };

package/dist/utils/index.mjs

@@ -1,13 +1,13 @@
-/*! @classytic/arc v2.43.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-CtrywMHP.mjs";
-import { t as simpleEqualityMatcher } from "../simpleEqualityMatcher-auW8QjXN.mjs";
-import { n as requireSingleHeaderValue, t as getHeader } from "../headers-BbkIF6vA.mjs";
-import { n as getUserRoles, r as normalizeRoles, t as getUserId } from "../userHelpers-aklawRaK.mjs";
-import { C as paginationSchema, D as createQueryParser, E as ArcQueryParser, O as MONGO_DIALECT, S as offsetListResponse, T as responses, _ as errorContractSchema, a as defineCompensation, b as keysetListResponse, c as CircuitBreaker, d as CircuitState, f as createCircuitBreaker, g as deleteResponse, h as bareListResponse, i as defineErrorMapper, k as NEUTRAL_DIALECT, l as CircuitBreakerError, m as aggregateListResponse, n as handleRaw, o as withCompensation, p as createCircuitBreakerRegistry, r as defineGuard, s as RedisCircuitBreakerState, t as createStateMachine, u as CircuitBreakerRegistry, v as getDefaultCrudSchemas, w as queryParams, x as listResponse, y as getListQueryParams } from "../utils-ec1oTo1n.mjs";
-import { a as isZodSchema, i as isJsonSchema, n as convertRouteSchema, o as toJsonSchema, t as convertOpenApiSchemas } from "../schemaConverter-BORek3O-.mjs";
-import { a as promoteStreamTokenToHeader, i as pipeUIMessageStreamToReply, n as forwardedStreamHeaders, r as isReadableStream, t as UI_MESSAGE_STREAM_HEADERS } from "../streaming-DjTQhZrN.mjs";
-import { n as declareRuntimeCapability } from "../runtimeCapabilities-0tccjRlj.mjs";
-import { i as runAdmittedWork, r as registerShutdownParticipant } from "../shutdown-MqA81z_P.mjs";
-import { t as openSseStream } from "../sseStream-B5_Afiqn.mjs";
-import { t as hasEvents } from "../typeGuards-CySF12G-.mjs";
+/*! @classytic/arc v2.45.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-C9G4A8cN.mjs";
+import { t as simpleEqualityMatcher } from "../simpleEqualityMatcher-WdZw6GOt.mjs";
+import { n as requireSingleHeaderValue, t as getHeader } from "../headers-B6DRXXzT.mjs";
+import { n as getUserRoles, r as normalizeRoles, t as getUserId } from "../userHelpers-Nc5ePCsf.mjs";
+import { C as paginationSchema, D as createQueryParser, E as ArcQueryParser, O as MONGO_DIALECT, S as offsetListResponse, T as responses, _ as errorContractSchema, a as defineCompensation, b as keysetListResponse, c as CircuitBreaker, d as CircuitState, f as createCircuitBreaker, g as deleteResponse, h as bareListResponse, i as defineErrorMapper, k as NEUTRAL_DIALECT, l as CircuitBreakerError, m as aggregateListResponse, n as handleRaw, o as withCompensation, p as createCircuitBreakerRegistry, r as defineGuard, s as RedisCircuitBreakerState, t as createStateMachine, u as CircuitBreakerRegistry, v as getDefaultCrudSchemas, w as queryParams, x as listResponse, y as getListQueryParams } from "../utils-QWSIKqAk.mjs";
+import { a as isZodSchema, i as isJsonSchema, n as convertRouteSchema, o as toJsonSchema, t as convertOpenApiSchemas } from "../schemaConverter-rzBovk00.mjs";
+import { a as promoteStreamTokenToHeader, i as pipeUIMessageStreamToReply, n as forwardedStreamHeaders, r as isReadableStream, t as UI_MESSAGE_STREAM_HEADERS } from "../streaming-BLg1buwL.mjs";
+import { n as declareRuntimeCapability } from "../runtimeCapabilities-C7gAbIxC.mjs";
+import { i as runAdmittedWork, r as registerShutdownParticipant } from "../shutdown-BW8qwgpx.mjs";
+import { t as openSseStream } from "../sseStream-B7rPhIQw.mjs";
+import { t as hasEvents } from "../typeGuards-CtZJypJO.mjs";
 export { ArcError, ArcQueryParser, CircuitBreaker, CircuitBreakerError, CircuitBreakerRegistry, CircuitState, ConflictError, ForbiddenError, MONGO_DIALECT, NEUTRAL_DIALECT, NotFoundError, OrgAccessDeniedError, OrgRequiredError, RateLimitError, RedisCircuitBreakerState, ServiceUnavailableError, UI_MESSAGE_STREAM_HEADERS, UnauthorizedError, ValidationError, aggregateListResponse, bareListResponse, convertOpenApiSchemas, convertRouteSchema, createCircuitBreaker, createCircuitBreakerRegistry, createDomainError, createError, createQueryParser, createStateMachine, declareRuntimeCapability, defineCompensation, defineErrorMapper, defineGuard, deleteResponse, errorContractSchema, forwardedStreamHeaders, getDefaultCrudSchemas, getHeader, getListQueryParams, getUserId, getUserRoles, handleRaw, hasEvents, isArcError, isJsonSchema, isReadableStream, isZodSchema, keysetListResponse, listResponse, normalizeRoles, offsetListResponse, openSseStream, paginationSchema, pipeUIMessageStreamToReply, promoteStreamTokenToHeader, queryParams, registerShutdownParticipant, requireSingleHeaderValue, responses, runAdmittedWork, simpleEqualityMatcher, toJsonSchema, withCompensation };

package/dist/{utils-ec1oTo1n.mjs → utils-QWSIKqAk.mjs}

@@ -1,7 +1,7 @@
-/*! @classytic/arc v2.43.0 | MIT | https://classytic.com */
-import { h as RESERVED_QUERY_PARAMS } from "./constants-Cu7Mx7_U.mjs";
-import { t as arcLog } from "./logger-DXjfIqjV.mjs";
-import { t as ArcError, u as ValidationError } from "./errors-CtrywMHP.mjs";
+/*! @classytic/arc v2.45.0 | MIT | https://classytic.com */
+import { h as RESERVED_QUERY_PARAMS } from "./constants-B90SnSQn.mjs";
+import { t as arcLog } from "./logger-vxu0DXf_.mjs";
+import { t as ArcError, u as ValidationError } from "./errors-C9G4A8cN.mjs";
 import { errorContractSchema as errorContractSchema$1 } from "@classytic/repo-core/errors";
 import { readEnv } from "@classytic/primitives/environment";
 import { OPERATOR_DESCRIPTIONS, URL_OPERATORS, escapeRegex, isQueryGrammarError, readFilterClauses, readPageRequest, readSearch, readSelect, readSort } from "@classytic/repo-core/query-parser";

package/dist/{validate-9yzHC1e2.mjs → validate-CT4umNhp.mjs}

@@ -1,6 +1,6 @@
-/*! @classytic/arc v2.43.0 | MIT | https://classytic.com */
-import { t as __exportAll } from "./rolldown-runtime-D1w9Y1VJ.mjs";
-import { _ as pathTouchesBlocked } from "./plugin-BccET1tL.mjs";
+/*! @classytic/arc v2.45.0 | MIT | https://classytic.com */
+import { r as __exportAll } from "./rolldown-runtime-AD16t29l.mjs";
+import { _ as pathTouchesBlocked } from "./plugin-BDBOS3-c.mjs";
 //#region src/core/aggregation/normalize.ts
 /**
 * Framework cap on URL-driven aggregation limits when the host opts

package/dist/{versioning-Bsb51gGT.d.mts → versioning-Bqm_57Qt.d.mts}

@@ -119,6 +119,28 @@ interface SSEOptions {
    * Set `null` to disable promotion (e.g. cookie-only auth).
    */
   tokenQueryParam?: string | null;
+  /**
+   * Keyed delivery: the connection keys (user ids by default) an event is for.
+   * Delivery becomes one map lookup per key, and org-scoping + `filter` still run
+   * on those connections only. `null`/`undefined` = broadcast through the filter.
+   * Each replica resolves it against its own connections. Setting it switches the
+   * plugin to one shared subscription per pattern. See wiki/plugins.md.
+   */
+  audience?: (event: DomainEvent<unknown>) => readonly string[] | null | undefined;
+  /** Key a connection is indexed under for `audience` (default: scope user id; none = broadcasts only). */
+  connectionKey?: (request: FastifyRequest) => string | null | undefined;
+}
+/** Live connection gauge, summed across every `ssePlugin` registration on the instance. */
+interface SSEStats {
+  /** Open SSE connections. */
+  connections: number;
+  /** Distinct `connectionKey`s indexed (0 without `audience`). */
+  keys: number;
+}
+declare module "fastify" {
+  interface FastifyInstance {
+    sseStats: () => SSEStats;
+  }
 }
 declare const _default$3: FastifyPluginAsync<SSEOptions>;
 //#endregion
@@ -243,4 +265,4 @@ declare module "fastify" {
 }
 declare const _default: FastifyPluginAsync<VersioningOptions>;
 //#endregion
-export { _default$5 as _, MetricsOptions as a, RealtimeOptions as c, _default$3 as d, CachingOptions as f, ShutdownState as g, GracefulShutdownOptions as h, MetricsCollector as i, _default$2 as l, _default$4 as m, _default as n, _default$1 as o, CachingRule as p, MetricEntry as r, ChangeOperation as s, VersioningOptions as t, SSEOptions as u };
+export { ShutdownState as _, MetricsOptions as a, RealtimeOptions as c, SSEStats as d, _default$3 as f, GracefulShutdownOptions as g, _default$4 as h, MetricsCollector as i, _default$2 as l, CachingRule as m, _default as n, _default$1 as o, CachingOptions as p, MetricEntry as r, ChangeOperation as s, VersioningOptions as t, SSEOptions as u, _default$5 as v };

package/dist/{versioning-fhhWHV74.mjs → versioning-JIqxO64K.mjs}

@@ -1,6 +1,6 @@
-/*! @classytic/arc v2.43.0 | MIT | https://classytic.com */
-import { t as __exportAll } from "./rolldown-runtime-D1w9Y1VJ.mjs";
-import { d as createDomainError } from "./errors-CtrywMHP.mjs";
+/*! @classytic/arc v2.45.0 | MIT | https://classytic.com */
+import { r as __exportAll } from "./rolldown-runtime-AD16t29l.mjs";
+import { d as createDomainError } from "./errors-C9G4A8cN.mjs";
 import fp from "fastify-plugin";
 //#region src/plugins/versioning.ts
 var versioning_exports = /* @__PURE__ */ __exportAll({

package/dist/{workScope-zpPyge4t.mjs → workScope-BDjGXwU9.mjs}

@@ -1,5 +1,5 @@
-/*! @classytic/arc v2.43.0 | MIT | https://classytic.com */
-import { n as requestContext } from "./requestContext-Dsu9P1bV.mjs";
+/*! @classytic/arc v2.45.0 | MIT | https://classytic.com */
+import { n as requestContext } from "./requestContext-B8JKbeb7.mjs";
 //#region src/context/workScope.ts
 /** Enter a scope for `fn`, or run it inside the active one. */
 function runWorkScope(seed, fn) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/arc",
-  "version": "2.43.0",
+  "version": "2.45.0",
   "description": "Resource-oriented backend framework for Fastify - clean, minimal, powerful, tree-shakable",
   "type": "module",
   "exports": {
@@ -340,6 +340,7 @@
     "smoke:mcp": "node scripts/mcp-e2e.mjs",
     "bench:memory": "node --expose-gc scripts/bench-memory.mjs",
     "bench:http": "node --expose-gc scripts/bench-http.mjs",
+    "bench:sse": "node scripts/bench-sse-audience.mjs",
     "push": "classytic-push",
     "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
     "release": "npm run push -- main && npm run release:tag && npm publish",
@@ -486,59 +487,59 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@better-auth/drizzle-adapter": "^1.6.19",
-    "@better-auth/mongo-adapter": "^1.6.19",
-    "@biomejs/biome": "^2.5.7",
-    "@classytic/dev-tools": "^0.2.0",
-    "@classytic/gitkit": ">=0.1.0",
-    "@classytic/mongokit": "^3.40.1",
+    "@better-auth/drizzle-adapter": "^1.7.10",
+    "@better-auth/mongo-adapter": "^1.7.10",
+    "@biomejs/biome": "^2.5.15",
+    "@classytic/dev-tools": "^0.2.1",
+    "@classytic/gitkit": ">=0.3.0",
+    "@classytic/mongokit": "^3.43.0",
     "@classytic/pgkit": "^0.1.0",
-    "@classytic/primitives": "^0.31.0",
-    "@classytic/repo-core": "^0.31.0",
-    "@classytic/sqlitekit": "^0.9.0",
-    "@classytic/streamline": "^2.8.2",
-    "@electric-sql/pglite": "^0.5.4",
-    "@fastify/cors": "^11.2.0",
-    "@fastify/helmet": "^13.0.2",
-    "@fastify/jwt": "^10.1.0",
-    "@fastify/multipart": "^10.0.0",
-    "@fastify/rate-limit": "^11.0.0",
-    "@fastify/sensible": "^6.0.4",
-    "@fastify/static": "^10.1.2",
-    "@fastify/type-provider-typebox": "^6.1.0",
-    "@fastify/under-pressure": "^9.0.3",
-    "@fastify/websocket": "^11.2.0",
-    "@modelcontextprotocol/client": "^2.0.0",
-    "@modelcontextprotocol/node": "^2.0.0",
-    "@modelcontextprotocol/server": "^2.0.0",
+    "@classytic/primitives": "^0.34.0",
+    "@classytic/repo-core": "^0.31.1",
+    "@classytic/sqlitekit": "^0.10.0",
+    "@classytic/streamline": "^2.11.0",
+    "@electric-sql/pglite": "^0.5.10",
+    "@fastify/cors": "^11.3.1",
+    "@fastify/helmet": "^13.2.0",
+    "@fastify/jwt": "^10.2.5",
+    "@fastify/multipart": "^10.1.4",
+    "@fastify/rate-limit": "^11.2.1",
+    "@fastify/sensible": "^6.0.7",
+    "@fastify/static": "^10.1.6",
+    "@fastify/type-provider-typebox": "^6.3.0",
+    "@fastify/under-pressure": "^9.2.1",
+    "@fastify/websocket": "^11.3.4",
+    "@modelcontextprotocol/client": "^2.3.1",
+    "@modelcontextprotocol/node": "^2.1.1",
+    "@modelcontextprotocol/server": "^2.3.1",
     "@opentelemetry/api": "^1.9.1",
-    "@types/node": "^22.19.21",
+    "@types/node": "^26.6.5",
     "@types/qs": "^6.15.1",
-    "@vitest/coverage-v8": "^5.0.0",
+    "@vitest/coverage-v8": "^5.0.5",
     "ajv": "^8.20.0",
-    "better-auth": "^1.7.3",
+    "better-auth": "^1.7.10",
     "better-sqlite3": "^13.0.3",
-    "bullmq": "^6.1.2",
-    "dotenv": "^17.4.2",
-    "drizzle-orm": "^0.45.2",
-    "fast-check": "^4.8.0",
-    "fastify": "^5.12.1",
-    "fastify-raw-body": "^6.0.1",
-    "h3-js": "^4.4.0",
+    "bullmq": "^6.3.16",
+    "dotenv": "^18.0.8",
+    "drizzle-orm": "^0.45.4",
+    "fast-check": "^4.10.2",
+    "fastify": "^5.12.7",
+    "fastify-raw-body": "^6.0.3",
+    "h3-js": "^4.5.0",
     "ioredis": "^6.0.0",
-    "jose": "^6.2.3",
+    "jose": "^6.2.12",
     "jsonwebtoken": "^9.0.3",
-    "knip": "^6.31.0",
-    "mongodb": "^7.3.0",
-    "mongodb-memory-server": "^11.2.0",
-    "mongoose": "^9.9.1",
-    "publint": "^0.3.21",
-    "tsdown": "^0.22.14",
-    "typebox": "^1.3.6",
+    "knip": "^6.41.0",
+    "mongodb": "^7.7.0",
+    "mongodb-memory-server": "^11.3.0",
+    "mongoose": "^9.11.2",
+    "publint": "^0.3.25",
+    "tsdown": "^0.23.1",
+    "typebox": "^1.4.2",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.0",
-    "ws": "^8.21.0",
-    "zod": "^4.4.3"
+    "vitest": "^5.0.5",
+    "ws": "^8.22.0",
+    "zod": "^4.6.7"
   },
   "config": {
     "mongodbMemoryServer": {
@@ -568,11 +569,5 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/classytic/arc.git"
-  },
-  "overrides": {
-    "better-sqlite3": "$better-sqlite3",
-    "better-auth": {
-      "vitest": "$vitest"
-    }
   }
 }

package/dist/rolldown-runtime-D1w9Y1VJ.mjs

@@ -1,15 +0,0 @@
-/*! @classytic/arc v2.43.0 | MIT | https://classytic.com */
-import "node:module";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
-export { __exportAll as t };