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

package/dist/page.d.ts

@@ -0,0 +1,137 @@
+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 { CAPABILITY_CATALOG, 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';
+
+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-HEMWSWXI.js";import{a as He,b as Ve,c as v,d as R}from"./chunk-YDAVA3BB.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,78 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { JsonValue, WriteResult, FunctionEnvelope } from './shared.cjs';
+export { DiagnosticCategory, RuntimeDiagnostic, SDKError, SDKErrorOptions } from './shared.cjs';
+
+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,78 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { JsonValue, WriteResult, FunctionEnvelope } from './shared.js';
+export { DiagnosticCategory, RuntimeDiagnostic, SDKError, SDKErrorOptions } from './shared.js';
+
+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.js

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

package/dist/shared.cjs

@@ -0,0 +1 @@
+"use strict";var p=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var m=(r,n)=>{for(var e in n)p(r,e,{get:n[e],enumerable:!0})},E=(r,n,e,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of b(n))!y.call(r,t)&&t!==e&&p(r,t,{get:()=>n[t],enumerable:!(a=c(n,t))||a.enumerable});return r};var f=r=>E(p({},"__esModule",{value:!0}),r);var I={};m(I,{CAPABILITY_CATALOG:()=>C,CapabilityUnavailableError:()=>u,DiagnosticCode:()=>o,SDKError:()=>i,classifyRuntimeError:()=>A});module.exports=f(I);var d=Symbol.for("@lark-base-open/base-database-app-sdk/SDKError/v1"),i=class extends Error{constructor(e,a,t,l){super(a);this.code=e;this.name="SDKError",this.safeMessage=a;let s=typeof t=="object"?t:{};this.upstreamCode=typeof t=="string"?t:void 0,this.wireCode=Number.isSafeInteger(s.wireCode)&&s.wireCode!==0?s.wireCode:e==="SDK_TIMEOUT"?504:e==="SDK_CANCELLED"?499:e==="SDK_INPUT_INVALID"?400:500,this.retryable=s.retryable??l??!1,this.outcome=s.outcome??"failed",this.paths=s.paths??[]}[d]=!0;static[Symbol.hasInstance](e){return this!==i?Function.prototype[Symbol.hasInstance].call(this,e):e!==null&&typeof e=="object"&&e[d]===!0}wireCode;safeMessage;retryable;outcome;paths;upstreamCode};var C={"runtime.context":{kind:"critical",hostBaseline84afb07:!0},"http.request":{kind:"critical",hostBaseline84afb07:!0},"http.binary":{kind:"critical",hostBaseline84afb07:!0},"http.cancel":{kind:"optional",hostBaseline84afb07:!0},"function.invoke":{kind:"critical",hostBaseline84afb07:!0},"runtime.user":{kind:"optional",hostBaseline84afb07:!0},"runtime.logout":{kind:"optional",hostBaseline84afb07:!0},"runtime.requestEdit":{kind:"optional",hostBaseline84afb07:!0},"attachment.upload":{kind:"critical",hostBaseline84afb07:!0},"attachment.cancel":{kind:"optional",hostBaseline84afb07:!0},"chatbot.stream":{kind:"critical",hostBaseline84afb07:!0},"ai.function.stream":{kind:"critical",hostBaseline84afb07:!0},"runtime.lifecycle":{kind:"optional",hostBaseline84afb07:!0},"runtime.mode":{kind:"optional",hostBaseline84afb07:!0},"attachment.progress":{kind:"optional",hostBaseline84afb07:!0},"link.open":{kind:"optional",hostBaseline84afb07:!0}},o={HostUnsupported:"CAPABILITY_HOST_UNSUPPORTED",PermissionDenied:"CAPABILITY_PERMISSION_DENIED",RegionUnavailable:"CAPABILITY_REGION_UNAVAILABLE",TemporarilyUnavailable:"CAPABILITY_TEMPORARILY_UNAVAILABLE",ContextInvalid:"CAPABILITY_CONTEXT_INVALID",UnavailableUnknown:"CAPABILITY_UNAVAILABLE_UNKNOWN"},u=class extends i{constructor(e,a){super(o.HostUnsupported,`\u5F53\u524D\u5BBF\u4E3B\u4E0D\u652F\u6301 ${e} v${a}`);this.capability=e;this.minimumVersion=a;this.name="CapabilityUnavailableError"}};function A(r){let n=r&&typeof r=="object"?r:{},e=typeof n.code=="string"||typeof n.code=="number"?String(n.code):"UNKNOWN",a=o.UnavailableUnknown,t="unknown";[o.HostUnsupported,"10004","PROTOCOL_MISMATCH","ATTACHMENT_UNAVAILABLE","HTTP_RESPONSE_TYPE_UNSUPPORTED"].includes(e)?(a=o.HostUnsupported,t="host-unsupported"):[o.PermissionDenied,"403","PERMISSION_DENIED","FORBIDDEN","FUNCTION_NOT_ALLOWED"].includes(e)?(a=o.PermissionDenied,t="permission-denied"):[o.RegionUnavailable,"REGION_UNAVAILABLE","REGION_NOT_SUPPORTED"].includes(e)?(a=o.RegionUnavailable,t="region-unavailable"):[o.TemporarilyUnavailable,"REQUEST_TIMEOUT","10003","10005","HTTP_REQUEST_FAILED","FUNCTION_REQUEST_FAILED","STREAM_DISCONNECTED","STREAM_HEALTH_TIMEOUT","ATTACHMENT_UPLOAD_STALLED"].includes(e)?(a=o.TemporarilyUnavailable,t="temporary"):e===o.ContextInvalid&&(a=o.ContextInvalid,t="protocol");let l={"host-unsupported":"\u5F53\u524D\u5BBF\u4E3B\u4E0D\u652F\u6301\u6B64\u80FD\u529B","permission-denied":"\u5F53\u524D\u8EAB\u4EFD\u6216\u53D1\u5E03\u6E05\u5355\u4E0D\u5141\u8BB8\u6B64\u64CD\u4F5C","region-unavailable":"\u5BBF\u4E3B\u660E\u786E\u5F53\u524D\u533A\u57DF\u4E0D\u53EF\u7528",temporary:"\u8C03\u7528\u6682\u65F6\u5931\u8D25\uFF0C\u8BF7\u6838\u5BF9\u7ED3\u679C\u540E\u51B3\u5B9A\u662F\u5426\u91CD\u8BD5",protocol:"\u5BBF\u4E3B\u80FD\u529B\u5B57\u6BB5\u65E0\u6548",unknown:"\u8C03\u7528\u5931\u8D25\uFF0C\u539F\u56E0\u672A\u660E\u786E"};return{source:"sdk",code:a,upstreamCode:n.upstreamCode??e,category:t,retryable:t==="temporary"&&n.retryable!==!1,message:l[t],redaction:"\u539F\u59CB\u9519\u8BEF\u6D88\u606F\u548C\u4E1A\u52A1\u53C2\u6570\u5DF2\u7701\u7565"}}0&&(module.exports={CAPABILITY_CATALOG,CapabilityUnavailableError,DiagnosticCode,SDKError,classifyRuntimeError});

package/dist/shared.d.cts

@@ -0,0 +1,177 @@
+interface SDKErrorOptions {
+    wireCode?: number;
+    retryable?: boolean;
+    outcome?: "failed" | "unknown";
+    paths?: readonly (readonly (string | number)[])[];
+}
+/** message 必须是开发者提供的安全文案，不能包含原始错误或参数。 */
+declare const errorBrand: unique symbol;
+declare class SDKError extends Error {
+    readonly code: string;
+    private readonly [errorBrand];
+    static [Symbol.hasInstance](value: unknown): boolean;
+    readonly wireCode: number;
+    readonly safeMessage: string;
+    readonly retryable: boolean;
+    readonly outcome: "failed" | "unknown";
+    readonly paths: readonly (readonly (string | number)[])[];
+    readonly upstreamCode?: string;
+    constructor(code: string, message: string, options?: SDKErrorOptions | string, legacyRetryable?: boolean);
+}
+
+type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+interface FunctionEnvelope<T = unknown> {
+    code: number;
+    msg: string;
+    data?: T;
+}
+type IgnoredField = {
+    id: string;
+    name: string;
+    reason: string;
+};
+type WriteResult = {
+    status: "success";
+    appliedIds: string[];
+    notFoundIds: [];
+    ignoredFields: [];
+    attachments?: JsonValue;
+    noop?: boolean;
+} | {
+    status: "partial";
+    appliedIds: string[];
+    notFoundIds: string[];
+    ignoredFields: IgnoredField[];
+    attachments?: JsonValue;
+} | {
+    status: "failed";
+    code: string;
+    upstreamCode?: number;
+    retryable: false;
+    appliedIds: [];
+} | {
+    status: "unknown";
+    code: string;
+    retryable: false;
+    requestedIds?: string[];
+    logid?: string;
+};
+
+type CapabilityDescriptor = Readonly<{
+    version: number;
+}>;
+type CapabilityMap = Readonly<Record<string, CapabilityDescriptor>>;
+type RuntimeCapabilities = CapabilityMap;
+type CapabilityUnavailableReason = "permission-denied" | "region-unavailable" | "temporarily-unavailable";
+interface CapabilityContext {
+    capabilities?: CapabilityMap;
+    capabilityUnavailable?: Readonly<Record<string, {
+        reason: CapabilityUnavailableReason;
+        retryable: boolean;
+    }>>;
+}
+declare const CAPABILITY_CATALOG: {
+    readonly "runtime.context": {
+        readonly kind: "critical";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "http.request": {
+        readonly kind: "critical";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "http.binary": {
+        readonly kind: "critical";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "http.cancel": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "function.invoke": {
+        readonly kind: "critical";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "runtime.user": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "runtime.logout": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "runtime.requestEdit": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "attachment.upload": {
+        readonly kind: "critical";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "attachment.cancel": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "chatbot.stream": {
+        readonly kind: "critical";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "ai.function.stream": {
+        readonly kind: "critical";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "runtime.lifecycle": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "runtime.mode": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "attachment.progress": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+    readonly "link.open": {
+        readonly kind: "optional";
+        readonly hostBaseline84afb07: true;
+    };
+};
+type CapabilityName = keyof typeof CAPABILITY_CATALOG;
+interface CapabilityQueryResult {
+    name: string;
+    requiredVersion: number;
+    version: number | null;
+    supported: boolean;
+    source: "advertised" | "host-baseline-84afb07";
+    availability: "available" | "unknown" | CapabilityUnavailableReason | "unsupported";
+}
+declare const DiagnosticCode: {
+    readonly HostUnsupported: "CAPABILITY_HOST_UNSUPPORTED";
+    readonly PermissionDenied: "CAPABILITY_PERMISSION_DENIED";
+    readonly RegionUnavailable: "CAPABILITY_REGION_UNAVAILABLE";
+    readonly TemporarilyUnavailable: "CAPABILITY_TEMPORARILY_UNAVAILABLE";
+    readonly ContextInvalid: "CAPABILITY_CONTEXT_INVALID";
+    readonly UnavailableUnknown: "CAPABILITY_UNAVAILABLE_UNKNOWN";
+};
+type DiagnosticCategory = "host-unsupported" | "permission-denied" | "region-unavailable" | "temporary" | "protocol" | "unknown";
+interface RuntimeDiagnostic {
+    source: "sdk";
+    code: string;
+    upstreamCode?: string;
+    category: DiagnosticCategory;
+    retryable: boolean;
+    message: string;
+    redaction: "原始错误消息和业务参数已省略";
+}
+
+declare class CapabilityUnavailableError extends SDKError {
+    readonly capability: string;
+    readonly minimumVersion: number;
+    constructor(capability: string, minimumVersion: number);
+}
+/** 不解析 message 猜测原因；可恢复不代表写入可安全重试。 */
+declare function classifyRuntimeError(error: unknown): RuntimeDiagnostic;
+
+export { CAPABILITY_CATALOG, CapabilityContext, CapabilityDescriptor, CapabilityMap, CapabilityName, CapabilityQueryResult, CapabilityUnavailableError, CapabilityUnavailableReason, DiagnosticCategory, DiagnosticCode, FunctionEnvelope, JsonValue, RuntimeCapabilities, RuntimeDiagnostic, SDKError, SDKErrorOptions, WriteResult, classifyRuntimeError };