@01.software/sdk 0.4.3-dev.260324.6dc30aa → 0.5.0

package/dist/index.d.cts

@@ -19,11 +19,11 @@ export { JwtPayload, createApiKey, createServerToken, decodeServerToken, parseAp
  * 빌드 시 버전에 따라 기본값 결정: dev 빌드 → api-dev, 정식 → api.01.software
  */
 declare function resolveApiUrl(): string;
-interface ClientBrowserConfig {
+interface ClientConfig {
     clientKey: string;
     /**
      * Customer authentication options.
-     * Used to initialize CustomerAuth on BrowserClient.
+     * Used to initialize CustomerAuth on Client.
      */
     customer?: {
         /**
@@ -42,7 +42,7 @@ interface ClientBrowserConfig {
         onTokenChange?: (token: string | null) => void;
     };
 }
-interface ClientServerConfig extends ClientBrowserConfig {
+interface ClientServerConfig extends ClientConfig {
     secretKey: string;
 }
 interface ClientMetadata {
@@ -451,7 +451,7 @@ declare class CollectionClient extends HttpClient {
 
 /**
  * Read-only subset of CollectionQueryBuilder.
- * BrowserClient.from() returns this type to prevent write operations at compile time.
+ * Client.from() returns this type to prevent write operations at compile time.
  */
 type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count' | 'findMetadata' | 'findMetadataById'>;
 declare class CollectionQueryBuilder<T extends PublicCollection> {
@@ -585,7 +585,7 @@ interface CustomerAuthOptions {
 }
 
 /**
- * Customer authentication client for BrowserClient.
+ * Customer authentication client.
  *
  * Manages customer registration, login, logout, and token lifecycle.
  * All requests include X-Client-Key for tenant resolution.
@@ -894,21 +894,26 @@ declare class QueryHooks extends CollectionHooks {
     setCustomerData: CustomerHooks['setCustomerData'];
 }
 
-declare class BrowserClient {
+declare class Client {
     cart: CartApi;
     query: ReadOnlyQueryHooks;
     collections: CollectionClient;
     queryClient: QueryClient;
     customer: CustomerAuth;
     protected state: ClientState;
-    protected config: ClientBrowserConfig;
+    protected config: ClientConfig;
     protected baseUrl: string;
-    constructor(options: ClientBrowserConfig);
+    constructor(options: ClientConfig);
     from<T extends PublicCollection>(collection: T): ReadOnlyQueryBuilder<T>;
     getState(): ClientState;
-    getConfig(): ClientBrowserConfig;
+    getConfig(): ClientConfig;
 }
-declare function createBrowserClient(options: ClientBrowserConfig): BrowserClient;
+/**
+ * Create an SDK client. Works in both browser and server environments.
+ * Read-only collection queries + customer auth (cart, login, profile).
+ * Use `createServerClient()` when you need full CRUD with secretKey.
+ */
+declare function createClient(options: ClientConfig): Client;
 
 declare class ServerClient {
     api: OrderApi;
@@ -923,8 +928,12 @@ declare class ServerClient {
     constructor(options: ClientServerConfig);
     from<T extends PublicCollection>(collection: T): CollectionQueryBuilder<T>;
     getState(): ClientState;
-    getConfig(): ClientBrowserConfig;
+    getConfig(): ClientConfig;
 }
+/**
+ * Create a server-only client with full read/write access. Requires secretKey.
+ * For read-only usage, prefer `createClient()` (no secretKey needed).
+ */
 declare function createServerClient(options: ClientServerConfig): ServerClient;
 
 declare function getQueryClient(): QueryClient;
@@ -947,4 +956,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 ApiQueryReactOptions, type ApplyDiscountParams, BaseApi, BrowserClient, BrowserClient as BrowserClientType, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, type ClientBrowserConfig, type ClientMetadata, type ClientServerConfig, type ClientState, 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, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, 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, TimeoutError, Transaction, type UpdateExchangeParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, isApiError, isConfigError, isGoneError, isNetworkError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, resolveApiUrl, resolveRelation };
+export { type AddItemParams, ApiError, type ApiQueryOptions, type ApiQueryReactOptions, 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, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, 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, 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

@@ -19,11 +19,11 @@ export { JwtPayload, createApiKey, createServerToken, decodeServerToken, parseAp
  * 빌드 시 버전에 따라 기본값 결정: dev 빌드 → api-dev, 정식 → api.01.software
  */
 declare function resolveApiUrl(): string;
-interface ClientBrowserConfig {
+interface ClientConfig {
     clientKey: string;
     /**
      * Customer authentication options.
-     * Used to initialize CustomerAuth on BrowserClient.
+     * Used to initialize CustomerAuth on Client.
      */
     customer?: {
         /**
@@ -42,7 +42,7 @@ interface ClientBrowserConfig {
         onTokenChange?: (token: string | null) => void;
     };
 }
-interface ClientServerConfig extends ClientBrowserConfig {
+interface ClientServerConfig extends ClientConfig {
     secretKey: string;
 }
 interface ClientMetadata {
@@ -451,7 +451,7 @@ declare class CollectionClient extends HttpClient {
 
 /**
  * Read-only subset of CollectionQueryBuilder.
- * BrowserClient.from() returns this type to prevent write operations at compile time.
+ * Client.from() returns this type to prevent write operations at compile time.
  */
 type ReadOnlyQueryBuilder<T extends PublicCollection> = Pick<CollectionQueryBuilder<T>, 'find' | 'findById' | 'count' | 'findMetadata' | 'findMetadataById'>;
 declare class CollectionQueryBuilder<T extends PublicCollection> {
@@ -585,7 +585,7 @@ interface CustomerAuthOptions {
 }
 
 /**
- * Customer authentication client for BrowserClient.
+ * Customer authentication client.
  *
  * Manages customer registration, login, logout, and token lifecycle.
  * All requests include X-Client-Key for tenant resolution.
@@ -894,21 +894,26 @@ declare class QueryHooks extends CollectionHooks {
     setCustomerData: CustomerHooks['setCustomerData'];
 }
 
-declare class BrowserClient {
+declare class Client {
     cart: CartApi;
     query: ReadOnlyQueryHooks;
     collections: CollectionClient;
     queryClient: QueryClient;
     customer: CustomerAuth;
     protected state: ClientState;
-    protected config: ClientBrowserConfig;
+    protected config: ClientConfig;
     protected baseUrl: string;
-    constructor(options: ClientBrowserConfig);
+    constructor(options: ClientConfig);
     from<T extends PublicCollection>(collection: T): ReadOnlyQueryBuilder<T>;
     getState(): ClientState;
-    getConfig(): ClientBrowserConfig;
+    getConfig(): ClientConfig;
 }
-declare function createBrowserClient(options: ClientBrowserConfig): BrowserClient;
+/**
+ * Create an SDK client. Works in both browser and server environments.
+ * Read-only collection queries + customer auth (cart, login, profile).
+ * Use `createServerClient()` when you need full CRUD with secretKey.
+ */
+declare function createClient(options: ClientConfig): Client;
 
 declare class ServerClient {
     api: OrderApi;
@@ -923,8 +928,12 @@ declare class ServerClient {
     constructor(options: ClientServerConfig);
     from<T extends PublicCollection>(collection: T): CollectionQueryBuilder<T>;
     getState(): ClientState;
-    getConfig(): ClientBrowserConfig;
+    getConfig(): ClientConfig;
 }
+/**
+ * Create a server-only client with full read/write access. Requires secretKey.
+ * For read-only usage, prefer `createClient()` (no secretKey needed).
+ */
 declare function createServerClient(options: ClientServerConfig): ServerClient;
 
 declare function getQueryClient(): QueryClient;
@@ -947,4 +956,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 ApiQueryReactOptions, type ApplyDiscountParams, BaseApi, BrowserClient, BrowserClient as BrowserClientType, type CalculateShippingParams, type CalculateShippingResult, Cart, CartApi, type CartApiOptions, CartItem, type CheckoutParams, type ClearCartParams, type ClientBrowserConfig, type ClientMetadata, type ClientServerConfig, type ClientState, 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, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, 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, TimeoutError, Transaction, type UpdateExchangeParams, type UpdateFulfillmentParams, type UpdateItemParams, type UpdateOrderParams, type UpdateProfileData, type UpdateReturnParams, type UpdateTransactionParams, UsageLimitError, type ValidateDiscountParams, type ValidateDiscountResult, ValidationError, collectionKeys, createBrowserClient, createServerClient, customerKeys, formatOrderName, generateOrderNumber, getQueryClient, isApiError, isConfigError, isGoneError, isNetworkError, isSDKError, isServiceUnavailableError, isTimeoutError, isUsageLimitError, isValidationError, resolveApiUrl, resolveRelation };
+export { type AddItemParams, ApiError, type ApiQueryOptions, type ApiQueryReactOptions, 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, NetworkError, Order, OrderApi, type OrderApiOptions, OrderProduct, type PaginationMeta, type PayloadFindResponse, type PayloadMutationResponse, Product, ProductApi, type ProductApiOptions, PublicCollection, QueryHooks, 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, 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.js

@@ -267,7 +267,7 @@ function resolveApiUrl() {
       return envUrl.replace(/\/$/, "");
     }
   }
-  return "https://api-dev.01.software";
+  return "https://api.01.software";
 }
 
 // src/core/internal/utils/http.ts
@@ -1873,7 +1873,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;
@@ -1997,7 +1997,7 @@ var QueryHooks = class extends CollectionHooks {
 };
 
 // src/core/client/client.ts
-var BrowserClient = class {
+var Client = class {
   constructor(options) {
     var _a;
     if (!options.clientKey) {
@@ -2054,8 +2054,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
@@ -2063,7 +2063,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) {
@@ -2467,9 +2467,9 @@ function getVideoMp4Url(playbackId, resolution = "high") {
 export {
   ApiError,
   BaseApi,
-  BrowserClient,
   COLLECTIONS,
   CartApi,
+  Client,
   CollectionClient,
   CollectionHooks,
   CollectionQueryBuilder,
@@ -2491,7 +2491,7 @@ export {
   ValidationError,
   collectionKeys,
   createApiKey,
-  createBrowserClient,
+  createClient,
   createServerClient,
   createServerToken,
   createTypedWebhookHandler,