kaafil-js 0.1.0-beta.7 → 0.2.0

package/dist/client-entry.cjs

@@ -1478,6 +1478,10 @@ var CredentialResolver = class {
 };
 
 // src/config.ts
+var Environment = {
+  Live: "live",
+  Test: "test"
+};
 var ENVIRONMENT_BASE_URLS = {
   live: "https://engine.kaafil.in",
   test: "https://engine.kaafil.in"
@@ -1488,6 +1492,16 @@ var KaafilConfigError = class extends Error {
     this.name = "KaafilConfigError";
   }
 };
+function describeConfigValue(value) {
+  return typeof value === "string" ? `"${value}"` : String(value);
+}
+function assertValidEnvironment(environment) {
+  if (environment !== Environment.Live && environment !== Environment.Test) {
+    throw new KaafilConfigError(
+      `"environment" is required and must be "${Environment.Live}" or "${Environment.Test}"; received ${describeConfigValue(environment)}.`
+    );
+  }
+}
 function isValidAbsoluteUrl(value) {
   try {
     const url = new URL(value);
@@ -1497,6 +1511,7 @@ function isValidAbsoluteUrl(value) {
   }
 }
 function resolveBaseUrl(environment, baseUrl) {
+  assertValidEnvironment(environment);
   if (baseUrl === void 0) {
     return ENVIRONMENT_BASE_URLS[environment];
   }
@@ -2949,7 +2964,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;
   }
@@ -3019,7 +3062,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;
@@ -3056,6 +3099,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 {
@@ -3430,6 +3516,7 @@ 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 outbox = createOutbox({
     storage: options.storage,
     keyPrefix,
@@ -3502,14 +3589,21 @@ 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 enqueueWithBlob(input) {
@@ -7495,6 +7589,7 @@ exports.createOfflineEngine = createOfflineEngine;
 exports.createOfflineEvents = createOfflineEvents;
 exports.createOutbox = createOutbox;
 exports.createPullCoordinator = createPullCoordinator;
+exports.createReadCacheStore = createReadCacheStore;
 exports.createShareGuard = createShareGuard;
 exports.createSnapshotStore = createSnapshotStore;
 exports.createSyncResource = createSyncResource;