@01.software/sdk 0.40.0 → 0.41.0

package/dist/{types-D5uHrPLr.d.cts → types-Bl-m9ttd.d.cts}

@@ -1381,6 +1381,22 @@ type ProductListingCardOptions = {
     preferCompleteVariantFromHint?: boolean;
 };
 declare function buildProductHref(product: ProductHrefProduct, group?: ProductHrefGroup | null, options?: ProductHrefOptions): string;
+/**
+ * Server-equivalent sellability for a single variant: active, and either
+ * unlimited or with positive sellable stock (`stock - reservedStock`). This is
+ * the same rule the SDK applies when rolling availability up to the product, so
+ * storefronts can compute a Shopify-style `availableForSale` without
+ * re-implementing the check or shipping raw `stock`/`reservedStock` to the
+ * browser.
+ */
+declare function getVariantAvailableForSale(variant: ProductVariantShape): boolean;
+/**
+ * Sellable quantity for a single variant (`stock - reservedStock`, clamped at
+ * zero), or `null` when the variant is unlimited and has no finite quantity.
+ * Mirrors Shopify's `ProductVariant.quantityAvailable` (a single computed
+ * number, never the raw stock/reserved breakdown).
+ */
+declare function getVariantAvailableStock(variant: ProductVariantShape): number | null;
 declare function buildProductListingGroupProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingGroupProjection;
 declare function buildProductListingCard(item: ProductListingCardSourceItem, options?: ProductListingCardOptions): ProductListingCard;
 /** Shopify `priceRangeV2` naming for persisted listing projection fields. */
@@ -1414,6 +1430,20 @@ declare function toShopifyPriceRangeV2(listing: {
  * raw reads are constrained to `depth: 0`, `joins: false`, and no `populate`.
  */
 declare const PRODUCT_PLP_FIND_OPTIONS: ApiQueryOptions;
+/**
+ * Adapts a raw Payload product document (from
+ * `collections.from('products').find()`) into the listing shape the SDK
+ * listing builders consume. A raw product already carries `priceRange`,
+ * `compareAtPriceRange`, `availableForSale`, and `selectedOrFirstAvailableVariant`,
+ * but it has no `featuredImage` field — only the `images` gallery. This pure,
+ * non-lossy adapter fills `featuredImage` from the first non-null gallery image
+ * (when not already set) so SSG/sitemap consumers on the raw `find()` escape
+ * hatch can feed `buildProductListingGroupsByOption` / `buildProductListingCard`
+ * without hand-rolling the projection. An explicit `featuredImage` is preserved.
+ */
+declare function projectProductToListingShape<T extends ProductListingProductShape>(product: T): T & {
+    featuredImage: MediaValue;
+};
 /**
  * Builds product-first listing groups for one primary option.
  *
@@ -2577,4 +2607,4 @@ type DeepPartial<T> = {
 };
 type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-export { type CollectionFieldSchema as $, type AddItemParams as A, type RootReadOnlyQueryBuilder as B, CommerceClient as C, type DebugConfig as D, EventsClient as E, type StorefrontContentListOptions as F, type StorefrontContentReference as G, type StorefrontGalleryItem as H, type StorefrontGalleryItemsListOptions as I, type StorefrontGalleryItemsSort as J, type StorefrontLink as K, type StorefrontLinksListOptions as L, type StorefrontLinksSort as M, BaseApi as N, type ServerApiOptions as O, type PayloadFindResponse as P, ServerCommerceClient as Q, type RemoveDiscountParams as R, type Sort as S, type TenantIntrospectionClient as T, type UpdateItemParams as U, type BanCustomerParams as V, type Where as W, type CommunityBan as X, type UnbanCustomerParams as Y, type ClientServerConfig as Z, type RootServerClientWithEvents as _, CommunityClient as a, type CalculateShippingResult as a$, type CollectionSchemaResponse as a0, type EventGuestCancelParams as a1, type EventGuestRegistration as a2, type EventGuestRegistrationResponse as a3, type EventRegistrationAnswerInput as a4, type EventRegistrationAttendeeInput as a5, type EventRegistrationPublic as a6, type EventRegistrationRegisterParams as a7, type EventRegistrationRegisterResponse as a8, type EventsCalendarItem as a9, type CustomerAuthResponse as aA, type CustomerLoginData as aB, type CustomerRegisterResponse as aC, type CustomerRegisterData as aD, type CustomerRefreshResponse as aE, type UpdateProfileData as aF, type ProductListingPageBaseParams as aG, type ProductListingPageParams as aH, type ProductDetailParams as aI, type ProductDetailResult as aJ, type ProductListingPageCatalogParams as aK, type ProductListingPageResult as aL, type ProductListingGroupsCatalogItem as aM, type ProductListingPageFullParams as aN, type ProductListingGroupsItem as aO, type ProductDetail as aP, type ProductDetailCatalog as aQ, type StockSnapshotResponse as aR, type ProductSelectionMediaSource as aS, type ProductDisplayMediaSource as aT, type ResolveProductSelectionMediaInput as aU, type ResolveProductSelectionMediaResult as aV, type ProductSelectionMediaPointer as aW, type RootClientWithEvents as aX, type BulkImportFulfillmentsParams as aY, type BulkImportFulfillmentsResponse as aZ, type CalculateShippingParams as a_, type EventsClientOptions as aa, type EventsDateParam as ab, type EventsExternalSource as ac, type EventsLocation as ad, type EventsOccurrenceLocation as ae, type EventsRangeEvent as af, type EventsRangeOccurrence as ag, type EventsRangeParams as ah, type EventsRangeResponse as ai, type EventsTaxonomyItem as aj, ModerationApi as ak, type RootServerClient as al, type TenantFeatureProgressEvidenceValue as am, type TenantFeatureProgressFeature as an, type TenantFeatureProgressGroup as ao, type TenantFeatureProgressInput as ap, type TenantFeatureProgressItem as aq, type TenantFeatureProgressItemState as ar, type TenantFeatureProgressResponse as as, type TenantFeatureProgressSeverity as at, type TenantFeatureProgressStatus as au, TenantIntrospectionApi as av, type TenantIntrospectionApiOptions as aw, type PublicReadQueryOptions as ax, CustomerAuth as ay, type CustomerProfile as az, ContentClient as b, type ProductListingCardOptions as b$, type CancelOrderParams as b0, type CancelOrderReconciliationStatus as b1, type CancelOrderResponse as b2, type CancelReasonCode as b3, CartApi as b4, type CartApiOptions as b5, type Comment as b6, type CommerceClientOptions as b7, type CommunityClientOptions as b8, type CommunityComment as b9, OrderApi as bA, type OrderApiOptions as bB, PRODUCT_PLP_FIND_OPTIONS as bC, PRODUCT_UPSERT_READONLY_FIELD_REASON as bD, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as bE, type PrepareFulfillmentOrderParams as bF, type PrepareFulfillmentOrderResponse as bG, ProductApi as bH, type ProductApiOptions as bI, type ProductDetailBrand as bJ, type ProductDetailCatalogResult as bK, type ProductDetailCatalogVariant as bL, type ProductDetailCategory as bM, type ProductDetailImage as bN, type ProductDetailImageMedia as bO, type ProductDetailMedia as bP, type ProductDetailOption as bQ, type ProductDetailOptionValue as bR, type ProductDetailTag as bS, type ProductDetailUnavailableReason as bT, type ProductDetailVariant as bU, type ProductDetailVariantOptionValue as bV, type ProductDetailVideo as bW, type ProductHrefGroup as bX, type ProductHrefOptions as bY, type ProductHrefProduct as bZ, type ProductListingCard as b_, type CommunityCommentListSort as ba, type CommunityPost as bb, type CommunityPostCategory as bc, type CommunityPostListSort as bd, type CommunityPostTag as be, type CommunityPublicAuthorSnapshot as bf, type CommunityPublicMediaAsset as bg, type CommunityPublicReference as bh, type CompatibilityProductSelectionParamEvent as bi, type ConfirmPaymentParams as bj, type ConfirmPaymentResponse as bk, type CreateFulfillmentParams as bl, type CreateOrderItem as bm, type CreateOrderParams as bn, type CreateReturnParams as bo, type CustomerAuthOptions as bp, type CustomerOrderListOptions as bq, type CustomerSnapshot as br, DiscountApi as bs, type DiscountApiOptions as bt, type FeaturedImagePointerInput as bu, type LegacyProductSelectionParamEvent as bv, type ListingGroupsParams as bw, type MediaValue as bx, type NormalizedOptionSwatch as by, type NormalizedProductSelection as bz, CustomerNamespace as c, type UpdateTransactionParams as c$, type ProductListingCardPriceRange as c0, type ProductListingCardRepresentativeVariant as c1, type ProductListingGroup as c2, type ProductListingGroupCatalogSummary as c3, type ProductListingGroupCatalogVariant as c4, type ProductListingGroupProjection as c5, type ProductListingGroupSummary as c6, type ProductListingGroupVariant as c7, type ProductListingGroupsCatalogProduct as c8, type ProductListingGroupsCatalogResponse as c9, type ProductSelectionUrlEmit as cA, type ProductSelectionVariant as cB, type ProductUpsertFieldValidationErrorBody as cC, type ProductUpsertFieldValidationErrorReason as cD, type ProductVariantShape as cE, type RequestOptions as cF, type ResolveCancelRefundFailedResponse as cG, type ResolveCancelRefundOutcome as cH, type ResolveCancelRefundParams as cI, type ResolveCancelRefundResponse as cJ, type ResolveCancelRefundSucceededResponse as cK, type ResolveProductDisplayMediaInput as cL, type ResolveProductDisplayMediaResult as cM, type ReturnItem as cN, type ReturnReason as cO, type ReturnWithRefundItem as cP, type ReturnWithRefundParams as cQ, ShippingApi as cR, type ShippingApiOptions as cS, type StockCheckParams as cT, type StockCheckResponse as cU, type StockCheckResult as cV, type StockSnapshotItem as cW, type StockSnapshotParams as cX, type UpdateFulfillmentParams as cY, type UpdateOrderParams as cZ, type UpdateReturnParams as c_, type ProductListingGroupsProduct as ca, type ProductListingGroupsResponse as cb, type ProductListingPageFilters as cc, type ProductListingPageSort as cd, type ProductListingProductShape as ce, type ProductListingSwatch as cf, type ProductMediaResolutionSource as cg, type ProductMoneyRange as ch, type ProductOptionMatrix as ci, type ProductOptionMatrixOption as cj, type ProductOptionMatrixValue as ck, type ProductOptionMatrixVariant as cl, type ProductOptionShape as cm, type ProductOptionValueShape as cn, type ProductOptionValueSwatch as co, type ProductOptionValueSwatchInput as cp, type ProductPriceRange as cq, type ProductSelectionAvailableSwatch as cr, type ProductSelectionAvailableValue as cs, type ProductSelectionByOptionValue as ct, ProductSelectionCodecError as cu, type ProductSelectionCodecOptions as cv, type ProductSelectionInput as cw, type ProductSelectionOptionValue as cx, type ProductSelectionResolution as cy, type ProductSelectionResolutionContext as cz, type ClientState as d, type ValidateDiscountParams as d0, type ValidateDiscountResult as d1, type WithIdempotencyKey as d2, buildProductHref as d3, buildProductListingCard as d4, buildProductListingGroupProjection as d5, buildProductListingGroupsByOption as d6, buildProductOptionMatrix as d7, buildProductOptionMatrixFromDetail as d8, createProductSelectionCodec as d9, getAvailableOptionValues as da, getProductSelectionImages as db, getSelectedValueByOptionId as dc, isProductUpsertFieldValidationErrorBody as dd, normalizeProductSelection as de, normalizeProductSelectionFromMatrix as df, normalizeSelectedValueIds as dg, parseProductSelection as dh, resolveFeaturedImagePointer as di, resolveProductDisplayMedia as dj, resolveProductSelection as dk, resolveProductSelectionFromMatrix as dl, resolveProductSelectionMedia as dm, resolveVariantForSelection as dn, selectNext as dp, selectedSwatchMediaItemId as dq, stringifyProductSelection as dr, toShopifyPriceRangeV2 as ds, type ClientConfig as e, type ApiQueryOptions as f, type ApplyDiscountParams as g, type CheckoutParams as h, type ClearCartParams as i, type ClientMetadata as j, type ContentClientOptions as k, type DeepPartial as l, type ExtractArrayType as m, type PayloadMutationResponse as n, type PublicCart as o, type PublicCartItem as p, type PublicCartReference as q, type PublicMediaAsset as r, type PublicMediaSize as s, type PublicOrder as t, type PublicOrderItem as u, type PublicOrderReference as v, type RemoveItemParams as w, type RetryConfig as x, type RootClient as y, type RootCollectionClient as z };
+export { type CollectionFieldSchema as $, type AddItemParams as A, type RootReadOnlyQueryBuilder as B, CommerceClient as C, type DebugConfig as D, EventsClient as E, type StorefrontContentListOptions as F, type StorefrontContentReference as G, type StorefrontGalleryItem as H, type StorefrontGalleryItemsListOptions as I, type StorefrontGalleryItemsSort as J, type StorefrontLink as K, type StorefrontLinksListOptions as L, type StorefrontLinksSort as M, BaseApi as N, type ServerApiOptions as O, type PayloadFindResponse as P, ServerCommerceClient as Q, type RemoveDiscountParams as R, type Sort as S, type TenantIntrospectionClient as T, type UpdateItemParams as U, type BanCustomerParams as V, type Where as W, type CommunityBan as X, type UnbanCustomerParams as Y, type ClientServerConfig as Z, type RootServerClientWithEvents as _, CommunityClient as a, type CalculateShippingResult as a$, type CollectionSchemaResponse as a0, type EventGuestCancelParams as a1, type EventGuestRegistration as a2, type EventGuestRegistrationResponse as a3, type EventRegistrationAnswerInput as a4, type EventRegistrationAttendeeInput as a5, type EventRegistrationPublic as a6, type EventRegistrationRegisterParams as a7, type EventRegistrationRegisterResponse as a8, type EventsCalendarItem as a9, type CustomerAuthResponse as aA, type CustomerLoginData as aB, type CustomerRegisterResponse as aC, type CustomerRegisterData as aD, type CustomerRefreshResponse as aE, type UpdateProfileData as aF, type ProductListingPageBaseParams as aG, type ProductListingPageParams as aH, type ProductDetailParams as aI, type ProductDetailResult as aJ, type ProductListingPageCatalogParams as aK, type ProductListingPageResult as aL, type ProductListingGroupsCatalogItem as aM, type ProductListingPageFullParams as aN, type ProductListingGroupsItem as aO, type ProductDetail as aP, type ProductDetailCatalog as aQ, type StockSnapshotResponse as aR, type ProductSelectionMediaSource as aS, type ProductDisplayMediaSource as aT, type ResolveProductSelectionMediaInput as aU, type ResolveProductSelectionMediaResult as aV, type ProductSelectionMediaPointer as aW, type RootClientWithEvents as aX, type BulkImportFulfillmentsParams as aY, type BulkImportFulfillmentsResponse as aZ, type CalculateShippingParams as a_, type EventsClientOptions as aa, type EventsDateParam as ab, type EventsExternalSource as ac, type EventsLocation as ad, type EventsOccurrenceLocation as ae, type EventsRangeEvent as af, type EventsRangeOccurrence as ag, type EventsRangeParams as ah, type EventsRangeResponse as ai, type EventsTaxonomyItem as aj, ModerationApi as ak, type RootServerClient as al, type TenantFeatureProgressEvidenceValue as am, type TenantFeatureProgressFeature as an, type TenantFeatureProgressGroup as ao, type TenantFeatureProgressInput as ap, type TenantFeatureProgressItem as aq, type TenantFeatureProgressItemState as ar, type TenantFeatureProgressResponse as as, type TenantFeatureProgressSeverity as at, type TenantFeatureProgressStatus as au, TenantIntrospectionApi as av, type TenantIntrospectionApiOptions as aw, type PublicReadQueryOptions as ax, CustomerAuth as ay, type CustomerProfile as az, ContentClient as b, type ProductListingCardOptions as b$, type CancelOrderParams as b0, type CancelOrderReconciliationStatus as b1, type CancelOrderResponse as b2, type CancelReasonCode as b3, CartApi as b4, type CartApiOptions as b5, type Comment as b6, type CommerceClientOptions as b7, type CommunityClientOptions as b8, type CommunityComment as b9, OrderApi as bA, type OrderApiOptions as bB, PRODUCT_PLP_FIND_OPTIONS as bC, PRODUCT_UPSERT_READONLY_FIELD_REASON as bD, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as bE, type PrepareFulfillmentOrderParams as bF, type PrepareFulfillmentOrderResponse as bG, ProductApi as bH, type ProductApiOptions as bI, type ProductDetailBrand as bJ, type ProductDetailCatalogResult as bK, type ProductDetailCatalogVariant as bL, type ProductDetailCategory as bM, type ProductDetailImage as bN, type ProductDetailImageMedia as bO, type ProductDetailMedia as bP, type ProductDetailOption as bQ, type ProductDetailOptionValue as bR, type ProductDetailTag as bS, type ProductDetailUnavailableReason as bT, type ProductDetailVariant as bU, type ProductDetailVariantOptionValue as bV, type ProductDetailVideo as bW, type ProductHrefGroup as bX, type ProductHrefOptions as bY, type ProductHrefProduct as bZ, type ProductListingCard as b_, type CommunityCommentListSort as ba, type CommunityPost as bb, type CommunityPostCategory as bc, type CommunityPostListSort as bd, type CommunityPostTag as be, type CommunityPublicAuthorSnapshot as bf, type CommunityPublicMediaAsset as bg, type CommunityPublicReference as bh, type CompatibilityProductSelectionParamEvent as bi, type ConfirmPaymentParams as bj, type ConfirmPaymentResponse as bk, type CreateFulfillmentParams as bl, type CreateOrderItem as bm, type CreateOrderParams as bn, type CreateReturnParams as bo, type CustomerAuthOptions as bp, type CustomerOrderListOptions as bq, type CustomerSnapshot as br, DiscountApi as bs, type DiscountApiOptions as bt, type FeaturedImagePointerInput as bu, type LegacyProductSelectionParamEvent as bv, type ListingGroupsParams as bw, type MediaValue as bx, type NormalizedOptionSwatch as by, type NormalizedProductSelection as bz, CustomerNamespace as c, type UpdateTransactionParams as c$, type ProductListingCardPriceRange as c0, type ProductListingCardRepresentativeVariant as c1, type ProductListingGroup as c2, type ProductListingGroupCatalogSummary as c3, type ProductListingGroupCatalogVariant as c4, type ProductListingGroupProjection as c5, type ProductListingGroupSummary as c6, type ProductListingGroupVariant as c7, type ProductListingGroupsCatalogProduct as c8, type ProductListingGroupsCatalogResponse as c9, type ProductSelectionUrlEmit as cA, type ProductSelectionVariant as cB, type ProductUpsertFieldValidationErrorBody as cC, type ProductUpsertFieldValidationErrorReason as cD, type ProductVariantShape as cE, type RequestOptions as cF, type ResolveCancelRefundFailedResponse as cG, type ResolveCancelRefundOutcome as cH, type ResolveCancelRefundParams as cI, type ResolveCancelRefundResponse as cJ, type ResolveCancelRefundSucceededResponse as cK, type ResolveProductDisplayMediaInput as cL, type ResolveProductDisplayMediaResult as cM, type ReturnItem as cN, type ReturnReason as cO, type ReturnWithRefundItem as cP, type ReturnWithRefundParams as cQ, ShippingApi as cR, type ShippingApiOptions as cS, type StockCheckParams as cT, type StockCheckResponse as cU, type StockCheckResult as cV, type StockSnapshotItem as cW, type StockSnapshotParams as cX, type UpdateFulfillmentParams as cY, type UpdateOrderParams as cZ, type UpdateReturnParams as c_, type ProductListingGroupsProduct as ca, type ProductListingGroupsResponse as cb, type ProductListingPageFilters as cc, type ProductListingPageSort as cd, type ProductListingProductShape as ce, type ProductListingSwatch as cf, type ProductMediaResolutionSource as cg, type ProductMoneyRange as ch, type ProductOptionMatrix as ci, type ProductOptionMatrixOption as cj, type ProductOptionMatrixValue as ck, type ProductOptionMatrixVariant as cl, type ProductOptionShape as cm, type ProductOptionValueShape as cn, type ProductOptionValueSwatch as co, type ProductOptionValueSwatchInput as cp, type ProductPriceRange as cq, type ProductSelectionAvailableSwatch as cr, type ProductSelectionAvailableValue as cs, type ProductSelectionByOptionValue as ct, ProductSelectionCodecError as cu, type ProductSelectionCodecOptions as cv, type ProductSelectionInput as cw, type ProductSelectionOptionValue as cx, type ProductSelectionResolution as cy, type ProductSelectionResolutionContext as cz, type ClientState as d, type ValidateDiscountParams as d0, type ValidateDiscountResult as d1, type WithIdempotencyKey as d2, buildProductHref as d3, buildProductListingCard as d4, buildProductListingGroupProjection as d5, buildProductListingGroupsByOption as d6, buildProductOptionMatrix as d7, buildProductOptionMatrixFromDetail as d8, createProductSelectionCodec as d9, getAvailableOptionValues as da, getProductSelectionImages as db, getSelectedValueByOptionId as dc, getVariantAvailableForSale as dd, getVariantAvailableStock as de, isProductUpsertFieldValidationErrorBody as df, normalizeProductSelection as dg, normalizeProductSelectionFromMatrix as dh, normalizeSelectedValueIds as di, parseProductSelection as dj, projectProductToListingShape as dk, resolveFeaturedImagePointer as dl, resolveProductDisplayMedia as dm, resolveProductSelection as dn, resolveProductSelectionFromMatrix as dp, resolveProductSelectionMedia as dq, resolveVariantForSelection as dr, selectNext as ds, selectedSwatchMediaItemId as dt, stringifyProductSelection as du, toShopifyPriceRangeV2 as dv, type ClientConfig as e, type ApiQueryOptions as f, type ApplyDiscountParams as g, type CheckoutParams as h, type ClearCartParams as i, type ClientMetadata as j, type ContentClientOptions as k, type DeepPartial as l, type ExtractArrayType as m, type PayloadMutationResponse as n, type PublicCart as o, type PublicCartItem as p, type PublicCartReference as q, type PublicMediaAsset as r, type PublicMediaSize as s, type PublicOrder as t, type PublicOrderItem as u, type PublicOrderReference as v, type RemoveItemParams as w, type RetryConfig as x, type RootClient as y, type RootCollectionClient as z };

package/dist/{types-Umd-YTjM.d.ts → types-CHrzs2GB.d.ts}

@@ -1381,6 +1381,22 @@ type ProductListingCardOptions = {
     preferCompleteVariantFromHint?: boolean;
 };
 declare function buildProductHref(product: ProductHrefProduct, group?: ProductHrefGroup | null, options?: ProductHrefOptions): string;
+/**
+ * Server-equivalent sellability for a single variant: active, and either
+ * unlimited or with positive sellable stock (`stock - reservedStock`). This is
+ * the same rule the SDK applies when rolling availability up to the product, so
+ * storefronts can compute a Shopify-style `availableForSale` without
+ * re-implementing the check or shipping raw `stock`/`reservedStock` to the
+ * browser.
+ */
+declare function getVariantAvailableForSale(variant: ProductVariantShape): boolean;
+/**
+ * Sellable quantity for a single variant (`stock - reservedStock`, clamped at
+ * zero), or `null` when the variant is unlimited and has no finite quantity.
+ * Mirrors Shopify's `ProductVariant.quantityAvailable` (a single computed
+ * number, never the raw stock/reserved breakdown).
+ */
+declare function getVariantAvailableStock(variant: ProductVariantShape): number | null;
 declare function buildProductListingGroupProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingGroupProjection;
 declare function buildProductListingCard(item: ProductListingCardSourceItem, options?: ProductListingCardOptions): ProductListingCard;
 /** Shopify `priceRangeV2` naming for persisted listing projection fields. */
@@ -1414,6 +1430,20 @@ declare function toShopifyPriceRangeV2(listing: {
  * raw reads are constrained to `depth: 0`, `joins: false`, and no `populate`.
  */
 declare const PRODUCT_PLP_FIND_OPTIONS: ApiQueryOptions;
+/**
+ * Adapts a raw Payload product document (from
+ * `collections.from('products').find()`) into the listing shape the SDK
+ * listing builders consume. A raw product already carries `priceRange`,
+ * `compareAtPriceRange`, `availableForSale`, and `selectedOrFirstAvailableVariant`,
+ * but it has no `featuredImage` field — only the `images` gallery. This pure,
+ * non-lossy adapter fills `featuredImage` from the first non-null gallery image
+ * (when not already set) so SSG/sitemap consumers on the raw `find()` escape
+ * hatch can feed `buildProductListingGroupsByOption` / `buildProductListingCard`
+ * without hand-rolling the projection. An explicit `featuredImage` is preserved.
+ */
+declare function projectProductToListingShape<T extends ProductListingProductShape>(product: T): T & {
+    featuredImage: MediaValue;
+};
 /**
  * Builds product-first listing groups for one primary option.
  *
@@ -2577,4 +2607,4 @@ type DeepPartial<T> = {
 };
 type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-export { type CollectionFieldSchema as $, type AddItemParams as A, type RootReadOnlyQueryBuilder as B, CommerceClient as C, type DebugConfig as D, EventsClient as E, type StorefrontContentListOptions as F, type StorefrontContentReference as G, type StorefrontGalleryItem as H, type StorefrontGalleryItemsListOptions as I, type StorefrontGalleryItemsSort as J, type StorefrontLink as K, type StorefrontLinksListOptions as L, type StorefrontLinksSort as M, BaseApi as N, type ServerApiOptions as O, type PayloadFindResponse as P, ServerCommerceClient as Q, type RemoveDiscountParams as R, type Sort as S, type TenantIntrospectionClient as T, type UpdateItemParams as U, type BanCustomerParams as V, type Where as W, type CommunityBan as X, type UnbanCustomerParams as Y, type ClientServerConfig as Z, type RootServerClientWithEvents as _, CommunityClient as a, type CalculateShippingResult as a$, type CollectionSchemaResponse as a0, type EventGuestCancelParams as a1, type EventGuestRegistration as a2, type EventGuestRegistrationResponse as a3, type EventRegistrationAnswerInput as a4, type EventRegistrationAttendeeInput as a5, type EventRegistrationPublic as a6, type EventRegistrationRegisterParams as a7, type EventRegistrationRegisterResponse as a8, type EventsCalendarItem as a9, type CustomerAuthResponse as aA, type CustomerLoginData as aB, type CustomerRegisterResponse as aC, type CustomerRegisterData as aD, type CustomerRefreshResponse as aE, type UpdateProfileData as aF, type ProductListingPageBaseParams as aG, type ProductListingPageParams as aH, type ProductDetailParams as aI, type ProductDetailResult as aJ, type ProductListingPageCatalogParams as aK, type ProductListingPageResult as aL, type ProductListingGroupsCatalogItem as aM, type ProductListingPageFullParams as aN, type ProductListingGroupsItem as aO, type ProductDetail as aP, type ProductDetailCatalog as aQ, type StockSnapshotResponse as aR, type ProductSelectionMediaSource as aS, type ProductDisplayMediaSource as aT, type ResolveProductSelectionMediaInput as aU, type ResolveProductSelectionMediaResult as aV, type ProductSelectionMediaPointer as aW, type RootClientWithEvents as aX, type BulkImportFulfillmentsParams as aY, type BulkImportFulfillmentsResponse as aZ, type CalculateShippingParams as a_, type EventsClientOptions as aa, type EventsDateParam as ab, type EventsExternalSource as ac, type EventsLocation as ad, type EventsOccurrenceLocation as ae, type EventsRangeEvent as af, type EventsRangeOccurrence as ag, type EventsRangeParams as ah, type EventsRangeResponse as ai, type EventsTaxonomyItem as aj, ModerationApi as ak, type RootServerClient as al, type TenantFeatureProgressEvidenceValue as am, type TenantFeatureProgressFeature as an, type TenantFeatureProgressGroup as ao, type TenantFeatureProgressInput as ap, type TenantFeatureProgressItem as aq, type TenantFeatureProgressItemState as ar, type TenantFeatureProgressResponse as as, type TenantFeatureProgressSeverity as at, type TenantFeatureProgressStatus as au, TenantIntrospectionApi as av, type TenantIntrospectionApiOptions as aw, type PublicReadQueryOptions as ax, CustomerAuth as ay, type CustomerProfile as az, ContentClient as b, type ProductListingCardOptions as b$, type CancelOrderParams as b0, type CancelOrderReconciliationStatus as b1, type CancelOrderResponse as b2, type CancelReasonCode as b3, CartApi as b4, type CartApiOptions as b5, type Comment as b6, type CommerceClientOptions as b7, type CommunityClientOptions as b8, type CommunityComment as b9, OrderApi as bA, type OrderApiOptions as bB, PRODUCT_PLP_FIND_OPTIONS as bC, PRODUCT_UPSERT_READONLY_FIELD_REASON as bD, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as bE, type PrepareFulfillmentOrderParams as bF, type PrepareFulfillmentOrderResponse as bG, ProductApi as bH, type ProductApiOptions as bI, type ProductDetailBrand as bJ, type ProductDetailCatalogResult as bK, type ProductDetailCatalogVariant as bL, type ProductDetailCategory as bM, type ProductDetailImage as bN, type ProductDetailImageMedia as bO, type ProductDetailMedia as bP, type ProductDetailOption as bQ, type ProductDetailOptionValue as bR, type ProductDetailTag as bS, type ProductDetailUnavailableReason as bT, type ProductDetailVariant as bU, type ProductDetailVariantOptionValue as bV, type ProductDetailVideo as bW, type ProductHrefGroup as bX, type ProductHrefOptions as bY, type ProductHrefProduct as bZ, type ProductListingCard as b_, type CommunityCommentListSort as ba, type CommunityPost as bb, type CommunityPostCategory as bc, type CommunityPostListSort as bd, type CommunityPostTag as be, type CommunityPublicAuthorSnapshot as bf, type CommunityPublicMediaAsset as bg, type CommunityPublicReference as bh, type CompatibilityProductSelectionParamEvent as bi, type ConfirmPaymentParams as bj, type ConfirmPaymentResponse as bk, type CreateFulfillmentParams as bl, type CreateOrderItem as bm, type CreateOrderParams as bn, type CreateReturnParams as bo, type CustomerAuthOptions as bp, type CustomerOrderListOptions as bq, type CustomerSnapshot as br, DiscountApi as bs, type DiscountApiOptions as bt, type FeaturedImagePointerInput as bu, type LegacyProductSelectionParamEvent as bv, type ListingGroupsParams as bw, type MediaValue as bx, type NormalizedOptionSwatch as by, type NormalizedProductSelection as bz, CustomerNamespace as c, type UpdateTransactionParams as c$, type ProductListingCardPriceRange as c0, type ProductListingCardRepresentativeVariant as c1, type ProductListingGroup as c2, type ProductListingGroupCatalogSummary as c3, type ProductListingGroupCatalogVariant as c4, type ProductListingGroupProjection as c5, type ProductListingGroupSummary as c6, type ProductListingGroupVariant as c7, type ProductListingGroupsCatalogProduct as c8, type ProductListingGroupsCatalogResponse as c9, type ProductSelectionUrlEmit as cA, type ProductSelectionVariant as cB, type ProductUpsertFieldValidationErrorBody as cC, type ProductUpsertFieldValidationErrorReason as cD, type ProductVariantShape as cE, type RequestOptions as cF, type ResolveCancelRefundFailedResponse as cG, type ResolveCancelRefundOutcome as cH, type ResolveCancelRefundParams as cI, type ResolveCancelRefundResponse as cJ, type ResolveCancelRefundSucceededResponse as cK, type ResolveProductDisplayMediaInput as cL, type ResolveProductDisplayMediaResult as cM, type ReturnItem as cN, type ReturnReason as cO, type ReturnWithRefundItem as cP, type ReturnWithRefundParams as cQ, ShippingApi as cR, type ShippingApiOptions as cS, type StockCheckParams as cT, type StockCheckResponse as cU, type StockCheckResult as cV, type StockSnapshotItem as cW, type StockSnapshotParams as cX, type UpdateFulfillmentParams as cY, type UpdateOrderParams as cZ, type UpdateReturnParams as c_, type ProductListingGroupsProduct as ca, type ProductListingGroupsResponse as cb, type ProductListingPageFilters as cc, type ProductListingPageSort as cd, type ProductListingProductShape as ce, type ProductListingSwatch as cf, type ProductMediaResolutionSource as cg, type ProductMoneyRange as ch, type ProductOptionMatrix as ci, type ProductOptionMatrixOption as cj, type ProductOptionMatrixValue as ck, type ProductOptionMatrixVariant as cl, type ProductOptionShape as cm, type ProductOptionValueShape as cn, type ProductOptionValueSwatch as co, type ProductOptionValueSwatchInput as cp, type ProductPriceRange as cq, type ProductSelectionAvailableSwatch as cr, type ProductSelectionAvailableValue as cs, type ProductSelectionByOptionValue as ct, ProductSelectionCodecError as cu, type ProductSelectionCodecOptions as cv, type ProductSelectionInput as cw, type ProductSelectionOptionValue as cx, type ProductSelectionResolution as cy, type ProductSelectionResolutionContext as cz, type ClientState as d, type ValidateDiscountParams as d0, type ValidateDiscountResult as d1, type WithIdempotencyKey as d2, buildProductHref as d3, buildProductListingCard as d4, buildProductListingGroupProjection as d5, buildProductListingGroupsByOption as d6, buildProductOptionMatrix as d7, buildProductOptionMatrixFromDetail as d8, createProductSelectionCodec as d9, getAvailableOptionValues as da, getProductSelectionImages as db, getSelectedValueByOptionId as dc, isProductUpsertFieldValidationErrorBody as dd, normalizeProductSelection as de, normalizeProductSelectionFromMatrix as df, normalizeSelectedValueIds as dg, parseProductSelection as dh, resolveFeaturedImagePointer as di, resolveProductDisplayMedia as dj, resolveProductSelection as dk, resolveProductSelectionFromMatrix as dl, resolveProductSelectionMedia as dm, resolveVariantForSelection as dn, selectNext as dp, selectedSwatchMediaItemId as dq, stringifyProductSelection as dr, toShopifyPriceRangeV2 as ds, type ClientConfig as e, type ApiQueryOptions as f, type ApplyDiscountParams as g, type CheckoutParams as h, type ClearCartParams as i, type ClientMetadata as j, type ContentClientOptions as k, type DeepPartial as l, type ExtractArrayType as m, type PayloadMutationResponse as n, type PublicCart as o, type PublicCartItem as p, type PublicCartReference as q, type PublicMediaAsset as r, type PublicMediaSize as s, type PublicOrder as t, type PublicOrderItem as u, type PublicOrderReference as v, type RemoveItemParams as w, type RetryConfig as x, type RootClient as y, type RootCollectionClient as z };
+export { type CollectionFieldSchema as $, type AddItemParams as A, type RootReadOnlyQueryBuilder as B, CommerceClient as C, type DebugConfig as D, EventsClient as E, type StorefrontContentListOptions as F, type StorefrontContentReference as G, type StorefrontGalleryItem as H, type StorefrontGalleryItemsListOptions as I, type StorefrontGalleryItemsSort as J, type StorefrontLink as K, type StorefrontLinksListOptions as L, type StorefrontLinksSort as M, BaseApi as N, type ServerApiOptions as O, type PayloadFindResponse as P, ServerCommerceClient as Q, type RemoveDiscountParams as R, type Sort as S, type TenantIntrospectionClient as T, type UpdateItemParams as U, type BanCustomerParams as V, type Where as W, type CommunityBan as X, type UnbanCustomerParams as Y, type ClientServerConfig as Z, type RootServerClientWithEvents as _, CommunityClient as a, type CalculateShippingResult as a$, type CollectionSchemaResponse as a0, type EventGuestCancelParams as a1, type EventGuestRegistration as a2, type EventGuestRegistrationResponse as a3, type EventRegistrationAnswerInput as a4, type EventRegistrationAttendeeInput as a5, type EventRegistrationPublic as a6, type EventRegistrationRegisterParams as a7, type EventRegistrationRegisterResponse as a8, type EventsCalendarItem as a9, type CustomerAuthResponse as aA, type CustomerLoginData as aB, type CustomerRegisterResponse as aC, type CustomerRegisterData as aD, type CustomerRefreshResponse as aE, type UpdateProfileData as aF, type ProductListingPageBaseParams as aG, type ProductListingPageParams as aH, type ProductDetailParams as aI, type ProductDetailResult as aJ, type ProductListingPageCatalogParams as aK, type ProductListingPageResult as aL, type ProductListingGroupsCatalogItem as aM, type ProductListingPageFullParams as aN, type ProductListingGroupsItem as aO, type ProductDetail as aP, type ProductDetailCatalog as aQ, type StockSnapshotResponse as aR, type ProductSelectionMediaSource as aS, type ProductDisplayMediaSource as aT, type ResolveProductSelectionMediaInput as aU, type ResolveProductSelectionMediaResult as aV, type ProductSelectionMediaPointer as aW, type RootClientWithEvents as aX, type BulkImportFulfillmentsParams as aY, type BulkImportFulfillmentsResponse as aZ, type CalculateShippingParams as a_, type EventsClientOptions as aa, type EventsDateParam as ab, type EventsExternalSource as ac, type EventsLocation as ad, type EventsOccurrenceLocation as ae, type EventsRangeEvent as af, type EventsRangeOccurrence as ag, type EventsRangeParams as ah, type EventsRangeResponse as ai, type EventsTaxonomyItem as aj, ModerationApi as ak, type RootServerClient as al, type TenantFeatureProgressEvidenceValue as am, type TenantFeatureProgressFeature as an, type TenantFeatureProgressGroup as ao, type TenantFeatureProgressInput as ap, type TenantFeatureProgressItem as aq, type TenantFeatureProgressItemState as ar, type TenantFeatureProgressResponse as as, type TenantFeatureProgressSeverity as at, type TenantFeatureProgressStatus as au, TenantIntrospectionApi as av, type TenantIntrospectionApiOptions as aw, type PublicReadQueryOptions as ax, CustomerAuth as ay, type CustomerProfile as az, ContentClient as b, type ProductListingCardOptions as b$, type CancelOrderParams as b0, type CancelOrderReconciliationStatus as b1, type CancelOrderResponse as b2, type CancelReasonCode as b3, CartApi as b4, type CartApiOptions as b5, type Comment as b6, type CommerceClientOptions as b7, type CommunityClientOptions as b8, type CommunityComment as b9, OrderApi as bA, type OrderApiOptions as bB, PRODUCT_PLP_FIND_OPTIONS as bC, PRODUCT_UPSERT_READONLY_FIELD_REASON as bD, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as bE, type PrepareFulfillmentOrderParams as bF, type PrepareFulfillmentOrderResponse as bG, ProductApi as bH, type ProductApiOptions as bI, type ProductDetailBrand as bJ, type ProductDetailCatalogResult as bK, type ProductDetailCatalogVariant as bL, type ProductDetailCategory as bM, type ProductDetailImage as bN, type ProductDetailImageMedia as bO, type ProductDetailMedia as bP, type ProductDetailOption as bQ, type ProductDetailOptionValue as bR, type ProductDetailTag as bS, type ProductDetailUnavailableReason as bT, type ProductDetailVariant as bU, type ProductDetailVariantOptionValue as bV, type ProductDetailVideo as bW, type ProductHrefGroup as bX, type ProductHrefOptions as bY, type ProductHrefProduct as bZ, type ProductListingCard as b_, type CommunityCommentListSort as ba, type CommunityPost as bb, type CommunityPostCategory as bc, type CommunityPostListSort as bd, type CommunityPostTag as be, type CommunityPublicAuthorSnapshot as bf, type CommunityPublicMediaAsset as bg, type CommunityPublicReference as bh, type CompatibilityProductSelectionParamEvent as bi, type ConfirmPaymentParams as bj, type ConfirmPaymentResponse as bk, type CreateFulfillmentParams as bl, type CreateOrderItem as bm, type CreateOrderParams as bn, type CreateReturnParams as bo, type CustomerAuthOptions as bp, type CustomerOrderListOptions as bq, type CustomerSnapshot as br, DiscountApi as bs, type DiscountApiOptions as bt, type FeaturedImagePointerInput as bu, type LegacyProductSelectionParamEvent as bv, type ListingGroupsParams as bw, type MediaValue as bx, type NormalizedOptionSwatch as by, type NormalizedProductSelection as bz, CustomerNamespace as c, type UpdateTransactionParams as c$, type ProductListingCardPriceRange as c0, type ProductListingCardRepresentativeVariant as c1, type ProductListingGroup as c2, type ProductListingGroupCatalogSummary as c3, type ProductListingGroupCatalogVariant as c4, type ProductListingGroupProjection as c5, type ProductListingGroupSummary as c6, type ProductListingGroupVariant as c7, type ProductListingGroupsCatalogProduct as c8, type ProductListingGroupsCatalogResponse as c9, type ProductSelectionUrlEmit as cA, type ProductSelectionVariant as cB, type ProductUpsertFieldValidationErrorBody as cC, type ProductUpsertFieldValidationErrorReason as cD, type ProductVariantShape as cE, type RequestOptions as cF, type ResolveCancelRefundFailedResponse as cG, type ResolveCancelRefundOutcome as cH, type ResolveCancelRefundParams as cI, type ResolveCancelRefundResponse as cJ, type ResolveCancelRefundSucceededResponse as cK, type ResolveProductDisplayMediaInput as cL, type ResolveProductDisplayMediaResult as cM, type ReturnItem as cN, type ReturnReason as cO, type ReturnWithRefundItem as cP, type ReturnWithRefundParams as cQ, ShippingApi as cR, type ShippingApiOptions as cS, type StockCheckParams as cT, type StockCheckResponse as cU, type StockCheckResult as cV, type StockSnapshotItem as cW, type StockSnapshotParams as cX, type UpdateFulfillmentParams as cY, type UpdateOrderParams as cZ, type UpdateReturnParams as c_, type ProductListingGroupsProduct as ca, type ProductListingGroupsResponse as cb, type ProductListingPageFilters as cc, type ProductListingPageSort as cd, type ProductListingProductShape as ce, type ProductListingSwatch as cf, type ProductMediaResolutionSource as cg, type ProductMoneyRange as ch, type ProductOptionMatrix as ci, type ProductOptionMatrixOption as cj, type ProductOptionMatrixValue as ck, type ProductOptionMatrixVariant as cl, type ProductOptionShape as cm, type ProductOptionValueShape as cn, type ProductOptionValueSwatch as co, type ProductOptionValueSwatchInput as cp, type ProductPriceRange as cq, type ProductSelectionAvailableSwatch as cr, type ProductSelectionAvailableValue as cs, type ProductSelectionByOptionValue as ct, ProductSelectionCodecError as cu, type ProductSelectionCodecOptions as cv, type ProductSelectionInput as cw, type ProductSelectionOptionValue as cx, type ProductSelectionResolution as cy, type ProductSelectionResolutionContext as cz, type ClientState as d, type ValidateDiscountParams as d0, type ValidateDiscountResult as d1, type WithIdempotencyKey as d2, buildProductHref as d3, buildProductListingCard as d4, buildProductListingGroupProjection as d5, buildProductListingGroupsByOption as d6, buildProductOptionMatrix as d7, buildProductOptionMatrixFromDetail as d8, createProductSelectionCodec as d9, getAvailableOptionValues as da, getProductSelectionImages as db, getSelectedValueByOptionId as dc, getVariantAvailableForSale as dd, getVariantAvailableStock as de, isProductUpsertFieldValidationErrorBody as df, normalizeProductSelection as dg, normalizeProductSelectionFromMatrix as dh, normalizeSelectedValueIds as di, parseProductSelection as dj, projectProductToListingShape as dk, resolveFeaturedImagePointer as dl, resolveProductDisplayMedia as dm, resolveProductSelection as dn, resolveProductSelectionFromMatrix as dp, resolveProductSelectionMedia as dq, resolveVariantForSelection as dr, selectNext as ds, selectedSwatchMediaItemId as dt, stringifyProductSelection as du, toShopifyPriceRangeV2 as dv, type ClientConfig as e, type ApiQueryOptions as f, type ApplyDiscountParams as g, type CheckoutParams as h, type ClearCartParams as i, type ClientMetadata as j, type ContentClientOptions as k, type DeepPartial as l, type ExtractArrayType as m, type PayloadMutationResponse as n, type PublicCart as o, type PublicCartItem as p, type PublicCartReference as q, type PublicMediaAsset as r, type PublicMediaSize as s, type PublicOrder as t, type PublicOrderItem as u, type PublicOrderReference as v, type RemoveItemParams as w, type RetryConfig as x, type RootClient as y, type RootCollectionClient as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@01.software/sdk",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "01.software SDK",
   "author": "<office@01.works>",
   "repository": {
@@ -201,7 +201,9 @@
     "node": ">=18.0.0"
   },
   "files": [
-    "dist"
+    "dist",
+    "MIGRATION.md",
+    "CHANGELOG.md"
   ],
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
@@ -231,8 +233,8 @@
     "tsup": "^8.5.1",
     "typescript": "5.7.3",
     "vitest": "^4.1.5",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "dependencies": {
     "qs-esm": "^8.0.1"