@lark-base-open/base-database-app-sdk 0.0.0-stage → 0.0.1-alpha.1

package/dist/index-64557073.d.ts

@@ -0,0 +1,306 @@
+import * as React from 'react';
+import React__default, { KeyboardEventHandler, MouseEventHandler, FocusEventHandler, ComponentType } from 'react';
+import * as channelRuntime from '@lark-base-open/base-site-channel/runtime';
+import { FunctionMap, RuntimeChannel, SiteProjectEnv } from '@lark-base-open/base-site-channel/runtime';
+import { S as SiteRuntimeContext } from './capabilities-56e403e7.js';
+import { RuntimeDiagnostic } from './shared.js';
+
+declare class SiteRuntimeClient<Map = FunctionMap> extends channelRuntime.SiteRuntimeClient<Map> {
+    constructor(channel?: RuntimeChannel);
+}
+declare const createSiteRuntimeClient: <Map = FunctionMap>(channel?: RuntimeChannel) => SiteRuntimeClient<Map>;
+declare const siteRuntime: {
+    getRuntimeContext(): Promise<SiteRuntimeContext>;
+} & typeof channelRuntime.siteRuntime;
+declare const invokeHttp: (request: channelRuntime.SiteHttpRequestOptions) => Promise<Response>;
+declare const invokeApi: <Name extends never>(functionName: Name, params: channelRuntime.FunctionMap[Name] extends channelRuntime.SiteFunctionDefinition<infer Params, unknown> ? Params : never) => Promise<channelRuntime.FunctionMap[Name] extends channelRuntime.SiteFunctionDefinition<unknown, infer Result> ? Result : never>;
+declare const getCurrentUser: () => Promise<channelRuntime.SiteRuntimeUserInfo>;
+declare const logout: () => Promise<void>;
+declare const requestEdit: () => Promise<void>;
+declare const uploadAttachment: ({ onProgress, ...request }: channelRuntime.SiteAttachmentUploadOptions) => Promise<channelRuntime.SiteAttachmentUploadResult>;
+declare const openLink: (url: string) => Promise<channelRuntime.SiteOpenLinkResult>;
+declare const createSiteRuntimeFetch: typeof channelRuntime.createSiteRuntimeFetch;
+declare const fetch: typeof globalThis.fetch;
+
+/** 工程生成代码通过 page 模块扩充，未生成时拒绝任意函数名。 */
+interface DatabaseFunctionInputMap extends FunctionInputMap {
+}
+interface FunctionInputMap {
+}
+
+/** 应用产物在 BaseApp 页面 iframe 中的运行上下文。 */
+interface DatabaseContext {
+    env: DatabaseEnv;
+    gatewayOrigin: string;
+    token: string;
+}
+/** 附件在底表里的位置。四个值都来自 catalog.json 与 Database Function 结果。 */
+interface DatabaseAttachmentRef {
+    tableId: string;
+    fieldId: string;
+    recordId: string;
+    fileToken: string;
+}
+/** 产物环境沿用 site.v1 协议的规范类型，避免两侧各自声明后漂移。 */
+type DatabaseEnv = SiteProjectEnv;
+/** Function 调用的统一响应包裹结构，与运行态接口一致。 */
+interface DatabaseFunctionResponse<Data = unknown> {
+    code: number;
+    data?: Data;
+    msg?: string;
+}
+
+/** 从产物托管路径推断当前应用 token 与运行环境。
+ *
+ * 这是宿主未下发上下文时的兜底：BaseApp 形态下 site 与 BaseApp 共用同一个 token，
+ * 线上产物挂在 /app/{token}/、预览产物挂在 /preview/app/{token}/。
+ * 该推断依赖部署侧的 CDN 路径约定，优先级低于宿主下发值。
+ *
+ * @returns 应用 token、运行环境与业务网关 origin；无法推断的值为空字符串。
+ */
+declare function getDatabaseContext(): DatabaseContext;
+/** 解析当前应用上下文，宿主下发值优先、产物路径推断兜底。
+ *
+ * 结果按会话缓存；解析失败时清空缓存，允许后续调用重试。
+ *
+ * @returns 应用 token、运行环境与业务网关 origin。
+ */
+declare function resolveDatabaseContext(): Promise<DatabaseContext>;
+/** 宿主用当前访问者身份同源取图，返回可创建本地 URL 的图片字节。
+ * 调用方在替换或卸载时取消请求并释放自己创建的 Blob URL。
+ */
+declare function fetchAttachmentCover(ref: DatabaseAttachmentRef, size?: number, options?: {
+    signal?: AbortSignal;
+}): Promise<Blob>;
+/** 经父页面 bridge 取短时效自证链接；原文件由浏览器下载，不进入页面 JavaScript。
+ * 下载链接不代表附件增删已完成，也不提供并发或重试保证。
+ *
+ * @returns 短时效下载链接；用户下载请调用 openAttachmentDownload，由宿主打开。
+ */
+declare function fetchAttachmentDownloadUrl(context: DatabaseContext, ref: DatabaseAttachmentRef): Promise<string>;
+/** 构造运行态读取应用信息的统一网关地址。
+ *
+ * @param context 当前应用上下文。
+ * @returns GetInvokeProject 的同源相对路径。
+ */
+declare function buildDatabaseInvokeGetPath(context: DatabaseContext): string;
+/** 构造运行态调用函数的统一网关地址。
+ *
+ * token 与 function_id 是 path 参数，env 走 query（prod 为服务端缺省，不显式下传）。
+ *
+ * @param context 当前应用上下文。
+ * @param functionId Base Database Function ID。
+ * @returns InvokeFunction 的同源相对路径。
+ * @throws functionId 不满足命名约束时抛出 TypeError。
+ */
+declare function buildDatabaseInvokeFunctionPath(context: DatabaseContext, functionId: string): string;
+/** 调用应用 Function。
+ *
+ * 请求经父页面同源代理发往统一网关；整个请求体即 payload，业务参数包在 params 下。
+ * 目标环境由 query 参数 env 指定，不重复添加环境 Header。
+ * 4xx/5xx 直接抛错，业务码由调用方按 operation 契约校验一次顶层 code。
+ *
+ * @param functionId Base Database Function ID。
+ * @param params 函数入参：Database Function、Mutation 与 FaaS 使用按声明名称构造的对象。
+ * @returns 统一包裹的函数响应。
+ */
+type DatabaseFunctionInvocation<Inputs extends object> = [
+    Extract<keyof Inputs, string>
+] extends [never] ? [functionId: never, params: never] : {
+    [FunctionId in Extract<keyof Inputs, string>]: [
+        functionId: FunctionId,
+        params: Inputs[FunctionId]
+    ];
+}[Extract<keyof Inputs, string>];
+declare function invokeDatabaseFunction<Data = unknown>(...[functionId, params]: DatabaseFunctionInvocation<DatabaseFunctionInputMap>): Promise<DatabaseFunctionResponse<Data>>;
+/** 每组参数应用同一份已发布 Mutation 声明；总记录数最多 200。 */
+declare function invokeDatabaseMutationBatch<Data = unknown>(functionId: string, parameterGroups: Record<string, unknown>[]): Promise<DatabaseFunctionResponse<Data>>;
+/** 每次点击重新取短效 URL，经宿主打开；不代表浏览器已完成落盘。 */
+declare function openAttachmentDownload(context: DatabaseContext, ref: DatabaseAttachmentRef): Promise<void>;
+/** 旧模板的纯 URL 构造兼容接口：同步、无网络/宿主调用。
+ * 保留旧 extra.baseAppToken 与尺寸匹配语义；新业务取封面使用 fetchAttachmentCover，
+ * 其实际请求经统一调用边界。构造地址不能证明附件存在、权限或写入成功。
+ */
+declare function buildAttachmentCoverUrl(context: DatabaseContext, ref: DatabaseAttachmentRef, size?: number): string;
+
+declare const UiLanguageContext: React.Context<"en" | "zh" | "ja" | undefined>;
+declare const LANGUAGES: readonly [{
+    readonly id: "en";
+    readonly locale: "en-US";
+    readonly match: RegExp;
+}, {
+    readonly id: "zh";
+    readonly locale: "zh-CN";
+    readonly match: RegExp;
+}, {
+    readonly id: "ja";
+    readonly locale: "ja-JP";
+    readonly match: RegExp;
+}];
+type UiLanguage = (typeof LANGUAGES)[number]["id"];
+/** Supported host locale wins; otherwise use the browser, then English. */
+declare function selectUiLanguage(hostLocale: unknown, fallbackLocale: unknown): UiLanguage;
+declare function getUiLanguage(): UiLanguage;
+declare function getUiLocale(language?: "en" | "zh" | "ja"): string;
+/** The Channel waits for the host handshake. All components share one request. */
+declare function initializeUiLanguage(): Promise<UiLanguage>;
+declare function useUiLanguage(): UiLanguage;
+
+interface BaseAppContextValue {
+    runtime: typeof siteRuntime;
+    theme: "host" | "light" | "dark";
+    locale: UiLanguage;
+    mode?: string;
+    onDiagnostic?: (record: RuntimeDiagnostic) => void;
+}
+declare function BaseAppProvider({ children, ...value }: BaseAppContextValue & {
+    children?: React__default.ReactNode;
+}): React__default.JSX.Element;
+declare function useBaseApp(): BaseAppContextValue;
+declare function useOptionalBaseApp(): BaseAppContextValue | null;
+
+interface FloatingButtonProps {
+    position?: "bottom-right" | "bottom-left";
+    className?: string;
+    slots?: {
+        trigger?: React__default.ComponentType;
+        tooltip?: React__default.ComponentType<{
+            text: string;
+        }>;
+    };
+}
+declare function FloatingButton({ position, className, slots, }: FloatingButtonProps): React__default.JSX.Element | null;
+
+/** 浮层菜单展示用的当前登录用户信息。 */
+interface CurrentUser {
+    name: string;
+    avatarUrl: string;
+    /** 组织名。协议的 getCurrentUser 不含该字段，仅宿主用户接口回落路径提供。 */
+    tenantName: string;
+}
+
+type DatabaseAudience = "enterprise" | "personal";
+interface DatabaseUserMenuProps {
+    /** 默认 enterprise：拿不准时宁可多显示一个头像，也不要让用户找不到退出登录。 */
+    slots?: {
+        trigger?: React__default.ComponentType<{
+            user: CurrentUser;
+        }>;
+        organization?: React__default.ComponentType<{
+            name: string;
+        }>;
+    };
+    audience?: DatabaseAudience;
+    /** 弹层相对触发器的对齐方向，默认 right（触发器在右上角时用）。 */
+    align?: "left" | "right";
+    /** 弹层展开方向，默认 down（触发器在顶部时用）；侧边栏底部的入口用 up。 */
+    side?: "up" | "down";
+    /** 是否在头像右侧显示姓名。窄侧栏或顶栏空间紧张时传 false。 */
+    showName?: boolean;
+    className?: string;
+}
+declare function DatabaseUserMenu({ audience, align, side, showName, className, slots, }: DatabaseUserMenuProps): React__default.JSX.Element | null;
+
+interface UserAvatar {
+    avatar_72: string;
+    avatar_240: string;
+    avatar_640: string;
+    avatar_origin: string;
+}
+interface User {
+    avatar: UserAvatar;
+    department_ids: string[];
+    description?: string;
+    is_external?: boolean;
+    name: string;
+    user_id: string;
+    open_id?: string;
+}
+
+type UserSelectorAction = "Select" | "Remove" | "Clear";
+type UserSelectorMode = "multiple";
+type UserSelectorSearchAction = "Input" | "AutoClear";
+type UserSelectorValue = User | User[];
+interface UserSelectorPanelProps {
+    className?: string;
+    slots?: {
+        empty?: React__default.ComponentType;
+        loading?: React__default.ComponentType;
+        option?: React__default.ComponentType<{
+            user: User;
+            selected: boolean;
+        }>;
+        footer?: React__default.ComponentType;
+    };
+    value?: UserSelectorValue | null;
+    defaultValue?: UserSelectorValue;
+    onChange?: (value: UserSelectorValue | undefined, meta: {
+        option: User | undefined;
+        action: UserSelectorAction;
+    }) => void;
+    onSelect?: (user: User, meta: {
+        option: User;
+    }) => void;
+    onClose?: () => void;
+    onSelectRecordCreator?: () => void;
+    getUserDescription?: (user: User) => string | undefined;
+    onSearch?: (value: string, meta: {
+        action: UserSelectorSearchAction;
+    }) => void;
+    loading?: boolean;
+    mode?: UserSelectorMode;
+    onKeyDown?: KeyboardEventHandler<HTMLInputElement>;
+}
+declare function UserSelectorPanel(props: UserSelectorPanelProps): React__default.JSX.Element;
+
+type UserSelectorEditorValue = UserSelectorValue;
+
+interface UserSelectorEditorProps {
+    className?: string;
+    portalContainer?: HTMLElement;
+    slots?: {
+        trigger?: React__default.ComponentType<{
+            value: UserSelectorEditorValue | null | undefined;
+        }>;
+        chip?: React__default.ComponentType<{
+            user: User;
+        }>;
+    };
+    value: UserSelectorEditorValue | null | undefined;
+    loading?: boolean;
+    mode?: UserSelectorMode;
+    onClick?: MouseEventHandler<HTMLDivElement>;
+    onChange?: (value: UserSelectorEditorValue | undefined) => void;
+    onSelect?: (user: User, meta: {
+        option: User;
+    }) => void;
+    onClear?: () => void;
+    onRemove?: (user: User) => void;
+    onSelectRecordCreator?: () => void;
+    getUserDescription?: (user: User) => string | undefined;
+    onDropdownVisibleChange?: (visible: boolean) => void;
+    onSearch?: (value: string, meta: {
+        action: UserSelectorSearchAction;
+    }) => void;
+    onKeyDown?: KeyboardEventHandler<HTMLInputElement>;
+    onFocus?: FocusEventHandler<HTMLButtonElement>;
+    onBlur?: FocusEventHandler<HTMLButtonElement>;
+}
+declare function UserSelectorEditor(props: UserSelectorEditorProps): React__default.JSX.Element;
+
+/** 缩略图与大图共用；只在靠近可见区域时加载，组件持有并释放本地图片 URL。 */
+declare function AttachmentImage({ attachment, size, alt, className, slots, }: {
+    slots?: {
+        loading?: ComponentType;
+        error?: ComponentType<{
+            code: string;
+            retry: () => void;
+        }>;
+    };
+    attachment: DatabaseAttachmentRef;
+    size?: number;
+    alt: string;
+    className?: string;
+}): React.JSX.Element;
+
+export { getUiLocale as $, UserSelectorPanel as A, UserSelectorPanelProps as B, User as C, DatabaseContext as D, UserSelectorValue as E, FunctionInputMap as F, UserSelectorMode as G, UserSelectorAction as H, UserSelectorSearchAction as I, UserSelectorEditor as J, UserSelectorEditorProps as K, UserSelectorEditorValue as L, BaseAppContextValue as M, BaseAppProvider as N, useBaseApp as O, useOptionalBaseApp as P, FloatingButtonProps as Q, FloatingButton as R, SiteRuntimeClient as S, DatabaseAudience as T, UiLanguage as U, DatabaseUserMenuProps as V, DatabaseUserMenu as W, AttachmentImage as X, UiLanguageContext as Y, selectUiLanguage as Z, getUiLanguage as _, getDatabaseContext as a, initializeUiLanguage as a0, useUiLanguage as a1, resolveDatabaseContext as b, fetchAttachmentCover as c, buildAttachmentCoverUrl as d, fetchAttachmentDownloadUrl as e, fetch as f, getCurrentUser as g, buildDatabaseInvokeGetPath as h, invokeHttp as i, buildDatabaseInvokeFunctionPath as j, invokeDatabaseFunction as k, logout as l, invokeDatabaseMutationBatch as m, DatabaseAttachmentRef as n, openAttachmentDownload as o, DatabaseEnv as p, DatabaseFunctionResponse as q, requestEdit as r, siteRuntime as s, DatabaseFunctionInvocation as t, DatabaseFunctionInputMap as u, createSiteRuntimeClient as v, createSiteRuntimeFetch as w, invokeApi as x, uploadAttachment as y, openLink as z };

package/dist/page.d.ts

@@ -0,0 +1,138 @@
+import * as channelRuntime from '@lark-base-open/base-site-channel/runtime';
+import { LinkGuardOptions as LinkGuardOptions$1, CallSiteAIFunctionParams as CallSiteAIFunctionParams$1, InvokeSiteAIFunctionStreamParams as InvokeSiteAIFunctionStreamParams$1, SiteAIVideoTask, SiteAIImageAsset, SiteAIFunctionResult, SiteAIFunctionStreamHandle } from '@lark-base-open/base-site-channel/runtime';
+export * from '@lark-base-open/base-site-channel/runtime';
+export { SiteChatbotStreamError } from '@lark-base-open/base-site-channel/runtime';
+import { RuntimeDiagnostic } from './shared.js';
+export { CapabilityContext, CapabilityDescriptor, CapabilityMap, CapabilityName, CapabilityQueryResult, CapabilityUnavailableError, CapabilityUnavailableReason, DiagnosticCategory, DiagnosticCode, FunctionEnvelope, JsonValue, RuntimeCapabilities, SDKError, SDKErrorOptions, WriteResult, classifyRuntimeError } from './shared.js';
+import { R as RuntimeContextReader } from './capabilities-56e403e7.js';
+export { S as SiteRuntimeContext, g as getCapabilities, a as getRuntimeCapabilities, h as hasCapability, q as queryCapability, r as readCapabilities, b as requireCapability } from './capabilities-56e403e7.js';
+export * from '@lark-base-open/base-site-channel/runtime-contract';
+export { SITE_RUNTIME_PROTOCOL_VERSION, SiteRuntimeApi, SiteRuntimeErrorCode, SiteRuntimeEvent, SiteRuntimeFunction, isValidSiteFunctionName, readSiteAITextDelta } from '@lark-base-open/base-site-channel/runtime-contract';
+import { U as UiLanguage } from './index-64557073.js';
+export { X as AttachmentImage, M as BaseAppContextValue, N as BaseAppProvider, n as DatabaseAttachmentRef, T as DatabaseAudience, D as DatabaseContext, p as DatabaseEnv, u as DatabaseFunctionInputMap, t as DatabaseFunctionInvocation, q as DatabaseFunctionResponse, W as DatabaseUserMenu, V as DatabaseUserMenuProps, R as FloatingButton, Q as FloatingButtonProps, F as FunctionInputMap, S as SiteRuntimeClient, Y as UiLanguageContext, C as User, H as UserSelectorAction, J as UserSelectorEditor, K as UserSelectorEditorProps, L as UserSelectorEditorValue, G as UserSelectorMode, A as UserSelectorPanel, B as UserSelectorPanelProps, I as UserSelectorSearchAction, E as UserSelectorValue, d as buildAttachmentCoverUrl, j as buildDatabaseInvokeFunctionPath, h as buildDatabaseInvokeGetPath, v as createSiteRuntimeClient, w as createSiteRuntimeFetch, f as fetch, c as fetchAttachmentCover, e as fetchAttachmentDownloadUrl, g as getCurrentUser, a as getDatabaseContext, _ as getUiLanguage, $ as getUiLocale, a0 as initializeUiLanguage, x as invokeApi, k as invokeDatabaseFunction, m as invokeDatabaseMutationBatch, i as invokeHttp, l as logout, o as openAttachmentDownload, z as openLink, r as requestEdit, b as resolveDatabaseContext, Z as selectUiLanguage, s as siteRuntime, y as uploadAttachment, O as useBaseApp, P as useOptionalBaseApp, a1 as useUiLanguage } from './index-64557073.js';
+import React__default from 'react';
+export { CAPABILITY_CATALOG } from '@lark-base-open/base-site-channel/capabilities';
+
+interface LinkGuardOptions extends LinkGuardOptions$1 {
+    /** 测试时可注入上下文读取器；转发链接仍使用 channel 默认运行时。 */
+    runtime?: RuntimeContextReader;
+    onDiagnostic?: (diagnostic: RuntimeDiagnostic) => void;
+}
+/** 同步返回清理函数，异步查询期间维持原生行为；卸载后迟到的查询不会安装。 */
+declare function installLinkGuard(options?: LinkGuardOptions): () => void;
+
+type SiteAIMessageContentPart = {
+    text: string;
+    type: "text";
+} | {
+    detail?: "high" | "low" | "xhigh";
+    type: "image";
+    url: string;
+} | {
+    fps?: number;
+    type: "video";
+    url: string;
+} | {
+    type: "audio";
+    url: string;
+} | {
+    filename?: string;
+    type: "file";
+    url: string;
+};
+/** AI Function 对话消息。所有 content 都使用非空 parts 数组；System Prompt 由 Function 配置管理。
+ * 元组式 `[X, ...X[]]` 保证空数组无法通过 TS 编译，避免把空 content 推迟到运行态服务端校验。 */
+type SiteAIMessage = {
+    content: [SiteAIMessageContentPart, ...SiteAIMessageContentPart[]];
+    role: "user";
+} | {
+    content: [
+        Extract<SiteAIMessageContentPart, {
+            type: "text";
+        }>,
+        ...Array<Extract<SiteAIMessageContentPart, {
+            type: "text";
+        }>>
+    ];
+    role: "assistant";
+};
+type WithSiteAIMessages<T> = T extends unknown ? Omit<T, "messages"> & {
+    messages?: SiteAIMessage[];
+} : never;
+type CallSiteAIFunctionParams = WithSiteAIMessages<CallSiteAIFunctionParams$1>;
+type InvokeSiteAIFunctionStreamParams = Omit<InvokeSiteAIFunctionStreamParams$1, "messages"> & {
+    messages: SiteAIMessage[];
+};
+
+/** AI Function 可判别联合返回与媒体任务态，供页面按 type 分支渲染。 */
+type SiteAIMediaTask = SiteAIVideoTask | {
+    capabilityType?: "image";
+    errCode?: string;
+    errMessage?: string;
+    imageAssets?: SiteAIImageAsset[];
+    progress?: number;
+    requestId: string;
+    status: "cancelled" | "failed" | "queued" | "running" | "succeeded";
+    taskId: string;
+    type: "image_task";
+};
+
+/** 按 functionKey 调用 AI Function，返回可判别联合结果（text/image_task/video_task）。
+ *
+ * 页面用 switch(result.type) 分支渲染：text 为聚合文本，image_task/video_task
+ * 需再用 getSiteAIFunctionTask 轮询。传 messages 走文本/多模态理解，
+ * 传 input 创建媒体任务；随后用 getSiteAIFunctionTask 轮询。
+ */
+declare function callSiteAIFunction(params: CallSiteAIFunctionParams): Promise<SiteAIFunctionResult>;
+/** 显式流式调用 AI Function（text/vision）：逐帧消费增量，卸载或取消时 destroy。 */
+declare function invokeSiteAIFunctionStream(params: InvokeSiteAIFunctionStreamParams): SiteAIFunctionStreamHandle;
+/** 校验并归一化 AI Function 媒体任务响应。
+ *
+ * Channel SDK 新旧版本、OpenAPI 和父页面代理可能返回裸 task 或
+ * `{code,msg,data}` 包裹；页面只接受含合法 taskId/type/status 的任务。
+ */
+declare function normalizeSiteAIMediaTask(value: unknown): SiteAIMediaTask;
+declare function hasRunnableMediaTask(task: SiteAIMediaTask): task is SiteAIMediaTask & {
+    taskId: string;
+};
+/** 提交文生图或文生视频任务，返回封装后的 taskId 与初始状态。 */
+declare function createSiteAIFunctionTask(params: CallSiteAIFunctionParams): Promise<SiteAIMediaTask>;
+/** 轮询文生图或文生视频任务进度与最终资源。 */
+declare function getSiteAIFunctionTask(functionKey: string, taskId: string): Promise<SiteAIMediaTask>;
+
+interface StartBaseAppOptions {
+    app: React__default.ComponentType;
+    root?: HTMLElement | string;
+    strictMode?: boolean;
+    linkGuard?: boolean;
+    reportLifecycle?: boolean;
+    platformUI?: boolean;
+    theme?: "host" | "light" | "dark";
+    locale?: "host" | UiLanguage;
+    providers?: (children: React__default.ReactNode) => React__default.ReactNode;
+    onDiagnostic?: (record: RuntimeDiagnostic) => void;
+    slots?: {
+        loading?: React__default.ComponentType;
+        error?: React__default.ComponentType<{
+            code: string;
+        }>;
+    };
+}
+interface BaseAppHandle {
+    ready: Promise<void>;
+    dispose(): void;
+}
+declare function startBaseApp(options: StartBaseAppOptions): BaseAppHandle;
+
+interface DevelopmentPairChallenge {
+    challenge: string;
+}
+interface DevelopmentPairProof {
+    proof: string;
+}
+
+declare class SiteChatbotStreamAdapter extends channelRuntime.SiteChatbotStreamAdapter {
+    constructor(options: ConstructorParameters<typeof channelRuntime.SiteChatbotStreamAdapter>[0]);
+}
+
+export { BaseAppHandle, CallSiteAIFunctionParams, DevelopmentPairChallenge, DevelopmentPairProof, InvokeSiteAIFunctionStreamParams, LinkGuardOptions, RuntimeContextReader, RuntimeDiagnostic, SiteAIMediaTask, SiteAIMessage, SiteAIMessageContentPart, SiteChatbotStreamAdapter, StartBaseAppOptions, UiLanguage, callSiteAIFunction, createSiteAIFunctionTask, getSiteAIFunctionTask, hasRunnableMediaTask, installLinkGuard, invokeSiteAIFunctionStream, normalizeSiteAIMediaTask, startBaseApp };

package/dist/page.js

@@ -0,0 +1 @@
+import{A as Qe,B as le,C as pe,D as fe,E as Se,F as Ae,G as ge,H as Ie,I as ke,J as ye,K as he,L as Ye,M as L,N as Je,O,P as Xe,Q as Ze,R as B,S as $e,T as et,U,V as G,W as tt,X as nt,Y as it,Z as rt,a as Q,b as Y,c as J,d as X,e as Z,f as $,g as ee,h as x,i as M,j as te,k as ne,l as m,m as ie,n as re,o as oe,p as ae,q as se,r as ce,s as ue,t as de,u as me,v as ze,w as _,x as Ke,y as We,z as je}from"./chunk-5XIFZ4AH.js";import{a as He,b as Ve,c as v,d as R}from"./chunk-ZKBZAK4L.js";import{a as qe}from"./chunk-3JX3FIBG.js";import"./chunk-OHPYKFCM.js";export*from"@lark-base-open/base-site-channel/runtime";import{installLinkGuard as Re}from"@lark-base-open/base-site-channel/runtime";function D(e={}){let t=!0,n,i=s=>{let c=R(s);e.onDiagnostic?e.onDiagnostic(c):console.warn("[Base Database SDK]",c)},o=e.runtime??m;return Promise.resolve().then(()=>o.getRuntimeContext()).then(s=>{if(t){if(!_(s,"link.open")){i(new v("link.open",1));return}n=Re(e)}}).catch(s=>{t&&i(s)}),()=>{t=!1,n?.()}}export*from"@lark-base-open/base-site-channel/runtime-contract";import{SiteChatbotStreamError as _t}from"@lark-base-open/base-site-channel/runtime";import*as u from"@lark-base-open/base-site-channel/runtime";var P=class extends u.SiteChatbotStreamAdapter{constructor(t){super({...t,channel:t.channel?x(t.channel):M})}},F=e=>({...e,channel:e?.channel?x(e.channel):M}),N=(e,t)=>u.callSiteAIFunction(e,F(t)),q=(e,t)=>u.invokeSiteAIFunctionStream(e,F(t)),H=(e,t)=>u.createSiteAIFunctionTask(e,F(t)),V=(e,t,n)=>u.getSiteAIFunctionTask(e,t,F(n));var Fe=new Set(["cancelled","failed","queued","running","succeeded"]);async function Te(e){let t=await N(e);return e.input&&!e.messages?k(t):t}function Ce(e){return q(e)}function a(e,t){for(let n of t){let i=e[n];if(typeof i=="string"&&i.trim())return i}}function be(e,t){for(let n of t){let i=e[n];if(typeof i=="number"&&Number.isFinite(i))return i}}function xe(e){let t=a(e,["capabilityType","capability_type","CapabilityType"]);return t==="image"||t==="video"?t:void 0}function Me(e){if(Array.isArray(e))return e.filter(C).map(t=>{let n=a(t,["size","Size"]),i=a(t,["token","Token"]),o=a(t,["url","URL"]);return{safetyStatus:a(t,["safetyStatus","safety_status","SafetyStatus"])??"",...n?{size:n}:{},...i?{token:i}:{},...o?{url:o}:{}}})}function De(e){if(!C(e))return;let t=e.durationSeconds??e.duration_seconds??e.DurationSeconds,n=a(e,["token","Token"]),i=a(e,["url","URL"]);return{...typeof t=="number"?{durationSeconds:t}:{},...n?{token:n}:{},...i?{url:i}:{}}}function T(e,t="INVALID_AI_FUNCTION_TASK"){let n=new Error(e);return n.name="SiteAIFunctionTaskError",n.code=t,n}function k(e){if(!C(e))throw T("AI Function task response has an invalid structure");let t=Pe(e);if(t)throw T(t.message,t.code);if("data"in e&&e.data!==void 0)return k(e.data);let n=a(e,["type","Type"]),i=a(e,["taskId","task_id","TaskID"]),o=e.status??e.Status;if(n!=="image_task"&&n!=="video_task"||!i||typeof o!="string"||!Fe.has(o))throw T("AI Function task response has an invalid structure");let s=Me(e.imageAssets??e.image_assets??e.ImageAssets),c=De(e.videoAsset??e.video_asset??e.VideoAsset),l=be(e,["progress","Progress"]),I=xe(e),p=a(e,["errCode","err_code","ErrCode"]),f=a(e,["errMessage","err_message","ErrMessage"]);return{...I?{capabilityType:I}:{},...p?{errCode:p}:{},...f?{errMessage:f}:{},...s?{imageAssets:s}:{},...l!==void 0?{progress:l}:{},...c?{videoAsset:c}:{},requestId:a(e,["requestId","request_id","RequestID"])??"",status:o,taskId:i,type:n}}function Pe(e){let t=e.code??e.Code;if(typeof t=="number"&&t!==0||typeof t=="string"&&t&&t!=="0")return{code:String(t),message:a(e,["msg","message","Message"])??"Failed to create the AI Function task"};let n=e.BaseResp??e.base_resp??e.baseResp;if(!C(n))return;let i=n.StatusCode??n.status_code??n.statusCode;if(typeof i=="number"&&i!==0||typeof i=="string"&&i&&i!=="0")return{code:String(i),message:a(n,["StatusMessage","status_message","statusMessage"])??"Failed to create the AI Function task"}}function Ee(e){return!!e.taskId.trim()&&(e.status==="queued"||e.status==="running")}async function we(e){return k(await H(e))}async function ve(e,t){if(!t.trim())throw T("AI Function task ID must not be empty");return k(await V(e,t))}function C(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import{Component as _e,StrictMode as Le,useEffect as Oe,useState as Be}from"react";import{createRoot as Ue}from"react-dom/client";import{Fragment as Ge,jsx as d,jsxs as Ne}from"react/jsx-runtime";var E=new WeakSet,b=class extends _e{state={failed:!1};static getDerivedStateFromError(){return{failed:!0}}componentDidCatch(t){this.props.failed(t)}render(){let t=this.props.fallback;return this.state.failed?t?d(t,{code:"APP_BOOT_FAILED"}):d("div",{role:"alert",children:"APP_BOOT_FAILED"}):this.props.children}};function Tt(e){let t,n,i=new Promise((r,g)=>{t=r,n=g});i.catch(()=>{});let o=!1,s=!1,c=!1,l,I=()=>{},p=()=>{},f=r=>{try{e.onDiagnostic?.(R(r))}catch{}},S=r=>{f(r),!(o||s||c)&&(c=!0,n(r),e.reportLifecycle!==!1&&m.reportLoadFailed("APP_BOOT_FAILED").catch(f))},A;try{A=typeof e.root=="string"?document.querySelector(e.root):e.root??document.querySelector("#root")}catch(r){return S(r),{ready:i,dispose(){o=!0}}}if(!A)return S(new Error("APP_ROOT_NOT_FOUND")),{ready:i,dispose(){o=!0}};if(E.has(A))throw new Error("APP_ALREADY_STARTED");E.add(A);let z=()=>{o||(o=!0,I(),p(),l?.unmount(),E.delete(A),U.clear(),!s&&!c&&n(new Error("APP_DISPOSED")))},K=()=>{queueMicrotask(()=>{o||c||s||(s=!0,e.reportLifecycle===!1?t():m.ready().then(t,r=>{f(r),n(r)}))})};function W({locale:r,theme:g}){let[y,h]=Be();Oe(()=>(p=m.subscribeModeChanged(h),K(),()=>p()),[]);let j=e.app,w=Ne(Ge,{children:[d(j,{}),e.platformUI===!1?null:d(G,{})]});return d(B,{runtime:m,theme:g,locale:r,mode:y,onDiagnostic:e.onDiagnostic,children:e.providers?e.providers(w):w})}try{l=Ue(A);let r=e.slots?.loading;r&&l.render(d(b,{failed:S,fallback:e.slots?.error,children:d(r,{})})),m.getRuntimeContext().then(g=>{if(o||c)return;let y=e.locale&&e.locale!=="host"?e.locale:L(g.locale,"en");document.documentElement.lang=O(y),e.linkGuard!==!1&&(I=D({onDiagnostic:e.onDiagnostic}));let h=d(b,{failed:S,fallback:e.slots?.error,children:d(W,{locale:y,theme:e.theme&&e.theme!=="host"?e.theme:g.colorScheme==="dark"?"dark":"light"})});l.render(e.strictMode===!1?h:d(Le,{children:h}))}).catch(S)}catch(r){S(r)}return{ready:i,dispose:z}}export{rt as AttachmentImage,B as BaseAppProvider,He as CAPABILITY_CATALOG,v as CapabilityUnavailableError,tt as DatabaseUserMenu,Ve as DiagnosticCode,G as FloatingButton,qe as SDKError,Q as SITE_RUNTIME_PROTOCOL_VERSION,P as SiteChatbotStreamAdapter,_t as SiteChatbotStreamError,Y as SiteRuntimeApi,te as SiteRuntimeClient,Z as SiteRuntimeErrorCode,J as SiteRuntimeEvent,X as SiteRuntimeFunction,Ye as UiLanguageContext,it as UserSelectorEditor,nt as UserSelectorPanel,he as buildAttachmentCoverUrl,ge as buildDatabaseInvokeFunctionPath,Ae as buildDatabaseInvokeGetPath,Te as callSiteAIFunction,R as classifyRuntimeError,we as createSiteAIFunctionTask,ne as createSiteRuntimeClient,de as createSiteRuntimeFetch,me as fetch,fe as fetchAttachmentCover,Se as fetchAttachmentDownloadUrl,Ke as getCapabilities,oe as getCurrentUser,le as getDatabaseContext,We as getRuntimeCapabilities,ve as getSiteAIFunctionTask,Je as getUiLanguage,O as getUiLocale,_ as hasCapability,Ee as hasRunnableMediaTask,Xe as initializeUiLanguage,D as installLinkGuard,re as invokeApi,Ie as invokeDatabaseFunction,ke as invokeDatabaseMutationBatch,ie as invokeHttp,Ce as invokeSiteAIFunctionStream,ee as isValidSiteFunctionName,ae as logout,k as normalizeSiteAIMediaTask,ye as openAttachmentDownload,ue as openLink,je as queryCapability,ze as readCapabilities,$ as readSiteAITextDelta,se as requestEdit,Qe as requireCapability,pe as resolveDatabaseContext,L as selectUiLanguage,m as siteRuntime,Tt as startBaseApp,ce as uploadAttachment,$e as useBaseApp,et as useOptionalBaseApp,Ze as useUiLanguage};

package/dist/server.cjs

@@ -0,0 +1 @@
+"use strict";var k=Object.defineProperty;var U=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var W=Object.prototype.hasOwnProperty;var J=(t,s)=>{for(var o in s)k(t,o,{get:s[o],enumerable:!0})},V=(t,s,o,e)=>{if(s&&typeof s=="object"||typeof s=="function")for(let n of L(s))!W.call(t,n)&&n!==o&&k(t,n,{get:()=>s[n],enumerable:!(e=U(s,n))||e.enumerable});return t};var z=t=>V(k({},"__esModule",{value:!0}),t);var M={};J(M,{SDKError:()=>f,bindFunctionRuntime:()=>j,createServerContext:()=>_,defineFunction:()=>K,normalizeRecordsResult:()=>x});module.exports=z(M);var F=Symbol.for("@lark-base-open/base-database-app-sdk/SDKError/v1"),f=class extends Error{constructor(o,e,n,r){super(e);this.code=o;this.name="SDKError",this.safeMessage=e;let c=typeof n=="object"?n:{};this.upstreamCode=typeof n=="string"?n:void 0,this.wireCode=Number.isSafeInteger(c.wireCode)&&c.wireCode!==0?c.wireCode:o==="SDK_TIMEOUT"?504:o==="SDK_CANCELLED"?499:o==="SDK_INPUT_INVALID"?400:500,this.retryable=c.retryable??r??!1,this.outcome=c.outcome??"failed",this.paths=c.paths??[]}[F]=!0;static[Symbol.hasInstance](o){return this!==f?Function.prototype[Symbol.hasInstance].call(this,o):o!==null&&typeof o=="object"&&o[F]===!0}wireCode;safeMessage;retryable;outcome;paths;upstreamCode};var d=t=>typeof t=="object"&&t!==null&&!Array.isArray(t),b=t=>typeof t=="string"&&/^rec[A-Za-z0-9]{1,32}$/.test(t);function S(t){let s=new Set,o=e=>{if(!(e===null||typeof e=="string"||typeof e=="boolean"||typeof e=="number"&&Number.isFinite(e))){if(typeof e!="object"||!e||s.has(e)||Array.isArray(e)&&Object.getPrototypeOf(e)!==Array.prototype||!Array.isArray(e)&&Object.getPrototypeOf(e)!==Object.prototype&&Object.getPrototypeOf(e)!==null||Array.isArray(e)&&(Object.keys(e).length!==e.length||Object.keys(e).some((n,r)=>n!==String(r))))throw 0;s.add(e);for(let n of Reflect.ownKeys(e)){if(Array.isArray(e)&&n==="length")continue;if(typeof n!="string")throw 0;let r=Object.getOwnPropertyDescriptor(e,n);if(!r.enumerable||!("value"in r))throw 0;o(r.value)}s.delete(e)}};try{o(t)}catch{throw new f("SDK_OUTPUT_NOT_JSON","\u8F93\u51FA\u5FC5\u987B\u662F\u65E0\u635F JSON \u503C")}}function O(t,s,o){return{status:"unknown",code:t,retryable:!1,...s?{requestedIds:[...s]}:{},...o?{logid:o}:{}}}var B=t=>typeof t=="number"&&[401,403,404,91403,1254302,1254043,1254044].includes(t),A=t=>({status:"failed",code:"SDK_RECORDS_REJECTED",upstreamCode:t,retryable:!1,appliedIds:[]}),D=t=>Array.isArray(t)&&t.every(b)&&new Set(t).size===t.length;function x(t,s){let o=()=>O("SDK_RECORDS_RESULT_UNKNOWN",s.requestedIds);if(d(t)&&B(t.code))return A(t.code);if(!d(t)||t.code!==0||!d(t.data))return o();let e=t.data,n=e.ignored_fields??[];if(!Array.isArray(n)||!n.every(a=>d(a)&&["id","name","reason"].every(i=>typeof a[i]=="string")))return o();let r=e.record_not_found??[];if(!D(r))return o();let c=s.requestedIds??[],u,y;if(s.operation==="appendAttachments"||s.operation==="removeAttachments"){if(!d(e.attachments))return o();try{S(e.attachments)}catch{return o()}for(let[a,i]of Object.entries(e.attachments)){if(!b(a)||!c.includes(a)||!d(i)||!Object.keys(i).length)return o();for(let[p,m]of Object.entries(i))if(!/^fld[A-Za-z0-9]+$/.test(p)||!Array.isArray(m)||!m.every(g=>d(g)&&typeof g.file_token=="string"&&g.file_token.length>0))return o()}if(u=Object.keys(e.attachments),r.some(a=>!c.includes(a)||u.includes(a))||!n.length&&c.some(a=>!u.includes(a)&&!r.includes(a)))return o();y=e.attachments}else{if(!D(e.record_id_list))return o();let a=e.record_id_list;if(s.operation==="create"){if(a.length!==s.count||Object.hasOwn(e,"record_not_found"))return o();u=a}else if(s.operation==="update"){if(a.some(i=>!c.includes(i)||r.includes(i))||r.some(i=>!c.includes(i))||a.length+r.length!==c.length)return o();u=a}else{if(a.length!==c.length||a.some((i,p)=>i!==c[p])||r.some(i=>!c.includes(i)))return o();u=a.filter(i=>!r.includes(i))}}let l=y===void 0?{}:{attachments:y};return r.length||n.length?{status:"partial",appliedIds:u,notFoundIds:r,ignoredFields:n,...l}:{status:"success",appliedIds:u,notFoundIds:[],ignoredFields:[],...l}}var E={create:"records/batch_create",update:"records/batch_update",delete:"records/batch_delete",appendAttachments:"append_attachments",removeAttachments:"remove_attachments"},I=t=>({status:"failed",code:t,retryable:!1,appliedIds:[]});function $(t){if(t?.platformEnv==="online")return t.brand==="feishu"?"https://open.feishu.cn":t.brand==="lark"?"https://open.larksuite.com":void 0;if(t?.brand==="feishu"){if(t.platformEnv==="pre")return"https://open.feishu-pre.cn";if(t.platformEnv==="boe")return"https://open.feishu-boe.cn"}}function T(t,s){let o=async(e,n,r,c)=>{if(!s)return I("SDK_RUNTIME_PROFILE_MISSING");let u=$(s);if(!u)return I("SDK_RUNTIME_PROFILE_UNSUPPORTED");if(c?.signal?.aborted)return I("SDK_CANCELLED");let y,l,a;try{if(!d(n)||typeof n.baseToken!="string"||typeof n.tableId!="string"||!/^[A-Za-z0-9]+$/.test(n.baseToken)||!/^tbl[A-Za-z0-9]+$/.test(n.tableId))throw 0;if(S(r),e==="create"){if(!Array.isArray(r)||!r.every(d))throw 0;a=r.length,y={create_records:r}}else if(e==="update"){if(!d(r)||!Object.values(r).every(d))throw 0;l=Object.keys(r),a=l.length,y={update_records:r}}else if(e==="delete"){if(!Array.isArray(r)||!r.every(b))throw 0;l=r,a=r.length,y={record_id_list:r}}else{if(!d(r))throw 0;let i=Object.create(null),p=0;for(let[m,g]of Object.entries(r)){if(!b(m)||!d(g))throw 0;for(let[C,w]of Object.entries(g)){if(!C.trim()||!Array.isArray(w))throw 0;for(let h of w){if(!d(h)||typeof h.file_token!="string"||!h.file_token.trim()||Object.keys(h).some(R=>!["file_token",...e==="appendAttachments"?["image_width","image_height"]:[]].includes(R)))throw 0;for(let R of["image_width","image_height"])if(h[R]!==void 0&&(typeof h[R]!="number"||!Number.isInteger(h[R])||h[R]<=0))throw 0}p+=w.length,w.length&&(i[m]??=Object.create(null),i[m][C]=w)}}if(p>50)throw 0;if(!p)return{status:"success",appliedIds:[],notFoundIds:[],ignoredFields:[],noop:!0};l=Object.keys(i),y={attachments:i}}if(a!==void 0&&(a<1||a>200)||l&&(!l.every(b)||new Set(l).size!==l.length))throw 0}catch{return I("SDK_RECORDS_INPUT_INVALID")}try{let i=await t.fetch(`${u}/open-apis/bitable/v1/apps/${encodeURIComponent(n.baseToken)}/tables/${encodeURIComponent(n.tableId)}/${E[e]}`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(y),signal:c?.signal}),p=i.headers.get("x-tt-logid")??void 0;if([401,403,404].includes(i.status))return A(i.status);if(!i.ok)return O("SDK_RECORDS_HTTP_ERROR",l,p);let m=x(await i.json(),{operation:e,requestedIds:l,count:a});return m.status==="unknown"&&p?{...m,logid:p}:m}catch(i){let p=i instanceof Error?i.name:"";return O(p==="AbortError"?"SDK_CANCELLED":p==="TimeoutError"?"SDK_TIMEOUT":"SDK_RECORDS_RESULT_UNKNOWN",l)}};return Object.fromEntries(Object.keys(E).map(e=>[e,(n,r,c)=>o(e,n,r,c)]))}var P=Symbol("base-database-runtime-profile");function j(t,s){let o=Object.freeze({platformEnv:s.platformEnv,brand:s.brand});return function(e,n){let r=Object.defineProperty({...n},P,{value:o});return t.call(this,e,r)}}function _(t){return{...t,records:T(t,t[P])}}async function N(t,s,o){let e;try{e=await t["~standard"].validate(s)}catch{throw new f("SDK_VALIDATOR_FAILED","Schema \u6821\u9A8C\u5668\u6267\u884C\u5931\u8D25")}if(e.issues){let n=e.issues.map(r=>(r.path??[]).map(c=>{let u=typeof c=="object"?c.key:c;return typeof u=="number"||typeof u=="string"?u:"[symbol]"}));throw new f(`SDK_${o}_INVALID`,o==="INPUT"?"\u8F93\u5165\u4E0D\u7B26\u5408\u5951\u7EA6":"\u8F93\u51FA\u4E0D\u7B26\u5408\u5951\u7EA6",{paths:n})}return e.value}function K(t){return async(s,o)=>{try{let e=await N(t.input,s,"INPUT"),n=await t.handler(e,_(o)),r=await N(t.output,n,"OUTPUT");return S(r),{code:0,msg:"success",data:r}}catch(e){let n=e instanceof f?e:new f("SDK_HANDLER_FAILED","\u51FD\u6570\u6267\u884C\u5931\u8D25");return console.error(JSON.stringify({source:"sdk",code:n.code,paths:n.paths,retryable:n.retryable,outcome:n.outcome})),{code:n.wireCode,msg:n.safeMessage}}}}0&&(module.exports={SDKError,bindFunctionRuntime,createServerContext,defineFunction,normalizeRecordsResult});

package/dist/server.d.cts

@@ -0,0 +1,79 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { JsonValue, WriteResult, FunctionEnvelope } from './shared.cjs';
+export { DiagnosticCategory, RuntimeDiagnostic, SDKError, SDKErrorOptions } from './shared.cjs';
+import '@lark-base-open/base-site-channel/capabilities';
+
+type Fields = Record<string, JsonValue>;
+type Target = {
+    baseToken: string;
+    tableId: string;
+};
+type AttachmentInput = {
+    file_token: string;
+    image_width?: number;
+    image_height?: number;
+};
+type Attachments = Record<string, Record<string, AttachmentInput[]>>;
+interface RecordsClient {
+    create<T extends Fields>(target: Target, records: readonly T[], opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+    update<T extends Fields>(target: Target, records: Readonly<Record<string, Partial<T>>>, opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+    delete(target: Target, ids: readonly string[], opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+    appendAttachments(target: Target, values: Attachments, opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+    removeAttachments(target: Target, values: Record<string, Record<string, {
+        file_token: string;
+    }[]>>, opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+}
+
+interface RawFunctionContext {
+    fetch: typeof globalThis.fetch;
+    invokeFunction(p: {
+        projectId: string;
+        functionId: string;
+        params?: unknown;
+    }): Promise<unknown>;
+}
+interface RuntimeBuildProfile {
+    platformEnv: "online" | "pre" | "boe";
+    brand: "feishu" | "lark";
+}
+interface ServerContext extends RawFunctionContext {
+    records: RecordsClient;
+}
+declare function bindFunctionRuntime<F extends (raw: unknown, ctx: RawFunctionContext) => unknown>(fn: F, profile: RuntimeBuildProfile): F;
+declare function createServerContext(raw: RawFunctionContext): ServerContext;
+
+interface DefineFunctionOptions<I extends StandardSchemaV1, O extends StandardSchemaV1> {
+    input: I;
+    output: O;
+    handler(input: StandardSchemaV1.InferOutput<I>, ctx: ServerContext): StandardSchemaV1.InferInput<O> | Promise<StandardSchemaV1.InferInput<O>>;
+}
+interface DefinedFunction<I extends StandardSchemaV1, O extends StandardSchemaV1> {
+    (rawParams: unknown, context: RawFunctionContext): Promise<FunctionEnvelope<StandardSchemaV1.InferOutput<O>>>;
+    readonly __contractTypes?: {
+        input: StandardSchemaV1.InferInput<I>;
+        output: StandardSchemaV1.InferOutput<O>;
+    };
+}
+declare function defineFunction<I extends StandardSchemaV1, O extends StandardSchemaV1>(definition: DefineFunctionOptions<I, O>): DefinedFunction<I, O>;
+
+type RecordsOperation = "create" | "update" | "delete" | "appendAttachments" | "removeAttachments";
+interface RecordsResultRequest {
+    operation: RecordsOperation;
+    requestedIds?: readonly string[];
+    count?: number;
+}
+declare function normalizeRecordsResult(body: unknown, request: RecordsResultRequest): WriteResult;
+
+type LegacyFunctionHandler<Context = unknown> = (rawParams: unknown, context: Context) => unknown | Promise<unknown>;
+
+export { AttachmentInput, Attachments, DefineFunctionOptions, DefinedFunction, Fields, FunctionEnvelope, FunctionEnvelope as FunctionResult, JsonValue, LegacyFunctionHandler, RawFunctionContext, RecordsClient, RecordsOperation, RecordsResultRequest, RuntimeBuildProfile, ServerContext, Target, WriteResult, bindFunctionRuntime, createServerContext, defineFunction, normalizeRecordsResult };

package/dist/server.d.ts

@@ -0,0 +1,79 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { JsonValue, WriteResult, FunctionEnvelope } from './shared.js';
+export { DiagnosticCategory, RuntimeDiagnostic, SDKError, SDKErrorOptions } from './shared.js';
+import '@lark-base-open/base-site-channel/capabilities';
+
+type Fields = Record<string, JsonValue>;
+type Target = {
+    baseToken: string;
+    tableId: string;
+};
+type AttachmentInput = {
+    file_token: string;
+    image_width?: number;
+    image_height?: number;
+};
+type Attachments = Record<string, Record<string, AttachmentInput[]>>;
+interface RecordsClient {
+    create<T extends Fields>(target: Target, records: readonly T[], opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+    update<T extends Fields>(target: Target, records: Readonly<Record<string, Partial<T>>>, opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+    delete(target: Target, ids: readonly string[], opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+    appendAttachments(target: Target, values: Attachments, opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+    removeAttachments(target: Target, values: Record<string, Record<string, {
+        file_token: string;
+    }[]>>, opts?: {
+        signal?: AbortSignal;
+    }): Promise<WriteResult>;
+}
+
+interface RawFunctionContext {
+    fetch: typeof globalThis.fetch;
+    invokeFunction(p: {
+        projectId: string;
+        functionId: string;
+        params?: unknown;
+    }): Promise<unknown>;
+}
+interface RuntimeBuildProfile {
+    platformEnv: "online" | "pre" | "boe";
+    brand: "feishu" | "lark";
+}
+interface ServerContext extends RawFunctionContext {
+    records: RecordsClient;
+}
+declare function bindFunctionRuntime<F extends (raw: unknown, ctx: RawFunctionContext) => unknown>(fn: F, profile: RuntimeBuildProfile): F;
+declare function createServerContext(raw: RawFunctionContext): ServerContext;
+
+interface DefineFunctionOptions<I extends StandardSchemaV1, O extends StandardSchemaV1> {
+    input: I;
+    output: O;
+    handler(input: StandardSchemaV1.InferOutput<I>, ctx: ServerContext): StandardSchemaV1.InferInput<O> | Promise<StandardSchemaV1.InferInput<O>>;
+}
+interface DefinedFunction<I extends StandardSchemaV1, O extends StandardSchemaV1> {
+    (rawParams: unknown, context: RawFunctionContext): Promise<FunctionEnvelope<StandardSchemaV1.InferOutput<O>>>;
+    readonly __contractTypes?: {
+        input: StandardSchemaV1.InferInput<I>;
+        output: StandardSchemaV1.InferOutput<O>;
+    };
+}
+declare function defineFunction<I extends StandardSchemaV1, O extends StandardSchemaV1>(definition: DefineFunctionOptions<I, O>): DefinedFunction<I, O>;
+
+type RecordsOperation = "create" | "update" | "delete" | "appendAttachments" | "removeAttachments";
+interface RecordsResultRequest {
+    operation: RecordsOperation;
+    requestedIds?: readonly string[];
+    count?: number;
+}
+declare function normalizeRecordsResult(body: unknown, request: RecordsResultRequest): WriteResult;
+
+type LegacyFunctionHandler<Context = unknown> = (rawParams: unknown, context: Context) => unknown | Promise<unknown>;
+
+export { AttachmentInput, Attachments, DefineFunctionOptions, DefinedFunction, Fields, FunctionEnvelope, FunctionEnvelope as FunctionResult, JsonValue, LegacyFunctionHandler, RawFunctionContext, RecordsClient, RecordsOperation, RecordsResultRequest, RuntimeBuildProfile, ServerContext, Target, WriteResult, bindFunctionRuntime, createServerContext, defineFunction, normalizeRecordsResult };