@01.software/sdk 0.2.9-dev.260310.cf511cb → 0.2.9-dev.260311.892250f

package/dist/auth-CVVo5UT5.d.ts

@@ -1,298 +0,0 @@
-import { Sort, Where } from 'payload';
-import './payload-types-Cq93wqIe.js';
-
-declare class SDKError extends Error {
-    readonly code: string;
-    readonly status?: number;
-    readonly details?: unknown;
-    readonly userMessage?: string;
-    readonly suggestion?: string;
-    constructor(code: string, message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string);
-    getUserMessage(): string;
-    toJSON(): {
-        name: string;
-        code: string;
-        message: string;
-        status: number | undefined;
-        details: unknown;
-        userMessage: string | undefined;
-        suggestion: string | undefined;
-    };
-}
-declare class NetworkError extends SDKError {
-    constructor(message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ValidationError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ApiError extends SDKError {
-    constructor(message: string, status: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ConfigError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class TimeoutError extends SDKError {
-    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class GoneError extends SDKError {
-    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ServiceUnavailableError extends SDKError {
-    readonly retryAfter?: number;
-    constructor(message?: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class UsageLimitError extends SDKError {
-    readonly usage: {
-        limit: number;
-        current: number;
-        remaining: number;
-    };
-    constructor(message: string, usage: {
-        limit: number;
-        current: number;
-        remaining: number;
-    }, details?: unknown, userMessage?: string, suggestion?: string);
-    toJSON(): {
-        usage: {
-            limit: number;
-            current: number;
-            remaining: number;
-        };
-        name: string;
-        code: string;
-        message: string;
-        status: number | undefined;
-        details: unknown;
-        userMessage: string | undefined;
-        suggestion: string | undefined;
-    };
-}
-declare function isSDKError(error: unknown): error is SDKError;
-declare function isNetworkError(error: unknown): error is NetworkError;
-declare function isValidationError(error: unknown): error is ValidationError;
-declare function isApiError(error: unknown): error is ApiError;
-declare function isConfigError(error: unknown): error is ConfigError;
-declare function isTimeoutError(error: unknown): error is TimeoutError;
-declare function isGoneError(error: unknown): error is GoneError;
-declare function isServiceUnavailableError(error: unknown): error is ServiceUnavailableError;
-declare function isUsageLimitError(error: unknown): error is UsageLimitError;
-
-type Environment = 'local' | 'development' | 'staging' | 'production';
-declare const API_URLS: Record<Environment, string>;
-/**
- * 환경에 맞는 API URL을 반환합니다.
- * 우선순위: baseUrl > environment > 환경변수 > 기본값(production)
- */
-declare function resolveApiUrl(config?: {
-    baseUrl?: string;
-    environment?: Environment;
-}): string;
-interface ClientBrowserConfig {
-    clientKey: string;
-    /**
-     * API 환경 설정.
-     * - 'local': localhost:3000
-     * - 'development': dev.01.software
-     * - 'staging': stg.01.software
-     * - 'production': api.01.software
-     *
-     * baseUrl이 설정되면 이 값은 무시됩니다.
-     * @default 'production'
-     */
-    environment?: Environment;
-    /**
-     * 커스텀 API URL. 설정 시 environment 값은 무시됩니다.
-     * @example 'https://my-custom-api.example.com'
-     */
-    baseUrl?: string;
-    /**
-     * Customer authentication options.
-     * Used to initialize CustomerAuth on BrowserClient.
-     */
-    customer?: {
-        /**
-         * Automatically persist token in localStorage.
-         * - `true`: uses default key `'customer-token'`
-         * - `string`: uses the given string as localStorage key
-         *
-         * Handles SSR safely (no-op on server).
-         * When set, `token` and `onTokenChange` are ignored.
-         */
-        persist?: boolean | string;
-        /** Initial token (e.g. from SSR cookie) */
-        token?: string;
-        /** Called when token changes (login/logout) — use to persist in localStorage/cookie */
-        onTokenChange?: (token: string | null) => void;
-    };
-}
-interface ClientServerConfig extends ClientBrowserConfig {
-    secretKey: string;
-}
-interface ClientMetadata {
-    userAgent?: string;
-    timestamp: number;
-}
-interface ClientState {
-    metadata: ClientMetadata;
-}
-interface PaginationMeta {
-    page: number;
-    limit: number;
-    totalDocs: number;
-    totalPages: number;
-    hasNextPage: boolean;
-    hasPrevPage: boolean;
-    pagingCounter: number;
-    prevPage: number | null;
-    nextPage: number | null;
-}
-/**
- * Payload CMS Find (List) Response
- * GET /api/{collection}
- */
-interface PayloadFindResponse<T = unknown> {
-    docs: T[];
-    totalDocs: number;
-    limit: number;
-    totalPages: number;
-    page: number;
-    pagingCounter: number;
-    hasPrevPage: boolean;
-    hasNextPage: boolean;
-    prevPage: number | null;
-    nextPage: number | null;
-}
-/**
- * Payload CMS Create/Update Response
- * POST /api/{collection}
- * PATCH /api/{collection}/{id}
- */
-interface PayloadMutationResponse<T = unknown> {
-    message: string;
-    doc: T;
-    errors?: unknown[];
-}
-interface ApiQueryOptions {
-    page?: number;
-    limit?: number;
-    sort?: Sort;
-    where?: Where;
-    depth?: number;
-    select?: Record<string, boolean>;
-}
-interface ApiQueryReactOptions {
-    keepPreviousData?: boolean;
-}
-interface DebugConfig {
-    logRequests?: boolean;
-    logResponses?: boolean;
-    logErrors?: boolean;
-}
-interface RetryConfig {
-    maxRetries?: number;
-    retryableStatuses?: number[];
-    retryDelay?: (attempt: number) => number;
-}
-interface ErrorLogger {
-    log(error: SDKError | Error, context?: Record<string, unknown>): void;
-}
-type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
-
-interface FetchOptions extends RequestInit {
-    clientKey?: string;
-    secretKey?: string;
-    customerToken?: string;
-    timeout?: number;
-    baseUrl?: string;
-    debug?: boolean | DebugConfig;
-    retry?: RetryConfig;
-    /** Called on 401 when customerToken is set. Return a new token to retry, or null to fail. */
-    onUnauthorized?: () => Promise<string | null>;
-}
-interface JwtPayload {
-    clientKey: string;
-    iat?: number;
-    exp?: number;
-}
-/**
- * Creates a JWT token for server-side authentication.
- * The token is valid for 1 hour by default.
- *
- * @param clientKey - Client API key
- * @param secretKey - Secret key used for signing
- * @param expiresIn - Token expiration time (default: '1h')
- * @returns Promise<string> JWT token
- *
- * @example
- * ```typescript
- * const token = await createServerToken('client-key', 'secret-key')
- * // Use in Authorization header: `Bearer ${token}`
- * ```
- */
-declare function createServerToken(clientKey: string, secretKey: string, expiresIn?: string): Promise<string>;
-/**
- * Verifies a JWT token and returns the payload.
- *
- * @param token - JWT token to verify
- * @param secretKey - Secret key used for verification
- * @returns Promise<JwtPayload> Verified payload containing clientKey
- * @throws Error if token is invalid or expired
- *
- * @example
- * ```typescript
- * const payload = await verifyServerToken(token, 'secret-key')
- * console.log(payload.clientKey)
- * ```
- */
-declare function verifyServerToken(token: string, secretKey: string): Promise<JwtPayload>;
-/**
- * Decodes a JWT token without verification.
- * WARNING: Use this only when you need to inspect token contents.
- * Always use verifyServerToken for authentication.
- *
- * @param token - JWT token to decode
- * @returns JwtPayload Decoded payload (unverified)
- *
- * @example
- * ```typescript
- * const payload = decodeServerToken(token)
- * console.log(payload.clientKey) // Unverified!
- * ```
- */
-declare function decodeServerToken(token: string): JwtPayload;
-/**
- * Creates a Base64-encoded API key from clientKey and secretKey.
- * Use this for MCP server authentication.
- *
- * @param clientKey - Client API key
- * @param secretKey - Secret key
- * @returns Base64-encoded API key
- *
- * @example
- * ```typescript
- * const apiKey = createApiKey('client-key', 'secret-key')
- * // Use in x-api-key header
- * ```
- */
-declare function createApiKey(clientKey: string, secretKey: string): string;
-/**
- * Parses a Base64-encoded API key to extract clientKey and secretKey.
- *
- * @param apiKey - Base64-encoded API key
- * @returns Object containing clientKey and secretKey
- * @throws Error if API key is invalid
- *
- * @example
- * ```typescript
- * const { clientKey, secretKey } = parseApiKey(apiKey)
- * ```
- */
-declare function parseApiKey(apiKey: string): {
-    clientKey: string;
-    secretKey: string;
-};
-
-export { type ApiQueryOptions as A, type PaginationMeta as B, type ClientBrowserConfig as C, type DeepPartial as D, type ExtractArrayType as E, type FetchOptions as F, GoneError as G, type ApiQueryReactOptions as H, type JwtPayload as J, NetworkError as N, type PayloadFindResponse as P, type RetryConfig as R, SDKError as S, TimeoutError as T, UsageLimitError as U, ValidationError as V, type PayloadMutationResponse as a, type ClientState as b, type ClientServerConfig as c, type DebugConfig as d, type ErrorLogger as e, ApiError as f, ConfigError as g, ServiceUnavailableError as h, isSDKError as i, isNetworkError as j, isValidationError as k, isApiError as l, isConfigError as m, isTimeoutError as n, isGoneError as o, isServiceUnavailableError as p, isUsageLimitError as q, createServerToken as r, decodeServerToken as s, createApiKey as t, parseApiKey as u, verifyServerToken as v, type Environment as w, API_URLS as x, resolveApiUrl as y, type ClientMetadata as z };

package/dist/auth-CqgrT1qd.d.cts

@@ -1,298 +0,0 @@
-import { Sort, Where } from 'payload';
-import './payload-types-Cq93wqIe.cjs';
-
-declare class SDKError extends Error {
-    readonly code: string;
-    readonly status?: number;
-    readonly details?: unknown;
-    readonly userMessage?: string;
-    readonly suggestion?: string;
-    constructor(code: string, message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string);
-    getUserMessage(): string;
-    toJSON(): {
-        name: string;
-        code: string;
-        message: string;
-        status: number | undefined;
-        details: unknown;
-        userMessage: string | undefined;
-        suggestion: string | undefined;
-    };
-}
-declare class NetworkError extends SDKError {
-    constructor(message: string, status?: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ValidationError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ApiError extends SDKError {
-    constructor(message: string, status: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ConfigError extends SDKError {
-    constructor(message: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class TimeoutError extends SDKError {
-    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class GoneError extends SDKError {
-    constructor(message?: string, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class ServiceUnavailableError extends SDKError {
-    readonly retryAfter?: number;
-    constructor(message?: string, retryAfter?: number, details?: unknown, userMessage?: string, suggestion?: string);
-}
-declare class UsageLimitError extends SDKError {
-    readonly usage: {
-        limit: number;
-        current: number;
-        remaining: number;
-    };
-    constructor(message: string, usage: {
-        limit: number;
-        current: number;
-        remaining: number;
-    }, details?: unknown, userMessage?: string, suggestion?: string);
-    toJSON(): {
-        usage: {
-            limit: number;
-            current: number;
-            remaining: number;
-        };
-        name: string;
-        code: string;
-        message: string;
-        status: number | undefined;
-        details: unknown;
-        userMessage: string | undefined;
-        suggestion: string | undefined;
-    };
-}
-declare function isSDKError(error: unknown): error is SDKError;
-declare function isNetworkError(error: unknown): error is NetworkError;
-declare function isValidationError(error: unknown): error is ValidationError;
-declare function isApiError(error: unknown): error is ApiError;
-declare function isConfigError(error: unknown): error is ConfigError;
-declare function isTimeoutError(error: unknown): error is TimeoutError;
-declare function isGoneError(error: unknown): error is GoneError;
-declare function isServiceUnavailableError(error: unknown): error is ServiceUnavailableError;
-declare function isUsageLimitError(error: unknown): error is UsageLimitError;
-
-type Environment = 'local' | 'development' | 'staging' | 'production';
-declare const API_URLS: Record<Environment, string>;
-/**
- * 환경에 맞는 API URL을 반환합니다.
- * 우선순위: baseUrl > environment > 환경변수 > 기본값(production)
- */
-declare function resolveApiUrl(config?: {
-    baseUrl?: string;
-    environment?: Environment;
-}): string;
-interface ClientBrowserConfig {
-    clientKey: string;
-    /**
-     * API 환경 설정.
-     * - 'local': localhost:3000
-     * - 'development': dev.01.software
-     * - 'staging': stg.01.software
-     * - 'production': api.01.software
-     *
-     * baseUrl이 설정되면 이 값은 무시됩니다.
-     * @default 'production'
-     */
-    environment?: Environment;
-    /**
-     * 커스텀 API URL. 설정 시 environment 값은 무시됩니다.
-     * @example 'https://my-custom-api.example.com'
-     */
-    baseUrl?: string;
-    /**
-     * Customer authentication options.
-     * Used to initialize CustomerAuth on BrowserClient.
-     */
-    customer?: {
-        /**
-         * Automatically persist token in localStorage.
-         * - `true`: uses default key `'customer-token'`
-         * - `string`: uses the given string as localStorage key
-         *
-         * Handles SSR safely (no-op on server).
-         * When set, `token` and `onTokenChange` are ignored.
-         */
-        persist?: boolean | string;
-        /** Initial token (e.g. from SSR cookie) */
-        token?: string;
-        /** Called when token changes (login/logout) — use to persist in localStorage/cookie */
-        onTokenChange?: (token: string | null) => void;
-    };
-}
-interface ClientServerConfig extends ClientBrowserConfig {
-    secretKey: string;
-}
-interface ClientMetadata {
-    userAgent?: string;
-    timestamp: number;
-}
-interface ClientState {
-    metadata: ClientMetadata;
-}
-interface PaginationMeta {
-    page: number;
-    limit: number;
-    totalDocs: number;
-    totalPages: number;
-    hasNextPage: boolean;
-    hasPrevPage: boolean;
-    pagingCounter: number;
-    prevPage: number | null;
-    nextPage: number | null;
-}
-/**
- * Payload CMS Find (List) Response
- * GET /api/{collection}
- */
-interface PayloadFindResponse<T = unknown> {
-    docs: T[];
-    totalDocs: number;
-    limit: number;
-    totalPages: number;
-    page: number;
-    pagingCounter: number;
-    hasPrevPage: boolean;
-    hasNextPage: boolean;
-    prevPage: number | null;
-    nextPage: number | null;
-}
-/**
- * Payload CMS Create/Update Response
- * POST /api/{collection}
- * PATCH /api/{collection}/{id}
- */
-interface PayloadMutationResponse<T = unknown> {
-    message: string;
-    doc: T;
-    errors?: unknown[];
-}
-interface ApiQueryOptions {
-    page?: number;
-    limit?: number;
-    sort?: Sort;
-    where?: Where;
-    depth?: number;
-    select?: Record<string, boolean>;
-}
-interface ApiQueryReactOptions {
-    keepPreviousData?: boolean;
-}
-interface DebugConfig {
-    logRequests?: boolean;
-    logResponses?: boolean;
-    logErrors?: boolean;
-}
-interface RetryConfig {
-    maxRetries?: number;
-    retryableStatuses?: number[];
-    retryDelay?: (attempt: number) => number;
-}
-interface ErrorLogger {
-    log(error: SDKError | Error, context?: Record<string, unknown>): void;
-}
-type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
-
-interface FetchOptions extends RequestInit {
-    clientKey?: string;
-    secretKey?: string;
-    customerToken?: string;
-    timeout?: number;
-    baseUrl?: string;
-    debug?: boolean | DebugConfig;
-    retry?: RetryConfig;
-    /** Called on 401 when customerToken is set. Return a new token to retry, or null to fail. */
-    onUnauthorized?: () => Promise<string | null>;
-}
-interface JwtPayload {
-    clientKey: string;
-    iat?: number;
-    exp?: number;
-}
-/**
- * Creates a JWT token for server-side authentication.
- * The token is valid for 1 hour by default.
- *
- * @param clientKey - Client API key
- * @param secretKey - Secret key used for signing
- * @param expiresIn - Token expiration time (default: '1h')
- * @returns Promise<string> JWT token
- *
- * @example
- * ```typescript
- * const token = await createServerToken('client-key', 'secret-key')
- * // Use in Authorization header: `Bearer ${token}`
- * ```
- */
-declare function createServerToken(clientKey: string, secretKey: string, expiresIn?: string): Promise<string>;
-/**
- * Verifies a JWT token and returns the payload.
- *
- * @param token - JWT token to verify
- * @param secretKey - Secret key used for verification
- * @returns Promise<JwtPayload> Verified payload containing clientKey
- * @throws Error if token is invalid or expired
- *
- * @example
- * ```typescript
- * const payload = await verifyServerToken(token, 'secret-key')
- * console.log(payload.clientKey)
- * ```
- */
-declare function verifyServerToken(token: string, secretKey: string): Promise<JwtPayload>;
-/**
- * Decodes a JWT token without verification.
- * WARNING: Use this only when you need to inspect token contents.
- * Always use verifyServerToken for authentication.
- *
- * @param token - JWT token to decode
- * @returns JwtPayload Decoded payload (unverified)
- *
- * @example
- * ```typescript
- * const payload = decodeServerToken(token)
- * console.log(payload.clientKey) // Unverified!
- * ```
- */
-declare function decodeServerToken(token: string): JwtPayload;
-/**
- * Creates a Base64-encoded API key from clientKey and secretKey.
- * Use this for MCP server authentication.
- *
- * @param clientKey - Client API key
- * @param secretKey - Secret key
- * @returns Base64-encoded API key
- *
- * @example
- * ```typescript
- * const apiKey = createApiKey('client-key', 'secret-key')
- * // Use in x-api-key header
- * ```
- */
-declare function createApiKey(clientKey: string, secretKey: string): string;
-/**
- * Parses a Base64-encoded API key to extract clientKey and secretKey.
- *
- * @param apiKey - Base64-encoded API key
- * @returns Object containing clientKey and secretKey
- * @throws Error if API key is invalid
- *
- * @example
- * ```typescript
- * const { clientKey, secretKey } = parseApiKey(apiKey)
- * ```
- */
-declare function parseApiKey(apiKey: string): {
-    clientKey: string;
-    secretKey: string;
-};
-
-export { type ApiQueryOptions as A, type PaginationMeta as B, type ClientBrowserConfig as C, type DeepPartial as D, type ExtractArrayType as E, type FetchOptions as F, GoneError as G, type ApiQueryReactOptions as H, type JwtPayload as J, NetworkError as N, type PayloadFindResponse as P, type RetryConfig as R, SDKError as S, TimeoutError as T, UsageLimitError as U, ValidationError as V, type PayloadMutationResponse as a, type ClientState as b, type ClientServerConfig as c, type DebugConfig as d, type ErrorLogger as e, ApiError as f, ConfigError as g, ServiceUnavailableError as h, isSDKError as i, isNetworkError as j, isValidationError as k, isApiError as l, isConfigError as m, isTimeoutError as n, isGoneError as o, isServiceUnavailableError as p, isUsageLimitError as q, createServerToken as r, decodeServerToken as s, createApiKey as t, parseApiKey as u, verifyServerToken as v, type Environment as w, API_URLS as x, resolveApiUrl as y, type ClientMetadata as z };