brainerce 1.25.0 → 1.26.0

package/README.md

@@ -49,7 +49,10 @@ Every Brainerce storefront must include **all mandatory features** below. Featur
 | Global header: cart count + search autocomplete         | `client.getCart()`, `client.getSearchSuggestions(query)`                                                      | ✅          |
 | Discount banners + product badges                       | `client.getDiscountBanners()`, `client.getProductDiscountBadge(productId)`                                    | ✅          |
 | Product reviews on PDP + JSON-LD aggregateRating        | `client.listProductReviews(id)`, `client.submitProductReview(id, …)`                                          | ✅          |
-| Multi-language + RTL (when i18n enabled)                | `client.setLocale()`                                                                                          | conditional |
+| Site chrome (header + footer + announcement bar)        | `client.content.header.get()`, `client.content.footer.get()`, `client.content.announcement.list()`            | ✅          |
+| FAQ page                                                | `client.content.faq.get('main', locale)`                                                                       | conditional |
+| Static pages catch-all (`/pages/[slug]`)                | `client.content.page.getBySlug(slug, locale)`                                                                  | conditional |
+| Multi-language + RTL (when i18n enabled)                | `client.setLocale()`, `client.getStoreDirection(locale)`                                                       | conditional |
 
 ---
 
@@ -368,6 +371,39 @@ Money on the wire is **always strings** (`priceDelta: "5.00"`). Validation failu
 
 Full rendering guide: [INTEGRATION.md §2.9](https://brainerce.com/docs/integration). Restaurant features (allergens, scheduled availability, nested combos to depth 3, downsell modifiers): [INTEGRATION-OPTIONAL.md "Restaurant / build-your-own products"](https://brainerce.com/docs/integration/raw?part=optional).
 
+### Content (FAQ / Footer / Header / Announcements / Pages)
+
+Merchants edit site chrome and static content in the Brainerce dashboard under **Sell → Content**; storefronts pick up changes within ~5 minutes. Six types: `FAQ`, `FOOTER`, `HEADER`, `ANNOUNCEMENT`, `RICH_TEXT`, `PAGE`. Every type has `'main'` as its universal default key.
+
+```typescript
+// Fetch chrome at the root layout (server component if Next.js)
+const [header, footer, announcements] = await Promise.all([
+  client.content.header.get('main', locale),
+  client.content.footer.get('main', locale),
+  client.content.announcement.list(locale),
+]);
+
+// FAQ page
+const faq = await client.content.faq.get('main', locale);
+
+// Static pages — catch-all route
+const page = await client.content.page.getBySlug(params.slug, locale);
+if (!page) notFound();
+```
+
+All `get` / `getBySlug` return `null` on 404 — render a hard-coded fallback so the page never crashes when the merchant hasn't seeded yet.
+
+**Security**: `FAQ.items[i].answer`, `RICH_TEXT.html`, and `PAGE.html` are **merchant-authored HTML**. The server does NOT pre-sanitize (merchants may embed iframes). ALWAYS sanitize before injecting:
+
+```typescript
+import DOMPurify from 'isomorphic-dompurify';
+<div dangerouslySetInnerHTML={{ __html: DOMPurify.sanitize(rawHtml) }} />
+```
+
+The `create-brainerce-store` scaffold ships ready-made components (`<AnnouncementBar>`, `<SiteHeader>`, `<SiteFooter>`, `<FaqSection>`, `<RichTextBlock>`) + a `/pages/[slug]` catch-all route — use them rather than rolling your own renderers.
+
+Full guide: [INTEGRATION.md "Content"](https://brainerce.com/docs/integration#content). Advanced patterns (channel scoping, custom fields, translations, admin writes): [INTEGRATION-OPTIONAL.md "Content"](https://brainerce.com/docs/integration/raw?part=optional). Validation + sanitize rules: [INTEGRATION-RULES.md "Content"](https://brainerce.com/docs/integration/raw?part=rules).
+
 ---
 
 ## Common Mistakes to Avoid

package/dist/index.d.mts

@@ -118,6 +118,28 @@ interface StoreInfo {
     name: string;
     currency: string;
     language: string;
+    /**
+     * SEO snippet for the storefront homepage. Used for `<meta name="description">`,
+     * `og:description`, and `twitter:description`. 50-160 chars recommended.
+     * Null when the merchant has not authored one.
+     */
+    metaDescription?: string | null;
+    /**
+     * Public-facing store logo URL. Used by the storefront for the Organization
+     * JSON-LD on the homepage (Google Knowledge Panel, AI Overviews citation).
+     * Null when the merchant has not uploaded one.
+     */
+    logo?: string | null;
+    /** Public contact email — rendered in storefront footer, included in Organization JSON-LD. */
+    contactEmail?: string | null;
+    /** Public contact phone (free-form local format). Rendered in footer + Organization JSON-LD. */
+    contactPhone?: string | null;
+    /**
+     * Public social profile URLs keyed by platform. Feeds Organization.sameAs in JSON-LD
+     * (Google Knowledge Panel reinforcement) and the storefront footer icons.
+     * Known keys: `facebook`, `instagram`, `tiktok`, `twitter`, `youtube`.
+     */
+    socialLinks?: Record<string, string> | null;
     /** Sales Channel ID (sales-channel mode only) */
     salesChannelId?: string;
     /** @deprecated alias of `salesChannelId` — will be removed in SDK 2.0 */
@@ -153,8 +175,25 @@ interface I18nSettings {
     enabled: boolean;
     /** The store's default locale (content language) */
     defaultLocale: string;
+    /** Script direction of the default locale (derived from `defaultLocale`) */
+    defaultDirection?: 'ltr' | 'rtl';
     /** All supported locales */
     supportedLocales: string[];
+    /**
+     * Same locales as `supportedLocales`, but each entry includes its script
+     * direction and a default flag. Additive (introduced alongside `defaultDirection`)
+     * so existing consumers reading `supportedLocales` keep working.
+     */
+    supportedLocaleObjects?: SupportedLocaleObject[];
+}
+/** Per-locale entry returned alongside `supportedLocales` */
+interface SupportedLocaleObject {
+    /** BCP-47 code (e.g. 'he', 'en-US') */
+    code: string;
+    /** Script direction for this locale */
+    direction: 'ltr' | 'rtl';
+    /** Whether this is the store's default locale */
+    isDefault: boolean;
 }
 /** Upsell feature configuration exposed to the storefront */
 interface UpsellSettings {
@@ -519,6 +558,54 @@ declare function getDescriptionContent(product: Pick<Product, 'description' | 'd
 } | {
     text: string;
 } | null;
+/**
+ * Strip HTML tags and decode common HTML entities from a string, then collapse
+ * whitespace. Safe to use on merchant-authored product descriptions before
+ * placing them inside `<meta name="description">`, `og:description`, or
+ * `schema.org/Product.description`.
+ *
+ * @param html - Raw string that may contain HTML markup
+ * @returns Plain text suitable for SEO meta tags
+ *
+ * @example
+ * ```typescript
+ * import { stripHtml } from 'brainerce';
+ * stripHtml('<p>Hello <strong>world</strong></p>'); // 'Hello world'
+ * ```
+ */
+declare function stripHtml(html: string | null | undefined): string;
+/**
+ * Derive a clean meta description for a product, suitable for `<meta name="description">`,
+ * `og:description`, `twitter:description`, and `schema.org/Product.description`.
+ *
+ * Priority order:
+ * 1. `product.seoDescription` — merchant-authored, already SEO-shaped (returned as-is)
+ * 2. `product.metaDescription` — same idea under the backend field name
+ * 3. Truncated, HTML-stripped `product.description` — capped at `maxLength` with
+ *    a word-boundary cut and an ellipsis when truncation happens
+ * 4. `product.name` — last-resort fallback so the meta tag is never empty
+ *
+ * The truncation is word-aware (never cuts mid-word) and never embeds HTML.
+ *
+ * @param product - Product or product-like object
+ * @param options.maxLength - Hard cap for derived descriptions. Default: 160 (Google SERP cap)
+ * @returns Clean meta description string, or empty string if nothing is available
+ *
+ * @example
+ * ```typescript
+ * import { deriveSeoDescription } from 'brainerce';
+ *
+ * // In Next.js generateMetadata:
+ * const description = deriveSeoDescription(product);
+ * return { description, openGraph: { description }, twitter: { description } };
+ * ```
+ */
+declare function deriveSeoDescription(product: (Partial<Pick<Product, 'description' | 'descriptionFormat' | 'name'>> & {
+    seoDescription?: string | null;
+    metaDescription?: string | null;
+}) | null | undefined, options?: {
+    maxLength?: number;
+}): string;
 /**
  * Get a human-readable stock status string
  * Now tracking-mode aware:
@@ -3079,6 +3166,9 @@ interface Category {
     /** Platform-specific metadata */
     platformMetadata?: Record<string, Record<string, unknown>> | null;
     parentId?: string | null;
+    image?: string | null;
+    /** R2/S3 object key for `image`; null when the URL is external (e.g. Shopify CDN). */
+    imageKey?: string | null;
     isActive: boolean;
     /** Tax behavior: 'taxable' follows store setting, 'exempt' always skips tax */
     taxBehavior?: 'taxable' | 'exempt';
@@ -3125,12 +3215,18 @@ interface CreateCategoryDto {
     storeId?: string;
     source?: string;
     isActive?: boolean;
+    image?: string;
+    /** R2/S3 object key for `image`; powers asset-deletion cascade. */
+    imageKey?: string;
     taxBehavior?: 'taxable' | 'exempt';
 }
 interface UpdateCategoryDto {
     name?: string;
     parentId?: string | null;
     isActive?: boolean;
+    image?: string | null;
+    /** R2/S3 object key for `image`; pass null to clear. */
+    imageKey?: string | null;
     taxBehavior?: 'taxable' | 'exempt';
 }
 /**
@@ -3144,6 +3240,8 @@ interface Brand {
     slug?: string | null;
     description?: string | null;
     logo?: string | null;
+    /** R2/S3 object key for `logo`; null when the URL is external. */
+    logoKey?: string | null;
     /** Platform-specific IDs */
     platformIds?: Record<string, string> | null;
     /** Platforms this brand is published on */
@@ -3196,6 +3294,8 @@ interface CreateBrandDto {
     slug?: string;
     description?: string;
     logo?: string;
+    /** R2/S3 object key for `logo`; powers asset-deletion cascade. */
+    logoKey?: string;
     storeId?: string;
     isActive?: boolean;
 }
@@ -3204,6 +3304,8 @@ interface UpdateBrandDto {
     slug?: string;
     description?: string | null;
     logo?: string | null;
+    /** R2/S3 object key for `logo`; pass null to clear. */
+    logoKey?: string | null;
     isActive?: boolean;
 }
 /**
@@ -4377,6 +4479,127 @@ interface ContactFormSummary {
     name: string;
     isDefault: boolean;
 }
+type ContentType = 'FAQ' | 'FOOTER' | 'HEADER' | 'ANNOUNCEMENT' | 'RICH_TEXT' | 'PAGE';
+type ContentStatus = 'DRAFT' | 'PUBLISHED';
+interface FaqItem {
+    question: string;
+    /** Sanitized HTML — sanitize before rendering. */
+    answer: string;
+}
+interface FaqContent {
+    items: FaqItem[];
+}
+interface FooterLink {
+    label: string;
+    url: string;
+}
+interface FooterColumn {
+    title: string;
+    links: FooterLink[];
+}
+interface FooterSocialLink {
+    /** e.g. 'instagram' | 'facebook' | 'x' | 'linkedin' */
+    platform: string;
+    url: string;
+}
+interface FooterContent {
+    columns: FooterColumn[];
+    copyright?: string;
+    social?: FooterSocialLink[];
+}
+interface HeaderLogo {
+    src: string;
+    alt: string;
+}
+interface HeaderNavItem {
+    label: string;
+    url: string;
+}
+interface HeaderCta {
+    label: string;
+    url: string;
+}
+interface HeaderContent {
+    logo?: HeaderLogo;
+    navItems: HeaderNavItem[];
+    cta?: HeaderCta;
+}
+type AnnouncementSeverity = 'info' | 'warning' | 'success';
+interface AnnouncementContent {
+    message: string;
+    severity: AnnouncementSeverity;
+    dismissible: boolean;
+    /** ISO 8601. Storefront filters client-side. */
+    startsAt?: string;
+    endsAt?: string;
+    ctaLabel?: string;
+    ctaHref?: string;
+}
+interface RichTextContent {
+    /** Raw HTML — sanitize before rendering. */
+    html: string;
+}
+interface PageSeo {
+    title?: string;
+    description?: string;
+    ogImage?: string;
+}
+interface PageContent {
+    /** URL slug, lower-kebab. */
+    slug: string;
+    title: string;
+    /** Raw HTML — sanitize before rendering. */
+    html: string;
+    seo?: PageSeo;
+}
+type ContentDataMap = {
+    FAQ: FaqContent;
+    FOOTER: FooterContent;
+    HEADER: HeaderContent;
+    ANNOUNCEMENT: AnnouncementContent;
+    RICH_TEXT: RichTextContent;
+    PAGE: PageContent;
+};
+interface ContentSummary {
+    id: string;
+    type: ContentType;
+    key: string;
+    name: string;
+    status: ContentStatus;
+    position: number;
+    updatedAt: string;
+}
+interface Content<T extends ContentType = ContentType> extends ContentSummary {
+    type: T;
+    data: ContentDataMap[T];
+    customFields: Record<string, string>;
+    salesChannelIds: string[];
+}
+/** Body for `client.content.<type>.create()` (admin mode). */
+interface CreateContentInput<T extends ContentType = ContentType> {
+    type: T;
+    /** URL-safe slug. Use `'main'` as the default for the primary entry of each type. */
+    key: string;
+    name: string;
+    description?: string;
+    data: ContentDataMap[T];
+    salesChannelIds?: string[];
+    customFields?: Record<string, string>;
+    translations?: Record<string, Partial<ContentDataMap[T]>>;
+    status?: ContentStatus;
+    position?: number;
+}
+/** Body for `client.content.<type>.update()` (admin mode). `data` is replaced wholesale. */
+interface UpdateContentInput<T extends ContentType = ContentType> {
+    name?: string;
+    description?: string;
+    data?: ContentDataMap[T];
+    salesChannelIds?: string[];
+    customFields?: Record<string, string>;
+    translations?: Record<string, Partial<ContentDataMap[T]>> | null;
+    status?: ContentStatus;
+    position?: number;
+}
 /**
  * How many modifiers a customer can pick from a group.
  *
@@ -4416,6 +4639,8 @@ interface Modifier {
         thumbnailUrl?: string;
         alt?: string;
     };
+    /** R2/S3 object key for `image`; null when the URL is external. */
+    imageKey?: string | null;
     position: number;
     /** Pre-checked in the UI on first render. */
     isDefault: boolean;
@@ -4650,6 +4875,20 @@ interface BrainerceApiError {
     details?: unknown;
 }
 
+/**
+ * BCP-47 primary subtags whose script is written right-to-left. Inlined in the
+ * SDK so storefronts don't take a runtime dependency on `@brainerce/types`.
+ * Keep in sync with `packages/types/src/utils/locale-resolver.ts`.
+ */
+declare const RTL_LOCALES: Set<string>;
+/**
+ * Resolve script direction (`'ltr' | 'rtl'`) for a BCP-47 locale tag.
+ * Unknown / undefined locales → `'ltr'`. Use this whenever you need direction
+ * without a `BrainerceClient` instance (e.g. inside server-rendered layouts
+ * before any SDK call). When you already have a client, prefer
+ * `client.getStoreDirection()` which picks up the client's configured locale.
+ */
+declare function getDirectionForLocale(locale: string | undefined | null): 'ltr' | 'rtl';
 /**
  * BrainerceClient - SDK for integrating stores with Brainerce Platform
  *
@@ -4796,6 +5035,17 @@ declare class BrainerceClient {
      * Works in vibe-coded, storefront, and admin mode
      */
     getStoreInfo(): Promise<StoreInfo>;
+    /**
+     * Resolve the script direction (`'ltr' | 'rtl'`) for a locale tag.
+     * Use this on `<html dir>` in your root layout — do not maintain a local
+     * RTL set in your storefront.
+     *
+     * @param locale - Optional BCP-47 tag. If omitted, falls back to the SDK
+     *   client's configured locale (`new BrainerceClient({ locale: 'he' })`).
+     * @returns `'rtl'` for Arabic / Hebrew / Persian / Urdu / Yiddish family,
+     *   `'ltr'` for everything else (including unknown locales).
+     */
+    getStoreDirection(locale?: string | null): 'ltr' | 'rtl';
     /**
      * Get a list of products with pagination and filtering
      * Works in vibe-coded, storefront (public), and admin mode
@@ -5834,6 +6084,142 @@ declare class BrainerceClient {
          */
         get: (formKey?: string, locale?: string) => Promise<ContactFormPublic>;
     };
+    /**
+     * Typed merchant content store: FAQ, Footer, Header, Announcement,
+     * Rich Text, and Page.
+     *
+     * Works in all three SDK modes (vibe-coded, storefront, admin):
+     *   - **Public reads** (`get`, `list`, `getBySlug`): work in any mode.
+     *   - **Write operations** (`create`, `update`, `publish`, `unpublish`,
+     *     `remove`): admin mode only — they call `/api/v1/content/...` with
+     *     the API key. Calling from storefront / vibe-coded mode throws.
+     *
+     * **Default key:** every type has `'main'` as its universal default key.
+     * Pass no argument to fetch the main entry; pass a custom key (e.g.
+     * `'shipping'`, `'holiday-2026'`) for topical entries.
+     *
+     * **404 contract:** public reads return `null` when no PUBLISHED row
+     * exists. Storefronts should render hard-coded fallbacks on `null` so
+     * the page never crashes when the merchant hasn't seeded yet.
+     *
+     * **Security:** RICH_TEXT, PAGE, and FAQ answers contain raw HTML.
+     * Always sanitize with isomorphic-dompurify (or equivalent) before
+     * rendering. The server does NOT pre-sanitize because some merchants
+     * embed iframes (e.g. YouTube videos).
+     *
+     * @example
+     * ```typescript
+     * // Storefront (public) — fetch the merchant's FAQ in Hebrew
+     * const faq = await client.content.faq.get('main', 'he');
+     * if (faq) {
+     *   faq.data.items.forEach(({ question, answer }) => {
+     *     // sanitize(answer) before injecting via dangerouslySetInnerHTML
+     *   });
+     * }
+     *
+     * // Admin — create a shipping FAQ in DRAFT
+     * await client.content.faq.create({
+     *   key: 'shipping',
+     *   name: 'Shipping FAQ',
+     *   data: { items: [{ question: '…', answer: '…' }] },
+     * });
+     * ```
+     */
+    content: {
+        faq: {
+            /**
+             * Fetch one PUBLISHED entry by key (defaults to `'main'`). Returns
+             * `null` on 404 — render a hard-coded fallback when the merchant
+             * hasn't seeded yet.
+             */
+            get: (key?: string, locale?: string) => Promise<Content<"FAQ"> | null>;
+            /** List all PUBLISHED entries of this type. */
+            list: (locale?: string) => Promise<Content<"FAQ">[]>;
+            /** Create a new entry in DRAFT (admin mode). */
+            create: (input: Omit<CreateContentInput<"FAQ">, "type">) => Promise<Content<"FAQ">>;
+        };
+        footer: {
+            /**
+             * Fetch one PUBLISHED entry by key (defaults to `'main'`). Returns
+             * `null` on 404 — render a hard-coded fallback when the merchant
+             * hasn't seeded yet.
+             */
+            get: (key?: string, locale?: string) => Promise<Content<"FOOTER"> | null>;
+            /** List all PUBLISHED entries of this type. */
+            list: (locale?: string) => Promise<Content<"FOOTER">[]>;
+            /** Create a new entry in DRAFT (admin mode). */
+            create: (input: Omit<CreateContentInput<"FOOTER">, "type">) => Promise<Content<"FOOTER">>;
+        };
+        header: {
+            /**
+             * Fetch one PUBLISHED entry by key (defaults to `'main'`). Returns
+             * `null` on 404 — render a hard-coded fallback when the merchant
+             * hasn't seeded yet.
+             */
+            get: (key?: string, locale?: string) => Promise<Content<"HEADER"> | null>;
+            /** List all PUBLISHED entries of this type. */
+            list: (locale?: string) => Promise<Content<"HEADER">[]>;
+            /** Create a new entry in DRAFT (admin mode). */
+            create: (input: Omit<CreateContentInput<"HEADER">, "type">) => Promise<Content<"HEADER">>;
+        };
+        announcement: {
+            /**
+             * Fetch one PUBLISHED entry by key (defaults to `'main'`). Returns
+             * `null` on 404 — render a hard-coded fallback when the merchant
+             * hasn't seeded yet.
+             */
+            get: (key?: string, locale?: string) => Promise<Content<"ANNOUNCEMENT"> | null>;
+            /** List all PUBLISHED entries of this type. */
+            list: (locale?: string) => Promise<Content<"ANNOUNCEMENT">[]>;
+            /** Create a new entry in DRAFT (admin mode). */
+            create: (input: Omit<CreateContentInput<"ANNOUNCEMENT">, "type">) => Promise<Content<"ANNOUNCEMENT">>;
+        };
+        richText: {
+            /**
+             * Fetch one PUBLISHED entry by key (defaults to `'main'`). Returns
+             * `null` on 404 — render a hard-coded fallback when the merchant
+             * hasn't seeded yet.
+             */
+            get: (key?: string, locale?: string) => Promise<Content<"RICH_TEXT"> | null>;
+            /** List all PUBLISHED entries of this type. */
+            list: (locale?: string) => Promise<Content<"RICH_TEXT">[]>;
+            /** Create a new entry in DRAFT (admin mode). */
+            create: (input: Omit<CreateContentInput<"RICH_TEXT">, "type">) => Promise<Content<"RICH_TEXT">>;
+        };
+        page: {
+            /**
+             * Fetch a PUBLISHED page by its `data.slug` (e.g. `'about'`).
+             * Returns `null` on 404. Use this from your `app/[slug]/page.tsx`
+             * catch-all route.
+             */
+            getBySlug: (slug: string, locale?: string) => Promise<Content<"PAGE"> | null>;
+            /**
+             * Fetch one PUBLISHED entry by key (defaults to `'main'`). Returns
+             * `null` on 404 — render a hard-coded fallback when the merchant
+             * hasn't seeded yet.
+             */
+            get: (key?: string, locale?: string) => Promise<Content<"PAGE"> | null>;
+            /** List all PUBLISHED entries of this type. */
+            list: (locale?: string) => Promise<Content<"PAGE">[]>;
+            /** Create a new entry in DRAFT (admin mode). */
+            create: (input: Omit<CreateContentInput<"PAGE">, "type">) => Promise<Content<"PAGE">>;
+        };
+        /** Find a single row by its admin id (admin mode). */
+        findById: <T_1 extends ContentType = ContentType>(id: string) => Promise<Content<T_1>>;
+        /** List rows in admin mode with optional filters. */
+        listAdmin: <T_1 extends ContentType = ContentType>(filters?: {
+            type?: T_1;
+            status?: "DRAFT" | "PUBLISHED";
+        }) => Promise<Array<Content<T_1>>>;
+        /** Replace `data` (and optional metadata) on an existing row. */
+        update: <T_1 extends ContentType>(id: string, input: UpdateContentInput<T_1>) => Promise<Content<T_1>>;
+        /** Transition status DRAFT → PUBLISHED. */
+        publish: (id: string) => Promise<Content>;
+        /** Transition status PUBLISHED → DRAFT. */
+        unpublish: (id: string) => Promise<Content>;
+        /** Hard delete the row. Admin mode only. */
+        remove: (id: string) => Promise<void>;
+    };
     /**
      * Submit a contact inquiry from a storefront contact form.
      *
@@ -8458,4 +8844,4 @@ declare function isAllowedPaymentUrl(url: string, options?: PaymentUrlOptions):
  */
 declare function safePaymentRedirect(url: string, options?: PaymentUrlOptions): void;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, 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 CategoryNode, 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 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 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 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 FormatPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, 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 PaginatedResponse, 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 ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, 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 ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, 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 UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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, createWebhookHandler, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, safePaymentRedirect, verifyWebhook };
+export { type AddToCartDto, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, 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 CategoryNode, 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 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 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 ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, 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 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 ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, 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 ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, 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 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, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, safePaymentRedirect, stripHtml, verifyWebhook };