repzo 1.0.230 → 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

@@ -39,6 +39,8 @@ export declare const end_points: {
     readonly INVOICE: "fullinvoices";
     readonly PROFORMA: "proforma";
     readonly PRINT_SETTINGS: "print-settings";
+    readonly PDF_TEMPLATE_GALLERY: "pdf-template-gallery";
+    readonly PDF_TEMPLATE: "pdf-template";
     readonly PAYMENT: "payments";
     readonly REFUND: "refund";
     readonly SETTLEMENT: "settlement";
@@ -116,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"];
@@ -125,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(): {
@@ -167,6 +174,8 @@ export default class Repzo {
         readonly INVOICE: "fullinvoices";
         readonly PROFORMA: "proforma";
         readonly PRINT_SETTINGS: "print-settings";
+        readonly PDF_TEMPLATE_GALLERY: "pdf-template-gallery";
+        readonly PDF_TEMPLATE: "pdf-template";
         readonly PAYMENT: "payments";
         readonly REFUND: "refund";
         readonly SETTLEMENT: "settlement";
@@ -244,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;
@@ -252,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>;
@@ -1139,4 +1162,24 @@ export default class Repzo {
         create: (body: Service.PrintSetting.Create.Body) => Promise<Service.PrintSetting.Create.Result>;
         update: (id: Service.PrintSetting.Update.ID, body: Service.PrintSetting.Update.Body) => Promise<Service.PrintSetting.Update.Result>;
     };
+    pdfTemplateGallery: {
+        _path: "pdf-template-gallery";
+        find: (params?: Service.PdfTemplateGallery.Find.Params) => Promise<Service.PdfTemplateGallery.Find.Result>;
+        get: (id: Service.PdfTemplateGallery.Get.ID, params?: Service.PdfTemplateGallery.Get.Params) => Promise<Service.PdfTemplateGallery.Get.Result>;
+        create: (body: Service.PdfTemplateGallery.Create.Body) => Promise<Service.PdfTemplateGallery.Create.Result>;
+        update: (id: Service.PdfTemplateGallery.Update.ID, body: Service.PdfTemplateGallery.Update.Body) => Promise<Service.PdfTemplateGallery.Update.Result>;
+        remove: (id: Service.PdfTemplateGallery.Remove.ID) => Promise<Service.PdfTemplateGallery.Remove.Result>;
+    };
+    pdfTemplate: {
+        _path: "pdf-template";
+        find: (params?: Service.PdfTemplate.Find.Params) => Promise<Service.PdfTemplate.Find.Result>;
+        get: (id: Service.PdfTemplate.Get.ID, params?: Service.PdfTemplate.Get.Params) => Promise<Service.PdfTemplate.Get.Result>;
+        create: (body: Service.PdfTemplate.Create.Body) => Promise<Service.PdfTemplate.Create.Result>;
+        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",
@@ -40,6 +41,8 @@ export const end_points = {
     INVOICE: "fullinvoices",
     PROFORMA: "proforma",
     PRINT_SETTINGS: "print-settings",
+    PDF_TEMPLATE_GALLERY: "pdf-template-gallery",
+    PDF_TEMPLATE: "pdf-template",
     PAYMENT: "payments",
     REFUND: "refund",
     SETTLEMENT: "settlement",
@@ -117,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",
@@ -216,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) => {
@@ -2336,6 +2378,57 @@ class Repzo {
                 return res;
             },
         };
+        this.pdfTemplateGallery = {
+            _path: Repzo._end_points.PDF_TEMPLATE_GALLERY,
+            find: async (params) => {
+                let res = await this._fetch(this.svAPIEndpoint, this.pdfTemplateGallery._path, params);
+                return res;
+            },
+            get: async (id, params) => {
+                return await this._fetch(this.svAPIEndpoint, this.pdfTemplateGallery._path + `/${id}`, params);
+            },
+            create: async (body) => {
+                let res = await this._create(this.svAPIEndpoint, this.pdfTemplateGallery._path, body);
+                return res;
+            },
+            update: async (id, body) => {
+                let res = await this._update(this.svAPIEndpoint, this.pdfTemplateGallery._path + `/${id}`, body);
+                return res;
+            },
+            remove: async (id) => {
+                let res = await this._delete(this.svAPIEndpoint, this.pdfTemplateGallery._path + `/${id}`);
+                return res;
+            },
+        };
+        this.pdfTemplate = {
+            _path: Repzo._end_points.PDF_TEMPLATE,
+            find: async (params) => {
+                let res = await this._fetch(this.svAPIEndpoint, this.pdfTemplate._path, params);
+                return res;
+            },
+            get: async (id, params) => {
+                return await this._fetch(this.svAPIEndpoint, this.pdfTemplate._path + `/${id}`, params);
+            },
+            create: async (body) => {
+                let res = await this._create(this.svAPIEndpoint, this.pdfTemplate._path, body);
+                return res;
+            },
+            update: async (id, body) => {
+                let res = await this._update(this.svAPIEndpoint, this.pdfTemplate._path + `/${id}`, body);
+                return res;
+            },
+            remove: async (id) => {
+                let res = await this._delete(this.svAPIEndpoint, this.pdfTemplate._path + `/${id}`);
+                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"
@@ -2349,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) {
@@ -2368,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;
@@ -240,7 +243,7 @@ export interface CalendarWeeklyGroup {
 }
 export type Model = "quickConvertToPdf" | "warehouses" | "transfers" | "transactions" | "taxes" | "productvariations" | "products" | "pricelistsitems" | "pricelists" | "payments" | "ledger_payments" | "mslsales" | "mslproducts" | "measureunits" | "measureunitfamilies" | "invoicesitems" | "invoices" | "ledger_goods" | "fullinvoices" | "checks" | "clients" | "activities" | "bigReports" | "admins";
 export type DocumentTypes = "form" | "quickConvertToPdf" | "clients" | "asset" | "assetUnit" | "workorder" | "clientLocation" | "clientContact" | "commentsThread" | "workorderRequest" | "workorderPortal" | "invoice" | "products" | "productvariations" | "representatives" | "productcategories" | "productSubCategory" | "speciality" | "line" | "banner" | "intgAvailableApps" | "availability_msl" | "reminders" | "audits" | "availability" | "photos" | "planogram" | "tasks" | "checks" | "notificationsCenter" | "admins" | "settings" | "printWorkorderPortalLink" | "bulkExport" | "generateRule" | "scheduleEmail" | "custom-list-item" | "days" | "bulkImport" | "sv.activitiesstorechecks" | "retailExecutionPreset" | "paymentMethod" | "approvalRequest" | "activityFormV2Result" | "formV2" | "payments" | "ocrInvoiceJob" | "contract" | "contractInstallment" | "form" | "paymentMethod" | "aiObjectDetectionModelVersion" | "aiObjectDetectionTask" | "assetPart" | "assetPartReceival" | "assetPartUnit" | "returnAssetPartUnit" | "storeAssetPartUnit" | "activityAiSalesOrder" | "ocrInvoiceJobGroup";
-export type PrintTypes = "workorder" | "form" | "invoice" | "proforma" | "settlement";
+export type PrintTypes = "workorder" | "form" | "invoice" | "proforma" | "settlement" | "formV2";
 export type InvoiceFontStyles = "InvoiceHeaderTitle" | "InvoiceTaxNumber" | "InvoiceType" | "InvoiceInfo" | "ItemsHeader" | "ItemLabel" | "ItemValue" | "ItemVariant" | "TotalItemsQty" | "TotalAmount" | "RepReciver" | "Address" | "PrintTime" | "InvoiceHeader" | "ClientBalance";
 type Granularity = "Year" | "Year Month" | "Year Week" | "Month" | "Year Month Day" | "Year Month Day Time" | "Year Month Day Time Offset";
 export interface MediaDoc {
@@ -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";
@@ -17357,6 +17391,190 @@ export declare namespace Service {
             type Result = Data;
         }
     }
+    namespace PdfTemplateGallery {
+        export interface Data {
+            _id: string;
+            html_media?: string | MediaDoc;
+            settings?: {
+                [key: string]: any;
+            };
+            cover_photo?: string | MediaDoc;
+            name: string;
+            locale: "en" | "ar";
+            ai_prompt?: string;
+            document_type: PrintTypes;
+            disabled: boolean;
+            createdAt: string;
+            updatedAt: string;
+        }
+        export interface CreateBody {
+            html_media?: string;
+            settings?: {
+                [key: string]: any;
+            };
+            cover_photo?: string;
+            name: string;
+            locale: "en" | "ar";
+            ai_prompt?: string;
+            document_type: PrintTypes;
+            disabled?: boolean;
+        }
+        export interface UpdateBody {
+            html_media?: string;
+            settings?: {
+                [key: string]: any;
+            };
+            cover_photo?: string;
+            name?: string;
+            locale?: "en" | "ar";
+            ai_prompt?: string;
+            document_type?: PrintTypes;
+        }
+        export type PopulatedDoc = Data & {
+            html_media_populated?: MediaDoc;
+            cover_photo_populated?: MediaDoc;
+        };
+        type PopulatedKeys = "html_media" | "cover_photo";
+        export namespace Find {
+            type Params = DefaultPaginationQueryParams & {
+                _id?: string | string[];
+                name?: string;
+                locale?: "en" | "ar";
+                document_type?: PrintTypes;
+                disabled?: boolean;
+            };
+            interface Result extends DefaultPaginationResult {
+                data: PopulatedDoc[];
+            }
+        }
+        export namespace Get {
+            type ID = string;
+            type Params = {
+                populatedKeys?: PopulatedKeys[];
+            };
+            type Result = PopulatedDoc;
+        }
+        export namespace Create {
+            type Body = CreateBody;
+            type Result = Data;
+        }
+        export namespace Update {
+            type ID = string;
+            type Body = UpdateBody;
+            type Result = Data;
+        }
+        export namespace Remove {
+            type ID = string;
+            type Result = Data;
+        }
+        export {};
+    }
+    namespace PdfTemplate {
+        export interface Data {
+            _id: string;
+            html_media?: string | MediaDoc;
+            settings?: {
+                [key: string]: any;
+            };
+            cover_photo?: string | MediaDoc;
+            name: string;
+            is_default: boolean;
+            creator: AdminCreator;
+            editor?: AdminCreator;
+            locale: "en" | "ar";
+            pdf_template_gallery?: string;
+            publish_time?: number | null;
+            document_type: PrintTypes;
+            disabled: boolean;
+            company_namespace: string[];
+            createdAt: string;
+            updatedAt: string;
+        }
+        export interface CreateBody {
+            html_media?: string;
+            settings?: {
+                [key: string]: any;
+            };
+            cover_photo?: string;
+            name: string;
+            is_default?: boolean;
+            locale: "en" | "ar";
+            pdf_template_gallery?: string;
+            publish_time?: number | null;
+            document_type: PrintTypes;
+        }
+        export interface UpdateBody {
+            html_media?: string;
+            settings?: {
+                [key: string]: any;
+            };
+            cover_photo?: string;
+            name?: string;
+            is_default?: boolean;
+            locale?: "en" | "ar";
+            pdf_template_gallery?: string;
+            publish_time?: number | null;
+            document_type?: PrintTypes;
+        }
+        export type PopulatedDoc = Data & {
+            html_media_populated?: MediaDoc;
+            cover_photo_populated?: MediaDoc;
+            pdf_template_gallery_populated?: PdfTemplateGallery.Data;
+        };
+        type PopulatedKeys = "html_media" | "cover_photo" | "pdf_template_gallery";
+        export namespace Find {
+            type Params = DefaultPaginationQueryParams & {
+                name?: string | string[];
+                locale?: "en" | "ar" | ("en" | "ar")[];
+                document_type?: PrintTypes | PrintTypes[];
+                is_default?: boolean;
+                pdf_template_gallery?: string | string[];
+                publish_time?: number | (number | null)[];
+                disabled?: boolean;
+                _id?: string | string[];
+                "creator._id"?: string | string[];
+                "editor._id"?: string | string[];
+            };
+            interface Result extends DefaultPaginationResult {
+                data: PopulatedDoc[];
+            }
+        }
+        export namespace Get {
+            type ID = string;
+            type Params = {
+                populatedKeys?: PopulatedKeys[];
+            };
+            type Result = PopulatedDoc;
+        }
+        export namespace Create {
+            type Body = CreateBody;
+            type Result = Data;
+        }
+        export namespace Update {
+            type ID = string;
+            type Body = UpdateBody;
+            type Result = Data;
+        }
+        export namespace Remove {
+            type ID = string;
+            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 {
+            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.230",
+  "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",
@@ -50,6 +51,8 @@ export const end_points = {
   INVOICE: "fullinvoices",
   PROFORMA: "proforma",
   PRINT_SETTINGS: "print-settings",
+  PDF_TEMPLATE_GALLERY: "pdf-template-gallery",
+  PDF_TEMPLATE: "pdf-template",
   PAYMENT: "payments",
   REFUND: "refund",
   SETTLEMENT: "settlement",
@@ -127,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];
 
@@ -232,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"
@@ -247,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;
@@ -269,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;
       }
 
@@ -361,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 (
@@ -5944,6 +6019,136 @@ export default class Repzo {
       return res;
     },
   };
+
+  pdfTemplateGallery = {
+    _path: Repzo._end_points.PDF_TEMPLATE_GALLERY,
+
+    find: async (
+      params?: Service.PdfTemplateGallery.Find.Params,
+    ): Promise<Service.PdfTemplateGallery.Find.Result> => {
+      let res: Service.PdfTemplateGallery.Find.Result = await this._fetch(
+        this.svAPIEndpoint,
+        this.pdfTemplateGallery._path,
+        params,
+      );
+      return res;
+    },
+
+    get: async (
+      id: Service.PdfTemplateGallery.Get.ID,
+      params?: Service.PdfTemplateGallery.Get.Params,
+    ): Promise<Service.PdfTemplateGallery.Get.Result> => {
+      return await this._fetch(
+        this.svAPIEndpoint,
+        this.pdfTemplateGallery._path + `/${id}`,
+        params,
+      );
+    },
+
+    create: async (
+      body: Service.PdfTemplateGallery.Create.Body,
+    ): Promise<Service.PdfTemplateGallery.Create.Result> => {
+      let res = await this._create(
+        this.svAPIEndpoint,
+        this.pdfTemplateGallery._path,
+        body,
+      );
+      return res;
+    },
+
+    update: async (
+      id: Service.PdfTemplateGallery.Update.ID,
+      body: Service.PdfTemplateGallery.Update.Body,
+    ): Promise<Service.PdfTemplateGallery.Update.Result> => {
+      let res: Service.PdfTemplateGallery.Update.Result = await this._update(
+        this.svAPIEndpoint,
+        this.pdfTemplateGallery._path + `/${id}`,
+        body,
+      );
+      return res;
+    },
+
+    remove: async (
+      id: Service.PdfTemplateGallery.Remove.ID,
+    ): Promise<Service.PdfTemplateGallery.Remove.Result> => {
+      let res: Service.PdfTemplateGallery.Remove.Result = await this._delete(
+        this.svAPIEndpoint,
+        this.pdfTemplateGallery._path + `/${id}`,
+      );
+      return res;
+    },
+  };
+
+  pdfTemplate = {
+    _path: Repzo._end_points.PDF_TEMPLATE,
+
+    find: async (
+      params?: Service.PdfTemplate.Find.Params,
+    ): Promise<Service.PdfTemplate.Find.Result> => {
+      let res: Service.PdfTemplate.Find.Result = await this._fetch(
+        this.svAPIEndpoint,
+        this.pdfTemplate._path,
+        params,
+      );
+      return res;
+    },
+
+    get: async (
+      id: Service.PdfTemplate.Get.ID,
+      params?: Service.PdfTemplate.Get.Params,
+    ): Promise<Service.PdfTemplate.Get.Result> => {
+      return await this._fetch(
+        this.svAPIEndpoint,
+        this.pdfTemplate._path + `/${id}`,
+        params,
+      );
+    },
+
+    create: async (
+      body: Service.PdfTemplate.Create.Body,
+    ): Promise<Service.PdfTemplate.Create.Result> => {
+      let res = await this._create(
+        this.svAPIEndpoint,
+        this.pdfTemplate._path,
+        body,
+      );
+      return res;
+    },
+
+    update: async (
+      id: Service.PdfTemplate.Update.ID,
+      body: Service.PdfTemplate.Update.Body,
+    ): Promise<Service.PdfTemplate.Update.Result> => {
+      let res: Service.PdfTemplate.Update.Result = await this._update(
+        this.svAPIEndpoint,
+        this.pdfTemplate._path + `/${id}`,
+        body,
+      );
+      return res;
+    },
+
+    remove: async (
+      id: Service.PdfTemplate.Remove.ID,
+    ): Promise<Service.PdfTemplate.Remove.Result> => {
+      let res: Service.PdfTemplate.Remove.Result = await this._delete(
+        this.svAPIEndpoint,
+        this.pdfTemplate._path + `/${id}`,
+      );
+      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;
@@ -382,7 +385,8 @@ export type PrintTypes =
   | "form"
   | "invoice"
   | "proforma"
-  | "settlement";
+  | "settlement"
+  | "formV2";
 
 export type InvoiceFontStyles =
   | "InvoiceHeaderTitle"
@@ -462,7 +466,6 @@ interface GeoPoint {
   coordinates: [number, number];
 }
 
-// <reference path = "vehicle.ts" />
 export namespace Service {
   export namespace Client {
     interface Financials {
@@ -2848,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;
@@ -3128,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;
@@ -19057,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";
@@ -19415,6 +19450,205 @@ export namespace Service {
       export type Result = Data;
     }
   }
+
+  export namespace PdfTemplateGallery {
+    export interface Data {
+      _id: string;
+      html_media?: string | MediaDoc;
+      settings?: { [key: string]: any };
+      cover_photo?: string | MediaDoc;
+      name: string;
+      locale: "en" | "ar";
+      ai_prompt?: string;
+      document_type: PrintTypes;
+      disabled: boolean;
+      createdAt: string;
+      updatedAt: string;
+    }
+
+    export interface CreateBody {
+      html_media?: string;
+      settings?: { [key: string]: any };
+      cover_photo?: string;
+      name: string;
+      locale: "en" | "ar";
+      ai_prompt?: string;
+      document_type: PrintTypes;
+      disabled?: boolean;
+    }
+
+    export interface UpdateBody {
+      html_media?: string;
+      settings?: { [key: string]: any };
+      cover_photo?: string;
+      name?: string;
+      locale?: "en" | "ar";
+      ai_prompt?: string;
+      document_type?: PrintTypes;
+    }
+
+    export type PopulatedDoc = Data & {
+      html_media_populated?: MediaDoc;
+      cover_photo_populated?: MediaDoc;
+    };
+
+    type PopulatedKeys = "html_media" | "cover_photo";
+
+    export namespace Find {
+      export type Params = DefaultPaginationQueryParams & {
+        _id?: string | string[];
+        name?: string;
+        locale?: "en" | "ar";
+        document_type?: PrintTypes;
+        disabled?: boolean;
+      };
+      export interface Result extends DefaultPaginationResult {
+        data: PopulatedDoc[];
+      }
+    }
+
+    export namespace Get {
+      export type ID = string;
+      export type Params = { populatedKeys?: PopulatedKeys[] };
+      export type Result = PopulatedDoc;
+    }
+
+    export namespace Create {
+      export type Body = CreateBody;
+      export type Result = Data;
+    }
+
+    export namespace Update {
+      export type ID = string;
+      export type Body = UpdateBody;
+      export type Result = Data;
+    }
+
+    export namespace Remove {
+      export type ID = string;
+      export type Result = Data;
+    }
+  }
+
+  export namespace PdfTemplate {
+    export interface Data {
+      _id: string;
+      html_media?: string | MediaDoc;
+      settings?: { [key: string]: any };
+      cover_photo?: string | MediaDoc;
+      name: string;
+      is_default: boolean;
+      creator: AdminCreator;
+      editor?: AdminCreator;
+      locale: "en" | "ar";
+      pdf_template_gallery?: string;
+      publish_time?: number | null;
+      document_type: PrintTypes;
+      disabled: boolean;
+      company_namespace: string[];
+      createdAt: string;
+      updatedAt: string;
+    }
+
+    export interface CreateBody {
+      html_media?: string;
+      settings?: { [key: string]: any };
+      cover_photo?: string;
+      name: string;
+      is_default?: boolean;
+      locale: "en" | "ar";
+      pdf_template_gallery?: string;
+      publish_time?: number | null;
+      document_type: PrintTypes;
+    }
+
+    export interface UpdateBody {
+      html_media?: string;
+      settings?: { [key: string]: any };
+      cover_photo?: string;
+      name?: string;
+      is_default?: boolean;
+      locale?: "en" | "ar";
+      pdf_template_gallery?: string;
+      publish_time?: number | null;
+      document_type?: PrintTypes;
+    }
+
+    export type PopulatedDoc = Data & {
+      html_media_populated?: MediaDoc;
+      cover_photo_populated?: MediaDoc;
+      pdf_template_gallery_populated?: PdfTemplateGallery.Data;
+    };
+
+    type PopulatedKeys = "html_media" | "cover_photo" | "pdf_template_gallery";
+
+    export namespace Find {
+      export type Params = DefaultPaginationQueryParams & {
+        name?: string | string[];
+        locale?: "en" | "ar" | ("en" | "ar")[];
+        document_type?: PrintTypes | PrintTypes[];
+        is_default?: boolean;
+        pdf_template_gallery?: string | string[];
+        publish_time?: number | (number | null)[];
+        disabled?: boolean;
+        _id?: string | string[];
+        "creator._id"?: string | string[];
+        "editor._id"?: string | string[];
+      };
+      export interface Result extends DefaultPaginationResult {
+        data: PopulatedDoc[];
+      }
+    }
+
+    export namespace Get {
+      export type ID = string;
+      export type Params = { populatedKeys?: PopulatedKeys[] };
+      export type Result = PopulatedDoc;
+    }
+
+    export namespace Create {
+      export type Body = CreateBody;
+      export type Result = Data;
+    }
+
+    export namespace Update {
+      export type ID = string;
+      export type Body = UpdateBody;
+      export type Result = Data;
+    }
+
+    export namespace Remove {
+      export type ID = string;
+      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;