@lpdjs/firestore-repo-service 2.4.3 → 2.6.2-beta.0

package/dist/{openapi-ML_1hTx2.d.cts → openapi-B2w5tVRR.d.cts}

@@ -1,4 +1,4 @@
-import { d as CrudRepoRegistry, O as OpenAPISpecOptions } from './types-BtdC0Qhu.cjs';
+import { d as CrudRepoRegistry, O as OpenAPISpecOptions } from './types-GvexCqrq.cjs';
 
 /**
  * OpenAPI 3.1 specification generator for the CRUD server.

package/dist/{openapi-DIoQV_yQ.d.ts → openapi-DB8bXZB-.d.ts}

@@ -1,4 +1,4 @@
-import { d as CrudRepoRegistry, O as OpenAPISpecOptions } from './types-5vgXdUM2.js';
+import { d as CrudRepoRegistry, O as OpenAPISpecOptions } from './types-BHZ-Gk-s.js';
 
 /**
  * OpenAPI 3.1 specification generator for the CRUD server.

package/dist/{queue-xMOZxY0M.d.cts → queue-B8YUTnBT.d.cts}

@@ -1,4 +1,4 @@
-import { a as SqlAdapter, S as SyncEvent } from './types-BgIGWlR1.cjs';
+import { a as SqlAdapter, S as SyncEvent } from './types-wcX7xfdo.cjs';
 
 /**
  * Per-repo in-memory batch buffer.
@@ -47,12 +47,27 @@ declare class SyncQueue {
      *
      * Concurrent callers (e.g. several PubSub messages handled in parallel
      * inside the same Cloud Function instance with `concurrency > 1`) all
-     * await the same in-flight flush and then trigger a follow-up flush if
-     * new events were enqueued in the meantime. This guarantees that every
-     * caller's event is persisted before its `await flush()` resolves —
-     * which is required for safe PubSub ack semantics.
+     * await the same in-flight drain cycle. A drain cycle empties the buffer
+     * completely (see {@link _drain}), so by the time `await flush()` resolves
+     * every event that was buffered when the call started has been persisted
+     * (or handed to `onFlushError`) — which is required for safe PubSub
+     * at-least-once ack semantics.
      */
     flush(): Promise<void>;
+    /**
+     * Drain the buffer to empty. A single {@link _doFlush} only removes up to
+     * `batchSize` events, so loop until nothing remains. Without this loop,
+     * bursts larger than `batchSize` would leave events buffered after
+     * `flush()` resolved — and a container shutdown before the next interval
+     * would lose them permanently (breaking at-least-once).
+     */
+    private _drain;
+    /**
+     * Flush a single batch (up to `batchSize` events) to the adapter.
+     * @returns `true` when the batch was processed (or routed to the error
+     * handler) and the loop may continue; `false` when the batch was
+     * re-buffered after a failure with no `onFlushError` handler.
+     */
     private _doFlush;
     /** Stop the auto-flush timer and flush remaining events. */
     shutdown(): Promise<void>;

package/dist/{queue-CVchaGAh.d.ts → queue-DYmbVDu5.d.ts}

@@ -1,4 +1,4 @@
-import { a as SqlAdapter, S as SyncEvent } from './types-ChzVPw4k.js';
+import { a as SqlAdapter, S as SyncEvent } from './types-FLGn8CAI.js';
 
 /**
  * Per-repo in-memory batch buffer.
@@ -47,12 +47,27 @@ declare class SyncQueue {
      *
      * Concurrent callers (e.g. several PubSub messages handled in parallel
      * inside the same Cloud Function instance with `concurrency > 1`) all
-     * await the same in-flight flush and then trigger a follow-up flush if
-     * new events were enqueued in the meantime. This guarantees that every
-     * caller's event is persisted before its `await flush()` resolves —
-     * which is required for safe PubSub ack semantics.
+     * await the same in-flight drain cycle. A drain cycle empties the buffer
+     * completely (see {@link _drain}), so by the time `await flush()` resolves
+     * every event that was buffered when the call started has been persisted
+     * (or handed to `onFlushError`) — which is required for safe PubSub
+     * at-least-once ack semantics.
      */
     flush(): Promise<void>;
+    /**
+     * Drain the buffer to empty. A single {@link _doFlush} only removes up to
+     * `batchSize` events, so loop until nothing remains. Without this loop,
+     * bursts larger than `batchSize` would leave events buffered after
+     * `flush()` resolved — and a container shutdown before the next interval
+     * would lose them permanently (breaking at-least-once).
+     */
+    private _drain;
+    /**
+     * Flush a single batch (up to `batchSize` events) to the adapter.
+     * @returns `true` when the batch was processed (or routed to the error
+     * handler) and the loop may continue; `false` when the batch was
+     * re-buffered after a failure with no `onFlushError` handler.
+     */
     private _doFlush;
     /** Stop the auto-flush timer and flush remaining events. */
     shutdown(): Promise<void>;

package/dist/{read-BSyLao3I.d.cts → read-CTWZjxyh.d.cts}

@@ -357,4 +357,4 @@ interface HistoryMethods<T, PathArgs extends readonly unknown[] = [string]> {
     ]): Promise<HistoryEntry<T> | null>;
 }
 
-export { type HistoryTriggersConfig as H, type V2HistoryDoc as V, type HistoryConfigForModel as a, type HistoryMethods as b, type HistoryOperation as c, type HistoryFieldChange as d, type HistoryMeta as e, type HistoryValueType as f, type V1HistoryDoc as g, type HistoryEntry as h, createHistoryMethods as i, type HistoryConfigBase as j, type HistoryFirestoreTriggersDep as k, type HistoryListOptions as l, type HistoryRawListOptions as m, type HistoryTriggerRepoOverride as n };
+export { type HistoryTriggersConfig as H, type V2HistoryDoc as V, type HistoryOperation as a, type HistoryFieldChange as b, type HistoryMeta as c, type HistoryConfigForModel as d, type HistoryValueType as e, type V1HistoryDoc as f, type HistoryEntry as g, createHistoryMethods as h, type HistoryMethods as i, type HistoryConfigBase as j, type HistoryFirestoreTriggersDep as k, type HistoryListOptions as l, type HistoryRawListOptions as m, type HistoryTriggerRepoOverride as n };

package/dist/{read-BSyLao3I.d.ts → read-CTWZjxyh.d.ts}

@@ -357,4 +357,4 @@ interface HistoryMethods<T, PathArgs extends readonly unknown[] = [string]> {
     ]): Promise<HistoryEntry<T> | null>;
 }
 
-export { type HistoryTriggersConfig as H, type V2HistoryDoc as V, type HistoryConfigForModel as a, type HistoryMethods as b, type HistoryOperation as c, type HistoryFieldChange as d, type HistoryMeta as e, type HistoryValueType as f, type V1HistoryDoc as g, type HistoryEntry as h, createHistoryMethods as i, type HistoryConfigBase as j, type HistoryFirestoreTriggersDep as k, type HistoryListOptions as l, type HistoryRawListOptions as m, type HistoryTriggerRepoOverride as n };
+export { type HistoryTriggersConfig as H, type V2HistoryDoc as V, type HistoryOperation as a, type HistoryFieldChange as b, type HistoryMeta as c, type HistoryConfigForModel as d, type HistoryValueType as e, type V1HistoryDoc as f, type HistoryEntry as g, createHistoryMethods as h, type HistoryMethods as i, type HistoryConfigBase as j, type HistoryFirestoreTriggersDep as k, type HistoryListOptions as l, type HistoryRawListOptions as m, type HistoryTriggerRepoOverride as n };