@01.software/sdk 0.4.3 → 0.5.0

package/README.md

@@ -15,19 +15,19 @@ pnpm add @01.software/sdk
 
 - Full TypeScript type inference
 - Browser and server environment support
-- React Query integration (both BrowserClient and ServerClient)
+- React Query integration (both Client and ServerClient)
 - Mutation hooks (useCreate, useUpdate, useRemove) with automatic cache invalidation
 - Customer auth hooks (useCustomerMe, useCustomerLogin, etc.) with cache management
 - Automatic retry with exponential backoff (non-retryable: 401, 403, 404, 422)
 - Webhook handling with HMAC-SHA256 signature verification
 - Sub-path imports (`./auth`, `./webhook`, `./components`) for tree-shaking
-- Type-safe read-only `from()` for BrowserClient (compile-time write prevention)
+- Type-safe read-only `from()` for Client (compile-time write prevention)
 
 ### Sub-path Imports
 
 ```typescript
 // Main entry - clients, query builder, hooks, utilities
-import { createBrowserClient, createServerClient } from '@01.software/sdk'
+import { createClient, createServerClient } from '@01.software/sdk'
 
 // Auth only - JWT & API Key utilities (smaller bundle)
 import {
@@ -53,12 +53,12 @@ import { VideoPlayer } from '@01.software/sdk/ui/video'
 
 ## Getting Started
 
-### Browser Client
+### Client
 
 ```typescript
-import { createBrowserClient } from '@01.software/sdk'
+import { createClient } from '@01.software/sdk'
 
-const client = createBrowserClient({
+const client = createClient({
   clientKey: process.env.NEXT_PUBLIC_SOFTWARE_CLIENT_KEY,
 })
 
@@ -102,7 +102,7 @@ await client.query.prefetchQuery({
 ### Client Configuration
 
 ```typescript
-const client = createBrowserClient({
+const client = createClient({
   clientKey: string, // Required
 })
 ```
@@ -121,7 +121,7 @@ API URL은 환경변수로 오버라이드 가능합니다:
 
 Access collections via `client.from(collection)` method.
 
-> **Note:** `BrowserClient.from()` returns a `ReadOnlyQueryBuilder` (only `find`, `findById`, `count`, `findMetadata`, `findMetadataById`). Write operations (`create`, `update`, `remove`, `updateMany`, `removeMany`) are only available on `ServerClient.from()`.
+> **Note:** `Client.from()` returns a `ReadOnlyQueryBuilder` (only `find`, `findById`, `count`, `findMetadata`, `findMetadataById`). Write operations (`create`, `update`, `remove`, `updateMany`, `removeMany`) are only available on `ServerClient.from()`.
 
 ```typescript
 // List query - returns PayloadFindResponse
@@ -218,7 +218,7 @@ interface PayloadMutationResponse<T> {
 
 ### React Query Hooks
 
-Read hooks are available on both `BrowserClient` and `ServerClient` via `client.query.*`. Mutation hooks (`useCreate`, `useUpdate`, `useRemove`) are only available on `ServerClient`.
+Read hooks are available on both `Client` and `ServerClient` via `client.query.*`. Mutation hooks (`useCreate`, `useUpdate`, `useRemove`) are only available on `ServerClient`.
 
 ```typescript
 // List query
@@ -273,7 +273,7 @@ client.query.invalidateQueries('products')
 client.query.getQueryData('products', 'list', options)
 client.query.setQueryData('products', 'detail', id, data)
 
-// Customer auth hooks (BrowserClient only)
+// Customer auth hooks (Client only)
 const { data: profile } = client.query.useCustomerMe()
 const { mutate: login } = client.query.useCustomerLogin()
 const { mutate: register } = client.query.useCustomerRegister()
@@ -295,10 +295,10 @@ client.query.setCustomerData(profile)
 
 ### Customer Auth
 
-Available on BrowserClient via `client.customer.*`.
+Available on Client via `client.customer.*`.
 
 ```typescript
-const client = createBrowserClient({
+const client = createClient({
   clientKey: process.env.NEXT_PUBLIC_SOFTWARE_CLIENT_KEY,
   customer: { persist: true },
 })
@@ -370,7 +370,7 @@ const { results, allAvailable } = await client.product.stockCheck({
 
 ### Cart API
 
-Available in both ServerClient and BrowserClient via `client.cart.*`.
+Available in both ServerClient and Client via `client.cart.*`.
 
 ```typescript
 // Add item to cart

package/dist/auth.d.cts

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

package/dist/auth.d.ts

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

package/dist/{const-C3GC2SxR.d.cts → const-BO4SPN7f.d.ts}

@@ -1,4 +1,4 @@
-import { C as Config } from './payload-types-DPka7hJu.cjs';
+import { C as Config } from './payload-types-mZpmjJBz.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", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "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", "flows", "flow-node-types", "flow-edge-types", "flow-categories", "flow-tags", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions"];
 /**
  * Public collections available for SDK access.
  * Derived from the COLLECTIONS array (single source of truth).

package/dist/{const-ikSyKVND.d.ts → const-hqVXNZoy.d.cts}

@@ -1,4 +1,4 @@
-import { C as Config } from './payload-types-DPka7hJu.js';
+import { C as Config } from './payload-types-mZpmjJBz.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", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "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", "flows", "flow-node-types", "flow-edge-types", "flow-categories", "flow-tags", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions"];
 /**
  * Public collections available for SDK access.
  * Derived from the COLLECTIONS array (single source of truth).

package/dist/index.cjs

@@ -72,9 +72,9 @@ var src_exports = {};
 __export(src_exports, {
   ApiError: () => ApiError,
   BaseApi: () => BaseApi,
-  BrowserClient: () => BrowserClient,
   COLLECTIONS: () => COLLECTIONS,
   CartApi: () => CartApi,
+  Client: () => Client,
   CollectionClient: () => CollectionClient,
   CollectionHooks: () => CollectionHooks,
   CollectionQueryBuilder: () => CollectionQueryBuilder,
@@ -96,7 +96,7 @@ __export(src_exports, {
   ValidationError: () => ValidationError,
   collectionKeys: () => collectionKeys,
   createApiKey: () => createApiKey,
-  createBrowserClient: () => createBrowserClient,
+  createClient: () => createClient,
   createServerClient: () => createServerClient,
   createServerToken: () => createServerToken,
   createTypedWebhookHandler: () => createTypedWebhookHandler,
@@ -1341,6 +1341,8 @@ var COLLECTIONS = [
   "playlist-categories",
   "playlist-tags",
   "musics",
+  "music-categories",
+  "music-tags",
   "galleries",
   "gallery-categories",
   "gallery-tags",
@@ -1939,7 +1941,7 @@ var CustomerHooks = class {
   ensureCustomerAuth() {
     if (!this.customerAuth) {
       throw createConfigError(
-        "Customer hooks require BrowserClient. Use createBrowserClient() instead of createServerClient()."
+        "Customer hooks require Client. Use createClient() instead of createServerClient()."
       );
     }
     return this.customerAuth;
@@ -2063,7 +2065,7 @@ var QueryHooks = class extends CollectionHooks {
 };
 
 // src/core/client/client.ts
-var BrowserClient = class {
+var Client = class {
   constructor(options) {
     var _a;
     if (!options.clientKey) {
@@ -2120,8 +2122,8 @@ var BrowserClient = class {
     return __spreadValues({}, this.config);
   }
 };
-function createBrowserClient(options) {
-  return new BrowserClient(options);
+function createClient(options) {
+  return new Client(options);
 }
 
 // src/core/client/client.server.ts
@@ -2129,7 +2131,7 @@ var ServerClient = class {
   constructor(options) {
     if (typeof window !== "undefined") {
       throw createConfigError(
-        "ServerClient must not be used in a browser environment. This risks exposing your secretKey in client bundles. Use createBrowserClient() for browser code instead."
+        "ServerClient must not be used in a browser environment. This risks exposing your secretKey in client bundles. Use createClient() for browser code instead."
       );
     }
     if (!options.clientKey) {