@shushed/helpers 0.0.220 → 0.0.222

package/dist/cjs/src-public/centra.js

@@ -276,7 +276,7 @@ class CentraHelper extends env_1.default {
                     nextCursor = null;
                 }
                 if (campaignConnection && campaignConnection.edges?.length) {
-                    for (let i = campaignConnection.edges.length; i < (names?.length || 0); i++) {
+                    for (let i = 0; i < campaignConnection.edges.length; i++) {
                         const { node } = campaignConnection.edges[i];
                         result[node.name] = node;
                     }

package/dist/cjs/src-public/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RedisConnectionError = exports.RateLimit = exports.setHeaders = exports.BCOrderHelper = exports.DatoHelper = exports.AirtableHelper = exports.CentraHelper = exports.BigQueryHelper = exports.JWKSHelper = exports.CloudTasksHelper = exports.Secrets = exports.SchedulerHelper = exports.Logging = exports.Runtime = exports.PubSubHelper = exports.EnvEngine = exports.validate = void 0;
+exports.SitooHelper = exports.RedisConnectionError = exports.RateLimit = exports.setHeaders = exports.BCOrderHelper = exports.DatoHelper = exports.AirtableHelper = exports.CentraHelper = exports.BigQueryHelper = exports.JWKSHelper = exports.CloudTasksHelper = exports.Secrets = exports.SchedulerHelper = exports.Logging = exports.Runtime = exports.PubSubHelper = exports.EnvEngine = exports.validate = void 0;
 var validate_1 = require("./validate");
 Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return __importDefault(validate_1).default; } });
 __exportStar(require("./sanitize"), exports);
@@ -52,3 +52,5 @@ Object.defineProperty(exports, "setHeaders", { enumerable: true, get: function (
 var rateLimit_1 = require("./rateLimit");
 Object.defineProperty(exports, "RateLimit", { enumerable: true, get: function () { return __importDefault(rateLimit_1).default; } });
 Object.defineProperty(exports, "RedisConnectionError", { enumerable: true, get: function () { return rateLimit_1.RedisConnectionError; } });
+var sitoo_1 = require("./sitoo");
+Object.defineProperty(exports, "SitooHelper", { enumerable: true, get: function () { return __importDefault(sitoo_1).default; } });

package/dist/cjs/src-public/sitoo.js

@@ -0,0 +1,279 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const crypto_1 = __importDefault(require("crypto"));
+const lodash_groupby_1 = __importDefault(require("lodash.groupby"));
+const env_1 = __importDefault(require("./env"));
+const SITOO_TR_TYPE_MANUAL_IN = 10;
+const SITOO_TR_TYPE_MANUAL_OUT = 20;
+const BATCH_SIZE = 900;
+class SitooHelper extends env_1.default {
+    opts;
+    shaToken;
+    baseUrl;
+    siteId;
+    constructor(options, opts) {
+        super(options);
+        this.opts = opts;
+        this.shaToken = crypto_1.default.createHash('sha256').update(opts.accessToken).digest('hex').slice(0, 8);
+        this.baseUrl = opts.sitooBaseUrl.replace(/\/$/, '');
+        this.siteId = opts.sitooSiteId;
+    }
+    async getSitooWarehouses() {
+        const url = `${this.baseUrl}/sites/${this.siteId}/warehouses.json`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Basic ${this.opts.accessToken}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => 'Unknown error');
+            throw new Error(`Sitoo API error: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        const data = await response.json();
+        const nameToId = {};
+        const warehouses = {};
+        for (const warehouse of data.items) {
+            nameToId[warehouse.name] = warehouse.warehouseid;
+            warehouses[warehouse.warehouseid] = warehouse;
+        }
+        return { nameToId, warehouses };
+    }
+    async fetchWarehouseTransactionsWithFilter(params) {
+        const queryParams = new URLSearchParams();
+        queryParams.set('num', (params.num || 100).toString());
+        if (params.transactiontype !== undefined) {
+            queryParams.set('transactiontype', params.transactiontype.toString());
+        }
+        if (params.datecreatedfrom !== undefined) {
+            queryParams.set('datecreatedfrom', params.datecreatedfrom.toString());
+        }
+        if (params.start !== undefined) {
+            queryParams.set('start', params.start.toString());
+        }
+        queryParams.set('sort', params.ascending ? 'warehousetransactionid' : '-warehousetransactionid');
+        const url = `${this.baseUrl}/sites/${this.siteId}/warehouses/${params.warehouseid}/warehousetransactions.json?${queryParams.toString()}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Basic ${this.opts.accessToken}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => 'Unknown error');
+            throw new Error(`Sitoo API error: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        return await response.json();
+    }
+    async searchTransactionsInApi(warehouseId, entryNosToFind, transactionType, datecreatedfrom) {
+        const found = new Map();
+        let lowestTransactionId = undefined;
+        if (entryNosToFind.size === 0) {
+            return { found, lowestTransactionId };
+        }
+        let hasMore = true;
+        const pageSize = 100;
+        const currentDateFrom = datecreatedfrom;
+        let currentStart = 0;
+        while (hasMore && found.size < entryNosToFind.size) {
+            const envelope = await this.fetchWarehouseTransactionsWithFilter({
+                warehouseid: warehouseId,
+                datecreatedfrom: currentDateFrom,
+                transactiontype: transactionType,
+                ascending: false,
+                num: pageSize,
+                start: currentStart,
+            });
+            const transactions = envelope.items;
+            if (transactions.length === 0) {
+                hasMore = false;
+                break;
+            }
+            for (const transaction of transactions) {
+                if (lowestTransactionId === undefined || transaction.warehousetransactionid < lowestTransactionId) {
+                    lowestTransactionId = transaction.warehousetransactionid;
+                }
+                if (transaction.description) {
+                    for (const entryNo of entryNosToFind) {
+                        if (!found.has(entryNo) && transaction.description.includes(`'${entryNo}'`)) {
+                            found.set(entryNo, transaction);
+                        }
+                    }
+                }
+                if (found.size === entryNosToFind.size) {
+                    break;
+                }
+            }
+            currentStart = currentStart ? currentStart + transactions.length : transactions.length;
+            if (transactions.length < pageSize) {
+                hasMore = false;
+            }
+        }
+        return { found, lowestTransactionId };
+    }
+    async batchAddWarehouseTransactions(transactions) {
+        if (transactions.length === 0)
+            return [];
+        if (transactions.length > BATCH_SIZE) {
+            throw new Error(`Batch size exceeds maximum of ${BATCH_SIZE}. Got ${transactions.length}`);
+        }
+        const url = `${this.baseUrl}/sites/${this.siteId}/warehousetransactions.json`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Basic ${this.opts.accessToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(transactions),
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => 'Unknown error');
+            throw new Error(`Sitoo API error: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        const result = await response.json();
+        return result;
+    }
+    async syncWarehouseTransactions(items, options) {
+        if (items.length === 0) {
+            return [];
+        }
+        const locationCodeToWarehouse = (await this.getSitooWarehouses()).nameToId;
+        const foundEntryNos = new Map();
+        const results = {};
+        const entryNoToIdx = {};
+        const entriesByWarehouseAndTransactionType = new Map();
+        for (let i = 0; i < items.length; i++) {
+            const entry = items[i];
+            const warehouseId = locationCodeToWarehouse[entry.location_code];
+            const transactionType = entry.type === 'transfer' ? (entry.quantity > 0 ? SITOO_TR_TYPE_MANUAL_IN : SITOO_TR_TYPE_MANUAL_OUT) : undefined;
+            entryNoToIdx[entry.entry_no] = i;
+            if (transactionType === undefined) {
+                results[i] = {
+                    error: false,
+                    message: `Not supported transaction type: ${entry.type}`,
+                };
+                continue;
+            }
+            if (warehouseId === undefined) {
+                results[i] = {
+                    error: false,
+                    message: `Not supported warehouse in Sitoo: ${entry.location_code}`,
+                };
+                continue;
+            }
+            const key = `${warehouseId}-${transactionType}`;
+            if (!entriesByWarehouseAndTransactionType.has(key)) {
+                entriesByWarehouseAndTransactionType.set(key, []);
+            }
+            entriesByWarehouseAndTransactionType.get(key).push(entry);
+        }
+        for (const [_, warehouseEntries] of entriesByWarehouseAndTransactionType) {
+            if (warehouseEntries.length > 0) {
+                let datecreatedfrom = undefined;
+                for (const entry of warehouseEntries) {
+                    const entryCreatedAt = Math.floor(new Date(entry.created_at).getTime() / 1000);
+                    if (datecreatedfrom === undefined || entryCreatedAt < datecreatedfrom) {
+                        datecreatedfrom = entryCreatedAt;
+                    }
+                }
+                const { found: apiFound } = await this.searchTransactionsInApi(locationCodeToWarehouse[warehouseEntries[0].location_code], new Set(warehouseEntries.map(e => e.entry_no.toString())), warehouseEntries[0].quantity > 0 ? SITOO_TR_TYPE_MANUAL_IN : SITOO_TR_TYPE_MANUAL_OUT, datecreatedfrom);
+                for (const [entryNo, transaction] of apiFound) {
+                    foundEntryNos.set(entryNo, transaction.warehousetransactionid);
+                }
+            }
+        }
+        for (const [entryNo, transactionId] of foundEntryNos) {
+            const idx = entryNoToIdx[entryNo];
+            results[idx] = {
+                error: false,
+                message: `Found transaction in Sitoo: ${transactionId} for the entry ${entryNo}`,
+            };
+        }
+        const batches = [[]];
+        for (const [_, warehouseEntries] of entriesByWarehouseAndTransactionType) {
+            for (let i = 0; i < warehouseEntries.length; i += 1) {
+                if (!foundEntryNos.has(warehouseEntries[i].entry_no)) {
+                    if ((batches[batches.length - 1].length + 1) >= BATCH_SIZE) {
+                        batches.push([]);
+                    }
+                    batches[batches.length - 1].push(warehouseEntries[i]);
+                }
+            }
+        }
+        const hasMissingEntries = batches[0].length > 0;
+        if (!options?.preview && hasMissingEntries) {
+            for (let i = 0; i < batches.length; i++) {
+                const warehouseEntities = (0, lodash_groupby_1.default)(batches[i], e => `${locationCodeToWarehouse[e.location_code]}-${e.quantity > 0 ? 'positive' : 'negative'}`);
+                const entryNosInBatches = {};
+                const transactionsToCreate = [];
+                for (const k in warehouseEntities) {
+                    const entriesToCreate = warehouseEntities[k];
+                    const warehouseId = locationCodeToWarehouse[entriesToCreate[0].location_code];
+                    const entryType = entriesToCreate[0].quantity > 0 ? SITOO_TR_TYPE_MANUAL_IN : SITOO_TR_TYPE_MANUAL_OUT;
+                    entryNosInBatches[transactionsToCreate.length] = entriesToCreate.map(e => e.entry_no);
+                    transactionsToCreate.push({
+                        warehouseid: warehouseId,
+                        transactiontype: entryType,
+                        description: entriesToCreate.map(e => `'${e.entry_no}'`).join(', '),
+                        items: entriesToCreate.map(e => ({
+                            sku: [e.style_id, e.colour_id, e.size_code].filter(Boolean).join('-'),
+                            decimalquantity: `${e.quantity.toFixed(3)}`,
+                            moneypricein: (((e.unit_cost?.value ?? 0) / 100) * e.quantity).toFixed(2),
+                        })),
+                    });
+                }
+                try {
+                    const createdIds = await this.batchAddWarehouseTransactions(transactionsToCreate);
+                    for (let j = 0; j < transactionsToCreate.length; j++) {
+                        const transactionId = createdIds[j];
+                        for (let k = 0; k < entryNosInBatches[j].length; k += 1) {
+                            const entryNo = entryNosInBatches[j][k];
+                            const idx = entryNoToIdx[entryNo];
+                            results[idx] = {
+                                entryNo: entryNo,
+                                transactionId: transactionId,
+                            };
+                        }
+                    }
+                }
+                catch (error) {
+                    for (const entry of batches[i]) {
+                        const idx = entryNoToIdx[entry.entry_no];
+                        results[idx] = error;
+                    }
+                }
+            }
+        }
+        else {
+            for (let i = 0; i < batches.length; i++) {
+                for (let j = 0; j < batches[i].length; j += 1) {
+                    const entry = batches[i][j];
+                    const idx = entryNoToIdx[entry.entry_no];
+                    const warehouseId = locationCodeToWarehouse[entry.location_code];
+                    const transactionType = entry.quantity > 0 ? SITOO_TR_TYPE_MANUAL_IN : SITOO_TR_TYPE_MANUAL_OUT;
+                    results[idx] = {
+                        error: false,
+                        message: `In Preview Mode. ${entry.entry_no} scheduled to be created as transction type: ${transactionType} in the warehouse: ${warehouseId}. Batch: ${i}`
+                    };
+                }
+            }
+        }
+        const resultsAsArray = [];
+        for (let i = 0; i < items.length; i += 1) {
+            const result = results[i];
+            if (!result) {
+                resultsAsArray.push(new Error(`${items[i].entry_no} got missed in processing`));
+            }
+            else {
+                resultsAsArray.push(result);
+            }
+        }
+        return resultsAsArray;
+    }
+}
+exports.default = SitooHelper;

package/dist/package.json

@@ -5,6 +5,7 @@
   "license": "UNLICENSED",
   "description": "",
   "dependencies": {
+    "@google-cloud/firestore": "^7.11.1",
     "@hackylabs/deep-redact": "^2.2.1",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
@@ -12,15 +13,15 @@
     "jose": "^6.0.11",
     "lodash.chunk": "^4.2.0",
     "lodash.clonedeep": "^4.5.0",
+    "lodash.groupby": "^4.6.0",
     "lodash.isequal": "^4.5.0",
     "lodash.omit": "^4.5.0",
     "lodash.pick": "^4.4.0",
     "mime-types": "^3.0.1",
     "p-limit": "^7.1.1",
     "rate-limiter-flexible": "^7.2.0",
-    "uuid": "^11.1.0",
     "redis": "^5.6.0",
-    "@google-cloud/firestore": "^7.11.1"
+    "uuid": "^11.1.0"
   },
   "files": [
     "dist"

package/dist/types/src-public/index.d.ts

@@ -17,3 +17,4 @@ export { default as setHeaders } from './setHeaders';
 export { type CentraError, type CentraErrors, type BasicCentraCountry, type BasicCentraMarket, type BasicCentraSizeChart, type BasicPricelist, type BasicCentraWarehouse, type BasicCentraCampaign, type BasicCentraProduct, type BasicCentraVariant, type BasicCentraDisplay } from './centra';
 export { default as RateLimit, RedisConnectionError } from './rateLimit';
 export { type TriggerOnCreateOptions, type TriggerOnExecuteOptions, type NodeOptions, type RNConfiguration, type TriggerExtraOptions } from './types';
+export { default as SitooHelper, type UnitCost, type StockMovementInput, type BasicSitooWarehouse, type BasicSitooStore, type BasicWarehouseTransaction, type WarehouseTransactionEnvelope, type WarehouseTransactionSyncOptions } from './sitoo';

package/dist/types/src-public/sitoo.d.ts

@@ -0,0 +1,119 @@
+import EnvEngine from './env';
+import Runtime from './runtime';
+export interface UnitCost {
+    value: number;
+    decimal_places: number;
+    currency: string;
+    lcy_value: number;
+    lcy_currency: string;
+    lcy_decimal_places: number;
+}
+export interface StockMovementInput {
+    style_id: string;
+    colour_id: string;
+    size_code: string;
+    location_code: string;
+    last_updated_at?: string;
+    entry_no: string;
+    quantity: number;
+    document_no: string;
+    external_document_no?: string;
+    type: 'transfer' | 'negative adjustment' | 'positive adjustment' | 'purchase' | 'sale';
+    unit_cost?: UnitCost;
+    document_date?: string;
+    posting_date?: string;
+    created_at: string;
+}
+export type BasicSitooWarehouse = {
+    warehouseid: number;
+    warehousetype: string;
+    usetype: string;
+    storeid: number;
+    sellable: boolean;
+    name: string;
+    externalId: number;
+};
+export type BasicSitooStore = {
+    storeid: number;
+    name: string;
+    externalId: number;
+};
+export type BasicWarehouseTransaction = {
+    warehousetransactionid: number;
+    warehouseid: number;
+    datecreated: number;
+    transactiontype: number;
+    description: string;
+    orderdeliveryid: number | null;
+    shipmentid: number | null;
+    externalid: string | null;
+    reasoncode: string | null;
+    items: Array<{
+        decimalquantity: string;
+        decimaltotal: string;
+        moneypricein: string;
+        moneytotal: string;
+        moneyvalue: string;
+        sku: string;
+    }>;
+};
+export type WarehouseTransactionEnvelope = {
+    totalcount: number;
+    items: BasicWarehouseTransaction[];
+};
+export interface WarehouseTransactionSyncOptions {
+    preview?: boolean;
+    skuGenerator?: (styleId: string, colourId: string, sizeCode: string) => string;
+}
+export interface WarehouseTransactionSyncResult {
+    found: Array<{
+        entryNo: string;
+        transactionId: number;
+    }>;
+    missing: string[];
+    created: Array<{
+        entryNo: string;
+        transactionId: number;
+    }>;
+    errors: Array<{
+        entryNo: string;
+        error: string;
+    }>;
+    firestoreUpdated: boolean;
+    skipped: Array<{
+        entryNo: string;
+        reason: string;
+    }>;
+}
+export interface FirestoreCacheDocument {
+    [entryNo: string]: number;
+}
+export default class SitooHelper extends EnvEngine {
+    protected opts: {
+        accessToken: string;
+        sitooBaseUrl: string;
+        sitooSiteId: number;
+    };
+    shaToken: string;
+    baseUrl: string;
+    siteId: number;
+    constructor(options: ConstructorParameters<typeof Runtime>[0], opts: {
+        accessToken: string;
+        sitooBaseUrl: string;
+        sitooSiteId: number;
+    });
+    getSitooWarehouses(): Promise<{
+        nameToId: Record<string, number>;
+        warehouses: Record<number, BasicSitooWarehouse>;
+    }>;
+    private fetchWarehouseTransactionsWithFilter;
+    private searchTransactionsInApi;
+    private batchAddWarehouseTransactions;
+    syncWarehouseTransactions(items: StockMovementInput[], options?: WarehouseTransactionSyncOptions): Promise<Array<{
+        entryNo: string;
+        transactionId: number;
+    } | Error | {
+        error: boolean;
+        message: string;
+    }>>;
+}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@shushed/helpers",
-  "version": "0.0.220",
+  "version": "0.0.222",
   "author": "",
   "license": "UNLICENSED",
   "description": "",
   "dependencies": {
+    "@google-cloud/firestore": "^7.11.1",
     "@hackylabs/deep-redact": "^2.2.1",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
@@ -12,15 +13,15 @@
     "jose": "^6.0.11",
     "lodash.chunk": "^4.2.0",
     "lodash.clonedeep": "^4.5.0",
+    "lodash.groupby": "^4.6.0",
     "lodash.isequal": "^4.5.0",
     "lodash.omit": "^4.5.0",
     "lodash.pick": "^4.4.0",
     "mime-types": "^3.0.1",
     "p-limit": "^7.1.1",
     "rate-limiter-flexible": "^7.2.0",
-    "uuid": "^11.1.0",
     "redis": "^5.6.0",
-    "@google-cloud/firestore": "^7.11.1"
+    "uuid": "^11.1.0"
   },
   "files": [
     "dist"