@pipeline-builder/pipeline-data 4.1.2 → 4.1.4

package/README.md

@@ -22,7 +22,6 @@ Database layer for [Pipeline Builder](https://mwashburn160.github.io/pipeline-bu
 | `db` | Shared Drizzle database instance |
 | `getConnection`, `closeConnection` | PostgreSQL connection lifecycle (with retry strategy) |
 | `schema` | All Drizzle table definitions and their `*Insert` / `*Update` types |
-| `runMigrations` (`MigrateOptions`) | Drizzle migration runner |
 | `tenantContext`, `runWithTenantContext`, `getTenantContext`, `withTenantTx` | Tenant-context primitives for scoped/RLS transactions |
 
 ### Services

package/lib/api/crud-service.d.ts

@@ -40,7 +40,10 @@ export interface QueryOptions {
     sortOrder?: 'asc' | 'desc';
     /** When true, runs a separate COUNT(*) query to include exact total. Default: false. */
     includeTotal?: boolean;
-    /** Cursor-based pagination: fetch rows after this cursor value (uses sortBy column). */
+    /**
+     * Keyset pagination: the opaque `nextCursor` of the previous page. Continues
+     * strictly after that row in (sortBy, id) order; takes precedence over `offset`.
+     */
     cursor?: string;
     /** Sparse fieldset: column names to select. Returns all columns when omitted. */
     fields?: string[];
@@ -55,7 +58,7 @@ export interface PaginatedResult<T> {
     limit: number;
     offset: number;
     hasMore: boolean;
-    /** Cursor pointing to the last item, for cursor-based pagination. */
+    /** Opaque cursor for the next page. Present only when `hasMore`. */
     nextCursor?: string;
 }
 /** The shared soft-delete retention window in ms (`SOFT_DELETE_RETENTION_DAYS`,
@@ -184,12 +187,11 @@ export declare abstract class CrudService<TEntity extends BaseEntity, TFilter, T
     findPaginated(filter: Partial<TFilter>, orgId?: string, options?: QueryOptions, parentOrgId?: string): Promise<PaginatedResult<TEntity>>;
     /**
      * Build a column selection map for sparse fieldsets.
-     * Falls back to full select if no matching columns found.
+     * Falls back to full select if no fields are requested.
      *
-     * `sortBy` (when set) is always folded into the projection even if the caller's
-     * `fields` omits it — cursor pagination reads the next cursor from the sort
-     * column's value on the last row, so dropping it from the SELECT would yield an
-     * undefined cursor and stall paging. Included the same way `id` always is.
+     * `id` is always included — it is the entity identity AND the keyset cursor's
+     * tie-breaker. The sort value for the cursor is projected separately (as text)
+     * by `findPaginated`, so the fieldset need not carry the sort column.
      */
     private buildFieldSelect;
     /**