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

package/dist/index.js

@@ -1,13 +1,17 @@
-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 } from './chunk-5XQIW67A.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 } from './chunk-5XQIW67A.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 { feedbackContract } from './chunk-OQG36ECJ.js';
+export { FeedbackAppendEvidenceInputSchema, FeedbackAttachmentDataSchema, FeedbackAttachmentInputSchema, FeedbackAttachmentQuerySchema, FeedbackAttachmentSchema, FeedbackCollectionStatusSchema, FeedbackCompleteInputSchema, FeedbackDetailSchema, FeedbackEvidenceAckSchema, FeedbackEvidenceInputSchema, FeedbackEvidenceQuerySchema, FeedbackEvidenceSchema, FeedbackExportInputSchema, FeedbackExportQuerySchema, FeedbackHistorySchema, FeedbackIdInputSchema, FeedbackJobSchema, FeedbackListInputSchema, FeedbackNotificationStatusSchema, FeedbackReportSchema, FeedbackRetryInputSchema, FeedbackSetStatusInputSchema, FeedbackStatusSchema, FeedbackSubmitInputSchema, FeedbackUploadInputSchema } from './chunk-OQG36ECJ.js';
+import { paginatedSchema } from './chunk-CCCPHO6X.js';
+export { PaginationQuerySchema, paginatedSchema } from './chunk-CCCPHO6X.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
@@ -43,7 +47,9 @@ var apiContract = {
   /** AI 领域 contract（聊天 / 记忆 / 会话）。 */
   ai: aiContract,
   /** Payment 领域 contract。 */
-  payment: paymentContract
+  payment: paymentContract,
+  /** 用户反馈、证据采集和离线导出。 */
+  feedback: feedbackContract
 };
 var IdParamSchema = z.object({
   id: z.string().min(1)

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;;;ACzBO,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,eAAA;AAAA;AAAA,EAET,QAAA,EAAU;AACZ;AC/CO,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 { feedbackContract } from './feedback/feedback-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  feedback: feedbackContract,\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"]}

package/dist/payment/index.d.ts

@@ -2,7 +2,16 @@ import * as _orpc_contract from '@orpc/contract';
 import { z } from 'zod';
 import { HaiResult } from '@h-ai/core';
 
-/** Payment 领域 oRPC contract。 */
+/**
+ * Payment 领域 oRPC contract。
+ * @example
+ * ```ts
+ * import { apiContract } from '@h-ai/api-contract'
+ *
+ * const contract = apiContract.payment
+ * void contract
+ * ```
+ */
 declare const paymentContract: {
     orders: {
         create: _orpc_contract.ContractProcedureBuilderWithInputOutput<z.ZodObject<{
@@ -16,13 +25,10 @@ declare const paymentContract: {
             tradeType: z.ZodEnum<{
                 jsapi: "jsapi";
                 h5: "h5";
-                app: "app";
-                native: "native";
-                mini_program: "mini_program";
             }>;
             userId: z.ZodOptional<z.ZodString>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
             success: z.ZodLiteral<true>;
             data: z.ZodObject<{
                 provider: z.ZodEnum<{
@@ -33,9 +39,6 @@ declare const paymentContract: {
                 tradeType: z.ZodEnum<{
                     jsapi: "jsapi";
                     h5: "h5";
-                    app: "app";
-                    native: "native";
-                    mini_program: "mini_program";
                 }>;
                 clientParams: z.ZodRecord<z.ZodString, z.ZodUnknown>;
                 prepayId: z.ZodOptional<z.ZodString>;
@@ -62,10 +65,10 @@ declare const paymentContract: {
                 transactionId: z.ZodOptional<z.ZodString>;
                 status: z.ZodEnum<{
                     pending: "pending";
+                    failed: "failed";
                     paid: "paid";
                     closed: "closed";
                     refunded: "refunded";
-                    failed: "failed";
                 }>;
                 amount: z.ZodNumber;
                 paidAt: z.ZodOptional<z.ZodISODateTime>;
@@ -177,23 +180,64 @@ declare const paymentContract: {
         }, z.core.$strip>], "success">, Record<never, never>, Record<never, never>>;
     };
 };
+/**
+ * payment 领域公开 procedure 契约的完整类型。
+ * @example
+ * ```ts
+ * import type { PaymentContract } from '@h-ai/api-contract'
+ * import { apiContract } from '@h-ai/api-contract'
+ *
+ * const contract: PaymentContract = apiContract.payment
+ * void contract
+ * ```
+ */
 type PaymentContract = typeof paymentContract;
 
-/** 支付渠道 Schema。 */
+/**
+ * 支付渠道 Schema。
+ * @example
+ * ```ts
+ * import { PaymentProviderSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentProviderSchema.parse('wechat')
+ * void value
+ * ```
+ */
 declare const PaymentProviderSchema: z.ZodEnum<{
     wechat: "wechat";
     alipay: "alipay";
     stripe: "stripe";
 }>;
-/** 支付交易类型 Schema。 */
+/**
+ * 完整实现的支付类型：微信 jsapi，支付宝/Stripe h5。
+ * @example
+ * ```ts
+ * import { PaymentTradeTypeSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentTradeTypeSchema.parse('jsapi')
+ * void value
+ * ```
+ */
 declare const PaymentTradeTypeSchema: z.ZodEnum<{
     jsapi: "jsapi";
     h5: "h5";
-    app: "app";
-    native: "native";
-    mini_program: "mini_program";
 }>;
-/** 创建支付订单入参 Schema。 */
+/**
+ * 创建支付订单入参 Schema。
+ * @example
+ * ```ts
+ * import { PaymentCreateOrderInputSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentCreateOrderInputSchema.parse({
+ *   provider: 'wechat',
+ *   amount: 100,
+ *   description: 'Example order',
+ *   tradeType: 'jsapi',
+ *   userId: 'example-openid'
+ * })
+ * void value
+ * ```
+ */
 declare const PaymentCreateOrderInputSchema: z.ZodObject<{
     provider: z.ZodEnum<{
         wechat: "wechat";
@@ -205,14 +249,32 @@ declare const PaymentCreateOrderInputSchema: z.ZodObject<{
     tradeType: z.ZodEnum<{
         jsapi: "jsapi";
         h5: "h5";
-        app: "app";
-        native: "native";
-        mini_program: "mini_program";
     }>;
     userId: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, z.core.$strip>;
-/** 创建支付订单业务数据 Schema。 */
+}, z.core.$strict>;
+/**
+ * 创建支付订单业务数据 Schema。
+ * @example
+ * ```ts
+ * import { PaymentCreateOrderDataSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentCreateOrderDataSchema.parse({
+ *   provider: 'wechat',
+ *   tradeType: 'jsapi',
+ *   prepayId: 'example-prepay',
+ *   clientParams: {
+ *     appId: 'wx-example',
+ *     timeStamp: '1767225600',
+ *     nonceStr: 'example-nonce',
+ *     package: 'prepay_id=example-prepay',
+ *     signType: 'RSA',
+ *     paySign: 'example-only-signature'
+ *   }
+ * })
+ * void value
+ * ```
+ */
 declare const PaymentCreateOrderDataSchema: z.ZodObject<{
     provider: z.ZodEnum<{
         wechat: "wechat";
@@ -222,32 +284,67 @@ declare const PaymentCreateOrderDataSchema: z.ZodObject<{
     tradeType: z.ZodEnum<{
         jsapi: "jsapi";
         h5: "h5";
-        app: "app";
-        native: "native";
-        mini_program: "mini_program";
     }>;
     clientParams: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     prepayId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/** 查询支付订单入参 Schema。 */
+/**
+ * 查询支付订单入参 Schema。
+ * @example
+ * ```ts
+ * import { PaymentQueryOrderInputSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentQueryOrderInputSchema.parse({
+ *   orderNo: 'order_1'
+ * })
+ * void value
+ * ```
+ */
 declare const PaymentQueryOrderInputSchema: z.ZodObject<{
     orderNo: z.ZodString;
 }, z.core.$strip>;
-/** 支付订单业务数据 Schema。 */
+/**
+ * 支付订单业务数据 Schema。
+ * @example
+ * ```ts
+ * import { PaymentOrderSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentOrderSchema.parse({
+ *   orderNo: 'order_1',
+ *   status: 'pending',
+ *   amount: 0
+ * })
+ * void value
+ * ```
+ */
 declare const PaymentOrderSchema: z.ZodObject<{
     orderNo: z.ZodString;
     transactionId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
         pending: "pending";
+        failed: "failed";
         paid: "paid";
         closed: "closed";
         refunded: "refunded";
-        failed: "failed";
     }>;
     amount: z.ZodNumber;
     paidAt: z.ZodOptional<z.ZodISODateTime>;
 }, z.core.$strip>;
-/** 退款入参 Schema。 */
+/**
+ * 退款入参 Schema。
+ * @example
+ * ```ts
+ * import { PaymentRefundInputSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentRefundInputSchema.parse({
+ *   provider: 'wechat',
+ *   orderNo: 'order_1',
+ *   refundNo: 'refund_1',
+ *   amount: 1
+ * })
+ * void value
+ * ```
+ */
 declare const PaymentRefundInputSchema: z.ZodObject<{
     provider: z.ZodEnum<{
         wechat: "wechat";
@@ -259,7 +356,20 @@ declare const PaymentRefundInputSchema: z.ZodObject<{
     amount: z.ZodNumber;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/** 退款业务数据 Schema。 */
+/**
+ * 退款业务数据 Schema。
+ * @example
+ * ```ts
+ * import { PaymentRefundDataSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentRefundDataSchema.parse({
+ *   refundNo: 'refund_1',
+ *   refundId: 'example',
+ *   status: 'processing'
+ * })
+ * void value
+ * ```
+ */
 declare const PaymentRefundDataSchema: z.ZodObject<{
     refundNo: z.ZodString;
     refundId: z.ZodString;
@@ -269,17 +379,97 @@ declare const PaymentRefundDataSchema: z.ZodObject<{
         processing: "processing";
     }>;
 }, z.core.$strip>;
-/** 微信/支付宝通知响应 Schema。 */
+/**
+ * 微信/支付宝通知响应 Schema。
+ * @example
+ * ```ts
+ * import { PaymentNotifyMessageSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentNotifyMessageSchema.parse({
+ *   code: 'example-1',
+ *   message: 'example'
+ * })
+ * void value
+ * ```
+ */
 declare const PaymentNotifyMessageSchema: z.ZodObject<{
     code: z.ZodString;
     message: z.ZodString;
 }, z.core.$strip>;
-/** Stripe 通知响应 Schema。 */
+/**
+ * Stripe 通知响应 Schema。
+ * @example
+ * ```ts
+ * import { PaymentStripeNotifyDataSchema } from '@h-ai/api-contract'
+ *
+ * const value = PaymentStripeNotifyDataSchema.parse({
+ *   received: true
+ * })
+ * void value
+ * ```
+ */
 declare const PaymentStripeNotifyDataSchema: z.ZodObject<{
     received: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * 按渠道和已实现支付方式创建订单的请求。
+ * @example
+ * ```ts
+ * import type { PaymentCreateOrderInput } from '@h-ai/api-contract'
+ * import { PaymentCreateOrderInputSchema } from '@h-ai/api-contract'
+ *
+ * const value: PaymentCreateOrderInput = PaymentCreateOrderInputSchema.parse({
+ *   provider: 'wechat',
+ *   amount: 100,
+ *   description: 'Example order',
+ *   tradeType: 'jsapi',
+ *   userId: 'example-openid'
+ * })
+ * void value
+ * ```
+ */
 type PaymentCreateOrderInput = z.infer<typeof PaymentCreateOrderInputSchema>;
+/**
+ * 以 HaiResult 区分成功业务数据和公共错误的 PaymentCreateOrderOutput 响应。
+ * @example
+ * ```ts
+ * import type { PaymentCreateOrderOutput } from '@h-ai/api-contract'
+ * import { PaymentCreateOrderDataSchema } from '@h-ai/api-contract'
+ * import { ok } from '@h-ai/core'
+ *
+ * const response: PaymentCreateOrderOutput = ok(PaymentCreateOrderDataSchema.parse({
+ *   provider: 'wechat',
+ *   tradeType: 'jsapi',
+ *   prepayId: 'example-prepay',
+ *   clientParams: {
+ *     appId: 'wx-example',
+ *     timeStamp: '1767225600',
+ *     nonceStr: 'example-nonce',
+ *     package: 'prepay_id=example-prepay',
+ *     signType: 'RSA',
+ *     paySign: 'example-only-signature'
+ *   }
+ * }))
+ * if (response.success) void response.data
+ * ```
+ */
 type PaymentCreateOrderOutput = HaiResult<z.infer<typeof PaymentCreateOrderDataSchema>>;
+/**
+ * 退款请求，金额单位与支付契约一致。
+ * @example
+ * ```ts
+ * import type { PaymentRefundInput } from '@h-ai/api-contract'
+ * import { PaymentRefundInputSchema } from '@h-ai/api-contract'
+ *
+ * const value: PaymentRefundInput = PaymentRefundInputSchema.parse({
+ *   provider: 'wechat',
+ *   orderNo: 'order_1',
+ *   refundNo: 'refund_1',
+ *   amount: 1
+ * })
+ * void value
+ * ```
+ */
 type PaymentRefundInput = z.infer<typeof PaymentRefundInputSchema>;
 
 export { type PaymentContract, PaymentCreateOrderDataSchema, type PaymentCreateOrderInput, PaymentCreateOrderInputSchema, type PaymentCreateOrderOutput, PaymentNotifyMessageSchema, PaymentOrderSchema, PaymentProviderSchema, PaymentQueryOrderInputSchema, PaymentRefundDataSchema, type PaymentRefundInput, PaymentRefundInputSchema, PaymentStripeNotifyDataSchema, PaymentTradeTypeSchema, paymentContract };

package/dist/payment/index.js

@@ -1,4 +1,4 @@
-export { PaymentCreateOrderDataSchema, PaymentCreateOrderInputSchema, PaymentNotifyMessageSchema, PaymentOrderSchema, PaymentProviderSchema, PaymentQueryOrderInputSchema, PaymentRefundDataSchema, PaymentRefundInputSchema, PaymentStripeNotifyDataSchema, PaymentTradeTypeSchema, paymentContract } from '../chunk-JIQINMLG.js';
-import '../chunk-CUU2F6YD.js';
+export { PaymentCreateOrderDataSchema, PaymentCreateOrderInputSchema, PaymentNotifyMessageSchema, PaymentOrderSchema, PaymentProviderSchema, PaymentQueryOrderInputSchema, PaymentRefundDataSchema, PaymentRefundInputSchema, PaymentStripeNotifyDataSchema, PaymentTradeTypeSchema, paymentContract } from '../chunk-R5GDWFYC.js';
+import '../chunk-JKPLID6E.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map