@01.software/sdk 0.1.0-dev.260210.4ecca43 → 0.1.1

package/dist/auth-Brdn6voY.d.ts

@@ -0,0 +1,267 @@
+import { Sort, Where } from 'payload';
+import './payload-types-BE-5_Y2d.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 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 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;
+}
+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;
+    timeout?: number;
+    baseUrl?: string;
+    debug?: boolean | DebugConfig;
+    retry?: RetryConfig;
+}
+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 ClientBrowserConfig as C, type DeepPartial as D, type ExtractArrayType as E, type FetchOptions as F, 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, isNetworkError as h, isSDKError as i, isValidationError as j, isApiError as k, isConfigError as l, isTimeoutError as m, isUsageLimitError as n, createServerToken as o, decodeServerToken as p, createApiKey as q, parseApiKey as r, type Environment as s, API_URLS as t, resolveApiUrl as u, verifyServerToken as v, type ClientMetadata as w, type PaginationMeta as x, type ApiQueryReactOptions as y };

package/dist/auth.cjs

@@ -0,0 +1,129 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/auth.ts
+var auth_exports = {};
+__export(auth_exports, {
+  createApiKey: () => createApiKey,
+  createServerToken: () => createServerToken,
+  decodeServerToken: () => decodeServerToken,
+  parseApiKey: () => parseApiKey,
+  verifyServerToken: () => verifyServerToken
+});
+module.exports = __toCommonJS(auth_exports);
+
+// src/core/internal/utils/index.ts
+var import_jose = require("jose");
+function createServerToken(clientKey, secretKey, expiresIn = "1h") {
+  return __async(this, null, function* () {
+    if (!clientKey || !secretKey) {
+      throw new Error("clientKey and secretKey are required.");
+    }
+    const secret = new TextEncoder().encode(secretKey);
+    return new import_jose.SignJWT({ clientKey }).setProtectedHeader({ alg: "HS256" }).setIssuedAt().setExpirationTime(expiresIn).sign(secret);
+  });
+}
+function verifyServerToken(token, secretKey) {
+  return __async(this, null, function* () {
+    if (!token || !secretKey) {
+      throw new Error("token and secretKey are required.");
+    }
+    const secret = new TextEncoder().encode(secretKey);
+    const { payload } = yield (0, import_jose.jwtVerify)(token, secret, {
+      algorithms: ["HS256"]
+    });
+    if (!payload.clientKey || typeof payload.clientKey !== "string") {
+      throw new Error("Invalid token payload: clientKey is missing");
+    }
+    return {
+      clientKey: payload.clientKey,
+      iat: payload.iat,
+      exp: payload.exp
+    };
+  });
+}
+function decodeServerToken(token) {
+  if (!token) {
+    throw new Error("token is required.");
+  }
+  const payload = (0, import_jose.decodeJwt)(token);
+  if (!payload.clientKey || typeof payload.clientKey !== "string") {
+    throw new Error("Invalid token payload: clientKey is missing");
+  }
+  return {
+    clientKey: payload.clientKey,
+    iat: payload.iat,
+    exp: payload.exp
+  };
+}
+function createApiKey(clientKey, secretKey) {
+  if (!clientKey || !secretKey) {
+    throw new Error("clientKey and secretKey are required.");
+  }
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(`${clientKey}:${secretKey}`).toString("base64");
+  }
+  return btoa(`${clientKey}:${secretKey}`);
+}
+function parseApiKey(apiKey) {
+  if (!apiKey) {
+    throw new Error("apiKey is required.");
+  }
+  try {
+    let decoded;
+    if (typeof Buffer !== "undefined") {
+      decoded = Buffer.from(apiKey, "base64").toString("utf-8");
+    } else {
+      decoded = atob(apiKey);
+    }
+    const colonIndex = decoded.indexOf(":");
+    if (colonIndex === -1) {
+      throw new Error("Invalid format: missing colon separator");
+    }
+    const clientKey = decoded.substring(0, colonIndex);
+    const secretKey = decoded.substring(colonIndex + 1);
+    if (!clientKey || !secretKey) {
+      throw new Error("Invalid format: empty clientKey or secretKey");
+    }
+    return { clientKey, secretKey };
+  } catch (e) {
+    throw new Error('Invalid API key. Expected Base64 encoded "clientKey:secretKey"');
+  }
+}
+//# sourceMappingURL=auth.cjs.map

package/dist/auth.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/auth.ts","../src/core/internal/utils/index.ts"],"sourcesContent":["export type { JwtPayload } from './core/internal/utils'\nexport {\n  createServerToken,\n  verifyServerToken,\n  decodeServerToken,\n  createApiKey,\n  parseApiKey,\n} from './core/internal/utils'\n","import { SignJWT, jwtVerify, decodeJwt } from 'jose'\nimport { createNetworkError, createUsageLimitError, createTimeoutError, TimeoutError, NetworkError } from '../errors'\nimport type { DebugConfig, RetryConfig } from '../../client/types'\nimport { API_URLS } from '../../client/types'\n\nconst DEFAULT_TIMEOUT = 30000\nconst DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504]\nconst NON_RETRYABLE_STATUSES = [401, 403, 404, 422]\n\nexport interface FetchOptions extends RequestInit {\n  clientKey?: string\n  secretKey?: string\n  timeout?: number\n  baseUrl?: string\n  debug?: boolean | DebugConfig\n  retry?: RetryConfig\n}\n\nexport interface JwtPayload {\n  clientKey: string\n  iat?: number\n  exp?: number\n}\n\n/**\n * Creates a JWT token for server-side authentication.\n * The token is valid for 1 hour by default.\n *\n * @param clientKey - Client API key\n * @param secretKey - Secret key used for signing\n * @param expiresIn - Token expiration time (default: '1h')\n * @returns Promise<string> JWT token\n *\n * @example\n * ```typescript\n * const token = await createServerToken('client-key', 'secret-key')\n * // Use in Authorization header: `Bearer ${token}`\n * ```\n */\nexport async function createServerToken(\n  clientKey: string,\n  secretKey: string,\n  expiresIn: string = '1h',\n): Promise<string> {\n  if (!clientKey || !secretKey) {\n    throw new Error('clientKey and secretKey are required.')\n  }\n\n  const secret = new TextEncoder().encode(secretKey)\n  return new SignJWT({ clientKey })\n    .setProtectedHeader({ alg: 'HS256' })\n    .setIssuedAt()\n    .setExpirationTime(expiresIn)\n    .sign(secret)\n}\n\n/**\n * Verifies a JWT token and returns the payload.\n *\n * @param token - JWT token to verify\n * @param secretKey - Secret key used for verification\n * @returns Promise<JwtPayload> Verified payload containing clientKey\n * @throws Error if token is invalid or expired\n *\n * @example\n * ```typescript\n * const payload = await verifyServerToken(token, 'secret-key')\n * console.log(payload.clientKey)\n * ```\n */\nexport async function verifyServerToken(\n  token: string,\n  secretKey: string,\n): Promise<JwtPayload> {\n  if (!token || !secretKey) {\n    throw new Error('token and secretKey are required.')\n  }\n\n  const secret = new TextEncoder().encode(secretKey)\n  const { payload } = await jwtVerify(token, secret, {\n    algorithms: ['HS256'],\n  })\n\n  if (!payload.clientKey || typeof payload.clientKey !== 'string') {\n    throw new Error('Invalid token payload: clientKey is missing')\n  }\n\n  return {\n    clientKey: payload.clientKey as string,\n    iat: payload.iat,\n    exp: payload.exp,\n  }\n}\n\n/**\n * Decodes a JWT token without verification.\n * WARNING: Use this only when you need to inspect token contents.\n * Always use verifyServerToken for authentication.\n *\n * @param token - JWT token to decode\n * @returns JwtPayload Decoded payload (unverified)\n *\n * @example\n * ```typescript\n * const payload = decodeServerToken(token)\n * console.log(payload.clientKey) // Unverified!\n * ```\n */\nexport function decodeServerToken(token: string): JwtPayload {\n  if (!token) {\n    throw new Error('token is required.')\n  }\n\n  const payload = decodeJwt(token)\n\n  if (!payload.clientKey || typeof payload.clientKey !== 'string') {\n    throw new Error('Invalid token payload: clientKey is missing')\n  }\n\n  return {\n    clientKey: payload.clientKey as string,\n    iat: payload.iat,\n    exp: payload.exp,\n  }\n}\n\n// ============================================================================\n// API Key Utilities\n// ============================================================================\n\n/**\n * Creates a Base64-encoded API key from clientKey and secretKey.\n * Use this for MCP server authentication.\n *\n * @param clientKey - Client API key\n * @param secretKey - Secret key\n * @returns Base64-encoded API key\n *\n * @example\n * ```typescript\n * const apiKey = createApiKey('client-key', 'secret-key')\n * // Use in x-api-key header\n * ```\n */\nexport function createApiKey(clientKey: string, secretKey: string): string {\n  if (!clientKey || !secretKey) {\n    throw new Error('clientKey and secretKey are required.')\n  }\n\n  // Browser와 Node.js 모두 지원\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(`${clientKey}:${secretKey}`).toString('base64')\n  }\n  return btoa(`${clientKey}:${secretKey}`)\n}\n\n/**\n * Parses a Base64-encoded API key to extract clientKey and secretKey.\n *\n * @param apiKey - Base64-encoded API key\n * @returns Object containing clientKey and secretKey\n * @throws Error if API key is invalid\n *\n * @example\n * ```typescript\n * const { clientKey, secretKey } = parseApiKey(apiKey)\n * ```\n */\nexport function parseApiKey(apiKey: string): {\n  clientKey: string\n  secretKey: string\n} {\n  if (!apiKey) {\n    throw new Error('apiKey is required.')\n  }\n\n  try {\n    let decoded: string\n    if (typeof Buffer !== 'undefined') {\n      decoded = Buffer.from(apiKey, 'base64').toString('utf-8')\n    } else {\n      decoded = atob(apiKey)\n    }\n\n    const colonIndex = decoded.indexOf(':')\n    if (colonIndex === -1) {\n      throw new Error('Invalid format: missing colon separator')\n    }\n\n    const clientKey = decoded.substring(0, colonIndex)\n    const secretKey = decoded.substring(colonIndex + 1)\n\n    if (!clientKey || !secretKey) {\n      throw new Error('Invalid format: empty clientKey or secretKey')\n    }\n\n    return { clientKey, secretKey }\n  } catch {\n    throw new Error('Invalid API key. Expected Base64 encoded \"clientKey:secretKey\"')\n  }\n}\n\nfunction debugLog(\n  debug: boolean | DebugConfig | undefined,\n  type: 'request' | 'response' | 'error',\n  message: string,\n  data?: unknown,\n) {\n  if (!debug) return\n\n  const shouldLog =\n    debug === true ||\n    (type === 'request' && (debug as DebugConfig).logRequests) ||\n    (type === 'response' && (debug as DebugConfig).logResponses) ||\n    (type === 'error' && (debug as DebugConfig).logErrors)\n\n  if (shouldLog) {\n    console.group(`[SDK ${type.toUpperCase()}] ${message}`)\n    if (data) console.log(data)\n    console.groupEnd()\n  }\n}\n\nfunction getErrorSuggestion(status: number): string | undefined {\n  if (status === 401) return 'Please check your authentication credentials.'\n  if (status === 404) return 'The requested resource was not found.'\n  if (status >= 500)\n    return 'A server error occurred. Please try again later.'\n  return undefined\n}\n\nasync function delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nexport async function _fetch(\n  url: string,\n  options?: FetchOptions,\n): Promise<Response> {\n  const {\n    clientKey,\n    secretKey,\n    timeout = DEFAULT_TIMEOUT,\n    baseUrl = API_URLS.production,\n    debug,\n    retry,\n    ...requestInit\n  } = options || {}\n\n  const retryConfig = {\n    maxRetries: retry?.maxRetries ?? 3,\n    retryableStatuses: retry?.retryableStatuses ?? DEFAULT_RETRYABLE_STATUSES,\n    retryDelay:\n      retry?.retryDelay ??\n      ((attempt: number) => Math.min(1000 * 2 ** attempt, 10000)),\n  }\n\n  // Generate JWT once before retry loop (token valid for 1h)\n  let authToken: string | undefined\n  if (secretKey && clientKey) {\n    authToken = await createServerToken(clientKey, secretKey)\n  }\n\n  let lastError: Error | undefined\n\n  for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {\n    try {\n      const headers = new Headers(requestInit.headers)\n\n      if (clientKey) {\n        headers.set('X-Client-Key', clientKey)\n      }\n\n      if (authToken) {\n        headers.set('Authorization', `Bearer ${authToken}`)\n      }\n\n      if (!headers.has('Content-Type') && requestInit.body) {\n        headers.set('Content-Type', 'application/json')\n      }\n\n      debugLog(debug, 'request', url, {\n        method: requestInit.method || 'GET',\n        headers: Object.fromEntries(headers.entries()),\n        attempt: attempt + 1,\n      })\n\n      const controller = new AbortController()\n      const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n      const response = await fetch(`${baseUrl}${url}`, {\n        ...requestInit,\n        headers,\n        signal: controller.signal,\n      })\n\n      clearTimeout(timeoutId)\n\n      debugLog(debug, 'response', url, {\n        status: response.status,\n        statusText: response.statusText,\n        headers: Object.fromEntries(response.headers.entries()),\n      })\n\n      if (!response.ok) {\n        // Usage limit 429 — never retry (distinguished by X-Usage-Limit header)\n        if (\n          response.status === 429 &&\n          response.headers.get('X-Usage-Limit')\n        ) {\n          const limit = parseInt(response.headers.get('X-Usage-Limit') || '0', 10)\n          const current = parseInt(response.headers.get('X-Usage-Current') || '0', 10)\n          const remaining = parseInt(response.headers.get('X-Usage-Remaining') || '0', 10)\n\n          throw createUsageLimitError(\n            `Monthly API usage limit exceeded (${current.toLocaleString()}/${limit.toLocaleString()})`,\n            { limit, current, remaining },\n            { url, method: requestInit.method || 'GET', attempt: attempt + 1 },\n            'Monthly API call limit exceeded. Please upgrade your plan.',\n            'Upgrade your tenant plan to increase the monthly API call limit.',\n          )\n        }\n\n        // Never retry non-retryable statuses regardless of user config\n        if (NON_RETRYABLE_STATUSES.includes(response.status)) {\n          throw createNetworkError(\n            `HTTP ${response.status}: ${response.statusText}`,\n            response.status,\n            { url, method: requestInit.method || 'GET', attempt: attempt + 1 },\n            `Request failed (status: ${response.status})`,\n            getErrorSuggestion(response.status),\n          )\n        }\n\n        const error = createNetworkError(\n          `HTTP ${response.status}: ${response.statusText}`,\n          response.status,\n          { url, method: requestInit.method || 'GET', attempt: attempt + 1 },\n          `Request failed (status: ${response.status})`,\n          getErrorSuggestion(response.status),\n        )\n\n        if (\n          attempt < retryConfig.maxRetries &&\n          retryConfig.retryableStatuses.includes(response.status)\n        ) {\n          lastError = error\n          const retryDelay = retryConfig.retryDelay(attempt)\n          debugLog(debug, 'error', `Retrying in ${retryDelay}ms...`, error)\n          await delay(retryDelay)\n          continue\n        }\n\n        throw error\n      }\n\n      return response\n    } catch (error) {\n      debugLog(debug, 'error', url, error)\n\n      if (error instanceof Error && error.name === 'AbortError') {\n        const timeoutError = createTimeoutError(\n          `Request timed out after ${timeout}ms.`,\n          { url, timeout, attempt: attempt + 1 },\n          'The request timed out.',\n          'Please check your network connection or try again later.',\n        )\n\n        if (attempt < retryConfig.maxRetries) {\n          lastError = timeoutError\n          await delay(retryConfig.retryDelay(attempt))\n          continue\n        }\n\n        throw timeoutError\n      }\n\n      if (error instanceof TypeError) {\n        const networkError = createNetworkError(\n          'Network connection failed.',\n          undefined,\n          { url, originalError: error.message, attempt: attempt + 1 },\n          'Network connection failed.',\n          'Please check your internet connection and try again.',\n        )\n\n        if (attempt < retryConfig.maxRetries) {\n          lastError = networkError\n          await delay(retryConfig.retryDelay(attempt))\n          continue\n        }\n\n        throw networkError\n      }\n\n      if (error instanceof NetworkError || error instanceof TimeoutError) {\n        if (\n          attempt < retryConfig.maxRetries &&\n          error.status &&\n          !NON_RETRYABLE_STATUSES.includes(error.status) &&\n          retryConfig.retryableStatuses.includes(error.status)\n        ) {\n          lastError = error\n          await delay(retryConfig.retryDelay(attempt))\n          continue\n        }\n\n        throw error\n      }\n\n      const unknownError = createNetworkError(\n        error instanceof Error\n          ? error.message\n          : 'An unknown network error occurred.',\n        undefined,\n        { url, originalError: error, attempt: attempt + 1 },\n        'An unknown error occurred.',\n        'Please try again later.',\n      )\n\n      if (attempt < retryConfig.maxRetries) {\n        lastError = unknownError\n        await delay(retryConfig.retryDelay(attempt))\n        continue\n      }\n\n      throw unknownError\n    }\n  }\n\n  throw lastError!\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAA8C;AAuC9C,SAAsB,kBACpB,WACA,WACA,YAAoB,MACH;AAAA;AACjB,QAAI,CAAC,aAAa,CAAC,WAAW;AAC5B,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AAEA,UAAM,SAAS,IAAI,YAAY,EAAE,OAAO,SAAS;AACjD,WAAO,IAAI,oBAAQ,EAAE,UAAU,CAAC,EAC7B,mBAAmB,EAAE,KAAK,QAAQ,CAAC,EACnC,YAAY,EACZ,kBAAkB,SAAS,EAC3B,KAAK,MAAM;AAAA,EAChB;AAAA;AAgBA,SAAsB,kBACpB,OACA,WACqB;AAAA;AACrB,QAAI,CAAC,SAAS,CAAC,WAAW;AACxB,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACrD;AAEA,UAAM,SAAS,IAAI,YAAY,EAAE,OAAO,SAAS;AACjD,UAAM,EAAE,QAAQ,IAAI,UAAM,uBAAU,OAAO,QAAQ;AAAA,MACjD,YAAY,CAAC,OAAO;AAAA,IACtB,CAAC;AAED,QAAI,CAAC,QAAQ,aAAa,OAAO,QAAQ,cAAc,UAAU;AAC/D,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AAEA,WAAO;AAAA,MACL,WAAW,QAAQ;AAAA,MACnB,KAAK,QAAQ;AAAA,MACb,KAAK,QAAQ;AAAA,IACf;AAAA,EACF;AAAA;AAgBO,SAAS,kBAAkB,OAA2B;AAC3D,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,oBAAoB;AAAA,EACtC;AAEA,QAAM,cAAU,uBAAU,KAAK;AAE/B,MAAI,CAAC,QAAQ,aAAa,OAAO,QAAQ,cAAc,UAAU;AAC/D,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AAEA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,KAAK,QAAQ;AAAA,IACb,KAAK,QAAQ;AAAA,EACf;AACF;AAoBO,SAAS,aAAa,WAAmB,WAA2B;AACzE,MAAI,CAAC,aAAa,CAAC,WAAW;AAC5B,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AAGA,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO,OAAO,KAAK,GAAG,SAAS,IAAI,SAAS,EAAE,EAAE,SAAS,QAAQ;AAAA,EACnE;AACA,SAAO,KAAK,GAAG,SAAS,IAAI,SAAS,EAAE;AACzC;AAcO,SAAS,YAAY,QAG1B;AACA,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,qBAAqB;AAAA,EACvC;AAEA,MAAI;AACF,QAAI;AACJ,QAAI,OAAO,WAAW,aAAa;AACjC,gBAAU,OAAO,KAAK,QAAQ,QAAQ,EAAE,SAAS,OAAO;AAAA,IAC1D,OAAO;AACL,gBAAU,KAAK,MAAM;AAAA,IACvB;AAEA,UAAM,aAAa,QAAQ,QAAQ,GAAG;AACtC,QAAI,eAAe,IAAI;AACrB,YAAM,IAAI,MAAM,yCAAyC;AAAA,IAC3D;AAEA,UAAM,YAAY,QAAQ,UAAU,GAAG,UAAU;AACjD,UAAM,YAAY,QAAQ,UAAU,aAAa,CAAC;AAElD,QAAI,CAAC,aAAa,CAAC,WAAW;AAC5B,YAAM,IAAI,MAAM,8CAA8C;AAAA,IAChE;AAEA,WAAO,EAAE,WAAW,UAAU;AAAA,EAChC,SAAQ;AACN,UAAM,IAAI,MAAM,gEAAgE;AAAA,EAClF;AACF;","names":[]}

package/dist/auth.d.cts

@@ -0,0 +1,3 @@
+export { J as JwtPayload, q as createApiKey, o as createServerToken, p as decodeServerToken, r as parseApiKey, v as verifyServerToken } from './auth-BipHkgbu.cjs';
+import 'payload';
+import './payload-types-BE-5_Y2d.cjs';

package/dist/auth.d.ts

@@ -0,0 +1,3 @@
+export { J as JwtPayload, q as createApiKey, o as createServerToken, p as decodeServerToken, r as parseApiKey, v as verifyServerToken } from './auth-Brdn6voY.js';
+import 'payload';
+import './payload-types-BE-5_Y2d.js';

package/dist/auth.js

@@ -0,0 +1,107 @@
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/core/internal/utils/index.ts
+import { SignJWT, jwtVerify, decodeJwt } from "jose";
+function createServerToken(clientKey, secretKey, expiresIn = "1h") {
+  return __async(this, null, function* () {
+    if (!clientKey || !secretKey) {
+      throw new Error("clientKey and secretKey are required.");
+    }
+    const secret = new TextEncoder().encode(secretKey);
+    return new SignJWT({ clientKey }).setProtectedHeader({ alg: "HS256" }).setIssuedAt().setExpirationTime(expiresIn).sign(secret);
+  });
+}
+function verifyServerToken(token, secretKey) {
+  return __async(this, null, function* () {
+    if (!token || !secretKey) {
+      throw new Error("token and secretKey are required.");
+    }
+    const secret = new TextEncoder().encode(secretKey);
+    const { payload } = yield jwtVerify(token, secret, {
+      algorithms: ["HS256"]
+    });
+    if (!payload.clientKey || typeof payload.clientKey !== "string") {
+      throw new Error("Invalid token payload: clientKey is missing");
+    }
+    return {
+      clientKey: payload.clientKey,
+      iat: payload.iat,
+      exp: payload.exp
+    };
+  });
+}
+function decodeServerToken(token) {
+  if (!token) {
+    throw new Error("token is required.");
+  }
+  const payload = decodeJwt(token);
+  if (!payload.clientKey || typeof payload.clientKey !== "string") {
+    throw new Error("Invalid token payload: clientKey is missing");
+  }
+  return {
+    clientKey: payload.clientKey,
+    iat: payload.iat,
+    exp: payload.exp
+  };
+}
+function createApiKey(clientKey, secretKey) {
+  if (!clientKey || !secretKey) {
+    throw new Error("clientKey and secretKey are required.");
+  }
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(`${clientKey}:${secretKey}`).toString("base64");
+  }
+  return btoa(`${clientKey}:${secretKey}`);
+}
+function parseApiKey(apiKey) {
+  if (!apiKey) {
+    throw new Error("apiKey is required.");
+  }
+  try {
+    let decoded;
+    if (typeof Buffer !== "undefined") {
+      decoded = Buffer.from(apiKey, "base64").toString("utf-8");
+    } else {
+      decoded = atob(apiKey);
+    }
+    const colonIndex = decoded.indexOf(":");
+    if (colonIndex === -1) {
+      throw new Error("Invalid format: missing colon separator");
+    }
+    const clientKey = decoded.substring(0, colonIndex);
+    const secretKey = decoded.substring(colonIndex + 1);
+    if (!clientKey || !secretKey) {
+      throw new Error("Invalid format: empty clientKey or secretKey");
+    }
+    return { clientKey, secretKey };
+  } catch (e) {
+    throw new Error('Invalid API key. Expected Base64 encoded "clientKey:secretKey"');
+  }
+}
+export {
+  createApiKey,
+  createServerToken,
+  decodeServerToken,
+  parseApiKey,
+  verifyServerToken
+};
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/internal/utils/index.ts"],"sourcesContent":["import { SignJWT, jwtVerify, decodeJwt } from 'jose'\nimport { createNetworkError, createUsageLimitError, createTimeoutError, TimeoutError, NetworkError } from '../errors'\nimport type { DebugConfig, RetryConfig } from '../../client/types'\nimport { API_URLS } from '../../client/types'\n\nconst DEFAULT_TIMEOUT = 30000\nconst DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504]\nconst NON_RETRYABLE_STATUSES = [401, 403, 404, 422]\n\nexport interface FetchOptions extends RequestInit {\n  clientKey?: string\n  secretKey?: string\n  timeout?: number\n  baseUrl?: string\n  debug?: boolean | DebugConfig\n  retry?: RetryConfig\n}\n\nexport interface JwtPayload {\n  clientKey: string\n  iat?: number\n  exp?: number\n}\n\n/**\n * Creates a JWT token for server-side authentication.\n * The token is valid for 1 hour by default.\n *\n * @param clientKey - Client API key\n * @param secretKey - Secret key used for signing\n * @param expiresIn - Token expiration time (default: '1h')\n * @returns Promise<string> JWT token\n *\n * @example\n * ```typescript\n * const token = await createServerToken('client-key', 'secret-key')\n * // Use in Authorization header: `Bearer ${token}`\n * ```\n */\nexport async function createServerToken(\n  clientKey: string,\n  secretKey: string,\n  expiresIn: string = '1h',\n): Promise<string> {\n  if (!clientKey || !secretKey) {\n    throw new Error('clientKey and secretKey are required.')\n  }\n\n  const secret = new TextEncoder().encode(secretKey)\n  return new SignJWT({ clientKey })\n    .setProtectedHeader({ alg: 'HS256' })\n    .setIssuedAt()\n    .setExpirationTime(expiresIn)\n    .sign(secret)\n}\n\n/**\n * Verifies a JWT token and returns the payload.\n *\n * @param token - JWT token to verify\n * @param secretKey - Secret key used for verification\n * @returns Promise<JwtPayload> Verified payload containing clientKey\n * @throws Error if token is invalid or expired\n *\n * @example\n * ```typescript\n * const payload = await verifyServerToken(token, 'secret-key')\n * console.log(payload.clientKey)\n * ```\n */\nexport async function verifyServerToken(\n  token: string,\n  secretKey: string,\n): Promise<JwtPayload> {\n  if (!token || !secretKey) {\n    throw new Error('token and secretKey are required.')\n  }\n\n  const secret = new TextEncoder().encode(secretKey)\n  const { payload } = await jwtVerify(token, secret, {\n    algorithms: ['HS256'],\n  })\n\n  if (!payload.clientKey || typeof payload.clientKey !== 'string') {\n    throw new Error('Invalid token payload: clientKey is missing')\n  }\n\n  return {\n    clientKey: payload.clientKey as string,\n    iat: payload.iat,\n    exp: payload.exp,\n  }\n}\n\n/**\n * Decodes a JWT token without verification.\n * WARNING: Use this only when you need to inspect token contents.\n * Always use verifyServerToken for authentication.\n *\n * @param token - JWT token to decode\n * @returns JwtPayload Decoded payload (unverified)\n *\n * @example\n * ```typescript\n * const payload = decodeServerToken(token)\n * console.log(payload.clientKey) // Unverified!\n * ```\n */\nexport function decodeServerToken(token: string): JwtPayload {\n  if (!token) {\n    throw new Error('token is required.')\n  }\n\n  const payload = decodeJwt(token)\n\n  if (!payload.clientKey || typeof payload.clientKey !== 'string') {\n    throw new Error('Invalid token payload: clientKey is missing')\n  }\n\n  return {\n    clientKey: payload.clientKey as string,\n    iat: payload.iat,\n    exp: payload.exp,\n  }\n}\n\n// ============================================================================\n// API Key Utilities\n// ============================================================================\n\n/**\n * Creates a Base64-encoded API key from clientKey and secretKey.\n * Use this for MCP server authentication.\n *\n * @param clientKey - Client API key\n * @param secretKey - Secret key\n * @returns Base64-encoded API key\n *\n * @example\n * ```typescript\n * const apiKey = createApiKey('client-key', 'secret-key')\n * // Use in x-api-key header\n * ```\n */\nexport function createApiKey(clientKey: string, secretKey: string): string {\n  if (!clientKey || !secretKey) {\n    throw new Error('clientKey and secretKey are required.')\n  }\n\n  // Browser와 Node.js 모두 지원\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(`${clientKey}:${secretKey}`).toString('base64')\n  }\n  return btoa(`${clientKey}:${secretKey}`)\n}\n\n/**\n * Parses a Base64-encoded API key to extract clientKey and secretKey.\n *\n * @param apiKey - Base64-encoded API key\n * @returns Object containing clientKey and secretKey\n * @throws Error if API key is invalid\n *\n * @example\n * ```typescript\n * const { clientKey, secretKey } = parseApiKey(apiKey)\n * ```\n */\nexport function parseApiKey(apiKey: string): {\n  clientKey: string\n  secretKey: string\n} {\n  if (!apiKey) {\n    throw new Error('apiKey is required.')\n  }\n\n  try {\n    let decoded: string\n    if (typeof Buffer !== 'undefined') {\n      decoded = Buffer.from(apiKey, 'base64').toString('utf-8')\n    } else {\n      decoded = atob(apiKey)\n    }\n\n    const colonIndex = decoded.indexOf(':')\n    if (colonIndex === -1) {\n      throw new Error('Invalid format: missing colon separator')\n    }\n\n    const clientKey = decoded.substring(0, colonIndex)\n    const secretKey = decoded.substring(colonIndex + 1)\n\n    if (!clientKey || !secretKey) {\n      throw new Error('Invalid format: empty clientKey or secretKey')\n    }\n\n    return { clientKey, secretKey }\n  } catch {\n    throw new Error('Invalid API key. Expected Base64 encoded \"clientKey:secretKey\"')\n  }\n}\n\nfunction debugLog(\n  debug: boolean | DebugConfig | undefined,\n  type: 'request' | 'response' | 'error',\n  message: string,\n  data?: unknown,\n) {\n  if (!debug) return\n\n  const shouldLog =\n    debug === true ||\n    (type === 'request' && (debug as DebugConfig).logRequests) ||\n    (type === 'response' && (debug as DebugConfig).logResponses) ||\n    (type === 'error' && (debug as DebugConfig).logErrors)\n\n  if (shouldLog) {\n    console.group(`[SDK ${type.toUpperCase()}] ${message}`)\n    if (data) console.log(data)\n    console.groupEnd()\n  }\n}\n\nfunction getErrorSuggestion(status: number): string | undefined {\n  if (status === 401) return 'Please check your authentication credentials.'\n  if (status === 404) return 'The requested resource was not found.'\n  if (status >= 500)\n    return 'A server error occurred. Please try again later.'\n  return undefined\n}\n\nasync function delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nexport async function _fetch(\n  url: string,\n  options?: FetchOptions,\n): Promise<Response> {\n  const {\n    clientKey,\n    secretKey,\n    timeout = DEFAULT_TIMEOUT,\n    baseUrl = API_URLS.production,\n    debug,\n    retry,\n    ...requestInit\n  } = options || {}\n\n  const retryConfig = {\n    maxRetries: retry?.maxRetries ?? 3,\n    retryableStatuses: retry?.retryableStatuses ?? DEFAULT_RETRYABLE_STATUSES,\n    retryDelay:\n      retry?.retryDelay ??\n      ((attempt: number) => Math.min(1000 * 2 ** attempt, 10000)),\n  }\n\n  // Generate JWT once before retry loop (token valid for 1h)\n  let authToken: string | undefined\n  if (secretKey && clientKey) {\n    authToken = await createServerToken(clientKey, secretKey)\n  }\n\n  let lastError: Error | undefined\n\n  for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {\n    try {\n      const headers = new Headers(requestInit.headers)\n\n      if (clientKey) {\n        headers.set('X-Client-Key', clientKey)\n      }\n\n      if (authToken) {\n        headers.set('Authorization', `Bearer ${authToken}`)\n      }\n\n      if (!headers.has('Content-Type') && requestInit.body) {\n        headers.set('Content-Type', 'application/json')\n      }\n\n      debugLog(debug, 'request', url, {\n        method: requestInit.method || 'GET',\n        headers: Object.fromEntries(headers.entries()),\n        attempt: attempt + 1,\n      })\n\n      const controller = new AbortController()\n      const timeoutId = setTimeout(() => controller.abort(), timeout)\n\n      const response = await fetch(`${baseUrl}${url}`, {\n        ...requestInit,\n        headers,\n        signal: controller.signal,\n      })\n\n      clearTimeout(timeoutId)\n\n      debugLog(debug, 'response', url, {\n        status: response.status,\n        statusText: response.statusText,\n        headers: Object.fromEntries(response.headers.entries()),\n      })\n\n      if (!response.ok) {\n        // Usage limit 429 — never retry (distinguished by X-Usage-Limit header)\n        if (\n          response.status === 429 &&\n          response.headers.get('X-Usage-Limit')\n        ) {\n          const limit = parseInt(response.headers.get('X-Usage-Limit') || '0', 10)\n          const current = parseInt(response.headers.get('X-Usage-Current') || '0', 10)\n          const remaining = parseInt(response.headers.get('X-Usage-Remaining') || '0', 10)\n\n          throw createUsageLimitError(\n            `Monthly API usage limit exceeded (${current.toLocaleString()}/${limit.toLocaleString()})`,\n            { limit, current, remaining },\n            { url, method: requestInit.method || 'GET', attempt: attempt + 1 },\n            'Monthly API call limit exceeded. Please upgrade your plan.',\n            'Upgrade your tenant plan to increase the monthly API call limit.',\n          )\n        }\n\n        // Never retry non-retryable statuses regardless of user config\n        if (NON_RETRYABLE_STATUSES.includes(response.status)) {\n          throw createNetworkError(\n            `HTTP ${response.status}: ${response.statusText}`,\n            response.status,\n            { url, method: requestInit.method || 'GET', attempt: attempt + 1 },\n            `Request failed (status: ${response.status})`,\n            getErrorSuggestion(response.status),\n          )\n        }\n\n        const error = createNetworkError(\n          `HTTP ${response.status}: ${response.statusText}`,\n          response.status,\n          { url, method: requestInit.method || 'GET', attempt: attempt + 1 },\n          `Request failed (status: ${response.status})`,\n          getErrorSuggestion(response.status),\n        )\n\n        if (\n          attempt < retryConfig.maxRetries &&\n          retryConfig.retryableStatuses.includes(response.status)\n        ) {\n          lastError = error\n          const retryDelay = retryConfig.retryDelay(attempt)\n          debugLog(debug, 'error', `Retrying in ${retryDelay}ms...`, error)\n          await delay(retryDelay)\n          continue\n        }\n\n        throw error\n      }\n\n      return response\n    } catch (error) {\n      debugLog(debug, 'error', url, error)\n\n      if (error instanceof Error && error.name === 'AbortError') {\n        const timeoutError = createTimeoutError(\n          `Request timed out after ${timeout}ms.`,\n          { url, timeout, attempt: attempt + 1 },\n          'The request timed out.',\n          'Please check your network connection or try again later.',\n        )\n\n        if (attempt < retryConfig.maxRetries) {\n          lastError = timeoutError\n          await delay(retryConfig.retryDelay(attempt))\n          continue\n        }\n\n        throw timeoutError\n      }\n\n      if (error instanceof TypeError) {\n        const networkError = createNetworkError(\n          'Network connection failed.',\n          undefined,\n          { url, originalError: error.message, attempt: attempt + 1 },\n          'Network connection failed.',\n          'Please check your internet connection and try again.',\n        )\n\n        if (attempt < retryConfig.maxRetries) {\n          lastError = networkError\n          await delay(retryConfig.retryDelay(attempt))\n          continue\n        }\n\n        throw networkError\n      }\n\n      if (error instanceof NetworkError || error instanceof TimeoutError) {\n        if (\n          attempt < retryConfig.maxRetries &&\n          error.status &&\n          !NON_RETRYABLE_STATUSES.includes(error.status) &&\n          retryConfig.retryableStatuses.includes(error.status)\n        ) {\n          lastError = error\n          await delay(retryConfig.retryDelay(attempt))\n          continue\n        }\n\n        throw error\n      }\n\n      const unknownError = createNetworkError(\n        error instanceof Error\n          ? error.message\n          : 'An unknown network error occurred.',\n        undefined,\n        { url, originalError: error, attempt: attempt + 1 },\n        'An unknown error occurred.',\n        'Please try again later.',\n      )\n\n      if (attempt < retryConfig.maxRetries) {\n        lastError = unknownError\n        await delay(retryConfig.retryDelay(attempt))\n        continue\n      }\n\n      throw unknownError\n    }\n  }\n\n  throw lastError!\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,SAAS,WAAW,iBAAiB;AAuC9C,SAAsB,kBACpB,WACA,WACA,YAAoB,MACH;AAAA;AACjB,QAAI,CAAC,aAAa,CAAC,WAAW;AAC5B,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AAEA,UAAM,SAAS,IAAI,YAAY,EAAE,OAAO,SAAS;AACjD,WAAO,IAAI,QAAQ,EAAE,UAAU,CAAC,EAC7B,mBAAmB,EAAE,KAAK,QAAQ,CAAC,EACnC,YAAY,EACZ,kBAAkB,SAAS,EAC3B,KAAK,MAAM;AAAA,EAChB;AAAA;AAgBA,SAAsB,kBACpB,OACA,WACqB;AAAA;AACrB,QAAI,CAAC,SAAS,CAAC,WAAW;AACxB,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACrD;AAEA,UAAM,SAAS,IAAI,YAAY,EAAE,OAAO,SAAS;AACjD,UAAM,EAAE,QAAQ,IAAI,MAAM,UAAU,OAAO,QAAQ;AAAA,MACjD,YAAY,CAAC,OAAO;AAAA,IACtB,CAAC;AAED,QAAI,CAAC,QAAQ,aAAa,OAAO,QAAQ,cAAc,UAAU;AAC/D,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AAEA,WAAO;AAAA,MACL,WAAW,QAAQ;AAAA,MACnB,KAAK,QAAQ;AAAA,MACb,KAAK,QAAQ;AAAA,IACf;AAAA,EACF;AAAA;AAgBO,SAAS,kBAAkB,OAA2B;AAC3D,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,oBAAoB;AAAA,EACtC;AAEA,QAAM,UAAU,UAAU,KAAK;AAE/B,MAAI,CAAC,QAAQ,aAAa,OAAO,QAAQ,cAAc,UAAU;AAC/D,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AAEA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,KAAK,QAAQ;AAAA,IACb,KAAK,QAAQ;AAAA,EACf;AACF;AAoBO,SAAS,aAAa,WAAmB,WAA2B;AACzE,MAAI,CAAC,aAAa,CAAC,WAAW;AAC5B,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AAGA,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO,OAAO,KAAK,GAAG,SAAS,IAAI,SAAS,EAAE,EAAE,SAAS,QAAQ;AAAA,EACnE;AACA,SAAO,KAAK,GAAG,SAAS,IAAI,SAAS,EAAE;AACzC;AAcO,SAAS,YAAY,QAG1B;AACA,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,qBAAqB;AAAA,EACvC;AAEA,MAAI;AACF,QAAI;AACJ,QAAI,OAAO,WAAW,aAAa;AACjC,gBAAU,OAAO,KAAK,QAAQ,QAAQ,EAAE,SAAS,OAAO;AAAA,IAC1D,OAAO;AACL,gBAAU,KAAK,MAAM;AAAA,IACvB;AAEA,UAAM,aAAa,QAAQ,QAAQ,GAAG;AACtC,QAAI,eAAe,IAAI;AACrB,YAAM,IAAI,MAAM,yCAAyC;AAAA,IAC3D;AAEA,UAAM,YAAY,QAAQ,UAAU,GAAG,UAAU;AACjD,UAAM,YAAY,QAAQ,UAAU,aAAa,CAAC;AAElD,QAAI,CAAC,aAAa,CAAC,WAAW;AAC5B,YAAM,IAAI,MAAM,8CAA8C;AAAA,IAChE;AAEA,WAAO,EAAE,WAAW,UAAU;AAAA,EAChC,SAAQ;AACN,UAAM,IAAI,MAAM,gEAAgE;AAAA,EAClF;AACF;","names":[]}

package/dist/components.cjs

@@ -0,0 +1,76 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/index.ts
+var components_exports = {};
+__export(components_exports, {
+  RichTextContent: () => RichTextContent
+});
+module.exports = __toCommonJS(components_exports);
+
+// src/components/RichTextContent/index.tsx
+var import_react = __toESM(require("react"), 1);
+var import_react2 = require("@payloadcms/richtext-lexical/react");
+function RichTextContent({
+  data,
+  className,
+  internalDocToHref,
+  blocks
+}) {
+  return /* @__PURE__ */ import_react.default.createElement(
+    import_react2.RichText,
+    {
+      data,
+      className,
+      converters: __spreadProps(__spreadValues(__spreadValues({}, import_react2.defaultJSXConverters), (0, import_react2.LinkJSXConverter)({
+        internalDocToHref
+      })), {
+        blocks: blocks ? blocks : void 0
+      })
+    }
+  );
+}
+//# sourceMappingURL=components.cjs.map

package/dist/components.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/index.ts","../src/components/RichTextContent/index.tsx"],"sourcesContent":["export * from './RichTextContent'\n","'use client'\n\nimport React from 'react'\nimport {\n  SerializedBlockNode,\n  SerializedLinkNode,\n} from '@payloadcms/richtext-lexical'\nimport {\n  SerializedEditorState,\n  SerializedLexicalNode,\n} from '@payloadcms/richtext-lexical/lexical'\nimport {\n  defaultJSXConverters,\n  JSXConverter,\n  LinkJSXConverter,\n  RichText,\n} from '@payloadcms/richtext-lexical/react'\n\nexport type RichTextData = SerializedEditorState<SerializedLexicalNode>\n\nexport interface RichTextContentProps {\n  data: RichTextData\n  className?: string\n  internalDocToHref?: (args: { linkNode: SerializedLinkNode }) => string\n  blocks?: {\n    Iframe?: JSXConverter<\n      SerializedBlockNode<{\n        blockName?: string | null\n        blockType: string\n        url: string\n      }>\n    >\n    Player?: JSXConverter<\n      SerializedBlockNode<{\n        blockName?: string | null\n        blockType: string\n        url: string\n      }>\n    >\n  }\n}\n\nexport function RichTextContent({\n  data,\n  className,\n  internalDocToHref,\n  blocks,\n}: RichTextContentProps) {\n  return (\n    <RichText\n      data={data}\n      className={className}\n      converters={{\n        ...defaultJSXConverters,\n        ...LinkJSXConverter({\n          internalDocToHref,\n        }),\n        blocks: blocks\n          ? (blocks as Record<\n              string,\n              JSXConverter<\n                SerializedBlockNode<{\n                  blockName?: string | null\n                  blockType: string\n                }>\n              >\n            >)\n          : undefined,\n      }}\n    />\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,mBAAkB;AASlB,IAAAA,gBAKO;AA0BA,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyB;AACvB,SACE,6BAAAC,QAAA;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA,YAAY,gDACP,yCACA,gCAAiB;AAAA,QAClB;AAAA,MACF,CAAC,IAJS;AAAA,QAKV,QAAQ,SACH,SASD;AAAA,MACN;AAAA;AAAA,EACF;AAEJ;","names":["import_react","React"]}