@classytic/repo-core 0.8.1 → 0.10.0

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.1",
+  "version": "0.10.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": {