npm - @djvlc/openapi-user-client - Versions diffs - 1.3.0 → 1.5.0 - Mend

@djvlc/openapi-user-client 1.3.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -1,3 +1,6 @@
+import { BaseClientOptions, Configuration as Configuration$1 } from '@djvlc/openapi-client-core';
+export { AbortError, Configuration, DjvApiError, Interceptors, Logger, Middleware, NetworkError, RequestOptions, RetryOptions, TimeoutError, createConsoleLogger, createSilentLogger, isRetryableError } from '@djvlc/openapi-client-core';
 interface ConfigurationParameters {
     basePath?: string;
     fetchApi?: FetchAPI;
@@ -2534,33 +2537,107 @@ declare namespace apis {
   export { apis_ActionApi as ActionApi, type apis_ActionApiExecuteActionBatchOperationRequest as ActionApiExecuteActionBatchOperationRequest, type apis_ActionApiExecuteActionRequest as ActionApiExecuteActionRequest, type apis_ActionApiInterface as ActionApiInterface, apis_ActivityApi as ActivityApi, type apis_ActivityApiGetActivityStateBatchOperationRequest as ActivityApiGetActivityStateBatchOperationRequest, type apis_ActivityApiGetActivityStateRequest as ActivityApiGetActivityStateRequest, type apis_ActivityApiInterface as ActivityApiInterface, apis_DataApi as DataApi, type apis_DataApiInterface as DataApiInterface, type apis_DataApiQueryDataBatchOperationRequest as DataApiQueryDataBatchOperationRequest, type apis_DataApiQueryDataRequest as DataApiQueryDataRequest, apis_HealthApi as HealthApi, type apis_HealthApiInterface as HealthApiInterface, apis_PageApi as PageApi, type apis_PageApiInterface as PageApiInterface, type apis_PageApiResolvePageBatchOperationRequest as PageApiResolvePageBatchOperationRequest, type apis_PageApiResolvePageRequest as PageApiResolvePageRequest, type apis_ResolvePageChannelEnum as ResolvePageChannelEnum, apis_TrackApi as TrackApi, type apis_TrackApiInterface as TrackApiInterface, type apis_TrackApiTrackOperationRequest as TrackApiTrackOperationRequest };
 }
-interface UserClientOptions {
+/**
+ * @djvlc/openapi-user-client - User API 客户端
+ *
+ * 用于 Runtime 访问 User API（数据面）。
+ *
+ * @example
+ * ```typescript
+ * import { createUserClient, DjvApiError, TimeoutError } from '@djvlc/openapi-user-client';
+ *
+ * const client = createUserClient({
+ *   baseUrl: 'https://api.example.com',
+ *   getAuthToken: () => localStorage.getItem('token') ?? '',
+ *   getTraceHeaders: () => ({ traceparent: '00-...' }),
+ *   retry: { maxRetries: 2 },
+ * });
+ *
+ * try {
+ *   const page = await client.PageApi.resolvePage({ pageUid: 'xxx' });
+ * } catch (e) {
+ *   if (DjvApiError.is(e)) {
+ *     console.log('业务错误:', e.code, e.traceId);
+ *   } else if (TimeoutError.is(e)) {
+ *     console.log('请求超时');
+ *   }
+ * }
+ * ```
+ */
+interface UserClientOptions extends Omit<BaseClientOptions, 'baseUrl'> {
+    /** API 基础 URL */
     baseUrl: string;
-    /** user-api 可能需要登录态 token（也可能不需要） */
+    /**
+     * 获取认证 Token
+     *
+     * User API 可能需要登录态（也可能不需要）
+     */
     getAuthToken?: () => string | Promise<string>;
-    /** OTel：traceparent/baggage/... */
+    /**
+     * 获取追踪头
+     *
+     * OpenTelemetry: traceparent, baggage 等
+     */
     getTraceHeaders?: () => Record<string, string>;
-    /** 比如 x-app-key / x-tenant-id / x-device-id */
+    /**
+     * 默认请求头
+     *
+     * 如 x-device-id, x-channel, x-app-key 等
+     */
     defaultHeaders?: Record<string, string>;
-    /** 默认 15s（线上 user-api 通常更追求快失败） */
+    /**
+     * 超时时间（毫秒）
+     *
+     * @default 15000 (User API 追求快失败)
+     */
     timeoutMs?: number;
-    fetchApi?: typeof fetch;
-    /** 默认 omit（通常不走 cookie） */
+    /**
+     * Cookie 策略
+     *
+     * @default 'omit' (User API 通常不走 Cookie)
+     */
     credentials?: RequestCredentials;
 }
-type ApiInstances = {
-    [K in keyof typeof apis as K extends `${string}Api` ? (typeof apis)[K] extends new (...args: any) => any ? K : never : never]: (typeof apis)[K] extends new (...args: any) => any ? InstanceType<(typeof apis)[K]> : never;
+type ApiClasses = typeof apis;
+type ApiInstanceMap = {
+    [K in keyof ApiClasses as K extends `${string}Api` ? ApiClasses[K] extends new (...args: unknown[]) => unknown ? K : never : never]: ApiClasses[K] extends new (...args: unknown[]) => infer T ? T : never;
 };
+/**
+ * 创建 User API 客户端
+ *
+ * @param opts - 客户端配置
+ * @returns 包含所有 API 实例的客户端对象
+ *
+ * @example
+ * ```typescript
+ * const client = createUserClient({
+ *   baseUrl: 'https://api.example.com',
+ *   getAuthToken: () => getToken(),
+ *   defaultHeaders: {
+ *     'x-device-id': deviceId,
+ *     'x-channel': 'h5',
+ *   },
+ *   retry: { maxRetries: 2 },
+ * });
+ *
+ * // 解析页面
+ * const page = await client.PageApi.resolvePage({ pageUid: 'xxx' });
+ *
+ * // 执行动作
+ * const result = await client.ActionsApi.executeAction({
+ *   actionExecuteRequest: {
+ *     actionType: 'claim',
+ *     params: { activityId: 'xxx' },
+ *     context: {},
+ *   },
+ * });
+ * ```
+ */
 declare function createUserClient(opts: UserClientOptions): {
-    ActionApi: ActionApi;
-    ActivityApi: ActivityApi;
-    DataApi: DataApi;
-    HealthApi: HealthApi;
-    PageApi: PageApi;
-    TrackApi: TrackApi;
-    config: Configuration;
-    apis: ApiInstances;
-};
+    config: Configuration$1;
+    apis: ApiInstanceMap;
+} & ApiInstanceMap;
 type UserClient = ReturnType<typeof createUserClient>;
-export { ActionApi, type ActionApiExecuteActionBatchOperationRequest, type ActionApiExecuteActionRequest, type ActionApiInterface, type ActionContext, ActionContextFromJSON, ActionContextFromJSONTyped, ActionContextToJSON, ActionContextToJSONTyped, type ActionExecuteRequest, ActionExecuteRequestFromJSON, ActionExecuteRequestFromJSONTyped, ActionExecuteRequestToJSON, ActionExecuteRequestToJSONTyped, type ActionExecuteResponse, ActionExecuteResponseFromJSON, ActionExecuteResponseFromJSONTyped, ActionExecuteResponseToJSON, ActionExecuteResponseToJSONTyped, ActivityApi, type ActivityApiGetActivityStateBatchOperationRequest, type ActivityApiGetActivityStateRequest, type ActivityApiInterface, type ActivityState, type ActivityStateActivityInfo, ActivityStateActivityInfoFromJSON, ActivityStateActivityInfoFromJSONTyped, ActivityStateActivityInfoToJSON, ActivityStateActivityInfoToJSONTyped, ActivityStateFromJSON, ActivityStateFromJSONTyped, type ActivityStateResponse, ActivityStateResponseFromJSON, ActivityStateResponseFromJSONTyped, ActivityStateResponseToJSON, ActivityStateResponseToJSONTyped, ActivityStateStatusEnum, ActivityStateToJSON, ActivityStateToJSONTyped, type BaseResponseVo, BaseResponseVoFromJSON, BaseResponseVoFromJSONTyped, BaseResponseVoToJSON, BaseResponseVoToJSONTyped, type BlockedComponent, BlockedComponentFromJSON, BlockedComponentFromJSONTyped, BlockedComponentToJSON, BlockedComponentToJSONTyped, Configuration, DataApi, type DataApiInterface, type DataApiQueryDataBatchOperationRequest, type DataApiQueryDataRequest, type DataQueryContext, DataQueryContextFromJSON, DataQueryContextFromJSONTyped, DataQueryContextToJSON, DataQueryContextToJSONTyped, type DataQueryRequest, DataQueryRequestFromJSON, DataQueryRequestFromJSONTyped, DataQueryRequestToJSON, DataQueryRequestToJSONTyped, type DataQueryResponse, DataQueryResponseFromJSON, DataQueryResponseFromJSONTyped, DataQueryResponseToJSON, DataQueryResponseToJSONTyped, type ErrorDetail, ErrorDetailFromJSON, ErrorDetailFromJSONTyped, ErrorDetailToJSON, ErrorDetailToJSONTyped, type ErrorResponseVo, ErrorResponseVoFromJSON, ErrorResponseVoFromJSONTyped, ErrorResponseVoToJSON, ErrorResponseVoToJSONTyped, type ExecuteActionBatch200Response, ExecuteActionBatch200ResponseFromJSON, ExecuteActionBatch200ResponseFromJSONTyped, ExecuteActionBatch200ResponseToJSON, ExecuteActionBatch200ResponseToJSONTyped, type ExecuteActionBatchRequest, ExecuteActionBatchRequestFromJSON, ExecuteActionBatchRequestFromJSONTyped, ExecuteActionBatchRequestToJSON, ExecuteActionBatchRequestToJSONTyped, type GetActivityStateBatch200Response, GetActivityStateBatch200ResponseFromJSON, GetActivityStateBatch200ResponseFromJSONTyped, GetActivityStateBatch200ResponseToJSON, GetActivityStateBatch200ResponseToJSONTyped, type GetActivityStateBatchRequest, GetActivityStateBatchRequestFromJSON, GetActivityStateBatchRequestFromJSONTyped, GetActivityStateBatchRequestToJSON, GetActivityStateBatchRequestToJSONTyped, HealthApi, type HealthApiInterface, type HealthResponse, type HealthResponseChecksValue, HealthResponseChecksValueFromJSON, HealthResponseChecksValueFromJSONTyped, HealthResponseChecksValueToJSON, HealthResponseChecksValueToJSONTyped, HealthResponseFromJSON, HealthResponseFromJSONTyped, HealthResponseStatusEnum, HealthResponseToJSON, HealthResponseToJSONTyped, type ManifestItem, ManifestItemFromJSON, ManifestItemFromJSONTyped, ManifestItemToJSON, ManifestItemToJSONTyped, PageApi, type PageApiInterface, type PageApiResolvePageBatchOperationRequest, type PageApiResolvePageRequest, type PageManifest, PageManifestFromJSON, PageManifestFromJSONTyped, PageManifestToJSON, PageManifestToJSONTyped, type PageResolveResponse, PageResolveResponseFromJSON, PageResolveResponseFromJSONTyped, PageResolveResponseToJSON, PageResolveResponseToJSONTyped, type PageResolveResult, PageResolveResultFromJSON, PageResolveResultFromJSONTyped, PageResolveResultToJSON, PageResolveResultToJSONTyped, type QueryDataBatch200Response, QueryDataBatch200ResponseFromJSON, QueryDataBatch200ResponseFromJSONTyped, QueryDataBatch200ResponseToJSON, QueryDataBatch200ResponseToJSONTyped, type QueryDataBatchRequest, QueryDataBatchRequestFromJSON, QueryDataBatchRequestFromJSONTyped, QueryDataBatchRequestToJSON, QueryDataBatchRequestToJSONTyped, type ResolvePageBatch200Response, ResolvePageBatch200ResponseFromJSON, ResolvePageBatch200ResponseFromJSONTyped, ResolvePageBatch200ResponseToJSON, ResolvePageBatch200ResponseToJSONTyped, type ResolvePageBatchRequest, ResolvePageBatchRequestChannelEnum, ResolvePageBatchRequestFromJSON, ResolvePageBatchRequestFromJSONTyped, ResolvePageBatchRequestToJSON, ResolvePageBatchRequestToJSONTyped, ResolvePageChannelEnum, type RuntimeConfig, RuntimeConfigFromJSON, RuntimeConfigFromJSONTyped, type RuntimeConfigReportConfig, RuntimeConfigReportConfigFromJSON, RuntimeConfigReportConfigFromJSONTyped, RuntimeConfigReportConfigToJSON, RuntimeConfigReportConfigToJSONTyped, RuntimeConfigToJSON, RuntimeConfigToJSONTyped, type TraceContext, TraceContextFromJSON, TraceContextFromJSONTyped, TraceContextToJSON, TraceContextToJSONTyped, TrackApi, type TrackApiInterface, type TrackApiTrackOperationRequest, type TrackContext, TrackContextFromJSON, TrackContextFromJSONTyped, TrackContextToJSON, TrackContextToJSONTyped, type TrackEvent, TrackEventEventTypeEnum, TrackEventFromJSON, TrackEventFromJSONTyped, TrackEventToJSON, TrackEventToJSONTyped, type TrackRequest, TrackRequestFromJSON, TrackRequestFromJSONTyped, TrackRequestToJSON, TrackRequestToJSONTyped, type UserActivityState, UserActivityStateFromJSON, UserActivityStateFromJSONTyped, type UserActivityStateProgress, UserActivityStateProgressFromJSON, UserActivityStateProgressFromJSONTyped, UserActivityStateProgressToJSON, UserActivityStateProgressToJSONTyped, UserActivityStateToJSON, UserActivityStateToJSONTyped, type UserClient, type UserClientOptions, createUserClient, instanceOfActionContext, instanceOfActionExecuteRequest, instanceOfActionExecuteResponse, instanceOfActivityState, instanceOfActivityStateActivityInfo, instanceOfActivityStateResponse, instanceOfBaseResponseVo, instanceOfBlockedComponent, instanceOfDataQueryContext, instanceOfDataQueryRequest, instanceOfDataQueryResponse, instanceOfErrorDetail, instanceOfErrorResponseVo, instanceOfExecuteActionBatch200Response, instanceOfExecuteActionBatchRequest, instanceOfGetActivityStateBatch200Response, instanceOfGetActivityStateBatchRequest, instanceOfHealthResponse, instanceOfHealthResponseChecksValue, instanceOfManifestItem, instanceOfPageManifest, instanceOfPageResolveResponse, instanceOfPageResolveResult, instanceOfQueryDataBatch200Response, instanceOfQueryDataBatchRequest, instanceOfResolvePageBatch200Response, instanceOfResolvePageBatchRequest, instanceOfRuntimeConfig, instanceOfRuntimeConfigReportConfig, instanceOfTraceContext, instanceOfTrackContext, instanceOfTrackEvent, instanceOfTrackRequest, instanceOfUserActivityState, instanceOfUserActivityStateProgress };
+export { ActionApi, type ActionApiExecuteActionBatchOperationRequest, type ActionApiExecuteActionRequest, type ActionApiInterface, type ActionContext, ActionContextFromJSON, ActionContextFromJSONTyped, ActionContextToJSON, ActionContextToJSONTyped, type ActionExecuteRequest, ActionExecuteRequestFromJSON, ActionExecuteRequestFromJSONTyped, ActionExecuteRequestToJSON, ActionExecuteRequestToJSONTyped, type ActionExecuteResponse, ActionExecuteResponseFromJSON, ActionExecuteResponseFromJSONTyped, ActionExecuteResponseToJSON, ActionExecuteResponseToJSONTyped, ActivityApi, type ActivityApiGetActivityStateBatchOperationRequest, type ActivityApiGetActivityStateRequest, type ActivityApiInterface, type ActivityState, type ActivityStateActivityInfo, ActivityStateActivityInfoFromJSON, ActivityStateActivityInfoFromJSONTyped, ActivityStateActivityInfoToJSON, ActivityStateActivityInfoToJSONTyped, ActivityStateFromJSON, ActivityStateFromJSONTyped, type ActivityStateResponse, ActivityStateResponseFromJSON, ActivityStateResponseFromJSONTyped, ActivityStateResponseToJSON, ActivityStateResponseToJSONTyped, ActivityStateStatusEnum, ActivityStateToJSON, ActivityStateToJSONTyped, type BaseResponseVo, BaseResponseVoFromJSON, BaseResponseVoFromJSONTyped, BaseResponseVoToJSON, BaseResponseVoToJSONTyped, type BlockedComponent, BlockedComponentFromJSON, BlockedComponentFromJSONTyped, BlockedComponentToJSON, BlockedComponentToJSONTyped, DataApi, type DataApiInterface, type DataApiQueryDataBatchOperationRequest, type DataApiQueryDataRequest, type DataQueryContext, DataQueryContextFromJSON, DataQueryContextFromJSONTyped, DataQueryContextToJSON, DataQueryContextToJSONTyped, type DataQueryRequest, DataQueryRequestFromJSON, DataQueryRequestFromJSONTyped, DataQueryRequestToJSON, DataQueryRequestToJSONTyped, type DataQueryResponse, DataQueryResponseFromJSON, DataQueryResponseFromJSONTyped, DataQueryResponseToJSON, DataQueryResponseToJSONTyped, type ErrorDetail, ErrorDetailFromJSON, ErrorDetailFromJSONTyped, ErrorDetailToJSON, ErrorDetailToJSONTyped, type ErrorResponseVo, ErrorResponseVoFromJSON, ErrorResponseVoFromJSONTyped, ErrorResponseVoToJSON, ErrorResponseVoToJSONTyped, type ExecuteActionBatch200Response, ExecuteActionBatch200ResponseFromJSON, ExecuteActionBatch200ResponseFromJSONTyped, ExecuteActionBatch200ResponseToJSON, ExecuteActionBatch200ResponseToJSONTyped, type ExecuteActionBatchRequest, ExecuteActionBatchRequestFromJSON, ExecuteActionBatchRequestFromJSONTyped, ExecuteActionBatchRequestToJSON, ExecuteActionBatchRequestToJSONTyped, type GetActivityStateBatch200Response, GetActivityStateBatch200ResponseFromJSON, GetActivityStateBatch200ResponseFromJSONTyped, GetActivityStateBatch200ResponseToJSON, GetActivityStateBatch200ResponseToJSONTyped, type GetActivityStateBatchRequest, GetActivityStateBatchRequestFromJSON, GetActivityStateBatchRequestFromJSONTyped, GetActivityStateBatchRequestToJSON, GetActivityStateBatchRequestToJSONTyped, HealthApi, type HealthApiInterface, type HealthResponse, type HealthResponseChecksValue, HealthResponseChecksValueFromJSON, HealthResponseChecksValueFromJSONTyped, HealthResponseChecksValueToJSON, HealthResponseChecksValueToJSONTyped, HealthResponseFromJSON, HealthResponseFromJSONTyped, HealthResponseStatusEnum, HealthResponseToJSON, HealthResponseToJSONTyped, type ManifestItem, ManifestItemFromJSON, ManifestItemFromJSONTyped, ManifestItemToJSON, ManifestItemToJSONTyped, PageApi, type PageApiInterface, type PageApiResolvePageBatchOperationRequest, type PageApiResolvePageRequest, type PageManifest, PageManifestFromJSON, PageManifestFromJSONTyped, PageManifestToJSON, PageManifestToJSONTyped, type PageResolveResponse, PageResolveResponseFromJSON, PageResolveResponseFromJSONTyped, PageResolveResponseToJSON, PageResolveResponseToJSONTyped, type PageResolveResult, PageResolveResultFromJSON, PageResolveResultFromJSONTyped, PageResolveResultToJSON, PageResolveResultToJSONTyped, type QueryDataBatch200Response, QueryDataBatch200ResponseFromJSON, QueryDataBatch200ResponseFromJSONTyped, QueryDataBatch200ResponseToJSON, QueryDataBatch200ResponseToJSONTyped, type QueryDataBatchRequest, QueryDataBatchRequestFromJSON, QueryDataBatchRequestFromJSONTyped, QueryDataBatchRequestToJSON, QueryDataBatchRequestToJSONTyped, type ResolvePageBatch200Response, ResolvePageBatch200ResponseFromJSON, ResolvePageBatch200ResponseFromJSONTyped, ResolvePageBatch200ResponseToJSON, ResolvePageBatch200ResponseToJSONTyped, type ResolvePageBatchRequest, ResolvePageBatchRequestChannelEnum, ResolvePageBatchRequestFromJSON, ResolvePageBatchRequestFromJSONTyped, ResolvePageBatchRequestToJSON, ResolvePageBatchRequestToJSONTyped, ResolvePageChannelEnum, type RuntimeConfig, RuntimeConfigFromJSON, RuntimeConfigFromJSONTyped, type RuntimeConfigReportConfig, RuntimeConfigReportConfigFromJSON, RuntimeConfigReportConfigFromJSONTyped, RuntimeConfigReportConfigToJSON, RuntimeConfigReportConfigToJSONTyped, RuntimeConfigToJSON, RuntimeConfigToJSONTyped, type TraceContext, TraceContextFromJSON, TraceContextFromJSONTyped, TraceContextToJSON, TraceContextToJSONTyped, TrackApi, type TrackApiInterface, type TrackApiTrackOperationRequest, type TrackContext, TrackContextFromJSON, TrackContextFromJSONTyped, TrackContextToJSON, TrackContextToJSONTyped, type TrackEvent, TrackEventEventTypeEnum, TrackEventFromJSON, TrackEventFromJSONTyped, TrackEventToJSON, TrackEventToJSONTyped, type TrackRequest, TrackRequestFromJSON, TrackRequestFromJSONTyped, TrackRequestToJSON, TrackRequestToJSONTyped, type UserActivityState, UserActivityStateFromJSON, UserActivityStateFromJSONTyped, type UserActivityStateProgress, UserActivityStateProgressFromJSON, UserActivityStateProgressFromJSONTyped, UserActivityStateProgressToJSON, UserActivityStateProgressToJSONTyped, UserActivityStateToJSON, UserActivityStateToJSONTyped, type UserClient, type UserClientOptions, createUserClient, instanceOfActionContext, instanceOfActionExecuteRequest, instanceOfActionExecuteResponse, instanceOfActivityState, instanceOfActivityStateActivityInfo, instanceOfActivityStateResponse, instanceOfBaseResponseVo, instanceOfBlockedComponent, instanceOfDataQueryContext, instanceOfDataQueryRequest, instanceOfDataQueryResponse, instanceOfErrorDetail, instanceOfErrorResponseVo, instanceOfExecuteActionBatch200Response, instanceOfExecuteActionBatchRequest, instanceOfGetActivityStateBatch200Response, instanceOfGetActivityStateBatchRequest, instanceOfHealthResponse, instanceOfHealthResponseChecksValue, instanceOfManifestItem, instanceOfPageManifest, instanceOfPageResolveResponse, instanceOfPageResolveResult, instanceOfQueryDataBatch200Response, instanceOfQueryDataBatchRequest, instanceOfResolvePageBatch200Response, instanceOfResolvePageBatchRequest, instanceOfRuntimeConfig, instanceOfRuntimeConfigReportConfig, instanceOfTraceContext, instanceOfTrackContext, instanceOfTrackEvent, instanceOfTrackRequest, instanceOfUserActivityState, instanceOfUserActivityStateProgress };

package/dist/index.d.ts CHANGED Viewed

@@ -1,3 +1,6 @@
+import { BaseClientOptions, Configuration as Configuration$1 } from '@djvlc/openapi-client-core';
+export { AbortError, Configuration, DjvApiError, Interceptors, Logger, Middleware, NetworkError, RequestOptions, RetryOptions, TimeoutError, createConsoleLogger, createSilentLogger, isRetryableError } from '@djvlc/openapi-client-core';
 interface ConfigurationParameters {
     basePath?: string;
     fetchApi?: FetchAPI;
@@ -2534,33 +2537,107 @@ declare namespace apis {
   export { apis_ActionApi as ActionApi, type apis_ActionApiExecuteActionBatchOperationRequest as ActionApiExecuteActionBatchOperationRequest, type apis_ActionApiExecuteActionRequest as ActionApiExecuteActionRequest, type apis_ActionApiInterface as ActionApiInterface, apis_ActivityApi as ActivityApi, type apis_ActivityApiGetActivityStateBatchOperationRequest as ActivityApiGetActivityStateBatchOperationRequest, type apis_ActivityApiGetActivityStateRequest as ActivityApiGetActivityStateRequest, type apis_ActivityApiInterface as ActivityApiInterface, apis_DataApi as DataApi, type apis_DataApiInterface as DataApiInterface, type apis_DataApiQueryDataBatchOperationRequest as DataApiQueryDataBatchOperationRequest, type apis_DataApiQueryDataRequest as DataApiQueryDataRequest, apis_HealthApi as HealthApi, type apis_HealthApiInterface as HealthApiInterface, apis_PageApi as PageApi, type apis_PageApiInterface as PageApiInterface, type apis_PageApiResolvePageBatchOperationRequest as PageApiResolvePageBatchOperationRequest, type apis_PageApiResolvePageRequest as PageApiResolvePageRequest, type apis_ResolvePageChannelEnum as ResolvePageChannelEnum, apis_TrackApi as TrackApi, type apis_TrackApiInterface as TrackApiInterface, type apis_TrackApiTrackOperationRequest as TrackApiTrackOperationRequest };
 }
-interface UserClientOptions {
+/**
+ * @djvlc/openapi-user-client - User API 客户端
+ *
+ * 用于 Runtime 访问 User API（数据面）。
+ *
+ * @example
+ * ```typescript
+ * import { createUserClient, DjvApiError, TimeoutError } from '@djvlc/openapi-user-client';
+ *
+ * const client = createUserClient({
+ *   baseUrl: 'https://api.example.com',
+ *   getAuthToken: () => localStorage.getItem('token') ?? '',
+ *   getTraceHeaders: () => ({ traceparent: '00-...' }),
+ *   retry: { maxRetries: 2 },
+ * });
+ *
+ * try {
+ *   const page = await client.PageApi.resolvePage({ pageUid: 'xxx' });
+ * } catch (e) {
+ *   if (DjvApiError.is(e)) {
+ *     console.log('业务错误:', e.code, e.traceId);
+ *   } else if (TimeoutError.is(e)) {
+ *     console.log('请求超时');
+ *   }
+ * }
+ * ```
+ */
+interface UserClientOptions extends Omit<BaseClientOptions, 'baseUrl'> {
+    /** API 基础 URL */
     baseUrl: string;
-    /** user-api 可能需要登录态 token（也可能不需要） */
+    /**
+     * 获取认证 Token
+     *
+     * User API 可能需要登录态（也可能不需要）
+     */
     getAuthToken?: () => string | Promise<string>;
-    /** OTel：traceparent/baggage/... */
+    /**
+     * 获取追踪头
+     *
+     * OpenTelemetry: traceparent, baggage 等
+     */
     getTraceHeaders?: () => Record<string, string>;
-    /** 比如 x-app-key / x-tenant-id / x-device-id */
+    /**
+     * 默认请求头
+     *
+     * 如 x-device-id, x-channel, x-app-key 等
+     */
     defaultHeaders?: Record<string, string>;
-    /** 默认 15s（线上 user-api 通常更追求快失败） */
+    /**
+     * 超时时间（毫秒）
+     *
+     * @default 15000 (User API 追求快失败)
+     */
     timeoutMs?: number;
-    fetchApi?: typeof fetch;
-    /** 默认 omit（通常不走 cookie） */
+    /**
+     * Cookie 策略
+     *
+     * @default 'omit' (User API 通常不走 Cookie)
+     */
     credentials?: RequestCredentials;
 }
-type ApiInstances = {
-    [K in keyof typeof apis as K extends `${string}Api` ? (typeof apis)[K] extends new (...args: any) => any ? K : never : never]: (typeof apis)[K] extends new (...args: any) => any ? InstanceType<(typeof apis)[K]> : never;
+type ApiClasses = typeof apis;
+type ApiInstanceMap = {
+    [K in keyof ApiClasses as K extends `${string}Api` ? ApiClasses[K] extends new (...args: unknown[]) => unknown ? K : never : never]: ApiClasses[K] extends new (...args: unknown[]) => infer T ? T : never;
 };
+/**
+ * 创建 User API 客户端
+ *
+ * @param opts - 客户端配置
+ * @returns 包含所有 API 实例的客户端对象
+ *
+ * @example
+ * ```typescript
+ * const client = createUserClient({
+ *   baseUrl: 'https://api.example.com',
+ *   getAuthToken: () => getToken(),
+ *   defaultHeaders: {
+ *     'x-device-id': deviceId,
+ *     'x-channel': 'h5',
+ *   },
+ *   retry: { maxRetries: 2 },
+ * });
+ *
+ * // 解析页面
+ * const page = await client.PageApi.resolvePage({ pageUid: 'xxx' });
+ *
+ * // 执行动作
+ * const result = await client.ActionsApi.executeAction({
+ *   actionExecuteRequest: {
+ *     actionType: 'claim',
+ *     params: { activityId: 'xxx' },
+ *     context: {},
+ *   },
+ * });
+ * ```
+ */
 declare function createUserClient(opts: UserClientOptions): {
-    ActionApi: ActionApi;
-    ActivityApi: ActivityApi;
-    DataApi: DataApi;
-    HealthApi: HealthApi;
-    PageApi: PageApi;
-    TrackApi: TrackApi;
-    config: Configuration;
-    apis: ApiInstances;
-};
+    config: Configuration$1;
+    apis: ApiInstanceMap;
+} & ApiInstanceMap;
 type UserClient = ReturnType<typeof createUserClient>;
-export { ActionApi, type ActionApiExecuteActionBatchOperationRequest, type ActionApiExecuteActionRequest, type ActionApiInterface, type ActionContext, ActionContextFromJSON, ActionContextFromJSONTyped, ActionContextToJSON, ActionContextToJSONTyped, type ActionExecuteRequest, ActionExecuteRequestFromJSON, ActionExecuteRequestFromJSONTyped, ActionExecuteRequestToJSON, ActionExecuteRequestToJSONTyped, type ActionExecuteResponse, ActionExecuteResponseFromJSON, ActionExecuteResponseFromJSONTyped, ActionExecuteResponseToJSON, ActionExecuteResponseToJSONTyped, ActivityApi, type ActivityApiGetActivityStateBatchOperationRequest, type ActivityApiGetActivityStateRequest, type ActivityApiInterface, type ActivityState, type ActivityStateActivityInfo, ActivityStateActivityInfoFromJSON, ActivityStateActivityInfoFromJSONTyped, ActivityStateActivityInfoToJSON, ActivityStateActivityInfoToJSONTyped, ActivityStateFromJSON, ActivityStateFromJSONTyped, type ActivityStateResponse, ActivityStateResponseFromJSON, ActivityStateResponseFromJSONTyped, ActivityStateResponseToJSON, ActivityStateResponseToJSONTyped, ActivityStateStatusEnum, ActivityStateToJSON, ActivityStateToJSONTyped, type BaseResponseVo, BaseResponseVoFromJSON, BaseResponseVoFromJSONTyped, BaseResponseVoToJSON, BaseResponseVoToJSONTyped, type BlockedComponent, BlockedComponentFromJSON, BlockedComponentFromJSONTyped, BlockedComponentToJSON, BlockedComponentToJSONTyped, Configuration, DataApi, type DataApiInterface, type DataApiQueryDataBatchOperationRequest, type DataApiQueryDataRequest, type DataQueryContext, DataQueryContextFromJSON, DataQueryContextFromJSONTyped, DataQueryContextToJSON, DataQueryContextToJSONTyped, type DataQueryRequest, DataQueryRequestFromJSON, DataQueryRequestFromJSONTyped, DataQueryRequestToJSON, DataQueryRequestToJSONTyped, type DataQueryResponse, DataQueryResponseFromJSON, DataQueryResponseFromJSONTyped, DataQueryResponseToJSON, DataQueryResponseToJSONTyped, type ErrorDetail, ErrorDetailFromJSON, ErrorDetailFromJSONTyped, ErrorDetailToJSON, ErrorDetailToJSONTyped, type ErrorResponseVo, ErrorResponseVoFromJSON, ErrorResponseVoFromJSONTyped, ErrorResponseVoToJSON, ErrorResponseVoToJSONTyped, type ExecuteActionBatch200Response, ExecuteActionBatch200ResponseFromJSON, ExecuteActionBatch200ResponseFromJSONTyped, ExecuteActionBatch200ResponseToJSON, ExecuteActionBatch200ResponseToJSONTyped, type ExecuteActionBatchRequest, ExecuteActionBatchRequestFromJSON, ExecuteActionBatchRequestFromJSONTyped, ExecuteActionBatchRequestToJSON, ExecuteActionBatchRequestToJSONTyped, type GetActivityStateBatch200Response, GetActivityStateBatch200ResponseFromJSON, GetActivityStateBatch200ResponseFromJSONTyped, GetActivityStateBatch200ResponseToJSON, GetActivityStateBatch200ResponseToJSONTyped, type GetActivityStateBatchRequest, GetActivityStateBatchRequestFromJSON, GetActivityStateBatchRequestFromJSONTyped, GetActivityStateBatchRequestToJSON, GetActivityStateBatchRequestToJSONTyped, HealthApi, type HealthApiInterface, type HealthResponse, type HealthResponseChecksValue, HealthResponseChecksValueFromJSON, HealthResponseChecksValueFromJSONTyped, HealthResponseChecksValueToJSON, HealthResponseChecksValueToJSONTyped, HealthResponseFromJSON, HealthResponseFromJSONTyped, HealthResponseStatusEnum, HealthResponseToJSON, HealthResponseToJSONTyped, type ManifestItem, ManifestItemFromJSON, ManifestItemFromJSONTyped, ManifestItemToJSON, ManifestItemToJSONTyped, PageApi, type PageApiInterface, type PageApiResolvePageBatchOperationRequest, type PageApiResolvePageRequest, type PageManifest, PageManifestFromJSON, PageManifestFromJSONTyped, PageManifestToJSON, PageManifestToJSONTyped, type PageResolveResponse, PageResolveResponseFromJSON, PageResolveResponseFromJSONTyped, PageResolveResponseToJSON, PageResolveResponseToJSONTyped, type PageResolveResult, PageResolveResultFromJSON, PageResolveResultFromJSONTyped, PageResolveResultToJSON, PageResolveResultToJSONTyped, type QueryDataBatch200Response, QueryDataBatch200ResponseFromJSON, QueryDataBatch200ResponseFromJSONTyped, QueryDataBatch200ResponseToJSON, QueryDataBatch200ResponseToJSONTyped, type QueryDataBatchRequest, QueryDataBatchRequestFromJSON, QueryDataBatchRequestFromJSONTyped, QueryDataBatchRequestToJSON, QueryDataBatchRequestToJSONTyped, type ResolvePageBatch200Response, ResolvePageBatch200ResponseFromJSON, ResolvePageBatch200ResponseFromJSONTyped, ResolvePageBatch200ResponseToJSON, ResolvePageBatch200ResponseToJSONTyped, type ResolvePageBatchRequest, ResolvePageBatchRequestChannelEnum, ResolvePageBatchRequestFromJSON, ResolvePageBatchRequestFromJSONTyped, ResolvePageBatchRequestToJSON, ResolvePageBatchRequestToJSONTyped, ResolvePageChannelEnum, type RuntimeConfig, RuntimeConfigFromJSON, RuntimeConfigFromJSONTyped, type RuntimeConfigReportConfig, RuntimeConfigReportConfigFromJSON, RuntimeConfigReportConfigFromJSONTyped, RuntimeConfigReportConfigToJSON, RuntimeConfigReportConfigToJSONTyped, RuntimeConfigToJSON, RuntimeConfigToJSONTyped, type TraceContext, TraceContextFromJSON, TraceContextFromJSONTyped, TraceContextToJSON, TraceContextToJSONTyped, TrackApi, type TrackApiInterface, type TrackApiTrackOperationRequest, type TrackContext, TrackContextFromJSON, TrackContextFromJSONTyped, TrackContextToJSON, TrackContextToJSONTyped, type TrackEvent, TrackEventEventTypeEnum, TrackEventFromJSON, TrackEventFromJSONTyped, TrackEventToJSON, TrackEventToJSONTyped, type TrackRequest, TrackRequestFromJSON, TrackRequestFromJSONTyped, TrackRequestToJSON, TrackRequestToJSONTyped, type UserActivityState, UserActivityStateFromJSON, UserActivityStateFromJSONTyped, type UserActivityStateProgress, UserActivityStateProgressFromJSON, UserActivityStateProgressFromJSONTyped, UserActivityStateProgressToJSON, UserActivityStateProgressToJSONTyped, UserActivityStateToJSON, UserActivityStateToJSONTyped, type UserClient, type UserClientOptions, createUserClient, instanceOfActionContext, instanceOfActionExecuteRequest, instanceOfActionExecuteResponse, instanceOfActivityState, instanceOfActivityStateActivityInfo, instanceOfActivityStateResponse, instanceOfBaseResponseVo, instanceOfBlockedComponent, instanceOfDataQueryContext, instanceOfDataQueryRequest, instanceOfDataQueryResponse, instanceOfErrorDetail, instanceOfErrorResponseVo, instanceOfExecuteActionBatch200Response, instanceOfExecuteActionBatchRequest, instanceOfGetActivityStateBatch200Response, instanceOfGetActivityStateBatchRequest, instanceOfHealthResponse, instanceOfHealthResponseChecksValue, instanceOfManifestItem, instanceOfPageManifest, instanceOfPageResolveResponse, instanceOfPageResolveResult, instanceOfQueryDataBatch200Response, instanceOfQueryDataBatchRequest, instanceOfResolvePageBatch200Response, instanceOfResolvePageBatchRequest, instanceOfRuntimeConfig, instanceOfRuntimeConfigReportConfig, instanceOfTraceContext, instanceOfTrackContext, instanceOfTrackEvent, instanceOfTrackRequest, instanceOfUserActivityState, instanceOfUserActivityStateProgress };
+export { ActionApi, type ActionApiExecuteActionBatchOperationRequest, type ActionApiExecuteActionRequest, type ActionApiInterface, type ActionContext, ActionContextFromJSON, ActionContextFromJSONTyped, ActionContextToJSON, ActionContextToJSONTyped, type ActionExecuteRequest, ActionExecuteRequestFromJSON, ActionExecuteRequestFromJSONTyped, ActionExecuteRequestToJSON, ActionExecuteRequestToJSONTyped, type ActionExecuteResponse, ActionExecuteResponseFromJSON, ActionExecuteResponseFromJSONTyped, ActionExecuteResponseToJSON, ActionExecuteResponseToJSONTyped, ActivityApi, type ActivityApiGetActivityStateBatchOperationRequest, type ActivityApiGetActivityStateRequest, type ActivityApiInterface, type ActivityState, type ActivityStateActivityInfo, ActivityStateActivityInfoFromJSON, ActivityStateActivityInfoFromJSONTyped, ActivityStateActivityInfoToJSON, ActivityStateActivityInfoToJSONTyped, ActivityStateFromJSON, ActivityStateFromJSONTyped, type ActivityStateResponse, ActivityStateResponseFromJSON, ActivityStateResponseFromJSONTyped, ActivityStateResponseToJSON, ActivityStateResponseToJSONTyped, ActivityStateStatusEnum, ActivityStateToJSON, ActivityStateToJSONTyped, type BaseResponseVo, BaseResponseVoFromJSON, BaseResponseVoFromJSONTyped, BaseResponseVoToJSON, BaseResponseVoToJSONTyped, type BlockedComponent, BlockedComponentFromJSON, BlockedComponentFromJSONTyped, BlockedComponentToJSON, BlockedComponentToJSONTyped, DataApi, type DataApiInterface, type DataApiQueryDataBatchOperationRequest, type DataApiQueryDataRequest, type DataQueryContext, DataQueryContextFromJSON, DataQueryContextFromJSONTyped, DataQueryContextToJSON, DataQueryContextToJSONTyped, type DataQueryRequest, DataQueryRequestFromJSON, DataQueryRequestFromJSONTyped, DataQueryRequestToJSON, DataQueryRequestToJSONTyped, type DataQueryResponse, DataQueryResponseFromJSON, DataQueryResponseFromJSONTyped, DataQueryResponseToJSON, DataQueryResponseToJSONTyped, type ErrorDetail, ErrorDetailFromJSON, ErrorDetailFromJSONTyped, ErrorDetailToJSON, ErrorDetailToJSONTyped, type ErrorResponseVo, ErrorResponseVoFromJSON, ErrorResponseVoFromJSONTyped, ErrorResponseVoToJSON, ErrorResponseVoToJSONTyped, type ExecuteActionBatch200Response, ExecuteActionBatch200ResponseFromJSON, ExecuteActionBatch200ResponseFromJSONTyped, ExecuteActionBatch200ResponseToJSON, ExecuteActionBatch200ResponseToJSONTyped, type ExecuteActionBatchRequest, ExecuteActionBatchRequestFromJSON, ExecuteActionBatchRequestFromJSONTyped, ExecuteActionBatchRequestToJSON, ExecuteActionBatchRequestToJSONTyped, type GetActivityStateBatch200Response, GetActivityStateBatch200ResponseFromJSON, GetActivityStateBatch200ResponseFromJSONTyped, GetActivityStateBatch200ResponseToJSON, GetActivityStateBatch200ResponseToJSONTyped, type GetActivityStateBatchRequest, GetActivityStateBatchRequestFromJSON, GetActivityStateBatchRequestFromJSONTyped, GetActivityStateBatchRequestToJSON, GetActivityStateBatchRequestToJSONTyped, HealthApi, type HealthApiInterface, type HealthResponse, type HealthResponseChecksValue, HealthResponseChecksValueFromJSON, HealthResponseChecksValueFromJSONTyped, HealthResponseChecksValueToJSON, HealthResponseChecksValueToJSONTyped, HealthResponseFromJSON, HealthResponseFromJSONTyped, HealthResponseStatusEnum, HealthResponseToJSON, HealthResponseToJSONTyped, type ManifestItem, ManifestItemFromJSON, ManifestItemFromJSONTyped, ManifestItemToJSON, ManifestItemToJSONTyped, PageApi, type PageApiInterface, type PageApiResolvePageBatchOperationRequest, type PageApiResolvePageRequest, type PageManifest, PageManifestFromJSON, PageManifestFromJSONTyped, PageManifestToJSON, PageManifestToJSONTyped, type PageResolveResponse, PageResolveResponseFromJSON, PageResolveResponseFromJSONTyped, PageResolveResponseToJSON, PageResolveResponseToJSONTyped, type PageResolveResult, PageResolveResultFromJSON, PageResolveResultFromJSONTyped, PageResolveResultToJSON, PageResolveResultToJSONTyped, type QueryDataBatch200Response, QueryDataBatch200ResponseFromJSON, QueryDataBatch200ResponseFromJSONTyped, QueryDataBatch200ResponseToJSON, QueryDataBatch200ResponseToJSONTyped, type QueryDataBatchRequest, QueryDataBatchRequestFromJSON, QueryDataBatchRequestFromJSONTyped, QueryDataBatchRequestToJSON, QueryDataBatchRequestToJSONTyped, type ResolvePageBatch200Response, ResolvePageBatch200ResponseFromJSON, ResolvePageBatch200ResponseFromJSONTyped, ResolvePageBatch200ResponseToJSON, ResolvePageBatch200ResponseToJSONTyped, type ResolvePageBatchRequest, ResolvePageBatchRequestChannelEnum, ResolvePageBatchRequestFromJSON, ResolvePageBatchRequestFromJSONTyped, ResolvePageBatchRequestToJSON, ResolvePageBatchRequestToJSONTyped, ResolvePageChannelEnum, type RuntimeConfig, RuntimeConfigFromJSON, RuntimeConfigFromJSONTyped, type RuntimeConfigReportConfig, RuntimeConfigReportConfigFromJSON, RuntimeConfigReportConfigFromJSONTyped, RuntimeConfigReportConfigToJSON, RuntimeConfigReportConfigToJSONTyped, RuntimeConfigToJSON, RuntimeConfigToJSONTyped, type TraceContext, TraceContextFromJSON, TraceContextFromJSONTyped, TraceContextToJSON, TraceContextToJSONTyped, TrackApi, type TrackApiInterface, type TrackApiTrackOperationRequest, type TrackContext, TrackContextFromJSON, TrackContextFromJSONTyped, TrackContextToJSON, TrackContextToJSONTyped, type TrackEvent, TrackEventEventTypeEnum, TrackEventFromJSON, TrackEventFromJSONTyped, TrackEventToJSON, TrackEventToJSONTyped, type TrackRequest, TrackRequestFromJSON, TrackRequestFromJSONTyped, TrackRequestToJSON, TrackRequestToJSONTyped, type UserActivityState, UserActivityStateFromJSON, UserActivityStateFromJSONTyped, type UserActivityStateProgress, UserActivityStateProgressFromJSON, UserActivityStateProgressFromJSONTyped, UserActivityStateProgressToJSON, UserActivityStateProgressToJSONTyped, UserActivityStateToJSON, UserActivityStateToJSONTyped, type UserClient, type UserClientOptions, createUserClient, instanceOfActionContext, instanceOfActionExecuteRequest, instanceOfActionExecuteResponse, instanceOfActivityState, instanceOfActivityStateActivityInfo, instanceOfActivityStateResponse, instanceOfBaseResponseVo, instanceOfBlockedComponent, instanceOfDataQueryContext, instanceOfDataQueryRequest, instanceOfDataQueryResponse, instanceOfErrorDetail, instanceOfErrorResponseVo, instanceOfExecuteActionBatch200Response, instanceOfExecuteActionBatchRequest, instanceOfGetActivityStateBatch200Response, instanceOfGetActivityStateBatchRequest, instanceOfHealthResponse, instanceOfHealthResponseChecksValue, instanceOfManifestItem, instanceOfPageManifest, instanceOfPageResolveResponse, instanceOfPageResolveResult, instanceOfQueryDataBatch200Response, instanceOfQueryDataBatchRequest, instanceOfResolvePageBatch200Response, instanceOfResolvePageBatchRequest, instanceOfRuntimeConfig, instanceOfRuntimeConfigReportConfig, instanceOfTraceContext, instanceOfTrackContext, instanceOfTrackEvent, instanceOfTrackRequest, instanceOfUserActivityState, instanceOfUserActivityStateProgress };

package/dist/index.js CHANGED Viewed

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AbortError: () => import_openapi_client_core2.AbortError,
   ActionApi: () => ActionApi,
   ActionContextFromJSON: () => ActionContextFromJSON,
   ActionContextFromJSONTyped: () => ActionContextFromJSONTyped,
@@ -55,7 +56,7 @@ __export(index_exports, {
   BlockedComponentFromJSONTyped: () => BlockedComponentFromJSONTyped,
   BlockedComponentToJSON: () => BlockedComponentToJSON,
   BlockedComponentToJSONTyped: () => BlockedComponentToJSONTyped,
-  Configuration: () => Configuration,
+  Configuration: () => import_openapi_client_core2.Configuration,
   DataApi: () => DataApi,
   DataQueryContextFromJSON: () => DataQueryContextFromJSON,
   DataQueryContextFromJSONTyped: () => DataQueryContextFromJSONTyped,
@@ -69,6 +70,7 @@ __export(index_exports, {
   DataQueryResponseFromJSONTyped: () => DataQueryResponseFromJSONTyped,
   DataQueryResponseToJSON: () => DataQueryResponseToJSON,
   DataQueryResponseToJSONTyped: () => DataQueryResponseToJSONTyped,
+  DjvApiError: () => import_openapi_client_core2.DjvApiError,
   ErrorDetailFromJSON: () => ErrorDetailFromJSON,
   ErrorDetailFromJSONTyped: () => ErrorDetailFromJSONTyped,
   ErrorDetailToJSON: () => ErrorDetailToJSON,
@@ -107,6 +109,7 @@ __export(index_exports, {
   ManifestItemFromJSONTyped: () => ManifestItemFromJSONTyped,
   ManifestItemToJSON: () => ManifestItemToJSON,
   ManifestItemToJSONTyped: () => ManifestItemToJSONTyped,
+  NetworkError: () => import_openapi_client_core2.NetworkError,
   PageApi: () => PageApi,
   PageManifestFromJSON: () => PageManifestFromJSON,
   PageManifestFromJSONTyped: () => PageManifestFromJSONTyped,
@@ -146,6 +149,7 @@ __export(index_exports, {
   RuntimeConfigReportConfigToJSONTyped: () => RuntimeConfigReportConfigToJSONTyped,
   RuntimeConfigToJSON: () => RuntimeConfigToJSON,
   RuntimeConfigToJSONTyped: () => RuntimeConfigToJSONTyped,
+  TimeoutError: () => import_openapi_client_core2.TimeoutError,
   TraceContextFromJSON: () => TraceContextFromJSON,
   TraceContextFromJSONTyped: () => TraceContextFromJSONTyped,
   TraceContextToJSON: () => TraceContextToJSON,
@@ -172,6 +176,8 @@ __export(index_exports, {
   UserActivityStateProgressToJSONTyped: () => UserActivityStateProgressToJSONTyped,
   UserActivityStateToJSON: () => UserActivityStateToJSON,
   UserActivityStateToJSONTyped: () => UserActivityStateToJSONTyped,
+  createConsoleLogger: () => import_openapi_client_core2.createConsoleLogger,
+  createSilentLogger: () => import_openapi_client_core2.createSilentLogger,
   createUserClient: () => createUserClient,
   instanceOfActionContext: () => instanceOfActionContext,
   instanceOfActionExecuteRequest: () => instanceOfActionExecuteRequest,
@@ -207,9 +213,23 @@ __export(index_exports, {
   instanceOfTrackEvent: () => instanceOfTrackEvent,
   instanceOfTrackRequest: () => instanceOfTrackRequest,
   instanceOfUserActivityState: () => instanceOfUserActivityState,
-  instanceOfUserActivityStateProgress: () => instanceOfUserActivityStateProgress
+  instanceOfUserActivityStateProgress: () => instanceOfUserActivityStateProgress,
+  isRetryableError: () => import_openapi_client_core2.isRetryableError
 });
 module.exports = __toCommonJS(index_exports);
+var import_openapi_client_core = require("@djvlc/openapi-client-core");
+// src/gen/apis/index.ts
+var apis_exports = {};
+__export(apis_exports, {
+  ActionApi: () => ActionApi,
+  ActivityApi: () => ActivityApi,
+  DataApi: () => DataApi,
+  HealthApi: () => HealthApi,
+  PageApi: () => PageApi,
+  ResolvePageChannelEnum: () => ResolvePageChannelEnum,
+  TrackApi: () => TrackApi
+});
 // src/gen/runtime.ts
 var BASE_PATH = "https://api.djvlc.com".replace(/\/+$/, "");
@@ -444,11 +464,10 @@ function querystringSingleKey(key, value, keyPrefix = "") {
   return `${encodeURIComponent(fullKey)}=${encodeURIComponent(String(value))}`;
 }
 function mapValues(data, fn) {
-  const result = {};
-  for (const key of Object.keys(data)) {
-    result[key] = fn(data[key]);
-  }
-  return result;
+  return Object.keys(data).reduce(
+    (acc, key) => ({ ...acc, [key]: fn(data[key]) }),
+    {}
+  );
 }
 var JSONApiResponse = class {
   constructor(raw, transformer = (jsonValue) => jsonValue) {
@@ -468,18 +487,6 @@ var VoidApiResponse = class {
   }
 };
-// src/gen/apis/index.ts
-var apis_exports = {};
-__export(apis_exports, {
-  ActionApi: () => ActionApi,
-  ActivityApi: () => ActivityApi,
-  DataApi: () => DataApi,
-  HealthApi: () => HealthApi,
-  PageApi: () => PageApi,
-  ResolvePageChannelEnum: () => ResolvePageChannelEnum,
-  TrackApi: () => TrackApi
-});
 // src/gen/models/ActionContext.ts
 function instanceOfActionContext(value) {
   return true;
@@ -1742,9 +1749,8 @@ var ActionApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/actions/execute`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/actions/execute`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1774,9 +1780,8 @@ var ActionApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/actions/batch`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/actions/batch`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1815,9 +1820,8 @@ var ActivityApi = class extends BaseAPI {
       queryParameters["uid"] = requestParameters["uid"];
     }
     const headerParameters = {};
-    let urlPath = `/api/activity/state`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/activity/state`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -1846,9 +1850,8 @@ var ActivityApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/activity/state/batch`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/activity/state/batch`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1882,9 +1885,8 @@ var DataApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/data/query`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/data/query`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1914,9 +1916,8 @@ var DataApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/data/query/batch`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/data/query/batch`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1943,9 +1944,8 @@ var HealthApi = class extends BaseAPI {
   async healthRaw(initOverrides) {
     const queryParameters = {};
     const headerParameters = {};
-    let urlPath = `/api/health`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/health`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -1967,9 +1967,8 @@ var HealthApi = class extends BaseAPI {
   async livenessRaw(initOverrides) {
     const queryParameters = {};
     const headerParameters = {};
-    let urlPath = `/api/health/live`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/health/live`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -1991,9 +1990,8 @@ var HealthApi = class extends BaseAPI {
   async readinessRaw(initOverrides) {
     const queryParameters = {};
     const headerParameters = {};
-    let urlPath = `/api/health/ready`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/health/ready`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -2040,9 +2038,8 @@ var PageApi = class extends BaseAPI {
       queryParameters["previewToken"] = requestParameters["previewToken"];
     }
     const headerParameters = {};
-    let urlPath = `/api/page/resolve`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/page/resolve`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -2071,9 +2068,8 @@ var PageApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/page/resolve/batch`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/page/resolve/batch`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -2112,9 +2108,8 @@ var TrackApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/track`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/track`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -2132,64 +2127,27 @@ var TrackApi = class extends BaseAPI {
 };
 // src/index.ts
-function stripTrailingSlash(url) {
-  return url.replace(/\/$/, "");
-}
-function createFetchWithTimeout(fetchImpl, timeoutMs) {
-  return (async (input, init) => {
-    const controller = new AbortController();
-    const id = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-      return await fetchImpl(input, { ...init, signal: controller.signal });
-    } finally {
-      clearTimeout(id);
-    }
-  });
-}
-function normalizeHeaders(initHeaders) {
-  return new Headers(initHeaders ?? {});
-}
+var import_openapi_client_core2 = require("@djvlc/openapi-client-core");
+var SDK_INFO = {
+  name: true ? "@djvlc/openapi-user-client" : "@djvlc/openapi-user-client",
+  version: true ? "1.0.0" : "0.0.0-dev"
+};
 function createUserClient(opts) {
-  const timeoutMs = opts.timeoutMs ?? 15e3;
-  const fetchImpl = opts.fetchApi ?? fetch;
-  const fetchWithTimeout = createFetchWithTimeout(fetchImpl, timeoutMs);
-  const headersMiddleware = {
-    async pre(context) {
-      const headers = normalizeHeaders(context.init.headers);
-      if (opts.defaultHeaders) {
-        for (const [k, v] of Object.entries(opts.defaultHeaders)) headers.set(k, v);
-      }
-      if (opts.getAuthToken) {
-        const token = await opts.getAuthToken();
-        if (token) headers.set("Authorization", `Bearer ${token}`);
-      }
-      if (opts.getTraceHeaders) {
-        const traceHeaders = opts.getTraceHeaders();
-        for (const [k, v] of Object.entries(traceHeaders)) headers.set(k, v);
-      }
-      return { url: context.url, init: { ...context.init, headers } };
-    }
+  const defaultOpts = {
+    timeoutMs: 15e3,
+    // User API 追求快失败
+    credentials: "omit"
+    // 通常不走 Cookie
   };
-  const config = new Configuration({
-    basePath: stripTrailingSlash(opts.baseUrl),
-    fetchApi: fetchWithTimeout,
-    middleware: [headersMiddleware],
-    credentials: opts.credentials ?? "omit"
-  });
-  const apiInstances = {};
-  for (const [name, ApiClass] of Object.entries(apis_exports)) {
-    if (typeof ApiClass === "function" && name.endsWith("Api")) {
-      apiInstances[name] = new ApiClass(config);
-    }
-  }
-  return {
-    config,
-    apis: apiInstances,
-    ...apiInstances
+  const mergedOpts = {
+    ...defaultOpts,
+    ...opts
   };
+  return (0, import_openapi_client_core.createClient)(apis_exports, mergedOpts, SDK_INFO);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AbortError,
   ActionApi,
   ActionContextFromJSON,
   ActionContextFromJSONTyped,
@@ -2239,6 +2197,7 @@ function createUserClient(opts) {
   DataQueryResponseFromJSONTyped,
   DataQueryResponseToJSON,
   DataQueryResponseToJSONTyped,
+  DjvApiError,
   ErrorDetailFromJSON,
   ErrorDetailFromJSONTyped,
   ErrorDetailToJSON,
@@ -2277,6 +2236,7 @@ function createUserClient(opts) {
   ManifestItemFromJSONTyped,
   ManifestItemToJSON,
   ManifestItemToJSONTyped,
+  NetworkError,
   PageApi,
   PageManifestFromJSON,
   PageManifestFromJSONTyped,
@@ -2316,6 +2276,7 @@ function createUserClient(opts) {
   RuntimeConfigReportConfigToJSONTyped,
   RuntimeConfigToJSON,
   RuntimeConfigToJSONTyped,
+  TimeoutError,
   TraceContextFromJSON,
   TraceContextFromJSONTyped,
   TraceContextToJSON,
@@ -2342,6 +2303,8 @@ function createUserClient(opts) {
   UserActivityStateProgressToJSONTyped,
   UserActivityStateToJSON,
   UserActivityStateToJSONTyped,
+  createConsoleLogger,
+  createSilentLogger,
   createUserClient,
   instanceOfActionContext,
   instanceOfActionExecuteRequest,
@@ -2377,5 +2340,6 @@ function createUserClient(opts) {
   instanceOfTrackEvent,
   instanceOfTrackRequest,
   instanceOfUserActivityState,
-  instanceOfUserActivityStateProgress
+  instanceOfUserActivityStateProgress,
+  isRetryableError
 });

package/dist/index.mjs CHANGED Viewed

@@ -4,6 +4,23 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
+// src/index.ts
+import {
+  createClient
+} from "@djvlc/openapi-client-core";
+// src/gen/apis/index.ts
+var apis_exports = {};
+__export(apis_exports, {
+  ActionApi: () => ActionApi,
+  ActivityApi: () => ActivityApi,
+  DataApi: () => DataApi,
+  HealthApi: () => HealthApi,
+  PageApi: () => PageApi,
+  ResolvePageChannelEnum: () => ResolvePageChannelEnum,
+  TrackApi: () => TrackApi
+});
 // src/gen/runtime.ts
 var BASE_PATH = "https://api.djvlc.com".replace(/\/+$/, "");
 var Configuration = class {
@@ -237,11 +254,10 @@ function querystringSingleKey(key, value, keyPrefix = "") {
   return `${encodeURIComponent(fullKey)}=${encodeURIComponent(String(value))}`;
 }
 function mapValues(data, fn) {
-  const result = {};
-  for (const key of Object.keys(data)) {
-    result[key] = fn(data[key]);
-  }
-  return result;
+  return Object.keys(data).reduce(
+    (acc, key) => ({ ...acc, [key]: fn(data[key]) }),
+    {}
+  );
 }
 var JSONApiResponse = class {
   constructor(raw, transformer = (jsonValue) => jsonValue) {
@@ -261,18 +277,6 @@ var VoidApiResponse = class {
   }
 };
-// src/gen/apis/index.ts
-var apis_exports = {};
-__export(apis_exports, {
-  ActionApi: () => ActionApi,
-  ActivityApi: () => ActivityApi,
-  DataApi: () => DataApi,
-  HealthApi: () => HealthApi,
-  PageApi: () => PageApi,
-  ResolvePageChannelEnum: () => ResolvePageChannelEnum,
-  TrackApi: () => TrackApi
-});
 // src/gen/models/ActionContext.ts
 function instanceOfActionContext(value) {
   return true;
@@ -1535,9 +1539,8 @@ var ActionApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/actions/execute`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/actions/execute`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1567,9 +1570,8 @@ var ActionApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/actions/batch`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/actions/batch`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1608,9 +1610,8 @@ var ActivityApi = class extends BaseAPI {
       queryParameters["uid"] = requestParameters["uid"];
     }
     const headerParameters = {};
-    let urlPath = `/api/activity/state`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/activity/state`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -1639,9 +1640,8 @@ var ActivityApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/activity/state/batch`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/activity/state/batch`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1675,9 +1675,8 @@ var DataApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/data/query`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/data/query`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1707,9 +1706,8 @@ var DataApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/data/query/batch`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/data/query/batch`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1736,9 +1734,8 @@ var HealthApi = class extends BaseAPI {
   async healthRaw(initOverrides) {
     const queryParameters = {};
     const headerParameters = {};
-    let urlPath = `/api/health`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/health`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -1760,9 +1757,8 @@ var HealthApi = class extends BaseAPI {
   async livenessRaw(initOverrides) {
     const queryParameters = {};
     const headerParameters = {};
-    let urlPath = `/api/health/live`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/health/live`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -1784,9 +1780,8 @@ var HealthApi = class extends BaseAPI {
   async readinessRaw(initOverrides) {
     const queryParameters = {};
     const headerParameters = {};
-    let urlPath = `/api/health/ready`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/health/ready`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -1833,9 +1828,8 @@ var PageApi = class extends BaseAPI {
       queryParameters["previewToken"] = requestParameters["previewToken"];
     }
     const headerParameters = {};
-    let urlPath = `/api/page/resolve`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/page/resolve`,
       method: "GET",
       headers: headerParameters,
       query: queryParameters
@@ -1864,9 +1858,8 @@ var PageApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/page/resolve/batch`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/page/resolve/batch`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1905,9 +1898,8 @@ var TrackApi = class extends BaseAPI {
     const queryParameters = {};
     const headerParameters = {};
     headerParameters["Content-Type"] = "application/json";
-    let urlPath = `/api/track`;
     const response = await this.request({
-      path: urlPath,
+      path: `/api/track`,
       method: "POST",
       headers: headerParameters,
       query: queryParameters,
@@ -1925,63 +1917,35 @@ var TrackApi = class extends BaseAPI {
 };
 // src/index.ts
-function stripTrailingSlash(url) {
-  return url.replace(/\/$/, "");
-}
-function createFetchWithTimeout(fetchImpl, timeoutMs) {
-  return (async (input, init) => {
-    const controller = new AbortController();
-    const id = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-      return await fetchImpl(input, { ...init, signal: controller.signal });
-    } finally {
-      clearTimeout(id);
-    }
-  });
-}
-function normalizeHeaders(initHeaders) {
-  return new Headers(initHeaders ?? {});
-}
+import {
+  DjvApiError,
+  NetworkError,
+  TimeoutError,
+  AbortError,
+  isRetryableError,
+  Configuration as Configuration3,
+  createConsoleLogger,
+  createSilentLogger
+} from "@djvlc/openapi-client-core";
+var SDK_INFO = {
+  name: true ? "@djvlc/openapi-user-client" : "@djvlc/openapi-user-client",
+  version: true ? "1.0.0" : "0.0.0-dev"
+};
 function createUserClient(opts) {
-  const timeoutMs = opts.timeoutMs ?? 15e3;
-  const fetchImpl = opts.fetchApi ?? fetch;
-  const fetchWithTimeout = createFetchWithTimeout(fetchImpl, timeoutMs);
-  const headersMiddleware = {
-    async pre(context) {
-      const headers = normalizeHeaders(context.init.headers);
-      if (opts.defaultHeaders) {
-        for (const [k, v] of Object.entries(opts.defaultHeaders)) headers.set(k, v);
-      }
-      if (opts.getAuthToken) {
-        const token = await opts.getAuthToken();
-        if (token) headers.set("Authorization", `Bearer ${token}`);
-      }
-      if (opts.getTraceHeaders) {
-        const traceHeaders = opts.getTraceHeaders();
-        for (const [k, v] of Object.entries(traceHeaders)) headers.set(k, v);
-      }
-      return { url: context.url, init: { ...context.init, headers } };
-    }
+  const defaultOpts = {
+    timeoutMs: 15e3,
+    // User API 追求快失败
+    credentials: "omit"
+    // 通常不走 Cookie
   };
-  const config = new Configuration({
-    basePath: stripTrailingSlash(opts.baseUrl),
-    fetchApi: fetchWithTimeout,
-    middleware: [headersMiddleware],
-    credentials: opts.credentials ?? "omit"
-  });
-  const apiInstances = {};
-  for (const [name, ApiClass] of Object.entries(apis_exports)) {
-    if (typeof ApiClass === "function" && name.endsWith("Api")) {
-      apiInstances[name] = new ApiClass(config);
-    }
-  }
-  return {
-    config,
-    apis: apiInstances,
-    ...apiInstances
+  const mergedOpts = {
+    ...defaultOpts,
+    ...opts
   };
+  return createClient(apis_exports, mergedOpts, SDK_INFO);
 }
 export {
+  AbortError,
   ActionApi,
   ActionContextFromJSON,
   ActionContextFromJSONTyped,
@@ -2017,7 +1981,7 @@ export {
   BlockedComponentFromJSONTyped,
   BlockedComponentToJSON,
   BlockedComponentToJSONTyped,
-  Configuration,
+  Configuration3 as Configuration,
   DataApi,
   DataQueryContextFromJSON,
   DataQueryContextFromJSONTyped,
@@ -2031,6 +1995,7 @@ export {
   DataQueryResponseFromJSONTyped,
   DataQueryResponseToJSON,
   DataQueryResponseToJSONTyped,
+  DjvApiError,
   ErrorDetailFromJSON,
   ErrorDetailFromJSONTyped,
   ErrorDetailToJSON,
@@ -2069,6 +2034,7 @@ export {
   ManifestItemFromJSONTyped,
   ManifestItemToJSON,
   ManifestItemToJSONTyped,
+  NetworkError,
   PageApi,
   PageManifestFromJSON,
   PageManifestFromJSONTyped,
@@ -2108,6 +2074,7 @@ export {
   RuntimeConfigReportConfigToJSONTyped,
   RuntimeConfigToJSON,
   RuntimeConfigToJSONTyped,
+  TimeoutError,
   TraceContextFromJSON,
   TraceContextFromJSONTyped,
   TraceContextToJSON,
@@ -2134,6 +2101,8 @@ export {
   UserActivityStateProgressToJSONTyped,
   UserActivityStateToJSON,
   UserActivityStateToJSONTyped,
+  createConsoleLogger,
+  createSilentLogger,
   createUserClient,
   instanceOfActionContext,
   instanceOfActionExecuteRequest,
@@ -2169,5 +2138,6 @@ export {
   instanceOfTrackEvent,
   instanceOfTrackRequest,
   instanceOfUserActivityState,
-  instanceOfUserActivityStateProgress
+  instanceOfUserActivityStateProgress,
+  isRetryableError
 };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@djvlc/openapi-user-client",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "DJV Low-code Platform - User API 客户端（自动生成）",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -19,12 +19,14 @@
   "scripts": {
     "clean": "rimraf src/gen dist",
     "gen": "node ../../tools/openapi/generate-clients.js user",
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "build": "tsup --config tsup.config.ts",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "lint": "eslint src/ --ext .ts --ignore-pattern src/gen/",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {},
+  "dependencies": {
+    "@djvlc/openapi-client-core": "1.1.0"
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "^7.0.0",