@classytic/mongokit 3.43.1 → 3.45.0

package/dist/index.mjs

@@ -1,30 +1,30 @@
-import { n as idVariants } from "./id-resolution-BqDrk0S2.mjs";
-import { a as ALL_OPERATIONS, c as READ_OPERATIONS, i as searchKeysPlugin, l as operationsByPolicyKey, n as Repository, o as MUTATING_OPERATIONS, r as AggregationBuilder, s as OP_REGISTRY, t as HOOK_PRIORITY, u as createMongoPurgePort } from "./Repository-Dj6xqPxJ.mjs";
-import { C as isCreateManyPartialError, g as LookupBuilder, v as compileFilterToMongo } from "./update-WgeAUJ_I.mjs";
-import { n as warn, t as configureLogger } from "./logger-K7dPmu2U.mjs";
-import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-BuByZwKU.mjs";
-import { a as assertQueryDefaultsConfigured, c as getQueryDefaults, l as resetQueryDefaults, o as configureAggregateDefaults, s as configureQueryDefaults, t as QUERY_DEFAULTS_ERROR_CODES, u as resolveQueryOptions } from "./query-defaults-BxUcSOoF.mjs";
-import { t as actions_exports } from "./actions-ChYfkPYP.mjs";
-import { a as supportsTransactions, c as MONGOKIT_CAPABILITIES, d as probeMongoCapabilities, f as resetCapabilityProbeCache, h as transactionResolutionOf, i as runTransaction, l as capabilitiesForSupport, m as resolveTransactionSupport, n as batchTransaction, o as withTransaction, p as resolveMongoCapabilities, r as isTransactionUnsupported, t as TRANSACTION_ERROR_CODES, u as classifyHelloReply } from "./transaction-DmiB4k2P.mjs";
-import { _ as AuditTrailQuery, a as declareTenantContextKey, b as auditLogPlugin, c as tenantContextKeysOf, d as ensureSequenceAtLeast, f as getNextSequence, g as cachePlugin, h as sequentialId, i as multiTenantPlugin, l as customIdPlugin, m as readSequence, n as softDeletePlugin, o as forwardScope, p as prefixedId, r as adminBypass, s as isScopeKey, t as timestampPlugin, u as dateSequentialId, v as auditTrailPlugin, y as ensureAuditTrailReady } from "./timestamp.plugin-DpOWavVI.mjs";
-import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "./method-registry.plugin-C63pGn1d.mjs";
-import { c as PAGINATION_ERROR_CODES, h as resetPaginationDefaults, m as getPaginationDefaults, p as configurePaginationDefaults, t as PaginationEngine } from "./PaginationEngine-DZnkbSrr.mjs";
-import { _ as tokenizeSearchText, d as buildSearchKeys, f as prefixSearchFilter, g as normalizeSearchText, h as findSearchMatches, l as DEFAULT_SEARCH_KEYS_FIELD, m as searchKeysPath, n as SearchKeysWriteError, p as searchKeysIndex, t as SEARCH_KEYS_ERROR_CODES, u as MAX_PREFIX_SEARCH_TERMS } from "./derive-DRBiegRH.mjs";
+import { n as idVariants } from "./id-resolution-Cqh49d9J.mjs";
+import { a as ALL_OPERATIONS, c as READ_OPERATIONS, d as RETENTION_PURGE_ERROR_CODES, i as searchKeysPlugin, l as operationsByPolicyKey, n as Repository, o as MUTATING_OPERATIONS, r as AggregationBuilder, s as OP_REGISTRY, t as HOOK_PRIORITY, u as createMongoPurgePort } from "./Repository-DheA7oW-.mjs";
+import { C as isCreateManyPartialError, g as LookupBuilder, v as compileFilterToMongo } from "./update-CYaJMu6j.mjs";
+import { t as actions_exports } from "./actions-DKQx9ToJ.mjs";
+import { a as supportsTransactions, c as MONGOKIT_CAPABILITIES, d as probeMongoCapabilities, f as resetCapabilityProbeCache, h as transactionResolutionOf, i as runTransaction, l as capabilitiesForSupport, m as resolveTransactionSupport, n as batchTransaction, o as withTransaction, p as resolveMongoCapabilities, r as isTransactionUnsupported, t as TRANSACTION_ERROR_CODES, u as classifyHelloReply } from "./transaction-C6Oj941P.mjs";
+import { t as createRepository } from "./create-repository-C9DHHcl7.mjs";
+import { n as defineModel, r as isModelRegistered, t as ModelCollisionError } from "./model-registry-DrVfJ3Nt.mjs";
+import { c as PAGINATION_ERROR_CODES, h as resetPaginationDefaults, m as getPaginationDefaults, p as configurePaginationDefaults, t as PaginationEngine } from "./PaginationEngine-BRlLTQQz.mjs";
+import { C as ensureAuditTrailReady, S as auditTrailPlugin, _ as prefixedId, a as declareTenantContextKey, b as cachePlugin, c as tenantContextKeysOf, d as customIdPlugin, f as dateSequentialId, g as periodCounterKey, h as getNextSequence, i as multiTenantPlugin, l as civilPeriodKey, m as getNextPeriodSequence, n as softDeletePlugin, o as forwardScope, p as ensureSequenceAtLeast, r as adminBypass, s as isScopeKey, t as timestampPlugin, u as createSequenceCounter, v as readSequence, w as auditLogPlugin, x as AuditTrailQuery, y as sequentialId } from "./timestamp.plugin-B-IJrlYb.mjs";
+import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "./validation-chain.plugin-DJplVJ12.mjs";
+import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "./method-registry.plugin-BeJfQBJV.mjs";
+import { n as warn, t as configureLogger } from "./logger-hbWOlj_X.mjs";
 import { GEO_OPERATORS, parseGeoFilter } from "./query/primitives/geo.mjs";
-import { n as declareCollectionScope, t as JOIN_ERROR_CODES } from "./join-scope-DSAznE8E.mjs";
-import { t as createRepository } from "./create-repository-UjwPWR1z.mjs";
-import { n as defineModel, r as isModelRegistered, t as ModelCollisionError } from "./model-registry-ClKtWiHa.mjs";
-import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "./validation-chain.plugin-DRApTmkN.mjs";
-import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-FSQFLpsU.mjs";
 import { buildFieldTypeMap, coerceHeuristic } from "./query/primitives/coercion.mjs";
+import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-DjdmPLWO.mjs";
 import { extractSchemaIndexes } from "./query/primitives/indexes.mjs";
+import { n as declareCollectionScope, t as JOIN_ERROR_CODES } from "./join-scope-C1gOtZ59.mjs";
+import { a as configureAggregateDefaults, c as resetQueryDefaults, i as assertQueryDefaultsConfigured, l as resolveQueryOptions, o as configureQueryDefaults, s as getQueryDefaults, t as QUERY_DEFAULTS_ERROR_CODES } from "./query-defaults-DwvWUjZU.mjs";
+import { _ as tokenizeSearchText, d as buildSearchKeys, f as prefixSearchFilter, g as normalizeSearchText, h as findSearchMatches, l as DEFAULT_SEARCH_KEYS_FIELD, m as searchKeysPath, n as SearchKeysWriteError, p as searchKeysIndex, t as SEARCH_KEYS_ERROR_CODES, u as MAX_PREFIX_SEARCH_TERMS } from "./derive-Dxsc31fV.mjs";
+import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-DPFaFw9Y.mjs";
 import "./search/index.mjs";
-import { n as createMemoryCache, t as toPlain } from "./to-plain-vksRrLtc.mjs";
-import { n as buildCrudSchemasFromMongooseSchema, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-C3k4ide0.mjs";
+import { n as createMemoryCache, t as toPlain } from "./to-plain-CEKv_ylg.mjs";
+import { n as buildCrudSchemasFromMongooseSchema, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-DMDotz4_.mjs";
 import { runChunkedPurge } from "@classytic/repo-core/repository";
 import { stableStringify } from "@classytic/repo-core/hash";
 import { OPERATOR_DESCRIPTIONS, QueryGrammarError, URL_OPERATORS, clausesToFilter, escapeRegex, isQueryGrammarError, readFilterClauses, readPageRequest, readSearch, readSelect, readSort } from "@classytic/repo-core/query-parser";
-//#region src/actions/cascade-references.ts
+// src/actions/cascade-references.ts
 /**
 * cascadePurgeReferences — imperative, multi-relation "purge by reference".
 *
@@ -152,8 +152,7 @@ async function cascadePurgeReferences(options) {
 	for (const rel of relations) out.push(await purgeRelation(rel, match, mode, ctx));
 	return out;
 }
-//#endregion
-//#region src/model-blueprint.ts
+// src/model-blueprint.ts
 function isProductionRuntime() {
 	return process.env.NODE_ENV === "production";
 }
@@ -223,8 +222,7 @@ function defineModels(spec) {
 		}
 	};
 }
-//#endregion
-//#region src/pagination/keyset-source.ts
+// src/pagination/keyset-source.ts
 /**
 * `keysetSource(repo, { name, sort, filters, ...scope })` — a mongokit repository as a repo-core
 * `KeysetSource`, for `mergeKeysetPages`. Pages are `getAll({ mode: 'keyset' })` under the given
@@ -262,8 +260,7 @@ function keysetSource(repo, options) {
 		})
 	};
 }
-//#endregion
-//#region src/query/parser/pipeline-sanitizer.ts
+// src/query/parser/pipeline-sanitizer.ts
 /**
 * Sanitize $match configuration to prevent dangerous operators.
 * Recursively filters out operators like $where, $function, $accumulator.
@@ -372,8 +369,7 @@ function sanitizeExpressions(rt, config, depth = 0) {
 	}
 	return sanitized;
 }
-//#endregion
-//#region src/query/parser/aggregation.ts
+// src/query/parser/aggregation.ts
 /**
 * Parse aggregation pipeline from URL (advanced feature).
 *
@@ -401,8 +397,7 @@ function parseAggregation(rt, aggregate) {
 	}
 	return pipeline.length > 0 ? pipeline : void 0;
 }
-//#endregion
-//#region src/query/parser/filter-compiler.ts
+// src/query/parser/filter-compiler.ts
 /**
 * URL filters → a MongoDB filter. The grammar (keys, operators, value coercion, refusals) is
 * repo-core's `readFilterClauses`; its clauses compile through the Filter IR compiler every
@@ -531,8 +526,7 @@ function toGrammarFieldTypes(types) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-//#endregion
-//#region src/query/parser/lookup.ts
+// src/query/parser/lookup.ts
 function pluralize(str) {
 	if (str.endsWith("y")) return `${str.slice(0, -1)}ies`;
 	if (str.endsWith("s")) return str;
@@ -606,8 +600,7 @@ function parseSingleLookup(rt, collectionName, config) {
 	}
 	return null;
 }
-//#endregion
-//#region src/query/parser/runtime.ts
+// src/query/parser/runtime.ts
 /**
 * Parser runtime — the shared context every parser module receives.
 *
@@ -646,8 +639,7 @@ function guarded(rt, read, fallback) {
 		return fallback;
 	}
 }
-//#endregion
-//#region src/query/parser/sort-select.ts
+// src/query/parser/sort-select.ts
 /**
 * `?sort=-createdAt,name` and `?select=name,-password` — read through the shared grammar
 * (`readSort` / `readSelect`), so an invalid or disallowed field is refused like any filter.
@@ -672,8 +664,7 @@ function parseSort(rt, sort) {
 function parseSelect(rt, select) {
 	return guarded(rt, () => readSelect(select), void 0);
 }
-//#endregion
-//#region src/query/parser/populate.ts
+// src/query/parser/populate.ts
 /**
 * Populate parsing — simple string form (`?populate=author,category`) and
 * qs-nested advanced form (`?populate[author][select]=name,email`), with
@@ -790,8 +781,7 @@ function convertPopulateMatch(rt, path, match) {
 	}
 	return converted;
 }
-//#endregion
-//#region src/query/parser/schema-docs.ts
+// src/query/parser/schema-docs.ts
 /**
 * OpenAPI query-schema generation — Arc's `defineResource()` auto-detects
 * `getQuerySchema()` on the parser and uses it to document list-endpoint
@@ -932,8 +922,7 @@ function buildOpenAPIQuerySchema(rt) {
 	};
 	return schema;
 }
-//#endregion
-//#region src/query/parser/search.ts
+// src/query/parser/search.ts
 /**
 * `?search=` — length-checked through the shared grammar. Regex mode matches the term as LITERAL
 * text across `searchFields` (`c++` and `a.b` mean exactly those characters).
@@ -947,8 +936,7 @@ function buildRegexSearch(rt, searchTerm) {
 	const pattern = new RegExp(escapeRegex(searchTerm), "i");
 	return fields.map((field) => ({ [field]: { $regex: pattern } }));
 }
-//#endregion
-//#region src/query/QueryParser.ts
+// src/query/QueryParser.ts
 /**
 * Modern Query Parser - URL to MongoDB Query Transpiler
 *
@@ -1184,8 +1172,7 @@ function attachCondition(filters, condition) {
 		$and: and
 	};
 }
-//#endregion
-//#region src/search/rebuild.ts
+// src/search/rebuild.ts
 const sameKeys = (a, b) => Array.isArray(a) && a.length === b.length && a.every((v, i) => v === b[i]);
 async function rebuildSearchKeys(source, options = {}) {
 	const repo = typeof source === "function" ? void 0 : source;
@@ -1230,8 +1217,7 @@ async function rebuildSearchKeys(source, options = {}) {
 		updated
 	};
 }
-//#endregion
-//#region src/utils/repo-options.ts
+// src/utils/repo-options.ts
 /**
 * Forward request-scoped context fields into a mongokit options bag.
 *
@@ -1443,8 +1429,7 @@ function systemContext(extra) {
 		bypassTenant: true
 	};
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 /**
 * MongoKit - Event-driven repository pattern for MongoDB
 *
@@ -1484,5 +1469,4 @@ function systemContext(extra) {
 * ```
 */
 var src_default = Repository;
-//#endregion
-export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, DEFAULT_SEARCH_KEYS_FIELD, HOOK_PRIORITY, JOIN_ERROR_CODES, LookupBuilder, MAX_PREFIX_SEARCH_TERMS, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, ModelCollisionError, OP_REGISTRY, PAGINATION_ERROR_CODES, PaginationEngine, QUERY_DEFAULTS_ERROR_CODES, QueryParser, READ_OPERATIONS, Repository, SEARCH_KEYS_ERROR_CODES, SearchKeysWriteError, TRANSACTION_ERROR_CODES, actions_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, assertQueryDefaultsConfigured, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, buildSearchKeys, cachePlugin, capabilitiesForSupport, cascadePlugin, cascadePurgeReferences, classifyHelloReply, compileFilterToMongo, configureAggregateDefaults, configureLogger, configurePaginationDefaults, configureQueryDefaults, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, declareCollectionScope, declareTenantContextKey, src_default as default, defineModel, defineModels, elasticSearchPlugin, ensureAuditTrailReady, ensureSequenceAtLeast, fieldFilterPlugin, filterResponseData, findSearchMatches, forwardScope, getFieldsForUser, getMongooseProjection, getNextSequence, getPaginationDefaults, getQueryDefaults, idVariants, idempotencyStorePlugin, immutableField, immutableStatesPlugin, isCreateManyPartialError, isDuplicateKeyError, isModelRegistered, isTransactionUnsupported, keysetSource, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, normalizeSearchText, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixSearchFilter, prefixedId, probeMongoCapabilities, readSequence, rebuildSearchKeys, repoOptionsFromCtx, requireField, resetCapabilityProbeCache, resetPaginationDefaults, resetQueryDefaults, resolveMongoCapabilities, resolveQueryOptions, resolveTransactionSupport, runTransaction, searchKeysIndex, searchKeysPath, searchKeysPlugin, sequentialId, softDeletePlugin, subdocumentPlugin, supportsTransactions, systemContext, tenantContextKeysOf, timestampPlugin, toPlain, tokenizeSearchText, transactionResolutionOf, uniqueField, validationChainPlugin, withTransaction };
+export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, DEFAULT_SEARCH_KEYS_FIELD, HOOK_PRIORITY, JOIN_ERROR_CODES, LookupBuilder, MAX_PREFIX_SEARCH_TERMS, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, ModelCollisionError, OP_REGISTRY, PAGINATION_ERROR_CODES, PaginationEngine, QUERY_DEFAULTS_ERROR_CODES, QueryParser, READ_OPERATIONS, RETENTION_PURGE_ERROR_CODES, Repository, SEARCH_KEYS_ERROR_CODES, SearchKeysWriteError, TRANSACTION_ERROR_CODES, actions_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, assertQueryDefaultsConfigured, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, buildSearchKeys, cachePlugin, capabilitiesForSupport, cascadePlugin, cascadePurgeReferences, civilPeriodKey, classifyHelloReply, compileFilterToMongo, configureAggregateDefaults, configureLogger, configurePaginationDefaults, configureQueryDefaults, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createSequenceCounter, createTenantContext, customIdPlugin, dateSequentialId, declareCollectionScope, declareTenantContextKey, src_default as default, defineModel, defineModels, elasticSearchPlugin, ensureAuditTrailReady, ensureSequenceAtLeast, fieldFilterPlugin, filterResponseData, findSearchMatches, forwardScope, getFieldsForUser, getMongooseProjection, getNextPeriodSequence, getNextSequence, getPaginationDefaults, getQueryDefaults, idVariants, idempotencyStorePlugin, immutableField, immutableStatesPlugin, isCreateManyPartialError, isDuplicateKeyError, isModelRegistered, isTransactionUnsupported, keysetSource, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, normalizeSearchText, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, periodCounterKey, prefixSearchFilter, prefixedId, probeMongoCapabilities, readSequence, rebuildSearchKeys, repoOptionsFromCtx, requireField, resetCapabilityProbeCache, resetPaginationDefaults, resetQueryDefaults, resolveMongoCapabilities, resolveQueryOptions, resolveTransactionSupport, runTransaction, searchKeysIndex, searchKeysPath, searchKeysPlugin, sequentialId, softDeletePlugin, subdocumentPlugin, supportsTransactions, systemContext, tenantContextKeysOf, timestampPlugin, toPlain, tokenizeSearchText, transactionResolutionOf, uniqueField, validationChainPlugin, withTransaction };

package/dist/indexes/verify-indexes.d.mts

@@ -1,4 +1,3 @@
-//#region src/indexes/verify-indexes.d.ts
 /**
  * Compare DECLARED indexes against what a database actually has.
  *
@@ -27,11 +26,11 @@
  * touches no connection. This module is the live comparison.
  */
 /** The slice of a Mongoose-like connection this needs. Structural on purpose. */
-interface IndexVerifiableConnection {
+export interface IndexVerifiableConnection {
   modelNames(): string[];
   model(name: string): IndexVerifiableModel;
 }
-interface IndexVerifiableModel {
+export interface IndexVerifiableModel {
   schema: {
     indexes(): Array<[Record<string, unknown>, Record<string, unknown>?]>;
   };
@@ -42,20 +41,20 @@ interface IndexVerifiableModel {
     };
   };
 }
-interface MissingIndex {
+export interface MissingIndex {
   model: string;
   collection: string;
   /** The declared key, JSON-stringified — stable to log and to diff. */
   key: string;
 }
 /** A live index on the declared keys whose correctness options differ from the declaration. */
-interface IncompatibleIndex extends MissingIndex {
+export interface IncompatibleIndex extends MissingIndex {
   /** Declared `unique` — a mismatch here can already have admitted duplicates. */
   unique: boolean;
   /** One line per differing option: `unique: declared true, live false`. */
   differences: string[];
 }
-interface IndexVerifyReport {
+export interface IndexVerifyReport {
   modelsChecked: number;
   /** Declared `unique` indexes with nothing behind them. Duplicates can already exist. */
   missingUnique: MissingIndex[];
@@ -65,7 +64,7 @@ interface IndexVerifyReport {
   /** Models whose indexes could not be read — collection absent, or no permission. */
   unreadable: string[];
 }
-interface VerifyIndexesOptions {
+export interface VerifyIndexesOptions {
   /**
    * Include a model in the sweep. Default: every model.
    *
@@ -75,8 +74,6 @@ interface VerifyIndexesOptions {
    */
   includeModel?: (modelName: string) => boolean;
 }
-declare function verifyIndexes(connection: IndexVerifiableConnection, options?: VerifyIndexesOptions): Promise<IndexVerifyReport>;
+export declare function verifyIndexes(connection: IndexVerifiableConnection, options?: VerifyIndexesOptions): Promise<IndexVerifyReport>;
 /** One-line summary for a boot log. */
-declare function formatIndexReport(report: IndexVerifyReport): string;
-//#endregion
-export { IncompatibleIndex, IndexVerifiableConnection, IndexVerifiableModel, IndexVerifyReport, MissingIndex, VerifyIndexesOptions, formatIndexReport, verifyIndexes };
+export declare function formatIndexReport(report: IndexVerifyReport): string;

package/dist/indexes/verify-indexes.mjs

@@ -1,4 +1,4 @@
-//#region src/indexes/verify-indexes.ts
+// src/indexes/verify-indexes.ts
 /**
 * Order-sensitive: a compound index is not the same index with keys swapped.
 *
@@ -119,5 +119,4 @@ function formatIndexReport(report) {
 	if (report.unreadable.length > 0) parts.push(`unreadable: ${report.unreadable.length}`);
 	return `[index-check] ${parts.join(" — ")}`;
 }
-//#endregion
 export { formatIndexReport, verifyIndexes };

package/dist/{indexes-DIjMpYES.d.mts → indexes-FfyOuhDK.d.mts}

@@ -1,4 +1,3 @@
-//#region src/query/primitives/indexes.d.ts
 /**
  * Schema index introspection
  *
@@ -37,5 +36,4 @@ interface SchemaIndexes {
  * can read `.geoFields`/`.textFields` unconditionally without null checks.
  */
 declare function extractSchemaIndexes(schema?: IndexableSchema | null): SchemaIndexes;
-//#endregion
 export { SchemaIndexes as n, extractSchemaIndexes as r, IndexableSchema as t };

package/dist/{join-scope-DSAznE8E.mjs → join-scope-C1gOtZ59.mjs}

@@ -1,6 +1,6 @@
-import { t as createError } from "./error-BuByZwKU.mjs";
+import { t as createError } from "./error-DjdmPLWO.mjs";
 import mongoose from "mongoose";
-//#region src/repository/join-scope.ts
+// src/repository/join-scope.ts
 /**
 * Join scope — a joined collection is read under ITS OWN policy, or not at all.
 *
@@ -164,5 +164,4 @@ function walk(pipeline, env) {
 		return stage;
 	});
 }
-//#endregion
 export { scopeJoins as a, scopeForCollection as i, declareCollectionScope as n, tenantFieldsOf as o, markGoverned as r, JOIN_ERROR_CODES as t };

package/dist/kernel-conformance/index.d.mts

@@ -1,19 +1,50 @@
 import { Connection } from "mongoose";
-//#region src/kernel-conformance/types.d.ts
 /**
  * Every check the suite can run, in execution order. The ids are STABLE — `skip` is typed
  * against this tuple, so a typo is a compile error rather than a silently-ineffective skip
  * (a skip that skips nothing is the same silent-permissiveness bug class the suite exists
  * to catch).
  */
-declare const KERNEL_CONFORMANCE_CHECKS: readonly ["describe-purity", "blueprint-model-names", "bind-registers-declared-models", "bind-connection-scoped", "bind-no-index-io", "no-autoindex-on-bind", "fresh-schema-per-connection", "double-bind-collision", "transport-not-closed-when-supplied", "owned-transport-closed", "close-idempotent", "no-legacy-surface", "maintenance-fails-loud", "bind-verifies-requirements", "outbox-requires-transactional-save", "optional-modules-register-no-models"];
+export declare const KERNEL_CONFORMANCE_CHECKS: readonly [
+/** §11.1 — `defineX(shape)` registers no model and performs no I/O. */
+'describe-purity',
+/** §11.1 — `modelNames` is non-empty, frozen, and matches `expectedModelNames`. */
+'blueprint-model-names',
+/** §11.1 — after `bind`, the connection holds EXACTLY the declared models. */
+'bind-registers-declared-models',
+/** §5.2 — `bind` uses the supplied connection's registry, never the global one. */
+'bind-connection-scoped',
+/** §11.11 — `bind` never synchronizes, creates or drops indexes. */
+'bind-no-index-io',
+/** §8.1 — every bound schema disables mongoose's own `autoIndex` build. */
+'no-autoindex-on-bind',
+/** §11.3 — a schema factory produces a FRESH schema per connection. */
+'fresh-schema-per-connection',
+/** §11.2/§11.12 — a second bind on one connection throws mongokit `ModelCollisionError`. */
+'double-bind-collision',
+/** §11.7 — a host-SUPPLIED transport is never closed by the engine. */
+'transport-not-closed-when-supplied',
+/** §11.7 — the internally-created bus IS closed by `close()`. */
+'owned-transport-closed',
+/** §6.4 — `close()` is idempotent. */
+'close-idempotent',
+/** §11.12 — one construction API (`defineX`), one teardown name (`close`). */
+'no-legacy-surface',
+/** §8 — a failing index sync REJECTS; it is never swallowed. */
+'maintenance-fails-loud',
+/** §11.5 — unmet runtime capability requirements fail the bind. (conditional) */
+'bind-verifies-requirements',
+/** §11.5 — an injected outbox that does not enlist `ctx.session` is REFUSED. (conditional) */
+'outbox-requires-transactional-save',
+/** §11.10 — a blueprint with optional modules off registers no extra models. (conditional) */
+'optional-modules-register-no-models'];
 type ConformanceCheck = (typeof KERNEL_CONFORMANCE_CHECKS)[number];
 /**
  * Checks that only run when the kernel supplies the input they need. When the input is
  * absent they are reported as NOT EXERCISED — a visible marker test plus a report entry,
  * never a silent pass.
  */
-declare const CONDITIONAL_CHECKS: readonly ["bind-verifies-requirements", "outbox-requires-transactional-save", "optional-modules-register-no-models"];
+export declare const CONDITIONAL_CHECKS: readonly ["bind-verifies-requirements", "outbox-requires-transactional-save", "optional-modules-register-no-models"];
 /**
  * The two runner functions the suite needs, INJECTED by the consumer.
  *
@@ -192,15 +223,11 @@ interface KernelConformanceOptions<TBlueprint extends KernelBlueprintLike, TEngi
   /** Receives the manifest before any test runs. Defaults to a `console` summary. */
   readonly onReport?: (report: KernelConformanceReport) => void;
 }
-//#endregion
-//#region src/kernel-conformance/suite.d.ts
-declare function describeKernelConformance<TBlueprint extends KernelBlueprintLike, TEngine>(opts: KernelConformanceOptions<TBlueprint, TEngine>): void;
-//#endregion
-//#region src/kernel-conformance/transport.d.ts
+export declare function describeKernelConformance<TBlueprint extends KernelBlueprintLike, TEngine>(opts: KernelConformanceOptions<TBlueprint, TEngine>): void;
 /** A minimal, valid domain-event envelope (`type` + `meta.id` is all any bus reads). */
-declare function conformanceEvent(type: string): ConformanceEvent;
+export declare function conformanceEvent(type: string): ConformanceEvent;
 /** An in-process transport good enough to stand in for a host-owned shared bus. */
-declare function createConformanceTransport(name?: string): EventTransportLike;
+export declare function createConformanceTransport(name?: string): EventTransportLike;
 interface InstrumentedTransport {
   /** Hand THIS to the kernel. */
   readonly transport: EventTransportLike;
@@ -212,6 +239,5 @@ interface InstrumentedTransport {
  * the kernel cannot tell the difference — which is the point: ownership must be decided by
  * "did I create this?", never by inspecting the object.
  */
-declare function instrumentTransport(inner: EventTransportLike): InstrumentedTransport;
-//#endregion
-export { CONDITIONAL_CHECKS, type ConformanceCheck, type ConformanceCheckOutcome, type ConformanceCheckStatus, type ConformanceConnect, type ConformanceConnectionHandle, type ConformanceEvent, type ConformanceRunner, type ConformanceSkip, type EventTransportLike, type InstrumentedTransport, KERNEL_CONFORMANCE_CHECKS, type KernelBindContext, type KernelBlueprintLike, type KernelConformanceOptions, type KernelConformanceReport, conformanceEvent, createConformanceTransport, describeKernelConformance, instrumentTransport };
+export declare function instrumentTransport(inner: EventTransportLike): InstrumentedTransport;
+export type { ConformanceCheck, ConformanceCheckOutcome, ConformanceCheckStatus, ConformanceConnect, ConformanceConnectionHandle, ConformanceEvent, ConformanceRunner, ConformanceSkip, EventTransportLike, InstrumentedTransport, KernelBindContext, KernelBlueprintLike, KernelConformanceOptions, KernelConformanceReport };

package/dist/kernel-conformance/index.mjs

@@ -1,6 +1,6 @@
-import { t as ModelCollisionError } from "../model-registry-ClKtWiHa.mjs";
+import { t as ModelCollisionError } from "../model-registry-DrVfJ3Nt.mjs";
 import mongoose from "mongoose";
-//#region src/kernel-conformance/transport.ts
+// src/kernel-conformance/transport.ts
 /** Exact match, `*`, or a `prefix.*` / `prefix:*` glob — the kernel bus convention. */
 function matches(pattern, type) {
 	if (pattern === "*" || pattern === type) return true;
@@ -81,8 +81,7 @@ function instrumentTransport(inner) {
 		closeCalls: () => closeCalls
 	};
 }
-//#endregion
-//#region src/kernel-conformance/types.ts
+// src/kernel-conformance/types.ts
 /**
 * Every check the suite can run, in execution order. The ids are STABLE — `skip` is typed
 * against this tuple, so a typo is a compile error rather than a silently-ineffective skip
@@ -117,8 +116,7 @@ const CONDITIONAL_CHECKS = [
 	"outbox-requires-transactional-save",
 	"optional-modules-register-no-models"
 ];
-//#endregion
-//#region src/kernel-conformance/suite.ts
+// src/kernel-conformance/suite.ts
 /**
 * `describeKernelConformance` — the EXECUTABLE form of the Kernel Construction Standard
 * (commerce `STANDARDIZATION-PLAN.md` §11).
@@ -599,5 +597,4 @@ function defaultReport(report) {
 	for (const s of report.notExercised) lines.push(`  NOT EXERCISED ${s.check} — ${s.reason}`);
 	console.info(lines.join("\n"));
 }
-//#endregion
 export { CONDITIONAL_CHECKS, KERNEL_CONFORMANCE_CHECKS, conformanceEvent, createConformanceTransport, describeKernelConformance, instrumentTransport };

package/dist/lock/index.d.mts

@@ -1,8 +1,91 @@
-import { Connection } from "mongoose";
-import { BaseLockAdapterOptions, LockAdapter } from "@classytic/repo-core/lock";
-//#region src/lock/index.d.ts
+import { ClientSession, Connection } from "mongoose";
+import { BaseLockAdapterOptions, LockAdapter, LockState } from "@classytic/repo-core/lock";
+/** What a claim carries (mirrors arc's `DailyClaimInfo`). */
+interface MongoDailyClaimInfo {
+  /** The gate's clock reading when the claim was attempted. */
+  readonly now: Date;
+  /** Uncompleted claims older than this may be re-granted. Omit to never re-grant. */
+  readonly staleAfterMs?: number;
+}
+/** The ledger contract (structurally arc's `DailyLedger`, plus `inspect`). */
+interface MongoDailyLedger {
+  claimDay(key: string, civilDate: string, info: MongoDailyClaimInfo): Promise<boolean>;
+  /**
+   * Mark the day done (stale recovery never applies again) and store `result`, fenced to the
+   * claim this invocation won. A no-op when that claim was re-granted, already completed or
+   * released, or when the caller holds no claim on the day (see `adminCompleteDay`).
+   */
+  completeDay(key: string, civilDate: string, result?: Record<string, unknown>): Promise<void>;
+  /** Drop this invocation's UNCOMPLETED claim so the next tick retries. A completed day is kept. */
+  releaseDay(key: string, civilDate: string): Promise<void>;
+  /**
+   * Claim the day and return a per-invocation handle (or `null` when not won). The handle's
+   * `complete` / `release` are fenced by its own token, whatever else claims the day later.
+   */
+  claim(key: string, civilDate: string, info: MongoDailyClaimInfo): Promise<MongoDailyClaim | null>;
+  /**
+   * Manual / admin completion: complete the day's UNCOMPLETED claim whoever holds it, unfenced.
+   * Explicit only; never a fallback of `completeDay`. Resolves `true` when it completed a row.
+   */
+  adminCompleteDay(key: string, civilDate: string, result?: Record<string, unknown>): Promise<boolean>;
+  /** Read one day's row, or `null`. For assertions and admin views. */
+  inspect(key: string, civilDate: string): Promise<MongoDailyLedgerRow | null>;
+}
+/** One won claim (see `MongoDailyLedger.claim`). */
+interface MongoDailyClaim {
+  readonly key: string;
+  readonly civilDate: string;
+  /** Unique per claim; the row carries it as `claimToken` while this claim holds the day. */
+  readonly token: string;
+  readonly claimedAt: Date;
+  /** Complete the day while this claim still holds it. `true` when it did. */
+  complete(result?: Record<string, unknown>): Promise<boolean>;
+  /** Drop the claim while it still holds the day uncompleted. `true` when it did. */
+  release(): Promise<boolean>;
+}
+interface MongoDailyLedgerRow {
+  key: string;
+  civilDate: string;
+  claimedAt: Date;
+  /** The winning claim's token (rows written by earlier versions have none). */
+  claimToken?: string;
+  completed: boolean;
+  completedAt?: Date;
+  result?: Record<string, unknown>;
+}
+interface MongoDailyLedgerOptions {
+  /** Mongoose connection. Default `mongoose.connection`. */
+  connection?: Connection;
+  /** Collection name. Default `mongo_daily_ledger`. */
+  collectionName?: string;
+  /** Mongoose model name. Default `MongoDailyLedger`. */
+  modelName?: string;
+  /** Clock for `completedAt`. Default `() => new Date()`. Claims use `info.now`. */
+  nowFn?: () => Date;
+  /**
+   * Optional session getter for `completeDay`, `releaseDay` and
+   * `inspect`, e.g. to complete a day inside the job's transaction.
+   * `claimDay` never uses it: a losing claim raises E11000, which would
+   * abort a surrounding transaction.
+   */
+  session?: () => ClientSession | undefined;
+}
+/**
+ * Build a Mongo-backed daily ledger. Idempotent per `(connection,
+ * modelName)` like `createMongoLockAdapter`.
+ *
+ * @example
+ * import { createDailyGate } from '@classytic/arc/plugins';
+ * import { createMongoDailyLedger } from '@classytic/mongokit/lock';
+ *
+ * const gate = createDailyGate({
+ *   key: 'digest', zone: 'Asia/Dubai', hour: 6, staleAfterMs: 15 * 60_000,
+ *   ledger: createMongoDailyLedger({ connection, collectionName: 'app_daily_ledger' }),
+ * });
+ */
+export declare function createMongoDailyLedger(options?: MongoDailyLedgerOptions): MongoDailyLedger;
 /** Adapter-construction options. */
-interface MongoLockAdapterOptions extends BaseLockAdapterOptions {
+export interface MongoLockAdapterOptions extends BaseLockAdapterOptions {
   /**
    * Mongoose connection. Defaults to `mongoose.connection` (the
    * default global connection) — most apps connect once via
@@ -15,6 +98,51 @@ interface MongoLockAdapterOptions extends BaseLockAdapterOptions {
   collectionName?: string;
   /** Override the Mongoose model name. Default `MongoLock`. */
   modelName?: string;
+  /**
+   * Clock for `tryAcquire` (expiry comparison + new expiry) and
+   * `inspect`. Inject one to drive lease expiry from tests or a host
+   * `Clock` port. Default `() => new Date()`.
+   *
+   * The collection's TTL index on `expiresAt` deletes by the server's
+   * real time, so in production `nowFn` must track wall-clock time: a
+   * clock running behind real time writes expiries the TTL monitor may
+   * already treat as past, and the lock can be swept (and taken by
+   * another holder) while still held. Skewed / frozen clocks are for
+   * tests only (use a far-future base there).
+   */
+  nowFn?: () => Date;
+}
+/**
+ * The outcome of {@link MongoLockAdapter.acquire}, read from the same atomic write that took (or
+ * did not take) the lock. Structurally the same as repo-core's optional `LockAdapter.acquire`
+ * result (`LockAcquisition`), declared here so mongokit keeps its repo-core peer floor.
+ */
+export interface MongoLockAcquisition {
+  /** `true` when `holderId` holds the lock after this call (fresh, takeover or renewal). */
+  acquired: boolean;
+  /** The holder after this call: the caller when acquired, else the live holder that kept it. */
+  holder: string;
+  /**
+   * The holder recorded on the row BEFORE this write, when there was one: the caller itself on a
+   * renewal, another holder on a takeover of its lapsed lease. Absent when the lock was free
+   * (never taken, released, or swept by the TTL index). Only set when `acquired`.
+   */
+  previousHolder?: string;
+  /** Since when `holder` holds the lock (kept across its renewals). */
+  acquiredAt: Date;
+  /** When `holder`'s lease ends. */
+  expiresAt: Date;
+}
+/** The Mongo lock adapter: the repo-core contract, with `inspect` and `acquire` always present. */
+export interface MongoLockAdapter extends LockAdapter {
+  /**
+   * Like `tryAcquire` (take a free or lapsed lock, or renew one's own), but answers WHO held it
+   * before and who holds it now, from the one atomic write: no `inspect` before or after, so no
+   * race window between reading the previous holder and taking the lock. A refused acquire writes
+   * nothing and reports the live holder.
+   */
+  acquire(name: string, holderId: string, leaseMs: number): Promise<MongoLockAcquisition>;
+  inspect(name: string): Promise<LockState | null>;
 }
 /**
  * Build a Mongo-backed lock adapter. Idempotent — the underlying
@@ -22,6 +150,5 @@ interface MongoLockAdapterOptions extends BaseLockAdapterOptions {
  * calling this multiple times with the same options shares the same
  * collection (no duplicate-model errors).
  */
-declare function createMongoLockAdapter(options?: MongoLockAdapterOptions): LockAdapter;
-//#endregion
-export { MongoLockAdapterOptions, createMongoLockAdapter };
+export declare function createMongoLockAdapter(options?: MongoLockAdapterOptions): MongoLockAdapter;
+export type { MongoDailyClaim, MongoDailyClaimInfo, MongoDailyLedger, MongoDailyLedgerOptions, MongoDailyLedgerRow };