@h-ai/api-contract 0.1.0-alpha.67 → 0.1.0-alpha.68

package/dist/iam/index.js

@@ -1,4 +1,4 @@
-export { IamAdminCreateUserInputSchema, IamAdminResetPasswordInputSchema, IamAdminUpdateUserInputSchema, IamAgreementDisplaySchema, IamAuthResultSchema, IamChangePasswordInputSchema, IamConfirmPasswordResetInputSchema, IamCreatePermissionInputSchema, IamCreateRoleInputSchema, IamCurrentUserSchema, IamLdapLoginInputSchema, IamListPermissionsInputSchema, IamListUsersInputSchema, IamLoginInputSchema, IamLogoutInputSchema, IamOtpLoginInputSchema, IamPermissionSchema, IamPermissionTypeSchema, IamPublicConfigSchema, IamRefreshTokenDataSchema, IamRefreshTokenInputSchema, IamRegisterInputSchema, IamRequestPasswordResetInputSchema, IamRoleSchema, IamSendOtpDataSchema, IamSendOtpInputSchema, IamTokenPairSchema, IamUpdateCurrentUserInputSchema, IamUpdateRoleInputSchema, IamUserIdInputSchema, IamUserSchema, iamContract } from '../chunk-RVSGP2GF.js';
-import '../chunk-CUU2F6YD.js';
+export { IamAdminCreateUserInputSchema, IamAdminResetPasswordInputSchema, IamAdminUpdateUserInputSchema, IamAgreementDisplaySchema, IamAuthResultSchema, IamChangePasswordInputSchema, IamConfirmPasswordResetInputSchema, IamCreatePermissionInputSchema, IamCreateRoleInputSchema, IamCurrentUserSchema, IamLdapLoginInputSchema, IamListPermissionsInputSchema, IamListUsersInputSchema, IamLoginInputSchema, IamLogoutInputSchema, IamOtpLoginInputSchema, IamPermissionSchema, IamPermissionTypeSchema, IamPublicConfigSchema, IamRefreshTokenDataSchema, IamRefreshTokenInputSchema, IamRegisterInputSchema, IamRequestPasswordResetInputSchema, IamRoleSchema, IamSendOtpDataSchema, IamSendOtpInputSchema, IamTokenPairSchema, IamUpdateCurrentUserInputSchema, IamUpdateRoleInputSchema, IamUserIdInputSchema, IamUserSchema, iamContract } from '../chunk-G3SME6V5.js';
+import '../chunk-JKPLID6E.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,12 +1,13 @@
-export { AUDIO_WS_PATH, AiAssistantMessageSchema, AiChatCompletionChoiceSchema, AiChatCompletionData, AiChatCompletionDataSchema, AiChatCompletionInput, AiChatCompletionInputSchema, AiChatCompletionOutput, AiChatHistoryDataSchema, AiChatHistoryInput, AiChatHistoryInputSchema, AiChatMessageSchema, AiChatRecord, AiChatRecordSchema, AiContract, AiImageContentSchema, AiMemoryEntrySchema, AiMemoryListDataSchema, AiMemoryListInput, AiMemoryListInputSchema, AiMemoryRecallDataSchema, AiMemoryRecallInput, AiMemoryRecallInputSchema, AiMemoryTypeSchema, AiMessageContentSchema, AiMessageRoleSchema, AiSendMessageData, AiSendMessageDataSchema, AiSendMessageInput, AiSendMessageInputSchema, AiSendMessageOutput, AiSessionInfoSchema, AiSessionListDataSchema, AiSessionListInput, AiSessionListInputSchema, AiTextContentSchema, AiTokenUsageSchema, AiToolCallSchema, AiToolDefinitionSchema, AiToolParameterSchema, AudioFormatSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema } from './ai/index.js';
+export { AUDIO_WS_PATH, AiAssistantMessageSchema, AiChatCompletionChoiceSchema, AiChatCompletionData, AiChatCompletionDataSchema, AiChatCompletionInput, AiChatCompletionInputSchema, AiChatCompletionOutput, AiChatHistoryDataSchema, AiChatHistoryInput, AiChatHistoryInputSchema, AiChatMessageSchema, AiChatRecord, AiChatRecordSchema, AiContract, AiImageContentSchema, AiMemoryEntrySchema, AiMemoryListDataSchema, AiMemoryListInput, AiMemoryListInputSchema, AiMemoryRecallDataSchema, AiMemoryRecallInput, AiMemoryRecallInputSchema, AiMemoryTypeSchema, AiMessageContentSchema, AiMessageRoleSchema, AiSendMessageData, AiSendMessageDataSchema, AiSendMessageInput, AiSendMessageInputSchema, AiSendMessageOutput, AiSessionInfoSchema, AiSessionListDataSchema, AiSessionListInput, AiSessionListInputSchema, AiTextContentSchema, AiTokenUsageSchema, AiToolCallSchema, AiToolDefinitionSchema, AudioFormatSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema } from './ai/index.js';
 import * as _orpc_contract from '@orpc/contract';
 import { AnyContractProcedure, AnyContractRouter } from '@orpc/contract';
+export { ContractProcedureBuilderWithInputOutput, ContractProcedureBuilderWithOutput, Schema } from '@orpc/contract';
 import * as zod_v4_core from 'zod/v4/core';
 import * as zod from 'zod';
 import { z } from 'zod';
 export { IamAdminCreateUserInput, IamAdminCreateUserInputSchema, IamAdminResetPasswordInput, IamAdminResetPasswordInputSchema, IamAdminUpdateUserInput, IamAdminUpdateUserInputSchema, IamAgreementDisplaySchema, IamAuthResultOutput, IamAuthResultSchema, IamChangePasswordInput, IamChangePasswordInputSchema, IamConfirmPasswordResetInputSchema, IamContract, IamCreatePermissionInput, IamCreatePermissionInputSchema, IamCreateRoleInput, IamCreateRoleInputSchema, IamCurrentUser, IamCurrentUserOutput, IamCurrentUserSchema, IamLdapLoginInput, IamLdapLoginInputSchema, IamListPermissionsInput, IamListPermissionsInputSchema, IamListUsersInput, IamListUsersInputSchema, IamLoginInput, IamLoginInputSchema, IamLogoutInput, IamLogoutInputSchema, IamOtpLoginInput, IamOtpLoginInputSchema, IamPermissionSchema, IamPermissionTypeSchema, IamPublicConfig, IamPublicConfigSchema, IamRefreshTokenDataSchema, IamRefreshTokenInput, IamRefreshTokenInputSchema, IamRefreshTokenOutput, IamRegisterInput, IamRegisterInputSchema, IamRequestPasswordResetInputSchema, IamRoleSchema, IamSendOtpDataSchema, IamSendOtpInput, IamSendOtpInputSchema, IamTokenPairSchema, IamUpdateCurrentUserInput, IamUpdateCurrentUserInputSchema, IamUpdateRoleInput, IamUpdateRoleInputSchema, IamUserIdInput, IamUserIdInputSchema, IamUserSchema } from './iam/index.js';
 export { PaymentContract, PaymentCreateOrderDataSchema, PaymentCreateOrderInput, PaymentCreateOrderInputSchema, PaymentCreateOrderOutput, PaymentNotifyMessageSchema, PaymentOrderSchema, PaymentProviderSchema, PaymentQueryOrderInputSchema, PaymentRefundDataSchema, PaymentRefundInput, PaymentRefundInputSchema, PaymentStripeNotifyDataSchema, PaymentTradeTypeSchema } from './payment/index.js';
-export { StorageContract, StorageDeleteFilesInput, StorageDeleteFilesInputSchema, StorageFileKeyInput, StorageFileKeyInputSchema, StorageFileMetadataSchema, StorageListFilesDataSchema, StorageListFilesInput, StorageListFilesInputSchema, StoragePresignDownloadInput, StoragePresignDownloadInputSchema, StoragePresignUploadInput, StoragePresignUploadInputSchema, StoragePresignedUrlOutput, StoragePresignedUrlSchema } from './storage/index.js';
+export { StorageContract, StorageDeleteFilesInput, StorageDeleteFilesInputSchema, StorageDeleteSummarySchema, StorageFileKeyInput, StorageFileKeyInputSchema, StorageFileMetadataSchema, StorageListFilesDataSchema, StorageListFilesInput, StorageListFilesInputSchema, StoragePresignDownloadInput, StoragePresignDownloadInputSchema, StoragePresignUploadInput, StoragePresignUploadInputSchema, StoragePresignedUrlOutput, StoragePresignedUrlSchema } from './storage/index.js';
 import '@h-ai/core';
 
 /**
@@ -21,13 +22,12 @@ import '@h-ai/core';
  *
  * 页码和页大小均为可选，由服务端提供合理默认值（page=1, pageSize=20）。
  * 支持字符串 coerce，适配 GET 请求 query string 场景。
- *
  * @example
  * ```ts
- * // 扩展为领域专属查询参数
- * const IamListUsersInputSchema = PaginationQuerySchema.extend({
- *   search: z.string().optional(),
- * })
+ * import { PaginationQuerySchema } from '@h-ai/api-contract'
+ *
+ * const value = PaginationQuerySchema.parse({})
+ * void value
  * ```
  */
 declare const PaginationQuerySchema: z.ZodObject<{
@@ -42,13 +42,14 @@ declare const PaginationQuerySchema: z.ZodObject<{
  *
  * @param itemSchema - 分页项的 Zod Schema
  * @returns 包含 items/total/page/pageSize 的对象 Schema
- *
  * @example
  * ```ts
- * const listUsers = route({ method: 'GET', path: '/users' })
- *   .output(haiResultSchema(paginatedSchema(IamUserSchema)))
- * // 解析结果形如：
- * // { success: true, data: { items: [...], total: 100, page: 1, pageSize: 20 } }
+ * import { apiContract } from '@h-ai/api-contract'
+ * import { z } from 'zod'
+ *
+ * const page = apiContract.paginatedSchema(z.object({ id: z.string() }))
+ *   .parse({ items: [{ id: 'order_1' }], total: 1, page: 1, pageSize: 20 })
+ * void page
  * ```
  */
 declare function paginatedSchema<T extends z.ZodType>(itemSchema: T): z.ZodObject<{
@@ -70,6 +71,17 @@ declare function paginatedSchema<T extends z.ZodType>(itemSchema: T): z.ZodObjec
  * HaiError 的跨端 JSON Schema。
  *
  * 仅描述公共错误字段，不暴露内部异常对象结构。
+ * @example
+ * ```ts
+ * import { HaiErrorSchema } from '@h-ai/api-contract'
+ *
+ * const value = HaiErrorSchema.parse({
+ *   code: 'app:orders:001',
+ *   message: 'Order not found',
+ *   httpStatus: 404
+ * })
+ * void value
+ * ```
  */
 declare const HaiErrorSchema: z.ZodObject<{
     code: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
@@ -86,10 +98,14 @@ declare const HaiErrorSchema: z.ZodObject<{
  *
  * @param dataSchema - 成功分支 data 字段 Schema
  * @returns HaiResult<T> 的 Zod Schema
- *
  * @example
  * ```ts
- * const OutputSchema = haiResultSchema(z.object({ id: z.string() }))
+ * import { apiContract } from '@h-ai/api-contract'
+ * import { z } from 'zod'
+ *
+ * const result = apiContract.haiResultSchema(z.object({ id: z.string() }))
+ *   .parse({ success: true, data: { id: 'order_1' } })
+ * if (result.success) void result.data.id
  * ```
  */
 declare function haiResultSchema<T extends z.ZodType>(dataSchema: T): z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -124,6 +140,13 @@ declare function haiResultSchema<T extends z.ZodType>(dataSchema: T): z.ZodDiscr
  *
  * @param procedure - 已声明 HTTP route 的 oRPC contract procedure
  * @returns contract 中的绝对业务路径
+ * @example
+ * ```ts
+ * import { apiContract } from '@h-ai/api-contract'
+ *
+ * const path = apiContract.pathOf(apiContract.iam.auth.login)
+ * void path
+ * ```
  */
 declare function pathOf(procedure: AnyContractProcedure): `/${string}`;
 
@@ -135,9 +158,31 @@ declare function pathOf(procedure: AnyContractProcedure): `/${string}`;
  * @module create-api-contract
  */
 
-/** API contract 组合输入。key 为领域名称，value 为领域 contract 或 false/undefined（跳过该领域）。 */
+/**
+ * API contract 组合输入。key 为领域名称，value 为领域 contract 或 false/undefined（跳过该领域）。
+ * @example
+ * ```ts
+ * import type { CreateApiContractOptions } from '@h-ai/api-contract'
+ * import { apiContract } from '@h-ai/api-contract'
+ *
+ * const parts = { iam: apiContract.iam, payment: false } satisfies CreateApiContractOptions
+ * const contract = apiContract.create(parts)
+ * void contract.iam.auth.login
+ * ```
+ */
 type CreateApiContractOptions = Record<string, AnyContractRouter | false | undefined>;
-/** 根据输入过滤 false/undefined 后得到的应用级 contract 类型。 */
+/**
+ * 根据输入过滤 false/undefined 后得到的应用级 contract 类型。
+ * @example
+ * ```ts
+ * import type { CreatedApiContract } from '@h-ai/api-contract'
+ * import { apiContract } from '@h-ai/api-contract'
+ *
+ * const parts = { iam: apiContract.iam, payment: false } as const
+ * const contract: CreatedApiContract<typeof parts> = apiContract.create(parts)
+ * void contract.iam.auth.login
+ * ```
+ */
 type CreatedApiContract<T extends CreateApiContractOptions> = {
     readonly [K in keyof T as T[K] extends false | undefined ? never : K]: Exclude<T[K], false | undefined>;
 };
@@ -149,21 +194,28 @@ type CreatedApiContract<T extends CreateApiContractOptions> = {
  *
  * @param options - 各领域 contract（传 false/undefined 表示禁用该领域）
  * @returns 过滤后的应用级 oRPC contract router
- *
  * @example
  * ```ts
  * import { apiContract } from '@h-ai/api-contract'
  *
- * const myContract = apiContract.create({
- *   iam: apiContract.iam,
- *   storage: apiContract.storage,
- *   payment: false, // 未启用，不会出现在 contract 或 OpenAPI spec 中
- * })
+ * const contract = apiContract.create({ iam: apiContract.iam, payment: false })
+ * const loginPath = apiContract.pathOf(contract.iam.auth.login)
+ * void loginPath
  * ```
  */
 declare function createApiContract<const T extends CreateApiContractOptions>(options: T): CreatedApiContract<T>;
 
-/** hai-framework API contract 统一入口（扁平命名空间）。 */
+/**
+ * hai-framework API contract 统一入口（扁平命名空间）。
+ * @example
+ * ```ts
+ * import { apiContract } from '@h-ai/api-contract'
+ *
+ * const contract = apiContract.create({ iam: apiContract.iam, payment: false })
+ * const loginPath = apiContract.pathOf(contract.iam.auth.login)
+ * void loginPath
+ * ```
+ */
 declare const apiContract: {
     /** 组合任意领域 contract，过滤掉 `false` / `undefined`，输出可被 serv 挂载的 router。 */
     create: typeof createApiContract;
@@ -355,7 +407,6 @@ declare const apiContract: {
             login: _orpc_contract.ContractProcedureBuilderWithInputOutput<zod.ZodObject<{
                 identifier: zod.ZodString;
                 password: zod.ZodString;
-                rememberMe: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
                 success: zod.ZodLiteral<true>;
                 data: zod.ZodObject<{
@@ -1123,7 +1174,7 @@ declare const apiContract: {
             createDownload: _orpc_contract.ContractProcedureBuilderWithInputOutput<zod.ZodObject<{
                 key: zod.ZodString;
                 expiresIn: zod.ZodOptional<zod.ZodNumber>;
-            }, zod_v4_core.$strip>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+            }, zod_v4_core.$strict>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
                 success: zod.ZodLiteral<true>;
                 data: zod.ZodObject<{
                     url: zod.ZodString;
@@ -1146,9 +1197,8 @@ declare const apiContract: {
             createUpload: _orpc_contract.ContractProcedureBuilderWithInputOutput<zod.ZodObject<{
                 key: zod.ZodString;
                 contentType: zod.ZodOptional<zod.ZodString>;
-                contentLength: zod.ZodOptional<zod.ZodNumber>;
                 expiresIn: zod.ZodOptional<zod.ZodNumber>;
-            }, zod_v4_core.$strip>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+            }, zod_v4_core.$strict>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
                 success: zod.ZodLiteral<true>;
                 data: zod.ZodObject<{
                     url: zod.ZodString;
@@ -1250,7 +1300,19 @@ declare const apiContract: {
                 keys: zod.ZodArray<zod.ZodString>;
             }, zod_v4_core.$strip>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
                 success: zod.ZodLiteral<true>;
-                data: zod.ZodVoid;
+                data: zod.ZodObject<{
+                    deletedKeys: zod.ZodArray<zod.ZodString>;
+                    failures: zod.ZodArray<zod.ZodObject<{
+                        key: zod.ZodString;
+                        code: zod.ZodString;
+                        retryable: zod.ZodBoolean;
+                        outcome: zod.ZodEnum<{
+                            unknown: "unknown";
+                            failed: "failed";
+                            notAttempted: "notAttempted";
+                        }>;
+                    }, zod_v4_core.$strip>>;
+                }, zod_v4_core.$strip>;
             }, zod_v4_core.$strip>, zod.ZodObject<{
                 success: zod.ZodLiteral<false>;
                 error: zod.ZodObject<{
@@ -1261,7 +1323,21 @@ declare const apiContract: {
                     module: zod.ZodOptional<zod.ZodString>;
                     cause: zod.ZodOptional<zod.ZodUnknown>;
                     suggestion: zod.ZodOptional<zod.ZodString>;
-                    ext: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>;
+                    ext: zod.ZodOptional<zod.ZodObject<{
+                        deleteMany: zod.ZodOptional<zod.ZodObject<{
+                            deletedKeys: zod.ZodArray<zod.ZodString>;
+                            failures: zod.ZodArray<zod.ZodObject<{
+                                key: zod.ZodString;
+                                code: zod.ZodString;
+                                retryable: zod.ZodBoolean;
+                                outcome: zod.ZodEnum<{
+                                    unknown: "unknown";
+                                    failed: "failed";
+                                    notAttempted: "notAttempted";
+                                }>;
+                            }, zod_v4_core.$strip>>;
+                        }, zod_v4_core.$strip>>;
+                    }, zod_v4_core.$catchall<zod.ZodUnknown>>>;
                 }, zod_v4_core.$strip>;
             }, zod_v4_core.$strip>], "success">, Record<never, never>, Record<never, never>>;
         };
@@ -1270,18 +1346,22 @@ declare const apiContract: {
     ai: {
         chats: {
             createCompletion: _orpc_contract.ContractProcedureBuilderWithInputOutput<zod.ZodObject<{
+                objectId: zod.ZodOptional<zod.ZodString>;
+                sessionId: zod.ZodOptional<zod.ZodString>;
                 model: zod.ZodOptional<zod.ZodString>;
-                messages: zod.ZodArray<zod.ZodObject<{
-                    role: zod.ZodEnum<{
-                        system: "system";
-                        user: "user";
-                        assistant: "assistant";
-                        tool: "tool";
-                    }>;
-                    content: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
+                messages: zod.ZodArray<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+                    role: zod.ZodLiteral<"system">;
+                    content: zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodObject<{
                         type: zod.ZodLiteral<"text">;
                         text: zod.ZodString;
-                    }, zod_v4_core.$strip>, zod.ZodObject<{
+                    }, zod_v4_core.$strict>>]>;
+                    name: zod.ZodOptional<zod.ZodString>;
+                }, zod_v4_core.$strict>, zod.ZodObject<{
+                    role: zod.ZodLiteral<"user">;
+                    content: zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
+                        type: zod.ZodLiteral<"text">;
+                        text: zod.ZodString;
+                    }, zod_v4_core.$strict>, zod.ZodObject<{
                         type: zod.ZodLiteral<"image_url">;
                         image_url: zod.ZodObject<{
                             url: zod.ZodString;
@@ -1290,8 +1370,15 @@ declare const apiContract: {
                                 low: "low";
                                 high: "high";
                             }>>;
-                        }, zod_v4_core.$strip>;
-                    }, zod_v4_core.$strip>]>>]>>;
+                        }, zod_v4_core.$strict>;
+                    }, zod_v4_core.$strict>]>>]>;
+                    name: zod.ZodOptional<zod.ZodString>;
+                }, zod_v4_core.$strict>, zod.ZodObject<{
+                    role: zod.ZodLiteral<"assistant">;
+                    content: zod.ZodOptional<zod.ZodNullable<zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodObject<{
+                        type: zod.ZodLiteral<"text">;
+                        text: zod.ZodString;
+                    }, zod_v4_core.$strict>>]>>>;
                     name: zod.ZodOptional<zod.ZodString>;
                     tool_calls: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
                         id: zod.ZodString;
@@ -1299,37 +1386,35 @@ declare const apiContract: {
                         function: zod.ZodObject<{
                             name: zod.ZodString;
                             arguments: zod.ZodString;
-                        }, zod_v4_core.$strip>;
-                    }, zod_v4_core.$strip>>>;
-                    tool_call_id: zod.ZodOptional<zod.ZodString>;
-                }, zod_v4_core.$strip>>;
+                        }, zod_v4_core.$strict>;
+                    }, zod_v4_core.$strict>>>;
+                }, zod_v4_core.$strict>, zod.ZodObject<{
+                    role: zod.ZodLiteral<"tool">;
+                    content: zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodObject<{
+                        type: zod.ZodLiteral<"text">;
+                        text: zod.ZodString;
+                    }, zod_v4_core.$strict>>]>;
+                    tool_call_id: zod.ZodString;
+                }, zod_v4_core.$strict>], "role">>;
                 temperature: zod.ZodOptional<zod.ZodNumber>;
                 top_p: zod.ZodOptional<zod.ZodNumber>;
                 max_tokens: zod.ZodOptional<zod.ZodNumber>;
-                stream: zod.ZodOptional<zod.ZodBoolean>;
                 tools: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
                     type: zod.ZodLiteral<"function">;
                     function: zod.ZodObject<{
                         name: zod.ZodString;
                         description: zod.ZodOptional<zod.ZodString>;
-                        parameters: zod.ZodOptional<zod.ZodObject<{
-                            type: zod.ZodLiteral<"object">;
-                            properties: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodObject<{
-                                type: zod.ZodString;
-                                description: zod.ZodOptional<zod.ZodString>;
-                                enum: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
-                            }, zod_v4_core.$strip>>>;
-                            required: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
-                        }, zod_v4_core.$strip>>;
-                    }, zod_v4_core.$strip>;
-                }, zod_v4_core.$strip>>>;
-                tool_choice: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodLiteral<"auto">, zod.ZodLiteral<"none">, zod.ZodObject<{
+                        parameters: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodJSONSchema>>;
+                        strict: zod.ZodOptional<zod.ZodNullable<zod.ZodBoolean>>;
+                    }, zod_v4_core.$strict>;
+                }, zod_v4_core.$strict>>>;
+                tool_choice: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodLiteral<"auto">, zod.ZodLiteral<"none">, zod.ZodLiteral<"required">, zod.ZodObject<{
                     type: zod.ZodLiteral<"function">;
                     function: zod.ZodObject<{
                         name: zod.ZodString;
-                    }, zod_v4_core.$strip>;
-                }, zod_v4_core.$strip>]>>;
-            }, zod_v4_core.$strip>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+                    }, zod_v4_core.$strict>;
+                }, zod_v4_core.$strict>]>>;
+            }, zod_v4_core.$strict>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
                 success: zod.ZodLiteral<true>;
                 data: zod.ZodObject<{
                     id: zod.ZodString;
@@ -1347,8 +1432,8 @@ declare const apiContract: {
                                 function: zod.ZodObject<{
                                     name: zod.ZodString;
                                     arguments: zod.ZodString;
-                                }, zod_v4_core.$strip>;
-                            }, zod_v4_core.$strip>>>;
+                                }, zod_v4_core.$strict>;
+                            }, zod_v4_core.$strict>>>;
                         }, zod_v4_core.$strip>;
                         finish_reason: zod.ZodEnum<{
                             length: "length";
@@ -1377,6 +1462,8 @@ declare const apiContract: {
                 }, zod_v4_core.$strip>;
             }, zod_v4_core.$strip>], "success">, Record<never, never>, Record<never, never>>;
             sendMessage: _orpc_contract.ContractProcedureBuilderWithInputOutput<zod.ZodObject<{
+                objectId: zod.ZodOptional<zod.ZodString>;
+                sessionId: zod.ZodOptional<zod.ZodString>;
                 message: zod.ZodString;
                 systemPrompt: zod.ZodOptional<zod.ZodString>;
                 model: zod.ZodOptional<zod.ZodString>;
@@ -1406,7 +1493,7 @@ declare const apiContract: {
                 }, zod_v4_core.$strip>;
             }, zod_v4_core.$strip>], "success">, Record<never, never>, Record<never, never>>;
             listHistory: _orpc_contract.ContractProcedureBuilderWithInputOutput<zod.ZodObject<{
-                objectId: zod.ZodString;
+                objectId: zod.ZodOptional<zod.ZodString>;
                 sessionId: zod.ZodString;
                 limit: zod.ZodOptional<zod.ZodNumber>;
                 order: zod.ZodOptional<zod.ZodEnum<{
@@ -1422,17 +1509,19 @@ declare const apiContract: {
                         sessionId: zod.ZodString;
                         request: zod.ZodObject<{
                             model: zod.ZodString;
-                            messages: zod.ZodArray<zod.ZodObject<{
-                                role: zod.ZodEnum<{
-                                    system: "system";
-                                    user: "user";
-                                    assistant: "assistant";
-                                    tool: "tool";
-                                }>;
-                                content: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
+                            messages: zod.ZodArray<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+                                role: zod.ZodLiteral<"system">;
+                                content: zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodObject<{
+                                    type: zod.ZodLiteral<"text">;
+                                    text: zod.ZodString;
+                                }, zod_v4_core.$strict>>]>;
+                                name: zod.ZodOptional<zod.ZodString>;
+                            }, zod_v4_core.$strict>, zod.ZodObject<{
+                                role: zod.ZodLiteral<"user">;
+                                content: zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
                                     type: zod.ZodLiteral<"text">;
                                     text: zod.ZodString;
-                                }, zod_v4_core.$strip>, zod.ZodObject<{
+                                }, zod_v4_core.$strict>, zod.ZodObject<{
                                     type: zod.ZodLiteral<"image_url">;
                                     image_url: zod.ZodObject<{
                                         url: zod.ZodString;
@@ -1441,8 +1530,15 @@ declare const apiContract: {
                                             low: "low";
                                             high: "high";
                                         }>>;
-                                    }, zod_v4_core.$strip>;
-                                }, zod_v4_core.$strip>]>>]>>;
+                                    }, zod_v4_core.$strict>;
+                                }, zod_v4_core.$strict>]>>]>;
+                                name: zod.ZodOptional<zod.ZodString>;
+                            }, zod_v4_core.$strict>, zod.ZodObject<{
+                                role: zod.ZodLiteral<"assistant">;
+                                content: zod.ZodOptional<zod.ZodNullable<zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodObject<{
+                                    type: zod.ZodLiteral<"text">;
+                                    text: zod.ZodString;
+                                }, zod_v4_core.$strict>>]>>>;
                                 name: zod.ZodOptional<zod.ZodString>;
                                 tool_calls: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
                                     id: zod.ZodString;
@@ -1450,10 +1546,16 @@ declare const apiContract: {
                                     function: zod.ZodObject<{
                                         name: zod.ZodString;
                                         arguments: zod.ZodString;
-                                    }, zod_v4_core.$strip>;
-                                }, zod_v4_core.$strip>>>;
-                                tool_call_id: zod.ZodOptional<zod.ZodString>;
-                            }, zod_v4_core.$strip>>;
+                                    }, zod_v4_core.$strict>;
+                                }, zod_v4_core.$strict>>>;
+                            }, zod_v4_core.$strict>, zod.ZodObject<{
+                                role: zod.ZodLiteral<"tool">;
+                                content: zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodObject<{
+                                    type: zod.ZodLiteral<"text">;
+                                    text: zod.ZodString;
+                                }, zod_v4_core.$strict>>]>;
+                                tool_call_id: zod.ZodString;
+                            }, zod_v4_core.$strict>], "role">>;
                         }, zod_v4_core.$strip>;
                         response: zod.ZodObject<{
                             content: zod.ZodString;
@@ -1463,8 +1565,8 @@ declare const apiContract: {
                                 function: zod.ZodObject<{
                                     name: zod.ZodString;
                                     arguments: zod.ZodString;
-                                }, zod_v4_core.$strip>;
-                            }, zod_v4_core.$strip>>>;
+                                }, zod_v4_core.$strict>;
+                            }, zod_v4_core.$strict>>>;
                             finishReason: zod.ZodString;
                             usage: zod.ZodObject<{
                                 prompt_tokens: zod.ZodNumber;
@@ -1586,7 +1688,7 @@ declare const apiContract: {
         };
         sessions: {
             list: _orpc_contract.ContractProcedureBuilderWithInputOutput<zod.ZodObject<{
-                objectId: zod.ZodString;
+                objectId: zod.ZodOptional<zod.ZodString>;
             }, zod_v4_core.$strip>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
                 success: zod.ZodLiteral<true>;
                 data: zod.ZodObject<{
@@ -1627,13 +1729,10 @@ declare const apiContract: {
                 tradeType: zod.ZodEnum<{
                     jsapi: "jsapi";
                     h5: "h5";
-                    app: "app";
-                    native: "native";
-                    mini_program: "mini_program";
                 }>;
                 userId: zod.ZodOptional<zod.ZodString>;
                 metadata: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
-            }, zod_v4_core.$strip>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+            }, zod_v4_core.$strict>, zod.ZodDiscriminatedUnion<[zod.ZodObject<{
                 success: zod.ZodLiteral<true>;
                 data: zod.ZodObject<{
                     provider: zod.ZodEnum<{
@@ -1644,9 +1743,6 @@ declare const apiContract: {
                     tradeType: zod.ZodEnum<{
                         jsapi: "jsapi";
                         h5: "h5";
-                        app: "app";
-                        native: "native";
-                        mini_program: "mini_program";
                     }>;
                     clientParams: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
                     prepayId: zod.ZodOptional<zod.ZodString>;
@@ -1797,7 +1893,18 @@ declare const apiContract: {
  * @module response-schemas
  */
 
-/** 通用 ID 路径参数 Schema。用于 `GET /resource/{id}` 等 RESTful 路由的输入校验。 */
+/**
+ * 通用 ID 路径参数 Schema。用于 `GET /resource/{id}` 等 RESTful 路由的输入校验。
+ * @example
+ * ```ts
+ * import { IdParamSchema } from '@h-ai/api-contract'
+ *
+ * const value = IdParamSchema.parse({
+ *   id: 'example-1'
+ * })
+ * void value
+ * ```
+ */
 declare const IdParamSchema: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;

package/dist/index.js

@@ -1,13 +1,13 @@
-import { iamContract, paginatedSchema } from './chunk-RVSGP2GF.js';
-export { IamAdminCreateUserInputSchema, IamAdminResetPasswordInputSchema, IamAdminUpdateUserInputSchema, IamAgreementDisplaySchema, IamAuthResultSchema, IamChangePasswordInputSchema, IamConfirmPasswordResetInputSchema, IamCreatePermissionInputSchema, IamCreateRoleInputSchema, IamCurrentUserSchema, IamLdapLoginInputSchema, IamListPermissionsInputSchema, IamListUsersInputSchema, IamLoginInputSchema, IamLogoutInputSchema, IamOtpLoginInputSchema, IamPermissionSchema, IamPermissionTypeSchema, IamPublicConfigSchema, IamRefreshTokenDataSchema, IamRefreshTokenInputSchema, IamRegisterInputSchema, IamRequestPasswordResetInputSchema, IamRoleSchema, IamSendOtpDataSchema, IamSendOtpInputSchema, IamTokenPairSchema, IamUpdateCurrentUserInputSchema, IamUpdateRoleInputSchema, IamUserIdInputSchema, IamUserSchema, PaginationQuerySchema, paginatedSchema } from './chunk-RVSGP2GF.js';
-import { storageContract } from './chunk-3QSKWVLP.js';
-export { StorageDeleteFilesInputSchema, StorageFileKeyInputSchema, StorageFileMetadataSchema, StorageListFilesDataSchema, StorageListFilesInputSchema, StoragePresignDownloadInputSchema, StoragePresignUploadInputSchema, StoragePresignedUrlSchema } from './chunk-3QSKWVLP.js';
-import { aiContract } from './chunk-VSPYX4DD.js';
-export { AUDIO_WS_PATH, AiAssistantMessageSchema, AiChatCompletionChoiceSchema, AiChatCompletionDataSchema, AiChatCompletionInputSchema, AiChatHistoryDataSchema, AiChatHistoryInputSchema, AiChatMessageSchema, AiChatRecordSchema, AiImageContentSchema, AiMemoryEntrySchema, AiMemoryListDataSchema, AiMemoryListInputSchema, AiMemoryRecallDataSchema, AiMemoryRecallInputSchema, AiMemoryTypeSchema, AiMessageContentSchema, AiMessageRoleSchema, AiSendMessageDataSchema, AiSendMessageInputSchema, AiSessionInfoSchema, AiSessionListDataSchema, AiSessionListInputSchema, AiTextContentSchema, AiTokenUsageSchema, AiToolCallSchema, AiToolDefinitionSchema, AiToolParameterSchema, AudioFormatSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema } from './chunk-VSPYX4DD.js';
-import { paymentContract } from './chunk-JIQINMLG.js';
-export { PaymentCreateOrderDataSchema, PaymentCreateOrderInputSchema, PaymentNotifyMessageSchema, PaymentOrderSchema, PaymentProviderSchema, PaymentQueryOrderInputSchema, PaymentRefundDataSchema, PaymentRefundInputSchema, PaymentStripeNotifyDataSchema, PaymentTradeTypeSchema } from './chunk-JIQINMLG.js';
-import { pathOf, route, HaiVoidResultSchema, haiResultSchema } from './chunk-CUU2F6YD.js';
-export { HaiErrorSchema } from './chunk-CUU2F6YD.js';
+import { iamContract, paginatedSchema } from './chunk-G3SME6V5.js';
+export { IamAdminCreateUserInputSchema, IamAdminResetPasswordInputSchema, IamAdminUpdateUserInputSchema, IamAgreementDisplaySchema, IamAuthResultSchema, IamChangePasswordInputSchema, IamConfirmPasswordResetInputSchema, IamCreatePermissionInputSchema, IamCreateRoleInputSchema, IamCurrentUserSchema, IamLdapLoginInputSchema, IamListPermissionsInputSchema, IamListUsersInputSchema, IamLoginInputSchema, IamLogoutInputSchema, IamOtpLoginInputSchema, IamPermissionSchema, IamPermissionTypeSchema, IamPublicConfigSchema, IamRefreshTokenDataSchema, IamRefreshTokenInputSchema, IamRegisterInputSchema, IamRequestPasswordResetInputSchema, IamRoleSchema, IamSendOtpDataSchema, IamSendOtpInputSchema, IamTokenPairSchema, IamUpdateCurrentUserInputSchema, IamUpdateRoleInputSchema, IamUserIdInputSchema, IamUserSchema, PaginationQuerySchema, paginatedSchema } from './chunk-G3SME6V5.js';
+import { storageContract } from './chunk-IVZVAWEF.js';
+export { StorageDeleteFilesInputSchema, StorageDeleteSummarySchema, StorageFileKeyInputSchema, StorageFileMetadataSchema, StorageListFilesDataSchema, StorageListFilesInputSchema, StoragePresignDownloadInputSchema, StoragePresignUploadInputSchema, StoragePresignedUrlSchema } from './chunk-IVZVAWEF.js';
+import { aiContract } from './chunk-G55ATYDA.js';
+export { AUDIO_WS_PATH, AiAssistantMessageSchema, AiChatCompletionChoiceSchema, AiChatCompletionDataSchema, AiChatCompletionInputSchema, AiChatHistoryDataSchema, AiChatHistoryInputSchema, AiChatMessageSchema, AiChatRecordSchema, AiImageContentSchema, AiMemoryEntrySchema, AiMemoryListDataSchema, AiMemoryListInputSchema, AiMemoryRecallDataSchema, AiMemoryRecallInputSchema, AiMemoryTypeSchema, AiMessageContentSchema, AiMessageRoleSchema, AiSendMessageDataSchema, AiSendMessageInputSchema, AiSessionInfoSchema, AiSessionListDataSchema, AiSessionListInputSchema, AiTextContentSchema, AiTokenUsageSchema, AiToolCallSchema, AiToolDefinitionSchema, AudioFormatSchema, AudioWsClientMessageSchema, AudioWsDoneMessageSchema, AudioWsStartMessageSchema, AudioWsTextMessageSchema } from './chunk-G55ATYDA.js';
+import { paymentContract } from './chunk-R5GDWFYC.js';
+export { PaymentCreateOrderDataSchema, PaymentCreateOrderInputSchema, PaymentNotifyMessageSchema, PaymentOrderSchema, PaymentProviderSchema, PaymentQueryOrderInputSchema, PaymentRefundDataSchema, PaymentRefundInputSchema, PaymentStripeNotifyDataSchema, PaymentTradeTypeSchema } from './chunk-R5GDWFYC.js';
+import { pathOf, route, HaiVoidResultSchema, haiResultSchema } from './chunk-JKPLID6E.js';
+export { HaiErrorSchema } from './chunk-JKPLID6E.js';
 import { z } from 'zod';
 
 // src/composition/create-api-contract.ts

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/composition/create-api-contract.ts","../src/api-contract-main.ts","../src/common/response-schemas.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAsCO,SAAS,kBAA4D,OAAA,EAAmC;AAC7G,EAAA,MAAM,WAA8C,EAAC;AAErD,EAAA,KAAA,MAAW,CAAC,MAAA,EAAQ,cAAc,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAC9D,IAAA,IAAI,cAAA,EAAgB;AAClB,MAAA,QAAA,CAAS,MAAM,CAAA,GAAI,cAAA;AAAA,IACrB;AAAA,EACF;AAEA,EAAA,OAAO,QAAA;AACT;;;ACjBO,IAAM,WAAA,GAAc;AAAA;AAAA,EAEzB,MAAA,EAAQ,iBAAA;AAAA;AAAA,EAGR,eAAA;AAAA;AAAA,EAEA,gBAAA,EAAkB,mBAAA;AAAA;AAAA,EAElB,eAAA;AAAA;AAAA,EAEA,KAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA;AAAA,EAIA,GAAA,EAAK,WAAA;AAAA;AAAA,EAEL,OAAA,EAAS,eAAA;AAAA;AAAA,EAET,EAAA,EAAI,UAAA;AAAA;AAAA,EAEJ,OAAA,EAAS;AACX;AC7CO,IAAM,aAAA,GAAgB,EAAE,MAAA,CAAO;AAAA,EACpC,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC;AACtB,CAAC","file":"index.js","sourcesContent":["/**\n * @h-ai/api-contract — Contract 组合工具\n *\n * 提供将多个领域 contract 组合为应用级 contract 的工厂函数。\n * 仅描述接口边界，不包含任何 procedure 实现。\n * @module create-api-contract\n */\n\nimport type { AnyContractRouter } from '@orpc/contract'\n\n/** API contract 组合输入。key 为领域名称，value 为领域 contract 或 false/undefined（跳过该领域）。 */\nexport type CreateApiContractOptions = Record<string, AnyContractRouter | false | undefined>\n\n/** 根据输入过滤 false/undefined 后得到的应用级 contract 类型。 */\nexport type CreatedApiContract<T extends CreateApiContractOptions> = {\n  readonly [K in keyof T as T[K] extends false | undefined ? never : K]: Exclude<T[K], false | undefined>\n}\n\n/**\n * 按领域组合应用级 API contract。\n *\n * contract 只描述接口边界；具体的 procedure 实现由 `@h-ai/serv` 的 feature 模块或应用层提供。\n * 传入 `false` 或 `undefined` 的领域将从最终 contract 中移除，类型也会同步收窄。\n *\n * @param options - 各领域 contract（传 false/undefined 表示禁用该领域）\n * @returns 过滤后的应用级 oRPC contract router\n *\n * @example\n * ```ts\n * import { apiContract } from '@h-ai/api-contract'\n *\n * const myContract = apiContract.create({\n *   iam: apiContract.iam,\n *   storage: apiContract.storage,\n *   payment: false, // 未启用，不会出现在 contract 或 OpenAPI spec 中\n * })\n * ```\n */\nexport function createApiContract<const T extends CreateApiContractOptions>(options: T): CreatedApiContract<T> {\n  const contract: Record<string, AnyContractRouter> = {}\n\n  for (const [domain, domainContract] of Object.entries(options)) {\n    if (domainContract) {\n      contract[domain] = domainContract\n    }\n  }\n\n  return contract as CreatedApiContract<T>\n}\n","/**\n * @h-ai/api-contract — 统一命名空间入口\n *\n * 将 contract 组合工厂、HaiResult schema 工具与各领域 contract 集中暴露在\n * `apiContract.*` 之下。应用层只需 `import { apiContract } from '@h-ai/api-contract'`\n * 即可完成所有 contract 装配，无需感知子模块路径或 `@orpc/contract` 实现细节。\n *\n * @module api-contract-main\n *\n * @example\n * ```ts\n * import { apiContract } from '@h-ai/api-contract'\n *\n * const contract = apiContract.create({\n *   iam: apiContract.iam,\n *   storage: apiContract.storage,\n *   ai: apiContract.ai,\n * })\n * ```\n */\n\nimport { aiContract } from './ai/ai-contract.js'\nimport { paginatedSchema } from './common/pagination-schemas.js'\nimport { haiResultSchema, HaiVoidResultSchema } from './common/result-schemas.js'\nimport { pathOf, route } from './common/route.js'\nimport { createApiContract } from './composition/create-api-contract.js'\nimport { iamContract } from './iam/iam-contract.js'\nimport { paymentContract } from './payment/payment-contract.js'\nimport { storageContract } from './storage/storage-contract.js'\n\n/** hai-framework API contract 统一入口（扁平命名空间）。 */\nexport const apiContract = {\n  /** 组合任意领域 contract，过滤掉 `false` / `undefined`，输出可被 serv 挂载的 router。 */\n  create: createApiContract,\n\n  /** 把 data schema 包成 `HaiResult<T>` 区分联合，供 procedure `.output(...)` 使用。 */\n  haiResultSchema,\n  /** `HaiResult<void>` 常量 schema。 */\n  voidResultSchema: HaiVoidResultSchema,\n  /** 分页响应 schema 工厂。 */\n  paginatedSchema,\n  /** 创建 oRPC contract 路由节点，供自定义 contract 定义 HTTP 元数据。 */\n  route,\n  /** 从 contract procedure 读取其唯一业务路径。 */\n  pathOf,\n\n  // 领域 contract（框架内置）\n  /** IAM 领域 contract（认证 / 用户 / 角色 / 权限）。 */\n  iam: iamContract,\n  /** Storage 领域 contract（预签名 URL / 文件管理）。 */\n  storage: storageContract,\n  /** AI 领域 contract（聊天 / 记忆 / 会话）。 */\n  ai: aiContract,\n  /** Payment 领域 contract。 */\n  payment: paymentContract,\n}\n","/**\n * @h-ai/api-contract — 通用响应 Schema\n *\n * 跨领域共用的基础请求 / 响应结构，如 ID 路径参数。\n * @module response-schemas\n */\n\nimport { z } from 'zod'\n\n/** 通用 ID 路径参数 Schema。用于 `GET /resource/{id}` 等 RESTful 路由的输入校验。 */\nexport const IdParamSchema = z.object({\n  id: z.string().min(1),\n})\n"]}
+{"version":3,"sources":["../src/composition/create-api-contract.ts","../src/api-contract-main.ts","../src/common/response-schemas.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAyDO,SAAS,kBAA4D,OAAA,EAAmC;AAC7G,EAAA,MAAM,WAA8C,EAAC;AAErD,EAAA,KAAA,MAAW,CAAC,MAAA,EAAQ,cAAc,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAC9D,IAAA,IAAI,cAAA,EAAgB;AAClB,MAAA,QAAA,CAAS,MAAM,CAAA,GAAI,cAAA;AAAA,IACrB;AAAA,EACF;AAEA,EAAA,OAAO,QAAA;AACT;;;AC1BO,IAAM,WAAA,GAAc;AAAA;AAAA,EAEzB,MAAA,EAAQ,iBAAA;AAAA;AAAA,EAGR,eAAA;AAAA;AAAA,EAEA,gBAAA,EAAkB,mBAAA;AAAA;AAAA,EAElB,eAAA;AAAA;AAAA,EAEA,KAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA;AAAA,EAIA,GAAA,EAAK,WAAA;AAAA;AAAA,EAEL,OAAA,EAAS,eAAA;AAAA;AAAA,EAET,EAAA,EAAI,UAAA;AAAA;AAAA,EAEJ,OAAA,EAAS;AACX;AC5CO,IAAM,aAAA,GAAgB,EAAE,MAAA,CAAO;AAAA,EACpC,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC;AACtB,CAAC","file":"index.js","sourcesContent":["/**\n * @h-ai/api-contract — Contract 组合工具\n *\n * 提供将多个领域 contract 组合为应用级 contract 的工厂函数。\n * 仅描述接口边界，不包含任何 procedure 实现。\n * @module create-api-contract\n */\n\nimport type { AnyContractRouter } from '@orpc/contract'\n\n/**\n * API contract 组合输入。key 为领域名称，value 为领域 contract 或 false/undefined（跳过该领域）。\n * @example\n * ```ts\n * import type { CreateApiContractOptions } from '@h-ai/api-contract'\n * import { apiContract } from '@h-ai/api-contract'\n *\n * const parts = { iam: apiContract.iam, payment: false } satisfies CreateApiContractOptions\n * const contract = apiContract.create(parts)\n * void contract.iam.auth.login\n * ```\n */\nexport type CreateApiContractOptions = Record<string, AnyContractRouter | false | undefined>\n\n/**\n * 根据输入过滤 false/undefined 后得到的应用级 contract 类型。\n * @example\n * ```ts\n * import type { CreatedApiContract } from '@h-ai/api-contract'\n * import { apiContract } from '@h-ai/api-contract'\n *\n * const parts = { iam: apiContract.iam, payment: false } as const\n * const contract: CreatedApiContract<typeof parts> = apiContract.create(parts)\n * void contract.iam.auth.login\n * ```\n */\nexport type CreatedApiContract<T extends CreateApiContractOptions> = {\n  readonly [K in keyof T as T[K] extends false | undefined ? never : K]: Exclude<T[K], false | undefined>\n}\n\n/**\n * 按领域组合应用级 API contract。\n *\n * contract 只描述接口边界；具体的 procedure 实现由 `@h-ai/serv` 的 feature 模块或应用层提供。\n * 传入 `false` 或 `undefined` 的领域将从最终 contract 中移除，类型也会同步收窄。\n *\n * @param options - 各领域 contract（传 false/undefined 表示禁用该领域）\n * @returns 过滤后的应用级 oRPC contract router\n * @example\n * ```ts\n * import { apiContract } from '@h-ai/api-contract'\n *\n * const contract = apiContract.create({ iam: apiContract.iam, payment: false })\n * const loginPath = apiContract.pathOf(contract.iam.auth.login)\n * void loginPath\n * ```\n */\nexport function createApiContract<const T extends CreateApiContractOptions>(options: T): CreatedApiContract<T> {\n  const contract: Record<string, AnyContractRouter> = {}\n\n  for (const [domain, domainContract] of Object.entries(options)) {\n    if (domainContract) {\n      contract[domain] = domainContract\n    }\n  }\n\n  return contract as CreatedApiContract<T>\n}\n","/**\n * @h-ai/api-contract — 统一命名空间入口\n *\n * 将 contract 组合工厂、HaiResult schema 工具与各领域 contract 集中暴露在\n * `apiContract.*` 之下。应用层只需 `import { apiContract } from '@h-ai/api-contract'`\n * 即可完成所有 contract 装配，无需感知子模块路径或 `@orpc/contract` 实现细节。\n *\n * @module api-contract-main\n *\n * @example\n * ```ts\n * import { apiContract } from '@h-ai/api-contract'\n *\n * const contract = apiContract.create({\n *   iam: apiContract.iam,\n *   storage: apiContract.storage,\n *   ai: apiContract.ai,\n * })\n * ```\n */\n\nimport { aiContract } from './ai/ai-contract.js'\nimport { paginatedSchema } from './common/pagination-schemas.js'\nimport { haiResultSchema, HaiVoidResultSchema } from './common/result-schemas.js'\nimport { pathOf, route } from './common/route.js'\nimport { createApiContract } from './composition/create-api-contract.js'\nimport { iamContract } from './iam/iam-contract.js'\nimport { paymentContract } from './payment/payment-contract.js'\nimport { storageContract } from './storage/storage-contract.js'\n\n/**\n * hai-framework API contract 统一入口（扁平命名空间）。\n * @example\n * ```ts\n * import { apiContract } from '@h-ai/api-contract'\n *\n * const contract = apiContract.create({ iam: apiContract.iam, payment: false })\n * const loginPath = apiContract.pathOf(contract.iam.auth.login)\n * void loginPath\n * ```\n */\nexport const apiContract = {\n  /** 组合任意领域 contract，过滤掉 `false` / `undefined`，输出可被 serv 挂载的 router。 */\n  create: createApiContract,\n\n  /** 把 data schema 包成 `HaiResult<T>` 区分联合，供 procedure `.output(...)` 使用。 */\n  haiResultSchema,\n  /** `HaiResult<void>` 常量 schema。 */\n  voidResultSchema: HaiVoidResultSchema,\n  /** 分页响应 schema 工厂。 */\n  paginatedSchema,\n  /** 创建 oRPC contract 路由节点，供自定义 contract 定义 HTTP 元数据。 */\n  route,\n  /** 从 contract procedure 读取其唯一业务路径。 */\n  pathOf,\n\n  // 领域 contract（框架内置）\n  /** IAM 领域 contract（认证 / 用户 / 角色 / 权限）。 */\n  iam: iamContract,\n  /** Storage 领域 contract（预签名 URL / 文件管理）。 */\n  storage: storageContract,\n  /** AI 领域 contract（聊天 / 记忆 / 会话）。 */\n  ai: aiContract,\n  /** Payment 领域 contract。 */\n  payment: paymentContract,\n}\n","/**\n * @h-ai/api-contract — 通用响应 Schema\n *\n * 跨领域共用的基础请求 / 响应结构，如 ID 路径参数。\n * @module response-schemas\n */\n\nimport { z } from 'zod'\n\n/**\n * 通用 ID 路径参数 Schema。用于 `GET /resource/{id}` 等 RESTful 路由的输入校验。\n * @example\n * ```ts\n * import { IdParamSchema } from '@h-ai/api-contract'\n *\n * const value = IdParamSchema.parse({\n *   id: 'example-1'\n * })\n * void value\n * ```\n */\nexport const IdParamSchema = z.object({\n  id: z.string().min(1),\n})\n"]}