@bellachu/xteambail 2.0.0

package/lib/Utils/business.d.ts

@@ -0,0 +1,23 @@
+import type { CatalogCollection, OrderDetails, Product, ProductCreate, ProductUpdate, WAMediaUpload, WAMediaUploadFunction } from '../Types/index.js';
+import { type BinaryNode } from '../WABinary/index.js';
+export declare const parseCatalogNode: (node: BinaryNode) => {
+    products: Product[];
+    nextPageCursor: string | undefined;
+};
+export declare const parseCollectionsNode: (node: BinaryNode) => {
+    collections: CatalogCollection[];
+};
+export declare const parseOrderDetailsNode: (node: BinaryNode) => OrderDetails;
+export declare const toProductNode: (productId: string | undefined, product: ProductCreate | ProductUpdate) => BinaryNode;
+export declare const parseProductNode: (productNode: BinaryNode) => Product;
+/**
+ * Uploads images not already uploaded to WA's servers
+ */
+export declare function uploadingNecessaryImagesOfProduct<T extends ProductUpdate | ProductCreate>(product: T, waUploadToServer: WAMediaUploadFunction, timeoutMs?: number): Promise<T>;
+/**
+ * Uploads images not already uploaded to WA's servers
+ */
+export declare const uploadingNecessaryImages: (images: WAMediaUpload[], waUploadToServer: WAMediaUploadFunction, timeoutMs?: number) => Promise<{
+    url: string;
+}[]>;
+//# sourceMappingURL=business.d.ts.map

package/lib/Utils/business.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business.d.ts","sourceRoot":"","sources":["../../src/Utils/business.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACX,iBAAiB,EAEjB,YAAY,EAEZ,OAAO,EACP,aAAa,EACb,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,KAAK,UAAU,EAAuE,MAAM,aAAa,CAAA;AAIlH,eAAO,MAAM,gBAAgB,GAAI,MAAM,UAAU;;;CAShD,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,MAAM,UAAU;;CAkBpD,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,MAAM,UAAU,iBAyBrD,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,GAAG,SAAS,EAAE,SAAS,aAAa,GAAG,aAAa,eAwGlG,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,aAAa,UAAU,YAwBvD,CAAA;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAC9F,OAAO,EAAE,CAAC,EACV,gBAAgB,EAAE,qBAAqB,EACvC,SAAS,SAAS,cASlB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACpC,QAAQ,aAAa,EAAE,EACvB,kBAAkB,qBAAqB,EACvC,kBAAkB;SAGS,MAAM;IAiCjC,CAAA"}

package/lib/Utils/business.js

@@ -0,0 +1,247 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.uploadingNecessaryImages = exports.toProductNode = exports.parseProductNode = exports.parseOrderDetailsNode = exports.parseCollectionsNode = exports.parseCatalogNode = void 0;
+exports.uploadingNecessaryImagesOfProduct = uploadingNecessaryImagesOfProduct;
+var _boom = require("@hapi/boom");
+var _crypto = require("crypto");
+var _fs = require("fs");
+var _os = require("os");
+var _path = require("path");
+var _index = require("../WABinary/index.js");
+var _generics = require("./generics.js");
+var _messagesMedia = require("./messages-media.js");
+const parseCatalogNode = node => {
+  const catalogNode = (0, _index.getBinaryNodeChild)(node, 'product_catalog');
+  const products = (0, _index.getBinaryNodeChildren)(catalogNode, 'product').map(parseProductNode);
+  const paging = (0, _index.getBinaryNodeChild)(catalogNode, 'paging');
+  return {
+    products,
+    nextPageCursor: paging ? (0, _index.getBinaryNodeChildString)(paging, 'after') : undefined
+  };
+};
+exports.parseCatalogNode = parseCatalogNode;
+const parseCollectionsNode = node => {
+  const collectionsNode = (0, _index.getBinaryNodeChild)(node, 'collections');
+  const collections = (0, _index.getBinaryNodeChildren)(collectionsNode, 'collection').map(collectionNode => {
+    const id = (0, _index.getBinaryNodeChildString)(collectionNode, 'id');
+    const name = (0, _index.getBinaryNodeChildString)(collectionNode, 'name');
+    const products = (0, _index.getBinaryNodeChildren)(collectionNode, 'product').map(parseProductNode);
+    return {
+      id,
+      name,
+      products,
+      status: parseStatusInfo(collectionNode)
+    };
+  });
+  return {
+    collections
+  };
+};
+exports.parseCollectionsNode = parseCollectionsNode;
+const parseOrderDetailsNode = node => {
+  const orderNode = (0, _index.getBinaryNodeChild)(node, 'order');
+  const products = (0, _index.getBinaryNodeChildren)(orderNode, 'product').map(productNode => {
+    const imageNode = (0, _index.getBinaryNodeChild)(productNode, 'image');
+    return {
+      id: (0, _index.getBinaryNodeChildString)(productNode, 'id'),
+      name: (0, _index.getBinaryNodeChildString)(productNode, 'name'),
+      imageUrl: (0, _index.getBinaryNodeChildString)(imageNode, 'url'),
+      price: +(0, _index.getBinaryNodeChildString)(productNode, 'price'),
+      currency: (0, _index.getBinaryNodeChildString)(productNode, 'currency'),
+      quantity: +(0, _index.getBinaryNodeChildString)(productNode, 'quantity')
+    };
+  });
+  const priceNode = (0, _index.getBinaryNodeChild)(orderNode, 'price');
+  const orderDetails = {
+    price: {
+      total: +(0, _index.getBinaryNodeChildString)(priceNode, 'total'),
+      currency: (0, _index.getBinaryNodeChildString)(priceNode, 'currency')
+    },
+    products
+  };
+  return orderDetails;
+};
+exports.parseOrderDetailsNode = parseOrderDetailsNode;
+const toProductNode = (productId, product) => {
+  const attrs = {};
+  const content = [];
+  if (typeof productId !== 'undefined') {
+    content.push({
+      tag: 'id',
+      attrs: {},
+      content: Buffer.from(productId)
+    });
+  }
+  if (typeof product.name !== 'undefined') {
+    content.push({
+      tag: 'name',
+      attrs: {},
+      content: Buffer.from(product.name)
+    });
+  }
+  if (typeof product.description !== 'undefined') {
+    content.push({
+      tag: 'description',
+      attrs: {},
+      content: Buffer.from(product.description)
+    });
+  }
+  if (typeof product.retailerId !== 'undefined') {
+    content.push({
+      tag: 'retailer_id',
+      attrs: {},
+      content: Buffer.from(product.retailerId)
+    });
+  }
+  if (product.images.length) {
+    content.push({
+      tag: 'media',
+      attrs: {},
+      content: product.images.map(img => {
+        if (!('url' in img)) {
+          throw new _boom.Boom('Expected img for product to already be uploaded', {
+            statusCode: 400
+          });
+        }
+        return {
+          tag: 'image',
+          attrs: {},
+          content: [{
+            tag: 'url',
+            attrs: {},
+            content: Buffer.from(img.url.toString())
+          }]
+        };
+      })
+    });
+  }
+  if (typeof product.price !== 'undefined') {
+    content.push({
+      tag: 'price',
+      attrs: {},
+      content: Buffer.from(product.price.toString())
+    });
+  }
+  if (typeof product.currency !== 'undefined') {
+    content.push({
+      tag: 'currency',
+      attrs: {},
+      content: Buffer.from(product.currency)
+    });
+  }
+  if ('originCountryCode' in product) {
+    if (typeof product.originCountryCode === 'undefined') {
+      attrs['compliance_category'] = 'COUNTRY_ORIGIN_EXEMPT';
+    } else {
+      content.push({
+        tag: 'compliance_info',
+        attrs: {},
+        content: [{
+          tag: 'country_code_origin',
+          attrs: {},
+          content: Buffer.from(product.originCountryCode)
+        }]
+      });
+    }
+  }
+  if (typeof product.isHidden !== 'undefined') {
+    attrs['is_hidden'] = product.isHidden.toString();
+  }
+  const node = {
+    tag: 'product',
+    attrs,
+    content
+  };
+  return node;
+};
+exports.toProductNode = toProductNode;
+const parseProductNode = productNode => {
+  const isHidden = productNode.attrs.is_hidden === 'true';
+  const id = (0, _index.getBinaryNodeChildString)(productNode, 'id');
+  const mediaNode = (0, _index.getBinaryNodeChild)(productNode, 'media');
+  const statusInfoNode = (0, _index.getBinaryNodeChild)(productNode, 'status_info');
+  const product = {
+    id,
+    imageUrls: parseImageUrls(mediaNode),
+    reviewStatus: {
+      whatsapp: (0, _index.getBinaryNodeChildString)(statusInfoNode, 'status')
+    },
+    availability: 'in stock',
+    name: (0, _index.getBinaryNodeChildString)(productNode, 'name'),
+    retailerId: (0, _index.getBinaryNodeChildString)(productNode, 'retailer_id'),
+    url: (0, _index.getBinaryNodeChildString)(productNode, 'url'),
+    description: (0, _index.getBinaryNodeChildString)(productNode, 'description'),
+    price: +(0, _index.getBinaryNodeChildString)(productNode, 'price'),
+    currency: (0, _index.getBinaryNodeChildString)(productNode, 'currency'),
+    isHidden
+  };
+  return product;
+};
+/**
+ * Uploads images not already uploaded to WA's servers
+ */
+exports.parseProductNode = parseProductNode;
+async function uploadingNecessaryImagesOfProduct(product, waUploadToServer, timeoutMs = 30000) {
+  product = {
+    ...product,
+    images: product.images ? await uploadingNecessaryImages(product.images, waUploadToServer, timeoutMs) : product.images
+  };
+  return product;
+}
+/**
+ * Uploads images not already uploaded to WA's servers
+ */
+const uploadingNecessaryImages = async (images, waUploadToServer, timeoutMs = 30000) => {
+  const results = await Promise.all(images.map(async img => {
+    if ('url' in img) {
+      const url = img.url.toString();
+      if (url.includes('.whatsapp.net')) {
+        return {
+          url
+        };
+      }
+    }
+    const {
+      stream
+    } = await (0, _messagesMedia.getStream)(img);
+    const hasher = (0, _crypto.createHash)('sha256');
+    const filePath = (0, _path.join)((0, _os.tmpdir)(), 'img' + (0, _generics.generateMessageIDV2)());
+    const encFileWriteStream = (0, _fs.createWriteStream)(filePath);
+    for await (const block of stream) {
+      hasher.update(block);
+      encFileWriteStream.write(block);
+    }
+    const sha = hasher.digest('base64');
+    const {
+      directPath
+    } = await waUploadToServer(filePath, {
+      mediaType: 'product-catalog-image',
+      fileEncSha256B64: sha,
+      timeoutMs
+    });
+    await _fs.promises.unlink(filePath).catch(err => console.log('Error deleting temp file ', err));
+    return {
+      url: (0, _messagesMedia.getUrlFromDirectPath)(directPath)
+    };
+  }));
+  return results;
+};
+exports.uploadingNecessaryImages = uploadingNecessaryImages;
+const parseImageUrls = mediaNode => {
+  const imgNode = (0, _index.getBinaryNodeChild)(mediaNode, 'image');
+  return {
+    requested: (0, _index.getBinaryNodeChildString)(imgNode, 'request_image_url'),
+    original: (0, _index.getBinaryNodeChildString)(imgNode, 'original_image_url')
+  };
+};
+const parseStatusInfo = mediaNode => {
+  const node = (0, _index.getBinaryNodeChild)(mediaNode, 'status_info');
+  return {
+    status: (0, _index.getBinaryNodeChildString)(node, 'status'),
+    canAppeal: (0, _index.getBinaryNodeChildString)(node, 'can_appeal') === 'true'
+  };
+};
+//# sourceMappingURL=business.js.map

package/lib/Utils/business.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business.js","sourceRoot":"","sources":["../../src/Utils/business.ts"],"names":[],"mappings":"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"}

package/lib/Utils/chat-utils.d.ts

@@ -0,0 +1,100 @@
+import { proto } from '../../WAProto/index.js';
+import type { xrlEventEmitter, ChatModification, ChatMutation, Contact, InitialAppStateSyncOptions, LTHashState, WAPatchCreate, WAPatchName } from '../Types/index.js';
+import { type BinaryNode } from '../WABinary/index.js';
+import type { ILogger } from './logger.js';
+type FetchAppStateSyncKey = (keyId: string) => Promise<proto.Message.IAppStateSyncKeyData | null | undefined>;
+export type ChatMutationMap = {
+    [index: string]: ChatMutation;
+};
+type Mac = {
+    indexMac: Uint8Array;
+    valueMac: Uint8Array;
+    operation: proto.SyncdMutation.SyncdOperation;
+};
+export declare const makeLtHashGenerator: ({ indexValueMap, hash }: Pick<LTHashState, "hash" | "indexValueMap">) => {
+    mix: ({ indexMac, valueMac, operation }: Mac) => void;
+    finish: () => {
+        hash: Buffer<ArrayBuffer>;
+        indexValueMap: {
+            [indexMacBase64: string]: {
+                valueMac: Uint8Array | Buffer;
+            };
+        };
+    };
+};
+export declare const newLTHashState: () => LTHashState;
+export declare const ensureLTHashStateVersion: (state: LTHashState) => LTHashState;
+export declare const MAX_SYNC_ATTEMPTS = 2;
+/**
+ * Check if an error is a missing app state sync key.
+ * WA Web treats these as "Blocked" (waits for key arrival), not fatal.
+ * In xrl we retry with a snapshot which may use a different key.
+ */
+export declare const isMissingKeyError: (error: any) => boolean;
+/**
+ * Determines if an app state sync error is unrecoverable.
+ * TypeError indicates a WASM crash; otherwise we give up after MAX_SYNC_ATTEMPTS.
+ * Missing keys are NOT checked here — they are handled separately as "Blocked".
+ */
+export declare const isAppStateSyncIrrecoverable: (error: any, attempts: number) => boolean;
+export declare const encodeSyncdPatch: ({ type, index, syncAction, apiVersion, operation }: WAPatchCreate, myAppStateKeyId: string, state: LTHashState, getAppStateSyncKey: FetchAppStateSyncKey) => Promise<{
+    patch: proto.ISyncdPatch;
+    state: LTHashState;
+}>;
+export declare const decodeSyncdMutations: (msgMutations: (proto.ISyncdMutation | proto.ISyncdRecord)[], initialState: LTHashState, getAppStateSyncKey: FetchAppStateSyncKey, onMutation: (mutation: ChatMutation) => void, validateMacs: boolean) => Promise<{
+    hash: Buffer<ArrayBuffer>;
+    indexValueMap: {
+        [indexMacBase64: string]: {
+            valueMac: Uint8Array | Buffer;
+        };
+    };
+}>;
+export declare const decodeSyncdPatch: (msg: proto.ISyncdPatch, name: WAPatchName, initialState: LTHashState, getAppStateSyncKey: FetchAppStateSyncKey, onMutation: (mutation: ChatMutation) => void, validateMacs: boolean) => Promise<{
+    hash: Buffer<ArrayBuffer>;
+    indexValueMap: {
+        [indexMacBase64: string]: {
+            valueMac: Uint8Array | Buffer;
+        };
+    };
+}>;
+export declare const extractSyncdPatches: (result: BinaryNode, options: RequestInit) => Promise<{
+    critical_unblock_low: {
+        patches: proto.ISyncdPatch[];
+        hasMorePatches: boolean;
+        snapshot?: proto.ISyncdSnapshot;
+    };
+    regular_high: {
+        patches: proto.ISyncdPatch[];
+        hasMorePatches: boolean;
+        snapshot?: proto.ISyncdSnapshot;
+    };
+    regular_low: {
+        patches: proto.ISyncdPatch[];
+        hasMorePatches: boolean;
+        snapshot?: proto.ISyncdSnapshot;
+    };
+    critical_block: {
+        patches: proto.ISyncdPatch[];
+        hasMorePatches: boolean;
+        snapshot?: proto.ISyncdSnapshot;
+    };
+    regular: {
+        patches: proto.ISyncdPatch[];
+        hasMorePatches: boolean;
+        snapshot?: proto.ISyncdSnapshot;
+    };
+}>;
+export declare const downloadExternalBlob: (blob: proto.IExternalBlobReference, options: RequestInit) => Promise<Buffer<ArrayBuffer>>;
+export declare const downloadExternalPatch: (blob: proto.IExternalBlobReference, options: RequestInit) => Promise<proto.SyncdMutations>;
+export declare const decodeSyncdSnapshot: (name: WAPatchName, snapshot: proto.ISyncdSnapshot, getAppStateSyncKey: FetchAppStateSyncKey, minimumVersionNumber: number | undefined, validateMacs?: boolean, logger?: ILogger) => Promise<{
+    state: LTHashState;
+    mutationMap: ChatMutationMap;
+}>;
+export declare const decodePatches: (name: WAPatchName, syncds: proto.ISyncdPatch[], initial: LTHashState, getAppStateSyncKey: FetchAppStateSyncKey, options: RequestInit, minimumVersionNumber?: number, logger?: ILogger, validateMacs?: boolean) => Promise<{
+    state: LTHashState;
+    mutationMap: ChatMutationMap;
+}>;
+export declare const chatModificationToAppPatch: (mod: ChatModification, jid: string) => WAPatchCreate;
+export declare const processSyncAction: (syncAction: ChatMutation, ev: xrlEventEmitter, me: Contact, initialSyncOpts?: InitialAppStateSyncOptions, logger?: ILogger) => void;
+export {};
+//# sourceMappingURL=chat-utils.d.ts.map

package/lib/Utils/chat-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-utils.d.ts","sourceRoot":"","sources":["../../src/Utils/chat-utils.ts"],"names":[],"mappings":"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"}