@classytic/repo-core 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -4,6 +4,48 @@ All notable changes to `@classytic/repo-core` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.0] - 2026-07-11
+
+### Added — `StandardRepo.getByIds` (batch point-read)
+
+- **`getByIds?(ids: readonly string[], options?: FindAllOptions): Promise<Map<string, TDoc>>`**
+  added to `StandardRepo` — the `$in` / `IN (...)` counterpart to `getById`. The N+1
+  killer for callers resolving many ids in one tick (order-line snapshotting, dashboard
+  row enrichment, reference expansion).
+
+  **Contract:**
+  - Kit de-duplicates ids before the driver round-trip.
+  - Ids with no matching doc are ABSENT from the returned `Map` — never throw on a miss.
+  - Structurally invalid ids are treated as misses (one malformed id must never fail the
+    batch).
+  - Tenant scoping, soft-delete, and hooks apply exactly as they would to `getById`.
+  - Empty input → empty Map, no round-trip.
+  - Optional: kits adopt incrementally. Callers feature-detect
+    (`repo.getByIds ?? per-id fallback`) until their kit floor ships it.
+  - Sizing is backend-bound (Mongo: 16 MB query document); keep batches ≤ ~10k ids and
+    chunk beyond.
+
+- **`events.ts` clarification** — `getByIds` has no `BEFORE_GET_BY_IDS` event by design.
+  It routes through `findAll`, so observers see the batch as `before:findAll` / `after:findAll`
+  with an `$in` filter. The comment guards against accidentally adding a separate event.
+
+- **New type-level contract test** (`tests/unit/repository/get-by-ids-contract.test.ts`) —
+  pins the `getByIds` shape for kits implementing it: `Map<string, TDoc>` keyed by
+  stringified id, `readonly string[]` input. Verifies that kits without `getByIds` still
+  conform (the member is optional).
+
+### Changed
+
+- `ChangesPage.changes` type: `ReadonlyArray<ChangeEntry<TDoc>>` → `readonly ChangeEntry<TDoc>[]`
+  (canonical form — functionally identical).
+- devDeps: `tsdown ^0.21.8 → ^0.22.5`, `typescript ^6.0.3 → ^7.0.2`.
+
+## [0.8.1] - 2026-07-11
+
+### Docs — `DataAdapter.close()` ownership rule
+
+- Clarified the `close?()` contract (doc-only, no type/runtime change): the adapter does **not** own the database connection — the host does, and `close()` must release only adapter/kit-owned resources (TTL/vacuum timers, change streams), never disconnect a shared client/pool. Kits that genuinely own a connection gate its disposal behind an explicit opt-in. This standardizes cleanup semantics across mongokit/sqlitekit/pgkit/prismakit.
+
 ## [0.8.0] - 2026-07-08
 
 ### Added — data-lifecycle contract (archive, streaming, distribution awareness)

package/dist/adapter/types.d.mts

@@ -1,6 +1,5 @@
 import { DeleteResult, MinimalRepo, StandardRepo } from "../repository/types.mjs";
 import { SchemaBuilderOptions } from "../schema/types.mjs";
-
 //#region src/adapter/types.d.ts
 /**
  * Cross-kit repository contract.
@@ -191,7 +190,25 @@ interface DataAdapter<TDoc = unknown> {
    * SQL adapters, non-Mongo operators, or kits that compile Filter IR.
    */
   matchesFilter?: (item: unknown, filters: Record<string, unknown>) => boolean;
-  /** Close / cleanup resources. */
+  /**
+   * Release resources this ADAPTER (or its repository) allocated —
+   * background timers (TTL / vacuum sweepers), open change streams,
+   * kit-internal caches. Safe to call more than once.
+   *
+   * **Ownership rule (load-bearing).** The adapter does NOT own the
+   * database connection — the HOST does. The host wrote
+   * `new PrismaClient()` / `new Pool()` / `mongoose.connect()`, so the
+   * host closes it (typically in its own `onClose`). `close()` MUST NOT
+   * disconnect a connection it didn't open: several resources commonly
+   * share one client/pool, so tearing it down from one adapter would
+   * break every sibling resource. Kits that must dispose a connection
+   * they genuinely own gate it behind an explicit opt-in (e.g.
+   * prismakit's `ownsClient`).
+   *
+   * Kits with nothing kit-owned to release still MAY implement this as a
+   * documented no-op so hosts can call `adapter.close()` uniformly across
+   * every backend without feature-detecting.
+   */
   close?(): Promise<void>;
   /**
    * Optional: does the underlying schema declare a path with this name?

package/dist/adapter/widen.d.mts

@@ -1,5 +1,4 @@
 import { AdapterRepositoryInput, RepositoryLike } from "./types.mjs";
-
 //#region src/adapter/widen.d.ts
 /**
  * Widen a permissive `AdapterRepositoryInput<TDoc>` to the strict

package/dist/aggregate/normalize.d.mts

@@ -1,5 +1,4 @@
 import { AggRequest } from "../repository/types.mjs";
-
 //#region src/aggregate/normalize.d.ts
 /**
  * Normalize `AggRequest['groupBy']` into a readonly string array.

package/dist/better-auth/index.mjs

@@ -53,7 +53,7 @@ function pluralizeBetterAuthCollection(name) {
 */
 function resolveBetterAuthCollections(options = {}) {
 	const { plugins = [], extraCollections = [], usePlural = false, modelOverrides = {} } = options;
-	const pluginSet = new Set(["core", ...plugins]);
+	const pluginSet = /* @__PURE__ */ new Set(["core", ...plugins]);
 	const collected = [];
 	for (const key of pluginSet) for (const name of BA_COLLECTIONS_BY_PLUGIN[key]) collected.push(name);
 	for (const name of extraCollections) collected.push(name);

package/dist/cache/engine.d.mts

@@ -1,6 +1,5 @@
 import { CacheReadResult, ResolvedCacheOptions } from "./options.mjs";
 import { CacheAdapter } from "./types.mjs";
-
 //#region src/cache/engine.d.ts
 interface CacheEngineOptions {
   /** Cache key namespace prefix. Default: `'rc'`. */

package/dist/cache/memory-adapter.d.mts

@@ -1,5 +1,4 @@
 import { CacheAdapter } from "./types.mjs";
-
 //#region src/cache/memory-adapter.d.ts
 /** Minimal in-memory `Map`-backed adapter with per-key TTL + prefix invalidation. */
 declare function createMemoryCacheAdapter(): CacheAdapter;

package/dist/cache/memory-adapter.mjs

@@ -36,6 +36,13 @@ function createMemoryCacheAdapter() {
 			const prefix = pattern.endsWith("*") ? pattern.slice(0, -1) : pattern;
 			for (const key of store.keys()) if (key.startsWith(prefix)) store.delete(key);
 		},
+		/**
+		* Atomic add-to-set — `O(M)` per call where M is the number of
+		* new members. Stores the value as `Set<string>` internally for
+		* `O(1)` membership checks; `get` exposes it back as an array for
+		* cross-adapter portability. JS's single-thread guarantee makes
+		* the read-mutate-write race-free without locks.
+		*/
 		addToSet(key, members, ttlSeconds = 60) {
 			const existing = readUnexpired(key);
 			let set;
@@ -55,6 +62,12 @@ function createMemoryCacheAdapter() {
 			}
 			return added;
 		},
+		/**
+		* Atomic increment — JS's single-threaded execution model makes
+		* this race-free without locks. Mirrors Redis's `INCRBY key by` +
+		* `EXPIRE key ttlSeconds NX`: TTL is applied only on key creation,
+		* existing keys keep their original expiry.
+		*/
 		increment(key, by = 1, ttlSeconds = 60) {
 			const existing = readUnexpired(key);
 			const next = (existing && typeof existing.value === "number" && Number.isFinite(existing.value) ? existing.value : 0) + by;

package/dist/cache/plugin/context.mjs

@@ -99,7 +99,7 @@ function stripAggOperationalSlots(value) {
 	return rest;
 }
 /** Aggregate ops carry their cache slot inside the AggRequest IR. */
-const AGGREGATE_OPS = new Set(["aggregate", "aggregatePaginate"]);
+const AGGREGATE_OPS = /* @__PURE__ */ new Set(["aggregate", "aggregatePaginate"]);
 /**
 * Extract per-call `CacheOptions` from a hook context. Three valid
 * locations covered (kit-dependent):

package/dist/cache/plugin/index.d.mts

@@ -3,12 +3,11 @@ import { CacheOptions, CacheReadResult } from "../options.mjs";
 import { CacheAdapter } from "../types.mjs";
 import { CacheEngine } from "../engine.mjs";
 import { DEFAULT_SHAPE_KEYS_BY_OP } from "./context.mjs";
-
 //#region src/cache/plugin/index.d.ts
 /** Default read ops the plugin caches. Kits may override per resource. */
-declare const DEFAULT_CACHEABLE_OPS: readonly ["getById", "getAll", "getOne", "getByQuery", "count", "exists", "distinct", "aggregate", "aggregatePaginate"];
+declare const DEFAULT_CACHEABLE_OPS: readonly ['getById', 'getAll', 'getOne', 'getByQuery', 'count', 'exists', 'distinct', 'aggregate', 'aggregatePaginate'];
 /** Default mutating ops that bump version + invalidate tags on success. */
-declare const DEFAULT_INVALIDATING_OPS: readonly ["create", "createMany", "update", "updateMany", "findOneAndUpdate", "upsert", "delete", "deleteMany", "restore", "claim", "claimVersion", "increment", "bulkWrite"];
+declare const DEFAULT_INVALIDATING_OPS: readonly ['create', 'createMany', 'update', 'updateMany', 'findOneAndUpdate', 'upsert', 'delete', 'deleteMany', 'restore', 'claim', 'claimVersion', 'increment', 'bulkWrite'];
 /** Observability callbacks — pipe to metrics, traces, or stdout. */
 interface LogCallbacks {
   onHit?: (key: string, op: string, ageSeconds: number) => void;
@@ -83,4 +82,4 @@ interface RepositoryCacheHandle {
  */
 declare function cachePlugin(options: RepositoryCachePluginOptions): Plugin;
 //#endregion
-export { DEFAULT_CACHEABLE_OPS, DEFAULT_INVALIDATING_OPS, LogCallbacks, RepositoryCacheHandle, RepositoryCachePluginOptions, cachePlugin };
+export { DEFAULT_CACHEABLE_OPS, DEFAULT_INVALIDATING_OPS, DEFAULT_SHAPE_KEYS_BY_OP, LogCallbacks, RepositoryCacheHandle, RepositoryCachePluginOptions, cachePlugin };

package/dist/cache/plugin/index.mjs

@@ -75,4 +75,4 @@ function cachePlugin(options) {
 	};
 }
 //#endregion
-export { DEFAULT_CACHEABLE_OPS, DEFAULT_INVALIDATING_OPS, cachePlugin };
+export { DEFAULT_CACHEABLE_OPS, DEFAULT_INVALIDATING_OPS, DEFAULT_SHAPE_KEYS_BY_OP, cachePlugin };

package/dist/cache/timeout-adapter.d.mts

@@ -1,5 +1,4 @@
 import { CacheAdapter } from "./types.mjs";
-
 //#region src/cache/timeout-adapter.d.ts
 declare class CacheTimeoutError extends Error {
   readonly op: string;

package/dist/context/index.d.mts

@@ -1,2 +1,2 @@
 import { RepositoryContext } from "./types.mjs";
-export { type RepositoryContext };
+export type { RepositoryContext };

package/dist/context/types.d.mts

@@ -1,5 +1,4 @@
 import { Filter } from "../filter/types.mjs";
-
 //#region src/context/types.d.ts
 /** The canonical lifecycle-hook context. */
 interface RepositoryContext {

package/dist/errors/contract.d.mts

@@ -1,5 +1,4 @@
 import { ErrorCode, ErrorContract } from "./types.mjs";
-
 //#region src/errors/contract.d.ts
 /**
  * Map an HTTP status code to the canonical {@link ErrorCode}. Used as a

package/dist/errors/create-error.d.mts

@@ -1,5 +1,4 @@
 import { HttpError } from "./types.mjs";
-
 //#region src/errors/create-error.d.ts
 /**
  * Create an error with an HTTP status code attached.

package/dist/errors/duplicate-key.d.mts

@@ -1,5 +1,4 @@
 import { DuplicateKeyMeta, HttpError } from "./types.mjs";
-
 //#region src/errors/duplicate-key.d.ts
 /** Predicate shape kits implement and repositories expose as `isDuplicateKeyError`. */
 type IsDuplicateKeyErrorFn = (err: unknown) => boolean;

package/dist/errors/schema.d.mts

@@ -17,24 +17,24 @@
  * {@link ./types.ts}.
  */
 declare const errorDetailSchema: {
-  readonly type: "object";
+  readonly type: 'object';
   readonly properties: {
     readonly path: {
-      readonly type: "string";
+      readonly type: 'string';
       readonly description: "Dot-path to the offending field, e.g. 'lines.0.quantity'.";
     };
     readonly code: {
-      readonly type: "string";
+      readonly type: 'string';
     };
     readonly message: {
-      readonly type: "string";
+      readonly type: 'string';
     };
     readonly meta: {
-      readonly type: "object";
-      readonly description: "Non-PII per-detail diagnostics (safe to log + return).";
+      readonly type: 'object';
+      readonly description: 'Non-PII per-detail diagnostics (safe to log + return).';
     };
   };
-  readonly required: readonly ["code", "message"];
+  readonly required: readonly ['code', 'message'];
 };
 /**
  * Canonical error response. Mirrors `ErrorContract` in {@link ./types.ts}.
@@ -48,54 +48,54 @@ declare const errorDetailSchema: {
  * a separate path from success — HTTP status discriminates.
  */
 declare const errorContractSchema: {
-  readonly type: "object";
+  readonly type: 'object';
   readonly properties: {
     readonly code: {
-      readonly type: "string";
+      readonly type: 'string';
       readonly description: "Hierarchical machine-readable code (e.g. 'arc.not_found').";
     };
     readonly message: {
-      readonly type: "string";
-      readonly description: "Human-readable, safe-for-client message.";
+      readonly type: 'string';
+      readonly description: 'Human-readable, safe-for-client message.';
     };
     readonly status: {
-      readonly type: "integer";
-      readonly description: "Suggested HTTP status code (hosts may override).";
+      readonly type: 'integer';
+      readonly description: 'Suggested HTTP status code (hosts may override).';
     };
     readonly details: {
-      readonly type: "array";
-      readonly description: "Field-scoped structured details (validation failures, duplicate keys, multi-code domain errors).";
+      readonly type: 'array';
+      readonly description: 'Field-scoped structured details (validation failures, duplicate keys, multi-code domain errors).';
       readonly items: {
-        readonly type: "object";
+        readonly type: 'object';
         readonly properties: {
           readonly path: {
-            readonly type: "string";
+            readonly type: 'string';
             readonly description: "Dot-path to the offending field, e.g. 'lines.0.quantity'.";
           };
           readonly code: {
-            readonly type: "string";
+            readonly type: 'string';
           };
           readonly message: {
-            readonly type: "string";
+            readonly type: 'string';
           };
           readonly meta: {
-            readonly type: "object";
-            readonly description: "Non-PII per-detail diagnostics (safe to log + return).";
+            readonly type: 'object';
+            readonly description: 'Non-PII per-detail diagnostics (safe to log + return).';
           };
         };
-        readonly required: readonly ["code", "message"];
+        readonly required: readonly ['code', 'message'];
       };
     };
     readonly correlationId: {
-      readonly type: "string";
-      readonly description: "Request id for support lookups.";
+      readonly type: 'string';
+      readonly description: 'Request id for support lookups.';
     };
     readonly meta: {
-      readonly type: "object";
-      readonly description: "Non-PII diagnostics (safe to log + return).";
+      readonly type: 'object';
+      readonly description: 'Non-PII diagnostics (safe to log + return).';
     };
   };
-  readonly required: readonly ["code", "message"];
+  readonly required: readonly ['code', 'message'];
 };
 //#endregion
 export { errorContractSchema, errorDetailSchema };

package/dist/errors/types.d.mts

@@ -125,17 +125,17 @@ interface ErrorDetail {
  * codes on the wire so existing client switches keep working.
  */
 declare const ERROR_CODES: {
-  readonly VALIDATION: "validation_error";
-  readonly NOT_FOUND: "not_found";
-  readonly CONFLICT: "conflict";
-  readonly UNAUTHORIZED: "unauthorized";
-  readonly FORBIDDEN: "forbidden";
-  readonly RATE_LIMITED: "rate_limited";
-  readonly IDEMPOTENCY_CONFLICT: "idempotency_conflict";
-  readonly PRECONDITION_FAILED: "precondition_failed";
-  readonly INTERNAL: "internal_error";
-  readonly UNAVAILABLE: "service_unavailable";
-  readonly TIMEOUT: "timeout";
+  readonly VALIDATION: 'validation_error';
+  readonly NOT_FOUND: 'not_found';
+  readonly CONFLICT: 'conflict';
+  readonly UNAUTHORIZED: 'unauthorized';
+  readonly FORBIDDEN: 'forbidden';
+  readonly RATE_LIMITED: 'rate_limited';
+  readonly IDEMPOTENCY_CONFLICT: 'idempotency_conflict';
+  readonly PRECONDITION_FAILED: 'precondition_failed';
+  readonly INTERNAL: 'internal_error';
+  readonly UNAVAILABLE: 'service_unavailable';
+  readonly TIMEOUT: 'timeout';
 };
 type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
 //#endregion

package/dist/events/emit.d.mts

@@ -1,6 +1,5 @@
 import { EventMeta, RepositoryEventPublisher } from "./types.mjs";
 import { RepositoryBase } from "../repository/base.mjs";
-
 //#region src/events/emit.d.ts
 /** Construction-time event wiring. */
 interface RepositoryEventsOptions {

package/dist/filter/builders.d.mts

@@ -1,5 +1,4 @@
 import { Filter, FilterEq, FilterExists, FilterFalse, FilterGt, FilterGte, FilterIn, FilterLike, FilterLt, FilterLte, FilterNe, FilterNin, FilterRaw, FilterRegex, FilterTrue } from "./types.mjs";
-
 //#region src/filter/builders.d.ts
 declare const eq: (field: string, value: unknown) => FilterEq;
 declare const ne: (field: string, value: unknown) => FilterNe;
@@ -11,7 +10,7 @@ declare const lte: (field: string, value: unknown) => FilterLte;
 declare const in_: (field: string, values: readonly unknown[]) => FilterIn;
 /** Non-membership (`$nin` / `NOT IN (...)`). Aliased as `noneOf`. */
 declare const nin: (field: string, values: readonly unknown[]) => FilterNin;
-declare const like: (field: string, pattern: string, caseSensitivity?: "sensitive" | "insensitive") => FilterLike;
+declare const like: (field: string, pattern: string, caseSensitivity?: 'sensitive' | 'insensitive') => FilterLike;
 declare const regex: (field: string, pattern: string, flags?: string) => FilterRegex;
 declare const exists: (field: string, present?: boolean) => FilterExists;
 /**
@@ -57,4 +56,4 @@ declare function isNotNull(field: string): FilterExists;
  */
 declare function raw(sql: string, params?: readonly unknown[]): FilterRaw;
 //#endregion
-export { FALSE, TRUE, and, between, contains, endsWith, eq, exists, gt, gte, iEq, in_, isNotNull, isNull, like, lt, lte, ne, nin, not, or, raw, regex, startsWith };
+export { FALSE, type FilterRaw, TRUE, and, in_ as anyOf, in_, between, contains, endsWith, eq, exists, gt, gte, iEq, not as invert, not, isNotNull, isNull, like, lt, lte, ne, nin, nin as noneOf, or, raw, regex, startsWith };

package/dist/filter/builders.mjs

@@ -169,4 +169,4 @@ function escapeLikePattern(value) {
 	return value.replace(/[%_]/g, (c) => `\\${c}`);
 }
 //#endregion
-export { FALSE, TRUE, and, between, contains, endsWith, eq, exists, gt, gte, iEq, in_, isNotNull, isNull, like, lt, lte, ne, nin, not, or, raw, regex, startsWith };
+export { FALSE, TRUE, and, in_ as anyOf, in_, between, contains, endsWith, eq, exists, gt, gte, iEq, not as invert, not, isNotNull, isNull, like, lt, lte, ne, nin, nin as noneOf, or, raw, regex, startsWith };

package/dist/filter/from-record.d.mts

@@ -1,5 +1,4 @@
 import { Filter } from "./types.mjs";
-
 //#region src/filter/from-record.d.ts
 /**
  * Convert a plain record (Mongo-style query object) into a Filter IR

package/dist/filter/from-record.mjs

@@ -1,4 +1,4 @@
-import { TRUE, and, contains, endsWith, eq, gt, gte, in_, isNotNull, isNull, like, lt, lte, ne, nin, startsWith } from "./builders.mjs";
+import { TRUE, and, anyOf as in_, contains, endsWith, eq, gt, gte, isNotNull, isNull, like, lt, lte, ne, nin, startsWith } from "./builders.mjs";
 //#region src/filter/from-record.ts
 /**
 * Plain-record → Filter IR conversion — the canonical normalizer every
@@ -40,7 +40,7 @@ function isOperatorObject(value) {
 	if (keys.length === 0) return false;
 	return keys.every((k) => KNOWN_OPS.has(k));
 }
-const KNOWN_OPS = new Set([
+const KNOWN_OPS = /* @__PURE__ */ new Set([
 	"eq",
 	"ne",
 	"gt",

package/dist/filter/guard.d.mts

@@ -1,5 +1,4 @@
 import { Filter } from "./types.mjs";
-
 //#region src/filter/guard.d.ts
 /**
  * True when `value` is a Filter IR node.

package/dist/filter/guard.mjs

@@ -1,5 +1,5 @@
 //#region src/filter/guard.ts
-const FILTER_OPS = new Set([
+const FILTER_OPS = /* @__PURE__ */ new Set([
 	"eq",
 	"ne",
 	"gt",

package/dist/filter/index.d.mts

@@ -1,5 +1,5 @@
 import { Filter, FilterAnd, FilterEq, FilterExists, FilterFalse, FilterGt, FilterGte, FilterIn, FilterLike, FilterLt, FilterLte, FilterNe, FilterNin, FilterNot, FilterOp, FilterOr, FilterRaw, FilterRegex, FilterTrue } from "./types.mjs";
-import { FALSE, TRUE, and, between, contains, endsWith, eq, exists, gt, gte, iEq, in_, isNotNull, isNull, like, lt, lte, ne, nin, not, or, raw, regex, startsWith } from "./builders.mjs";
+import { FALSE, TRUE, and, anyOf as in_, between, contains, endsWith, eq, exists, gt, gte, iEq, invert as not, isNotNull, isNull, like, lt, lte, ne, nin, or, raw, regex, startsWith } from "./builders.mjs";
 import { recordToFilter } from "./from-record.mjs";
 import { isFilter } from "./guard.mjs";
 import { asPredicate, matchFilter } from "./match.mjs";

package/dist/filter/index.mjs

@@ -1,6 +1,6 @@
 import { isFilter } from "./guard.mjs";
 import { collectFields, mapFilter, walkFilter } from "./walk.mjs";
-import { FALSE, TRUE, and, between, contains, endsWith, eq, exists, gt, gte, iEq, in_, isNotNull, isNull, like, lt, lte, ne, nin, not, or, raw, regex, startsWith } from "./builders.mjs";
+import { FALSE, TRUE, and, anyOf as in_, between, contains, endsWith, eq, exists, gt, gte, iEq, invert as not, isNotNull, isNull, like, lt, lte, ne, nin, or, raw, regex, startsWith } from "./builders.mjs";
 import { recordToFilter } from "./from-record.mjs";
 import { asPredicate, matchFilter } from "./match.mjs";
 import { SCOPE_ANY, buildTenantScope, mergeScope } from "./scope.mjs";

package/dist/filter/match.d.mts

@@ -1,5 +1,4 @@
 import { Filter } from "./types.mjs";
-
 //#region src/filter/match.d.ts
 /** Evaluate a filter against a single document. Returns true iff the doc matches. */
 declare function matchFilter(doc: unknown, filter: Filter): boolean;

package/dist/filter/scope.d.mts

@@ -1,5 +1,4 @@
 import { Filter } from "./types.mjs";
-
 //#region src/filter/scope.d.ts
 /**
  * Inject a tenant-scope predicate into an existing filter.

package/dist/filter/walk.d.mts

@@ -1,5 +1,4 @@
 import { Filter } from "./types.mjs";
-
 //#region src/filter/walk.d.ts
 /**
  * Depth-first visit of every node. Visitor returns `false` to stop descent

package/dist/hooks/engine.d.mts

@@ -1,5 +1,4 @@
 import { HookListener, HookMode, PrioritizedHook } from "./types.mjs";
-
 //#region src/hooks/engine.d.ts
 /** The default priority assigned when a user omits one on `on(...)`. */
 declare const DEFAULT_LISTENER_PRIORITY = 500;

package/dist/hooks/events.d.mts

@@ -37,57 +37,57 @@
  * ```
  */
 declare const HOOK_EVENTS: {
-  readonly BEFORE_CREATE: "before:create";
-  readonly AFTER_CREATE: "after:create";
-  readonly ERROR_CREATE: "error:create";
-  readonly BEFORE_UPDATE: "before:update";
-  readonly AFTER_UPDATE: "after:update";
-  readonly ERROR_UPDATE: "error:update";
-  readonly BEFORE_DELETE: "before:delete";
-  readonly AFTER_DELETE: "after:delete";
-  readonly ERROR_DELETE: "error:delete";
-  readonly BEFORE_GET_BY_ID: "before:getById";
-  readonly AFTER_GET_BY_ID: "after:getById";
-  readonly ERROR_GET_BY_ID: "error:getById";
-  readonly BEFORE_GET_ALL: "before:getAll";
-  readonly AFTER_GET_ALL: "after:getAll";
-  readonly ERROR_GET_ALL: "error:getAll";
-  readonly BEFORE_CREATE_MANY: "before:createMany";
-  readonly AFTER_CREATE_MANY: "after:createMany";
-  readonly ERROR_CREATE_MANY: "error:createMany";
-  readonly BEFORE_UPDATE_MANY: "before:updateMany";
-  readonly AFTER_UPDATE_MANY: "after:updateMany";
-  readonly ERROR_UPDATE_MANY: "error:updateMany";
-  readonly BEFORE_DELETE_MANY: "before:deleteMany";
-  readonly AFTER_DELETE_MANY: "after:deleteMany";
-  readonly ERROR_DELETE_MANY: "error:deleteMany";
-  readonly BEFORE_FIND_ONE_AND_UPDATE: "before:findOneAndUpdate";
-  readonly AFTER_FIND_ONE_AND_UPDATE: "after:findOneAndUpdate";
-  readonly ERROR_FIND_ONE_AND_UPDATE: "error:findOneAndUpdate";
-  readonly BEFORE_RESTORE: "before:restore";
-  readonly AFTER_RESTORE: "after:restore";
-  readonly ERROR_RESTORE: "error:restore";
-  readonly BEFORE_GET_BY_QUERY: "before:getByQuery";
-  readonly AFTER_GET_BY_QUERY: "after:getByQuery";
-  readonly ERROR_GET_BY_QUERY: "error:getByQuery";
-  readonly BEFORE_GET_ONE: "before:getOne";
-  readonly AFTER_GET_ONE: "after:getOne";
-  readonly ERROR_GET_ONE: "error:getOne";
-  readonly BEFORE_FIND_ALL: "before:findAll";
-  readonly AFTER_FIND_ALL: "after:findAll";
-  readonly ERROR_FIND_ALL: "error:findAll";
-  readonly BEFORE_GET_OR_CREATE: "before:getOrCreate";
-  readonly AFTER_GET_OR_CREATE: "after:getOrCreate";
-  readonly ERROR_GET_OR_CREATE: "error:getOrCreate";
-  readonly BEFORE_COUNT: "before:count";
-  readonly AFTER_COUNT: "after:count";
-  readonly ERROR_COUNT: "error:count";
-  readonly BEFORE_EXISTS: "before:exists";
-  readonly AFTER_EXISTS: "after:exists";
-  readonly ERROR_EXISTS: "error:exists";
-  readonly BEFORE_DISTINCT: "before:distinct";
-  readonly AFTER_DISTINCT: "after:distinct";
-  readonly ERROR_DISTINCT: "error:distinct";
+  readonly BEFORE_CREATE: 'before:create';
+  readonly AFTER_CREATE: 'after:create';
+  readonly ERROR_CREATE: 'error:create';
+  readonly BEFORE_UPDATE: 'before:update';
+  readonly AFTER_UPDATE: 'after:update';
+  readonly ERROR_UPDATE: 'error:update';
+  readonly BEFORE_DELETE: 'before:delete';
+  readonly AFTER_DELETE: 'after:delete';
+  readonly ERROR_DELETE: 'error:delete';
+  readonly BEFORE_GET_BY_ID: 'before:getById';
+  readonly AFTER_GET_BY_ID: 'after:getById';
+  readonly ERROR_GET_BY_ID: 'error:getById';
+  readonly BEFORE_GET_ALL: 'before:getAll';
+  readonly AFTER_GET_ALL: 'after:getAll';
+  readonly ERROR_GET_ALL: 'error:getAll';
+  readonly BEFORE_CREATE_MANY: 'before:createMany';
+  readonly AFTER_CREATE_MANY: 'after:createMany';
+  readonly ERROR_CREATE_MANY: 'error:createMany';
+  readonly BEFORE_UPDATE_MANY: 'before:updateMany';
+  readonly AFTER_UPDATE_MANY: 'after:updateMany';
+  readonly ERROR_UPDATE_MANY: 'error:updateMany';
+  readonly BEFORE_DELETE_MANY: 'before:deleteMany';
+  readonly AFTER_DELETE_MANY: 'after:deleteMany';
+  readonly ERROR_DELETE_MANY: 'error:deleteMany';
+  readonly BEFORE_FIND_ONE_AND_UPDATE: 'before:findOneAndUpdate';
+  readonly AFTER_FIND_ONE_AND_UPDATE: 'after:findOneAndUpdate';
+  readonly ERROR_FIND_ONE_AND_UPDATE: 'error:findOneAndUpdate';
+  readonly BEFORE_RESTORE: 'before:restore';
+  readonly AFTER_RESTORE: 'after:restore';
+  readonly ERROR_RESTORE: 'error:restore';
+  readonly BEFORE_GET_BY_QUERY: 'before:getByQuery';
+  readonly AFTER_GET_BY_QUERY: 'after:getByQuery';
+  readonly ERROR_GET_BY_QUERY: 'error:getByQuery';
+  readonly BEFORE_GET_ONE: 'before:getOne';
+  readonly AFTER_GET_ONE: 'after:getOne';
+  readonly ERROR_GET_ONE: 'error:getOne';
+  readonly BEFORE_FIND_ALL: 'before:findAll';
+  readonly AFTER_FIND_ALL: 'after:findAll';
+  readonly ERROR_FIND_ALL: 'error:findAll';
+  readonly BEFORE_GET_OR_CREATE: 'before:getOrCreate';
+  readonly AFTER_GET_OR_CREATE: 'after:getOrCreate';
+  readonly ERROR_GET_OR_CREATE: 'error:getOrCreate';
+  readonly BEFORE_COUNT: 'before:count';
+  readonly AFTER_COUNT: 'after:count';
+  readonly ERROR_COUNT: 'error:count';
+  readonly BEFORE_EXISTS: 'before:exists';
+  readonly AFTER_EXISTS: 'after:exists';
+  readonly ERROR_EXISTS: 'error:exists';
+  readonly BEFORE_DISTINCT: 'before:distinct';
+  readonly AFTER_DISTINCT: 'after:distinct';
+  readonly ERROR_DISTINCT: 'error:distinct';
 };
 /** String-literal union of every canonical hook event name. */
 type HookEventName = (typeof HOOK_EVENTS)[keyof typeof HOOK_EVENTS];

package/dist/hooks/priority.d.mts

@@ -12,15 +12,19 @@
  * compose identically.
  */
 declare const HOOK_PRIORITY: {
-  /** Policy enforcement — tenant isolation, soft-delete filtering. */readonly POLICY: 100;
+  /** Policy enforcement — tenant isolation, soft-delete filtering. */
+  readonly POLICY: 100;
   /**
    * Input validation — Standard Schema / custom validators. Runs after
    * policy (so tenant-stamped fields are present on the payload) and
    * before cache (an invalid request must never claim a cache slot).
    */
-  readonly VALIDATION: 150; /** Cache lookup / store — must run after policy so filters are in the key. */
-  readonly CACHE: 200; /** Observability — audit logging, metrics, telemetry. Must not mutate context. */
-  readonly OBSERVABILITY: 300; /** Default priority for user-registered hooks with no explicit priority. */
+  readonly VALIDATION: 150;
+  /** Cache lookup / store — must run after policy so filters are in the key. */
+  readonly CACHE: 200;
+  /** Observability — audit logging, metrics, telemetry. Must not mutate context. */
+  readonly OBSERVABILITY: 300;
+  /** Default priority for user-registered hooks with no explicit priority. */
   readonly DEFAULT: 500;
 };
 /** The numeric type of any `HOOK_PRIORITY` value. */

package/dist/hooks/priority.mjs

@@ -12,10 +12,19 @@
 * compose identically.
 */
 const HOOK_PRIORITY = {
+	/** Policy enforcement — tenant isolation, soft-delete filtering. */
 	POLICY: 100,
+	/**
+	* Input validation — Standard Schema / custom validators. Runs after
+	* policy (so tenant-stamped fields are present on the payload) and
+	* before cache (an invalid request must never claim a cache slot).
+	*/
 	VALIDATION: 150,
+	/** Cache lookup / store — must run after policy so filters are in the key. */
 	CACHE: 200,
+	/** Observability — audit logging, metrics, telemetry. Must not mutate context. */
 	OBSERVABILITY: 300,
+	/** Default priority for user-registered hooks with no explicit priority. */
 	DEFAULT: 500
 };
 //#endregion

package/dist/lookup/index.d.mts

@@ -1,2 +1,2 @@
 import { LookupPopulateOptions, LookupPopulateResult, LookupRow, LookupSpec } from "./types.mjs";
-export { type LookupPopulateOptions, type LookupPopulateResult, type LookupRow, type LookupSpec };
+export type { LookupPopulateOptions, LookupPopulateResult, LookupRow, LookupSpec };

package/dist/lookup/types.d.mts

@@ -1,6 +1,5 @@
 import { Filter } from "../filter/types.mjs";
 import { KeysetPaginationResultCore, OffsetPaginationResultCore } from "../pagination/types.mjs";
-
 //#region src/lookup/types.d.ts
 /**
  * Single lookup join. Reads like a `LEFT JOIN from ON from.foreignField

package/dist/operations/registry.d.mts

@@ -1,5 +1,4 @@
 import { CoreRepositoryOperation, OperationDescriptor, OperationRegistry, PolicyKey, RepositoryOperation } from "./types.mjs";
-
 //#region src/operations/registry.d.ts
 /**
  * The core registry. Driver kits merge their own descriptors on top of this

package/dist/pagination/canonical.d.mts

@@ -1,5 +1,4 @@
 import { AnyPaginationResult, BareListResult, PaginatedResult } from "./types.mjs";
-
 //#region src/pagination/canonical.d.ts
 /**
  * Type guard: is this value a paginated result envelope (vs a bare array

package/dist/pagination/cursor.d.mts

@@ -1,5 +1,4 @@
 import { DecodedCursor, SortSpec } from "./types.mjs";
-
 //#region src/pagination/cursor.d.ts
 /**
  * Encode a document's sort values and id into a base64url cursor token.

package/dist/pagination/keyset.d.mts

@@ -1,5 +1,4 @@
 import { SortSpec } from "./types.mjs";
-
 //#region src/pagination/keyset.d.ts
 /**
  * Normalize a sort object so non-`_id` fields come first, `_id` last.

package/dist/pagination/offset.d.mts

@@ -1,5 +1,4 @@
 import { PaginationConfig } from "./types.mjs";
-
 //#region src/pagination/offset.d.ts
 /**
  * Parse, clamp, and sanitize a `limit` value. Accepts string or number

package/dist/plugins/tenant-helpers.d.mts

@@ -1,5 +1,4 @@
 import { PolicyKey } from "../operations/types.mjs";
-
 //#region src/plugins/tenant-helpers.d.ts
 /**
  * Minimal context shape this module reads. Kits' richer

package/dist/query-parser/coerce.d.mts

@@ -1,12 +1,11 @@
 import { QueryParserOptions } from "./types.mjs";
-
 //#region src/query-parser/coerce.d.ts
 /**
  * Coerce a single URL value to its field-declared type, or to a best-guess
  * scalar when no hint exists. Always returns `string`, `number`, `boolean`,
  * `Date`, or `null` — never `undefined`.
  */
-declare function coerceValue(rawValue: string, fieldType: QueryParserOptions['fieldTypes'] extends infer T ? T extends Record<string, infer V> ? V | undefined : undefined : undefined): unknown;
+declare function coerceValue(rawValue: string, fieldType: QueryParserOptions['fieldTypes'] extends (infer T) ? T extends Record<string, infer V> ? V | undefined : undefined : undefined): unknown;
 /**
  * Split a comma-separated URL value into an array of coerced scalars.
  * Used by `in`/`nin`/`between` which accept `field[in]=a,b,c`.

package/dist/query-parser/coerce.mjs

@@ -1,11 +1,11 @@
 //#region src/query-parser/coerce.ts
-const BOOLEAN_STRINGS = new Set([
+const BOOLEAN_STRINGS = /* @__PURE__ */ new Set([
 	"true",
 	"1",
 	"yes",
 	"on"
 ]);
-const FALSEY_STRINGS = new Set([
+const FALSEY_STRINGS = /* @__PURE__ */ new Set([
 	"false",
 	"0",
 	"no",

package/dist/query-parser/parse-url.d.mts

@@ -1,5 +1,4 @@
 import { ParsedQuery, QueryParserInput, QueryParserOptions } from "./types.mjs";
-
 //#region src/query-parser/parse-url.d.ts
 /** Parse URL search params into a driver-agnostic ParsedQuery. */
 declare function parseUrl(input: QueryParserInput, options?: QueryParserOptions): ParsedQuery;

package/dist/query-parser/parse-url.mjs

@@ -1,4 +1,4 @@
-import { TRUE, and, between, contains, endsWith, eq, gt, gte, iEq, in_, isNotNull, isNull, like, lt, lte, ne, nin, regex, startsWith } from "../filter/builders.mjs";
+import { TRUE, and, anyOf as in_, between, contains, endsWith, eq, gt, gte, iEq, isNotNull, isNull, like, lt, lte, ne, nin, regex, startsWith } from "../filter/builders.mjs";
 import { coerceList, coerceValue } from "./coerce.mjs";
 import { isControlParam } from "./reserved.mjs";
 //#region src/query-parser/parse-url.ts
@@ -16,7 +16,7 @@ const DEFAULT_MAX_SEARCH = 200;
 * approach this bound.
 */
 const MAX_PARAM_KEY_LENGTH = 256;
-const ALL_OPERATORS = new Set([
+const ALL_OPERATORS = /* @__PURE__ */ new Set([
 	"eq",
 	"ne",
 	"gt",

package/dist/query-parser/reserved.mjs

@@ -23,7 +23,7 @@
 * Pagination + sort + select + populate + search + resource-dispatch
 * verbs (`_count`, `_distinct`, `_exists`).
 */
-const STANDARD_RESERVED_PARAMS = new Set([
+const STANDARD_RESERVED_PARAMS = /* @__PURE__ */ new Set([
 	"page",
 	"limit",
 	"after",

package/dist/query-parser/types.d.mts

@@ -1,5 +1,4 @@
 import { Filter } from "../filter/types.mjs";
-
 //#region src/query-parser/types.d.ts
 /** Sort direction on a single field. */
 type ParsedSortDirection = 1 | -1;

package/dist/repository/archive.d.mts

@@ -1,5 +1,4 @@
 import { RetryPolicy } from "./resilience.mjs";
-
 //#region src/repository/archive.d.ts
 /**
  * Destination for archived documents — implemented by the HOST, not the

package/dist/repository/base.d.mts

@@ -4,7 +4,6 @@ import { HookListener, HookMode } from "../hooks/types.mjs";
 import { HookEngine } from "../hooks/engine.mjs";
 import { StandardSchemaV1 } from "../schema/standard-schema.mjs";
 import { PluginType } from "./plugin-types.mjs";
-
 //#region src/repository/base.d.ts
 /** Construction options common to every kit. */
 interface RepositoryBaseOptions {

package/dist/repository/distribution.d.mts

@@ -1,5 +1,4 @@
 import { FilterInput } from "./types.mjs";
-
 //#region src/repository/distribution.d.ts
 /** Per-repo declaration of how the underlying table/collection is distributed. */
 interface DistributionConfig {

package/dist/repository/options.d.mts

@@ -50,7 +50,7 @@
  * options bag, and let kit plugins read what they implement. Unknown
  * ctx keys do NOT forward — the bag stays narrow.
  */
-declare const STANDARD_REPO_OPTION_KEYS: readonly ["organizationId", "userId", "user", "session", "requestId", "traceId"];
+declare const STANDARD_REPO_OPTION_KEYS: readonly ['organizationId', 'userId', 'user', 'session', 'requestId', 'traceId'];
 /**
  * Type-level union of canonical option keys. Use to constrain
  * framework helpers that thread request context into repo options:

package/dist/repository/plugin-types.d.mts

@@ -1,5 +1,4 @@
 import { RepositoryBase } from "./base.mjs";
-
 //#region src/repository/plugin-types.d.ts
 /** Object-style plugin — preferred form. Carries a stable `name` for ordering checks. */
 interface Plugin<TRepo extends RepositoryBase = RepositoryBase> {

package/dist/repository/purge.d.mts

@@ -1,5 +1,4 @@
 import { TenantPurgeOptions, TenantPurgeResult, TenantPurgeStrategy } from "./types.mjs";
-
 //#region src/repository/purge.d.ts
 /**
  * Strategies that perform a write. `skip` is handled by the orchestrator

package/dist/repository/types.d.mts

@@ -6,7 +6,6 @@ import { RetryPolicy } from "./resilience.mjs";
 import { ArchiveOptions, ArchiveResult, ArchiveSink } from "./archive.mjs";
 import { RepoCapabilities } from "./capabilities.mjs";
 import { CacheOptions } from "../cache/options.mjs";
-
 //#region src/repository/types.d.ts
 /**
  * Accepted filter input across every repository method. A repository
@@ -146,31 +145,33 @@ type TenantPurgeStrategy =
  */
 {
   type: 'hard';
-}
+} |
 /**
  * Mark every matching row as deleted via the soft-delete convention.
  * Pair with `softDeletePlugin` or a TTL index for eventual cleanup.
  */
-| {
-  type: 'soft'; /** Boolean flag field set to `true`. Default `'deleted'`. */
-  deletedField?: string; /** Timestamp field set to purge-time. Default `'deletedAt'`. */
+{
+  type: 'soft';
+  /** Boolean flag field set to `true`. Default `'deleted'`. */
+  deletedField?: string;
+  /** Timestamp field set to purge-time. Default `'deletedAt'`. */
   deletedAtField?: string;
-}
+} |
 /**
  * Retain every matching row but overwrite the declared fields. Field
  * values can be static (preferred — statically inspectable for audit)
  * or per-row functions when deterministic transforms are needed
  * (hashing, derived identifiers).
  */
-| {
+{
   type: 'anonymize';
   fields: Record<string, unknown | ((doc: Record<string, unknown>) => unknown)>;
-}
+} |
 /**
  * Take no action. `reason` is required — an undocumented skip is a
  * silent compliance leak. Surfaces in audit reports + introspection.
  */
-| {
+{
   type: 'skip';
   reason: string;
 };
@@ -827,7 +828,9 @@ type AggDateBucketUnit = 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter
  *  order without parsing the string back into a date.
  */
 type AggDateBucketInterval = AggDateBucketUnit | {
-  /** Number of `unit`-sized chunks per bin. Must be a positive integer. */every: number; /** Base unit. `quarter` and `year` aren't supported in custom-bin form. */
+  /** Number of `unit`-sized chunks per bin. Must be a positive integer. */
+  every: number;
+  /** Base unit. `quarter` and `year` aren't supported in custom-bin form. */
   unit: Exclude<AggDateBucketUnit, 'quarter' | 'year'>;
 };
 /**
@@ -1421,6 +1424,31 @@ interface StandardRepo<TDoc> extends MinimalRepo<TDoc> {
   getOne?(filter: FilterInput, options?: QueryOptions): Promise<TDoc | null>;
   /** Alias many kits expose alongside `getOne`. Arc checks both names. */
   getByQuery?(filter: FilterInput, options?: QueryOptions): Promise<TDoc | null>;
+  /**
+   * Batch point-read — the `$in` / `IN (...)` counterpart to `getById`.
+   * Fetches every doc whose primary key is in `ids` in ONE query and
+   * returns a Map keyed by the STRINGIFIED id (`String(doc.id)`) for O(1)
+   * lookup. The N+1 killer for callers resolving many ids in one tick
+   * (order-line snapshotting, dashboard row enrichment, reference
+   * expansion).
+   *
+   * **Contract:**
+   *   - Input ids are de-duplicated by the kit.
+   *   - Ids with no matching doc are simply ABSENT from the Map — never
+   *     throw on a miss (mirrors `getById`'s null-on-miss form).
+   *   - Structurally invalid ids (impossible for the backend's key type)
+   *     are treated as misses and dropped — one malformed id must never
+   *     fail the batch.
+   *   - Same policy surface as a single read: tenant scoping, soft-delete,
+   *     and hooks apply to the batch exactly as they would to `getById`.
+   *   - Empty input → empty Map, no driver round-trip.
+   *
+   * Optional: kits adopt incrementally. Callers feature-detect
+   * (`repo.getByIds ?? per-id fallback`) until their kit floor ships it.
+   * Sizing is backend-bound (e.g. Mongo's 16 MB query document); keep
+   * batches ≤ ~10k ids and chunk beyond.
+   */
+  getByIds?(ids: readonly string[], options?: FindAllOptions): Promise<Map<string, TDoc>>;
   count?(filter?: FilterInput, options?: QueryOptions): Promise<number>;
   exists?(filter: FilterInput, options?: QueryOptions): Promise<boolean | {
     _id: unknown;

package/dist/schema/field-rules.d.mts

@@ -1,5 +1,4 @@
 import { JsonSchema, SchemaBuilderOptions, ValidationResult } from "./types.mjs";
-
 //#region src/schema/field-rules.d.ts
 /**
  * Collect the set of fields that must NOT appear in a generated schema.

package/dist/schema/field-rules.mjs

@@ -33,7 +33,7 @@ function collectFieldsToOmit(options, purpose) {
 		if (explicit) for (const f of explicit) result.add(f);
 		return result;
 	}
-	const result = new Set([
+	const result = /* @__PURE__ */ new Set([
 		"createdAt",
 		"updatedAt",
 		"__v",

package/dist/schema/generator.d.mts

@@ -1,5 +1,4 @@
 import { CrudSchemas, SchemaBuilderOptions } from "./types.mjs";
-
 //#region src/schema/generator.d.ts
 /**
  * Resource-level context threaded into the generator at boot. Lets the

package/dist/schema/types.d.mts

@@ -149,9 +149,13 @@ interface SchemaBuilderOptions {
   dateAs?: 'date' | 'datetime';
   /** Create-schema overrides. */
   create?: {
-    /** Fields to omit from the create body. */omitFields?: string[]; /** Force field to required (merged with auto-detected required). */
-    requiredOverrides?: Record<string, boolean>; /** Force field to optional (even if DB-level required). */
-    optionalOverrides?: Record<string, boolean>; /** Replace the generated schema for a specific field. */
+    /** Fields to omit from the create body. */
+    omitFields?: string[];
+    /** Force field to required (merged with auto-detected required). */
+    requiredOverrides?: Record<string, boolean>;
+    /** Force field to optional (even if DB-level required). */
+    optionalOverrides?: Record<string, boolean>;
+    /** Replace the generated schema for a specific field. */
     schemaOverrides?: Record<string, unknown>;
   };
   /**
@@ -165,12 +169,15 @@ interface SchemaBuilderOptions {
   softRequiredFields?: string[];
   /** Update-schema overrides. */
   update?: {
-    /** Fields to omit from the update body. */omitFields?: string[]; /** When `true`, reject empty update bodies (`minProperties: 1`). */
+    /** Fields to omit from the update body. */
+    omitFields?: string[];
+    /** When `true`, reject empty update bodies (`minProperties: 1`). */
     requireAtLeastOne?: boolean;
   };
   /** List-query schema overrides. */
   query?: {
-    /** Extra filterable fields exposed on the list-query schema. */filterableFields?: Record<string, {
+    /** Extra filterable fields exposed on the list-query schema. */
+    filterableFields?: Record<string, {
       type: string;
     } | unknown>;
   };
@@ -185,7 +192,8 @@ interface SchemaBuilderOptions {
    * scoring you want kept in update bodies but stripped from list reads).
    */
   response?: {
-    /** Extra fields to omit from the response shape. */omitFields?: string[];
+    /** Extra fields to omit from the response shape. */
+    omitFields?: string[];
   };
   /**
    * Emit OpenAPI vendor extensions (`x-*` keywords like `x-ref` for populated

package/dist/sync/index.d.mts

@@ -68,7 +68,7 @@ interface ChangesSinceOptions {
   readonly tenantId?: string;
 }
 interface ChangesPage<TDoc = unknown> {
-  readonly changes: ReadonlyArray<ChangeEntry<TDoc>>;
+  readonly changes: readonly ChangeEntry<TDoc>[];
   /** Checkpoint AFTER applying this page — echo into the next `since`. */
   readonly cursor: string;
   /** True → more entries exist; pull again immediately. */

package/dist/sync/index.mjs

@@ -1,6 +1,8 @@
 //#region src/sync/index.ts
 /** Client checkpoint older than the store's compaction horizon → full resync. */
 var CursorExpiredError = class extends Error {
+	cursor;
+	horizon;
 	constructor(cursor, horizon) {
 		super(`[repo-core:sync] cursor "${cursor}" predates the compaction horizon — full resync required.`);
 		this.cursor = cursor;

package/dist/tenant/resolve.d.mts

@@ -1,5 +1,4 @@
 import { ResolvedTenantConfig, TenantConfig } from "./types.mjs";
-
 //#region src/tenant/resolve.d.ts
 /**
  * Sensible defaults for a freshly-built package (field strategy).
@@ -10,7 +9,7 @@ import { ResolvedTenantConfig, TenantConfig } from "./types.mjs";
  * runtime default — `Pick<TenantConfig, 'fieldType'>` extension preserves
  * type-level alignment without forcing a runtime default change.
  */
-type TenantDefaults = { [K in 'strategy' | 'enabled' | 'tenantField' | 'fieldType' | 'ref' | 'contextKey' | 'required']-?: Exclude<TenantConfig[K], undefined> };
+type TenantDefaults = { [K in 'strategy' | 'enabled' | 'tenantField' | 'fieldType' | 'ref' | 'contextKey' | 'required']-?: Exclude<TenantConfig[K], undefined>; };
 declare const DEFAULT_TENANT_CONFIG: TenantDefaults;
 declare function resolveTenantConfig(config?: TenantConfig | boolean): ResolvedTenantConfig;
 //#endregion

package/dist/testing/conformance.d.mts

@@ -1,5 +1,4 @@
 import { ConformanceDoc, ConformanceHarness } from "./types.mjs";
-
 //#region src/testing/conformance.d.ts
 declare function runStandardRepoConformance<TDoc extends ConformanceDoc = ConformanceDoc>(harness: ConformanceHarness<TDoc>): void;
 //#endregion

package/dist/testing/conformance.mjs

@@ -1,4 +1,4 @@
-import { and, eq, gt, in_, isNull, like, ne, or } from "../filter/builders.mjs";
+import { and, anyOf as in_, eq, gt, isNull, like, ne, or } from "../filter/builders.mjs";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 //#region src/testing/conformance.ts
 /**

package/dist/testing/lock-conformance.d.mts

@@ -1,5 +1,4 @@
 import { LockAdapter } from "../lock/index.mjs";
-
 //#region src/testing/lock-conformance.d.ts
 interface LockConformanceHarness {
   /**

package/dist/testing/types.d.mts

@@ -1,6 +1,5 @@
 import { AggregateOpsSupport, RepoCapabilities } from "../repository/capabilities.mjs";
 import { MinimalRepo, StandardRepo } from "../repository/types.mjs";
-
 //#region src/testing/types.d.ts
 /**
  * The conformance scenarios operate on a minimal doc shape common to
@@ -114,4 +113,4 @@ interface ConformanceHarness<TDoc extends ConformanceDoc = ConformanceDoc> {
   makeDoc(overrides?: Partial<ConformanceDoc>): Partial<TDoc>;
 }
 //#endregion
-export { ConformanceContext, ConformanceDoc, ConformanceFeatures, ConformanceHarness };
+export { type AggregateOpsSupport, ConformanceContext, ConformanceDoc, ConformanceFeatures, ConformanceHarness };

package/dist/update/builders.d.mts

@@ -1,5 +1,4 @@
 import { UpdateSpec } from "./types.mjs";
-
 //#region src/update/builders.d.ts
 /**
  * Compose an `UpdateSpec` from the four primitive mutations.

package/dist/update/compile.d.mts

@@ -1,5 +1,4 @@
 import { UpdateSpec } from "./types.mjs";
-
 //#region src/update/compile.d.ts
 /**
  * Compile an `UpdateSpec` to a Mongo operator record.

package/dist/update/guard.d.mts

@@ -1,5 +1,4 @@
 import { UpdateSpec } from "./types.mjs";
-
 //#region src/update/guard.d.ts
 /**
  * True when `value` is an `UpdateSpec` — i.e. the portable, compile-to-native

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/repo-core",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Driver-agnostic repository primitives: hooks, Filter IR, operations, pagination, cache contract. Foundation for mongokit, sqlitekit, pgkit, and prismakit. Lean by design — no plugins ship here; each kit owns its own.",
   "type": "module",
   "sideEffects": false,
@@ -157,8 +157,8 @@
     "fast-check": "^4.7.0",
     "knip": "^6.3.0",
     "publint": "^0.3.18",
-    "tsdown": "^0.21.8",
-    "typescript": "^6.0.3",
+    "tsdown": "^0.22.5",
+    "typescript": "^7.0.2",
     "vitest": "^4.1.4"
   },
   "peerDependencies": {