@uengage.io/platform-sdk 0.8.0 → 0.12.0

package/dist/business/schema.d.ts

@@ -2,14 +2,154 @@
  * Group names recognised by the business read API. Mirrors the GROUPS
  * registry in services/business; if the server adds a group, add it here.
  */
-export declare const BUSINESS_GROUPS: readonly ["profile", "gst", "payment_gateway"];
+export declare const BUSINESS_GROUPS: readonly ["profile", "branding", "compliance", "address", "contact", "hours", "slots", "order_types", "delivery", "charges", "attributes", "app_config", "payment_gateway", "bank"];
 export type BusinessGroupName = (typeof BUSINESS_GROUPS)[number];
 export interface BusinessProfile {
     name: string | null;
+    slug: string | null;
+    /** Numeric flag; 1 = active, 0 = inactive (legacy convention). */
+    status: number | null;
+    legal_entity_name: string | null;
 }
-export interface BusinessGst {
+export interface BusinessBranding {
+    /** Logo image URL or relative path served by the legacy CDN. */
+    logo: string | null;
+    /** Header/banner image URL. */
+    header_image: string | null;
+    /** Hex color string, e.g. "#01522B". */
+    brand_color: string | null;
+    social: {
+        facebook: string | null;
+        instagram: string | null;
+    };
+}
+export interface BusinessCompliance {
+    gstin: string | null;
+    fssai_no: string | null;
+    /** State of GST registration; same column as `address.state` in the DB. */
     state: string | null;
-    gst_no: string | null;
+    legal_entity_name: string | null;
+}
+export interface BusinessAddress {
+    city: string | null;
+    state: string | null;
+    address: string | null;
+    locality: string | null;
+    postal_code: number | null;
+    latitude: string | null;
+    longitude: string | null;
+}
+export interface BusinessContact {
+    outlet_phone: string | null;
+    owner_phone: string | null;
+    alternative_phone: string | null;
+    /** Phone number that receives order-failure / SLA-breach SMS alerts. */
+    alert_phone: string | null;
+    /** Comma-separated email list for daily reports + alerts. */
+    alert_emails: string | null;
+}
+export interface TimeOfDay {
+    hour: number | null;
+    minute: number;
+}
+export interface BusinessHours {
+    /** Window during which the storefront accepts online orders. */
+    online_orders: {
+        start: TimeOfDay;
+        end: TimeOfDay;
+    };
+    /** Real-world open/close times (may differ from order-window for prep buffers). */
+    actual: {
+        open: TimeOfDay;
+        close: TimeOfDay;
+    };
+    /** Hours of the day (0-23) when ordering is blocked. */
+    blocked_hours: number[];
+    /** Legacy off-hours config; same shape as blocked_hours. */
+    off_hours: number[];
+    /** Minutes between order placement and outlet handoff. String for legacy compat. */
+    preparation_time_minutes: string | null;
+}
+export interface BusinessSlots {
+    /** 1 = slots enabled, 0 = disabled. */
+    enabled: number | null;
+    /** 1 = slot-based ordering, 0 = continuous. */
+    slot_based_ordering: number | null;
+    /** "1" = show today's slots, "0" = hide. */
+    show_current_day: string | null;
+    /** Number of days into the future the user can pick slots for. */
+    day_limit: string | null;
+}
+export interface BusinessOrderTypes {
+    self_pickup: number | null;
+    delivery: number | null;
+    in_car: number | null;
+    dine_in: number | null;
+    /** "1" / "0" — legacy storage uses string. */
+    uengage_pay: string | null;
+    /**
+     * Inverted from intuition: "1" = delivery is fully disabled, "0" = enabled.
+     * Same string-typed legacy column.
+     */
+    delivery_disabled: string | null;
+}
+export interface BusinessDelivery {
+    /** Service radius in kilometers. String in legacy. */
+    radius_km: string | null;
+    /** Estimated delivery time, minutes. String in legacy. */
+    time_minutes: string | null;
+    tax_percent: number | null;
+    /** Min order value above which delivery is free. */
+    free_delivery_min_order_value: number | null;
+    /** Charge applied below the free-delivery threshold. */
+    delivery_charges: number | null;
+    /** Lower bound on order value the outlet accepts at all. */
+    eligible_order_value: number | null;
+    /** 0 → applied on Gross Value; 1 → applied on SubTotal. */
+    charges_applied_on: number;
+}
+export interface BusinessCharges {
+    packing: {
+        /** "1" = fixed, "2" = percentage. */
+        type: string | null;
+        /** Amount or percentage depending on `type`. */
+        amount: number | null;
+        tax_percent: number | null;
+    };
+    service: {
+        /** Percentage applied as service charge for dine-in orders. */
+        amount: number | null;
+        tax_percent: number | null;
+    };
+}
+export interface BusinessAttributes {
+    pure_veg: number | null;
+    serves_cuisine: string | null;
+    manages_riders: number | null;
+    /** "1" = grocery flow enabled in the consumer app. */
+    grocery_flow: string | null;
+    /** "1" = cloud kitchen (no in-person dining). */
+    cloud_kitchen: string | null;
+    /** Numeric campus identifier for B2B tenants; null for non-campus businesses. */
+    campus_id: string | null;
+}
+export interface BusinessAppConfig {
+    /** "1" = display menu prices inclusive of GST in the consumer app. */
+    menu_price_inclusive_of_gst: string | null;
+    new_launch: string | null;
+    share_link: string | null;
+    launch_date: string | null;
+    /** "0" = paid plan, "1" = free (legacy inverted). */
+    paid: string | null;
+    firebase_key: string | null;
+    /** Online listing visibility toggle; 1 = visible, 0 = hidden. */
+    online_visibility: number | null;
+    wallet: {
+        /** "1" = activated, "2" = inactive. */
+        activated: string | null;
+        /** "0" = show wallet tab, "1" = hide. */
+        hidden: string | null;
+    };
 }
 export interface BusinessPaymentGateway {
     razorpay: {
@@ -17,6 +157,12 @@ export interface BusinessPaymentGateway {
         secret: string | null;
     };
 }
+export interface BusinessBank {
+    account_holder: string | null;
+    account_number: string | null;
+    bank_name: string | null;
+    ifsc: string | null;
+}
 /**
  * Public summary of a parent business. Same shape as a top-level record
  * with the `profile` group included, but the parent's own parent is NOT
@@ -37,6 +183,17 @@ export interface BusinessRecord {
     /** Direct parent business (single level), or null if root. */
     parent: BusinessParent | null;
     profile?: BusinessProfile;
-    gst?: BusinessGst;
+    branding?: BusinessBranding;
+    compliance?: BusinessCompliance;
+    address?: BusinessAddress;
+    contact?: BusinessContact;
+    hours?: BusinessHours;
+    slots?: BusinessSlots;
+    order_types?: BusinessOrderTypes;
+    delivery?: BusinessDelivery;
+    charges?: BusinessCharges;
+    attributes?: BusinessAttributes;
+    app_config?: BusinessAppConfig;
     payment_gateway?: BusinessPaymentGateway;
+    bank?: BusinessBank;
 }

package/dist/business/schema.js

@@ -5,5 +5,20 @@ exports.BUSINESS_GROUPS = void 0;
  * Group names recognised by the business read API. Mirrors the GROUPS
  * registry in services/business; if the server adds a group, add it here.
  */
-exports.BUSINESS_GROUPS = ['profile', 'gst', 'payment_gateway'];
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NoZW1hLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2J1c2luZXNzL3NjaGVtYS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQTs7O0dBR0c7QUFDVSxRQUFBLGVBQWUsR0FBRyxDQUFDLFNBQVMsRUFBRSxLQUFLLEVBQUUsaUJBQWlCLENBQVUsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogR3JvdXAgbmFtZXMgcmVjb2duaXNlZCBieSB0aGUgYnVzaW5lc3MgcmVhZCBBUEkuIE1pcnJvcnMgdGhlIEdST1VQU1xuICogcmVnaXN0cnkgaW4gc2VydmljZXMvYnVzaW5lc3M7IGlmIHRoZSBzZXJ2ZXIgYWRkcyBhIGdyb3VwLCBhZGQgaXQgaGVyZS5cbiAqL1xuZXhwb3J0IGNvbnN0IEJVU0lORVNTX0dST1VQUyA9IFsncHJvZmlsZScsICdnc3QnLCAncGF5bWVudF9nYXRld2F5J10gYXMgY29uc3Q7XG5leHBvcnQgdHlwZSBCdXNpbmVzc0dyb3VwTmFtZSA9ICh0eXBlb2YgQlVTSU5FU1NfR1JPVVBTKVtudW1iZXJdO1xuXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzUHJvZmlsZSB7XG4gIG5hbWU6IHN0cmluZyB8IG51bGw7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NHc3Qge1xuICBzdGF0ZTogc3RyaW5nIHwgbnVsbDtcbiAgZ3N0X25vOiBzdHJpbmcgfCBudWxsO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzUGF5bWVudEdhdGV3YXkge1xuICByYXpvcnBheToge1xuICAgIGtleTogc3RyaW5nIHwgbnVsbDtcbiAgICBzZWNyZXQ6IHN0cmluZyB8IG51bGw7XG4gIH07XG59XG5cbi8qKlxuICogUHVibGljIHN1bW1hcnkgb2YgYSBwYXJlbnQgYnVzaW5lc3MuIFNhbWUgc2hhcGUgYXMgYSB0b3AtbGV2ZWwgcmVjb3JkXG4gKiB3aXRoIHRoZSBgcHJvZmlsZWAgZ3JvdXAgaW5jbHVkZWQsIGJ1dCB0aGUgcGFyZW50J3Mgb3duIHBhcmVudCBpcyBOT1RcbiAqIHJlY3Vyc2l2ZWx5IHJlc29sdmVkIChjYXBwZWQgYXQgZGVwdGggMSkuIENhbGxcbiAqIGBidXNpbmVzcy5nZXQocGFyZW50LmlkKWAgZm9yIHRoZSBncmFuZC1wYXJlbnQgaWYgbmVlZGVkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzUGFyZW50IHtcbiAgaWQ6IG51bWJlcjtcbiAgcHJvZmlsZTogQnVzaW5lc3NQcm9maWxlO1xufVxuXG4vKipcbiAqIFJlc3BvbnNlIHNoYXBlIGZyb20gR0VUIC92MS9idXNpbmVzc2VzLzppZCBhbmQgdGhlIGVudHJpZXMgcmV0dXJuZWQgYnlcbiAqIEdFVCAvdjEvYnVzaW5lc3Nlcy4gR3JvdXAga2V5cyBhcmUgb3B0aW9uYWwgLSB0aGUgc2VydmVyIGluY2x1ZGVzXG4gKiBvbmx5IHRoZSBncm91cHMgdGhhdCB3ZXJlIGJvdGggcmVxdWVzdGVkIGFuZCBhdXRob3JpemVkIGZvciB0aGUgY2FsbGVyLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzUmVjb3JkIHtcbiAgaWQ6IG51bWJlcjtcbiAgLyoqIERpcmVjdCBwYXJlbnQgYnVzaW5lc3MgKHNpbmdsZSBsZXZlbCksIG9yIG51bGwgaWYgcm9vdC4gKi9cbiAgcGFyZW50OiBCdXNpbmVzc1BhcmVudCB8IG51bGw7XG4gIHByb2ZpbGU/OiBCdXNpbmVzc1Byb2ZpbGU7XG4gIGdzdD86IEJ1c2luZXNzR3N0O1xuICBwYXltZW50X2dhdGV3YXk/OiBCdXNpbmVzc1BheW1lbnRHYXRld2F5O1xufVxuIl19
+exports.BUSINESS_GROUPS = [
+    'profile',
+    'branding',
+    'compliance',
+    'address',
+    'contact',
+    'hours',
+    'slots',
+    'order_types',
+    'delivery',
+    'charges',
+    'attributes',
+    'app_config',
+    'payment_gateway',
+    'bank',
+];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NoZW1hLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2J1c2luZXNzL3NjaGVtYS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQTs7O0dBR0c7QUFDVSxRQUFBLGVBQWUsR0FBRztJQUM3QixTQUFTO0lBQ1QsVUFBVTtJQUNWLFlBQVk7SUFDWixTQUFTO0lBQ1QsU0FBUztJQUNULE9BQU87SUFDUCxPQUFPO0lBQ1AsYUFBYTtJQUNiLFVBQVU7SUFDVixTQUFTO0lBQ1QsWUFBWTtJQUNaLFlBQVk7SUFDWixpQkFBaUI7SUFDakIsTUFBTTtDQUNFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEdyb3VwIG5hbWVzIHJlY29nbmlzZWQgYnkgdGhlIGJ1c2luZXNzIHJlYWQgQVBJLiBNaXJyb3JzIHRoZSBHUk9VUFNcbiAqIHJlZ2lzdHJ5IGluIHNlcnZpY2VzL2J1c2luZXNzOyBpZiB0aGUgc2VydmVyIGFkZHMgYSBncm91cCwgYWRkIGl0IGhlcmUuXG4gKi9cbmV4cG9ydCBjb25zdCBCVVNJTkVTU19HUk9VUFMgPSBbXG4gICdwcm9maWxlJyxcbiAgJ2JyYW5kaW5nJyxcbiAgJ2NvbXBsaWFuY2UnLFxuICAnYWRkcmVzcycsXG4gICdjb250YWN0JyxcbiAgJ2hvdXJzJyxcbiAgJ3Nsb3RzJyxcbiAgJ29yZGVyX3R5cGVzJyxcbiAgJ2RlbGl2ZXJ5JyxcbiAgJ2NoYXJnZXMnLFxuICAnYXR0cmlidXRlcycsXG4gICdhcHBfY29uZmlnJyxcbiAgJ3BheW1lbnRfZ2F0ZXdheScsXG4gICdiYW5rJyxcbl0gYXMgY29uc3Q7XG5leHBvcnQgdHlwZSBCdXNpbmVzc0dyb3VwTmFtZSA9ICh0eXBlb2YgQlVTSU5FU1NfR1JPVVBTKVtudW1iZXJdO1xuXG4vLyDilIDilIDilIAgSWRlbnRpdHkg4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSAXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzUHJvZmlsZSB7XG4gIG5hbWU6IHN0cmluZyB8IG51bGw7XG4gIHNsdWc6IHN0cmluZyB8IG51bGw7XG4gIC8qKiBOdW1lcmljIGZsYWc7IDEgPSBhY3RpdmUsIDAgPSBpbmFjdGl2ZSAobGVnYWN5IGNvbnZlbnRpb24pLiAqL1xuICBzdGF0dXM6IG51bWJlciB8IG51bGw7XG4gIGxlZ2FsX2VudGl0eV9uYW1lOiBzdHJpbmcgfCBudWxsO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzQnJhbmRpbmcge1xuICAvKiogTG9nbyBpbWFnZSBVUkwgb3IgcmVsYXRpdmUgcGF0aCBzZXJ2ZWQgYnkgdGhlIGxlZ2FjeSBDRE4uICovXG4gIGxvZ286IHN0cmluZyB8IG51bGw7XG4gIC8qKiBIZWFkZXIvYmFubmVyIGltYWdlIFVSTC4gKi9cbiAgaGVhZGVyX2ltYWdlOiBzdHJpbmcgfCBudWxsO1xuICAvKiogSGV4IGNvbG9yIHN0cmluZywgZS5nLiBcIiMwMTUyMkJcIi4gKi9cbiAgYnJhbmRfY29sb3I6IHN0cmluZyB8IG51bGw7XG4gIHNvY2lhbDoge1xuICAgIGZhY2Vib29rOiBzdHJpbmcgfCBudWxsO1xuICAgIGluc3RhZ3JhbTogc3RyaW5nIHwgbnVsbDtcbiAgfTtcbn1cblxuLy8g4pSA4pSA4pSAIFN0YXR1dG9yeSAvIHJlZ3VsYXRvcnkg4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSAXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzQ29tcGxpYW5jZSB7XG4gIGdzdGluOiBzdHJpbmcgfCBudWxsO1xuICBmc3NhaV9ubzogc3RyaW5nIHwgbnVsbDtcbiAgLyoqIFN0YXRlIG9mIEdTVCByZWdpc3RyYXRpb247IHNhbWUgY29sdW1uIGFzIGBhZGRyZXNzLnN0YXRlYCBpbiB0aGUgREIuICovXG4gIHN0YXRlOiBzdHJpbmcgfCBudWxsO1xuICBsZWdhbF9lbnRpdHlfbmFtZTogc3RyaW5nIHwgbnVsbDtcbn1cblxuLy8g4pSA4pSA4pSAIFdoZXJlIHRoZSBvdXRsZXQgbGl2ZXMg4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSA4pSAXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzQWRkcmVzcyB7XG4gIGNpdHk6IHN0cmluZyB8IG51bGw7XG4gIHN0YXRlOiBzdHJpbmcgfCBudWxsO1xuICBhZGRyZXNzOiBzdHJpbmcgfCBudWxsO1xuICBsb2NhbGl0eTogc3RyaW5nIHwgbnVsbDtcbiAgcG9zdGFsX2NvZGU6IG51bWJlciB8IG51bGw7XG4gIGxhdGl0dWRlOiBzdHJpbmcgfCBudWxsO1xuICBsb25naXR1ZGU6IHN0cmluZyB8IG51bGw7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NDb250YWN0IHtcbiAgb3V0bGV0X3Bob25lOiBzdHJpbmcgfCBudWxsO1xuICBvd25lcl9waG9uZTogc3RyaW5nIHwgbnVsbDtcbiAgYWx0ZXJuYXRpdmVfcGhvbmU6IHN0cmluZyB8IG51bGw7XG4gIC8qKiBQaG9uZSBudW1iZXIgdGhhdCByZWNlaXZlcyBvcmRlci1mYWlsdXJlIC8gU0xBLWJyZWFjaCBTTVMgYWxlcnRzLiAqL1xuICBhbGVydF9waG9uZTogc3RyaW5nIHwgbnVsbDtcbiAgLyoqIENvbW1hLXNlcGFyYXRlZCBlbWFpbCBsaXN0IGZvciBkYWlseSByZXBvcnRzICsgYWxlcnRzLiAqL1xuICBhbGVydF9lbWFpbHM6IHN0cmluZyB8IG51bGw7XG59XG5cbi8vIOKUgOKUgOKUgCBPcGVyYXRpb25zIOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgFxuZXhwb3J0IGludGVyZmFjZSBUaW1lT2ZEYXkge1xuICBob3VyOiBudW1iZXIgfCBudWxsO1xuICBtaW51dGU6IG51bWJlcjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBCdXNpbmVzc0hvdXJzIHtcbiAgLyoqIFdpbmRvdyBkdXJpbmcgd2hpY2ggdGhlIHN0b3JlZnJvbnQgYWNjZXB0cyBvbmxpbmUgb3JkZXJzLiAqL1xuICBvbmxpbmVfb3JkZXJzOiB7IHN0YXJ0OiBUaW1lT2ZEYXk7IGVuZDogVGltZU9mRGF5IH07XG4gIC8qKiBSZWFsLXdvcmxkIG9wZW4vY2xvc2UgdGltZXMgKG1heSBkaWZmZXIgZnJvbSBvcmRlci13aW5kb3cgZm9yIHByZXAgYnVmZmVycykuICovXG4gIGFjdHVhbDogeyBvcGVuOiBUaW1lT2ZEYXk7IGNsb3NlOiBUaW1lT2ZEYXkgfTtcbiAgLyoqIEhvdXJzIG9mIHRoZSBkYXkgKDAtMjMpIHdoZW4gb3JkZXJpbmcgaXMgYmxvY2tlZC4gKi9cbiAgYmxvY2tlZF9ob3VyczogbnVtYmVyW107XG4gIC8qKiBMZWdhY3kgb2ZmLWhvdXJzIGNvbmZpZzsgc2FtZSBzaGFwZSBhcyBibG9ja2VkX2hvdXJzLiAqL1xuICBvZmZfaG91cnM6IG51bWJlcltdO1xuICAvKiogTWludXRlcyBiZXR3ZWVuIG9yZGVyIHBsYWNlbWVudCBhbmQgb3V0bGV0IGhhbmRvZmYuIFN0cmluZyBmb3IgbGVnYWN5IGNvbXBhdC4gKi9cbiAgcHJlcGFyYXRpb25fdGltZV9taW51dGVzOiBzdHJpbmcgfCBudWxsO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIEJ1c2luZXNzU2xvdHMge1xuICAvKiogMSA9IHNsb3RzIGVuYWJsZWQsIDAgPSBkaXNhYmxlZC4gKi9cbiAgZW5hYmxlZDogbnVtYmVyIHwgbnVsbDtcbiAgLyoqIDEgPSBzbG90LWJhc2VkIG9yZGVyaW5nLCAwID0gY29udGludW91cy4gKi9cbiAgc2xvdF9iYXNlZF9vcmRlcmluZzogbnVtYmVyIHwgbnVsbDtcbiAgLyoqIFwiMVwiID0gc2hvdyB0b2RheSdzIHNsb3RzLCBcIjBcIiA9IGhpZGUuICovXG4gIHNob3dfY3VycmVudF9kYXk6IHN0cmluZyB8IG51bGw7XG4gIC8qKiBOdW1iZXIgb2YgZGF5cyBpbnRvIHRoZSBmdXR1cmUgdGhlIHVzZXIgY2FuIHBpY2sgc2xvdHMgZm9yLiAqL1xuICBkYXlfbGltaXQ6IHN0cmluZyB8IG51bGw7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NPcmRlclR5cGVzIHtcbiAgc2VsZl9waWNrdXA6IG51bWJlciB8IG51bGw7XG4gIGRlbGl2ZXJ5OiBudW1iZXIgfCBudWxsO1xuICBpbl9jYXI6IG51bWJlciB8IG51bGw7XG4gIGRpbmVfaW46IG51bWJlciB8IG51bGw7XG4gIC8qKiBcIjFcIiAvIFwiMFwiIOKAlCBsZWdhY3kgc3RvcmFnZSB1c2VzIHN0cmluZy4gKi9cbiAgdWVuZ2FnZV9wYXk6IHN0cmluZyB8IG51bGw7XG4gIC8qKlxuICAgKiBJbnZlcnRlZCBmcm9tIGludHVpdGlvbjogXCIxXCIgPSBkZWxpdmVyeSBpcyBmdWxseSBkaXNhYmxlZCwgXCIwXCIgPSBlbmFibGVkLlxuICAgKiBTYW1lIHN0cmluZy10eXBlZCBsZWdhY3kgY29sdW1uLlxuICAgKi9cbiAgZGVsaXZlcnlfZGlzYWJsZWQ6IHN0cmluZyB8IG51bGw7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NEZWxpdmVyeSB7XG4gIC8qKiBTZXJ2aWNlIHJhZGl1cyBpbiBraWxvbWV0ZXJzLiBTdHJpbmcgaW4gbGVnYWN5LiAqL1xuICByYWRpdXNfa206IHN0cmluZyB8IG51bGw7XG4gIC8qKiBFc3RpbWF0ZWQgZGVsaXZlcnkgdGltZSwgbWludXRlcy4gU3RyaW5nIGluIGxlZ2FjeS4gKi9cbiAgdGltZV9taW51dGVzOiBzdHJpbmcgfCBudWxsO1xuICB0YXhfcGVyY2VudDogbnVtYmVyIHwgbnVsbDtcbiAgLyoqIE1pbiBvcmRlciB2YWx1ZSBhYm92ZSB3aGljaCBkZWxpdmVyeSBpcyBmcmVlLiAqL1xuICBmcmVlX2RlbGl2ZXJ5X21pbl9vcmRlcl92YWx1ZTogbnVtYmVyIHwgbnVsbDtcbiAgLyoqIENoYXJnZSBhcHBsaWVkIGJlbG93IHRoZSBmcmVlLWRlbGl2ZXJ5IHRocmVzaG9sZC4gKi9cbiAgZGVsaXZlcnlfY2hhcmdlczogbnVtYmVyIHwgbnVsbDtcbiAgLyoqIExvd2VyIGJvdW5kIG9uIG9yZGVyIHZhbHVlIHRoZSBvdXRsZXQgYWNjZXB0cyBhdCBhbGwuICovXG4gIGVsaWdpYmxlX29yZGVyX3ZhbHVlOiBudW1iZXIgfCBudWxsO1xuICAvKiogMCDihpIgYXBwbGllZCBvbiBHcm9zcyBWYWx1ZTsgMSDihpIgYXBwbGllZCBvbiBTdWJUb3RhbC4gKi9cbiAgY2hhcmdlc19hcHBsaWVkX29uOiBudW1iZXI7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NDaGFyZ2VzIHtcbiAgcGFja2luZzoge1xuICAgIC8qKiBcIjFcIiA9IGZpeGVkLCBcIjJcIiA9IHBlcmNlbnRhZ2UuICovXG4gICAgdHlwZTogc3RyaW5nIHwgbnVsbDtcbiAgICAvKiogQW1vdW50IG9yIHBlcmNlbnRhZ2UgZGVwZW5kaW5nIG9uIGB0eXBlYC4gKi9cbiAgICBhbW91bnQ6IG51bWJlciB8IG51bGw7XG4gICAgdGF4X3BlcmNlbnQ6IG51bWJlciB8IG51bGw7XG4gIH07XG4gIHNlcnZpY2U6IHtcbiAgICAvKiogUGVyY2VudGFnZSBhcHBsaWVkIGFzIHNlcnZpY2UgY2hhcmdlIGZvciBkaW5lLWluIG9yZGVycy4gKi9cbiAgICBhbW91bnQ6IG51bWJlciB8IG51bGw7XG4gICAgdGF4X3BlcmNlbnQ6IG51bWJlciB8IG51bGw7XG4gIH07XG59XG5cbi8vIOKUgOKUgOKUgCBCdXNpbmVzcyBhdHRyaWJ1dGVzIC8gdHlwZSDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIBcbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NBdHRyaWJ1dGVzIHtcbiAgcHVyZV92ZWc6IG51bWJlciB8IG51bGw7XG4gIHNlcnZlc19jdWlzaW5lOiBzdHJpbmcgfCBudWxsO1xuICBtYW5hZ2VzX3JpZGVyczogbnVtYmVyIHwgbnVsbDtcbiAgLyoqIFwiMVwiID0gZ3JvY2VyeSBmbG93IGVuYWJsZWQgaW4gdGhlIGNvbnN1bWVyIGFwcC4gKi9cbiAgZ3JvY2VyeV9mbG93OiBzdHJpbmcgfCBudWxsO1xuICAvKiogXCIxXCIgPSBjbG91ZCBraXRjaGVuIChubyBpbi1wZXJzb24gZGluaW5nKS4gKi9cbiAgY2xvdWRfa2l0Y2hlbjogc3RyaW5nIHwgbnVsbDtcbiAgLyoqIE51bWVyaWMgY2FtcHVzIGlkZW50aWZpZXIgZm9yIEIyQiB0ZW5hbnRzOyBudWxsIGZvciBub24tY2FtcHVzIGJ1c2luZXNzZXMuICovXG4gIGNhbXB1c19pZDogc3RyaW5nIHwgbnVsbDtcbn1cblxuLy8g4pSA4pSA4pSAIEFwcC1sZXZlbCBjb25maWcgKyB2aXNpYmlsaXR5IOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgOKUgFxuZXhwb3J0IGludGVyZmFjZSBCdXNpbmVzc0FwcENvbmZpZyB7XG4gIC8qKiBcIjFcIiA9IGRpc3BsYXkgbWVudSBwcmljZXMgaW5jbHVzaXZlIG9mIEdTVCBpbiB0aGUgY29uc3VtZXIgYXBwLiAqL1xuICBtZW51X3ByaWNlX2luY2x1c2l2ZV9vZl9nc3Q6IHN0cmluZyB8IG51bGw7XG4gIG5ld19sYXVuY2g6IHN0cmluZyB8IG51bGw7XG4gIHNoYXJlX2xpbms6IHN0cmluZyB8IG51bGw7XG4gIGxhdW5jaF9kYXRlOiBzdHJpbmcgfCBudWxsO1xuICAvKiogXCIwXCIgPSBwYWlkIHBsYW4sIFwiMVwiID0gZnJlZSAobGVnYWN5IGludmVydGVkKS4gKi9cbiAgcGFpZDogc3RyaW5nIHwgbnVsbDtcbiAgZmlyZWJhc2Vfa2V5OiBzdHJpbmcgfCBudWxsO1xuICAvKiogT25saW5lIGxpc3RpbmcgdmlzaWJpbGl0eSB0b2dnbGU7IDEgPSB2aXNpYmxlLCAwID0gaGlkZGVuLiAqL1xuICBvbmxpbmVfdmlzaWJpbGl0eTogbnVtYmVyIHwgbnVsbDtcbiAgd2FsbGV0OiB7XG4gICAgLyoqIFwiMVwiID0gYWN0aXZhdGVkLCBcIjJcIiA9IGluYWN0aXZlLiAqL1xuICAgIGFjdGl2YXRlZDogc3RyaW5nIHwgbnVsbDtcbiAgICAvKiogXCIwXCIgPSBzaG93IHdhbGxldCB0YWIsIFwiMVwiID0gaGlkZS4gKi9cbiAgICBoaWRkZW46IHN0cmluZyB8IG51bGw7XG4gIH07XG59XG5cbi8vIOKUgOKUgOKUgCBNb25leSBpbiAvIG91dCDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIBcbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NQYXltZW50R2F0ZXdheSB7XG4gIHJhem9ycGF5OiB7XG4gICAga2V5OiBzdHJpbmcgfCBudWxsO1xuICAgIHNlY3JldDogc3RyaW5nIHwgbnVsbDtcbiAgfTtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBCdXNpbmVzc0Jhbmsge1xuICBhY2NvdW50X2hvbGRlcjogc3RyaW5nIHwgbnVsbDtcbiAgYWNjb3VudF9udW1iZXI6IHN0cmluZyB8IG51bGw7XG4gIGJhbmtfbmFtZTogc3RyaW5nIHwgbnVsbDtcbiAgaWZzYzogc3RyaW5nIHwgbnVsbDtcbn1cblxuLyoqXG4gKiBQdWJsaWMgc3VtbWFyeSBvZiBhIHBhcmVudCBidXNpbmVzcy4gU2FtZSBzaGFwZSBhcyBhIHRvcC1sZXZlbCByZWNvcmRcbiAqIHdpdGggdGhlIGBwcm9maWxlYCBncm91cCBpbmNsdWRlZCwgYnV0IHRoZSBwYXJlbnQncyBvd24gcGFyZW50IGlzIE5PVFxuICogcmVjdXJzaXZlbHkgcmVzb2x2ZWQgKGNhcHBlZCBhdCBkZXB0aCAxKS4gQ2FsbFxuICogYGJ1c2luZXNzLmdldChwYXJlbnQuaWQpYCBmb3IgdGhlIGdyYW5kLXBhcmVudCBpZiBuZWVkZWQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NQYXJlbnQge1xuICBpZDogbnVtYmVyO1xuICBwcm9maWxlOiBCdXNpbmVzc1Byb2ZpbGU7XG59XG5cbi8qKlxuICogUmVzcG9uc2Ugc2hhcGUgZnJvbSBHRVQgL3YxL2J1c2luZXNzZXMvOmlkIGFuZCB0aGUgZW50cmllcyByZXR1cm5lZCBieVxuICogR0VUIC92MS9idXNpbmVzc2VzLiBHcm91cCBrZXlzIGFyZSBvcHRpb25hbCAtIHRoZSBzZXJ2ZXIgaW5jbHVkZXNcbiAqIG9ubHkgdGhlIGdyb3VwcyB0aGF0IHdlcmUgYm90aCByZXF1ZXN0ZWQgYW5kIGF1dGhvcml6ZWQgZm9yIHRoZSBjYWxsZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQnVzaW5lc3NSZWNvcmQge1xuICBpZDogbnVtYmVyO1xuICAvKiogRGlyZWN0IHBhcmVudCBidXNpbmVzcyAoc2luZ2xlIGxldmVsKSwgb3IgbnVsbCBpZiByb290LiAqL1xuICBwYXJlbnQ6IEJ1c2luZXNzUGFyZW50IHwgbnVsbDtcbiAgcHJvZmlsZT86IEJ1c2luZXNzUHJvZmlsZTtcbiAgYnJhbmRpbmc/OiBCdXNpbmVzc0JyYW5kaW5nO1xuICBjb21wbGlhbmNlPzogQnVzaW5lc3NDb21wbGlhbmNlO1xuICBhZGRyZXNzPzogQnVzaW5lc3NBZGRyZXNzO1xuICBjb250YWN0PzogQnVzaW5lc3NDb250YWN0O1xuICBob3Vycz86IEJ1c2luZXNzSG91cnM7XG4gIHNsb3RzPzogQnVzaW5lc3NTbG90cztcbiAgb3JkZXJfdHlwZXM/OiBCdXNpbmVzc09yZGVyVHlwZXM7XG4gIGRlbGl2ZXJ5PzogQnVzaW5lc3NEZWxpdmVyeTtcbiAgY2hhcmdlcz86IEJ1c2luZXNzQ2hhcmdlcztcbiAgYXR0cmlidXRlcz86IEJ1c2luZXNzQXR0cmlidXRlcztcbiAgYXBwX2NvbmZpZz86IEJ1c2luZXNzQXBwQ29uZmlnO1xuICBwYXltZW50X2dhdGV3YXk/OiBCdXNpbmVzc1BheW1lbnRHYXRld2F5O1xuICBiYW5rPzogQnVzaW5lc3NCYW5rO1xufVxuIl19

package/dist/client.d.ts

@@ -1,34 +1,86 @@
 import { type AuditClient } from './audit/client';
 import { type BusinessClient } from './business/client';
-import { auth } from './auth';
+import { type ZonesClient } from './zones/client';
+import { auth as authNamespace } from './auth';
 /**
- * Caller-facing config for the unified `createClient(...)` factory and
- * the `platform` singleton.
+ * Caller-facing config for `createClient(...)`.
  *
- * Pick exactly one of:
- *   - `accessToken` (string or callback) for the static Bearer flow
- *   - `serviceId` + `serviceSecret` for OAuth2 client_credentials
+ * `createClient()` (no args) reads everything from the standard
+ * `UENGAGE_*` environment variables — convenient for Lambdas that
+ * already have their config injected by the deploy stack. Any field
+ * passed explicitly overrides the matching env default for that one
+ * call only (no shared mutable state, no singleton).
  *
- * Without either, calls throw `ConfigError` on the first request.
+ * Auth-mode fields are mutually exclusive. Pick one:
+ *   - `serviceId` + `serviceSecret`  OAuth2 client_credentials.
+ *   - `authToken`                    static Bearer token, or async
+ *                                    callback that returns one.
+ *   - `session: {id, token}`         legacy uEngage (id, apiToken) /
+ *                                    (id, addo_contacts_mapping.token)
+ *                                    pair. The SDK probes the business
+ *                                    surface (users) first, falls back
+ *                                    to the customer surface
+ *                                    (addo_contacts_mapping) if the
+ *                                    business probe returns
+ *                                    `invalid_grant`, and caches the
+ *                                    resulting JWT.
+ *
+ * Passing more than one explicitly is a `ConfigError`. Passing any one
+ * of them suppresses every env-derived auth default, so a caller's
+ * explicit override is never silently merged with env credentials of
+ * a different mode.
  */
 export interface ClientConfig {
     baseUrl?: string;
     /**
      * Auth surface base used to bootstrap the first client_credentials
-     * mint. Defaults to `${baseUrl}/auth/business`. Once a token exists,
-     * future auth calls follow the token's `iss` claim.
+     * mint. Defaults to `${baseUrl}/auth/business`.
      */
     authBaseUrl?: string;
     /**
-     * Customer auth surface base used by `withSessionToken`. Defaults
-     * to `${baseUrl}/auth/customer`.
+     * Customer auth surface base used by `session` exchanges. Defaults to
+     * `${baseUrl}/auth/customer`.
      */
     customerAuthBaseUrl?: string;
-    accessToken?: string | (() => string | Promise<string>);
+    /** OAuth2 `client_credentials` clientId. Pair with `serviceSecret`. */
     serviceId?: string;
+    /** OAuth2 `client_credentials` clientSecret. Pair with `serviceId`. */
     serviceSecret?: string;
     /** Space-separated scope list to request when minting via client_credentials. */
     scope?: string;
+    /** Static Bearer JWT, or async callback that returns one. */
+    authToken?: string | (() => string | Promise<string>);
+    /**
+     * Legacy uEngage (id, token) pair. `id` is `users.userId` for staff
+     * users (matched via the business surface) or
+     * `addo_contacts_mapping.id`/`contactId` for customers (matched via
+     * the customer surface). The SDK probes the business surface first
+     * and falls back to customer on `invalid_grant`.
+     */
+    session?: {
+        id: string | number;
+        token: string;
+    };
+    /**
+     * `(accessToken, refreshToken)` pair from a finished login flow
+     * (`auth.loginWithPassword(...)`, `auth.verifyOtp(...)`, etc). The
+     * SDK uses the access token until it expires, then rotates via
+     * `auth.refresh(...)` transparently. `onRotate` fires after every
+     * rotation so callers can persist the new pair.
+     */
+    tokens?: {
+        accessToken: string;
+        refreshToken: string;
+        /** Access token TTL (seconds), as returned by the auth surface. */
+        expiresIn: number;
+        /** OAuth client id used during the original login (required by the refresh handler). */
+        clientId: string;
+        onRotate?: (pair: {
+            accessToken: string;
+            refreshToken: string;
+            expiresAt: number;
+        }) => void | Promise<void>;
+    };
     /**
      * Service identifier the audit client should stamp into `actor.via`
      * on emitted events. Defaults to `serviceId` when set; otherwise
@@ -41,48 +93,22 @@ export interface ClientConfig {
 export interface PlatformClient {
     business: BusinessClient;
     audit: AuditClient;
-    auth: typeof auth;
-    /**
-     * Return a derived client bound to the supplied access token.
-     * Inherits `baseUrl` and `fetchFn`; replaces the token source with
-     * the new one. Use case: BFF handlers that want to call the
-     * platform API as the end user instead of as the service.
-     */
-    withToken(token: string | (() => string | Promise<string>)): PlatformClient;
+    zones: ZonesClient;
+    auth: typeof authNamespace;
     /**
-     * Return a derived client that exchanges a legacy customer session
-     * token (from `addo_contacts_mapping.token`) for a Bearer JWT
-     * transparently on each call. The session token is the persistent
-     * credential — exchanges happen lazily on token-cache miss and on
-     * 401 retries. When the legacy session is revoked, the next
-     * exchange returns 401 and surfaces as `AuthenticationError`.
+     * Resolve the current access token, minting via the configured auth
+     * mode if the cache is cold. Useful for `auth.verifyAccessToken(...)`
+     * round-trips and for callers that want to log / forward the bearer
+     * to a downstream service.
+     *
+     * Throws `ConfigError` when the client was built with no auth mode.
      */
-    withSessionToken(sessionToken: string): PlatformClient;
+    getAccessToken(): Promise<string>;
 }
 /**
- * Build a fresh, isolated client from explicit config. Each call
- * gets its own TokenSource state — concurrent `createClient(...)` use
- * does not stampede the cache.
+ * Build a fresh, isolated client. With no args, reads `UENGAGE_*`
+ * env vars; explicit fields override per call. Each call gets its own
+ * TokenSource state — concurrent `createClient(...)` use does not
+ * stampede the cache.
  */
 export declare function createClient(input?: ClientConfig): PlatformClient;
-/**
- * Default client. Reads config from environment variables on first
- * property access (so test setups that mutate `process.env` after
- * import work). Use `createClient(...)` when you need an isolated
- * instance with explicit config.
- *
- *   UENGAGE_BASE_URL         defaults to https://api.platform.uengage.io
- *   UENGAGE_AUTH_BASE_URL    auth surface override (default ${baseUrl}/auth/business)
- *   UENGAGE_AUTH_TOKEN       static Bearer token (overrides client_credentials)
- *   UENGAGE_SERVICE_ID       OAuth2 client_credentials clientId
- *   UENGAGE_SERVICE_SECRET   OAuth2 client_credentials clientSecret
- *   UENGAGE_SERVICE_SCOPE    optional space-separated scope list
- */
-export declare const platform: PlatformClient;
-/** Test-only: drop the singleton cache between cases. */
-export declare function _resetPlatformSingleton(): void;
-/**
- * Convenience: shorthand for `platform.withToken(token)`.
- * BFF handlers commonly call this once per request.
- */
-export declare function withToken(token: string | (() => string | Promise<string>)): PlatformClient;