repzo 1.0.231 → 1.0.233

package/lib/helper.d.ts

@@ -0,0 +1 @@
+export declare const generateUUID: (prefix?: string, suffix?: string, length?: number) => string;

package/lib/helper.js

@@ -0,0 +1,17 @@
+import crypto from "crypto";
+export const generateUUID = (prefix = "", suffix = "", length = 8) => {
+    if ((prefix && typeof prefix !== "string") ||
+        (suffix && typeof suffix !== "string")) {
+        throw new Error("Prefix and suffix must be strings");
+    }
+    if (typeof crypto === "undefined" ||
+        typeof crypto.randomBytes !== "function") {
+        throw new Error("crypto module or randomBytes function is unavailable");
+    }
+    const randomPortion = BigInt(`0x${crypto.randomBytes(length).toString("hex")}`).toString(36);
+    const timestamp = Date.now().toString(36);
+    const formattedPrefix = prefix ? `${prefix}-` : "";
+    const formattedSuffix = suffix ? `-${suffix}` : "";
+    const uuid = `${formattedPrefix}${timestamp}${randomPortion}${formattedSuffix}`;
+    return uuid;
+};

package/lib/index.d.ts

@@ -118,6 +118,8 @@ export declare const end_points: {
     readonly CLM_FETCH: "clm-fetch";
     readonly PROMOTIONS: "promotions";
     readonly COMPARE_INVOICE_TO_WAREHOUSE: "compare-invoice-to-warehouse";
+    readonly AUTHENTICATE: "authenticate";
+    readonly OPTIONAL_BUSINESS_APP_SERVICE: "optional-business-app-service";
 };
 export type EndPoints = (typeof end_points)[keyof typeof end_points];
 export declare const availableService: readonly ["client", "product", "variant", "category", "sub_category", "brand", "product_group", "tax", "measureunit", "measureunitFamily", "media", "priceList", "priceListItem", "team", "returnReason", "rep", "tag", "warehouse", "route", "productModifiersGroup", "channel", "speciality", "clientContact", "paymentTerm", "bank", "bank_list", "customStatus", "customList", "customListItem", "inventoryAdjustmentReason", "workorder", "workorderRequest", "supplier", "quickConvertToPdf", "visit", "activityFeedback", "activityFeedbackV2", "feedbackOption", "invoice", "proforma", "payment", "refund", "settlement", "voidSettlement", "check", "day", "receivingMaterial", "adjustAccount", "transfer", "msl", "mslProduct", "mediaStorage", "storecheckTemplate", "activityStorecheck", "adjustInventory", "inventory", "integrationApp", "joinActionsWebHook", "patchAction", "updateIntegrationMeta", "assetPartType", "assetPart", "assetPartUnit", "assetPartReceival", "assetPartTransfer", "returnAssetPartUnit", "storeAssetPartUnit", "ocrInvoiceJobTemplate", "ocrInvoiceJobGroup", "activityAiSalesOrder", "ocrInvoiceJob", "ocrInvoiceJobPage", "settings", "mailUnsubscribe", "approvalRequest", "safeInvoiceSerialCounter", "clientLocation", "assetType", "asset", "assetUnit", "workorderPortal", "approval", "workorderCategory", "contract", "contractInstallment", "repBalanceSummary", "workorderPortalLink", "customField", "salesAnalyticsReport", "clmPresentation", "clmSequence", "clmSlide", "clmFetch"];
@@ -127,6 +129,9 @@ export default class Repzo {
     headers: Headers;
     private timeout;
     private retryAttempts;
+    private refresh_token?;
+    private nameSpace?;
+    private reauthCallBackFn?;
     constructor(apiKey: string, options?: Options);
     private static _end_points;
     static get END_POINTS(): {
@@ -248,6 +253,8 @@ export default class Repzo {
         readonly CLM_FETCH: "clm-fetch";
         readonly PROMOTIONS: "promotions";
         readonly COMPARE_INVOICE_TO_WAREHOUSE: "compare-invoice-to-warehouse";
+        readonly AUTHENTICATE: "authenticate";
+        readonly OPTIONAL_BUSINESS_APP_SERVICE: "optional-business-app-service";
     };
     private _retryRequest;
     private _fetch;
@@ -256,6 +263,18 @@ export default class Repzo {
     private _patch;
     private _delete;
     available_services: readonly ["client", "product", "variant", "category", "sub_category", "brand", "product_group", "tax", "measureunit", "measureunitFamily", "media", "priceList", "priceListItem", "team", "returnReason", "rep", "tag", "warehouse", "route", "productModifiersGroup", "channel", "speciality", "clientContact", "paymentTerm", "bank", "bank_list", "customStatus", "customList", "customListItem", "inventoryAdjustmentReason", "workorder", "workorderRequest", "supplier", "quickConvertToPdf", "visit", "activityFeedback", "activityFeedbackV2", "feedbackOption", "invoice", "proforma", "payment", "refund", "settlement", "voidSettlement", "check", "day", "receivingMaterial", "adjustAccount", "transfer", "msl", "mslProduct", "mediaStorage", "storecheckTemplate", "activityStorecheck", "adjustInventory", "inventory", "integrationApp", "joinActionsWebHook", "patchAction", "updateIntegrationMeta", "assetPartType", "assetPart", "assetPartUnit", "assetPartReceival", "assetPartTransfer", "returnAssetPartUnit", "storeAssetPartUnit", "ocrInvoiceJobTemplate", "ocrInvoiceJobGroup", "activityAiSalesOrder", "ocrInvoiceJob", "ocrInvoiceJobPage", "settings", "mailUnsubscribe", "approvalRequest", "safeInvoiceSerialCounter", "clientLocation", "assetType", "asset", "assetUnit", "workorderPortal", "approval", "workorderCategory", "contract", "contractInstallment", "repBalanceSummary", "workorderPortalLink", "customField", "salesAnalyticsReport", "clmPresentation", "clmSequence", "clmSlide", "clmFetch"];
+    generateUUID: ({ prefix, suffix, length, }: {
+        prefix?: string;
+        suffix?: string;
+        length: number;
+    }) => string;
+    core: {
+        updateHeader: (newHeaders: {
+            authorization?: string;
+            refresh_token?: string;
+        }) => void;
+        reauth: () => Promise<Service.Reauth.Result>;
+    };
     client: {
         _path: "client";
         find: (params?: Service.Client.Find.Params) => Promise<Service.Client.Find.Result>;
@@ -1159,4 +1178,8 @@ export default class Repzo {
         update: (id: Service.PdfTemplate.Update.ID, body: Service.PdfTemplate.Update.Body) => Promise<Service.PdfTemplate.Update.Result>;
         remove: (id: Service.PdfTemplate.Remove.ID) => Promise<Service.PdfTemplate.Remove.Result>;
     };
+    optionalBusinessAppService: {
+        _path: "optional-business-app-service";
+        find: () => Promise<Service.OptionalBusinessAppService.Find.Result>;
+    };
 }

package/lib/index.js

@@ -1,5 +1,6 @@
 import axios from "axios";
 import { v4 as uuid } from "uuid";
+import { generateUUID } from "./helper.js";
 export const end_points = {
     CLIENT: "client",
     PRODUCT: "product",
@@ -119,6 +120,8 @@ export const end_points = {
     CLM_FETCH: "clm-fetch",
     PROMOTIONS: "promotions",
     COMPARE_INVOICE_TO_WAREHOUSE: "compare-invoice-to-warehouse",
+    AUTHENTICATE: "authenticate",
+    OPTIONAL_BUSINESS_APP_SERVICE: "optional-business-app-service",
 };
 export const availableService = [
     "client",
@@ -218,6 +221,43 @@ export const availableService = [
 class Repzo {
     constructor(apiKey, options) {
         this.available_services = availableService;
+        this.generateUUID = ({ prefix, suffix, length, }) => {
+            return generateUUID(prefix, suffix, length);
+        };
+        this.core = {
+            updateHeader: (newHeaders) => {
+                if (newHeaders?.authorization) {
+                    this.headers["authorization"] = newHeaders.authorization;
+                }
+                if (newHeaders?.refresh_token) {
+                    this.headers["refresh_token"] = newHeaders.refresh_token;
+                }
+            },
+            reauth: async () => {
+                const nameSpace = this.nameSpace;
+                const refreshToken = this.refresh_token;
+                if (!nameSpace || !refreshToken) {
+                    throw new Error("Missing required parameters for reauth");
+                }
+                const headers = {
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                    "X-NAME-SPACE": nameSpace,
+                    refresh_token: refreshToken,
+                };
+                const res = await axios.get(`${this.svAPIEndpoint}/${Repzo._end_points.AUTHENTICATE}`, { headers: headers, timeout: this.timeout });
+                const result = res.data;
+                if (result.login_status == "success") {
+                    this.core.updateHeader({
+                        authorization: result.access_token,
+                        refresh_token: result.refresh_token,
+                    });
+                    if (this.reauthCallBackFn)
+                        this.reauthCallBackFn(result);
+                }
+                return result;
+            },
+        };
         this.client = {
             _path: Repzo._end_points.CLIENT,
             find: async (params) => {
@@ -2382,6 +2422,13 @@ class Repzo {
                 return res;
             },
         };
+        this.optionalBusinessAppService = {
+            _path: Repzo._end_points.OPTIONAL_BUSINESS_APP_SERVICE,
+            find: async () => {
+                let res = await this._fetch(this.svAPIEndpoint, this.optionalBusinessAppService._path);
+                return res;
+            },
+        };
         this.svAPIEndpoint =
             !options?.env || options?.env == "production"
                 ? "https://sv.api.repzo.me"
@@ -2395,6 +2442,12 @@ class Repzo {
             "Content-Type": "application/json",
             Accept: "application/json",
         };
+        if (options?.nameSpace)
+            this.nameSpace = options.nameSpace;
+        if (options?.refresh_token)
+            this.refresh_token = options.refresh_token;
+        if (options?.reauthCallBackFn)
+            this.reauthCallBackFn = options.reauthCallBackFn;
         if (options?.headers)
             Object.assign(this.headers, options.headers);
         if (options?.timeout) {
@@ -2414,7 +2467,17 @@ class Repzo {
         }
         catch (error) {
             // Don't retry on 401 (Unauthorized) errors
-            if (error?.response?.status === 401) {
+            if (error?.response?.status === 401 &&
+                this.refresh_token &&
+                this.nameSpace) {
+                try {
+                    await this.core.reauth();
+                }
+                catch (e) {
+                    throw error;
+                }
+            }
+            else {
                 throw error;
             }
             // Retry if we haven't exceeded the retry attempts

package/lib/test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test.js

@@ -0,0 +1,7 @@
+import Repzo from "./index.js";
+const go = async () => {
+    const repzo = new Repzo("", { timeout: 10000, env: "staging" });
+    const res = await repzo.client.find({ search: "Mecca" });
+    console.log(JSON.stringify(res, null, 2));
+};
+go();

package/lib/types/index.d.ts

@@ -13,6 +13,9 @@ export interface Options {
     };
     timeout?: number | undefined;
     retryAttempts?: number;
+    nameSpace?: string;
+    refresh_token?: string;
+    reauthCallBackFn?: (res: Service.Reauth.Result) => void;
 }
 export interface Headers {
     "api-key": string;
@@ -2441,6 +2444,9 @@ export declare namespace Service {
             rep_must_end_day_after_specific_time: boolean;
             rep_can_upload_media_on_payment?: boolean;
             rep_can_access_sales_reports?: boolean;
+            rep_must_add_delivery_date_on_sales_order_and_invoice?: boolean;
+            rep_can_view_stock_on_transfers?: boolean;
+            rep_must_invoice_items_from_cross_inventory_and_msl?: boolean;
         }
         interface TargetResults {
             totalPoints: number;
@@ -2697,6 +2703,9 @@ export declare namespace Service {
                 "permissions.rep_can_create_negative_invoices"?: boolean;
                 "permissions.rep_can_upload_media_on_payment"?: boolean;
                 "permissions.rep_can_access_sales_reports"?: boolean;
+                "permissions.rep_must_add_delivery_date_on_sales_order_and_invoice"?: boolean;
+                "permissions.rep_can_view_stock_on_transfers"?: boolean;
+                "permissions.rep_must_invoice_items_from_cross_inventory_and_msl"?: boolean;
                 "settings.rep_must_end_day_after"?: `${number}:${number}`;
                 "settings.allowable_accuracy"?: number;
                 "settings.is_item_status_per_visit_limited"?: boolean;
@@ -17039,6 +17048,31 @@ export declare namespace Service {
             }
         }
     }
+    namespace Reauth {
+        interface Result {
+            access_token: string;
+            refresh_token: string;
+            login_status: "success";
+            teams: StringId[];
+            populated_teams?: Pick<Team.TeamSchema, "name" | "_id">[];
+            permissions: Rep.Data["permissions"];
+            rep: StringId;
+            identifier: number;
+            exp: number;
+            modules: string[];
+            realm_token: string;
+            app_code: string;
+            country: string;
+            country_code: string[];
+            is_test: boolean;
+            suspended: boolean;
+            nameSpace: string[];
+            allow_treating_invoice_as_proforma_for_etax: boolean;
+            time_zone: string;
+            EOD: string;
+            allow_offline_day: boolean;
+        }
+    }
     namespace PrintSetting {
         type ImageSize = "original" | "small" | "medium" | "large" | "extra";
         type QrCodeSize = "small" | "medium" | "large";
@@ -17527,6 +17561,20 @@ export declare namespace Service {
         }
         export {};
     }
+    namespace OptionalBusinessAppService {
+        type SERVICE_NAMES = "transfer" | "warehouse" | "fullinvoices" | "client" | "product" | "rep" | "tag" | "asset-part-unit" | "asset-part-receival" | "asset-part-transfer" | "return-asset-part-unit" | "store-asset-part-unit" | "clm-presentation";
+        export namespace Find {
+            interface Result {
+                code: string;
+                services: {
+                    permission: StringId;
+                    name: SERVICE_NAMES;
+                    default_teams_shared: "shared" | "unshared";
+                }[];
+            }
+        }
+        export {};
+    }
 }
 export type StringId = string;
 export type NameSpaces = string[];

package/lib/types/index.js

@@ -1,4 +1,3 @@
-// <reference path = "vehicle.ts" />
 export var Service;
 (function (Service) {
     let FormV2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repzo",
-  "version": "1.0.231",
+  "version": "1.0.233",
   "description": "Repzo TypeScript SDK",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -13,7 +13,7 @@
     "changelog.md"
   ],
   "scripts": {
-    "test": "npm run test",
+    "test": "npm run build && node ./lib/test.js",
     "lint": "npx prettier --write .",
     "build": "tsc --skipLibCheck && npm run lint",
     "docs:generate": "node scripts/build-docs.js",
@@ -57,6 +57,7 @@
   "devDependencies": {
     "@apidevtools/swagger-parser": "^12.0.0",
     "@redocly/openapi-cli": "^0.12.16",
+    "@types/node": "^24.10.0",
     "@types/uuid": "^8.3.4",
     "axios": "^0.26.1",
     "js-yaml": "^4.1.0",

package/src/helper.ts

@@ -0,0 +1,32 @@
+import crypto from "crypto";
+
+export const generateUUID = (
+  prefix = "",
+  suffix = "",
+  length: number = 8,
+): string => {
+  if (
+    (prefix && typeof prefix !== "string") ||
+    (suffix && typeof suffix !== "string")
+  ) {
+    throw new Error("Prefix and suffix must be strings");
+  }
+  if (
+    typeof crypto === "undefined" ||
+    typeof crypto.randomBytes !== "function"
+  ) {
+    throw new Error("crypto module or randomBytes function is unavailable");
+  }
+  const randomPortion = BigInt(
+    `0x${crypto.randomBytes(length).toString("hex")}`,
+  ).toString(36);
+
+  const timestamp = Date.now().toString(36);
+
+  const formattedPrefix = prefix ? `${prefix}-` : "";
+  const formattedSuffix = suffix ? `-${suffix}` : "";
+
+  const uuid = `${formattedPrefix}${timestamp}${randomPortion}${formattedSuffix}`;
+
+  return uuid;
+};

package/src/index.ts

@@ -9,6 +9,7 @@ import type {
   StringId,
   NameSpaces,
 } from "./types/index";
+import { generateUUID } from "./helper.js";
 
 export const end_points = {
   CLIENT: "client",
@@ -129,6 +130,8 @@ export const end_points = {
   CLM_FETCH: "clm-fetch",
   PROMOTIONS: "promotions",
   COMPARE_INVOICE_TO_WAREHOUSE: "compare-invoice-to-warehouse",
+  AUTHENTICATE: "authenticate",
+  OPTIONAL_BUSINESS_APP_SERVICE: "optional-business-app-service",
 } as const;
 export type EndPoints = (typeof end_points)[keyof typeof end_points];
 
@@ -234,6 +237,9 @@ export default class Repzo {
   headers: Headers;
   private timeout: number;
   private retryAttempts: number;
+  private refresh_token?: string;
+  private nameSpace?: string;
+  private reauthCallBackFn?: (res: Service.Reauth.Result) => void;
   constructor(apiKey: string, options?: Options) {
     this.svAPIEndpoint =
       !options?.env || options?.env == "production"
@@ -249,6 +255,10 @@ export default class Repzo {
       "Content-Type": "application/json",
       Accept: "application/json",
     };
+    if (options?.nameSpace) this.nameSpace = options.nameSpace;
+    if (options?.refresh_token) this.refresh_token = options.refresh_token;
+    if (options?.reauthCallBackFn)
+      this.reauthCallBackFn = options.reauthCallBackFn;
     if (options?.headers) Object.assign(this.headers, options.headers);
     if (options?.timeout) {
       this.timeout = options.timeout;
@@ -271,7 +281,17 @@ export default class Repzo {
       return await requestFn();
     } catch (error: any) {
       // Don't retry on 401 (Unauthorized) errors
-      if (error?.response?.status === 401) {
+      if (
+        error?.response?.status === 401 &&
+        this.refresh_token &&
+        this.nameSpace
+      ) {
+        try {
+          await this.core.reauth();
+        } catch (e) {
+          throw error;
+        }
+      } else {
         throw error;
       }
 
@@ -363,6 +383,59 @@ export default class Repzo {
 
   available_services = availableService;
 
+  generateUUID = ({
+    prefix,
+    suffix,
+    length,
+  }: {
+    prefix?: string;
+    suffix?: string;
+    length: number;
+  }): string => {
+    return generateUUID(prefix, suffix, length);
+  };
+
+  core = {
+    updateHeader: (newHeaders: {
+      authorization?: string;
+      refresh_token?: string;
+    }) => {
+      if (newHeaders?.authorization) {
+        this.headers["authorization"] = newHeaders.authorization;
+      }
+      if (newHeaders?.refresh_token) {
+        this.headers["refresh_token"] = newHeaders.refresh_token;
+      }
+    },
+
+    reauth: async (): Promise<Service.Reauth.Result> => {
+      const nameSpace = this.nameSpace;
+      const refreshToken = this.refresh_token;
+      if (!nameSpace || !refreshToken) {
+        throw new Error("Missing required parameters for reauth");
+      }
+      const headers = {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        "X-NAME-SPACE": nameSpace,
+        refresh_token: refreshToken,
+      };
+      const res: any = await axios.get(
+        `${this.svAPIEndpoint}/${Repzo._end_points.AUTHENTICATE}`,
+        { headers: headers, timeout: this.timeout },
+      );
+      const result: Service.Reauth.Result = res.data;
+      if (result.login_status == "success") {
+        this.core.updateHeader({
+          authorization: result.access_token,
+          refresh_token: result.refresh_token,
+        });
+        if (this.reauthCallBackFn) this.reauthCallBackFn(result);
+      }
+      return result;
+    },
+  };
+
   client = {
     _path: Repzo._end_points.CLIENT,
     find: async (
@@ -6064,6 +6137,18 @@ export default class Repzo {
       return res;
     },
   };
+
+  optionalBusinessAppService = {
+    _path: Repzo._end_points.OPTIONAL_BUSINESS_APP_SERVICE,
+    find: async (): Promise<Service.OptionalBusinessAppService.Find.Result> => {
+      let res: Service.OptionalBusinessAppService.Find.Result =
+        await this._fetch(
+          this.svAPIEndpoint,
+          this.optionalBusinessAppService._path,
+        );
+      return res;
+    },
+  };
 }
 
 function normalizeParams(params: Params): { [key: string]: any } {

package/src/test.ts

@@ -0,0 +1,8 @@
+import Repzo from "./index.js";
+const go = async () => {
+  const repzo = new Repzo("", { timeout: 10000, env: "staging" });
+
+  const res = await repzo.client.find({ search: "Mecca" });
+  console.log(JSON.stringify(res, null, 2));
+};
+go();

package/src/types/index.ts

@@ -12,6 +12,9 @@ export interface Options {
   headers?: { [key: string]: string };
   timeout?: number | undefined;
   retryAttempts?: number;
+  nameSpace?: string;
+  refresh_token?: string;
+  reauthCallBackFn?: (res: Service.Reauth.Result) => void;
 }
 export interface Headers {
   "api-key": string;
@@ -463,7 +466,6 @@ interface GeoPoint {
   coordinates: [number, number];
 }
 
-// <reference path = "vehicle.ts" />
 export namespace Service {
   export namespace Client {
     interface Financials {
@@ -2849,6 +2851,9 @@ export namespace Service {
       rep_must_end_day_after_specific_time: boolean;
       rep_can_upload_media_on_payment?: boolean;
       rep_can_access_sales_reports?: boolean;
+      rep_must_add_delivery_date_on_sales_order_and_invoice?: boolean;
+      rep_can_view_stock_on_transfers?: boolean;
+      rep_must_invoice_items_from_cross_inventory_and_msl?: boolean;
     }
     interface TargetResults {
       totalPoints: number;
@@ -3129,6 +3134,9 @@ export namespace Service {
         "permissions.rep_can_create_negative_invoices"?: boolean;
         "permissions.rep_can_upload_media_on_payment"?: boolean;
         "permissions.rep_can_access_sales_reports"?: boolean;
+        "permissions.rep_must_add_delivery_date_on_sales_order_and_invoice"?: boolean;
+        "permissions.rep_can_view_stock_on_transfers"?: boolean;
+        "permissions.rep_must_invoice_items_from_cross_inventory_and_msl"?: boolean;
         "settings.rep_must_end_day_after"?: `${number}:${number}`;
         "settings.allowable_accuracy"?: number;
         "settings.is_item_status_per_visit_limited"?: boolean;
@@ -19058,6 +19066,32 @@ export namespace Service {
     }
   }
 
+  export namespace Reauth {
+    export interface Result {
+      access_token: string;
+      refresh_token: string;
+      login_status: "success";
+      teams: StringId[];
+      populated_teams?: Pick<Team.TeamSchema, "name" | "_id">[];
+      permissions: Rep.Data["permissions"];
+      rep: StringId;
+      identifier: number;
+      exp: number; // timestamp
+      modules: string[];
+      realm_token: string;
+      app_code: string;
+      country: string;
+      country_code: string[];
+      is_test: boolean;
+      suspended: boolean;
+      nameSpace: string[];
+      allow_treating_invoice_as_proforma_for_etax: boolean;
+      time_zone: string;
+      EOD: string;
+      allow_offline_day: boolean;
+    }
+  }
+
   export namespace PrintSetting {
     export type ImageSize = "original" | "small" | "medium" | "large" | "extra";
     export type QrCodeSize = "small" | "medium" | "large";
@@ -19588,6 +19622,33 @@ export namespace Service {
       export type Result = Data;
     }
   }
+
+  export namespace OptionalBusinessAppService {
+    type SERVICE_NAMES =
+      | "transfer"
+      | "warehouse"
+      | "fullinvoices"
+      | "client"
+      | "product"
+      | "rep"
+      | "tag"
+      | "asset-part-unit"
+      | "asset-part-receival"
+      | "asset-part-transfer"
+      | "return-asset-part-unit"
+      | "store-asset-part-unit"
+      | "clm-presentation";
+    export namespace Find {
+      export interface Result {
+        code: string;
+        services: {
+          permission: StringId;
+          name: SERVICE_NAMES;
+          default_teams_shared: "shared" | "unshared";
+        }[];
+      }
+    }
+  }
 }
 
 export type StringId = string;