@01.software/sdk 0.28.0 → 0.29.0

package/dist/{payload-types-BrSYb-sh.d.cts → payload-types-Ci-ZA7aM.d.cts}

@@ -2157,7 +2157,7 @@ interface ProductOptionValue {
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
     generateSlug?: boolean | null;
-    slug?: string | null;
+    slug: string;
     thumbnail?: (string | null) | Image;
     images?: (string | Image)[] | null;
     metadata?: {
@@ -2184,6 +2184,11 @@ interface ProductOption {
      * Option name (e.g. Color, Size)
      */
     title: string;
+    /**
+     * When enabled, the slug will auto-generate from the title field on save and autosave.
+     */
+    generateSlug?: boolean | null;
+    slug: string;
     values?: {
         docs?: (string | ProductOptionValue)[];
         hasNextPage?: boolean;
@@ -3589,7 +3594,6 @@ interface Article {
      * Canonical URL for search engines. Leave empty to use this article URL.
      */
     canonicalUrl?: string | null;
-    visibility?: ('public' | 'members' | 'paid') | null;
     /**
      * Scheduled publish metadata. No automatic publishing job runs from this field.
      */
@@ -6571,6 +6575,8 @@ interface ProductOptionsSelect<T extends boolean = true> {
     tenant?: T;
     product?: T;
     title?: T;
+    generateSlug?: T;
+    slug?: T;
     values?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -7389,7 +7395,6 @@ interface ArticlesSelect<T extends boolean = true> {
     readingMinutes?: T;
     excerpt?: T;
     canonicalUrl?: T;
-    visibility?: T;
     scheduledAt?: T;
     featuredUntil?: T;
     relatedArticles?: T;

package/dist/{payload-types-BrSYb-sh.d.ts → payload-types-Ci-ZA7aM.d.ts}

@@ -2157,7 +2157,7 @@ interface ProductOptionValue {
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
     generateSlug?: boolean | null;
-    slug?: string | null;
+    slug: string;
     thumbnail?: (string | null) | Image;
     images?: (string | Image)[] | null;
     metadata?: {
@@ -2184,6 +2184,11 @@ interface ProductOption {
      * Option name (e.g. Color, Size)
      */
     title: string;
+    /**
+     * When enabled, the slug will auto-generate from the title field on save and autosave.
+     */
+    generateSlug?: boolean | null;
+    slug: string;
     values?: {
         docs?: (string | ProductOptionValue)[];
         hasNextPage?: boolean;
@@ -3589,7 +3594,6 @@ interface Article {
      * Canonical URL for search engines. Leave empty to use this article URL.
      */
     canonicalUrl?: string | null;
-    visibility?: ('public' | 'members' | 'paid') | null;
     /**
      * Scheduled publish metadata. No automatic publishing job runs from this field.
      */
@@ -6571,6 +6575,8 @@ interface ProductOptionsSelect<T extends boolean = true> {
     tenant?: T;
     product?: T;
     title?: T;
+    generateSlug?: T;
+    slug?: T;
     values?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -7389,7 +7395,6 @@ interface ArticlesSelect<T extends boolean = true> {
     readingMinutes?: T;
     excerpt?: T;
     canonicalUrl?: T;
-    visibility?: T;
     scheduledAt?: T;
     featuredUntil?: T;
     relatedArticles?: T;

package/dist/realtime.d.cts

@@ -1,7 +1,7 @@
 import { R as RealtimeEvent } from './realtime-D7HtUpqt.cjs';
 export { a as RealtimeConnection, b as RealtimeListener } from './realtime-D7HtUpqt.cjs';
-import { P as PublicCollection } from './const-Cz9Ki_I7.cjs';
-import './payload-types-BrSYb-sh.cjs';
+import { P as PublicCollection } from './const-Dsixdi6z.cjs';
+import './payload-types-Ci-ZA7aM.cjs';
 
 interface UseRealtimeQueryOptions {
     /** Filter events to specific collections. Empty/undefined = all collections. */

package/dist/realtime.d.ts

@@ -1,7 +1,7 @@
 import { R as RealtimeEvent } from './realtime-D7HtUpqt.js';
 export { a as RealtimeConnection, b as RealtimeListener } from './realtime-D7HtUpqt.js';
-import { P as PublicCollection } from './const-mdQQtIOz.js';
-import './payload-types-BrSYb-sh.js';
+import { P as PublicCollection } from './const-DAjQYNuM.js';
+import './payload-types-Ci-ZA7aM.js';
 
 interface UseRealtimeQueryOptions {
     /** Filter events to specific collections. Empty/undefined = all collections. */

package/dist/{server-D369bCVJ.d.cts → server-C0C8dtms.d.cts}

@@ -1,10 +1,10 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, InfiniteData, UseQueryResult } from '@tanstack/react-query';
-import { O as Order, d as Cart, e as CartItem, f as Product, l as OrderItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-BrSYb-sh.cjs';
+import { O as Order, d as Cart, e as CartItem, f as Product, l as OrderItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-Ci-ZA7aM.cjs';
 import { Sort, Where } from 'payload';
 import { Metadata } from 'next';
-import { C as CollectionType } from './types-CW4PaIL7.cjs';
-import { P as PublicCollection, d as ServerCollection } from './const-Cz9Ki_I7.cjs';
+import { C as CollectionType } from './types-zKjATmDK.cjs';
+import { P as PublicCollection, d as ServerCollection } from './const-Dsixdi6z.cjs';
 
 declare function resolveApiUrl(): string;
 interface ClientConfig {
@@ -889,9 +889,7 @@ type EntityID = string;
 type RelationshipValue = string | number | null | undefined | {
     id?: string | number | null;
 };
-type MediaValue = {
-    id?: EntityID | null;
-} | EntityID | null | undefined;
+type MediaValue = ProductDetailMedia | null | undefined;
 interface ProductOptionValueShape {
     id?: string | number | null;
     option?: RelationshipValue;
@@ -906,6 +904,7 @@ interface ProductOptionValueShape {
 interface ProductOptionShape {
     id?: string | number | null;
     title?: string | null;
+    slug?: string | null;
     _order?: string | null;
     '_product-options_options_order'?: string | null;
     values?: {
@@ -933,6 +932,7 @@ interface ProductListingProductShape {
 type ProductOptionMatrixValue = {
     id: string;
     optionId: string;
+    optionSlug: string;
     label: string;
     slug: string | null;
     swatchColor?: string | null;
@@ -943,6 +943,7 @@ type ProductOptionMatrixValue = {
 type ProductOptionMatrixOption = {
     id: string;
     title: string;
+    slug: string;
     order: string;
     values: ProductOptionMatrixValue[];
 };
@@ -950,14 +951,18 @@ type ProductOptionMatrixVariant<TVariant extends ProductVariantShape = ProductVa
     id: string;
     optionValueIds: string[];
     optionValueByOptionId: Map<string, string>;
+    optionValueByOptionSlug: Map<string, string>;
     source: TVariant;
 };
 type ProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantShape> = {
     options: ProductOptionMatrixOption[];
     optionIds: string[];
+    optionSlugs: string[];
     optionById: Map<string, ProductOptionMatrixOption>;
+    optionBySlug: Map<string, ProductOptionMatrixOption>;
     valueById: Map<string, ProductOptionMatrixValue>;
     valueToOptionId: Map<string, string>;
+    valueToOptionSlug: Map<string, string>;
     variants: ProductOptionMatrixVariant<TVariant>[];
 };
 type ProductListingProjection = {
@@ -984,14 +989,90 @@ type ProductListingGroup<TVariant extends ProductVariantShape = ProductVariantSh
     variants: TVariant[];
     listing: ProductListingProjection;
 };
+type ProductSelectionByOptionValue = string | number | null | undefined | {
+    valueId?: string | number | null;
+    valueSlug?: string | null;
+};
+type ProductSelectionInput = {
+    variantId?: string | number | null;
+    byOptionSlug?: Record<string, ProductSelectionByOptionValue>;
+    byOptionId?: Record<string, ProductSelectionByOptionValue>;
+    valueIds?: Iterable<unknown>;
+    search?: string | URLSearchParams | URL | null;
+};
+type NormalizedProductSelection = {
+    byOptionSlug: Record<string, string>;
+    byOptionId: Record<string, string>;
+    valueIds: string[];
+    variantId: string | null;
+};
+type LegacyProductSelectionParamEvent = {
+    optionId: string;
+    optionSlug: string;
+    valueSlug: string;
+    searchParam: string;
+};
+type ProductSelectionCodecOptions = {
+    onLegacyOptionIdParam?: (event: LegacyProductSelectionParamEvent) => void;
+};
+type ProductSelectionAvailableValue = {
+    valueId: string;
+    value: string;
+    slug: string;
+    selected: boolean;
+    available: boolean;
+    swatchColor?: string | null;
+    thumbnail?: MediaValue;
+    images?: MediaValue[] | null;
+};
+type ProductSelectionResolution = {
+    normalizedSelection: NormalizedProductSelection;
+    selectedVariant: ProductDetailVariant | null;
+    matchingVariants: ProductDetailVariant[];
+    partialVariants: ProductDetailVariant[];
+    availableValuesByOptionSlug: Record<string, ProductSelectionAvailableValue[]>;
+    availableValuesByOptionId: Record<string, ProductSelectionAvailableValue[]>;
+    allOptionsSelected: boolean;
+    price: {
+        min: number | null;
+        max: number | null;
+        compareAtMin: number | null;
+        compareAtMax: number | null;
+        isRange: boolean;
+    };
+    media: {
+        primaryImage: ProductDetailMedia | null;
+        images: ProductDetailMedia[];
+    };
+    stock: {
+        availableForSale: boolean;
+        isUnlimited: boolean;
+        stock: number | null;
+        reservedStock: number | null;
+        availableStock: number | null;
+    };
+};
+declare class ProductSelectionCodecError extends Error {
+    code: string;
+    constructor(message: string);
+}
 declare function buildProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantShape>({ options, variants, }: {
     options: ProductOptionShape[];
     variants?: TVariant[];
 }): ProductOptionMatrix<TVariant>;
+declare function buildProductOptionMatrixFromDetail(detail: ProductDetail): ProductOptionMatrix<ProductDetailVariant>;
 declare function getSelectedValueByOptionId<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): Map<string, string>;
 declare function normalizeSelectedValueIds<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): string[];
 declare function getAvailableOptionValues<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, optionId: string, selectedValueIds: Iterable<unknown>): ProductOptionMatrixValue[];
 declare function resolveVariantForSelection<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): ProductOptionMatrixVariant<TVariant> | undefined;
+declare function normalizeProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
+declare function parseProductSelection(detail: ProductDetail, search: string | URLSearchParams | URL | null | undefined, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
+declare function stringifyProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): string;
+declare function createProductSelectionCodec(detail: ProductDetail, options?: ProductSelectionCodecOptions): {
+    parse: (search: string | URLSearchParams | URL | null | undefined) => NormalizedProductSelection;
+    stringify: (selection?: ProductSelectionInput) => string;
+};
+declare function resolveProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): ProductSelectionResolution;
 declare function buildProductListingProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingProjection;
 /**
  * Builds product-first listing groups for one primary option.
@@ -1044,9 +1125,18 @@ type ProductDetailParams = {
 };
 interface ProductDetailVariantOptionValue {
     optionId: string | number;
+    optionSlug: string;
     valueId: string | number;
+    valueSlug: string;
     value?: string | null;
 }
+type ProductDetailMedia = string | number | {
+    id?: string | number | null;
+    url?: string | null;
+    alt?: string | null;
+    width?: number | null;
+    height?: number | null;
+};
 interface ProductDetailVariant {
     id: string | number;
     optionKey: string;
@@ -1058,19 +1148,23 @@ interface ProductDetailVariant {
     stock: number;
     reservedStock: number;
     isUnlimited: boolean;
-    thumbnail?: unknown | null;
-    images?: unknown[];
+    isActive: boolean;
+    thumbnail?: ProductDetailMedia | null;
+    images?: ProductDetailMedia[];
     optionValues: ProductDetailVariantOptionValue[];
 }
 interface ProductDetailOptionValue {
     id: string | number;
     value: string;
+    slug: string;
     swatchColor?: string | null;
-    thumbnail?: unknown | null;
+    thumbnail?: ProductDetailMedia | null;
+    images?: ProductDetailMedia[] | null;
 }
 interface ProductDetailOption {
     id: string | number;
     title: string;
+    slug: string;
     values: ProductDetailOptionValue[];
 }
 interface ProductDetailBrand {
@@ -1106,9 +1200,9 @@ interface ProductDetailListing {
     minCompareAtPrice?: number | null;
     maxCompareAtPrice?: number | null;
     isPriceRange?: boolean | null;
-    primaryImage?: unknown | null;
+    primaryImage?: ProductDetailMedia | null;
     availableForSale?: boolean | null;
-    selectionHintVariant?: unknown | null;
+    selectionHintVariant?: string | number | null;
 }
 interface ProductDetail {
     product: {
@@ -1145,11 +1239,17 @@ type ProductUpsertOptionValueInput = {
 type ProductUpsertOptionInput = {
     id?: string;
     title: string;
+    slug?: string;
     values: ProductUpsertOptionValueInput[];
 };
+type ProductUpsertVariantOptionValue = string | {
+    valueSlug?: string;
+    valueId?: string;
+    value?: string;
+};
 type ProductUpsertVariantInput = {
     id?: string;
-    optionValues?: Record<string, string> | string[];
+    optionValues?: Record<string, ProductUpsertVariantOptionValue> | string[];
     sku?: string | null;
     title?: string | null;
     price: number;
@@ -1659,4 +1759,4 @@ declare class ServerClient {
  */
 declare function createServerClient(options: ClientServerConfig): ServerClient;
 
-export { type CustomerAuthResponse as $, type AddItemParams as A, type BanCustomerParams as B, CustomerAuth as C, type ClientMetadata as D, type ClientServerConfig as E, CollectionClient as F, type CollectionDetailQueryParams as G, CollectionHooks as H, type CollectionInfiniteQueryParams as I, CollectionQueryBuilder as J, type CollectionQueryParams as K, type ListingGroupsParams as L, type CommunityBan as M, type CommunityClientOptions as N, type CommunityPost as O, type ProductListingGroupsResponse as P, ConfigError as Q, type RemoveItemParams as R, type StockCheckParams as S, type ConfirmPaymentParams as T, type UpdateItemParams as U, type ValidateDiscountParams as V, type ConfirmPaymentResponse as W, ConflictError as X, type CreateFulfillmentParams as Y, type CreateOrderParams as Z, type CreateReturnParams as _, type CustomerAuthOptions as a, type ServerCommerceClientOptions as a$, CustomerHooks as a0, type CustomerLoginData as a1, type CustomerProfile as a2, type CustomerRefreshResponse as a3, type CustomerRegisterData as a4, type CustomerRegisterResponse as a5, type CustomerSnapshot as a6, type DebugConfig as a7, type DeepPartial as a8, DiscountApi as a9, type ProductListingGroup as aA, type ProductListingGroupSummary as aB, type ProductListingGroupsItem as aC, type ProductListingProductShape as aD, type ProductListingProjection as aE, type ProductOptionMatrix as aF, type ProductOptionMatrixOption as aG, type ProductOptionMatrixValue as aH, type ProductOptionMatrixVariant as aI, type ProductOptionShape as aJ, type ProductOptionValueShape as aK, type ProductVariantShape as aL, QueryHooks as aM, type QueryOptions as aN, RateLimitError as aO, type ReadOnlyQueryBuilder as aP, type RequestOptions as aQ, type RetryConfig as aR, type ReturnItem as aS, type ReturnReason as aT, type ReturnWithRefundParams as aU, SDKError as aV, type ServerApiOptions as aW, ServerClient as aX, ServerCollectionClient as aY, ServerCollectionQueryBuilder as aZ, ServerCommerceClient as a_, type DiscountApiOptions as aa, type ExtractArrayType as ab, type GenerateMetadataOptions as ac, GoneError as ad, type InfiniteQueryOptions as ae, ModerationApi as af, type ModerationApiOptions as ag, NetworkError as ah, NotFoundError as ai, OrderApi as aj, type OrderApiOptions as ak, type PaginationMeta as al, type PayloadMutationResponse as am, PermissionError as an, ProductApi as ao, type ProductApiOptions as ap, type ProductDetailBrand as aq, type ProductDetailCategory as ar, type ProductDetailImage as as, type ProductDetailListing as at, type ProductDetailOption as au, type ProductDetailOptionValue as av, type ProductDetailTag as aw, type ProductDetailVariant as ax, type ProductDetailVariantOptionValue as ay, type ProductDetailVideo as az, type StockCheckResponse as b, ServiceUnavailableError as b0, ShippingApi as b1, type ShippingApiOptions as b2, type StockCheckResult as b3, type SuspenseInfiniteQueryOptions as b4, type SuspenseQueryOptions as b5, TimeoutError as b6, type UnbanCustomerParams as b7, type UpdateFulfillmentParams as b8, type UpdateOrderParams as b9, isServiceUnavailableError as bA, isTimeoutError as bB, isUsageLimitError as bC, isValidationError as bD, normalizeSelectedValueIds as bE, resolveApiUrl as bF, resolveVariantForSelection as bG, type UpdateProfileData as ba, type UpdateReturnParams as bb, type UpdateTransactionParams as bc, UsageLimitError as bd, ValidationError as be, buildProductListingGroupsByOption as bf, buildProductListingProjection as bg, buildProductOptionMatrix as bh, createAuthError as bi, createConflictError as bj, createNotFoundError as bk, createPermissionError as bl, createRateLimitError as bm, createServerClient as bn, getAvailableOptionValues as bo, getSelectedValueByOptionId as bp, isApiError as bq, isAuthError as br, isConfigError as bs, isConflictError as bt, isGoneError as bu, isNetworkError as bv, isNotFoundError as bw, isPermissionError as bx, isRateLimitError as by, isSDKError as bz, type ProductDetailParams as c, type ProductDetail as d, type ApplyDiscountParams as e, type RemoveDiscountParams as f, type ClearCartParams as g, type CheckoutParams as h, type PayloadFindResponse as i, type ValidateDiscountResult as j, type CalculateShippingParams as k, type CalculateShippingResult as l, type ApiQueryOptions as m, type ProductListingGroupsQueryOptions as n, CommunityClient as o, type ReadOnlyQueryHooks as p, ReadOnlyCollectionClient as q, type ClientState as r, type ClientConfig as s, ApiError as t, AuthError as u, BaseApi as v, type BulkImportFulfillmentsParams as w, type BulkImportFulfillmentsResponse as x, CartApi as y, type CartApiOptions as z };
+export { type CustomerAuthResponse as $, type AddItemParams as A, type BanCustomerParams as B, CustomerAuth as C, type ClientMetadata as D, type ClientServerConfig as E, CollectionClient as F, type CollectionDetailQueryParams as G, CollectionHooks as H, type CollectionInfiniteQueryParams as I, CollectionQueryBuilder as J, type CollectionQueryParams as K, type ListingGroupsParams as L, type CommunityBan as M, type CommunityClientOptions as N, type CommunityPost as O, type ProductListingGroupsResponse as P, ConfigError as Q, type RemoveItemParams as R, type StockCheckParams as S, type ConfirmPaymentParams as T, type UpdateItemParams as U, type ValidateDiscountParams as V, type ConfirmPaymentResponse as W, ConflictError as X, type CreateFulfillmentParams as Y, type CreateOrderParams as Z, type CreateReturnParams as _, type CustomerAuthOptions as a, type ReturnItem as a$, CustomerHooks as a0, type CustomerLoginData as a1, type CustomerProfile as a2, type CustomerRefreshResponse as a3, type CustomerRegisterData as a4, type CustomerRegisterResponse as a5, type CustomerSnapshot as a6, type DebugConfig as a7, type DeepPartial as a8, DiscountApi as a9, type ProductDetailVariant as aA, type ProductDetailVariantOptionValue as aB, type ProductDetailVideo as aC, type ProductListingGroup as aD, type ProductListingGroupSummary as aE, type ProductListingGroupsItem as aF, type ProductListingProductShape as aG, type ProductListingProjection as aH, type ProductOptionMatrix as aI, type ProductOptionMatrixOption as aJ, type ProductOptionMatrixValue as aK, type ProductOptionMatrixVariant as aL, type ProductOptionShape as aM, type ProductOptionValueShape as aN, type ProductSelectionAvailableValue as aO, type ProductSelectionByOptionValue as aP, ProductSelectionCodecError as aQ, type ProductSelectionCodecOptions as aR, type ProductSelectionInput as aS, type ProductSelectionResolution as aT, type ProductVariantShape as aU, QueryHooks as aV, type QueryOptions as aW, RateLimitError as aX, type ReadOnlyQueryBuilder as aY, type RequestOptions as aZ, type RetryConfig as a_, type DiscountApiOptions as aa, type ExtractArrayType as ab, type GenerateMetadataOptions as ac, GoneError as ad, type InfiniteQueryOptions as ae, type LegacyProductSelectionParamEvent as af, ModerationApi as ag, type ModerationApiOptions as ah, NetworkError as ai, type NormalizedProductSelection as aj, NotFoundError as ak, OrderApi as al, type OrderApiOptions as am, type PaginationMeta as an, type PayloadMutationResponse as ao, PermissionError as ap, ProductApi as aq, type ProductApiOptions as ar, type ProductDetailBrand as as, type ProductDetailCategory as at, type ProductDetailImage as au, type ProductDetailListing as av, type ProductDetailMedia as aw, type ProductDetailOption as ax, type ProductDetailOptionValue as ay, type ProductDetailTag as az, type StockCheckResponse as b, type ReturnReason as b0, type ReturnWithRefundParams as b1, SDKError as b2, type ServerApiOptions as b3, ServerClient as b4, ServerCollectionClient as b5, ServerCollectionQueryBuilder as b6, ServerCommerceClient as b7, type ServerCommerceClientOptions as b8, ServiceUnavailableError as b9, getSelectedValueByOptionId as bA, isApiError as bB, isAuthError as bC, isConfigError as bD, isConflictError as bE, isGoneError as bF, isNetworkError as bG, isNotFoundError as bH, isPermissionError as bI, isRateLimitError as bJ, isSDKError as bK, isServiceUnavailableError as bL, isTimeoutError as bM, isUsageLimitError as bN, isValidationError as bO, normalizeProductSelection as bP, normalizeSelectedValueIds as bQ, parseProductSelection as bR, resolveApiUrl as bS, resolveProductSelection as bT, resolveVariantForSelection as bU, stringifyProductSelection as bV, ShippingApi as ba, type ShippingApiOptions as bb, type StockCheckResult as bc, type SuspenseInfiniteQueryOptions as bd, type SuspenseQueryOptions as be, TimeoutError as bf, type UnbanCustomerParams as bg, type UpdateFulfillmentParams as bh, type UpdateOrderParams as bi, type UpdateProfileData as bj, type UpdateReturnParams as bk, type UpdateTransactionParams as bl, UsageLimitError as bm, ValidationError as bn, buildProductListingGroupsByOption as bo, buildProductListingProjection as bp, buildProductOptionMatrix as bq, buildProductOptionMatrixFromDetail as br, createAuthError as bs, createConflictError as bt, createNotFoundError as bu, createPermissionError as bv, createProductSelectionCodec as bw, createRateLimitError as bx, createServerClient as by, getAvailableOptionValues as bz, type ProductDetailParams as c, type ProductDetail as d, type ApplyDiscountParams as e, type RemoveDiscountParams as f, type ClearCartParams as g, type CheckoutParams as h, type PayloadFindResponse as i, type ValidateDiscountResult as j, type CalculateShippingParams as k, type CalculateShippingResult as l, type ApiQueryOptions as m, type ProductListingGroupsQueryOptions as n, CommunityClient as o, type ReadOnlyQueryHooks as p, ReadOnlyCollectionClient as q, type ClientState as r, type ClientConfig as s, ApiError as t, AuthError as u, BaseApi as v, type BulkImportFulfillmentsParams as w, type BulkImportFulfillmentsResponse as x, CartApi as y, type CartApiOptions as z };

package/dist/{server-C2Q9R-Lu.d.ts → server-Cv0Q4dPQ.d.ts}

@@ -1,10 +1,10 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, InfiniteData, UseQueryResult } from '@tanstack/react-query';
-import { O as Order, d as Cart, e as CartItem, f as Product, l as OrderItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-BrSYb-sh.js';
+import { O as Order, d as Cart, e as CartItem, f as Product, l as OrderItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-Ci-ZA7aM.js';
 import { Sort, Where } from 'payload';
 import { Metadata } from 'next';
-import { C as CollectionType } from './types-BLUb4cYq.js';
-import { P as PublicCollection, d as ServerCollection } from './const-mdQQtIOz.js';
+import { C as CollectionType } from './types-BWq_WlbB.js';
+import { P as PublicCollection, d as ServerCollection } from './const-DAjQYNuM.js';
 
 declare function resolveApiUrl(): string;
 interface ClientConfig {
@@ -889,9 +889,7 @@ type EntityID = string;
 type RelationshipValue = string | number | null | undefined | {
     id?: string | number | null;
 };
-type MediaValue = {
-    id?: EntityID | null;
-} | EntityID | null | undefined;
+type MediaValue = ProductDetailMedia | null | undefined;
 interface ProductOptionValueShape {
     id?: string | number | null;
     option?: RelationshipValue;
@@ -906,6 +904,7 @@ interface ProductOptionValueShape {
 interface ProductOptionShape {
     id?: string | number | null;
     title?: string | null;
+    slug?: string | null;
     _order?: string | null;
     '_product-options_options_order'?: string | null;
     values?: {
@@ -933,6 +932,7 @@ interface ProductListingProductShape {
 type ProductOptionMatrixValue = {
     id: string;
     optionId: string;
+    optionSlug: string;
     label: string;
     slug: string | null;
     swatchColor?: string | null;
@@ -943,6 +943,7 @@ type ProductOptionMatrixValue = {
 type ProductOptionMatrixOption = {
     id: string;
     title: string;
+    slug: string;
     order: string;
     values: ProductOptionMatrixValue[];
 };
@@ -950,14 +951,18 @@ type ProductOptionMatrixVariant<TVariant extends ProductVariantShape = ProductVa
     id: string;
     optionValueIds: string[];
     optionValueByOptionId: Map<string, string>;
+    optionValueByOptionSlug: Map<string, string>;
     source: TVariant;
 };
 type ProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantShape> = {
     options: ProductOptionMatrixOption[];
     optionIds: string[];
+    optionSlugs: string[];
     optionById: Map<string, ProductOptionMatrixOption>;
+    optionBySlug: Map<string, ProductOptionMatrixOption>;
     valueById: Map<string, ProductOptionMatrixValue>;
     valueToOptionId: Map<string, string>;
+    valueToOptionSlug: Map<string, string>;
     variants: ProductOptionMatrixVariant<TVariant>[];
 };
 type ProductListingProjection = {
@@ -984,14 +989,90 @@ type ProductListingGroup<TVariant extends ProductVariantShape = ProductVariantSh
     variants: TVariant[];
     listing: ProductListingProjection;
 };
+type ProductSelectionByOptionValue = string | number | null | undefined | {
+    valueId?: string | number | null;
+    valueSlug?: string | null;
+};
+type ProductSelectionInput = {
+    variantId?: string | number | null;
+    byOptionSlug?: Record<string, ProductSelectionByOptionValue>;
+    byOptionId?: Record<string, ProductSelectionByOptionValue>;
+    valueIds?: Iterable<unknown>;
+    search?: string | URLSearchParams | URL | null;
+};
+type NormalizedProductSelection = {
+    byOptionSlug: Record<string, string>;
+    byOptionId: Record<string, string>;
+    valueIds: string[];
+    variantId: string | null;
+};
+type LegacyProductSelectionParamEvent = {
+    optionId: string;
+    optionSlug: string;
+    valueSlug: string;
+    searchParam: string;
+};
+type ProductSelectionCodecOptions = {
+    onLegacyOptionIdParam?: (event: LegacyProductSelectionParamEvent) => void;
+};
+type ProductSelectionAvailableValue = {
+    valueId: string;
+    value: string;
+    slug: string;
+    selected: boolean;
+    available: boolean;
+    swatchColor?: string | null;
+    thumbnail?: MediaValue;
+    images?: MediaValue[] | null;
+};
+type ProductSelectionResolution = {
+    normalizedSelection: NormalizedProductSelection;
+    selectedVariant: ProductDetailVariant | null;
+    matchingVariants: ProductDetailVariant[];
+    partialVariants: ProductDetailVariant[];
+    availableValuesByOptionSlug: Record<string, ProductSelectionAvailableValue[]>;
+    availableValuesByOptionId: Record<string, ProductSelectionAvailableValue[]>;
+    allOptionsSelected: boolean;
+    price: {
+        min: number | null;
+        max: number | null;
+        compareAtMin: number | null;
+        compareAtMax: number | null;
+        isRange: boolean;
+    };
+    media: {
+        primaryImage: ProductDetailMedia | null;
+        images: ProductDetailMedia[];
+    };
+    stock: {
+        availableForSale: boolean;
+        isUnlimited: boolean;
+        stock: number | null;
+        reservedStock: number | null;
+        availableStock: number | null;
+    };
+};
+declare class ProductSelectionCodecError extends Error {
+    code: string;
+    constructor(message: string);
+}
 declare function buildProductOptionMatrix<TVariant extends ProductVariantShape = ProductVariantShape>({ options, variants, }: {
     options: ProductOptionShape[];
     variants?: TVariant[];
 }): ProductOptionMatrix<TVariant>;
+declare function buildProductOptionMatrixFromDetail(detail: ProductDetail): ProductOptionMatrix<ProductDetailVariant>;
 declare function getSelectedValueByOptionId<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): Map<string, string>;
 declare function normalizeSelectedValueIds<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): string[];
 declare function getAvailableOptionValues<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, optionId: string, selectedValueIds: Iterable<unknown>): ProductOptionMatrixValue[];
 declare function resolveVariantForSelection<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): ProductOptionMatrixVariant<TVariant> | undefined;
+declare function normalizeProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
+declare function parseProductSelection(detail: ProductDetail, search: string | URLSearchParams | URL | null | undefined, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
+declare function stringifyProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): string;
+declare function createProductSelectionCodec(detail: ProductDetail, options?: ProductSelectionCodecOptions): {
+    parse: (search: string | URLSearchParams | URL | null | undefined) => NormalizedProductSelection;
+    stringify: (selection?: ProductSelectionInput) => string;
+};
+declare function resolveProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): ProductSelectionResolution;
 declare function buildProductListingProjection(product: ProductListingProductShape | null | undefined, variants: ProductVariantShape[]): ProductListingProjection;
 /**
  * Builds product-first listing groups for one primary option.
@@ -1044,9 +1125,18 @@ type ProductDetailParams = {
 };
 interface ProductDetailVariantOptionValue {
     optionId: string | number;
+    optionSlug: string;
     valueId: string | number;
+    valueSlug: string;
     value?: string | null;
 }
+type ProductDetailMedia = string | number | {
+    id?: string | number | null;
+    url?: string | null;
+    alt?: string | null;
+    width?: number | null;
+    height?: number | null;
+};
 interface ProductDetailVariant {
     id: string | number;
     optionKey: string;
@@ -1058,19 +1148,23 @@ interface ProductDetailVariant {
     stock: number;
     reservedStock: number;
     isUnlimited: boolean;
-    thumbnail?: unknown | null;
-    images?: unknown[];
+    isActive: boolean;
+    thumbnail?: ProductDetailMedia | null;
+    images?: ProductDetailMedia[];
     optionValues: ProductDetailVariantOptionValue[];
 }
 interface ProductDetailOptionValue {
     id: string | number;
     value: string;
+    slug: string;
     swatchColor?: string | null;
-    thumbnail?: unknown | null;
+    thumbnail?: ProductDetailMedia | null;
+    images?: ProductDetailMedia[] | null;
 }
 interface ProductDetailOption {
     id: string | number;
     title: string;
+    slug: string;
     values: ProductDetailOptionValue[];
 }
 interface ProductDetailBrand {
@@ -1106,9 +1200,9 @@ interface ProductDetailListing {
     minCompareAtPrice?: number | null;
     maxCompareAtPrice?: number | null;
     isPriceRange?: boolean | null;
-    primaryImage?: unknown | null;
+    primaryImage?: ProductDetailMedia | null;
     availableForSale?: boolean | null;
-    selectionHintVariant?: unknown | null;
+    selectionHintVariant?: string | number | null;
 }
 interface ProductDetail {
     product: {
@@ -1145,11 +1239,17 @@ type ProductUpsertOptionValueInput = {
 type ProductUpsertOptionInput = {
     id?: string;
     title: string;
+    slug?: string;
     values: ProductUpsertOptionValueInput[];
 };
+type ProductUpsertVariantOptionValue = string | {
+    valueSlug?: string;
+    valueId?: string;
+    value?: string;
+};
 type ProductUpsertVariantInput = {
     id?: string;
-    optionValues?: Record<string, string> | string[];
+    optionValues?: Record<string, ProductUpsertVariantOptionValue> | string[];
     sku?: string | null;
     title?: string | null;
     price: number;
@@ -1659,4 +1759,4 @@ declare class ServerClient {
  */
 declare function createServerClient(options: ClientServerConfig): ServerClient;
 
-export { type CustomerAuthResponse as $, type AddItemParams as A, type BanCustomerParams as B, CustomerAuth as C, type ClientMetadata as D, type ClientServerConfig as E, CollectionClient as F, type CollectionDetailQueryParams as G, CollectionHooks as H, type CollectionInfiniteQueryParams as I, CollectionQueryBuilder as J, type CollectionQueryParams as K, type ListingGroupsParams as L, type CommunityBan as M, type CommunityClientOptions as N, type CommunityPost as O, type ProductListingGroupsResponse as P, ConfigError as Q, type RemoveItemParams as R, type StockCheckParams as S, type ConfirmPaymentParams as T, type UpdateItemParams as U, type ValidateDiscountParams as V, type ConfirmPaymentResponse as W, ConflictError as X, type CreateFulfillmentParams as Y, type CreateOrderParams as Z, type CreateReturnParams as _, type CustomerAuthOptions as a, type ServerCommerceClientOptions as a$, CustomerHooks as a0, type CustomerLoginData as a1, type CustomerProfile as a2, type CustomerRefreshResponse as a3, type CustomerRegisterData as a4, type CustomerRegisterResponse as a5, type CustomerSnapshot as a6, type DebugConfig as a7, type DeepPartial as a8, DiscountApi as a9, type ProductListingGroup as aA, type ProductListingGroupSummary as aB, type ProductListingGroupsItem as aC, type ProductListingProductShape as aD, type ProductListingProjection as aE, type ProductOptionMatrix as aF, type ProductOptionMatrixOption as aG, type ProductOptionMatrixValue as aH, type ProductOptionMatrixVariant as aI, type ProductOptionShape as aJ, type ProductOptionValueShape as aK, type ProductVariantShape as aL, QueryHooks as aM, type QueryOptions as aN, RateLimitError as aO, type ReadOnlyQueryBuilder as aP, type RequestOptions as aQ, type RetryConfig as aR, type ReturnItem as aS, type ReturnReason as aT, type ReturnWithRefundParams as aU, SDKError as aV, type ServerApiOptions as aW, ServerClient as aX, ServerCollectionClient as aY, ServerCollectionQueryBuilder as aZ, ServerCommerceClient as a_, type DiscountApiOptions as aa, type ExtractArrayType as ab, type GenerateMetadataOptions as ac, GoneError as ad, type InfiniteQueryOptions as ae, ModerationApi as af, type ModerationApiOptions as ag, NetworkError as ah, NotFoundError as ai, OrderApi as aj, type OrderApiOptions as ak, type PaginationMeta as al, type PayloadMutationResponse as am, PermissionError as an, ProductApi as ao, type ProductApiOptions as ap, type ProductDetailBrand as aq, type ProductDetailCategory as ar, type ProductDetailImage as as, type ProductDetailListing as at, type ProductDetailOption as au, type ProductDetailOptionValue as av, type ProductDetailTag as aw, type ProductDetailVariant as ax, type ProductDetailVariantOptionValue as ay, type ProductDetailVideo as az, type StockCheckResponse as b, ServiceUnavailableError as b0, ShippingApi as b1, type ShippingApiOptions as b2, type StockCheckResult as b3, type SuspenseInfiniteQueryOptions as b4, type SuspenseQueryOptions as b5, TimeoutError as b6, type UnbanCustomerParams as b7, type UpdateFulfillmentParams as b8, type UpdateOrderParams as b9, isServiceUnavailableError as bA, isTimeoutError as bB, isUsageLimitError as bC, isValidationError as bD, normalizeSelectedValueIds as bE, resolveApiUrl as bF, resolveVariantForSelection as bG, type UpdateProfileData as ba, type UpdateReturnParams as bb, type UpdateTransactionParams as bc, UsageLimitError as bd, ValidationError as be, buildProductListingGroupsByOption as bf, buildProductListingProjection as bg, buildProductOptionMatrix as bh, createAuthError as bi, createConflictError as bj, createNotFoundError as bk, createPermissionError as bl, createRateLimitError as bm, createServerClient as bn, getAvailableOptionValues as bo, getSelectedValueByOptionId as bp, isApiError as bq, isAuthError as br, isConfigError as bs, isConflictError as bt, isGoneError as bu, isNetworkError as bv, isNotFoundError as bw, isPermissionError as bx, isRateLimitError as by, isSDKError as bz, type ProductDetailParams as c, type ProductDetail as d, type ApplyDiscountParams as e, type RemoveDiscountParams as f, type ClearCartParams as g, type CheckoutParams as h, type PayloadFindResponse as i, type ValidateDiscountResult as j, type CalculateShippingParams as k, type CalculateShippingResult as l, type ApiQueryOptions as m, type ProductListingGroupsQueryOptions as n, CommunityClient as o, type ReadOnlyQueryHooks as p, ReadOnlyCollectionClient as q, type ClientState as r, type ClientConfig as s, ApiError as t, AuthError as u, BaseApi as v, type BulkImportFulfillmentsParams as w, type BulkImportFulfillmentsResponse as x, CartApi as y, type CartApiOptions as z };
+export { type CustomerAuthResponse as $, type AddItemParams as A, type BanCustomerParams as B, CustomerAuth as C, type ClientMetadata as D, type ClientServerConfig as E, CollectionClient as F, type CollectionDetailQueryParams as G, CollectionHooks as H, type CollectionInfiniteQueryParams as I, CollectionQueryBuilder as J, type CollectionQueryParams as K, type ListingGroupsParams as L, type CommunityBan as M, type CommunityClientOptions as N, type CommunityPost as O, type ProductListingGroupsResponse as P, ConfigError as Q, type RemoveItemParams as R, type StockCheckParams as S, type ConfirmPaymentParams as T, type UpdateItemParams as U, type ValidateDiscountParams as V, type ConfirmPaymentResponse as W, ConflictError as X, type CreateFulfillmentParams as Y, type CreateOrderParams as Z, type CreateReturnParams as _, type CustomerAuthOptions as a, type ReturnItem as a$, CustomerHooks as a0, type CustomerLoginData as a1, type CustomerProfile as a2, type CustomerRefreshResponse as a3, type CustomerRegisterData as a4, type CustomerRegisterResponse as a5, type CustomerSnapshot as a6, type DebugConfig as a7, type DeepPartial as a8, DiscountApi as a9, type ProductDetailVariant as aA, type ProductDetailVariantOptionValue as aB, type ProductDetailVideo as aC, type ProductListingGroup as aD, type ProductListingGroupSummary as aE, type ProductListingGroupsItem as aF, type ProductListingProductShape as aG, type ProductListingProjection as aH, type ProductOptionMatrix as aI, type ProductOptionMatrixOption as aJ, type ProductOptionMatrixValue as aK, type ProductOptionMatrixVariant as aL, type ProductOptionShape as aM, type ProductOptionValueShape as aN, type ProductSelectionAvailableValue as aO, type ProductSelectionByOptionValue as aP, ProductSelectionCodecError as aQ, type ProductSelectionCodecOptions as aR, type ProductSelectionInput as aS, type ProductSelectionResolution as aT, type ProductVariantShape as aU, QueryHooks as aV, type QueryOptions as aW, RateLimitError as aX, type ReadOnlyQueryBuilder as aY, type RequestOptions as aZ, type RetryConfig as a_, type DiscountApiOptions as aa, type ExtractArrayType as ab, type GenerateMetadataOptions as ac, GoneError as ad, type InfiniteQueryOptions as ae, type LegacyProductSelectionParamEvent as af, ModerationApi as ag, type ModerationApiOptions as ah, NetworkError as ai, type NormalizedProductSelection as aj, NotFoundError as ak, OrderApi as al, type OrderApiOptions as am, type PaginationMeta as an, type PayloadMutationResponse as ao, PermissionError as ap, ProductApi as aq, type ProductApiOptions as ar, type ProductDetailBrand as as, type ProductDetailCategory as at, type ProductDetailImage as au, type ProductDetailListing as av, type ProductDetailMedia as aw, type ProductDetailOption as ax, type ProductDetailOptionValue as ay, type ProductDetailTag as az, type StockCheckResponse as b, type ReturnReason as b0, type ReturnWithRefundParams as b1, SDKError as b2, type ServerApiOptions as b3, ServerClient as b4, ServerCollectionClient as b5, ServerCollectionQueryBuilder as b6, ServerCommerceClient as b7, type ServerCommerceClientOptions as b8, ServiceUnavailableError as b9, getSelectedValueByOptionId as bA, isApiError as bB, isAuthError as bC, isConfigError as bD, isConflictError as bE, isGoneError as bF, isNetworkError as bG, isNotFoundError as bH, isPermissionError as bI, isRateLimitError as bJ, isSDKError as bK, isServiceUnavailableError as bL, isTimeoutError as bM, isUsageLimitError as bN, isValidationError as bO, normalizeProductSelection as bP, normalizeSelectedValueIds as bQ, parseProductSelection as bR, resolveApiUrl as bS, resolveProductSelection as bT, resolveVariantForSelection as bU, stringifyProductSelection as bV, ShippingApi as ba, type ShippingApiOptions as bb, type StockCheckResult as bc, type SuspenseInfiniteQueryOptions as bd, type SuspenseQueryOptions as be, TimeoutError as bf, type UnbanCustomerParams as bg, type UpdateFulfillmentParams as bh, type UpdateOrderParams as bi, type UpdateProfileData as bj, type UpdateReturnParams as bk, type UpdateTransactionParams as bl, UsageLimitError as bm, ValidationError as bn, buildProductListingGroupsByOption as bo, buildProductListingProjection as bp, buildProductOptionMatrix as bq, buildProductOptionMatrixFromDetail as br, createAuthError as bs, createConflictError as bt, createNotFoundError as bu, createPermissionError as bv, createProductSelectionCodec as bw, createRateLimitError as bx, createServerClient as by, getAvailableOptionValues as bz, type ProductDetailParams as c, type ProductDetail as d, type ApplyDiscountParams as e, type RemoveDiscountParams as f, type ClearCartParams as g, type CheckoutParams as h, type PayloadFindResponse as i, type ValidateDiscountResult as j, type CalculateShippingParams as k, type CalculateShippingResult as l, type ApiQueryOptions as m, type ProductListingGroupsQueryOptions as n, CommunityClient as o, type ReadOnlyQueryHooks as p, ReadOnlyCollectionClient as q, type ClientState as r, type ClientConfig as s, ApiError as t, AuthError as u, BaseApi as v, type BulkImportFulfillmentsParams as w, type BulkImportFulfillmentsResponse as x, CartApi as y, type CartApiOptions as z };

package/dist/server.cjs

@@ -1395,10 +1395,7 @@ var ProductApi = class extends BaseApi {
    * `product-upsert` tool.
    */
   upsert(params) {
-    return this.request(
-      "/api/products/upsert",
-      params
-    );
+    return this.request("/api/products/upsert", params);
   }
 };