@pipeline-builder/pipeline-data 4.1.3 → 4.1.5

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`,
@@ -90,7 +93,7 @@ export declare abstract class CrudService<TEntity extends BaseEntity, TFilter, T
      * be the tenant `orgId` column, not a display/name column.
      */
     protected abstract getOrgColumn(): AnyColumn;
-    /** Get the unique constraint columns for onConflictDoUpdate */
+    /** The unique-constraint columns a create must not conflict on (see {@link create}). */
     protected abstract get conflictTarget(): AnyColumn[];
     private readonly _logger;
     constructor();
@@ -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;
     /**
@@ -254,21 +256,6 @@ export declare abstract class CrudService<TEntity extends BaseEntity, TFilter, T
      * Update multiple entities matching filter
      */
     updateMany(filter: Partial<TFilter>, data: Partial<TUpdate>, orgId: string, userId: string): Promise<TEntity[]>;
-    /**
-     * Create multiple entities in a single batch insert.
-     * Uses upsert (onConflictDoUpdate) — all rows are inserted in one query per chunk.
-     * Chunks of 100 to stay within PostgreSQL parameter limits.
-     */
-    /**
-     * Build the `onConflictDoUpdate` SET for a bulk upsert. Unlike a single-row
-     * create (which can spread the one row's data), a batched insert has many rows,
-     * so each updatable column is written from `excluded.*` (the would-be-inserted
-     * value) — otherwise an existing row's fields are silently discarded and only
-     * timestamps bump. Skips identity/immutable (`id`, `createdAt`, `createdBy`)
-     * and the conflict-target columns; `updatedAt`/`updatedBy` get the fresh values.
-     */
-    private buildBulkUpsertSet;
-    bulkCreate(items: TInsert[], userId: string): Promise<TEntity[]>;
     /**
      * The `visibility` predicate for a bulk soft-delete, mirroring
      * `requireVisibilityWriteAccess` rung for rung so bulk and single-row delete