brainerce 1.55.0 → 1.56.0

package/README.md

@@ -292,6 +292,9 @@ The SDK exports these utility functions for common UI tasks:
 | `buildBreadcrumbJsonLd(items)`                 | schema.org BreadcrumbList                                                                    | See SEO section                                        |
 | `jsonLdScriptProps(data)`                      | XSS-safe `<script type="application/ld+json">` props                                         | `<script {...jsonLdScriptProps(data)} />`              |
 | `getBlogSitemapEntries(client, opts)`          | Paginate published posts into sitemap entries                                                | See SEO section                                        |
+| `getProductSitemapEntries(client, opts)`       | ALL published products into sitemap entries (no 100-item clamp)                              | See SEO section                                        |
+| `getCategorySitemapEntries(client, opts)`      | Category tree into sitemap entries                                                           | See SEO section                                        |
+| `client.resolveSlugRedirect(type, slug)`       | Renamed slug → current slug (301 support in not-found paths)                                 | See SEO section                                        |
 
 ```typescript
 import {
@@ -481,9 +484,9 @@ return <div dangerouslySetInnerHTML={{ __html: safeHtml }} className="prose" />;
 
 **SEO Autopilot writes here too**: the platform's SEO Autopilot publishes AI-written articles into this same blog automatically — render whatever `getPosts()` returns, and see the SEO section below for the required discoverability pieces.
 
-### SEO — JSON-LD builders, sitemap helper, IndexNow key, llms.txt
+### SEO — JSON-LD builders, sitemap helpers, IndexNow key, llms.txt + agents.md
 
-The SDK ships schema.org builders that encode Google's structured-data rules (aggregateRating gated on `reviewCount > 0`, AggregateOffer for VARIABLE products, XSS-safe serialization). `buildProductJsonLd`'s Offer also always includes `itemCondition` (hardcoded `NewCondition` — first-party new-goods catalog), `priceValidUntil` when the product has an active sale-price window (`salePriceEndsAt`), and `shippingDetails` when you pass `shipping` (real flat-rate/free zones from `storeInfo.shipping` — omitted entirely, never fabricated, if you don't pass it). Prefer these builders over hand-rolled JSON-LD:
+The SDK ships schema.org builders that encode Google's structured-data rules (aggregateRating gated on `reviewCount > 0` with explicit `bestRating`/`worstRating`, AggregateOffer with `offerCount` for VARIABLE products, XSS-safe serialization, and the full availability mapping — `InStock` from the backend's pre-computed `inventory.inStock`, `BackOrder` for purchasable-while-out-of-stock products, `OutOfStock` otherwise). `buildProductJsonLd`'s Offer also always includes `itemCondition` (hardcoded `NewCondition` — first-party new-goods catalog), `priceValidUntil` when the product has an active sale-price window (`salePriceEndsAt`), and `shippingDetails` when you pass `shipping` (real flat-rate/free zones from `storeInfo.shipping` — omitted entirely, never fabricated, if you don't pass it). Prefer these builders over hand-rolled JSON-LD:
 
 ```tsx
 import {
@@ -511,23 +514,43 @@ import {
 }))} />
 ```
 
-**Blog entries in sitemap.xml** (required — autopilot articles missing from the sitemap never get crawled):
+**Product + category + blog entries in sitemap.xml** (required). ⚠️ Products **must** use `getProductSitemapEntries` — the public listing API clamps `limit` to 100, so a naive `getProducts({ limit: 1000 })` sitemap silently truncates at 100 products. The helper uses a dedicated lightweight endpoint (slug + updatedAt + localeSlugs, up to 5000 in one call) and falls back to pagination on older backends:
 
 ```ts
 // app/sitemap.ts
-import { getBlogSitemapEntries } from 'brainerce';
+import {
+  getProductSitemapEntries,
+  getCategorySitemapEntries,
+  getBlogSitemapEntries,
+} from 'brainerce';
 
-const blogPages = await getBlogSitemapEntries(client, {
+const productPages = await getProductSitemapEntries(client, {
   siteUrl: baseUrl,
   locales: supportedLocales, // optional (multi-locale stores)
   defaultLocale,
 }).catch(() => []);
-return [...staticPages, ...productPages, ...blogPages];
+const categoryPages = await getCategorySitemapEntries(client, {
+  siteUrl: baseUrl,
+  locales: supportedLocales,
+  defaultLocale,
+}).catch(() => []);
+const blogPages = await getBlogSitemapEntries(client, {
+  siteUrl: baseUrl,
+  locales: supportedLocales,
+  defaultLocale,
+}).catch(() => []);
+return [...staticPages, ...productPages, ...categoryPages, ...blogPages];
 ```
 
+**robots.txt** (required): allow the AI search crawlers by name (`OAI-SearchBot`, `ChatGPT-User`, `Claude-SearchBot`, `Claude-User`, `PerplexityBot`, `Perplexity-User`, `Bingbot`, `Applebot`, `Amazonbot`) — they power ChatGPT/Claude/Perplexity/Copilot shopping answers and respect robots.txt. Keep `/api/`, `/auth/`, `/checkout/`, `/account/` disallowed.
+
 **IndexNow key file** (required): the platform pings IndexNow when posts publish; search engines verify by fetching `GET /indexnow-key.txt`. Serve `getStoreInfo().seo.indexNowKey` as `text/plain`, 404 while `null`. The key is **not a secret** (public by protocol design).
 
-**llms.txt** (recommended): a plain-text site summary (store name, key pages, recent article links) for AI answer engines at `GET /llms.txt`.
+**llms.txt + agents.md** (required): `/llms.txt` is a plain-text site summary (store name, categories, key pages, recent article links) for AI answer engines; `/agents.md` is the agent-facing guide (machine surfaces, key URLs, currency, how buying works). Multi-locale stores: keep these dotted routes (plus `indexnow-key.txt`) at the app ROOT — locale middleware matchers skip dotted paths, so a locale-nested copy serves the homepage HTML instead.
+
+**Site verification** : when `getStoreInfo().seo.googleSiteVerification` is set, render `<meta name="google-site-verification" content={token} />` in the root layout head (Search Console verification + Merchant Center website claim).
+
+**Renamed slugs 301 instead of 404** (required): the platform records every product/blog slug rename. In the not-found path of the product and blog pages call `client.resolveSlugRedirect('product' | 'blog', slug)` — on a hit, `permanentRedirect()` to the returned `currentSlug`; `null` means a genuine 404 (never throws, safe to call unconditionally). Rename chains collapse to one hop.
 
 ---
 
@@ -4718,6 +4741,46 @@ target vibe-coded connection both belong to the same account. Cross-account
 calls fail with `404 Not Found` (the connection ID is treated as if it doesn't
 exist for that account).
 
+#### Customers and sales channels
+
+Customers use the same publish/unpublish shape, with one important difference:
+**you almost never have to call it.** A customer is attached to a channel
+automatically the moment they are seen on it — when they register, sign in
+(including via OAuth), or complete a checkout there.
+
+There is one customer record per store, shared by every channel
+(`@@unique(storeId, email)`), so the same person shopping two of your
+storefronts stays one customer with two channel rows — never a duplicate.
+
+```typescript
+// Attach / detach by hand — for migrations and corrections only
+await client.publishCustomerToSalesChannel('cust_id', 'vc_conn_id');
+await client.unpublishCustomerFromSalesChannel('cust_id', 'vc_conn_id');
+
+// Read both facts off any customer get/by-email response
+const customer = await client.getCustomer('cust_id');
+customer.channelPublishes;
+// [{ salesChannel: { id, name, connectionId }, firstSeenAt, lastSeenAt }, ...]
+customer.acquisitionSalesChannel; // first-touch channel, or null if unknown
+
+// Set / correct the first-touch channel ('' clears it back to unknown)
+await client.updateCustomer('cust_id', { acquisitionSalesChannelId: 'vc_conn_id' });
+```
+
+Two things to keep straight:
+
+- **`channelPublishes`** = every channel they are active in. Grows over time.
+- **`acquisitionSalesChannel`** = the FIRST channel they ever arrived through.
+  Written once and then never touched by the platform again, so it stays a
+  reliable answer to "which storefront is bringing me customers". `null` is a
+  normal value: customers created through the API, imported from a file, or
+  arriving via a `storeId`-mode storefront have no observed origin.
+
+`unpublishCustomerFromSalesChannel` is a **correction, not a block.** It does
+not prevent that person from buying on that storefront, and the row comes back
+the next time they sign in or order there. There is no API to bar a customer
+from a sales channel.
+
 ### Store Team Management
 
 Each store has its own team with roles (`OWNER`, `MANAGER`, `STAFF`, `VIEWER`) and granular permissions.

package/dist/index.d.mts

@@ -229,14 +229,24 @@ interface StoreInfo {
     /** Multi-language / i18n settings */
     i18n?: I18nSettings;
     /**
-     * SEO Autopilot fields (sales-channel mode only).
+     * SEO fields (sales-channel mode only).
+     *
      * `indexNowKey`: serve this verbatim at `GET /indexnow-key.txt`
      * (`text/plain`) so the platform can ping IndexNow when blog posts publish.
      * Not a secret — the key file is public by protocol design. `null` until
      * the store's SEO Autopilot generates one; return 404 while null.
+     *
+     * `googleSiteVerification`: the merchant's Google site-verification token
+     * (the `content` value of the `google-site-verification` meta tag), set in
+     * the dashboard under the sales channel's settings. When present, render
+     * `<meta name="google-site-verification" content={token} />` in the root
+     * layout `<head>` — it is what lets the merchant verify the storefront in
+     * Google Search Console and claim it in Merchant Center. Public by design
+     * (the token appears in page source on every verified site).
      */
     seo?: {
         indexNowKey: string | null;
+        googleSiteVerification?: string | null;
     };
     /**
      * Real merchant-configured shipping rates (sales-channel mode only) —
@@ -1998,9 +2008,40 @@ interface Customer {
         externalId: string;
     }>;
     addresses: CustomerAddress[];
+    /**
+     * FIRST-TOUCH sales channel — the storefront this customer originally arrived
+     * through. `null`/absent is a normal state, not an error: customers created in
+     * the dashboard, imported from a file, arriving via a `storeId`-mode
+     * storefront, or predating channel attribution have no value here.
+     *
+     * Different from `platformConnections` (their ids on Shopify/WooCommerce) and
+     * from `channelPublishes` below (where they are active now).
+     */
+    acquisitionSalesChannel?: CustomerSalesChannelRef | null;
+    /**
+     * Every sales channel this customer is active in — one entry per channel they
+     * registered, signed in, checked out or ordered on, plus any a merchant
+     * attached by hand. A customer belongs to exactly one store but can be active
+     * in any number of that store's channels. `[]` = none known yet.
+     */
+    channelPublishes?: CustomerChannelPublish[];
     createdAt: string;
     updatedAt: string;
 }
+interface CustomerSalesChannelRef {
+    /** Internal SalesChannel id (cuid). */
+    id: string;
+    name: string;
+    /** Public `vc_*` connection id — the one your storefront initialises with. */
+    connectionId: string;
+}
+interface CustomerChannelPublish {
+    salesChannel: CustomerSalesChannelRef;
+    /** First time this customer was seen on this channel. */
+    firstSeenAt: string;
+    /** Most recent time this customer was seen on this channel. */
+    lastSeenAt: string;
+}
 /**
  * Display-only summary of a vaulted payment method.
  *
@@ -2091,6 +2132,14 @@ interface CreateCustomerDto {
     tags?: string[];
     /** Free-form merchant-set segment (e.g. "wholesale", "vip"), max 50 chars. */
     role?: string;
+    /**
+     * Explicit FIRST-TOUCH channel (internal SalesChannel id or public `vc_*`).
+     * Creating a customer through the API is not itself a channel sighting, so
+     * omitting this leaves the customer's origin unknown — set it only when you
+     * actually know where the person came from (a migration, a phone order for a
+     * specific storefront). Which channels they SHOP on is separate.
+     */
+    acquisitionSalesChannelId?: string;
     metadata?: Record<string, unknown>;
 }
 interface UpdateCustomerDto {
@@ -2102,6 +2151,15 @@ interface UpdateCustomerDto {
     tags?: string[];
     /** Free-form merchant-set segment. Pass '' to clear it. */
     role?: string;
+    /**
+     * Override the FIRST-TOUCH channel. Normally stamped automatically when the
+     * customer registers, signs in with OAuth, or checks out — this is the
+     * correction path for customers created through the API/dashboard or imported
+     * from a file, where no channel was ever observed. Accepts an internal
+     * SalesChannel id or a public `vc_*` connectionId; `''` clears it back to
+     * unknown. Does NOT change which channels they are active in.
+     */
+    acquisitionSalesChannelId?: string;
     metadata?: Record<string, unknown>;
 }
 interface CustomerQueryParams {
@@ -2111,6 +2169,17 @@ interface CustomerQueryParams {
     hasAccount?: boolean;
     /** Filter by merchant-set customer role/segment (exact match, case-insensitive). */
     role?: string;
+    /**
+     * Only customers ACTIVE IN this channel (they registered, signed in, checked
+     * out or ordered there, or a merchant attached them). Accepts an internal
+     * SalesChannel id or a public `vc_*` connectionId.
+     */
+    salesChannelId?: string;
+    /**
+     * Only customers whose FIRST TOUCH was this channel, regardless of where they
+     * have been active since. Customers with no attribution match nothing here.
+     */
+    acquisitionSalesChannelId?: string;
     sortBy?: 'createdAt' | 'email' | 'firstName' | 'lastName' | 'lastOrderAt';
     sortOrder?: 'asc' | 'desc';
 }
@@ -6817,6 +6886,41 @@ declare class BrainerceClient {
      * ```
      */
     getProducts(params?: ProductQueryParams): Promise<PaginatedResponse<Product>>;
+    /**
+     * Lightweight product rows for sitemap generation: `slug`, `updatedAt`, and
+     * per-locale `localeSlugs` only — up to `limit` (max 5000) in ONE request,
+     * with none of the 100-per-page clamp the full listing applies.
+     *
+     * Sales-channel (`salesChannelId`) mode only; other modes throw so
+     * {@link getProductSitemapEntries} (sitemap.ts) can catch and fall back to
+     * paginating `getProducts`. Prefer that helper over calling this directly.
+     */
+    getSitemapProducts(limit?: number): Promise<Array<{
+        id: string;
+        slug: string | null;
+        updatedAt: string;
+        localeSlugs: Record<string, string> | null;
+    }>>;
+    /**
+     * Resolve an old (renamed) slug to the entity's CURRENT slug, so the
+     * storefront can issue a permanent (301/308) redirect instead of a 404.
+     *
+     * Call this in the catch/not-found path of a product or blog page:
+     * the platform records every slug rename, so a URL that stopped matching
+     * usually has a redirect. Returns `null` when there is no redirect (real
+     * 404) or outside sales-channel mode — always fall through to notFound().
+     *
+     * @example
+     * ```typescript
+     * // app/products/[slug]/page.tsx — in the catch path:
+     * const redirect = await client.resolveSlugRedirect('product', slug);
+     * if (redirect) permanentRedirect(`/products/${redirect.currentSlug}`);
+     * notFound();
+     * ```
+     */
+    resolveSlugRedirect(entityType: 'product' | 'blog', slug: string): Promise<{
+        currentSlug: string;
+    } | null>;
     /**
      * Get a single product by ID
      * Works in vibe-coded, storefront (public), and admin mode
@@ -10918,6 +11022,33 @@ declare class BrainerceClient {
     unpublishProductFromSalesChannel(productId: string, salesChannelId: string): Promise<{
         success: boolean;
     }>;
+    /**
+     * Attach a customer to a sales channel (admin mode) — marks them as active in
+     * that storefront. Accepts the sales-channel record ID or its public `vc_*`
+     * connection ID.
+     *
+     * Rarely needed: the platform records a channel by itself whenever the
+     * customer registers, signs in or checks out on it. Use this for migrations
+     * from another system and for fixing up records you created yourself. A
+     * customer belongs to one store but can be active in any number of its
+     * channels, so calling this for several channels is normal and expected.
+     *
+     * This does not change where the customer CAME FROM — for that, pass
+     * `acquisitionSalesChannelId` to {@link updateCustomer}.
+     */
+    publishCustomerToSalesChannel(customerId: string, salesChannelId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Detach a customer from a sales channel (admin mode).
+     *
+     * A correction, NOT a block — it does not stop that person from buying on
+     * that storefront, and the channel is recorded again the next time they sign
+     * in or order there. There is no way to bar a customer from a channel.
+     */
+    unpublishCustomerFromSalesChannel(customerId: string, salesChannelId: string): Promise<{
+        success: boolean;
+    }>;
     /**
      * Publish a coupon to a sales channel (admin mode) — makes it redeemable on
      * that vibe-coded storefront. Accepts the sales-channel record ID or its
@@ -11725,6 +11856,34 @@ interface BlogSitemapOptions {
  * only returns PUBLISHED posts, so no status filtering is needed.
  */
 declare function getBlogSitemapEntries(client: BrainerceClient, opts: BlogSitemapOptions): Promise<SitemapEntry[]>;
+interface ProductSitemapOptions {
+    /** Canonical site origin, e.g. "https://shop.com" (no trailing slash). */
+    siteUrl: string;
+    /** Product route prefix. Default '/products'. */
+    basePath?: string;
+    /**
+     * Locales to emit locale-prefixed entries for. The default locale is emitted
+     * unprefixed; every other locale as `/{locale}{basePath}/{localeSlug}`,
+     * using the product's per-locale slug (`localeSlugs`) when one exists.
+     */
+    locales?: string[];
+    defaultLocale?: string;
+    /** Page size for the pagination fallback (max 100). Default 100. */
+    pageSize?: number;
+    /** Safety cap on total products. Default 5000. */
+    maxEntries?: number;
+}
+/**
+ * Every published product as sitemap entries — the REQUIRED way to build the
+ * products section of `app/sitemap.ts`.
+ *
+ * Do NOT call `getProducts({ limit: 1000 })` for sitemaps: the public API
+ * clamps `limit` to 100, so any store with more than 100 products silently
+ * ships a truncated sitemap. This helper uses the dedicated lightweight
+ * sitemap endpoint (slug + updatedAt only, up to 5000 in one call) and falls
+ * back to paginating the full listing on older backends.
+ */
+declare function getProductSitemapEntries(client: BrainerceClient, opts: ProductSitemapOptions): Promise<SitemapEntry[]>;
 interface CategorySitemapOptions {
     /** Canonical site origin, e.g. "https://shop.com" (no trailing slash). */
     siteUrl: string;
@@ -11742,4 +11901,4 @@ interface CategorySitemapOptions {
  */
 declare function getCategorySitemapEntries(client: BrainerceClient, opts: CategorySitemapOptions): Promise<SitemapEntry[]>;
 
-export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BlogPost, type BlogPostListParams, type BlogPostListResponse, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type BusinessHoursWindow, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryDetail, type CategoryNode, type CategorySitemapOptions, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DateAvailabilityConstraints, type DateFieldParseResult, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type JsonLdOptions, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyStatus, type LoyaltyTierSummary, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldFilter, type MetafieldFilterValue, type MetafieldFiltersResponse, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type ParsedDateFieldValue, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type StoreTracking, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type TrackingEventItem, type TrackingEventName, type TrackingEventPayload, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, buildArticleJsonLd, buildBreadcrumbJsonLd, buildCollectionPageJsonLd, buildOrganizationJsonLd, buildProductJsonLd, buildWebsiteJsonLd, computeAvailableSlots, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getBusinessHoursForDate, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, parseWebhookEvent, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };
+export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BlogPost, type BlogPostListParams, type BlogPostListResponse, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type BusinessHoursWindow, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryDetail, type CategoryNode, type CategorySitemapOptions, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DateAvailabilityConstraints, type DateFieldParseResult, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type JsonLdOptions, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyStatus, type LoyaltyTierSummary, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldFilter, type MetafieldFilterValue, type MetafieldFiltersResponse, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type ParsedDateFieldValue, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSitemapOptions, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type StoreTracking, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type TrackingEventItem, type TrackingEventName, type TrackingEventPayload, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, buildArticleJsonLd, buildBreadcrumbJsonLd, buildCollectionPageJsonLd, buildOrganizationJsonLd, buildProductJsonLd, buildWebsiteJsonLd, computeAvailableSlots, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getBusinessHoursForDate, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSitemapEntries, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, parseWebhookEvent, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };

package/dist/index.d.ts

@@ -229,14 +229,24 @@ interface StoreInfo {
     /** Multi-language / i18n settings */
     i18n?: I18nSettings;
     /**
-     * SEO Autopilot fields (sales-channel mode only).
+     * SEO fields (sales-channel mode only).
+     *
      * `indexNowKey`: serve this verbatim at `GET /indexnow-key.txt`
      * (`text/plain`) so the platform can ping IndexNow when blog posts publish.
      * Not a secret — the key file is public by protocol design. `null` until
      * the store's SEO Autopilot generates one; return 404 while null.
+     *
+     * `googleSiteVerification`: the merchant's Google site-verification token
+     * (the `content` value of the `google-site-verification` meta tag), set in
+     * the dashboard under the sales channel's settings. When present, render
+     * `<meta name="google-site-verification" content={token} />` in the root
+     * layout `<head>` — it is what lets the merchant verify the storefront in
+     * Google Search Console and claim it in Merchant Center. Public by design
+     * (the token appears in page source on every verified site).
      */
     seo?: {
         indexNowKey: string | null;
+        googleSiteVerification?: string | null;
     };
     /**
      * Real merchant-configured shipping rates (sales-channel mode only) —
@@ -1998,9 +2008,40 @@ interface Customer {
         externalId: string;
     }>;
     addresses: CustomerAddress[];
+    /**
+     * FIRST-TOUCH sales channel — the storefront this customer originally arrived
+     * through. `null`/absent is a normal state, not an error: customers created in
+     * the dashboard, imported from a file, arriving via a `storeId`-mode
+     * storefront, or predating channel attribution have no value here.
+     *
+     * Different from `platformConnections` (their ids on Shopify/WooCommerce) and
+     * from `channelPublishes` below (where they are active now).
+     */
+    acquisitionSalesChannel?: CustomerSalesChannelRef | null;
+    /**
+     * Every sales channel this customer is active in — one entry per channel they
+     * registered, signed in, checked out or ordered on, plus any a merchant
+     * attached by hand. A customer belongs to exactly one store but can be active
+     * in any number of that store's channels. `[]` = none known yet.
+     */
+    channelPublishes?: CustomerChannelPublish[];
     createdAt: string;
     updatedAt: string;
 }
+interface CustomerSalesChannelRef {
+    /** Internal SalesChannel id (cuid). */
+    id: string;
+    name: string;
+    /** Public `vc_*` connection id — the one your storefront initialises with. */
+    connectionId: string;
+}
+interface CustomerChannelPublish {
+    salesChannel: CustomerSalesChannelRef;
+    /** First time this customer was seen on this channel. */
+    firstSeenAt: string;
+    /** Most recent time this customer was seen on this channel. */
+    lastSeenAt: string;
+}
 /**
  * Display-only summary of a vaulted payment method.
  *
@@ -2091,6 +2132,14 @@ interface CreateCustomerDto {
     tags?: string[];
     /** Free-form merchant-set segment (e.g. "wholesale", "vip"), max 50 chars. */
     role?: string;
+    /**
+     * Explicit FIRST-TOUCH channel (internal SalesChannel id or public `vc_*`).
+     * Creating a customer through the API is not itself a channel sighting, so
+     * omitting this leaves the customer's origin unknown — set it only when you
+     * actually know where the person came from (a migration, a phone order for a
+     * specific storefront). Which channels they SHOP on is separate.
+     */
+    acquisitionSalesChannelId?: string;
     metadata?: Record<string, unknown>;
 }
 interface UpdateCustomerDto {
@@ -2102,6 +2151,15 @@ interface UpdateCustomerDto {
     tags?: string[];
     /** Free-form merchant-set segment. Pass '' to clear it. */
     role?: string;
+    /**
+     * Override the FIRST-TOUCH channel. Normally stamped automatically when the
+     * customer registers, signs in with OAuth, or checks out — this is the
+     * correction path for customers created through the API/dashboard or imported
+     * from a file, where no channel was ever observed. Accepts an internal
+     * SalesChannel id or a public `vc_*` connectionId; `''` clears it back to
+     * unknown. Does NOT change which channels they are active in.
+     */
+    acquisitionSalesChannelId?: string;
     metadata?: Record<string, unknown>;
 }
 interface CustomerQueryParams {
@@ -2111,6 +2169,17 @@ interface CustomerQueryParams {
     hasAccount?: boolean;
     /** Filter by merchant-set customer role/segment (exact match, case-insensitive). */
     role?: string;
+    /**
+     * Only customers ACTIVE IN this channel (they registered, signed in, checked
+     * out or ordered there, or a merchant attached them). Accepts an internal
+     * SalesChannel id or a public `vc_*` connectionId.
+     */
+    salesChannelId?: string;
+    /**
+     * Only customers whose FIRST TOUCH was this channel, regardless of where they
+     * have been active since. Customers with no attribution match nothing here.
+     */
+    acquisitionSalesChannelId?: string;
     sortBy?: 'createdAt' | 'email' | 'firstName' | 'lastName' | 'lastOrderAt';
     sortOrder?: 'asc' | 'desc';
 }
@@ -6817,6 +6886,41 @@ declare class BrainerceClient {
      * ```
      */
     getProducts(params?: ProductQueryParams): Promise<PaginatedResponse<Product>>;
+    /**
+     * Lightweight product rows for sitemap generation: `slug`, `updatedAt`, and
+     * per-locale `localeSlugs` only — up to `limit` (max 5000) in ONE request,
+     * with none of the 100-per-page clamp the full listing applies.
+     *
+     * Sales-channel (`salesChannelId`) mode only; other modes throw so
+     * {@link getProductSitemapEntries} (sitemap.ts) can catch and fall back to
+     * paginating `getProducts`. Prefer that helper over calling this directly.
+     */
+    getSitemapProducts(limit?: number): Promise<Array<{
+        id: string;
+        slug: string | null;
+        updatedAt: string;
+        localeSlugs: Record<string, string> | null;
+    }>>;
+    /**
+     * Resolve an old (renamed) slug to the entity's CURRENT slug, so the
+     * storefront can issue a permanent (301/308) redirect instead of a 404.
+     *
+     * Call this in the catch/not-found path of a product or blog page:
+     * the platform records every slug rename, so a URL that stopped matching
+     * usually has a redirect. Returns `null` when there is no redirect (real
+     * 404) or outside sales-channel mode — always fall through to notFound().
+     *
+     * @example
+     * ```typescript
+     * // app/products/[slug]/page.tsx — in the catch path:
+     * const redirect = await client.resolveSlugRedirect('product', slug);
+     * if (redirect) permanentRedirect(`/products/${redirect.currentSlug}`);
+     * notFound();
+     * ```
+     */
+    resolveSlugRedirect(entityType: 'product' | 'blog', slug: string): Promise<{
+        currentSlug: string;
+    } | null>;
     /**
      * Get a single product by ID
      * Works in vibe-coded, storefront (public), and admin mode
@@ -10918,6 +11022,33 @@ declare class BrainerceClient {
     unpublishProductFromSalesChannel(productId: string, salesChannelId: string): Promise<{
         success: boolean;
     }>;
+    /**
+     * Attach a customer to a sales channel (admin mode) — marks them as active in
+     * that storefront. Accepts the sales-channel record ID or its public `vc_*`
+     * connection ID.
+     *
+     * Rarely needed: the platform records a channel by itself whenever the
+     * customer registers, signs in or checks out on it. Use this for migrations
+     * from another system and for fixing up records you created yourself. A
+     * customer belongs to one store but can be active in any number of its
+     * channels, so calling this for several channels is normal and expected.
+     *
+     * This does not change where the customer CAME FROM — for that, pass
+     * `acquisitionSalesChannelId` to {@link updateCustomer}.
+     */
+    publishCustomerToSalesChannel(customerId: string, salesChannelId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Detach a customer from a sales channel (admin mode).
+     *
+     * A correction, NOT a block — it does not stop that person from buying on
+     * that storefront, and the channel is recorded again the next time they sign
+     * in or order there. There is no way to bar a customer from a channel.
+     */
+    unpublishCustomerFromSalesChannel(customerId: string, salesChannelId: string): Promise<{
+        success: boolean;
+    }>;
     /**
      * Publish a coupon to a sales channel (admin mode) — makes it redeemable on
      * that vibe-coded storefront. Accepts the sales-channel record ID or its
@@ -11725,6 +11856,34 @@ interface BlogSitemapOptions {
  * only returns PUBLISHED posts, so no status filtering is needed.
  */
 declare function getBlogSitemapEntries(client: BrainerceClient, opts: BlogSitemapOptions): Promise<SitemapEntry[]>;
+interface ProductSitemapOptions {
+    /** Canonical site origin, e.g. "https://shop.com" (no trailing slash). */
+    siteUrl: string;
+    /** Product route prefix. Default '/products'. */
+    basePath?: string;
+    /**
+     * Locales to emit locale-prefixed entries for. The default locale is emitted
+     * unprefixed; every other locale as `/{locale}{basePath}/{localeSlug}`,
+     * using the product's per-locale slug (`localeSlugs`) when one exists.
+     */
+    locales?: string[];
+    defaultLocale?: string;
+    /** Page size for the pagination fallback (max 100). Default 100. */
+    pageSize?: number;
+    /** Safety cap on total products. Default 5000. */
+    maxEntries?: number;
+}
+/**
+ * Every published product as sitemap entries — the REQUIRED way to build the
+ * products section of `app/sitemap.ts`.
+ *
+ * Do NOT call `getProducts({ limit: 1000 })` for sitemaps: the public API
+ * clamps `limit` to 100, so any store with more than 100 products silently
+ * ships a truncated sitemap. This helper uses the dedicated lightweight
+ * sitemap endpoint (slug + updatedAt only, up to 5000 in one call) and falls
+ * back to paginating the full listing on older backends.
+ */
+declare function getProductSitemapEntries(client: BrainerceClient, opts: ProductSitemapOptions): Promise<SitemapEntry[]>;
 interface CategorySitemapOptions {
     /** Canonical site origin, e.g. "https://shop.com" (no trailing slash). */
     siteUrl: string;
@@ -11742,4 +11901,4 @@ interface CategorySitemapOptions {
  */
 declare function getCategorySitemapEntries(client: BrainerceClient, opts: CategorySitemapOptions): Promise<SitemapEntry[]>;
 
-export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BlogPost, type BlogPostListParams, type BlogPostListResponse, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type BusinessHoursWindow, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryDetail, type CategoryNode, type CategorySitemapOptions, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DateAvailabilityConstraints, type DateFieldParseResult, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type JsonLdOptions, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyStatus, type LoyaltyTierSummary, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldFilter, type MetafieldFilterValue, type MetafieldFiltersResponse, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type ParsedDateFieldValue, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type StoreTracking, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type TrackingEventItem, type TrackingEventName, type TrackingEventPayload, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, buildArticleJsonLd, buildBreadcrumbJsonLd, buildCollectionPageJsonLd, buildOrganizationJsonLd, buildProductJsonLd, buildWebsiteJsonLd, computeAvailableSlots, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getBusinessHoursForDate, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, parseWebhookEvent, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };
+export { type AddToCartDto, type AddressDetailsResult, type AddressSuggestion, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BlogPost, type BlogPostListParams, type BlogPostListResponse, type BlogSitemapOptions, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type BusinessHoursWindow, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryDetail, type CategoryNode, type CategorySitemapOptions, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DateAvailabilityConstraints, type DateFieldParseResult, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type JsonLdOptions, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type LoyaltyNextTierSummary, type LoyaltyReward, type LoyaltyStatus, type LoyaltyTierSummary, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldFilter, type MetafieldFilterValue, type MetafieldFiltersResponse, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type ParsedDateFieldValue, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSitemapOptions, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type RedeemRewardResult, type ReferralInfo, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingSummaryEntry, type ShippingZone, type ShippingZoneQueryParams, type SitemapEntry, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type StoreTracking, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type TrackingEventItem, type TrackingEventName, type TrackingEventPayload, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, buildArticleJsonLd, buildBreadcrumbJsonLd, buildCollectionPageJsonLd, buildOrganizationJsonLd, buildProductJsonLd, buildWebsiteJsonLd, computeAvailableSlots, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getBusinessHoursForDate, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSitemapEntries, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCalendarDateAllowed, isCouponApplicableToProduct, isDateValueAllowed, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseDateFieldValue, parseWebhookEvent, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };

package/dist/index.js

@@ -63,6 +63,7 @@ __export(index_exports, {
   getProductMetafieldsByType: () => getProductMetafieldsByType,
   getProductPrice: () => getProductPrice,
   getProductPriceInfo: () => getProductPriceInfo,
+  getProductSitemapEntries: () => getProductSitemapEntries,
   getProductSwatches: () => getProductSwatches,
   getStockStatus: () => getStockStatus,
   getVariantOptions: () => getVariantOptions,
@@ -1653,6 +1654,50 @@ var _BrainerceClient = class _BrainerceClient {
       queryParamsWithRegion
     );
   }
+  /**
+   * Lightweight product rows for sitemap generation: `slug`, `updatedAt`, and
+   * per-locale `localeSlugs` only — up to `limit` (max 5000) in ONE request,
+   * with none of the 100-per-page clamp the full listing applies.
+   *
+   * Sales-channel (`salesChannelId`) mode only; other modes throw so
+   * {@link getProductSitemapEntries} (sitemap.ts) can catch and fall back to
+   * paginating `getProducts`. Prefer that helper over calling this directly.
+   */
+  async getSitemapProducts(limit = 5e3) {
+    if (!this.isVibeCodedMode()) {
+      throw new Error("getSitemapProducts is available in salesChannelId mode only");
+    }
+    const res = await this.vibeCodedRequest("GET", "/sitemap-products", void 0, { limit: Math.min(limit, 5e3) });
+    return res.data;
+  }
+  /**
+   * Resolve an old (renamed) slug to the entity's CURRENT slug, so the
+   * storefront can issue a permanent (301/308) redirect instead of a 404.
+   *
+   * Call this in the catch/not-found path of a product or blog page:
+   * the platform records every slug rename, so a URL that stopped matching
+   * usually has a redirect. Returns `null` when there is no redirect (real
+   * 404) or outside sales-channel mode — always fall through to notFound().
+   *
+   * @example
+   * ```typescript
+   * // app/products/[slug]/page.tsx — in the catch path:
+   * const redirect = await client.resolveSlugRedirect('product', slug);
+   * if (redirect) permanentRedirect(`/products/${redirect.currentSlug}`);
+   * notFound();
+   * ```
+   */
+  async resolveSlugRedirect(entityType, slug) {
+    if (!this.isVibeCodedMode()) return null;
+    try {
+      return await this.vibeCodedRequest(
+        "GET",
+        `/slug-redirects/${entityType}/${encodePathSegment(slug)}`
+      );
+    } catch {
+      return null;
+    }
+  }
   /**
    * Get a single product by ID
    * Works in vibe-coded, storefront (public), and admin mode
@@ -8945,6 +8990,41 @@ var _BrainerceClient = class _BrainerceClient {
       { salesChannelId }
     );
   }
+  /**
+   * Attach a customer to a sales channel (admin mode) — marks them as active in
+   * that storefront. Accepts the sales-channel record ID or its public `vc_*`
+   * connection ID.
+   *
+   * Rarely needed: the platform records a channel by itself whenever the
+   * customer registers, signs in or checks out on it. Use this for migrations
+   * from another system and for fixing up records you created yourself. A
+   * customer belongs to one store but can be active in any number of its
+   * channels, so calling this for several channels is normal and expected.
+   *
+   * This does not change where the customer CAME FROM — for that, pass
+   * `acquisitionSalesChannelId` to {@link updateCustomer}.
+   */
+  async publishCustomerToSalesChannel(customerId, salesChannelId) {
+    return this.adminRequest(
+      "POST",
+      `/api/v1/customers/${encodePathSegment(customerId)}/publish-sales-channel`,
+      { salesChannelId }
+    );
+  }
+  /**
+   * Detach a customer from a sales channel (admin mode).
+   *
+   * A correction, NOT a block — it does not stop that person from buying on
+   * that storefront, and the channel is recorded again the next time they sign
+   * in or order there. There is no way to bar a customer from a channel.
+   */
+  async unpublishCustomerFromSalesChannel(customerId, salesChannelId) {
+    return this.adminRequest(
+      "POST",
+      `/api/v1/customers/${encodePathSegment(customerId)}/unpublish-sales-channel`,
+      { salesChannelId }
+    );
+  }
   /**
    * Publish a coupon to a sales channel (admin mode) — makes it redeemable on
    * that vibe-coded storefront. Accepts the sales-channel record ID or its
@@ -10136,7 +10216,8 @@ function buildProductJsonLd(product, opts) {
   const brand = opts.brandName ?? product.brands?.[0]?.name;
   const description = stripHtml(product.description).slice(0, 5e3);
   const effectivePrice = product.salePrice ?? product.basePrice;
-  const inStock = product.inventory ? (product.inventory.available ?? 0) > 0 : true;
+  const inv = product.inventory;
+  const availability = !inv ? "https://schema.org/InStock" : inv.inStock ?? (inv.available ?? 0) > 0 ? "https://schema.org/InStock" : inv.canPurchase ? "https://schema.org/BackOrder" : "https://schema.org/OutOfStock";
   const isVariable = product.type === "VARIABLE" && product.priceMin && product.priceMax;
   const itemCondition = "https://schema.org/NewCondition";
   const shippingDetails = (opts.shipping ?? []).filter((z) => z.amount !== null).map((z) => ({
@@ -10167,8 +10248,9 @@ function buildProductJsonLd(product, opts) {
     "@type": "AggregateOffer",
     lowPrice: product.priceMin,
     highPrice: product.priceMax,
+    ...product.variants?.length ? { offerCount: product.variants.length } : {},
     priceCurrency: opts.currency,
-    availability: inStock ? "https://schema.org/InStock" : "https://schema.org/OutOfStock",
+    availability,
     itemCondition,
     ...shippingDetails.length > 0 ? { shippingDetails } : {},
     ...url ? { url } : {}
@@ -10176,7 +10258,7 @@ function buildProductJsonLd(product, opts) {
     "@type": "Offer",
     price: effectivePrice,
     priceCurrency: opts.currency,
-    availability: inStock ? "https://schema.org/InStock" : "https://schema.org/OutOfStock",
+    availability,
     itemCondition,
     // Only meaningful for an active sale price with a known end date —
     // a regular (non-sale) price has no expiry to declare.
@@ -10191,19 +10273,25 @@ function buildProductJsonLd(product, opts) {
     ...description ? { description } : {},
     ...images.length > 0 ? { image: images } : {},
     ...url ? { url } : {},
-    sku: product.sku,
+    // Fall back to the product id so the offer always carries a stable SKU —
+    // Merchant Center matching and review aggregation both key on it.
+    sku: product.sku || product.id,
     // Identifiers Google uses to match a product to its catalog — key for
     // free merchant-listing eligibility without a Merchant Center feed.
     ...product.gtin ? { gtin: product.gtin } : {},
     ...product.mpn ? { mpn: product.mpn } : {},
     ...brand ? { brand: { "@type": "Brand", name: brand } } : {},
     offers: offer,
-    // Google policy: never emit an empty/zero rating block.
+    // Google policy: never emit an empty/zero rating block. bestRating /
+    // worstRating make the 1-5 scale explicit so aggregators can't misread
+    // a 4.8 on an assumed 0-10 scale.
     ...product.reviewCount && product.reviewCount > 0 && product.avgRating ? {
       aggregateRating: {
         "@type": "AggregateRating",
         ratingValue: product.avgRating,
-        reviewCount: product.reviewCount
+        reviewCount: product.reviewCount,
+        bestRating: 5,
+        worstRating: 1
       }
     } : {}
   };
@@ -10314,6 +10402,54 @@ async function getBlogSitemapEntries(client, opts) {
   }
   return entries;
 }
+async function getProductSitemapEntries(client, opts) {
+  const base = opts.siteUrl.replace(/\/+$/, "");
+  const basePath = opts.basePath ?? "/products";
+  const pageSize = Math.min(opts.pageSize ?? 100, 100);
+  const maxEntries = opts.maxEntries ?? 5e3;
+  let rows = [];
+  try {
+    rows = await client.getSitemapProducts(maxEntries);
+  } catch {
+    let page = 1;
+    for (; ; ) {
+      const res = await client.getProducts({ page, limit: pageSize });
+      rows.push(
+        ...res.data.map((p) => ({
+          slug: p.slug ?? null,
+          id: p.id,
+          updatedAt: p.updatedAt,
+          localeSlugs: p.localeSlugs ?? null
+        }))
+      );
+      if (page >= res.meta.totalPages || rows.length >= maxEntries) break;
+      page += 1;
+    }
+  }
+  const nonDefaultLocales = opts.locales?.filter((locale) => locale !== opts.defaultLocale) ?? [];
+  const entries = [];
+  for (const row of rows.slice(0, maxEntries)) {
+    const baseSlug = row.slug || row.id;
+    if (!baseSlug) continue;
+    const lastModified = row.updatedAt ? new Date(row.updatedAt) : void 0;
+    const localeSlugs = row.localeSlugs ?? {};
+    entries.push({
+      url: `${base}${basePath}/${baseSlug}`,
+      ...lastModified ? { lastModified } : {},
+      changeFrequency: "daily",
+      priority: 0.8
+    });
+    for (const locale of nonDefaultLocales) {
+      entries.push({
+        url: `${base}/${locale}${basePath}/${localeSlugs[locale] || baseSlug}`,
+        ...lastModified ? { lastModified } : {},
+        changeFrequency: "daily",
+        priority: 0.7
+      });
+    }
+  }
+  return entries;
+}
 async function getCategorySitemapEntries(client, opts) {
   const base = opts.siteUrl.replace(/\/+$/, "");
   const basePath = opts.basePath ?? "/category";
@@ -10619,6 +10755,7 @@ function isCouponApplicableToProduct(coupon, productId) {
   getProductMetafieldsByType,
   getProductPrice,
   getProductPriceInfo,
+  getProductSitemapEntries,
   getProductSwatches,
   getStockStatus,
   getVariantOptions,

package/dist/index.mjs

@@ -1567,6 +1567,50 @@ var _BrainerceClient = class _BrainerceClient {
       queryParamsWithRegion
     );
   }
+  /**
+   * Lightweight product rows for sitemap generation: `slug`, `updatedAt`, and
+   * per-locale `localeSlugs` only — up to `limit` (max 5000) in ONE request,
+   * with none of the 100-per-page clamp the full listing applies.
+   *
+   * Sales-channel (`salesChannelId`) mode only; other modes throw so
+   * {@link getProductSitemapEntries} (sitemap.ts) can catch and fall back to
+   * paginating `getProducts`. Prefer that helper over calling this directly.
+   */
+  async getSitemapProducts(limit = 5e3) {
+    if (!this.isVibeCodedMode()) {
+      throw new Error("getSitemapProducts is available in salesChannelId mode only");
+    }
+    const res = await this.vibeCodedRequest("GET", "/sitemap-products", void 0, { limit: Math.min(limit, 5e3) });
+    return res.data;
+  }
+  /**
+   * Resolve an old (renamed) slug to the entity's CURRENT slug, so the
+   * storefront can issue a permanent (301/308) redirect instead of a 404.
+   *
+   * Call this in the catch/not-found path of a product or blog page:
+   * the platform records every slug rename, so a URL that stopped matching
+   * usually has a redirect. Returns `null` when there is no redirect (real
+   * 404) or outside sales-channel mode — always fall through to notFound().
+   *
+   * @example
+   * ```typescript
+   * // app/products/[slug]/page.tsx — in the catch path:
+   * const redirect = await client.resolveSlugRedirect('product', slug);
+   * if (redirect) permanentRedirect(`/products/${redirect.currentSlug}`);
+   * notFound();
+   * ```
+   */
+  async resolveSlugRedirect(entityType, slug) {
+    if (!this.isVibeCodedMode()) return null;
+    try {
+      return await this.vibeCodedRequest(
+        "GET",
+        `/slug-redirects/${entityType}/${encodePathSegment(slug)}`
+      );
+    } catch {
+      return null;
+    }
+  }
   /**
    * Get a single product by ID
    * Works in vibe-coded, storefront (public), and admin mode
@@ -8859,6 +8903,41 @@ var _BrainerceClient = class _BrainerceClient {
       { salesChannelId }
     );
   }
+  /**
+   * Attach a customer to a sales channel (admin mode) — marks them as active in
+   * that storefront. Accepts the sales-channel record ID or its public `vc_*`
+   * connection ID.
+   *
+   * Rarely needed: the platform records a channel by itself whenever the
+   * customer registers, signs in or checks out on it. Use this for migrations
+   * from another system and for fixing up records you created yourself. A
+   * customer belongs to one store but can be active in any number of its
+   * channels, so calling this for several channels is normal and expected.
+   *
+   * This does not change where the customer CAME FROM — for that, pass
+   * `acquisitionSalesChannelId` to {@link updateCustomer}.
+   */
+  async publishCustomerToSalesChannel(customerId, salesChannelId) {
+    return this.adminRequest(
+      "POST",
+      `/api/v1/customers/${encodePathSegment(customerId)}/publish-sales-channel`,
+      { salesChannelId }
+    );
+  }
+  /**
+   * Detach a customer from a sales channel (admin mode).
+   *
+   * A correction, NOT a block — it does not stop that person from buying on
+   * that storefront, and the channel is recorded again the next time they sign
+   * in or order there. There is no way to bar a customer from a channel.
+   */
+  async unpublishCustomerFromSalesChannel(customerId, salesChannelId) {
+    return this.adminRequest(
+      "POST",
+      `/api/v1/customers/${encodePathSegment(customerId)}/unpublish-sales-channel`,
+      { salesChannelId }
+    );
+  }
   /**
    * Publish a coupon to a sales channel (admin mode) — makes it redeemable on
    * that vibe-coded storefront. Accepts the sales-channel record ID or its
@@ -10050,7 +10129,8 @@ function buildProductJsonLd(product, opts) {
   const brand = opts.brandName ?? product.brands?.[0]?.name;
   const description = stripHtml(product.description).slice(0, 5e3);
   const effectivePrice = product.salePrice ?? product.basePrice;
-  const inStock = product.inventory ? (product.inventory.available ?? 0) > 0 : true;
+  const inv = product.inventory;
+  const availability = !inv ? "https://schema.org/InStock" : inv.inStock ?? (inv.available ?? 0) > 0 ? "https://schema.org/InStock" : inv.canPurchase ? "https://schema.org/BackOrder" : "https://schema.org/OutOfStock";
   const isVariable = product.type === "VARIABLE" && product.priceMin && product.priceMax;
   const itemCondition = "https://schema.org/NewCondition";
   const shippingDetails = (opts.shipping ?? []).filter((z) => z.amount !== null).map((z) => ({
@@ -10081,8 +10161,9 @@ function buildProductJsonLd(product, opts) {
     "@type": "AggregateOffer",
     lowPrice: product.priceMin,
     highPrice: product.priceMax,
+    ...product.variants?.length ? { offerCount: product.variants.length } : {},
     priceCurrency: opts.currency,
-    availability: inStock ? "https://schema.org/InStock" : "https://schema.org/OutOfStock",
+    availability,
     itemCondition,
     ...shippingDetails.length > 0 ? { shippingDetails } : {},
     ...url ? { url } : {}
@@ -10090,7 +10171,7 @@ function buildProductJsonLd(product, opts) {
     "@type": "Offer",
     price: effectivePrice,
     priceCurrency: opts.currency,
-    availability: inStock ? "https://schema.org/InStock" : "https://schema.org/OutOfStock",
+    availability,
     itemCondition,
     // Only meaningful for an active sale price with a known end date —
     // a regular (non-sale) price has no expiry to declare.
@@ -10105,19 +10186,25 @@ function buildProductJsonLd(product, opts) {
     ...description ? { description } : {},
     ...images.length > 0 ? { image: images } : {},
     ...url ? { url } : {},
-    sku: product.sku,
+    // Fall back to the product id so the offer always carries a stable SKU —
+    // Merchant Center matching and review aggregation both key on it.
+    sku: product.sku || product.id,
     // Identifiers Google uses to match a product to its catalog — key for
     // free merchant-listing eligibility without a Merchant Center feed.
     ...product.gtin ? { gtin: product.gtin } : {},
     ...product.mpn ? { mpn: product.mpn } : {},
     ...brand ? { brand: { "@type": "Brand", name: brand } } : {},
     offers: offer,
-    // Google policy: never emit an empty/zero rating block.
+    // Google policy: never emit an empty/zero rating block. bestRating /
+    // worstRating make the 1-5 scale explicit so aggregators can't misread
+    // a 4.8 on an assumed 0-10 scale.
     ...product.reviewCount && product.reviewCount > 0 && product.avgRating ? {
       aggregateRating: {
         "@type": "AggregateRating",
         ratingValue: product.avgRating,
-        reviewCount: product.reviewCount
+        reviewCount: product.reviewCount,
+        bestRating: 5,
+        worstRating: 1
       }
     } : {}
   };
@@ -10228,6 +10315,54 @@ async function getBlogSitemapEntries(client, opts) {
   }
   return entries;
 }
+async function getProductSitemapEntries(client, opts) {
+  const base = opts.siteUrl.replace(/\/+$/, "");
+  const basePath = opts.basePath ?? "/products";
+  const pageSize = Math.min(opts.pageSize ?? 100, 100);
+  const maxEntries = opts.maxEntries ?? 5e3;
+  let rows = [];
+  try {
+    rows = await client.getSitemapProducts(maxEntries);
+  } catch {
+    let page = 1;
+    for (; ; ) {
+      const res = await client.getProducts({ page, limit: pageSize });
+      rows.push(
+        ...res.data.map((p) => ({
+          slug: p.slug ?? null,
+          id: p.id,
+          updatedAt: p.updatedAt,
+          localeSlugs: p.localeSlugs ?? null
+        }))
+      );
+      if (page >= res.meta.totalPages || rows.length >= maxEntries) break;
+      page += 1;
+    }
+  }
+  const nonDefaultLocales = opts.locales?.filter((locale) => locale !== opts.defaultLocale) ?? [];
+  const entries = [];
+  for (const row of rows.slice(0, maxEntries)) {
+    const baseSlug = row.slug || row.id;
+    if (!baseSlug) continue;
+    const lastModified = row.updatedAt ? new Date(row.updatedAt) : void 0;
+    const localeSlugs = row.localeSlugs ?? {};
+    entries.push({
+      url: `${base}${basePath}/${baseSlug}`,
+      ...lastModified ? { lastModified } : {},
+      changeFrequency: "daily",
+      priority: 0.8
+    });
+    for (const locale of nonDefaultLocales) {
+      entries.push({
+        url: `${base}/${locale}${basePath}/${localeSlugs[locale] || baseSlug}`,
+        ...lastModified ? { lastModified } : {},
+        changeFrequency: "daily",
+        priority: 0.7
+      });
+    }
+  }
+  return entries;
+}
 async function getCategorySitemapEntries(client, opts) {
   const base = opts.siteUrl.replace(/\/+$/, "");
   const basePath = opts.basePath ?? "/category";
@@ -10532,6 +10667,7 @@ export {
   getProductMetafieldsByType,
   getProductPrice,
   getProductPriceInfo,
+  getProductSitemapEntries,
   getProductSwatches,
   getStockStatus,
   getVariantOptions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.55.0",
+  "version": "1.56.0",
   "description": "Official SDK for building e-commerce storefronts with Brainerce Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",