brainerce 1.48.0 → 1.49.0

package/README.md

@@ -1696,6 +1696,9 @@ fields.forEach((field) => {
   // field.required: whether customer must fill this in
   // field.minLength, field.maxLength: validation for text fields
   // field.minValue, field.maxValue: validation for number fields
+  // field.dateAvailability: constraints for DATE/DATETIME fields (blocked
+  //   weekdays/dates, min/max date, business hours + slots) — see
+  //   computeAvailableSlots()/isDateValueAllowed() below
   // field.enumValues: CustomizationFieldOption[] for SELECT/MULTI_SELECT
   //   each option: { label: string, value: string, swatchColor?: string, swatchImageUrl?: string }
   //   use option.value for metadata submission, option.label for display
@@ -2380,7 +2383,7 @@ const fields = await client.getCheckoutCustomFields(checkoutId);
 
 // 2. Render fields dynamically based on field.type:
 //    TEXT → text input, NUMBER → number input, BOOLEAN → checkbox,
-//    SELECT → dropdown (field.options), DATE → date picker
+//    SELECT → dropdown (field.options), DATE/DATETIME → date/time picker
 //    Show pricing info from field.pricing (e.g., "+25₪ when checked")
 
 // 3. Set customer values → recalculates surcharges and total
@@ -2395,6 +2398,35 @@ const updatedCheckout = await client.setCheckoutCustomFields(checkoutId, {
 // updatedCheckout.total is recalculated with surcharges included
 ```
 
+**DATE / DATETIME fields with availability constraints**
+
+A `DATE`/`DATETIME` field's `dateAvailability` (blocked weekdays, blocked specific
+dates, min/max date range, and — for `DATETIME` — business hours + time
+slots) is a merchant-configured restriction on which values the customer may
+pick. Use `computeAvailableSlots()` / `isDateValueAllowed()` to drive your own
+date-picker/slot-picker UI — the SDK ships no calendar component, only the
+math (evaluated in the **store's** timezone, never the browser's):
+
+```typescript
+import { computeAvailableSlots, isDateValueAllowed } from 'brainerce';
+
+const { timezone } = await client.getStoreInfo(); // IANA string, e.g. "Asia/Jerusalem"
+const deliveryField = fields.find((f) => f.key === 'delivery_slot');
+
+// Disable dates on your calendar of choice:
+const isDateDisabled = (candidate: Date) => {
+  const result = isDateValueAllowed(candidate, deliveryField?.dateAvailability, deliveryField!.type, timezone);
+  return !result.allowed;
+};
+
+// Once the customer picks a date, list its bookable time slots (DATETIME only):
+const slots = computeAvailableSlots(deliveryField?.dateAvailability, '2026-08-15'); // ["09:00", "09:30", ...]
+```
+
+The backend independently re-validates every submitted value against the same
+constraints at write time — this is a client-side UX aid, not the source of
+enforcement.
+
 **Pricing types:**
 
 - `none` → no surcharge

package/dist/index.d.mts

@@ -169,6 +169,15 @@ interface StoreInfo {
     name: string;
     currency: string;
     language: string;
+    /**
+     * IANA timezone (e.g. "Asia/Jerusalem") the store operates in. Use this —
+     * never the shopper's browser timezone — to evaluate any DATE/DATETIME
+     * custom field's `dateAvailability` constraints (blocked weekdays, business
+     * hours, time slots) client-side via `computeAvailableSlots()`. Optional
+     * for backward compatibility with existing `StoreInfo` construction; the
+     * backend always populates it.
+     */
+    timezone?: string;
     /**
      * SEO snippet for the storefront homepage. Used for `<meta name="description">`,
      * `og:description`, and `twitter:description`. 50-160 chars recommended.
@@ -4472,6 +4481,45 @@ interface CreateRegionDto {
 interface UpdateRegionDto extends Partial<CreateRegionDto> {
     isActive?: boolean;
 }
+/**
+ * A single per-weekday open/close window, store-local time. Only meaningful
+ * on DATETIME fields — ignored for plain DATE fields.
+ */
+interface BusinessHoursWindow {
+    /** 0 = Sunday .. 6 = Saturday. */
+    weekday: number;
+    /** "HH:mm", 24h, store-local. */
+    open: string;
+    /** "HH:mm", 24h, store-local. */
+    close: string;
+}
+/**
+ * Date/time availability constraints for a DATE/DATETIME custom field
+ * definition (checkout custom field or metafield). Null/absent = no
+ * restrictions. Pass this — together with a candidate date and the store's
+ * `timezone` (from `getStoreInfo()`) — into `computeAvailableSlots()` to
+ * render a disabled-dates list or time-slot picker; the backend independently
+ * re-validates every submitted value against these same constraints, so this
+ * is purely a client-side UX aid, not the source of enforcement.
+ *
+ * This type intentionally mirrors (but does not import)
+ * `DateAvailabilityConstraints` from `@brainerce/types` — the SDK has no
+ * runtime dependency on that package. Keep the two in sync by hand.
+ */
+interface DateAvailabilityConstraints {
+    /** "YYYY-MM-DD", inclusive. */
+    minDate?: string;
+    /** "YYYY-MM-DD", inclusive. */
+    maxDate?: string;
+    /** Subset of 0-6; any weekday(s) fully blocked regardless of date. */
+    blockedWeekdays?: number[];
+    /** Specific blocked calendar dates, e.g. holidays: ["2026-12-25"]. */
+    blockedDates?: string[];
+    /** Per-weekday open/close windows. Omitted weekday = closed all day. Only meaningful on DATETIME fields. */
+    businessHours?: BusinessHoursWindow[];
+    /** Minutes per bookable slot within businessHours. Requires businessHours. Only meaningful on DATETIME fields. */
+    slotDurationMinutes?: number;
+}
 /**
  * Metafield type for defining value structure
  */
@@ -4514,6 +4562,8 @@ interface MetafieldDefinition {
     maxLength?: number | null;
     minValue?: number | null;
     maxValue?: number | null;
+    /** Date/time constraints for DATE/DATETIME fields — see `computeAvailableSlots()`. */
+    dateAvailability?: DateAvailabilityConstraints | null;
     /** Allowed values for SELECT / MULTI_SELECT fields, with optional swatch metadata. */
     enumValues?: CustomizationFieldOption[] | null;
     defaultValue?: string | null;
@@ -4605,6 +4655,8 @@ interface PublicMetafieldDefinition {
     maxLength?: number | null;
     minValue?: number | null;
     maxValue?: number | null;
+    /** Date/time constraints for DATE/DATETIME fields — see `computeAvailableSlots()`. */
+    dateAvailability?: DateAvailabilityConstraints | null;
     defaultValue?: string | null;
     position: number;
 }
@@ -5398,7 +5450,7 @@ interface CheckoutCustomFieldDefinition {
      * `MULTI_SELECT` are NOT supported for checkout fields — those are
      * product-metafield-only (`ProductCustomizationField` / `MetafieldType`).
      */
-    type: 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATE' | 'IMAGE';
+    type: 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATE' | 'DATETIME' | 'IMAGE';
     required: boolean;
     position: number;
     visibility: CheckoutFieldVisibility;
@@ -5411,6 +5463,8 @@ interface CheckoutCustomFieldDefinition {
     maxLength?: number | null;
     minValue?: number | null;
     maxValue?: number | null;
+    /** Date/time constraints for DATE/DATETIME fields — see `computeAvailableSlots()`. */
+    dateAvailability?: DateAvailabilityConstraints | null;
     translations?: Record<string, Record<string, string>> | null;
 }
 interface CheckoutFieldVisibility {
@@ -5943,6 +5997,7 @@ interface BlogPost {
     seoTitle?: string;
     seoDescription?: string;
     ogImageUrl?: string;
+    translations?: Record<string, Record<string, string>> | null;
     createdAt: string;
     updatedAt: string;
 }
@@ -10736,6 +10791,59 @@ declare function formatVariantPrice(variant: Pick<ProductVariant, 'price' | 'sal
 /** Format any numeric amount as currency. Useful for cart totals, fees, etc. */
 declare function formatMoney(amount: number, currency: string, locale?: string): string;
 
+/**
+ * Config well-formedness — mirrors the backend's own check. Returns
+ * human-readable error strings; empty array = valid. Storefronts don't
+ * generally need this (only admins author the config), but it's exposed for
+ * any storefront building its own admin-like UI on top of the SDK.
+ */
+declare function validateDateAvailabilityConfig(config: DateAvailabilityConstraints | null | undefined, fieldType: 'DATE' | 'DATETIME'): string[];
+interface StoreLocalParts {
+    /** "YYYY-MM-DD" in the given timezone. */
+    dateYYYYMMDD: string;
+    /** "HH:mm" in the given timezone. */
+    hhmm: string;
+    /** 0 = Sunday .. 6 = Saturday. */
+    weekday: number;
+}
+/**
+ * Resolves an absolute instant to the store-local calendar date, "HH:mm",
+ * and weekday. Use `getStoreInfo().timezone` as the `timezone` argument —
+ * never the shopper's browser timezone, or "is Friday blocked" will
+ * disagree with the backend's own answer for shoppers in a different zone.
+ * Falls back to UTC parts on an invalid IANA timezone string — never throws.
+ */
+declare function resolveStoreLocalParts(instant: Date, timezone: string): StoreLocalParts;
+/** Day-level gate: minDate/maxDate/blockedWeekdays/blockedDates only (no time-of-day). */
+declare function isCalendarDateAllowed(dateYYYYMMDD: string, config: DateAvailabilityConstraints | null | undefined): boolean;
+/**
+ * Discrete slot starts ("HH:mm", store-local) for one calendar date. Empty
+ * array if: the date fails `isCalendarDateAllowed`, no `businessHours` window
+ * covers that weekday, or `slotDurationMinutes` is unset. A trailing slot
+ * whose end would exceed `close` is dropped, not clamped. No
+ * capacity/overbooking accounting — purely "which slots exist".
+ *
+ * Feed this into your own date-picker/slot-picker UI, e.g.:
+ * ```ts
+ * const { timezone } = await client.getStoreInfo();
+ * const fields = await client.getCheckoutCustomFields(checkoutId);
+ * const deliveryField = fields.find((f) => f.key === 'delivery_slot');
+ * const local = resolveStoreLocalParts(candidateDate, timezone);
+ * const slots = computeAvailableSlots(deliveryField?.dateAvailability, local.dateYYYYMMDD);
+ * ```
+ */
+declare function computeAvailableSlots(config: DateAvailabilityConstraints | null | undefined, dateYYYYMMDD: string): string[];
+/**
+ * Full value validation for a candidate date/datetime a shopper is about to
+ * submit — use this to disable a "Continue" button client-side before the
+ * backend's own (authoritative) rejection would otherwise surface as an
+ * error after a round trip.
+ */
+declare function isDateValueAllowed(instant: Date, config: DateAvailabilityConstraints | null | undefined, fieldType: 'DATE' | 'DATETIME', timezone: string): {
+    allowed: boolean;
+    reason?: string;
+};
+
 /**
  * JSON-LD (schema.org) builders for storefronts.
  *
@@ -10881,4 +10989,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 BlogSitemapOptions, 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 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 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 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 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 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 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, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseWebhookEvent, safePaymentRedirect, stripHtml, 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 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 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 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 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 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 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, 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, parseWebhookEvent, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };

package/dist/index.d.ts

@@ -169,6 +169,15 @@ interface StoreInfo {
     name: string;
     currency: string;
     language: string;
+    /**
+     * IANA timezone (e.g. "Asia/Jerusalem") the store operates in. Use this —
+     * never the shopper's browser timezone — to evaluate any DATE/DATETIME
+     * custom field's `dateAvailability` constraints (blocked weekdays, business
+     * hours, time slots) client-side via `computeAvailableSlots()`. Optional
+     * for backward compatibility with existing `StoreInfo` construction; the
+     * backend always populates it.
+     */
+    timezone?: string;
     /**
      * SEO snippet for the storefront homepage. Used for `<meta name="description">`,
      * `og:description`, and `twitter:description`. 50-160 chars recommended.
@@ -4472,6 +4481,45 @@ interface CreateRegionDto {
 interface UpdateRegionDto extends Partial<CreateRegionDto> {
     isActive?: boolean;
 }
+/**
+ * A single per-weekday open/close window, store-local time. Only meaningful
+ * on DATETIME fields — ignored for plain DATE fields.
+ */
+interface BusinessHoursWindow {
+    /** 0 = Sunday .. 6 = Saturday. */
+    weekday: number;
+    /** "HH:mm", 24h, store-local. */
+    open: string;
+    /** "HH:mm", 24h, store-local. */
+    close: string;
+}
+/**
+ * Date/time availability constraints for a DATE/DATETIME custom field
+ * definition (checkout custom field or metafield). Null/absent = no
+ * restrictions. Pass this — together with a candidate date and the store's
+ * `timezone` (from `getStoreInfo()`) — into `computeAvailableSlots()` to
+ * render a disabled-dates list or time-slot picker; the backend independently
+ * re-validates every submitted value against these same constraints, so this
+ * is purely a client-side UX aid, not the source of enforcement.
+ *
+ * This type intentionally mirrors (but does not import)
+ * `DateAvailabilityConstraints` from `@brainerce/types` — the SDK has no
+ * runtime dependency on that package. Keep the two in sync by hand.
+ */
+interface DateAvailabilityConstraints {
+    /** "YYYY-MM-DD", inclusive. */
+    minDate?: string;
+    /** "YYYY-MM-DD", inclusive. */
+    maxDate?: string;
+    /** Subset of 0-6; any weekday(s) fully blocked regardless of date. */
+    blockedWeekdays?: number[];
+    /** Specific blocked calendar dates, e.g. holidays: ["2026-12-25"]. */
+    blockedDates?: string[];
+    /** Per-weekday open/close windows. Omitted weekday = closed all day. Only meaningful on DATETIME fields. */
+    businessHours?: BusinessHoursWindow[];
+    /** Minutes per bookable slot within businessHours. Requires businessHours. Only meaningful on DATETIME fields. */
+    slotDurationMinutes?: number;
+}
 /**
  * Metafield type for defining value structure
  */
@@ -4514,6 +4562,8 @@ interface MetafieldDefinition {
     maxLength?: number | null;
     minValue?: number | null;
     maxValue?: number | null;
+    /** Date/time constraints for DATE/DATETIME fields — see `computeAvailableSlots()`. */
+    dateAvailability?: DateAvailabilityConstraints | null;
     /** Allowed values for SELECT / MULTI_SELECT fields, with optional swatch metadata. */
     enumValues?: CustomizationFieldOption[] | null;
     defaultValue?: string | null;
@@ -4605,6 +4655,8 @@ interface PublicMetafieldDefinition {
     maxLength?: number | null;
     minValue?: number | null;
     maxValue?: number | null;
+    /** Date/time constraints for DATE/DATETIME fields — see `computeAvailableSlots()`. */
+    dateAvailability?: DateAvailabilityConstraints | null;
     defaultValue?: string | null;
     position: number;
 }
@@ -5398,7 +5450,7 @@ interface CheckoutCustomFieldDefinition {
      * `MULTI_SELECT` are NOT supported for checkout fields — those are
      * product-metafield-only (`ProductCustomizationField` / `MetafieldType`).
      */
-    type: 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATE' | 'IMAGE';
+    type: 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATE' | 'DATETIME' | 'IMAGE';
     required: boolean;
     position: number;
     visibility: CheckoutFieldVisibility;
@@ -5411,6 +5463,8 @@ interface CheckoutCustomFieldDefinition {
     maxLength?: number | null;
     minValue?: number | null;
     maxValue?: number | null;
+    /** Date/time constraints for DATE/DATETIME fields — see `computeAvailableSlots()`. */
+    dateAvailability?: DateAvailabilityConstraints | null;
     translations?: Record<string, Record<string, string>> | null;
 }
 interface CheckoutFieldVisibility {
@@ -5943,6 +5997,7 @@ interface BlogPost {
     seoTitle?: string;
     seoDescription?: string;
     ogImageUrl?: string;
+    translations?: Record<string, Record<string, string>> | null;
     createdAt: string;
     updatedAt: string;
 }
@@ -10736,6 +10791,59 @@ declare function formatVariantPrice(variant: Pick<ProductVariant, 'price' | 'sal
 /** Format any numeric amount as currency. Useful for cart totals, fees, etc. */
 declare function formatMoney(amount: number, currency: string, locale?: string): string;
 
+/**
+ * Config well-formedness — mirrors the backend's own check. Returns
+ * human-readable error strings; empty array = valid. Storefronts don't
+ * generally need this (only admins author the config), but it's exposed for
+ * any storefront building its own admin-like UI on top of the SDK.
+ */
+declare function validateDateAvailabilityConfig(config: DateAvailabilityConstraints | null | undefined, fieldType: 'DATE' | 'DATETIME'): string[];
+interface StoreLocalParts {
+    /** "YYYY-MM-DD" in the given timezone. */
+    dateYYYYMMDD: string;
+    /** "HH:mm" in the given timezone. */
+    hhmm: string;
+    /** 0 = Sunday .. 6 = Saturday. */
+    weekday: number;
+}
+/**
+ * Resolves an absolute instant to the store-local calendar date, "HH:mm",
+ * and weekday. Use `getStoreInfo().timezone` as the `timezone` argument —
+ * never the shopper's browser timezone, or "is Friday blocked" will
+ * disagree with the backend's own answer for shoppers in a different zone.
+ * Falls back to UTC parts on an invalid IANA timezone string — never throws.
+ */
+declare function resolveStoreLocalParts(instant: Date, timezone: string): StoreLocalParts;
+/** Day-level gate: minDate/maxDate/blockedWeekdays/blockedDates only (no time-of-day). */
+declare function isCalendarDateAllowed(dateYYYYMMDD: string, config: DateAvailabilityConstraints | null | undefined): boolean;
+/**
+ * Discrete slot starts ("HH:mm", store-local) for one calendar date. Empty
+ * array if: the date fails `isCalendarDateAllowed`, no `businessHours` window
+ * covers that weekday, or `slotDurationMinutes` is unset. A trailing slot
+ * whose end would exceed `close` is dropped, not clamped. No
+ * capacity/overbooking accounting — purely "which slots exist".
+ *
+ * Feed this into your own date-picker/slot-picker UI, e.g.:
+ * ```ts
+ * const { timezone } = await client.getStoreInfo();
+ * const fields = await client.getCheckoutCustomFields(checkoutId);
+ * const deliveryField = fields.find((f) => f.key === 'delivery_slot');
+ * const local = resolveStoreLocalParts(candidateDate, timezone);
+ * const slots = computeAvailableSlots(deliveryField?.dateAvailability, local.dateYYYYMMDD);
+ * ```
+ */
+declare function computeAvailableSlots(config: DateAvailabilityConstraints | null | undefined, dateYYYYMMDD: string): string[];
+/**
+ * Full value validation for a candidate date/datetime a shopper is about to
+ * submit — use this to disable a "Continue" button client-side before the
+ * backend's own (authoritative) rejection would otherwise surface as an
+ * error after a round trip.
+ */
+declare function isDateValueAllowed(instant: Date, config: DateAvailabilityConstraints | null | undefined, fieldType: 'DATE' | 'DATETIME', timezone: string): {
+    allowed: boolean;
+    reason?: string;
+};
+
 /**
  * JSON-LD (schema.org) builders for storefronts.
  *
@@ -10881,4 +10989,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 BlogSitemapOptions, 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 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 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 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 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 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 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, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getBlogSitemapEntries, getCartItemImage, getCartItemName, getCartTotals, getCategorySitemapEntries, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, jsonLdScriptProps, parseWebhookEvent, safePaymentRedirect, stripHtml, 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 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 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 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 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 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 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, 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, parseWebhookEvent, resolveStoreLocalParts, safePaymentRedirect, stripHtml, validateDateAvailabilityConfig, verifyWebhook };

package/dist/index.js

@@ -40,6 +40,7 @@ __export(index_exports, {
   buildOrganizationJsonLd: () => buildOrganizationJsonLd,
   buildProductJsonLd: () => buildProductJsonLd,
   buildWebsiteJsonLd: () => buildWebsiteJsonLd,
+  computeAvailableSlots: () => computeAvailableSlots,
   createWebhookHandler: () => createWebhookHandler,
   deriveSeoDescription: () => deriveSeoDescription,
   enableDevGuards: () => enableDevGuards,
@@ -66,13 +67,17 @@ __export(index_exports, {
   getVariantOptions: () => getVariantOptions,
   getVariantPrice: () => getVariantPrice,
   isAllowedPaymentUrl: () => isAllowedPaymentUrl,
+  isCalendarDateAllowed: () => isCalendarDateAllowed,
   isCouponApplicableToProduct: () => isCouponApplicableToProduct,
+  isDateValueAllowed: () => isDateValueAllowed,
   isHtmlDescription: () => isHtmlDescription,
   isWebhookEventType: () => isWebhookEventType,
   jsonLdScriptProps: () => jsonLdScriptProps,
   parseWebhookEvent: () => parseWebhookEvent,
+  resolveStoreLocalParts: () => resolveStoreLocalParts,
   safePaymentRedirect: () => safePaymentRedirect,
   stripHtml: () => stripHtml2,
+  validateDateAvailabilityConfig: () => validateDateAvailabilityConfig,
   verifyWebhook: () => verifyWebhook
 });
 module.exports = __toCommonJS(index_exports);
@@ -9189,6 +9194,183 @@ function formatAmount(amount, currency, locale) {
   }
 }
 
+// src/date-availability.ts
+var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+var TIME_RE = /^([01]\d|2[0-3]):[0-5]\d$/;
+function validateDateAvailabilityConfig(config, fieldType) {
+  const errors = [];
+  if (!config) return errors;
+  if (config.minDate !== void 0 && !DATE_RE.test(config.minDate)) {
+    errors.push("minDate must be in YYYY-MM-DD format");
+  }
+  if (config.maxDate !== void 0 && !DATE_RE.test(config.maxDate)) {
+    errors.push("maxDate must be in YYYY-MM-DD format");
+  }
+  if (config.minDate && config.maxDate && DATE_RE.test(config.minDate) && DATE_RE.test(config.maxDate) && config.minDate > config.maxDate) {
+    errors.push("minDate must be on or before maxDate");
+  }
+  if (config.blockedWeekdays) {
+    for (const d of config.blockedWeekdays) {
+      if (!Number.isInteger(d) || d < 0 || d > 6) {
+        errors.push(`blockedWeekdays entries must be integers 0-6, got ${JSON.stringify(d)}`);
+        break;
+      }
+    }
+  }
+  if (config.blockedDates) {
+    for (const d of config.blockedDates) {
+      if (!DATE_RE.test(d)) {
+        errors.push(`blockedDates entries must be in YYYY-MM-DD format, got "${d}"`);
+        break;
+      }
+    }
+  }
+  if (config.businessHours) {
+    const seenWeekdays = /* @__PURE__ */ new Set();
+    for (const w of config.businessHours) {
+      if (!Number.isInteger(w.weekday) || w.weekday < 0 || w.weekday > 6) {
+        errors.push(`businessHours.weekday must be an integer 0-6, got ${JSON.stringify(w.weekday)}`);
+        continue;
+      }
+      if (seenWeekdays.has(w.weekday)) {
+        errors.push(`businessHours has more than one window for weekday ${w.weekday}`);
+      }
+      seenWeekdays.add(w.weekday);
+      const openValid = TIME_RE.test(w.open);
+      const closeValid = TIME_RE.test(w.close);
+      if (!openValid) errors.push(`businessHours.open must be HH:mm, got "${w.open}"`);
+      if (!closeValid) errors.push(`businessHours.close must be HH:mm, got "${w.close}"`);
+      if (openValid && closeValid && w.open >= w.close) {
+        errors.push(`businessHours for weekday ${w.weekday}: open must be before close`);
+      }
+    }
+  }
+  if (config.slotDurationMinutes !== void 0) {
+    if (!Number.isInteger(config.slotDurationMinutes) || config.slotDurationMinutes <= 0) {
+      errors.push("slotDurationMinutes must be a positive integer");
+    }
+    if (!config.businessHours || config.businessHours.length === 0) {
+      errors.push("slotDurationMinutes requires at least one businessHours window");
+    }
+  }
+  if (fieldType === "DATE" && (config.businessHours?.length || config.slotDurationMinutes !== void 0)) {
+    errors.push("businessHours/slotDurationMinutes only apply to DATETIME fields, not DATE");
+  }
+  return errors;
+}
+var WEEKDAY_TO_INDEX = {
+  Sun: 0,
+  Mon: 1,
+  Tue: 2,
+  Wed: 3,
+  Thu: 4,
+  Fri: 5,
+  Sat: 6
+};
+function resolveStoreLocalParts(instant, timezone) {
+  let parts;
+  try {
+    const fmt = new Intl.DateTimeFormat("en-US", {
+      timeZone: timezone,
+      weekday: "short",
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      hour12: false
+    });
+    parts = fmt.formatToParts(instant);
+  } catch {
+    return {
+      dateYYYYMMDD: `${instant.getUTCFullYear()}-${pad2(instant.getUTCMonth() + 1)}-${pad2(instant.getUTCDate())}`,
+      hhmm: `${pad2(instant.getUTCHours())}:${pad2(instant.getUTCMinutes())}`,
+      weekday: instant.getUTCDay()
+    };
+  }
+  const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+  let hour = get("hour");
+  if (hour === "24") hour = "00";
+  return {
+    dateYYYYMMDD: `${get("year")}-${get("month")}-${get("day")}`,
+    hhmm: `${hour}:${get("minute")}`,
+    weekday: WEEKDAY_TO_INDEX[get("weekday")] ?? instant.getUTCDay()
+  };
+}
+function isCalendarDateAllowed(dateYYYYMMDD, config) {
+  if (!config) return true;
+  if (config.minDate && dateYYYYMMDD < config.minDate) return false;
+  if (config.maxDate && dateYYYYMMDD > config.maxDate) return false;
+  if (config.blockedDates?.includes(dateYYYYMMDD)) return false;
+  if (config.blockedWeekdays?.length) {
+    if (config.blockedWeekdays.includes(weekdayOfDateString(dateYYYYMMDD))) return false;
+  }
+  return true;
+}
+function computeAvailableSlots(config, dateYYYYMMDD) {
+  if (!config) return [];
+  if (!isCalendarDateAllowed(dateYYYYMMDD, config)) return [];
+  if (!config.businessHours?.length || !config.slotDurationMinutes) return [];
+  const weekday = weekdayOfDateString(dateYYYYMMDD);
+  const windows = config.businessHours.filter((w) => w.weekday === weekday);
+  if (windows.length === 0) return [];
+  const slots = [];
+  for (const w of windows) {
+    const openMin = toMinutes(w.open);
+    const closeMin = toMinutes(w.close);
+    for (let t = openMin; t + config.slotDurationMinutes <= closeMin; t += config.slotDurationMinutes) {
+      slots.push(minutesToHHMM(t));
+    }
+  }
+  return slots;
+}
+function isDateValueAllowed(instant, config, fieldType, timezone) {
+  if (!config) return { allowed: true };
+  if (fieldType === "DATE") {
+    const dateYYYYMMDD = `${instant.getUTCFullYear()}-${pad2(instant.getUTCMonth() + 1)}-${pad2(instant.getUTCDate())}`;
+    if (!isCalendarDateAllowed(dateYYYYMMDD, config)) {
+      return { allowed: false, reason: "date is outside the allowed range" };
+    }
+    return { allowed: true };
+  }
+  const local = resolveStoreLocalParts(instant, timezone);
+  if (!isCalendarDateAllowed(local.dateYYYYMMDD, config)) {
+    return { allowed: false, reason: "date is outside the allowed range" };
+  }
+  if (!config.businessHours?.length) {
+    return { allowed: true };
+  }
+  const windows = config.businessHours.filter((w) => w.weekday === local.weekday);
+  if (windows.length === 0) {
+    return { allowed: false, reason: "no business hours are configured for this day" };
+  }
+  if (config.slotDurationMinutes) {
+    const slots = computeAvailableSlots(config, local.dateYYYYMMDD);
+    if (!slots.includes(local.hhmm)) {
+      return { allowed: false, reason: "time does not match an available slot" };
+    }
+    return { allowed: true };
+  }
+  const inWindow = windows.some((w) => local.hhmm >= w.open && local.hhmm < w.close);
+  if (!inWindow) {
+    return { allowed: false, reason: "time is outside business hours" };
+  }
+  return { allowed: true };
+}
+function weekdayOfDateString(dateYYYYMMDD) {
+  return (/* @__PURE__ */ new Date(`${dateYYYYMMDD}T00:00:00Z`)).getUTCDay();
+}
+function toMinutes(hhmm) {
+  const [h, m] = hhmm.split(":").map(Number);
+  return h * 60 + m;
+}
+function minutesToHHMM(totalMinutes) {
+  return `${pad2(Math.floor(totalMinutes / 60))}:${pad2(totalMinutes % 60)}`;
+}
+function pad2(n) {
+  return n.toString().padStart(2, "0");
+}
+
 // src/jsonld.ts
 function absoluteUrl(siteUrl, path) {
   if (!path) return void 0;
@@ -9682,6 +9864,7 @@ function isCouponApplicableToProduct(coupon, productId) {
   buildOrganizationJsonLd,
   buildProductJsonLd,
   buildWebsiteJsonLd,
+  computeAvailableSlots,
   createWebhookHandler,
   deriveSeoDescription,
   enableDevGuards,
@@ -9708,12 +9891,16 @@ function isCouponApplicableToProduct(coupon, productId) {
   getVariantOptions,
   getVariantPrice,
   isAllowedPaymentUrl,
+  isCalendarDateAllowed,
   isCouponApplicableToProduct,
+  isDateValueAllowed,
   isHtmlDescription,
   isWebhookEventType,
   jsonLdScriptProps,
   parseWebhookEvent,
+  resolveStoreLocalParts,
   safePaymentRedirect,
   stripHtml,
+  validateDateAvailabilityConfig,
   verifyWebhook
 });

package/dist/index.mjs

@@ -9110,6 +9110,183 @@ function formatAmount(amount, currency, locale) {
   }
 }
 
+// src/date-availability.ts
+var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+var TIME_RE = /^([01]\d|2[0-3]):[0-5]\d$/;
+function validateDateAvailabilityConfig(config, fieldType) {
+  const errors = [];
+  if (!config) return errors;
+  if (config.minDate !== void 0 && !DATE_RE.test(config.minDate)) {
+    errors.push("minDate must be in YYYY-MM-DD format");
+  }
+  if (config.maxDate !== void 0 && !DATE_RE.test(config.maxDate)) {
+    errors.push("maxDate must be in YYYY-MM-DD format");
+  }
+  if (config.minDate && config.maxDate && DATE_RE.test(config.minDate) && DATE_RE.test(config.maxDate) && config.minDate > config.maxDate) {
+    errors.push("minDate must be on or before maxDate");
+  }
+  if (config.blockedWeekdays) {
+    for (const d of config.blockedWeekdays) {
+      if (!Number.isInteger(d) || d < 0 || d > 6) {
+        errors.push(`blockedWeekdays entries must be integers 0-6, got ${JSON.stringify(d)}`);
+        break;
+      }
+    }
+  }
+  if (config.blockedDates) {
+    for (const d of config.blockedDates) {
+      if (!DATE_RE.test(d)) {
+        errors.push(`blockedDates entries must be in YYYY-MM-DD format, got "${d}"`);
+        break;
+      }
+    }
+  }
+  if (config.businessHours) {
+    const seenWeekdays = /* @__PURE__ */ new Set();
+    for (const w of config.businessHours) {
+      if (!Number.isInteger(w.weekday) || w.weekday < 0 || w.weekday > 6) {
+        errors.push(`businessHours.weekday must be an integer 0-6, got ${JSON.stringify(w.weekday)}`);
+        continue;
+      }
+      if (seenWeekdays.has(w.weekday)) {
+        errors.push(`businessHours has more than one window for weekday ${w.weekday}`);
+      }
+      seenWeekdays.add(w.weekday);
+      const openValid = TIME_RE.test(w.open);
+      const closeValid = TIME_RE.test(w.close);
+      if (!openValid) errors.push(`businessHours.open must be HH:mm, got "${w.open}"`);
+      if (!closeValid) errors.push(`businessHours.close must be HH:mm, got "${w.close}"`);
+      if (openValid && closeValid && w.open >= w.close) {
+        errors.push(`businessHours for weekday ${w.weekday}: open must be before close`);
+      }
+    }
+  }
+  if (config.slotDurationMinutes !== void 0) {
+    if (!Number.isInteger(config.slotDurationMinutes) || config.slotDurationMinutes <= 0) {
+      errors.push("slotDurationMinutes must be a positive integer");
+    }
+    if (!config.businessHours || config.businessHours.length === 0) {
+      errors.push("slotDurationMinutes requires at least one businessHours window");
+    }
+  }
+  if (fieldType === "DATE" && (config.businessHours?.length || config.slotDurationMinutes !== void 0)) {
+    errors.push("businessHours/slotDurationMinutes only apply to DATETIME fields, not DATE");
+  }
+  return errors;
+}
+var WEEKDAY_TO_INDEX = {
+  Sun: 0,
+  Mon: 1,
+  Tue: 2,
+  Wed: 3,
+  Thu: 4,
+  Fri: 5,
+  Sat: 6
+};
+function resolveStoreLocalParts(instant, timezone) {
+  let parts;
+  try {
+    const fmt = new Intl.DateTimeFormat("en-US", {
+      timeZone: timezone,
+      weekday: "short",
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      hour12: false
+    });
+    parts = fmt.formatToParts(instant);
+  } catch {
+    return {
+      dateYYYYMMDD: `${instant.getUTCFullYear()}-${pad2(instant.getUTCMonth() + 1)}-${pad2(instant.getUTCDate())}`,
+      hhmm: `${pad2(instant.getUTCHours())}:${pad2(instant.getUTCMinutes())}`,
+      weekday: instant.getUTCDay()
+    };
+  }
+  const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+  let hour = get("hour");
+  if (hour === "24") hour = "00";
+  return {
+    dateYYYYMMDD: `${get("year")}-${get("month")}-${get("day")}`,
+    hhmm: `${hour}:${get("minute")}`,
+    weekday: WEEKDAY_TO_INDEX[get("weekday")] ?? instant.getUTCDay()
+  };
+}
+function isCalendarDateAllowed(dateYYYYMMDD, config) {
+  if (!config) return true;
+  if (config.minDate && dateYYYYMMDD < config.minDate) return false;
+  if (config.maxDate && dateYYYYMMDD > config.maxDate) return false;
+  if (config.blockedDates?.includes(dateYYYYMMDD)) return false;
+  if (config.blockedWeekdays?.length) {
+    if (config.blockedWeekdays.includes(weekdayOfDateString(dateYYYYMMDD))) return false;
+  }
+  return true;
+}
+function computeAvailableSlots(config, dateYYYYMMDD) {
+  if (!config) return [];
+  if (!isCalendarDateAllowed(dateYYYYMMDD, config)) return [];
+  if (!config.businessHours?.length || !config.slotDurationMinutes) return [];
+  const weekday = weekdayOfDateString(dateYYYYMMDD);
+  const windows = config.businessHours.filter((w) => w.weekday === weekday);
+  if (windows.length === 0) return [];
+  const slots = [];
+  for (const w of windows) {
+    const openMin = toMinutes(w.open);
+    const closeMin = toMinutes(w.close);
+    for (let t = openMin; t + config.slotDurationMinutes <= closeMin; t += config.slotDurationMinutes) {
+      slots.push(minutesToHHMM(t));
+    }
+  }
+  return slots;
+}
+function isDateValueAllowed(instant, config, fieldType, timezone) {
+  if (!config) return { allowed: true };
+  if (fieldType === "DATE") {
+    const dateYYYYMMDD = `${instant.getUTCFullYear()}-${pad2(instant.getUTCMonth() + 1)}-${pad2(instant.getUTCDate())}`;
+    if (!isCalendarDateAllowed(dateYYYYMMDD, config)) {
+      return { allowed: false, reason: "date is outside the allowed range" };
+    }
+    return { allowed: true };
+  }
+  const local = resolveStoreLocalParts(instant, timezone);
+  if (!isCalendarDateAllowed(local.dateYYYYMMDD, config)) {
+    return { allowed: false, reason: "date is outside the allowed range" };
+  }
+  if (!config.businessHours?.length) {
+    return { allowed: true };
+  }
+  const windows = config.businessHours.filter((w) => w.weekday === local.weekday);
+  if (windows.length === 0) {
+    return { allowed: false, reason: "no business hours are configured for this day" };
+  }
+  if (config.slotDurationMinutes) {
+    const slots = computeAvailableSlots(config, local.dateYYYYMMDD);
+    if (!slots.includes(local.hhmm)) {
+      return { allowed: false, reason: "time does not match an available slot" };
+    }
+    return { allowed: true };
+  }
+  const inWindow = windows.some((w) => local.hhmm >= w.open && local.hhmm < w.close);
+  if (!inWindow) {
+    return { allowed: false, reason: "time is outside business hours" };
+  }
+  return { allowed: true };
+}
+function weekdayOfDateString(dateYYYYMMDD) {
+  return (/* @__PURE__ */ new Date(`${dateYYYYMMDD}T00:00:00Z`)).getUTCDay();
+}
+function toMinutes(hhmm) {
+  const [h, m] = hhmm.split(":").map(Number);
+  return h * 60 + m;
+}
+function minutesToHHMM(totalMinutes) {
+  return `${pad2(Math.floor(totalMinutes / 60))}:${pad2(totalMinutes % 60)}`;
+}
+function pad2(n) {
+  return n.toString().padStart(2, "0");
+}
+
 // src/jsonld.ts
 function absoluteUrl(siteUrl, path) {
   if (!path) return void 0;
@@ -9602,6 +9779,7 @@ export {
   buildOrganizationJsonLd,
   buildProductJsonLd,
   buildWebsiteJsonLd,
+  computeAvailableSlots,
   createWebhookHandler,
   deriveSeoDescription,
   enableDevGuards,
@@ -9628,12 +9806,16 @@ export {
   getVariantOptions,
   getVariantPrice,
   isAllowedPaymentUrl,
+  isCalendarDateAllowed,
   isCouponApplicableToProduct,
+  isDateValueAllowed,
   isHtmlDescription,
   isWebhookEventType,
   jsonLdScriptProps,
   parseWebhookEvent,
+  resolveStoreLocalParts,
   safePaymentRedirect,
   stripHtml2 as stripHtml,
+  validateDateAvailabilityConfig,
   verifyWebhook
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.48.0",
+  "version": "1.49.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",
@@ -62,6 +62,7 @@
     "url": "https://github.com/brainerce/brainerce/issues"
   },
   "devDependencies": {
+    "@brainerce/types": "workspace:*",
     "@types/node": "^25.0.3",
     "@typescript-eslint/eslint-plugin": "^8.50.1",
     "@typescript-eslint/parser": "^8.50.1",