nxus-qbd 0.1.0

package/dist/generated/types.gen.js

@@ -0,0 +1,217 @@
+// This file is auto-generated by @hey-api/openapi-ts
+/**
+ * Defines the valid Account Types for QuickBooks Desktop.
+ * The specific type of the account, such as Bank, Accounts Payable, Accounts Receivable, CreditCard, etc.
+ */
+export var AccountType;
+(function (AccountType) {
+    AccountType["ACCOUNTS_PAYABLE"] = "AccountsPayable";
+    AccountType["ACCOUNTS_RECEIVABLE"] = "AccountsReceivable";
+    AccountType["BANK"] = "Bank";
+    AccountType["COST_OF_GOODS_SOLD"] = "CostOfGoodsSold";
+    AccountType["CREDIT_CARD"] = "CreditCard";
+    AccountType["EQUITY"] = "Equity";
+    AccountType["EXPENSE"] = "Expense";
+    AccountType["FIXED_ASSET"] = "FixedAsset";
+    AccountType["INCOME"] = "Income";
+    AccountType["LONG_TERM_LIABILITY"] = "LongTermLiability";
+    AccountType["NON_POSTING"] = "NonPosting";
+    AccountType["OTHER_ASSET"] = "OtherAsset";
+    AccountType["OTHER_CURRENT_ASSET"] = "OtherCurrentAsset";
+    AccountType["OTHER_CURRENT_LIABILITY"] = "OtherCurrentLiability";
+    AccountType["OTHER_EXPENSE"] = "OtherExpense";
+    AccountType["OTHER_INCOME"] = "OtherIncome";
+})(AccountType || (AccountType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemInventoryItemItemType;
+(function (ItemInventoryItemItemType) {
+    ItemInventoryItemItemType["INVENTORY_ITEM"] = "InventoryItem";
+})(ItemInventoryItemItemType || (ItemInventoryItemItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemDiscountItemType;
+(function (ItemItemDiscountItemType) {
+    ItemItemDiscountItemType["DISCOUNT"] = "Discount";
+})(ItemItemDiscountItemType || (ItemItemDiscountItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemFixedAssetItemType;
+(function (ItemItemFixedAssetItemType) {
+    ItemItemFixedAssetItemType["FIXED_ASSET"] = "FixedAsset";
+})(ItemItemFixedAssetItemType || (ItemItemFixedAssetItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemGroupItemType;
+(function (ItemItemGroupItemType) {
+    ItemItemGroupItemType["GROUP"] = "Group";
+})(ItemItemGroupItemType || (ItemItemGroupItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemInventoryAssemblyItemType;
+(function (ItemItemInventoryAssemblyItemType) {
+    ItemItemInventoryAssemblyItemType["INVENTORY_ASSEMBLY"] = "InventoryAssembly";
+})(ItemItemInventoryAssemblyItemType || (ItemItemInventoryAssemblyItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemNonInventoryItemType;
+(function (ItemItemNonInventoryItemType) {
+    ItemItemNonInventoryItemType["NON_INVENTORY"] = "NonInventory";
+})(ItemItemNonInventoryItemType || (ItemItemNonInventoryItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemOtherChargeItemType;
+(function (ItemItemOtherChargeItemType) {
+    ItemItemOtherChargeItemType["OTHER_CHARGE"] = "OtherCharge";
+})(ItemItemOtherChargeItemType || (ItemItemOtherChargeItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemPaymentItemType;
+(function (ItemItemPaymentItemType) {
+    ItemItemPaymentItemType["PAYMENT"] = "Payment";
+})(ItemItemPaymentItemType || (ItemItemPaymentItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemSalesTaxGroupItemType;
+(function (ItemItemSalesTaxGroupItemType) {
+    ItemItemSalesTaxGroupItemType["SALES_TAX_GROUP"] = "SalesTaxGroup";
+})(ItemItemSalesTaxGroupItemType || (ItemItemSalesTaxGroupItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemSalesTaxItemType;
+(function (ItemItemSalesTaxItemType) {
+    ItemItemSalesTaxItemType["SALES_TAX"] = "SalesTax";
+})(ItemItemSalesTaxItemType || (ItemItemSalesTaxItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemItemSubtotalItemType;
+(function (ItemItemSubtotalItemType) {
+    ItemItemSubtotalItemType["SUBTOTAL"] = "Subtotal";
+})(ItemItemSubtotalItemType || (ItemItemSubtotalItemType = {}));
+/**
+ * Specific object type for the Item.
+ * Matches the XML return tag name (e.g. ItemServiceRet -> Service).
+ */
+export var ItemServiceItemItemType;
+(function (ItemServiceItemItemType) {
+    ItemServiceItemItemType["SERVICE"] = "Service";
+})(ItemServiceItemItemType || (ItemServiceItemItemType = {}));
+export var NullableAccountType;
+(function (NullableAccountType) {
+    NullableAccountType["ACCOUNTS_PAYABLE"] = "AccountsPayable";
+    NullableAccountType["ACCOUNTS_RECEIVABLE"] = "AccountsReceivable";
+    NullableAccountType["BANK"] = "Bank";
+    NullableAccountType["COST_OF_GOODS_SOLD"] = "CostOfGoodsSold";
+    NullableAccountType["CREDIT_CARD"] = "CreditCard";
+    NullableAccountType["EQUITY"] = "Equity";
+    NullableAccountType["EXPENSE"] = "Expense";
+    NullableAccountType["FIXED_ASSET"] = "FixedAsset";
+    NullableAccountType["INCOME"] = "Income";
+    NullableAccountType["LONG_TERM_LIABILITY"] = "LongTermLiability";
+    NullableAccountType["NON_POSTING"] = "NonPosting";
+    NullableAccountType["OTHER_ASSET"] = "OtherAsset";
+    NullableAccountType["OTHER_CURRENT_ASSET"] = "OtherCurrentAsset";
+    NullableAccountType["OTHER_CURRENT_LIABILITY"] = "OtherCurrentLiability";
+    NullableAccountType["OTHER_EXPENSE"] = "OtherExpense";
+    NullableAccountType["OTHER_INCOME"] = "OtherIncome";
+})(NullableAccountType || (NullableAccountType = {}));
+export var NullableAvsStreet;
+(function (NullableAvsStreet) {
+    NullableAvsStreet["PASS"] = "Pass";
+    NullableAvsStreet["FAIL"] = "Fail";
+    NullableAvsStreet["NOT_AVAILABLE"] = "NotAvailable";
+})(NullableAvsStreet || (NullableAvsStreet = {}));
+export var NullableAvsZip;
+(function (NullableAvsZip) {
+    NullableAvsZip["PASS"] = "Pass";
+    NullableAvsZip["FAIL"] = "Fail";
+    NullableAvsZip["NOT_AVAILABLE"] = "NotAvailable";
+})(NullableAvsZip || (NullableAvsZip = {}));
+export var NullableCardSecurityCodeMatch;
+(function (NullableCardSecurityCodeMatch) {
+    NullableCardSecurityCodeMatch["PASS"] = "Pass";
+    NullableCardSecurityCodeMatch["FAIL"] = "Fail";
+    NullableCardSecurityCodeMatch["NOT_AVAILABLE"] = "NotAvailable";
+})(NullableCardSecurityCodeMatch || (NullableCardSecurityCodeMatch = {}));
+export var NullableCashFlowClassification;
+(function (NullableCashFlowClassification) {
+    NullableCashFlowClassification["NONE"] = "None";
+    NullableCashFlowClassification["OPERATING"] = "Operating";
+    NullableCashFlowClassification["INVESTING"] = "Investing";
+    NullableCashFlowClassification["FINANCING"] = "Financing";
+    NullableCashFlowClassification["NOT_APPLICABLE"] = "NotApplicable";
+})(NullableCashFlowClassification || (NullableCashFlowClassification = {}));
+export var NullableCreditCardTransactionType;
+(function (NullableCreditCardTransactionType) {
+    NullableCreditCardTransactionType["AUTHORIZATION"] = "Authorization";
+    NullableCreditCardTransactionType["CAPTURE"] = "Capture";
+    NullableCreditCardTransactionType["CHARGE"] = "Charge";
+    NullableCreditCardTransactionType["REFUND"] = "Refund";
+    NullableCreditCardTransactionType["VOICE_AUTHORIZATION"] = "VoiceAuthorization";
+})(NullableCreditCardTransactionType || (NullableCreditCardTransactionType = {}));
+export var NullableJobStatus;
+(function (NullableJobStatus) {
+    NullableJobStatus["NONE"] = "None";
+    NullableJobStatus["PENDING"] = "Pending";
+    NullableJobStatus["AWARDED"] = "Awarded";
+    NullableJobStatus["IN_PROGRESS"] = "InProgress";
+    NullableJobStatus["CLOSED"] = "Closed";
+    NullableJobStatus["NOT_AWARDED"] = "NotAwarded";
+})(NullableJobStatus || (NullableJobStatus = {}));
+export var NullableSpecialAccountType;
+(function (NullableSpecialAccountType) {
+    NullableSpecialAccountType["ACCOUNTS_PAYABLE"] = "AccountsPayable";
+    NullableSpecialAccountType["ACCOUNTS_RECEIVABLE"] = "AccountsReceivable";
+    NullableSpecialAccountType["CONDENSE_ITEM_ADJUSTMENT_EXPENSES"] = "CondenseItemAdjustmentExpenses";
+    NullableSpecialAccountType["COST_OF_GOODS_SOLD"] = "CostOfGoodsSold";
+    NullableSpecialAccountType["DIRECT_DEPOSIT_LIABILITIES"] = "DirectDepositLiabilities";
+    NullableSpecialAccountType["ESTIMATES"] = "Estimates";
+    NullableSpecialAccountType["EXCHANGE_GAIN_LOSS"] = "ExchangeGainLoss";
+    NullableSpecialAccountType["INVENTORY_ASSETS"] = "InventoryAssets";
+    NullableSpecialAccountType["ITEM_RECEIPT_ACCOUNT"] = "ItemReceiptAccount";
+    NullableSpecialAccountType["OPENING_BALANCE_EQUITY"] = "OpeningBalanceEquity";
+    NullableSpecialAccountType["PAYROLL_EXPENSES"] = "PayrollExpenses";
+    NullableSpecialAccountType["PAYROLL_LIABILITIES"] = "PayrollLiabilities";
+    NullableSpecialAccountType["PETTY_CASH"] = "PettyCash";
+    NullableSpecialAccountType["PURCHASE_ORDERS"] = "PurchaseOrders";
+    NullableSpecialAccountType["RECONCILIATION_DIFFERENCES"] = "ReconciliationDifferences";
+    NullableSpecialAccountType["RETAINED_EARNINGS"] = "RetainedEarnings";
+    NullableSpecialAccountType["SALES_ORDERS"] = "SalesOrders";
+    NullableSpecialAccountType["SALES_TAX_PAYABLE"] = "SalesTaxPayable";
+    NullableSpecialAccountType["UNCATEGORIZED_EXPENSES"] = "UncategorizedExpenses";
+    NullableSpecialAccountType["UNCATEGORIZED_INCOME"] = "UncategorizedIncome";
+    NullableSpecialAccountType["UNDEPOSITED_FUNDS"] = "UndepositedFunds";
+})(NullableSpecialAccountType || (NullableSpecialAccountType = {}));
+export var NullableTransactionMode;
+(function (NullableTransactionMode) {
+    NullableTransactionMode["CARD_NOT_PRESENT"] = "CardNotPresent";
+    NullableTransactionMode["CARD_PRESENT"] = "CardPresent";
+})(NullableTransactionMode || (NullableTransactionMode = {}));
+export var PaymentStatus;
+(function (PaymentStatus) {
+    PaymentStatus["UNKNOWN"] = "Unknown";
+    PaymentStatus["COMPLETED"] = "Completed";
+})(PaymentStatus || (PaymentStatus = {}));
+//# sourceMappingURL=types.gen.js.map

package/dist/generated/types.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.gen.js","sourceRoot":"","sources":["../../src/generated/types.gen.ts"],"names":[],"mappings":"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"}

package/dist/helpers/errors.d.ts

@@ -0,0 +1,113 @@
+import type { ErrorDetail } from '../generated/types.gen';
+/**
+ * Error codes from the nXus API.
+ * Mirrors the ErrorCode enum from types.gen.ts for convenience.
+ */
+export type NxusErrorCode = ErrorDetail['code'] | (string & {});
+export type NxusErrorType = ErrorDetail['type'] | (string & {});
+/**
+ * Typed error class for all nXus API errors.
+ *
+ * Normalizes both `StandardErrorResponse` and `ProblemDetails` shapes into
+ * a single class with typed properties and helper getters.
+ *
+ * @example
+ * ```ts
+ * const { data, error } = await listConnections();
+ * if (error) {
+ *   const err = NxusApiError.from(error);
+ *   if (err.isAuthError) { /* redirect to login *\/ }
+ *   if (err.isRateLimited) { /* wait for retryAfter *\/ }
+ *   console.log(err.userMessage); // always safe to show in UI
+ * }
+ * ```
+ */
+export declare class NxusApiError extends Error {
+    /** The specific error code for programmatic handling (e.g. `'QBD_CONNECTION_ERROR'`). */
+    readonly code: NxusErrorCode | undefined;
+    /** Broad error category (e.g. `'AUTHENTICATION_ERROR_TYPE'`). */
+    readonly type: NxusErrorType | undefined;
+    /** HTTP status code. */
+    readonly status: number;
+    /** User-safe message — always prefer this in UI over `message`. */
+    readonly userMessage: string;
+    /** Request ID for support/diagnostics (e.g. `'req_abc123'`). */
+    readonly requestId: string | undefined;
+    /** QB Desktop integration-specific error code (HRESULT or QBXML status). */
+    readonly integrationCode: string | undefined;
+    /** Per-field validation errors (only present for 422 responses). */
+    readonly validationErrors: Record<string, string[]> | undefined;
+    /** Connection lifecycle state when the API includes restriction context. */
+    readonly lifecycleState: string | undefined;
+    /** Reason the tenant or connection is restricted, if provided. */
+    readonly restrictionReason: string | undefined;
+    /** Structured restriction code when the API includes one. */
+    readonly restrictionCode: string | undefined;
+    /** Whether the API indicates payment is required before the request can succeed. */
+    readonly requiresPayment: boolean | undefined;
+    /** Checkout URL included with payment/restriction errors. */
+    readonly checkoutUrl: string | undefined;
+    /** The raw error payload as received from the SDK. */
+    readonly raw: unknown;
+    constructor(opts: {
+        message: string;
+        userMessage: string;
+        status: number;
+        code?: NxusErrorCode;
+        type?: NxusErrorType;
+        requestId?: string;
+        integrationCode?: string;
+        validationErrors?: Record<string, string[]>;
+        lifecycleState?: string;
+        restrictionReason?: string;
+        restrictionCode?: string;
+        requiresPayment?: boolean;
+        checkoutUrl?: string;
+        raw?: unknown;
+    });
+    /** Whether this is a rate-limit error (429). */
+    get isRateLimited(): boolean;
+    /** Whether this is an authentication/authorization error (401 or 403). */
+    get isAuthError(): boolean;
+    /** Whether this is a validation error (422, or explicit validation code/type). */
+    get isValidationError(): boolean;
+    /** Whether this is a not-found error (404). */
+    get isNotFound(): boolean;
+    /** Whether this error originated from QuickBooks Desktop (has an integration code). */
+    get isIntegrationError(): boolean;
+    /** Whether this is a stale edit sequence conflict (refresh and retry). */
+    get isConflict(): boolean;
+    /** Whether the API blocked the request because of a lifecycle or billing restriction. */
+    get isRestrictionError(): boolean;
+    /** Whether the connection appears to be archived. */
+    get isArchivedConnection(): boolean;
+    /**
+     * Create a `NxusApiError` from any SDK error value.
+     *
+     * Handles:
+     * - `StandardErrorResponse` (`{ error: ErrorDetail }`)
+     * - `ProblemDetails` (`{ title, detail, status, errors }`)
+     * - Plain strings
+     * - Unknown shapes (wrapped with generic message)
+     */
+    static from(error: unknown): NxusApiError;
+}
+export declare function isNxusApiError(error: unknown): error is NxusApiError;
+/**
+ * Use in SDK call sites to convert `{ data, error }` into a throw pattern.
+ *
+ * @example
+ * ```ts
+ * const { data, error } = await listConnections();
+ * throwIfError(error);
+ * // `data` is now narrowed to the success type
+ * ```
+ */
+export declare function throwIfError(error: unknown): asserts error is undefined;
+/**
+ * Extract a user-displayable message from any SDK error shape.
+ *
+ * @deprecated Prefer `NxusApiError.from(error).userMessage` for typed access.
+ */
+export declare function extractErrorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/helpers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/helpers/errors.ts"],"names":[],"mappings":"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"}

package/dist/helpers/errors.js

@@ -0,0 +1,250 @@
+function asRecord(value) {
+    return typeof value === 'object' && value !== null
+        ? value
+        : undefined;
+}
+function readString(source, key) {
+    const value = source?.[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function readBoolean(source, key) {
+    const value = source?.[key];
+    return typeof value === 'boolean' ? value : undefined;
+}
+// ---------------------------------------------------------------------------
+// NxusApiError — the single error type consumers should work with
+// ---------------------------------------------------------------------------
+/**
+ * Typed error class for all nXus API errors.
+ *
+ * Normalizes both `StandardErrorResponse` and `ProblemDetails` shapes into
+ * a single class with typed properties and helper getters.
+ *
+ * @example
+ * ```ts
+ * const { data, error } = await listConnections();
+ * if (error) {
+ *   const err = NxusApiError.from(error);
+ *   if (err.isAuthError) { /* redirect to login *\/ }
+ *   if (err.isRateLimited) { /* wait for retryAfter *\/ }
+ *   console.log(err.userMessage); // always safe to show in UI
+ * }
+ * ```
+ */
+export class NxusApiError extends Error {
+    /** The specific error code for programmatic handling (e.g. `'QBD_CONNECTION_ERROR'`). */
+    code;
+    /** Broad error category (e.g. `'AUTHENTICATION_ERROR_TYPE'`). */
+    type;
+    /** HTTP status code. */
+    status;
+    /** User-safe message — always prefer this in UI over `message`. */
+    userMessage;
+    /** Request ID for support/diagnostics (e.g. `'req_abc123'`). */
+    requestId;
+    /** QB Desktop integration-specific error code (HRESULT or QBXML status). */
+    integrationCode;
+    /** Per-field validation errors (only present for 422 responses). */
+    validationErrors;
+    /** Connection lifecycle state when the API includes restriction context. */
+    lifecycleState;
+    /** Reason the tenant or connection is restricted, if provided. */
+    restrictionReason;
+    /** Structured restriction code when the API includes one. */
+    restrictionCode;
+    /** Whether the API indicates payment is required before the request can succeed. */
+    requiresPayment;
+    /** Checkout URL included with payment/restriction errors. */
+    checkoutUrl;
+    /** The raw error payload as received from the SDK. */
+    raw;
+    constructor(opts) {
+        super(opts.message);
+        this.name = 'NxusApiError';
+        this.code = opts.code;
+        this.type = opts.type;
+        this.status = opts.status;
+        this.userMessage = opts.userMessage;
+        this.requestId = opts.requestId;
+        this.integrationCode = opts.integrationCode;
+        this.validationErrors = opts.validationErrors;
+        this.lifecycleState = opts.lifecycleState;
+        this.restrictionReason = opts.restrictionReason;
+        this.restrictionCode = opts.restrictionCode;
+        this.requiresPayment = opts.requiresPayment;
+        this.checkoutUrl = opts.checkoutUrl;
+        this.raw = opts.raw;
+    }
+    /** Whether this is a rate-limit error (429). */
+    get isRateLimited() {
+        return this.status === 429 || this.code === 'RATE_LIMIT_EXCEEDED';
+    }
+    /** Whether this is an authentication/authorization error (401 or 403). */
+    get isAuthError() {
+        return (this.status === 401 ||
+            this.status === 403 ||
+            this.type === 'AUTHENTICATION_ERROR_TYPE');
+    }
+    /** Whether this is a validation error (422, or explicit validation code/type). */
+    get isValidationError() {
+        return (this.status === 422 ||
+            this.code === 'VALIDATION_ERROR' ||
+            this.type === 'VALIDATION_ERROR_TYPE' ||
+            this.validationErrors != null);
+    }
+    /** Whether this is a not-found error (404). */
+    get isNotFound() {
+        return this.status === 404 || this.type === 'NOT_FOUND_ERROR_TYPE';
+    }
+    /** Whether this error originated from QuickBooks Desktop (has an integration code). */
+    get isIntegrationError() {
+        return this.integrationCode != null;
+    }
+    /** Whether this is a stale edit sequence conflict (refresh and retry). */
+    get isConflict() {
+        return this.status === 409 || this.code === 'QBD_STALE_EDIT_SEQUENCE';
+    }
+    /** Whether the API blocked the request because of a lifecycle or billing restriction. */
+    get isRestrictionError() {
+        return (this.status === 402 ||
+            this.requiresPayment === true ||
+            this.restrictionReason != null ||
+            this.restrictionCode != null ||
+            this.type === 'BILLING_ERROR_TYPE');
+    }
+    /** Whether the connection appears to be archived. */
+    get isArchivedConnection() {
+        return this.lifecycleState === 'archived';
+    }
+    /**
+     * Create a `NxusApiError` from any SDK error value.
+     *
+     * Handles:
+     * - `StandardErrorResponse` (`{ error: ErrorDetail }`)
+     * - `ProblemDetails` (`{ title, detail, status, errors }`)
+     * - Plain strings
+     * - Unknown shapes (wrapped with generic message)
+     */
+    static from(error) {
+        if (error instanceof NxusApiError)
+            return error;
+        if (!error) {
+            return new NxusApiError({
+                message: 'An unexpected error occurred.',
+                userMessage: 'An unexpected error occurred.',
+                status: 0,
+                raw: error,
+            });
+        }
+        if (typeof error === 'string') {
+            return new NxusApiError({
+                message: error,
+                userMessage: error,
+                status: 0,
+                raw: error,
+            });
+        }
+        const obj = error;
+        const restriction = asRecord(obj.restriction);
+        const billing = asRecord(obj.billing);
+        const lifecycleState = readString(obj, 'lifecycleState') ??
+            readString(restriction, 'lifecycleState');
+        const restrictionReason = readString(obj, 'restrictionReason') ??
+            readString(restriction, 'reason') ??
+            readString(restriction, 'restrictionReason');
+        const restrictionCode = readString(obj, 'restrictionCode') ??
+            readString(restriction, 'code') ??
+            readString(restriction, 'restrictionCode');
+        const requiresPayment = readBoolean(obj, 'requiresPayment') ??
+            readBoolean(restriction, 'requiresPayment') ??
+            readBoolean(billing, 'requiresPayment');
+        const checkoutUrl = readString(obj, 'checkoutUrl') ??
+            readString(restriction, 'checkoutUrl') ??
+            readString(billing, 'checkoutUrl');
+        // StandardErrorResponse shape: { error: ErrorDetail }
+        if (obj.error && typeof obj.error === 'object' && 'message' in obj.error) {
+            const detail = obj.error;
+            return new NxusApiError({
+                message: detail.message,
+                userMessage: detail.userFacingMessage || detail.message,
+                status: detail.httpStatusCode ?? obj.status ?? 0,
+                code: detail.code,
+                type: detail.type,
+                requestId: detail.requestId,
+                integrationCode: detail.integrationCode ?? undefined,
+                lifecycleState,
+                restrictionReason,
+                restrictionCode,
+                requiresPayment,
+                checkoutUrl,
+                raw: error,
+            });
+        }
+        // ProblemDetails shape: { title, detail, status, errors? }
+        if ('status' in obj && ('title' in obj || 'detail' in obj)) {
+            return new NxusApiError({
+                message: obj.detail || obj.title || 'Validation failed.',
+                userMessage: obj.detail || obj.title || 'Please check your input and try again.',
+                status: obj.status ?? 422,
+                type: 'VALIDATION_ERROR_TYPE',
+                code: 'VALIDATION_ERROR',
+                validationErrors: obj.errors,
+                lifecycleState,
+                restrictionReason,
+                restrictionCode,
+                requiresPayment,
+                checkoutUrl,
+                raw: error,
+            });
+        }
+        // Fallback: plain object with .message
+        const message = obj.message || obj.detail || obj.title || 'An unexpected error occurred.';
+        return new NxusApiError({
+            message,
+            userMessage: message,
+            status: obj.status ?? obj.statusCode ?? 0,
+            lifecycleState,
+            restrictionReason,
+            restrictionCode,
+            requiresPayment,
+            checkoutUrl,
+            raw: error,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Type guard
+// ---------------------------------------------------------------------------
+export function isNxusApiError(error) {
+    return error instanceof NxusApiError;
+}
+// ---------------------------------------------------------------------------
+// Convenience: throw SDK errors as typed NxusApiError
+// ---------------------------------------------------------------------------
+/**
+ * Use in SDK call sites to convert `{ data, error }` into a throw pattern.
+ *
+ * @example
+ * ```ts
+ * const { data, error } = await listConnections();
+ * throwIfError(error);
+ * // `data` is now narrowed to the success type
+ * ```
+ */
+export function throwIfError(error) {
+    if (error) {
+        throw NxusApiError.from(error);
+    }
+}
+// ---------------------------------------------------------------------------
+// Backward-compatible helper (used across existing components)
+// ---------------------------------------------------------------------------
+/**
+ * Extract a user-displayable message from any SDK error shape.
+ *
+ * @deprecated Prefer `NxusApiError.from(error).userMessage` for typed access.
+ */
+export function extractErrorMessage(error) {
+    return NxusApiError.from(error).userMessage;
+}
+//# sourceMappingURL=errors.js.map

package/dist/helpers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/helpers/errors.ts"],"names":[],"mappings":"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"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export { PaginationError, type AutoPaginationPromise, type CursorPage, type PaginatedPage, } from './pagination';
+export { NxusApiError, isNxusApiError, throwIfError, extractErrorMessage, type NxusErrorCode, type NxusErrorType, } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,3 @@
+export { PaginationError, } from './pagination';
+export { NxusApiError, isNxusApiError, throwIfError, extractErrorMessage, } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAIhB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,mBAAmB,GAGpB,MAAM,UAAU,CAAC"}

package/dist/helpers/pagination.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Pagination types and helpers for the Nxus SDK.
+ *
+ * The actual pagination logic is implemented in `src/resources/base.ts`
+ * using the transport layer. This file exports the shared type definitions
+ * and the PaginationError class.
+ */
+export type CursorPage<TItem = unknown> = {
+    count?: number;
+    data: TItem[];
+    hasMore: boolean;
+    limit?: number;
+    nextCursor: string | null;
+    page?: number;
+    remainingCount?: number;
+    totalCount?: number;
+    [key: string]: unknown;
+};
+export interface PaginatedPage<TItem = unknown> extends CursorPage<TItem> {
+    getNextPage(): Promise<PaginatedPage<TItem>>;
+    hasNextPage(): boolean;
+}
+export interface AutoPaginationPromise<TItem = unknown> extends PromiseLike<PaginatedPage<TItem>>, AsyncIterable<TItem> {
+    catch<TResult = never>(onRejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<PaginatedPage<TItem> | TResult>;
+    finally(onFinally?: (() => void) | null): Promise<PaginatedPage<TItem>>;
+}
+export declare class PaginationError extends Error {
+    readonly causeData?: unknown;
+    readonly status?: number;
+    constructor(message: string, options?: {
+        causeData?: unknown;
+        status?: number;
+    });
+}
+//# sourceMappingURL=pagination.d.ts.map