@kizlo/woocommerce 0.9.0 → 0.11.0

package/README.md

@@ -42,6 +42,39 @@ pnpm add @kizlo/woocommerce
 
 See the [docs](https://kizlo.io/docs) for setup and usage.
 
+## Billing Tax IDs
+
+Billing addresses expose `taxId` on customers, carts, checkout responses, and orders. The field is always a string on output and defaults to `""` when it has not been set. Billing address inputs accept an optional `taxId`; shipping addresses never expose or persist one.
+
+```ts
+await kizlo.woocommerce.cart.update.call({
+  body: { billingAddress: { taxId: "GB123456789" } },
+})
+```
+
+Store administrators can make the field mandatory from **WooCommerce → Settings → Accounts & Privacy → Checkout → Require Tax ID at checkout**. It remains optional by default.
+
+## Storefront settings
+
+`storefront.get` returns the store-wide settings a storefront renders with, so nothing has to be hardcoded:
+
+- `address`: the countries the store sells and ships to, their states, the per-country field rules, and every checkout field including ones plugins register
+- `checkout`: guest checkout, coupons, tax display, shipping and local pickup
+- `pricing`: the currency format, plus how prices show tax
+- `catalog`: units, review rules and stock display
+
+A field's rules for a country are its default merged with that country's override, the way WooCommerce's Checkout block builds them:
+
+```ts
+const store = await kizlo.woocommerce.storefront.get.call()
+
+const country = store.address.countries.find((entry) => entry.code === "AE")
+const postcode = { ...store.address.fields.postcode, ...country?.locale.postcode }
+// { label: "Postal code", required: false, hidden: true, ... }
+```
+
+The response is cached in WordPress per locale. Changing a WooCommerce setting clears it and sends the `settings.woocommerce.updated` webhook event.
+
 ## License
 
-[Apache 2.0](./LICENSE) © Kizlo
+[Apache 2.0](./LICENSE) © Kizlo

package/dist/index.d.ts

@@ -29,6 +29,7 @@ declare const CartShippingAddress: z$1.ZodObject<{
 type CartShippingAddress = z$1.infer<typeof CartShippingAddress>;
 declare const CartBillingAddress: z$1.ZodObject<{
   email: z$1.ZodString;
+  taxId: z$1.ZodDefault<z$1.ZodString>;
   firstName: z$1.ZodString;
   lastName: z$1.ZodString;
   company: z$1.ZodString;
@@ -344,6 +345,7 @@ declare const Cart: z$1.ZodObject<{
   itemsWeight: z$1.ZodNumber;
   billingAddress: z$1.ZodObject<{
     email: z$1.ZodString;
+    taxId: z$1.ZodDefault<z$1.ZodString>;
     firstName: z$1.ZodString;
     lastName: z$1.ZodString;
     company: z$1.ZodString;
@@ -619,6 +621,7 @@ declare const UpdateCartInput: z$1.ZodObject<{
   }, z$1.core.$strip>>;
   billingAddress: z$1.ZodOptional<z$1.ZodObject<{
     email: z$1.ZodOptional<z$1.ZodString>;
+    taxId: z$1.ZodOptional<z$1.ZodDefault<z$1.ZodString>>;
     firstName: z$1.ZodOptional<z$1.ZodString>;
     lastName: z$1.ZodOptional<z$1.ZodString>;
     company: z$1.ZodOptional<z$1.ZodString>;
@@ -663,6 +666,7 @@ declare const Checkout: z$2.ZodObject<{
   customerNote: z$2.ZodString;
   billingAddress: z$2.ZodObject<{
     email: z$2.ZodString;
+    taxId: z$2.ZodDefault<z$2.ZodString>;
     firstName: z$2.ZodString;
     lastName: z$2.ZodString;
     company: z$2.ZodString;
@@ -770,6 +774,7 @@ declare const Checkout: z$2.ZodObject<{
     itemsWeight: z$2.ZodNumber;
     billingAddress: z$2.ZodObject<{
       email: z$2.ZodString;
+      taxId: z$2.ZodDefault<z$2.ZodString>;
       firstName: z$2.ZodString;
       lastName: z$2.ZodString;
       company: z$2.ZodString;
@@ -1008,6 +1013,7 @@ type UpdateCheckoutInput = z$2.input<typeof UpdateCheckoutInput>;
 declare const ConfirmCheckoutInput: z$2.ZodObject<{
   billingAddress: z$2.ZodObject<{
     email: z$2.ZodString;
+    taxId: z$2.ZodDefault<z$2.ZodString>;
     firstName: z$2.ZodString;
     lastName: z$2.ZodString;
     company: z$2.ZodString;
@@ -1054,6 +1060,7 @@ declare const RetryCheckoutInput: z$2.ZodObject<{
   billingEmail: z$2.ZodOptional<z$2.ZodEmail>;
   billingAddress: z$2.ZodObject<{
     email: z$2.ZodString;
+    taxId: z$2.ZodDefault<z$2.ZodString>;
     firstName: z$2.ZodString;
     lastName: z$2.ZodString;
     company: z$2.ZodString;
@@ -1132,6 +1139,7 @@ declare const OrderItem: z.ZodObject<{
   id: z.ZodNumber;
   productId: z.ZodNullable<z.ZodNumber>;
   variationId: z.ZodNullable<z.ZodNumber>;
+  hsCode: z.ZodNullable<z.ZodString>;
   name: z.ZodString;
   quantity: z.ZodNumber;
   selectedAttributes: z.ZodArray<z.ZodObject<{
@@ -1225,6 +1233,7 @@ declare const Order: z.ZodObject<{
     id: z.ZodNumber;
     productId: z.ZodNullable<z.ZodNumber>;
     variationId: z.ZodNullable<z.ZodNumber>;
+    hsCode: z.ZodNullable<z.ZodString>;
     name: z.ZodString;
     quantity: z.ZodNumber;
     selectedAttributes: z.ZodArray<z.ZodObject<{
@@ -1296,6 +1305,7 @@ declare const Order: z.ZodObject<{
   }, z.core.$strip>>;
   billingAddress: z.ZodObject<{
     email: z.ZodString;
+    taxId: z.ZodDefault<z.ZodString>;
     firstName: z.ZodString;
     lastName: z.ZodString;
     company: z.ZodString;
@@ -2035,6 +2045,7 @@ declare const Product: z.ZodObject<{
   formattedWeight: z.ZodString;
   formattedDimensions: z.ZodString;
   stockQuantity: z.ZodNullable<z.ZodNumber>;
+  hsCode: z.ZodNullable<z.ZodString>;
   saleStartsAt: z.ZodNullable<z.ZodNumber>;
   saleEndsAt: z.ZodNullable<z.ZodNumber>;
   seo: z.ZodNullable<z.ZodObject<{
@@ -2537,6 +2548,7 @@ declare const ProductList: z.ZodObject<{
     formattedWeight: z.ZodString;
     formattedDimensions: z.ZodString;
     stockQuantity: z.ZodNullable<z.ZodNumber>;
+    hsCode: z.ZodNullable<z.ZodString>;
     saleStartsAt: z.ZodNullable<z.ZodNumber>;
     saleEndsAt: z.ZodNullable<z.ZodNumber>;
     seo: z.ZodNullable<z.ZodObject<{
@@ -3380,6 +3392,229 @@ declare const RetrieveProductFiltersInput: z.ZodObject<{
 type RetrieveProductFiltersInput = z.input<typeof RetrieveProductFiltersInput>;
 type RetrieveProductFiltersInputOut = z.output<typeof RetrieveProductFiltersInput>;
 //#endregion
+//#region src/storefront/schema.d.ts
+/**
+ * A plugin-registered field may make `required` or `hidden` a JSON Schema rule evaluated against the
+ * checkout rather than a fixed boolean.
+ */
+declare const StorefrontFieldRule: z$2.ZodUnion<readonly [z$2.ZodBoolean, z$2.ZodRecord<z$2.ZodString, z$2.ZodUnknown>]>;
+type StorefrontFieldRule = z$2.infer<typeof StorefrontFieldRule>;
+declare const StorefrontFieldOption: z$2.ZodObject<{
+  value: z$2.ZodString;
+  label: z$2.ZodString;
+}, z$2.core.$strip>;
+type StorefrontFieldOption = z$2.infer<typeof StorefrontFieldOption>;
+declare const StorefrontField: z$2.ZodObject<{
+  label: z$2.ZodString;
+  optionalLabel: z$2.ZodString;
+  required: z$2.ZodUnion<readonly [z$2.ZodBoolean, z$2.ZodRecord<z$2.ZodString, z$2.ZodUnknown>]>;
+  hidden: z$2.ZodUnion<readonly [z$2.ZodBoolean, z$2.ZodRecord<z$2.ZodString, z$2.ZodUnknown>]>;
+  type: z$2.ZodNullable<z$2.ZodString>;
+  autocomplete: z$2.ZodNullable<z$2.ZodString>;
+  index: z$2.ZodNullable<z$2.ZodNumber>;
+  placeholder: z$2.ZodNullable<z$2.ZodString>;
+  options: z$2.ZodArray<z$2.ZodObject<{
+    value: z$2.ZodString;
+    label: z$2.ZodString;
+  }, z$2.core.$strip>>;
+}, z$2.core.$strip>;
+type StorefrontField = z$2.infer<typeof StorefrontField>;
+/** What a country changes about a field. Anything it leaves out keeps the field's default. */
+declare const StorefrontFieldOverride: z$2.ZodObject<{
+  label: z$2.ZodOptional<z$2.ZodString>;
+  required: z$2.ZodOptional<z$2.ZodBoolean>;
+  hidden: z$2.ZodOptional<z$2.ZodBoolean>;
+  index: z$2.ZodOptional<z$2.ZodNumber>;
+}, z$2.core.$strip>;
+type StorefrontFieldOverride = z$2.infer<typeof StorefrontFieldOverride>;
+declare const StorefrontCountry: z$2.ZodObject<{
+  code: z$2.ZodString;
+  name: z$2.ZodString;
+  allowBilling: z$2.ZodBoolean;
+  allowShipping: z$2.ZodBoolean;
+  states: z$2.ZodArray<z$2.ZodObject<{
+    code: z$2.ZodString;
+    name: z$2.ZodString;
+  }, z$2.core.$strip>>;
+  locale: z$2.ZodRecord<z$2.ZodString, z$2.ZodObject<{
+    label: z$2.ZodOptional<z$2.ZodString>;
+    required: z$2.ZodOptional<z$2.ZodBoolean>;
+    hidden: z$2.ZodOptional<z$2.ZodBoolean>;
+    index: z$2.ZodOptional<z$2.ZodNumber>;
+  }, z$2.core.$strip>>;
+  format: z$2.ZodString;
+}, z$2.core.$strip>;
+type StorefrontCountry = z$2.infer<typeof StorefrontCountry>;
+declare const StorefrontAddress: z$2.ZodObject<{
+  countries: z$2.ZodArray<z$2.ZodObject<{
+    code: z$2.ZodString;
+    name: z$2.ZodString;
+    allowBilling: z$2.ZodBoolean;
+    allowShipping: z$2.ZodBoolean;
+    states: z$2.ZodArray<z$2.ZodObject<{
+      code: z$2.ZodString;
+      name: z$2.ZodString;
+    }, z$2.core.$strip>>;
+    locale: z$2.ZodRecord<z$2.ZodString, z$2.ZodObject<{
+      label: z$2.ZodOptional<z$2.ZodString>;
+      required: z$2.ZodOptional<z$2.ZodBoolean>;
+      hidden: z$2.ZodOptional<z$2.ZodBoolean>;
+      index: z$2.ZodOptional<z$2.ZodNumber>;
+    }, z$2.core.$strip>>;
+    format: z$2.ZodString;
+  }, z$2.core.$strip>>;
+  defaultAddressFormat: z$2.ZodString;
+  fields: z$2.ZodRecord<z$2.ZodString, z$2.ZodObject<{
+    label: z$2.ZodString;
+    optionalLabel: z$2.ZodString;
+    required: z$2.ZodUnion<readonly [z$2.ZodBoolean, z$2.ZodRecord<z$2.ZodString, z$2.ZodUnknown>]>;
+    hidden: z$2.ZodUnion<readonly [z$2.ZodBoolean, z$2.ZodRecord<z$2.ZodString, z$2.ZodUnknown>]>;
+    type: z$2.ZodNullable<z$2.ZodString>;
+    autocomplete: z$2.ZodNullable<z$2.ZodString>;
+    index: z$2.ZodNullable<z$2.ZodNumber>;
+    placeholder: z$2.ZodNullable<z$2.ZodString>;
+    options: z$2.ZodArray<z$2.ZodObject<{
+      value: z$2.ZodString;
+      label: z$2.ZodString;
+    }, z$2.core.$strip>>;
+  }, z$2.core.$strip>>;
+  fieldLocations: z$2.ZodObject<{
+    address: z$2.ZodArray<z$2.ZodString>;
+    contact: z$2.ZodArray<z$2.ZodString>;
+    order: z$2.ZodArray<z$2.ZodString>;
+  }, z$2.core.$strip>;
+  baseCountry: z$2.ZodString;
+  defaultCountry: z$2.ZodNullable<z$2.ZodString>;
+}, z$2.core.$strip>;
+type StorefrontAddress = z$2.infer<typeof StorefrontAddress>;
+declare const StorefrontCheckout: z$2.ZodObject<{
+  allowsGuest: z$2.ZodBoolean;
+  couponsEnabled: z$2.ZodBoolean;
+  forcedBillingAddress: z$2.ZodBoolean;
+  taxesEnabled: z$2.ZodBoolean;
+  displayCartPricesIncludingTax: z$2.ZodBoolean;
+  displayItemizedTaxes: z$2.ZodBoolean;
+  shippingEnabled: z$2.ZodBoolean;
+  localPickup: z$2.ZodObject<{
+    enabled: z$2.ZodBoolean;
+    title: z$2.ZodString;
+    cost: z$2.ZodString;
+  }, z$2.core.$strip>;
+}, z$2.core.$strip>;
+type StorefrontCheckout = z$2.infer<typeof StorefrontCheckout>;
+declare const StorefrontPricing: z$2.ZodObject<{
+  currency: z$2.ZodObject<{
+    currencyCode: z$2.ZodString;
+    currencySymbol: z$2.ZodString;
+    currencyPrefix: z$2.ZodString;
+    currencySuffix: z$2.ZodString;
+    currencyMinorUnit: z$2.ZodNumber;
+    currencyDecimalSeparator: z$2.ZodString;
+    currencyThousandSeparator: z$2.ZodString;
+  }, z$2.core.$strip>;
+  pricesIncludeTax: z$2.ZodBoolean;
+  displayShopPricesIncludingTax: z$2.ZodBoolean;
+  priceSuffix: z$2.ZodString;
+}, z$2.core.$strip>;
+type StorefrontPricing = z$2.infer<typeof StorefrontPricing>;
+declare const StorefrontCatalog: z$2.ZodObject<{
+  weightUnit: z$2.ZodString;
+  dimensionUnit: z$2.ZodString;
+  reviewsEnabled: z$2.ZodBoolean;
+  reviewRatingsEnabled: z$2.ZodBoolean;
+  reviewRatingRequired: z$2.ZodBoolean;
+  reviewsVerifiedOwnersOnly: z$2.ZodBoolean;
+  stockFormat: z$2.ZodString;
+  hideOutOfStock: z$2.ZodBoolean;
+  placeholderImage: z$2.ZodString;
+  cartRedirectAfterAdd: z$2.ZodBoolean;
+}, z$2.core.$strip>;
+type StorefrontCatalog = z$2.infer<typeof StorefrontCatalog>;
+declare const Storefront: z$2.ZodObject<{
+  address: z$2.ZodObject<{
+    countries: z$2.ZodArray<z$2.ZodObject<{
+      code: z$2.ZodString;
+      name: z$2.ZodString;
+      allowBilling: z$2.ZodBoolean;
+      allowShipping: z$2.ZodBoolean;
+      states: z$2.ZodArray<z$2.ZodObject<{
+        code: z$2.ZodString;
+        name: z$2.ZodString;
+      }, z$2.core.$strip>>;
+      locale: z$2.ZodRecord<z$2.ZodString, z$2.ZodObject<{
+        label: z$2.ZodOptional<z$2.ZodString>;
+        required: z$2.ZodOptional<z$2.ZodBoolean>;
+        hidden: z$2.ZodOptional<z$2.ZodBoolean>;
+        index: z$2.ZodOptional<z$2.ZodNumber>;
+      }, z$2.core.$strip>>;
+      format: z$2.ZodString;
+    }, z$2.core.$strip>>;
+    defaultAddressFormat: z$2.ZodString;
+    fields: z$2.ZodRecord<z$2.ZodString, z$2.ZodObject<{
+      label: z$2.ZodString;
+      optionalLabel: z$2.ZodString;
+      required: z$2.ZodUnion<readonly [z$2.ZodBoolean, z$2.ZodRecord<z$2.ZodString, z$2.ZodUnknown>]>;
+      hidden: z$2.ZodUnion<readonly [z$2.ZodBoolean, z$2.ZodRecord<z$2.ZodString, z$2.ZodUnknown>]>;
+      type: z$2.ZodNullable<z$2.ZodString>;
+      autocomplete: z$2.ZodNullable<z$2.ZodString>;
+      index: z$2.ZodNullable<z$2.ZodNumber>;
+      placeholder: z$2.ZodNullable<z$2.ZodString>;
+      options: z$2.ZodArray<z$2.ZodObject<{
+        value: z$2.ZodString;
+        label: z$2.ZodString;
+      }, z$2.core.$strip>>;
+    }, z$2.core.$strip>>;
+    fieldLocations: z$2.ZodObject<{
+      address: z$2.ZodArray<z$2.ZodString>;
+      contact: z$2.ZodArray<z$2.ZodString>;
+      order: z$2.ZodArray<z$2.ZodString>;
+    }, z$2.core.$strip>;
+    baseCountry: z$2.ZodString;
+    defaultCountry: z$2.ZodNullable<z$2.ZodString>;
+  }, z$2.core.$strip>;
+  checkout: z$2.ZodObject<{
+    allowsGuest: z$2.ZodBoolean;
+    couponsEnabled: z$2.ZodBoolean;
+    forcedBillingAddress: z$2.ZodBoolean;
+    taxesEnabled: z$2.ZodBoolean;
+    displayCartPricesIncludingTax: z$2.ZodBoolean;
+    displayItemizedTaxes: z$2.ZodBoolean;
+    shippingEnabled: z$2.ZodBoolean;
+    localPickup: z$2.ZodObject<{
+      enabled: z$2.ZodBoolean;
+      title: z$2.ZodString;
+      cost: z$2.ZodString;
+    }, z$2.core.$strip>;
+  }, z$2.core.$strip>;
+  pricing: z$2.ZodObject<{
+    currency: z$2.ZodObject<{
+      currencyCode: z$2.ZodString;
+      currencySymbol: z$2.ZodString;
+      currencyPrefix: z$2.ZodString;
+      currencySuffix: z$2.ZodString;
+      currencyMinorUnit: z$2.ZodNumber;
+      currencyDecimalSeparator: z$2.ZodString;
+      currencyThousandSeparator: z$2.ZodString;
+    }, z$2.core.$strip>;
+    pricesIncludeTax: z$2.ZodBoolean;
+    displayShopPricesIncludingTax: z$2.ZodBoolean;
+    priceSuffix: z$2.ZodString;
+  }, z$2.core.$strip>;
+  catalog: z$2.ZodObject<{
+    weightUnit: z$2.ZodString;
+    dimensionUnit: z$2.ZodString;
+    reviewsEnabled: z$2.ZodBoolean;
+    reviewRatingsEnabled: z$2.ZodBoolean;
+    reviewRatingRequired: z$2.ZodBoolean;
+    reviewsVerifiedOwnersOnly: z$2.ZodBoolean;
+    stockFormat: z$2.ZodString;
+    hideOutOfStock: z$2.ZodBoolean;
+    placeholderImage: z$2.ZodString;
+    cartRedirectAfterAdd: z$2.ZodBoolean;
+  }, z$2.core.$strip>;
+}, z$2.core.$strip>;
+type Storefront = z$2.infer<typeof Storefront>;
+//#endregion
 //#region src/index.d.ts
 declare function woocommerce(): kizlo0.Integration<"woocommerce", {
   cart: {
@@ -3459,6 +3694,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
       itemsWeight: number;
       billingAddress: {
         email: string;
+        taxId: string;
         firstName: string;
         lastName: string;
         company: string;
@@ -3708,6 +3944,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         } | undefined;
         billingAddress?: {
           email?: string | undefined;
+          taxId?: string | undefined;
           firstName?: string | undefined;
           lastName?: string | undefined;
           company?: string | undefined;
@@ -3797,6 +4034,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
       itemsWeight: number;
       billingAddress: {
         email: string;
+        taxId: string;
         firstName: string;
         lastName: string;
         company: string;
@@ -4115,6 +4353,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
       itemsWeight: number;
       billingAddress: {
         email: string;
+        taxId: string;
         firstName: string;
         lastName: string;
         company: string;
@@ -4443,6 +4682,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -4787,6 +5027,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -5120,6 +5361,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -5439,6 +5681,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -5760,6 +6003,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -6194,6 +6438,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
       customerNote: string;
       billingAddress: {
         email: string;
+        taxId: string;
         firstName: string;
         lastName: string;
         company: string;
@@ -6311,6 +6556,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -6570,6 +6816,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
       customerNote: string;
       billingAddress: {
         email: string;
+        taxId: string;
         firstName: string;
         lastName: string;
         company: string;
@@ -6687,6 +6934,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -7018,6 +7266,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -7320,6 +7569,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -7622,6 +7872,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -7924,6 +8175,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -8226,6 +8478,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -8470,6 +8723,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
           additionalFields: {
             [x: string]: string | boolean;
           };
+          taxId?: string | undefined;
         };
         paymentMethod: string;
         shippingAddress?: {
@@ -8507,6 +8761,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
       customerNote: string;
       billingAddress: {
         email: string;
+        taxId: string;
         firstName: string;
         lastName: string;
         company: string;
@@ -8624,6 +8879,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -8999,6 +9255,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -9301,6 +9558,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -9603,6 +9861,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -9905,6 +10164,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -10207,6 +10467,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -10509,6 +10770,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -10811,6 +11073,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
             itemsWeight: zod0.ZodNumber;
             billingAddress: zod0.ZodObject<{
               email: zod0.ZodString;
+              taxId: zod0.ZodDefault<zod0.ZodString>;
               firstName: zod0.ZodString;
               lastName: zod0.ZodString;
               company: zod0.ZodString;
@@ -11055,6 +11318,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
           additionalFields: {
             [x: string]: string | boolean;
           };
+          taxId?: string | undefined;
         };
         key: string;
         paymentMethod: string;
@@ -11095,6 +11359,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
       customerNote: string;
       billingAddress: {
         email: string;
+        taxId: string;
         firstName: string;
         lastName: string;
         company: string;
@@ -11212,6 +11477,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         itemsWeight: number;
         billingAddress: {
           email: string;
+          taxId: string;
           firstName: string;
           lastName: string;
           company: string;
@@ -11507,6 +11773,7 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
         state: string;
         country: string;
         email: string;
+        taxId: string;
         company?: string | undefined;
         address2?: string | undefined;
       };
@@ -11574,6 +11841,99 @@ declare function woocommerce(): kizlo0.Integration<"woocommerce", {
       };
     }>;
   };
+  storefront: {
+    get: kizlo0.Procedure<"api", {}, {
+      address: {
+        countries: {
+          code: string;
+          name: string;
+          allowBilling: boolean;
+          allowShipping: boolean;
+          states: {
+            code: string;
+            name: string;
+          }[];
+          locale: {
+            [x: string]: {
+              label?: string | undefined;
+              required?: boolean | undefined;
+              hidden?: boolean | undefined;
+              index?: number | undefined;
+            };
+          };
+          format: string;
+        }[];
+        defaultAddressFormat: string;
+        fields: {
+          [x: string]: {
+            label: string;
+            optionalLabel: string;
+            required: boolean | {
+              [x: string]: unknown;
+            };
+            hidden: boolean | {
+              [x: string]: unknown;
+            };
+            type: string | null;
+            autocomplete: string | null;
+            index: number | null;
+            placeholder: string | null;
+            options: {
+              value: string;
+              label: string;
+            }[];
+          };
+        };
+        fieldLocations: {
+          address: string[];
+          contact: string[];
+          order: string[];
+        };
+        baseCountry: string;
+        defaultCountry: string | null;
+      };
+      checkout: {
+        allowsGuest: boolean;
+        couponsEnabled: boolean;
+        forcedBillingAddress: boolean;
+        taxesEnabled: boolean;
+        displayCartPricesIncludingTax: boolean;
+        displayItemizedTaxes: boolean;
+        shippingEnabled: boolean;
+        localPickup: {
+          enabled: boolean;
+          title: string;
+          cost: string;
+        };
+      };
+      pricing: {
+        currency: {
+          currencyCode: string;
+          currencySymbol: string;
+          currencyPrefix: string;
+          currencySuffix: string;
+          currencyMinorUnit: number;
+          currencyDecimalSeparator: string;
+          currencyThousandSeparator: string;
+        };
+        pricesIncludeTax: boolean;
+        displayShopPricesIncludingTax: boolean;
+        priceSuffix: string;
+      };
+      catalog: {
+        weightUnit: string;
+        dimensionUnit: string;
+        reviewsEnabled: boolean;
+        reviewRatingsEnabled: boolean;
+        reviewRatingRequired: boolean;
+        reviewsVerifiedOwnersOnly: boolean;
+        stockFormat: string;
+        hideOutOfStock: boolean;
+        placeholderImage: string;
+        cartRedirectAfterAdd: boolean;
+      };
+    }, kizlo0.DefinedErrorMapLike>;
+  };
 }>;
 //#endregion
-export { AddCartItemInput, ApplyCouponInput, Cart, CartAdditionalFields, CartBillingAddress, CartCoupon, CartCouponTotals, CartError, CartFee, CartFeeTotals, CartItem, CartItemData, CartItemQuantityLimits, CartItemTotals, CartPaymentMethod, CartSelectedAttribute, CartShippingAddress, CartShippingDestination, CartShippingItem, CartShippingPackage, CartShippingRate, CartShippingRateMetadata, CartTaxLine, CartTotals, Checkout, CheckoutAdditionalFields, CheckoutExtensions, CheckoutPaymentData, CheckoutPaymentResult, ConfirmCheckoutInput, GetOrderInput, ListProductInput, ListProductInputOut, Order, OrderFee, OrderItem, OrderItemProduct, OrderTotals, PRODUCT_ATTRIBUTE_RELATIONS, PRODUCT_CATALOG_VISIBILITIES, PRODUCT_DATE_COLUMNS, PRODUCT_RATINGS, PRODUCT_STOCK_STATUSES, PRODUCT_TYPES, Product, ProductAddToCart, ProductAttributeCount, ProductAttributeFilter, ProductAttributeRelation, ProductAttributeSummary, ProductAttributeTermSummary, ProductBrandSummary, ProductCatalogVisibility, ProductCategorySummary, ProductCustomFieldsSchema, ProductDateColumn, ProductDimensions, ProductExtensions, ProductFilters, ProductFiltersAttributeTerm, ProductFiltersPriceRange, ProductFiltersRatingCount, ProductFiltersStockStatus, ProductFiltersTaxonomyTerm, ProductFiltersTerm, ProductList, ProductOrderBy, ProductPriceRange, ProductPrices, ProductRating, ProductRecommendations, ProductStockAvailability, ProductStockStatus, ProductSummary, ProductTagSummary, ProductTaxonomyFilter, ProductTaxonomyOperator, ProductTermSummary, ProductType, ProductVariationAttributeSummary, ProductVariationSummary, RemoveCartItemInput, RemoveCouponInput, RetrieveProductFiltersInput, RetrieveProductFiltersInputOut, RetrieveProductInput, RetryCheckoutInput, SWATCH_TYPES, SelectCartShippingRateInput, SwatchType, UpdateCartInput, UpdateCartItemInput, UpdateCheckoutInput, woocommerce };
+export { AddCartItemInput, ApplyCouponInput, Cart, CartAdditionalFields, CartBillingAddress, CartCoupon, CartCouponTotals, CartError, CartFee, CartFeeTotals, CartItem, CartItemData, CartItemQuantityLimits, CartItemTotals, CartPaymentMethod, CartSelectedAttribute, CartShippingAddress, CartShippingDestination, CartShippingItem, CartShippingPackage, CartShippingRate, CartShippingRateMetadata, CartTaxLine, CartTotals, Checkout, CheckoutAdditionalFields, CheckoutExtensions, CheckoutPaymentData, CheckoutPaymentResult, ConfirmCheckoutInput, GetOrderInput, ListProductInput, ListProductInputOut, Order, OrderFee, OrderItem, OrderItemProduct, OrderTotals, PRODUCT_ATTRIBUTE_RELATIONS, PRODUCT_CATALOG_VISIBILITIES, PRODUCT_DATE_COLUMNS, PRODUCT_RATINGS, PRODUCT_STOCK_STATUSES, PRODUCT_TYPES, Product, ProductAddToCart, ProductAttributeCount, ProductAttributeFilter, ProductAttributeRelation, ProductAttributeSummary, ProductAttributeTermSummary, ProductBrandSummary, ProductCatalogVisibility, ProductCategorySummary, ProductCustomFieldsSchema, ProductDateColumn, ProductDimensions, ProductExtensions, ProductFilters, ProductFiltersAttributeTerm, ProductFiltersPriceRange, ProductFiltersRatingCount, ProductFiltersStockStatus, ProductFiltersTaxonomyTerm, ProductFiltersTerm, ProductList, ProductOrderBy, ProductPriceRange, ProductPrices, ProductRating, ProductRecommendations, ProductStockAvailability, ProductStockStatus, ProductSummary, ProductTagSummary, ProductTaxonomyFilter, ProductTaxonomyOperator, ProductTermSummary, ProductType, ProductVariationAttributeSummary, ProductVariationSummary, RemoveCartItemInput, RemoveCouponInput, RetrieveProductFiltersInput, RetrieveProductFiltersInputOut, RetrieveProductInput, RetryCheckoutInput, SWATCH_TYPES, SelectCartShippingRateInput, Storefront, StorefrontAddress, StorefrontCatalog, StorefrontCheckout, StorefrontCountry, StorefrontField, StorefrontFieldOption, StorefrontFieldOverride, StorefrontFieldRule, StorefrontPricing, SwatchType, UpdateCartInput, UpdateCartItemInput, UpdateCheckoutInput, woocommerce };

package/dist/index.js

@@ -314,6 +314,7 @@ const Product = ProductSummary.extend({
 	formattedWeight: z.string(),
 	formattedDimensions: z.string(),
 	stockQuantity: z.number().nullable(),
+	hsCode: z.string().nullable(),
 	saleStartsAt: z.number().nullable(),
 	saleEndsAt: z.number().nullable(),
 	seo: Seo.nullable(),
@@ -501,7 +502,8 @@ const CartAddressFields = {
 const CartShippingAddress = z$1.object(CartAddressFields);
 const CartBillingAddress = z$1.object({
 	...CartAddressFields,
-	email: z$1.string()
+	email: z$1.string(),
+	taxId: z$1.string().default("")
 });
 const CartShippingDestination = z$1.object({
 	address1: z$1.string(),
@@ -675,10 +677,7 @@ const SelectCartShippingRateInput = z$1.object({
 	packageId: z$1.union([z$1.number(), z$1.string()]).nullable().optional()
 });
 const CartShippingAddressInput = z$1.object(CartAddressFields).partial();
-const CartBillingAddressInput = z$1.object({
-	...CartAddressFields,
-	email: z$1.string()
-}).partial();
+const CartBillingAddressInput = CartBillingAddress.partial();
 const UpdateCartInput = z$1.object({
 	shippingAddress: CartShippingAddressInput.optional(),
 	billingAddress: CartBillingAddressInput.optional()
@@ -701,6 +700,7 @@ function deserializeStoreProduct(data, recommendations) {
 		formattedWeight: data.formatted_weight,
 		formattedDimensions: data.formatted_dimensions,
 		stockQuantity: nullableNumber(kizlo.stock),
+		hsCode: typeof kizlo.hs_code === "string" && kizlo.hs_code !== "" ? kizlo.hs_code : null,
 		saleStartsAt: timestampFromIso(typeof kizlo.on_sale_from === "string" ? kizlo.on_sale_from : null),
 		saleEndsAt: timestampFromIso(typeof kizlo.on_sale_to === "string" ? kizlo.on_sale_to : null),
 		seo: isRecord$1(kizlo.seo) ? deserializeSeo(kizlo.seo) : null,
@@ -931,6 +931,7 @@ function nullableNumber(value) {
 
 //#endregion
 //#region src/cart/utils.ts
+const TAX_ID_KEY = "kizlo/tax-id";
 function assertNoMissing$2() {}
 assertNoMissing$2();
 assertNoMissing$2();
@@ -1139,6 +1140,7 @@ function deserializeCartBillingAddress(address) {
 	return {
 		...deserializeCartShippingAddress(address),
 		email: address.email,
+		taxId: taxId(address),
 		additionalFields: additionalAddressFields(address, BILLING_ADDRESS_KEYS)
 	};
 }
@@ -1152,12 +1154,16 @@ const SHIPPING_ADDRESS_KEYS = new Set([
 	"state",
 	"postcode",
 	"country",
-	"phone"
+	"phone",
+	TAX_ID_KEY
 ]);
 const BILLING_ADDRESS_KEYS = new Set([...SHIPPING_ADDRESS_KEYS, "email"]);
 function additionalAddressFields(address, standardKeys) {
 	return Object.fromEntries(Object.entries(address).filter((entry) => !standardKeys.has(entry[0]) && (typeof entry[1] === "string" || typeof entry[1] === "boolean")));
 }
+function taxId(address) {
+	return typeof address[TAX_ID_KEY] === "string" ? address[TAX_ID_KEY] : "";
+}
 function serializeCartUpdateInput(input) {
 	return {
 		...input.billingAddress !== void 0 && { billing_address: serializeCartBillingAddress(input.billingAddress) },
@@ -1166,7 +1172,7 @@ function serializeCartUpdateInput(input) {
 }
 function serializeCartShippingAddress(address) {
 	return compactAddress({
-		...address.additionalFields,
+		...Object.fromEntries(Object.entries(address.additionalFields ?? {}).filter(([key]) => key !== TAX_ID_KEY)),
 		first_name: address.firstName,
 		last_name: address.lastName,
 		company: address.company,
@@ -1182,7 +1188,8 @@ function serializeCartShippingAddress(address) {
 function serializeCartBillingAddress(address) {
 	return compactAddress({
 		...serializeCartShippingAddress(address),
-		email: address.email
+		email: address.email,
+		[TAX_ID_KEY]: address.taxId
 	});
 }
 function compactAddress(address) {
@@ -1960,7 +1967,10 @@ const ShippingAddress = z$1.object({
 	state: z$1.string(),
 	country: z$1.string()
 });
-const BillingAddress = ShippingAddress.extend({ email: z$1.string() });
+const BillingAddress = ShippingAddress.extend({
+	email: z$1.string(),
+	taxId: z$1.string().default("")
+});
 
 //#endregion
 //#region src/customer/schema.ts
@@ -1982,21 +1992,23 @@ const Customer = z$2.object({
 //#endregion
 //#region src/customer/utils.ts
 function deserializeCustomer(data) {
+	const billing = data.billing;
 	return {
 		id: data.id,
 		avatarUrl: data.avatar_url.length ? data.avatar_url : null,
 		billing: {
-			firstName: data.billing.first_name,
-			lastName: data.billing.last_name,
-			address1: data.billing.address_1,
-			city: data.billing.city,
-			country: data.billing.country,
-			email: data.billing.email,
-			phone: data.billing.phone,
-			postcode: data.billing.postcode,
-			state: data.billing.state,
-			address2: data.billing.address_2,
-			company: data.billing.company
+			firstName: billing.first_name,
+			lastName: billing.last_name,
+			address1: billing.address_1,
+			city: billing.city,
+			country: billing.country,
+			email: billing.email,
+			phone: billing.phone,
+			postcode: billing.postcode,
+			state: billing.state,
+			address2: billing.address_2,
+			company: billing.company,
+			taxId: typeof billing.tax_id === "string" ? billing.tax_id : ""
 		},
 		shipping: {
 			firstName: data.shipping.first_name,
@@ -2078,6 +2090,7 @@ const OrderItem = z.object({
 	id: z.number(),
 	productId: z.number().nullable(),
 	variationId: z.number().nullable(),
+	hsCode: z.string().nullable(),
 	name: z.string(),
 	quantity: z.number(),
 	selectedAttributes: z.array(CartSelectedAttribute),
@@ -2209,6 +2222,7 @@ function deserializeOrderItem(item) {
 		id: item.id,
 		productId,
 		variationId,
+		hsCode: typeof kizlo.hs_code === "string" && kizlo.hs_code !== "" ? kizlo.hs_code : null,
 		name: item.name,
 		quantity: item.quantity,
 		selectedAttributes: item.variation.map((attribute) => ({
@@ -2413,6 +2427,194 @@ const PRODUCT_PROCEDURES = {
 	})
 };
 
+//#endregion
+//#region src/storefront/schema.ts
+/**
+* A plugin-registered field may make `required` or `hidden` a JSON Schema rule evaluated against the
+* checkout rather than a fixed boolean.
+*/
+const StorefrontFieldRule = z$2.union([z$2.boolean(), z$2.record(z$2.string(), z$2.unknown())]);
+const StorefrontFieldOption = z$2.object({
+	value: z$2.string(),
+	label: z$2.string()
+});
+const StorefrontField = z$2.object({
+	label: z$2.string(),
+	optionalLabel: z$2.string(),
+	required: StorefrontFieldRule,
+	hidden: StorefrontFieldRule,
+	type: z$2.string().nullable(),
+	autocomplete: z$2.string().nullable(),
+	index: z$2.number().nullable(),
+	placeholder: z$2.string().nullable(),
+	options: z$2.array(StorefrontFieldOption)
+});
+/** What a country changes about a field. Anything it leaves out keeps the field's default. */
+const StorefrontFieldOverride = z$2.object({
+	label: z$2.string().optional(),
+	required: z$2.boolean().optional(),
+	hidden: z$2.boolean().optional(),
+	index: z$2.number().optional()
+});
+const StorefrontCountry = z$2.object({
+	code: z$2.string(),
+	name: z$2.string(),
+	allowBilling: z$2.boolean(),
+	allowShipping: z$2.boolean(),
+	states: z$2.array(z$2.object({
+		code: z$2.string(),
+		name: z$2.string()
+	})),
+	locale: z$2.record(z$2.string(), StorefrontFieldOverride),
+	format: z$2.string()
+});
+const StorefrontAddress = z$2.object({
+	countries: z$2.array(StorefrontCountry),
+	defaultAddressFormat: z$2.string(),
+	fields: z$2.record(z$2.string(), StorefrontField),
+	fieldLocations: z$2.object({
+		address: z$2.array(z$2.string()),
+		contact: z$2.array(z$2.string()),
+		order: z$2.array(z$2.string())
+	}),
+	baseCountry: z$2.string(),
+	defaultCountry: z$2.string().nullable()
+});
+const StorefrontCheckout = z$2.object({
+	allowsGuest: z$2.boolean(),
+	couponsEnabled: z$2.boolean(),
+	forcedBillingAddress: z$2.boolean(),
+	taxesEnabled: z$2.boolean(),
+	displayCartPricesIncludingTax: z$2.boolean(),
+	displayItemizedTaxes: z$2.boolean(),
+	shippingEnabled: z$2.boolean(),
+	localPickup: z$2.object({
+		enabled: z$2.boolean(),
+		title: z$2.string(),
+		cost: z$2.string()
+	})
+});
+const StorefrontPricing = z$2.object({
+	currency: CurrencyFormat,
+	pricesIncludeTax: z$2.boolean(),
+	displayShopPricesIncludingTax: z$2.boolean(),
+	priceSuffix: z$2.string()
+});
+const StorefrontCatalog = z$2.object({
+	weightUnit: z$2.string(),
+	dimensionUnit: z$2.string(),
+	reviewsEnabled: z$2.boolean(),
+	reviewRatingsEnabled: z$2.boolean(),
+	reviewRatingRequired: z$2.boolean(),
+	reviewsVerifiedOwnersOnly: z$2.boolean(),
+	stockFormat: z$2.string(),
+	hideOutOfStock: z$2.boolean(),
+	placeholderImage: z$2.string(),
+	cartRedirectAfterAdd: z$2.boolean()
+});
+const Storefront = z$2.object({
+	address: StorefrontAddress,
+	checkout: StorefrontCheckout,
+	pricing: StorefrontPricing,
+	catalog: StorefrontCatalog
+});
+
+//#endregion
+//#region src/storefront/utils.ts
+function deserializeStorefront(data) {
+	const { address, checkout, pricing, catalog } = data;
+	return {
+		address: {
+			countries: address.countries.map(deserializeCountry),
+			defaultAddressFormat: address.default_address_format,
+			fields: Object.fromEntries(Object.entries(address.fields).map(([key, field]) => [key, deserializeField(field)])),
+			fieldLocations: address.field_locations,
+			baseCountry: address.base_country,
+			defaultCountry: address.default_country ?? null
+		},
+		checkout: {
+			allowsGuest: checkout.allows_guest,
+			couponsEnabled: checkout.coupons_enabled,
+			forcedBillingAddress: checkout.forced_billing_address,
+			taxesEnabled: checkout.taxes_enabled,
+			displayCartPricesIncludingTax: checkout.display_cart_prices_including_tax,
+			displayItemizedTaxes: checkout.display_itemized_taxes,
+			shippingEnabled: checkout.shipping_enabled,
+			localPickup: checkout.local_pickup
+		},
+		pricing: {
+			currency: deserializeCurrencyFormat(pricing.currency),
+			pricesIncludeTax: pricing.prices_include_tax,
+			displayShopPricesIncludingTax: pricing.display_shop_prices_including_tax,
+			priceSuffix: pricing.price_suffix
+		},
+		catalog: {
+			weightUnit: catalog.weight_unit,
+			dimensionUnit: catalog.dimension_unit,
+			reviewsEnabled: catalog.reviews_enabled,
+			reviewRatingsEnabled: catalog.review_ratings_enabled,
+			reviewRatingRequired: catalog.review_rating_required,
+			reviewsVerifiedOwnersOnly: catalog.reviews_verified_owners_only,
+			stockFormat: catalog.stock_format,
+			hideOutOfStock: catalog.hide_out_of_stock,
+			placeholderImage: catalog.placeholder_image,
+			cartRedirectAfterAdd: catalog.cart_redirect_after_add
+		}
+	};
+}
+function deserializeCountry(country) {
+	return {
+		code: country.code,
+		name: country.name,
+		allowBilling: country.allowBilling,
+		allowShipping: country.allowShipping,
+		states: country.states,
+		locale: Object.fromEntries(Object.entries(country.locale).map(([key, override]) => [key, deserializeOverride(override)])),
+		format: country.format
+	};
+}
+function deserializeOverride(override) {
+	return {
+		...typeof override.label === "string" && { label: override.label },
+		...typeof override.required === "boolean" && { required: override.required },
+		...typeof override.hidden === "boolean" && { hidden: override.hidden },
+		...typeof override.index === "number" && { index: override.index }
+	};
+}
+function deserializeField(field) {
+	return {
+		label: field.label,
+		optionalLabel: field.optionalLabel,
+		required: deserializeRule(field.required),
+		hidden: deserializeRule(field.hidden),
+		type: field.type ?? null,
+		autocomplete: field.autocomplete ?? null,
+		index: field.index ?? null,
+		placeholder: field.placeholder ?? null,
+		options: field.options ?? []
+	};
+}
+function deserializeRule(rule) {
+	if (typeof rule === "boolean") return rule;
+	return typeof rule === "object" && rule !== null && !Array.isArray(rule) ? rule : false;
+}
+
+//#endregion
+//#region src/storefront/index.ts
+const STOREFRONT_PROCEDURES = { get: createProcedure({
+	scope: "api",
+	method: "GET",
+	path: "/storefront",
+	output: Storefront
+}, async ({ context, errors }) => {
+	const response = await context.wordpress.woocommerce.kizlo.storefront.retrieve();
+	if (response.error) {
+		context.logger.error("Get storefront unhandled error", response.error, { code: response.error.code });
+		throw errors.INTERNAL_SERVER_ERROR();
+	}
+	return deserializeStorefront(response.data);
+}) };
+
 //#endregion
 //#region src/index.ts
 function woocommerce() {
@@ -2421,10 +2623,11 @@ function woocommerce() {
 		requires: {
 			plugins: [{
 				name: "kizlo-woocommerce",
-				version: "0.10.0"
+				version: "0.11.0"
 			}],
 			endpoints: [
 				"woocommerce.customers",
+				"woocommerce.kizlo.storefront",
 				"woocommerce.products",
 				"woocommerce.store.cart",
 				"woocommerce.store.checkout",
@@ -2437,10 +2640,11 @@ function woocommerce() {
 			products: PRODUCT_PROCEDURES,
 			checkout: CHECKOUT_PROCEDURES,
 			customers: CUSTOMER_PROCEDURES,
-			orders: ORDER_PROCEDURES
+			orders: ORDER_PROCEDURES,
+			storefront: STOREFRONT_PROCEDURES
 		}
 	});
 }
 
 //#endregion
-export { AddCartItemInput, ApplyCouponInput, Cart, CartAdditionalFields, CartBillingAddress, CartCoupon, CartCouponTotals, CartError, CartFee, CartFeeTotals, CartItem, CartItemData, CartItemQuantityLimits, CartItemTotals, CartPaymentMethod, CartSelectedAttribute, CartShippingAddress, CartShippingDestination, CartShippingItem, CartShippingPackage, CartShippingRate, CartShippingRateMetadata, CartTaxLine, CartTotals, Checkout, CheckoutAdditionalFields, CheckoutExtensions, CheckoutPaymentData, CheckoutPaymentResult, ConfirmCheckoutInput, GetOrderInput, ListProductInput, Order, OrderFee, OrderItem, OrderItemProduct, OrderTotals, PRODUCT_ATTRIBUTE_RELATIONS, PRODUCT_CATALOG_VISIBILITIES, PRODUCT_DATE_COLUMNS, PRODUCT_RATINGS, PRODUCT_STOCK_STATUSES, PRODUCT_TYPES, Product, ProductAddToCart, ProductAttributeCount, ProductAttributeFilter, ProductAttributeRelation, ProductAttributeSummary, ProductAttributeTermSummary, ProductBrandSummary, ProductCatalogVisibility, ProductCategorySummary, ProductCustomFieldsSchema, ProductDateColumn, ProductDimensions, ProductExtensions, ProductFilters, ProductFiltersAttributeTerm, ProductFiltersPriceRange, ProductFiltersRatingCount, ProductFiltersStockStatus, ProductFiltersTaxonomyTerm, ProductFiltersTerm, ProductList, ProductOrderBy, ProductPriceRange, ProductPrices, ProductRating, ProductRecommendations, ProductStockAvailability, ProductStockStatus, ProductSummary, ProductTagSummary, ProductTaxonomyFilter, ProductTaxonomyOperator, ProductTermSummary, ProductType, ProductVariationAttributeSummary, ProductVariationSummary, RemoveCartItemInput, RemoveCouponInput, RetrieveProductFiltersInput, RetrieveProductInput, RetryCheckoutInput, SWATCH_TYPES, SelectCartShippingRateInput, SwatchType, UpdateCartInput, UpdateCartItemInput, UpdateCheckoutInput, woocommerce };
+export { AddCartItemInput, ApplyCouponInput, Cart, CartAdditionalFields, CartBillingAddress, CartCoupon, CartCouponTotals, CartError, CartFee, CartFeeTotals, CartItem, CartItemData, CartItemQuantityLimits, CartItemTotals, CartPaymentMethod, CartSelectedAttribute, CartShippingAddress, CartShippingDestination, CartShippingItem, CartShippingPackage, CartShippingRate, CartShippingRateMetadata, CartTaxLine, CartTotals, Checkout, CheckoutAdditionalFields, CheckoutExtensions, CheckoutPaymentData, CheckoutPaymentResult, ConfirmCheckoutInput, GetOrderInput, ListProductInput, Order, OrderFee, OrderItem, OrderItemProduct, OrderTotals, PRODUCT_ATTRIBUTE_RELATIONS, PRODUCT_CATALOG_VISIBILITIES, PRODUCT_DATE_COLUMNS, PRODUCT_RATINGS, PRODUCT_STOCK_STATUSES, PRODUCT_TYPES, Product, ProductAddToCart, ProductAttributeCount, ProductAttributeFilter, ProductAttributeRelation, ProductAttributeSummary, ProductAttributeTermSummary, ProductBrandSummary, ProductCatalogVisibility, ProductCategorySummary, ProductCustomFieldsSchema, ProductDateColumn, ProductDimensions, ProductExtensions, ProductFilters, ProductFiltersAttributeTerm, ProductFiltersPriceRange, ProductFiltersRatingCount, ProductFiltersStockStatus, ProductFiltersTaxonomyTerm, ProductFiltersTerm, ProductList, ProductOrderBy, ProductPriceRange, ProductPrices, ProductRating, ProductRecommendations, ProductStockAvailability, ProductStockStatus, ProductSummary, ProductTagSummary, ProductTaxonomyFilter, ProductTaxonomyOperator, ProductTermSummary, ProductType, ProductVariationAttributeSummary, ProductVariationSummary, RemoveCartItemInput, RemoveCouponInput, RetrieveProductFiltersInput, RetrieveProductInput, RetryCheckoutInput, SWATCH_TYPES, SelectCartShippingRateInput, Storefront, StorefrontAddress, StorefrontCatalog, StorefrontCheckout, StorefrontCountry, StorefrontField, StorefrontFieldOption, StorefrontFieldOverride, StorefrontFieldRule, StorefrontPricing, SwatchType, UpdateCartInput, UpdateCartItemInput, UpdateCheckoutInput, woocommerce };

package/dist/test.d.ts

@@ -1,4 +1,4 @@
-import * as kizlo19 from "kizlo";
+import * as kizlo21 from "kizlo";
 import { DevPluginSource } from "kizlo/test";
 
 //#region src/test/index.d.ts
@@ -20,6 +20,6 @@ declare const BANK_TRANSFER_DESCRIPTION = "Pay by transferring to our test bank
  */
 declare function woocommerce(opts?: {
   plugins?: DevPluginSource[];
-}): kizlo19.Fixture;
+}): kizlo21.Fixture;
 //#endregion
 export { BANK_TRANSFER_DESCRIPTION, BANK_TRANSFER_TITLE, woocommerce };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kizlo/woocommerce",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "type": "module",
   "sideEffects": false,
   "description": "WooCommerce integration for Kizlo.",