@noy-db/hub 0.4.0-pre.1 → 0.4.0-pre.11

package/dist/with-lookup/{aggregate → reduce}/groupby.d.ts

@@ -58,7 +58,7 @@
  * groupBy doesn't need its own seam for the moment, because it
  * delegates to the reducer protocol for all per-bucket state.
  */
-import type { AggregateSpec, AggregateResult, AggregationUpstream, LiveAggregation } from './aggregation.js';
+import type { ReduceSpec, ReduceResult, ReductionUpstream, LiveReduction } from './reduction.js';
 import type { ReducerBuilder } from './reducers.js';
 import type { MoneyDescriptor } from '../../via/money/descriptor.js';
 import type { ViaPipeline } from '../../kernel/via/pipeline.js';
@@ -78,7 +78,7 @@ export declare const GROUPBY_MAX_CARDINALITY = 100000;
  */
 export declare function resetGroupByWarnings(): void;
 /**
- * Result row shape for a grouped aggregation. Each row carries the
+ * Result row shape for a grouped reduction. Each row carries the
  * group key value under the grouping field name plus every reducer
  * output from the spec.
  *
@@ -116,7 +116,7 @@ export type GroupedRowN<F extends readonly string[], R> = {
  */
 declare abstract class GroupedQueryBase {
     protected readonly executeRecords: () => readonly unknown[];
-    protected readonly upstreams: readonly AggregationUpstream[];
+    protected readonly upstreams: readonly ReductionUpstream[];
     /**
      * Optional dict label resolver attached by the query builder when
      * the grouping field is a dictKey. Variadic groupings always pass
@@ -137,7 +137,7 @@ declare abstract class GroupedQueryBase {
      * `[field]`.
      */
     protected readonly fields: readonly string[];
-    constructor(executeRecords: () => readonly unknown[], fieldOrFields: string | readonly string[], upstreams: readonly AggregationUpstream[], 
+    constructor(executeRecords: () => readonly unknown[], fieldOrFields: string | readonly string[], upstreams: readonly ReductionUpstream[], 
     /**
      * Optional dict label resolver attached by the query builder when
      * the grouping field is a dictKey. Variadic groupings always pass
@@ -152,21 +152,21 @@ declare abstract class GroupedQueryBase {
      */
     via?: ViaPipeline | undefined);
     /** Apply Via-aware reducer rewriting (e.g. money) when the source declares one. */
-    protected wrapSpec<Spec extends AggregateSpec>(spec: Spec): Spec;
+    protected wrapSpec<Spec extends ReduceSpec>(spec: Spec): Spec;
 }
 /**
  * Chainable wrapper returned by `Query.groupBy(field)`. Terminates
- * with `.aggregate(spec)` which returns a `GroupedAggregation`.
+ * with `.aggregate(spec)` which returns a `GroupedReduction`.
  *
  * Kept minimal — the only operation on a grouped query is
- * aggregation. Ordering, limiting, and further filtering belong on
+ * reduction. Ordering, limiting, and further filtering belong on
  * the underlying `Query` before `.groupBy()` is called; applying
  * them post-group would be a different operation (`having` /
  * `groupOrderBy`), out of scope for.
  */
 export declare class GroupedQuery<T, F extends string, S extends keyof T = never, M extends keyof T & string = never> extends GroupedQueryBase {
     /**
-     * Build a grouped aggregation. Returns a `GroupedAggregation`
+     * Build a grouped reduction. Returns a `GroupedReduction`
      * with `.run()`, `.runAsync()`, and `.live()` terminals — same shape
      * as the non-grouped `.aggregate()` wrapper, just with an array
      * result (one row per bucket) instead of a single reduced object.
@@ -178,8 +178,8 @@ export declare class GroupedQuery<T, F extends string, S extends keyof T = never
      * declared `moneyFields` (`M`) member return a `MoneyString`. The
      * bare-spec overload is preserved for backward compatibility.
      */
-    aggregate<Spec extends AggregateSpec>(spec: Spec): GroupedAggregation<GroupedRow<F, AggregateResult<Spec>>>;
-    aggregate<Spec extends AggregateSpec>(build: (b: ReducerBuilder<T, S, M>) => Spec): GroupedAggregation<GroupedRow<F, AggregateResult<Spec>>>;
+    aggregate<Spec extends ReduceSpec>(spec: Spec): GroupedReduction<GroupedRow<F, ReduceResult<Spec>>>;
+    aggregate<Spec extends ReduceSpec>(build: (b: ReducerBuilder<T, S, M>) => Spec): GroupedReduction<GroupedRow<F, ReduceResult<Spec>>>;
 }
 /**
  * Variadic-keyed sibling of `GroupedQuery<T, F>`. Constructed by the
@@ -187,12 +187,12 @@ export declare class GroupedQuery<T, F extends string, S extends keyof T = never
  * identical — only the type-level result-row narrowing differs.
  */
 export declare class GroupedQueryN<T, F extends readonly string[], S extends keyof T = never, M extends keyof T & string = never> extends GroupedQueryBase {
-    aggregate<Spec extends AggregateSpec>(spec: Spec): GroupedAggregation<GroupedRowN<F, AggregateResult<Spec>>>;
-    aggregate<Spec extends AggregateSpec>(build: (b: ReducerBuilder<T, S, M>) => Spec): GroupedAggregation<GroupedRowN<F, AggregateResult<Spec>>>;
+    aggregate<Spec extends ReduceSpec>(spec: Spec): GroupedReduction<GroupedRowN<F, ReduceResult<Spec>>>;
+    aggregate<Spec extends ReduceSpec>(build: (b: ReducerBuilder<T, S, M>) => Spec): GroupedReduction<GroupedRowN<F, ReduceResult<Spec>>>;
 }
 /**
  * Execute the group-and-reduce pipeline. Pure function over a
- * record array and a spec — shared by `GroupedAggregation.run()`
+ * record array and a spec — shared by `GroupedReduction.run()`
  * and the live-mode refresh path. Exported for tests and for any
  * future `scan().groupBy().aggregate()` reuse.
  *
@@ -201,10 +201,10 @@ export declare class GroupedQueryN<T, F extends readonly string[], S extends key
  * bucket would be created — the consumer doesn't have to wait for
  * the full partition to materialize before the error fires.
  */
-export declare function groupAndReduce<R>(records: readonly unknown[], fieldOrFields: string | readonly string[], spec: AggregateSpec, moneyFields?: Record<string, MoneyDescriptor>): R[];
+export declare function groupAndReduce<R>(records: readonly unknown[], fieldOrFields: string | readonly string[], spec: ReduceSpec, moneyFields?: Record<string, MoneyDescriptor>): R[];
 /**
- * Grouped aggregation wrapper — the `.groupBy(field).aggregate(spec)`
- * terminal. Shape mirrors `Aggregation<R>` from aggregate.ts: two
+ * Grouped reduction wrapper — the `.groupBy(field).aggregate(spec)`
+ * terminal. Shape mirrors `Reduction<R>` from aggregate.ts: two
  * terminals (`.run()` and `.live()`), spec bound at construction
  * time, upstreams collected for live mode.
  *
@@ -212,7 +212,7 @@ export declare function groupAndReduce<R>(records: readonly unknown[], fieldOrFi
  * grouped row), and the terminals return `R[]` — one row per
  * bucket.
  */
-export declare class GroupedAggregation<R> {
+export declare class GroupedReduction<R> {
     private readonly executeRecords;
     private readonly spec;
     private readonly upstreams;
@@ -222,7 +222,7 @@ export declare class GroupedAggregation<R> {
      */
     private readonly dictLabelResolver?;
     private readonly fields;
-    constructor(executeRecords: () => readonly unknown[], fields: string | readonly string[], spec: AggregateSpec, upstreams: readonly AggregationUpstream[], 
+    constructor(executeRecords: () => readonly unknown[], fields: string | readonly string[], spec: ReduceSpec, upstreams: readonly ReductionUpstream[], 
     /**
      * Optional dict label resolver for `<field>Label` projection
      *. Present when the grouping field is a dictKey.
@@ -260,10 +260,10 @@ export declare class GroupedAggregation<R> {
         fallback?: string | readonly string[];
     }): Promise<R[]>;
     /**
-     * Build a reactive `LiveAggregation<R[]>` that re-runs the full
+     * Build a reactive `LiveReduction<R[]>` that re-runs the full
      * group-and-reduce pipeline whenever any upstream source notifies
      * of a change. Same error-isolation and idempotent-stop contract
-     * as `Aggregation.live()` — the implementation delegates to the
+     * as `Reduction.live()` — the implementation delegates to the
      * same `LiveAggregationImpl` class by threading a fresh
      * recompute closure through the existing constructor.
      *
@@ -275,6 +275,6 @@ export declare class GroupedAggregation<R> {
      *
      * Always call `live.stop()` when finished.
      */
-    live(): LiveAggregation<R[]>;
+    live(): LiveReduction<R[]>;
 }
 export {};

package/dist/with-lookup/reduce/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @noy-db/hub/reduce — opt-in reduction + groupBy service.
+ *
+ * @category capability
+ *
+ * Groups every file whose reason-for-existing is record reduction:
+ *   - `reduction` (`Reduction<R>`, `reduceRecords`, `buildLiveReduction`)
+ *   - `groupby` (`GroupedQuery`, `GroupedReduction`, cardinality guards)
+ *   - `reducers` (`count`, `sum`, `avg`, `min`, `max` factories)
+ *
+ * The root barrel (`@noy-db/hub`) and the `@noy-db/hub/query` subpath
+ * continue to re-export the same symbols for backward compatibility
+ * with consumers written before the relocation. New code should
+ * prefer this subpath.
+ */
+export { withReduce } from './active.js';
+export type { ReduceStrategy } from './strategy.js';
+export { Reduction, reduceRecords, buildLiveReduction } from './reduction.js';
+export type { ReduceSpec, ReduceResult, ReductionUpstream, LiveReduction, } from './reduction.js';
+export { GroupedQuery, GroupedQueryN, GroupedReduction, groupAndReduce, resetGroupByWarnings, GROUPBY_WARN_CARDINALITY, GROUPBY_MAX_CARDINALITY, } from './groupby.js';
+export type { GroupedRow, GroupedRowN } from './groupby.js';
+export { count, sum, avg, min, max, moneySum, moneyMin, moneyMax, reducerBuilder } from './reducers.js';
+export type { Reducer, ReducerOptions, ReducerBuilder } from './reducers.js';
+/** The un-opted-in stub for this service — exported so callers can compare against it (#844). */
+export { NO_REDUCE } from './strategy.js';
+/**
+ * Types named by this entry's own signatures (#843a). `min`/`max` return a
+ * `MinMaxState`, and the money reducers speak `MoneyString`; both must be
+ * nameable from the entry that exports the functions, or a caller can invoke
+ * them and cannot annotate the result.
+ */
+export type { MinMaxState } from './reducers.js';
+export type { MoneyString } from '../../via/money/branded.js';
+export type { MoneyDescriptor } from '../../via/money/descriptor.js';

package/dist/with-lookup/{aggregate → reduce}/reducers.d.ts

@@ -1,12 +1,12 @@
 /**
- * Aggregation reducers for the query DSL.
+ * Reduction reducers for the query DSL.
  *
  * the reducer protocol plus five built-in factories
  * (`count`, `sum`, `avg`, `min`, `max`) consumed by `Query.aggregate()`
  * and, in the future, `Scan.aggregate()`. Every factory accepts
  * an optional `{ seed }` parameter that is plumbed through the
  * protocol but unused by the executor — that's the load-bearing
- * half of  constraint #2. When partition-aware aggregation
+ * half of  constraint #2. When partition-aware reduction
  * lands, the seed carries the previous partition's running total into
  * the next partition without requiring a protocol change.
  *
@@ -19,7 +19,7 @@
  * Reducers are pure data — `init` / `step` / `finalize` / optional
  * `remove` are stateless functions that receive and return `S`. This
  * is the shape that admits O(1) incremental maintenance in a future
- * optimization (delta-aware `LiveAggregation` applies `step` or
+ * optimization (delta-aware `LiveReduction` applies `step` or
  * `remove` per delta), without blocking the simpler "full re-run on
  * source change" that ships.
  */
@@ -30,19 +30,19 @@ import type { QueryField } from '../../kernel/types.js';
  * `.aggregate()` spec.
  *
  * Type parameters:
- *   - `R` — user-visible result type (what the aggregation returns
+ *   - `R` — user-visible result type (what the reduction returns
  *     for this slot, e.g. `number` for `sum()`)
  *   - `S` — internal state type, defaults to `R` for simple reducers
  *     that don't need compound bookkeeping
  *
  * A reducer is stateless: every method is pure over `S`. `init()` is
- * called once per aggregation run to build the initial state; `step()`
+ * called once per reduction run to build the initial state; `step()`
  * folds a record into the state; `remove()` (optional) un-folds a
  * record, enabling incremental live maintenance; `finalize()` reads
  * the final answer out of the state at the end of the run.
  */
 export interface Reducer<R, S = R> {
-    /** Build the initial state for a fresh aggregation run. */
+    /** Build the initial state for a fresh reduction run. */
     init(): S;
     /** Fold a record into the state. Returns the new state. */
     step(state: S, record: unknown): S;
@@ -63,7 +63,7 @@ export interface Reducer<R, S = R> {
      * Combine two independent partial states into one (then `finalize` once).
      * Optional. MUST be associative + commutative with `init()` as identity.
      * Never merge finalized results — only states. Enables parallel /
-     * hierarchical aggregation (e.g. cross-shard or advisor→firm rollup).
+     * hierarchical reduction (e.g. cross-shard or advisor→firm rollup).
      */
     merge?(a: S, b: S): S;
     /**
@@ -94,10 +94,10 @@ export interface Reducer<R, S = R> {
  *
  * `seed` — optional initial value for the internal state. **Unused by
  * the executor**, plumbed through the protocol for  constraint
- * #2 (partition-aware aggregation seam). In, partitioned
- * aggregations will pass the previous partition's carry as `seed` so
+ * #2 (partition-aware reduction seam). In, partitioned
+ * reductions will pass the previous partition's carry as `seed` so
  * a long time series can be rolled forward one partition at a time
- * without re-aggregating closed partitions.
+ * without re-reducing closed partitions.
  *
  * always uses `init()` with the factory's zero value, regardless
  * of whether `seed` was passed. Do not remove the parameter — that's
@@ -156,7 +156,7 @@ export declare function avg(field: string, opts?: ReducerOptions<{
     sum: number;
     count: number;
 }>;
-interface MinMaxState {
+export interface MinMaxState {
     /**
      * Multiset of contributing field values. Stored as a plain array
      * because we need to support `remove` and a plain array gives us
@@ -254,4 +254,3 @@ export interface ReducerBuilder<T, S extends keyof T = never, M extends keyof T
  * parameter-contravariance, so this single instance works for all `T`/`S`.
  */
 export declare const reducerBuilder: ReducerBuilder<Record<string, unknown>>;
-export {};

package/dist/with-lookup/{aggregate/aggregation.d.ts → reduce/reduction.d.ts}

@@ -1,13 +1,13 @@
 /**
  * Aggregate execution — the runtime behind `Query.aggregate()`.
  *
- * takes an `AggregateSpec` (a record of named reducers
+ * takes an `ReduceSpec` (a record of named reducers
  * built from `reducers.ts`) and runs every reducer over the records
  * produced by the underlying query. Two terminal surfaces:
  *
  *   - `.run(): R` — synchronous one-shot reduction. Matches the
  *     existing `Query.toArray()` / `.first()` / `.count()` style.
- *   - `.live(): LiveAggregation<R>` — reactive primitive that
+ *   - `.live(): LiveReduction<R>` — reactive primitive that
  *     re-runs the reduction whenever the query's source notifies of
  *     a change. uses naive full re-run; incremental delta
  *     maintenance is admitted by the reducer protocol (`remove()`)
@@ -15,7 +15,7 @@
  *     can switch from full re-run to delta-based without breaking
  *     the public API. Consumers get correct, reactive values today.
  *
- * The `Aggregation<R>` wrapper is deliberately tiny — it exists so
+ * The `Reduction<R>` wrapper is deliberately tiny — it exists so
  * `.aggregate(spec)` can be chained with either `.run()` or `.live()`
  * without the builder needing two separate terminal methods. It
  * holds the closure over the query execution (produces the current
@@ -39,9 +39,9 @@ import type { Reducer } from './reducers.js';
  * }
  * ```
  */
-export type AggregateSpec = Readonly<Record<string, Reducer<unknown, unknown>>>;
+export type ReduceSpec = Readonly<Record<string, Reducer<unknown, unknown>>>;
 /**
- * Map an `AggregateSpec` to its reduced result shape — each key
+ * Map an `ReduceSpec` to its reduced result shape — each key
  * carries the finalized result type from its reducer. A spec built
  * from `{ total: sum('amount'), n: count() }` yields a result of
  * `{ total: number, n: number }`.
@@ -50,26 +50,26 @@ export type AggregateSpec = Readonly<Record<string, Reducer<unknown, unknown>>>;
  * each `Reducer<R, _>`. The `infer` captures the user-visible result
  * type, discarding the internal state type `S`.
  */
-export type AggregateResult<Spec extends AggregateSpec> = {
+export type ReduceResult<Spec extends ReduceSpec> = {
     [K in keyof Spec]: Spec[K] extends Reducer<infer R, unknown> ? R : never;
 };
 /**
  * Pure reduction over a record array. Runs every reducer's
  * `init → step* → finalize` pipeline exactly once over the records.
  *
- * Called by `Aggregation.run()` and by the live-mode refresh path.
+ * Called by `Reduction.run()` and by the live-mode refresh path.
  * Exported for tests and for future `scan().aggregate()` reuse
  * — the streaming path will call the same reducer protocol with a
  * per-page loop instead of a single array.
  */
-export declare function reduceRecords<Spec extends AggregateSpec>(records: readonly unknown[], spec: Spec): AggregateResult<Spec>;
+export declare function reduceRecords<Spec extends ReduceSpec>(records: readonly unknown[], spec: Spec): ReduceResult<Spec>;
 /**
- * A minimal reactive primitive for aggregation results.
+ * A minimal reactive primitive for reduction results.
  *
  * Same spirit as the `LiveQuery` in : frame-agnostic, a plain
  * object with `value` / `error` fields and a `subscribe(cb)`
  * notification channel that Vue / React / Solid adapters wrap in
- * their own primitive. Intentionally NOT a Promise — aggregations
+ * their own primitive. Intentionally NOT a Promise — reductions
  * have a well-defined "current value" at every instant, and the
  * reactive consumer wants to read that value synchronously.
  *
@@ -86,7 +86,7 @@ export declare function reduceRecords<Spec extends AggregateSpec>(records: reado
  * Always call `stop()` when done; Vue's `onUnmounted` is the
  * canonical place. Raw consumers must do it themselves.
  */
-export interface LiveAggregation<R> {
+export interface LiveReduction<R> {
     /** Current reduced value. Undefined only if the first compute threw. */
     readonly value: R | undefined;
     /** Last execution error, if any. Cleared on the next successful run. */
@@ -97,14 +97,14 @@ export interface LiveAggregation<R> {
     stop(): void;
 }
 /**
- * Upstream change-notification hook for live aggregation.
+ * Upstream change-notification hook for live reduction.
  *
  * Matches the shape that `QuerySource.subscribe` already uses — a
  * single method that accepts a callback and returns an unsubscribe
- * function. The `Aggregation` wrapper collects upstreams from the
+ * function. The `Reduction` wrapper collects upstreams from the
  * query's source and wires them into a single re-run trigger.
  */
-export interface AggregationUpstream {
+export interface ReductionUpstream {
     subscribe(cb: () => void): () => void;
 }
 /**
@@ -120,14 +120,14 @@ export interface AggregationUpstream {
  * `.aggregate(spec).live()`. Wrapping lets the spec be named once
  * and reused for either terminal, and keeps the `Query` class
  * from growing a pair of near-duplicate method overloads
- * (`aggregateRun` / `aggregateLive`) that would be harder to
+ * (`reduceRun` / `reduceLive`) that would be harder to
  * discover.
  */
-export declare class Aggregation<R> {
+export declare class Reduction<R> {
     private readonly executeRecords;
     private readonly spec;
     private readonly upstreams;
-    constructor(executeRecords: () => readonly unknown[], spec: AggregateSpec, upstreams: readonly AggregationUpstream[]);
+    constructor(executeRecords: () => readonly unknown[], spec: ReduceSpec, upstreams: readonly ReductionUpstream[]);
     /**
      * Execute the query and reduce the results synchronously.
      * Returns the reduced shape matching the spec — e.g. a spec of
@@ -136,7 +136,7 @@ export declare class Aggregation<R> {
      */
     run(): R;
     /**
-     * Build a reactive `LiveAggregation<R>` that re-runs the reduction
+     * Build a reactive `LiveReduction<R>` that re-runs the reduction
      * whenever any upstream source notifies of a change. The initial
      * value is computed eagerly in the constructor, so consumers can
      * read `live.value` immediately after calling `.live()`.
@@ -153,14 +153,14 @@ export declare class Aggregation<R> {
      * correct, reactive values today; future PRs can switch to
      * delta-based maintenance without changing this API.
      */
-    live(): LiveAggregation<R>;
+    live(): LiveReduction<R>;
 }
 /**
- * Build a `LiveAggregation<V>` from a recompute closure and a list
+ * Build a `LiveReduction<V>` from a recompute closure and a list
  * of upstreams. Exposed so sibling files in the query DSL
  * (currently `groupby.ts`) can reuse the reactive primitive
  * without reaching into `LiveAggregationImpl` directly. This keeps
  * the implementation class private while still allowing planned
  * composition with `.groupBy().aggregate().live()`.
  */
-export declare function buildLiveAggregation<V>(recompute: () => V, upstreams: readonly AggregationUpstream[]): LiveAggregation<V>;
+export declare function buildLiveReduction<V>(recompute: () => V, upstreams: readonly ReductionUpstream[]): LiveReduction<V>;

package/dist/with-lookup/{aggregate → reduce}/strategy.d.ts

@@ -1,18 +1,18 @@
 /**
  * Strategy seam between the core Query / ScanBuilder chain and the
  * optional aggregate / groupBy service. Core imports
- * `AggregateStrategy` as a TYPE-ONLY symbol and `NO_AGGREGATE` as a
+ * `ReduceStrategy` as a TYPE-ONLY symbol and `NO_REDUCE` as a
  * tiny runtime stub.
  *
- * The heavy machinery — `Aggregation`, `GroupedQuery`, the
- * reducer-step logic — is only reachable from `withAggregate()` in
+ * The heavy machinery — `Reduction`, `GroupedQuery`, the
+ * reducer-step logic — is only reachable from `withReduce()` in
  * `./active.ts`, which is only exported through the
- * `@noy-db/hub/aggregate` subpath. Consumers that don't import the
+ * `@noy-db/hub/reduce` subpath. Consumers that don't import the
  * subpath ship none of the ~886 LOC.
  *
  * @internal
  */
-import type { Aggregation, AggregateSpec, AggregateResult, AggregationUpstream } from './aggregation.js';
+import type { Reduction, ReduceSpec, ReduceResult, ReductionUpstream } from './reduction.js';
 import type { GroupedQuery, GroupedQueryN } from './groupby.js';
 import type { ViaPipeline } from '../../kernel/via/pipeline.js';
 /**
@@ -21,39 +21,39 @@ import type { ViaPipeline } from '../../kernel/via/pipeline.js';
  *
  * @internal
  */
-export interface AggregateStrategy {
+export interface ReduceStrategy {
     /**
-     * Build an `Aggregation<R>` for `Query.aggregate(spec)`. `executeRecords`
+     * Build an `Reduction<R>` for `Query.aggregate(spec)`. `executeRecords`
      * is a closure that produces the matching record set when the
-     * aggregation runs. NO_AGGREGATE throws; the active strategy
-     * constructs a real `Aggregation`.
+     * reduction runs. NO_REDUCE throws; the active strategy
+     * constructs a real `Reduction`.
      */
-    aggregate<Spec extends AggregateSpec>(executeRecords: () => readonly unknown[], spec: Spec, upstreams: readonly AggregationUpstream[]): Aggregation<AggregateResult<Spec>>;
+    aggregate<Spec extends ReduceSpec>(executeRecords: () => readonly unknown[], spec: Spec, upstreams: readonly ReductionUpstream[]): Reduction<ReduceResult<Spec>>;
     /**
      * Build a `GroupedQuery<T, F, S>` for `Query.groupBy(field)`. Same
      * closure / upstream inputs as `aggregate` plus the group key field.
      */
-    groupBy<T, F extends string, S extends keyof T = never, M extends keyof T & string = never>(executeRecords: () => readonly unknown[], field: F, upstreams: readonly AggregationUpstream[], dictLabelResolver?: (key: string, locale: string, fallback?: string | readonly string[]) => Promise<string | undefined>, via?: ViaPipeline): GroupedQuery<T, F, S, M>;
+    groupBy<T, F extends string, S extends keyof T = never, M extends keyof T & string = never>(executeRecords: () => readonly unknown[], field: F, upstreams: readonly ReductionUpstream[], dictLabelResolver?: (key: string, locale: string, fallback?: string | readonly string[]) => Promise<string | undefined>, via?: ViaPipeline): GroupedQuery<T, F, S, M>;
     /**
      * Variadic-keyed sibling — builds a `GroupedQueryN<T, F, S>` for
      * `Query.groupBy(...fields)`. No dictLabelResolver — `<field>Label`
      * projection only applies to single-field groupings, which dispatch
      * through `groupBy` above.
      */
-    groupByN<T, F extends readonly string[], S extends keyof T = never, M extends keyof T & string = never>(executeRecords: () => readonly unknown[], fields: F, upstreams: readonly AggregationUpstream[], via?: ViaPipeline): GroupedQueryN<T, F, S, M>;
+    groupByN<T, F extends readonly string[], S extends keyof T = never, M extends keyof T & string = never>(executeRecords: () => readonly unknown[], fields: F, upstreams: readonly ReductionUpstream[], via?: ViaPipeline): GroupedQueryN<T, F, S, M>;
     /**
      * Terminal streaming aggregator for `ScanBuilder.aggregate(spec)`.
      * Takes an async iterable of decrypted records + the spec and
      * returns the reduced result.
      */
-    scanAggregate<Spec extends AggregateSpec>(iter: AsyncIterable<unknown>, spec: Spec): Promise<AggregateResult<Spec>>;
+    scanAggregate<Spec extends ReduceSpec>(iter: AsyncIterable<unknown>, spec: Spec): Promise<ReduceResult<Spec>>;
 }
 /**
  * No-aggregate stub. Every `.aggregate()` / `.groupBy()` / streaming
  * `scan().aggregate()` call throws with a pointer at the subpath. The
- * real `Aggregation` / `GroupedQuery` classes are never referenced at
+ * real `Reduction` / `GroupedQuery` classes are never referenced at
  * runtime, so the bundler drops the ~886 LOC.
  *
  * @internal
  */
-export declare const NO_AGGREGATE: AggregateStrategy;
+export declare const NO_REDUCE: ReduceStrategy;

package/dist/with-lookup/search/build-docs.d.ts

@@ -1,7 +1,13 @@
 import type { I18nTextDescriptor } from '../../via/i18n/core.js';
 import type { DictKeyDescriptor, StaticDictDescriptor } from '../../via/i18n/dictionary.js';
 import type { IndexDoc } from './inverted-index.js';
-type FieldEntry = IndexDoc['fields'][number];
+/**
+ * One entry in an {@link IndexDoc}'s `fields` array — the return shape of the
+ * `build*FieldEntries` helpers. Exported so `@noy-db/hub/search` can name the
+ * return type of its own public functions (#843 C1: the subpath's first
+ * type-reachability gap).
+ */
+export type FieldEntry = IndexDoc['fields'][number];
 export declare function buildStringFieldEntries(record: Record<string, unknown>, textIndexes: readonly string[], only?: readonly string[]): FieldEntry[];
 export declare function buildI18nFieldEntries(record: Record<string, unknown>, i18nFields: Record<string, I18nTextDescriptor>, textIndexes: readonly string[], only?: readonly string[]): FieldEntry[];
 /** label map: field -> (key -> { locale -> label }). Precomputed in the collection (async for dynamic dicts). */
@@ -12,4 +18,3 @@ export declare function buildDictKeyFieldEntries(record: Record<string, unknown>
  * caller). Bytes are never tokenized; only the slot `filename` is indexed.
  */
 export declare function buildBlobFieldEntries(filenamesByField: Map<string, string[]>): FieldEntry[];
-export {};

package/dist/with-lookup/search/index.d.ts

@@ -11,7 +11,7 @@ export { segmentTokens, segmentTokenizer, type Token } from './segment.js';
 export { InvertedIndex, type IndexDoc, type IndexHit, type QueryOptions } from './inverted-index.js';
 export { extractSnippet } from './snippet.js';
 export { MemoryIndexStore, type IndexStore } from './index-store.js';
-export { buildStringFieldEntries } from './build-docs.js';
+export { buildStringFieldEntries, type FieldEntry } from './build-docs.js';
 export type { RetrieveOptions, RetrieveHit } from './retrieve-types.js';
 export { fuseRetrieval, type FuseOptions } from './fuse.js';
 export { withSearch } from './active.js';

package/dist/with-party/broker/index.d.ts

@@ -26,3 +26,4 @@ export declare function issueChallenge(opts?: {
 }): IssuedChallenge;
 export { verifyBrokerProof };
 export type { VerifyBrokerProofArgs };
+export type { IssuedChallenge } from '../../kernel/enclave/index.js';

package/dist/with-party/broker/seed.d.ts

@@ -1,6 +1,6 @@
 /**
  * `_broker` reserved-collection seed lifecycle (#479, credential-broker
- * spec §2/§3). Modeled on `with-party/team/sync-credentials.ts`: a
+ * spec §2/§3). Modeled on `with-sync/credentials.ts`: a
  * `_`-prefixed reserved collection, record id = `brokerId`, encrypted under
  * the collection's own DEK, `requireAdminAccess` role gate (owner/admin
  * only — custodian intentionally excluded, same rationale as

package/dist/with-party/custody/liberate.d.ts

@@ -24,7 +24,7 @@
  * unseal the original sealed owner. The old sealed-owner credential is left
  * untouched and ORPHANED (its `_keyring/<id>` file remains, its KEK is still
  * sealed under the non-firm provider), never impersonated. The new owner is a
- * DISTINCT principal under a fresh KEK derived from `newOwnerPassphrase`. This
+ * DISTINCT principal under a fresh KEK derived from `newOwnerSecret`. This
  * preserves the inalienability floor: the act of claiming ownership is itself
  * auditable and produces a different principal, rather than silently assuming
  * the latent owner's identity.
@@ -47,8 +47,8 @@ import type { FrozenSnapshotRef } from '../../with-audit/portability/withdraw-ac
 export interface LiberateOptions {
     /** The id of the new owner principal the custodian mints by claiming ownership. */
     readonly newOwnerId: string;
-    /** The passphrase that derives the new owner's KEK (the DEKs are re-wrapped under it). */
-    readonly newOwnerPassphrase: string;
+    /** The secret that derives the new owner's KEK (the DEKs are re-wrapped under it). */
+    readonly newOwnerSecret: string;
     /** Legal/contractual basis recorded in the audit (e.g. 'contractual-handover'). */
     readonly legalBasis: string;
     readonly factors?: FactorProofBundle;

package/dist/with-party/directory/cover/index.d.ts

@@ -8,12 +8,8 @@
  */
 export type { Cover, CoverText, CoverSchema, CoverField, JsonValue, ResolvedCoverSchema, } from './types.js';
 export { COVER_FIELDS, DEFAULT_COVER_SCHEMA, resolveSchema, } from './types.js';
+export { resolveSchema as resolveCoverSchema } from './types.js';
 export type { SetCoverInput } from './schema.js';
 export { validateCoverInput, isCover } from './schema.js';
 export { mergeCustom, validateCoverSize } from './custom.js';
 export { loadCover, saveCover, readCover, resolveLocale, pickLocale, COVER_RECORD_ID, } from './storage.js';
-export type { PublicEnvelope, PublicEnvelopeText, PublicEnvelopeSchema, PublicEnvelopeField, ResolvedPublicEnvelopeSchema, } from './types.js';
-export { PUBLIC_ENVELOPE_FIELDS, DEFAULT_PUBLIC_ENVELOPE_SCHEMA, } from './types.js';
-export type { SetPublicEnvelopeInput } from './schema.js';
-export { validatePublicEnvelopeInput, isPublicEnvelope } from './schema.js';
-export { loadPublicEnvelope, savePublicEnvelope, readPublicEnvelope, PUBLIC_ENVELOPE_RECORD_ID, } from './storage.js';

package/dist/with-party/directory/cover/schema.d.ts

@@ -31,9 +31,3 @@ export declare function validateCoverInput(input: SetCoverInput, schema: Resolve
  * discriminator keeps its frozen name: `_noydb_public: 1`.)
  */
 export declare function isCover(x: unknown): x is Cover;
-/** @deprecated Use {@link SetCoverInput}. */
-export type SetPublicEnvelopeInput = SetCoverInput;
-/** @deprecated Use {@link validateCoverInput}. */
-export declare const validatePublicEnvelopeInput: typeof validateCoverInput;
-/** @deprecated Use {@link isCover}. */
-export declare const isPublicEnvelope: typeof isCover;

package/dist/with-party/directory/cover/storage.d.ts

@@ -61,11 +61,3 @@ export declare function resolveLocale(cover: Cover, locale: string): Cover;
  * This deviation is documented in `https://github.com/vLannaAi/noy-db-docs/blob/main/content/docs/services/public-envelope.md`.
  */
 export declare function pickLocale(value: string | Record<string, string>, locale: string, defaultLocale: string | undefined): string;
-/** @deprecated Use {@link COVER_RECORD_ID}. */
-export declare const PUBLIC_ENVELOPE_RECORD_ID = "public-envelope";
-/** @deprecated Use {@link loadCover}. */
-export declare const loadPublicEnvelope: typeof loadCover;
-/** @deprecated Use {@link saveCover}. */
-export declare const savePublicEnvelope: typeof saveCover;
-/** @deprecated Use {@link readCover}. */
-export declare const readPublicEnvelope: typeof readCover;

package/dist/with-party/directory/cover/types.d.ts

@@ -126,24 +126,3 @@ export interface ResolvedCoverSchema {
  * overrides the keys it provides.
  */
 export declare function resolveSchema(schema: true | CoverSchema | undefined): ResolvedCoverSchema | undefined;
-/** @deprecated Use {@link Cover}. */
-export type PublicEnvelope = Cover;
-/** @deprecated Use {@link CoverText}. */
-export type PublicEnvelopeText = CoverText;
-/** @deprecated Use {@link CoverField}. */
-export type PublicEnvelopeField = CoverField;
-/** @deprecated Use {@link CoverSchema}. */
-export type PublicEnvelopeSchema = CoverSchema;
-/** @deprecated Use {@link ResolvedCoverSchema}. */
-export type ResolvedPublicEnvelopeSchema = ResolvedCoverSchema;
-/** @deprecated Use {@link COVER_FIELDS}. */
-export declare const PUBLIC_ENVELOPE_FIELDS: readonly ["name", "description", "icon", "createdAt", "updatedAt", "defaultLocale", "custom"];
-/** @deprecated Use {@link DEFAULT_COVER_SCHEMA}. */
-export declare const DEFAULT_PUBLIC_ENVELOPE_SCHEMA: {
-    readonly fields: readonly ["name", "description", "icon", "createdAt", "updatedAt", "defaultLocale"];
-    readonly maxIconBytes: number;
-    readonly iconMimeTypes: readonly ["image/png", "image/svg+xml"];
-    readonly maxStringChars: 200;
-    readonly maxCustomBytes: number;
-    readonly maxCoverBytes: number;
-};

package/dist/with-party/directory/index.d.ts

@@ -7,5 +7,7 @@
  * @module
  */
 export type { DirectoryConfig, UserVisibility } from './types.js';
+export { loadUserEnvelope, saveUserEnvelope, deleteUserEnvelope, listUserEnvelopeIds, } from './user-envelope/storage.js';
+export { UserApi } from './user-envelope/api.js';
 export { readDirectoryConfig, persistDirectoryConfig, META_COLLECTION, DIRECTORY_RECORD_ID, } from './storage.js';
 export { readUserVisibility, persistUserVisibility, deleteUserVisibility, visibilityRecordId, VISIBILITY_RECORD_PREFIX, } from './visibility.js';

package/dist/with-party/session/dev-unlock.d.ts

@@ -2,11 +2,11 @@
  * Dev-mode persistent unlock —
  *
  * Solves the developer inner-loop friction: hot-reload destroys the session
- * (page navigation semantics), forcing a passphrase re-entry every refresh.
+ * (page navigation semantics), forcing a secret re-entry every refresh.
  *
  * This module provides an opt-in, deliberately-named escape hatch that lets
  * developers store the keyring payload in sessionStorage or localStorage so
- * the vault auto-unlocks on every page load — without a passphrase,
+ * the vault auto-unlocks on every page load — without a secret,
  * without a biometric prompt, without any OIDC flow.
  *
  * ⚠️ WARNING — this is a loaded footgun ⚠️

package/dist/with-party/session/index.d.ts

@@ -21,3 +21,5 @@ export type { DevUnlockOptions } from './dev-unlock.js';
 export { withSession } from './active.js';
 export type { SessionStrategy } from './strategy.js';
 export { SessionExpiredError, SessionNotFoundError, SessionPolicyError, } from '../../kernel/errors.js';
+/** The un-opted-in stub for this service — exported so callers can compare against it (#844). */
+export { NO_SESSION } from './strategy.js';