@classytic/arc 2.20.0 → 2.22.0

package/dist/{index-DUa8WHz3.d.mts → index-D8MKYGDa.d.mts}

@@ -1,11 +1,12 @@
-import { C as RequestContext, Et as AggregationConfig, F as FastifyWithDecorators, H as ActionDefinition, K as ArcFieldRule, L as RequestWithExtras, T as CrudRouterOptions, V as ResourceDefinition, bt as IControllerResponse, ht as RouteSchemaOptions, pt as RouteMcpConfig, q as CrudController, qt as AnyRecord, st as ResourceConfig, xt as IRequestContext, yt as IController } from "./index-_--GyzcO.mjs";
-import { i as RequestScope } from "./types-LNebCoJx.mjs";
-import { c as PermissionCheck } from "./fields-C7ahdGYf.mjs";
+import { C as RequestContext, Et as ActionDefinition, F as FastifyWithDecorators, H as CrudController, L as RequestWithExtras, Lt as IController, Rt as IControllerResponse, T as CrudRouterOptions, U as ResourceConfig, V as ResourceDefinition, et as RouteSchemaOptions, jt as RouteMcpConfig, qt as AnyRecord, tt as ArcFieldRule, ut as AggregationConfig, zt as IRequestContext } from "./index-DbtgCOCj.mjs";
+import { i as RequestScope } from "./types-DH0GupI7.mjs";
+import { t as PermissionCheck } from "./types-Csxga7d3.mjs";
+import "./fastify-augmentation-9_fuetB4.mjs";
 import { FastifyReply, FastifyRequest, RouteHandlerMethod } from "fastify";
 import { z } from "zod";
+import { DataAdapter } from "@classytic/repo-core/adapter";
 import { AggDateBucket, AggMeasure, AggTopN } from "@classytic/repo-core/repository";
 import { LookupSpec } from "@classytic/repo-core/lookup";
-
 //#region src/constants.d.ts
 /**
  * Arc Framework Constants — Single Source of Truth
@@ -130,7 +131,7 @@ declare function createPermissionMiddleware(permission: PermissionCheck, resourc
  * Plain JSON-Schema entries skip the inference path entirely (they go
  * through the untyped `ActionDefinition` form).
  */
-interface DefineActionConfig<TSchema extends z.ZodTypeAny | undefined = undefined, TData = (TSchema extends z.ZodTypeAny ? z.infer<TSchema> : Record<string, unknown>)> {
+interface DefineActionConfig<TSchema extends z.ZodTypeAny | undefined = undefined, TData = TSchema extends z.ZodTypeAny ? z.infer<TSchema> : Record<string, unknown>> {
   /** Per-action body schema (Zod v4). Drives both AJV validation and the typed `data` param. */
   schema?: TSchema;
   /** Per-action permission gate. Falls back to resource-level if omitted. */
@@ -167,6 +168,86 @@ interface DefineActionConfig<TSchema extends z.ZodTypeAny | undefined = undefine
  */
 declare function defineAction<TSchema extends z.ZodTypeAny | undefined = undefined>(config: DefineActionConfig<TSchema>): ActionDefinition;
 //#endregion
+//#region src/core/defineResource/seams.d.ts
+/**
+ * Structural adapter boundary — the `ControllerLike` pattern (v2.10.6)
+ * applied to adapters. `DataAdapter<T>` is invariant in `T`, so a
+ * `DataAdapter<HydratedDocument<IProduct>>` built by the HOST does not
+ * assign to a module's `DataAdapter<AnyRecord>` slot; before this type,
+ * module authors erased the slot to `unknown` and cast at every use.
+ *
+ * Arc only reaches for these members at runtime — the rest of the adapter's
+ * shape is the caller's concern. All slots optional + `unknown` so every
+ * kit adapter (mongokit, sqlitekit, prismakit, custom) assigns structurally.
+ *
+ * Used by {@link ResourceSeams}; `ResourceConfig.adapter` itself stays
+ * `DataAdapter<TDoc>` so `defineResource`'s doc-type inference is untouched.
+ */
+interface AdapterLike {
+  repository?: unknown;
+  generateSchemas?: unknown;
+  getSchemaMetadata?: unknown;
+}
+/**
+ * Seam-slot type transform, two widenings per property:
+ *
+ *   - admits explicit `undefined` — {@link mergeResourceConfig} skips
+ *     `undefined` values at runtime, so the type says so. Makes
+ *     field-mapping seams (`{ permissions: cfg.permissionsMap, ... }`)
+ *     ergonomic under `exactOptionalPropertyTypes: true` (stricter than
+ *     arc's own tsconfig — found by a live spine-module smoke).
+ *   - array slots also accept `readonly` arrays — hosts naturally write
+ *     route/preset tables `as const` or behind `readonly` exports; the
+ *     merge copies arrays into fresh mutable ones, so a frozen host table
+ *     never leaks into arc's internals.
+ */
+type SeamSlot<V> = V | undefined | (V extends (infer E)[] ? readonly E[] : never);
+type SkippableUndefined<T> = { [K in keyof T]: SeamSlot<T[K]>; };
+/**
+ * The host-injectable subset of a resource config — everything a module can
+ * let its host override, i.e. every `ResourceConfig` slot except the
+ * module-owned `name` (and the internal preset-tracking field).
+ *
+ * Type your module's per-resource override bundles as `ResourceSeams` (or a
+ * `Pick<ResourceSeams, ...>` allow-list when you want to constrain what
+ * hosts may touch) and pass them through {@link mergeResourceConfig}.
+ */
+type ResourceSeams<TDoc = AnyRecord> = SkippableUndefined<Omit<ResourceConfig<TDoc>, "name" | "_appliedPresets" | "adapter">> & {
+  /** Any kit adapter — widened via {@link AdapterLike} at this boundary. */
+  adapter?: DataAdapter<TDoc> | AdapterLike | undefined;
+};
+/**
+ * Base-config input for {@link mergeResourceConfig} — a required `name`
+ * plus every seam slot (which is exactly `ResourceConfig` with the
+ * {@link AdapterLike} widening, `undefined`-skipping, and readonly-array
+ * acceptance the seams get). Module builders constructing DEFAULT adapters
+ * from untyped kernel engine bags hit the identical `DataAdapter<T>`
+ * invariance at the base as hosts do at the seam.
+ */
+type SeamedResourceConfig<TDoc = AnyRecord> = {
+  name: string;
+} & ResourceSeams<TDoc>;
+/**
+ * Canonical slot-aware merge of a base resource config with host seams.
+ * Later seams win over earlier ones; `undefined` values never clobber.
+ *
+ * Merge semantics (value-driven — no per-slot registry to drift):
+ *
+ *   - **Top-level arrays CONCAT** — `routes`, `middlewares`, `presets`,
+ *     `routeGuards`, `disabledRoutes`: additive collections, base first.
+ *   - **Plain objects merge recursively** — `permissions`, `actions`,
+ *     `schemaOptions` (incl. `fieldRules`), `aggregations`, `customSchemas`,
+ *     `fields`, `cache`, `events`: per-key composition. Arrays NESTED inside
+ *     them replace (they're value lists — enums, sort specs), not concat.
+ *   - **Everything else last-wins** — class instances (`adapter`,
+ *     `controller`, `queryParser`), functions, scalars.
+ *
+ * The single `as` at the return is the one documented erasure for the
+ * {@link AdapterLike}-widened seam slots — inside the helper so no module
+ * author ever writes one (mirrors mongokit's one-cast-at-the-boundary rule).
+ */
+declare function mergeResourceConfig<TDoc = AnyRecord>(base: SeamedResourceConfig<TDoc>, ...seams: ReadonlyArray<ResourceSeams<TDoc> | undefined>): ResourceConfig<TDoc>;
+//#endregion
 //#region src/core/defineResourceVariants.d.ts
 /**
  * Required identity fields for each variant. The user MUST provide a unique
@@ -188,7 +269,7 @@ type VariantsMap<TDoc = AnyRecord> = Record<string, VariantOverride<TDoc>>;
  * Result type — preserves the variant keys so destructuring is type-safe:
  * `const { articlePublic, articleAdmin } = defineResourceVariants(...)`.
  */
-type VariantsResult<TDoc, V extends VariantsMap<TDoc>> = { [K in keyof V]: ResourceDefinition<TDoc> };
+type VariantsResult<TDoc, V extends VariantsMap<TDoc>> = { [K in keyof V]: ResourceDefinition<TDoc>; };
 /**
  * Define multiple resources from a shared base config and per-variant overrides.
  *
@@ -344,4 +425,4 @@ declare function isFieldReadable(rule: ArcFieldRule | undefined): boolean;
  */
 declare function collectReadBlockedFields(schemaOptions: RouteSchemaOptions | undefined): Set<string> | null;
 //#endregion
-export { MAX_FILTER_DEPTH as A, DEFAULT_SORT as C, HOOK_PHASES as D, HOOK_OPERATIONS as E, RESERVED_QUERY_PARAMS as F, SYSTEM_FIELDS as I, MAX_SEARCH_LENGTH as M, MUTATION_OPERATIONS as N, HookOperation as O, MutationOperation as P, DEFAULT_MAX_LIMIT as S, DEFAULT_UPDATE_METHOD as T, defineAggregation as _, createRequestContext as a, DEFAULT_ID_FIELD as b, sendControllerResponse as c, getEntityQuery as d, defineResourceVariants as f, createPermissionMiddleware as g, createCrudRouter as h, createFastifyHandler as i, MAX_REGEX_LENGTH as j, HookPhase as k, getEntityId as l, defineAction as m, isFieldReadable as n, getControllerContext as o, DefineActionConfig as p, createCrudHandlers as r, getControllerScope as s, collectReadBlockedFields as t, getEntityIdField as u, CRUD_OPERATIONS as v, DEFAULT_TENANT_FIELD as w, DEFAULT_LIMIT as x, CrudOperation as y };
+export { HOOK_OPERATIONS as A, SYSTEM_FIELDS as B, CrudOperation as C, DEFAULT_SORT as D, DEFAULT_MAX_LIMIT as E, MAX_REGEX_LENGTH as F, MAX_SEARCH_LENGTH as I, MUTATION_OPERATIONS as L, HookOperation as M, HookPhase as N, DEFAULT_TENANT_FIELD as O, MAX_FILTER_DEPTH as P, MutationOperation as R, CRUD_OPERATIONS as S, DEFAULT_LIMIT as T, DefineActionConfig as _, createRequestContext as a, createPermissionMiddleware as b, sendControllerResponse as c, getEntityQuery as d, defineResourceVariants as f, mergeResourceConfig as g, SeamedResourceConfig as h, createFastifyHandler as i, HOOK_PHASES as j, DEFAULT_UPDATE_METHOD as k, getEntityId as l, ResourceSeams as m, isFieldReadable as n, getControllerContext as o, AdapterLike as p, createCrudHandlers as r, getControllerScope as s, collectReadBlockedFields as t, getEntityIdField as u, defineAction as v, DEFAULT_ID_FIELD as w, defineAggregation as x, createCrudRouter as y, RESERVED_QUERY_PARAMS as z };