@smartbills/sdk 1.1.0-alpha.1 → 1.1.0-alpha.10

package/dist/types/index.d.ts

@@ -744,12 +744,19 @@ interface UpdateInstallationStatusRequest {
     status: AppInstallationStatus;
 }
 
+/** Configuration for the underlying HTTP transport layer. */
 interface HttpClientConfig {
     baseUrl: string;
     timeout?: number;
     maxRetries?: number;
     retryDelay?: number;
 }
+/**
+ * Low-level HTTP client that wraps Axios with automatic retry, error mapping,
+ * and multi-tenant header injection.
+ *
+ * Not intended for direct use — access services through {@link SmartbillsClient} instead.
+ */
 declare class HttpClient {
     private readonly instance;
     private accessToken?;
@@ -773,6 +780,11 @@ declare class HttpClient {
     delete<T>(url: string, config?: AxiosRequestConfig): Promise<T>;
     upload<T>(url: string, formData: FormData, config?: AxiosRequestConfig): Promise<T>;
     downloadBlob(url: string, config?: AxiosRequestConfig): Promise<Blob>;
+    downloadBlobWithFilename(method: string, url: string, data?: unknown, config?: AxiosRequestConfig): Promise<{
+        blob: Blob;
+        filename?: string;
+    }>;
+    private parseContentDispositionFilename;
     private requestWithRetry;
     private calculateRetryDelay;
     private parseError;
@@ -801,6 +813,10 @@ declare abstract class BaseService {
     protected _delete<T>(url: string, options?: RequestOptions): Promise<T>;
     protected _upload<T>(url: string, formData: FormData, options?: RequestOptions): Promise<T>;
     protected _download(url: string, options?: RequestOptions): Promise<Blob>;
+    protected _downloadWithFilename(method: string, url: string, data?: unknown, options?: RequestOptions): Promise<{
+        blob: Blob;
+        filename?: string;
+    }>;
     protected businessUrl(path: string, options?: RequestOptions): string;
 }
 
@@ -1165,7 +1181,10 @@ declare class ApprobationService extends BaseService {
      * @returns The expense report
      * @throws {SmartbillsNotFoundError} If the report is not found
      */
-    getById(reportId: number, options?: RequestOptions): Promise<SBExpenseReport>;
+    getById(reportId: number, params?: {
+        sortBy?: string;
+        sortOrder?: string;
+    }, options?: RequestOptions): Promise<SBExpenseReport>;
     /**
      * Approves an expense report.
      *
@@ -1311,8 +1330,13 @@ declare class ApprobationService extends BaseService {
      * @throws {SmartbillsNotFoundError} If the report is not found
      */
     downloadAttachmentsZip(reportId: number, options?: RequestOptions): Promise<Blob>;
+    updateExpense(reportId: number, expenseId: number, data: unknown, options?: RequestOptions): Promise<unknown>;
+    saveExpenseReview(reportId: number, data: ExpenseReportApproveRequest & {
+        saveExpenseReviewOnly?: boolean;
+    }, options?: RequestOptions): Promise<SBExpenseReport>;
 }
 
+/** Represents the current subscription state for a business. */
 interface SBSubscription {
     id: string;
     planName?: string;
@@ -1325,6 +1349,7 @@ interface SBSubscription {
     cancelAtPeriodEnd?: boolean;
     canceledAt?: string;
 }
+/** Represents a billing invoice issued to the business. */
 interface SBInvoice {
     id: string;
     number?: string;
@@ -1340,6 +1365,7 @@ interface SBInvoice {
     hostedInvoiceUrl?: string;
     invoicePdfUrl?: string;
 }
+/** Preview of the next invoice based on the current subscription and usage. */
 interface SBUpcomingInvoice {
     total: number;
     subtotal: number;
@@ -1349,18 +1375,21 @@ interface SBUpcomingInvoice {
     periodEnd?: string;
     lines?: SBInvoiceLine[];
 }
+/** A single line item on an invoice. */
 interface SBInvoiceLine {
     description?: string;
     amount: number;
     currency: string;
     quantity?: number;
 }
+/** Tracks resource consumption against a quota limit (e.g., receipts, expenses). */
 interface SBBillingUsage {
     quotaKey: string;
     used: number;
     limit: number;
     percentage: number;
 }
+/** Represents an available billing plan that a business can subscribe to. */
 interface SBBillingPlan {
     id: string;
     name: string;
@@ -1370,23 +1399,29 @@ interface SBBillingPlan {
     interval: string;
     features?: string[];
 }
+/** Request payload for upgrading or starting a trial on a specific plan. */
 interface UpgradeSubscriptionRequest {
     planId: string;
 }
+/** Request payload for creating a Stripe billing portal session. */
 interface CreatePortalSessionRequest {
     returnUrl?: string;
 }
+/** Contains the URL for a Stripe billing portal session. */
 interface SBPortalSession {
     url: string;
 }
+/** Query parameters for listing billing invoices. */
 interface InvoiceListRequest {
     page?: number;
     pageSize?: number;
 }
+/** Query parameters for retrieving usage history. */
 interface UsageHistoryRequest {
     page?: number;
     pageSize?: number;
 }
+/** Represents a payment method on file for billing. */
 interface SBBillingPaymentMethod {
     id: string;
     type: string;
@@ -1398,32 +1433,58 @@ interface SBBillingPaymentMethod {
         expYear: number;
     };
 }
+/** Contains the client secret needed to complete a Stripe SetupIntent flow. */
 interface SBSetupIntent {
     clientSecret: string;
 }
+/** Result of validating whether a subscription can be downgraded. */
 interface SBDowngradeValidation {
     canDowngrade: boolean;
     blockers?: string[];
 }
 
+/**
+ * Service for managing billing, subscriptions, and usage within a business.
+ *
+ * Provides methods to manage the business subscription plan, view invoices,
+ * track usage quotas, manage payment methods, and create billing portal sessions.
+ */
 declare class BillingService extends BaseService {
+    /** Retrieves the current subscription for the business. */
     getSubscription(options?: RequestOptions): Promise<SBSubscription>;
+    /** Upgrades the business subscription to a new plan. */
     upgradeSubscription(data: UpgradeSubscriptionRequest, options?: RequestOptions): Promise<SBSubscription>;
+    /** Cancels the current business subscription. */
     cancelSubscription(options?: RequestOptions): Promise<SBSubscription>;
+    /** Retrieves all available billing plans. */
     getPlans(options?: RequestOptions): Promise<SBBillingPlan[]>;
+    /** Starts a trial subscription for the specified plan. */
     startTrial(data: UpgradeSubscriptionRequest, options?: RequestOptions): Promise<SBSubscription>;
+    /** Activates the free tier subscription for the business. */
     activateFreeTier(options?: RequestOptions): Promise<SBSubscription>;
+    /** Validates whether the business can downgrade to a lower plan without losing features. */
     validateDowngrade(data: UpgradeSubscriptionRequest, options?: RequestOptions): Promise<SBDowngradeValidation>;
+    /** Lists billing invoices for the business with pagination support. */
     listInvoices(params?: InvoiceListRequest, options?: RequestOptions): Promise<SBListResponse<SBInvoice>>;
+    /** Retrieves a specific billing invoice by its Stripe ID. */
     getInvoice(invoiceId: string, options?: RequestOptions): Promise<SBInvoice>;
+    /** Retrieves the upcoming invoice preview based on the current subscription. */
     getUpcomingInvoice(options?: RequestOptions): Promise<SBUpcomingInvoice>;
+    /** Retrieves current usage across all quota keys for the business. */
     getUsage(options?: RequestOptions): Promise<SBBillingUsage[]>;
+    /** Retrieves historical usage data with pagination support. */
     getUsageHistory(params?: UsageHistoryRequest, options?: RequestOptions): Promise<SBListResponse<SBBillingUsage>>;
+    /** Retrieves current usage for a specific quota key (e.g., "receipts", "expenses"). */
     getUsageByKey(quotaKey: string, options?: RequestOptions): Promise<SBBillingUsage>;
+    /** Creates a Stripe billing portal session URL for self-service subscription management. */
     createPortalSession(data?: CreatePortalSessionRequest, options?: RequestOptions): Promise<SBPortalSession>;
+    /** Retrieves all payment methods on file for the business. */
     getPaymentMethods(options?: RequestOptions): Promise<SBBillingPaymentMethod[]>;
+    /** Creates a Stripe SetupIntent for securely collecting a new payment method. */
     createSetupIntent(options?: RequestOptions): Promise<SBSetupIntent>;
+    /** Detaches (removes) a payment method from the business. */
     detachPaymentMethod(paymentMethodId: string, options?: RequestOptions): Promise<void>;
+    /** Sets a payment method as the default for future billing. */
     setDefaultPaymentMethod(paymentMethodId: string, options?: RequestOptions): Promise<void>;
 }
 
@@ -1772,6 +1833,7 @@ interface PaginateTransactionRequest extends PaginationRequest {
     maxAmount?: number;
     hasAttachment?: boolean;
     employeeId?: number;
+    payerType?: PayerType;
 }
 /**
  * Request payload for updating an existing transaction.
@@ -1784,6 +1846,7 @@ interface TransactionUpdateRequest {
     categoryId?: number;
     note?: string;
     vendorId?: number;
+    payerType?: PayerType;
 }
 /**
  * Request payload for batch-updating multiple transactions.
@@ -1795,6 +1858,7 @@ interface TransactionBatchUpdateRequest {
     total?: number;
     categoryId?: number;
     vendorId?: number;
+    payerType?: PayerType;
 }
 
 /**
@@ -2873,6 +2937,21 @@ interface SyncSessionListRequest extends PaginationRequest {
 interface SBEmailAccountAuthorizeResponse {
     authorizationUrl: string;
 }
+interface SBSharedMailbox {
+    email: string;
+    mailboxId: number;
+    syncEnabled: boolean;
+}
+interface SBValidateSharedMailboxResponse {
+    valid: boolean;
+    reason?: string;
+    displayName?: string;
+}
+interface SBHistoricalSyncResponse {
+    message: string;
+    fromDate?: string;
+    toDate?: string;
+}
 
 /**
  * Service for managing email accounts used for receipt ingestion.
@@ -2965,7 +3044,9 @@ declare class EmailAccountService extends BaseService {
      * @returns The reconnection authorization response
      * @throws {SmartbillsNotFoundError} If the account is not found
      */
-    reconnect(accountId: number, options?: RequestOptions): Promise<SBEmailAccountAuthorizeResponse>;
+    reconnect(accountId: number, data?: {
+        password?: string;
+    }, options?: RequestOptions): Promise<SBEmailAccount>;
     /**
      * Enables an email account.
      *
@@ -3013,6 +3094,15 @@ declare class EmailAccountService extends BaseService {
      * @throws {SmartbillsNotFoundError} If the account or mailbox is not found
      */
     updateMailbox(accountId: number, mailboxId: number, data: MailboxUpdateRequest, options?: RequestOptions): Promise<SBMailbox>;
+    getSyncSessions(accountId: number, params?: SyncSessionListRequest, options?: RequestOptions): Promise<SBListResponse<SBSyncSession>>;
+    authorizeWithParams(params: {
+        provider: string;
+        redirect?: string;
+        payerType?: string;
+    }, options?: RequestOptions): Promise<SBEmailAccountAuthorizeResponse>;
+    validateSharedMailbox(accountId: number, email: string, options?: RequestOptions): Promise<SBValidateSharedMailboxResponse>;
+    addSharedMailbox(accountId: number, email: string, options?: RequestOptions): Promise<SBSharedMailbox>;
+    removeSharedMailbox(accountId: number, email: string, options?: RequestOptions): Promise<void>;
 }
 
 /**
@@ -3023,6 +3113,7 @@ declare class EmailAccountService extends BaseService {
 interface SBExpenseJob extends SBEntity, SBTimestamps {
     fileName?: string;
     status: string;
+    jobStatus?: number | string;
     progress?: number;
     totalItems?: number;
     processedItems?: number;
@@ -3031,12 +3122,22 @@ interface SBExpenseJob extends SBEntity, SBTimestamps {
     employeeId?: number;
     error?: string;
     completedAt?: string;
+    expenseReportId?: number;
+    categoryId?: number;
+    transactionId?: number;
+    note?: string;
+    attachment?: {
+        id?: number;
+        fileName?: string;
+        url?: string;
+        cdnUrl?: string;
+    };
 }
 /**
  * Request parameters for listing expense jobs with optional status filter.
  */
 interface ExpenseJobListRequest extends PaginationRequest {
-    status?: string;
+    status?: string | string[];
 }
 
 /**
@@ -3105,6 +3206,7 @@ declare class ExpenseJobService extends BaseService {
      * @throws {SmartbillsNotFoundError} If the employee or job is not found
      */
     retryEmployeeJob(employeeId: number, jobId: number, options?: RequestOptions): Promise<void>;
+    listByExpenseReport(reportId: number, params?: ExpenseJobListRequest, options?: RequestOptions): Promise<SBListResponse<SBExpenseJob>>;
 }
 
 /**
@@ -3221,6 +3323,11 @@ declare class ExpenseReportExpenseService extends BaseService {
      * @throws {SmartbillsNotFoundError} If the employee, report, or expense is not found
      */
     editForEmployee(employeeId: number, reportId: number, expenseId: number, data: EditExpenseInReportRequest, options?: RequestOptions): Promise<unknown>;
+    replace(reportId: number, oldExpenseId: number, data: {
+        newExpenseId: number;
+        categoryId?: number;
+        notes?: string;
+    }, options?: RequestOptions): Promise<unknown>;
 }
 
 /**
@@ -3284,6 +3391,11 @@ declare class ExpenseReportService extends BaseService {
      * @returns Paginated list of expense reports
      */
     list(params?: ExpenseReportListRequest, options?: RequestOptions): Promise<SBListResponse<SBExpenseReport>>;
+    listForEmployee(employeeId: number, params?: ExpenseReportListRequest, options?: RequestOptions): Promise<SBListResponse<SBExpenseReport>>;
+    getByIdForEmployee(employeeId: number, reportId: number, params?: {
+        sortBy?: string;
+        sortOrder?: string;
+    }, options?: RequestOptions): Promise<SBExpenseReport>;
     /**
      * Retrieves a single expense report by ID.
      *
@@ -3297,7 +3409,10 @@ declare class ExpenseReportService extends BaseService {
      * const report = await client.expenseReports.getById(123);
      * ```
      */
-    getById(reportId: number, options?: RequestOptions): Promise<SBExpenseReport>;
+    getById(reportId: number, params?: {
+        sortBy?: string;
+        sortOrder?: string;
+    }, options?: RequestOptions): Promise<SBExpenseReport>;
     /**
      * Lists expense reports belonging to the current user.
      *
@@ -3541,10 +3656,22 @@ interface BulkAssignVendorRequest {
 interface BulkDeleteExpensesRequest {
     expenseIds: number[];
 }
+interface BulkAssignPayerTypeRequest {
+    expenseIds: number[];
+    payerType: PayerType;
+}
+interface BulkSetNoteRequest {
+    expenseIds: number[];
+    note: string | null;
+}
+interface ExpenseReviewUpdateRequest {
+    isReviewed: boolean;
+}
 /**
  * Request payload for exporting expenses to a file.
  */
 interface ExpenseExportRequest {
+    expenseIds?: number[];
     startDate?: string;
     endDate?: string;
     categoryId?: number;
@@ -3558,6 +3685,7 @@ interface ExpenseExportRequest {
  */
 interface ExpenseAttachmentDownloadRequest {
     expenseIds: number[];
+    fileNameTemplate?: string;
 }
 /**
  * Request parameters for listing expenses with filters and pagination.
@@ -3575,18 +3703,28 @@ interface ExpenseListRequest extends PaginationRequest {
     status?: string;
     expenseReportStatus?: string[];
 }
-/**
- * Request payload for splitting an expense into multiple line items.
- */
+declare enum ExpenseSplitType {
+    EQUAL = 0,
+    BY_PERCENTAGE = 1,
+    BY_LINE_ITEM = 2
+}
+interface ExpenseSplitLineItem {
+    lineItemId: number;
+    quantity?: number;
+    percentage?: number;
+    fullAmount?: boolean;
+}
 interface ExpenseSplitRequest {
+    splitType: ExpenseSplitType;
     splits: ExpenseSplitItem[];
 }
-/**
- * A single split item when dividing an expense.
- */
 interface ExpenseSplitItem {
-    amount: number;
-    categoryId?: number;
+    name?: string;
+    percentage?: number;
+    amount?: number;
+    lineItems?: ExpenseSplitLineItem[];
+    categoryId?: number | null;
+    memo?: string | null;
     note?: string;
 }
 /**
@@ -3600,6 +3738,43 @@ interface SBExpenseValidateResponse {
  * Response for bulk expense operations.
  */
 type SBExpenseBulkActionResponse = SBBulkActionResponse;
+interface PresignedUploadFileRequest {
+    fileName: string;
+    contentType: string;
+    fileSize: number;
+}
+interface PresignedUploadRequest {
+    files: PresignedUploadFileRequest[];
+    vendorId?: number;
+    expenseReportId?: number;
+    categoryId?: number;
+    type?: string;
+    payerType?: string;
+}
+interface PresignedUploadFileResponse {
+    fileName: string;
+    s3Key: string;
+    uploadUrl: string;
+    contentType: string;
+}
+interface PresignedUploadResponse {
+    uploadSessionId: string;
+    files: PresignedUploadFileResponse[];
+}
+interface ConfirmUploadFileRequest {
+    s3Key: string;
+    fileName: string;
+    contentType: string;
+}
+interface ConfirmUploadRequest {
+    uploadSessionId: string;
+    files: ConfirmUploadFileRequest[];
+    vendorId?: number;
+    expenseReportId?: number;
+    categoryId?: number;
+    type?: string;
+    payerType?: string;
+}
 
 /**
  * Service for managing expenses (receipts and transactions) within a business.
@@ -3777,6 +3952,7 @@ declare class ExpenseService extends BaseService {
      * @returns Bulk action response with success and failure counts
      */
     bulkAssignCategory(data: BulkAssignCategoryRequest, options?: RequestOptions): Promise<SBExpenseBulkActionResponse>;
+    bulkAssignPayerType(data: BulkAssignPayerTypeRequest, options?: RequestOptions): Promise<SBExpenseBulkActionResponse>;
     /**
      * Bulk assigns multiple expenses to an expense report.
      *
@@ -3793,6 +3969,8 @@ declare class ExpenseService extends BaseService {
      * @returns Bulk action response with success and failure counts
      */
     bulkAssignVendor(data: BulkAssignVendorRequest, options?: RequestOptions): Promise<SBExpenseBulkActionResponse>;
+    bulkSetNote(data: BulkSetNoteRequest, options?: RequestOptions): Promise<SBExpenseBulkActionResponse>;
+    updateReview(expenseId: number, data: ExpenseReviewUpdateRequest, options?: RequestOptions): Promise<SBTransaction>;
     /**
      * Bulk deletes multiple expenses.
      *
@@ -3809,6 +3987,10 @@ declare class ExpenseService extends BaseService {
      * @returns Blob containing the exported file
      */
     export(data: ExpenseExportRequest, options?: RequestOptions): Promise<Blob>;
+    exportWithFilename(data: ExpenseExportRequest, options?: RequestOptions): Promise<{
+        blob: Blob;
+        filename?: string;
+    }>;
     /**
      * Downloads expense attachments as a zip or combined file.
      *
@@ -3817,6 +3999,15 @@ declare class ExpenseService extends BaseService {
      * @returns Blob containing the downloaded attachments
      */
     downloadAttachments(data: ExpenseAttachmentDownloadRequest, options?: RequestOptions): Promise<Blob>;
+    downloadAttachmentsWithFilename(data: ExpenseAttachmentDownloadRequest, options?: RequestOptions): Promise<{
+        blob: Blob;
+        filename?: string;
+    }>;
+    downloadSingleAttachment(expenseId: number, options?: RequestOptions): Promise<Blob>;
+    downloadSingleAttachmentWithFilename(expenseId: number, options?: RequestOptions): Promise<{
+        blob: Blob;
+        filename?: string;
+    }>;
     /**
      * Splits an expense into multiple transactions.
      *
@@ -3836,6 +4027,10 @@ declare class ExpenseService extends BaseService {
      * @returns Array of updated expense transactions
      */
     batchUpdate(data: unknown[], options?: RequestOptions): Promise<SBTransaction[]>;
+    presignUpload(request: PresignedUploadRequest, options?: RequestOptions): Promise<PresignedUploadResponse>;
+    confirmUpload(request: ConfirmUploadRequest, options?: RequestOptions): Promise<unknown>;
+    presignEmployeeUpload(employeeId: number, request: PresignedUploadRequest, options?: RequestOptions): Promise<PresignedUploadResponse>;
+    confirmEmployeeUpload(employeeId: number, request: ConfirmUploadRequest, options?: RequestOptions): Promise<unknown>;
 }
 
 /**
@@ -3918,6 +4113,15 @@ declare class IntegrationService extends BaseService {
      * @throws {SmartbillsNotFoundError} If the app is not found
      */
     getMarketplaceApp(slug: string, options?: RequestOptions): Promise<SBMarketplaceApp>;
+    getInstallationById(installationId: string, options?: RequestOptions): Promise<SBIntegration>;
+    getInstallation(appSlug: string, installationId: string, options?: RequestOptions): Promise<SBIntegration>;
+    getSessionToken(installationId: string, options?: RequestOptions): Promise<SBSessionTokenResponse>;
+    retryInstallation(appSlug: string, installationId: string, options?: RequestOptions): Promise<SBIntegrationAuthorizeResponse>;
+    abortInstallation(appSlug: string, installationId: string, options?: RequestOptions): Promise<SBIntegration>;
+    updateInstallationStatus(appSlug: string, installationId: string, data: {
+        status: string;
+        errorMessage?: string;
+    }, options?: RequestOptions): Promise<SBIntegration>;
 }
 
 /**
@@ -4821,7 +5025,7 @@ declare class ReportingService extends BaseService {
      * @param options - Request options including businessId, locale, and abort signal
      * @returns Array of monthly expense summaries
      */
-    monthlySummary(params: ReportingRequest, options?: RequestOptions): Promise<SBExpenseMonthlySummary[]>;
+    monthlySummary(params: ReportingRequest, options?: RequestOptions): Promise<SBExpenseMonthlySummary>;
     /**
      * Retrieves expense breakdown by category.
      *
@@ -5721,17 +5925,843 @@ declare class WorkflowService extends BaseService {
     createFromTemplate(templateId: string, options?: RequestOptions): Promise<SBWorkflow>;
 }
 
+/** Represents a customer of the business (buyer / receipt recipient). */
+interface SBCustomer extends SBEntity, SBTimestamps {
+    firstName?: string;
+    lastName?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    acceptsMarketing?: boolean;
+    taxExempt?: boolean;
+    billingAddress?: SBAddress;
+    shippingAddress?: SBAddress;
+    ordersCount?: number;
+    totalSpent?: number;
+}
+/** Query parameters for listing customers with search support. */
+interface CustomerListRequest extends PaginationRequest {
+    search?: string;
+    searchTerm?: string;
+}
+/** Payload for creating a new customer. */
+interface CustomerCreateRequest {
+    firstName?: string;
+    lastName?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    acceptsMarketing?: boolean;
+    taxExempt?: boolean;
+    billingAddress?: SBAddress;
+    shippingAddress?: SBAddress;
+}
+/** Payload for updating an existing customer. All fields are optional. */
+type CustomerUpdateRequest = Partial<CustomerCreateRequest>;
+
+/**
+ * Service for managing customers within a business.
+ *
+ * Customers represent the people or organizations that purchase
+ * goods or services from the business.
+ */
+declare class CustomerService extends BaseService {
+    /**
+     * Retrieves a paginated list of customers.
+     *
+     * @param params - Optional filters, search, and pagination parameters
+     * @param options - Request options including business context and abort signal
+     * @returns A paginated list of customers
+     */
+    list(params?: CustomerListRequest, options?: RequestOptions): Promise<SBListResponse<SBCustomer>>;
+    /**
+     * Retrieves a single customer by ID.
+     *
+     * @param id - The customer ID
+     * @param options - Request options including business context and abort signal
+     * @returns The customer
+     * @throws {SmartbillsNotFoundError} If the customer is not found
+     */
+    getById(id: number, options?: RequestOptions): Promise<SBCustomer>;
+    /**
+     * Creates a new customer.
+     *
+     * @param data - The customer creation payload
+     * @param options - Request options including business context and abort signal
+     * @returns The newly created customer
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    create(data: CustomerCreateRequest, options?: RequestOptions): Promise<SBCustomer>;
+    /**
+     * Updates an existing customer.
+     *
+     * @param id - The customer ID
+     * @param data - The fields to update
+     * @param options - Request options including business context and abort signal
+     * @returns The updated customer
+     * @throws {SmartbillsNotFoundError} If the customer is not found
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    update(id: number, data: CustomerUpdateRequest, options?: RequestOptions): Promise<SBCustomer>;
+    /**
+     * Deletes a customer.
+     *
+     * @param id - The customer ID
+     * @param options - Request options including business context and abort signal
+     * @throws {SmartbillsNotFoundError} If the customer is not found
+     */
+    delete(id: number, options?: RequestOptions): Promise<void>;
+}
+
+/** A lightweight representation of a team member within a department. */
+interface SBDepartmentMember {
+    id: number;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    avatar?: string;
+}
+/** Represents an organizational department within a business. */
+interface SBDepartment extends SBEntity, SBTimestamps {
+    name: string;
+    code?: string;
+    description?: string;
+    managerName?: string;
+    isActive: boolean;
+    active?: boolean;
+    employeeCount?: number;
+    teamMembers?: SBDepartmentMember[];
+}
+/** Query parameters for listing departments with search support. */
+interface DepartmentListRequest extends PaginationRequest {
+    search?: string;
+}
+/** Payload for creating a new department. */
+interface DepartmentCreateRequest {
+    name: string;
+    code?: string;
+    description?: string;
+    managerName?: string;
+    isActive?: boolean;
+    teamMemberIds?: number[];
+}
+/** Payload for updating an existing department. */
+type DepartmentUpdateRequest = DepartmentCreateRequest;
+
+/**
+ * Service for managing departments within a business.
+ *
+ * Departments are organizational units used to categorize expenses,
+ * employees, and budgets within a business.
+ */
+declare class DepartmentService extends BaseService {
+    /**
+     * Retrieves a paginated list of departments.
+     *
+     * @param params - Optional filters and pagination parameters
+     * @param options - Request options including business context and abort signal
+     * @returns A paginated list of departments
+     */
+    list(params?: DepartmentListRequest, options?: RequestOptions): Promise<SBListResponse<SBDepartment>>;
+    /**
+     * Retrieves a single department by ID.
+     *
+     * @param id - The department ID
+     * @param options - Request options including business context and abort signal
+     * @returns The department
+     * @throws {SmartbillsNotFoundError} If the department is not found
+     */
+    getById(id: number, options?: RequestOptions): Promise<SBDepartment>;
+    /**
+     * Creates a new department.
+     *
+     * @param data - The department creation payload
+     * @param options - Request options including business context and abort signal
+     * @returns The newly created department
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    create(data: DepartmentCreateRequest, options?: RequestOptions): Promise<SBDepartment>;
+    /**
+     * Updates an existing department.
+     *
+     * @param id - The department ID
+     * @param data - The fields to update
+     * @param options - Request options including business context and abort signal
+     * @returns The updated department
+     * @throws {SmartbillsNotFoundError} If the department is not found
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    update(id: number, data: DepartmentUpdateRequest, options?: RequestOptions): Promise<SBDepartment>;
+    /**
+     * Deletes a department.
+     *
+     * @param id - The department ID
+     * @param options - Request options including business context and abort signal
+     * @throws {SmartbillsNotFoundError} If the department is not found
+     */
+    delete(id: number, options?: RequestOptions): Promise<void>;
+}
+
+/** Represents a product or service offered by the business. */
+interface SBProduct extends SBEntity, SBTimestamps {
+    name: string;
+    description?: string;
+    price?: number;
+    sku?: string;
+}
+/** Query parameters for listing products with optional search. */
+interface ProductListRequest extends PaginationRequest {
+    search?: string;
+}
+
+/**
+ * Service for managing products within a business.
+ *
+ * Products represent the goods or services sold by the business
+ * and appear on receipts and invoices.
+ */
+declare class ProductService extends BaseService {
+    /**
+     * Retrieves a paginated list of products.
+     *
+     * @param params - Optional filters, search, and pagination parameters
+     * @param options - Request options including business context and abort signal
+     * @returns A paginated list of products
+     */
+    list(params?: ProductListRequest, options?: RequestOptions): Promise<SBListResponse<SBProduct>>;
+    /**
+     * Retrieves a single product by ID.
+     *
+     * @param id - The product ID
+     * @param options - Request options including business context and abort signal
+     * @returns The product
+     * @throws {SmartbillsNotFoundError} If the product is not found
+     */
+    getById(id: number, options?: RequestOptions): Promise<SBProduct>;
+}
+
+/** Represents a tax rate configured for a business. */
+interface SBTax extends SBEntity, SBTimestamps {
+    name: string;
+    rate: number;
+    code?: string;
+    isDefault?: boolean;
+}
+/** Query parameters for listing tax rates with optional search. */
+interface TaxListRequest extends PaginationRequest {
+    search?: string;
+}
+
+/**
+ * Service for managing tax configurations within a business.
+ *
+ * Taxes define the tax rates applied to receipts, invoices, and
+ * expense items (e.g., GST, HST, PST, VAT).
+ */
+declare class TaxService extends BaseService {
+    /**
+     * Retrieves a paginated list of tax configurations.
+     *
+     * @param params - Optional filters and pagination parameters
+     * @param options - Request options including business context and abort signal
+     * @returns A paginated list of tax configurations
+     */
+    list(params?: TaxListRequest, options?: RequestOptions): Promise<SBListResponse<SBTax>>;
+    /**
+     * Retrieves a single tax configuration by ID.
+     *
+     * @param id - The tax ID
+     * @param options - Request options including business context and abort signal
+     * @returns The tax configuration
+     * @throws {SmartbillsNotFoundError} If the tax is not found
+     */
+    getById(id: number, options?: RequestOptions): Promise<SBTax>;
+}
+
+/** Represents a promotional code that can be applied to receipts or transactions. */
+interface SBPromoCode extends SBEntity, SBTimestamps {
+    name: string;
+    code: string;
+    type: string;
+    value: number;
+    active: boolean;
+}
+
+/**
+ * Service for managing promotional codes within a business.
+ *
+ * Promo codes provide discounts to customers on receipts and invoices.
+ */
+declare class PromoCodeService extends BaseService {
+    /**
+     * Retrieves a single promotional code by ID.
+     *
+     * @param id - The promo code ID
+     * @param options - Request options including business context and abort signal
+     * @returns The promotional code
+     * @throws {SmartbillsNotFoundError} If the promo code is not found
+     */
+    getById(id: number, options?: RequestOptions): Promise<SBPromoCode>;
+}
+
+/** Represents an expense category used to classify and organize expenses. */
+interface SBCategory extends SBEntity, SBTimestamps {
+    name: string;
+    code?: string;
+    isVisible: boolean;
+    businessId?: number;
+    userId?: number;
+}
+/** Payload for creating a new expense category. */
+interface CategoryCreateRequest {
+    name: string;
+    code?: string;
+    isVisible?: boolean;
+}
+/** Payload for updating an existing expense category. */
+interface CategoryUpdateRequest {
+    name?: string;
+    code?: string;
+    isVisible?: boolean;
+}
+
+/**
+ * Service for managing expense categories within a business.
+ *
+ * Categories are used to classify expenses for reporting, budgeting,
+ * and accounting purposes (e.g., Travel, Meals, Office Supplies).
+ */
+declare class CategoryService extends BaseService {
+    /**
+     * Retrieves all expense categories for the business.
+     *
+     * @param options - Request options including business context and abort signal
+     * @returns An array of expense categories
+     */
+    list(options?: RequestOptions): Promise<SBCategory[]>;
+    /**
+     * Retrieves a single expense category by ID.
+     *
+     * @param id - The category ID
+     * @param options - Request options including business context and abort signal
+     * @returns The expense category
+     * @throws {SmartbillsNotFoundError} If the category is not found
+     */
+    getById(id: number, options?: RequestOptions): Promise<SBCategory>;
+    /**
+     * Creates a new expense category.
+     *
+     * @param data - The category creation payload
+     * @param options - Request options including business context and abort signal
+     * @returns The newly created category
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    create(data: CategoryCreateRequest, options?: RequestOptions): Promise<SBCategory>;
+    /**
+     * Updates an existing expense category.
+     *
+     * @param id - The category ID
+     * @param data - The fields to update
+     * @param options - Request options including business context and abort signal
+     * @returns The updated category
+     * @throws {SmartbillsNotFoundError} If the category is not found
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    update(id: number, data: CategoryUpdateRequest, options?: RequestOptions): Promise<SBCategory>;
+    /**
+     * Deletes an expense category.
+     *
+     * @param id - The category ID
+     * @param options - Request options including business context and abort signal
+     * @throws {SmartbillsNotFoundError} If the category is not found
+     */
+    delete(id: number, options?: RequestOptions): Promise<void>;
+}
+
+/** Lightweight representation of an employee's manager. */
+interface SBEmployeeManager {
+    id: number;
+    firstName: string;
+    lastName: string;
+    name: string;
+    email: string;
+}
+/** Department association for an employee. */
+interface SBEmployeeDepartment {
+    departmentId: number;
+    departmentName: string;
+}
+/** Location association for an employee. */
+interface SBEmployeeLocation {
+    locationId: number;
+    locationName: string;
+}
+/** Represents an employee within a business, including their manager, departments, and locations. */
+interface SBEmployee extends SBEntity, SBTimestamps {
+    businessId: number;
+    userId: number;
+    employeeIdentifier?: string;
+    firstName: string;
+    lastName: string;
+    name: string;
+    email: string;
+    phoneNumber?: string;
+    managerId?: number;
+    manager?: SBEmployeeManager;
+    status: string;
+    isMemberOnPlatform: boolean;
+    birthdate?: string;
+    departments?: SBEmployeeDepartment[];
+    locations?: SBEmployeeLocation[];
+}
+/** Query parameters for listing employees with optional search and status filter. */
+interface EmployeeListRequest extends PaginationRequest {
+    search?: string;
+    status?: string;
+}
+/** Payload for creating a new employee record. */
+interface EmployeeCreateRequest {
+    businessId: number;
+    employeeIdentifier?: string;
+    firstName: string;
+    lastName: string;
+    email: string;
+    phoneNumber?: string;
+    managerId?: number;
+    departmentIds?: number[];
+    locationIds?: number[];
+    birthdate?: string;
+}
+/** Payload for updating an existing employee record. All fields are optional. */
+type EmployeeUpdateRequest = Partial<Omit<EmployeeCreateRequest, "businessId">>;
+/** Payload for assigning or removing a manager from a single employee. */
+interface EmployeeSetManagerRequest {
+    managerId: number | null;
+}
+/** Payload for bulk-assigning a manager to multiple employees at once. */
+interface EmployeeBulkAssignManagerRequest {
+    employeeIds: number[];
+    managerId: number | null;
+}
+
+/**
+ * Service for managing employees within a business.
+ *
+ * Employees are team members who can submit expenses, be assigned to departments,
+ * and have managers in the organizational hierarchy.
+ */
+declare class EmployeeService extends BaseService {
+    /**
+     * Retrieves a paginated list of employees.
+     *
+     * @param params - Optional filters, search, and pagination parameters
+     * @param options - Request options including business context and abort signal
+     * @returns A paginated list of employees
+     */
+    list(params?: EmployeeListRequest, options?: RequestOptions): Promise<SBListResponse<SBEmployee>>;
+    /**
+     * Retrieves a single employee by ID.
+     *
+     * @param id - The employee ID
+     * @param options - Request options including business context and abort signal
+     * @returns The employee
+     * @throws {SmartbillsNotFoundError} If the employee is not found
+     */
+    getById(id: number, options?: RequestOptions): Promise<SBEmployee>;
+    /**
+     * Creates a new employee.
+     *
+     * @param data - The employee creation payload
+     * @param options - Request options including business context and abort signal
+     * @returns The newly created employee
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    create(data: EmployeeCreateRequest, options?: RequestOptions): Promise<SBEmployee>;
+    /**
+     * Updates an existing employee.
+     *
+     * @param id - The employee ID
+     * @param data - The fields to update
+     * @param options - Request options including business context and abort signal
+     * @returns The updated employee
+     * @throws {SmartbillsNotFoundError} If the employee is not found
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    update(id: number, data: EmployeeUpdateRequest, options?: RequestOptions): Promise<SBEmployee>;
+    /**
+     * Deletes an employee.
+     *
+     * @param id - The employee ID
+     * @param options - Request options including business context and abort signal
+     * @throws {SmartbillsNotFoundError} If the employee is not found
+     */
+    delete(id: number, options?: RequestOptions): Promise<void>;
+    /**
+     * Assigns a manager to an employee.
+     *
+     * @param employeeId - The employee ID
+     * @param data - The manager assignment payload
+     * @param options - Request options including business context and abort signal
+     * @returns The updated employee with the new manager
+     * @throws {SmartbillsNotFoundError} If the employee is not found
+     */
+    setManager(employeeId: number, data: EmployeeSetManagerRequest, options?: RequestOptions): Promise<SBEmployee>;
+    /**
+     * Assigns a manager to multiple employees in a single bulk operation.
+     *
+     * @param data - The bulk manager assignment payload with employee IDs and manager ID
+     * @param options - Request options including business context and abort signal
+     */
+    bulkAssignManager(data: EmployeeBulkAssignManagerRequest, options?: RequestOptions): Promise<void>;
+    /**
+     * Activates an employee.
+     *
+     * @param employeeId - The employee ID
+     * @param options - Request options including business context and abort signal
+     * @returns The activated employee
+     * @throws {SmartbillsNotFoundError} If the employee is not found
+     */
+    setActive(employeeId: number, options?: RequestOptions): Promise<SBEmployee>;
+    /**
+     * Deactivates an employee without removing them.
+     *
+     * @param employeeId - The employee ID
+     * @param options - Request options including business context and abort signal
+     * @returns The deactivated employee
+     * @throws {SmartbillsNotFoundError} If the employee is not found
+     */
+    setInactive(employeeId: number, options?: RequestOptions): Promise<SBEmployee>;
+}
+
+/** Represents a file attachment (e.g., receipt image, PDF) associated with an expense or transaction. */
+interface SBAttachment extends SBEntity, SBTimestamps {
+    fileName: string;
+    fileSize: number;
+    versionId: string;
+    url: string;
+    thumbnailUrl: string;
+}
+/** Query parameters for listing attachments with optional search. */
+interface AttachmentListRequest extends PaginationRequest {
+    searchTerm?: string;
+}
+/** Payload for renaming an existing attachment. */
+interface AttachmentRenameRequest {
+    fileName: string;
+}
+
+/**
+ * Service for managing file attachments on expenses and receipts.
+ *
+ * Attachments are images or documents (PDF, JPEG, PNG) associated with
+ * expenses, receipts, or bills as proof of purchase.
+ */
+declare class AttachmentService extends BaseService {
+    /**
+     * Retrieves a paginated list of attachments.
+     *
+     * @param params - Optional filters and pagination parameters
+     * @param options - Request options including business context and abort signal
+     * @returns A paginated list of attachments
+     */
+    list(params?: AttachmentListRequest, options?: RequestOptions): Promise<SBListResponse<SBAttachment>>;
+    /**
+     * Retrieves a single attachment by ID.
+     *
+     * @param id - The attachment ID
+     * @param options - Request options including business context and abort signal
+     * @returns The attachment with its metadata and URL
+     * @throws {SmartbillsNotFoundError} If the attachment is not found
+     */
+    getById(id: number, options?: RequestOptions): Promise<SBAttachment>;
+    /**
+     * Renames an attachment.
+     *
+     * @param id - The attachment ID
+     * @param data - The rename payload with the new filename
+     * @param options - Request options including business context and abort signal
+     * @returns The renamed attachment
+     * @throws {SmartbillsNotFoundError} If the attachment is not found
+     */
+    rename(id: number, data: AttachmentRenameRequest, options?: RequestOptions): Promise<SBAttachment>;
+    /**
+     * Deletes an attachment.
+     *
+     * @param id - The attachment ID
+     * @param options - Request options including business context and abort signal
+     * @throws {SmartbillsNotFoundError} If the attachment is not found
+     */
+    delete(id: number, options?: RequestOptions): Promise<void>;
+}
+
+/** Represents an email forwarding configuration for a user or business. */
+interface SBEmailForwardingConfig extends SBEntity, SBTimestamps {
+    userId?: number;
+    businessId?: number;
+    forwardingEmail?: string;
+    name?: string;
+    origin?: string;
+    personalizedSlug?: string;
+    emailAddress: string;
+    departmentId?: number;
+    employeeId?: number;
+    isActive: boolean;
+}
+/** Payload for creating or updating an email forwarding configuration. */
+interface EmailForwardingConfigRequest {
+    userId?: number;
+    businessId?: number;
+    forwardingEmail?: string;
+    personalizedSlug?: string;
+    name?: string;
+    origin?: string;
+    departmentId?: number;
+    employeeId?: number;
+}
+
+/**
+ * Service for managing email forwarding configurations.
+ *
+ * Email forwarding allows businesses and users to automatically forward
+ * receipt emails to Smartbills for expense ingestion and processing.
+ */
+declare class EmailForwardingService extends BaseService {
+    /**
+     * Lists all email forwarding configurations for a business.
+     *
+     * @param businessId - The business ID
+     * @param options - Request options including locale and abort signal
+     * @returns An array of email forwarding configurations
+     */
+    listBusiness(businessId: number, options?: RequestOptions): Promise<SBEmailForwardingConfig[]>;
+    /**
+     * Retrieves the email forwarding configuration for a specific user.
+     *
+     * @param userId - The user ID
+     * @param businessId - Optional business ID to scope the configuration
+     * @param options - Request options including locale and abort signal
+     * @returns The user's email forwarding configuration
+     */
+    getUser(userId: number, businessId?: number, options?: RequestOptions): Promise<SBEmailForwardingConfig>;
+    /**
+     * Configures email forwarding for a business.
+     *
+     * @param data - The forwarding configuration payload
+     * @param options - Request options including locale and abort signal
+     * @returns The created email forwarding configuration
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    configureBusiness(data: EmailForwardingConfigRequest, options?: RequestOptions): Promise<SBEmailForwardingConfig>;
+    /**
+     * Configures email forwarding for a user.
+     *
+     * @param data - The forwarding configuration payload
+     * @param options - Request options including locale and abort signal
+     * @returns The created email forwarding configuration
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    configureUser(data: EmailForwardingConfigRequest, options?: RequestOptions): Promise<SBEmailForwardingConfig>;
+    /**
+     * Disables email forwarding for a business.
+     *
+     * @param businessId - The business ID
+     * @param options - Request options including locale and abort signal
+     * @returns The disabled email forwarding configuration
+     */
+    disableBusiness(businessId: number, options?: RequestOptions): Promise<SBEmailForwardingConfig>;
+    /**
+     * Disables email forwarding for a user.
+     *
+     * @param userId - The user ID
+     * @param options - Request options including locale and abort signal
+     * @returns The disabled email forwarding configuration
+     */
+    disableUser(userId: number, options?: RequestOptions): Promise<SBEmailForwardingConfig>;
+}
+
+interface SBAuthorizedSender {
+    id: number;
+    userId: number;
+    businessId: number | null;
+    emailAddress: string;
+    createdAt: string;
+}
+interface CreateAuthorizedSenderRequest {
+    emailAddress: string;
+}
+
+declare class AuthorizedSenderService extends BaseService {
+    list(businessId: number, options?: RequestOptions): Promise<SBAuthorizedSender[]>;
+    create(businessId: number, data: CreateAuthorizedSenderRequest, options?: RequestOptions): Promise<SBAuthorizedSender>;
+    delete(businessId: number, id: number, options?: RequestOptions): Promise<void>;
+}
+
+/** The type of rule that determines how loyalty points are accrued. */
+type LoyaltyRuleType = "visit" | "spend" | "item_variation" | "category";
+/** Base shape shared by all loyalty accrual rules. */
+interface SBLoyaltyRuleBase {
+    id?: string;
+    type: LoyaltyRuleType;
+    value: number;
+    description?: string;
+}
+/** Configuration data specific to visit-based loyalty rules. */
+interface SBVisitRuleData {
+    minimumAmountMoney?: number;
+    taxMode?: "include_tax" | "exclude_tax";
+}
+/** Configuration data specific to spend-based loyalty rules. */
+interface SBSpendRuleData {
+    taxMode?: "include_tax" | "exclude_tax";
+    excludedCategoryIds?: string[];
+    excludedItemVariationIds?: string[];
+}
+/** Configuration data specific to item-variation-based loyalty rules. */
+interface SBItemVariationRuleData {
+    itemVariationId: string;
+}
+/** Configuration data specific to category-based loyalty rules. */
+interface SBCategoryRuleData {
+    categoryId: string;
+}
+/** Discriminated union of all loyalty accrual rule types. */
+type SBLoyaltyRule = (SBLoyaltyRuleBase & {
+    type: "visit";
+    visitData?: SBVisitRuleData;
+}) | (SBLoyaltyRuleBase & {
+    type: "spend";
+    spendData?: SBSpendRuleData;
+}) | (SBLoyaltyRuleBase & {
+    type: "item_variation";
+    itemVariationData?: SBItemVariationRuleData;
+}) | (SBLoyaltyRuleBase & {
+    type: "category";
+    categoryData?: SBCategoryRuleData;
+});
+/** How rewards are distributed to loyalty members. */
+type LoyaltyRewardType = "points" | "cashback" | "tier";
+/** Current lifecycle status of a loyalty program. */
+type LoyaltyProgramStatus = "active" | "draft";
+/** Represents a loyalty program configured for a business. */
+interface SBLoyaltyProgram extends SBEntity, SBTimestamps {
+    name: string;
+    description: string;
+    status: LoyaltyProgramStatus;
+    memberCount: number;
+    pointsIssued: number;
+    rewardType: LoyaltyRewardType;
+    rewardValue: number;
+    rules: SBLoyaltyRule[];
+}
+/** Payload for creating a new loyalty program. */
+interface LoyaltyProgramCreateRequest {
+    name: string;
+    description: string;
+    rewardType: LoyaltyRewardType;
+    rewardValue: number;
+    status: LoyaltyProgramStatus;
+    rules: SBLoyaltyRule[];
+}
+/** Payload for updating an existing loyalty program. All fields are optional. */
+interface LoyaltyProgramUpdateRequest extends Partial<LoyaltyProgramCreateRequest> {
+}
+/** Query parameters for listing loyalty programs. */
+interface LoyaltyProgramListRequest extends PaginationRequest {
+}
+
+/**
+ * Service for managing loyalty programs.
+ *
+ * Loyalty programs allow businesses to reward repeat customers
+ * with points, stamps, or tier-based rewards.
+ */
+declare class LoyaltyService extends BaseService {
+    /**
+     * Retrieves a paginated list of loyalty programs.
+     *
+     * @param params - Optional filters and pagination parameters
+     * @param options - Request options including locale and abort signal
+     * @returns A paginated list of loyalty programs
+     */
+    list(params?: LoyaltyProgramListRequest, options?: RequestOptions): Promise<SBListResponse<SBLoyaltyProgram>>;
+    /**
+     * Retrieves a single loyalty program by ID.
+     *
+     * @param id - The loyalty program ID
+     * @param options - Request options including locale and abort signal
+     * @returns The loyalty program
+     * @throws {SmartbillsNotFoundError} If the loyalty program is not found
+     */
+    getById(id: string, options?: RequestOptions): Promise<SBLoyaltyProgram>;
+    /**
+     * Creates a new loyalty program.
+     *
+     * @param data - The loyalty program creation payload
+     * @param options - Request options including locale and abort signal
+     * @returns The newly created loyalty program
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    create(data: LoyaltyProgramCreateRequest, options?: RequestOptions): Promise<SBLoyaltyProgram>;
+    /**
+     * Updates an existing loyalty program.
+     *
+     * @param id - The loyalty program ID
+     * @param data - The fields to update
+     * @param options - Request options including locale and abort signal
+     * @returns The updated loyalty program
+     * @throws {SmartbillsNotFoundError} If the loyalty program is not found
+     * @throws {SmartbillsValidationError} If the provided data fails validation
+     */
+    update(id: string, data: LoyaltyProgramUpdateRequest, options?: RequestOptions): Promise<SBLoyaltyProgram>;
+    /**
+     * Deletes a loyalty program.
+     *
+     * @param id - The loyalty program ID
+     * @param options - Request options including locale and abort signal
+     * @throws {SmartbillsNotFoundError} If the loyalty program is not found
+     */
+    delete(id: string, options?: RequestOptions): Promise<void>;
+}
+
+/**
+ * Configuration options for initializing a {@link SmartbillsClient}.
+ */
 interface SmartbillsClientOptions {
+    /** Override the Smartbills API base URL. Defaults to `https://api.smartbills.io`. */
     baseUrl?: string;
+    /** OAuth2 access token for authenticating requests. */
     accessToken?: string;
+    /** Business ID to scope all requests to a specific business tenant. */
     businessId?: number;
+    /** Locale code for localized API responses (e.g., "en-CA", "fr-CA"). */
     locale?: string;
+    /** Request timeout in milliseconds. */
     timeout?: number;
+    /** Maximum number of automatic retries on transient failures. */
     maxRetries?: number;
+    /** Delay in milliseconds between retries. */
     retryDelay?: number;
 }
 declare const DEFAULT_BASE_URL = "https://api.smartbills.io";
 
+/**
+ * The main entry point for the Smartbills SDK.
+ *
+ * Provides access to all Smartbills API services through a single client instance.
+ * Handles authentication, business context, and locale configuration.
+ *
+ * @example
+ * ```typescript
+ * const client = new SmartbillsClient({
+ *   accessToken: "your-access-token",
+ *   businessId: 42,
+ *   locale: "en-CA",
+ * });
+ *
+ * const expenses = await client.expenses.listBusiness({ limit: 25 });
+ * const report = await client.expenseReports.create({ name: "Q1 Travel" });
+ * ```
+ */
 declare class SmartbillsClient {
     protected readonly http: HttpClient;
     readonly users: UserService;
@@ -5762,23 +6792,63 @@ declare class SmartbillsClient {
     readonly tables: TableService;
     readonly billing: BillingService;
     readonly workflows: WorkflowService;
+    readonly customers: CustomerService;
+    readonly departments: DepartmentService;
+    readonly products: ProductService;
+    readonly taxes: TaxService;
+    readonly promoCodes: PromoCodeService;
+    readonly categories: CategoryService;
+    readonly employees: EmployeeService;
+    readonly attachments: AttachmentService;
+    readonly emailForwarding: EmailForwardingService;
+    readonly authorizedSenders: AuthorizedSenderService;
+    readonly loyalty: LoyaltyService;
+    /**
+     * Creates a new Smartbills client instance.
+     *
+     * @param options - Configuration options for the client (base URL, auth token, business ID, locale, retry settings)
+     */
     constructor(options?: SmartbillsClientOptions);
+    /** Sets the OAuth2 access token used for authenticating API requests. */
     setAccessToken(token: string | undefined): void;
+    /** Sets the business context for multi-tenant API requests. */
     setBusinessId(id: number | undefined): void;
+    /** Sets the locale for localized API responses (e.g., "en-CA", "fr-CA"). */
     setLocale(locale: string | undefined): void;
+    /** The current OAuth2 access token, if set. */
     get accessToken(): string | undefined;
+    /** The current business ID context, if set. */
     get businessId(): number | undefined;
+    /** The current locale for API responses, if set. */
     get locale(): string | undefined;
 }
 
+/**
+ * Interface for providing access credentials to the Smartbills SDK.
+ *
+ * Implement this interface to supply custom credential retrieval logic,
+ * such as refreshing tokens from an auth provider.
+ */
 interface CredentialProvider {
+    /** Returns the current access token, or `undefined` if not authenticated. */
     getAccessToken(): string | undefined;
+    /** Optional callback invoked when the current token has expired, allowing automatic refresh. */
     onTokenExpired?(): Promise<string | undefined>;
 }
+/**
+ * Simple credential provider that stores an access token in memory.
+ *
+ * @example
+ * ```typescript
+ * const cred = new AccessToken("my-jwt-token");
+ * console.log(cred.getAccessToken()); // "my-jwt-token"
+ * ```
+ */
 declare class AccessToken implements CredentialProvider {
     private token?;
     constructor(token?: string);
     getAccessToken(): string | undefined;
+    /** Updates the stored access token. Pass `undefined` to clear it. */
     setToken(token: string | undefined): void;
 }
 
@@ -5922,5 +6992,7 @@ declare function isConflictError(error: unknown): error is SmartbillsConflictErr
 declare function isQuotaError(error: unknown): error is SmartbillsQuotaError;
 declare function isRetryableError(error: unknown): boolean;
 
-export { AccessToken, AppInstallationService, AppInstallationStatus, ApprobationService, BaseService, BillApprovalStatus, BillApprovalType, BillService, BillStatus, BillingService, BusinessService, BusinessUserService, CheckoutDocumentType, CheckoutPaymentStatus, CheckoutService, CheckoutStatus, ConnectAccountStatus, ConnectService, DEFAULT_BASE_URL, EmailAccountService, EmailAccountStatus, EmailAccountSyncStatus, EmailAccountType, ErrorCode, ExpenseItemStatus, ExpenseJobService, ExpenseReportAuditLogAction, ExpenseReportExpenseService, ExpenseReportPaymentService, ExpenseReportService, ExpenseReportStatus, ExpenseService, HttpClient, IntegrationService, IntegrationStatus, InvitationService, InvitationStatus, LocationService, MailboxType, MembershipRole, MembershipService, NotificationService, NotificationType, PayerType, PaymentMethodService, ReceiptPaymentStatus, ReceiptPaymentType, ReceiptService, ReceiptSource, ReceiptType, ReportingService, SmartbillsApiError, SmartbillsAuthenticationError, SmartbillsClient, SmartbillsConflictError, SmartbillsError, SmartbillsNetworkError, SmartbillsNotFoundError, SmartbillsPermissionError, SmartbillsQuotaError, SmartbillsRateLimitError, SmartbillsValidationError, SyncTriggerType, TableService, TransactionService, TransactionType, UserService, VendorConnectionService, VendorConnectionStatus, VendorService, WorkflowService, WorkflowTriggerType, isApiError, isAuthenticationError, isConflictError, isNetworkError, isNotFoundError, isPermissionError, isQuotaError, isRateLimitError, isRetryableError, isSmartbillsError, isValidationError };
-export type { AddExpenseToReportRequest, AddExpensesToReportBatchRequest, ApprobationListRequest, AssociateExpenseReportUpdateRequest, BillApprovalRequest, BillBatchUpdateRequest, BillCancelRequest, BillCreateRequest, BillListRequest, BillMarkPaidRequest, BillReschedulePaymentRequest, BillRetryPaymentRequest, BillSchedulePaymentRequest, BillSubmitForApprovalRequest, BillTransitionRequest, BillUpdateRequest, BulkAssignCategoryRequest, BulkAssignExpenseReportRequest, BulkAssignReportCategoryRequest, BulkAssignVendorRequest, BulkBillApproveRequest, BulkBillCancelPaymentRequest, BulkBillDeleteRequest, BulkBillMarkPaidRequest, BulkBillRemindRequest, BulkBillRetryPaymentRequest, BulkBillSchedulePaymentRequest, BulkBillUnscheduleRequest, BulkBillUpdateRequest, BulkDeleteExpenseReportsRequest, BulkDeleteExpensesRequest, BulkDeleteVendorsRequest, BulkRemoveReportExpensesRequest, BusinessBatchUpdateRequest, BusinessBrandCreateRequest, BusinessCreateRequest, BusinessUpdateRequest, ConnectOnboardingRequest, CreateCheckoutPaymentIntentRequest, CreatePaymentMethodRequest, CreatePortalSessionRequest, CredentialProvider, EditExpenseInReportRequest, EmailAccountImapCreateRequest, EmailAccountListRequest, EmailAccountOAuth2CreateRequest, EmailAccountUpdateRequest, ErrorCodeType, ExpenseAttachmentDownloadRequest, ExpenseCategoryUpdateRequest, ExpenseExportRequest, ExpenseJobListRequest, ExpenseListRequest, ExpenseNoteUpdateRequest, ExpenseOverTimeRequest, ExpenseReportApproveRequest, ExpenseReportAssignLedgerAccountRequest, ExpenseReportCommentCreateRequest, ExpenseReportCreateRequest, ExpenseReportExportRequest, ExpenseReportListRequest, ExpenseReportPartialReimburseRequest, ExpenseReportPlanReimbursementRequest, ExpenseReportRecallRequest, ExpenseReportReimburseRequest, ExpenseReportRejectRequest, ExpenseReportRequestChangesRequest, ExpenseReportUpdateRequest, ExpenseSplitItem, ExpenseSplitRequest, HistoricalSyncRequest, HttpClientConfig, IntegrationCallbackRequest, IntegrationListRequest, InvitationCreateRequest, InvitationListRequest, InvoiceListRequest, LocationBatchCreateRequest, LocationBatchUpdateRequest, LocationCreateRequest, LocationImageUrlRequest, LocationListRequest, LocationUpdateRequest, MailboxUpdateRequest, MembershipCreateRequest, MembershipEmailInviteRequest, MembershipListRequest, MembershipRoleUpdateRequest, NotificationListRequest, PaginateBusinessRequest, PaginateTransactionRequest, PaginationRequest, PaymentMethodListRequest, ReceiptCreateRequest, ReceiptListRequest, ReceiptOCRCreateRequest, ReceiptUpdateRequest, RefundCheckoutPaymentRequest, ReportDateRange, ReportingRequest, RequestOptions, SBAddress, SBAppInstallation, SBApprobationSummary, SBBatchResponse, SBBill, SBBillApproval, SBBillApprovalHistoryItem, SBBillAttachment, SBBillBulkActionResponse, SBBillLineItem, SBBillStatusSummary, SBBillTax, SBBillTransitionResponse, SBBillingAddress, SBBillingPaymentMethod, SBBillingPlan, SBBillingUsage, SBBulkActionResponse, SBBulkActionResult, SBBusiness, SBBusinessBrand, SBBusinessPlan, SBCheckoutLineItem, SBCheckoutPayment, SBCheckoutPaymentDispute, SBCheckoutPaymentRefund, SBCheckoutTax, SBCheckoutTransactionResponse, SBConnectAccount, SBConnectAccountRequirements, SBConnectDashboardResponse, SBConnectOnboardingResponse, SBCoordinate, SBCreateCheckoutPaymentIntentResponse, SBDowngradeValidation, SBEmailAccount, SBEmailAccountAuthorizeResponse, SBEmployeeCategoryBreakdownReport, SBEntity, SBExpenseBulkActionResponse, SBExpenseByCategoryReport, SBExpenseByDayReport, SBExpenseByEmployeeReport, SBExpenseByVendorReport, SBExpenseJob, SBExpenseMonthlySummary, SBExpenseOverTimeDataPoint, SBExpenseOverTimeReport, SBExpenseReport, SBExpenseReportAuditLogEntry, SBExpenseReportBulkActionResponse, SBExpenseReportComment, SBExpenseReportItem, SBExpenseReportSummary, SBExpenseReportTimelineEntry, SBExpenseValidateResponse, SBFileDownloadResponse, SBIntegration, SBIntegrationAuthorizeResponse, SBInvitation, SBInvoice, SBInvoiceLine, SBListResponse, SBLocation, SBLocationImage, SBMailbox, SBMarketplaceApp, SBMembership, SBMerchantLedger, SBMoney, SBNotification, SBPagination, SBPaymentMethod, SBPaymentMethodBillingDetails, SBPaymentMethodSetupIntentResponse, SBPortalSession, SBReceipt, SBReceiptBarcode, SBReceiptBusiness, SBReceiptCustomer, SBReceiptDiscount, SBReceiptDocument, SBReceiptFee, SBReceiptLineItem, SBReceiptPayment, SBReceiptPaymentCard, SBReceiptRefund, SBReceiptTax, SBReceiptTransaction, SBReceiptVendor, SBSessionTokenResponse, SBSetupIntent, SBSubscription, SBSyncSession, SBTable, SBTableColumn, SBTableRow, SBTaxByCategoryReport, SBTaxByTypeReport, SBTaxByVendorReport, SBTaxSummaryReport, SBTimestamps, SBTransaction, SBTransactionAttachment, SBTransactionMerchant, SBTransactionTax, SBTransactionUploadResponse, SBTransactionVendor, SBUpcomingInvoice, SBUserAccount, SBValidateEmailResponse, SBVendor, SBVendorBulkActionResponse, SBVendorConnectResponse, SBVendorConnection, SBVendorImportResult, SBWorkflow, SBWorkflowCondition, SBWorkflowStep, SBWorkflowTestResponse, SmartbillsClientOptions, SmartbillsFieldError, SubmitDisputeEvidenceRequest, SyncSessionListRequest, TableCreateRequest, TableListRequest, TableUpdateRequest, TransactionBatchUpdateRequest, TransactionUpdateRequest, UpdateInstallationStatusRequest, UpgradeSubscriptionRequest, UsageHistoryRequest, UserUpdateRequest, VendorBatchUpdateRequest, VendorConnectRequest, VendorCreateRequest, VendorListRequest, VendorMergeRequest, VendorUpdateRequest, WorkflowCreateRequest, WorkflowListRequest, WorkflowTestRequest, WorkflowUpdateRequest };
+declare function uploadFileToS3(uploadUrl: string, file: Blob | ArrayBuffer, contentType: string): Promise<void>;
+
+export { AccessToken, AppInstallationService, AppInstallationStatus, ApprobationService, AttachmentService, AuthorizedSenderService, BaseService, BillApprovalStatus, BillApprovalType, BillService, BillStatus, BillingService, BusinessService, BusinessUserService, CategoryService, CheckoutDocumentType, CheckoutPaymentStatus, CheckoutService, CheckoutStatus, ConnectAccountStatus, ConnectService, CustomerService, DEFAULT_BASE_URL, DepartmentService, EmailAccountService, EmailAccountStatus, EmailAccountSyncStatus, EmailAccountType, EmailForwardingService, EmployeeService, ErrorCode, ExpenseItemStatus, ExpenseJobService, ExpenseReportAuditLogAction, ExpenseReportExpenseService, ExpenseReportPaymentService, ExpenseReportService, ExpenseReportStatus, ExpenseService, ExpenseSplitType, HttpClient, IntegrationService, IntegrationStatus, InvitationService, InvitationStatus, LocationService, LoyaltyService, MailboxType, MembershipRole, MembershipService, NotificationService, NotificationType, PayerType, PaymentMethodService, ProductService, PromoCodeService, ReceiptPaymentStatus, ReceiptPaymentType, ReceiptService, ReceiptSource, ReceiptType, ReportingService, SmartbillsApiError, SmartbillsAuthenticationError, SmartbillsClient, SmartbillsConflictError, SmartbillsError, SmartbillsNetworkError, SmartbillsNotFoundError, SmartbillsPermissionError, SmartbillsQuotaError, SmartbillsRateLimitError, SmartbillsValidationError, SyncTriggerType, TableService, TaxService, TransactionService, TransactionType, UserService, VendorConnectionService, VendorConnectionStatus, VendorService, WorkflowService, WorkflowTriggerType, isApiError, isAuthenticationError, isConflictError, isNetworkError, isNotFoundError, isPermissionError, isQuotaError, isRateLimitError, isRetryableError, isSmartbillsError, isValidationError, uploadFileToS3 };
+export type { AddExpenseToReportRequest, AddExpensesToReportBatchRequest, ApprobationListRequest, AssociateExpenseReportUpdateRequest, AttachmentListRequest, AttachmentRenameRequest, BillApprovalRequest, BillBatchUpdateRequest, BillCancelRequest, BillCreateRequest, BillListRequest, BillMarkPaidRequest, BillReschedulePaymentRequest, BillRetryPaymentRequest, BillSchedulePaymentRequest, BillSubmitForApprovalRequest, BillTransitionRequest, BillUpdateRequest, BulkAssignCategoryRequest, BulkAssignExpenseReportRequest, BulkAssignPayerTypeRequest, BulkAssignReportCategoryRequest, BulkAssignVendorRequest, BulkBillApproveRequest, BulkBillCancelPaymentRequest, BulkBillDeleteRequest, BulkBillMarkPaidRequest, BulkBillRemindRequest, BulkBillRetryPaymentRequest, BulkBillSchedulePaymentRequest, BulkBillUnscheduleRequest, BulkBillUpdateRequest, BulkDeleteExpenseReportsRequest, BulkDeleteExpensesRequest, BulkDeleteVendorsRequest, BulkRemoveReportExpensesRequest, BulkSetNoteRequest, BusinessBatchUpdateRequest, BusinessBrandCreateRequest, BusinessCreateRequest, BusinessUpdateRequest, CategoryCreateRequest, CategoryUpdateRequest, ConfirmUploadFileRequest, ConfirmUploadRequest, ConnectOnboardingRequest, CreateAuthorizedSenderRequest, CreateCheckoutPaymentIntentRequest, CreatePaymentMethodRequest, CreatePortalSessionRequest, CredentialProvider, CustomerCreateRequest, CustomerListRequest, CustomerUpdateRequest, DepartmentCreateRequest, DepartmentListRequest, DepartmentUpdateRequest, EditExpenseInReportRequest, EmailAccountImapCreateRequest, EmailAccountListRequest, EmailAccountOAuth2CreateRequest, EmailAccountUpdateRequest, EmailForwardingConfigRequest, EmployeeBulkAssignManagerRequest, EmployeeCreateRequest, EmployeeListRequest, EmployeeSetManagerRequest, EmployeeUpdateRequest, ErrorCodeType, ExpenseAttachmentDownloadRequest, ExpenseCategoryUpdateRequest, ExpenseExportRequest, ExpenseJobListRequest, ExpenseListRequest, ExpenseNoteUpdateRequest, ExpenseOverTimeRequest, ExpenseReportApproveRequest, ExpenseReportAssignLedgerAccountRequest, ExpenseReportCommentCreateRequest, ExpenseReportCreateRequest, ExpenseReportExportRequest, ExpenseReportListRequest, ExpenseReportPartialReimburseRequest, ExpenseReportPlanReimbursementRequest, ExpenseReportRecallRequest, ExpenseReportReimburseRequest, ExpenseReportRejectRequest, ExpenseReportRequestChangesRequest, ExpenseReportUpdateRequest, ExpenseReviewUpdateRequest, ExpenseSplitItem, ExpenseSplitLineItem, ExpenseSplitRequest, HistoricalSyncRequest, HttpClientConfig, IntegrationCallbackRequest, IntegrationListRequest, InvitationCreateRequest, InvitationListRequest, InvoiceListRequest, LocationBatchCreateRequest, LocationBatchUpdateRequest, LocationCreateRequest, LocationImageUrlRequest, LocationListRequest, LocationUpdateRequest, LoyaltyProgramCreateRequest, LoyaltyProgramListRequest, LoyaltyProgramStatus, LoyaltyProgramUpdateRequest, LoyaltyRewardType, LoyaltyRuleType, MailboxUpdateRequest, MembershipCreateRequest, MembershipEmailInviteRequest, MembershipListRequest, MembershipRoleUpdateRequest, NotificationListRequest, PaginateBusinessRequest, PaginateTransactionRequest, PaginationRequest, PaymentMethodListRequest, PresignedUploadFileRequest, PresignedUploadFileResponse, PresignedUploadRequest, PresignedUploadResponse, ProductListRequest, ReceiptCreateRequest, ReceiptListRequest, ReceiptOCRCreateRequest, ReceiptUpdateRequest, RefundCheckoutPaymentRequest, ReportDateRange, ReportingRequest, RequestOptions, SBAddress, SBAppInstallation, SBApprobationSummary, SBAttachment, SBAuthorizedSender, SBBatchResponse, SBBill, SBBillApproval, SBBillApprovalHistoryItem, SBBillAttachment, SBBillBulkActionResponse, SBBillLineItem, SBBillStatusSummary, SBBillTax, SBBillTransitionResponse, SBBillingAddress, SBBillingPaymentMethod, SBBillingPlan, SBBillingUsage, SBBulkActionResponse, SBBulkActionResult, SBBusiness, SBBusinessBrand, SBBusinessPlan, SBCategory, SBCategoryRuleData, SBCheckoutLineItem, SBCheckoutPayment, SBCheckoutPaymentDispute, SBCheckoutPaymentRefund, SBCheckoutTax, SBCheckoutTransactionResponse, SBConnectAccount, SBConnectAccountRequirements, SBConnectDashboardResponse, SBConnectOnboardingResponse, SBCoordinate, SBCreateCheckoutPaymentIntentResponse, SBCustomer, SBDepartment, SBDepartmentMember, SBDowngradeValidation, SBEmailAccount, SBEmailAccountAuthorizeResponse, SBEmailForwardingConfig, SBEmployee, SBEmployeeCategoryBreakdownReport, SBEmployeeDepartment, SBEmployeeLocation, SBEmployeeManager, SBEntity, SBExpenseBulkActionResponse, SBExpenseByCategoryReport, SBExpenseByDayReport, SBExpenseByEmployeeReport, SBExpenseByVendorReport, SBExpenseJob, SBExpenseMonthlySummary, SBExpenseOverTimeDataPoint, SBExpenseOverTimeReport, SBExpenseReport, SBExpenseReportAuditLogEntry, SBExpenseReportBulkActionResponse, SBExpenseReportComment, SBExpenseReportItem, SBExpenseReportSummary, SBExpenseReportTimelineEntry, SBExpenseValidateResponse, SBFileDownloadResponse, SBHistoricalSyncResponse, SBIntegration, SBIntegrationAuthorizeResponse, SBInvitation, SBInvoice, SBInvoiceLine, SBItemVariationRuleData, SBListResponse, SBLocation, SBLocationImage, SBLoyaltyProgram, SBLoyaltyRule, SBLoyaltyRuleBase, SBMailbox, SBMarketplaceApp, SBMembership, SBMerchantLedger, SBMoney, SBNotification, SBPagination, SBPaymentMethod, SBPaymentMethodBillingDetails, SBPaymentMethodSetupIntentResponse, SBPortalSession, SBProduct, SBPromoCode, SBReceipt, SBReceiptBarcode, SBReceiptBusiness, SBReceiptCustomer, SBReceiptDiscount, SBReceiptDocument, SBReceiptFee, SBReceiptLineItem, SBReceiptPayment, SBReceiptPaymentCard, SBReceiptRefund, SBReceiptTax, SBReceiptTransaction, SBReceiptVendor, SBSessionTokenResponse, SBSetupIntent, SBSharedMailbox, SBSpendRuleData, SBSubscription, SBSyncSession, SBTable, SBTableColumn, SBTableRow, SBTax, SBTaxByCategoryReport, SBTaxByTypeReport, SBTaxByVendorReport, SBTaxSummaryReport, SBTimestamps, SBTransaction, SBTransactionAttachment, SBTransactionMerchant, SBTransactionTax, SBTransactionUploadResponse, SBTransactionVendor, SBUpcomingInvoice, SBUserAccount, SBValidateEmailResponse, SBValidateSharedMailboxResponse, SBVendor, SBVendorBulkActionResponse, SBVendorConnectResponse, SBVendorConnection, SBVendorImportResult, SBVisitRuleData, SBWorkflow, SBWorkflowCondition, SBWorkflowStep, SBWorkflowTestResponse, SmartbillsClientOptions, SmartbillsFieldError, SubmitDisputeEvidenceRequest, SyncSessionListRequest, TableCreateRequest, TableListRequest, TableUpdateRequest, TaxListRequest, TransactionBatchUpdateRequest, TransactionUpdateRequest, UpdateInstallationStatusRequest, UpgradeSubscriptionRequest, UsageHistoryRequest, UserUpdateRequest, VendorBatchUpdateRequest, VendorConnectRequest, VendorCreateRequest, VendorListRequest, VendorMergeRequest, VendorUpdateRequest, WorkflowCreateRequest, WorkflowListRequest, WorkflowTestRequest, WorkflowUpdateRequest };