@mohasinac/appkit 4.53.2 → 4.54.0-next.0

package/dist/index.d.ts

@@ -2076,7 +2076,6 @@ export { finalizeStagedMediaObject } from "./features/media/server";
 export { finalizeStagedMediaObjectArray } from "./features/media/server";
 export { finalizeStagedMediaUrl } from "./features/media/server";
 export { DEFAULT_ORDER_DATA } from "./features/orders/index";
-export { MarketplaceOrderCard } from "./features/orders/index";
 export { ORDER_ADMIN_SORT_OPTIONS } from "./features/orders/index";
 export { ORDER_COLLECTION } from "./features/orders/index";
 export { ORDER_FILTER_KEYS } from "./features/orders/index";
@@ -2125,10 +2124,6 @@ export { orderTimelineSchema } from "./features/orders/index";
 export { useOrder } from "./features/orders/index";
 export { useOrders } from "./features/orders/index";
 export { useTrackOrder } from "./features/orders/index";
-export type { MarketplaceOrderCardLabels } from "./features/orders/index";
-export type { MarketplaceOrderCardLinks } from "./features/orders/index";
-export type { MarketplaceOrderCardOrder } from "./features/orders/index";
-export type { MarketplaceOrderCardProps } from "./features/orders/index";
 export type { Order } from "./features/orders/index";
 export type { OrderAdminUpdateInput } from "./features/orders/index";
 export type { AppliedOrderDiscount } from "./features/orders/index";
@@ -2311,6 +2306,8 @@ export { getProductTableColumns } from "./features/products/index";
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/index";
 export { isFinalSale, acceptsChangeOfMindReturns, } from "./features/products/constants/final-sale";
 export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, isListingType, } from "./_internal/shared/listing-types/feature-flags";
+export { ADVANCED_LISTING_TYPE_CAPABILITY, ADVANCED_LISTING_TYPES, BASIC_LISTING_TYPES, LISTING_TYPE_TIER, assertListingTypeAllowed, hasAdvancedListingTypes, isAdvancedListingType, isListingTypeAllowedFor, listingTypesAllowedFor, } from "./_internal/shared/listing-types/tiers";
+export type { ListingTypeAccessContext, ListingTypeTier, } from "./_internal/shared/listing-types/tiers";
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type ActionEvent, type ActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";
 export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, type ActionDef, type ActionKind, type ActionResource, type ActionTree, type ActionConfirmation, } from "./_internal/shared/actions/action-registry";
@@ -2747,7 +2744,6 @@ export { AdminSiteConfigGuideView } from "./features/admin/components/AdminSiteC
 export { AdminTeamGuideView } from "./features/admin/components/AdminTeamGuideView";
 export { AdminAnalyticsGuideView } from "./features/admin/components/AdminAnalyticsGuideView";
 export { AdminTrustGuideView } from "./features/admin/components/AdminTrustGuideView";
-export { AdminWhatsAppGuideView } from "./features/admin/components/AdminWhatsAppGuideView";
 export { AdminPaymentsGuideView } from "./features/admin/components/AdminPaymentsGuideView";
 export { BuyerShoppingGuideView } from "./features/account/components/BuyerShoppingGuideView";
 export { BuyerAuctionsGuideView } from "./features/account/components/BuyerAuctionsGuideView";
@@ -2765,8 +2761,6 @@ export { StoreCapabilitiesGuideView } from "./features/stores/components/StoreCa
 export type { StoreCapabilitiesGuideViewProps } from "./features/stores/components/StoreCapabilitiesGuideView";
 export { StoreSettingsGuideView } from "./features/stores/components/StoreSettingsGuideView";
 export type { StoreSettingsGuideViewProps } from "./features/stores/components/StoreSettingsGuideView";
-export { StoreWhatsAppGuideView } from "./features/stores/components/StoreWhatsAppGuideView";
-export type { StoreWhatsAppGuideViewProps } from "./features/stores/components/StoreWhatsAppGuideView";
 export { StorePreOrdersListing } from "./features/stores/components/StorePreOrdersListing";
 export type { StorePreOrdersListingProps } from "./features/stores/components/StorePreOrdersListing";
 export { buildStoreColumns } from "./features/stores/index";
@@ -2820,25 +2814,8 @@ export { updateStoreAddressForSeller } from "./features/stores/server";
 export type { StoreContentParams } from "./features/stores/server";
 export type { StoreQueryListParams } from "./features/stores/server";
 export type { StoreReviewsResult } from "./features/stores/server";
-export { WhatsAppChatButton } from "./features/whatsapp-bot/index";
-export { SellerWhatsAppSettingsView } from "./features/whatsapp-bot/index";
-export type { SellerWhatsAppSettingsViewProps } from "./features/whatsapp-bot/index";
-export type { CheckoutMessageInput } from "./features/whatsapp-bot/index";
-export type { IncomingWebhookPayload } from "./features/whatsapp-bot/index";
-export type { OrderStatusKey } from "./features/whatsapp-bot/index";
-export type { SendWhatsAppInput } from "./features/whatsapp-bot/index";
-export type { StatusMessageInput } from "./features/whatsapp-bot/index";
-export type { StatusNotificationInput } from "./features/whatsapp-bot/index";
-export type { WebhookVerifyInput } from "./features/whatsapp-bot/index";
-export { buildCheckoutMessageURL } from "./features/whatsapp-bot/server";
-export { buildStatusMessage } from "./features/whatsapp-bot/server";
-export { buildStatusNotificationURL } from "./features/whatsapp-bot/server";
-export { buildPaymentProofReviewMessage } from "./features/whatsapp-bot/server";
-export { isAdminNumber } from "./features/whatsapp-bot/server";
-export { parseIncomingWebhookPayload } from "./features/whatsapp-bot/server";
-export { sendWhatsAppMessage } from "./features/whatsapp-bot/server";
-export { sendWhatsAppBusinessMessage, syncProductsToCatalog, buildPurchaseAnnouncementMessage, buildGroupShareLink } from "./features/whatsapp-bot/server";
-export type { WaBusinessSendInput, CatalogSyncProduct, CatalogSyncInput, CatalogSyncResult, PurchaseAnnouncementInput } from "./features/whatsapp-bot/index";
+export { buildPaymentProofReviewMessage } from "./features/orders/utils/payment-proof-message";
+export type { PaymentProofReviewMessageInput } from "./features/orders/utils/payment-proof-message";
 export { WishlistCard } from "./features/wishlist/index";
 export { WishlistPage } from "./features/wishlist/index";
 export { WishlistHeartButton } from "./features/wishlist/index";
@@ -3082,6 +3059,8 @@ export type { UserProfileOgData } from "./_internal/server/features/profile/og";
 export { LISTING_TYPE_CAPABILITIES, capabilityFor, canAddToCart, canBid, supportsShipping, requiresVendorVerified, requiresJurisdictionCheck, hasInstantFulfillment, assertNever, } from "./_internal/shared/listing-types/capabilities";
 export type { ListingTypeCapability } from "./_internal/shared/listing-types/capabilities";
 export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_internal/shared/listing-types/_registry";
+export { OwnerQuickActions } from "./features/admin/components/OwnerQuickActions";
+export type { OwnerQuickActionsProps, OwnerQuickActionsResource } from "./features/admin/components/OwnerQuickActions";
 export type { ListingTypePlugin } from "./_internal/shared/listing-types/_registry";
 export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules";
 export type { ListingCheckoutRule, CategoryCheckoutRule, CartItemProductPair, OrderItemInput, RefundPolicy, } from "./_internal/shared/checkout/rules";
@@ -3184,3 +3163,5 @@ export type { CourierRatingPair, CourierRatingDisplay, CourierRatingVote, Courie
  * server.ts.
  */
 export type { ConversationDocument, ConversationStatus, ConversationLastMessage, ParticipantRole, MessageDocument, MessageProductRef, } from "./features/messages/schemas/firestore";
+export { configurePlatformSupplier, getPlatformSupplier, resetPlatformSupplier, } from "./_internal/shared/features/site-settings/supplier-of-record";
+export type { PlatformSupplierIdentity } from "./_internal/shared/features/site-settings/supplier-of-record";

package/dist/index.js

@@ -3915,8 +3915,6 @@ export { finalizeStagedMediaUrl } from "./features/media/server.js";
 // DEFAULT_ORDER_DATA - Constant used across modules.
 export { DEFAULT_ORDER_DATA } from "./features/orders/index.js";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// MarketplaceOrderCard - Component for marketplace order card.
-export { MarketplaceOrderCard } from "./features/orders/index.js";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // ORDER_ADMIN_SORT_OPTIONS - Constant used across modules.
 export { ORDER_ADMIN_SORT_OPTIONS } from "./features/orders/index.js";
@@ -4306,6 +4304,9 @@ export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardLi
 export { isFinalSale, acceptsChangeOfMindReturns, } from "./features/products/constants/final-sale.js";
 // SB-UNI-X4 2026-05-13 â€" per-type feature-flag helpers.
 export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, isListingType, } from "./_internal/shared/listing-types/feature-flags.js";
+// Basic/advanced listing-type split — which types a store may create.
+// Pure (no firebase-admin in its import chain), so it is safe in index.ts.
+export { ADVANCED_LISTING_TYPE_CAPABILITY, ADVANCED_LISTING_TYPES, BASIC_LISTING_TYPES, LISTING_TYPE_TIER, assertListingTypeAllowed, hasAdvancedListingTypes, isAdvancedListingType, isListingTypeAllowedFor, listingTypesAllowedFor, } from "./_internal/shared/listing-types/tiers.js";
 // SB-UNI-X5 2026-05-13 â€" action telemetry sink.
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker.js";
 // SB-UNI-S 2026-05-13 â€" cart-level shipping-requirement helpers.
@@ -5045,8 +5046,6 @@ export { AdminTeamGuideView } from "./features/admin/components/AdminTeamGuideVi
 export { AdminAnalyticsGuideView } from "./features/admin/components/AdminAnalyticsGuideView.js";
 // [CLIENT-SSR]-Admin trust & safety guide — static view, no firebase-admin.
 export { AdminTrustGuideView } from "./features/admin/components/AdminTrustGuideView.js";
-// [CLIENT-SSR]-Admin WhatsApp integration guide — static view, no firebase-admin.
-export { AdminWhatsAppGuideView } from "./features/admin/components/AdminWhatsAppGuideView.js";
 // [CLIENT-SSR]-Admin payments (Razorpay) guide — static view, no firebase-admin.
 export { AdminPaymentsGuideView } from "./features/admin/components/AdminPaymentsGuideView.js";
 // [CLIENT-SSR]-Buyer shopping guide — static view, no firebase-admin.
@@ -5069,8 +5068,6 @@ export { StoreFinanceGuideView } from "./features/stores/components/StoreFinance
 export { StoreCapabilitiesGuideView } from "./features/stores/components/StoreCapabilitiesGuideView.js";
 // [CLIENT-SSR]-Store settings guide — static view, no firebase-admin.
 export { StoreSettingsGuideView } from "./features/stores/components/StoreSettingsGuideView.js";
-// [CLIENT-SSR]-Store WhatsApp catalog sync guide — static view, no firebase-admin.
-export { StoreWhatsAppGuideView } from "./features/stores/components/StoreWhatsAppGuideView.js";
 export { StorePreOrdersListing } from "./features/stores/components/StorePreOrdersListing.js";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // buildStoreColumns - Helper for build store columns.
@@ -5146,35 +5143,11 @@ export { storeSlugGET } from "./features/stores/server.js";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // updateStoreAddressForSeller - Helper for update store address for seller.
 export { updateStoreAddressForSeller } from "./features/stores/server.js";
-// ./features/whatsapp-bot/index
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// WhatsAppChatButton - Component for whats app chat button.
-export { WhatsAppChatButton } from "./features/whatsapp-bot/index.js";
-export { SellerWhatsAppSettingsView } from "./features/whatsapp-bot/index.js";
-// ./features/whatsapp-bot/server
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// buildCheckoutMessageURL - Helper for build checkout message url.
-export { buildCheckoutMessageURL } from "./features/whatsapp-bot/server.js";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// buildStatusMessage - Helper for build status message.
-export { buildStatusMessage } from "./features/whatsapp-bot/server.js";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// buildStatusNotificationURL - Helper for build status notification url.
-export { buildStatusNotificationURL } from "./features/whatsapp-bot/server.js";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// buildPaymentProofReviewMessage - Helper for build payment proof review message (Tier PP).
-export { buildPaymentProofReviewMessage } from "./features/whatsapp-bot/server.js";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// isAdminNumber - Shared export for is admin number.
-export { isAdminNumber } from "./features/whatsapp-bot/server.js";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// parseIncomingWebhookPayload - Helper for parse incoming webhook payload.
-export { parseIncomingWebhookPayload } from "./features/whatsapp-bot/server.js";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sendWhatsAppMessage - Shared export for send whats app message.
-export { sendWhatsAppMessage } from "./features/whatsapp-bot/server.js";
-// [SERVER-ONLY] Meta WhatsApp Business Cloud API helpers (WA1-WA8 integration)
-export { sendWhatsAppBusinessMessage, syncProductsToCatalog, buildPurchaseAnnouncementMessage, buildGroupShareLink } from "./features/whatsapp-bot/server.js";
+// ./features/orders/utils/payment-proof-message
+// [CLIENT-SAFE] Pure wa.me share-link message builder — no crypto, no network.
+// The WhatsApp Cloud API integration was removed 2026-10-20; this survived
+// because a wa.me deep link needs no token, number or Meta billing account.
+export { buildPaymentProofReviewMessage } from "./features/orders/utils/payment-proof-message.js";
 // ./features/wishlist/index
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // WishlistCard - Component for wishlist card.
@@ -5507,6 +5480,8 @@ export { renderPrivateProfileOgImage, renderUserProfileOgImage } from "./_intern
 // Listing-type capability registry â€" SB-UNI X1.
 export { LISTING_TYPE_CAPABILITIES, capabilityFor, canAddToCart, canBid, supportsShipping, requiresVendorVerified, requiresJurisdictionCheck, hasInstantFulfillment, assertNever, } from "./_internal/shared/listing-types/capabilities.js";
 export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_internal/shared/listing-types/_registry.js";
+// Pencil / clone / bin for whoever owns the record, on a PUBLIC surface.
+export { OwnerQuickActions } from "./features/admin/components/OwnerQuickActions.js";
 // Checkout rule registry â€" pure TS, safe in both client and server bundles.
 export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules/index.js";
 // Media upload limits â€" pure constants, safe in both client and server bundles.
@@ -5633,3 +5608,7 @@ export { RETURN_CUSTODY_STATES, RETURN_CUSTODY_COPY, isTerminalCustody, canAdvan
 export { resolveReturnAddress, RTO_ENTRY_CUSTODY, rtoCostBearer, RETURN_ABUSE_SCAM_TYPES, RETURN_ABUSE_THRESHOLDS, returnAbuseSignals, enforcementFor, } from "./_internal/shared/features/returns/destination.js";
 // C5f — courier ratings. Two numbers, never blended; see the module header.
 export { COURIER_RATING_MIN_CONFIDENT_SAMPLES, courierRatingDisplay, isValidCourierVote, courierVoteId, rollUpCourierVotes, } from "./_internal/shared/features/shipping/courier-rating.js";
+// The platform's statutory identity, injected at boot from appkit.config.js's
+// `business` block via the consumer's providers.config.ts. See the module
+// header for why the invoice path must not read it from siteSettings.
+export { configurePlatformSupplier, getPlatformSupplier, resetPlatformSupplier, } from "./_internal/shared/features/site-settings/supplier-of-record.js";

package/dist/next/routing/route-map.d.ts

@@ -183,6 +183,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CHECKOUT_SUCCESS: "/checkout/success";
         readonly OFFERS: "/user/offers";
         readonly REVIEWS: "/user/reviews";
+        readonly REVIEW_EDIT: (id: string) => string;
         readonly BIDS: "/user/bids";
         readonly BID_DETAIL: (id: string) => string;
         readonly RETURNS: "/user/returns";
@@ -618,6 +619,7 @@ export declare const ROUTES: {
         readonly CHECKOUT_SUCCESS: "/checkout/success";
         readonly OFFERS: "/user/offers";
         readonly REVIEWS: "/user/reviews";
+        readonly REVIEW_EDIT: (id: string) => string;
         readonly BIDS: "/user/bids";
         readonly BID_DETAIL: (id: string) => string;
         readonly RETURNS: "/user/returns";

package/dist/next/routing/route-map.js

@@ -273,6 +273,15 @@ export const DEFAULT_ROUTE_MAP = {
         CHECKOUT_SUCCESS: "/checkout/success",
         OFFERS: "/user/offers",
         REVIEWS: "/user/reviews",
+        /*
+         * The buyer's own review editor. There was no edit route for a review in
+         * EITHER portal — the user index was list-only and the admin side had just
+         * /admin/reviews — so a reviewer had no way to change what they had
+         * written. Added with its page and its nav entry in the same change
+         * (Root Cause #37: a route with no page, or a page with no nav, ships as
+         * half done).
+         */
+        REVIEW_EDIT: (id) => `/user/reviews/${id}/edit`,
         BIDS: "/user/bids",
         BID_DETAIL: (id) => `/user/bids/${id}/view`,
         RETURNS: "/user/returns",

package/dist/providers/shipping-shiprocket/index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @mohasinac/shipping-shiprocket — IShippingProvider over Shiprocket's v1 API.
+ *
+ * ── Read this before trusting it ──────────────────────────────────────────
+ *
+ * ── What is verified, and what is not ────────────────────────────────────
+ *
+ * ✅ VERIFIED against the live API (2026-10-20, real API-user credentials):
+ *    `POST /v1/external/auth/login` returns HTTP 200 with
+ *    `{ company_id, created_at, email, first_name, id, last_name, token }`.
+ *    The `token` field is present and non-empty, which is the only field
+ *    `loginResponse` requires — the rest are ignored, as Zod ignores unknown
+ *    keys by default.
+ *
+ * 🛑 NOT VERIFIED: every other endpoint. Order creation, AWB assignment,
+ *    tracking, serviceability and label generation all MUTATE or bill against
+ *    a real carrier account, so none was called. Their field names below are
+ *    claims taken from the published docs, not facts read off a payload.
+ *
+ * That asymmetry is the reason every response is parsed through Zod rather
+ * than cast: an unverified contract that is wrong surfaces as a named error at
+ * the boundary, instead of as an `undefined` AWB written to an order and shown
+ * to a buyer as a tracking number that tracks nothing.
+ *
+ * ── Auth: why a dedicated API user, and why the token is cached ───────────
+ *
+ * Shiprocket's core v1 API has no long-lived key/secret. You POST credentials
+ * to `/v1/external/auth/login` and receive a bearer token valid for roughly
+ * ten days, then log in again.
+ *
+ * 🛑 Those credentials should be a DEDICATED API USER (Shiprocket dashboard →
+ * Settings → API → Configure), not the dashboard login. Using the dashboard
+ * account means the token dies whenever someone changes that password — a
+ * shipping integration that breaks on an unrelated admin action — and it hands
+ * full account scope to this process. The env var is named
+ * `SHIPROCKET_LOGIN_USER_EMAIL` rather than `LOGIN_ID` because the login payload
+ * field is `email`; a var called "login id" invites someone to put a username
+ * in it and get a 400 they cannot explain.
+ *
+ * 🛑 The token is cached in module state with its expiry. Logging in per
+ * request would mean two round trips for every shipment and would hit
+ * Shiprocket's auth rate limit under any real volume. A 401 mid-flight clears
+ * the cache and retries ONCE — exactly once, because a credential that is
+ * genuinely wrong must fail fast rather than loop.
+ *
+ * ── What is deliberately NOT here ────────────────────────────────────────
+ *
+ * Inbound webhooks. Shiprocket pushes status updates to a URL configured in
+ * its dashboard and authenticates them with an `x-api-key` header whose value
+ * you set there — a THIRD secret, and an inbound route rather than a provider
+ * method. `trackShipment` below polls instead, which is correct for a provider
+ * contract and wasteful as a status mechanism; the webhook is the better
+ * answer and belongs in its own route with its own verification.
+ *
+ * @tag domain:shipping
+ * @tag layer:providers
+ * @tag access:server-only
+ */
+import { IShippingProvider } from "../../contracts";
+import type { CreateShipmentInput, Shipment, TrackingInfo, ServiceabilityResult } from "../../contracts";
+export interface ShiprocketConfig {
+    /** The API user's email. See the header on why this is not a "login id". */
+    email: string;
+    password: string;
+    /** Shiprocket pickup-location nickname, as registered in their dashboard. */
+    pickupLocation?: string;
+}
+export declare class ShiprocketShippingProvider extends IShippingProvider {
+    private readonly config;
+    readonly name = "shiprocket";
+    private token;
+    private tokenExpiresAt;
+    constructor(config: ShiprocketConfig);
+    /**
+     * A bearer token, logging in only when the cached one is absent or stale.
+     *
+     * The 60-second safety margin matters: a token that expires mid-request
+     * produces a 401 the caller has to interpret, and shaving a minute off a
+     * ten-day lifetime costs nothing.
+     */
+    private getToken;
+    /**
+     * One authenticated call, with a single re-auth on 401.
+     *
+     * 🛑 Exactly one retry. A token that expired early is worth one more attempt;
+     * a credential that is wrong must fail rather than loop, because a retry loop
+     * against an auth endpoint is how an integration gets rate-limited and then
+     * looks like an outage.
+     */
+    private call;
+    /** Their order payload wants the address flattened across many keys. */
+    private addressFields;
+    createShipment(data: CreateShipmentInput): Promise<Shipment>;
+    trackShipment(trackingId: string): Promise<TrackingInfo>;
+    cancelShipment(shipmentId: string): Promise<void>;
+    checkServiceability(pincode: string, weight: number): Promise<ServiceabilityResult>;
+    generateLabel(shipmentId: string): Promise<ArrayBuffer>;
+}