brainerce 1.18.0 → 1.19.0

package/README.md

@@ -119,7 +119,7 @@ const { data: products } = await client.getProducts();
 
 ### Product customization fields (buyer input)
 
-Products can expose `customizationFields` — merchant-defined inputs the buyer fills on the product page (engraving text, photo upload, select / multi-select options, date pickers, etc.). Render the form from the array, upload any images via `uploadCustomizationFile()`, then pass values as `metadata` on add-to-cart. The server validates and snapshots everything onto the order line.
+Products can expose `customizationFields` — merchant-defined inputs the buyer fills on the product page (engraving text, photo upload, select / multi-select options, date pickers, etc.). Render the form from the array, upload any images via `uploadCustomizationFile()`, then pass values as `metadata` on add-to-cart. The server validates and snapshots everything onto the order line. Definitions flagged `appliesToAllProducts: true` are folded into every product's `customizationFields` automatically — no client-side merging required.
 
 ```typescript
 if (product.customizationFields?.length) {
@@ -4308,7 +4308,7 @@ When building a store, implement these pages:
 - [ ] **Register** (`/register`) - Customer registration + social signup buttons
 - [ ] **Auth Callback** (`/auth/callback`) - Handle OAuth redirects from Google/Facebook/GitHub
 - [ ] **Verify Email** (`/verify-email`) - Email verification with 6-digit code (if store requires it)
-- [ ] **Account** (`/account`) - Profile and order history
+- [ ] **Account** (`/account`) - Profile, addresses, and full order history (per-item customizations, shipping & tracking, payment status, status timeline)
 
 ### ⚠️ Payment Page is REQUIRED
 

package/dist/index.d.mts

@@ -895,6 +895,32 @@ interface Order {
     /** Tax amount */
     taxAmount?: string | null;
     createdAt: string;
+    /** Payment method used (e.g., "card", "paypal", "cash_on_delivery"). */
+    paymentMethod?: string | null;
+    /** Financial status: "pending", "paid", "refunded", "partially_refunded", "voided". */
+    financialStatus?: string | null;
+    /** Fulfillment status: "unfulfilled", "partial", "fulfilled". */
+    fulfillmentStatus?: string | null;
+    /** Tracking number, e.g., "1Z999AA10123456784". */
+    trackingNumber?: string | null;
+    /** Deep link to the carrier's tracking page. */
+    trackingUrl?: string | null;
+    /** Carrier name, e.g., "UPS", "USPS", "DHL". */
+    carrier?: string | null;
+    /** ISO-8601 timestamp when the order was shipped. */
+    shippedAt?: string | null;
+    /** ISO-8601 timestamp when the order was delivered. */
+    deliveredAt?: string | null;
+    /** Status timeline entries in chronological order. */
+    statusHistory?: OrderStatusChange[] | null;
+}
+/** One status transition on an order. */
+interface OrderStatusChange {
+    status: OrderStatus;
+    /** ISO-8601 timestamp of the transition. */
+    at: string;
+    /** Optional note (why the status changed). */
+    note?: string | null;
 }
 /**
  * Order status values are **lowercase**.
@@ -3177,6 +3203,13 @@ interface MetafieldDefinition {
     description?: string | null;
     type: MetafieldType;
     required: boolean;
+    isCustomerInput?: boolean;
+    /**
+     * When `true`, the field is treated as present on every product of this
+     * account — including products created later. Clients don't need to list
+     * individual `ProductCustomizationField` rows when this is set.
+     */
+    appliesToAllProducts?: boolean;
     minLength?: number | null;
     maxLength?: number | null;
     minValue?: number | null;
@@ -3186,6 +3219,11 @@ interface MetafieldDefinition {
     position: number;
     isActive: boolean;
     mappings?: MetafieldPlatformMapping[];
+    /** Products this definition is explicitly attached to (customer-input only). */
+    products?: Array<{
+        id: string;
+        name: string;
+    }>;
     createdAt: string;
     updatedAt: string;
 }
@@ -3201,6 +3239,11 @@ interface PublicMetafieldDefinition {
     type: MetafieldType;
     required: boolean;
     isCustomerInput?: boolean;
+    /**
+     * When true, this definition applies to every product of the account —
+     * including ones created after the flag was set.
+     */
+    appliesToAllProducts?: boolean;
     enumValues?: string[];
     minLength?: number | null;
     maxLength?: number | null;
@@ -3247,6 +3290,14 @@ interface CreateMetafieldDefinitionDto {
     description?: string;
     type?: MetafieldType;
     required?: boolean;
+    isCustomerInput?: boolean;
+    /** When true the field applies to every product in the account. */
+    appliesToAllProducts?: boolean;
+    /**
+     * Assign the new (customer-input) definition to specific products atomically
+     * in the same create call. Only valid when `isCustomerInput` is true.
+     */
+    productIds?: string[];
     minLength?: number;
     maxLength?: number;
     minValue?: number;
@@ -3260,6 +3311,8 @@ interface UpdateMetafieldDefinitionDto {
     description?: string | null;
     type?: MetafieldType;
     required?: boolean;
+    isCustomerInput?: boolean;
+    appliesToAllProducts?: boolean;
     minLength?: number | null;
     maxLength?: number | null;
     minValue?: number | null;
@@ -3269,6 +3322,16 @@ interface UpdateMetafieldDefinitionDto {
     position?: number;
     isActive?: boolean;
 }
+/**
+ * Set (replace with diff-scoped semantics) the list of products linked to a
+ * single customer-input metafield definition. Passing an empty array detaches
+ * the definition from every product.
+ */
+interface SetDefinitionProductsDto {
+    productIds: string[];
+    /** Optionally flip the `appliesToAllProducts` flag in the same call. */
+    appliesToAllProducts?: boolean;
+}
 /**
  * Product metafield value
  */
@@ -6711,6 +6774,26 @@ declare class BrainerceClient {
      * Requires Admin mode (apiKey)
      */
     deleteMetafieldDefinition(definitionId: string): Promise<void>;
+    /**
+     * Replace the list of products a (customer-input) metafield definition is
+     * attached to. Diff-scoped: only rows for this definition are touched, so
+     * concurrent edits to other definitions on the same product are safe.
+     *
+     * Optionally toggles `appliesToAllProducts` in the same call. When that
+     * flag is true the `productIds` list is still respected as the explicit
+     * subset, but buyers will see the field on every product regardless.
+     *
+     * Requires Admin mode (apiKey).
+     *
+     * @example
+     * ```typescript
+     * await client.setDefinitionProducts('def_123', {
+     *   productIds: ['prod_a', 'prod_b'],
+     *   appliesToAllProducts: false,
+     * });
+     * ```
+     */
+    setDefinitionProducts(definitionId: string, data: SetDefinitionProductsDto): Promise<MetafieldDefinition>;
     /**
      * Get all metafield values for a product
      * Requires Admin mode (apiKey)
@@ -7100,4 +7183,4 @@ declare function enableDevGuards(options?: {
     force?: boolean;
 }): void;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, 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 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 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 CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 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 LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, 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 PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, 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 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 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 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, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, 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 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 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 CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 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 LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, 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 PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, 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 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 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 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, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.d.ts

@@ -895,6 +895,32 @@ interface Order {
     /** Tax amount */
     taxAmount?: string | null;
     createdAt: string;
+    /** Payment method used (e.g., "card", "paypal", "cash_on_delivery"). */
+    paymentMethod?: string | null;
+    /** Financial status: "pending", "paid", "refunded", "partially_refunded", "voided". */
+    financialStatus?: string | null;
+    /** Fulfillment status: "unfulfilled", "partial", "fulfilled". */
+    fulfillmentStatus?: string | null;
+    /** Tracking number, e.g., "1Z999AA10123456784". */
+    trackingNumber?: string | null;
+    /** Deep link to the carrier's tracking page. */
+    trackingUrl?: string | null;
+    /** Carrier name, e.g., "UPS", "USPS", "DHL". */
+    carrier?: string | null;
+    /** ISO-8601 timestamp when the order was shipped. */
+    shippedAt?: string | null;
+    /** ISO-8601 timestamp when the order was delivered. */
+    deliveredAt?: string | null;
+    /** Status timeline entries in chronological order. */
+    statusHistory?: OrderStatusChange[] | null;
+}
+/** One status transition on an order. */
+interface OrderStatusChange {
+    status: OrderStatus;
+    /** ISO-8601 timestamp of the transition. */
+    at: string;
+    /** Optional note (why the status changed). */
+    note?: string | null;
 }
 /**
  * Order status values are **lowercase**.
@@ -3177,6 +3203,13 @@ interface MetafieldDefinition {
     description?: string | null;
     type: MetafieldType;
     required: boolean;
+    isCustomerInput?: boolean;
+    /**
+     * When `true`, the field is treated as present on every product of this
+     * account — including products created later. Clients don't need to list
+     * individual `ProductCustomizationField` rows when this is set.
+     */
+    appliesToAllProducts?: boolean;
     minLength?: number | null;
     maxLength?: number | null;
     minValue?: number | null;
@@ -3186,6 +3219,11 @@ interface MetafieldDefinition {
     position: number;
     isActive: boolean;
     mappings?: MetafieldPlatformMapping[];
+    /** Products this definition is explicitly attached to (customer-input only). */
+    products?: Array<{
+        id: string;
+        name: string;
+    }>;
     createdAt: string;
     updatedAt: string;
 }
@@ -3201,6 +3239,11 @@ interface PublicMetafieldDefinition {
     type: MetafieldType;
     required: boolean;
     isCustomerInput?: boolean;
+    /**
+     * When true, this definition applies to every product of the account —
+     * including ones created after the flag was set.
+     */
+    appliesToAllProducts?: boolean;
     enumValues?: string[];
     minLength?: number | null;
     maxLength?: number | null;
@@ -3247,6 +3290,14 @@ interface CreateMetafieldDefinitionDto {
     description?: string;
     type?: MetafieldType;
     required?: boolean;
+    isCustomerInput?: boolean;
+    /** When true the field applies to every product in the account. */
+    appliesToAllProducts?: boolean;
+    /**
+     * Assign the new (customer-input) definition to specific products atomically
+     * in the same create call. Only valid when `isCustomerInput` is true.
+     */
+    productIds?: string[];
     minLength?: number;
     maxLength?: number;
     minValue?: number;
@@ -3260,6 +3311,8 @@ interface UpdateMetafieldDefinitionDto {
     description?: string | null;
     type?: MetafieldType;
     required?: boolean;
+    isCustomerInput?: boolean;
+    appliesToAllProducts?: boolean;
     minLength?: number | null;
     maxLength?: number | null;
     minValue?: number | null;
@@ -3269,6 +3322,16 @@ interface UpdateMetafieldDefinitionDto {
     position?: number;
     isActive?: boolean;
 }
+/**
+ * Set (replace with diff-scoped semantics) the list of products linked to a
+ * single customer-input metafield definition. Passing an empty array detaches
+ * the definition from every product.
+ */
+interface SetDefinitionProductsDto {
+    productIds: string[];
+    /** Optionally flip the `appliesToAllProducts` flag in the same call. */
+    appliesToAllProducts?: boolean;
+}
 /**
  * Product metafield value
  */
@@ -6711,6 +6774,26 @@ declare class BrainerceClient {
      * Requires Admin mode (apiKey)
      */
     deleteMetafieldDefinition(definitionId: string): Promise<void>;
+    /**
+     * Replace the list of products a (customer-input) metafield definition is
+     * attached to. Diff-scoped: only rows for this definition are touched, so
+     * concurrent edits to other definitions on the same product are safe.
+     *
+     * Optionally toggles `appliesToAllProducts` in the same call. When that
+     * flag is true the `productIds` list is still respected as the explicit
+     * subset, but buyers will see the field on every product regardless.
+     *
+     * Requires Admin mode (apiKey).
+     *
+     * @example
+     * ```typescript
+     * await client.setDefinitionProducts('def_123', {
+     *   productIds: ['prod_a', 'prod_b'],
+     *   appliesToAllProducts: false,
+     * });
+     * ```
+     */
+    setDefinitionProducts(definitionId: string, data: SetDefinitionProductsDto): Promise<MetafieldDefinition>;
     /**
      * Get all metafield values for a product
      * Requires Admin mode (apiKey)
@@ -7100,4 +7183,4 @@ declare function enableDevGuards(options?: {
     force?: boolean;
 }): void;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, 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 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 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 CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 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 LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, 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 PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, 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 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 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 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, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, 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 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 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 CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 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 LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, 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 PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, 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 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 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 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, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.js

@@ -439,11 +439,14 @@ var BrainerceClient = class {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
+      const isFormData = typeof FormData !== "undefined" && body instanceof FormData;
       const headers = {
-        "Content-Type": "application/json",
         "X-SDK-Version": SDK_VERSION,
         "ngrok-skip-browser-warning": "true"
       };
+      if (!isFormData) {
+        headers["Content-Type"] = "application/json";
+      }
       if (this.origin) {
         headers["Origin"] = this.origin;
       }
@@ -462,7 +465,7 @@ var BrainerceClient = class {
       const response = await fetch(url.toString(), {
         method,
         headers,
-        body: body ? JSON.stringify(body) : void 0,
+        body: body ? isFormData ? body : JSON.stringify(body) : void 0,
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -516,11 +519,14 @@ var BrainerceClient = class {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
+      const isFormData = typeof FormData !== "undefined" && body instanceof FormData;
       const headers = {
-        "Content-Type": "application/json",
         "X-SDK-Version": SDK_VERSION,
         "ngrok-skip-browser-warning": "true"
       };
+      if (!isFormData) {
+        headers["Content-Type"] = "application/json";
+      }
       if (this.origin) {
         headers["Origin"] = this.origin;
       }
@@ -536,7 +542,7 @@ var BrainerceClient = class {
       const response = await fetch(url.toString(), {
         method,
         headers,
-        body: body ? JSON.stringify(body) : void 0,
+        body: body ? isFormData ? body : JSON.stringify(body) : void 0,
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -5709,6 +5715,32 @@ var BrainerceClient = class {
   async deleteMetafieldDefinition(definitionId) {
     await this.adminRequest("DELETE", `/api/v1/metafield-definitions/${definitionId}`);
   }
+  /**
+   * Replace the list of products a (customer-input) metafield definition is
+   * attached to. Diff-scoped: only rows for this definition are touched, so
+   * concurrent edits to other definitions on the same product are safe.
+   *
+   * Optionally toggles `appliesToAllProducts` in the same call. When that
+   * flag is true the `productIds` list is still respected as the explicit
+   * subset, but buyers will see the field on every product regardless.
+   *
+   * Requires Admin mode (apiKey).
+   *
+   * @example
+   * ```typescript
+   * await client.setDefinitionProducts('def_123', {
+   *   productIds: ['prod_a', 'prod_b'],
+   *   appliesToAllProducts: false,
+   * });
+   * ```
+   */
+  async setDefinitionProducts(definitionId, data) {
+    return this.adminRequest(
+      "PATCH",
+      `/api/v1/metafield-definitions/${definitionId}/products`,
+      data
+    );
+  }
   // -------------------- Metafields: Product Values --------------------
   // These methods require Admin mode (apiKey)
   /**

package/dist/index.mjs

@@ -378,11 +378,14 @@ var BrainerceClient = class {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
+      const isFormData = typeof FormData !== "undefined" && body instanceof FormData;
       const headers = {
-        "Content-Type": "application/json",
         "X-SDK-Version": SDK_VERSION,
         "ngrok-skip-browser-warning": "true"
       };
+      if (!isFormData) {
+        headers["Content-Type"] = "application/json";
+      }
       if (this.origin) {
         headers["Origin"] = this.origin;
       }
@@ -401,7 +404,7 @@ var BrainerceClient = class {
       const response = await fetch(url.toString(), {
         method,
         headers,
-        body: body ? JSON.stringify(body) : void 0,
+        body: body ? isFormData ? body : JSON.stringify(body) : void 0,
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -455,11 +458,14 @@ var BrainerceClient = class {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
+      const isFormData = typeof FormData !== "undefined" && body instanceof FormData;
       const headers = {
-        "Content-Type": "application/json",
         "X-SDK-Version": SDK_VERSION,
         "ngrok-skip-browser-warning": "true"
       };
+      if (!isFormData) {
+        headers["Content-Type"] = "application/json";
+      }
       if (this.origin) {
         headers["Origin"] = this.origin;
       }
@@ -475,7 +481,7 @@ var BrainerceClient = class {
       const response = await fetch(url.toString(), {
         method,
         headers,
-        body: body ? JSON.stringify(body) : void 0,
+        body: body ? isFormData ? body : JSON.stringify(body) : void 0,
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -5648,6 +5654,32 @@ var BrainerceClient = class {
   async deleteMetafieldDefinition(definitionId) {
     await this.adminRequest("DELETE", `/api/v1/metafield-definitions/${definitionId}`);
   }
+  /**
+   * Replace the list of products a (customer-input) metafield definition is
+   * attached to. Diff-scoped: only rows for this definition are touched, so
+   * concurrent edits to other definitions on the same product are safe.
+   *
+   * Optionally toggles `appliesToAllProducts` in the same call. When that
+   * flag is true the `productIds` list is still respected as the explicit
+   * subset, but buyers will see the field on every product regardless.
+   *
+   * Requires Admin mode (apiKey).
+   *
+   * @example
+   * ```typescript
+   * await client.setDefinitionProducts('def_123', {
+   *   productIds: ['prod_a', 'prod_b'],
+   *   appliesToAllProducts: false,
+   * });
+   * ```
+   */
+  async setDefinitionProducts(definitionId, data) {
+    return this.adminRequest(
+      "PATCH",
+      `/api/v1/metafield-definitions/${definitionId}/products`,
+      data
+    );
+  }
   // -------------------- Metafields: Product Values --------------------
   // These methods require Admin mode (apiKey)
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.18.0",
+  "version": "1.19.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",