@classytic/repo-core 0.31.0 → 0.32.0

package/dist/repository/plugin-types.mjs

@@ -1,4 +1,4 @@
-//#region src/repository/plugin-types.ts
+// src/repository/plugin-types.ts
 /**
 * Ordered pairs that produce wrong behavior when installed out of order.
 * Each entry: `[mustComeFirst, mustComeAfter, reason]`.
@@ -41,5 +41,4 @@ function validatePluginOrder(plugins, repoName, mode = "warn", onWarn = (m) => {
 		onWarn(message);
 	}
 }
-//#endregion
 export { PLUGIN_ORDER_CONSTRAINTS, validatePluginOrder };

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
  * before the port is ever consulted, so ports only deal with the three
@@ -88,5 +87,4 @@ interface PurgePort {
  * @param port      Kit-specific driver glue (one `purgeChunk` method).
  */
 declare function runChunkedPurge(strategy: TenantPurgeStrategy, options: TenantPurgeOptions, port: PurgePort): Promise<TenantPurgeResult>;
-//#endregion
 export { PurgePort, WritingPurgeStrategy, runChunkedPurge };

package/dist/repository/purge.mjs

@@ -1,5 +1,5 @@
 import { withRetry } from "./resilience.mjs";
-//#region src/repository/purge.ts
+// src/repository/purge.ts
 /**
 * Chunked tenant-purge orchestrator — kit-agnostic.
 *
@@ -79,5 +79,4 @@ async function runChunkedPurge(strategy, options, port) {
 		durationMs: Date.now() - start
 	};
 }
-//#endregion
 export { runChunkedPurge };

package/dist/repository/read-only.d.mts

@@ -1,4 +1,3 @@
-//#region src/repository/read-only.d.ts
 /**
  * `asReadOnlyRepo` — seal a repository whose rows are owned by ANOTHER writer.
  *
@@ -56,5 +55,4 @@ declare class ReadOnlyRepositoryError extends Error {
 declare function asReadOnlyRepo<TRepo extends object>(repo: TRepo, options: ReadOnlyRepoOptions): TRepo;
 /** True when a repository (or adapter repository) declares itself read-only. */
 declare function isReadOnlyRepo(repo: unknown): boolean;
-//#endregion
 export { ReadOnlyRepoOptions, ReadOnlyRepositoryError, asReadOnlyRepo, isReadOnlyRepo };

package/dist/repository/read-only.mjs

@@ -1,4 +1,4 @@
-//#region src/repository/read-only.ts
+// src/repository/read-only.ts
 /**
 * Methods that only READ. Everything else callable is refused — a novel
 * kit-contributed method is sealed until it is listed here deliberately.
@@ -76,5 +76,4 @@ function isReadOnlyRepo(repo) {
 	if (!repo || typeof repo !== "object") return false;
 	return repo.capabilities?.readOnly === true;
 }
-//#endregion
 export { ReadOnlyRepositoryError, asReadOnlyRepo, isReadOnlyRepo };

package/dist/repository/resilience.d.mts

@@ -1,4 +1,3 @@
-//#region src/repository/resilience.d.ts
 /**
  * Resilience primitives — the single retry/abort contract every kit and
  * every chunked orchestrator (purge, batch imports, outbox relays) uses.
@@ -70,5 +69,4 @@ declare function withRetry<T>(fn: () => Promise<T>, policy: RetryPolicy | undefi
  * round-trip instead of running to completion.
  */
 declare function throwIfAborted(signal: AbortSignal | undefined): void;
-//#endregion
 export { RetryPolicy, isTransientError, throwIfAborted, withRetry };

package/dist/repository/resilience.mjs

@@ -1,4 +1,4 @@
-//#region src/repository/resilience.ts
+// src/repository/resilience.ts
 /**
 * Resilience primitives — the single retry/abort contract every kit and
 * every chunked orchestrator (purge, batch imports, outbox relays) uses.
@@ -122,5 +122,4 @@ async function withRetry(fn, policy, signal) {
 function throwIfAborted(signal) {
 	signal?.throwIfAborted();
 }
-//#endregion
 export { isTransientError, throwIfAborted, withRetry };

package/dist/repository/retrying-transaction.d.mts

@@ -1,6 +1,5 @@
 import { StandardRepo, TransactionHandle } from "./types.mjs";
 import { IsTransientConflictFn } from "../errors/conflict.mjs";
-//#region src/repository/retrying-transaction.d.ts
 interface RetryingTransactionOptions {
   /** Max attempts including the first. Default 5. */
   maxAttempts?: number;
@@ -44,5 +43,4 @@ interface RetryingTransactionOptions {
  * closed on an unconfirmed deployment).
  */
 declare function retryingTransaction<TDoc, T>(repo: StandardRepo<TDoc>, fn: (txRepo: StandardRepo<TDoc>, uow?: TransactionHandle) => Promise<T>, options?: RetryingTransactionOptions): Promise<T>;
-//#endregion
 export { RetryingTransactionOptions, retryingTransaction };

package/dist/repository/retrying-transaction.mjs

@@ -1,6 +1,6 @@
 import { neverTransient } from "../errors/conflict.mjs";
 import { withRetry } from "./resilience.mjs";
-//#region src/repository/retrying-transaction.ts
+// src/repository/retrying-transaction.ts
 /**
 * Run `fn` inside `repo.withTransaction`, re-running on transient conflicts.
 *
@@ -31,5 +31,4 @@ async function retryingTransaction(repo, fn, options = {}) {
 		}
 	}, options.signal);
 }
-//#endregion
 export { retryingTransaction };

package/dist/repository/types.d.mts

@@ -7,7 +7,6 @@ import { ArchiveOptions, ArchiveResult, ArchiveSink } from "./archive.mjs";
 import { CacheOptions } from "../cache/options.mjs";
 import { RepoCapabilities } from "./capabilities.mjs";
 import { BulkUpsertOptions, BulkUpsertResult } from "./bulk-upsert.mjs";
-//#region src/repository/types.d.ts
 /**
  * Accepted filter input across every repository method. A repository
  * call can pass either a plain record (`{ status: 'active' }`) or a
@@ -2008,5 +2007,4 @@ interface CursorOptions {
   sort?: Record<string, 1 | -1>;
   [key: string]: unknown;
 }
-//#endregion
 export { AggCacheOptions, AggDateBucket, AggDateBucketInterval, AggDateBucketUnit, AggExecutionHints, AggMeasure, AggPaginationRequest, AggRequest, AggResult, AggRow, AggTopN, AggTopNTies, BulkCreateResult, BulkWriteOperation, BulkWriteResult, ChangeEvent, ClaimTransition, ClaimVersionTransition, CursorOptions, DeleteManyResult, DeleteOptions, DeleteResult, FilterInput, FindAllOptions, FindOneAndUpdateOptions, InferDoc, KeysetAggPaginationResult, MinimalRepo, PaginationParams, QueryOptions, RepositorySession, StandardRepo, TenantPurgeOptions, TenantPurgeProgress, TenantPurgeResult, TenantPurgeStrategy, TransactionHandle, TransitionArgs, TransitionMachine, UpdateManyResult, WatchOptions, WriteOptions };

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.
  *
@@ -108,5 +107,4 @@ declare function mergeFieldRuleConstraints(schemas: Record<string, unknown> | nu
  * widening logic.
  */
 declare function applyNullable(prop: Record<string, unknown>): void;
-//#endregion
 export { applyFieldRules, applyNullable, collectFieldsToOmit, getImmutableFields, getSystemManagedFields, isFieldUpdateAllowed, mergeFieldRuleConstraints, validateUpdateBody };

package/dist/schema/field-rules.mjs

@@ -1,4 +1,4 @@
-//#region src/schema/field-rules.ts
+// src/schema/field-rules.ts
 /**
 * Collect the set of fields that must NOT appear in a generated schema.
 *
@@ -260,5 +260,4 @@ function widenEnumToIncludeNull(prop) {
 	if (prop["enum"].includes(null)) return;
 	prop["enum"] = [...prop["enum"], null];
 }
-//#endregion
 export { applyFieldRules, applyNullable, collectFieldsToOmit, getImmutableFields, getSystemManagedFields, isFieldUpdateAllowed, mergeFieldRuleConstraints, validateUpdateBody };

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
  * generator shape output to per-resource config (idField pattern,
@@ -67,5 +66,4 @@ type SchemaGenerator<TModel = unknown> = (model: TModel, options?: SchemaBuilder
  * accept either a generator or a config-bag.
  */
 declare function isSchemaGenerator(value: unknown): value is SchemaGenerator;
-//#endregion
 export { SchemaGenerator, SchemaGeneratorContext, isSchemaGenerator };

package/dist/schema/generator.mjs

@@ -1,4 +1,4 @@
-//#region src/schema/generator.ts
+// src/schema/generator.ts
 /**
 * Runtime predicate — true when `value` matches the generator shape.
 *
@@ -12,5 +12,4 @@
 function isSchemaGenerator(value) {
 	return typeof value === "function" && value.length >= 1 && value.length <= 3;
 }
-//#endregion
 export { isSchemaGenerator };

package/dist/schema/standard-schema.d.mts

@@ -1,4 +1,3 @@
-//#region src/schema/standard-schema.d.ts
 /**
  * Standard Schema integration — the validator-agnostic validation slot.
  *
@@ -85,5 +84,4 @@ declare namespace StandardSchemaV1 {
  * shape every kit's own validation errors serialize to.
  */
 declare function validateStandardSchema<TSchema extends StandardSchemaV1>(schema: TSchema, data: unknown): Promise<StandardSchemaV1.InferOutput<TSchema>>;
-//#endregion
 export { StandardSchemaV1, validateStandardSchema };

package/dist/schema/standard-schema.mjs

@@ -1,5 +1,5 @@
 import { ERROR_CODES } from "../errors/codes.mjs";
-//#region src/schema/standard-schema.ts
+// src/schema/standard-schema.ts
 /**
 * Standard Schema integration — the validator-agnostic validation slot.
 *
@@ -55,5 +55,4 @@ async function validateStandardSchema(schema, data) {
 	}
 	return result.value;
 }
-//#endregion
 export { validateStandardSchema };

package/dist/schema/types.d.mts

@@ -1,4 +1,3 @@
-//#region src/schema/types.d.ts
 /**
  * Schema contract types — shared across every kit that emits JSON Schemas
  * from its native schema (Mongoose models, Drizzle tables, Prisma schemas,
@@ -216,5 +215,4 @@ interface ValidationResult {
   }>;
   message?: string;
 }
-//#endregion
 export { CrudSchemas, FieldRule, FieldRules, JsonSchema, SchemaBuilderOptions, ValidationResult };

package/dist/sync/index.d.mts

@@ -1,4 +1,3 @@
-//#region src/sync/index.d.ts
 /**
  * The sync contracts kits implement and a sync engine (`@classytic/arc-sync`) consumes:
  *
@@ -162,5 +161,4 @@ interface CommandStreamStore<TTx extends CommandStreamTx = CommandStreamTx> {
  * the feed entries appended with their `session` reach `changes` only on commit.
  */
 declare function createMemoryCommandStreamStore(feed?: ChangeLogStore): CommandStreamStore;
-//#endregion
 export { ChangeEntry, ChangeLogAppendOptions, ChangeLogStore, ChangeOp, ChangesPage, ChangesSinceOptions, CommandAliasRecord, CommandOutcome, CommandStreamRecord, CommandStreamStore, CommandStreamTx, CommandVerdictRecord, CursorExpiredError, MemoryChangeLogStore, createMemoryCommandStreamStore };

package/dist/tenant/index.mjs

@@ -1,2 +1 @@
-import { DEFAULT_TENANT_CONFIG, assertNoLegacyTenantKeys, resolveTenantConfig, resolveTenantField } from "./resolve.mjs";
-export { DEFAULT_TENANT_CONFIG, assertNoLegacyTenantKeys, resolveTenantConfig, resolveTenantField };
+export { DEFAULT_TENANT_CONFIG, assertNoLegacyTenantKeys, resolveTenantConfig, resolveTenantField } from "./resolve.mjs";

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).
  *
@@ -59,5 +58,4 @@ declare function resolveTenantField(config?: TenantConfig | boolean): string | f
  *   the package carried a sibling field-type option.
  */
 declare function assertNoLegacyTenantKeys(config: unknown, pkg: string, extra?: ReadonlyArray<readonly [string, string]>): void;
-//#endregion
 export { DEFAULT_TENANT_CONFIG, assertNoLegacyTenantKeys, resolveTenantConfig, resolveTenantField };

package/dist/tenant/resolve.mjs

@@ -1,4 +1,4 @@
-//#region src/tenant/resolve.ts
+// src/tenant/resolve.ts
 const DEFAULT_TENANT_CONFIG = {
 	strategy: "field",
 	enabled: true,
@@ -110,5 +110,4 @@ function assertNoLegacyTenantKeys(config, pkg, extra = []) {
 		throw new Error(`${pkg}: \`${key}\` was renamed to \`${became}\`. It is REFUSED rather than ignored because ignoring it disables tenancy SILENTLY — no tenant field, no tenant filter, and every read spanning all tenants while returning plausible numbers. Move the value to \`tenant\` (\`tenant: false\` for a single-tenant deployment).`);
 	}
 }
-//#endregion
 export { DEFAULT_TENANT_CONFIG, assertNoLegacyTenantKeys, resolveTenantConfig, resolveTenantField };

package/dist/tenant/types.d.mts

@@ -1,4 +1,3 @@
-//#region src/tenant/types.d.ts
 /**
  * Tenant scope configuration — canonical static contract for the org.
  *
@@ -138,5 +137,4 @@ type ResolvedTenantConfig = {
   required: boolean;
   resolve?: TenantConfig['resolve'] | undefined;
 };
-//#endregion
 export { ResolvedTenantConfig, TenantConfig, TenantFieldType, TenantStrategy };

package/dist/testing/change-log-conformance.d.mts

@@ -1,5 +1,4 @@
 import { ChangeLogStore } from "../sync/index.mjs";
-//#region src/testing/change-log-conformance.d.ts
 interface ChangeLogConformanceHarness {
   /** A store over an EMPTY backend, per scenario. */
   createStore(): ChangeLogStore | Promise<ChangeLogStore>;
@@ -17,5 +16,4 @@ declare function changeLogStoreCases(harness: ChangeLogConformanceHarness): {
 }[];
 /** The contract as a vitest suite. */
 declare function runChangeLogStoreConformance(harness: ChangeLogConformanceHarness): void;
-//#endregion
 export { ChangeLogConformanceHarness, changeLogStoreCases, runChangeLogStoreConformance };

package/dist/testing/change-log-conformance.mjs

@@ -1,5 +1,5 @@
 import { describe, it } from "vitest";
-//#region src/testing/change-log-conformance.ts
+// src/testing/change-log-conformance.ts
 /**
 * `runChangeLogStoreConformance` — the contract every `ChangeLogStore` passes. A kit runs it against
 * its real backend; passing it is what "implements the store" means.
@@ -200,5 +200,4 @@ function runChangeLogStoreConformance(harness) {
 		else it(c.name, c.run, 3e4);
 	});
 }
-//#endregion
 export { changeLogStoreCases, runChangeLogStoreConformance };

package/dist/testing/command-stream-conformance.d.mts

@@ -1,5 +1,4 @@
 import { CommandStreamStore } from "../sync/index.mjs";
-//#region src/testing/command-stream-conformance.d.ts
 interface CommandStreamConformanceHarness {
   /** A store over an EMPTY backend, per scenario. */
   createStore(): CommandStreamStore | Promise<CommandStreamStore>;
@@ -11,5 +10,4 @@ declare function commandStreamStoreCases(harness: CommandStreamConformanceHarnes
 }[];
 /** The contract as a vitest suite. */
 declare function runCommandStreamStoreConformance(harness: CommandStreamConformanceHarness): void;
-//#endregion
 export { CommandStreamConformanceHarness, commandStreamStoreCases, runCommandStreamStoreConformance };

package/dist/testing/command-stream-conformance.mjs

@@ -1,5 +1,5 @@
 import { describe, it } from "vitest";
-//#region src/testing/command-stream-conformance.ts
+// src/testing/command-stream-conformance.ts
 /**
 * `runCommandStreamStoreConformance` — the contract every `CommandStreamStore` passes, run against
 * its real backend. The serialisation case is the one that matters: a store whose transactions can
@@ -159,5 +159,4 @@ function runCommandStreamStoreConformance(harness) {
 		for (const c of commandStreamStoreCases(harness)) it(c.name, c.run, 6e4);
 	});
 }
-//#endregion
 export { commandStreamStoreCases, runCommandStreamStoreConformance };

package/dist/testing/conformance.d.mts

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

package/dist/testing/conformance.mjs

@@ -1,7 +1,7 @@
 import { isVersionConflictError } from "../errors/conflict.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
+// src/testing/conformance.ts
 /**
 * `runStandardRepoConformance` — the cross-kit contract suite.
 *
@@ -1541,5 +1541,4 @@ function runStandardRepoConformance(harness) {
 		});
 	});
 }
-//#endregion
 export { runStandardRepoConformance };

package/dist/testing/data-access-conformance.d.mts

@@ -1,7 +1,6 @@
 import { RepoCapabilities } from "../repository/capabilities.mjs";
 import { AggRequest, AggResult } from "../repository/types.mjs";
 import { BulkUpsertOptions, BulkUpsertResult } from "../repository/bulk-upsert.mjs";
-//#region src/testing/data-access-conformance.d.ts
 /** `getByIds(..., { preserveOrder: true })` reached through the kit's own signature. */
 interface OrderedIdsFixture {
   /** Insert one record per name; returns their ids in the same order. */
@@ -85,5 +84,4 @@ type DataAccessCapability = 'getByIdsOrdered' | 'scopedJoins' | 'bulkUpsert' | '
 /** Whether a group runs, is skipped (capability not declared), or fails (declared, no fixture). */
 declare function dataAccessGroupState(features: RepoCapabilities, capability: DataAccessCapability, fixture: unknown): 'run' | 'skip' | 'missing-fixture';
 declare function runDataAccessConformance(harness: DataAccessConformanceHarness): void;
-//#endregion
 export { BulkUpsertFixture, DataAccessCapability, DataAccessConformanceHarness, OrderedIdsFixture, ReadModelFixture, ScopedJoinFixture, dataAccessGroupState, runDataAccessConformance };

package/dist/testing/data-access-conformance.mjs

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
-//#region src/testing/data-access-conformance.ts
+// src/testing/data-access-conformance.ts
 /**
 * Data-access conformance: behaviour groups a kit OPTS INTO through `RepoCapabilities`.
 *
@@ -327,5 +327,4 @@ function runDataAccessConformance(harness) {
 		});
 	});
 }
-//#endregion
 export { dataAccessGroupState, runDataAccessConformance };

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

@@ -1,5 +1,4 @@
 import { IdempotencyClaimStore } from "../idempotency/index.mjs";
-//#region src/testing/idempotency-conformance.d.ts
 interface IdempotencyConformanceHarness {
   /** A store over an EMPTY backend, per scenario. */
   createStore(): IdempotencyClaimStore | Promise<IdempotencyClaimStore>;
@@ -11,5 +10,4 @@ declare function idempotencyStoreCases(harness: IdempotencyConformanceHarness):
 }[];
 /** Register every contract case as a vitest test against `harness.createStore()`. */
 declare function runIdempotencyStoreConformance(harness: IdempotencyConformanceHarness): void;
-//#endregion
 export { IdempotencyConformanceHarness, idempotencyStoreCases, runIdempotencyStoreConformance };

package/dist/testing/idempotency-conformance.mjs

@@ -1,6 +1,6 @@
 import { completeClaim, decideClaim, identityKey, runIdempotent } from "../idempotency/index.mjs";
 import { describe, it } from "vitest";
-//#region src/testing/idempotency-conformance.ts
+// src/testing/idempotency-conformance.ts
 /**
 * `runIdempotencyStoreConformance` — the contract every `IdempotencyClaimStore` passes.
 * Mirrors `runLockAdapterConformance`: a kit runs it against its real backend, and passing it
@@ -311,5 +311,4 @@ function runIdempotencyStoreConformance(harness) {
 		for (const c of idempotencyStoreCases(harness)) it(c.name, c.run);
 	});
 }
-//#endregion
 export { idempotencyStoreCases, runIdempotencyStoreConformance };

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 {
   /**
    * Construct a fresh adapter for each describe block. May be async
@@ -20,5 +19,4 @@ interface LockConformanceHarness {
   beforeEach?(adapter: LockAdapter): void | Promise<void>;
 }
 declare function runLockAdapterConformance(harness: LockConformanceHarness): void;
-//#endregion
 export { LockConformanceHarness, runLockAdapterConformance };

package/dist/testing/lock-conformance.mjs

@@ -1,5 +1,5 @@
 import { beforeEach, describe, expect, it } from "vitest";
-//#region src/testing/lock-conformance.ts
+// src/testing/lock-conformance.ts
 /**
 * `runLockAdapterConformance` — cross-kit lock-adapter contract suite.
 *
@@ -168,5 +168,4 @@ function runLockAdapterConformance(harness) {
 function sleep(ms) {
 	return new Promise((r) => setTimeout(r, ms));
 }
-//#endregion
 export { runLockAdapterConformance };

package/dist/testing/merge-keyset-conformance.d.mts

@@ -1,6 +1,5 @@
 import { RepoCapabilities } from "../repository/capabilities.mjs";
 import { KeysetSource } from "../pagination/merge-keyset.mjs";
-//#region src/testing/merge-keyset-conformance.d.ts
 interface MergeKeysetFixture {
   /** Insert into source 0 or 1; `k` is a small integer sort key (ties expected), `label` unique. */
   insert(source: 0 | 1, rows: ReadonlyArray<{
@@ -22,5 +21,4 @@ interface MergeKeysetHarness {
   numRuns?: number;
 }
 declare function runMergeKeysetConformance(harness: MergeKeysetHarness): void;
-//#endregion
 export { MergeKeysetFixture, MergeKeysetHarness, runMergeKeysetConformance };

package/dist/testing/merge-keyset-conformance.mjs

@@ -1,7 +1,7 @@
 import { mergeKeysetPages } from "../pagination/merge-keyset.mjs";
 import { describe, expect, it } from "vitest";
 import fc from "fast-check";
-//#region src/testing/merge-keyset-conformance.ts
+// src/testing/merge-keyset-conformance.ts
 /**
 * `mergeKeysetPages` over a kit's real sources (fast-check), gated by
 * `RepoCapabilities.mergeKeyset`: two sources ordered by the same total order (descending key),
@@ -81,5 +81,4 @@ function runMergeKeysetConformance(harness) {
 		});
 	});
 }
-//#endregion
 export { runMergeKeysetConformance };

package/dist/testing/pagination-property-conformance.d.mts

@@ -1,5 +1,4 @@
 import { RepoCapabilities } from "../repository/capabilities.mjs";
-//#region src/testing/pagination-property-conformance.d.ts
 interface PropertyRow {
   id: string;
   k: number | null;
@@ -40,5 +39,4 @@ interface PaginationPropertyHarness {
   numRuns?: number;
 }
 declare function runPaginationPropertyConformance(harness: PaginationPropertyHarness): void;
-//#endregion
 export { PaginationPropertyFixture, PaginationPropertyHarness, PropertyRow, runPaginationPropertyConformance };

package/dist/testing/pagination-property-conformance.mjs

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import fc from "fast-check";
-//#region src/testing/pagination-property-conformance.ts
+// src/testing/pagination-property-conformance.ts
 /**
 * Pagination properties (fast-check), gated by `RepoCapabilities.paginationProperties`.
 *
@@ -156,5 +156,4 @@ function runPaginationPropertyConformance(harness) {
 		});
 	});
 }
-//#endregion
 export { runPaginationPropertyConformance };

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

@@ -1,5 +1,4 @@
 import { TenantPurgeOptions, TenantPurgeResult, TenantPurgeStrategy } from "../repository/types.mjs";
-//#region src/testing/purge-conformance.d.ts
 /** Everything the shared scenarios need from a kit. */
 interface PurgeConformanceContext {
   /**
@@ -29,5 +28,4 @@ interface PurgeConformanceHarness {
   setup(): Promise<PurgeConformanceContext>;
 }
 declare function runPurgeConformance(harness: PurgeConformanceHarness): void;
-//#endregion
 export { PurgeConformanceContext, PurgeConformanceHarness, runPurgeConformance };

package/dist/testing/purge-conformance.mjs

@@ -1,5 +1,5 @@
 import { beforeEach, describe, expect, it } from "vitest";
-//#region src/testing/purge-conformance.ts
+// src/testing/purge-conformance.ts
 /**
 * `runPurgeConformance` — cross-kit chunked-purge contract suite.
 *
@@ -155,5 +155,4 @@ function runPurgeConformance(harness) {
 		});
 	});
 }
-//#endregion
 export { runPurgeConformance };

package/dist/testing/query-grammar-conformance.d.mts

@@ -1,4 +1,3 @@
-//#region src/testing/query-grammar-conformance.d.ts
 /**
  * `runQueryGrammarConformance` — every list-query parser reads a URL the same way.
  *
@@ -56,5 +55,4 @@ interface QueryGrammarConformanceOptions {
   readonly unsupportedOperators?: readonly string[];
 }
 declare function runQueryGrammarConformance(name: string, harness: QueryGrammarHarness, conformance?: QueryGrammarConformanceOptions): void;
-//#endregion
 export { QUERY_GRAMMAR_DOCS, QUERY_GRAMMAR_FILTER_CASES, QUERY_GRAMMAR_PAGING_CASES, QUERY_GRAMMAR_REFUSED, QueryGrammarCaseOptions, QueryGrammarConformanceOptions, QueryGrammarHarness, QueryGrammarParsed, runQueryGrammarConformance };

package/dist/testing/query-grammar-conformance.mjs

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-//#region src/testing/query-grammar-conformance.ts
+// src/testing/query-grammar-conformance.ts
 /**
 * `runQueryGrammarConformance` — every list-query parser reads a URL the same way.
 *
@@ -376,5 +376,4 @@ function runQueryGrammarConformance(name, harness, conformance = {}) {
 		});
 	});
 }
-//#endregion
 export { QUERY_GRAMMAR_DOCS, QUERY_GRAMMAR_FILTER_CASES, QUERY_GRAMMAR_PAGING_CASES, QUERY_GRAMMAR_REFUSED, runQueryGrammarConformance };

package/dist/testing/read-model-property-conformance.d.mts

@@ -1,6 +1,5 @@
 import { RepoCapabilities } from "../repository/capabilities.mjs";
 import { ReadModelFixture } from "./data-access-conformance.mjs";
-//#region src/testing/read-model-property-conformance.d.ts
 interface ReadModelPropertyHarness {
   name: string;
   features: RepoCapabilities;
@@ -9,5 +8,4 @@ interface ReadModelPropertyHarness {
   numRuns?: number;
 }
 declare function runReadModelPropertyConformance(harness: ReadModelPropertyHarness): void;
-//#endregion
 export { ReadModelPropertyHarness, runReadModelPropertyConformance };

package/dist/testing/read-model-property-conformance.mjs

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import fc from "fast-check";
-//#region src/testing/read-model-property-conformance.ts
+// src/testing/read-model-property-conformance.ts
 /**
 * Read-model properties (fast-check), gated by `RepoCapabilities.readModel`.
 *
@@ -70,5 +70,4 @@ function runReadModelPropertyConformance(harness) {
 		});
 	});
 }
-//#endregion
 export { runReadModelPropertyConformance };

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
  * every backend:
@@ -123,5 +122,4 @@ interface ConformanceHarness<TDoc extends ConformanceDoc = ConformanceDoc> {
    */
   makeDoc(overrides?: Partial<ConformanceDoc>): Partial<TDoc>;
 }
-//#endregion
 export { type AggregateOpsSupport, ConformanceContext, ConformanceDoc, ConformanceFeatures, ConformanceHarness };

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

@@ -1,5 +1,4 @@
 import { UsageStore } from "../usage/index.mjs";
-//#region src/testing/usage-conformance.d.ts
 interface UsageConformanceHarness {
   /**
    * Construct the store under test. May be async (SQL migrations,
@@ -14,5 +13,4 @@ interface UsageConformanceHarness {
   beforeEach?(store: UsageStore): void | Promise<void>;
 }
 declare function runUsageStoreContract(harness: UsageConformanceHarness): void;
-//#endregion
 export { UsageConformanceHarness, runUsageStoreContract };

package/dist/testing/usage-conformance.mjs

@@ -1,5 +1,5 @@
 import { beforeEach, describe, expect, it } from "vitest";
-//#region src/testing/usage-conformance.ts
+// src/testing/usage-conformance.ts
 /**
 * `runUsageStoreContract` — cross-kit usage-store contract suite.
 *
@@ -97,5 +97,4 @@ function runUsageStoreContract(harness) {
 		});
 	});
 }
-//#endregion
 export { runUsageStoreContract };

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.
  *
@@ -47,5 +46,4 @@ declare function setOnInsertFields(fields: Record<string, unknown>): UpdateSpec;
  * always a caller bug.
  */
 declare function combineUpdates(...specs: readonly UpdateSpec[]): UpdateSpec;
-//#endregion
 export { combineUpdates, incFields, setFields, setOnInsertFields, unsetFields, update };

package/dist/update/builders.mjs

@@ -1,4 +1,4 @@
-//#region src/update/builders.ts
+// src/update/builders.ts
 /**
 * Compose an `UpdateSpec` from the four primitive mutations.
 *
@@ -88,5 +88,4 @@ function stripUndefined(record) {
 	for (const [k, v] of Object.entries(record)) if (v !== void 0) out[k] = v;
 	return Object.keys(out).length > 0 ? Object.freeze(out) : void 0;
 }
-//#endregion
 export { combineUpdates, incFields, setFields, setOnInsertFields, unsetFields, update };