@wocart/storefront 1.23.0 → 2.0.0

package/CHANGELOG.md

@@ -5,6 +5,47 @@ follows [semantic versioning](https://semver.org/): breaking changes ship only
 in a new major version, and an export is marked `@deprecated` for at least one
 minor release before a major removes it.
 
+## 2.0.0 — 2026-10-30
+
+A store's images can live on any media host. The server answers every image
+as a `MediaImage` and the store's config says how its images are delivered;
+the image helpers take that delivery instead of a media domain. Requires a
+store server that answers this shape.
+
+### Changed (breaking)
+
+- Every image is a `MediaImage`, `{ key, url, width, height }`: a product
+  image (`ProductImageSchema`) and a landing image carry `key` and `url`
+  (`src`, `srcSm`, `srcMd`, `srcLg` are gone); a category has `image` (was
+  `imageUrl`); `StoreConfig` has `logo` (was `logoUrl`) and `ogImage` as
+  images.
+- `StoreConfig.media` (`MediaDelivery`, `{ kind, origin }`): where every key is
+  served from, and how it is resized — `imagekit`, `cloudflare`, or `direct`.
+- `mediaUrl(key, delivery)`, `mediaImageUrl(url, params, delivery)`,
+  `mediaImageSrcset(url, widths, { delivery })` and `pictureOf(image,
+  delivery)` take the store's delivery (was a media domain). `mediaImageUrl`
+  builds ImageKit's `?tr=` or Cloudflare's `/cdn-cgi/image/`, and answers
+  `null` for a `direct` delivery.
+- `productImageSource` reads `url`.
+
+### Removed
+
+- `optimizeImage`, `generateSrcSet`, `IMAGE_SIZES`, `getCardImage`,
+  `getGalleryImage`, `getThumbnailImage`, `getHeroImage`, `getCategoryImage`,
+  `getLogoImage`, `createImageHelpers` and their types: each took a media
+  domain, which no longer exists. Use `mediaImageUrl` and `mediaImageSrcset`
+  with the size a page shows. They are removed without a deprecating minor
+  because no media domain is left for them to take.
+
+### Added
+
+- `isMediaKey`, `MediaImage`, `MediaDelivery`, `MediaDeliveryKind`,
+  `MediaImageSchema` and `MediaDeliverySchema`.
+
+### Changed
+
+- The README is short and points to the documentation at docs.wocart.store.
+
 ## 1.23.0 — 2026-10-25
 
 One checkout, one order: a double click, a refreshed submission or a retry

package/README.md

@@ -1,20 +1,13 @@
 # @wocart/storefront
 
 The storefront SDK for [Wocart](https://github.com/bighadj22/codflow), the
-cash-on-delivery commerce platform for Algeria. It gives a storefront theme
-typed, validated access to a store's catalog, delivery prices, basket,
-checkout, OTP and order tracking — and keeps prices, rules and secrets on the
-server.
+cash-on-delivery commerce platform for Algeria. It gives a storefront typed,
+validated access to a store's catalog, delivery prices, basket, checkout, OTP,
+order tracking and images — and keeps prices, rules and secrets on the server.
 
-- **Typed and validated.** Every server response is parsed against a schema
-  before your code sees it.
-- **Predictable failures.** Reads never throw: they resolve to `null`, `[]` or
-  `{}` and report through `onError`. Writes return a result whose failure always
-  carries a structured `DomainError`.
-- **Browser-safe by construction.** The root entry exports no client and no
-  secret; the store API key lives behind `@wocart/storefront/server`.
-- **Framework-neutral core, Astro adapters.** Proxy routes, form actions and
-  the POST/Redirect/GET middleware decision for Astro, with no Astro import.
+**Documentation: [docs.wocart.store/sdk/storefront](https://docs.wocart.store/sdk/storefront)**
+— also in [French](https://docs.wocart.store/fr/sdk/storefront) and
+[Arabic](https://docs.wocart.store/ar/sdk/storefront).
 
 ## Install
 
@@ -22,123 +15,35 @@ server.
 npm install @wocart/storefront zod
 ```
 
-`zod` (4.x) is a peer dependency: the SDK's schemas are part of its API — you
-can validate with them, and you pass your own schemas to `createProxyEndpoint` —
-so your app and the SDK share one copy. npm 7 and later install it
-automatically. ESM only. Runs in browsers, Cloudflare Workers, Node and Astro server
-runtimes; tooling needs Node 22.12 or newer.
+`zod` 4 is a peer dependency. ESM only; Node 22.12 or newer for tooling.
 
 ## Quick start
 
 ```ts
 import { createStoreClient } from "@wocart/storefront/server";
+import { mediaImageUrl } from "@wocart/storefront";
 
-// Server-side only: a page frontmatter, endpoint, action or middleware.
-const store = createStoreClient({
-  serverUrl: env.COD_SERVER_URL, // your store's API origin
-  apiKey: env.STORE_API_KEY,     // server-only secret
-  onError: (error) => console.warn(error.operation, error.code, error.requestId),
-});
+const store = createStoreClient({ serverUrl: env.COD_SERVER_URL, apiKey: env.STORE_API_KEY });
 
-// Reads: typed, validated, safe to render straight away.
-const [config, products] = await Promise.all([
-  store.config.get(),                                // StoreConfig | null
-  store.products.list({ featured: true, limit: 8 }), // ProductList[]
-]);
-const product = await store.products.get("blue-t-shirt"); // Product | null
-
-// Writes: a discriminated result, never a thrown HTTP error.
-const result = await store.orders.create({
-  customerName: "أمين",
-  phone: "0555123456",
-  wilayaId: 16,
-  communeId: "c-16-001",
-  items: [{ productId: "p-1", productName: "Blue T-Shirt", quantity: 1 }],
-});
-
-if (result.success) {
-  console.log(result.data.orderNumber, result.data.total);
-} else {
-  console.error(result.domainError.category, result.domainError.message);
-}
-```
-
-## Entry points
-
-| Import | Runs in | What it holds |
-| --- | --- | --- |
-| `@wocart/storefront` | browser and server | read-model types and schemas, reference data (58 wilayas, 1,551 communes), money and image helpers, the basket and OTP state machines, language routing, Meta pixel payloads |
-| `@wocart/storefront/server` | server only | `createStoreClient`, `StoreClient`, `ClientResult`, `StorefrontError` — the API key lives here — the preview checks (`readPreviewRequest`, `verifyPreviewToken`, `previewResponseHeaders`, `previewConfig`) and revalidation (`readRevalidateRequest`) |
-| `@wocart/storefront/astro` | server only | `createStorefrontRoutes`, `createProxyEndpoint`, `placeOrderInput`, `executePlaceOrder`, `collectForwardedHeaders`, `runFormAction` |
-
-Browser code never receives the key. It calls your own same-origin routes
-(for example `src/pages/api/cart.ts`), which call the SDK on the server:
-
-```ts
-// In the browser: no client, no key.
-import { createBasketStore, formatMoney } from "@wocart/storefront";
+const config = await store.config.get();
+const product = await store.products.get("blue-t-shirt");
+const photo = product?.images[0];
+const src = photo && config ? mediaImageUrl(photo.url, { width: 480, fit: "cover", format: "auto" }, config.media) ?? photo.url : null;
 ```
 
-## What the client covers
-
-| Namespace | Use it for |
-| --- | --- |
-| `config` | store identity, branding, languages, checkout policy, feature flags |
-| `products` | catalog lists, product detail, reviews |
-| `categories` | catalog navigation |
-| `pages` | legal and CMS pages, landing pages |
-| `pageData` | the store's saved page document for a surface (render it with [`@wocart/theme`](https://www.npmjs.com/package/@wocart/theme)) |
-| `shipping` | home and stop-desk delivery prices per wilaya |
-| `geo` | wilayas and communes |
-| `cart` | server re-pricing and validation of a browser basket |
-| `orders` | order creation, OTP, abandoned checkout, conversion tracking |
-
-## How errors work
+Reads never throw: they resolve to `null`, `[]` or `{}` and report through
+`onError`. Writes return `{ success, data }` or a structured `domainError`.
 
-- **Reads** resolve to the empty value (`null`, `[]`, `{}`) so a page still
-  renders, and report the cause to `onError` as a `DomainError` with
-  `category`, `code`, `retryable`, `sideEffect`, `operation` and `requestId`.
-- **Writes** return `ClientResult<T>`: `{ success: true, data }` or
-  `{ success: false, error, domainError }`. Branch on
-  `result.domainError.category` — `validation`, `authentication`, `business`,
-  `system`, `transport` — instead of status codes.
-- **Setup errors are loud.** An empty `serverUrl` or `apiKey` throws
-  `MISSING_CONFIGURATION` when the client is created, instead of quietly
-  turning every read into an empty store.
-
-## Configuration
+## Entry points
 
-| Option | Required | Notes |
+| Import | Runs in | Holds |
 | --- | --- | --- |
-| `serverUrl` | yes | your store's API origin |
-| `apiKey` | yes | the store API key, sent as `X-Store-API-Key`; server-only |
-| `locale` | no | read merchant text in a published store language (`"fr"`); one client per language |
-| `theme` | no | your theme's key (`defineTheme({ key })`), to receive the merchant's edits to your theme's text |
-| `onError` | no | observability hook for degraded reads |
-| `readTimeoutMs` | no | how long one read may take, retries included, before it degrades (default 10 000; `0` for no limit) |
-
-A storefront deployed by Wocart receives its origin and key as the
-`COD_SERVER_URL` and `STORE_API_KEY` environment variables. The SDK reads no
-environment variables itself; pass the values in. In Astro, declare the key as
-a server secret (`envField.string({ context: "server", access: "secret" })`)
-and never expose it as a public variable.
-
-## Documentation
-
-- [USAGE.md](./USAGE.md) — the full guide: every namespace and the UI decisions
-  it implies, checkout and OTP, Astro actions and proxy routes, languages,
-  images, and a definition of done for a new theme.
-- [CHANGELOG.md](./CHANGELOG.md) — what changed in each release.
-
-## Compatibility
+| `@wocart/storefront` | browser and server | types and schemas, reference data, money and image helpers, basket and OTP state |
+| `@wocart/storefront/server` | server only | `createStoreClient` — the store API key lives here — preview and revalidation checks |
+| `@wocart/storefront/astro` | server only | proxy routes, form actions, `placeOrderInput` |
 
-- Follows [semantic versioning](https://semver.org/). Breaking changes ship
-  only in a new major version and are listed in the changelog.
-- Response schemas ignore fields they do not know, so a newer server never
-  breaks an older SDK; a response missing a required field degrades the read
-  and reports it.
-- Astro 7 is verified. The Astro adapters are structural and import nothing
-  from Astro.
+[USAGE.md](./USAGE.md) ships with the package for offline reading;
+[CHANGELOG.md](./CHANGELOG.md) lists every release.
 
 ## License
 

package/USAGE.md

@@ -214,10 +214,11 @@ server directly.
 
 | Export | Use it for |
 | --- | --- |
-| `formatMoney`, `optimizeImage`, `generateSrcSet` | Money text and image URLs |
-| `mediaImageUrl` | The Cloudflare resizing URL of a media-domain image, served by the media domain itself (any storefront host); `null` for any other image — the builder behind every image helper and `@wocart/theme/image-service` |
-| `mediaUrl(key, mediaDomain)` | The public URL of a stored media key — what a theme's `image` field holds (`{ key: "products/…" }`): `mediaUrl(image.key, MEDIA_DOMAIN)`; `null` with no media domain or a key that cannot name an object. The key is the identity; the URL is derived at render |
-| `createImageHelpers(mediaDomain)`, `getCardImage`, `getGalleryImage`, `getThumbnailImage`, `getHeroImage`, `getCategoryImage`, `getLogoImage` | The bound image toolkit (`IMAGE_SIZES` holds the presets) |
+| `formatMoney` | Money text |
+| `mediaImageUrl(url, params, config.media)` | A store image at the size and format a page shows it, from the store's delivery (ImageKit `?tr=` or Cloudflare `/cdn-cgi/image/`); `null` for an image the delivery does not serve, or a `direct` delivery — the builder behind `@wocart/theme/image-service` |
+| `mediaImageSrcset(url, widths, { delivery })` | The same image at several widths, for `srcset` |
+| `mediaUrl(key, config.media)`, `isMediaKey` | The URL of a Media Key — what a theme's `image` field holds (`{ key: "products/…" }`); `null` without a delivery or for a value that is not a key |
+| `pictureOf(image, config.media)` | A picked image ready for an `<img>`: URL, alt, size, focal point |
 | `WILAYAS`, `ALGERIA_COMMUNES`, `communesForWilaya` | Reference data: 58 wilayas, 1,551 communes, one wilaya's rows |
 | `isWilayaId` | Whether a value is a wilaya id — the range `WilayaIdSchema` checks on the server, without a schema in the browser |
 | `readShippingRates`, `readCouponOutcome` | Read in the browser what the server handed it — the rates a page carries, a quote's coupon outcome — accepting exactly what `ShippingRatesSchema` / `CouponOutcomeSchema` accept, without Zod |
@@ -290,7 +291,6 @@ storefront deployed by Wocart receives these:
 | --- | --- | --- |
 | `COD_SERVER_URL` | server variable | the store's API origin, e.g. `https://api.your-store.com` |
 | `STORE_API_KEY` | server secret | the store API key |
-| `MEDIA_DOMAIN` | server variable (optional) | media domain for `createImageHelpers(mediaDomain)`; unset → image URLs pass through unchanged |
 
 Never put `STORE_API_KEY` in a browser-exposed variable (no `PUBLIC_*`, no
 `import.meta.env` in client code, no HTML attribute). In Astro, declare it in
@@ -518,11 +518,13 @@ const currencySymbol = config?.currencySymbol ?? "دج";
 StoreConfig contains the current store identity and presentation fields,
 including:
 
-- name, domain, logoUrl and themeId (the colors, fontFamily and fontUrl
+- name, domain, logo (a MediaImage) and themeId (the colors, fontFamily and fontUrl
   fields are deprecated: colors and fonts are theme settings, read from
   themeSettings);
 - lang (the primary language), locales, contentOverrides, themeSettings,
-  currency, currencySymbol, metaTitle, metaDescription, and ogImage;
+  currency, currencySymbol, metaTitle, metaDescription, and ogImage (a
+  MediaImage);
+- media, the store's MediaDelivery, which every image helper takes;
 - reviewsEnabled (announcementBar is deprecated and always null: an
   announcement is a theme's own setting);
 - cartEnabled, freeShippingThreshold, and cartShippingMode;
@@ -1827,53 +1829,46 @@ price presentation does not drift between cards, product pages, and checkout.
 
 ### Images
 
+Every image the store's server answers is a `MediaImage` — `{ key, url,
+width, height }` — and the store's config carries `media`, its
+`MediaDelivery`: the origin every key is served from and how that origin
+resizes (`imagekit`, `cloudflare`, or `direct` for files served as stored).
+Pass `config.media` to the image helpers; one theme then works on every host a
+store can use.
+
 ~~~ts
-import {
-  generateSrcSet,
-  getCardImage,
-  optimizeImage,
-} from "@wocart/storefront";
+import { mediaImageUrl } from "@wocart/storefront";
 
-const mediaDomain = env.MEDIA_DOMAIN;
-const originalImage = product.images[0]?.src ?? "";
-const cardImage = getCardImage(originalImage, mediaDomain);
-const src = optimizeImage(originalImage, {
-  width: 480,
-  height: 480,
-  quality: 82,
-  format: "auto",
-  fit: "cover",
-}, mediaDomain);
-const srcSet = generateSrcSet(originalImage, 480, 480, mediaDomain);
+const photo = product.images[0];
+const card = photo ? mediaImageUrl(photo.url, { width: 480, height: 480, fit: "cover", format: "auto", quality: 82 }, config.media) ?? photo.url : null;
 ~~~
 
-The image utility accepts the original media URL and can target a media
-domain. Use it to produce appropriately sized URLs rather than downloading
-original assets into every card.
+`mediaImageUrl` answers `null` for an image its delivery does not serve and
+for a `direct` delivery, which does not resize: show the original then.
 
 For an image whose width changes with the screen, give the browser widths and
 let `sizes` choose — a phone then downloads a phone-sized file.
-`mediaImageSrcset(src, widths, { mediaDomain, ratio, quality })` gives one
-size per width with width descriptors, cropped to `ratio` (height ÷ width)
-when given; null off the media domain:
+`mediaImageSrcset(src, widths, { delivery, ratio, quality })` gives one size
+per width with width descriptors, cropped to `ratio` (height ÷ width) when
+given and never enlarged past the original otherwise:
 
 ~~~astro
 <img
-  src={mediaImageUrl(src, { width: 720, format: "auto" }, mediaDomain) ?? src}
-  srcset={mediaImageSrcset(src, [360, 540, 720, 1080], { mediaDomain, ratio: 1.25 }) ?? undefined}
+  src={mediaImageUrl(src, { width: 720, fit: "scale-down", format: "auto" }, config.media) ?? src}
+  srcset={mediaImageSrcset(src, [360, 540, 720, 1080], { delivery: config.media, ratio: 1.25 }) ?? undefined}
   sizes="(min-width: 1024px) 25vw, 50vw"
   alt="" loading="lazy" />
 ~~~
 
-A photo a merchant picks for a section is stored as a media key with its alt
-text, size and focal point. `pictureOf(image, mediaDomain)` turns it into what
+A photo a merchant picks for a section is stored as a Media Key with its alt
+text, size and focal point. `pictureOf(image, config.media)` turns it into what
 an `<img>` needs — `src`, `alt` (empty when none was written), `width`,
 `height` and `position`, the focal point as CSS `object-position` — or null
 when none is picked:
 
 ~~~astro
 ---
-const picture = pictureOf(props.image, mediaDomain);
+const picture = pictureOf(props.image, config.media);
 ---
 {picture && <img src={picture.src} alt={picture.alt} width={picture.width} height={picture.height} style={{ objectPosition: picture.position }} />}
 ~~~
@@ -1886,10 +1881,10 @@ thumbnail. `productImageSource` answers which image represents the product, so
 a cart drawer, a checkout summary and a product card cannot disagree:
 
 ~~~ts
-import { getThumbnailImage, productImageSource } from "@wocart/storefront";
+import { mediaImageUrl, productImageSource } from "@wocart/storefront";
 
 const src = productImageSource(product); // Product | ProductList
-const thumbnail = src ? getThumbnailImage(src) : null;
+const thumbnail = src ? mediaImageUrl(src, { width: 160, height: 160, fit: "cover", format: "auto" }, config.media) ?? src : null;
 ~~~
 
 It prefers the merchant's cover and falls back to the first usable gallery
@@ -1897,40 +1892,6 @@ image; `null` means the product genuinely has no photograph, so that is the
 moment to render a placeholder. The list model carries no gallery at all, so a
 card gets the cover or `null`.
 
-Available semantic helpers include:
-
-- getCardImage;
-- getGalleryImage;
-- getThumbnailImage;
-- getHeroImage;
-- getCategoryImage;
-- getLogoImage.
-
-The helper chooses the appropriate image role. The theme still owns layout,
-aspect ratio, alt text, lazy loading, placeholders, and art direction.
-
-#### Bind the media domain once
-
-Do not thread the media domain through every call site — a missed argument
-silently ships an unoptimized image. Bind it once and use the URL-only helper
-set:
-
-~~~ts
-import { createImageHelpers } from "@wocart/storefront";
-
-const images = createImageHelpers(env.MEDIA_DOMAIN);
-
-const thumbnail = images.getThumbnailImage(product.images[0].src);
-const preview = images.getCardImage(product.images[0].src);
-const srcSet = images.generateSrcSet(product.images[0].src, 480, 480);
-~~~
-
-The returned toolkit exposes the same helpers plus `optimizeImage`,
-`generateSrcSet`, and `IMAGE_SIZES`. With no domain bound, every helper returns
-the original URL unchanged, so a store without a media domain needs no branch —
-and `optimizeImage` / `generateSrcSet` still take a per-call domain that
-overrides the bound one.
-
 ## WhatsApp prefill messages
 
 The storefront's WhatsApp launcher hands the shopper to WhatsApp with a message

package/dist/index.d.ts

@@ -11,8 +11,8 @@
  */
 export { formatMoney } from "./utils/money.js";
 export type { MoneyFormatOptions } from "./utils/money.js";
-export { optimizeImage, generateSrcSet, IMAGE_SIZES, getCardImage, getGalleryImage, getThumbnailImage, getHeroImage, getCategoryImage, getLogoImage, createImageHelpers, mediaImageUrl, mediaImageSrcset, mediaUrl, pictureOf, } from "./utils/image.js";
-export type { ImageHelpers, ImageResizeOptions, MediaImageParams, MediaImageSrcsetOptions, PickedImage, Picture } from "./utils/image.js";
+export { isMediaKey, mediaImageSrcset, mediaImageUrl, mediaUrl, pictureOf } from "./utils/image.js";
+export type { MediaDelivery, MediaDeliveryKind, MediaImage, MediaImageParams, MediaImageSrcsetOptions, PickedImage, Picture } from "./utils/image.js";
 export { productImageSource } from "./utils/product-image.js";
 export type { ProductImageSourceInput } from "./utils/product-image.js";
 export { MAX_RESOLVED_PREFILL_LENGTH, PREFILL_TOKENS, stripTrackingParams, truncateAtWordBoundary, resolvePrefillText, buildWhatsAppHref, } from "./whatsapp.js";

package/dist/index.js

@@ -10,7 +10,7 @@
  * Internal modules stay reachable only through their intentional entry points.
  */
 export { formatMoney } from "./utils/money.js";
-export { optimizeImage, generateSrcSet, IMAGE_SIZES, getCardImage, getGalleryImage, getThumbnailImage, getHeroImage, getCategoryImage, getLogoImage, createImageHelpers, mediaImageUrl, mediaImageSrcset, mediaUrl, pictureOf, } from "./utils/image.js";
+export { isMediaKey, mediaImageSrcset, mediaImageUrl, mediaUrl, pictureOf } from "./utils/image.js";
 export { productImageSource } from "./utils/product-image.js";
 export { MAX_RESOLVED_PREFILL_LENGTH, PREFILL_TOKENS, stripTrackingParams, truncateAtWordBoundary, resolvePrefillText, buildWhatsAppHref, } from "./whatsapp.js";
 export { STOREFRONT_PAGE_PATHS, STOREFRONT_ROUTES, matchStorefrontPath, showsWidgetOn, storefrontPath } from "./routes.js";

package/dist/schemas.d.ts

@@ -1,10 +1,24 @@
 import { z } from "zod";
+export declare const MediaImageSchema: z.ZodObject<{
+    key: z.ZodString;
+    url: z.ZodString;
+    width: z.ZodNullable<z.ZodNumber>;
+    height: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const MediaDeliverySchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        cloudflare: "cloudflare";
+        direct: "direct";
+        imagekit: "imagekit";
+    }>;
+    origin: z.ZodString;
+}, z.core.$strip>;
 export declare const ProductImageSchema: z.ZodObject<{
+    key: z.ZodString;
+    url: z.ZodString;
+    width: z.ZodNullable<z.ZodNumber>;
+    height: z.ZodNullable<z.ZodNumber>;
     id: z.ZodString;
-    src: z.ZodString;
-    srcSm: z.ZodNullable<z.ZodString>;
-    srcMd: z.ZodNullable<z.ZodString>;
-    srcLg: z.ZodNullable<z.ZodString>;
     altText: z.ZodNullable<z.ZodString>;
     position: z.ZodNumber;
 }, z.core.$strip>;
@@ -64,7 +78,12 @@ export declare const CategorySchema: z.ZodObject<{
     slug: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     parentId: z.ZodNullable<z.ZodString>;
-    imageUrl: z.ZodNullable<z.ZodString>;
+    image: z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+        url: z.ZodString;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
     metaKeywords: z.ZodNullable<z.ZodString>;
@@ -114,11 +133,11 @@ export declare const ProductListSchema: z.ZodObject<{
     variantOptions: z.ZodNullable<z.ZodString>;
     tags: z.ZodNullable<z.ZodString>;
     coverImage: z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+        url: z.ZodString;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
         id: z.ZodString;
-        src: z.ZodString;
-        srcSm: z.ZodNullable<z.ZodString>;
-        srcMd: z.ZodNullable<z.ZodString>;
-        srcLg: z.ZodNullable<z.ZodString>;
         altText: z.ZodNullable<z.ZodString>;
         position: z.ZodNumber;
     }, z.core.$strip>>;
@@ -180,7 +199,12 @@ export declare const ProductSchema: z.ZodObject<{
         slug: z.ZodString;
         description: z.ZodNullable<z.ZodString>;
         parentId: z.ZodNullable<z.ZodString>;
-        imageUrl: z.ZodNullable<z.ZodString>;
+        image: z.ZodNullable<z.ZodObject<{
+            key: z.ZodString;
+            url: z.ZodString;
+            width: z.ZodNullable<z.ZodNumber>;
+            height: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
         metaTitle: z.ZodNullable<z.ZodString>;
         metaDescription: z.ZodNullable<z.ZodString>;
         metaKeywords: z.ZodNullable<z.ZodString>;
@@ -208,11 +232,11 @@ export declare const ProductSchema: z.ZodObject<{
         updatedAt: z.ZodString;
     }, z.core.$strip>>;
     images: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        url: z.ZodString;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
         id: z.ZodString;
-        src: z.ZodString;
-        srcSm: z.ZodNullable<z.ZodString>;
-        srcMd: z.ZodNullable<z.ZodString>;
-        srcLg: z.ZodNullable<z.ZodString>;
         altText: z.ZodNullable<z.ZodString>;
         position: z.ZodNumber;
     }, z.core.$strip>>;
@@ -282,11 +306,11 @@ export declare const StoreCollectionSchema: z.ZodObject<{
     description: z.ZodNullable<z.ZodString>;
     productCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     image: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+        url: z.ZodString;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
         id: z.ZodString;
-        src: z.ZodString;
-        srcSm: z.ZodNullable<z.ZodString>;
-        srcMd: z.ZodNullable<z.ZodString>;
-        srcLg: z.ZodNullable<z.ZodString>;
         altText: z.ZodNullable<z.ZodString>;
         position: z.ZodNumber;
     }, z.core.$strip>>>;
@@ -417,7 +441,12 @@ export declare const StoreConfigSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     domain: z.ZodNullable<z.ZodString>;
-    logoUrl: z.ZodNullable<z.ZodString>;
+    logo: z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+        url: z.ZodString;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
     themeId: z.ZodString;
     primaryColor: z.ZodString;
     accentColor: z.ZodString;
@@ -440,7 +469,20 @@ export declare const StoreConfigSchema: z.ZodObject<{
     currencySymbol: z.ZodString;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
-    ogImage: z.ZodNullable<z.ZodString>;
+    ogImage: z.ZodNullable<z.ZodObject<{
+        key: z.ZodString;
+        url: z.ZodString;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    media: z.ZodObject<{
+        kind: z.ZodEnum<{
+            cloudflare: "cloudflare";
+            direct: "direct";
+            imagekit: "imagekit";
+        }>;
+        origin: z.ZodString;
+    }, z.core.$strip>;
     announcementBar: z.ZodNullable<z.ZodString>;
     reviewsEnabled: z.ZodBoolean;
     cartEnabled: z.ZodBoolean;
@@ -549,12 +591,13 @@ export declare const StoreConfigSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const LandingPageImageSchema: z.ZodObject<{
+    key: z.ZodString;
+    url: z.ZodString;
+    width: z.ZodNullable<z.ZodNumber>;
+    height: z.ZodNullable<z.ZodNumber>;
     id: z.ZodString;
-    src: z.ZodString;
     altText: z.ZodNullable<z.ZodString>;
     position: z.ZodNumber;
-    width: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-    height: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 export declare const LandingPageSchema: z.ZodObject<{
     id: z.ZodString;
@@ -570,12 +613,13 @@ export declare const LandingPageSchema: z.ZodObject<{
     metaDescription: z.ZodNullable<z.ZodString>;
     publishedAt: z.ZodNullable<z.ZodString>;
     images: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        url: z.ZodString;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
         id: z.ZodString;
-        src: z.ZodString;
         altText: z.ZodNullable<z.ZodString>;
         position: z.ZodNumber;
-        width: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-        height: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     }, z.core.$strip>>;
     product: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;
@@ -630,7 +674,12 @@ export declare const LandingPageSchema: z.ZodObject<{
             slug: z.ZodString;
             description: z.ZodNullable<z.ZodString>;
             parentId: z.ZodNullable<z.ZodString>;
-            imageUrl: z.ZodNullable<z.ZodString>;
+            image: z.ZodNullable<z.ZodObject<{
+                key: z.ZodString;
+                url: z.ZodString;
+                width: z.ZodNullable<z.ZodNumber>;
+                height: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
             metaTitle: z.ZodNullable<z.ZodString>;
             metaDescription: z.ZodNullable<z.ZodString>;
             metaKeywords: z.ZodNullable<z.ZodString>;
@@ -658,11 +707,11 @@ export declare const LandingPageSchema: z.ZodObject<{
             updatedAt: z.ZodString;
         }, z.core.$strip>>;
         images: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            url: z.ZodString;
+            width: z.ZodNullable<z.ZodNumber>;
+            height: z.ZodNullable<z.ZodNumber>;
             id: z.ZodString;
-            src: z.ZodString;
-            srcSm: z.ZodNullable<z.ZodString>;
-            srcMd: z.ZodNullable<z.ZodString>;
-            srcLg: z.ZodNullable<z.ZodString>;
             altText: z.ZodNullable<z.ZodString>;
             position: z.ZodNumber;
         }, z.core.$strip>>;
@@ -904,11 +953,11 @@ export declare const ProductPageEnvelopeSchema: z.ZodObject<{
         variantOptions: z.ZodNullable<z.ZodString>;
         tags: z.ZodNullable<z.ZodString>;
         coverImage: z.ZodNullable<z.ZodObject<{
+            key: z.ZodString;
+            url: z.ZodString;
+            width: z.ZodNullable<z.ZodNumber>;
+            height: z.ZodNullable<z.ZodNumber>;
             id: z.ZodString;
-            src: z.ZodString;
-            srcSm: z.ZodNullable<z.ZodString>;
-            srcMd: z.ZodNullable<z.ZodString>;
-            srcLg: z.ZodNullable<z.ZodString>;
             altText: z.ZodNullable<z.ZodString>;
             position: z.ZodNumber;
         }, z.core.$strip>>;