@01.software/sdk 0.5.9 → 0.6.0

package/dist/index.d.cts

@@ -1,13 +1,13 @@
-import { O as Order, a as OrderProduct, T as Transaction, b as Fulfillment, R as Return, E as Exchange, c as Cart, d as CartItem, P as Product } from './payload-types-D70l0uF9.cjs';
-export { o as ApiUsage, ax as ApiUsageSelect, A as Audience, at as AudiencesSelect, by as Auth, q as BillingHistory, az as BillingHistorySelect, y as Brand, B as BrandLogo, aI as BrandLogosSelect, aH as BrandsSelect, aY as CartItemsSelect, aX as CartsSelect, g as CodeBlock, bx as CollectionsWidget, C as Config, G as Customer, J as CustomerAddress, aV as CustomerAddressesSelect, e as CustomerAuthOperations, H as CustomerGroup, aW as CustomerGroupsSelect, aU as CustomersSelect, W as Discount, aZ as DiscountsSelect, $ as Document, b3 as DocumentCategoriesSelect, a1 as DocumentCategory, a0 as DocumentType, b4 as DocumentTypesSelect, b2 as DocumentsSelect, m as EmailLog, au as EmailLogsSelect, N as ExchangeProduct, aS as ExchangeProductsSelect, aR as ExchangesSelect, j as FieldConfig, aq as FieldConfigsSelect, af as Flow, bl as FlowCategoriesSelect, ag as FlowCategory, aj as FlowEdgeType, bk as FlowEdgeTypesSelect, ai as FlowNodeType, bj as FlowNodeTypesSelect, ah as FlowTag, bm as FlowTagsSelect, bi as FlowsSelect, F as Form, ak as FormSubmission, bs as FormSubmissionsSelect, br as FormsSelect, K as FulfillmentItem, aO as FulfillmentItemsSelect, aN as FulfillmentsSelect, bb as GalleriesSelect, a8 as Gallery, bc as GalleryCategoriesSelect, a9 as GalleryCategory, ab as GalleryItem, be as GalleryItemsSelect, aa as GalleryTag, bd as GalleryTagsSelect, I as IframeBlock, k as Image, ar as ImagesSelect, ac as Link, bg as LinkCategoriesSelect, ad as LinkCategory, ae as LinkTag, bh as LinkTagsSelect, bf as LinksSelect, L as LiveStream, bq as LiveStreamsSelect, a5 as Music, b9 as MusicCategoriesSelect, a6 as MusicCategory, a7 as MusicTag, ba as MusicTagsSelect, b8 as MusicsSelect, aK as OrderProductsSelect, Q as OrderStatusLog, aM as OrderStatusLogsSelect, aJ as OrdersSelect, al as PayloadKv, bt as PayloadKvSelect, am as PayloadLockedDocument, bu as PayloadLockedDocumentsSelect, ao as PayloadMigration, bw as PayloadMigrationsSelect, an as PayloadPreference, bv as PayloadPreferencesSelect, f as PlayerBlock, a2 as Playlist, b6 as PlaylistCategoriesSelect, a3 as PlaylistCategory, a4 as PlaylistTag, b7 as PlaylistTagsSelect, b5 as PlaylistsSelect, X as Post, Y as PostAuthor, a$ as PostAuthorsSelect, b0 as PostCategoriesSelect, Z as PostCategory, _ as PostTag, b1 as PostTagsSelect, a_ as PostsSelect, aE as ProductCategoriesSelect, w as ProductCategory, D as ProductCollection, aG as ProductCollectionsSelect, v as ProductOption, aD as ProductOptionsSelect, x as ProductTag, aF as ProductTagsSelect, u as ProductVariant, aC as ProductVariantsSelect, aB as ProductsSelect, M as ReturnProduct, aQ as ReturnProductsSelect, aP as ReturnsSelect, aT as ShippingPoliciesSelect, z as ShippingPolicy, p as Subscription, ay as SubscriptionsSelect, S as SupportedTimezones, l as SystemMedia, as as SystemMediaSelect, i as Tenant, r as TenantLogo, aA as TenantLogosSelect, aw as TenantMetadataSelect, n as TenantMetadatum, av as TenantsSelect, aL as TransactionsSelect, h as User, U as UserAuthOperations, ap as UsersSelect, V as Video, bo as VideoCategoriesSelect, s as VideoCategory, t as VideoTag, bp as VideoTagsSelect, bn as VideosSelect } from './payload-types-D70l0uF9.cjs';
+import { O as Order, a as OrderProduct, T as Transaction, b as Fulfillment, R as Return, E as Exchange, c as Cart, d as CartItem, P as Product } from './payload-types-DCVm1syH.cjs';
+export { o as ApiUsage, aF as ApiUsageSelect, A as Audience, aB as AudiencesSelect, bO as Auth, q as BillingHistory, aH as BillingHistorySelect, ap as Bookmark, bD as BookmarksSelect, y as Brand, B as BrandLogo, aQ as BrandLogosSelect, aP as BrandsSelect, b4 as CartItemsSelect, b3 as CartsSelect, g as CodeBlock, bN as CollectionsWidget, am as Comment, bA as CommentsSelect, ar as CommunityBan, bG as CommunityBansSelect, C as Config, G as Customer, J as CustomerAddress, b1 as CustomerAddressesSelect, e as CustomerAuthOperations, H as CustomerGroup, b2 as CustomerGroupsSelect, b0 as CustomersSelect, W as Discount, b5 as DiscountsSelect, $ as Document, bb as DocumentCategoriesSelect, a1 as DocumentCategory, a0 as DocumentType, bc as DocumentTypesSelect, ba as DocumentsSelect, m as EmailLog, aC as EmailLogsSelect, N as ExchangeProduct, a_ as ExchangeProductsSelect, aZ as ExchangesSelect, j as FieldConfig, ay as FieldConfigsSelect, af as Flow, bt as FlowCategoriesSelect, ag as FlowCategory, aj as FlowEdgeType, bs as FlowEdgeTypesSelect, ai as FlowNodeType, br as FlowNodeTypesSelect, ah as FlowTag, bu as FlowTagsSelect, bq as FlowsSelect, F as Form, as as FormSubmission, bI as FormSubmissionsSelect, bH as FormsSelect, K as FulfillmentItem, aW as FulfillmentItemsSelect, aV as FulfillmentsSelect, bj as GalleriesSelect, a8 as Gallery, bk as GalleryCategoriesSelect, a9 as GalleryCategory, ab as GalleryItem, bm as GalleryItemsSelect, aa as GalleryTag, bl as GalleryTagsSelect, I as IframeBlock, k as Image, az as ImagesSelect, ac as Link, bo as LinkCategoriesSelect, ad as LinkCategory, ae as LinkTag, bp as LinkTagsSelect, bn as LinksSelect, L as LiveStream, by as LiveStreamsSelect, a5 as Music, bh as MusicCategoriesSelect, a6 as MusicCategory, a7 as MusicTag, bi as MusicTagsSelect, bg as MusicsSelect, aS as OrderProductsSelect, Q as OrderStatusLog, aU as OrderStatusLogsSelect, aR as OrdersSelect, at as PayloadKv, bJ as PayloadKvSelect, au as PayloadLockedDocument, bK as PayloadLockedDocumentsSelect, aw as PayloadMigration, bM as PayloadMigrationsSelect, av as PayloadPreference, bL as PayloadPreferencesSelect, f as PlayerBlock, a2 as Playlist, be as PlaylistCategoriesSelect, a3 as PlaylistCategory, a4 as PlaylistTag, bf as PlaylistTagsSelect, bd as PlaylistsSelect, X as Post, Y as PostAuthor, b7 as PostAuthorsSelect, b8 as PostCategoriesSelect, Z as PostCategory, _ as PostTag, b9 as PostTagsSelect, b6 as PostsSelect, aM as ProductCategoriesSelect, w as ProductCategory, D as ProductCollection, aO as ProductCollectionsSelect, v as ProductOption, aL as ProductOptionsSelect, x as ProductTag, aN as ProductTagsSelect, u as ProductVariant, aK as ProductVariantsSelect, aJ as ProductsSelect, an as Reaction, ao as ReactionType, bC as ReactionTypesSelect, bB as ReactionsSelect, aq as Report, bF as ReportsSelect, M as ReturnProduct, aY as ReturnProductsSelect, aX as ReturnsSelect, a$ as ShippingPoliciesSelect, z as ShippingPolicy, p as Subscription, aG as SubscriptionsSelect, S as SupportedTimezones, l as SystemMedia, aA as SystemMediaSelect, i as Tenant, r as TenantLogo, aI as TenantLogosSelect, aE as TenantMetadataSelect, n as TenantMetadatum, aD as TenantsSelect, ak as Thread, bE as ThreadCategoriesSelect, al as ThreadCategory, bz as ThreadsSelect, aT as TransactionsSelect, h as User, U as UserAuthOperations, ax as UsersSelect, V as Video, bw as VideoCategoriesSelect, s as VideoCategory, t as VideoTag, bx as VideoTagsSelect, bv as VideosSelect } from './payload-types-DCVm1syH.cjs';
 import { Sort, Where } from 'payload';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, InfiniteData } from '@tanstack/react-query';
 import { Metadata } from 'next';
-import { P as PublicCollection } from './const-rK0y0s2r.cjs';
-export { a as COLLECTIONS, C as Collection } from './const-rK0y0s2r.cjs';
-import { C as CollectionType } from './webhook-C_aXaaBz.cjs';
-export { a as WebhookEvent, b as WebhookHandler, W as WebhookOperation, c as WebhookOptions, d as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-C_aXaaBz.cjs';
+import { P as PublicCollection } from './const-DQZQAXex.cjs';
+export { a as COLLECTIONS, C as Collection } from './const-DQZQAXex.cjs';
+import { C as CollectionType } from './webhook-TDfT7aKA.cjs';
+export { a as WebhookEvent, b as WebhookHandler, W as WebhookOperation, c as WebhookOptions, d as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-TDfT7aKA.cjs';
 export { a as RealtimeConnection, R as RealtimeEvent, b as RealtimeListener } from './realtime-DupPIYx-.cjs';
 export { b as IMAGE_SIZES, I as ImageData, a as ImagePalette, f as ImagePlaceholderOptions, d as getImageLqip, e as getImagePalette, h as getImagePlaceholderStyle, c as getImageSrcSet, g as getImageUrl } from './image-TT8lTsk5.cjs';
 export { e as VideoGifOptions, V as VideoThumbnailOptions, a as getVideoGif, c as getVideoMp4Url, d as getVideoStoryboard, b as getVideoStreamUrl, g as getVideoThumbnail } from './video-DbLL8yuc.cjs';
@@ -96,6 +96,16 @@ interface ApiQueryOptions {
     where?: Where;
     depth?: number;
     select?: Record<string, boolean>;
+    /** Per-collection field selection for populated relationships (keyed by collection slug) */
+    populate?: Record<string, boolean | Record<string, boolean>>;
+    /** Join field control: pagination/filter per join, or false to disable */
+    joins?: Record<string, {
+        limit?: number;
+        page?: number;
+        sort?: string;
+        where?: Where;
+        count?: boolean;
+    } | false> | false;
 }
 interface DebugConfig {
     logRequests?: boolean;
@@ -466,7 +476,7 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
      * GET /api/{collection}/{id}
      * @returns Document object directly (no wrapper)
      */
-    findById(id: string, options?: ApiQueryOptions): Promise<CollectionType<T>>;
+    findById(id: string | number, options?: ApiQueryOptions): Promise<CollectionType<T>>;
     /**
      * Create a new document
      * POST /api/{collection}
@@ -525,6 +535,193 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
     removeMany(where: ApiQueryOptions['where']): Promise<PayloadFindResponse<CollectionType<T>>>;
 }
 
+interface CommunityClientOptions {
+    clientKey: string;
+    secretKey?: string;
+    customerToken?: string | (() => string | null);
+    baseUrl?: string;
+    onUnauthorized?: () => Promise<string | null>;
+}
+interface Thread {
+    id: string;
+    title: string;
+    content: unknown;
+    categories?: string[];
+    thumbnail?: string;
+    viewCount?: number;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface Comment {
+    id: string;
+    content: string;
+    thread?: string;
+    parent?: string;
+    rootId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface Reaction {
+    id: string;
+    thread?: string;
+    comment?: string;
+    type?: string;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+interface ReactionSummary {
+    counts: Record<string, number>;
+    total: number;
+    userReactions: string[];
+}
+interface Bookmark {
+    id: string;
+    thread?: string;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+interface ReactionType {
+    id: string;
+    title: string;
+    slug: string;
+    emoji?: string;
+    [key: string]: unknown;
+}
+interface CommunityBan {
+    id: string;
+    customer: string;
+    isPermanent?: boolean;
+    bannedUntil?: string;
+    reason?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface PaginatedResponse<T> {
+    docs: T[];
+    totalDocs: number;
+    limit: number;
+    totalPages: number;
+    page: number;
+    pagingCounter: number;
+    hasPrevPage: boolean;
+    hasNextPage: boolean;
+    prevPage: number | null;
+    nextPage: number | null;
+}
+declare class CommunityClient {
+    private readonly clientKey;
+    private readonly secretKey?;
+    private readonly customerToken?;
+    private readonly baseUrl?;
+    private readonly onUnauthorized?;
+    constructor(options: CommunityClientOptions);
+    private execute;
+    createThread(params: {
+        title: string;
+        content: unknown;
+        categories?: string[];
+        thumbnail?: string;
+    }): Promise<Thread>;
+    getMyThreads(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<Thread>>;
+    getTrending(params?: {
+        page?: number;
+        limit?: number;
+        period?: string;
+    }): Promise<PaginatedResponse<Thread>>;
+    incrementView(params: {
+        threadId: string;
+    }): Promise<{
+        viewCount: number;
+    }>;
+    reportThread(params: {
+        threadId: string;
+        reason?: string;
+        reasonDetail?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    createComment(params: {
+        threadId: string;
+        content: string;
+        parentId?: string;
+    }): Promise<Comment>;
+    listComments(params: {
+        threadId: string;
+        page?: number;
+        limit?: number;
+        rootId?: string;
+    }): Promise<PaginatedResponse<Comment>>;
+    updateComment(params: {
+        commentId: string;
+        content: string;
+    }): Promise<Comment>;
+    deleteComment(params: {
+        commentId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    reportComment(params: {
+        commentId: string;
+        reason?: string;
+        reasonDetail?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    addReaction(params: {
+        threadId: string;
+        type: string;
+    }): Promise<Reaction>;
+    removeReaction(params: {
+        threadId: string;
+        type: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    addCommentReaction(params: {
+        commentId: string;
+        type: string;
+    }): Promise<Reaction>;
+    removeCommentReaction(params: {
+        commentId: string;
+        type: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    getReactionSummary(params: {
+        threadId: string;
+    }): Promise<ReactionSummary>;
+    getReactionTypes(): Promise<PaginatedResponse<ReactionType>>;
+    addBookmark(params: {
+        threadId: string;
+    }): Promise<Bookmark>;
+    removeBookmark(params: {
+        threadId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    getMyBookmarks(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<Bookmark>>;
+    banCustomer(params: {
+        customerId: string;
+        isPermanent?: boolean;
+        bannedUntil?: string;
+        reason?: string;
+    }): Promise<CommunityBan>;
+    unbanCustomer(params: {
+        customerId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+}
+
 interface CustomerAuthResponse {
     token: string;
     customer: CustomerProfile;
@@ -908,6 +1105,7 @@ declare class QueryHooks extends CollectionHooks {
 
 declare class Client {
     cart: CartApi;
+    community: CommunityClient;
     query: ReadOnlyQueryHooks;
     collections: CollectionClient;
     queryClient: QueryClient;
@@ -930,6 +1128,7 @@ declare function createClient(options: ClientConfig): Client;
 declare class ServerClient {
     api: OrderApi;
     cart: CartApi;
+    community: CommunityClient;
     product: ProductApi;
     query: QueryHooks;
     collections: CollectionClient;
@@ -968,4 +1167,4 @@ declare const formatOrderName: (items: OrderItem[]) => string;
  */
 declare const resolveRelation: <T>(ref: T | string | number | null | undefined) => T | null;
 
-export { type AddItemParams, ApiError, type ApiQueryOptions, type ApplyDiscountParams, BaseApi, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, Client, type ClientConfig, type ClientMetadata, type ClientServerConfig, type ClientState, Client as ClientType, CollectionClient, type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, ConfigError, type CreateExchangeParams, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, CustomerHooks, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, type CustomerRegisterResponse, type CustomerSnapshot, type DebugConfig, type DeepPartial, Exchange, type ExtractArrayType, Fulfillment, type GenerateMetadataOptions, type GetOrderParams, GoneError, type InfiniteQueryOptions, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, type QueryOptions, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveDiscountParams, type RemoveItemParams, type RequestOptions, type RetryConfig, Return, type ReturnProductItem, type ReturnReason, type ReturnWithRefundParams, SDKError, type ServerApiOptions, ServerClient, ServerClient as ServerClientType, ServiceUnavailableError, type StockCheckParams, type StockCheckResponse, type StockCheckResult, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, TimeoutError, Transaction, type UpdateExchangeParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, collectionKeys, createClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, isApiError, isConfigError, isGoneError, isNetworkError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, resolveApiUrl, resolveRelation };
+export { type AddItemParams, ApiError, type ApiQueryOptions, type ApplyDiscountParams, BaseApi, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, Client, type ClientConfig, type ClientMetadata, type ClientServerConfig, type ClientState, Client as ClientType, CollectionClient, type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, CommunityClient, type CommunityClientOptions, ConfigError, type CreateExchangeParams, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, CustomerHooks, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, type CustomerRegisterResponse, type CustomerSnapshot, type DebugConfig, type DeepPartial, Exchange, type ExtractArrayType, Fulfillment, type GenerateMetadataOptions, type GetOrderParams, GoneError, type InfiniteQueryOptions, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, type QueryOptions, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveDiscountParams, type RemoveItemParams, type RequestOptions, type RetryConfig, Return, type ReturnProductItem, type ReturnReason, type ReturnWithRefundParams, SDKError, type ServerApiOptions, ServerClient, ServerClient as ServerClientType, ServiceUnavailableError, type StockCheckParams, type StockCheckResponse, type StockCheckResult, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, TimeoutError, Transaction, type UpdateExchangeParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, collectionKeys, createClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, isApiError, isConfigError, isGoneError, isNetworkError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, resolveApiUrl, resolveRelation };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { O as Order, a as OrderProduct, T as Transaction, b as Fulfillment, R as Return, E as Exchange, c as Cart, d as CartItem, P as Product } from './payload-types-D70l0uF9.js';
-export { o as ApiUsage, ax as ApiUsageSelect, A as Audience, at as AudiencesSelect, by as Auth, q as BillingHistory, az as BillingHistorySelect, y as Brand, B as BrandLogo, aI as BrandLogosSelect, aH as BrandsSelect, aY as CartItemsSelect, aX as CartsSelect, g as CodeBlock, bx as CollectionsWidget, C as Config, G as Customer, J as CustomerAddress, aV as CustomerAddressesSelect, e as CustomerAuthOperations, H as CustomerGroup, aW as CustomerGroupsSelect, aU as CustomersSelect, W as Discount, aZ as DiscountsSelect, $ as Document, b3 as DocumentCategoriesSelect, a1 as DocumentCategory, a0 as DocumentType, b4 as DocumentTypesSelect, b2 as DocumentsSelect, m as EmailLog, au as EmailLogsSelect, N as ExchangeProduct, aS as ExchangeProductsSelect, aR as ExchangesSelect, j as FieldConfig, aq as FieldConfigsSelect, af as Flow, bl as FlowCategoriesSelect, ag as FlowCategory, aj as FlowEdgeType, bk as FlowEdgeTypesSelect, ai as FlowNodeType, bj as FlowNodeTypesSelect, ah as FlowTag, bm as FlowTagsSelect, bi as FlowsSelect, F as Form, ak as FormSubmission, bs as FormSubmissionsSelect, br as FormsSelect, K as FulfillmentItem, aO as FulfillmentItemsSelect, aN as FulfillmentsSelect, bb as GalleriesSelect, a8 as Gallery, bc as GalleryCategoriesSelect, a9 as GalleryCategory, ab as GalleryItem, be as GalleryItemsSelect, aa as GalleryTag, bd as GalleryTagsSelect, I as IframeBlock, k as Image, ar as ImagesSelect, ac as Link, bg as LinkCategoriesSelect, ad as LinkCategory, ae as LinkTag, bh as LinkTagsSelect, bf as LinksSelect, L as LiveStream, bq as LiveStreamsSelect, a5 as Music, b9 as MusicCategoriesSelect, a6 as MusicCategory, a7 as MusicTag, ba as MusicTagsSelect, b8 as MusicsSelect, aK as OrderProductsSelect, Q as OrderStatusLog, aM as OrderStatusLogsSelect, aJ as OrdersSelect, al as PayloadKv, bt as PayloadKvSelect, am as PayloadLockedDocument, bu as PayloadLockedDocumentsSelect, ao as PayloadMigration, bw as PayloadMigrationsSelect, an as PayloadPreference, bv as PayloadPreferencesSelect, f as PlayerBlock, a2 as Playlist, b6 as PlaylistCategoriesSelect, a3 as PlaylistCategory, a4 as PlaylistTag, b7 as PlaylistTagsSelect, b5 as PlaylistsSelect, X as Post, Y as PostAuthor, a$ as PostAuthorsSelect, b0 as PostCategoriesSelect, Z as PostCategory, _ as PostTag, b1 as PostTagsSelect, a_ as PostsSelect, aE as ProductCategoriesSelect, w as ProductCategory, D as ProductCollection, aG as ProductCollectionsSelect, v as ProductOption, aD as ProductOptionsSelect, x as ProductTag, aF as ProductTagsSelect, u as ProductVariant, aC as ProductVariantsSelect, aB as ProductsSelect, M as ReturnProduct, aQ as ReturnProductsSelect, aP as ReturnsSelect, aT as ShippingPoliciesSelect, z as ShippingPolicy, p as Subscription, ay as SubscriptionsSelect, S as SupportedTimezones, l as SystemMedia, as as SystemMediaSelect, i as Tenant, r as TenantLogo, aA as TenantLogosSelect, aw as TenantMetadataSelect, n as TenantMetadatum, av as TenantsSelect, aL as TransactionsSelect, h as User, U as UserAuthOperations, ap as UsersSelect, V as Video, bo as VideoCategoriesSelect, s as VideoCategory, t as VideoTag, bp as VideoTagsSelect, bn as VideosSelect } from './payload-types-D70l0uF9.js';
+import { O as Order, a as OrderProduct, T as Transaction, b as Fulfillment, R as Return, E as Exchange, c as Cart, d as CartItem, P as Product } from './payload-types-DCVm1syH.js';
+export { o as ApiUsage, aF as ApiUsageSelect, A as Audience, aB as AudiencesSelect, bO as Auth, q as BillingHistory, aH as BillingHistorySelect, ap as Bookmark, bD as BookmarksSelect, y as Brand, B as BrandLogo, aQ as BrandLogosSelect, aP as BrandsSelect, b4 as CartItemsSelect, b3 as CartsSelect, g as CodeBlock, bN as CollectionsWidget, am as Comment, bA as CommentsSelect, ar as CommunityBan, bG as CommunityBansSelect, C as Config, G as Customer, J as CustomerAddress, b1 as CustomerAddressesSelect, e as CustomerAuthOperations, H as CustomerGroup, b2 as CustomerGroupsSelect, b0 as CustomersSelect, W as Discount, b5 as DiscountsSelect, $ as Document, bb as DocumentCategoriesSelect, a1 as DocumentCategory, a0 as DocumentType, bc as DocumentTypesSelect, ba as DocumentsSelect, m as EmailLog, aC as EmailLogsSelect, N as ExchangeProduct, a_ as ExchangeProductsSelect, aZ as ExchangesSelect, j as FieldConfig, ay as FieldConfigsSelect, af as Flow, bt as FlowCategoriesSelect, ag as FlowCategory, aj as FlowEdgeType, bs as FlowEdgeTypesSelect, ai as FlowNodeType, br as FlowNodeTypesSelect, ah as FlowTag, bu as FlowTagsSelect, bq as FlowsSelect, F as Form, as as FormSubmission, bI as FormSubmissionsSelect, bH as FormsSelect, K as FulfillmentItem, aW as FulfillmentItemsSelect, aV as FulfillmentsSelect, bj as GalleriesSelect, a8 as Gallery, bk as GalleryCategoriesSelect, a9 as GalleryCategory, ab as GalleryItem, bm as GalleryItemsSelect, aa as GalleryTag, bl as GalleryTagsSelect, I as IframeBlock, k as Image, az as ImagesSelect, ac as Link, bo as LinkCategoriesSelect, ad as LinkCategory, ae as LinkTag, bp as LinkTagsSelect, bn as LinksSelect, L as LiveStream, by as LiveStreamsSelect, a5 as Music, bh as MusicCategoriesSelect, a6 as MusicCategory, a7 as MusicTag, bi as MusicTagsSelect, bg as MusicsSelect, aS as OrderProductsSelect, Q as OrderStatusLog, aU as OrderStatusLogsSelect, aR as OrdersSelect, at as PayloadKv, bJ as PayloadKvSelect, au as PayloadLockedDocument, bK as PayloadLockedDocumentsSelect, aw as PayloadMigration, bM as PayloadMigrationsSelect, av as PayloadPreference, bL as PayloadPreferencesSelect, f as PlayerBlock, a2 as Playlist, be as PlaylistCategoriesSelect, a3 as PlaylistCategory, a4 as PlaylistTag, bf as PlaylistTagsSelect, bd as PlaylistsSelect, X as Post, Y as PostAuthor, b7 as PostAuthorsSelect, b8 as PostCategoriesSelect, Z as PostCategory, _ as PostTag, b9 as PostTagsSelect, b6 as PostsSelect, aM as ProductCategoriesSelect, w as ProductCategory, D as ProductCollection, aO as ProductCollectionsSelect, v as ProductOption, aL as ProductOptionsSelect, x as ProductTag, aN as ProductTagsSelect, u as ProductVariant, aK as ProductVariantsSelect, aJ as ProductsSelect, an as Reaction, ao as ReactionType, bC as ReactionTypesSelect, bB as ReactionsSelect, aq as Report, bF as ReportsSelect, M as ReturnProduct, aY as ReturnProductsSelect, aX as ReturnsSelect, a$ as ShippingPoliciesSelect, z as ShippingPolicy, p as Subscription, aG as SubscriptionsSelect, S as SupportedTimezones, l as SystemMedia, aA as SystemMediaSelect, i as Tenant, r as TenantLogo, aI as TenantLogosSelect, aE as TenantMetadataSelect, n as TenantMetadatum, aD as TenantsSelect, ak as Thread, bE as ThreadCategoriesSelect, al as ThreadCategory, bz as ThreadsSelect, aT as TransactionsSelect, h as User, U as UserAuthOperations, ax as UsersSelect, V as Video, bw as VideoCategoriesSelect, s as VideoCategory, t as VideoTag, bx as VideoTagsSelect, bv as VideosSelect } from './payload-types-DCVm1syH.js';
 import { Sort, Where } from 'payload';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, InfiniteData } from '@tanstack/react-query';
 import { Metadata } from 'next';
-import { P as PublicCollection } from './const-EdTT21dc.js';
-export { a as COLLECTIONS, C as Collection } from './const-EdTT21dc.js';
-import { C as CollectionType } from './webhook-BVU0Qfsu.js';
-export { a as WebhookEvent, b as WebhookHandler, W as WebhookOperation, c as WebhookOptions, d as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-BVU0Qfsu.js';
+import { P as PublicCollection } from './const-Bk3-zigV.js';
+export { a as COLLECTIONS, C as Collection } from './const-Bk3-zigV.js';
+import { C as CollectionType } from './webhook-BTtG_8f2.js';
+export { a as WebhookEvent, b as WebhookHandler, W as WebhookOperation, c as WebhookOptions, d as createTypedWebhookHandler, h as handleWebhook, i as isValidWebhookEvent } from './webhook-BTtG_8f2.js';
 export { a as RealtimeConnection, R as RealtimeEvent, b as RealtimeListener } from './realtime-DupPIYx-.js';
 export { b as IMAGE_SIZES, I as ImageData, a as ImagePalette, f as ImagePlaceholderOptions, d as getImageLqip, e as getImagePalette, h as getImagePlaceholderStyle, c as getImageSrcSet, g as getImageUrl } from './image-TT8lTsk5.js';
 export { e as VideoGifOptions, V as VideoThumbnailOptions, a as getVideoGif, c as getVideoMp4Url, d as getVideoStoryboard, b as getVideoStreamUrl, g as getVideoThumbnail } from './video-DbLL8yuc.js';
@@ -96,6 +96,16 @@ interface ApiQueryOptions {
     where?: Where;
     depth?: number;
     select?: Record<string, boolean>;
+    /** Per-collection field selection for populated relationships (keyed by collection slug) */
+    populate?: Record<string, boolean | Record<string, boolean>>;
+    /** Join field control: pagination/filter per join, or false to disable */
+    joins?: Record<string, {
+        limit?: number;
+        page?: number;
+        sort?: string;
+        where?: Where;
+        count?: boolean;
+    } | false> | false;
 }
 interface DebugConfig {
     logRequests?: boolean;
@@ -466,7 +476,7 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
      * GET /api/{collection}/{id}
      * @returns Document object directly (no wrapper)
      */
-    findById(id: string, options?: ApiQueryOptions): Promise<CollectionType<T>>;
+    findById(id: string | number, options?: ApiQueryOptions): Promise<CollectionType<T>>;
     /**
      * Create a new document
      * POST /api/{collection}
@@ -525,6 +535,193 @@ declare class CollectionQueryBuilder<T extends PublicCollection> {
     removeMany(where: ApiQueryOptions['where']): Promise<PayloadFindResponse<CollectionType<T>>>;
 }
 
+interface CommunityClientOptions {
+    clientKey: string;
+    secretKey?: string;
+    customerToken?: string | (() => string | null);
+    baseUrl?: string;
+    onUnauthorized?: () => Promise<string | null>;
+}
+interface Thread {
+    id: string;
+    title: string;
+    content: unknown;
+    categories?: string[];
+    thumbnail?: string;
+    viewCount?: number;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface Comment {
+    id: string;
+    content: string;
+    thread?: string;
+    parent?: string;
+    rootId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface Reaction {
+    id: string;
+    thread?: string;
+    comment?: string;
+    type?: string;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+interface ReactionSummary {
+    counts: Record<string, number>;
+    total: number;
+    userReactions: string[];
+}
+interface Bookmark {
+    id: string;
+    thread?: string;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+interface ReactionType {
+    id: string;
+    title: string;
+    slug: string;
+    emoji?: string;
+    [key: string]: unknown;
+}
+interface CommunityBan {
+    id: string;
+    customer: string;
+    isPermanent?: boolean;
+    bannedUntil?: string;
+    reason?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface PaginatedResponse<T> {
+    docs: T[];
+    totalDocs: number;
+    limit: number;
+    totalPages: number;
+    page: number;
+    pagingCounter: number;
+    hasPrevPage: boolean;
+    hasNextPage: boolean;
+    prevPage: number | null;
+    nextPage: number | null;
+}
+declare class CommunityClient {
+    private readonly clientKey;
+    private readonly secretKey?;
+    private readonly customerToken?;
+    private readonly baseUrl?;
+    private readonly onUnauthorized?;
+    constructor(options: CommunityClientOptions);
+    private execute;
+    createThread(params: {
+        title: string;
+        content: unknown;
+        categories?: string[];
+        thumbnail?: string;
+    }): Promise<Thread>;
+    getMyThreads(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<Thread>>;
+    getTrending(params?: {
+        page?: number;
+        limit?: number;
+        period?: string;
+    }): Promise<PaginatedResponse<Thread>>;
+    incrementView(params: {
+        threadId: string;
+    }): Promise<{
+        viewCount: number;
+    }>;
+    reportThread(params: {
+        threadId: string;
+        reason?: string;
+        reasonDetail?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    createComment(params: {
+        threadId: string;
+        content: string;
+        parentId?: string;
+    }): Promise<Comment>;
+    listComments(params: {
+        threadId: string;
+        page?: number;
+        limit?: number;
+        rootId?: string;
+    }): Promise<PaginatedResponse<Comment>>;
+    updateComment(params: {
+        commentId: string;
+        content: string;
+    }): Promise<Comment>;
+    deleteComment(params: {
+        commentId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    reportComment(params: {
+        commentId: string;
+        reason?: string;
+        reasonDetail?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    addReaction(params: {
+        threadId: string;
+        type: string;
+    }): Promise<Reaction>;
+    removeReaction(params: {
+        threadId: string;
+        type: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    addCommentReaction(params: {
+        commentId: string;
+        type: string;
+    }): Promise<Reaction>;
+    removeCommentReaction(params: {
+        commentId: string;
+        type: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    getReactionSummary(params: {
+        threadId: string;
+    }): Promise<ReactionSummary>;
+    getReactionTypes(): Promise<PaginatedResponse<ReactionType>>;
+    addBookmark(params: {
+        threadId: string;
+    }): Promise<Bookmark>;
+    removeBookmark(params: {
+        threadId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    getMyBookmarks(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<Bookmark>>;
+    banCustomer(params: {
+        customerId: string;
+        isPermanent?: boolean;
+        bannedUntil?: string;
+        reason?: string;
+    }): Promise<CommunityBan>;
+    unbanCustomer(params: {
+        customerId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+}
+
 interface CustomerAuthResponse {
     token: string;
     customer: CustomerProfile;
@@ -908,6 +1105,7 @@ declare class QueryHooks extends CollectionHooks {
 
 declare class Client {
     cart: CartApi;
+    community: CommunityClient;
     query: ReadOnlyQueryHooks;
     collections: CollectionClient;
     queryClient: QueryClient;
@@ -930,6 +1128,7 @@ declare function createClient(options: ClientConfig): Client;
 declare class ServerClient {
     api: OrderApi;
     cart: CartApi;
+    community: CommunityClient;
     product: ProductApi;
     query: QueryHooks;
     collections: CollectionClient;
@@ -968,4 +1167,4 @@ declare const formatOrderName: (items: OrderItem[]) => string;
  */
 declare const resolveRelation: <T>(ref: T | string | number | null | undefined) => T | null;
 
-export { type AddItemParams, ApiError, type ApiQueryOptions, type ApplyDiscountParams, BaseApi, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, Client, type ClientConfig, type ClientMetadata, type ClientServerConfig, type ClientState, Client as ClientType, CollectionClient, type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, ConfigError, type CreateExchangeParams, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, CustomerHooks, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, type CustomerRegisterResponse, type CustomerSnapshot, type DebugConfig, type DeepPartial, Exchange, type ExtractArrayType, Fulfillment, type GenerateMetadataOptions, type GetOrderParams, GoneError, type InfiniteQueryOptions, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, type QueryOptions, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveDiscountParams, type RemoveItemParams, type RequestOptions, type RetryConfig, Return, type ReturnProductItem, type ReturnReason, type ReturnWithRefundParams, SDKError, type ServerApiOptions, ServerClient, ServerClient as ServerClientType, ServiceUnavailableError, type StockCheckParams, type StockCheckResponse, type StockCheckResult, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, TimeoutError, Transaction, type UpdateExchangeParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, collectionKeys, createClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, isApiError, isConfigError, isGoneError, isNetworkError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, resolveApiUrl, resolveRelation };
+export { type AddItemParams, ApiError, type ApiQueryOptions, type ApplyDiscountParams, BaseApi, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, Client, type ClientConfig, type ClientMetadata, type ClientServerConfig, type ClientState, Client as ClientType, CollectionClient, type CollectionDetailQueryParams, CollectionHooks, type CollectionInfiniteQueryParams, CollectionQueryBuilder, type CollectionQueryParams, CollectionType, CommunityClient, type CommunityClientOptions, ConfigError, type CreateExchangeParams, type CreateFulfillmentParams, type CreateOrderParams, type CreateReturnParams, CustomerAuth, type CustomerAuthOptions, type CustomerAuthResponse, CustomerHooks, type CustomerLoginData, type CustomerProfile, type CustomerRefreshResponse, type CustomerRegisterData, type CustomerRegisterResponse, type CustomerSnapshot, type DebugConfig, type DeepPartial, Exchange, type ExtractArrayType, Fulfillment, type GenerateMetadataOptions, type GetOrderParams, GoneError, type InfiniteQueryOptions, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, type QueryOptions, type ReadOnlyQueryBuilder, type ReadOnlyQueryHooks, type RemoveDiscountParams, type RemoveItemParams, type RequestOptions, type RetryConfig, Return, type ReturnProductItem, type ReturnReason, type ReturnWithRefundParams, SDKError, type ServerApiOptions, ServerClient, ServerClient as ServerClientType, ServiceUnavailableError, type StockCheckParams, type StockCheckResponse, type StockCheckResult, type SuspenseInfiniteQueryOptions, type SuspenseQueryOptions, TimeoutError, Transaction, type UpdateExchangeParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, collectionKeys, createClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, isApiError, isConfigError, isGoneError, isNetworkError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, resolveApiUrl, resolveRelation };