@lark-base-open/base-database-app-sdk 0.5.0-durable.0 → 0.5.1

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.
@@ -5,6 +5,7 @@
5
5
  | 能力 | 分类 | 缺字段时 host-baseline(版本 1) |
6
6
  |---|---|---|
7
7
  | runtime.context | 关键 | 是 |
8
+ | runtime.diagnostic | 可选;SDK 无对应 API | 否,须由宿主显式声明 |
8
9
  | http.request | 关键 | 是 |
9
10
  | http.binary | 关键 | 是 |
10
11
  | http.cancel | 可选 | 是 |
@@ -21,7 +22,7 @@
21
22
  | attachment.progress | 可选 | 是 |
22
23
  | link.open | 可选 | 是 |
23
24
 
24
- 宿主集中部署;缺少 capabilities 字段仅代表能力协商尚未上线,不代表缺少外链或进度能力。基线以包内 capabilities.json 的能力清单为准,由宿主注册与事件实现的回归测试验证。服务端 ctx.records 不属于页面能力协商;未知能力不在基线。[`queryCapability`](exports.md#page) 的 source 此时为 `host-baseline`;显式能力表为 `advertised`。
25
+ 缺少 capabilities 字段时,基线以包内 capabilities.json 的能力清单为准。服务端 ctx.records 不属于页面能力协商;未知能力不在基线。[`queryCapability`](exports.md#page) 的 source 此时为 `host-baseline`;显式能力表为 `advertised`。
25
26
  `readCapabilities(context)`、`hasCapability(context,name,minVersion)` 是纯查询;[`getCapabilities`](exports.md#page) 为标准查询入口,[`getRuntimeCapabilities`](exports.md#page) 是别名;[`queryCapability`](exports.md#page) 返回 supported/version/source/availability,未明确健康状态时 availability 为 unknown;`getRuntimeCapabilities(runtime?)` 每次读宿主,不跨应用、环境或用户缓存。[`requireCapability`](exports.md#page) 查询失败或缺失时抛错。所有公开业务入口、兼容 helper 与组件通过同一调用边界:等待配对 → 自动能力预检 → 发送。显式缺失能力时本地抛结构化能力错误,不发送业务请求;RuntimeContext 是协商引导请求,不对自身递归预检。显式 [`requireCapability`](exports.md#page) 仍可用于界面判断,宿主是最终授权方。
26
27
 
27
28
  <!-- example: capabilities.ts -->
@@ -39,4 +40,4 @@ export async function inspectHost() {
39
40
  分类只用稳定错误码,不解析含业务内容的 message。LINK_CHECK_UNAVAILABLE 表示服务不可用,分类为 unknown,不能据此断言地域政策。宿主可用 companion 字段 capabilityUnavailable 明确 permission-denied/region-unavailable/temporarily-unavailable;[`requireCapability`](exports.md#page) 会根据该原因拒绝。unknown 不猜测也不自动重试;retryable 提示不保证非幂等写入重试安全。
40
41
  输出含 source/code/upstreamCode/category/retryable/message/redaction;不附原始异常、请求参数、URL、身份、token。应用、环境、制品版本与 requestId/logid 由持有可信上下文的诊断汇总端补齐,本模块不伪造关联信息。
41
42
 
42
- 结构化清单位于包内 capabilities.json,测试保证它与共享 [`CAPABILITY_CATALOG`](exports.md#page) 一致。无缓存实现每次读取当前 channel 上下文,避免跨 mount/用户/应用泄漏旧状态。基线包含 link.open 与 attachment.progress;支持进度事件不代表每次上传都必定出现回调或保证服务当前可用。
43
+ 结构化清单位于包内 capabilities.json,也可通过 [`CAPABILITY_CATALOG`](exports.md#page) 读取。无缓存实现每次读取当前 channel 上下文,避免跨 mount/用户/应用泄漏旧状态。基线包含 link.open 与 attachment.progress;支持进度事件不代表每次上传都必定出现回调或保证服务当前可用。
package/docs/codegen.md CHANGED
@@ -23,8 +23,8 @@ export const files = await generateFunctionClients(data);
23
23
 
24
24
  格式类型 `FunctionContractData`、`FunctionInputContract`、`ClientContract` 与等价校验函数 `validateContractData` 同入口导出。`SUPPORTED_CONTRACT_FORMAT_VERSIONS` 当前为 `[1]`。未知格式版本抛 `CodegenError`,其 `code=CONTRACT_FORMAT_UNSUPPORTED`、`toJSON()` 返回结构化错误;非法数据为 `CONTRACT_DATA_INVALID`。不接受外部 Schema 引用;沿用单 Schema 32KiB、256 节点和16层限制。
25
25
 
26
- `client=false` 仍会在输入类型文件中生成输出映射和 Mutation 标记映射,因此纯 SQL 或 Mutation 工程直接调用 SDK 也有类型约束;仅省略 `functions.ts` 包装客户端。CLI 以 `functions: []` 重新生成旧 helper 时,SDK 可从 `inputs[].functionType` 保留 SQL 的 `{ rows }` 类型及 Mutation 标记。相同 ID 在 `functions` 与 `inputs` 中提供了冲突的 Function 类型时,生成失败;缺少类型信息时不推断为 Mutation。`augmentation=compat|client` 生成相应 FunctionInputMap 增强文件,none 不生成增强。`previousAugmentation` 若提供,必须为已知的未修改生成文件,否则报 `CONTRACT_INPUT_MAP_CONFLICT`。生成文件有冻结的逐字节测试夹具。
26
+ `client=false` 仍会在输入类型文件中生成输出映射和 Mutation 标记映射,因此纯 SQL 或 Mutation 工程直接调用 SDK 也有类型约束;仅省略 `functions.ts` 包装客户端。CLI 以 `functions: []` 重新生成旧 helper 时,SDK 可从 `inputs[].functionType` 保留 SQL 的 `{ rows }` 类型及 Mutation 标记。相同 ID 在 `functions` 与 `inputs` 中提供了冲突的 Function 类型时,生成失败;缺少类型信息时不推断为 Mutation。`augmentation=compat|client` 生成相应 FunctionInputMap 增强文件,none 不生成增强。`previousAugmentation` 若提供,必须为已知的未修改生成文件,否则报 `CONTRACT_INPUT_MAP_CONFLICT`。
27
27
 
28
- 直接调用要求输入、输出映射都包含该 Function ID;缺失输出映射不能退回到调用方自行指定泛型。Mutation 标记仅根据真实 `functionType=5` 生成,不能按输出结构判断。批量 helper 的 ID 必须同时存在于 Mutation 标记、输入和输出映射中,每组参数与结果均按 ID 推断;无输出 Schema 时结果为 `DatabaseMutationResult`,有 Schema 时保留精确类型。ID 与参数必须保持关联,不能用任意字符串或返回泛型回退;页面仍须检查顶层业务码、缺失记录和忽略字段。FaaS 未声明输出 Schema 时映射值为 `unknown`,页面须先校验或显式断言 `data` 的业务结构。0.2.0 的直接调用与 0.3.0 的批量调用分别收紧了公开类型契约;升级后重新生成契约并按 [Migration](../CHANGELOG.md) 修改调用处。
28
+ 直接调用要求输入、输出映射都包含该 Function ID;缺失输出映射不能退回到调用方自行指定泛型。Mutation 标记仅根据真实 `functionType=5` 生成,不能按输出结构判断。批量 helper 的 ID 必须同时存在于 Mutation 标记、输入和输出映射中,每组参数与结果均按 ID 推断;无输出 Schema 时结果为 `DatabaseMutationResult`,有 Schema 时保留精确类型。ID 与参数必须保持关联,不能用任意字符串或返回泛型回退;页面仍须检查顶层业务码、缺失记录和忽略字段。FaaS 未声明输出 Schema 时映射值为 `unknown`,页面须先校验或显式断言 `data` 的业务结构。0.2.0 的直接调用与 0.3.0 的批量调用分别收紧了公开类型契约;升级后重新生成契约并按 [迁移指南](upgrade.md) 修改调用处。
29
29
 
30
- CLI 在与契约提取相同的受限子进程边界执行安装在工程内的 codegen:环境清空、只读临时包快照、禁子进程/写文件、时间和内存限制;父进程校验相对路径、文件大小与目标软链后写入,check 比较文件内容。此机制不是面向任意恶意原生程序的通用沙箱。
30
+ 生成完成后运行 `base-database-cli check --json` 检查契约与生成文件是否一致。
package/docs/compat.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # 老模板兼容
2
2
 
3
- 兼容基准为 classic 模板的 `page/src/lib/database-runtime.ts`;源码版本与摘要保存在仓库测试夹具中。page 保留其全部 36 个值/类型导出;测试夹具保存原始文件与 SHA256。兼容长期维护,暂不设截止日期。
3
+ page 保留 classic 模板 `page/src/lib/database-runtime.ts` 的 36 个值/类型导出。
4
4
 
5
- 数据库与附件实现位于 page/database.ts,AI helper 位于 page/ai-compat.ts。替换 import 后,Function 调用仍返回原 envelope;唯一例外是数据未就绪(800008918):Function 调用默认开启写后读,重试用尽后不返回 envelope,改为抛 [`DataNotReadyError`](exports.md#page),传 `{ readYourWrites: false }` 保持原 envelope,见 [页面运行时](page.md) 的「写后读」;HTTP 失败仍抛错;Mutation batch 接受 1–200 个命名参数对象,与统一 Function 路由一致;旧位置数组必须按已发布的冻结声明人工迁移,不能直接替换 import 后发送。[`resolveDatabaseContext`](exports.md#page) 保持宿主优先、路径兜底和原会话缓存语义。媒体任务保留原 helper 的宽容归一化及错误名/码,流式 destroy 仍取消。
5
+ 替换 import 后,Function 调用仍返回原 envelope;唯一例外是数据未就绪(800008918):Function 调用默认开启写后读,重试用尽后不返回 envelope,改为抛 [`DataNotReadyError`](exports.md#page),传 `{ readYourWrites: false }` 保持原 envelope,见 [页面运行时](page.md) 的「写后读」;HTTP 失败仍抛错;Mutation batch 接受 1–200 个命名参数对象,与统一 Function 路由一致;旧位置数组必须按已发布的冻结声明人工迁移,不能直接替换 import 后发送。[`resolveDatabaseContext`](exports.md#page) 保持宿主优先、路径兜底和原会话缓存语义。媒体任务保留原 helper 的宽容归一化及错误名/码,流式 destroy 仍取消。
6
6
 
7
7
  [`DatabaseFunctionInputMap`](exports.md#page) 可通过模块扩充,[`FunctionInputMap`](exports.md#page) 也可作为生成器的基础扩充接口;两者未提供函数时拒绝任意函数名和参数。不使用 Record<string,unknown> 兜底伪造类型安全。新生成工程用 Function ID 输出映射推断 `data`:SQL 为 `DatabaseQueryResult<Row>`,无列 Schema 时 `Row=unknown`;缺失输出映射时直接调用编译失败,应核对 CLI/SDK 版本并运行 `contracts generate`。批量调用还要求 ID 存在于 codegen 的 Mutation 标记映射中;每组输入和输出均按 ID 推断,移除调用方返回泛型。对自定义过 helper 的工程应先比对差异,不直接覆盖。
8
8
 
@@ -15,9 +15,9 @@ Panel 的 slots.empty/loading/option/footer 均为 ComponentType;option 收到
15
15
 
16
16
  CSS 只作用 `.base-app-platform`,位于 `@layer base-app`。可覆盖 `--base-app-color-bg/fg/muted/accent/danger/border`、`--base-app-radius`、`--base-app-font-family/font-size`、`--base-app-z-popover/z-floating` 和 `--base-app-shadow`。Portal 保留 Provider 的主题,支持 light/dark、文档方向与 reduced-motion。不依赖用户工程的 Tailwind 编译。
17
17
 
18
- 组件语义与 classic 模板组件保持兼容;源码版本与摘要保存在仓库测试目录中。旧成员推荐接口、返回归一化、zh/en/ja 文案和权限语义保留;交互骨架与主题 CSS 重写。旧 ui-language 测试中的业务 App 和 PageState 属模板而非 SDK,迁移保留该用例中全部 SDK 断言。
18
+ 组件与 classic 模板的公开属性、文案和权限语义保持兼容。
19
+
19
20
 
20
- 体积由 scripts/measure-size.mjs 对生产 ESM bundle 测 gzip,包含 channel/cmdk/Radix,排除 React/react-dom/TanStack Query;测试阈值在 test/size-budget.json,为本次实测值 +10%。CSS 单独计量。浏览器夹具与 mock host 证明组件行为,不证明 BOE 权限或真实业务请求。
21
21
 
22
22
  <!-- example: components.tsx -->
23
23
  ```tsx
package/docs/exports.md CHANGED
@@ -1,12 +1,12 @@
1
1
  # 公开导出清单
2
2
 
3
- 由 package.json exports 指向的实际 dist ESM 与 TypeScript 声明生成;在 SDK 源码仓运行 npm run docs:exports 更新,npm test 校验。server/shared/codegen 另提供 CJS;CSS 入口为 /page/styles.css。没有根入口或源码通配入口。
3
+ 此清单列出各公开入口的值与类型。server/shared/codegen 另提供 CJS;CSS 入口为 /page/styles.css。没有根入口或源码通配入口。
4
4
 
5
5
  ## page
6
6
 
7
7
  值:`AttachmentImage`、`BaseAppProvider`、`CAPABILITY_CATALOG`、`CapabilityUnavailableError`、`DataNotReadyError`、`DatabaseUserMenu`、`DiagnosticCode`、`FloatingButton`、`SDKError`、`SITE_RUNTIME_PROTOCOL_VERSION`、`SiteChatbotStreamAdapter`、`SiteChatbotStreamError`、`SiteRuntimeApi`、`SiteRuntimeClient`、`SiteRuntimeErrorCode`、`SiteRuntimeEvent`、`SiteRuntimeFunction`、`SiteRuntimeInvocationError`、`UiLanguageContext`、`UserSelectorEditor`、`UserSelectorPanel`、`buildAttachmentCoverUrl`、`buildDatabaseInvokeFunctionPath`、`buildDatabaseInvokeGetPath`、`callSiteAIFunction`、`classifyRuntimeError`、`createSiteAIFunctionTask`、`createSiteRuntimeClient`、`createSiteRuntimeFetch`、`fetch`、`fetchAttachmentCover`、`fetchAttachmentDownloadUrl`、`getCapabilities`、`getCurrentUser`、`getDatabaseContext`、`getRuntimeCapabilities`、`getSiteAIFunctionTask`、`getUiLanguage`、`getUiLocale`、`hasCapability`、`hasRunnableMediaTask`、`initializeUiLanguage`、`installLinkGuard`、`invokeApi`、`invokeDatabaseFunction`、`invokeDatabaseMutationBatch`、`invokeHttp`、`invokeSiteAIFunctionStream`、`isValidSiteFunctionName`、`logout`、`normalizeSiteAIMediaTask`、`openAttachmentDownload`、`openLink`、`queryCapability`、`readCapabilities`、`readSiteAITextDelta`、`requestEdit`、`requireCapability`、`resolveDatabaseContext`、`selectUiLanguage`、`siteRuntime`、`startBaseApp`、`uploadAttachment`、`useBaseApp`、`useOptionalBaseApp`、`useUiLanguage`。
8
8
 
9
- 类型与值完整清单:`AttachmentImage`、`BaseAppContextValue`、`BaseAppHandle`、`BaseAppProvider`、`CAPABILITY_CATALOG`、`CallSiteAIFunctionParams`、`CapabilityContext`、`CapabilityDescriptor`、`CapabilityMap`、`CapabilityName`、`CapabilityQueryResult`、`CapabilityUnavailableError`、`CapabilityUnavailableReason`、`DataNotReadyError`、`DatabaseAttachmentRef`、`DatabaseAudience`、`DatabaseContext`、`DatabaseEnv`、`DatabaseFunctionInputMap`、`DatabaseFunctionInvocation`、`DatabaseFunctionOptions`、`DatabaseFunctionOutputMap`、`DatabaseFunctionResponse`、`DatabaseMutationResult`、`DatabaseQueryResult`、`DatabaseUserMenu`、`DatabaseUserMenuProps`、`DevelopmentPairChallenge`、`DevelopmentPairProof`、`DiagnosticCategory`、`DiagnosticCode`、`FloatingButton`、`FloatingButtonProps`、`FunctionEnvelope`、`FunctionInputMap`、`FunctionMap`、`FunctionOutputMap`、`InvokeSiteAIFunctionStreamParams`、`JsonValue`、`LinkGuardOptions`、`MutationFunctionId`、`MutationFunctionMap`、`RuntimeCapabilities`、`RuntimeChannel`、`RuntimeContextReader`、`RuntimeDiagnostic`、`SDKError`、`SDKErrorOptions`、`SITE_RUNTIME_PROTOCOL_VERSION`、`SiteAIAudioContentPart`、`SiteAICapabilityType`、`SiteAIFileContentPart`、`SiteAIFunctionArguments`、`SiteAIFunctionError`、`SiteAIFunctionOptions`、`SiteAIFunctionParams`、`SiteAIFunctionResult`、`SiteAIFunctionStreamCloseRequest`、`SiteAIFunctionStreamDone`、`SiteAIFunctionStreamError`、`SiteAIFunctionStreamHandle`、`SiteAIFunctionStreamMessage`、`SiteAIFunctionStreamOpenRequest`、`SiteAIFunctionVariables`、`SiteAIImageAsset`、`SiteAIImageContentPart`、`SiteAIImageGenerationInput`、`SiteAIImageTask`、`SiteAIMediaTask`、`SiteAIMediaTaskBase`、`SiteAIMessage`、`SiteAIMessageContentPart`、`SiteAIStreamDelta`、`SiteAIStreamMessageParam`、`SiteAITaskStatus`、`SiteAITextContentPart`、`SiteAITextDelta`、`SiteAITextMessageParam`、`SiteAIUserMessageParam`、`SiteAIVideoAsset`、`SiteAIVideoContentPart`、`SiteAIVideoGenerationInput`、`SiteAIVideoTask`、`SiteAttachmentTarget`、`SiteAttachmentUploadCancelRequest`、`SiteAttachmentUploadOptions`、`SiteAttachmentUploadPayload`、`SiteAttachmentUploadProgress`、`SiteAttachmentUploadRequest`、`SiteAttachmentUploadResult`、`SiteChatbotStreamAdapter`、`SiteChatbotStreamCloseRequest`、`SiteChatbotStreamError`、`SiteChatbotStreamMessage`、`SiteChatbotStreamOpenRequest`、`SiteFunctionDefinition`、`SiteFunctionInvokeRequest`、`SiteFunctionValidationIssue`、`SiteHttpCancelRequest`、`SiteHttpMethod`、`SiteHttpRequest`、`SiteHttpRequestInit`、`SiteHttpRequestOptions`、`SiteHttpResponse`、`SiteHttpResponseType`、`SiteOpenLinkRequest`、`SiteOpenLinkResult`、`SiteProjectEnv`、`SiteRuntimeApi`、`SiteRuntimeClient`、`SiteRuntimeContext`、`SiteRuntimeError`、`SiteRuntimeErrorCode`、`SiteRuntimeEvent`、`SiteRuntimeFunction`、`SiteRuntimeInvocationError`、`SiteRuntimeLoadFailedEvent`、`SiteRuntimeModeChangedEvent`、`SiteRuntimeReadyEvent`、`SiteRuntimeUserInfo`、`StartBaseAppOptions`、`UiLanguage`、`UiLanguageContext`、`User`、`UserSelectorAction`、`UserSelectorEditor`、`UserSelectorEditorProps`、`UserSelectorEditorValue`、`UserSelectorMode`、`UserSelectorPanel`、`UserSelectorPanelProps`、`UserSelectorSearchAction`、`UserSelectorValue`、`WriteResult`、`buildAttachmentCoverUrl`、`buildDatabaseInvokeFunctionPath`、`buildDatabaseInvokeGetPath`、`callSiteAIFunction`、`classifyRuntimeError`、`createSiteAIFunctionTask`、`createSiteRuntimeClient`、`createSiteRuntimeFetch`、`fetch`、`fetchAttachmentCover`、`fetchAttachmentDownloadUrl`、`getCapabilities`、`getCurrentUser`、`getDatabaseContext`、`getRuntimeCapabilities`、`getSiteAIFunctionTask`、`getUiLanguage`、`getUiLocale`、`hasCapability`、`hasRunnableMediaTask`、`initializeUiLanguage`、`installLinkGuard`、`invokeApi`、`invokeDatabaseFunction`、`invokeDatabaseMutationBatch`、`invokeHttp`、`invokeSiteAIFunctionStream`、`isValidSiteFunctionName`、`logout`、`normalizeSiteAIMediaTask`、`openAttachmentDownload`、`openLink`、`queryCapability`、`readCapabilities`、`readSiteAITextDelta`、`requestEdit`、`requireCapability`、`resolveDatabaseContext`、`selectUiLanguage`、`siteRuntime`、`startBaseApp`、`uploadAttachment`、`useBaseApp`、`useOptionalBaseApp`、`useUiLanguage`。
9
+ 类型与值完整清单:`AttachmentImage`、`BaseAppContextValue`、`BaseAppHandle`、`BaseAppProvider`、`CAPABILITY_CATALOG`、`CallSiteAIFunctionParams`、`CapabilityContext`、`CapabilityDescriptor`、`CapabilityMap`、`CapabilityName`、`CapabilityQueryResult`、`CapabilityUnavailableError`、`CapabilityUnavailableReason`、`DataNotReadyError`、`DatabaseAttachmentRef`、`DatabaseAudience`、`DatabaseContext`、`DatabaseEnv`、`DatabaseFunctionInputMap`、`DatabaseFunctionInvocation`、`DatabaseFunctionOptions`、`DatabaseFunctionOutputMap`、`DatabaseFunctionResponse`、`DatabaseMutationResult`、`DatabaseQueryResult`、`DatabaseUserMenu`、`DatabaseUserMenuProps`、`DevelopmentPairChallenge`、`DevelopmentPairProof`、`DiagnosticCategory`、`DiagnosticCode`、`FloatingButton`、`FloatingButtonProps`、`FunctionEnvelope`、`FunctionInputMap`、`FunctionMap`、`FunctionOutputMap`、`InvokeSiteAIFunctionStreamParams`、`JsonValue`、`LinkGuardOptions`、`MutationFunctionId`、`MutationFunctionMap`、`RuntimeCapabilities`、`RuntimeChannel`、`RuntimeContextReader`、`RuntimeDiagnostic`、`SDKError`、`SDKErrorOptions`、`SITE_RUNTIME_PROTOCOL_VERSION`、`SiteAIAudioContentPart`、`SiteAICapabilityType`、`SiteAIFileContentPart`、`SiteAIFunctionArguments`、`SiteAIFunctionError`、`SiteAIFunctionOptions`、`SiteAIFunctionParams`、`SiteAIFunctionResult`、`SiteAIFunctionStreamCloseRequest`、`SiteAIFunctionStreamDone`、`SiteAIFunctionStreamError`、`SiteAIFunctionStreamHandle`、`SiteAIFunctionStreamMessage`、`SiteAIFunctionStreamOpenRequest`、`SiteAIFunctionVariables`、`SiteAIImageAsset`、`SiteAIImageContentPart`、`SiteAIImageGenerationInput`、`SiteAIImageTask`、`SiteAIMediaTask`、`SiteAIMediaTaskBase`、`SiteAIMessage`、`SiteAIMessageContentPart`、`SiteAIStreamDelta`、`SiteAIStreamMessageParam`、`SiteAITaskStatus`、`SiteAITextContentPart`、`SiteAITextDelta`、`SiteAITextMessageParam`、`SiteAIUserMessageParam`、`SiteAIVideoAsset`、`SiteAIVideoContentPart`、`SiteAIVideoGenerationInput`、`SiteAIVideoTask`、`SiteAttachmentTarget`、`SiteAttachmentUploadCancelRequest`、`SiteAttachmentUploadOptions`、`SiteAttachmentUploadPayload`、`SiteAttachmentUploadProgress`、`SiteAttachmentUploadRequest`、`SiteAttachmentUploadResult`、`SiteChatbotStreamAdapter`、`SiteChatbotStreamCloseRequest`、`SiteChatbotStreamError`、`SiteChatbotStreamMessage`、`SiteChatbotStreamOpenRequest`、`SiteFunctionDefinition`、`SiteFunctionInvokeRequest`、`SiteFunctionValidationIssue`、`SiteHttpCancelRequest`、`SiteHttpMethod`、`SiteHttpRequest`、`SiteHttpRequestInit`、`SiteHttpRequestOptions`、`SiteHttpResponse`、`SiteHttpResponseType`、`SiteOpenLinkRequest`、`SiteOpenLinkResult`、`SiteProjectEnv`、`SiteRuntimeApi`、`SiteRuntimeClient`、`SiteRuntimeContext`、`SiteRuntimeDiagnostic`、`SiteRuntimeError`、`SiteRuntimeErrorCode`、`SiteRuntimeEvent`、`SiteRuntimeFunction`、`SiteRuntimeInvocationError`、`SiteRuntimeLoadFailedEvent`、`SiteRuntimeModeChangedEvent`、`SiteRuntimeReadyEvent`、`SiteRuntimeUserInfo`、`SiteRuntimeVersions`、`StartBaseAppOptions`、`UiLanguage`、`UiLanguageContext`、`User`、`UserSelectorAction`、`UserSelectorEditor`、`UserSelectorEditorProps`、`UserSelectorEditorValue`、`UserSelectorMode`、`UserSelectorPanel`、`UserSelectorPanelProps`、`UserSelectorSearchAction`、`UserSelectorValue`、`WriteResult`、`buildAttachmentCoverUrl`、`buildDatabaseInvokeFunctionPath`、`buildDatabaseInvokeGetPath`、`callSiteAIFunction`、`classifyRuntimeError`、`createSiteAIFunctionTask`、`createSiteRuntimeClient`、`createSiteRuntimeFetch`、`fetch`、`fetchAttachmentCover`、`fetchAttachmentDownloadUrl`、`getCapabilities`、`getCurrentUser`、`getDatabaseContext`、`getRuntimeCapabilities`、`getSiteAIFunctionTask`、`getUiLanguage`、`getUiLocale`、`hasCapability`、`hasRunnableMediaTask`、`initializeUiLanguage`、`installLinkGuard`、`invokeApi`、`invokeDatabaseFunction`、`invokeDatabaseMutationBatch`、`invokeHttp`、`invokeSiteAIFunctionStream`、`isValidSiteFunctionName`、`logout`、`normalizeSiteAIMediaTask`、`openAttachmentDownload`、`openLink`、`queryCapability`、`readCapabilities`、`readSiteAITextDelta`、`requestEdit`、`requireCapability`、`resolveDatabaseContext`、`selectUiLanguage`、`siteRuntime`、`startBaseApp`、`uploadAttachment`、`useBaseApp`、`useOptionalBaseApp`、`useUiLanguage`。
10
10
 
11
11
  ## server
12
12
 
@@ -43,15 +43,3 @@
43
43
  值:`CodegenError`、`SUPPORTED_CONTRACT_FORMAT_VERSIONS`、`generateFunctionClients`、`validateContractData`。
44
44
 
45
45
  类型与值完整清单:`ClientContract`、`CodegenError`、`FunctionContractData`、`FunctionInputContract`、`GeneratedFile`、`SUPPORTED_CONTRACT_FORMAT_VERSIONS`、`generateFunctionClients`、`validateContractData`。
46
-
47
- ## durable/workflow
48
-
49
- 值:`callStep`、`reportProgress`、`sleep`、`waitForEvent`。
50
-
51
- 类型与值完整清单:`callStep`、`reportProgress`、`sleep`、`waitForEvent`。
52
-
53
- ## durable/activity
54
-
55
- 值:`cancellationSignal`、`getAttempt`、`invokeFunction`。
56
-
57
- 类型与值完整清单:`cancellationSignal`、`getAttempt`、`invokeFunction`。
package/docs/page.md CHANGED
@@ -79,7 +79,7 @@ export async function loadWithFetch() {
79
79
  }
80
80
  ```
81
81
 
82
- 业务 HTTP 经宿主代理,只接受单个 `/` 开头的相对地址和宿主配置白名单;默认清单见 testing.md。绝对地址、跨源、目录穿越、反斜杠、fragment、控制字符被拒绝。
82
+ 业务 HTTP 经宿主代理,只接受单个 `/` 开头的相对地址和宿主配置白名单;默认清单可从 testing 入口的 `DEFAULT_SITE_HTTP_BRIDGE_ALLOWLIST` 读取。绝对地址、跨源、目录穿越、反斜杠、fragment、控制字符被拒绝。
83
83
  方法仅 DELETE/GET/PATCH/POST/PUT;body 只支持字符串,GET 不能有 body。禁止透传 Authorization、Connection、Content-Length、Cookie、Host、Origin、Proxy-Authorization、Referer、Transfer-Encoding,以及 sec-/x-forwarded-/rpc- 前缀请求头。身份由宿主注入。
84
84
  4xx/5xx 正常返回 Response,必须自行检查 ok。文本与 arrayBuffer 使用明确的 responseType;旧宿主不支持二进制时失败,不降级为文本或直连。超时默认 30 秒、最高 60 秒;取消不证明远端写入已撤销,写入失败不得盲目重试。
85
85
 
@@ -99,7 +99,7 @@ export function onSupportedLinkClick(url: string) {
99
99
  }
100
100
  ```
101
101
 
102
- [`openLink`](exports.md#page) 支持 http/https/mailto/tel;宿主拒绝 javascript/data/file 等协议。HTTP(S) 必须经过宿主 seclink,服务不可用时失败关闭;opened 只代表宿主已提交导航,不保证弹窗可见。
102
+ [`openLink`](exports.md#page) 支持 http/https/mailto/tel;宿主拒绝 javascript/data/file 等协议。HTTP(S) 必须经过宿主 链接安全检查,服务不可用时失败关闭;opened 只代表宿主已提交导航,不保证弹窗可见。
103
103
  `installLinkGuard()` 同步返回 cleanup,内部异步查询能力;查询前、查询失败或显式能力表缺 link.open 时不拦截;无能力字段采用 host-baseline 并安装拦截。onDiagnostic 收到脱敏提示,默认 console.warn。应在页面启动时安装,而不是点击后才查询。支持能力时沿用 channel guard:捕获外链、_blank 与中键;download/hash/普通同源导航不接管。cleanup 也阻止迟到查询安装。
104
104
  不要将 guard 当作任意 HTML 的安全过滤器;尤其不允许把不可信字符串直接设为 href。浏览器原生行为仍受 iframe sandbox 限制。
105
105
 
@@ -185,7 +185,7 @@ export async function pollOrderCount() {
185
185
  [`fetch`](exports.md#page)/[`invokeHttp`](exports.md#page) 返回 Response。[`callSiteAIFunction`](exports.md#page)、任务与流式 API、[`SiteChatbotStreamAdapter`](exports.md#page) 保持兼容导出;已有返回联合类型和事件语义不变。
186
186
  [`invokeDatabaseFunction`](exports.md#page)、[`invokeDatabaseMutationBatch`](exports.md#page)、[`resolveDatabaseContext`](exports.md#page) 已由 /page 提供,保持老模板语义,见 [兼容 API](compat.md)。[`invokeApi`](exports.md#page) 的 function 点号路径不能替代 Database Function ID。
187
187
 
188
- SDK 文档说明本版本 API、组件、兼容语义与可编译示例。业务规则、服务端契约、Mutation 结果、CLI 命令与发布流程,请查阅 [@lark-base-open/base-database-cli](https://www.npmjs.com/package/@lark-base-open/base-database-cli) 随包安装的 lark-base-database Skill 及其 references。升级 CLI 时以该版本随包 Skill 为准。
188
+ SDK 文档说明本版本 API、组件、兼容语义与可编译示例。业务规则、服务端契约、Mutation 结果、CLI 命令与应用发布流程,请查阅 [@lark-base-open/base-database-cli](https://www.npmjs.com/package/@lark-base-open/base-database-cli) 随包安装的 lark-base-database Skill 及其 references。升级 CLI 时以该版本随包 Skill 为准。
189
189
 
190
190
  ## 本机开发上下文
191
191
 
@@ -195,7 +195,7 @@ SDK 文档说明本版本 API、组件、兼容语义与可编译示例。业务
195
195
  浏览器原生“本地网络访问”授权是访问 loopback 的前置条件:若浏览器提示,需允许当前宿主访问本机网络;此前已拒绝时到该站点的浏览器权限设置恢复。
196
196
  这项浏览器授权独立于应用内配对,不能由 SDK 代替用户授予。
197
197
  无令牌或非编辑者直接打开线上版本;复制地址栏链接给别人会自动打开线上版本。普通入口不加载 loopback。
198
- 页面隐藏不销毁,聚焦与30秒轮询复查权限;离开、本地登出或检测到权限失效即回收;当前标签刷新复用 sessionStorage 令牌,但重新挑战配对。不调用服务端开发会话接口。
198
+ 页面隐藏不销毁,聚焦与30秒轮询复查权限;离开、本地登出或检测到权限失效即回收;当前标签刷新复用 sessionStorage 令牌,但重新挑战配对。
199
199
 
200
200
  `SiteRuntimeContext.development` 可选,结构为
201
201
  `{ localOrigin: string, projectEnv: 'preview', artifactVersion: string | null }`。
package/docs/server.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  输入 issues 映射 400;输出 issues、校验器异常、非 JSON 输出及普通异常映射 500。[`SDKError`](exports.md#server) 可设置有限非零整数 wireCode,SDK_TIMEOUT 默认 504、SDK_CANCELLED 默认 499。safeMessage 必须是开发者提供的安全文案;不要传原始 error.message。结构化诊断仅记录码、字段路径、retryable、outcome,不记录校验消息或被拒值。网关可能脱敏 500,不能承诺客户端看到 SDK 字符串码。
8
8
 
9
- 旧 faas-entry 对错误返回仍会构造 `{code,msg,data:{code,msg}}`;先判断外层 code,错误 data 不是输出契约。运行时实现不需要升级。跨 server/shared、ESM/CJS 的 [`SDKError`](exports.md#server) 用同版本 Symbol 标识识别。
9
+ 错误响应可能包含 `{code,msg,data:{code,msg}}`;先判断外层 code,错误 data 不是输出契约。跨 server/shared、ESM/CJS 的 [`SDKError`](exports.md#server) 用同版本 Symbol 标识识别。
10
10
 
11
11
  <!-- example: server.ts -->
12
12
  ```ts
@@ -69,7 +69,7 @@ export default bindFunctionRuntime(handler, {
69
69
  });
70
70
  ```
71
71
 
72
- [`bindFunctionRuntime`](exports.md#server) 为每次调用复制 context 并添加私有非凭据 profile,不改全局或原 context。CLI 为模板 1/2 的 defineFunction 入口注入 profile 和 runtime 绑定;模板 1 从当前已验证账号品牌与工程 runtimeProfile 生成,模板 2 使用 generated/runtime-profile.ts。未绑定 profile 时 records 返回 SDK_RUNTIME_PROFILE_MISSING;不支持的环境/品牌返回 SDK_RUNTIME_PROFILE_UNSUPPORTED。online 支持 feishu/lark,pre、boe 仅支持 feishu。域名只是原 runtime 的路由标记,真实回调地址和身份仍由平台控制;SDK 不发身份头、不猜域、不跨区重试。
72
+ [`bindFunctionRuntime`](exports.md#server) 为函数绑定运行环境,通常由 CLI 生成入口;业务 handler 不需要持有身份凭据。未绑定时 records 返回 SDK_RUNTIME_PROFILE_MISSING;环境或品牌不受支持时返回 SDK_RUNTIME_PROFILE_UNSUPPORTED。
73
73
 
74
74
  | records 操作 | 参数与限制 |
75
75
  | --- | --- |
@@ -85,8 +85,8 @@ export default bindFunctionRuntime(handler, {
85
85
 
86
86
  [兼容 API](compat.md) · [公开导出](exports.md)
87
87
 
88
- 示例与测试使用精确固定的 Zod 4.2.1(devDependency),验证真实 Standard Schema 的转换、refine 与异步校验;SDK 的 server 产物不捆绑 Zod。消费此示例的工程需自行固定安装 Zod。
88
+ 运行示例需安装 Zod 4.2.1;SDK 不捆绑 Zod,也支持其他兼容 Standard Schema 的验证库。
89
89
 
90
90
  SDK 的 ctx.records 方法和 [`WriteResult`](exports.md#server) 是本包 API;底层记录 payload、CellValue、Mutation 与服务端业务规范以 Skill 为唯一正文来源。
91
91
 
92
- SDK 文档说明本版本 API、组件、兼容语义与可编译示例。业务规则、服务端契约、Mutation 结果、CLI 命令与发布流程,请查阅 [@lark-base-open/base-database-cli](https://www.npmjs.com/package/@lark-base-open/base-database-cli) 随包安装的 lark-base-database Skill 及其 references。升级 CLI 时以该版本随包 Skill 为准。
92
+ SDK 文档说明本版本 API、组件、兼容语义与可编译示例。业务规则、服务端契约、Mutation 结果、CLI 命令与应用发布流程,请查阅 [@lark-base-open/base-database-cli](https://www.npmjs.com/package/@lark-base-open/base-database-cli) 随包安装的 lark-base-database Skill 及其 references。升级 CLI 时以该版本随包 Skill 为准。
package/docs/shared.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  [`FunctionEnvelope`](exports.md#shared) 是调用包裹类型;[`WriteResult`](exports.md#shared) 的 success/partial/failed/unknown 表示记录写入结果,见 [server](server.md)。[`JsonValue`](exports.md#shared) 描述 JSON 数据;类型断言不能替代 [`defineFunction`](exports.md#server) 的运行时校验。[`classifyRuntimeError`](exports.md#shared) 只按稳定错误码分类,不推断原始错误消息,也不证明写入是否发生。
6
6
 
7
- SDK 文档说明本版本 API、组件、兼容语义与可编译示例。业务规则、服务端契约、Mutation 结果、CLI 命令与发布流程,请查阅 [@lark-base-open/base-database-cli](https://www.npmjs.com/package/@lark-base-open/base-database-cli) 随包安装的 lark-base-database Skill 及其 references。升级 CLI 时以该版本随包 Skill 为准。
7
+ SDK 文档说明本版本 API、组件、兼容语义与可编译示例。业务规则、服务端契约、Mutation 结果、CLI 命令与应用发布流程,请查阅 [@lark-base-open/base-database-cli](https://www.npmjs.com/package/@lark-base-open/base-database-cli) 随包安装的 lark-base-database Skill 及其 references。升级 CLI 时以该版本随包 Skill 为准。
8
8
 
9
9
  <!-- example: shared.ts -->
10
10
  ```ts
@@ -10,7 +10,7 @@ linkGuard:false 完全不安装拦截;能力不支持时 SDK 同样保持原
10
10
 
11
11
  开发与生产统一由 main.tsx 直接导入 base-app.config.ts 并调用 startBaseApp(options),不使用虚拟入口。CLI 自动安装 `/vite` 的配对服务端中间件;HMR 不重配对,整页或 iframe 重载才配对。
12
12
 
13
- 运行示例与构建类型检查位于包内 examples;SDK 尚未发布时只使用本批 tarball 验证,不代表 registry 已可安装。
13
+ 运行示例位于包内 examples。
14
14
 
15
15
  <!-- example: start-base-app.tsx -->
16
16
  ```tsx
@@ -30,18 +30,16 @@ import { baseAppDevelopmentPairingPlugin } from '@lark-base-open/base-database-a
30
30
  export const plugins = [baseAppDevelopmentPairingPlugin()];
31
31
  ```
32
32
 
33
- ## 本地开发配对(FE1C)
33
+ ## 本地开发配对
34
34
 
35
35
  使用 CLI 输出的 `/baseapp/dev/<siteToken>/<port>#t=<令牌>` 打开;宿主读取后立刻移除片段并按站点、端口存当前标签 sessionStorage。复制地址栏链接给别人会自动打开线上版本。无令牌或非编辑者直接降级,有令牌但未连接/配对失败保持错误页。普通线上页面不启用此协议。
36
36
 
37
37
  访问本机服务前,浏览器可能要求当前宿主的原生“本地网络访问”授权;需在浏览器提示或站点权限设置中允许。它是浏览器安全前置,不是应用内确认页,也不由 SDK 自动授予;配对成功后应用直接进入。
38
38
 
39
- `development-pairing.json` 是 CLI、宿主和 SDK 的协议常量唯一来源;其他仓的镜像必须逐字段校验。CLI 每项目生成 32 字节随机数的 base64url 令牌,持久化并仅通过 `BASE_APP_DEV_PAIRING_TOKEN` 环境变量交给 Vite。`baseAppDevelopmentPairingPlugin()` 必须排在中间件链最前,令牌不进入客户端产物、日志或 NDJSON。
39
+ 使用 CLI 启动本地开发服务时会自动配置配对令牌。手工配置 Vite 时,将 `baseAppDevelopmentPairingPlugin()` 放在插件列表最前,并通过 `BASE_APP_DEV_PAIRING_TOKEN` 设置令牌;不要把令牌写入客户端代码或日志。HMR 不需要重新配对,整页或 iframe 重载会重新配对;旧 SDK 不支持配对时需要升级。
40
40
 
41
- 插件在实际监听端口的 `http://127.0.0.1:43100` 至 `43109` 提供 `POST /__base_app/dev-pair`,请求体为 `{challenge}`(32 字节随机数的 base64url)。要求 Host 精确匹配监听地址;Origin 精确等于本机 origin,或无 Origin 时 Sec-Fetch-Site 为 same-origin。显式外域/null Origin 即使带 same-origin 也拒绝。响应无 CORS 头、禁止缓存;服务端按监听端口确定 origin,不读取请求体 origin。
42
-
43
- 返回 `{proof}`,proof 为 `HMAC-SHA256(UTF8(令牌字符串), UTF8("base-app-dev-pair.v1\n" + localOrigin + "\n" + challenge))` 的 base64url。令牌不先 base64url 解码;宿主 WebCrypto 必须采用相同 key 字节。每次 channel 握手宿主生成新挑战,通过 `site.v1.development.pair` 调用 iframe,iframe 同源 fetch 后返回 proof;宿主常量时间验证通过,广播 `site.v1.development.paired` 的 `{challenge}`。SDK 启动和 runtime Promise 方法等待匹配的 accepted,宿主仍负责在配对前拒绝所有业务调用(不能依赖客户端 gate 作为安全边界)。旧 SDK 不支持配对时宿主失败关闭并要求升级。
41
+ 平台 UI 使用 @tanstack/react-query,BaseAppProvider 管理缓存生命周期和应用/环境/身份隔离;它是组件的必需 peer。React/ReactDOM peer 接受 ^19.2.0,业务可按锁文件使用兼容补丁版本。server/shared 没有 React 运行时导入。
44
42
 
45
- Vite HMR 不关闭 gate,不重新配对;仅整页或 iframe 重载重新配对。普通页面与旧 channel 宿主/夹具组合保留原行为。
43
+ ## 生命周期版本上报(0.5.0)
46
44
 
47
- 平台 UI 使用 @tanstack/react-query,BaseAppProvider 管理缓存生命周期和应用/环境/身份隔离;它是组件的必需 peer。React/ReactDOM peer 接受 ^19.2.0,业务可按锁文件使用兼容补丁版本。server/shared 没有 React 运行时导入。
45
+ 应用启动成功或失败时会自动报告 SDK 版本,便于排查问题,无需新增配置。
package/docs/testing.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 测试替身
2
2
 
3
- 安装可选 peer msw@2.11.6 后从 SDK/testing 导入。单元/组件测试使用 [`createMockHost`](exports.md#testing)().channel;不需要手工 mock channel 模块。替身无真实身份、无后端或 seclink 服务,不作为开发主路径或真实授权证明。开发时应使用真实宿主会话。
3
+ 安装可选 peer msw@2.11.6 后从 SDK/testing 导入。单元/组件测试使用 [`createMockHost`](exports.md#testing)().channel;不需要手工 mock channel 模块。替身无真实身份、无后端或链接安全检查服务,不作为开发主路径或真实授权证明。开发时应使用真实宿主会话。
4
4
 
5
5
  <!-- example: mock.ts -->
6
6
  ```ts
@@ -16,7 +16,7 @@ export async function testUser() {
16
16
 
17
17
  `createMockHost({context,capabilities,bindings,allowedRoutes,secureLinkAvailable,functions,handlers,failures})`:context 提供模拟 locale/env/siteToken;capabilities 缺失模拟未提供能力字段的宿主,空表显式关闭能力;bindings 默认空,拒绝全部上传;allowedRoutes 默认固定宿主白名单。
18
18
  11 个 site.v1 API 都有默认响应,业务函数只有显式登记才允许;`handlers` 可替换下游结果,但不能绕过前置拒绝规则。`failures` 为指定 API 注入错误码。HTTP handler 返回 wire response(body/headers/status/statusText),runtime client 转为 Response。
19
- `calls/events` 仅保留测试夹具数据;dispose 清理监听、流、挂起请求和浏览器宿主。HTTP/上传支持定点取消;可通过 emit 注入进度、mode、AI error/done,通过 emitStreamMessage 注入带 seq 的流消息。默认不模拟真实上传耗时、AI 内容、并发排队、seclink 重定向或 backend 身份。
19
+ `calls/events` 仅保留测试夹具数据;dispose 清理监听、流、挂起请求和浏览器宿主。HTTP/上传支持定点取消;可通过 emit 注入进度、mode、AI error/done,通过 emitStreamMessage 注入带 seq 的流消息。默认不模拟真实上传耗时、AI 内容、并发排队、链接安全检查重定向或 backend 身份。
20
20
  `mount(container,url,allowedOrigin?)` 在真实浏览器中使用 channel 的 Host 创建 iframe;默认 origin 来自 url,sandbox 保留脚本/同源/下载限制,不允许弹窗(不模拟表单和模态框)。返回卸载函数。origin/source 错误由真实 channel 丢弃,不虚构业务错误回包;直接 channel 对象是内存调用,不声称校验浏览器 origin。
21
21
 
22
22
  ## HTTP 层 MSW
@@ -32,26 +32,6 @@ export const handlers = createHttpHandlers([
32
32
 
33
33
  MSW 工厂仅服务真正的 HTTP 请求,如 FaaS 下游或页面直接请求。宿主 postMessage 调用不经过网络,需上述 mock host。测试入口及 MSW 不会被 page/server/shared 导入。
34
34
 
35
- ## 拒绝规则来源与逐条对照
35
+ ## 模拟请求的限制
36
36
 
37
- 拒绝规则与宿主纯校验实现逐条对照;源码快照、版本来源及摘要仅保存在仓库测试目录。隔离测试仅替换日志、平台配置、身份注入与下游传输,不替换拒绝规则。
38
-
39
- | 规则 | 原文件 | 测试 |
40
- |---|---|---|
41
- | origin 白名单,绑定 sourceWindow | apps/site-web/src/view/preview/runtime-host.ts;channel src/host.ts:255 | test/browser/run.mjs:真实 Host 接受正确请求,错误 origin/source 不调用 handler |
42
- | http/https/mailto/tel 之外链接,空 URL、相对 URL | apps/site-web/src/view/preview/open-link.ts | rules.test.ts 链接矩阵,javascript/data/file 逐例 |
43
- | http(s) seclink 不可用 | apps/site-web/src/view/preview/open-link.ts | rules.test.ts seclink 不可用 |
44
- | 单斜杠、跨域、反斜杠、fragment、编码、穿越、控制字符 | apps/site-web/src/view/preview/http-proxy.ts | rules.test.ts HTTP 路径矩阵 |
45
- | Header 类型、名称、禁止清单及前缀 | apps/site-web/src/view/preview/http-proxy.ts | rules.test.ts 每个受限头单独用例 |
46
- | method、body、GET body、timeout | apps/site-web/src/view/preview/http-proxy.ts | rules.test.ts HTTP init 矩阵 |
47
- | 默认路由白名单/方法 | apps/site-web/src/view/preview/http-bridge-allowlist.ts | rules.test.ts 非白名单与合法读取;默认表逐条等价测试 |
48
- | responseType、空/重复/过长 requestId | apps/site-web/src/view/preview/http-proxy.ts | rules.test.ts 与 runtime.test.ts |
49
- | 上传 File、非空、2 GiB、Base/表成对绑定 | apps/site-web/src/view/preview/attachment-proxy.ts | rules.test.ts 附件矩阵 |
50
- | 封面/下载 file/table/field/record、应用、环境、单文件对应 | apps/site-web/src/view/preview/http-attachment-context.ts | rules.test.ts 下载坐标矩阵及封面缺坐标拒绝 |
51
- | Function 格式与发布清单 | apps/site-web/src/view/preview/function-proxy.ts | runtime.test.ts 函数拒绝 |
52
-
53
- 实现采用原宿主的纯校验片段(HTTP normalize、白名单匹配、附件上下文);仅移除平台配置读取并导出测试需要的函数,不复制 channel 实现。宿主版本变化时需更新快照、规则和矩阵一起审查。生产鉴权仍由真正的宿主和服务端执行,模拟成功不证明真实权限。
54
-
55
- ## 验证入口
56
-
57
- npm test 执行构建、node:test、入口依赖扫描和 examples 的 TypeScript 编译;server/shared 还在无 DOM、带 Node types 的配置下检查。test/browser/run.mjs 为本地真实 Chrome 页面夹具服务,使用 agent-browser 独立会话访问并采集结果;浏览器检查需显式执行,未宣称已自动接入仓外 CI。
37
+ 模拟宿主会校验 HTTP 路径、方法、请求头、附件坐标和应用绑定;真实权限仍需在运行环境中验证。
package/docs/upgrade.md CHANGED
@@ -5,3 +5,76 @@ SDK API 的版本变更见随包 [CHANGELOG](../CHANGELOG.md),升级与迁移
5
5
  存量 classic 的工程迁移由 coding agent 执行;步骤、输入声明与改前/改后示例统一以随 CLI 安装的建站 Skill `references/workspace-migration.md` 为准。CLI 只做配置、契约、类型和构建校验,不改写 helper 或自动搬迁工程。
6
6
 
7
7
  安装或升级本 SDK 前,核对已发布版本、Node 与 peerDependencies;保存源码和锁文件,保留业务扩展。按已安装版本的 [Page 启动说明](start-base-app.md) 接入应用生命周期,服务端契约按 [服务端说明](server.md) 编写。契约改变后显式运行 `base-database-cli contracts generate` 再 `base-database-cli check --json`;本地通过不代替 Preview 业务验收。
8
+
9
+ ## 0.3.0 迁移
10
+
11
+ #### 会坏什么
12
+
13
+ `invokeDatabaseMutationBatch<MyType>` 不再接受调用方指定的返回类型。任意字符串 ID、非 Mutation ID、错误参数及缺少生成映射的旧调用会编译失败;动态 ID 必须与它对应的参数保持关联。Mutation 无输出 Schema 时,生成结果由 `unknown` 变为平台固定的 `DatabaseMutationResult`。HTTP 请求和一层响应 envelope 保持原协议;从 0.1.x 升级还须完成下方 0.2.0 的不兼容迁移。
14
+
15
+ #### 怎么在代码里找受影响处
16
+
17
+ 在 Page 源码中定位 Mutation 调用及结果处理,再核对对应的 `mutations/<functionId>/spec.json`。例如在工程根运行:
18
+
19
+ ```sh
20
+ rg -n -U 'invokeDatabaseMutationBatch\s*<' page/src
21
+ rg -n 'invokeDatabaseFunction|invokeDatabaseMutationBatch|record_ids|record_not_found|ignored_fields' page/src
22
+ ```
23
+
24
+ 核对批量调用的真实 SDK 导入来源、ID 对应的 Mutation 声明,以及每组参数的名称、类型和必填字段;检查宽泛的字符串 ID、联合 ID 与参数错配。再定位手写的 Mutation 返回类型、平台字段结构校验及处理 `unknown` 的类型断言,保留应用自有业务校验。
25
+
26
+ #### 修改步骤
27
+
28
+ 1. 使用配套 CLI 和同包 Skill。用户授权升级后,将 Page 和 Server 的 SDK 依赖一起升级到目标版本并更新锁文件;单独升级 CLI 不会更换工程内的 SDK。
29
+ 2. 运行 `base-database-cli contracts generate`,由工程内 SDK 更新输入、输出及 Mutation ID 映射;不手改生成文件。没有 Mutation 标记或任一输入/输出映射时,先核对 Function 声明与 codegen 结果。
30
+ 3. 删除批量 helper 的返回泛型,使用已声明的 Mutation ID 和对应的命名参数对象数组。动态选择 ID 时同时保留其参数关联,不用强转或宽泛类型回退消除错误。直接调用和批量调用都按 ID 推断结果;无输出 Schema 时使用 `DatabaseMutationResult`,需要引用时从 SDK `/page` 导入,删除重复的本地类型和平台结构校验。
31
+ 4. 保留顶层 `code`、`data` 缺失、`record_not_found` / `ignored_fields` 部分失败及预期写入数量的业务检查。FaaS 无输出 Schema 时仍为 `unknown`,不按 Mutation 处理。
32
+
33
+ #### 验证命令
34
+
35
+ 在 workspace 工程根运行:
36
+
37
+ ```sh
38
+ base-database-cli contracts generate
39
+ base-database-cli check --json
40
+ npm run build --workspace page
41
+ ```
42
+
43
+ classic 工程的 Page 构建改用 `npm run build --prefix page`。确认生成结果包含 Mutation ID 与输入/输出映射,错误 ID、参数和手写返回泛型被编译拒绝,并覆盖完整成功、部分失败及结果缺失的业务分支;本地构建通过不代表远端写入或权限验收完成。
44
+
45
+ ## 0.2.0 迁移
46
+
47
+ #### 会坏什么
48
+
49
+ `invokeDatabaseFunction<MyType>` 不再接受调用方指定的返回类型,结果由 Function ID 对应的生成映射决定;没有生成映射的 ID 会被类型检查拒绝。SQL 的 `data` 是含 `rows` 的对象,无可信列 Schema 时行类型为 `unknown`。本次改变编译期契约,不改变一层 `{code,msg,data}` 的运行时响应。
50
+
51
+ #### 怎么在代码里找受影响处
52
+
53
+ 在工程根定位直接调用、旧返回泛型及结果处理;重新导出或自定义包装的调用也要核对:
54
+
55
+ ```sh
56
+ rg -n -U 'invokeDatabaseFunction\s*<' page/src
57
+ rg -n 'invokeDatabaseFunction|invokeDatabaseMutationBatch|result\.data|FunctionInputMap|FunctionOutputMap' page/src
58
+ ```
59
+
60
+ 重点检查把 SQL `data` 当成数组、二次解包 `data`、手写模块扩充,以及用 `as` 或 `any` 绕过返回类型的地方。classic 自有 helper 的泛型不属于 SDK API,须先核对真实导入来源。
61
+
62
+ #### 修改步骤
63
+
64
+ 1. 先使用支持 Function 输出映射的配套 CLI 和同包 Skill。旧 CLI 若未向 codegen 传递 `functionType`,先升级 CLI;CLI 更新不会自动升级工程 SDK。
65
+ 2. 未获用户授权时保留工程依赖,按实际安装版本的包内 docs 开发。获授权后,将 Page 和 Server 的 SDK 一起升级到目标版本并更新锁文件;跨多个不兼容版本时逐一阅读 Migration。
66
+ 3. 运行 `base-database-cli contracts generate`,生成输入和输出映射。纯 SQL 工程也要生成;已有生成客户端提供模块扩充时复用其唯一来源,不手改生成文件或重复声明扩充。
67
+ 4. 删除 SDK 直接调用中的手写返回泛型,按 Function ID 推断类型。SQL 先检查业务码和 `data`,再读取 `result.data.rows`;不把结果当行数组,也不二次解包。
68
+ 5. 本版本没有输出 Schema 的 FaaS/Mutation 仍返回 `unknown`,使用前按真实契约校验;Mutation 固定返回类型在 0.3.0 提供。不要添加类型断言或恢复旧泛型来绕过升级产生的错误。
69
+
70
+ #### 验证命令
71
+
72
+ 在 workspace 工程根运行:
73
+
74
+ ```sh
75
+ base-database-cli contracts generate
76
+ base-database-cli check --json
77
+ npm run build --workspace page
78
+ ```
79
+
80
+ classic 工程的 Page 构建改用 `npm run build --prefix page`。逐项修复生成、类型或构建诊断后重跑;保留原有业务回归,覆盖 SQL 结果读取及错误分支。命令通过只证明本地迁移完成,远端行为另按工程验收流程确认。
@@ -1,4 +1,4 @@
1
- // 模板 1 可先迁移 helper 导入;切换启动入口与模板 2 是独立的手动步骤。
1
+ // classic 工程可先迁移 helper 导入,再按升级指引切换启动入口。
2
2
  import { installLinkGuard, siteRuntime, classifyRuntimeError } from '@lark-base-open/base-database-app-sdk/page';
3
3
  export function initializeRuntime() {
4
4
  const uninstall = installLinkGuard();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lark-base-open/base-database-app-sdk",
3
- "version": "0.5.0-durable.0",
3
+ "version": "0.5.1",
4
4
  "description": "Base Database 页面与服务端 SDK、平台组件及测试工具",
5
5
  "type": "module",
6
6
  "sideEffects": [
@@ -54,26 +54,6 @@
54
54
  "types": "./dist/codegen.d.cts",
55
55
  "default": "./dist/codegen.cjs"
56
56
  }
57
- },
58
- "./durable/workflow": {
59
- "import": {
60
- "types": "./dist/durable/workflow.d.cts",
61
- "default": "./dist/durable/workflow.cjs"
62
- },
63
- "require": {
64
- "types": "./dist/durable/workflow.d.cts",
65
- "default": "./dist/durable/workflow.cjs"
66
- }
67
- },
68
- "./durable/activity": {
69
- "import": {
70
- "types": "./dist/durable/activity.d.cts",
71
- "default": "./dist/durable/activity.cjs"
72
- },
73
- "require": {
74
- "types": "./dist/durable/activity.d.cts",
75
- "default": "./dist/durable/activity.cjs"
76
- }
77
57
  }
78
58
  },
79
59
  "files": [
@@ -86,18 +66,8 @@
86
66
  "capabilities.json",
87
67
  "development-pairing.json"
88
68
  ],
89
- "scripts": {
90
- "build": "node scripts/sync-contract-schema.mjs --check && node scripts/sync-capabilities.mjs && tsup && tsup --config tsup.cjs.config.ts && cp src/page/theme.css dist/theme.css && node scripts/build-durable.cjs",
91
- "test": "npm run check:migrations && node scripts/sync-capabilities.mjs --check && npm run build && node --import tsx --test test/*.test.ts && npm run test:types && npm run test:components",
92
- "check:migrations": "node scripts/check-migrations.mjs",
93
- "prepublishOnly": "npm run check:migrations",
94
- "test:types": "tsc -p tsconfig.examples.json && tsc -p tsconfig.server.json && tsc -p tsconfig.cjs.json",
95
- "test:browser": "node test/browser/verify.mjs && node test/browser/ui-verify.mjs",
96
- "test:components": "vitest run",
97
- "docs:exports": "node scripts/doc-exports.mjs"
98
- },
99
69
  "dependencies": {
100
- "@lark-base-open/base-site-channel": "0.1.6",
70
+ "@lark-base-open/base-site-channel": "0.2.0",
101
71
  "@radix-ui/react-popover": "1.2.0",
102
72
  "@standard-schema/spec": "1.0.0",
103
73
  "cmdk": "1.1.1",
@@ -107,37 +77,13 @@
107
77
  "@tanstack/react-query": "5.104.1",
108
78
  "msw": "2.11.6",
109
79
  "react": "^19.2.0",
110
- "react-dom": "^19.2.0",
111
- "@temporalio/activity": "1.24.0",
112
- "@temporalio/workflow": "1.24.0"
80
+ "react-dom": "^19.2.0"
113
81
  },
114
82
  "peerDependenciesMeta": {
115
83
  "msw": {
116
84
  "optional": true
117
- },
118
- "@temporalio/activity": {
119
- "optional": true
120
- },
121
- "@temporalio/workflow": {
122
- "optional": true
123
85
  }
124
86
  },
125
- "devDependencies": {
126
- "@testing-library/react": "16.3.0",
127
- "@types/node": "22.15.0",
128
- "@types/react": "19.2.17",
129
- "@types/react-dom": "19.2.3",
130
- "jsdom": "26.1.0",
131
- "msw": "2.11.6",
132
- "pngjs": "7.0.0",
133
- "tsup": "6.7.0",
134
- "tsx": "4.20.3",
135
- "typescript": "5.8.3",
136
- "vitest": "3.2.4",
137
- "zod": "4.2.1",
138
- "@temporalio/activity": "1.24.0",
139
- "@temporalio/workflow": "1.24.0"
140
- },
141
87
  "typesVersions": {
142
88
  "*": {
143
89
  "server": [
@@ -148,12 +94,6 @@
148
94
  ],
149
95
  "codegen": [
150
96
  "dist/codegen.d.cts"
151
- ],
152
- "durable/workflow": [
153
- "dist/durable/workflow.d.ts"
154
- ],
155
- "durable/activity": [
156
- "dist/durable/activity.d.ts"
157
97
  ]
158
98
  }
159
99
  }
@@ -1 +0,0 @@
1
- import{a as Ne,b as W,c as Be}from"./chunk-ZKBZAK4L.js";import{a as Q}from"./chunk-3JX3FIBG.js";import{a as N}from"./chunk-OHPYKFCM.js";import{createContext as en,useContext as rt}from"react";import{createContext as Yt,useContext as Gt,useEffect as Kt,useSyncExternalStore as Jt}from"react";import{capabilityNames as xt}from"@lark-base-open/base-site-channel/capabilities";import*as S from"@lark-base-open/base-site-channel/runtime";import{SITE_RUNTIME_PROTOCOL_VERSION as On,SiteRuntimeApi as oe,SiteRuntimeEvent as Fn,SiteRuntimeFunction as Nn,SiteRuntimeErrorCode as Bn,readSiteAITextDelta as jn,isValidSiteFunctionName as $n}from"@lark-base-open/base-site-channel/runtime-contract";var Y=()=>{throw new Q(W.ContextInvalid,"\u5BBF\u4E3B\u80FD\u529B\u5B57\u6BB5\u65E0\u6548")};function fe(e){if(!e||typeof e!="object")return Y();if(e.capabilities===void 0)return Object.fromEntries(Object.entries(Ne).filter(([,o])=>o.baseline).map(([o])=>[o,{version:1}]));let t=e.capabilities;if(!t||typeof t!="object"||Array.isArray(t))return Y();let n=Object.entries(t);return n.some(([,o])=>!o||typeof o!="object"||Array.isArray(o)||!Number.isSafeInteger(o.version)||o.version<=0)?Y():Object.fromEntries(n.map(([o,r])=>[o,{version:r.version}]))}function Et(e,t,n=1){if(!Number.isSafeInteger(n)||n<1)return Y();let o=fe(e);return Object.prototype.hasOwnProperty.call(o,t)&&o[t].version>=n}async function Ut(e=E){return fe(await e.getRuntimeContext())}var qn=Ut;async function St(e,t=1,n=E){let o=await n.getRuntimeContext(),r=fe(o),i=Et(o,e,t),a=o.capabilityUnavailable;if(a!==void 0&&(!a||typeof a!="object"||Array.isArray(a)))return Y();let s=a&&Object.prototype.hasOwnProperty.call(a,e)?a[e]:void 0;return s!==void 0&&(!s||typeof s!="object"||!["permission-denied","region-unavailable","temporarily-unavailable"].includes(s.reason)||typeof s.retryable!="boolean")?Y():{name:e,requiredVersion:t,version:Object.prototype.hasOwnProperty.call(r,e)?r[e].version:null,supported:i,source:o.capabilities===void 0?"host-baseline":"advertised",availability:i?s?.reason??"unknown":"unsupported"}}async function je(e,t=1,n=E){let o=await n.getRuntimeContext(),r=await St(e,t,{getRuntimeContext:async()=>o});if(!r.supported)throw new Be(e,t);let i={"permission-denied":W.PermissionDenied,"region-unavailable":W.RegionUnavailable,"temporarily-unavailable":W.TemporarilyUnavailable};if(r.availability in i)throw new Q(i[r.availability],"\u5BBF\u4E3B\u660E\u786E\u62D2\u7EDD\u6B64\u80FD\u529B",void 0,o.capabilityUnavailable?.[e]?.retryable)}function $e(e,t){let n,o=!1,r,i=new Promise(a=>{r=a});return e.registerApi(N.pairApi,async a=>{if(!a||!/^[A-Za-z0-9_-]{43}$/.test(a.challenge))throw new Error("INVALID_PAIRING_CHALLENGE");n=a.challenge;let s=n;o&&(o=!1,i=new Promise(u=>{r=u}));let c=await t(N.endpoint,{method:"POST",credentials:"omit",cache:"no-store",redirect:"error",headers:{"Content-Type":"application/json"},body:JSON.stringify({challenge:s})});if(!c.ok)throw new Error("DEVELOPMENT_PAIRING_FAILED");let d=await c.json();if(!/^[A-Za-z0-9_-]{43}$/.test(d.proof))throw new Error("INVALID_PAIRING_PROOF");return{proof:d.proof}}),e.subscribeEvent(N.pairedEvent,a=>{n&&a?.challenge===n&&(o=!0,r())}),{reset:()=>{n=void 0,o&&(o=!1,i=new Promise(a=>{r=a}))},wait:async()=>{let a;do a=i,await a;while(a!==i)}}}var He=typeof window<"u"&&window.location.protocol==="http:"&&window.location.hostname===N.host&&Number(window.location.port)>=N.portMin&&Number(window.location.port)<=N.portMax;var ze=S.siteRuntime,_=ze.getChannel?.()??ze.channel,Pt=He&&typeof window<"u"&&window.parent!==window?$e(_,globalThis.fetch.bind(globalThis)):void 0;function qe(e,t=async()=>{}){let n=new Map,o=async(r,i)=>{await t();for(let a of xt(r,i))try{await je(a,1,{getRuntimeContext:()=>e.invokeApi(oe.RuntimeContext,void 0)})}catch(s){throw s instanceof Error&&"code"in s?Object.assign(new S.SiteRuntimeInvocationError(String(s.code),s.message),s):s}};return{subscribeEvent:(r,i)=>e.subscribeEvent(r,i),emitEvent:async(r,i)=>(await o(r,i),e.emitEvent(r,i)),invokeApi:async(r,i,a)=>{let s=i?.requestId??i?.subscriptionId??i?.uploadId,c=r===oe.HttpRequestCancel||r===oe.AttachmentUploadCancel||r.endsWith(".close");if(c&&s&&n.has(s)){n.get(s).canceled=!0;return}let d={canceled:!1};!c&&s&&n.set(s,d);try{if(await o(r,i),d.canceled)throw new DOMException("The operation was aborted","AbortError");return s&&n.delete(s),await e.invokeApi(r,i,a)}finally{s&&n.get(s)===d&&n.delete(s)}}}}var At={invokeApi:_.invokeApi.bind(_),emitEvent:_.emitEvent.bind(_),subscribeEvent:_.subscribeEvent.bind(_)},be=qe(At,async()=>{if(typeof window<"u"&&window.parent===window)throw new S.SiteRuntimeInvocationError("CHANNEL_UNAVAILABLE","\u9875\u9762\u672A\u8FDE\u63A5\u5BBF\u4E3B channel");await Pt?.wait()});_.invokeApi=be.invokeApi;_.emitEvent=be.emitEvent;var ge=class extends S.SiteRuntimeClient{constructor(t){super(t?qe(t):be)}},Xn=e=>new ge(e),E=S.siteRuntime,{invokeHttp:re,invokeApi:Zn,getCurrentUser:X,logout:he,requestEdit:kt,uploadAttachment:eo,openLink:ae}=E,It=(e=E,t)=>S.createSiteRuntimeFetch(e,t),D=It();var _t=re,Tt=/^\/?(preview\/)?app\/([^/]+)(\/|$)/,Ve=/^[A-Za-z0-9_-]+$/,Ge="/space/api/bitable/site/v1",Dt="/space/api/box/file/temporary_download_url",G="preview",Z=null;function Mt(){let t=(typeof globalThis.location>"u"?void 0:globalThis.location)?.ancestorOrigins?.[0];if(t)return t;let n=typeof globalThis.document>"u"?"":globalThis.document.referrer;if(!n)return"";try{return new URL(n).origin}catch{return""}}function we(){let e=typeof globalThis.location>"u"?"":globalThis.location.pathname,t=Tt.exec(e),n=Mt();return t?{env:t[1]?G:"prod",gatewayOrigin:n,token:decodeURIComponent(t[2]??"")}:{env:"prod",gatewayOrigin:n,token:""}}function B(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Lt(e){return e===G||e==="prod"}function Ot(e){if(!B(e))return{};let t=typeof e.siteToken=="string"?e.siteToken.trim():"";return{...t?{token:t}:{},...Lt(e.env)?{env:e.env}:{}}}async function j(){return Z||(Z=(async()=>{let e=we(),t={},n;try{n=await E.getRuntimeContext(),t=Ot(n)}catch(r){console.warn("Could not read the host Runtime context; inferring it from the artifact path",r)}ie=qt(n);let o={env:t.env??e.env,gatewayOrigin:e.gatewayOrigin,token:t.token??e.token};return o.token||console.error("Cannot determine the app token: the host did not provide siteToken and the current path does not match an artifact path"),o})().catch(e=>{throw Z=null,ie={...Re},e}),Z)}function ve(e){return!!(e.tableId.trim()&&e.fieldId.trim()&&e.recordId.trim()&&e.fileToken.trim())}function Ke(e,t){return JSON.stringify({bitablePerm:{tableId:t.tableId,attachments:{[t.fieldId]:{[t.recordId]:[t.fileToken]}},siteToken:e.token,siteEnv:e.env}})}function Je(e,t){if(t instanceof Error)return t;let n=B(t)?t.code:void 0,o=typeof n=="string"||typeof n=="number"?String(n):"",r=o==="REQUEST_TIMEOUT"||o==="10005"?`${e} timed out`:`${e} failed`;return Object.assign(new Error(`${r}${o?` (code ${o})`:""}`),{cause:t,...o?{code:o}:{}})}async function Qe(e,t=360,n={}){if(n.signal?.throwIfAborted(),!ve(e)||!Number.isFinite(t)||t<=0)throw new Error("Attachment location or image size is invalid");let o=await j();if(n.signal?.throwIfAborted(),!o.token)throw new Error("Cannot load the attachment image without an app token");let r=[120,360,720,1280].find(c=>c>=t)??1280,i=new URLSearchParams({extra:Ke(o,e),width:String(r),height:String(r),policy:"allow_up",fallback_source:"1"}),a=await _t({url:`/space/api/box/stream/download/v2/cover/${encodeURIComponent(e.fileToken)}?${i}`,init:{method:"GET",responseType:"arrayBuffer",timeoutMs:45e3},signal:n.signal}).catch(c=>{throw Je("Attachment image request",c)});if(!a.ok){let c=a.headers.get("x-tt-logid");throw new Error(`Failed to load attachment image: HTTP ${a.status}${c?`, LogID ${c}`:""}`)}let s=await a.blob();if(!s.size||!s.type.startsWith("image/"))throw new Error("The host did not return a valid image");return s}async function Ft(e,t){if(!e.token)throw new Error("Cannot get an attachment download URL without an app token");if(!ve(t))throw new Error("Cannot get an attachment download URL: the attachment location is incomplete");let n=await D(Dt,{body:JSON.stringify({extra:Ke(e,t),file_token:t.fileToken}),headers:{"content-type":"application/json"},method:"POST"}).catch(s=>{throw Je("Attachment download URL request",s)}),o=n.headers?.get("x-tt-logid")?.trim(),r;try{r=await n.json()}catch{throw new Error(n.ok?`Attachment download URL response is not valid JSON${o?`, LogID ${o}`:""}`:`Failed to get attachment download URL: HTTP ${n.status}${o?`, LogID ${o}`:""}`)}let i=B(r)?r.code:void 0;if(typeof i=="number"&&i!==0||typeof i=="string"&&i.trim()!==""&&i.trim()!=="0"){let s=new Error(`Attachment service could not provide a download URL (code ${String(i)}${o?`, LogID ${o}`:""})`);throw Object.assign(s,{code:String(i),cause:r})}if(!n.ok)throw new Error(`Failed to get attachment download URL: HTTP ${n.status}${o?`, LogID ${o}`:""}`);let a=B(r)&&B(r.data)&&typeof r.data.url=="string"?r.data.url.trim():"";if(!a)throw new Error(`Attachment download URL response is missing data.url${o?`, LogID ${o}`:""}`);return a}function We(e){let t=new URLSearchParams;e.env===G&&t.set("env",G);let n=t.toString(),o=`${Ge}/${encodeURIComponent(e.token)}/invoke_get`;return n?`${o}?${n}`:o}function Xe(e,t){if(!Ve.test(t))throw new TypeError(`functionId ${t} does not match the required pattern ${String(Ve)}`);let n=`${Ge}/${encodeURIComponent(e.token)}/functions/${encodeURIComponent(t)}/invoke`;return e.env===G?`${n}?env=${encodeURIComponent(G)}`:n}var Nt="x-base-site-session-id",Bt="x-base-site-read-your-writes",jt=800008918,Ye=new Map,Re={maxRetries:3,intervalMs:300},ie={...Re},$t=10,Ht=100,zt=2e3;function qt(e){let t=B(e)?e.readYourWritesRetry:void 0;return B(t)&&Number.isInteger(t.maxRetries)&&t.maxRetries>=0&&t.maxRetries<=$t&&Number.isInteger(t.intervalMs)&&t.intervalMs>=Ht&&t.intervalMs<=zt?{maxRetries:t.maxRetries,intervalMs:t.intervalMs}:{...Re}}function Vt(e){let t=Ye.get(e);if(t)return t;let n=`baseSite:session:${e}`,o;try{o=localStorage.getItem(n)||void 0}catch{o=void 0}if(!o){try{o=crypto.randomUUID()}catch{return}try{localStorage.setItem(n,o)}catch{}}return Ye.set(e,o),o}function Ze(e){let t=Vt(e);return{"content-type":"application/json",...t?{[Nt]:t}:{}}}var ye=class extends Q{logId;constructor(t={}){super("FUNCTION_INVOKE_FAILED","The write has succeeded but the data is not readable yet. Do not repeat the write; retry the query shortly.","800008918",!0),this.name="DataNotReadyError",this.logId=t.logId}};async function ro(e,t,n){let o=await j();if(!o.token)throw new Error(`Cannot invoke Function ${e} without an app token`);let r=n?.readYourWrites!==!1,i={...Ze(o.token),...r?{[Bt]:"1"}:{}},a=()=>re({url:Xe(o,e),init:{body:JSON.stringify({params:t}),headers:i,method:"POST"}});for(let s=0;;s++){let c=await a();if(!c.ok)throw new Error(`Function ${e} request failed: HTTP ${c.status}`);let d=await c.json();if(r&&d?.code===jt){if(s<ie.maxRetries){await new Promise(u=>setTimeout(u,ie.intervalMs));continue}throw new ye({logId:d.data?.log_id})}return d}}async function ao(e,t){if(!Array.isArray(t)||t.length<1||t.length>200||t.some(r=>r===null||typeof r!="object"||Array.isArray(r)))throw new TypeError("Mutation batch requires 1 to 200 named parameter objects");let n=await j();if(!n.token)throw new Error("\u5E94\u7528 token \u672A\u786E\u5B9A\uFF0C\u65E0\u6CD5\u8C03\u7528 Mutation");let o=await re({url:Xe(n,e),init:{body:JSON.stringify({batch:t.map(r=>({params:r}))}),headers:Ze(n.token),method:"POST"}});if(!o.ok)throw new Error(`Mutation \u8C03\u7528\u5931\u8D25\uFF1AHTTP ${o.status}`);return await o.json()}async function io(e,t){let n=await Ft(e,t);if(!(await ae(n)).opened)throw new Error("The host did not open the attachment download link")}function so(e,t,n=360){if(!e.gatewayOrigin||!e.token||!ve(t))return"";let o=[120,360,720,1280].find(i=>i>=n)??1280,r=new URLSearchParams({extra:JSON.stringify({bitablePerm:{tableId:t.tableId,attachments:{[t.fieldId]:{[t.recordId]:[t.fileToken]}},baseAppToken:e.token}}),width:String(o),height:String(o),policy:"allow_up",fallback_source:"1"});return`${e.gatewayOrigin}/space/api/box/stream/download/v2/cover/${encodeURIComponent(t.fileToken)}?${r.toString()}`}var Se=Yt(void 0),tt=[{id:"en",locale:"en-US",match:/^en(?:-|$)/},{id:"zh",locale:"zh-CN",match:/^zh(?:-|$)/},{id:"ja",locale:"ja-JP",match:/^ja(?:-|$)/}],Ee=new Set,nt,Ce=null;function Ue(e){if(typeof e!="string")return;let t=e.trim().replace(/_/g,"-").toLowerCase();return tt.find(({match:n})=>n.test(t))?.id}function Qt(){return typeof navigator>"u"?void 0:navigator.language}function Wt(e,t){return Ue(e)??Ue(t)??"en"}function $(){return nt??Wt(void 0,Qt())}function xe(e=$()){return tt.find(({id:t})=>t===e)?.locale??"en-US"}function Xt(e){return Ee.add(e),()=>Ee.delete(e)}function et(e){nt=Ue(e);let t=$();ot(t);for(let n of Ee)n();return t}function ot(e){typeof document<"u"&&(document.documentElement.lang=xe(e))}function Zt(){return Ce||(ot($()),Ce=E.getRuntimeContext().then(e=>et(e?.locale)).catch(()=>et(void 0))),Ce}function x(){let e=Gt(Se),t=Jt(Xt,$,()=>"en");return Kt(()=>{e||Zt()},[e]),e??t}import{jsx as Pe}from"react/jsx-runtime";var Ae=en(null);function ho({children:e,...t}){return Pe(Ae.Provider,{value:t,children:Pe(Se.Provider,{value:t.locale,children:Pe("div",{className:"base-app-platform","data-theme":t.theme,children:e})})})}function yo(){let e=rt(Ae);if(!e)throw new Error("BASE_APP_PROVIDER_REQUIRED");return e}function se(){return rt(Ae)}import{useState as ee,useEffect as st}from"react";import{QueryClient as tn}from"@tanstack/react-query";var ke=new tn({defaultOptions:{queries:{retry:!1,staleTime:3e4,gcTime:3e4}}});function ce(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function le(e,t){let n=e[t];return typeof n=="string"?n.trim():""}function nn(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}function H(){return{baseBindings:[],name:"",description:"",isOwner:!1,allowEdit:!1,organization:""}}function on(){let e=document.querySelector('meta[name="description"]');return e instanceof HTMLMetaElement?e:null}function rn(e){if(e.name&&(document.title=e.name),e.description){let t=on();t&&(t.content=e.description)}}function an(e){return Array.isArray(e)?e.reduce((t,n)=>{if(!ce(n))return t;let o=le(n,"baseToken");return o&&t.push({baseToken:o,tableIds:nn(n.tableIds)}),t},[]):[]}function sn(e){if(!ce(e)||e.code!==0)return H();let t=e.data;if(!ce(t))return H();let n=t.site;return ce(n)?{baseBindings:an(n.baseBindings),description:le(n,"description"),name:le(n,"name"),isOwner:t.isOwner===!0,allowEdit:n.allowEdit===void 0?t.isOwner===!0:n.allowEdit===!0,organization:le(n,"organization")}:H()}async function at(e){try{let t=await D(We(e),{method:"GET"});if(!t.ok)return H();let n=await t.json(),o=sn(n);return rn(o),o}catch{return H()}}async function K(){let e=await j();if(!e.token)return H();let t=await X().catch(()=>null);return t?.userId?ke.fetchQuery({queryKey:["project-meta",e.token,e.env,t.userId],queryFn:()=>at(e)}):at(e)}var cn="https://feishu.cn/base/site/detail/overview";async function it(){try{await E.requestEdit();return}catch{let{token:e}=await j(),t=new URL(cn);if(t.searchParams.set("token",e),!(await ae(t.toString())).opened)throw new Error("Management page was not opened")}}import{jsx as z,jsxs as ct}from"react/jsx-runtime";var ln={en:{openFailed:"Unable to open the management page. Please try again.",editSite:"Edit and manage your apps",hidePanel:"Hide until next visit",hiddenConfirmation:"Edit button hidden until you reopen the app",dismissNotification:"Dismiss notification"},zh:{openFailed:"\u65E0\u6CD5\u6253\u5F00\u7BA1\u7406\u9875\u9762\uFF0C\u8BF7\u91CD\u8BD5",editSite:"\u7F16\u8F91\u4E0E\u7BA1\u7406\u5E94\u7528",hidePanel:"\u9690\u85CF\u9762\u677F",hiddenConfirmation:"\u7F16\u8F91\u6309\u94AE\u5DF2\u9690\u85CF\uFF0C\u76F4\u81F3\u4E0B\u6B21\u91CD\u65B0\u6253\u5F00\u5E94\u7528",dismissNotification:"\u5173\u95ED\u63D0\u793A"},ja:{openFailed:"\u7BA1\u7406\u30DA\u30FC\u30B8\u3092\u958B\u3051\u307E\u305B\u3093\u3067\u3057\u305F\u3002\u3082\u3046\u4E00\u5EA6\u304A\u8A66\u3057\u304F\u3060\u3055\u3044\u3002",editSite:"\u30A2\u30D7\u30EA\u3092\u7DE8\u96C6\u30FB\u7BA1\u7406",hidePanel:"\u6B21\u56DE\u306E\u30A2\u30AF\u30BB\u30B9\u307E\u3067\u975E\u8868\u793A",hiddenConfirmation:"\u7DE8\u96C6\u30DC\u30BF\u30F3\u3092\u975E\u8868\u793A\u306B\u3057\u307E\u3057\u305F\u3002\u30A2\u30D7\u30EA\u3092\u518D\u5EA6\u958B\u304F\u3068\u8868\u793A\u3055\u308C\u307E\u3059",dismissNotification:"\u901A\u77E5\u3092\u9589\u3058\u308B"}};function Mo({position:e="bottom-right",className:t="",slots:n={}}){let o=ln[x()],[r,i]=ee(!1),[a,s]=ee(!1),[c,d]=ee(!1),[u,p]=ee(!1),[b,g]=ee(!1);st(()=>{let h=!0;return K().then(O=>{h&&i(O.allowEdit&&we().env==="prod")}).catch(()=>{}),()=>{h=!1}},[]),st(()=>{if(!c)return;let h=setTimeout(()=>d(!1),3e3);return()=>clearTimeout(h)},[c]);let m=n.trigger,v=n.tooltip;return r?a?c?ct("div",{className:"base-app-platform base-app-notice",role:"status",children:[o.hiddenConfirmation,z("button",{"aria-label":o.dismissNotification,onClick:()=>d(!1),children:"\xD7"})]}):null:ct("div",{className:`base-app-platform base-app-floating ${t}`,"data-position":e,children:[u?z("div",{role:"alert",children:o.openFailed}):null,b?z("div",{role:"tooltip",children:v?z(v,{text:o.editSite}):o.editSite}):null,z("button",{"aria-label":o.editSite,onFocus:()=>g(!0),onBlur:()=>g(!1),onMouseEnter:()=>g(!0),onMouseLeave:()=>g(!1),onClick:()=>{p(!1),it().catch(()=>p(!0))},children:m?z(m,{}):"\u270E"}),z("button",{"aria-label":o.hidePanel,onClick:()=>{s(!0),d(!0)},children:"\xD7"})]}):null}var Ie=new Set;function lt(e){return Ie.add(e),()=>{Ie.delete(e)}}function ut(){for(let e of Ie)e()}import{useEffect as un,useState as pt}from"react";import*as M from"@radix-ui/react-popover";async function dt(){try{let e=await X();if(typeof e?.name=="string"&&e.name)return{name:e.name,avatarUrl:typeof e.avatarUrl=="string"?e.avatarUrl:"",tenantName:""}}catch{}try{let e=await D("/space/api/user/",{headers:{accept:"application/json"}});if(!e.ok)return null;let n=(await e.json()).data;return!n||typeof n.name!="string"||!n.name?null:{name:n.name,avatarUrl:typeof n.avatar_url=="string"?n.avatar_url:"",tenantName:typeof n.tenant_name=="string"?n.tenant_name:""}}catch{return null}}import{Fragment as pn,jsx as P,jsxs as _e}from"react/jsx-runtime";var dn={en:{account:"Account",logout:"Log out"},zh:{account:"\u8D26\u53F7",logout:"\u9000\u51FA\u767B\u5F55"},ja:{account:"\u30A2\u30AB\u30A6\u30F3\u30C8",logout:"\u30ED\u30B0\u30A2\u30A6\u30C8"}};function Ko({audience:e="enterprise",align:t="right",side:n="down",showName:o=!0,className:r="",slots:i={}}){let[a,s]=pt(null),[c,d]=pt(""),u=se(),p=dn[x()];if(un(()=>{if(e!=="enterprise")return;let m=!0;return Promise.all([dt(),K().catch(()=>null)]).then(([v,h])=>{m&&(s(v),d(v?.tenantName||h?.organization||""))}),()=>{m=!1}},[e]),e!=="enterprise"||!a)return null;let b=i.trigger,g=i.organization;return _e(M.Root,{children:[P(M.Trigger,{asChild:!0,children:P("button",{className:`base-app-platform base-app-user-menu ${r}`,"aria-label":p.account,children:b?P(b,{user:a}):_e(pn,{children:[a.avatarUrl?P("img",{src:a.avatarUrl,alt:"",referrerPolicy:"no-referrer"}):P("span",{children:a.name.slice(0,1)}),o?a.name:null]})})}),P(M.Portal,{children:_e(M.Content,{"data-theme":u?.theme,className:"base-app-platform base-app-popover",align:t==="right"?"end":"start",side:n==="up"?"top":"bottom",sideOffset:8,collisionPadding:8,children:[P("strong",{children:a.name}),g?P(g,{name:c}):P("p",{children:c}),P("button",{onClick:()=>{ut(),ke.clear(),he().catch(()=>{for(let m of["base-site-session","session","sl_session"])document.cookie=`${m}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/`;window.location.reload()})},children:p.logout})]})})]})}import{useEffect as ue,useRef as gt,useState as q}from"react";import{Command as te}from"cmdk";import{QueryClient as Un,useQuery as Sn}from"@tanstack/react-query";var mn="/space/api/mention/recommend.v2/",fn="8",gn="4",bn="0",hn=20,mt={en:{businessError:e=>`Could not search members (error code ${e})`,httpError:e=>`Member search request failed: HTTP ${e}`,invalidResponse:"Member search response has an invalid structure",noBoundBase:"Cannot search members: the application is not bound to a Base"},zh:{businessError:e=>`\u641C\u7D22\u6210\u5458\u5931\u8D25\uFF08\u9519\u8BEF\u7801 ${e}\uFF09`,httpError:e=>`\u641C\u7D22\u6210\u5458\u8BF7\u6C42\u5931\u8D25\uFF1AHTTP ${e}`,invalidResponse:"\u6210\u5458\u641C\u7D22\u54CD\u5E94\u7ED3\u6784\u65E0\u6548",noBoundBase:"\u65E0\u6CD5\u641C\u7D22\u6210\u5458\uFF1A\u5E94\u7528\u5C1A\u672A\u7ED1\u5B9A\u591A\u7EF4\u8868\u683C"},ja:{businessError:e=>`\u30E1\u30F3\u30D0\u30FC\u3092\u691C\u7D22\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u30A8\u30E9\u30FC\u30B3\u30FC\u30C9 ${e}\uFF09`,httpError:e=>`\u30E1\u30F3\u30D0\u30FC\u691C\u7D22\u306E\u30EA\u30AF\u30A8\u30B9\u30C8\u306B\u5931\u6557\u3057\u307E\u3057\u305F\uFF1AHTTP ${e}`,invalidResponse:"\u30E1\u30F3\u30D0\u30FC\u691C\u7D22\u306E\u5FDC\u7B54\u5F62\u5F0F\u304C\u6B63\u3057\u304F\u3042\u308A\u307E\u305B\u3093",noBoundBase:"\u30E1\u30F3\u30D0\u30FC\u3092\u691C\u7D22\u3067\u304D\u307E\u305B\u3093\uFF1A\u30A2\u30D7\u30EA\u306BBase\u304C\u95A2\u9023\u4ED8\u3051\u3089\u308C\u3066\u3044\u307E\u305B\u3093"}};async function ft(e,t,n){let o=t??$(),r=mt[o],a=(await K()).baseBindings[0]?.baseToken;if(!a)throw new Error(r.noBoundBase);let s=new URLSearchParams({config_source:"0",obj_type:fn,source:gn,token:a,type:bn,user_type:"0",content:e.trim().slice(0,50)}).toString(),c=await D(mn,{signal:n,body:s,headers:{"content-type":"application/x-www-form-urlencoded"},method:"POST"});if(!c.ok)throw new Error(r.httpError(c.status));let d=await c.json();return{code:0,msg:"ok",data:yn(d,o)}}function yn(e,t=$()){let n=xe(t),o=mt[t],r=wn(e,o);if(!r)throw new Error(o.invalidResponse);let i=r.entities,a=A(i)?i.users:void 0;if(!A(a)||!Array.isArray(r.result_list))throw new Error(o.invalidResponse);let s=[],c=new Set;for(let d of r.result_list){if(!A(d)||Number(d.type)!==0)continue;let u=f(d.token);if(!u)continue;let p=a[u];if(!A(p))continue;let b=f(p.user_id)||f(p.id)||u,g=vn(p,n);if(!b||!g||c.has(b))continue;c.add(b);let m=f(p.avatar_url),v=f(p.open_id);if(s.push({avatar:{avatar_72:m,avatar_240:m,avatar_640:m,avatar_origin:m},department_ids:En(p.department_ids),description:Rn(p,n),is_external:p.is_external===!0,name:g,user_id:b,...v?{open_id:v}:{}}),s.length>=hn)break}return{users:s}}function wn(e,t){if(A(e)){if(typeof e.code=="number"&&e.code!==0){let n=f(e.msg);throw Object.assign(new Error(n||t.businessError(e.code)),{code:String(e.code),cause:e})}return"entities"in e&&"result_list"in e?e:A(e.data)?e.data:void 0}}function vn(e,t){let n=e.display_name;if(typeof n=="string"&&n.trim())return n.trim();let o=t.toLowerCase().replace("-","_"),r=o.split("_")[0],i=A(n)?n:{},a=A(i.i18n_value)?i.i18n_value:i,s=r==="zh"?e.cn_name:r==="en"?e.en_name:void 0;return f(a[o])||f(a[r])||f(s)||f(i.value)||f(e.name)||f(e.en_name)||f(e.cn_name)}function Rn(e,t){let n=e.is_external===!0?e.i18n_tenant:e.i18n_department;return Cn(n,t)||f(e.department)}function Cn(e,t){if(typeof e=="string")return e.trim();if(!A(e))return"";let n=t.toLowerCase().replace("-","_"),o=n.split("_")[0]??"",r=A(e.i18n_value)?e.i18n_value:e,i=f(r[n])||f(r[o]);if("i18n_value"in e)return i||f(e.value);let a=o==="zh"?f(r.zh_cn)||f(r.en_us):f(r.en_us)||f(r.zh_cn);return i||f(e.value)||a}function f(e){return typeof e=="string"?e.trim():""}function En(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}function A(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import{Fragment as ht,jsx as C,jsxs as Te}from"react/jsx-runtime";var yt={en:{invalidResponse:"Member search response has an invalid structure",loading:"Loading...",memberList:"Member list",noMatches:"No matching members. Try another search term.",noRecommendations:"No recommended members yet",recordCreator:"Add the person who created this record",searchFailed:"Member search failed",searchFailedCode:e=>`Could not search members (error code ${e})`,searchMembers:"Search members"},zh:{invalidResponse:"\u6210\u5458\u641C\u7D22\u54CD\u5E94\u7ED3\u6784\u65E0\u6548",loading:"\u52A0\u8F7D\u4E2D...",memberList:"\u6210\u5458\u5217\u8868",noMatches:"\u6CA1\u6709\u5339\u914D\u7684\u6210\u5458\uFF0C\u8BF7\u6362\u4E2A\u5173\u952E\u8BCD",noRecommendations:"\u6682\u65E0\u63A8\u8350\u6210\u5458",recordCreator:"\u6DFB\u52A0\u6B64\u8BB0\u5F55\u7684\u4EBA\u5458",searchFailed:"\u641C\u7D22\u6210\u5458\u5931\u8D25",searchFailedCode:e=>`\u641C\u7D22\u6210\u5458\u5931\u8D25\uFF08\u9519\u8BEF\u7801 ${e}\uFF09`,searchMembers:"\u641C\u7D22\u6210\u5458"},ja:{invalidResponse:"\u30E1\u30F3\u30D0\u30FC\u691C\u7D22\u306E\u5FDC\u7B54\u5F62\u5F0F\u304C\u6B63\u3057\u304F\u3042\u308A\u307E\u305B\u3093",loading:"\u8AAD\u307F\u8FBC\u307F\u4E2D...",memberList:"\u30E1\u30F3\u30D0\u30FC\u4E00\u89A7",noMatches:"\u4E00\u81F4\u3059\u308B\u30E1\u30F3\u30D0\u30FC\u304C\u3044\u307E\u305B\u3093\u3002\u5225\u306E\u30AD\u30FC\u30EF\u30FC\u30C9\u3067\u691C\u7D22\u3057\u3066\u304F\u3060\u3055\u3044\u3002",noRecommendations:"\u304A\u3059\u3059\u3081\u306E\u30E1\u30F3\u30D0\u30FC\u304C\u3044\u307E\u305B\u3093",recordCreator:"\u3053\u306E\u30EC\u30B3\u30FC\u30C9\u306E\u4F5C\u6210\u8005\u3092\u8FFD\u52A0",searchFailed:"\u30E1\u30F3\u30D0\u30FC\u306E\u691C\u7D22\u306B\u5931\u6557\u3057\u307E\u3057\u305F",searchFailedCode:e=>`\u30E1\u30F3\u30D0\u30FC\u3092\u691C\u7D22\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u30A8\u30E9\u30FC\u30B3\u30FC\u30C9 ${e}\uFF09`,searchMembers:"\u30E1\u30F3\u30D0\u30FC\u3092\u691C\u7D22"}};function de(e){let[t,n]=q(!1),[o,r]=q(!1);ue(()=>r(!0),[]);let i=x(),a=yt[i],[s]=q(()=>new Un({defaultOptions:{queries:{retry:!1,staleTime:3e4,gcTime:3e4}}}));ue(()=>{let l=lt(()=>{n(!0),s.clear()});return()=>{l(),s.clear()}},[s]);let c=Object.prototype.hasOwnProperty.call(e,"value"),d=gt(c);ue(()=>{c!==d.current&&console.warn("UserSelectorPanel controlled mode changed")},[c]);let[u,p]=q(e.defaultValue),b=c?e.value:u,g=Array.isArray(b)?b:b?[b]:[],[m,v]=q(""),[h,O]=q(""),[k,J]=q(!1),F=gt(!1);ue(()=>{if(k)return;let l=setTimeout(()=>O(m.trim()),m.trim()?400:0);return()=>clearTimeout(l)},[m,k]);let y=Sn({queryKey:["members",i,h],queryFn:async({signal:l})=>{let R=await ft(h,i,l);return xn(R,i)},enabled:!t&&o&&!k&&m.trim()===h},s),w=e.loading||y.isFetching||m.trim()!==h,I=!t&&!w&&!y.error&&y.data?[...y.data.users,...g.filter(l=>!y.data.users.some(R=>R.user_id===l.user_id))]:[],U=(l,R)=>{v(l),e.onSearch?.(l,{action:R})},pe=()=>{U("","AutoClear"),e.onClose?.()},Ct=l=>{if(F.current)return;let R=g.some(me=>me.user_id===l.user_id),ne=e.mode==="multiple"?R?g.filter(me=>me.user_id!==l.user_id):[...g,l]:R?void 0:l;c||p(ne),e.onChange?.(ne,{option:l,action:R?"Remove":"Select"}),R||e.onSelect?.(l,{option:l}),e.mode==="multiple"?U("","AutoClear"):pe()},Me=e.slots?.empty,Le=e.slots?.loading,Oe=e.slots?.option,Fe=e.slots?.footer;return Te(te,{shouldFilter:!1,loop:!0,className:`base-app-platform base-app-selector ${e.className??""}`,label:a.memberList,children:[C(te.Input,{autoFocus:!0,placeholder:a.searchMembers,"aria-label":a.searchMembers,value:m,onValueChange:l=>U(l,"Input"),onCompositionStart:()=>{F.current=!0,J(!0)},onCompositionEnd:()=>{F.current=!1,J(!1)},onKeyDown:l=>{if(e.onKeyDown?.(l),l.defaultPrevented){l.stopPropagation();return}if(F.current||Pn(l)){l.stopPropagation();return}l.key==="Escape"&&(l.preventDefault(),pe())}}),C(te.List,{"aria-label":a.memberList,"aria-multiselectable":e.mode==="multiple"||void 0,children:w?C("div",{role:"status",children:Le?C(Le,{}):a.loading}):y.error?C("div",{role:"alert",children:a.searchFailed}):Te(ht,{children:[e.onSelectRecordCreator?C(te.Item,{value:"record-creator",onSelect:()=>{e.onSelectRecordCreator?.(),pe()},children:a.recordCreator}):null,I.map(l=>{let R=g.some(ne=>ne.user_id===l.user_id);return C(te.Item,{value:l.user_id,onSelect:()=>Ct(l),"data-checked":R,children:Oe?C(Oe,{user:l,selected:R}):Te(ht,{children:[C("span",{children:l.name}),C("small",{children:e.getUserDescription?.(l)??l.description}),R?C("span",{"aria-label":"selected",children:"\u2713"}):null]})},l.user_id)}),!I.length&&!e.onSelectRecordCreator?C("div",{role:"status",children:Me?C(Me,{}):m.trim()?a.noMatches:a.noRecommendations}):null]})}),Fe?C(Fe,{}):null]})}function xn(e,t){let n=yt[t];if(!bt(e)||typeof e.code!="number")throw new Error(n.invalidResponse);if(e.code!==0){let o=typeof e.msg=="string"?e.msg.trim():"";throw Object.assign(new Error(o||n.searchFailedCode(e.code)),{code:String(e.code),cause:e})}if(!bt(e.data)||!Array.isArray(e.data.users))throw new Error(n.invalidResponse);return{users:e.data.users}}function bt(e){return typeof e=="object"&&e!==null}function Pn(e){return e.nativeEvent?.isComposing===!0||e.keyCode===229}import{useState as An,useRef as kn}from"react";import*as L from"@radix-ui/react-popover";import{jsx as T,jsxs as wt}from"react/jsx-runtime";var In={en:{clearSelected:"Clear selected members",removeMember:e=>`Remove member ${e}`,selectMembers:"Select members"},zh:{clearSelected:"\u6E05\u9664\u5DF2\u9009\u6210\u5458",removeMember:e=>`\u79FB\u9664\u6210\u5458 ${e}`,selectMembers:"\u9009\u62E9\u6210\u5458"},ja:{clearSelected:"\u9078\u629E\u3057\u305F\u30E1\u30F3\u30D0\u30FC\u3092\u30AF\u30EA\u30A2",removeMember:e=>`\u30E1\u30F3\u30D0\u30FC ${e} \u3092\u524A\u9664`,selectMembers:"\u30E1\u30F3\u30D0\u30FC\u3092\u9078\u629E"}};function vt(e){let t=kn(null),n=se(),o=In[x()],[r,i]=An(!1),a=Array.isArray(e.value)?e.value:e.value?[e.value]:[],s=u=>{i(u),u!==r&&e.onDropdownVisibleChange?.(u)},c=e.slots?.trigger,d=e.slots?.chip;return wt(L.Root,{open:r,onOpenChange:s,children:[wt("div",{ref:t,className:`base-app-platform base-app-editor ${e.className??""}`,onClickCapture:u=>{u.target.closest("[data-base-app-trigger]")&&e.onClick?.(u)},children:[T(L.Trigger,{asChild:!0,children:T("button",{type:"button","data-base-app-trigger":"","aria-label":o.selectMembers,onFocus:e.onFocus,onBlur:e.onBlur,children:c?T(c,{value:e.value}):a.length?a.map(u=>T("span",{children:d?T(d,{user:u}):u.name},u.user_id)):o.selectMembers})}),a.map(u=>T("button",{type:"button","aria-label":e.mode==="multiple"?o.removeMember(u.name):o.clearSelected,onClick:p=>{p.stopPropagation(),e.onChange?.(e.mode==="multiple"?a.filter(b=>b.user_id!==u.user_id):void 0),e.mode==="multiple"?e.onRemove?.(u):e.onClear?.()},children:"\xD7"},u.user_id))]}),T(L.Portal,{container:e.portalContainer??t.current?.closest("dialog")??void 0,children:T(L.Content,{"data-theme":n?.theme,className:"base-app-platform base-app-popover",sideOffset:4,collisionPadding:8,children:T(de,{...e,slots:void 0,onChange:(u,p)=>{e.onChange?.(u),p.action==="Remove"&&p.option&&e.onRemove?.(p.option)},onClose:()=>s(!1)})})})]})}import{useEffect as Rt,useRef as _n,useState as De}from"react";import{jsx as V,jsxs as Dn}from"react/jsx-runtime";var Tn={en:{decodeFailed:"Image could not be decoded",loadFailed:"Failed to load image",loading:"Loading image",retry:"Retry image"},zh:{decodeFailed:"\u56FE\u7247\u65E0\u6CD5\u89E3\u7801",loadFailed:"\u56FE\u7247\u52A0\u8F7D\u5931\u8D25",loading:"\u56FE\u7247\u52A0\u8F7D\u4E2D",retry:"\u91CD\u8BD5\u56FE\u7247"},ja:{decodeFailed:"\u753B\u50CF\u3092\u8868\u793A\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F",loadFailed:"\u753B\u50CF\u3092\u8AAD\u307F\u8FBC\u3081\u307E\u305B\u3093\u3067\u3057\u305F",loading:"\u753B\u50CF\u3092\u8AAD\u307F\u8FBC\u307F\u4E2D",retry:"\u753B\u50CF\u3092\u518D\u8AAD\u307F\u8FBC\u307F"}};function vr({attachment:e,size:t=360,alt:n,className:o,slots:r={}}){let i=x(),a=Tn[i],s=_n(null),[c,d]=De(!1),[u,p]=De(0),[b,g]=De({key:"",url:"",error:""}),{tableId:m,fieldId:v,recordId:h,fileToken:O}=e,k=JSON.stringify([m,v,h,O,t,u]);Rt(()=>{if(typeof IntersectionObserver>"u"){d(!0);return}let w=new IntersectionObserver(I=>{I.some(U=>U.isIntersecting)&&(d(!0),w.disconnect())},{rootMargin:"200px"});return s.current&&w.observe(s.current),()=>w.disconnect()},[]),Rt(()=>{if(!c)return;let w=new AbortController,I="";return Qe({tableId:m,fieldId:v,recordId:h,fileToken:O},t,{signal:w.signal}).then(U=>{w.signal.aborted||(I=URL.createObjectURL(U),g({key:k,url:I,error:""}))}).catch(U=>{w.signal.aborted||g({key:k,url:"",error:U instanceof Error?U.message:"",localError:U instanceof Error?void 0:"loadFailed"})}),()=>{w.abort(),I&&URL.revokeObjectURL(I)}},[c,k,m,v,h,O,t]);let J=r.loading,F=r.error,y=b.key===k?b:void 0;return V("span",{ref:s,className:`base-app-platform base-app-attachment ${o??""}`,"aria-busy":!y,children:y?.url?V("img",{src:y.url,alt:n,onError:()=>g({key:k,url:"",error:"",localError:"decodeFailed"})}):y?.error||y?.localError?F?V(F,{code:"ATTACHMENT_LOAD_FAILED",retry:()=>p(w=>w+1)}):Dn("span",{children:[V("span",{role:"status",children:y.localError?a[y.localError]:y.error}),V("button",{type:"button",onClick:()=>p(w=>w+1),children:a.retry})]}):V("span",{role:"status",children:J?V(J,{}):a.loading})})}export{On as a,oe as b,Fn as c,Nn as d,Bn as e,jn as f,$n as g,qe as h,be as i,ge as j,Xn as k,E as l,re as m,Zn as n,X as o,he as p,kt as q,eo as r,ae as s,It as t,D as u,fe as v,Et as w,Ut as x,qn as y,St as z,je as A,we as B,j as C,Qe as D,Ft as E,We as F,Xe as G,ye as H,ro as I,ao as J,io as K,so as L,Se as M,Wt as N,$ as O,xe as P,Zt as Q,x as R,ho as S,yo as T,se as U,ke as V,Mo as W,Ko as X,de as Y,vt as Z,vr as _};
@@ -1,25 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getAttempt = getAttempt;
4
- exports.cancellationSignal = cancellationSignal;
5
- exports.__installCapabilityTransport = __installCapabilityTransport;
6
- exports.invokeFunction = invokeFunction;
7
- const activity_1 = require("@temporalio/activity");
8
- function getAttempt() { return (0, activity_1.activityInfo)().attempt; }
9
- function cancellationSignal() { return activity_1.Context.current().cancellationSignal; }
10
- let capabilityTransport;
11
- // 只由通用 Worker 启动器装配;公开 SDK 类型不暴露凭证或配置入口。
12
- /** @internal */
13
- function __installCapabilityTransport(transport) {
14
- if (capabilityTransport)
15
- throw new Error('Site capability transport is already configured');
16
- capabilityTransport = transport;
17
- }
18
- /** input 与普通 Site Function 的请求体一致,例如 { params: { city: '北京' } }。 */
19
- async function invokeFunction(functionId, input, options) {
20
- if (!functionId || !options?.key || options.key.length > 256)
21
- throw new Error('Function and a stable call key are required');
22
- if (!capabilityTransport)
23
- throw new Error('Site capability transport is unavailable');
24
- return capabilityTransport((0, activity_1.activityInfo)().taskToken, { function_id: functionId, call_key: options.key, payload: input }, cancellationSignal());
25
- }