@h-ai/feedback 0.1.0-alpha.73 → 0.1.0-alpha.75

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import * as _h_ai_core from '@h-ai/core';
 import { HaiResult, PaginatedResult } from '@h-ai/core';
-import { FeedbackBudget, FeedbackSubmitInput, FeedbackReport, FeedbackListInput, FeedbackDetail, FeedbackEvidenceQuery, FeedbackEvidence, FeedbackSetStatusInput, FeedbackAppendEvidenceInput, FeedbackCompleteInput, FeedbackUploadInput, FeedbackAttachment, FeedbackAttachmentData, FeedbackRetryInput, FeedbackExportInput, FeedbackJob } from '@h-ai/api-contract/feedback';
+import { FeedbackEvidenceInput, FeedbackReport, FeedbackBudget, FeedbackSubmitInput, FeedbackListInput, FeedbackDetail, FeedbackEvidenceQuery, FeedbackEvidence, FeedbackSetStatusInput, FeedbackAppendEvidenceInput, FeedbackCompleteInput, FeedbackUploadInput, FeedbackAttachment, FeedbackAttachmentData, FeedbackRetryInput, FeedbackExportInput, FeedbackJob } from '@h-ai/api-contract/feedback';
 export { FeedbackAppendEvidenceInput, FeedbackAttachment, FeedbackAttachmentData, FeedbackCompleteInput, FeedbackDetail, FeedbackEvidence, FeedbackEvidenceQuery, FeedbackExportInput, FeedbackJob, FeedbackListInput, FeedbackReport, FeedbackRetryInput, FeedbackSetStatusInput, FeedbackSubmitInput, FeedbackUploadInput } from '@h-ai/api-contract/feedback';
 
 /**
@@ -23,14 +23,27 @@ declare const FeedbackConfigSchema: z.ZodObject<{
         console: "console";
         reach: "reach";
     }>>;
+    consoleContent: z.ZodDefault<z.ZodEnum<{
+        metadata: "metadata";
+        summary: "summary";
+    }>>;
     recipients: z.ZodDefault<z.ZodArray<z.ZodString>>;
     notificationProvider: z.ZodDefault<z.ZodString>;
     adminUrl: z.ZodOptional<z.ZodURL>;
     collectionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    businessCollectionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    webhookUrl: z.ZodDefault<z.ZodString>;
+    webhookSecret: z.ZodDefault<z.ZodString>;
+    webhookTimeoutMs: z.ZodDefault<z.ZodNumber>;
     workerIntervalMs: z.ZodDefault<z.ZodNumber>;
     leaseMs: z.ZodDefault<z.ZodNumber>;
     maxAttempts: z.ZodDefault<z.ZodNumber>;
     retentionDays: z.ZodDefault<z.ZodNumber>;
+    maxReportsPerUserDay: z.ZodDefault<z.ZodNumber>;
+    maxBytesPerUserDay: z.ZodDefault<z.ZodNumber>;
+    maxStoredBytesPerScope: z.ZodDefault<z.ZodNumber>;
+    maxExportsPerReport: z.ZodDefault<z.ZodNumber>;
+    exportRetentionHours: z.ZodDefault<z.ZodNumber>;
     envAllowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
     maxTotalBytes: z.ZodDefault<z.ZodNumber>;
     maxAttachmentBytes: z.ZodDefault<z.ZodNumber>;
@@ -78,6 +91,7 @@ declare const HaiFeedbackError: {
     LIMIT_EXCEEDED: _h_ai_core.HaiErrorDef;
     INVALID_INPUT: _h_ai_core.HaiErrorDef;
     CHECKSUM_MISMATCH: _h_ai_core.HaiErrorDef;
+    QUOTA_EXCEEDED: _h_ai_core.HaiErrorDef;
 };
 /**
  * 由可信服务端认证与授权策略生成的范围；HTTP 输入不能指定此对象。
@@ -93,6 +107,71 @@ interface FeedbackContext {
     userId: string;
     permissions?: readonly string[];
 }
+/**
+ * 业务采集附件；ID 在同一反馈内稳定，正文由框架计算校验和并写入私有存储。
+ * @example
+ * ```ts
+ * import type { FeedbackCollectedAttachment } from '@h-ai/feedback'
+ * const file: FeedbackCollectedAttachment = { id: 'logs', name: 'logs.txt', contentType: 'text/plain', bytes: new TextEncoder().encode('diagnostics') }
+ * void file
+ * ```
+ */
+interface FeedbackCollectedAttachment {
+    id: string;
+    name: string;
+    contentType: string;
+    bytes: Uint8Array;
+}
+/**
+ * 业务补充材料；短文本/结构化信息出现在 business 证据，完整日志使用附件。
+ * @example
+ * ```ts
+ * import type { FeedbackCollectedEvidence } from '@h-ai/feedback'
+ * const evidence: FeedbackCollectedEvidence = { text: 'Order diagnostics', data: { orderId: 'order-1' } }
+ * void evidence
+ * ```
+ */
+interface FeedbackCollectedEvidence {
+    text?: string;
+    data?: FeedbackEvidenceInput['data'];
+    attachments?: FeedbackCollectedAttachment[];
+}
+/**
+ * 采集扩展在持久任务中执行并等待异步结果；可能重试，宿主应按 report.id 幂等并响应 signal。
+ * @example
+ * ```ts
+ * import type { FeedbackInitOptions } from '@h-ai/feedback'
+ * const options: FeedbackInitOptions = { collectEvidence: async ({ report, signal }) => { signal.throwIfAborted(); return { text: report.number } } }
+ * void options
+ * ```
+ */
+interface FeedbackInitOptions {
+    collectEvidence?: (context: {
+        report: Readonly<FeedbackReport>;
+        signal: AbortSignal;
+    }) => FeedbackCollectedEvidence | Promise<FeedbackCollectedEvidence>;
+}
+/**
+ * 采集结束后发送的 feedback.created 事件；eventId 跨重试稳定，附件正文通过受权 API 读取。
+ * @example
+ * ```ts
+ * import type { FeedbackWebhookEvent } from '@h-ai/feedback'
+ * function eventKey(event: FeedbackWebhookEvent) { return event.eventId }
+ * void eventKey
+ * ```
+ */
+interface FeedbackWebhookEvent {
+    event: 'feedback.created';
+    eventId: string;
+    createdAt: number;
+    report: FeedbackReport;
+    evidence: {
+        revision: number;
+        business: boolean;
+        attachments: FeedbackAttachment[];
+    };
+    detailUrl?: string;
+}
 /**
  * 反馈服务对象；领域操作返回 HaiResult，close 不释放宿主依赖连接。
  * @example
@@ -106,7 +185,7 @@ interface FeedbackContext {
  * ```
  */
 interface FeedbackFunctions {
-    init: (config: FeedbackConfigInput) => Promise<HaiResult<void>>;
+    init: (config: FeedbackConfigInput, options?: FeedbackInitOptions) => Promise<HaiResult<void>>;
     close: () => Promise<HaiResult<void>>;
     readonly isInitialized: boolean;
     readonly config: FeedbackConfig | null;
@@ -158,4 +237,4 @@ interface FeedbackFunctions {
  */
 declare const feedback: FeedbackFunctions;
 
-export { type FeedbackConfig, type FeedbackConfigInput, FeedbackConfigSchema, type FeedbackContext, type FeedbackFunctions, HaiFeedbackError, feedback };
+export { type FeedbackCollectedAttachment, type FeedbackCollectedEvidence, type FeedbackConfig, type FeedbackConfigInput, FeedbackConfigSchema, type FeedbackContext, type FeedbackFunctions, type FeedbackInitOptions, type FeedbackWebhookEvent, HaiFeedbackError, feedback };