zapo-js 0.2.0 → 1.0.0

package/dist/appstate/{encoding.js → parsers/encoding.js}

@@ -4,14 +4,17 @@ exports.encodeAppStateFingerprint = encodeAppStateFingerprint;
 exports.decodeAppStateFingerprint = decodeAppStateFingerprint;
 exports.decodeAppStateSyncKeys = decodeAppStateSyncKeys;
 exports.decodeAppStateCollections = decodeAppStateCollections;
-const _proto_1 = require("../proto.js");
-const coercion_1 = require("../util/coercion");
+const _proto_1 = require("../../proto.js");
+const coercion_1 = require("../../util/coercion");
+const primitives_1 = require("../../util/primitives");
+/** Serializes an app-state sync key fingerprint to its protobuf bytes, or `null` when absent. */
 function encodeAppStateFingerprint(fingerprint) {
     if (!fingerprint) {
         return null;
     }
     return _proto_1.proto.Message.AppStateSyncKeyFingerprint.encode(fingerprint).finish();
 }
+/** Inverse of {@link encodeAppStateFingerprint}; throws on malformed input. */
 function decodeAppStateFingerprint(raw) {
     const bytes = (0, coercion_1.asOptionalBytes)(raw, 'appstate_sync_keys.fingerprint');
     if (!bytes) {
@@ -21,10 +24,10 @@ function decodeAppStateFingerprint(raw) {
         return _proto_1.proto.Message.AppStateSyncKeyFingerprint.decode(bytes);
     }
     catch (error) {
-        const reason = error instanceof Error ? error.message : String(error);
-        throw new Error(`invalid appstate_sync_keys.fingerprint protobuf payload: ${reason}`);
+        throw new Error(`invalid appstate_sync_keys.fingerprint protobuf payload: ${(0, primitives_1.toError)(error).message}`);
     }
 }
+/** Decodes app-state sync-key SQL rows into {@link WaAppStateSyncKey} records. */
 function decodeAppStateSyncKeys(rows) {
     const decoded = new Array(rows.length);
     for (let i = 0; i < rows.length; i += 1) {
@@ -38,6 +41,10 @@ function decodeAppStateSyncKeys(rows) {
     }
     return decoded;
 }
+/**
+ * Joins app-state collection-version and index-value SQL rows into the
+ * `collections` shape used by the in-memory app-state store.
+ */
 function decodeAppStateCollections(versionRows, valueRows) {
     const valueMapByCollection = new Map();
     for (const row of valueRows) {

package/dist/appstate/{WaAppStateSyncResponseParser.js → parsers/response-parser.js}

@@ -2,10 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSyncResponse = parseSyncResponse;
 exports.parseCollectionState = parseCollectionState;
-const utils_1 = require("./utils");
-const _proto_1 = require("../proto.js");
-const constants_1 = require("../protocol/constants");
-const helpers_1 = require("../transport/node/helpers");
+const utils_1 = require("../utils");
+const _proto_1 = require("../../proto.js");
+const constants_1 = require("../../protocol/constants");
+const helpers_1 = require("../../transport/node/helpers");
+const primitives_1 = require("../../util/primitives");
+/**
+ * Parses an app-state `sync` IQ response into one payload per collection,
+ * decoding embedded patches and snapshot references. Throws when the IQ is
+ * an error envelope or missing the `<sync>` child.
+ */
 function parseSyncResponse(iqNode) {
     if (iqNode.tag !== constants_1.WA_NODE_TAGS.IQ) {
         throw new Error(`invalid sync response tag ${iqNode.tag}`);
@@ -30,11 +36,10 @@ function parseSyncResponse(iqNode) {
         const versionAttr = collectionNode.attrs.version;
         let version;
         if (versionAttr) {
-            const parsedVersion = Number.parseInt(versionAttr, 10);
-            if (!Number.isSafeInteger(parsedVersion) || parsedVersion < 0) {
+            version = (0, primitives_1.parseOptionalInt)(versionAttr);
+            if (version === undefined) {
                 throw new Error(`invalid app-state collection version "${versionAttr}"`);
             }
-            version = parsedVersion;
         }
         const [patchesNode, snapshotNode] = (0, helpers_1.findNodeChildrenByTags)(collectionNode, [
             constants_1.WA_NODE_TAGS.PATCHES,
@@ -59,6 +64,11 @@ function parseSyncResponse(iqNode) {
     }
     return payloads;
 }
+/**
+ * Reads a `<collection>` node and returns the right
+ * {@link AppStateCollectionState} (success / has-more / conflict / fatal /
+ * retryable) based on its `type` attribute and embedded error code.
+ */
 function parseCollectionState(node) {
     const type = node.attrs.type;
     const hasMorePatches = node.attrs.has_more_patches === 'true';
@@ -75,7 +85,9 @@ function parseCollectionState(node) {
             : constants_1.WA_APP_STATE_COLLECTION_STATES.CONFLICT;
     }
     if (code === constants_1.WA_APP_STATE_ERROR_CODES.BAD_REQUEST ||
-        code === constants_1.WA_APP_STATE_ERROR_CODES.NOT_FOUND) {
+        code === constants_1.WA_APP_STATE_ERROR_CODES.NOT_FOUND ||
+        code === constants_1.WA_APP_STATE_ERROR_CODES.NOT_ALLOWED ||
+        code === constants_1.WA_APP_STATE_ERROR_CODES.NOT_ACCEPTABLE) {
         return constants_1.WA_APP_STATE_COLLECTION_STATES.ERROR_FATAL;
     }
     return constants_1.WA_APP_STATE_COLLECTION_STATES.ERROR_RETRY;