@01.software/sdk 0.1.8 → 0.2.0

package/dist/index.d.cts

@@ -1,11 +1,13 @@
-import { O as Order, a as OrderProduct, T as Transaction, F as Fulfillment, R as Return, C as CartItem, P as ProductOption } from './payload-types-DcOQUD4x.cjs';
-export { k as ApiUsage, ag as ApiUsageSelect, A as Audience, aa as AudiencesSelect, a$ as Auth, N as Author, aM as AuthorsSelect, m as BillingHistory, ai as BillingHistorySelect, s as Brand, B as BrandLogo, aq as BrandLogosSelect, ap as BrandsSelect, H as Cart, aF as CartItemsSelect, aE as CartsSelect, e as CodeBlock, b as Config, u as Customer, x as CustomerAddress, aB as CustomerAddressesSelect, c as CustomerAuthOperations, v as CustomerGroup, w as CustomerGroupImage, aD as CustomerGroupImagesSelect, aC as CustomerGroupsSelect, aA as CustomersSelect, J as Discount, aG as DiscountsSelect, W as Document, aO as DocumentCategoriesSelect, X as DocumentCategory, Y as DocumentImage, aP as DocumentImagesSelect, aN as DocumentsSelect, E as EmailLog, ab as EmailLogsSelect, z as Exchange, D as ExchangeProduct, aw as ExchangeProductsSelect, av as ExchangesSelect, a2 as Form, a3 as FormSubmission, aW as FormSubmissionsSelect, aV as FormsSelect, G as FulfillmentItem, ay as FulfillmentItemsSelect, ax as FulfillmentsSelect, aT as GalleriesSelect, a0 as Gallery, a1 as GalleryImage, aU as GalleryImagesSelect, I as IframeBlock, M as Media, a9 as MediaSelect, _ as Music, aS as MusicsSelect, as as OrderProductsSelect, ar as OrdersSelect, a4 as PayloadKv, aX as PayloadKvSelect, a5 as PayloadLockedDocument, aY as PayloadLockedDocumentsSelect, a7 as PayloadMigration, a_ as PayloadMigrationsSelect, a6 as PayloadPreference, aZ as PayloadPreferencesSelect, d as PlayerBlock, Z as Playlist, $ as PlaylistImage, aR as PlaylistImagesSelect, aQ as PlaylistsSelect, K as Post, aJ as PostCategoriesSelect, Q as PostCategory, L as PostImage, aL as PostImagesSelect, V as PostTag, aK as PostTagsSelect, aI as PostsSelect, n as Product, am as ProductCategoriesSelect, q as ProductCategory, o as ProductImage, ao as ProductImagesSelect, al as ProductOptionsSelect, r as ProductTag, an as ProductTagsSelect, p as ProductVariant, ak as ProductVariantsSelect, aj as ProductsSelect, y as ReturnProduct, au as ReturnProductsSelect, at as ReturnsSelect, aH as ShippingPoliciesSelect, t as ShippingPolicy, l as Subscription, ah as SubscriptionsSelect, S as SupportedTimezones, g as Tenant, j as TenantLogo, ae as TenantLogosSelect, ad as TenantMetadataSelect, h as TenantMetadatum, i as TenantOgImage, af as TenantOgImagesSelect, ac as TenantsSelect, az as TransactionsSelect, f as User, U as UserAuthOperations, a8 as UsersSelect } from './payload-types-DcOQUD4x.cjs';
-import { F as FetchOptions, A as ApiQueryOptions, P as PayloadFindResponse, a as PayloadMutationResponse, C as ClientBrowserConfig, b as ClientState, c as ClientServerConfig } from './auth-BnCTXZG0.cjs';
-export { t as API_URLS, f as ApiError, y as ApiQueryReactOptions, w as ClientMetadata, g as ConfigError, d as DebugConfig, D as DeepPartial, s as Environment, e as ErrorLogger, E as ExtractArrayType, J as JwtPayload, N as NetworkError, x as PaginationMeta, R as RetryConfig, S as SDKError, T as TimeoutError, U as UsageLimitError, V as ValidationError, q as createApiKey, o as createServerToken, p as decodeServerToken, k as isApiError, l as isConfigError, h as isNetworkError, i as isSDKError, m as isTimeoutError, n as isUsageLimitError, j as isValidationError, r as parseApiKey, u as resolveApiUrl, v as verifyServerToken } from './auth-BnCTXZG0.cjs';
+import { O as Order, a as OrderProduct, T as Transaction, F as Fulfillment, R as Return, C as CartItem, P as ProductOption } from './payload-types-BWJZhklJ.cjs';
+export { k as ApiUsage, af as ApiUsageSelect, A as Audience, a9 as AudiencesSelect, aZ as Auth, Q as Author, aM as AuthorsSelect, m as BillingHistory, ah as BillingHistorySelect, t as Brand, B as BrandLogo, aq as BrandLogosSelect, ap as BrandsSelect, J as Cart, aF as CartItemsSelect, aE as CartsSelect, e as CodeBlock, b as Config, v as Customer, y as CustomerAddress, aB as CustomerAddressesSelect, c as CustomerAuthOperations, w as CustomerGroup, x as CustomerGroupImage, aD as CustomerGroupImagesSelect, aC as CustomerGroupsSelect, aA as CustomersSelect, K as Discount, aG as DiscountsSelect, X as Document, aO as DocumentCategoriesSelect, Y as DocumentCategory, Z as DocumentImage, aP as DocumentImagesSelect, aN as DocumentsSelect, E as EmailLog, aa as EmailLogsSelect, D as Exchange, G as ExchangeProduct, aw as ExchangeProductsSelect, av as ExchangesSelect, a1 as Form, a2 as FormSubmission, aU as FormSubmissionsSelect, aT as FormsSelect, H as FulfillmentItem, ay as FulfillmentItemsSelect, ax as FulfillmentsSelect, I as IframeBlock, M as Media, a8 as MediaSelect, $ as Music, aS as MusicsSelect, as as OrderProductsSelect, ar as OrdersSelect, a3 as PayloadKv, aV as PayloadKvSelect, a4 as PayloadLockedDocument, aW as PayloadLockedDocumentsSelect, a6 as PayloadMigration, aY as PayloadMigrationsSelect, a5 as PayloadPreference, aX as PayloadPreferencesSelect, d as PlayerBlock, _ as Playlist, a0 as PlaylistImage, aR as PlaylistImagesSelect, aQ as PlaylistsSelect, L as Post, aJ as PostCategoriesSelect, V as PostCategory, N as PostImage, aL as PostImagesSelect, W as PostTag, aK as PostTagsSelect, aI as PostsSelect, n as Product, al as ProductCategoriesSelect, q as ProductCategory, s as ProductCollection, ao as ProductCollectionsSelect, o as ProductImage, an as ProductImagesSelect, ak as ProductOptionsSelect, r as ProductTag, am as ProductTagsSelect, p as ProductVariant, aj as ProductVariantsSelect, ai as ProductsSelect, z as ReturnProduct, au as ReturnProductsSelect, at as ReturnsSelect, aH as ShippingPoliciesSelect, u as ShippingPolicy, l as Subscription, ag as SubscriptionsSelect, S as SupportedTimezones, g as Tenant, j as TenantLogo, ad as TenantLogosSelect, ac as TenantMetadataSelect, h as TenantMetadatum, i as TenantOgImage, ae as TenantOgImagesSelect, ab as TenantsSelect, az as TransactionsSelect, f as User, U as UserAuthOperations, a7 as UsersSelect } from './payload-types-BWJZhklJ.cjs';
+import { F as FetchOptions, A as ApiQueryOptions, P as PayloadFindResponse, a as PayloadMutationResponse, C as ClientBrowserConfig, b as ClientState, c as ClientServerConfig } from './auth-BE80zCjC.cjs';
+export { t as API_URLS, f as ApiError, y as ApiQueryReactOptions, w as ClientMetadata, g as ConfigError, d as DebugConfig, D as DeepPartial, s as Environment, e as ErrorLogger, E as ExtractArrayType, J as JwtPayload, N as NetworkError, x as PaginationMeta, R as RetryConfig, S as SDKError, T as TimeoutError, U as UsageLimitError, V as ValidationError, q as createApiKey, o as createServerToken, p as decodeServerToken, k as isApiError, l as isConfigError, h as isNetworkError, i as isSDKError, m as isTimeoutError, n as isUsageLimitError, j as isValidationError, r as parseApiKey, u as resolveApiUrl, v as verifyServerToken } from './auth-BE80zCjC.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { P as PublicCollection, C as CollectionType } from './webhook-E1YlE_k1.cjs';
-export { b as COLLECTIONS, a as Collection, c as WebhookEvent, d as WebhookHandler, W as WebhookOperation, e as WebhookOptions, f as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-E1YlE_k1.cjs';
+import { P as PublicCollection, C as CollectionType } from './webhook-DMxUpnQD.cjs';
+export { b as COLLECTIONS, a as Collection, c as WebhookEvent, d as WebhookHandler, W as WebhookOperation, e as WebhookOptions, f as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-DMxUpnQD.cjs';
+import { Metadata } from 'next';
+import { GenerateMetadataOptions } from './metadata.cjs';
 export { RichTextContent, RichTextContentProps, RichTextData } from './components.cjs';
 import 'payload';
 import 'react';
@@ -251,7 +253,7 @@ declare class CollectionClient extends HttpClient {
  * Read-only subset of CollectionQueryBuilder.
  * BrowserClient.from() returns this type to prevent write operations at compile time.
  */
-type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count'>;
+type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count' | 'findMetadata' | 'findMetadataById'>;
 declare class CollectionQueryBuilder<T extends PublicCollection> {
     private api;
     private collection;
@@ -288,6 +290,18 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
     count(options?: ApiQueryOptions): Promise<{
         totalDocs: number;
     }>;
+    /**
+     * Find first matching document and return its Next.js Metadata.
+     * Applies depth: 1 (image populate) and limit: 1 automatically.
+     * @returns Metadata or null if no document matches
+     */
+    findMetadata(options?: ApiQueryOptions, metadataOptions?: GenerateMetadataOptions): Promise<Metadata | null>;
+    /**
+     * Find document by ID and return its Next.js Metadata.
+     * Applies depth: 1 (image populate) automatically.
+     * @returns Metadata (throws on 404)
+     */
+    findMetadataById(id: number | string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
     /**
      * Update multiple documents (bulk update)
      * PATCH /api/{collection}
@@ -628,6 +642,43 @@ declare function createServerClient(options: ClientServerConfig): ServerClient;
 
 declare function getQueryClient(): QueryClient;
 
+/** Common image data shape from Payload CMS upload collections */
+interface ImageData {
+    url?: string | null;
+    width?: number | null;
+    height?: number | null;
+    alt?: string | null;
+    sizes?: Record<string, {
+        url?: string | null;
+        width?: number | null;
+        height?: number | null;
+    } | undefined>;
+}
+/** Pre-generated image size breakpoints (px) */
+declare const IMAGE_SIZES: readonly [384, 768, 1536];
+/**
+ * Returns the optimal image URL for a given display width.
+ *
+ * Picks the smallest pre-generated size whose width >= displayWidth × dpr.
+ * Falls back to the original URL when no matching size exists.
+ *
+ * @param image - Payload image document
+ * @param displayWidth - CSS pixel width the image will be displayed at
+ * @param dpr - Device pixel ratio (default: 1)
+ * @returns URL string, or empty string if no URL is available
+ */
+declare function getImageUrl(image: ImageData, displayWidth: number, dpr?: number): string;
+/**
+ * Generates an HTML `srcset` attribute string from pre-generated sizes.
+ *
+ * Includes all available sizes plus the original image.
+ * Example output: `"url-384 384w, url-768 768w, url-1536 1536w, url-original 2000w"`
+ *
+ * @param image - Payload image document
+ * @returns srcset string, or empty string if no URLs are available
+ */
+declare function getImageSrcSet(image: ImageData): string;
+
 declare const generateOrderNumber: () => string;
 
 declare const formatOrderName: (options: ProductOption[]) => string;
@@ -645,4 +696,4 @@ declare const resolveRelation: <T>(ref: T | number | null | undefined) => T | nu
 /** @deprecated Use `resolveRelation` instead */
 declare const objectFor: <T>(ref: T | number | null | undefined) => T | null;
 
-export { type AddItemParams, ApiQueryOptions, BrowserClient, BrowserClient as BrowserClientType, CartApi, type CartApiOptions, CartItem, type CheckoutParams, ClientBrowserConfig, ClientServerConfig, ClientState, CollectionClient, type CollectionDetailQueryParams, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, Fulfillment, type GetOrderParams, Order, OrderApi, type OrderApiOptions, OrderProduct, PayloadFindResponse, PayloadMutationResponse, ProductApi, type ProductApiOptions, ProductOption, PublicCollection, QueryHooks, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveItemParams, Return, type ReturnWithRefundParams, ServerClient, ServerClient as ServerClientType, type StockCheckParams, type StockCheckResponse, type StockCheckResult, Transaction, type UpdateItemParams, type UpdateOrderParams, type UpdateReturnParams, type UpdateTransactionParams, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, objectFor, resolveRelation };
+export { type AddItemParams, ApiQueryOptions, BrowserClient, BrowserClient as BrowserClientType, CartApi, type CartApiOptions, CartItem, type CheckoutParams, ClientBrowserConfig, ClientServerConfig, ClientState, CollectionClient, type CollectionDetailQueryParams, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, Fulfillment, type GetOrderParams, IMAGE_SIZES, type ImageData, Order, OrderApi, type OrderApiOptions, OrderProduct, PayloadFindResponse, PayloadMutationResponse, ProductApi, type ProductApiOptions, ProductOption, PublicCollection, QueryHooks, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveItemParams, Return, type ReturnWithRefundParams, ServerClient, ServerClient as ServerClientType, type StockCheckParams, type StockCheckResponse, type StockCheckResult, Transaction, type UpdateItemParams, type UpdateOrderParams, type UpdateReturnParams, type UpdateTransactionParams, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getImageSrcSet, getImageUrl, getQueryClient, objectFor, resolveRelation };

package/dist/index.d.ts

@@ -1,11 +1,13 @@
-import { O as Order, a as OrderProduct, T as Transaction, F as Fulfillment, R as Return, C as CartItem, P as ProductOption } from './payload-types-DcOQUD4x.js';
-export { k as ApiUsage, ag as ApiUsageSelect, A as Audience, aa as AudiencesSelect, a$ as Auth, N as Author, aM as AuthorsSelect, m as BillingHistory, ai as BillingHistorySelect, s as Brand, B as BrandLogo, aq as BrandLogosSelect, ap as BrandsSelect, H as Cart, aF as CartItemsSelect, aE as CartsSelect, e as CodeBlock, b as Config, u as Customer, x as CustomerAddress, aB as CustomerAddressesSelect, c as CustomerAuthOperations, v as CustomerGroup, w as CustomerGroupImage, aD as CustomerGroupImagesSelect, aC as CustomerGroupsSelect, aA as CustomersSelect, J as Discount, aG as DiscountsSelect, W as Document, aO as DocumentCategoriesSelect, X as DocumentCategory, Y as DocumentImage, aP as DocumentImagesSelect, aN as DocumentsSelect, E as EmailLog, ab as EmailLogsSelect, z as Exchange, D as ExchangeProduct, aw as ExchangeProductsSelect, av as ExchangesSelect, a2 as Form, a3 as FormSubmission, aW as FormSubmissionsSelect, aV as FormsSelect, G as FulfillmentItem, ay as FulfillmentItemsSelect, ax as FulfillmentsSelect, aT as GalleriesSelect, a0 as Gallery, a1 as GalleryImage, aU as GalleryImagesSelect, I as IframeBlock, M as Media, a9 as MediaSelect, _ as Music, aS as MusicsSelect, as as OrderProductsSelect, ar as OrdersSelect, a4 as PayloadKv, aX as PayloadKvSelect, a5 as PayloadLockedDocument, aY as PayloadLockedDocumentsSelect, a7 as PayloadMigration, a_ as PayloadMigrationsSelect, a6 as PayloadPreference, aZ as PayloadPreferencesSelect, d as PlayerBlock, Z as Playlist, $ as PlaylistImage, aR as PlaylistImagesSelect, aQ as PlaylistsSelect, K as Post, aJ as PostCategoriesSelect, Q as PostCategory, L as PostImage, aL as PostImagesSelect, V as PostTag, aK as PostTagsSelect, aI as PostsSelect, n as Product, am as ProductCategoriesSelect, q as ProductCategory, o as ProductImage, ao as ProductImagesSelect, al as ProductOptionsSelect, r as ProductTag, an as ProductTagsSelect, p as ProductVariant, ak as ProductVariantsSelect, aj as ProductsSelect, y as ReturnProduct, au as ReturnProductsSelect, at as ReturnsSelect, aH as ShippingPoliciesSelect, t as ShippingPolicy, l as Subscription, ah as SubscriptionsSelect, S as SupportedTimezones, g as Tenant, j as TenantLogo, ae as TenantLogosSelect, ad as TenantMetadataSelect, h as TenantMetadatum, i as TenantOgImage, af as TenantOgImagesSelect, ac as TenantsSelect, az as TransactionsSelect, f as User, U as UserAuthOperations, a8 as UsersSelect } from './payload-types-DcOQUD4x.js';
-import { F as FetchOptions, A as ApiQueryOptions, P as PayloadFindResponse, a as PayloadMutationResponse, C as ClientBrowserConfig, b as ClientState, c as ClientServerConfig } from './auth-Cxfq94pG.js';
-export { t as API_URLS, f as ApiError, y as ApiQueryReactOptions, w as ClientMetadata, g as ConfigError, d as DebugConfig, D as DeepPartial, s as Environment, e as ErrorLogger, E as ExtractArrayType, J as JwtPayload, N as NetworkError, x as PaginationMeta, R as RetryConfig, S as SDKError, T as TimeoutError, U as UsageLimitError, V as ValidationError, q as createApiKey, o as createServerToken, p as decodeServerToken, k as isApiError, l as isConfigError, h as isNetworkError, i as isSDKError, m as isTimeoutError, n as isUsageLimitError, j as isValidationError, r as parseApiKey, u as resolveApiUrl, v as verifyServerToken } from './auth-Cxfq94pG.js';
+import { O as Order, a as OrderProduct, T as Transaction, F as Fulfillment, R as Return, C as CartItem, P as ProductOption } from './payload-types-BWJZhklJ.js';
+export { k as ApiUsage, af as ApiUsageSelect, A as Audience, a9 as AudiencesSelect, aZ as Auth, Q as Author, aM as AuthorsSelect, m as BillingHistory, ah as BillingHistorySelect, t as Brand, B as BrandLogo, aq as BrandLogosSelect, ap as BrandsSelect, J as Cart, aF as CartItemsSelect, aE as CartsSelect, e as CodeBlock, b as Config, v as Customer, y as CustomerAddress, aB as CustomerAddressesSelect, c as CustomerAuthOperations, w as CustomerGroup, x as CustomerGroupImage, aD as CustomerGroupImagesSelect, aC as CustomerGroupsSelect, aA as CustomersSelect, K as Discount, aG as DiscountsSelect, X as Document, aO as DocumentCategoriesSelect, Y as DocumentCategory, Z as DocumentImage, aP as DocumentImagesSelect, aN as DocumentsSelect, E as EmailLog, aa as EmailLogsSelect, D as Exchange, G as ExchangeProduct, aw as ExchangeProductsSelect, av as ExchangesSelect, a1 as Form, a2 as FormSubmission, aU as FormSubmissionsSelect, aT as FormsSelect, H as FulfillmentItem, ay as FulfillmentItemsSelect, ax as FulfillmentsSelect, I as IframeBlock, M as Media, a8 as MediaSelect, $ as Music, aS as MusicsSelect, as as OrderProductsSelect, ar as OrdersSelect, a3 as PayloadKv, aV as PayloadKvSelect, a4 as PayloadLockedDocument, aW as PayloadLockedDocumentsSelect, a6 as PayloadMigration, aY as PayloadMigrationsSelect, a5 as PayloadPreference, aX as PayloadPreferencesSelect, d as PlayerBlock, _ as Playlist, a0 as PlaylistImage, aR as PlaylistImagesSelect, aQ as PlaylistsSelect, L as Post, aJ as PostCategoriesSelect, V as PostCategory, N as PostImage, aL as PostImagesSelect, W as PostTag, aK as PostTagsSelect, aI as PostsSelect, n as Product, al as ProductCategoriesSelect, q as ProductCategory, s as ProductCollection, ao as ProductCollectionsSelect, o as ProductImage, an as ProductImagesSelect, ak as ProductOptionsSelect, r as ProductTag, am as ProductTagsSelect, p as ProductVariant, aj as ProductVariantsSelect, ai as ProductsSelect, z as ReturnProduct, au as ReturnProductsSelect, at as ReturnsSelect, aH as ShippingPoliciesSelect, u as ShippingPolicy, l as Subscription, ag as SubscriptionsSelect, S as SupportedTimezones, g as Tenant, j as TenantLogo, ad as TenantLogosSelect, ac as TenantMetadataSelect, h as TenantMetadatum, i as TenantOgImage, ae as TenantOgImagesSelect, ab as TenantsSelect, az as TransactionsSelect, f as User, U as UserAuthOperations, a7 as UsersSelect } from './payload-types-BWJZhklJ.js';
+import { F as FetchOptions, A as ApiQueryOptions, P as PayloadFindResponse, a as PayloadMutationResponse, C as ClientBrowserConfig, b as ClientState, c as ClientServerConfig } from './auth-BC0CWHt_.js';
+export { t as API_URLS, f as ApiError, y as ApiQueryReactOptions, w as ClientMetadata, g as ConfigError, d as DebugConfig, D as DeepPartial, s as Environment, e as ErrorLogger, E as ExtractArrayType, J as JwtPayload, N as NetworkError, x as PaginationMeta, R as RetryConfig, S as SDKError, T as TimeoutError, U as UsageLimitError, V as ValidationError, q as createApiKey, o as createServerToken, p as decodeServerToken, k as isApiError, l as isConfigError, h as isNetworkError, i as isSDKError, m as isTimeoutError, n as isUsageLimitError, j as isValidationError, r as parseApiKey, u as resolveApiUrl, v as verifyServerToken } from './auth-BC0CWHt_.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { P as PublicCollection, C as CollectionType } from './webhook-xdgxEN8s.js';
-export { b as COLLECTIONS, a as Collection, c as WebhookEvent, d as WebhookHandler, W as WebhookOperation, e as WebhookOptions, f as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-xdgxEN8s.js';
+import { P as PublicCollection, C as CollectionType } from './webhook-CcdyGpCb.js';
+export { b as COLLECTIONS, a as Collection, c as WebhookEvent, d as WebhookHandler, W as WebhookOperation, e as WebhookOptions, f as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-CcdyGpCb.js';
+import { Metadata } from 'next';
+import { GenerateMetadataOptions } from './metadata.js';
 export { RichTextContent, RichTextContentProps, RichTextData } from './components.js';
 import 'payload';
 import 'react';
@@ -251,7 +253,7 @@ declare class CollectionClient extends HttpClient {
  * Read-only subset of CollectionQueryBuilder.
  * BrowserClient.from() returns this type to prevent write operations at compile time.
  */
-type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count'>;
+type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count' | 'findMetadata' | 'findMetadataById'>;
 declare class CollectionQueryBuilder<T extends PublicCollection> {
     private api;
     private collection;
@@ -288,6 +290,18 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
     count(options?: ApiQueryOptions): Promise<{
         totalDocs: number;
     }>;
+    /**
+     * Find first matching document and return its Next.js Metadata.
+     * Applies depth: 1 (image populate) and limit: 1 automatically.
+     * @returns Metadata or null if no document matches
+     */
+    findMetadata(options?: ApiQueryOptions, metadataOptions?: GenerateMetadataOptions): Promise<Metadata | null>;
+    /**
+     * Find document by ID and return its Next.js Metadata.
+     * Applies depth: 1 (image populate) automatically.
+     * @returns Metadata (throws on 404)
+     */
+    findMetadataById(id: number | string, metadataOptions?: GenerateMetadataOptions): Promise<Metadata>;
     /**
      * Update multiple documents (bulk update)
      * PATCH /api/{collection}
@@ -628,6 +642,43 @@ declare function createServerClient(options: ClientServerConfig): ServerClient;
 
 declare function getQueryClient(): QueryClient;
 
+/** Common image data shape from Payload CMS upload collections */
+interface ImageData {
+    url?: string | null;
+    width?: number | null;
+    height?: number | null;
+    alt?: string | null;
+    sizes?: Record<string, {
+        url?: string | null;
+        width?: number | null;
+        height?: number | null;
+    } | undefined>;
+}
+/** Pre-generated image size breakpoints (px) */
+declare const IMAGE_SIZES: readonly [384, 768, 1536];
+/**
+ * Returns the optimal image URL for a given display width.
+ *
+ * Picks the smallest pre-generated size whose width >= displayWidth × dpr.
+ * Falls back to the original URL when no matching size exists.
+ *
+ * @param image - Payload image document
+ * @param displayWidth - CSS pixel width the image will be displayed at
+ * @param dpr - Device pixel ratio (default: 1)
+ * @returns URL string, or empty string if no URL is available
+ */
+declare function getImageUrl(image: ImageData, displayWidth: number, dpr?: number): string;
+/**
+ * Generates an HTML `srcset` attribute string from pre-generated sizes.
+ *
+ * Includes all available sizes plus the original image.
+ * Example output: `"url-384 384w, url-768 768w, url-1536 1536w, url-original 2000w"`
+ *
+ * @param image - Payload image document
+ * @returns srcset string, or empty string if no URLs are available
+ */
+declare function getImageSrcSet(image: ImageData): string;
+
 declare const generateOrderNumber: () => string;
 
 declare const formatOrderName: (options: ProductOption[]) => string;
@@ -645,4 +696,4 @@ declare const resolveRelation: <T>(ref: T | number | null | undefined) => T | nu
 /** @deprecated Use `resolveRelation` instead */
 declare const objectFor: <T>(ref: T | number | null | undefined) => T | null;
 
-export { type AddItemParams, ApiQueryOptions, BrowserClient, BrowserClient as BrowserClientType, CartApi, type CartApiOptions, CartItem, type CheckoutParams, ClientBrowserConfig, ClientServerConfig, ClientState, CollectionClient, type CollectionDetailQueryParams, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, Fulfillment, type GetOrderParams, Order, OrderApi, type OrderApiOptions, OrderProduct, PayloadFindResponse, PayloadMutationResponse, ProductApi, type ProductApiOptions, ProductOption, PublicCollection, QueryHooks, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveItemParams, Return, type ReturnWithRefundParams, ServerClient, ServerClient as ServerClientType, type StockCheckParams, type StockCheckResponse, type StockCheckResult, Transaction, type UpdateItemParams, type UpdateOrderParams, type UpdateReturnParams, type UpdateTransactionParams, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, objectFor, resolveRelation };
+export { type AddItemParams, ApiQueryOptions, BrowserClient, BrowserClient as BrowserClientType, CartApi, type CartApiOptions, CartItem, type CheckoutParams, ClientBrowserConfig, ClientServerConfig, ClientState, CollectionClient, type CollectionDetailQueryParams, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, Fulfillment, type GetOrderParams, IMAGE_SIZES, type ImageData, Order, OrderApi, type OrderApiOptions, OrderProduct, PayloadFindResponse, PayloadMutationResponse, ProductApi, type ProductApiOptions, ProductOption, PublicCollection, QueryHooks, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveItemParams, Return, type ReturnWithRefundParams, ServerClient, ServerClient as ServerClientType, type StockCheckParams, type StockCheckResponse, type StockCheckResult, Transaction, type UpdateItemParams, type UpdateOrderParams, type UpdateReturnParams, type UpdateTransactionParams, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getImageSrcSet, getImageUrl, getQueryClient, objectFor, resolveRelation };

package/dist/index.js

@@ -631,6 +631,37 @@ var ProductApi = class {
   }
 };
 
+// src/utils/types.ts
+var resolveRelation = (ref) => {
+  if (typeof ref === "number" || ref === null || ref === void 0) return null;
+  return ref;
+};
+var objectFor = resolveRelation;
+
+// src/core/metadata/index.ts
+function generateMetadata(doc, options) {
+  var _a, _b, _c, _d;
+  const meta = doc == null ? void 0 : doc.meta;
+  const title = (_b = (_a = meta == null ? void 0 : meta.title) != null ? _a : options == null ? void 0 : options.title) != null ? _b : void 0;
+  const description = (_d = (_c = meta == null ? void 0 : meta.description) != null ? _c : options == null ? void 0 : options.description) != null ? _d : void 0;
+  const image = resolveMetaImage(meta == null ? void 0 : meta.image);
+  return {
+    title,
+    description,
+    openGraph: __spreadValues(__spreadValues(__spreadValues(__spreadValues({}, title && { title }), description && { description }), (options == null ? void 0 : options.siteName) && { siteName: options.siteName }), image && { images: [image] }),
+    twitter: __spreadValues(__spreadValues(__spreadValues({
+      card: image ? "summary_large_image" : "summary"
+    }, title && { title }), description && { description }), image && { images: [image.url] })
+  };
+}
+function resolveMetaImage(ref) {
+  const media = resolveRelation(ref);
+  if (!(media == null ? void 0 : media.url)) return null;
+  return __spreadValues(__spreadValues(__spreadValues({
+    url: media.url
+  }, media.width && { width: media.width }), media.height && { height: media.height }), media.alt && { alt: media.alt });
+}
+
 // src/core/collection/query-builder.ts
 var CollectionQueryBuilder = class {
   constructor(api, collection) {
@@ -702,6 +733,36 @@ var CollectionQueryBuilder = class {
       );
     });
   }
+  /**
+   * Find first matching document and return its Next.js Metadata.
+   * Applies depth: 1 (image populate) and limit: 1 automatically.
+   * @returns Metadata or null if no document matches
+   */
+  findMetadata(options, metadataOptions) {
+    return __async(this, null, function* () {
+      const { docs } = yield this.find(__spreadProps(__spreadValues({}, options), { limit: 1, depth: 1 }));
+      const doc = docs[0];
+      if (!doc) return null;
+      return generateMetadata(
+        doc,
+        metadataOptions
+      );
+    });
+  }
+  /**
+   * Find document by ID and return its Next.js Metadata.
+   * Applies depth: 1 (image populate) automatically.
+   * @returns Metadata (throws on 404)
+   */
+  findMetadataById(id, metadataOptions) {
+    return __async(this, null, function* () {
+      const doc = yield this.findById(id, { depth: 1 });
+      return generateMetadata(
+        doc,
+        metadataOptions
+      );
+    });
+  }
   /**
    * Update multiple documents (bulk update)
    * PATCH /api/{collection}
@@ -977,6 +1038,7 @@ var COLLECTIONS = [
   "product-categories",
   "product-tags",
   "product-images",
+  "product-collections",
   "brands",
   "brand-logos",
   "orders",
@@ -1006,8 +1068,6 @@ var COLLECTIONS = [
   "playlists",
   "playlist-images",
   "musics",
-  "galleries",
-  "gallery-images",
   "forms",
   "form-submissions",
   "media"
@@ -1710,11 +1770,6 @@ function handleWebhook(request, handler, options) {
   return __async(this, null, function* () {
     try {
       const rawBody = yield request.text();
-      if (!(options == null ? void 0 : options.secret)) {
-        console.warn(
-          "[@01.software/sdk] Webhook signature verification is skipped because no secret was provided. Pass { secret } to handleWebhook() to enable signature verification."
-        );
-      }
       if (options == null ? void 0 : options.secret) {
         const signature = request.headers.get("x-webhook-signature") || "";
         const valid = yield verifySignature(rawBody, options.secret, signature);
@@ -1724,6 +1779,10 @@ function handleWebhook(request, handler, options) {
             { status: 401, headers: { "Content-Type": "application/json" } }
           );
         }
+      } else {
+        console.warn(
+          "[@01.software/sdk] Webhook signature verification is disabled. Set { secret } in handleWebhook() options to enable HMAC-SHA256 verification."
+        );
       }
       const body = JSON.parse(rawBody);
       if (!isValidWebhookEvent(body)) {
@@ -1755,6 +1814,39 @@ function createTypedWebhookHandler(collection, handler) {
   });
 }
 
+// src/utils/image.ts
+var IMAGE_SIZES = [384, 768, 1536];
+function getImageUrl(image, displayWidth, dpr = 1) {
+  var _a;
+  const target = displayWidth * dpr;
+  const sizes = image.sizes;
+  if (sizes) {
+    for (const size of IMAGE_SIZES) {
+      if (size >= target) {
+        const entry = sizes[String(size)];
+        if (entry == null ? void 0 : entry.url) return entry.url;
+      }
+    }
+  }
+  return (_a = image.url) != null ? _a : "";
+}
+function getImageSrcSet(image) {
+  const parts = [];
+  const sizes = image.sizes;
+  if (sizes) {
+    for (const size of IMAGE_SIZES) {
+      const entry = sizes[String(size)];
+      if ((entry == null ? void 0 : entry.url) && entry.width) {
+        parts.push(`${entry.url} ${entry.width}w`);
+      }
+    }
+  }
+  if (image.url && image.width) {
+    parts.push(`${image.url} ${image.width}w`);
+  }
+  return parts.join(", ");
+}
+
 // src/utils/order/generateOrderNumber.ts
 var generateOrderNumber = () => {
   var _a;
@@ -1767,13 +1859,6 @@ var generateOrderNumber = () => {
   return `${year}${month}${day}${random}`;
 };
 
-// src/utils/types.ts
-var resolveRelation = (ref) => {
-  if (typeof ref === "number" || ref === null || ref === void 0) return null;
-  return ref;
-};
-var objectFor = resolveRelation;
-
 // src/utils/order/formatOrderName.ts
 var formatOrderName = (options) => {
   var _a, _b;
@@ -1817,6 +1902,7 @@ export {
   CollectionQueryBuilder,
   ConfigError,
   CustomerAuth,
+  IMAGE_SIZES,
   NetworkError,
   OrderApi,
   ProductApi,
@@ -1836,6 +1922,8 @@ export {
   decodeServerToken,
   formatOrderName,
   generateOrderNumber,
+  getImageSrcSet,
+  getImageUrl,
   getQueryClient,
   handleWebhook,
   isApiError,