@drakkar.software/sunglasses-adapter-starfish 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -12,6 +12,12 @@ export { CleanupConfig, StarfishAdapterConfig } from '@drakkar.software/sunglass
  * 4. On 409 Conflict (optimistic locking): pull again, re-merge, re-push
  *    (iterative, not recursive, to prevent stack overflow under high contention)
  *
+ * ## Push-only mode (`pushOnly: true`)
+ * Skips the pull step entirely — events are pushed as a fresh document each time.
+ * Use for Starfish collections with `queueOnly: true` where pull always returns
+ * empty data and optimistic locking is not needed.
+ * On failure the adapter throws, keeping events in the local queue for retry.
+ *
  * ## Rotating path mode (`rotatePathOnSuccess: true`)
  * Each successful push creates a **new** Starfish document with an
  * auto-incrementing path suffix (e.g. `events-0001`, `events-0002`…).
@@ -31,6 +37,7 @@ declare class StarfishAnalyticsAdapter implements IAnalyticsAdapter {
     private readonly authToken;
     private readonly maxRetries;
     private readonly timeoutMs;
+    private readonly pushOnly;
     private readonly rotatePathOnSuccess;
     private readonly pathStorage;
     constructor(config: StarfishAdapterConfig & {
@@ -46,6 +53,11 @@ declare class StarfishAnalyticsAdapter implements IAnalyticsAdapter {
      */
     cleanupAfterFlush(delivered: ReadonlyArray<SunglassesEvent>, config: CleanupConfig): Promise<void>;
     private sendMerge;
+    /**
+     * Push a fresh document directly, no pull, no merge, no conflict detection.
+     * Throws on failure so SunglassesCore keeps events in queue for retry.
+     */
+    private sendPushOnly;
     /**
      * Push events to a new Starfish document each time.
      *

package/dist/index.d.ts

@@ -12,6 +12,12 @@ export { CleanupConfig, StarfishAdapterConfig } from '@drakkar.software/sunglass
  * 4. On 409 Conflict (optimistic locking): pull again, re-merge, re-push
  *    (iterative, not recursive, to prevent stack overflow under high contention)
  *
+ * ## Push-only mode (`pushOnly: true`)
+ * Skips the pull step entirely — events are pushed as a fresh document each time.
+ * Use for Starfish collections with `queueOnly: true` where pull always returns
+ * empty data and optimistic locking is not needed.
+ * On failure the adapter throws, keeping events in the local queue for retry.
+ *
  * ## Rotating path mode (`rotatePathOnSuccess: true`)
  * Each successful push creates a **new** Starfish document with an
  * auto-incrementing path suffix (e.g. `events-0001`, `events-0002`…).
@@ -31,6 +37,7 @@ declare class StarfishAnalyticsAdapter implements IAnalyticsAdapter {
     private readonly authToken;
     private readonly maxRetries;
     private readonly timeoutMs;
+    private readonly pushOnly;
     private readonly rotatePathOnSuccess;
     private readonly pathStorage;
     constructor(config: StarfishAdapterConfig & {
@@ -46,6 +53,11 @@ declare class StarfishAnalyticsAdapter implements IAnalyticsAdapter {
      */
     cleanupAfterFlush(delivered: ReadonlyArray<SunglassesEvent>, config: CleanupConfig): Promise<void>;
     private sendMerge;
+    /**
+     * Push a fresh document directly, no pull, no merge, no conflict detection.
+     * Throws on failure so SunglassesCore keeps events in queue for retry.
+     */
+    private sendPushOnly;
     /**
      * Push events to a new Starfish document each time.
      *

package/dist/index.js

@@ -79,6 +79,7 @@ var StarfishAnalyticsAdapter = class {
     this.authToken = config.authToken ?? "";
     this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.timeoutMs = config.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    this.pushOnly = config.pushOnly ?? false;
     this.rotatePathOnSuccess = config.rotatePathOnSuccess ?? false;
     this.pathStorage = config.pathStorage ?? null;
     if (this.rotatePathOnSuccess && !this.pathStorage) {
@@ -96,6 +97,9 @@ var StarfishAnalyticsAdapter = class {
       );
     }
     const baseResolved = resolveStoragePath(this.storagePath, identity);
+    if (this.pushOnly) {
+      return this.sendPushOnly(batch, baseResolved);
+    }
     if (this.rotatePathOnSuccess && this.pathStorage) {
       return this.sendRotating(batch, identity, baseResolved);
     }
@@ -167,6 +171,20 @@ var StarfishAnalyticsAdapter = class {
       `[SunGlasses] StarfishAnalyticsAdapter: max retries (${this.maxRetries}) exceeded for path "${path}" \u2014 batch discarded`
     );
   }
+  // ── Private: push-only mode (queueOnly collections) ──────────────────────
+  /**
+   * Push a fresh document directly, no pull, no merge, no conflict detection.
+   * Throws on failure so SunglassesCore keeps events in queue for retry.
+   */
+  async sendPushOnly(batch, path) {
+    const doc = mergeEvents(createEmptyDocument(), batch);
+    const response = await this.push(path, doc, "");
+    if (!response.ok) {
+      throw new Error(
+        `[SunGlasses] StarfishAnalyticsAdapter: push-only push failed with status ${response.status} for path "${path}"`
+      );
+    }
+  }
   // ── Private: rotating path mode ────────────────────────────────────────────
   /**
    * Push events to a new Starfish document each time.

package/dist/index.mjs

@@ -49,6 +49,7 @@ var StarfishAnalyticsAdapter = class {
     this.authToken = config.authToken ?? "";
     this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.timeoutMs = config.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    this.pushOnly = config.pushOnly ?? false;
     this.rotatePathOnSuccess = config.rotatePathOnSuccess ?? false;
     this.pathStorage = config.pathStorage ?? null;
     if (this.rotatePathOnSuccess && !this.pathStorage) {
@@ -66,6 +67,9 @@ var StarfishAnalyticsAdapter = class {
       );
     }
     const baseResolved = resolveStoragePath(this.storagePath, identity);
+    if (this.pushOnly) {
+      return this.sendPushOnly(batch, baseResolved);
+    }
     if (this.rotatePathOnSuccess && this.pathStorage) {
       return this.sendRotating(batch, identity, baseResolved);
     }
@@ -137,6 +141,20 @@ var StarfishAnalyticsAdapter = class {
       `[SunGlasses] StarfishAnalyticsAdapter: max retries (${this.maxRetries}) exceeded for path "${path}" \u2014 batch discarded`
     );
   }
+  // ── Private: push-only mode (queueOnly collections) ──────────────────────
+  /**
+   * Push a fresh document directly, no pull, no merge, no conflict detection.
+   * Throws on failure so SunglassesCore keeps events in queue for retry.
+   */
+  async sendPushOnly(batch, path) {
+    const doc = mergeEvents(createEmptyDocument(), batch);
+    const response = await this.push(path, doc, "");
+    if (!response.ok) {
+      throw new Error(
+        `[SunGlasses] StarfishAnalyticsAdapter: push-only push failed with status ${response.status} for path "${path}"`
+      );
+    }
+  }
   // ── Private: rotating path mode ────────────────────────────────────────────
   /**
    * Push events to a new Starfish document each time.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakkar.software/sunglasses-adapter-starfish",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Starfish document-sync adapter for SunGlasses (Drakkar-Software/Starfish)",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,7 +16,7 @@
     "dist"
   ],
   "dependencies": {
-    "@drakkar.software/sunglasses-core": "0.5.0"
+    "@drakkar.software/sunglasses-core": "0.6.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",