@lark-base-open/base-database-app-sdk 0.5.0 → 0.5.2
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.
- package/CHANGELOG.md +23 -71
- package/README.md +5 -35
- package/capabilities.json +7 -1
- package/dist/chunk-EG6R7YAD.js +1 -0
- package/dist/components.d.ts +1 -1
- package/dist/components.js +1 -1
- package/dist/{index-99514181.d.ts → index-f0f8b30f.d.ts} +2 -1
- package/dist/page.d.ts +13 -4
- package/dist/page.js +1 -1
- package/dist/server.cjs +1 -1
- package/dist/server.js +1 -1
- package/dist/testing.d.ts +1 -2
- package/dist/theme.css +18 -8
- package/docs/README.md +1 -1
- package/docs/capabilities.md +3 -3
- package/docs/codegen.md +3 -3
- package/docs/compat.md +2 -2
- package/docs/components.md +6 -2
- package/docs/exports.md +3 -3
- package/docs/page.md +4 -4
- package/docs/server.md +4 -4
- package/docs/shared.md +1 -1
- package/docs/start-base-app.md +26 -11
- package/docs/testing.md +4 -24
- package/docs/upgrade.md +73 -0
- package/examples/upgrade.ts +1 -1
- package/package.json +2 -26
- package/dist/chunk-OF7TEKK6.js +0 -1
package/docs/capabilities.md
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
| 能力 | 分类 | 缺字段时 host-baseline(版本 1) |
|
|
6
6
|
|---|---|---|
|
|
7
7
|
| runtime.context | 关键 | 是 |
|
|
8
|
-
| runtime.diagnostic | 可选;SDK 无对应 API
|
|
8
|
+
| runtime.diagnostic | 可选;SDK 无对应 API | 否,须由宿主显式声明 |
|
|
9
9
|
| http.request | 关键 | 是 |
|
|
10
10
|
| http.binary | 关键 | 是 |
|
|
11
11
|
| http.cancel | 可选 | 是 |
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
| attachment.progress | 可选 | 是 |
|
|
23
23
|
| link.open | 可选 | 是 |
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
缺少 capabilities 字段时,基线以包内 capabilities.json 的能力清单为准。服务端 ctx.records 不属于页面能力协商;未知能力不在基线。[`queryCapability`](exports.md#page) 的 source 此时为 `host-baseline`;显式能力表为 `advertised`。
|
|
26
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) 仍可用于界面判断,宿主是最终授权方。
|
|
27
27
|
|
|
28
28
|
<!-- example: capabilities.ts -->
|
|
@@ -40,4 +40,4 @@ export async function inspectHost() {
|
|
|
40
40
|
分类只用稳定错误码,不解析含业务内容的 message。LINK_CHECK_UNAVAILABLE 表示服务不可用,分类为 unknown,不能据此断言地域政策。宿主可用 companion 字段 capabilityUnavailable 明确 permission-denied/region-unavailable/temporarily-unavailable;[`requireCapability`](exports.md#page) 会根据该原因拒绝。unknown 不猜测也不自动重试;retryable 提示不保证非幂等写入重试安全。
|
|
41
41
|
输出含 source/code/upstreamCode/category/retryable/message/redaction;不附原始异常、请求参数、URL、身份、token。应用、环境、制品版本与 requestId/logid 由持有可信上下文的诊断汇总端补齐,本模块不伪造关联信息。
|
|
42
42
|
|
|
43
|
-
结构化清单位于包内 capabilities.json
|
|
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 的批量调用分别收紧了公开类型契约;升级后重新生成契约并按 [
|
|
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
|
-
|
|
30
|
+
生成完成后运行 `base-database-cli check --json` 检查契约与生成文件是否一致。
|
package/docs/compat.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# 老模板兼容
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
page 保留 classic 模板 `page/src/lib/database-runtime.ts` 的 36 个值/类型导出。
|
|
4
4
|
|
|
5
|
-
|
|
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
|
|
package/docs/components.md
CHANGED
|
@@ -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
|
-
|
|
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
|
|
@@ -33,3 +33,7 @@ export function Details({ attachment }: { attachment: DatabaseAttachmentRef }) {
|
|
|
33
33
|
</BaseAppProvider>;
|
|
34
34
|
}
|
|
35
35
|
```
|
|
36
|
+
|
|
37
|
+
## 业务样式隔离
|
|
38
|
+
|
|
39
|
+
`BaseAppProvider` 支持 `styleScope: 'legacy' | 'components'`。默认 legacy 保持既有基础样式;components 仅给 SDK 组件施加样式。外层 `.base-app-platform` 类名、`data-theme` 和主题变量不变,已有业务 token 映射继续有效。独立 Provider 的 host 主题按浏览器媒体查询解析,startBaseApp 的 host 按宿主 RuntimeContext 解析。
|
package/docs/exports.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# 公开导出清单
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
此清单列出各公开入口的值与类型。server/shared/codegen 另提供 CJS;CSS 入口为 /page/styles.css。没有根入口或源码通配入口。
|
|
4
4
|
|
|
5
5
|
## page
|
|
6
6
|
|
|
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`。
|
|
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`、`installRouteSync`、`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`、`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`。
|
|
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`、`RouteSyncDiagnostic`、`RouteSyncOptions`、`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`、`SiteRouteChangedEvent`、`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`、`installRouteSync`、`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
|
|
package/docs/page.md
CHANGED
|
@@ -79,7 +79,7 @@ export async function loadWithFetch() {
|
|
|
79
79
|
}
|
|
80
80
|
```
|
|
81
81
|
|
|
82
|
-
业务 HTTP 经宿主代理,只接受单个 `/`
|
|
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) 必须经过宿主
|
|
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
|
|
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
|
-
|
|
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)
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
package/docs/start-base-app.md
CHANGED
|
@@ -2,15 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
从 `/page` 导入 [`startBaseApp`](exports.md#page),传入 `app: App`(React ComponentType),通过 `/page/styles.css` 加载组件样式。SDK 不认识业务 App 的路径,也不会在 Node 侧执行业务代码。返回 `{ ready, dispose }`;ready 是首次 React effect 提交后的宿主通知 Promise。调用者应处理 ready 拒绝,并在热替换或移除页面时 dispose。
|
|
4
4
|
|
|
5
|
-
选项与默认值:root 为 `#root`(可传选择器或 HTMLElement);strictMode、linkGuard、reportLifecycle、platformUI 均为 true。theme 为 host,取宿主 colorScheme;locale 为 host,取宿主语言,不支持的语言映射 en。locale 可显式设 zh/en/ja,theme 可设 light/dark。providers 接收 ReactNode 并返回包裹后的 ReactNode;slots.loading 与 slots.error 接受 React 组件,error 只收到安全 code。onDiagnostic 接收 SDK 的脱敏 [`RuntimeDiagnostic`](exports.md#page)。
|
|
5
|
+
选项与默认值:root 为 `#root`(可传选择器或 HTMLElement);strictMode、linkGuard、routeSync、reportLifecycle、platformUI 均为 true。theme 为 host,取宿主 colorScheme;locale 为 host,取宿主语言,不支持的语言映射 en。locale 可显式设 zh/en/ja,theme 可设 light/dark。providers 接收 ReactNode 并返回包裹后的 ReactNode;slots.loading 与 slots.error 接受 React 组件,error 只收到安全 code。onDiagnostic 接收 SDK 的脱敏 [`RuntimeDiagnostic`](exports.md#page)。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
`styleScope` 默认 `legacy`,保留业务内容从 `.base-app-platform` 继承的基础样式。
|
|
8
|
+
新工程使用 `styleScope: 'components'`:外层仍保留 `.base-app-platform`、`data-theme` 和所有 `--base-app-*` 变量,
|
|
9
|
+
但不再给业务内容设置文字、字体、按钮、输入焦点和告警样式;业务根容器必须成对声明背景和文字颜色。
|
|
10
|
+
SDK 组件自身仍按 Provider 主题渲染。`theme` 默认仍是 `host`,固定浅色显式写 `theme: 'light'`。
|
|
11
|
+
业务要跟随主题时,在业务根容器映射 `--base-app-color-bg/fg/muted/border`,不要只切换背景或只切换文字。
|
|
12
|
+
|
|
13
|
+
顺序:解析 root、发起 channel 上下文请求、能力感知链接拦截与路由同步、Provider/错误边界/App、首次 effect 后 ready。StrictMode 不重复上报。启动错误报 APP_BOOT_FAILED;ready 之后的业务错误只交 onDiagnostic。root 缺失使 ready 拒绝,重复挂载同一 root 同步抛 APP_ALREADY_STARTED。dispose 幂等,卸载 React、退订 mode、清理链接拦截、路由监听和 UI 缓存;ready 前 dispose 使 ready 拒绝 APP_DISPOSED。共享 channel 连接不销毁,以免影响同页面其他调用者。
|
|
8
14
|
|
|
9
15
|
linkGuard:false 完全不安装拦截;能力不支持时 SDK 同样保持原生行为。reportLifecycle:false 不发 ready/load-failed,但 ready Promise 仍表达本地挂载结果。platformUI:false 隐藏默认悬浮按钮,不改变权限或宿主开发标识。关闭选项用于迁移中明确选择行为。
|
|
10
16
|
|
|
11
17
|
开发与生产统一由 main.tsx 直接导入 base-app.config.ts 并调用 startBaseApp(options),不使用虚拟入口。CLI 自动安装 `/vite` 的配对服务端中间件;HMR 不重配对,整页或 iframe 重载才配对。
|
|
12
18
|
|
|
13
|
-
|
|
19
|
+
运行示例位于包内 examples。
|
|
14
20
|
|
|
15
21
|
<!-- example: start-base-app.tsx -->
|
|
16
22
|
```tsx
|
|
@@ -30,22 +36,31 @@ import { baseAppDevelopmentPairingPlugin } from '@lark-base-open/base-database-a
|
|
|
30
36
|
export const plugins = [baseAppDevelopmentPairingPlugin()];
|
|
31
37
|
```
|
|
32
38
|
|
|
33
|
-
##
|
|
39
|
+
## 本地开发配对
|
|
34
40
|
|
|
35
41
|
使用 CLI 输出的 `/baseapp/dev/<siteToken>/<port>#t=<令牌>` 打开;宿主读取后立刻移除片段并按站点、端口存当前标签 sessionStorage。复制地址栏链接给别人会自动打开线上版本。无令牌或非编辑者直接降级,有令牌但未连接/配对失败保持错误页。普通线上页面不启用此协议。
|
|
36
42
|
|
|
37
43
|
访问本机服务前,浏览器可能要求当前宿主的原生“本地网络访问”授权;需在浏览器提示或站点权限设置中允许。它是浏览器安全前置,不是应用内确认页,也不由 SDK 自动授予;配对成功后应用直接进入。
|
|
38
44
|
|
|
39
|
-
|
|
45
|
+
使用 CLI 启动本地开发服务时会自动配置配对令牌。手工配置 Vite 时,将 `baseAppDevelopmentPairingPlugin()` 放在插件列表最前,并通过 `BASE_APP_DEV_PAIRING_TOKEN` 设置令牌;不要把令牌写入客户端代码或日志。HMR 不需要重新配对,整页或 iframe 重载会重新配对;旧 SDK 不支持配对时需要升级。
|
|
40
46
|
|
|
41
|
-
|
|
47
|
+
平台 UI 使用 @tanstack/react-query,BaseAppProvider 管理缓存生命周期和应用/环境/身份隔离;它是组件的必需 peer。React/ReactDOM peer 接受 ^19.2.0,业务可按锁文件使用兼容补丁版本。server/shared 没有 React 运行时导入。
|
|
42
48
|
|
|
43
|
-
|
|
49
|
+
## 生命周期版本上报(0.5.0)
|
|
44
50
|
|
|
45
|
-
|
|
51
|
+
应用启动成功或失败时会自动报告 SDK 版本,便于排查问题,无需新增配置。
|
|
46
52
|
|
|
47
|
-
平台 UI 使用 @tanstack/react-query,BaseAppProvider 管理缓存生命周期和应用/环境/身份隔离;它是组件的必需 peer。React/ReactDOM peer 接受 ^19.2.0,业务可按锁文件使用兼容补丁版本。server/shared 没有 React 运行时导入。
|
|
48
53
|
|
|
49
|
-
##
|
|
54
|
+
## 页面地址与路由同步
|
|
55
|
+
|
|
56
|
+
站点使用 hash 路由(例如 react-router 的 `createHashRouter` 或 `HashRouter`)。宿主将外层 `/baseapp/<app-token>/orders/123?status=open` 映射为产物 URL 的 `#/orders/123?status=open`;iframe 内重载仍只请求产物根路径。路由与查询参数会进入地址栏、分享链接和网关日志,不放置令牌、密钥或不宜分享的数据。
|
|
57
|
+
|
|
58
|
+
`startBaseApp` 默认安装 `installRouteSync`,`routeSync:false` 关闭。它包装 history.pushState/replaceState 并监听 popstate/hashchange,微任务合并重复变化;仅宿主显式声明 `runtime.route` 能力时回报。能力表缺失或为空时不发送路由事件。首报读取安装后的当前 hash,覆盖先于安装完成的初始重定向。dispose 还原监听和仍属于本安装的 history 包装。
|
|
59
|
+
|
|
60
|
+
`installRouteSync` 也从 `/page` 独立导出,供保留自有 bootstrap 的页面安装一次并在卸载时清理;通过 startBaseApp 启动时不再重复安装。`onDiagnostic` 接收固定英文 `PATH_ROUTING_UNSUPPORTED` 诊断,提示将 BrowserRouter 改为 hash router;诊断不包含原始地址或查询参数。
|
|
61
|
+
|
|
62
|
+
同标签 hash 导航保持原生行为。配套 linkGuard 将 `#/...` 链接的中键、修饰键、新标签页和 window.open 请求交给 OpenLink,宿主负责转换为对应的外层地址;普通 `#section` 锚点不参与路由。
|
|
63
|
+
|
|
64
|
+
路由同步与 linkGuard 独立:`routeSync:false` 只关闭路由回报。支持 OpenLink 但没有深链接转换能力的旧宿主可能仍打开 CDN 产物地址,不会自动变成可分享的站点链接。需要保留原生链接处理时另设 `linkGuard:false`;这也会关闭其他链接拦截,并不补齐旧宿主的深链接能力。
|
|
50
65
|
|
|
51
|
-
|
|
66
|
+
原生右键菜单的“在新标签页中打开”和“复制链接地址”直接使用元素的 `href`,不会经过点击拦截。需要这些操作得到站点子页面链接时,应让 `href` 指向可分享的宿主地址。
|
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
|
|
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
|
|
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 结果读取及错误分支。命令通过只证明本地迁移完成,远端行为另按工程验收流程确认。
|
package/examples/upgrade.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
//
|
|
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.
|
|
3
|
+
"version": "0.5.2",
|
|
4
4
|
"description": "Base Database 页面与服务端 SDK、平台组件及测试工具",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": [
|
|
@@ -66,18 +66,8 @@
|
|
|
66
66
|
"capabilities.json",
|
|
67
67
|
"development-pairing.json"
|
|
68
68
|
],
|
|
69
|
-
"scripts": {
|
|
70
|
-
"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",
|
|
71
|
-
"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",
|
|
72
|
-
"check:migrations": "node scripts/check-migrations.mjs",
|
|
73
|
-
"prepublishOnly": "npm run check:migrations",
|
|
74
|
-
"test:types": "tsc -p tsconfig.examples.json && tsc -p tsconfig.server.json && tsc -p tsconfig.cjs.json",
|
|
75
|
-
"test:browser": "node test/browser/verify.mjs && node test/browser/ui-verify.mjs",
|
|
76
|
-
"test:components": "vitest run",
|
|
77
|
-
"docs:exports": "node scripts/doc-exports.mjs"
|
|
78
|
-
},
|
|
79
69
|
"dependencies": {
|
|
80
|
-
"@lark-base-open/base-site-channel": "0.2.
|
|
70
|
+
"@lark-base-open/base-site-channel": "0.2.1",
|
|
81
71
|
"@radix-ui/react-popover": "1.2.0",
|
|
82
72
|
"@standard-schema/spec": "1.0.0",
|
|
83
73
|
"cmdk": "1.1.1",
|
|
@@ -94,20 +84,6 @@
|
|
|
94
84
|
"optional": true
|
|
95
85
|
}
|
|
96
86
|
},
|
|
97
|
-
"devDependencies": {
|
|
98
|
-
"@testing-library/react": "16.3.0",
|
|
99
|
-
"@types/node": "22.15.0",
|
|
100
|
-
"@types/react": "19.2.17",
|
|
101
|
-
"@types/react-dom": "19.2.3",
|
|
102
|
-
"jsdom": "26.1.0",
|
|
103
|
-
"msw": "2.11.6",
|
|
104
|
-
"pngjs": "7.0.0",
|
|
105
|
-
"tsup": "6.7.0",
|
|
106
|
-
"tsx": "4.20.3",
|
|
107
|
-
"typescript": "5.8.3",
|
|
108
|
-
"vitest": "3.2.4",
|
|
109
|
-
"zod": "4.2.1"
|
|
110
|
-
},
|
|
111
87
|
"typesVersions": {
|
|
112
88
|
"*": {
|
|
113
89
|
"server": [
|
package/dist/chunk-OF7TEKK6.js
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{a as He,b as re,c as ze}from"./chunk-ZKBZAK4L.js";import{a as oe}from"./chunk-3JX3FIBG.js";import{a as $}from"./chunk-OHPYKFCM.js";import{createContext as sn,useContext as ct}from"react";import{createContext as Zt,useContext as Xt,useEffect as en,useSyncExternalStore as tn}from"react";import{capabilityNames as Tt}from"@lark-base-open/base-site-channel/capabilities";import*as I from"@lark-base-open/base-site-channel/runtime";import{SITE_RUNTIME_PROTOCOL_VERSION as qn,SiteRuntimeApi as le,SiteRuntimeEvent as Yn,SiteRuntimeFunction as Gn,SiteRuntimeErrorCode as Kn,readSiteAITextDelta as Jn,isValidSiteFunctionName as Qn}from"@lark-base-open/base-site-channel/runtime-contract";var J=()=>{throw new oe(re.ContextInvalid,"\u5BBF\u4E3B\u80FD\u529B\u5B57\u6BB5\u65E0\u6548")};function ve(e){if(!e||typeof e!="object")return J();if(e.capabilities===void 0)return Object.fromEntries(Object.entries(He).filter(([,o])=>o.baseline).map(([o])=>[o,{version:1}]));let t=e.capabilities;if(!t||typeof t!="object"||Array.isArray(t))return J();let n=Object.entries(t);return n.some(([,o])=>!o||typeof o!="object"||Array.isArray(o)||!Number.isSafeInteger(o.version)||o.version<=0)?J():Object.fromEntries(n.map(([o,r])=>[o,{version:r.version}]))}function It(e,t,n=1){if(!Number.isSafeInteger(n)||n<1)return J();let o=ve(e);return Object.prototype.hasOwnProperty.call(o,t)&&o[t].version>=n}async function kt(e=P){return ve(await e.getRuntimeContext())}var Xn=kt;async function Lt(e,t=1,n=P){let o=await n.getRuntimeContext(),r=ve(o),i=It(o,e,t),a=o.capabilityUnavailable;if(a!==void 0&&(!a||typeof a!="object"||Array.isArray(a)))return J();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")?J():{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 Ve(e,t=1,n=P){let o=await n.getRuntimeContext(),r=await Lt(e,t,{getRuntimeContext:async()=>o});if(!r.supported)throw new ze(e,t);let i={"permission-denied":re.PermissionDenied,"region-unavailable":re.RegionUnavailable,"temporarily-unavailable":re.TemporarilyUnavailable};if(r.availability in i)throw new oe(i[r.availability],"\u5BBF\u4E3B\u660E\u786E\u62D2\u7EDD\u6B64\u80FD\u529B",void 0,o.capabilityUnavailable?.[e]?.retryable)}function qe(e,t){let n,o=!1,r,i=new Promise(a=>{r=a});return e.registerApi($.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($.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($.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 Ye=typeof window<"u"&&window.location.protocol==="http:"&&window.location.hostname===$.host&&Number(window.location.port)>=$.portMin&&Number(window.location.port)<=$.portMax;var Ge=I.siteRuntime,M=Ge.getChannel?.()??Ge.channel,_t=Ye&&typeof window<"u"&&window.parent!==window?qe(M,globalThis.fetch.bind(globalThis)):void 0;function Ke(e,t=async()=>{}){let n=new Map,o=async(r,i)=>{await t();for(let a of Tt(r,i))try{await Ve(a,1,{getRuntimeContext:()=>e.invokeApi(le.RuntimeContext,void 0)})}catch(s){throw s instanceof Error&&"code"in s?Object.assign(new I.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===le.HttpRequestCancel||r===le.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 Mt={invokeApi:M.invokeApi.bind(M),emitEvent:M.emitEvent.bind(M),subscribeEvent:M.subscribeEvent.bind(M)},Re=Ke(Mt,async()=>{if(typeof window<"u"&&window.parent===window)throw new I.SiteRuntimeInvocationError("CHANNEL_UNAVAILABLE","\u9875\u9762\u672A\u8FDE\u63A5\u5BBF\u4E3B channel");await _t?.wait()});M.invokeApi=Re.invokeApi;M.emitEvent=Re.emitEvent;var Ce=class extends I.SiteRuntimeClient{constructor(t){super(t?Ke(t):Re)}},so=e=>new Ce(e),P=I.siteRuntime,{invokeHttp:ue,invokeApi:co,getCurrentUser:ae,logout:Ee,requestEdit:Dt,uploadAttachment:lo,openLink:de}=P,Ft=(e=P,t)=>I.createSiteRuntimeFetch(e,t),N=Ft();var Ot=ue,Nt=/^\/?(preview\/)?app\/([^/]+)(\/|$)/,Je=/^[A-Za-z0-9_-]+$/,We="/space/api/bitable/site/v1",Bt="/space/api/box/file/temporary_download_url",Q="preview",ie=null;function jt(){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 Ue(){let e=typeof globalThis.location>"u"?"":globalThis.location.pathname,t=Nt.exec(e),n=jt();return t?{env:t[1]?Q:"prod",gatewayOrigin:n,token:decodeURIComponent(t[2]??"")}:{env:"prod",gatewayOrigin:n,token:""}}function H(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function $t(e){return e===Q||e==="prod"}function Ht(e){if(!H(e))return{};let t=typeof e.siteToken=="string"?e.siteToken.trim():"";return{...t?{token:t}:{},...$t(e.env)?{env:e.env}:{}}}async function z(){return ie||(ie=(async()=>{let e=Ue(),t={},n;try{n=await P.getRuntimeContext(),t=Ht(n)}catch(r){console.warn("Could not read the host Runtime context; inferring it from the artifact path",r)}pe=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 ie=null,pe={...Pe},e}),ie)}function Se(e){return!!(e.tableId.trim()&&e.fieldId.trim()&&e.recordId.trim()&&e.fileToken.trim())}function Ze(e,t){return JSON.stringify({bitablePerm:{tableId:t.tableId,attachments:{[t.fieldId]:{[t.recordId]:[t.fileToken]}},siteToken:e.token,siteEnv:e.env}})}function Xe(e,t){if(t instanceof Error)return t;let n=H(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 et(e,t=360,n={}){if(n.signal?.throwIfAborted(),!Se(e)||!Number.isFinite(t)||t<=0)throw new Error("Attachment location or image size is invalid");let o=await z();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:Ze(o,e),width:String(r),height:String(r),policy:"allow_up",fallback_source:"1"}),a=await Ot({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 Xe("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 zt(e,t){if(!e.token)throw new Error("Cannot get an attachment download URL without an app token");if(!Se(t))throw new Error("Cannot get an attachment download URL: the attachment location is incomplete");let n=await N(Bt,{body:JSON.stringify({extra:Ze(e,t),file_token:t.fileToken}),headers:{"content-type":"application/json"},method:"POST"}).catch(s=>{throw Xe("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=H(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=H(r)&&H(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 tt(e){let t=new URLSearchParams;e.env===Q&&t.set("env",Q);let n=t.toString(),o=`${We}/${encodeURIComponent(e.token)}/invoke_get`;return n?`${o}?${n}`:o}function nt(e,t){if(!Je.test(t))throw new TypeError(`functionId ${t} does not match the required pattern ${String(Je)}`);let n=`${We}/${encodeURIComponent(e.token)}/functions/${encodeURIComponent(t)}/invoke`;return e.env===Q?`${n}?env=${encodeURIComponent(Q)}`:n}var Vt="x-base-site-session-id",qt="x-base-site-read-your-writes",Yt=800008918,Qe=new Map,Pe={maxRetries:3,intervalMs:300},pe={...Pe},Gt=10,Kt=100,Jt=2e3;function Qt(e){let t=H(e)?e.readYourWritesRetry:void 0;return H(t)&&Number.isInteger(t.maxRetries)&&t.maxRetries>=0&&t.maxRetries<=Gt&&Number.isInteger(t.intervalMs)&&t.intervalMs>=Kt&&t.intervalMs<=Jt?{maxRetries:t.maxRetries,intervalMs:t.intervalMs}:{...Pe}}function Wt(e){let t=Qe.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 Qe.set(e,o),o}function ot(e){let t=Wt(e);return{"content-type":"application/json",...t?{[Vt]:t}:{}}}var xe=class extends oe{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 fo(e,t,n){let o=await z();if(!o.token)throw new Error(`Cannot invoke Function ${e} without an app token`);let r=n?.readYourWrites!==!1,i={...ot(o.token),...r?{[qt]:"1"}:{}},a=()=>ue({url:nt(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===Yt){if(s<pe.maxRetries){await new Promise(u=>setTimeout(u,pe.intervalMs));continue}throw new xe({logId:d.data?.log_id})}return d}}async function go(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 z();if(!n.token)throw new Error("\u5E94\u7528 token \u672A\u786E\u5B9A\uFF0C\u65E0\u6CD5\u8C03\u7528 Mutation");let o=await ue({url:nt(n,e),init:{body:JSON.stringify({batch:t.map(r=>({params:r}))}),headers:ot(n.token),method:"POST"}});if(!o.ok)throw new Error(`Mutation \u8C03\u7528\u5931\u8D25\uFF1AHTTP ${o.status}`);return await o.json()}async function ho(e,t){let n=await zt(e,t);if(!(await de(n)).opened)throw new Error("The host did not open the attachment download link")}function bo(e,t,n=360){if(!e.gatewayOrigin||!e.token||!Se(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 Le=Zt(void 0),at=[{id:"en",locale:"en-US",match:/^en(?:-|$)/},{id:"zh",locale:"zh-CN",match:/^zh(?:-|$)/},{id:"ja",locale:"ja-JP",match:/^ja(?:-|$)/}],Ie=new Set,it,Ae=null;function ke(e){if(typeof e!="string")return;let t=e.trim().replace(/_/g,"-").toLowerCase();return at.find(({match:n})=>n.test(t))?.id}function nn(){return typeof navigator>"u"?void 0:navigator.language}function on(e,t){return ke(e)??ke(t)??"en"}function V(){return it??on(void 0,nn())}function Te(e=V()){return at.find(({id:t})=>t===e)?.locale??"en-US"}function rn(e){return Ie.add(e),()=>Ie.delete(e)}function rt(e){it=ke(e);let t=V();st(t);for(let n of Ie)n();return t}function st(e){typeof document<"u"&&(document.documentElement.lang=Te(e))}function an(){return Ae||(st(V()),Ae=P.getRuntimeContext().then(e=>rt(e?.locale)).catch(()=>rt(void 0))),Ae}function k(){let e=Xt(Le),t=tn(rn,V,()=>"en");return en(()=>{e||an()},[e]),e??t}import{jsx as _e}from"react/jsx-runtime";var Me=sn(null);function So({children:e,...t}){return _e(Me.Provider,{value:t,children:_e(Le.Provider,{value:t.locale,children:_e("div",{className:"base-app-platform","data-theme":t.theme,children:e})})})}function Po(){let e=ct(Me);if(!e)throw new Error("BASE_APP_PROVIDER_REQUIRED");return e}function me(){return ct(Me)}import{useState as Z,useEffect as gt,useLayoutEffect as hn,useRef as Fe,useId as bn}from"react";import{jsx as D,jsxs as cn}from"react/jsx-runtime";function lt(){return D("svg",{"aria-hidden":"true",focusable:"false",width:"20",height:"20",viewBox:"0 0 20 20",fill:"none",children:D("path",{d:"M17.1956 16.3595C17.6558 16.3595 18.0289 16.7326 18.0289 17.1928C18.0287 17.6529 17.6557 18.0261 17.1956 18.0261H9.48724C9.0273 18.0259 8.65411 17.6527 8.6539 17.1928C8.6539 16.7327 9.02717 16.3597 9.48724 16.3595H17.1956ZM12.5732 2.47195C13.8817 1.28992 15.902 1.32977 17.163 2.59076L17.281 2.71527C18.4249 3.98149 18.4257 5.91435 17.2818 7.18061L17.163 7.3043L9.32366 15.1445C9.12419 15.3439 8.89959 15.5169 8.65716 15.6596L8.40976 15.7923L4.13079 17.8471C2.75554 18.5075 1.31776 17.1336 1.84889 15.7565L1.90667 15.623L3.96152 11.344C4.12431 11.0051 4.34347 10.696 4.60931 10.4301L12.4495 2.59076L12.5732 2.47195ZM5.78769 11.6093C5.65491 11.7421 5.54596 11.8966 5.46461 12.0659L3.40976 16.344L7.68792 14.2892C7.85719 14.2078 8.01164 14.0989 8.14446 13.9661L13.4643 8.64545L11.1075 6.28868L5.78769 11.6093ZM15.9846 3.76915C15.3338 3.11835 14.2788 3.11851 13.6279 3.76915L12.2867 5.11029L14.6435 7.46706L15.9846 6.12592C16.6353 5.47503 16.6354 4.41994 15.9846 3.76915Z",fill:"currentColor"})})}function ut(){return D("svg",{"aria-hidden":"true",focusable:"false",width:"24",height:"6",viewBox:"0 0 24 6",fill:"none",children:D("path",{d:"M8.4383 1.99309L11.2526 5.15916C11.6504 5.60668 12.3496 5.60668 12.7474 5.15916L15.5617 1.99309C16.6886 0.725344 18.3038 0 20 0L12 0L4 0C5.69619 0 7.31142 0.725345 8.4383 1.99309Z",fill:"#1F2329"})})}function dt(){return cn("svg",{"aria-hidden":"true",focusable:"false",width:"16",height:"16",viewBox:"0 0 16 16",fill:"none",children:[D("circle",{cx:"8.00008",cy:"8.00033",r:"7.33333",fill:"#1456F0"}),D("path",{d:"M8 5.33333C8.36819 5.33333 8.66667 5.03486 8.66667 4.66667C8.66667 4.29848 8.36819 4 8 4C7.63181 4 7.33333 4.29848 7.33333 4.66667C7.33333 5.03486 7.63181 5.33333 8 5.33333Z",fill:"white"}),D("path",{d:"M7.33333 6C6.96514 6 6.66667 6.29848 6.66667 6.66667C6.66667 7.03486 6.96514 7.33333 7.33333 7.33333V10H6.66667C6.29848 10 6 10.2985 6 10.6667C6 11.0349 6.29848 11.3333 6.66667 11.3333H9.33333C9.70152 11.3333 10 11.0349 10 10.6667C10 10.2985 9.70152 10 9.33333 10H8.66667V6.66667C8.66667 6.29848 8.36819 6 8 6H7.33333Z",fill:"white"})]})}function pt(){return D("svg",{"aria-hidden":"true",focusable:"false",width:"16",height:"16",viewBox:"0 0 16 16",fill:"none",children:D("path",{d:"M13.5043 13.5042C13.7646 13.2439 13.7665 12.8237 13.5062 12.5633L8.94298 8.00013L13.5061 3.43697C13.7665 3.17662 13.7646 2.7564 13.5043 2.49605C13.2439 2.2357 12.8237 2.23382 12.5633 2.49416C12.303 2.75451 8.00017 7.05732 8.00017 7.05732L3.43697 2.49413C3.17662 2.23378 2.7564 2.23566 2.49605 2.49601C2.2357 2.75636 2.23381 3.17658 2.49416 3.43693L7.05736 8.00013L2.49413 12.5634C2.23378 12.8237 2.23566 13.2439 2.49601 13.5043C2.75636 13.7646 3.17659 13.7665 3.43693 13.5062L8.00017 8.94294L12.5634 13.5061C12.8237 13.7665 13.2439 13.7646 13.5043 13.5042Z",fill:"#646A73"})})}import{QueryClient as ln}from"@tanstack/react-query";var De=new ln({defaultOptions:{queries:{retry:!1,staleTime:3e4,gcTime:3e4}}});function fe(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function ge(e,t){let n=e[t];return typeof n=="string"?n.trim():""}function un(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}function q(){return{baseBindings:[],name:"",description:"",isOwner:!1,allowEdit:!1,organization:""}}function dn(){let e=document.querySelector('meta[name="description"]');return e instanceof HTMLMetaElement?e:null}function pn(e){if(e.name&&(document.title=e.name),e.description){let t=dn();t&&(t.content=e.description)}}function mn(e){return Array.isArray(e)?e.reduce((t,n)=>{if(!fe(n))return t;let o=ge(n,"baseToken");return o&&t.push({baseToken:o,tableIds:un(n.tableIds)}),t},[]):[]}function fn(e){if(!fe(e)||e.code!==0)return q();let t=e.data;if(!fe(t))return q();let n=t.site;return fe(n)?{baseBindings:mn(n.baseBindings),description:ge(n,"description"),name:ge(n,"name"),isOwner:t.isOwner===!0,allowEdit:n.allowEdit===void 0?t.isOwner===!0:n.allowEdit===!0,organization:ge(n,"organization")}:q()}async function mt(e){try{let t=await N(tt(e),{method:"GET"});if(!t.ok)return q();let n=await t.json(),o=fn(n);return pn(o),o}catch{return q()}}async function W(){let e=await z();if(!e.token)return q();let t=await ae().catch(()=>null);return t?.userId?De.fetchQuery({queryKey:["project-meta",e.token,e.env,t.userId],queryFn:()=>mt(e)}):mt(e)}var gn="https://feishu.cn/base/site/detail/overview";async function ft(){try{await P.requestEdit();return}catch{let{token:e}=await z(),t=new URL(gn);if(t.searchParams.set("token",e),!(await de(t.toString())).opened)throw new Error("Management page was not opened")}}import{jsx as U,jsxs as he}from"react/jsx-runtime";var yn={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",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 Yo({position:e="bottom-right",className:t="",slots:n={}}){let o=yn[k()],[r,i]=Z(!1),[a,s]=Z(!1),[c,d]=Z(!1),[u,p]=Z(!1),[m,g]=Z(null),[f,E]=Z(null),x=Fe(null),O=Fe(null),S=Fe(null),_=bn();hn(()=>{if(!m)return;let h=m==="edit"?x.current:O.current,w=S.current;if(!h||!w)return;let v=()=>{let X=h.getBoundingClientRect(),ee=X.left+X.width/2,te=Math.ceil(w.getBoundingClientRect().width),ne=Math.max(8,Math.min(ee-te/2,window.innerWidth-te-8));E({left:ne,top:X.top-w.offsetHeight-14,arrowLeft:ee-ne})};v(),window.addEventListener("resize",v);let K=new ResizeObserver(v);return K.observe(w),()=>{window.removeEventListener("resize",v),K.disconnect()}},[m,o,e,n.tooltip]),gt(()=>{let h=!0;return W().then(w=>{h&&i(w.allowEdit&&Ue().env==="prod")}).catch(()=>{}),()=>{h=!1}},[]),gt(()=>{if(!c)return;let h=setTimeout(()=>d(!1),3e3);return()=>clearTimeout(h)},[c]);let A=n.trigger,y=n.tooltip;return r?a?c?he("div",{className:"base-app-platform base-app-notice",role:"status",children:[U(dt,{}),U("span",{children:o.hiddenConfirmation}),U("button",{type:"button","aria-label":o.dismissNotification,onClick:()=>d(!1),children:U(pt,{})})]}):null:he("div",{className:`base-app-platform base-app-floating ${t}`,"data-position":e,children:[u?U("div",{role:"alert",children:o.openFailed}):null,m?he("div",{ref:S,id:_,role:"tooltip",style:f?{left:f.left,top:f.top}:{visibility:"hidden"},children:[y?U(y,{text:m==="edit"?o.editSite:o.hidePanel}):m==="edit"?o.editSite:o.hidePanel,U("span",{className:"base-app-floating-caret",style:{left:f?.arrowLeft},children:U(ut,{})})]}):null,he("div",{className:"base-app-floating-controls",children:[U("button",{ref:x,type:"button",className:"base-app-floating-edit","aria-describedby":m==="edit"?_:void 0,"aria-label":o.editSite,onFocus:()=>g("edit"),onBlur:()=>g(null),onMouseEnter:()=>g("edit"),onMouseLeave:()=>g(null),onClick:()=>{p(!1),ft().catch(()=>p(!0))},children:A?U(A,{}):U(lt,{})}),U("button",{ref:O,type:"button",className:"base-app-floating-hide","aria-describedby":m==="hide"?_:void 0,"aria-label":o.hidePanel,onFocus:()=>g("hide"),onBlur:()=>g(null),onMouseEnter:()=>g("hide"),onMouseLeave:()=>g(null),onClick:()=>{s(!0),g(null),d(!0)},children:U("span",{"aria-hidden":"true",children:"\xD7"})})]})]}):null}var Oe=new Set;function ht(e){return Oe.add(e),()=>{Oe.delete(e)}}function bt(){for(let e of Oe)e()}import{useEffect as wn,useState as wt}from"react";import*as B from"@radix-ui/react-popover";async function yt(){try{let e=await ae();if(typeof e?.name=="string"&&e.name)return{name:e.name,avatarUrl:typeof e.avatarUrl=="string"?e.avatarUrl:"",tenantName:""}}catch{}try{let e=await N("/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 Cn,jsx as L,jsxs as Ne}from"react/jsx-runtime";var vn={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 ir({audience:e="enterprise",align:t="right",side:n="down",showName:o=!0,className:r="",slots:i={}}){let[a,s]=wt(null),[c,d]=wt(""),u=me(),p=vn[k()];if(wn(()=>{if(e!=="enterprise")return;let f=!0;return Promise.all([yt(),W().catch(()=>null)]).then(([E,x])=>{f&&(s(E),d(E?.tenantName||x?.organization||""))}),()=>{f=!1}},[e]),e!=="enterprise"||!a)return null;let m=i.trigger,g=i.organization;return Ne(B.Root,{children:[L(B.Trigger,{asChild:!0,children:L("button",{className:`base-app-platform base-app-user-menu ${r}`,"aria-label":p.account,children:m?L(m,{user:a}):Ne(Cn,{children:[a.avatarUrl?L("img",{src:a.avatarUrl,alt:"",referrerPolicy:"no-referrer"}):L("span",{children:a.name.slice(0,1)}),o?a.name:null]})})}),L(B.Portal,{children:Ne(B.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:[L("strong",{children:a.name}),g?L(g,{name:c}):L("p",{children:c}),L("button",{onClick:()=>{bt(),De.clear(),Ee().catch(()=>{for(let f of["base-site-session","session","sl_session"])document.cookie=`${f}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/`;window.location.reload()})},children:p.logout})]})})]})}import{useEffect as be,useRef as Rt,useState as Y}from"react";import{Command as se}from"cmdk";import{QueryClient as _n,useQuery as Mn}from"@tanstack/react-query";var Rn="/space/api/mention/recommend.v2/",En="8",xn="4",Un="0",Sn=20,vt={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 Ct(e,t,n){let o=t??V(),r=vt[o],a=(await W()).baseBindings[0]?.baseToken;if(!a)throw new Error(r.noBoundBase);let s=new URLSearchParams({config_source:"0",obj_type:En,source:xn,token:a,type:Un,user_type:"0",content:e.trim().slice(0,50)}).toString(),c=await N(Rn,{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:Pn(d,o)}}function Pn(e,t=V()){let n=Te(t),o=vt[t],r=An(e,o);if(!r)throw new Error(o.invalidResponse);let i=r.entities,a=T(i)?i.users:void 0;if(!T(a)||!Array.isArray(r.result_list))throw new Error(o.invalidResponse);let s=[],c=new Set;for(let d of r.result_list){if(!T(d)||Number(d.type)!==0)continue;let u=b(d.token);if(!u)continue;let p=a[u];if(!T(p))continue;let m=b(p.user_id)||b(p.id)||u,g=In(p,n);if(!m||!g||c.has(m))continue;c.add(m);let f=b(p.avatar_url),E=b(p.open_id);if(s.push({avatar:{avatar_72:f,avatar_240:f,avatar_640:f,avatar_origin:f},department_ids:Tn(p.department_ids),description:kn(p,n),is_external:p.is_external===!0,name:g,user_id:m,...E?{open_id:E}:{}}),s.length>=Sn)break}return{users:s}}function An(e,t){if(T(e)){if(typeof e.code=="number"&&e.code!==0){let n=b(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:T(e.data)?e.data:void 0}}function In(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=T(n)?n:{},a=T(i.i18n_value)?i.i18n_value:i,s=r==="zh"?e.cn_name:r==="en"?e.en_name:void 0;return b(a[o])||b(a[r])||b(s)||b(i.value)||b(e.name)||b(e.en_name)||b(e.cn_name)}function kn(e,t){let n=e.is_external===!0?e.i18n_tenant:e.i18n_department;return Ln(n,t)||b(e.department)}function Ln(e,t){if(typeof e=="string")return e.trim();if(!T(e))return"";let n=t.toLowerCase().replace("-","_"),o=n.split("_")[0]??"",r=T(e.i18n_value)?e.i18n_value:e,i=b(r[n])||b(r[o]);if("i18n_value"in e)return i||b(e.value);let a=o==="zh"?b(r.zh_cn)||b(r.en_us):b(r.en_us)||b(r.zh_cn);return i||b(e.value)||a}function b(e){return typeof e=="string"?e.trim():""}function Tn(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}function T(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import{Fragment as xt,jsx as R,jsxs as Be}from"react/jsx-runtime";var Ut={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 ye(e){let[t,n]=Y(!1),[o,r]=Y(!1);be(()=>r(!0),[]);let i=k(),a=Ut[i],[s]=Y(()=>new _n({defaultOptions:{queries:{retry:!1,staleTime:3e4,gcTime:3e4}}}));be(()=>{let l=ht(()=>{n(!0),s.clear()});return()=>{l(),s.clear()}},[s]);let c=Object.prototype.hasOwnProperty.call(e,"value"),d=Rt(c);be(()=>{c!==d.current&&console.warn("UserSelectorPanel controlled mode changed")},[c]);let[u,p]=Y(e.defaultValue),m=c?e.value:u,g=Array.isArray(m)?m:m?[m]:[],[f,E]=Y(""),[x,O]=Y(""),[S,_]=Y(!1),A=Rt(!1);be(()=>{if(S)return;let l=setTimeout(()=>O(f.trim()),f.trim()?400:0);return()=>clearTimeout(l)},[f,S]);let y=Mn({queryKey:["members",i,x],queryFn:async({signal:l})=>{let C=await Ct(x,i,l);return Dn(C,i)},enabled:!t&&o&&!S&&f.trim()===x},s),h=e.loading||y.isFetching||f.trim()!==x,w=!t&&!h&&!y.error&&y.data?[...y.data.users,...g.filter(l=>!y.data.users.some(C=>C.user_id===l.user_id))]:[],v=(l,C)=>{E(l),e.onSearch?.(l,{action:C})},K=()=>{v("","AutoClear"),e.onClose?.()},X=l=>{if(A.current)return;let C=g.some(we=>we.user_id===l.user_id),ce=e.mode==="multiple"?C?g.filter(we=>we.user_id!==l.user_id):[...g,l]:C?void 0:l;c||p(ce),e.onChange?.(ce,{option:l,action:C?"Remove":"Select"}),C||e.onSelect?.(l,{option:l}),e.mode==="multiple"?v("","AutoClear"):K()},ee=e.slots?.empty,te=e.slots?.loading,ne=e.slots?.option,$e=e.slots?.footer;return Be(se,{shouldFilter:!1,loop:!0,className:`base-app-platform base-app-selector ${e.className??""}`,label:a.memberList,children:[R(se.Input,{autoFocus:!0,placeholder:a.searchMembers,"aria-label":a.searchMembers,value:f,onValueChange:l=>v(l,"Input"),onCompositionStart:()=>{A.current=!0,_(!0)},onCompositionEnd:()=>{A.current=!1,_(!1)},onKeyDown:l=>{if(e.onKeyDown?.(l),l.defaultPrevented){l.stopPropagation();return}if(A.current||Fn(l)){l.stopPropagation();return}l.key==="Escape"&&(l.preventDefault(),K())}}),R(se.List,{"aria-label":a.memberList,"aria-multiselectable":e.mode==="multiple"||void 0,children:h?R("div",{role:"status",children:te?R(te,{}):a.loading}):y.error?R("div",{role:"alert",children:a.searchFailed}):Be(xt,{children:[e.onSelectRecordCreator?R(se.Item,{value:"record-creator",onSelect:()=>{e.onSelectRecordCreator?.(),K()},children:a.recordCreator}):null,w.map(l=>{let C=g.some(ce=>ce.user_id===l.user_id);return R(se.Item,{value:l.user_id,onSelect:()=>X(l),"data-checked":C,children:ne?R(ne,{user:l,selected:C}):Be(xt,{children:[R("span",{children:l.name}),R("small",{children:e.getUserDescription?.(l)??l.description}),C?R("span",{"aria-label":"selected",children:"\u2713"}):null]})},l.user_id)}),!w.length&&!e.onSelectRecordCreator?R("div",{role:"status",children:ee?R(ee,{}):f.trim()?a.noMatches:a.noRecommendations}):null]})}),$e?R($e,{}):null]})}function Dn(e,t){let n=Ut[t];if(!Et(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(!Et(e.data)||!Array.isArray(e.data.users))throw new Error(n.invalidResponse);return{users:e.data.users}}function Et(e){return typeof e=="object"&&e!==null}function Fn(e){return e.nativeEvent?.isComposing===!0||e.keyCode===229}import{useState as On,useRef as Nn}from"react";import*as j from"@radix-ui/react-popover";import{jsx as F,jsxs as St}from"react/jsx-runtime";var Bn={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 Pt(e){let t=Nn(null),n=me(),o=Bn[k()],[r,i]=On(!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 St(j.Root,{open:r,onOpenChange:s,children:[St("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:[F(j.Trigger,{asChild:!0,children:F("button",{type:"button","data-base-app-trigger":"","aria-label":o.selectMembers,onFocus:e.onFocus,onBlur:e.onBlur,children:c?F(c,{value:e.value}):a.length?a.map(u=>F("span",{children:d?F(d,{user:u}):u.name},u.user_id)):o.selectMembers})}),a.map(u=>F("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(m=>m.user_id!==u.user_id):void 0),e.mode==="multiple"?e.onRemove?.(u):e.onClear?.()},children:"\xD7"},u.user_id))]}),F(j.Portal,{container:e.portalContainer??t.current?.closest("dialog")??void 0,children:F(j.Content,{"data-theme":n?.theme,className:"base-app-platform base-app-popover",sideOffset:4,collisionPadding:8,children:F(ye,{...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 At,useRef as jn,useState as je}from"react";import{jsx as G,jsxs as Hn}from"react/jsx-runtime";var $n={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 Tr({attachment:e,size:t=360,alt:n,className:o,slots:r={}}){let i=k(),a=$n[i],s=jn(null),[c,d]=je(!1),[u,p]=je(0),[m,g]=je({key:"",url:"",error:""}),{tableId:f,fieldId:E,recordId:x,fileToken:O}=e,S=JSON.stringify([f,E,x,O,t,u]);At(()=>{if(typeof IntersectionObserver>"u"){d(!0);return}let h=new IntersectionObserver(w=>{w.some(v=>v.isIntersecting)&&(d(!0),h.disconnect())},{rootMargin:"200px"});return s.current&&h.observe(s.current),()=>h.disconnect()},[]),At(()=>{if(!c)return;let h=new AbortController,w="";return et({tableId:f,fieldId:E,recordId:x,fileToken:O},t,{signal:h.signal}).then(v=>{h.signal.aborted||(w=URL.createObjectURL(v),g({key:S,url:w,error:""}))}).catch(v=>{h.signal.aborted||g({key:S,url:"",error:v instanceof Error?v.message:"",localError:v instanceof Error?void 0:"loadFailed"})}),()=>{h.abort(),w&&URL.revokeObjectURL(w)}},[c,S,f,E,x,O,t]);let _=r.loading,A=r.error,y=m.key===S?m:void 0;return G("span",{ref:s,className:`base-app-platform base-app-attachment ${o??""}`,"aria-busy":!y,children:y?.url?G("img",{src:y.url,alt:n,onError:()=>g({key:S,url:"",error:"",localError:"decodeFailed"})}):y?.error||y?.localError?A?G(A,{code:"ATTACHMENT_LOAD_FAILED",retry:()=>p(h=>h+1)}):Hn("span",{children:[G("span",{role:"status",children:y.localError?a[y.localError]:y.error}),G("button",{type:"button",onClick:()=>p(h=>h+1),children:a.retry})]}):G("span",{role:"status",children:_?G(_,{}):a.loading})})}export{qn as a,le as b,Yn as c,Gn as d,Kn as e,Jn as f,Qn as g,Ke as h,Re as i,Ce as j,so as k,P as l,ue as m,co as n,ae as o,Ee as p,Dt as q,lo as r,de as s,Ft as t,N as u,ve as v,It as w,kt as x,Xn as y,Lt as z,Ve as A,Ue as B,z as C,et as D,zt as E,tt as F,nt as G,xe as H,fo as I,go as J,ho as K,bo as L,Le as M,on as N,V as O,Te as P,an as Q,k as R,So as S,Po as T,me as U,De as V,Yo as W,ir as X,ye as Y,Pt as Z,Tr as _};
|