@noy-db/hub 0.4.0-pre.3 → 0.4.0-pre.4

package/dist/port/with/strategies.d.ts

@@ -0,0 +1,134 @@
+/**
+ * The strategy bag (#838) — one resolved, immutable record of every opt-in
+ * service, built once in `createNoydb` and carried by reference down the
+ * spine: `Noydb` → `Vault` → `Collection`.
+ *
+ * ## Why this exists
+ *
+ * Threading one service through the spine used to cost ~10 mechanical edits
+ * with no logic in any of them: a field on `NoydbOptions`, a conditional
+ * spread at the `new Vault(` site, a field declaration + constructor
+ * parameter + constructor assignment on `Vault`, a forwarding spread into
+ * the collection options, a field + `?? NO_*` default in
+ * `collection-config.ts`, and a field + assignment on `Collection`. Nothing
+ * checked that a new service reached every layer, which is exactly how #834
+ * happened — one of three copies of the Vault option block had silently
+ * dropped six strategies, and a vault reached that way threw
+ * `*NotEnabledError` for services the caller had actually configured.
+ *
+ * Here the layers hold ONE field. Adding a service is a row in
+ * {@link StrategyBag} plus a row in {@link STRATEGY_DEFAULTS} — both in this
+ * file, and omitting either is a compile error rather than a bug that only
+ * shows up through one construction path.
+ *
+ * ## Every key always resolves
+ *
+ * There is no `undefined` in the bag. An un-opted-in service resolves to its
+ * `NO_*` stub, which is the tree-shake seam: the stubs are deliberately tiny
+ * modules on the `/with` port that the spine may import statically, while the
+ * real implementation arrives only when the consumer imports the service's
+ * subpath. Holding a stub costs a few hundred bytes; it does not pull the
+ * machinery in.
+ *
+ * Two services needed adjusting to fit that rule, both recorded here because
+ * the reasons are not obvious:
+ *
+ *  - `archive` had no stub at all and was held as `ArchiveStrategy |
+ *    undefined` behind a hand-rolled null gate. {@link NO_ARCHIVE} now stands
+ *    in and throws on `.store` access — see `port/with/archive-strategy.ts`.
+ *  - `lazy`'s floor is {@link IMPLICIT_LAZY}, not a no-op: an un-opted-in
+ *    collection still gets a working LRU, it just warns. So its default row
+ *    is a real strategy, which is why this table maps keys to defaults rather
+ *    than assuming a `NO_*` naming convention.
+ *
+ * `coordinationStrategy` is deliberately NOT in the bag. It is a
+ * `CoordinationProvider`, not a service strategy — it has no `with*()`
+ * factory, no `NO_*` stub, and is resolved asynchronously from the store
+ * (`createDefaultCoordinationProvider`) rather than passed through. The
+ * completeness assertion at the bottom of this file excludes it by name so
+ * that the exclusion is explicit and survives future edits.
+ *
+ * @internal
+ */
+import type { NoydbOptions } from '../../kernel/types.js';
+import { type AggregateStrategy } from '../../with-lookup/aggregate/strategy.js';
+import { type AttestationStrategy } from '../../with-audit/attestation/strategy.js';
+import { type BlobStrategy } from './blob-strategy.js';
+import { type BrokerStrategy } from './broker-strategy.js';
+import { type CargoStrategy } from '../../with-cargo/strategy.js';
+import { type ClassifiedStrategy } from './classified-strategy.js';
+import { type ConsentStrategy } from '../../with-audit/consent/strategy.js';
+import { type CrdtStrategy } from '../../with-commit/crdt/strategy.js';
+import { type CustodyStrategy } from '../../with-party/custody/strategy.js';
+import { type ForgetStrategy } from '../../with-audit/forget/strategy.js';
+import { type HistoryStrategy } from '../../with-commit/history/strategy.js';
+import { type I18nStrategy } from './i18n-strategy.js';
+import { type IndexStrategy } from '../../with-lookup/indexing/strategy.js';
+import { type PeriodsStrategy } from '../../with-audit/periods/strategy.js';
+import { type PortabilityStrategy } from '../../with-audit/portability/strategy.js';
+import { type SealedRecordStrategy } from '../../with-audit/sealed-record/strategy.js';
+import { type SearchStrategy } from '../../with-lookup/search/strategy.js';
+import { type SequenceStrategy } from '../../with-commit/sequence/strategy.js';
+import { type SessionStrategy } from '../../with-party/session/strategy.js';
+import { type ShadowStrategy } from '../../with-fork/shadow/strategy.js';
+import { type SnapshotStrategy } from '../../with-fork/snapshots/strategy.js';
+import { type SyncStrategy } from '../../with-party/team/sync-strategy.js';
+import { type TeamStrategy } from './team-strategy.js';
+import { type TiersStrategy } from '../../with-audit/tiers/strategy.js';
+import { type TxStrategy } from '../../with-commit/tx/strategy.js';
+import { type LazyStrategy } from './lazy-strategy.js';
+import type { ArchiveStrategy } from '../../with-fork/archive/index.js';
+/**
+ * Every opt-in service, resolved. One field per service, never `undefined`.
+ *
+ * Keys drop the `Strategy` suffix the `createNoydb` option carries, so
+ * `searchStrategy: withSearch()` reads back as `strategies.search`. The
+ * completeness assertion below pins that correspondence.
+ */
+export interface StrategyBag {
+    readonly aggregate: AggregateStrategy;
+    readonly archive: ArchiveStrategy;
+    readonly attestation: AttestationStrategy;
+    readonly blob: BlobStrategy;
+    readonly broker: BrokerStrategy;
+    readonly cargo: CargoStrategy;
+    readonly classified: ClassifiedStrategy;
+    readonly consent: ConsentStrategy;
+    readonly crdt: CrdtStrategy;
+    readonly custody: CustodyStrategy;
+    readonly forget: ForgetStrategy;
+    readonly history: HistoryStrategy;
+    readonly i18n: I18nStrategy;
+    readonly index: IndexStrategy;
+    readonly lazy: LazyStrategy;
+    readonly periods: PeriodsStrategy;
+    readonly portability: PortabilityStrategy;
+    readonly sealedRecord: SealedRecordStrategy;
+    readonly search: SearchStrategy;
+    readonly sequence: SequenceStrategy;
+    readonly session: SessionStrategy;
+    readonly shadow: ShadowStrategy;
+    readonly snapshot: SnapshotStrategy;
+    readonly sync: SyncStrategy;
+    readonly team: TeamStrategy;
+    readonly tiers: TiersStrategy;
+    readonly tx: TxStrategy;
+}
+/** The name of every service in the bag. */
+export type StrategyKey = keyof StrategyBag;
+/**
+ * The un-opted-in floor: what each service resolves to when the caller passed
+ * no `with*()` factory. Annotating this `StrategyBag` is what makes a missing
+ * row a compile error.
+ */
+export declare const STRATEGY_DEFAULTS: StrategyBag;
+/**
+ * Build the bag from user options. Called ONCE, in `createNoydb` — every
+ * layer below shares the resulting reference.
+ *
+ * The two casts are the price of mapping `blob` ↔ `blobStrategy` in a loop
+ * instead of writing 27 hand-copied lines; the correspondence they assume is
+ * proven at compile time by the assertion below, so a typo cannot survive a
+ * build.
+ */
+export declare function resolveStrategies(options: NoydbOptions): StrategyBag;

package/dist/query/index.js

@@ -4,7 +4,7 @@ import {
   ScanBuilder,
   buildLiveQuery,
   executePlan
-} from "../chunk-GU5AYA2Q.js";
+} from "../chunk-4X6DJZHY.js";
 import {
   DEFAULT_JOIN_MAX_ROWS,
   applyJoins,

package/dist/team/index.js

@@ -23,7 +23,7 @@ import {
   unwrapMagicLinkGrant,
   updateAuthenticator,
   writeMagicLinkGrant
-} from "../chunk-UBF7HTOR.js";
+} from "../chunk-QUIG6BZT.js";
 import {
   SYNC_CREDENTIALS_COLLECTION,
   buildRecipientKeyringFile,

package/dist/tiers/index.js

@@ -11,7 +11,7 @@ import {
   putAtTier,
   syncDerivedOutputs,
   withTiers
-} from "../chunk-N4A3DCBT.js";
+} from "../chunk-5KI3REO3.js";
 import "../chunk-MSO2C3KG.js";
 import "../chunk-PEY6ZTCF.js";
 import "../chunk-QXPOEAKR.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noy-db/hub",
-  "version": "0.4.0-pre.3",
+  "version": "0.4.0-pre.4",
   "description": "Zero-knowledge, offline-first, encrypted document store — core library with AES-256-GCM, PBKDF2, multi-user keyring, and sync engine",
   "license": "MIT",
   "author": "vLannaAi <vicio@lanna.ai>",
@@ -192,14 +192,14 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@noy-db/attestation": "0.4.0-pre.3"
+    "@noy-db/attestation": "0.4.0-pre.4"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "esbuild": "^0.25.0",
     "zod": "^4.0.0",
     "zod-to-json-schema": "^3.25.2",
-    "@noy-db/on-shamir": "0.4.0-pre.3"
+    "@noy-db/on-shamir": "0.4.0-pre.4"
   },
   "peerDependencies": {
     "zod-to-json-schema": "^3.25.0"