@01.software/sdk 0.5.9 → 0.6.0

package/README.md

@@ -134,6 +134,18 @@ const { docs, totalDocs, hasNextPage } = await client.from('products').find({
   select: { title: true, slug: true },
 })
 
+// Query with populate/joins control
+const { docs } = await client.from('products').find({
+  select: { title: true, slug: true, price: true, thumbnail: true },
+  joins: false, // disable joins for lightweight list
+})
+
+// Override relationship populate
+const product = await client.from('products').findById(id, {
+  populate: { brands: { name: true, logo: true } },
+  joins: { variants: { limit: 50 } },
+})
+
 // Single item query - returns document directly
 const product = await client.from('products').findById('id')
 

package/dist/auth.d.cts

@@ -1,4 +1,4 @@
-import './payload-types-D70l0uF9.cjs';
+import './payload-types-DCVm1syH.cjs';
 
 interface JwtPayload {
     clientKey: string;

package/dist/auth.d.ts

@@ -1,4 +1,4 @@
-import './payload-types-D70l0uF9.js';
+import './payload-types-DCVm1syH.js';
 
 interface JwtPayload {
     clientKey: string;

package/dist/{const-EdTT21dc.d.ts → const-Bk3-zigV.d.ts}

@@ -1,4 +1,4 @@
-import { C as Config } from './payload-types-D70l0uF9.js';
+import { C as Config } from './payload-types-DCVm1syH.js';
 
 /**
  * Collection type derived from Payload Config.
@@ -9,7 +9,7 @@ type Collection = keyof Config['collections'];
  * Array of all public collection names for runtime use (e.g., Zod enum validation).
  * This is the single source of truth for which collections are publicly accessible via SDK.
  */
-declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-products", "returns", "return-products", "exchanges", "exchange-products", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-addresses", "customer-groups", "carts", "cart-items", "discounts", "shipping-policies", "documents", "document-categories", "document-types", "posts", "post-authors", "post-categories", "post-tags", "playlists", "playlist-categories", "playlist-tags", "musics", "music-categories", "music-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "flows", "flow-node-types", "flow-edge-types", "flow-categories", "flow-tags", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions"];
+declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-products", "returns", "return-products", "exchanges", "exchange-products", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-addresses", "customer-groups", "carts", "cart-items", "discounts", "shipping-policies", "documents", "document-categories", "document-types", "posts", "post-authors", "post-categories", "post-tags", "playlists", "playlist-categories", "playlist-tags", "musics", "music-categories", "music-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "flows", "flow-node-types", "flow-edge-types", "flow-categories", "flow-tags", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions", "threads", "comments", "reactions", "reaction-types", "bookmarks", "thread-categories", "reports", "community-bans"];
 /**
  * Public collections available for SDK access.
  * Derived from the COLLECTIONS array (single source of truth).

package/dist/{const-rK0y0s2r.d.cts → const-DQZQAXex.d.cts}

@@ -1,4 +1,4 @@
-import { C as Config } from './payload-types-D70l0uF9.cjs';
+import { C as Config } from './payload-types-DCVm1syH.cjs';
 
 /**
  * Collection type derived from Payload Config.
@@ -9,7 +9,7 @@ type Collection = keyof Config['collections'];
  * Array of all public collection names for runtime use (e.g., Zod enum validation).
  * This is the single source of truth for which collections are publicly accessible via SDK.
  */
-declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-products", "returns", "return-products", "exchanges", "exchange-products", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-addresses", "customer-groups", "carts", "cart-items", "discounts", "shipping-policies", "documents", "document-categories", "document-types", "posts", "post-authors", "post-categories", "post-tags", "playlists", "playlist-categories", "playlist-tags", "musics", "music-categories", "music-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "flows", "flow-node-types", "flow-edge-types", "flow-categories", "flow-tags", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions"];
+declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-products", "returns", "return-products", "exchanges", "exchange-products", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-addresses", "customer-groups", "carts", "cart-items", "discounts", "shipping-policies", "documents", "document-categories", "document-types", "posts", "post-authors", "post-categories", "post-tags", "playlists", "playlist-categories", "playlist-tags", "musics", "music-categories", "music-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "flows", "flow-node-types", "flow-edge-types", "flow-categories", "flow-tags", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions", "threads", "comments", "reactions", "reaction-types", "bookmarks", "thread-categories", "reports", "community-bans"];
 /**
  * Public collections available for SDK access.
  * Derived from the COLLECTIONS array (single source of truth).

package/dist/index.cjs

@@ -28,6 +28,7 @@ __export(src_exports, {
   CollectionClient: () => CollectionClient,
   CollectionHooks: () => CollectionHooks,
   CollectionQueryBuilder: () => CollectionQueryBuilder,
+  CommunityClient: () => CommunityClient,
   ConfigError: () => ConfigError,
   CustomerAuth: () => CustomerAuth,
   CustomerHooks: () => CustomerHooks,
@@ -824,7 +825,7 @@ var CollectionQueryBuilder = class {
   async find(options) {
     return this.api.requestFind(
       `/api/${String(this.collection)}`,
-      options
+      { depth: 1, ...options }
     );
   }
   /**
@@ -835,7 +836,7 @@ var CollectionQueryBuilder = class {
   async findById(id, options) {
     return this.api.requestFindById(
       `/api/${String(this.collection)}/${String(id)}`,
-      options
+      { depth: 1, ...options }
     );
   }
   /**
@@ -1265,9 +1266,204 @@ var COLLECTIONS = [
   "live-streams",
   "images",
   "forms",
-  "form-submissions"
+  "form-submissions",
+  // Community
+  "threads",
+  "comments",
+  "reactions",
+  "reaction-types",
+  "bookmarks",
+  "thread-categories",
+  "reports",
+  "community-bans"
 ];
 
+// src/core/community/community-client.ts
+var CommunityClient = class {
+  constructor(options) {
+    if (!options.clientKey) {
+      throw createConfigError("clientKey is required for CommunityClient.");
+    }
+    this.clientKey = options.clientKey;
+    this.secretKey = options.secretKey;
+    this.customerToken = options.customerToken;
+    this.baseUrl = options.baseUrl;
+    this.onUnauthorized = options.onUnauthorized;
+  }
+  async execute(endpoint, method, body) {
+    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
+    const response = await httpFetch(endpoint, {
+      method,
+      clientKey: this.clientKey,
+      secretKey: this.secretKey,
+      customerToken: token ?? void 0,
+      baseUrl: this.baseUrl,
+      ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
+      ...body !== void 0 && { body: JSON.stringify(body) }
+    });
+    return parseApiResponse(response, endpoint);
+  }
+  // Threads
+  createThread(params) {
+    return this.execute("/api/threads", "POST", params);
+  }
+  getMyThreads(params) {
+    const query = params ? `?${new URLSearchParams(
+      Object.fromEntries(
+        Object.entries(params).map(([k, v]) => [k, String(v)])
+      )
+    ).toString()}` : "";
+    return this.execute(
+      `/api/threads/my${query}`,
+      "GET"
+    );
+  }
+  getTrending(params) {
+    const query = params ? `?${new URLSearchParams(
+      Object.fromEntries(
+        Object.entries(params).map(([k, v]) => [k, String(v)])
+      )
+    ).toString()}` : "";
+    return this.execute(
+      `/api/threads/trending${query}`,
+      "GET"
+    );
+  }
+  incrementView(params) {
+    return this.execute(
+      `/api/threads/${params.threadId}/view`,
+      "POST"
+    );
+  }
+  reportThread(params) {
+    const { threadId, ...body } = params;
+    return this.execute(
+      `/api/threads/${threadId}/report`,
+      "POST",
+      body
+    );
+  }
+  // Comments
+  createComment(params) {
+    const { threadId, parentId, content } = params;
+    const body = { thread: threadId, content };
+    if (parentId !== void 0) {
+      body.parent = parentId;
+    }
+    return this.execute("/api/comments", "POST", body);
+  }
+  listComments(params) {
+    const { threadId, page, limit, rootId } = params;
+    const urlParams = new URLSearchParams();
+    urlParams.set("where[thread][equals]", threadId);
+    urlParams.set("sort", "-createdAt");
+    if (limit !== void 0) urlParams.set("limit", String(limit));
+    if (page !== void 0) urlParams.set("page", String(page));
+    if (rootId !== void 0) urlParams.set("where[rootId][equals]", rootId);
+    return this.execute(
+      `/api/comments?${urlParams.toString()}`,
+      "GET"
+    );
+  }
+  updateComment(params) {
+    const { commentId, content } = params;
+    return this.execute(
+      `/api/comments/${commentId}`,
+      "PATCH",
+      { content }
+    );
+  }
+  deleteComment(params) {
+    return this.execute(
+      `/api/comments/${params.commentId}`,
+      "DELETE"
+    );
+  }
+  reportComment(params) {
+    const { commentId, ...body } = params;
+    return this.execute(
+      `/api/comments/${commentId}/report`,
+      "POST",
+      body
+    );
+  }
+  // Reactions
+  addReaction(params) {
+    const { threadId, type } = params;
+    return this.execute("/api/reactions", "POST", {
+      thread: threadId,
+      type
+    });
+  }
+  removeReaction(params) {
+    const { threadId, type } = params;
+    return this.execute(
+      `/api/threads/${threadId}/react?type=${encodeURIComponent(type)}`,
+      "DELETE"
+    );
+  }
+  addCommentReaction(params) {
+    const { commentId, type } = params;
+    return this.execute("/api/reactions", "POST", {
+      comment: commentId,
+      type
+    });
+  }
+  removeCommentReaction(params) {
+    const { commentId, type } = params;
+    return this.execute(
+      `/api/comments/${commentId}/react?type=${encodeURIComponent(type)}`,
+      "DELETE"
+    );
+  }
+  getReactionSummary(params) {
+    return this.execute(
+      `/api/threads/${params.threadId}/reactions`,
+      "GET"
+    );
+  }
+  getReactionTypes() {
+    return this.execute(
+      "/api/reaction-types?limit=100",
+      "GET"
+    );
+  }
+  // Bookmarks
+  addBookmark(params) {
+    return this.execute("/api/bookmarks", "POST", {
+      thread: params.threadId
+    });
+  }
+  removeBookmark(params) {
+    return this.execute(
+      `/api/threads/${params.threadId}/bookmark`,
+      "DELETE"
+    );
+  }
+  getMyBookmarks(params) {
+    const query = params ? `?${new URLSearchParams(
+      Object.fromEntries(
+        Object.entries(params).map(([k, v]) => [k, String(v)])
+      )
+    ).toString()}` : "";
+    return this.execute(
+      `/api/bookmarks/my${query}`,
+      "GET"
+    );
+  }
+  // Moderation
+  banCustomer(params) {
+    return this.execute("/api/community-bans/ban", "POST", params);
+  }
+  unbanCustomer(params) {
+    return this.execute(
+      "/api/community-bans/unban",
+      "DELETE",
+      params
+    );
+  }
+};
+
 // src/core/customer/customer-auth.ts
 var DEFAULT_TIMEOUT2 = 15e3;
 function safeGetItem(key) {
@@ -1977,6 +2173,12 @@ var Client = class {
       baseUrl: this.baseUrl,
       onUnauthorized
     });
+    this.community = new CommunityClient({
+      clientKey: this.config.clientKey,
+      customerToken: () => this.customer.getToken(),
+      baseUrl: this.baseUrl,
+      onUnauthorized
+    });
     this.collections = new CollectionClient(
       this.config.clientKey,
       void 0,
@@ -2035,6 +2237,11 @@ var ServerClient = class {
       secretKey: this.config.secretKey,
       baseUrl: this.baseUrl
     });
+    this.community = new CommunityClient({
+      clientKey: this.config.clientKey,
+      secretKey: this.config.secretKey,
+      baseUrl: this.baseUrl
+    });
     this.product = new ProductApi({
       clientKey: this.config.clientKey,
       secretKey: this.config.secretKey,