@atscript/db-mongo 0.1.152 → 0.1.153

package/dist/index.d.cts

@@ -254,6 +254,14 @@ interface TMongoAdapterOptions {
    * Default: exact counts.
    */
   estimatedCount?: boolean | readonly string[];
+  /**
+   * Read a managed view through its own pipeline on the entry collection,
+   * without the `$lookup` + `$unwind` stages of the joins the read does not
+   * need (default `true`) — see the views guide, "Performance". `false`
+   * always reads the stored view.
+   * @since 0.1.153
+   */
+  viewJoinPruning?: boolean;
 }
 declare class MongoAdapter extends BaseDbAdapter {
   protected readonly db: Db;
@@ -339,6 +347,12 @@ declare class MongoAdapter extends BaseDbAdapter {
   aggregateFns(): ReadonlySet<AggregateFn>;
   /** Arithmetic in an aggregate `$select` (`{ $expr }`, `{ $fn, $expr }`). */
   supportsAggregateExpressions(): boolean;
+  /**
+   * `$nulls` placement (since 0.1.153): a placed `$sort` / `$rowOrder` key
+   * gets a null-or-missing flag ordered before it (`mongo-sort.ts`) — reads
+   * then run as a pipeline with a blocking sort instead of `find().sort()`.
+   */
+  supportsNullsPlacement(): boolean;
   /** Computed view columns and first-row joins. */
   viewCapabilities(): ReadonlySet<TViewCapability>;
   /**
@@ -600,7 +614,29 @@ declare class MongoAdapter extends BaseDbAdapter {
   private _getCurrentFieldMax;
   /** Allocates increment values for a batch of items, assigning in order. */
   private _assignBatchIncrements;
-  /** A find whose filter holds relational predicates, as an aggregation pipeline. */
+  /**
+   * The pruned read of this adapter's managed view for `query` followed by
+   * `stages` (`mongoViewRead`, since 0.1.153): the view pipeline without the
+   * joins the read does not need, on the entry collection — or `undefined`
+   * to read the stored view: pruning off, not a view, nothing droppable, an
+   * operation-wide collation (it would govern the view's join keys too), or
+   * stages that may read a dropped column ({@link stagesReadAny}).
+   */
+  private _viewRead;
+  /**
+   * Runs a read pipeline — through the pruned view read `pruned` when there
+   * is one, on the bound collection otherwise. A view's own default
+   * collation is the simple one, so the pruned read pins it: the entry
+   * collection's default must not apply.
+   */
+  private _readPipeline;
+  /** A find over the pruned view read, or `undefined` when the stored view is read. */
+  private _prunedFind;
+  /**
+   * A find as an aggregation pipeline: its filter holds relational
+   * predicates, or its `$sort` places NULL (`$nulls` — `find().sort()` cannot
+   * express it; the placed sort is a blocking sort, so it may spill to disk).
+   */
   private _aggregateFind;
   private _buildFindOptions;
   /**

package/dist/index.d.mts

@@ -254,6 +254,14 @@ interface TMongoAdapterOptions {
    * Default: exact counts.
    */
   estimatedCount?: boolean | readonly string[];
+  /**
+   * Read a managed view through its own pipeline on the entry collection,
+   * without the `$lookup` + `$unwind` stages of the joins the read does not
+   * need (default `true`) — see the views guide, "Performance". `false`
+   * always reads the stored view.
+   * @since 0.1.153
+   */
+  viewJoinPruning?: boolean;
 }
 declare class MongoAdapter extends BaseDbAdapter {
   protected readonly db: Db;
@@ -339,6 +347,12 @@ declare class MongoAdapter extends BaseDbAdapter {
   aggregateFns(): ReadonlySet<AggregateFn>;
   /** Arithmetic in an aggregate `$select` (`{ $expr }`, `{ $fn, $expr }`). */
   supportsAggregateExpressions(): boolean;
+  /**
+   * `$nulls` placement (since 0.1.153): a placed `$sort` / `$rowOrder` key
+   * gets a null-or-missing flag ordered before it (`mongo-sort.ts`) — reads
+   * then run as a pipeline with a blocking sort instead of `find().sort()`.
+   */
+  supportsNullsPlacement(): boolean;
   /** Computed view columns and first-row joins. */
   viewCapabilities(): ReadonlySet<TViewCapability>;
   /**
@@ -600,7 +614,29 @@ declare class MongoAdapter extends BaseDbAdapter {
   private _getCurrentFieldMax;
   /** Allocates increment values for a batch of items, assigning in order. */
   private _assignBatchIncrements;
-  /** A find whose filter holds relational predicates, as an aggregation pipeline. */
+  /**
+   * The pruned read of this adapter's managed view for `query` followed by
+   * `stages` (`mongoViewRead`, since 0.1.153): the view pipeline without the
+   * joins the read does not need, on the entry collection — or `undefined`
+   * to read the stored view: pruning off, not a view, nothing droppable, an
+   * operation-wide collation (it would govern the view's join keys too), or
+   * stages that may read a dropped column ({@link stagesReadAny}).
+   */
+  private _viewRead;
+  /**
+   * Runs a read pipeline — through the pruned view read `pruned` when there
+   * is one, on the bound collection otherwise. A view's own default
+   * collation is the simple one, so the pruned read pins it: the entry
+   * collection's default must not apply.
+   */
+  private _readPipeline;
+  /** A find over the pruned view read, or `undefined` when the stored view is read. */
+  private _prunedFind;
+  /**
+   * A find as an aggregation pipeline: its filter holds relational
+   * predicates, or its `$sort` places NULL (`$nulls` — `find().sort()` cannot
+   * express it; the placed sort is a blocking sort, so it may spill to disk).
+   */
   private _aggregateFind;
   private _buildFindOptions;
   /**