kaafil-js 0.1.0 → 0.3.0

package/dist/client-entry.js

@@ -2583,6 +2583,11 @@ function createDrainer(options) {
           row: outcome.entity,
           ...outcome.serverTime !== void 0 ? { syncedAt: outcome.serverTime } : {}
         });
+        const temporaryId = entity.temporaryId;
+        if (temporaryId !== void 0 && temporaryId !== outcome.entity.id) {
+          await snapshot.purgeEntity(op.tripRef, entity.listName, temporaryId);
+          changed = true;
+        }
       }
       if (changed && outcome.serverTime !== void 0) {
         events.emit("snapshot.updated", {
@@ -2682,6 +2687,16 @@ function createDrainer(options) {
       switch (result.action) {
         case "drop":
           await outbox.drop(op.id);
+          if (op.entity?.temporaryId !== void 0) {
+            await snapshot.purgeEntity(op.tripRef, op.entity.listName, op.entity.temporaryId);
+            if (outcome.serverTime !== void 0) {
+              events.emit("snapshot.updated", {
+                tripRef: op.tripRef,
+                lists: [op.entity.listName],
+                serverTime: outcome.serverTime
+              });
+            }
+          }
           return "terminal";
         case "reissue":
           await outbox.reissue(op.id, {
@@ -2962,7 +2977,35 @@ var SYNC_PULL_SECTIONS = [
   "itinerary",
   "closeout"
 ];
-function extractSectionRows(data) {
+var SECTION_ROW_KEY = {
+  // Delta-shaped `rooms[]`; `windows[]`/`unassigned[]` are derived
+  // projections — the long note above is still exactly right about this one.
+  rooming: "rooms",
+  // The same decision in the same shape: `vehicles[]` is the feed,
+  // `unassignedPool[]` the projection that must never be cached as rows.
+  seating: "vehicles",
+  expenses: "items",
+  float: "data",
+  // The one that was silently dead. `sections[]` is a grouping projection and
+  // `availableTemplates[]` is agency-level catalogue; `items[]` is the trip's
+  // own entity list and the only one of the three carrying tombstones.
+  checklist: "items",
+  // `days[]` is the day-by-day projection the engine recomputes per read;
+  // `items[]` is the entity list.
+  itinerary: "items",
+  closeout: null
+  // `stayWindows`, `pickups`, `bookings` and `collections` send a top-level
+  // array and never reach this table.
+};
+function extractSectionRows(data, section) {
+  if (section !== void 0 && section in SECTION_ROW_KEY) {
+    const key = SECTION_ROW_KEY[section];
+    if (key === null || key === void 0 || typeof data !== "object" || data === null) {
+      return void 0;
+    }
+    const value = data[key];
+    return Array.isArray(value) && isRowArray(value) ? value : void 0;
+  }
   if (Array.isArray(data)) {
     return isRowArray(data) ? data : void 0;
   }
@@ -3032,7 +3075,7 @@ function createPullCoordinator(options) {
         absent.push(name);
         continue;
       }
-      const rows = extractSectionRows(section.data);
+      const rows = extractSectionRows(section.data, name);
       if (rows === void 0) {
         unmapped.push(name);
         continue;
@@ -3069,6 +3112,49 @@ function createPullCoordinator(options) {
   };
 }
 
+// src/offline/reads.ts
+function createReadCacheStore(options) {
+  const key = `${options.keyPrefix}:reads`;
+  let reads = /* @__PURE__ */ new Map();
+  async function persist() {
+    const shape = { reads: Object.fromEntries(reads) };
+    await options.storage.set(key, JSON.stringify(shape));
+  }
+  return {
+    get(readKey) {
+      return reads.get(readKey);
+    },
+    async set(readKey, value, serverTime) {
+      reads.set(readKey, { value, syncedAt: serverTime });
+      await persist();
+    },
+    async purge(readKey) {
+      if (!reads.delete(readKey)) {
+        return;
+      }
+      await persist();
+    },
+    async load() {
+      reads = /* @__PURE__ */ new Map();
+      const raw = await options.storage.get(key);
+      if (raw === void 0) {
+        return;
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(raw);
+      } catch {
+        return;
+      }
+      for (const [readKey, entry] of Object.entries(parsed.reads ?? {})) {
+        if (entry !== null && typeof entry === "object" && typeof entry.syncedAt === "string") {
+          reads.set(readKey, entry);
+        }
+      }
+    }
+  };
+}
+
 // src/offline/share.ts
 var SHARE_WRITE_GRACE_MS = 7 * 24 * 60 * 60 * 1e3;
 var KaafilShareLinkExpiredError = class _KaafilShareLinkExpiredError extends Error {
@@ -3443,6 +3529,8 @@ function createOfflineEngine(options) {
     ...options.onEventHandlerError !== void 0 ? { onHandlerError: (error) => options.onEventHandlerError?.(error) } : {}
   });
   const snapshot = createSnapshotStore({ storage: options.storage, keyPrefix });
+  const reads = createReadCacheStore({ storage: options.storage, keyPrefix });
+  const mintEntityId = () => `tmp_${options.newId?.() ?? newIdempotencyKey()}`;
   const outbox = createOutbox({
     storage: options.storage,
     keyPrefix,
@@ -3491,6 +3579,13 @@ function createOfflineEngine(options) {
   let unbind;
   async function enqueue(input) {
     share?.assertWritable();
+    let entity = input.entity;
+    let temporaryId;
+    if (input.creates === true && input.entity !== void 0) {
+      const { temporaryId: _ignored, ...ref } = input.entity;
+      temporaryId = mintEntityId();
+      entity = { ...ref, id: temporaryId, temporaryId };
+    }
     const op = await outbox.enqueue({
       tripRef: input.tripRef,
       method: input.method,
@@ -3498,16 +3593,25 @@ function createOfflineEngine(options) {
       operationId: input.operationId,
       ...input.body !== void 0 ? { body: input.body } : {},
       ...input.ifMatch !== void 0 ? { ifMatch: input.ifMatch } : {},
-      ...input.entity !== void 0 ? { entity: input.entity } : {},
+      ...entity !== void 0 ? { entity } : {},
       ...input.idempotencyKey !== void 0 ? { idempotencyKey: input.idempotencyKey } : {},
       ...input.enqueuedAt !== void 0 ? { enqueuedAt: input.enqueuedAt } : {}
     });
-    if (input.optimistic !== void 0 && input.entity !== void 0) {
+    if (input.optimistic !== void 0 && entity !== void 0) {
       await snapshot.upsert({
         tripRef: input.tripRef,
-        listName: input.entity.listName,
-        row: input.optimistic
+        listName: entity.listName,
+        // A create's row is keyed on the minted id rather than on whatever
+        // `id` the caller happened to put in the optimistic row — those two
+        // disagreeing is what would leave an orphan the drainer cannot find.
+        row: temporaryId === void 0 ? input.optimistic : { ...input.optimistic, id: temporaryId }
       });
+      if (temporaryId !== void 0) {
+        events.emit("snapshot.updated", {
+          tripRef: input.tripRef,
+          lists: [entity.listName]
+        });
+      }
     }
     drainer.kick();
     return op;
@@ -3515,17 +3619,39 @@ function createOfflineEngine(options) {
   return {
     events,
     snapshot,
+    reads,
     outbox,
     drainer,
     pull,
     blobs,
     share,
     async open() {
-      await Promise.all([snapshot.load(), outbox.load(), blobs?.load() ?? Promise.resolve()]);
+      await Promise.all([
+        snapshot.load(),
+        reads.load(),
+        outbox.load(),
+        blobs?.load() ?? Promise.resolve()
+      ]);
       unbind = drainer.bindOpportunisticTriggers();
       drainer.kick();
     },
     enqueue,
+    async discard(opId) {
+      const op = outbox.get(opId);
+      if (op === void 0) {
+        return;
+      }
+      await outbox.drop(opId);
+      const temporaryId = op.entity?.temporaryId;
+      if (op.entity === void 0 || temporaryId === void 0) {
+        return;
+      }
+      await snapshot.purgeEntity(op.tripRef, op.entity.listName, temporaryId);
+      events.emit("snapshot.updated", {
+        tripRef: op.tripRef,
+        lists: [op.entity.listName]
+      });
+    },
     async enqueueWithBlob(input) {
       const { blob, ...rest } = input;
       share?.assertWritable();
@@ -7411,6 +7537,6 @@ var KaafilClient = class {
   }
 };
 
-export { ACTIVE_TREK_REF, BATCH_THRESHOLD_OPS, BlobStatus, BoardStatus, BookingStatus, CONSOLIDATED_PULL_THRESHOLD_LISTS, ChecklistAudience, ChecklistGate, ChecklistItemStatus, ChecklistPhase, ChecklistPullTemplateMode, ClaimStatusIngest, CloseoutPackSection, CollectionMode, CompressionOutcome, Currency, ERROR_CODE_TABLE, EventType, ExpenseCategory, ExpensePaymentMode, FALLBACK_GLYPH, FileContentType, FilePurpose, FloatDirection, Gender, HEURISTIC_SEVERITY, ItineraryItemStatusUpdate, ItineraryItemType, KaafilAbortError, KaafilApiError, KaafilCapabilityUnavailableError, KaafilClient, KaafilClientAlreadyOpenError, KaafilClientNotOpenError, KaafilDeltaCursorInFlightError, KaafilEntitlementError, KaafilError, KaafilErrorCode, KaafilIndexedDbUnavailableError, KaafilInvalidRequestError, KaafilLockedError, KaafilNetworkError, KaafilNotFoundError, KaafilNotImplementedError, KaafilPaginationError, KaafilPaginationExhaustedError, KaafilPaginationInFlightError, KaafilRateLimitedError, KaafilReadOnlyRoleError, KaafilShareBatchUnauthenticatedError, KaafilShareLinkExpiredError, KaafilShareTokenExpiredError, KaafilShareTokenRevokedError, KaafilTimeoutError, KaafilTransportError, KaafilUnauthenticatedError, KaafilValidationError, KaafilVersionConflictError, MAX_BATCH_OPS, ManagerRole, ManifestMode, OutboxClass, OutboxRetryCause, OutboxStatus, PartyKind, PickupKind, Retryability, RoomType, RoomingFillOrder, RoomingGenderPolicy, RoomingHeuristicKey, SHADES_PER_FAMILY, SHARE_WRITE_GRACE_MS, SYNC_PULL_SECTIONS, SeatingFillOrder, SeatingGenderAdjacency, SeatingHeuristicKey, SyncOpMethod, TONE_FAMILIES, TriggerAnchor, TripMode, TripStatus, UNKNOWN_TONE_FAMILY, UnsatisfiableSchemeError, VehicleLayout, VehicleType, compressImage, convertImageLossless, createBlobLane, createDeltaCursor, createDrainer, createHttpOfflineTransport, createInMemoryStorageAdapter, createIndexedDbStorageAdapter, createOfflineEngine, createOfflineEvents, createOutbox, createPullCoordinator, createShareGuard, createSnapshotStore, createSyncResource, extractSectionRows, isCompressibleType, isImageCompressionSupported, isKaafilError, isRetryable, isRoomingHeuristicKey, isShareBatchPushAvailable, isTombstone, mergeDeltaRows, parseRoomingTone, readCurrentVersion, reconcileConflict, roomingHeuristicSeverity, scaledDimensions, shouldUseBatchTransport };
+export { ACTIVE_TREK_REF, BATCH_THRESHOLD_OPS, BlobStatus, BoardStatus, BookingStatus, CONSOLIDATED_PULL_THRESHOLD_LISTS, ChecklistAudience, ChecklistGate, ChecklistItemStatus, ChecklistPhase, ChecklistPullTemplateMode, ClaimStatusIngest, CloseoutPackSection, CollectionMode, CompressionOutcome, Currency, ERROR_CODE_TABLE, EventType, ExpenseCategory, ExpensePaymentMode, FALLBACK_GLYPH, FileContentType, FilePurpose, FloatDirection, Gender, HEURISTIC_SEVERITY, ItineraryItemStatusUpdate, ItineraryItemType, KaafilAbortError, KaafilApiError, KaafilCapabilityUnavailableError, KaafilClient, KaafilClientAlreadyOpenError, KaafilClientNotOpenError, KaafilDeltaCursorInFlightError, KaafilEntitlementError, KaafilError, KaafilErrorCode, KaafilIndexedDbUnavailableError, KaafilInvalidRequestError, KaafilLockedError, KaafilNetworkError, KaafilNotFoundError, KaafilNotImplementedError, KaafilPaginationError, KaafilPaginationExhaustedError, KaafilPaginationInFlightError, KaafilRateLimitedError, KaafilReadOnlyRoleError, KaafilShareBatchUnauthenticatedError, KaafilShareLinkExpiredError, KaafilShareTokenExpiredError, KaafilShareTokenRevokedError, KaafilTimeoutError, KaafilTransportError, KaafilUnauthenticatedError, KaafilValidationError, KaafilVersionConflictError, MAX_BATCH_OPS, ManagerRole, ManifestMode, OutboxClass, OutboxRetryCause, OutboxStatus, PartyKind, PickupKind, Retryability, RoomType, RoomingFillOrder, RoomingGenderPolicy, RoomingHeuristicKey, SHADES_PER_FAMILY, SHARE_WRITE_GRACE_MS, SYNC_PULL_SECTIONS, SeatingFillOrder, SeatingGenderAdjacency, SeatingHeuristicKey, SyncOpMethod, TONE_FAMILIES, TriggerAnchor, TripMode, TripStatus, UNKNOWN_TONE_FAMILY, UnsatisfiableSchemeError, VehicleLayout, VehicleType, compressImage, convertImageLossless, createBlobLane, createDeltaCursor, createDrainer, createHttpOfflineTransport, createInMemoryStorageAdapter, createIndexedDbStorageAdapter, createOfflineEngine, createOfflineEvents, createOutbox, createPullCoordinator, createReadCacheStore, createShareGuard, createSnapshotStore, createSyncResource, extractSectionRows, isCompressibleType, isImageCompressionSupported, isKaafilError, isRetryable, isRoomingHeuristicKey, isShareBatchPushAvailable, isTombstone, mergeDeltaRows, parseRoomingTone, readCurrentVersion, reconcileConflict, roomingHeuristicSeverity, scaledDimensions, shouldUseBatchTransport };
 //# sourceMappingURL=client-entry.js.map
 //# sourceMappingURL=client-entry.js.map