@classytic/arc 2.11.4 → 2.14.0

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-CXXRbnf8.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-DsglKfM_.mjs";
-import { i as errorHandlerPlugin, n as ErrorMapper, r as defaultIsDuplicateKeyError, t as ErrorHandlerOptions } from "../errorHandler-DEWmGWPz.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.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.4";
+	const resolvedVersion = serviceVersion ?? "2.14.0";
 	const exporter = new OTLPTraceExporter({ url: exporterUrl });
 	const provider = new NodeTracerProvider({ resource: { attributes: {
 		"service.name": serviceName,

package/dist/presets/filesUpload.d.mts

@@ -1,6 +1,6 @@
-import { nt as PresetResult } from "../index-CXXRbnf8.mjs";
-import { r as RequestScope } from "../types-DDyTPc6y.mjs";
-import { c as PermissionCheck } from "../fields-BRjxOAFp.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
@@ -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-CXXRbnf8.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-CXXRbnf8.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-CXXRbnf8.mjs";
-import { c as PermissionCheck } from "../fields-BRjxOAFp.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-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-stream-xTGxB2bm.d.mts → redis-stream-D6HzR1Z_.d.mts}

@@ -1,4 +1,4 @@
-import { i as EventLogger, n as DomainEvent, o as EventTransport, r as EventHandler } from "./EventTransport-CYNUXdCJ.mjs";
+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 {

package/dist/registry/index.d.mts

@@ -1,4 +1,4 @@
-import { R as RegisterOptions, k as IntrospectionPluginOptions, z as ResourceRegistry } from "../index-CXXRbnf8.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);