shopoflex-types 1.0.237 → 1.0.240

package/dist/common.d.ts

@@ -482,6 +482,8 @@ export interface Vendor {
         terminalId: string;
         branchIds: string[];
     }[];
+    /** POS-to-POS inter-branch item request settings (opt-in, off by default). */
+    posStockTransfer?: import('./interBranchRequest').PosStockTransferSettings;
     getTaxConfig(country?: string): TaxSettings;
     calculateTax(subtotal: number, country?: string): {
         taxAmount: number;

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export * from './productCart';
 export * from './filters';
 export * from './accounting';
 export * from './terminal';
+export * from './interBranchRequest';

package/dist/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./productCart"), exports);
 __exportStar(require("./filters"), exports);
 __exportStar(require("./accounting"), exports);
 __exportStar(require("./terminal"), exports);
+__exportStar(require("./interBranchRequest"), exports);

package/dist/interBranchRequest.d.ts

@@ -0,0 +1,50 @@
+export type InterBranchRequestStatus = 'requested' | 'acknowledged' | 'sent' | 'received' | 'rejected' | 'cancelled';
+export type InterBranchRequestMode = 'transfer' | 'info';
+export interface InterBranchRequestItem {
+    productId: string;
+    variantId: string;
+    name: string;
+    variantName?: string;
+    isStockTracked: boolean;
+    unitCost: number;
+    requestedQty: number;
+    sentQty?: number;
+    receivedQty?: number;
+}
+export interface PosStockTransferSettings {
+    enabled: boolean;
+    allowedModes: 'info' | 'transfer' | 'both';
+    senderBranchIds?: string[];
+}
+/** Branch ids a POS may request FROM, given the setting. A strict whitelist:
+ *  EMPTY = no branch is selectable (the vendor must explicitly configure sources).
+ *  Used by the POS to build the target dropdown and by the server to validate the
+ *  request's toBranchId. */
+export declare function allowedSenderBranchIds(settings: PosStockTransferSettings | null | undefined): string[];
+/** The request modes a POS may create given the vendor setting. Empty = feature
+ *  disabled → no requests at all. Used by both the POS (to gate the UI) and the
+ *  server (to validate the create payload). */
+export declare function allowedRequestModes(settings: PosStockTransferSettings | null | undefined): InterBranchRequestMode[];
+export interface InterBranchRequest {
+    _id?: string;
+    vendorId: string;
+    fromBranchId: string;
+    toBranchId: string;
+    requestNumber?: string;
+    mode: InterBranchRequestMode;
+    items: InterBranchRequestItem[];
+    totalValue?: number;
+    status: InterBranchRequestStatus;
+    note?: string;
+    createdByTerminalId?: string;
+    createdByName?: string;
+    acknowledgedAt?: string;
+    acknowledgedByName?: string;
+    sentAt?: string;
+    receivedAt?: string;
+    receivedByName?: string;
+    stockTransferId?: string;
+    printCount?: number;
+    createdAt?: string;
+    updatedAt?: string;
+}

package/dist/interBranchRequest.js

@@ -0,0 +1,26 @@
+"use strict";
+// Inter-branch item requests — shared shapes for the POS-to-POS cross-branch
+// request feature (POS / dashboard / server). A terminal at the REQUESTER branch
+// asks the FULFILLER branch to send items; goods flow fulfiller → requester.
+// Completes the `in_transit`/`received` workflow the StockTransfer model reserved.
+// IDs are strings (JSON), not ObjectIds.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allowedSenderBranchIds = allowedSenderBranchIds;
+exports.allowedRequestModes = allowedRequestModes;
+/** Branch ids a POS may request FROM, given the setting. A strict whitelist:
+ *  EMPTY = no branch is selectable (the vendor must explicitly configure sources).
+ *  Used by the POS to build the target dropdown and by the server to validate the
+ *  request's toBranchId. */
+function allowedSenderBranchIds(settings) {
+    return (settings?.senderBranchIds || []).map(String);
+}
+/** The request modes a POS may create given the vendor setting. Empty = feature
+ *  disabled → no requests at all. Used by both the POS (to gate the UI) and the
+ *  server (to validate the create payload). */
+function allowedRequestModes(settings) {
+    if (!settings?.enabled)
+        return [];
+    if (settings.allowedModes === 'both')
+        return ['transfer', 'info'];
+    return [settings.allowedModes];
+}

package/dist/productCart.d.ts

@@ -120,6 +120,12 @@ export interface ProductType {
     /** When true, cashiers may override this item's price at the POS even if the
      *  branch-wide custom pricing setting is off (additive with branch setting). */
     allowCustomPricing?: boolean;
+    /** When true, a made-to-order line for this product accepts customer-supplied
+     *  reference photo(s) + a text note (e.g. a custom cake). The options UI (POS
+     *  and navori_app) shows an uploader + text box, stored on the cart line's
+     *  `referenceImages` + `notes`, and printed per-line on the factory's color/A4
+     *  printer. */
+    allowReferenceImages?: boolean;
     specifications?: {
         active: boolean;
         values: any[];
@@ -185,6 +191,12 @@ export interface CartItem {
     pluLocked?: boolean;
     /** Copied from the product; lets the POS enable price editing per-item. */
     allowCustomPricing?: boolean;
+    /** Customer-supplied reference photo(s) for a made-to-order line (e.g. a custom
+     *  cake). imgix ids, resolved via getImageUrl. Populated by the POS cashier
+     *  (QR handoff or file pick) OR by the customer in navori_app. A line carrying
+     *  these never merges with another. Printed per-line on the factory color/A4
+     *  printer; the accompanying text reuses `notes`. */
+    referenceImages?: string[];
 }
 export interface sModifier {
     name: NameType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shopoflex-types",
-  "version": "1.0.237",
+  "version": "1.0.240",
   "description": "Shared TypeScript types for Shopoflex applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",