brainerce 1.27.1 → 1.28.0

package/dist/index.d.ts

@@ -248,12 +248,38 @@ interface Product {
     id: string;
     name: string;
     slug?: string | null;
+    /**
+     * Product description as HTML. **Always sanitize before rendering**, e.g.:
+     *
+     *     import { sanitizeHTML } from '@brainerce/utils';
+     *     <div dangerouslySetInnerHTML={{ __html: sanitizeHTML(product.description) }} />
+     *
+     * The backend strips dangerous tags/attributes on write, but storefronts should
+     * still treat product description as untrusted HTML and sanitize on render.
+     */
     description?: string | null;
     descriptionFormat?: 'text' | 'html' | 'markdown' | null;
     sku: string;
-    /** Base price as string (e.g., "29.99"). Use parseFloat() for calculations. */
+    /**
+     * Base price as string (e.g., "29.99"). Use parseFloat() for calculations.
+     *
+     * For `VARIABLE` products the API returns the effective base price
+     * aggregated from the product's variants — `MIN(variants.price)` — so a
+     * single product card always shows the lowest available price. Matches
+     * WooCommerce / Shopify storefront semantics. For `SIMPLE` products it is
+     * the product's own stored price.
+     */
     basePrice: string;
-    /** Sale price as string. Use parseFloat() for calculations. */
+    /**
+     * Sale price as string. Use parseFloat() for calculations. `null` when the
+     * product is not on sale.
+     *
+     * For `VARIABLE` products the API returns the effective sale price
+     * aggregated from the product's variants — `MIN(variants.salePrice WHERE
+     * NOT NULL)`. `null` only when no variant is on sale. Matches WooCommerce
+     * `is_on_sale()` ("any variation on sale" → product is on sale). For
+     * `SIMPLE` products it is the product's own stored sale price.
+     */
     salePrice?: string | null;
     /** Cost price as string. Use parseFloat() for calculations. */
     costPrice?: string | null;
@@ -263,6 +289,16 @@ interface Product {
     priceMax?: string | null;
     /** True when variant prices differ (VARIABLE products only). Use for "From X – Y" display. */
     priceVaries?: boolean;
+    /** PRD §23: product price converted to the region's currency via the daily
+     *  FX snapshot. Present only when the read was made with `getProducts({ regionId })`
+     *  and the region currency differs from the store currency. Display-only —
+     *  the basePrice/salePrice fields stay in the store currency. */
+    displayPrice?: string;
+    displaySalePrice?: string;
+    displayPriceMin?: string;
+    displayPriceMax?: string;
+    /** ISO 4217 currency of `displayPrice` (the buyer's region currency). */
+    displayCurrency?: string;
     /** Product status (active, draft). Always returned by backend. */
     status: string;
     type: 'SIMPLE' | 'VARIABLE';
@@ -444,6 +480,12 @@ interface ProductVariant {
     price?: string | null;
     /** Variant sale price as string. Use parseFloat() for calculations. */
     salePrice?: string | null;
+    /** PRD §23: variant price converted to the region's currency via the daily
+     *  FX snapshot. Present only with `getProducts({ regionId })`. Display-only. */
+    displayPrice?: string;
+    displaySalePrice?: string;
+    /** ISO 4217 currency of `displayPrice` (the buyer's region currency). */
+    displayCurrency?: string;
     /** Variant attributes (e.g., { "Color": "Red", "Size": "M" }) */
     attributes?: Record<string, string> | null;
     /**
@@ -466,6 +508,8 @@ interface ProductVariant {
     status?: string | null;
     createdAt: string;
     updatedAt: string;
+    /** Per-sales-channel field overrides keyed by connectionId */
+    channels?: Record<string, unknown> | null;
 }
 /**
  * Inventory tracking mode determines how stock is managed:
@@ -520,7 +564,9 @@ interface InventoryInfo {
  *   if (!product.description) return null;
  *
  *   if (isHtmlDescription(product)) {
- *     return <div dangerouslySetInnerHTML={{ __html: product.description }} />;
+ *     // Always sanitize before rendering — backend strips dangerous tags on write,
+ *     // but defense-in-depth on the storefront keeps a regressed/legacy DB safe too.
+ *     return <div dangerouslySetInnerHTML={{ __html: sanitizeHTML(product.description) }} />;
  *   }
  *
  *   return <p>{product.description}</p>;
@@ -922,6 +968,13 @@ interface ProductQueryParams {
     sortOrder?: 'asc' | 'desc';
     /** Locale for translated content (e.g., "he", "es"). Falls back to store default. */
     locale?: string;
+    /** PRD §23: resolve DISPLAY prices for this region. When set and the region
+     *  currency differs from the store currency, each product/variant gets
+     *  additive `displayPrice` / `displayCurrency` (+ `displaySalePrice`,
+     *  `displayPriceMin/Max`) from the daily FX snapshot. Original `basePrice` /
+     *  `salePrice` stay in the store currency. Display-only — checkout still
+     *  charges in the store currency. */
+    regionId?: string;
     type?: 'SIMPLE' | 'VARIABLE';
     isDownloadable?: boolean;
 }
@@ -1183,6 +1236,12 @@ interface OrderItem {
         value: string | string[];
         type: string;
     }>;
+    /**
+     * Slug of the tax class resolved for this line at order time (e.g. "reduced").
+     * A frozen snapshot — immune to later TaxClass renames/deletes. Omitted when
+     * the line resolved to no class (the store's Standard fallback).
+     */
+    taxClassSlug?: string;
 }
 /** A downloadable file attached to a product */
 interface DownloadFile {
@@ -1279,6 +1338,12 @@ interface Coupon {
     applicableCategories?: EntityRef[] | null;
     /** Categories explicitly excluded from this coupon. */
     excludedCategories?: EntityRef[] | null;
+    /**
+     * Region restriction (PRD §24). Region IDs this coupon is valid in. Empty =
+     * applies in all regions. Non-empty = only buyers whose checkout region is in
+     * the list can redeem it.
+     */
+    regionIds: string[];
     combinesWithOther: boolean;
     /** Whether coupon needs sync to platforms */
     needsSync?: boolean;
@@ -1351,6 +1416,8 @@ interface CreateCouponDto {
     applicableCategories?: string[];
     /** Category IDs explicitly excluded from this coupon */
     excludedCategories?: string[];
+    /** Region IDs this coupon is valid in (PRD §24). Empty/omitted = all regions. */
+    regionIds?: string[];
     combinesWithOther?: boolean;
     /** Platforms to publish this coupon to */
     platforms?: ConnectorPlatform[];
@@ -1376,6 +1443,8 @@ interface UpdateCouponDto {
     excludedProducts?: string[] | null;
     applicableCategories?: string[] | null;
     excludedCategories?: string[] | null;
+    /** Region IDs this coupon is valid in (PRD §24). Empty = all regions. */
+    regionIds?: string[];
     combinesWithOther?: boolean;
 }
 /**
@@ -2096,6 +2165,10 @@ interface TaxBreakdownItem {
     rate: number;
     /** Calculated tax amount for this rate */
     amount: number;
+    /** The rate's tax class id (null = Standard / no class). */
+    taxClassId?: string | null;
+    /** Slug of the rate's tax class for attribution (e.g. "reduced"; null = Standard). */
+    taxClassSlug?: string | null;
 }
 /**
  * Tax calculation result with itemized breakdown.
@@ -2412,6 +2485,12 @@ interface Checkout {
     shippingMethod?: ShippingRate | null;
     /** Currency code (e.g., "USD") */
     currency: string;
+    /**
+     * Region this checkout is associated with (multi-region commerce), or null.
+     * Recorded for reporting + provider scoping; currency follows the cart until
+     * FX price conversion lands.
+     */
+    regionId?: string | null;
     /** Subtotal as string - use parseFloat() */
     subtotal: string;
     /** Discount amount as string - use parseFloat() */
@@ -2492,6 +2571,13 @@ interface CreateCheckoutDto {
      * ```
      */
     selectedItemIds?: string[];
+    /**
+     * Region ID for multi-region commerce. The region must belong to the store.
+     * Recorded on the checkout for reporting + payment-provider scoping. Currency
+     * still follows the cart until FX price conversion lands. Omit for no region.
+     * Resolve a buyer's country to a region client-side with `detectRegion`.
+     */
+    regionId?: string;
 }
 interface SetCheckoutCustomerDto {
     email: string;
@@ -3475,6 +3561,12 @@ interface ShippingZone {
     regions?: Record<string, string[]> | null;
     /** Postal code patterns */
     postalCodes?: Record<string, string[]> | null;
+    /**
+     * Region restriction (PRD §25). Region IDs this zone is limited to. Empty =
+     * available for any region (default). Non-empty = the zone is only offered to
+     * checkouts whose region is in the list.
+     */
+    regionIds: string[];
     /** Zone priority (lower = higher priority) */
     priority: number;
     isActive: boolean;
@@ -3513,6 +3605,8 @@ interface CreateShippingZoneDto {
     countries: string[];
     regions?: Record<string, string[]>;
     postalCodes?: Record<string, string[]>;
+    /** Region restriction (PRD §25). Region IDs; empty/omitted = any region. */
+    regionIds?: string[];
     priority?: number;
     isActive?: boolean;
 }
@@ -3521,6 +3615,8 @@ interface UpdateShippingZoneDto {
     countries?: string[];
     regions?: Record<string, string[]> | null;
     postalCodes?: Record<string, string[]> | null;
+    /** Region restriction (PRD §25). Empty array = clear; omit = leave unchanged. */
+    regionIds?: string[];
     priority?: number;
     isActive?: boolean;
     platformSettings?: Record<string, unknown>;
@@ -3585,6 +3681,8 @@ interface TaxRate {
     isActive: boolean;
     /** Countries where this tax rate applies as exception */
     exceptionCountries: string[];
+    /** Tax class this rate applies to. null = Standard (applies to unclassed products). */
+    taxClassId?: string | null;
     createdAt: string;
     updatedAt: string;
 }
@@ -3597,6 +3695,8 @@ interface CreateTaxRateDto {
     taxType?: string;
     isCompound?: boolean;
     isInclusive?: boolean;
+    /** Tax class this rate applies to. Omit/null = Standard. */
+    taxClassId?: string;
     priority?: number;
     isActive?: boolean;
     exceptionCountries?: string[];
@@ -3613,6 +3713,114 @@ interface UpdateTaxRateDto {
     priority?: number;
     isActive?: boolean;
     exceptionCountries?: string[];
+    /** Tax class this rate applies to. null clears it (back to Standard). */
+    taxClassId?: string | null;
+}
+/**
+ * Tax class — product classification for differential tax rates (Standard /
+ * Reduced / Zero / Food / …). A TaxRate may target one class; a rate with
+ * taxClassId = null is the Standard fallback. See docs concepts/tax-classes.
+ */
+interface TaxClass {
+    id: string;
+    accountId: string;
+    storeId: string;
+    name: string;
+    slug: string;
+    description?: string | null;
+    /** The class auto-applied to products without an explicit class. */
+    isDefault: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A tax class as exposed on the public storefront (no internal fields). */
+interface PublicTaxClass {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string | null;
+    isDefault: boolean;
+}
+interface CreateTaxClassDto {
+    name: string;
+    /** kebab-case, unique per store */
+    slug: string;
+    description?: string;
+    isDefault?: boolean;
+}
+type UpdateTaxClassDto = Partial<CreateTaxClassDto>;
+/** Bulk-assign a class to products / variants / categories. */
+interface AssignTaxClassDto {
+    productIds?: string[];
+    variantIds?: string[];
+    categoryIds?: string[];
+}
+/** A payment provider (AppInstallation) enabled for a region. */
+interface RegionPaymentProvider {
+    id: string;
+    regionId: string;
+    appInstallationId: string;
+    isEnabled: boolean;
+    createdAt: string;
+}
+/**
+ * Region — binds a set of countries to a currency, tax-display mode, and the
+ * payment providers enabled there. See docs concepts/regions.
+ */
+interface Region {
+    id: string;
+    accountId: string;
+    storeId: string;
+    name: string;
+    slug: string;
+    /** ISO 4217 currency code. */
+    currency: string;
+    /** ISO 3166-1 alpha-2 country codes. */
+    countries: string[];
+    /** Prices shown tax-inclusive? */
+    taxInclusive: boolean;
+    automaticTaxes: boolean;
+    /** Fallback region for buyers whose country maps to no explicit region. */
+    isDefault: boolean;
+    isActive: boolean;
+    paymentProviders?: RegionPaymentProvider[];
+    createdAt: string;
+    updatedAt: string;
+}
+/** Public storefront shape — active regions only, no internal fields. */
+interface PublicRegion {
+    id: string;
+    name: string;
+    slug: string;
+    currency: string;
+    countries: string[];
+    taxInclusive: boolean;
+    isDefault: boolean;
+}
+/** A payment provider enabled for a region, as exposed on the public storefront. */
+interface PublicRegionPaymentProvider {
+    id: string;
+    appId: string;
+    name: string | null;
+}
+/** A single public region with its enabled payment providers (storefront detail). */
+interface PublicRegionDetail extends PublicRegion {
+    paymentProviders: PublicRegionPaymentProvider[];
+}
+interface CreateRegionDto {
+    name: string;
+    /** ISO 4217 */
+    currency: string;
+    /** ISO 3166-1 alpha-2 */
+    countries: string[];
+    taxInclusive?: boolean;
+    automaticTaxes?: boolean;
+    isDefault?: boolean;
+    /** AppInstallation IDs to enable as payment providers. */
+    paymentProviderIds?: string[];
+}
+interface UpdateRegionDto extends Partial<CreateRegionDto> {
+    isActive?: boolean;
 }
 /**
  * Metafield type for defining value structure
@@ -3938,6 +4146,15 @@ interface StoreMember {
     context: 'owner' | 'member';
     joinedAt: string | null;
     createdAt: string;
+    /**
+     * Vibe-coded sales channels this member is restricted to (by public
+     * `connectionId`, `vc_*` format). Empty array = unrestricted (all channels).
+     * Owners are never channel-scoped. Optional for backward compatibility.
+     */
+    salesChannels?: {
+        connectionId: string;
+        name: string;
+    }[];
 }
 /** Response for listing store team (members + invitations) */
 interface StoreTeamResponse {
@@ -3954,6 +4171,15 @@ interface StoreInvitation {
     inviterEmail?: string;
     expiresAt: string;
     createdAt: string;
+    /**
+     * Vibe-coded sales channels the invitee will be restricted to once they
+     * accept (by public `connectionId`, `vc_*` format). Empty array =
+     * unrestricted (all channels). Optional for backward compatibility.
+     */
+    salesChannels?: {
+        connectionId: string;
+        name: string;
+    }[];
 }
 /** Public invitation details (for invitation acceptance page) */
 interface StoreInvitationDetails {
@@ -3965,12 +4191,23 @@ interface StoreInvitationDetails {
     expiresAt: string;
     isExpired: boolean;
     isValid: boolean;
+    /** Channels this invite will scope the member to. Empty = unrestricted (all channels). */
+    salesChannels?: {
+        connectionId: string;
+        name: string;
+    }[];
 }
 /** DTO for inviting a store team member */
 interface InviteStoreMemberDto {
     email: string;
     /** Defaults to 'STAFF'. Cannot assign 'OWNER'. */
     role?: StoreRole;
+    /**
+     * Restrict the member to specific vibe-coded sales channels, identified by
+     * their public `connectionId` (`vc_*` format). Empty array or omitted =
+     * unrestricted (access to all channels).
+     */
+    salesChannelIds?: string[];
 }
 /** DTO for updating a store team member's role and/or permissions */
 interface UpdateStoreMemberDto {
@@ -3978,6 +4215,15 @@ interface UpdateStoreMemberDto {
     /** Custom permissions override role defaults when set */
     permissions?: StorePermission[];
 }
+/**
+ * DTO for replacing the full set of vibe-coded sales channels a member is
+ * restricted to. Channels are identified by their public `connectionId`
+ * (`vc_*` format). An empty array clears all restrictions (member becomes
+ * unrestricted).
+ */
+interface UpdateStoreMemberSalesChannelsDto {
+    salesChannelIds: string[];
+}
 /** A store accessible by the current user */
 interface UserStore {
     id: string;
@@ -5066,6 +5312,7 @@ declare class BrainerceClient {
      */
     getProduct(productId: string, options?: {
         locale?: string;
+        regionId?: string;
     }): Promise<Product>;
     /**
      * Get a single product by slug
@@ -5730,18 +5977,25 @@ declare class BrainerceClient {
      *
      * Apps mode requires `customers:read` and `payments:read` scopes.
      *
-     * @param storeId - The store this customer belongs to
+     * The store is derived from the SDK instance config (`storeId` passed to
+     * `new BrainerceClient(...)`); the SDK is instantiated per-store so callers
+     * MUST NOT supply it explicitly. A deprecated overload that accepts a
+     * leading `storeId` is kept for backwards-compat — it logs a warning and
+     * verifies the value matches the SDK config.
+     *
      * @param customerId - The customer's ID
      * @returns Array of saved payment methods
      *
      * @example
      * ```typescript
-     * const methods = await client.listSavedPaymentMethods(storeId, customerId);
+     * const methods = await client.listSavedPaymentMethods(customerId);
      * methods.forEach((m) => {
      *   console.log(`${m.brand} ending in ${m.last4} (expires ${m.expMonth}/${m.expYear})`);
      * });
      * ```
      */
+    listSavedPaymentMethods(customerId: string): Promise<SavedPaymentMethodSummary[]>;
+    /** @deprecated Pass only `customerId`; `storeId` is derived from the SDK config. */
     listSavedPaymentMethods(storeId: string, customerId: string): Promise<SavedPaymentMethodSummary[]>;
     /**
      * Remove a customer's saved payment method.
@@ -5753,18 +6007,45 @@ declare class BrainerceClient {
      *
      * Apps mode requires `customers:write` scope.
      *
-     * @param storeId - The store this customer belongs to
+     * The store is derived from the SDK instance config (`storeId` passed to
+     * `new BrainerceClient(...)`); the SDK is instantiated per-store so callers
+     * MUST NOT supply it explicitly. A deprecated overload that accepts a
+     * leading `storeId` is kept for backwards-compat — it logs a warning and
+     * verifies the value matches the SDK config.
+     *
      * @param customerId - The customer's ID
      * @param paymentMethodId - The saved payment method ID to remove
      *
      * @example
      * ```typescript
-     * await client.removeSavedPaymentMethod(storeId, customerId, methodId);
+     * await client.removeSavedPaymentMethod(customerId, methodId);
      * ```
      */
+    removeSavedPaymentMethod(customerId: string, paymentMethodId: string): Promise<{
+        success: true;
+    }>;
+    /** @deprecated Pass only `customerId` + `paymentMethodId`; `storeId` is derived from the SDK config. */
     removeSavedPaymentMethod(storeId: string, customerId: string, paymentMethodId: string): Promise<{
         success: true;
     }>;
+    /**
+     * Internal helper: normalize legacy `(storeId, customerId)` callers to the
+     * new `(customerId)` signature for `listSavedPaymentMethods`.
+     *
+     * Throws if the SDK instance has no `storeId` (these endpoints are
+     * storefront-scoped) and warns when the deprecated overload is detected.
+     */
+    private resolveSavedPaymentMethodsArgs;
+    /**
+     * Internal helper: normalize legacy `(storeId, customerId, paymentMethodId)`
+     * callers to the new `(customerId, paymentMethodId)` signature.
+     */
+    private resolveRemovePaymentMethodArgs;
+    /**
+     * One-shot deprecation warning per (method, mismatch?) — verifies the
+     * caller-supplied storeId matches the SDK config and warns regardless.
+     */
+    private warnDeprecatedStoreIdArg;
     /**
      * Login an existing customer (returns JWT token)
      * Works in vibe-coded, storefront, and admin mode
@@ -5796,9 +6077,18 @@ declare class BrainerceClient {
      * Request a password reset email for a customer
      * Works in vibe-coded, storefront, and admin mode
      *
+     * The `resetUrl` MUST be supplied explicitly in non-browser (SSR / Node)
+     * contexts — auto-deriving it from `window.location.origin` is impossible
+     * there and historically resulted in `undefined` being sent to the backend,
+     * which then bounced the email to a broken link. In browser contexts the
+     * origin is still used as a fallback but the SDK logs a one-time warning
+     * recommending an explicit value so server-rendered + proxied dashboards
+     * don't silently rely on the wrong host.
+     *
      * @param email - Customer email address
      * @param options - Optional settings
-     * @param options.resetUrl - Override the auto-detected reset URL (e.g. for BFF proxy callback)
+     * @param options.resetUrl - Reset URL the email links should point to.
+     *   Required outside the browser; recommended inside it.
      */
     forgotPassword(email: string, options?: {
         resetUrl?: string;
@@ -5899,12 +6189,14 @@ declare class BrainerceClient {
      * // Redirect user to Google
      * window.location.href = authorizationUrl;
      *
-     * // On /auth/callback page — the backend handles code exchange and redirects with params:
+     * // On /auth/callback page — exchange the one-time auth_code for the JWT.
+     * // (The backend used to put the JWT directly in the redirect URL; that path
+     * // is deprecated because URL params leak into browser history and logs.)
      * const params = new URLSearchParams(window.location.search);
-     * if (params.get('oauth_success') === 'true') {
-     *   const token = params.get('token');
-     *   client.setCustomerToken(token);
-     *   // Also available: customer_id, customer_email, is_new
+     * if (params.get('oauth_success') === 'true' && params.get('auth_code')) {
+     *   const result = await client.exchangeOAuthCode(params.get('auth_code')!);
+     *   client.setCustomerToken(result.token);
+     *   // result.customer, result.isNewCustomer, result.redirectUrl, ...
      * } else if (params.get('oauth_error')) {
      *   // Show error
      * }
@@ -5913,6 +6205,33 @@ declare class BrainerceClient {
     getOAuthAuthorizeUrl(provider: CustomerOAuthProvider, options?: {
         redirectUrl?: string;
     }): Promise<OAuthAuthorizeResponse>;
+    /**
+     * Exchange a one-time `auth_code` (returned in the post-OAuth redirect URL)
+     * for the customer JWT. Use this on the `/auth/callback` storefront page
+     * after reading `auth_code` from `window.location.search`.
+     *
+     * The code is single-use and expires 2 minutes after the OAuth callback
+     * issued it. A second call with the same code returns 400.
+     *
+     * This replaces the legacy flow where the JWT was placed directly in the
+     * redirect URL (`?token=...`). The legacy URL params still ship behind a
+     * server feature flag during the migration window, but they will be
+     * removed in the next major release — migrate now.
+     *
+     * @param authCode - The single-use code from the `?auth_code=` URL param.
+     *
+     * @example
+     * ```typescript
+     * const params = new URLSearchParams(window.location.search);
+     * const code = params.get('auth_code');
+     * if (code) {
+     *   const { token, customer, isNewCustomer, redirectUrl } =
+     *     await client.exchangeOAuthCode(code);
+     *   client.setCustomerToken(token);
+     * }
+     * ```
+     */
+    exchangeOAuthCode(authCode: string): Promise<OAuthCallbackResponse>;
     /**
      * Handle OAuth callback - exchange code for customer token (server-to-server)
      *
@@ -8263,6 +8582,71 @@ declare class BrainerceClient {
      * Requires Admin mode (apiKey)
      */
     deleteZoneShippingRate(zoneId: string, rateId: string): Promise<void>;
+    /** List the store's regions (paginated). */
+    getRegions(): Promise<PaginatedResponse<Region>>;
+    getRegion(regionId: string): Promise<Region>;
+    createRegion(data: CreateRegionDto): Promise<Region>;
+    updateRegion(regionId: string, data: UpdateRegionDto): Promise<Region>;
+    deleteRegion(regionId: string): Promise<void>;
+    setDefaultRegion(regionId: string): Promise<Region>;
+    /** Replace the region's enabled payment providers (AppInstallation IDs). */
+    updateRegionPaymentProviders(regionId: string, providerIds: string[]): Promise<Region>;
+    addRegionCountries(regionId: string, countries: string[]): Promise<Region>;
+    removeRegionCountry(regionId: string, countryCode: string): Promise<Region>;
+    /** Installed payment providers compatible with this region's countries. */
+    getRegionCompatibleProviders(regionId: string): Promise<Array<{
+        id: string;
+        appId: string;
+        name?: string | null;
+    }>>;
+    /**
+     * List the store's ACTIVE regions (public, no apiKey). Requires storeId mode.
+     * Returns only storefront-safe fields (no internal flags). Default region first.
+     */
+    getStoreRegions(): Promise<{
+        data: PublicRegion[];
+    }>;
+    /**
+     * Get one active public region plus its enabled payment providers (public).
+     * Requires storeId mode. Throws 404 if the region is inactive or not found.
+     */
+    getStoreRegion(regionId: string): Promise<PublicRegionDetail>;
+    /**
+     * Client-side region detection — no network call. Returns the region whose
+     * `countries` includes `country`, else the default region, else null.
+     */
+    detectRegion(country: string, regions: Array<Region | PublicRegion>): Region | PublicRegion | null;
+    /**
+     * List the store's tax classes (public, no apiKey — storeId mode). Storefront-
+     * safe fields only (id/name/slug/description/isDefault) for transparency UIs
+     * such as a "9% VAT" badge. Admin/api-key callers use getTaxClasses().
+     */
+    getStoreTaxClasses(): Promise<{
+        data: PublicTaxClass[];
+    }>;
+    /** List the store's tax classes. */
+    getTaxClasses(): Promise<{
+        data: TaxClass[];
+    }>;
+    /** Get a tax class with its dependent counts (products/variants/categories/rates). */
+    getTaxClass(id: string): Promise<TaxClass & {
+        dependents: {
+            productCount: number;
+            variantCount: number;
+            categoryCount: number;
+            taxRateCount: number;
+        };
+    }>;
+    createTaxClass(data: CreateTaxClassDto): Promise<TaxClass>;
+    updateTaxClass(id: string, data: UpdateTaxClassDto): Promise<TaxClass>;
+    deleteTaxClass(id: string): Promise<void>;
+    setDefaultTaxClass(id: string): Promise<TaxClass>;
+    /** Bulk-assign this tax class to products / variants / categories. */
+    assignTaxClass(id: string, data: AssignTaxClassDto): Promise<{
+        updated: number;
+    }>;
+    /** Merge this tax class into another, moving all FKs, then delete it. */
+    mergeTaxClasses(id: string, targetId: string): Promise<void>;
     /**
      * Get all tax rates for the store
      * Requires Admin mode (apiKey)
@@ -8535,6 +8919,9 @@ declare class BrainerceClient {
      * const invitation = await client.inviteStoreMember('store_id', {
      *   email: 'newmember@example.com',
      *   role: 'MANAGER', // 'MANAGER' | 'STAFF' | 'VIEWER'
+     *   // Optional: restrict to specific vibe-coded channels (connectionId, vc_*).
+     *   // Omit or pass [] for unrestricted access to all channels.
+     *   salesChannelIds: ['vc_abc123', 'vc_def456'],
      * });
      * ```
      */
@@ -8555,6 +8942,26 @@ declare class BrainerceClient {
      * ```
      */
     updateStoreMember(storeId: string, memberId: string, data: UpdateStoreMemberDto): Promise<StoreMember>;
+    /**
+     * Replace the set of vibe-coded sales channels a store member is restricted to.
+     * Channels are identified by their public `connectionId` (`vc_*` format). Pass
+     * an empty array to clear all restrictions (member becomes unrestricted).
+     * Requires Admin mode (apiKey) and MANAGE_TEAM permission
+     *
+     * @example
+     * ```typescript
+     * // Restrict to two vibe-coded channels
+     * await client.updateStoreMemberSalesChannels('store_id', 'member_id', {
+     *   salesChannelIds: ['vc_abc123', 'vc_def456'],
+     * });
+     *
+     * // Clear all restrictions (unrestricted access)
+     * await client.updateStoreMemberSalesChannels('store_id', 'member_id', {
+     *   salesChannelIds: [],
+     * });
+     * ```
+     */
+    updateStoreMemberSalesChannels(storeId: string, memberId: string, data: UpdateStoreMemberSalesChannelsDto): Promise<StoreMember>;
     /**
      * Remove a member from a store team
      * Requires Admin mode (apiKey) and MANAGE_TEAM permission