@noy-db/hub 0.2.0-pre.17 → 0.2.0-pre.18

package/dist/i18n/index.d.cts

@@ -1,12 +1,12 @@
-import { I as I18nStrategy } from '../types-CrSpRDuG.cjs';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, e as I18nMap, f as I18nTextDescriptor, g as I18nTextOptions, L as Layer, O as OnMissing, h as OnMissingPolicy, R as ResolveI18nOptions, S as ScriptWarning, i as StaticDictDescriptor, j as applyI18nLocale, k as dictCollectionName, l as dictKey, m as enforceScript, n as getAtPath, o as i18nText, p as inferScripts, q as isDictCollectionName, r as isDictKeyDescriptor, s as isI18nTextDescriptor, t as isStaticDictDescriptor, u as resolveI18nText, v as resolvePolicy, w as setAtPathInPlace, x as staticDict, y as validateI18nTextValue } from '../types-CrSpRDuG.cjs';
-export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-Dz64FA65.cjs';
+import { I as I18nStrategy } from '../types-BpLPqyaO.cjs';
+export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, e as I18nMap, f as I18nTextDescriptor, g as I18nTextOptions, L as Layer, O as OnMissing, h as OnMissingPolicy, R as ResolveI18nOptions, S as ScriptWarning, i as StaticDictDescriptor, j as applyI18nLocale, k as dictCollectionName, l as dictKey, m as enforceScript, n as getAtPath, o as i18nText, p as inferScripts, q as isDictCollectionName, r as isDictKeyDescriptor, s as isI18nTextDescriptor, t as isStaticDictDescriptor, u as resolveI18nText, v as resolvePolicy, w as setAtPathInPlace, x as staticDict, y as validateI18nTextValue } from '../types-BpLPqyaO.cjs';
+export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-DUTlAt3Y.cjs';
 import '../lazy-builder-eYZzLEL1.cjs';
 import '../predicate-BmhBSPCH.cjs';
-import '../strategy-CLC1j79g.cjs';
+import '../strategy-nuyN8K5N.cjs';
 import '../strategy-BSxFXGzb.cjs';
 import '../index-C-SSRIxP.cjs';
-import '../index-u-kWzSrL.cjs';
+import '../index-C6lgoUhK.cjs';
 import '@noy-db/attestation';
 
 /**

package/dist/i18n/index.d.ts

@@ -1,12 +1,12 @@
-import { I as I18nStrategy } from '../types-CljIHm_J.js';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, e as I18nMap, f as I18nTextDescriptor, g as I18nTextOptions, L as Layer, O as OnMissing, h as OnMissingPolicy, R as ResolveI18nOptions, S as ScriptWarning, i as StaticDictDescriptor, j as applyI18nLocale, k as dictCollectionName, l as dictKey, m as enforceScript, n as getAtPath, o as i18nText, p as inferScripts, q as isDictCollectionName, r as isDictKeyDescriptor, s as isI18nTextDescriptor, t as isStaticDictDescriptor, u as resolveI18nText, v as resolvePolicy, w as setAtPathInPlace, x as staticDict, y as validateI18nTextValue } from '../types-CljIHm_J.js';
-export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-Dz64FA65.js';
+import { I as I18nStrategy } from '../types-Diqc2caK.js';
+export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, e as I18nMap, f as I18nTextDescriptor, g as I18nTextOptions, L as Layer, O as OnMissing, h as OnMissingPolicy, R as ResolveI18nOptions, S as ScriptWarning, i as StaticDictDescriptor, j as applyI18nLocale, k as dictCollectionName, l as dictKey, m as enforceScript, n as getAtPath, o as i18nText, p as inferScripts, q as isDictCollectionName, r as isDictKeyDescriptor, s as isI18nTextDescriptor, t as isStaticDictDescriptor, u as resolveI18nText, v as resolvePolicy, w as setAtPathInPlace, x as staticDict, y as validateI18nTextValue } from '../types-Diqc2caK.js';
+export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-DUTlAt3Y.js';
 import '../lazy-builder-ChSqcF5t.js';
 import '../predicate-BmhBSPCH.js';
-import '../strategy-4M9jo172.js';
+import '../strategy-Diwh5lzS.js';
 import '../strategy-BSxFXGzb.js';
 import '../index-C-SSRIxP.js';
-import '../index-DpU6KWof.js';
+import '../index-DP1JTWHZ.js';
 import '@noy-db/attestation';
 
 /**

package/dist/i18n/index.js

@@ -1,7 +1,7 @@
 import {
   enforceScript,
   inferScripts
-} from "../chunk-JDWE6JMX.js";
+} from "../chunk-M3H7VSRV.js";
 import {
   DICT_COLLECTION_PREFIX,
   DictionaryHandle,
@@ -19,11 +19,11 @@ import {
   setAtPathInPlace,
   staticDict,
   validateI18nTextValue
-} from "../chunk-ROPJVUG3.js";
-import "../chunk-BSZOCSDZ.js";
+} from "../chunk-KOURQXIU.js";
+import "../chunk-FQRAYDS4.js";
 import "../chunk-PDVP3C2I.js";
-import "../chunk-SISBMAPO.js";
-import "../chunk-UNTGHX5A.js";
+import "../chunk-LGPSCKWZ.js";
+import "../chunk-QJKZ5WUP.js";
 import {
   DictKeyInUseError,
   DictKeyMissingError,
@@ -34,7 +34,7 @@ import {
   StaticDictReadonlyError,
   TranslatorNotConfiguredError,
   UnknownDictCodeError
-} from "../chunk-ZEGSDPB7.js";
+} from "../chunk-HMFC6M2G.js";
 
 // src/i18n/active.ts
 function withI18n() {

package/dist/{index-u-kWzSrL.d.cts → index-C6lgoUhK.d.cts}

@@ -1,6 +1,6 @@
 import { C as CollectionIndexes, a as Clause, O as Operator } from './predicate-BmhBSPCH.cjs';
-import { N as NoydbError } from './errors-Dz64FA65.cjs';
-import { v as MoneyDescriptor, A as AggregateStrategy, b as AggregateSpec, c as Aggregation, a as AggregateResult, g as GroupedQuery, h as GroupedQueryN } from './strategy-CLC1j79g.cjs';
+import { N as NoydbError } from './errors-DUTlAt3Y.cjs';
+import { v as MoneyDescriptor, A as AggregateStrategy, b as AggregateSpec, c as Aggregation, a as AggregateResult, g as GroupedQuery, h as GroupedQueryN } from './strategy-nuyN8K5N.cjs';
 
 /**
  * Foreign-key references — the soft-FK mechanism.
@@ -59,7 +59,19 @@ type RefMode = 'strict' | 'warn' | 'cascade';
 interface RefDescriptor {
     readonly target: string;
     readonly mode: RefMode;
+    /**
+     * Present and `true` only for an array ref (#377-A, `refArray()`): the
+     * field holds an ARRAY of ids, each validated against `target`
+     * independently (M:N). Absent for a scalar `ref()`. The same `mode`
+     * semantics apply per element — strict rejects on a missing element at
+     * put + blocks delete of a referenced target; cascade deletes every
+     * record whose array contains the deleted id; warn surfaces orphans
+     * only via `checkIntegrity()`.
+     */
+    readonly isArray?: true;
 }
+/** Runtime predicate: is this an array ref (`refArray()`) vs a scalar `ref()`? */
+declare function isRefArray(desc: RefDescriptor): boolean;
 /**
  * Thrown when a strict reference is violated — either `put()` with a
  * missing target id, or `delete()` of a target that still has
@@ -102,6 +114,30 @@ declare class RefScopeError extends NoydbError {
  * fails at collection construction time, not at the first put.
  */
 declare function ref(target: string, mode?: RefMode): RefDescriptor;
+/**
+ * Array reference (#377-A) — the many-to-many soft-FK. The field holds an
+ * array of ids; each element is validated against `target` independently.
+ *
+ * ```ts
+ * const orders = company.collection<Order>('orders', {
+ *   refs: { productIds: refArray('products', 'warn') },
+ * })
+ * ```
+ *
+ * Same three `mode` semantics as `ref()`, applied per element:
+ *   - **strict** — `put()` rejects if ANY element's target is missing;
+ *     `delete()` of a target is blocked while any record's array still
+ *     contains its id.
+ *   - **warn** — both succeed; orphaned elements surface via
+ *     `vault.checkIntegrity()` (one violation per dangling element).
+ *   - **cascade** — `delete()` of a target deletes every record whose
+ *     array contains its id (cycle-safe, like scalar cascade).
+ *
+ * A `null`/`undefined` field is allowed (no links). Non-array values, or
+ * non-string/number elements, are an integrity error. Cross-vault targets
+ * are rejected exactly as in `ref()`.
+ */
+declare function refArray(target: string, mode?: RefMode): RefDescriptor;
 /**
  * Per-vault registry of reference declarations.
  *
@@ -144,6 +180,7 @@ declare class RefRegistry {
         collection: string;
         field: string;
         mode: RefMode;
+        isArray?: true;
     }>;
     /**
      * Iterate every (collection → refs) pair that has at least one
@@ -1229,4 +1266,4 @@ declare class ScanBuilder<T> implements AsyncIterable<T> {
     private recordMatches;
 }
 
-export { DEFAULT_CROSS_JOIN_MAX_ROWS as D, type JoinContext as J, type LiveQuery as L, type OrderBy as O, Query as Q, type RefDescriptor as R, ScanBuilder as S, DEFAULT_JOIN_MAX_ROWS as a, type JoinLeg as b, type JoinStrategy as c, type JoinableSource as d, type LiveUpstream as e, type QueryPlan as f, type QuerySource as g, RefIntegrityError as h, type RefMode as i, RefRegistry as j, RefScopeError as k, type RefViolation as l, type ScanPageProvider as m, applyJoins as n, buildLiveQuery as o, executePlan as p, resetJoinWarnings as q, ref as r };
+export { DEFAULT_CROSS_JOIN_MAX_ROWS as D, type JoinContext as J, type LiveQuery as L, type OrderBy as O, Query as Q, type RefDescriptor as R, ScanBuilder as S, DEFAULT_JOIN_MAX_ROWS as a, type JoinLeg as b, type JoinStrategy as c, type JoinableSource as d, type LiveUpstream as e, type QueryPlan as f, type QuerySource as g, RefIntegrityError as h, type RefMode as i, RefRegistry as j, RefScopeError as k, type RefViolation as l, type ScanPageProvider as m, applyJoins as n, buildLiveQuery as o, executePlan as p, isRefArray as q, ref as r, refArray as s, resetJoinWarnings as t };

package/dist/{index-DpU6KWof.d.ts → index-DP1JTWHZ.d.ts}

@@ -1,6 +1,6 @@
 import { C as CollectionIndexes, a as Clause, O as Operator } from './predicate-BmhBSPCH.js';
-import { N as NoydbError } from './errors-Dz64FA65.js';
-import { v as MoneyDescriptor, A as AggregateStrategy, b as AggregateSpec, c as Aggregation, a as AggregateResult, g as GroupedQuery, h as GroupedQueryN } from './strategy-4M9jo172.js';
+import { N as NoydbError } from './errors-DUTlAt3Y.js';
+import { v as MoneyDescriptor, A as AggregateStrategy, b as AggregateSpec, c as Aggregation, a as AggregateResult, g as GroupedQuery, h as GroupedQueryN } from './strategy-Diwh5lzS.js';
 
 /**
  * Foreign-key references — the soft-FK mechanism.
@@ -59,7 +59,19 @@ type RefMode = 'strict' | 'warn' | 'cascade';
 interface RefDescriptor {
     readonly target: string;
     readonly mode: RefMode;
+    /**
+     * Present and `true` only for an array ref (#377-A, `refArray()`): the
+     * field holds an ARRAY of ids, each validated against `target`
+     * independently (M:N). Absent for a scalar `ref()`. The same `mode`
+     * semantics apply per element — strict rejects on a missing element at
+     * put + blocks delete of a referenced target; cascade deletes every
+     * record whose array contains the deleted id; warn surfaces orphans
+     * only via `checkIntegrity()`.
+     */
+    readonly isArray?: true;
 }
+/** Runtime predicate: is this an array ref (`refArray()`) vs a scalar `ref()`? */
+declare function isRefArray(desc: RefDescriptor): boolean;
 /**
  * Thrown when a strict reference is violated — either `put()` with a
  * missing target id, or `delete()` of a target that still has
@@ -102,6 +114,30 @@ declare class RefScopeError extends NoydbError {
  * fails at collection construction time, not at the first put.
  */
 declare function ref(target: string, mode?: RefMode): RefDescriptor;
+/**
+ * Array reference (#377-A) — the many-to-many soft-FK. The field holds an
+ * array of ids; each element is validated against `target` independently.
+ *
+ * ```ts
+ * const orders = company.collection<Order>('orders', {
+ *   refs: { productIds: refArray('products', 'warn') },
+ * })
+ * ```
+ *
+ * Same three `mode` semantics as `ref()`, applied per element:
+ *   - **strict** — `put()` rejects if ANY element's target is missing;
+ *     `delete()` of a target is blocked while any record's array still
+ *     contains its id.
+ *   - **warn** — both succeed; orphaned elements surface via
+ *     `vault.checkIntegrity()` (one violation per dangling element).
+ *   - **cascade** — `delete()` of a target deletes every record whose
+ *     array contains its id (cycle-safe, like scalar cascade).
+ *
+ * A `null`/`undefined` field is allowed (no links). Non-array values, or
+ * non-string/number elements, are an integrity error. Cross-vault targets
+ * are rejected exactly as in `ref()`.
+ */
+declare function refArray(target: string, mode?: RefMode): RefDescriptor;
 /**
  * Per-vault registry of reference declarations.
  *
@@ -144,6 +180,7 @@ declare class RefRegistry {
         collection: string;
         field: string;
         mode: RefMode;
+        isArray?: true;
     }>;
     /**
      * Iterate every (collection → refs) pair that has at least one
@@ -1229,4 +1266,4 @@ declare class ScanBuilder<T> implements AsyncIterable<T> {
     private recordMatches;
 }
 
-export { DEFAULT_CROSS_JOIN_MAX_ROWS as D, type JoinContext as J, type LiveQuery as L, type OrderBy as O, Query as Q, type RefDescriptor as R, ScanBuilder as S, DEFAULT_JOIN_MAX_ROWS as a, type JoinLeg as b, type JoinStrategy as c, type JoinableSource as d, type LiveUpstream as e, type QueryPlan as f, type QuerySource as g, RefIntegrityError as h, type RefMode as i, RefRegistry as j, RefScopeError as k, type RefViolation as l, type ScanPageProvider as m, applyJoins as n, buildLiveQuery as o, executePlan as p, resetJoinWarnings as q, ref as r };
+export { DEFAULT_CROSS_JOIN_MAX_ROWS as D, type JoinContext as J, type LiveQuery as L, type OrderBy as O, Query as Q, type RefDescriptor as R, ScanBuilder as S, DEFAULT_JOIN_MAX_ROWS as a, type JoinLeg as b, type JoinStrategy as c, type JoinableSource as d, type LiveUpstream as e, type QueryPlan as f, type QuerySource as g, RefIntegrityError as h, type RefMode as i, RefRegistry as j, RefScopeError as k, type RefViolation as l, type ScanPageProvider as m, applyJoins as n, buildLiveQuery as o, executePlan as p, isRefArray as q, ref as r, refArray as s, resetJoinWarnings as t };