kaafil-js 0.1.0-beta.3 → 0.1.0-beta.4

package/dist/client-entry.cjs

@@ -144,6 +144,7 @@ var OPERATION_SECURITY = {
   createRoomingRoom: ["managerAuth"],
   createRoomingStayWindow: ["managerAuth"],
   createSeatingVehicle: ["managerAuth"],
+  createSupportGrant: ["platformAdminAuth"],
   createTrekWalkIn: ["managerAuth"],
   deleteBooking: ["apiKeyAuth"],
   deleteChecklistItem: ["managerAuth"],
@@ -158,8 +159,10 @@ var OPERATION_SECURITY = {
   deleteSeatingVehicle: ["managerAuth"],
   dispatchForm: ["managerAuth", "apiKeyAuth"],
   editWebhookEndpoint: ["consoleAuth"],
+  eraseTraveller: ["apiKeyAuth"],
   exportCloseoutPack: ["managerAuth", "apiKeyAuth"],
   exportFormResponses: ["apiKeyAuth", "managerAuth"],
+  exportTraveller: ["apiKeyAuth"],
   getForm: ["apiKeyAuth", "agencyAdminAuth", "managerAuth"],
   getFormAggregate: ["apiKeyAuth"],
   getFormConsentReceipt: ["apiKeyAuth", "managerAuth"],
@@ -198,6 +201,8 @@ var OPERATION_SECURITY = {
   listPlatformPartnerConsoleUsers: ["platformAdminAuth"],
   listPlatformPartners: ["platformAdminAuth"],
   listRoomingStayWindows: ["managerAuth", "agencyAdminAuth", "apiKeyAuth"],
+  listSupportIngestLog: ["platformAdminAuth"],
+  listSupportWebhookDeliveries: ["platformAdminAuth"],
   listTripFormResponses: ["managerAuth", "apiKeyAuth"],
   listTripForms: ["managerAuth", "apiKeyAuth"],
   listTripVendors: ["apiKeyAuth", "managerAuth", "agencyAdminAuth"],
@@ -271,6 +276,8 @@ var OPERATION_SECURITY = {
   readRoomingBoard: ["managerAuth", "agencyAdminAuth", "apiKeyAuth"],
   readSeatingBoard: ["managerAuth", "agencyAdminAuth", "apiKeyAuth"],
   readShareToken: ["apiKeyAuth"],
+  readSupportJourneyState: ["platformAdminAuth"],
+  readSupportWebhookDeliveryDetail: ["platformAdminAuth"],
   readTrekBoard: ["managerAuth", "apiKeyAuth"],
   readTrekWalkInMeta: ["managerAuth", "apiKeyAuth"],
   readTripFeedbackSummary: ["managerAuth", "agencyAdminAuth", "apiKeyAuth"],
@@ -281,6 +288,7 @@ var OPERATION_SECURITY = {
   recordCollection: ["managerAuth"],
   redeliverEndpointDelivery: ["consoleAuth"],
   redeliverWebhookDelivery: ["apiKeyAuth"],
+  redriveSupportWebhookDelivery: ["platformAdminAuth"],
   refreshAgencyAdminTokens: ["agencyAdminAuth"],
   refreshManagerTokens: ["managerAuth"],
   regenerateShareToken: ["apiKeyAuth"],
@@ -296,6 +304,7 @@ var OPERATION_SECURITY = {
   reorderItineraryItem: ["managerAuth"],
   reorderPickupStops: ["managerAuth"],
   replaceBookingVouchers: ["apiKeyAuth"],
+  replaySupportWebhookRange: ["platformAdminAuth"],
   replayWebhookEndpoint: ["apiKeyAuth"],
   requestFileUpload: ["managerAuth", "apiKeyAuth"],
   resetPlatformPartnerConsoleUser: ["platformAdminAuth"],
@@ -369,6 +378,7 @@ var OPERATION_ACCEPTS_IDEMPOTENCY_KEY = {
   createRoomingRoom: true,
   createRoomingStayWindow: true,
   createSeatingVehicle: true,
+  createSupportGrant: false,
   createTrekWalkIn: true,
   deleteBooking: true,
   deleteChecklistItem: false,
@@ -383,8 +393,10 @@ var OPERATION_ACCEPTS_IDEMPOTENCY_KEY = {
   deleteSeatingVehicle: false,
   dispatchForm: true,
   editWebhookEndpoint: true,
+  eraseTraveller: true,
   exportCloseoutPack: false,
   exportFormResponses: false,
+  exportTraveller: false,
   getForm: false,
   getFormAggregate: false,
   getFormConsentReceipt: false,
@@ -423,6 +435,8 @@ var OPERATION_ACCEPTS_IDEMPOTENCY_KEY = {
   listPlatformPartnerConsoleUsers: false,
   listPlatformPartners: false,
   listRoomingStayWindows: false,
+  listSupportIngestLog: false,
+  listSupportWebhookDeliveries: false,
   listTripFormResponses: false,
   listTripForms: false,
   listTripVendors: false,
@@ -496,6 +510,8 @@ var OPERATION_ACCEPTS_IDEMPOTENCY_KEY = {
   readRoomingBoard: false,
   readSeatingBoard: false,
   readShareToken: false,
+  readSupportJourneyState: false,
+  readSupportWebhookDeliveryDetail: false,
   readTrekBoard: false,
   readTrekWalkInMeta: false,
   readTripFeedbackSummary: false,
@@ -506,6 +522,7 @@ var OPERATION_ACCEPTS_IDEMPOTENCY_KEY = {
   recordCollection: true,
   redeliverEndpointDelivery: true,
   redeliverWebhookDelivery: true,
+  redriveSupportWebhookDelivery: false,
   refreshAgencyAdminTokens: false,
   refreshManagerTokens: false,
   regenerateShareToken: true,
@@ -521,6 +538,7 @@ var OPERATION_ACCEPTS_IDEMPOTENCY_KEY = {
   reorderItineraryItem: true,
   reorderPickupStops: true,
   replaceBookingVouchers: false,
+  replaySupportWebhookRange: false,
   replayWebhookEndpoint: true,
   requestFileUpload: true,
   resetPlatformPartnerConsoleUser: false,
@@ -594,6 +612,7 @@ var KaafilErrorCode = {
   StayWindowOverlap: "STAY_WINDOW_OVERLAP",
   StopHasPending: "STOP_HAS_PENDING",
   SubjectRequired: "SUBJECT_REQUIRED",
+  SupportGrantRequired: "SUPPORT_GRANT_REQUIRED",
   SyncTargetRefused: "SYNC_TARGET_REFUSED",
   TenantScopeMissing: "TENANT_SCOPE_MISSING",
   Unauthenticated: "UNAUTHENTICATED",
@@ -647,6 +666,7 @@ var ERROR_CODE_TABLE = {
   STAY_WINDOW_OVERLAP: { status: 422, retryability: "no", outboxClass: "FATAL" },
   STOP_HAS_PENDING: { status: 422, retryability: "no", outboxClass: "FATAL" },
   SUBJECT_REQUIRED: { status: 422, retryability: "no", outboxClass: "FATAL" },
+  SUPPORT_GRANT_REQUIRED: { status: 403, retryability: "no", outboxClass: "FATAL" },
   SYNC_TARGET_REFUSED: { status: 422, retryability: "no", outboxClass: "FATAL" },
   TENANT_SCOPE_MISSING: { status: 500, retryability: "yes", outboxClass: "TRANSIENT" },
   UNAUTHENTICATED: { status: 401, retryability: "after-refresh", outboxClass: "FATAL" },
@@ -1919,6 +1939,10 @@ var OutboxStatus = {
   /** Terminal success. Pruned on the next persist. */
   Done: "done"
 };
+var OutboxRetryCause = {
+  Transport: "transport",
+  Server: "server"
+};
 function createOutbox(options) {
   const key = `${options.keyPrefix}:outbox`;
   const mintId = options.newId ?? newIdempotencyKey;
@@ -1985,6 +2009,7 @@ function createOutbox(options) {
         status: OutboxStatus.Pending,
         attemptCount: 0,
         nextRetryAt: null,
+        retryCause: void 0,
         refreshAttempted: false,
         parkReason: void 0
       };
@@ -2038,19 +2063,39 @@ function createOutbox(options) {
         status: OutboxStatus.Parked,
         parkReason: reason,
         attemptCount: (op?.attemptCount ?? 0) + 1,
-        nextRetryAt: null
+        nextRetryAt: null,
+        retryCause: void 0
       });
     },
-    async scheduleRetry(opId, nextRetryAt) {
+    async scheduleRetry(opId, nextRetryAt, cause) {
       const op = ops.get(opId);
       await mutate(opId, {
         status: OutboxStatus.Pending,
         attemptCount: (op?.attemptCount ?? 0) + 1,
-        nextRetryAt
+        nextRetryAt,
+        retryCause: cause
       });
     },
+    async clearTransportBackoff() {
+      let cleared = 0;
+      for (const [id, op] of ops) {
+        if (op.status !== OutboxStatus.Pending || op.nextRetryAt === null || op.retryCause !== OutboxRetryCause.Transport) {
+          continue;
+        }
+        ops.set(id, { ...op, nextRetryAt: null, retryCause: void 0 });
+        cleared += 1;
+      }
+      if (cleared > 0) {
+        await persist();
+      }
+      return cleared;
+    },
     async requeue(opId) {
-      await mutate(opId, { status: OutboxStatus.Pending });
+      await mutate(opId, {
+        status: OutboxStatus.Pending,
+        nextRetryAt: null,
+        retryCause: void 0
+      });
     },
     async markRefreshAttempted(opId) {
       await mutate(opId, { refreshAttempted: true });
@@ -2064,6 +2109,7 @@ function createOutbox(options) {
         ...op,
         status: OutboxStatus.Pending,
         nextRetryAt: null,
+        retryCause: void 0,
         attemptCount: op.attemptCount + 1,
         ...patch.body !== void 0 ? { body: patch.body } : {},
         ...patch.ifMatch !== void 0 ? { ifMatch: patch.ifMatch } : {}
@@ -2168,6 +2214,7 @@ function createDrainer(options) {
   const now = options.now ?? Date.now;
   const random = options.random ?? Math.random;
   let inFlight = null;
+  const ownSignal = new AbortController();
   function observeServerTime(outcome) {
     if (outcome.serverTime !== void 0) {
       options.onServerTime?.(outcome.serverTime);
@@ -2246,7 +2293,11 @@ function createDrainer(options) {
         ...outcome.retryAfterSeconds !== void 0 ? { retryAfterSeconds: outcome.retryAfterSeconds } : {},
         random
       });
-      await outbox.scheduleRetry(op.id, now() + delay);
+      await outbox.scheduleRetry(
+        op.id,
+        now() + delay,
+        outcome.status === null ? OutboxRetryCause.Transport : OutboxRetryCause.Server
+      );
       events.emit("sync.error", {
         opId: op.id,
         tripRef: op.tripRef,
@@ -2342,12 +2393,14 @@ function createDrainer(options) {
     let outcomes;
     try {
       outcomes = await sendBatch(ready, signal);
-    } catch {
+    } catch (error) {
+      const cause = isKaafilLike(error) && error.kind === "transport" ? OutboxRetryCause.Transport : OutboxRetryCause.Server;
       const [head, ...rest] = ready;
       if (head !== void 0) {
         await outbox.scheduleRetry(
           head.id,
-          now() + computeRetryDelayMs(head.attemptCount + 1, { random })
+          now() + computeRetryDelayMs(head.attemptCount + 1, { random }),
+          cause
         );
       }
       for (const op of rest) {
@@ -2399,20 +2452,68 @@ function createDrainer(options) {
     });
     return report;
   }
+  let kickTimer;
+  let pendingKickRestored = false;
   const drainer = {
     async drain(drainOptions = {}) {
       if (inFlight !== null) {
         return inFlight;
       }
-      const pass = runPass(drainOptions.signal).finally(() => {
+      const signal = drainOptions.signal ?? ownSignal.signal;
+      const pass = (async () => {
+        if (drainOptions.connectivityRestored === true) {
+          await outbox.clearTransportBackoff();
+        }
+        return runPass(signal);
+      })().finally(() => {
         inFlight = null;
       });
       inFlight = pass;
       return pass;
     },
-    kick() {
-      void drainer.drain().catch(() => {
-      });
+    // Deferred to a fresh macrotask, on purpose. `enqueue()` calls this after
+    // EVERY write, and a caller enqueueing several writes in a row (a batch
+    // import, this SDK's own offline smoke test, `06`'s worked example) does
+    // so as a sequence of awaited calls with no real I/O between them —
+    // which means their continuations are all still microtasks. A `kick()`
+    // that started draining synchronously would mark the FIRST op of the
+    // burst `inflight` before the caller's loop even reaches its second
+    // iteration, so `outbox.counts().pending` would under-report a queue
+    // that is, in fact, completely durable (`./outbox.ts`'s promise is about
+    // durability, not about `pending` never dipping). Parking the kick
+    // behind a macrotask lets the whole synchronous burst finish enqueueing
+    // — and, for a real UI, the current paint — before the drain takes its
+    // first op off the pending list. Nothing about durability changes: the
+    // write-ahead persist in `enqueue()` already happened before this method
+    // is even called.
+    kick(kickOptions = {}) {
+      if (kickTimer !== void 0) {
+        pendingKickRestored = pendingKickRestored || kickOptions.connectivityRestored === true;
+        return;
+      }
+      pendingKickRestored = kickOptions.connectivityRestored === true;
+      kickTimer = setTimeout(() => {
+        kickTimer = void 0;
+        const restored = pendingKickRestored;
+        pendingKickRestored = false;
+        void drainer.drain({ connectivityRestored: restored }).catch(() => {
+        });
+      }, 0);
+    },
+    // Called only from `OfflineEngine.close()` (`./engine.ts`). Two separate
+    // handles, both cleared: a `kick()` that is scheduled but has not fired
+    // yet (the `setTimeout` itself), and a pass already running under
+    // `ownSignal` — which, per `drain()` above, is every automatic kick and
+    // any signal-less explicit call. Aborting propagates into
+    // `transport.sendOne`/`sendBatch` and from there into
+    // `../http/client.ts`'s own retry ladder, which is otherwise the one
+    // thing nothing here could ever cut short.
+    cancelKick() {
+      if (kickTimer !== void 0) {
+        clearTimeout(kickTimer);
+        kickTimer = void 0;
+      }
+      ownSignal.abort();
     },
     bindOpportunisticTriggers() {
       const target = typeof globalThis.addEventListener === "function" ? globalThis : void 0;
@@ -2421,7 +2522,7 @@ function createDrainer(options) {
         };
       }
       const onOnline = () => {
-        drainer.kick();
+        drainer.kick({ connectivityRestored: true });
       };
       const onVisible = () => {
         const state = globalThis.document?.visibilityState;
@@ -3097,15 +3198,16 @@ function createOfflineEngine(options) {
       drainer.kick();
       return op;
     },
-    async drain() {
+    async drain(drainOptions = {}) {
       await share?.parkOpsPastGrace();
-      const report = await drainer.drain();
+      const report = await drainer.drain(drainOptions);
       await blobs?.drain();
       return report;
     },
     close() {
       unbind?.();
       unbind = void 0;
+      drainer.cancelKick();
       events.clear();
     }
   };
@@ -5183,6 +5285,7 @@ exports.MAX_BATCH_OPS = MAX_BATCH_OPS;
 exports.ManagerRole = ManagerRole;
 exports.ManifestMode = ManifestMode;
 exports.OutboxClass = OutboxClass;
+exports.OutboxRetryCause = OutboxRetryCause;
 exports.OutboxStatus = OutboxStatus;
 exports.PartyKind = PartyKind;
 exports.PickupKind = PickupKind;