@01.software/sdk 0.16.0 → 0.17.0

package/README.md

@@ -79,7 +79,7 @@ const { docs } = await client.collections.from('products').find({
 import { createServerClient } from '@01.software/sdk'
 
 const client = createServerClient({
-  publishableKey: process.env.NEXT_PUBLIC_SOFTWARE_PUBLISHABLE_KEY,
+  publishableKey: process.env.SOFTWARE_PUBLISHABLE_KEY,
   secretKey: process.env.SOFTWARE_SECRET_KEY, // sk01_... opaque API key from Console
 })
 
@@ -113,7 +113,7 @@ const client = createClient({
 const server = createServerClient({
   publishableKey: string,
   secretKey: string,      // sk01_... or pat01_...
-  tenantId: string,       // required when secretKey is pat01_
+  tenantId?: string,      // for PAT workflows, must match the pinned tenant when supplied
 })
 ```
 
@@ -121,6 +121,7 @@ const server = createServerClient({
 | ---------------- | -------- | ---------------------------- |
 | `publishableKey` | `string` | API publishable key          |
 | `secretKey`      | `string` | API secret key (server only) |
+| `tenantId`       | `string` | Optional generally; required when a PAT must disambiguate multi-tenant access. Must match the pinned tenant when supplied. |
 
 API URL은 환경변수로 오버라이드 가능합니다:
 
@@ -464,22 +465,25 @@ const handler = createTypedWebhookHandler('orders', async (event) => {
 
 ## Supported Collections
 
-| Category     | Collections                                                                                                                                     |
-| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| Tenant       | `tenants`, `tenant-metadata`, `tenant-logos`                                                                                                    |
-| Images       | `images` (unified), `brand-logos`                                                                                                               |
-| Products     | `products`, `product-variants`, `product-options`, `product-option-values`, `product-categories`, `product-tags`, `product-collections`, `brands`, `brand-logos` |
-| Orders       | `orders`, `order-items`, `returns`, `return-items`, `fulfillments`, `fulfillment-items`, `transactions`, `order-status-logs` |
-| Customers    | `customers`, `customer-addresses`, `customer-groups`                                                                                            |
-| Carts        | `carts`, `cart-items`                                                                                                                           |
-| Commerce     | `discounts`, `shipping-policies`                                                                                                                |
-| Content      | `posts`, `post-authors`, `post-categories`, `post-tags`, `documents`, `document-categories`, `document-types`                                  |
-| Playlists    | `playlists`, `playlist-categories`, `playlist-tags`, `tracks`, `track-categories`, `track-tags`                                               |
-| Galleries    | `galleries`, `gallery-items`, `gallery-categories`, `gallery-tags`                                                                              |
-| Canvas       | `canvases`, `canvas-node-types`, `canvas-edge-types`, `canvas-categories`, `canvas-tags`                                                        |
-| Videos       | `videos`, `video-categories`, `video-tags`                                                                                                      |
-| Live Streams | `live-streams`                                                                                                                                  |
-| Forms        | `forms`, `form-submissions`                                                                                                                     |
+Source of truth: `packages/sdk/src/core/collection/const.ts` (`COLLECTIONS`: 70).
+
+| Category | Collections |
+| --- | --- |
+| Tenant | `tenants`, `tenant-metadata`, `tenant-logos` |
+| Products | `products`, `product-variants`, `product-options`, `product-option-values`, `product-categories`, `product-tags`, `product-collections`, `brands`, `brand-logos` |
+| Orders | `orders`, `order-items`, `returns`, `return-items`, `fulfillments`, `fulfillment-items`, `transactions` |
+| Customers | `customers`, `customer-profiles`, `customer-addresses`, `customer-groups` |
+| Carts | `carts`, `cart-items` |
+| Commerce | `discounts`, `promotions`, `shipping-policies` |
+| Content | `documents`, `document-categories`, `document-types`, `posts`, `post-authors`, `post-categories`, `post-tags`, `links`, `link-categories`, `link-tags` |
+| Playlists / Tracks | `playlists`, `playlist-categories`, `playlist-tags`, `tracks`, `track-categories`, `track-tags` |
+| Galleries | `galleries`, `gallery-categories`, `gallery-tags`, `gallery-items` |
+| Canvas | `canvases`, `canvas-node-types`, `canvas-edge-types`, `canvas-categories`, `canvas-tags`, `canvas-nodes`, `canvas-edges` |
+| Videos | `videos`, `video-categories`, `video-tags` |
+| Live Streams | `live-streams` |
+| Media | `images` |
+| Forms | `forms`, `form-submissions` |
+| Community | `threads`, `comments`, `reactions`, `reaction-types`, `bookmarks`, `thread-categories`, `reports`, `community-bans` |
 
 ## Utilities
 
@@ -581,6 +585,7 @@ Error classes: `SDKError`, `ApiError`, `NetworkError`, `ValidationError`, `Confi
 
 ```bash
 NEXT_PUBLIC_SOFTWARE_PUBLISHABLE_KEY=your_publishable_key
+SOFTWARE_PUBLISHABLE_KEY=your_publishable_key
 SOFTWARE_SECRET_KEY=sk01_...  # Server only — opaque API key from Console
 ```
 
@@ -597,7 +602,7 @@ New error codes propagated via `SDKError.code` (no breaking change; existing cal
 | Code | Phase | Trigger |
 |---|---|---|
 | `account_suspended` | P1 | Suspended session / `sk01_` / `pat01_` / customer JWT — 401 |
-| `pat_tenant_header_forbidden` | P1 | `pat01_` with `X-Tenant-Id` header — 401 (header rejected) |
+| `pat_tenant_header_forbidden` | P1 | `pat01_` request with a forbidden or mismatched `X-Tenant-Id` header — 401 |
 | `tenant_mismatch` | P3 | Cross-tenant FK rejection (forms / community / orders) |
 | `server_derived` | P3 | Body-driven write into a server-derived state field — 422 |
 | `scope_denied` | P5 | `pat01_` whose `ApiKeys.scopes` lacks the operation |

package/dist/{const-RMD3ZVaS.d.ts → const-D2K5HxpP.d.cts}

@@ -1,4 +1,4 @@
-import { C as Config } from './payload-types-DRvL_bS2.js';
+import { C as Config } from './payload-types-CMoyAOjJ.cjs';
 
 /**
  * Collection type derived from Payload Config.
@@ -14,7 +14,7 @@ declare const INTERNAL_COLLECTIONS: readonly ["users", "payload-kv", "payload-lo
  * 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-option-values", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-items", "returns", "return-items", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-addresses", "customer-groups", "carts", "cart-items", "discounts", "promotions", "shipping-policies", "documents", "document-categories", "document-types", "posts", "post-authors", "post-categories", "post-tags", "playlists", "playlist-categories", "playlist-tags", "tracks", "track-categories", "track-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "canvases", "canvas-node-types", "canvas-edge-types", "canvas-categories", "canvas-tags", "canvas-nodes", "canvas-edges", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions", "threads", "comments", "reactions", "reaction-types", "bookmarks", "thread-categories", "reports", "community-bans"];
+declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-items", "returns", "return-items", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-profiles", "customer-addresses", "customer-groups", "carts", "cart-items", "discounts", "promotions", "shipping-policies", "documents", "document-categories", "document-types", "posts", "post-authors", "post-categories", "post-tags", "playlists", "playlist-categories", "playlist-tags", "tracks", "track-categories", "track-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "canvases", "canvas-node-types", "canvas-edge-types", "canvas-categories", "canvas-tags", "canvas-nodes", "canvas-edges", "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-BLwHrFZ-.d.cts → const-DG8TrouX.d.ts}

@@ -1,4 +1,4 @@
-import { C as Config } from './payload-types-DRvL_bS2.cjs';
+import { C as Config } from './payload-types-CMoyAOjJ.js';
 
 /**
  * Collection type derived from Payload Config.
@@ -14,7 +14,7 @@ declare const INTERNAL_COLLECTIONS: readonly ["users", "payload-kv", "payload-lo
  * 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-option-values", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-items", "returns", "return-items", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-addresses", "customer-groups", "carts", "cart-items", "discounts", "promotions", "shipping-policies", "documents", "document-categories", "document-types", "posts", "post-authors", "post-categories", "post-tags", "playlists", "playlist-categories", "playlist-tags", "tracks", "track-categories", "track-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "canvases", "canvas-node-types", "canvas-edge-types", "canvas-categories", "canvas-tags", "canvas-nodes", "canvas-edges", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions", "threads", "comments", "reactions", "reaction-types", "bookmarks", "thread-categories", "reports", "community-bans"];
+declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-items", "returns", "return-items", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-profiles", "customer-addresses", "customer-groups", "carts", "cart-items", "discounts", "promotions", "shipping-policies", "documents", "document-categories", "document-types", "posts", "post-authors", "post-categories", "post-tags", "playlists", "playlist-categories", "playlist-tags", "tracks", "track-categories", "track-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "canvases", "canvas-node-types", "canvas-edge-types", "canvas-categories", "canvas-tags", "canvas-nodes", "canvas-edges", "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

@@ -1115,6 +1115,7 @@ var COLLECTIONS = [
   "fulfillment-items",
   "transactions",
   "customers",
+  "customer-profiles",
   "customer-addresses",
   "customer-groups",
   "carts",