@kizlo/woocommerce 0.10.0 → 0.11.0

package/README.md

@@ -54,6 +54,27 @@ await kizlo.woocommerce.cart.update.call({
 
 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

package/dist/index.d.ts

@@ -3392,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: {
@@ -11618,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

@@ -2427,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() {
@@ -2435,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",
@@ -2451,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.10.0",
+  "version": "0.11.0",
   "type": "module",
   "sideEffects": false,
   "description": "WooCommerce integration for Kizlo.",