@infuro/cms-core 1.0.45 → 1.0.47

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import PgBoss from 'pg-boss';
 import * as typeorm from 'typeorm';
-import { DataSource, EntityTarget, ObjectLiteral, EntityManager, SelectQueryBuilder } from 'typeorm';
+import { DataSource, EntityManager, EntityTarget, ObjectLiteral, Repository, SelectQueryBuilder } from 'typeorm';
 import { ClassValue } from 'clsx';
 import { Metadata } from 'next';
 import { EventEmitter } from 'events';
@@ -121,7 +121,7 @@ declare class ERPSubmissionService {
     }[]): ContactFormData | null;
 }
 
-interface CmsAppLike$4 {
+interface CmsAppLike$5 {
     getPlugin(name: string): unknown;
 }
 type ErpJobPayload = {
@@ -140,8 +140,8 @@ type ErpJobPayload = {
     kind: 'productUpsert';
     product: Record<string, unknown>;
 };
-declare function queueErp(cms: CmsAppLike$4, payload: ErpJobPayload): Promise<void>;
-declare function registerErpQueueProcessor(cms: CmsAppLike$4): void;
+declare function queueErp(cms: CmsAppLike$5, payload: ErpJobPayload): Promise<void>;
+declare function registerErpQueueProcessor(cms: CmsAppLike$5): void;
 
 /**
  * Duck-typed DataSource so host apps (e.g. Next) can pass their own TypeORM instance
@@ -162,7 +162,7 @@ type ErpPaidOrderEntityMap = Record<string, unknown>;
  * Enqueues ERP `order.created` only when the order has at least one **completed** payment.
  * Include `payments` in the payload.
  */
-declare function queueErpPaidOrderForOrderId(cms: CmsAppLike$4, dataSource: ErpPaidOrderDataSource, entityMap: ErpPaidOrderEntityMap, orderId: number): Promise<void>;
+declare function queueErpPaidOrderForOrderId(cms: CmsAppLike$5, dataSource: ErpPaidOrderDataSource, entityMap: ErpPaidOrderEntityMap, orderId: number): Promise<void>;
 
 interface ErpContactSyncInput {
     name: string;
@@ -178,7 +178,43 @@ interface ErpContactSyncInput {
  * When ERP is enabled and plugin loaded, enqueue `create-contact` (non-fatal on failure).
  * Used for admin CRUD and storefront contact paths — not form submissions (those use lead/opportunity).
  */
-declare function queueErpCreateContactIfEnabled(cms: CmsAppLike$4, dataSource: ErpPaidOrderDataSource, entityMap: ErpPaidOrderEntityMap, input: ErpContactSyncInput): Promise<void>;
+declare function queueErpCreateContactIfEnabled(cms: CmsAppLike$5, dataSource: ErpPaidOrderDataSource, entityMap: ErpPaidOrderEntityMap, input: ErpContactSyncInput): Promise<void>;
+
+type CmsAppLike$4 = {
+    getPlugin(name: string): unknown;
+};
+type ErpConfigDataSource = {
+    getRepository(entity: unknown): {
+        find(options?: object): Promise<unknown[]>;
+    };
+};
+
+type ResolvedOrderInvoicePdf = {
+    bytes: Uint8Array;
+    filename: string;
+    contentType: string;
+    source: 'erp' | 'local';
+};
+type ResolveOrderInvoicePdfError = {
+    error: string;
+    status: number;
+};
+declare function isOrderEligibleForInvoiceEmail(status: string | null | undefined, orderKind?: string | null): boolean;
+/**
+ * Resolve invoice PDF bytes for a **sale** order (ERP prefer → local).
+ * Shared by HTTP download and order-confirmation email attachment.
+ */
+declare function resolveOrderInvoicePdfBytes(cms: CmsAppLike$4, dataSource: ErpConfigDataSource, entityMap: Record<string, unknown>, orderId: number, options?: {
+    ownerContactId?: number;
+}): Promise<ResolvedOrderInvoicePdf | ResolveOrderInvoicePdfError>;
+/**
+ * Streams invoice PDF for a **sale** order.
+ * Prefer ERP tax invoice when configured + ready; otherwise generate a local PDF
+ * using the store `invoiceTemplate` setting.
+ */
+declare function streamOrderInvoicePdf(cms: CmsAppLike$4, dataSource: ErpConfigDataSource, entityMap: Record<string, unknown>, orderId: number, options: {
+    ownerContactId?: number;
+}): Promise<Response>;
 
 interface ERPPluginConfig {
     webhookUrl: string;
@@ -261,12 +297,18 @@ interface EmailPluginConfig$1 {
     secretAccessKey?: string;
     templateOptions?: RenderEmailOptions;
 }
+interface EmailAttachment {
+    filename: string;
+    content: Buffer | Uint8Array;
+    contentType?: string;
+}
 interface EmailData {
     subject: string;
     html: string;
     text?: string;
     to?: string;
     from?: string;
+    attachments?: EmailAttachment[];
 }
 interface EmailServiceInterface {
     send(emailData: EmailData): Promise<boolean>;
@@ -284,6 +326,7 @@ declare class EmailService implements EmailServiceInterface {
     /** AWS via SMTP (nodemailer) vs SES API SDK. */
     private awsViaSmtp;
     constructor(config: EmailPluginConfig$1);
+    private nodemailerAttachments;
     send(emailData: EmailData): Promise<boolean>;
     renderTemplate(templateName: EmailTemplateName, ctx: TemplateContext<unknown>): RenderedEmail;
     /** Default notification recipient from plugin config (SMTP_TO / plugin `to`). */
@@ -326,6 +369,7 @@ declare function renderLayout(options: {
 
 interface CmsAppLike$3 {
     getPlugin(name: string): unknown;
+    dataSource?: unknown;
 }
 /** Context for template rendering: at least companyDetails; template-specific fields (formName, etc.) are allowed. */
 interface EmailJobPayload {
@@ -337,8 +381,18 @@ interface EmailJobPayload {
     subject?: string;
     html?: string;
     text?: string;
-}
-declare function registerEmailQueueProcessor(cms: CmsAppLike$3): void;
+    /** When set with attachInvoice, processor builds PDF in-worker (not stored in queue). */
+    orderId?: number;
+    /** Customer order-confirmed mail only — attach order invoice PDF when eligible. */
+    attachInvoice?: boolean;
+    attachments?: EmailAttachment[];
+}
+interface EmailQueueProcessorOptions {
+    /** Prefer explicit getter (host apps); falls back to `cms.dataSource`. */
+    getDataSource?: () => Promise<DataSource>;
+    entityMap?: Record<string, unknown>;
+}
+declare function registerEmailQueueProcessor(cms: CmsAppLike$3, options?: EmailQueueProcessorOptions): void;
 declare function queueEmail(cms: CmsAppLike$3, payload: EmailJobPayload): Promise<void>;
 interface OrderPlacedEmailPayload {
     orderNumber: string;
@@ -355,6 +409,15 @@ interface OrderPlacedEmailPayload {
     lineItems: OrderPlacedLineItem[];
     billingAddress?: Record<string, string>;
     shippingAddress?: Record<string, string>;
+    /**
+     * When set, customer email may attach order invoice (processor checks status eligibility).
+     * Sales emails never attach.
+     */
+    orderId?: number;
+    /**
+     * Default true when orderId is set. Set false to skip invoice PDF on customer mail.
+     */
+    attachInvoiceToCustomer?: boolean;
 }
 /** Queues one `orderPlaced` email per recipient (customer + each unique sales address; skips sales if same as customer). */
 declare function queueOrderPlacedEmails(cms: CmsAppLike$3, payload: OrderPlacedEmailPayload): Promise<void>;
@@ -363,7 +426,7 @@ interface VendorOnboardEmailPayload {
     vendorSlug?: string;
     ownerName: string;
     ownerEmail: string;
-    activation: 'invite' | 'password';
+    activation: 'invite' | 'password' | 'membership';
     inviteLink?: string;
     signInLink: string;
     kind?: 'vendor_onboard' | 'team_invite';
@@ -765,7 +828,7 @@ interface SessionUser {
     vendorIds?: number[];
     /** Active vendor for scoped CRUD (vendor staff). */
     activeVendorId?: number | null;
-    /** Role for the active vendor link (`vendor_users.role`). */
+    /** @deprecated Prefer isVendorRoleOwner / vendorRoleId. Legacy owner|staff hint. */
     vendorRole?: 'owner' | 'staff' | null;
     /** Active vendor-scoped role id (`vendor_users.vendorRoleId`). */
     vendorRoleId?: number | null;
@@ -830,7 +893,9 @@ type VendorScope = {
 } | {
     type: 'deny';
 };
-declare const VENDOR_OWNER_GROUP_NAME = "Vendor Owner";
+declare const VENDOR_GROUP_NAME = "Vendor";
+/** @deprecated Use VENDOR_GROUP_NAME */
+declare const VENDOR_OWNER_GROUP_NAME = "Vendor";
 /** User groups treated as vendor store staff (sidebar + scoped admin). */
 declare function isVendorGroupName(name: string | null | undefined): boolean;
 declare function isPlatformAdministrator(user: SessionUser | null | undefined): boolean;
@@ -857,6 +922,50 @@ declare function vendorPortalFlagsFromUser(input: {
     isVendorOwner: boolean;
 };
 
+type EntityMapLike$3 = Record<string, EntityTarget<ObjectLiteral> | undefined>;
+type InventoryOrderLine = {
+    productId: number;
+    quantity: number;
+    variantId?: number | null;
+};
+type OrderInventorySnapshot = {
+    status: string;
+    lines: InventoryOrderLine[];
+};
+declare function orderStatusHoldsStock(status: string | null | undefined): boolean;
+declare function orderInventorySnapshotFromRow(order: {
+    status?: string;
+    items?: Array<{
+        productId: number;
+        quantity: unknown;
+        variantId?: number | null;
+        metadata?: Record<string, unknown> | null;
+    }>;
+}): OrderInventorySnapshot;
+/** Merge lines by product+variant so duplicate lines net correctly. */
+declare function mergeInventoryLines(lines: InventoryOrderLine[]): Map<string, InventoryOrderLine>;
+type EmOrDs$1 = DataSource | EntityManager;
+/**
+ * Validate stock for lines that will hold inventory (confirmed/completed).
+ * Checks product.quantity (summed across variants) and per-variant inventory.
+ */
+declare function validateInventoryForConfirmedOrderLines(ds: EmOrDs$1, entityMap: EntityMapLike$3, lines: InventoryOrderLine[]): Promise<string | null>;
+/**
+ * When an order may already hold stock: available = DB qty + prior held qty for that key.
+ */
+declare function validateInventoryForOrderBecomingConfirmed(ds: EmOrDs$1, entityMap: EntityMapLike$3, prevSnap: OrderInventorySnapshot | null, nextLines: InventoryOrderLine[]): Promise<string | null>;
+/**
+ * Restore stock when leaving a held status; deduct when entering a held status.
+ * Restore runs before deduct so line edits while staying held net correctly.
+ */
+declare function reconcileOrderInventoryBetweenSnapshots(ds: EmOrDs$1, entityMap: EntityMapLike$3, prev: OrderInventorySnapshot, next: OrderInventorySnapshot): Promise<string | null>;
+/** Convenience: deduct stock for a newly confirmed/completed order. */
+declare function deductInventoryForConfirmedOrder(ds: EmOrDs$1, entityMap: EntityMapLike$3, lines: InventoryOrderLine[], options?: {
+    validate?: boolean;
+}): Promise<string | null>;
+/** Convenience: restore stock when cancelling a held order. */
+declare function restoreInventoryForCancelledOrder(ds: EmOrDs$1, entityMap: EntityMapLike$3, lines: InventoryOrderLine[]): Promise<string | null>;
+
 type EntityMap$2 = Record<string, typeorm.EntityTarget<typeorm.ObjectLiteral>>;
 interface CrudHandlerOptions {
     requireAuth: (req: Request) => Promise<Response | null>;
@@ -1275,7 +1384,7 @@ declare function createUsersApiHandlers(config: UsersApiConfig): {
     getById(_req: Request, id: string): Promise<Response>;
     update(req: Request, id: string): Promise<Response>;
     delete(_req: Request, id: string): Promise<Response>;
-    regenerateInvite(_req: Request, id: string): Promise<Response>;
+    regenerateInvite(req: Request, id: string): Promise<Response>;
 };
 interface UserAvatarConfig extends CmsHandlersBase {
     getSession: () => Promise<{
@@ -1629,6 +1738,8 @@ declare class UserGroup {
     users: User[];
 }
 
+/** Invite lifecycle for CMS users (separate from `blocked`). */
+type UserInviteStatus = 'pending' | 'active';
 declare class User {
     id: number;
     name: string;
@@ -1638,6 +1749,13 @@ declare class User {
     phoneVerifiedAt: Date | null;
     emailVerifiedAt: Date | null;
     password: string | null;
+    /**
+     * `pending` = invite outstanding (cannot sign in until password is set).
+     * `active` = invite accepted / account usable (subject to `blocked`).
+     */
+    inviteStatus: UserInviteStatus;
+    /** Rotating invite token; null when active or no invite outstanding. */
+    inviteToken: string | null;
     blocked: boolean;
     adminAccess: boolean;
     groupId: number | null;
@@ -1679,20 +1797,38 @@ declare class VendorRole {
     permissions: VendorRolePermission[];
 }
 
-/** Links a staff user to a vendor store. */
+/** Person KYC / contact for a vendor owner or team member (1:1 with vendor_users). */
+declare class VendorUserProfile {
+    id: number;
+    name: string;
+    email: string;
+    phone: string | null;
+    aadhaarNo: string | null;
+    panNo: string | null;
+    addressLine1: string | null;
+    addressLine2: string | null;
+    city: string | null;
+    state: string | null;
+    postalCode: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+/** @deprecated Prefer vendorRoleId / isOwnerRole from vendor_roles */
 type VendorUserRole = 'owner' | 'staff';
+/** Links a staff user to a vendor store. Store role is vendorRoleId only. */
 declare class VendorUser {
     id: number;
     vendorId: number;
     userId: number;
-    /** @deprecated use vendorRoleId — kept for migration compatibility */
-    role: VendorUserRole;
-    vendorRoleId: number | null;
+    vendorRoleId: number;
+    vendorUserProfileId: number;
     createdAt: Date;
     updatedAt: Date;
     vendor: Vendor;
     user: User;
-    vendorRole: VendorRole | null;
+    vendorRole: VendorRole;
+    vendorUserProfile: VendorUserProfile;
 }
 
 type VendorInviteStatus = 'none' | 'pending' | 'expired' | 'accepted';
@@ -1713,7 +1849,6 @@ declare class Vendor {
     country: string | null;
     postalCode: string | null;
     gstin: string | null;
-    pan: string | null;
     logo: string | null;
     description: string | null;
     metadata: Record<string, unknown> | null;
@@ -1745,6 +1880,19 @@ declare function findVendorByInviteToken(dataSource: DataSource, vendorEntity: E
     metadata: Record<string, unknown> | null;
 } | null>;
 
+/** Same URL shape as vendor invites: `/admin/invite?token=…`. */
+declare function buildUserInviteLink(baseUrl: string, token: string): string;
+declare function newUserInviteToken(): string;
+declare function findUserByInviteToken(dataSource: DataSource, userEntity: EntityTarget<ObjectLiteral>, token: string): Promise<{
+    id: number;
+    email: string;
+    blocked: boolean;
+    password: string | null;
+    inviteStatus: UserInviteStatus;
+    inviteToken: string | null;
+} | null>;
+declare function completeUserInviteAccept(dataSource: DataSource, userEntity: EntityTarget<ObjectLiteral>, userId: number, passwordHash: string): Promise<void>;
+
 /** Parse stored config value into a list of emails (JSON array, or comma/semicolon-separated string). */
 declare function parseEmailRecipientsFromConfig(raw: string | undefined | null): string[];
 /** Serialize email list for config storage (JSON array in DB). */
@@ -1798,19 +1946,103 @@ declare function rateLimitPublicApiIfNeeded(req: Request, method: string, segmen
 }): Promise<Response | null>;
 declare function rateLimitCheckoutPost(req: Request): Promise<Response | null>;
 
-interface EntityMapLike$1 {
+interface EntityMapLike$2 {
     configs: unknown;
     orders: unknown;
     order_items: unknown;
 }
 interface SendOrderPlacedEmailDeps {
     getDataSource: () => Promise<DataSource>;
-    entityMap: EntityMapLike$1;
-    getCms: () => Promise<CmsApp>;
+    entityMap: EntityMapLike$2;
+    /** Minimal CMS handle used to queue emails (matches storefront `getCms`). */
+    getCms: () => Promise<{
+        getPlugin: (name: string) => unknown;
+        dataSource?: unknown;
+    }>;
 }
 /** After payment confirmation: email customer + each sales team address from plugin settings. */
 declare function sendOrderPlacedEmailsAfterConfirmation(orderId: number, deps: SendOrderPlacedEmailDeps): Promise<void>;
 
+/** Built-in invoice layout ids selectable in Store settings. */
+declare const INVOICE_TEMPLATE_IDS: readonly ["classic", "modern", "compact", "bold"];
+type InvoiceTemplateId = (typeof INVOICE_TEMPLATE_IDS)[number];
+declare const INVOICE_TEMPLATE_OPTIONS: Array<{
+    id: InvoiceTemplateId;
+    label: string;
+    description: string;
+}>;
+declare function normalizeInvoiceTemplateId(raw: string | null | undefined): InvoiceTemplateId;
+
+type InvoiceLineItem = {
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    tax?: number;
+    total: number;
+    sku?: string | null;
+};
+type InvoiceAddress = {
+    line1?: string;
+    line2?: string | null;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+};
+type InvoiceCompany = {
+    name: string;
+    logoUrl?: string | null;
+    supportEmail?: string;
+    supportPhone?: string;
+    address?: string;
+};
+type InvoicePdfInput = {
+    templateId?: string | null;
+    orderNumber: string;
+    orderDate: Date | string;
+    currency: string;
+    customerName: string;
+    customerEmail?: string | null;
+    customerPhone?: string | null;
+    billingAddress?: InvoiceAddress | null;
+    shippingAddress?: InvoiceAddress | null;
+    lineItems: InvoiceLineItem[];
+    subtotal: number;
+    tax: number;
+    discount: number;
+    total: number;
+    company: InvoiceCompany;
+};
+/**
+ * Generate a local tax invoice PDF using the selected store template.
+ */
+declare function generateLocalInvoicePdf(input: InvoicePdfInput): Promise<Uint8Array>;
+
+type EmOrDs = DataSource | EntityManager;
+type EntityMapLike$1 = Record<string, EntityTarget<ObjectLiteral> | undefined>;
+/** Build local invoice PDF bytes for an order (store template + branding). */
+declare function buildLocalInvoicePdfForOrder(ds: EmOrDs, entityMap: EntityMapLike$1, orderId: number): Promise<{
+    bytes: Uint8Array;
+    filename: string;
+} | {
+    error: string;
+    status: number;
+}>;
+
+/**
+ * Resolve branding/logo URLs for invoice PDFs.
+ * Absolute http(s) URLs pass through; site-relative paths use public base URL env.
+ */
+declare function resolveInvoiceAssetUrl(raw: string | null | undefined): string | null;
+
+/**
+ * Soft-deleted rows still occupy UNIQUE columns (email/slug). Rename them so a new
+ * active row can reuse the original value without dropping the DB unique constraint.
+ */
+declare function retireSoftDeletedUniqueValue(repo: Repository<ObjectLiteral>, column: string, value: string): Promise<void>;
+/** True when an active (non-deleted) row already holds this unique value. */
+declare function activeUniqueValueExists(repo: Repository<ObjectLiteral>, column: string, value: string, excludeId?: number): Promise<boolean>;
+
 declare class FormField {
     id: number;
     formId: number;
@@ -2189,6 +2421,8 @@ declare class OrderItem {
     id: number;
     orderId: number;
     productId: number;
+    /** Selected product variant at order time (optional). */
+    variantId: number | null;
     discountIds: number[];
     vendorId: number | null;
     vendor: Vendor | null;
@@ -2527,6 +2761,7 @@ declare function buildEventOrderTemplateVariables(input: {
         phone?: string | null;
     };
     productNames: string;
+    vendorName?: string;
     orderLines?: OrderLineForTemplate[];
     siteUrl?: string;
 }): Record<string, string>;
@@ -2548,7 +2783,7 @@ type EventOrderMessageTemplateDefault = {
     externalTemplateRef?: string;
 };
 /** Variables available in email HTML and WhatsApp text templates. */
-declare const EVENT_ORDER_TEMPLATE_VARIABLES: readonly ["eventName", "eventSlug", "venue", "startDate", "orderNumber", "orderTotal", "currency", "customerName", "customerEmail", "customerPhone", "productNames", "trackUrl", "qrImageUrl", "orderDetails", "orderDetailsHtml"];
+declare const EVENT_ORDER_TEMPLATE_VARIABLES: readonly ["eventName", "vendorName", "eventSlug", "venue", "startDate", "orderNumber", "orderTotal", "currency", "customerName", "customerEmail", "customerPhone", "productNames", "trackUrl", "qrImageUrl", "orderDetails", "orderDetailsHtml"];
 declare const EVENT_ORDER_MESSAGE_TEMPLATE_DEFAULTS: EventOrderMessageTemplateDefault[];
 type ResolvedEventOrderTemplate = {
     subject?: string;
@@ -2570,19 +2805,21 @@ declare function resolveEventOrderTemplate(channel: EventOrderNotificationChanne
 } | null>, eventOverride?: EventOrderTemplateOverride | null): Promise<ResolvedEventOrderTemplate | null>;
 
 interface EmitOrderNotificationTriggerDeps {
-    dataSource: DataSource;
+    dataSource: any;
     entityMap: Record<string, unknown>;
 }
 declare function emitOrderNotificationTrigger(triggerKey: string, orderId: number, deps: EmitOrderNotificationTriggerDeps, extra?: {
     refundAmount?: number | null;
+    extraVariables?: Record<string, string>;
 }): Promise<void>;
 /** Fire-and-forget wrapper for API handlers (storefront, CRUD, CMS). */
 declare function fireOrderNotificationTrigger(triggerKey: string, orderId: number, deps: EmitOrderNotificationTriggerDeps, extra?: {
     refundAmount?: number | null;
+    extraVariables?: Record<string, string>;
 }): void;
 
 interface OrderNotificationDispatcherDeps {
-    dataSource: DataSource;
+    dataSource: any;
     entityMap: EntityMap$2;
     getCms: () => Promise<CmsAppLike$1>;
 }
@@ -2638,7 +2875,7 @@ declare const ORDER_NOTIFICATION_TRIGGERS: readonly [{
 }];
 type OrderNotificationTriggerKey = (typeof ORDER_NOTIFICATION_TRIGGERS)[number]['key'];
 
-type VendorOnboardedActivation = 'invite' | 'password';
+type VendorOnboardedActivation = 'invite' | 'password' | 'membership';
 type VendorOnboardedKind = 'vendor_onboard' | 'team_invite';
 
 interface EntityMapLike {
@@ -2690,7 +2927,7 @@ declare function seedDefaultAdmin(ds: DataSource, entityMap: SeedEntityMap, opts
 type UserVendorContext = {
     vendorIds: number[];
     activeVendorId: number | null;
-    /** @deprecated legacy vendor_users.role */
+    /** @deprecated Prefer isVendorRoleOwner / vendorRoleId */
     vendorRole: VendorUserRole | null;
     vendorRoleId: number | null;
     vendorRoleName: string | null;
@@ -2710,6 +2947,7 @@ interface NextAuthUser {
     name: string | null;
     password: string | null;
     blocked?: boolean;
+    inviteStatus?: 'pending' | 'active';
     deleted?: boolean;
     groupId?: number | null;
     adminAccess?: boolean;
@@ -2938,6 +3176,41 @@ declare function calculateOrderRefundPreview(dataSource: DataSource, entityMap:
 /** @deprecated Use event-attached policy via calculateOrderRefundPreview. */
 declare function findActiveRefundPolicyForVendor(dataSource: DataSource, entityMap: EntityMap$2, vendorId: number | null | undefined): Promise<PolicyRow | null>;
 
+/** Minimal entity map keys needed for discount usage accounting. */
+type DiscountUsageEntityMap = {
+    discounts?: EntityTarget<ObjectLiteral>;
+    order_discounts?: EntityTarget<ObjectLiteral>;
+    order_items: EntityTarget<ObjectLiteral>;
+};
+/**
+ * `order_discounts.userId` stores the contact id (historical column name).
+ */
+declare function countDiscountOrdersForContact(dataSource: DataSource, discountId: number, contactId: number): Promise<number>;
+declare function isMaxTotalUsageReached(discount: {
+    maxTotalUsage?: number | null;
+    usedCount?: number | null;
+}): boolean;
+declare function isMaxPerUserUsageReached(dataSource: DataSource, discount: {
+    id: number;
+    maxUsagePerUser?: number | null;
+}, contactId: number | null | undefined): Promise<boolean>;
+/**
+ * Enforce per-user + total limits, then atomically increment `usedCount`.
+ * Returns an error message, or null on success.
+ */
+declare function checkAndIncrementDiscountUsage(dataSource: DataSource, entityMap: DiscountUsageEntityMap, discountId: number, contactId: number): Promise<string | null>;
+declare function decrementDiscountUsage(dataSource: DataSource, entityMap: DiscountUsageEntityMap, discountId: number, orderId: number): Promise<void>;
+declare function recordDiscountUsage(dataSource: DataSource, entityMap: DiscountUsageEntityMap, orderId: number, discountId: number, contactId: number, discountAmount: number): Promise<void>;
+type AppliedDiscountUsage = {
+    id: number;
+    calculatedDiscount: number;
+};
+/**
+ * For each applied discount: enforce limits, increment usedCount, write order_discounts.
+ * Stops on first error and returns that message (caller may roll back).
+ */
+declare function consumeAppliedDiscountUsages(dataSource: DataSource, entityMap: DiscountUsageEntityMap, orderId: number, contactId: number, applied: AppliedDiscountUsage[]): Promise<string | null>;
+
 type CaptchaProviderId = 'turnstile' | 'recaptcha_v3';
 interface CaptchaPublicConfig {
     enabled: boolean;
@@ -3451,6 +3724,7 @@ declare enum Type {
     CATEGORY = "category",
     CART = "cart",
     PAYMENT_METHOD = "paymentMethod",
+    DEVICE_TYPE = "deviceType",
     ORDER = "order",
     QUANTITY = "quantity",
     TIME = "time",
@@ -3622,6 +3896,7 @@ declare class Combo {
     vendorId: number;
     vendor: Vendor;
     name: string;
+    slug: string;
     desc?: string;
     eventId?: number | null;
     event?: Event | null;
@@ -3681,10 +3956,16 @@ declare enum NotificationChannel {
     WHATSAPP = "whatsapp",
     EMAIL = "email"
 }
+declare enum NotificationAudienceType {
+    CUSTOMERS = "customers",
+    VENDORS = "vendors",
+    ADMIN = "admin"
+}
 declare class OrderNotificationBinding {
     id: number;
     triggerKey: string;
     channel: NotificationChannel;
+    type: NotificationAudienceType;
     messageTemplateId: number | null;
     enabled: boolean;
     createdAt: Date;
@@ -3799,7 +4080,7 @@ declare function logAuthClient(message: string, data?: Record<string, unknown>):
 declare function summarizeSessionUserForLog(user: unknown): Record<string, unknown>;
 declare function nextAuthCookieDebugInfo(): Record<string, unknown>;
 
-type VendorOwnerActivation = 'invite' | 'password';
+type VendorOwnerActivation = 'invite' | 'password' | 'membership';
 interface VendorOnboardHandlersConfig {
     dataSource: DataSource;
     entityMap: EntityMap$2;
@@ -3825,8 +4106,14 @@ declare function createVendorOnboardHandlers(config: VendorOnboardHandlersConfig
     switchVendor(req: Request): Promise<Response>;
     /** GET /api/admin/vendor/team */
     listTeam(): Promise<Response>;
-    /** POST /api/admin/vendor/team — add staff to vendor */
+    /** POST /api/admin/vendor/team — invite staff (set-password for new; accept-only for existing vendor people) */
     addTeamMember(req: Request): Promise<Response>;
+    /** POST /api/admin/vendor/team/send-invite — send invite email for a pending team member */
+    sendTeamInviteEmail(req: Request): Promise<Response>;
+    /** GET /api/admin/vendor/team-invite?token=&vendorId= — preflight for membership accept (no password) */
+    validateTeamInvite(req: Request): Promise<Response>;
+    /** POST /api/admin/vendor/team-invite — accept membership (token; no password) */
+    acceptTeamInvite(req: Request): Promise<Response>;
     /** PATCH /api/admin/vendor/team/:userId — change member store role */
     updateTeamMemberRole(req: Request, userIdStr: string): Promise<Response>;
     /** DELETE /api/admin/vendor/team/:userId */
@@ -3979,7 +4266,7 @@ declare function resolveSettingsEncryptionKey(config?: Record<string, string>):
 declare function loadSettingsGroupFromDb(dataSource: DataSource, entityMap: EntityMap$2, group: string, encryptionKey?: string): Promise<Record<string, string>>;
 declare function createMessageTemplateRowLoader(dataSource: DataSource, entityMap: EntityMap$2): MessageTemplateRowLoader;
 /** Register email + WhatsApp queue processors when a queue plugin is present. */
-declare function registerMessagingQueueProcessors(cms: CmsApp): void;
+declare function registerMessagingQueueProcessors(cms: CmsApp, entityMap?: EntityMap$2): void;
 /**
  * Ensures queue, email, and WhatsApp plugins exist on the CMS app (lazy overlay).
  * Consumer apps that omit `whatsappPlugin()` / `queuePlugin()` still get order notifications when env/DB is configured.
@@ -3993,4 +4280,4 @@ type CreateCmsAppWithMessagingOptions = CreateCmsAppOptions & EnsureMessagingPlu
 /** `createCmsApp` + messaging plugins + queue processor registration. */
 declare function createCmsAppWithMessaging(options: CreateCmsAppWithMessagingOptions): Promise<CmsApp>;
 
-export { ADMIN_GROUP_NAME, Address, type AdminNavItem, type AnalyticsHandlerConfig, type AnalyticsPluginConfig, Attendee, Attribute, type AuthHandlersConfig, type AuthHelpers, type AuthorizeOtpInput, BLOG_GENERATOR_AGENT_NAME, BLOG_GENERATOR_DEFAULT_SYSTEM_INSTRUCTION, BLOG_GENERATOR_DEFAULT_VALIDATION_RULES, BLOG_GENERATOR_LLM_AGENT_SLUG, BLOG_GENERATOR_MARKDOWN_ARTICLE_SEPARATOR, BLOG_METADATA_ENRICHER_AGENT_NAME, BLOG_METADATA_ENRICHER_DEFAULT_SYSTEM_INSTRUCTION, BLOG_METADATA_ENRICHER_DEFAULT_VALIDATION_RULES, BLOG_METADATA_ENRICHER_LLM_AGENT_SLUG, Blog, type BlogBySlugConfig, type BlogGeneratorBlogDraft, type BlogGeneratorDraftParseMode, type BlogGeneratorPluginConfig, type BlogGeneratorSeoDraft, BlogGeneratorService, Brand, CMS_ENTITY_MAP, type CachePluginConfig, type CacheService, type CaptchaProviderId, type CaptchaPublicConfig, CaptchaService, type CaptchaVerifyResult, Cart, CartItem, Category, type ChangePasswordConfig, ChatConversation, ChatMessage, type ChatPublicConfig, type CmsApiHandlerConfig, type CmsApp, type CmsGetter, type CmsMiddlewareConfig, type CmsMiddlewareRequest, type CmsPlugin, Collection, Combo, ComboItem, Comment, type CompanyDetails, Config, Contact, type CreateCmsAppOptions, type CreateCmsAppWithMessagingOptions, type CrudHandlerOptions, Currency, CurrencyExchange, Customer, Customer_Contacts, DEFAULT_ADMIN_NAV, DEFAULT_ORDER_NOTIFICATION_TRIGGER_SEEDS, type DashboardStatsConfig, type DataSourceManager, Discount, DiscountRules, type ERPPluginConfig, type ERPPluginInstance, ERPSubmissionService, EVENT_ORDER_MESSAGE_TEMPLATE_DEFAULTS, EVENT_ORDER_TEMPLATE_KEY, EVENT_ORDER_TEMPLATE_VARIABLES, type EcommerceAnalyticsConfig, type EmailData, type EmailJobPayload, type EmailPluginConfig, EmailService, type EmailServiceInterface, type EmailTemplateName, type EmailTemplateResult, type EmitOrderNotificationTriggerDeps, type EnsureCustomerRecordInput, type EnsureCustomerUserInput, type EnsureMessagingPluginsOptions, type EnsureVendorCustomerDetails, type EntityCrudAction, type EntityMap$2 as EntityMap, type EntityPermissionFlags, type ErpContactSyncInput, type ErpCreateContactPayload, type ErpJobPayload, type ErpPaidOrderDataSource, type ErpPaidOrderEntityMap, Event, type EventApprovalStatus, type EventOrderMessageTemplateHandlersConfig, type EventOrderNotificationChannel, type EventOrderNotificationTemplates, type EventOrderTemplateOverride, EventProduct, type ExtraPublicWriteRule, type FacebookMeAccountsResponse, type FacebookPageAccount, type ForgotPasswordConfig, Form, type FormBySlugConfig, FormField, FormSubmission, type GetPublicSettingsGroupConfig, type GetPublicSettingsGroupDataSource, type GetSession, type InviteAcceptConfig, JOB_RUNNER_QUEUE, type CmsAppLike as JobRunnerCmsAppLike, type JobRunnerDeps, type JobRunnerPayload, JobSchedule, type JobScheduleApiConfig, JobScheduleRun, KNOWN_NOTIFICATION_TRIGGERS, KnowledgeBaseChunk, KnowledgeBaseDocument, type LatestArticleFromFeed, LlmAgent, type LlmAgentKnowledgeApiConfig, type LlmAgentOptions, type LlmAgentValidationRulesJson, type LlmChatOptions, type LlmEmbeddingProvider, type LlmMessage, type LlmPluginConfig, LlmService, type LlmServiceEmbedOptions, type LlmServiceInterface, type LocalStoragePluginConfig, type Logger, Media, MessageTemplate, type MetaGraphMutationResponse, type NextAuthOptionsConfig, type NextAuthUser, OPEN_ENDPOINTS, ORDER_NOTIFICATION_TRIGGERS, Order, OrderAddresses, OrderDiscounts, OrderItem, OrderNotificationBinding, OrderNotificationTrigger, type OrderNotificationTriggerKey, type OrderPlacedEmailPayload, type OrderPlacedLineItem, type OrderTriggerPayload, OtpChallenge, type OtpChannel, type OtpPurpose, PERMISSION_REQUIRED_ENDPOINTS, Page, type ParsedLlmAgentValidation, PasswordResetToken, Payment, type PaymentIntent, type PaymentPluginConfig, type PaymentServiceInterface, Permission, type PgBossPluginConfig, PgBossService, type PipelineNames, type PluginContext, Product, type ProductApprovalStatus, ProductAttribute, ProductCategory, ProductConfig, ProductVariant, type PublicThemeSettingsPayload, type QueuePluginConfig, type QueueService, RBAC_ADMIN_ONLY_ENTITIES, type RefundCalculationResult, RefundPolicy, type RefundPolicyLike, type RefundPolicyTier, RefundRequest, type RenderEmailOptions, type RenderedEmail, RssArticle, RssFeed, type S3StoragePluginConfig, SUPER_ADMIN_GROUP_ID, type SendVendorOnboardEmailInput, Seo, type SeoLike, type SeoMetadataOverrides, type SessionUser, type SetPasswordConfig, type SettingsApiConfig, type SmsJobPayload, type SmsPluginConfig, type SmsProviderChoice, type SmsProviderId, type SmsServiceConfig, type SmsServiceInterface, type SocialLinkItem, type SocialMediaPluginConfig, type StorageService, type StorefrontApiConfig, type StorefrontOtpFlags, Tag, Tax, type TemplateContext, type UploadHandlerConfig, User, type UserAuthApiConfig, type UserAvatarConfig, UserGroup, type UserProfileConfig, type UsersApiConfig, VENDOR_ADMIN_GROUP_ID, VENDOR_OWNER_GROUP_NAME, VENDOR_SCOPED_STORE_ENTITIES, VENDOR_STORE_RBAC_ENTITIES, Vendor, type VendorCatalogCreateFlags, VendorCustomer, type VendorDashboardConfig, type VendorOnboardHandlersConfig, type VendorOwnerActivation, VendorRole, VendorRolePermission, VendorUser, type WhatsAppJobPayload, type WhatsAppPluginConfig, type WhatsAppServiceConfig, type WhatsAppServiceInterface, Wishlist, WishlistItem, ZIP_MIME_TYPES, allowRateLimit, analyticsPlugin, applyApprovalStatusSideEffects, applyEventApprovalStatusSideEffects, applyRotatingVendorInvite, applyVendorCustomersContactFilter, applyVendorEventCreateApproval, applyVendorProductCreateApproval, assertCaptchaOk, assertContactAllowedForVendorOrder, assertEventApprovalUpdate, assertProductApprovalUpdate, blogGeneratorPlugin, buildBlogMetadataUserPrompt, buildCaptchaPublicConfig, buildCronFromSchedule, buildEventOrderTemplateVariables, buildRssUserPromptFromFeeds, buildVendorInviteLink, cachePlugin, calculateOrderRefundPreview, calculateRefundFromPolicy, canManageRoles, canManageVendorRoles, canManageVendorTeam, canOnboardVendors, captchaPlugin, checkEventsEnabled, checkMultiVendorEnabled, cn, contactIsVendorCustomer, countRecentOtpSends, createAnalyticsHandlers, createAuthHelpers, createBlogBySlugHandler, createChangePasswordHandler, createCmsApiHandler, createCmsApp, createCmsAppWithMessaging, createCmsAuthBundle, createCmsMiddleware, createCrudByIdHandler, createCrudHandler, createDashboardStatsHandler, createDataSourceManager, createEcommerceAnalyticsHandler, createEventOrderMessageTemplateHandlers, createForgotPasswordHandler, createFormBySlugHandler, createInviteAcceptHandler, createJobScheduleHandlers, createLlmAgentKnowledgeHandlers, createMediaZipExtractHandler, createMessageTemplateRowLoader, createOtpChallenge, createSetPasswordHandler, createSettingsApiHandlers, createSocialMediaHandlers, createStorefrontApiHandler, createUploadHandler, createUserAuthApiRouter, createUserAvatarHandler, createUserProfileHandler, createUsersApiHandlers, createVendorDashboardHandler, createVendorOnboardHandlers, customerPhoneForEmail, customerPhoneForUser, daysBeforeEventStart, defaultPublicApiMethods, describeEventTierPolicy, emailPlugin, emailTemplates, emitOrderNotificationTrigger, enrichUserWithVendorContext, ensureCustomerForUser, ensureCustomerRecord, ensureMessagingPluginsOnCms, ensureScheduleQueueWorker, ensureVendorCustomerForOrderContact, ensureVendorCustomersForOrder, erpPlugin, explainSessionEntityAccess, fetchSeoBySlug, findActiveRefundPolicyForVendor, findVendorByInviteToken, fireOrderNotificationTrigger, formatDate, formatDateOnly, formatDateTime, formatTierRange, generateNumericOtp, generateSlug, getCompanyDetailsFromSettings, getNextAuthOptions, getPermissionableEntityKeys, getPublicSettingsGroup, getRequireEventApproval, getRequireProductApproval, getRequiredPermission, getRssArticleSummaryFromItem, getStorefrontNextAuthOptions, getVendorCatalogCreateFlags, hasEntityPermission, hashOtpCode, hydrateVendorSessionUser, initWhatsappTriggerDispatcher, invalidateEventsCache, invalidateMultiVendorCache, invalidateRequireEventApprovalCache, invalidateRequireProductApprovalCache, invalidateVendorCatalogCreateFlagsCache, isAuthDebugClientEnabled, isAuthDebugEnabled, isCustomerTypeContact, isOpenEndpoint, isPlatformAdministrator, isPublicMethod, isRbacDebugEnabled, isSuperAdmin, isSuperAdminGroupName, isSyntheticCustomerPhone, isVendorAdmin, isVendorGroupName, isVendorOwner, isVendorPortalUser, isVendorStaff, isZipMedia, joinRecipientsForSend, linkUnclaimedContactToUser, llmAgentToChatAgentOptions, llmPlugin, loadPublicThemeSettings, loadSettingsGroupFromDb, loadUserVendorContext, localStoragePlugin, logAuth, logAuthClient, logEntityAccessDecision, logRbac, mergeEmailLayoutCompanyDetails, mergeGuardrailsIntoSystemPrompt, mergeSeoBySlug, messagingPlugins, metaFetchUserManagedPages, metaPostPageFeed, metaPostPagePhoto, metaResolvePageAccessToken, nextAuthCookieDebugInfo, normalizeCustomerPhone, normalizePhoneE164, normalizeRefundTiers, notificationTriggerEmitter, overlayCmsPlugins, parseBlogGeneratorAgentContent, parseBlogGeneratorModelOutput, parseBlogMetadataEnrichmentJson, parseEmailRecipientsFromConfig, parseHfInferenceEmbeddingBody, parseLlmAgentValidationRules, paymentPlugin, permissionRowsToRecord, pgBossPlugin, pgBossScheduleNameForId, queueEmail, queueErp, queueErpCreateContactIfEnabled, queueErpPaidOrderForOrderId, queueJobScheduleNow, queueOrderPlacedEmails, queuePlugin, queueSms, queueVendorOnboardEmails, queueWhatsApp, rateLimitCheckoutPost, rateLimitKeyForApiRequest, rateLimitPublicApiIfNeeded, registerEmailQueueProcessor, registerErpQueueProcessor, registerJobRunnerWorker, registerMessagingQueueProcessors, registerSmsQueueProcessor, registerWhatsAppQueueProcessor, relativePathFromMediaParentId, renderEmail, renderLayout, resendOrderNotification, resolveBlogCategoryIdByName, resolveEventOrderTemplate, resolvePublicMetadata, resolveSettingsEncryptionKey, resolveVendorIdForContactCheck, resolveVendorScopeFromSessionUser, s3StoragePlugin, sanitizeMediaFolderPath, sanitizeStorageSegment, seedAdministratorPermissions, seedDefaultAdmin, sendOrderPlacedEmailsAfterConfirmation, sendVendorOnboardEmails, serializeEmailRecipients, sessionHasEntityAccess, shouldRateLimitPublicWrite, simpleDecrypt, simpleEncrypt, smsPlugin, socialMediaPlugin, summarizeEntityPerms, summarizeSessionUserForLog, syncJobScheduleToPgBoss, truncateText, validateRefundTiers, validateScheduleInput, validateSlug, validateUserMessageAgainstAgentRules, validateUserMessageAgainstStructuredRules, vendorPortalFlagsFromUser, verifyAndConsumeOtpChallenge, verifyOtpCodeHash, whatsappPlugin, withAdminRlsContext, withVendorRlsContext, wrapGetCmsWithMessaging };
+export { ADMIN_GROUP_NAME, Address, type AdminNavItem, type AnalyticsHandlerConfig, type AnalyticsPluginConfig, type AppliedDiscountUsage, Attendee, Attribute, type AuthHandlersConfig, type AuthHelpers, type AuthorizeOtpInput, BLOG_GENERATOR_AGENT_NAME, BLOG_GENERATOR_DEFAULT_SYSTEM_INSTRUCTION, BLOG_GENERATOR_DEFAULT_VALIDATION_RULES, BLOG_GENERATOR_LLM_AGENT_SLUG, BLOG_GENERATOR_MARKDOWN_ARTICLE_SEPARATOR, BLOG_METADATA_ENRICHER_AGENT_NAME, BLOG_METADATA_ENRICHER_DEFAULT_SYSTEM_INSTRUCTION, BLOG_METADATA_ENRICHER_DEFAULT_VALIDATION_RULES, BLOG_METADATA_ENRICHER_LLM_AGENT_SLUG, Blog, type BlogBySlugConfig, type BlogGeneratorBlogDraft, type BlogGeneratorDraftParseMode, type BlogGeneratorPluginConfig, type BlogGeneratorSeoDraft, BlogGeneratorService, Brand, CMS_ENTITY_MAP, type CachePluginConfig, type CacheService, type CaptchaProviderId, type CaptchaPublicConfig, CaptchaService, type CaptchaVerifyResult, Cart, CartItem, Category, type ChangePasswordConfig, ChatConversation, ChatMessage, type ChatPublicConfig, type CmsApiHandlerConfig, type CmsApp, type CmsGetter, type CmsMiddlewareConfig, type CmsMiddlewareRequest, type CmsPlugin, Collection, Combo, ComboItem, Comment, type CompanyDetails, Config, Contact, type CreateCmsAppOptions, type CreateCmsAppWithMessagingOptions, type CrudHandlerOptions, Currency, CurrencyExchange, Customer, Customer_Contacts, DEFAULT_ADMIN_NAV, DEFAULT_ORDER_NOTIFICATION_TRIGGER_SEEDS, type DashboardStatsConfig, type DataSourceManager, Discount, DiscountRules, type DiscountUsageEntityMap, type ERPPluginConfig, type ERPPluginInstance, ERPSubmissionService, EVENT_ORDER_MESSAGE_TEMPLATE_DEFAULTS, EVENT_ORDER_TEMPLATE_KEY, EVENT_ORDER_TEMPLATE_VARIABLES, type EcommerceAnalyticsConfig, type EmailAttachment, type EmailData, type EmailJobPayload, type EmailPluginConfig, type EmailQueueProcessorOptions, EmailService, type EmailServiceInterface, type EmailTemplateName, type EmailTemplateResult, type EmitOrderNotificationTriggerDeps, type EnsureCustomerRecordInput, type EnsureCustomerUserInput, type EnsureMessagingPluginsOptions, type EnsureVendorCustomerDetails, type EntityCrudAction, type EntityMap$2 as EntityMap, type EntityPermissionFlags, type ErpContactSyncInput, type ErpCreateContactPayload, type ErpJobPayload, type ErpPaidOrderDataSource, type ErpPaidOrderEntityMap, Event, type EventApprovalStatus, type EventOrderMessageTemplateHandlersConfig, type EventOrderNotificationChannel, type EventOrderNotificationTemplates, type EventOrderTemplateOverride, EventProduct, type ExtraPublicWriteRule, type FacebookMeAccountsResponse, type FacebookPageAccount, type ForgotPasswordConfig, Form, type FormBySlugConfig, FormField, FormSubmission, type GetPublicSettingsGroupConfig, type GetPublicSettingsGroupDataSource, type GetSession, INVOICE_TEMPLATE_IDS, INVOICE_TEMPLATE_OPTIONS, type InventoryOrderLine, type InviteAcceptConfig, type InvoiceAddress, type InvoiceCompany, type InvoiceLineItem, type InvoicePdfInput, type InvoiceTemplateId, JOB_RUNNER_QUEUE, type CmsAppLike as JobRunnerCmsAppLike, type JobRunnerDeps, type JobRunnerPayload, JobSchedule, type JobScheduleApiConfig, JobScheduleRun, KNOWN_NOTIFICATION_TRIGGERS, KnowledgeBaseChunk, KnowledgeBaseDocument, type LatestArticleFromFeed, LlmAgent, type LlmAgentKnowledgeApiConfig, type LlmAgentOptions, type LlmAgentValidationRulesJson, type LlmChatOptions, type LlmEmbeddingProvider, type LlmMessage, type LlmPluginConfig, LlmService, type LlmServiceEmbedOptions, type LlmServiceInterface, type LocalStoragePluginConfig, type Logger, Media, MessageTemplate, type MetaGraphMutationResponse, type NextAuthOptionsConfig, type NextAuthUser, OPEN_ENDPOINTS, ORDER_NOTIFICATION_TRIGGERS, Order, OrderAddresses, OrderDiscounts, type OrderInventorySnapshot, OrderItem, OrderNotificationBinding, OrderNotificationTrigger, type OrderNotificationTriggerKey, type OrderPlacedEmailPayload, type OrderPlacedLineItem, type OrderTriggerPayload, OtpChallenge, type OtpChannel, type OtpPurpose, PERMISSION_REQUIRED_ENDPOINTS, Page, type ParsedLlmAgentValidation, PasswordResetToken, Payment, type PaymentIntent, type PaymentPluginConfig, type PaymentServiceInterface, Permission, type PgBossPluginConfig, PgBossService, type PipelineNames, type PluginContext, Product, type ProductApprovalStatus, ProductAttribute, ProductCategory, ProductConfig, ProductVariant, type PublicThemeSettingsPayload, type QueuePluginConfig, type QueueService, RBAC_ADMIN_ONLY_ENTITIES, type RefundCalculationResult, RefundPolicy, type RefundPolicyLike, type RefundPolicyTier, RefundRequest, type RenderEmailOptions, type RenderedEmail, type ResolveOrderInvoicePdfError, type ResolvedOrderInvoicePdf, RssArticle, RssFeed, type S3StoragePluginConfig, SUPER_ADMIN_GROUP_ID, type SendVendorOnboardEmailInput, Seo, type SeoLike, type SeoMetadataOverrides, type SessionUser, type SetPasswordConfig, type SettingsApiConfig, type SmsJobPayload, type SmsPluginConfig, type SmsProviderChoice, type SmsProviderId, type SmsServiceConfig, type SmsServiceInterface, type SocialLinkItem, type SocialMediaPluginConfig, type StorageService, type StorefrontApiConfig, type StorefrontOtpFlags, Tag, Tax, type TemplateContext, type UploadHandlerConfig, User, type UserAuthApiConfig, type UserAvatarConfig, UserGroup, type UserInviteStatus, type UserProfileConfig, type UsersApiConfig, VENDOR_ADMIN_GROUP_ID, VENDOR_GROUP_NAME, VENDOR_OWNER_GROUP_NAME, VENDOR_SCOPED_STORE_ENTITIES, VENDOR_STORE_RBAC_ENTITIES, Vendor, type VendorCatalogCreateFlags, VendorCustomer, type VendorDashboardConfig, type VendorOnboardHandlersConfig, type VendorOwnerActivation, VendorRole, VendorRolePermission, VendorUser, VendorUserProfile, type WhatsAppJobPayload, type WhatsAppPluginConfig, type WhatsAppServiceConfig, type WhatsAppServiceInterface, Wishlist, WishlistItem, ZIP_MIME_TYPES, activeUniqueValueExists, allowRateLimit, analyticsPlugin, applyApprovalStatusSideEffects, applyEventApprovalStatusSideEffects, applyRotatingVendorInvite, applyVendorCustomersContactFilter, applyVendorEventCreateApproval, applyVendorProductCreateApproval, assertCaptchaOk, assertContactAllowedForVendorOrder, assertEventApprovalUpdate, assertProductApprovalUpdate, blogGeneratorPlugin, buildBlogMetadataUserPrompt, buildCaptchaPublicConfig, buildCronFromSchedule, buildEventOrderTemplateVariables, buildLocalInvoicePdfForOrder, buildRssUserPromptFromFeeds, buildUserInviteLink, buildVendorInviteLink, cachePlugin, calculateOrderRefundPreview, calculateRefundFromPolicy, canManageRoles, canManageVendorRoles, canManageVendorTeam, canOnboardVendors, captchaPlugin, checkAndIncrementDiscountUsage, checkEventsEnabled, checkMultiVendorEnabled, cn, completeUserInviteAccept, consumeAppliedDiscountUsages, contactIsVendorCustomer, countDiscountOrdersForContact, countRecentOtpSends, createAnalyticsHandlers, createAuthHelpers, createBlogBySlugHandler, createChangePasswordHandler, createCmsApiHandler, createCmsApp, createCmsAppWithMessaging, createCmsAuthBundle, createCmsMiddleware, createCrudByIdHandler, createCrudHandler, createDashboardStatsHandler, createDataSourceManager, createEcommerceAnalyticsHandler, createEventOrderMessageTemplateHandlers, createForgotPasswordHandler, createFormBySlugHandler, createInviteAcceptHandler, createJobScheduleHandlers, createLlmAgentKnowledgeHandlers, createMediaZipExtractHandler, createMessageTemplateRowLoader, createOtpChallenge, createSetPasswordHandler, createSettingsApiHandlers, createSocialMediaHandlers, createStorefrontApiHandler, createUploadHandler, createUserAuthApiRouter, createUserAvatarHandler, createUserProfileHandler, createUsersApiHandlers, createVendorDashboardHandler, createVendorOnboardHandlers, customerPhoneForEmail, customerPhoneForUser, daysBeforeEventStart, decrementDiscountUsage, deductInventoryForConfirmedOrder, defaultPublicApiMethods, describeEventTierPolicy, emailPlugin, emailTemplates, emitOrderNotificationTrigger, enrichUserWithVendorContext, ensureCustomerForUser, ensureCustomerRecord, ensureMessagingPluginsOnCms, ensureScheduleQueueWorker, ensureVendorCustomerForOrderContact, ensureVendorCustomersForOrder, erpPlugin, explainSessionEntityAccess, fetchSeoBySlug, findActiveRefundPolicyForVendor, findUserByInviteToken, findVendorByInviteToken, fireOrderNotificationTrigger, formatDate, formatDateOnly, formatDateTime, formatTierRange, generateLocalInvoicePdf, generateNumericOtp, generateSlug, getCompanyDetailsFromSettings, getNextAuthOptions, getPermissionableEntityKeys, getPublicSettingsGroup, getRequireEventApproval, getRequireProductApproval, getRequiredPermission, getRssArticleSummaryFromItem, getStorefrontNextAuthOptions, getVendorCatalogCreateFlags, hasEntityPermission, hashOtpCode, hydrateVendorSessionUser, initWhatsappTriggerDispatcher, invalidateEventsCache, invalidateMultiVendorCache, invalidateRequireEventApprovalCache, invalidateRequireProductApprovalCache, invalidateVendorCatalogCreateFlagsCache, isAuthDebugClientEnabled, isAuthDebugEnabled, isCustomerTypeContact, isMaxPerUserUsageReached, isMaxTotalUsageReached, isOpenEndpoint, isOrderEligibleForInvoiceEmail, isPlatformAdministrator, isPublicMethod, isRbacDebugEnabled, isSuperAdmin, isSuperAdminGroupName, isSyntheticCustomerPhone, isVendorAdmin, isVendorGroupName, isVendorOwner, isVendorPortalUser, isVendorStaff, isZipMedia, joinRecipientsForSend, linkUnclaimedContactToUser, llmAgentToChatAgentOptions, llmPlugin, loadPublicThemeSettings, loadSettingsGroupFromDb, loadUserVendorContext, localStoragePlugin, logAuth, logAuthClient, logEntityAccessDecision, logRbac, mergeEmailLayoutCompanyDetails, mergeGuardrailsIntoSystemPrompt, mergeInventoryLines, mergeSeoBySlug, messagingPlugins, metaFetchUserManagedPages, metaPostPageFeed, metaPostPagePhoto, metaResolvePageAccessToken, newUserInviteToken, nextAuthCookieDebugInfo, normalizeCustomerPhone, normalizeInvoiceTemplateId, normalizePhoneE164, normalizeRefundTiers, notificationTriggerEmitter, orderInventorySnapshotFromRow, orderStatusHoldsStock, overlayCmsPlugins, parseBlogGeneratorAgentContent, parseBlogGeneratorModelOutput, parseBlogMetadataEnrichmentJson, parseEmailRecipientsFromConfig, parseHfInferenceEmbeddingBody, parseLlmAgentValidationRules, paymentPlugin, permissionRowsToRecord, pgBossPlugin, pgBossScheduleNameForId, queueEmail, queueErp, queueErpCreateContactIfEnabled, queueErpPaidOrderForOrderId, queueJobScheduleNow, queueOrderPlacedEmails, queuePlugin, queueSms, queueVendorOnboardEmails, queueWhatsApp, rateLimitCheckoutPost, rateLimitKeyForApiRequest, rateLimitPublicApiIfNeeded, reconcileOrderInventoryBetweenSnapshots, recordDiscountUsage, registerEmailQueueProcessor, registerErpQueueProcessor, registerJobRunnerWorker, registerMessagingQueueProcessors, registerSmsQueueProcessor, registerWhatsAppQueueProcessor, relativePathFromMediaParentId, renderEmail, renderLayout, resendOrderNotification, resolveBlogCategoryIdByName, resolveEventOrderTemplate, resolveInvoiceAssetUrl, resolveOrderInvoicePdfBytes, resolvePublicMetadata, resolveSettingsEncryptionKey, resolveVendorIdForContactCheck, resolveVendorScopeFromSessionUser, restoreInventoryForCancelledOrder, retireSoftDeletedUniqueValue, s3StoragePlugin, sanitizeMediaFolderPath, sanitizeStorageSegment, seedAdministratorPermissions, seedDefaultAdmin, sendOrderPlacedEmailsAfterConfirmation, sendVendorOnboardEmails, serializeEmailRecipients, sessionHasEntityAccess, shouldRateLimitPublicWrite, simpleDecrypt, simpleEncrypt, smsPlugin, socialMediaPlugin, streamOrderInvoicePdf, summarizeEntityPerms, summarizeSessionUserForLog, syncJobScheduleToPgBoss, truncateText, validateInventoryForConfirmedOrderLines, validateInventoryForOrderBecomingConfirmed, validateRefundTiers, validateScheduleInput, validateSlug, validateUserMessageAgainstAgentRules, validateUserMessageAgainstStructuredRules, vendorPortalFlagsFromUser, verifyAndConsumeOtpChallenge, verifyOtpCodeHash, whatsappPlugin, withAdminRlsContext, withVendorRlsContext, wrapGetCmsWithMessaging };