@classytic/arc 2.11.4 → 2.14.0

package/dist/{index-m8mOOlFW.d.mts → index-Ds61mrJE.d.mts}

@@ -1,7 +1,9 @@
-import { B as ResourceDefinition, C as RequestContext, F as FastifyWithDecorators, Pt as AnyRecord, T as CrudRouterOptions, _t as IControllerResponse, at as ResourceConfig, gt as IController, q as CrudController, vt as IRequestContext } from "./index-CXXRbnf8.mjs";
-import { r as RequestScope } from "./types-DDyTPc6y.mjs";
-import { c as PermissionCheck } from "./fields-BRjxOAFp.mjs";
+import { C as RequestContext, Ct as AggregationConfig, F as FastifyWithDecorators, T as CrudRouterOptions, V as ResourceDefinition, Wt as AnyRecord, _t as IControllerResponse, at as ResourceConfig, gt as IController, q as CrudController, vt as IRequestContext } from "./index-BtW7qYwa.mjs";
+import { i as RequestScope } from "./types-CTYvcwHe.mjs";
+import { c as PermissionCheck } from "./fields-COhcH3fk.mjs";
 import { FastifyReply, FastifyRequest, RouteHandlerMethod } from "fastify";
+import { AggDateBucket, AggMeasure, AggTopN } from "@classytic/repo-core/repository";
+import { LookupSpec } from "@classytic/repo-core/lookup";
 
 //#region src/constants.d.ts
 /**
@@ -52,6 +54,50 @@ declare const MAX_FILTER_DEPTH: 10;
  */
 declare const RESERVED_QUERY_PARAMS: Readonly<Set<string>>;
 //#endregion
+//#region src/core/aggregation/defineAggregation.d.ts
+/**
+ * Declare a single resource aggregation. Exported configs flow into
+ * `defineResource({ aggregations: { ... } })` either as named keys or
+ * via auto-discovery patterns (loadAggregations — future).
+ *
+ * @example Inline
+ * ```ts
+ * defineResource({
+ *   name: 'order',
+ *   aggregations: {
+ *     revenueByStatus: defineAggregation({
+ *       groupBy: 'status',
+ *       measures: { count: 'count', revenue: 'sum:totalPrice' },
+ *       permissions: requireRoles(['admin']),
+ *     }),
+ *   },
+ * });
+ * ```
+ *
+ * @example Multi-file
+ * ```ts
+ * // orders/aggregations/revenue-by-status.ts
+ * import { defineAggregation } from '@classytic/arc';
+ *
+ * export const revenueByStatus = defineAggregation({
+ *   groupBy: 'status',
+ *   measures: { count: 'count', revenue: 'sum:totalPrice' },
+ *   permissions: requireRoles(['admin']),
+ *   timeout: 5000,
+ *   cache: { staleTime: 60 },
+ * });
+ *
+ * // orders/order.resource.ts
+ * import * as aggregations from './aggregations/index.js';
+ *
+ * defineResource({
+ *   name: 'order',
+ *   aggregations,                                  // 30+ entries flow in
+ * });
+ * ```
+ */
+declare function defineAggregation(config: AggregationConfig): AggregationConfig;
+//#endregion
 //#region src/core/createCrudRouter.d.ts
 /**
  * Create CRUD routes for a controller.
@@ -181,4 +227,4 @@ declare function createCrudHandlers<TDoc>(controller: IController<TDoc>): {
   delete: (req: FastifyRequest, reply: FastifyReply) => Promise<void>;
 };
 //#endregion
-export { MAX_REGEX_LENGTH as C, RESERVED_QUERY_PARAMS as D, MutationOperation as E, SYSTEM_FIELDS as O, MAX_FILTER_DEPTH as S, MUTATION_OPERATIONS as T, DEFAULT_UPDATE_METHOD as _, getControllerScope as a, HookOperation as b, createCrudRouter as c, CrudOperation as d, DEFAULT_ID_FIELD as f, DEFAULT_TENANT_FIELD as g, DEFAULT_SORT as h, getControllerContext as i, createPermissionMiddleware as l, DEFAULT_MAX_LIMIT as m, createFastifyHandler as n, sendControllerResponse as o, DEFAULT_LIMIT as p, createRequestContext as r, defineResourceVariants as s, createCrudHandlers as t, CRUD_OPERATIONS as u, HOOK_OPERATIONS as v, MAX_SEARCH_LENGTH as w, HookPhase as x, HOOK_PHASES as y };
+export { MAX_FILTER_DEPTH as C, MutationOperation as D, MUTATION_OPERATIONS as E, RESERVED_QUERY_PARAMS as O, HookPhase as S, MAX_SEARCH_LENGTH as T, DEFAULT_TENANT_FIELD as _, getControllerScope as a, HOOK_PHASES as b, createCrudRouter as c, CRUD_OPERATIONS as d, CrudOperation as f, DEFAULT_SORT as g, DEFAULT_MAX_LIMIT as h, getControllerContext as i, SYSTEM_FIELDS as k, createPermissionMiddleware as l, DEFAULT_LIMIT as m, createFastifyHandler as n, sendControllerResponse as o, DEFAULT_ID_FIELD as p, createRequestContext as r, defineResourceVariants as s, createCrudHandlers as t, defineAggregation as u, DEFAULT_UPDATE_METHOD as v, MAX_REGEX_LENGTH as w, HookOperation as x, HOOK_OPERATIONS as y };