@lark-base-open/base-database-app-sdk 0.6.0-durable.2 → 0.6.0-durable.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,24 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.6.0-durable.4] - 2026-11-08
4
+
5
+ ### Changed
6
+
7
+ - 网络异常时 DurableError.code 固定为 INFRA_UNAVAILABLE,底层错误码与原因保留在 message。
8
+
9
+ ### Removed
10
+
11
+ - 不再导出 RunStatus、Trigger、InvocationMeta、StepPolicy、Waiting 内部类型。
12
+
13
+ ## [0.6.0-durable.3] - 2026-11-08
14
+
15
+ ### Changed
16
+
17
+ - DurableError 改为 code、message、logId,保留服务端错误说明与网络原因。
18
+ - Durable events 可省略;schema 错误附前三条字段路径,脱敏保留长记录 ID。
19
+ - 导出可增强的 DurableFunctions,start 推断 input,get/signal 支持显式泛型;StepView 增加 lastError。
20
+ - 更新声明式 Trigger、环境边界与 CLI 类型生成文档。
21
+
3
22
  ## [0.6.0-durable.2] - 2026-11-05
4
23
 
5
24
  ### Added
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  用于开发以飞书多维表格为数据后端的 Base Database 应用,提供页面与服务端运行时、平台组件、版本化能力查询与测试工具。
4
4
 
5
- 安装:`npm install @lark-base-open/base-database-app-sdk@0.6.0-durable.2`。从旧版本升级前请阅读 [变更记录](CHANGELOG.md)。
5
+ 安装:`npm install @lark-base-open/base-database-app-sdk@0.6.0-durable.4`。从旧版本升级前请阅读 [变更记录](CHANGELOG.md)。
6
6
 
7
7
  运行环境需支持 ES2022;页面 API 需要 Base Database 页面宿主,服务端 API 用于 Node.js / FaaS。组件需要 React 与 React DOM 19.2,页面查询能力使用 @tanstack/react-query 5.104.1;npm 会安装声明的依赖与必需 peer。底层通信依赖 base-site-channel 0.2.1。
8
8
 
package/capabilities.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "sdkVersion": "0.6.0-durable.2",
3
+ "sdkVersion": "0.6.0-durable.4",
4
4
  "capabilities": {
5
5
  "runtime.diagnostic": {
6
6
  "required": [
package/dist/page.js CHANGED
@@ -1 +1 @@
1
- import{A as Ze,B as Se,C as fe,D as ge,E as Ae,F as Ie,G as ye,H as ke,I as Re,J as he,K as Fe,L as Te,M as $e,N as B,O as et,P as U,Q as tt,R as nt,S as N,T as ot,U as it,V as G,W as V,X as at,Y as rt,Z as st,_ as ct,a as J,b as X,c as Z,d as $,e as ee,f as te,g as ne,h as x,i as _,j as oe,k as ie,l as m,m as ae,n as re,o as se,p as ce,q as ue,r as de,s as me,t as le,u as pe,v as Ye,w as L,x as je,y as Je,z as Xe}from"./chunk-EG6R7YAD.js";import{a as We,b as Qe,c as v,d as h}from"./chunk-ZKBZAK4L.js";import{a as Ke}from"./chunk-3JX3FIBG.js";import"./chunk-OHPYKFCM.js";export*from"@lark-base-open/base-site-channel/runtime";import{installLinkGuard as De}from"@lark-base-open/base-site-channel/runtime";function P(e={}){let t=!0,n,o=s=>{let c=h(s);e.onDiagnostic?e.onDiagnostic(c):console.warn("[Base Database SDK]",c)},a=e.runtime??m;return Promise.resolve().then(()=>a.getRuntimeContext()).then(s=>{if(t){if(!L(s,"link.open")){o(new v("link.open",1));return}n=De(e)}}).catch(s=>{t&&o(s)}),()=>{t=!1,n?.()}}export*from"@lark-base-open/base-site-channel/runtime-contract";import{SiteChatbotStreamError as Vt}from"@lark-base-open/base-site-channel/runtime";import*as u from"@lark-base-open/base-site-channel/runtime";var M=class extends u.SiteChatbotStreamAdapter{constructor(t){super({...t,channel:t.channel?x(t.channel):_})}},F=e=>({...e,channel:e?.channel?x(e.channel):_}),q=(e,t)=>u.callSiteAIFunction(e,F(t)),H=(e,t)=>u.invokeSiteAIFunctionStream(e,F(t)),z=(e,t)=>u.createSiteAIFunctionTask(e,F(t)),K=(e,t,n)=>u.getSiteAIFunctionTask(e,t,F(n));var be=new Set(["cancelled","failed","queued","running","succeeded"]);async function Ce(e){let t=await q(e);return e.input&&!e.messages?y(t):t}function xe(e){return H(e)}function r(e,t){for(let n of t){let o=e[n];if(typeof o=="string"&&o.trim())return o}}function _e(e,t){for(let n of t){let o=e[n];if(typeof o=="number"&&Number.isFinite(o))return o}}function Pe(e){let t=r(e,["capabilityType","capability_type","CapabilityType"]);return t==="image"||t==="video"?t:void 0}function Me(e){if(Array.isArray(e))return e.filter(D).map(t=>{let n=r(t,["size","Size"]),o=r(t,["token","Token"]),a=r(t,["url","URL"]);return{safetyStatus:r(t,["safetyStatus","safety_status","SafetyStatus"])??"",...n?{size:n}:{},...o?{token:o}:{},...a?{url:a}:{}}})}function Ee(e){if(!D(e))return;let t=e.durationSeconds??e.duration_seconds??e.DurationSeconds,n=r(e,["token","Token"]),o=r(e,["url","URL"]);return{...typeof t=="number"?{durationSeconds:t}:{},...n?{token:n}:{},...o?{url:o}:{}}}function T(e,t="INVALID_AI_FUNCTION_TASK"){let n=new Error(e);return n.name="SiteAIFunctionTaskError",n.code=t,n}function y(e){if(!D(e))throw T("AI Function task response has an invalid structure");let t=Oe(e);if(t)throw T(t.message,t.code);if("data"in e&&e.data!==void 0)return y(e.data);let n=r(e,["type","Type"]),o=r(e,["taskId","task_id","TaskID"]),a=e.status??e.Status;if(n!=="image_task"&&n!=="video_task"||!o||typeof a!="string"||!be.has(a))throw T("AI Function task response has an invalid structure");let s=Me(e.imageAssets??e.image_assets??e.ImageAssets),c=Ee(e.videoAsset??e.video_asset??e.VideoAsset),l=_e(e,["progress","Progress"]),A=Pe(e),I=r(e,["errCode","err_code","ErrCode"]),S=r(e,["errMessage","err_message","ErrMessage"]);return{...A?{capabilityType:A}:{},...I?{errCode:I}:{},...S?{errMessage:S}:{},...s?{imageAssets:s}:{},...l!==void 0?{progress:l}:{},...c?{videoAsset:c}:{},requestId:r(e,["requestId","request_id","RequestID"])??"",status:a,taskId:o,type:n}}function Oe(e){let t=e.code??e.Code;if(typeof t=="number"&&t!==0||typeof t=="string"&&t&&t!=="0")return{code:String(t),message:r(e,["msg","message","Message"])??"Failed to create the AI Function task"};let n=e.BaseResp??e.base_resp??e.baseResp;if(!D(n))return;let o=n.StatusCode??n.status_code??n.statusCode;if(typeof o=="number"&&o!==0||typeof o=="string"&&o&&o!=="0")return{code:String(o),message:r(n,["StatusMessage","status_message","statusMessage"])??"Failed to create the AI Function task"}}function we(e){return!!e.taskId.trim()&&(e.status==="queued"||e.status==="running")}async function ve(e){return y(await z(e))}async function Le(e,t){if(!t.trim())throw T("AI Function task ID must not be empty");return y(await K(e,t))}function D(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import{Component as Ue,StrictMode as Ne,useEffect as Ge,useState as Ve}from"react";import{createRoot as qe}from"react-dom/client";import{installRouteSync as Be}from"@lark-base-open/base-site-channel/runtime";function E(e={}){return Be({...e,onDiagnostic:t=>{let n={source:"sdk",code:t.code,category:t.code==="PATH_ROUTING_UNSUPPORTED"?"protocol":"unknown",retryable:t.code==="ROUTE_SYNC_UNAVAILABLE",message:t.message,redaction:"\u539F\u59CB\u9519\u8BEF\u6D88\u606F\u548C\u4E1A\u52A1\u53C2\u6570\u5DF2\u7701\u7565"};e.onDiagnostic?e.onDiagnostic(n):console.warn("[Base Database SDK]",n.message)}})}import{Fragment as He,jsx as d,jsxs as ze}from"react/jsx-runtime";var O=new WeakSet,b=class extends Ue{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 Mt(e){let t,n,o=new Promise((i,p)=>{t=i,n=p});o.catch(()=>{});let a=!1,s=!1,c=!1,l,A=()=>{},I=()=>{},S=()=>{},C=i=>{try{e.onDiagnostic?.(h(i))}catch{}},f=i=>{C(i),!(a||s||c)&&(c=!0,n(i),e.reportLifecycle!==!1&&m.reportLoadFailed("APP_BOOT_FAILED",{appSdk:"0.6.0-durable.2"}).catch(C))},g;try{g=typeof e.root=="string"?document.querySelector(e.root):e.root??document.querySelector("#root")}catch(i){return f(i),{ready:o,dispose(){a=!0}}}if(!g)return f(new Error("APP_ROOT_NOT_FOUND")),{ready:o,dispose(){a=!0}};if(O.has(g))throw new Error("APP_ALREADY_STARTED");O.add(g);let W=()=>{a||(a=!0,A(),I(),S(),l?.unmount(),O.delete(g),G.clear(),!s&&!c&&n(new Error("APP_DISPOSED")))},Q=()=>{queueMicrotask(()=>{a||c||s||(s=!0,e.reportLifecycle===!1?t():m.ready({appSdk:"0.6.0-durable.2"}).then(t,i=>{C(i),n(i)}))})};function Y({locale:i,theme:p}){let[k,R]=Ve();Ge(()=>(S=m.subscribeModeChanged(R),Q(),()=>S()),[]);let j=e.app,w=ze(He,{children:[d(j,{}),e.platformUI===!1?null:d(V,{})]});return d(N,{runtime:m,theme:p,styleScope:e.styleScope,locale:i,mode:k,onDiagnostic:e.onDiagnostic,children:e.providers?e.providers(w):w})}try{l=qe(g);let i=e.slots?.loading;i&&l.render(d(b,{failed:f,fallback:e.slots?.error,children:d(i,{})})),m.getRuntimeContext().then(p=>{if(a||c)return;let k=e.locale&&e.locale!=="host"?e.locale:B(p.locale,"en");document.documentElement.lang=U(k),e.linkGuard!==!1&&(A=P({onDiagnostic:e.onDiagnostic})),e.routeSync!==!1&&(I=E({context:p,onDiagnostic:e.onDiagnostic}));let R=d(b,{failed:f,fallback:e.slots?.error,children:d(Y,{locale:k,theme:e.theme&&e.theme!=="host"?e.theme:p.colorScheme==="dark"?"dark":"light"})});l.render(e.strictMode===!1?R:d(Ne,{children:R}))}).catch(f)}catch(i){f(i)}return{ready:o,dispose:W}}export{ct as AttachmentImage,N as BaseAppProvider,We as CAPABILITY_CATALOG,v as CapabilityUnavailableError,ke as DataNotReadyError,at as DatabaseUserMenu,Qe as DiagnosticCode,V as FloatingButton,Ke as SDKError,J as SITE_RUNTIME_PROTOCOL_VERSION,M as SiteChatbotStreamAdapter,Vt as SiteChatbotStreamError,X as SiteRuntimeApi,oe as SiteRuntimeClient,ee as SiteRuntimeErrorCode,Z as SiteRuntimeEvent,$ as SiteRuntimeFunction,$e as UiLanguageContext,st as UserSelectorEditor,rt as UserSelectorPanel,Te as buildAttachmentCoverUrl,ye as buildDatabaseInvokeFunctionPath,Ie as buildDatabaseInvokeGetPath,Ce as callSiteAIFunction,h as classifyRuntimeError,ve as createSiteAIFunctionTask,ie as createSiteRuntimeClient,le as createSiteRuntimeFetch,pe as fetch,ge as fetchAttachmentCover,Ae as fetchAttachmentDownloadUrl,je as getCapabilities,se as getCurrentUser,Se as getDatabaseContext,Je as getRuntimeCapabilities,Le as getSiteAIFunctionTask,et as getUiLanguage,U as getUiLocale,L as hasCapability,we as hasRunnableMediaTask,tt as initializeUiLanguage,P as installLinkGuard,E as installRouteSync,re as invokeApi,Re as invokeDatabaseFunction,he as invokeDatabaseMutationBatch,ae as invokeHttp,xe as invokeSiteAIFunctionStream,ne as isValidSiteFunctionName,ce as logout,y as normalizeSiteAIMediaTask,Fe as openAttachmentDownload,me as openLink,Xe as queryCapability,Ye as readCapabilities,te as readSiteAITextDelta,ue as requestEdit,Ze as requireCapability,fe as resolveDatabaseContext,B as selectUiLanguage,m as siteRuntime,Mt as startBaseApp,de as uploadAttachment,ot as useBaseApp,it as useOptionalBaseApp,nt as useUiLanguage};
1
+ import{A as Ze,B as Se,C as fe,D as ge,E as Ae,F as Ie,G as ye,H as ke,I as Re,J as he,K as Fe,L as Te,M as $e,N as B,O as et,P as U,Q as tt,R as nt,S as N,T as ot,U as it,V as G,W as V,X as at,Y as rt,Z as st,_ as ct,a as J,b as X,c as Z,d as $,e as ee,f as te,g as ne,h as x,i as _,j as oe,k as ie,l as m,m as ae,n as re,o as se,p as ce,q as ue,r as de,s as me,t as le,u as pe,v as Ye,w as L,x as je,y as Je,z as Xe}from"./chunk-EG6R7YAD.js";import{a as We,b as Qe,c as v,d as h}from"./chunk-ZKBZAK4L.js";import{a as Ke}from"./chunk-3JX3FIBG.js";import"./chunk-OHPYKFCM.js";export*from"@lark-base-open/base-site-channel/runtime";import{installLinkGuard as De}from"@lark-base-open/base-site-channel/runtime";function P(e={}){let t=!0,n,o=s=>{let c=h(s);e.onDiagnostic?e.onDiagnostic(c):console.warn("[Base Database SDK]",c)},a=e.runtime??m;return Promise.resolve().then(()=>a.getRuntimeContext()).then(s=>{if(t){if(!L(s,"link.open")){o(new v("link.open",1));return}n=De(e)}}).catch(s=>{t&&o(s)}),()=>{t=!1,n?.()}}export*from"@lark-base-open/base-site-channel/runtime-contract";import{SiteChatbotStreamError as Vt}from"@lark-base-open/base-site-channel/runtime";import*as u from"@lark-base-open/base-site-channel/runtime";var M=class extends u.SiteChatbotStreamAdapter{constructor(t){super({...t,channel:t.channel?x(t.channel):_})}},F=e=>({...e,channel:e?.channel?x(e.channel):_}),q=(e,t)=>u.callSiteAIFunction(e,F(t)),H=(e,t)=>u.invokeSiteAIFunctionStream(e,F(t)),z=(e,t)=>u.createSiteAIFunctionTask(e,F(t)),K=(e,t,n)=>u.getSiteAIFunctionTask(e,t,F(n));var be=new Set(["cancelled","failed","queued","running","succeeded"]);async function Ce(e){let t=await q(e);return e.input&&!e.messages?y(t):t}function xe(e){return H(e)}function r(e,t){for(let n of t){let o=e[n];if(typeof o=="string"&&o.trim())return o}}function _e(e,t){for(let n of t){let o=e[n];if(typeof o=="number"&&Number.isFinite(o))return o}}function Pe(e){let t=r(e,["capabilityType","capability_type","CapabilityType"]);return t==="image"||t==="video"?t:void 0}function Me(e){if(Array.isArray(e))return e.filter(D).map(t=>{let n=r(t,["size","Size"]),o=r(t,["token","Token"]),a=r(t,["url","URL"]);return{safetyStatus:r(t,["safetyStatus","safety_status","SafetyStatus"])??"",...n?{size:n}:{},...o?{token:o}:{},...a?{url:a}:{}}})}function Ee(e){if(!D(e))return;let t=e.durationSeconds??e.duration_seconds??e.DurationSeconds,n=r(e,["token","Token"]),o=r(e,["url","URL"]);return{...typeof t=="number"?{durationSeconds:t}:{},...n?{token:n}:{},...o?{url:o}:{}}}function T(e,t="INVALID_AI_FUNCTION_TASK"){let n=new Error(e);return n.name="SiteAIFunctionTaskError",n.code=t,n}function y(e){if(!D(e))throw T("AI Function task response has an invalid structure");let t=Oe(e);if(t)throw T(t.message,t.code);if("data"in e&&e.data!==void 0)return y(e.data);let n=r(e,["type","Type"]),o=r(e,["taskId","task_id","TaskID"]),a=e.status??e.Status;if(n!=="image_task"&&n!=="video_task"||!o||typeof a!="string"||!be.has(a))throw T("AI Function task response has an invalid structure");let s=Me(e.imageAssets??e.image_assets??e.ImageAssets),c=Ee(e.videoAsset??e.video_asset??e.VideoAsset),l=_e(e,["progress","Progress"]),A=Pe(e),I=r(e,["errCode","err_code","ErrCode"]),S=r(e,["errMessage","err_message","ErrMessage"]);return{...A?{capabilityType:A}:{},...I?{errCode:I}:{},...S?{errMessage:S}:{},...s?{imageAssets:s}:{},...l!==void 0?{progress:l}:{},...c?{videoAsset:c}:{},requestId:r(e,["requestId","request_id","RequestID"])??"",status:a,taskId:o,type:n}}function Oe(e){let t=e.code??e.Code;if(typeof t=="number"&&t!==0||typeof t=="string"&&t&&t!=="0")return{code:String(t),message:r(e,["msg","message","Message"])??"Failed to create the AI Function task"};let n=e.BaseResp??e.base_resp??e.baseResp;if(!D(n))return;let o=n.StatusCode??n.status_code??n.statusCode;if(typeof o=="number"&&o!==0||typeof o=="string"&&o&&o!=="0")return{code:String(o),message:r(n,["StatusMessage","status_message","statusMessage"])??"Failed to create the AI Function task"}}function we(e){return!!e.taskId.trim()&&(e.status==="queued"||e.status==="running")}async function ve(e){return y(await z(e))}async function Le(e,t){if(!t.trim())throw T("AI Function task ID must not be empty");return y(await K(e,t))}function D(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import{Component as Ue,StrictMode as Ne,useEffect as Ge,useState as Ve}from"react";import{createRoot as qe}from"react-dom/client";import{installRouteSync as Be}from"@lark-base-open/base-site-channel/runtime";function E(e={}){return Be({...e,onDiagnostic:t=>{let n={source:"sdk",code:t.code,category:t.code==="PATH_ROUTING_UNSUPPORTED"?"protocol":"unknown",retryable:t.code==="ROUTE_SYNC_UNAVAILABLE",message:t.message,redaction:"\u539F\u59CB\u9519\u8BEF\u6D88\u606F\u548C\u4E1A\u52A1\u53C2\u6570\u5DF2\u7701\u7565"};e.onDiagnostic?e.onDiagnostic(n):console.warn("[Base Database SDK]",n.message)}})}import{Fragment as He,jsx as d,jsxs as ze}from"react/jsx-runtime";var O=new WeakSet,b=class extends Ue{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 Mt(e){let t,n,o=new Promise((i,p)=>{t=i,n=p});o.catch(()=>{});let a=!1,s=!1,c=!1,l,A=()=>{},I=()=>{},S=()=>{},C=i=>{try{e.onDiagnostic?.(h(i))}catch{}},f=i=>{C(i),!(a||s||c)&&(c=!0,n(i),e.reportLifecycle!==!1&&m.reportLoadFailed("APP_BOOT_FAILED",{appSdk:"0.6.0-durable.4"}).catch(C))},g;try{g=typeof e.root=="string"?document.querySelector(e.root):e.root??document.querySelector("#root")}catch(i){return f(i),{ready:o,dispose(){a=!0}}}if(!g)return f(new Error("APP_ROOT_NOT_FOUND")),{ready:o,dispose(){a=!0}};if(O.has(g))throw new Error("APP_ALREADY_STARTED");O.add(g);let W=()=>{a||(a=!0,A(),I(),S(),l?.unmount(),O.delete(g),G.clear(),!s&&!c&&n(new Error("APP_DISPOSED")))},Q=()=>{queueMicrotask(()=>{a||c||s||(s=!0,e.reportLifecycle===!1?t():m.ready({appSdk:"0.6.0-durable.4"}).then(t,i=>{C(i),n(i)}))})};function Y({locale:i,theme:p}){let[k,R]=Ve();Ge(()=>(S=m.subscribeModeChanged(R),Q(),()=>S()),[]);let j=e.app,w=ze(He,{children:[d(j,{}),e.platformUI===!1?null:d(V,{})]});return d(N,{runtime:m,theme:p,styleScope:e.styleScope,locale:i,mode:k,onDiagnostic:e.onDiagnostic,children:e.providers?e.providers(w):w})}try{l=qe(g);let i=e.slots?.loading;i&&l.render(d(b,{failed:f,fallback:e.slots?.error,children:d(i,{})})),m.getRuntimeContext().then(p=>{if(a||c)return;let k=e.locale&&e.locale!=="host"?e.locale:B(p.locale,"en");document.documentElement.lang=U(k),e.linkGuard!==!1&&(A=P({onDiagnostic:e.onDiagnostic})),e.routeSync!==!1&&(I=E({context:p,onDiagnostic:e.onDiagnostic}));let R=d(b,{failed:f,fallback:e.slots?.error,children:d(Y,{locale:k,theme:e.theme&&e.theme!=="host"?e.theme:p.colorScheme==="dark"?"dark":"light"})});l.render(e.strictMode===!1?R:d(Ne,{children:R}))}).catch(f)}catch(i){f(i)}return{ready:o,dispose:W}}export{ct as AttachmentImage,N as BaseAppProvider,We as CAPABILITY_CATALOG,v as CapabilityUnavailableError,ke as DataNotReadyError,at as DatabaseUserMenu,Qe as DiagnosticCode,V as FloatingButton,Ke as SDKError,J as SITE_RUNTIME_PROTOCOL_VERSION,M as SiteChatbotStreamAdapter,Vt as SiteChatbotStreamError,X as SiteRuntimeApi,oe as SiteRuntimeClient,ee as SiteRuntimeErrorCode,Z as SiteRuntimeEvent,$ as SiteRuntimeFunction,$e as UiLanguageContext,st as UserSelectorEditor,rt as UserSelectorPanel,Te as buildAttachmentCoverUrl,ye as buildDatabaseInvokeFunctionPath,Ie as buildDatabaseInvokeGetPath,Ce as callSiteAIFunction,h as classifyRuntimeError,ve as createSiteAIFunctionTask,ie as createSiteRuntimeClient,le as createSiteRuntimeFetch,pe as fetch,ge as fetchAttachmentCover,Ae as fetchAttachmentDownloadUrl,je as getCapabilities,se as getCurrentUser,Se as getDatabaseContext,Je as getRuntimeCapabilities,Le as getSiteAIFunctionTask,et as getUiLanguage,U as getUiLocale,L as hasCapability,we as hasRunnableMediaTask,tt as initializeUiLanguage,P as installLinkGuard,E as installRouteSync,re as invokeApi,Re as invokeDatabaseFunction,he as invokeDatabaseMutationBatch,ae as invokeHttp,xe as invokeSiteAIFunctionStream,ne as isValidSiteFunctionName,ce as logout,y as normalizeSiteAIMediaTask,Fe as openAttachmentDownload,me as openLink,Xe as queryCapability,Ye as readCapabilities,te as readSiteAITextDelta,ue as requestEdit,Ze as requireCapability,fe as resolveDatabaseContext,B as selectUiLanguage,m as siteRuntime,Mt as startBaseApp,de as uploadAttachment,ot as useBaseApp,it as useOptionalBaseApp,nt as useUiLanguage};
package/dist/server.cjs CHANGED
@@ -1 +1 @@
1
- "use strict";var W=Object.defineProperty;var pe=Object.getOwnPropertyDescriptor;var de=Object.getOwnPropertyNames;var fe=Object.prototype.hasOwnProperty;var me=(e,n)=>{for(var r in n)W(e,r,{get:n[r],enumerable:!0})},ge=(e,n,r,t)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of de(n))!fe.call(e,o)&&o!==r&&W(e,o,{get:()=>n[o],enumerable:!(t=pe(n,o))||t.enumerable});return e};var ye=e=>ge(W({},"__esModule",{value:!0}),e);var De={};me(De,{DurableError:()=>E,NonRetryableError:()=>N,SDKError:()=>R,StepFailedError:()=>P,bindFunctionRuntime:()=>ee,createServerContext:()=>C,defineDurableFunction:()=>ae,defineFunction:()=>re,durable:()=>ue,normalizeRecordsResult:()=>V});module.exports=ye(De);var G=Symbol.for("@lark-base-open/base-database-app-sdk/SDKError/v1"),R=class extends Error{constructor(r,t,o,s){super(t);this.code=r;this.name="SDKError",this.safeMessage=t;let c=typeof o=="object"?o:{};this.upstreamCode=typeof o=="string"?o:void 0,this.wireCode=Number.isSafeInteger(c.wireCode)&&c.wireCode!==0?c.wireCode:r==="SDK_TIMEOUT"?504:r==="SDK_CANCELLED"?499:r==="SDK_INPUT_INVALID"?400:500,this.retryable=c.retryable??s??!1,this.outcome=c.outcome??"failed",this.paths=c.paths??[]}[G]=!0;static[Symbol.hasInstance](r){return this!==R?Function.prototype[Symbol.hasInstance].call(this,r):r!==null&&typeof r=="object"&&r[G]===!0}wireCode;safeMessage;retryable;outcome;paths;upstreamCode};var x=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),_=e=>typeof e=="string"&&/^rec[A-Za-z0-9]{1,32}$/.test(e);function k(e){let n=new Set,r=t=>{if(!(t===null||typeof t=="string"||typeof t=="boolean"||typeof t=="number"&&Number.isFinite(t))){if(typeof t!="object"||!t||n.has(t)||Array.isArray(t)&&Object.getPrototypeOf(t)!==Array.prototype||!Array.isArray(t)&&Object.getPrototypeOf(t)!==Object.prototype&&Object.getPrototypeOf(t)!==null||Array.isArray(t)&&(Object.keys(t).length!==t.length||Object.keys(t).some((o,s)=>o!==String(s))))throw 0;n.add(t);for(let o of Reflect.ownKeys(t)){if(Array.isArray(t)&&o==="length")continue;if(typeof o!="string")throw 0;let s=Object.getOwnPropertyDescriptor(t,o);if(!s.enumerable||!("value"in s))throw 0;r(s.value)}n.delete(t)}};try{r(e)}catch{throw new R("SDK_OUTPUT_NOT_JSON","\u8F93\u51FA\u5FC5\u987B\u662F\u65E0\u635F JSON \u503C")}}function M(e,n,r){return{status:"unknown",code:e,retryable:!1,...n?{requestedIds:[...n]}:{},...r?{logid:r}:{}}}var be=e=>typeof e=="number"&&[401,403,404,91403,1254302,1254043,1254044].includes(e),z=e=>({status:"failed",code:"SDK_RECORDS_REJECTED",upstreamCode:e,retryable:!1,appliedIds:[]}),Z=e=>Array.isArray(e)&&e.every(_)&&new Set(e).size===e.length;function V(e,n){let r=()=>M("SDK_RECORDS_RESULT_UNKNOWN",n.requestedIds);if(x(e)&&be(e.code))return z(e.code);if(!x(e)||e.code!==0||!x(e.data))return r();let t=e.data,o=t.ignored_fields??[];if(!Array.isArray(o)||!o.every(a=>x(a)&&["id","name","reason"].every(u=>typeof a[u]=="string")))return r();let s=t.record_not_found??[];if(!Z(s))return r();let c=n.requestedIds??[],d,w;if(n.operation==="appendAttachments"||n.operation==="removeAttachments"){if(!x(t.attachments))return r();try{k(t.attachments)}catch{return r()}for(let[a,u]of Object.entries(t.attachments)){if(!_(a)||!c.includes(a)||!x(u)||!Object.keys(u).length)return r();for(let[m,g]of Object.entries(u))if(!/^fld[A-Za-z0-9]+$/.test(m)||!Array.isArray(g)||!g.every(S=>x(S)&&typeof S.file_token=="string"&&S.file_token.length>0))return r()}if(d=Object.keys(t.attachments),s.some(a=>!c.includes(a)||d.includes(a))||!o.length&&c.some(a=>!d.includes(a)&&!s.includes(a)))return r();w=t.attachments}else{if(!Z(t.record_id_list))return r();let a=t.record_id_list;if(n.operation==="create"){if(a.length!==n.count||Object.hasOwn(t,"record_not_found"))return r();d=a}else if(n.operation==="update"){if(a.some(u=>!c.includes(u)||s.includes(u))||s.some(u=>!c.includes(u))||a.length+s.length!==c.length)return r();d=a}else{if(a.length!==c.length||a.some((u,m)=>u!==c[m])||s.some(u=>!c.includes(u)))return r();d=a.filter(u=>!s.includes(u))}}let p=w===void 0?{}:{attachments:w};return s.length||o.length?{status:"partial",appliedIds:d,notFoundIds:s,ignoredFields:o,...p}:{status:"success",appliedIds:d,notFoundIds:[],ignoredFields:[],...p}}var Y={create:"records/batch_create",update:"records/batch_update",delete:"records/batch_delete",appendAttachments:"append_attachments",removeAttachments:"remove_attachments"},K=e=>({status:"failed",code:e,retryable:!1,appliedIds:[]});function xe(e){if(e?.platformEnv==="online")return e.brand==="feishu"?"https://open.feishu.cn":e.brand==="lark"?"https://open.larksuite.com":void 0;if(e?.brand==="feishu"){if(e.platformEnv==="pre")return"https://open.feishu-pre.cn";if(e.platformEnv==="boe")return"https://open.feishu-boe.cn"}}function X(e,n){let r=async(t,o,s,c)=>{if(!n)return K("SDK_RUNTIME_PROFILE_MISSING");let d=xe(n);if(!d)return K("SDK_RUNTIME_PROFILE_UNSUPPORTED");if(c?.signal?.aborted)return K("SDK_CANCELLED");let w,p,a;try{if(!x(o)||typeof o.baseToken!="string"||typeof o.tableId!="string"||!/^[A-Za-z0-9]+$/.test(o.baseToken)||!/^tbl[A-Za-z0-9]+$/.test(o.tableId))throw 0;if(k(s),t==="create"){if(!Array.isArray(s)||!s.every(x))throw 0;a=s.length,w={create_records:s}}else if(t==="update"){if(!x(s)||!Object.values(s).every(x))throw 0;p=Object.keys(s),a=p.length,w={update_records:s}}else if(t==="delete"){if(!Array.isArray(s)||!s.every(_))throw 0;p=s,a=s.length,w={record_id_list:s}}else{if(!x(s))throw 0;let u=Object.create(null),m=0;for(let[g,S]of Object.entries(s)){if(!_(g)||!x(S))throw 0;for(let[I,f]of Object.entries(S)){if(!I.trim()||!Array.isArray(f))throw 0;for(let h of f){if(!x(h)||typeof h.file_token!="string"||!h.file_token.trim()||Object.keys(h).some(D=>!["file_token",...t==="appendAttachments"?["image_width","image_height"]:[]].includes(D)))throw 0;for(let D of["image_width","image_height"])if(h[D]!==void 0&&(typeof h[D]!="number"||!Number.isInteger(h[D])||h[D]<=0))throw 0}m+=f.length,f.length&&(u[g]??=Object.create(null),u[g][I]=f)}}if(m>50)throw 0;if(!m)return{status:"success",appliedIds:[],notFoundIds:[],ignoredFields:[],noop:!0};p=Object.keys(u),w={attachments:u}}if(a!==void 0&&(a<1||a>200)||p&&(!p.every(_)||new Set(p).size!==p.length))throw 0}catch{return K("SDK_RECORDS_INPUT_INVALID")}try{let u=await e.fetch(`${d}/open-apis/bitable/v1/apps/${encodeURIComponent(o.baseToken)}/tables/${encodeURIComponent(o.tableId)}/${Y[t]}`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(w),signal:c?.signal}),m=u.headers.get("x-tt-logid")??void 0;if([401,403,404].includes(u.status))return z(u.status);if(!u.ok)return M("SDK_RECORDS_HTTP_ERROR",p,m);let g=V(await u.json(),{operation:t,requestedIds:p,count:a});return g.status==="unknown"&&m?{...g,logid:m}:g}catch(u){let m=u instanceof Error?u.name:"";return M(m==="AbortError"?"SDK_CANCELLED":m==="TimeoutError"?"SDK_TIMEOUT":"SDK_RECORDS_RESULT_UNKNOWN",p)}};return Object.fromEntries(Object.keys(Y).map(t=>[t,(o,s,c)=>r(t,o,s,c)]))}var Q=Symbol("base-database-runtime-profile");function ee(e,n){let r=Object.freeze({platformEnv:n.platformEnv,brand:n.brand});return function(t,o){let s=Object.defineProperty({...o},Q,{value:r});return e.call(this,t,s)}}function C(e){return{...e,records:X(e,e[Q])}}async function te(e,n,r){let t;try{t=await e["~standard"].validate(n)}catch{throw new R("SDK_VALIDATOR_FAILED","Schema \u6821\u9A8C\u5668\u6267\u884C\u5931\u8D25")}if(t.issues){let o=t.issues.map(s=>(s.path??[]).map(c=>{let d=typeof c=="object"?c.key:c;return typeof d=="number"||typeof d=="string"?d:"[symbol]"}));throw new R(`SDK_${r}_INVALID`,r==="INPUT"?"\u8F93\u5165\u4E0D\u7B26\u5408\u5951\u7EA6":"\u8F93\u51FA\u4E0D\u7B26\u5408\u5951\u7EA6",{paths:o})}return t.value}function re(e){return async(n,r)=>{try{let t=await te(e.input,n,"INPUT"),o=await e.handler(t,C(r)),s=await te(e.output,o,"OUTPUT");return k(s),{code:0,msg:"success",data:s}}catch(t){let o=t instanceof R?t:new R("SDK_HANDLER_FAILED","\u51FD\u6570\u6267\u884C\u5931\u8D25");console.error(JSON.stringify({source:"sdk",code:o.code,paths:o.paths,retryable:o.retryable,outcome:o.outcome}));let s={code:o.wireCode,msg:o.safeMessage};return t instanceof R||Object.defineProperty(s,Symbol.for("base-site.function-error"),{value:t}),s}}}var ne="base-site.durable",oe="base-site.runtime";var E=class extends Error{constructor(r,t=r){super(t);this.reason=r;this.name="DurableError"}},N=class extends Error{constructor(n){super(n),this.name="NonRetryableError"}},P=class extends Error{constructor(r,t){super(t.message);this.key=r;this.error=t;this.name="StepFailedError"}};function j(e,n,r){let t="Unknown error",o="Error";try{e instanceof Error?(typeof e.message=="string"&&(t=e.message),typeof e.name=="string"&&(o=e.name)):typeof e=="string"&&(t=e)}catch{}t=t.slice(0,1024*4).replace(/([?&][^=&#\s]*?(?:token|ticket|code|secret|key|password|authorization)[^=&#\s]*=)[^&#\s]*/gi,"$1[REDACTED]").replace(/\bBearer\s+[^\s"'<>]+/gi,"Bearer [REDACTED]").replace(/[A-Za-z0-9_]{32,}/g,"[REDACTED]");let s="",c=0;for(let d of t){if(c+=new TextEncoder().encode(d).length,c>1024)break;s+=d}return{name:o,message:s,...n?{code:n}:{},...r?{key:r}:{},...e instanceof N?{retryable:!1}:{}}}function q(e){let n={ms:1,s:1e3,m:6e4,h:36e5,d:864e5},r=typeof e=="string"&&/^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/.exec(e),t=typeof e=="number"?e:r?Number(r[1])*n[r[2]]:NaN;if(!Number.isSafeInteger(t)||t<0)throw new Error("Invalid duration");return t}function $(e){return k(e),e}function H(e){return new TextEncoder().encode(JSON.stringify(e)).length}var T=()=>new Promise(()=>{});function ae(e){let n={v:1,async execute(r,t){try{return await Ee(e,r,t)}catch(o){return{v:1,seq:r?.invocation?.seq??0,op:"fail",error:j(o,"HANDLER_ERROR")}}}};return{[Symbol.for(ne)]:n}}function Ee(e,n,r){return new Promise(t=>{let o={v:1,seq:n.invocation.seq},s=new Set,c=new Map(n.steps.map(i=>[i.key,i])),d,w=!1,p=!1,a,u,m,g,S=Math.min(r.deadline,n.invocation.deadline),I=i=>{p||((!a||i.op==="fail")&&(a=i),queueMicrotask(()=>{p||!a||(p=!0,clearTimeout(D),clearTimeout(m),r.signal.removeEventListener("abort",h),u?.abort(),t({...a,...d!==void 0?{progress:d}:{}}))}))},f=(i,y,l=new Error(i))=>I({...o,op:"fail",error:j(l,i,y)}),h=()=>g?g():f("REPLAY_TIMEOUT"),D=setTimeout(h,Math.max(0,S-Date.now())),J=(i,y)=>{if(p||a?.op==="fail")return;if(Date.now()>=S){h();return}if(typeof i!="string"||i.length<1||i.length>128||/[\x00-\x1f\x7f-\x9f]/.test(i)){f("DEFINITION_INVALID",void 0,new Error("Invalid step key"));return}if(s.has(i)){f("DUPLICATE_STEP_KEY",i);return}s.add(i);let l=c.get(i);if(l){if(l.kind!==y){f("DEFINITION_KIND_MISMATCH",i);return}if(!l.ok)throw new P(i,l.error);return{fresh:!1,value:y==="sleep"?void 0:l.timedOut?null:l.value}}if(w){f("PARALLEL_STEPS",i);return}if(c.size>=100){f("STEP_LIMIT",i);return}return w=!0,{fresh:!0}},ce={async run(i,y,l={}){let b=J(i,"run");if(!b)return T();if(!b.fresh)return b.value;let O,U=l.retries??3;try{if(O=l.timeout===void 0?S-Date.now():Math.min(q(l.timeout),S-Date.now()),!Number.isSafeInteger(U)||U<0||O<=0)throw new Error("Invalid step options")}catch(A){return f("DEFINITION_INVALID",i,A),T()}u=new AbortController;let le=u.signal,v=Date.now(),B=(A,L)=>I({...o,op:"step",key:i,ok:!1,error:j(A,L,i),policy:{retries:U},durationMs:Math.max(0,Date.now()-v)});return g=()=>{B(new Error("Step exceeded its deadline"),"STEP_TIMEOUT"),u?.abort()},m=setTimeout(g,O),Promise.resolve().then(async()=>{if(!(a||p))try{let A=await y({signal:le,attempt:n.invocation.attempt});if(Date.now()>=v+O){g?.();return}let L=$(A===void 0?null:A);if(H(L)>262144){B(new N("Step result exceeds 256KB"),"STEP_RESULT_TOO_LARGE");return}I({...o,op:"step",key:i,ok:!0,value:L,durationMs:Math.max(0,Date.now()-v)})}catch(A){Date.now()>=v+O?g?.():B(A)}}),T()},async sleep(i,y){let l=J(i,"sleep");if(!l)return T();if(l.fresh){try{let b=q(y);if(b<1e3||b>2592e6)throw new Error("Sleep duration must be between 1s and 30d");I({...o,op:"sleep",key:i,durationMs:b})}catch(b){f("DEFINITION_INVALID",i,b)}return T()}},async waitForEvent(i,y,l){if(!Object.hasOwn(e.events,y))return f("EVENT_UNDECLARED",i),T();let b=J(i,"wait");if(!b)return T();if(!b.fresh)return b.value;try{let O=q(l.timeout);if(O<1e3||O>2592e6)throw new Error("Event timeout must be between 1s and 30d");I({...o,op:"wait",key:i,event:y,timeoutMs:O})}catch(O){f("DEFINITION_INVALID",i,O)}return T()},progress(i){if(!p)try{let y=$(i);H(y)<=4096?d=JSON.parse(JSON.stringify(y)):console.warn("Durable progress exceeds 4KB; discarded")}catch{f("DEFINITION_INVALID",void 0,new Error("Progress must be JSON"))}}};if(r.signal.addEventListener("abort",h,{once:!0}),r.signal.aborted||S<=Date.now()){h();return}Promise.resolve().then(async()=>{try{let i;try{let l=await e.input["~standard"].validate(n.input);if(l.issues)throw new Error("Input schema validation failed");i=l.value}catch(l){f("INPUT_INVALID",void 0,l);return}if(p||a)return;if(Date.now()>=S){f("REPLAY_TIMEOUT");return}let y=await e.handler(i,ce,C(r.ctx));if(w||p||a)return;try{let l=await e.output["~standard"].validate(y);if(l.issues)throw new Error("Output schema validation failed");if(Date.now()>=S){f("REPLAY_TIMEOUT");return}let b=$(l.value);if(H(b)>262144)throw new Error("Output exceeds 256KB");I({...o,op:"done",output:b})}catch(l){f("OUTPUT_INVALID",void 0,l)}}catch(i){f("HANDLER_ERROR",i instanceof P?i.key:void 0,i)}})})}async function F(e){let n=globalThis[Symbol.for(oe)],r=n?.v===1?n.context.getStore()?.ctx:void 0;if(!r?.faasInvoke)throw new E("DURABLE_NO_CONTEXT");try{let t=await r.faasInvoke({method:"durable",params:JSON.stringify(e)});if(!t||t.code!==0)throw new E(t?.data?.reason??"INFRA_UNAVAILABLE");return t.data}catch(t){throw t instanceof E?t:new E("INFRA_UNAVAILABLE")}}var ue={start(e,n,r){return F({...r,action:"start",functionId:e,input:n})},get(e,n){return F({...n,action:"get",runId:e})},list(e){return F({...e,action:"list"})},cancel(e,n){return F({...n,action:"cancel",runId:e})},signal(e,n,r,t){return F({...t,action:"signal",runId:e,event:n,data:r})}};0&&(module.exports={DurableError,NonRetryableError,SDKError,StepFailedError,bindFunctionRuntime,createServerContext,defineDurableFunction,defineFunction,durable,normalizeRecordsResult});
1
+ "use strict";var W=Object.defineProperty;var pe=Object.getOwnPropertyDescriptor;var fe=Object.getOwnPropertyNames;var me=Object.prototype.hasOwnProperty;var ge=(e,o)=>{for(var n in o)W(e,n,{get:o[n],enumerable:!0})},ye=(e,o,n,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of fe(o))!me.call(e,r)&&r!==n&&W(e,r,{get:()=>o[r],enumerable:!(t=pe(o,r))||t.enumerable});return e};var be=e=>ye(W({},"__esModule",{value:!0}),e);var Fe={};ge(Fe,{DurableError:()=>E,NonRetryableError:()=>k,SDKError:()=>R,StepFailedError:()=>N,bindFunctionRuntime:()=>ee,createServerContext:()=>_,defineDurableFunction:()=>ue,defineFunction:()=>ne,durable:()=>ce,normalizeRecordsResult:()=>M});module.exports=be(Fe);var G=Symbol.for("@lark-base-open/base-database-app-sdk/SDKError/v1"),R=class extends Error{constructor(n,t,r,s){super(t);this.code=n;this.name="SDKError",this.safeMessage=t;let c=typeof r=="object"?r:{};this.upstreamCode=typeof r=="string"?r:void 0,this.wireCode=Number.isSafeInteger(c.wireCode)&&c.wireCode!==0?c.wireCode:n==="SDK_TIMEOUT"?504:n==="SDK_CANCELLED"?499:n==="SDK_INPUT_INVALID"?400:500,this.retryable=c.retryable??s??!1,this.outcome=c.outcome??"failed",this.paths=c.paths??[]}[G]=!0;static[Symbol.hasInstance](n){return this!==R?Function.prototype[Symbol.hasInstance].call(this,n):n!==null&&typeof n=="object"&&n[G]===!0}wireCode;safeMessage;retryable;outcome;paths;upstreamCode};var x=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),P=e=>typeof e=="string"&&/^rec[A-Za-z0-9]{1,32}$/.test(e);function T(e){let o=new Set,n=t=>{if(!(t===null||typeof t=="string"||typeof t=="boolean"||typeof t=="number"&&Number.isFinite(t))){if(typeof t!="object"||!t||o.has(t)||Array.isArray(t)&&Object.getPrototypeOf(t)!==Array.prototype||!Array.isArray(t)&&Object.getPrototypeOf(t)!==Object.prototype&&Object.getPrototypeOf(t)!==null||Array.isArray(t)&&(Object.keys(t).length!==t.length||Object.keys(t).some((r,s)=>r!==String(s))))throw 0;o.add(t);for(let r of Reflect.ownKeys(t)){if(Array.isArray(t)&&r==="length")continue;if(typeof r!="string")throw 0;let s=Object.getOwnPropertyDescriptor(t,r);if(!s.enumerable||!("value"in s))throw 0;n(s.value)}o.delete(t)}};try{n(e)}catch{throw new R("SDK_OUTPUT_NOT_JSON","\u8F93\u51FA\u5FC5\u987B\u662F\u65E0\u635F JSON \u503C")}}function V(e,o,n){return{status:"unknown",code:e,retryable:!1,...o?{requestedIds:[...o]}:{},...n?{logid:n}:{}}}var xe=e=>typeof e=="number"&&[401,403,404,91403,1254302,1254043,1254044].includes(e),$=e=>({status:"failed",code:"SDK_RECORDS_REJECTED",upstreamCode:e,retryable:!1,appliedIds:[]}),Y=e=>Array.isArray(e)&&e.every(P)&&new Set(e).size===e.length;function M(e,o){let n=()=>V("SDK_RECORDS_RESULT_UNKNOWN",o.requestedIds);if(x(e)&&xe(e.code))return $(e.code);if(!x(e)||e.code!==0||!x(e.data))return n();let t=e.data,r=t.ignored_fields??[];if(!Array.isArray(r)||!r.every(a=>x(a)&&["id","name","reason"].every(u=>typeof a[u]=="string")))return n();let s=t.record_not_found??[];if(!Y(s))return n();let c=o.requestedIds??[],d,I;if(o.operation==="appendAttachments"||o.operation==="removeAttachments"){if(!x(t.attachments))return n();try{T(t.attachments)}catch{return n()}for(let[a,u]of Object.entries(t.attachments)){if(!P(a)||!c.includes(a)||!x(u)||!Object.keys(u).length)return n();for(let[m,g]of Object.entries(u))if(!/^fld[A-Za-z0-9]+$/.test(m)||!Array.isArray(g)||!g.every(S=>x(S)&&typeof S.file_token=="string"&&S.file_token.length>0))return n()}if(d=Object.keys(t.attachments),s.some(a=>!c.includes(a)||d.includes(a))||!r.length&&c.some(a=>!d.includes(a)&&!s.includes(a)))return n();I=t.attachments}else{if(!Y(t.record_id_list))return n();let a=t.record_id_list;if(o.operation==="create"){if(a.length!==o.count||Object.hasOwn(t,"record_not_found"))return n();d=a}else if(o.operation==="update"){if(a.some(u=>!c.includes(u)||s.includes(u))||s.some(u=>!c.includes(u))||a.length+s.length!==c.length)return n();d=a}else{if(a.length!==c.length||a.some((u,m)=>u!==c[m])||s.some(u=>!c.includes(u)))return n();d=a.filter(u=>!s.includes(u))}}let p=I===void 0?{}:{attachments:I};return s.length||r.length?{status:"partial",appliedIds:d,notFoundIds:s,ignoredFields:r,...p}:{status:"success",appliedIds:d,notFoundIds:[],ignoredFields:[],...p}}var Z={create:"records/batch_create",update:"records/batch_update",delete:"records/batch_delete",appendAttachments:"append_attachments",removeAttachments:"remove_attachments"},j=e=>({status:"failed",code:e,retryable:!1,appliedIds:[]});function Se(e){if(e?.platformEnv==="online")return e.brand==="feishu"?"https://open.feishu.cn":e.brand==="lark"?"https://open.larksuite.com":void 0;if(e?.brand==="feishu"){if(e.platformEnv==="pre")return"https://open.feishu-pre.cn";if(e.platformEnv==="boe")return"https://open.feishu-boe.cn"}}function X(e,o){let n=async(t,r,s,c)=>{if(!o)return j("SDK_RUNTIME_PROFILE_MISSING");let d=Se(o);if(!d)return j("SDK_RUNTIME_PROFILE_UNSUPPORTED");if(c?.signal?.aborted)return j("SDK_CANCELLED");let I,p,a;try{if(!x(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(T(s),t==="create"){if(!Array.isArray(s)||!s.every(x))throw 0;a=s.length,I={create_records:s}}else if(t==="update"){if(!x(s)||!Object.values(s).every(x))throw 0;p=Object.keys(s),a=p.length,I={update_records:s}}else if(t==="delete"){if(!Array.isArray(s)||!s.every(P))throw 0;p=s,a=s.length,I={record_id_list:s}}else{if(!x(s))throw 0;let u=Object.create(null),m=0;for(let[g,S]of Object.entries(s)){if(!P(g)||!x(S))throw 0;for(let[w,f]of Object.entries(S)){if(!w.trim()||!Array.isArray(f))throw 0;for(let h of f){if(!x(h)||typeof h.file_token!="string"||!h.file_token.trim()||Object.keys(h).some(D=>!["file_token",...t==="appendAttachments"?["image_width","image_height"]:[]].includes(D)))throw 0;for(let D of["image_width","image_height"])if(h[D]!==void 0&&(typeof h[D]!="number"||!Number.isInteger(h[D])||h[D]<=0))throw 0}m+=f.length,f.length&&(u[g]??=Object.create(null),u[g][w]=f)}}if(m>50)throw 0;if(!m)return{status:"success",appliedIds:[],notFoundIds:[],ignoredFields:[],noop:!0};p=Object.keys(u),I={attachments:u}}if(a!==void 0&&(a<1||a>200)||p&&(!p.every(P)||new Set(p).size!==p.length))throw 0}catch{return j("SDK_RECORDS_INPUT_INVALID")}try{let u=await e.fetch(`${d}/open-apis/bitable/v1/apps/${encodeURIComponent(r.baseToken)}/tables/${encodeURIComponent(r.tableId)}/${Z[t]}`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(I),signal:c?.signal}),m=u.headers.get("x-tt-logid")??void 0;if([401,403,404].includes(u.status))return $(u.status);if(!u.ok)return V("SDK_RECORDS_HTTP_ERROR",p,m);let g=M(await u.json(),{operation:t,requestedIds:p,count:a});return g.status==="unknown"&&m?{...g,logid:m}:g}catch(u){let m=u instanceof Error?u.name:"";return V(m==="AbortError"?"SDK_CANCELLED":m==="TimeoutError"?"SDK_TIMEOUT":"SDK_RECORDS_RESULT_UNKNOWN",p)}};return Object.fromEntries(Object.keys(Z).map(t=>[t,(r,s,c)=>n(t,r,s,c)]))}var Q=Symbol("base-database-runtime-profile");function ee(e,o){let n=Object.freeze({platformEnv:o.platformEnv,brand:o.brand});return function(t,r){let s=Object.defineProperty({...r},Q,{value:n});return e.call(this,t,s)}}function _(e){return{...e,records:X(e,e[Q])}}async function te(e,o,n){let t;try{t=await e["~standard"].validate(o)}catch{throw new R("SDK_VALIDATOR_FAILED","Schema \u6821\u9A8C\u5668\u6267\u884C\u5931\u8D25")}if(t.issues){let r=t.issues.map(s=>(s.path??[]).map(c=>{let d=typeof c=="object"?c.key:c;return typeof d=="number"||typeof d=="string"?d:"[symbol]"}));throw new R(`SDK_${n}_INVALID`,n==="INPUT"?"\u8F93\u5165\u4E0D\u7B26\u5408\u5951\u7EA6":"\u8F93\u51FA\u4E0D\u7B26\u5408\u5951\u7EA6",{paths:r})}return t.value}function ne(e){return async(o,n)=>{try{let t=await te(e.input,o,"INPUT"),r=await e.handler(t,_(n)),s=await te(e.output,r,"OUTPUT");return T(s),{code:0,msg:"success",data:s}}catch(t){let r=t instanceof R?t:new R("SDK_HANDLER_FAILED","\u51FD\u6570\u6267\u884C\u5931\u8D25");console.error(JSON.stringify({source:"sdk",code:r.code,paths:r.paths,retryable:r.retryable,outcome:r.outcome}));let s={code:r.wireCode,msg:r.safeMessage};return t instanceof R||Object.defineProperty(s,Symbol.for("base-site.function-error"),{value:t}),s}}}var re="base-site.durable",oe="base-site.runtime";var E=class extends Error{constructor(n,t=n,r,s){super(t,s);this.code=n;this.logId=r;this.name="DurableError"}},k=class extends Error{constructor(o){super(o),this.name="NonRetryableError"}},N=class extends Error{constructor(n,t){super(t.message);this.key=n;this.error=t;this.name="StepFailedError"}};function J(e,o,n){let t="Unknown error",r="Error";try{e instanceof Error?(typeof e.message=="string"&&(t=e.message),typeof e.name=="string"&&(r=e.name)):typeof e=="string"&&(t=e)}catch{}t=t.slice(0,1024*4).replace(/([?&][^=&#\s]*?(?:token|ticket|code|secret|key|password|authorization)[^=&#\s]*=)[^&#\s]*/gi,"$1[REDACTED]").replace(/\bBearer\s+[^\s"'<>]+/gi,"Bearer [REDACTED]");let s="",c=0;for(let d of t){if(c+=new TextEncoder().encode(d).length,c>1024)break;s+=d}return{name:r,message:s,...o?{code:o}:{},...n?{key:n}:{},...e instanceof k?{retryable:!1}:{}}}function ae(e,o){return`${e} schema validation failed: `+o.slice(0,3).map(n=>`${n.path?.map(r=>String(typeof r=="object"?r.key:r)).join(".")||"$"}: ${n.message}`).join("; ")}function z(e){let o={ms:1,s:1e3,m:6e4,h:36e5,d:864e5},n=typeof e=="string"&&/^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/.exec(e),t=typeof e=="number"?e:n?Number(n[1])*o[n[2]]:NaN;if(!Number.isSafeInteger(t)||t<0)throw new Error("Invalid duration");return t}function q(e){return T(e),e}function H(e){return new TextEncoder().encode(JSON.stringify(e)).length}var A=()=>new Promise(()=>{});function ue(e){let o={v:1,async execute(n,t){try{return await De(e,n,t)}catch(r){return{v:1,seq:n?.invocation?.seq??0,op:"fail",error:J(r,"HANDLER_ERROR")}}}};return{[Symbol.for(re)]:o}}function De(e,o,n){return new Promise(t=>{let r={v:1,seq:o.invocation.seq},s=new Set,c=new Map(o.steps.map(i=>[i.key,i])),d,I=!1,p=!1,a,u,m,g,S=Math.min(n.deadline,o.invocation.deadline),w=i=>{p||((!a||i.op==="fail")&&(a=i),queueMicrotask(()=>{p||!a||(p=!0,clearTimeout(D),clearTimeout(m),n.signal.removeEventListener("abort",h),u?.abort(),t({...a,...d!==void 0?{progress:d}:{}}))}))},f=(i,y,l=new Error(i))=>w({...r,op:"fail",error:J(l,i,y)}),h=()=>g?g():f("REPLAY_TIMEOUT"),D=setTimeout(h,Math.max(0,S-Date.now())),K=(i,y)=>{if(p||a?.op==="fail")return;if(Date.now()>=S){h();return}if(typeof i!="string"||i.length<1||i.length>128||/[\x00-\x1f\x7f-\x9f]/.test(i)){f("DEFINITION_INVALID",void 0,new Error("Invalid step key"));return}if(s.has(i)){f("DUPLICATE_STEP_KEY",i);return}s.add(i);let l=c.get(i);if(l){if(l.kind!==y){f("DEFINITION_KIND_MISMATCH",i);return}if(!l.ok)throw new N(i,l.error);return{fresh:!1,value:y==="sleep"?void 0:l.timedOut?null:l.value}}if(I){f("PARALLEL_STEPS",i);return}if(c.size>=100){f("STEP_LIMIT",i);return}return I=!0,{fresh:!0}},le={async run(i,y,l={}){let b=K(i,"run");if(!b)return A();if(!b.fresh)return b.value;let O,U=l.retries??3;try{if(O=l.timeout===void 0?S-Date.now():Math.min(z(l.timeout),S-Date.now()),!Number.isSafeInteger(U)||U<0||O<=0)throw new Error("Invalid step options")}catch(F){return f("DEFINITION_INVALID",i,F),A()}u=new AbortController;let de=u.signal,v=Date.now(),B=(F,L)=>w({...r,op:"step",key:i,ok:!1,error:J(F,L,i),policy:{retries:U},durationMs:Math.max(0,Date.now()-v)});return g=()=>{B(new Error("Step exceeded its deadline"),"STEP_TIMEOUT"),u?.abort()},m=setTimeout(g,O),Promise.resolve().then(async()=>{if(!(a||p))try{let F=await y({signal:de,attempt:o.invocation.attempt});if(Date.now()>=v+O){g?.();return}let L=q(F===void 0?null:F);if(H(L)>262144){B(new k("Step result exceeds 256KB"),"STEP_RESULT_TOO_LARGE");return}w({...r,op:"step",key:i,ok:!0,value:L,durationMs:Math.max(0,Date.now()-v)})}catch(F){Date.now()>=v+O?g?.():B(F)}}),A()},async sleep(i,y){let l=K(i,"sleep");if(!l)return A();if(l.fresh){try{let b=z(y);if(b<1e3||b>2592e6)throw new Error("Sleep duration must be between 1s and 30d");w({...r,op:"sleep",key:i,durationMs:b})}catch(b){f("DEFINITION_INVALID",i,b)}return A()}},async waitForEvent(i,y,l){if(!Object.hasOwn(e.events??{},y))return f("EVENT_UNDECLARED",i),A();let b=K(i,"wait");if(!b)return A();if(!b.fresh)return b.value;try{let O=z(l.timeout);if(O<1e3||O>2592e6)throw new Error("Event timeout must be between 1s and 30d");w({...r,op:"wait",key:i,event:y,timeoutMs:O})}catch(O){f("DEFINITION_INVALID",i,O)}return A()},progress(i){if(!p)try{let y=q(i);H(y)<=4096?d=JSON.parse(JSON.stringify(y)):console.warn("Durable progress exceeds 4KB; discarded")}catch{f("DEFINITION_INVALID",void 0,new Error("Progress must be JSON"))}}};if(n.signal.addEventListener("abort",h,{once:!0}),n.signal.aborted||S<=Date.now()){h();return}Promise.resolve().then(async()=>{try{let i;try{let l=await e.input["~standard"].validate(o.input);if(l.issues)throw new Error(ae("Input",l.issues));i=l.value}catch(l){f("INPUT_INVALID",void 0,l);return}if(p||a)return;if(Date.now()>=S){f("REPLAY_TIMEOUT");return}let y=await e.handler(i,le,_(n.ctx));if(I||p||a)return;try{let l=await e.output["~standard"].validate(y);if(l.issues)throw new Error(ae("Output",l.issues));if(Date.now()>=S){f("REPLAY_TIMEOUT");return}let b=q(l.value);if(H(b)>262144)throw new Error("Output exceeds 256KB");w({...r,op:"done",output:b})}catch(l){f("OUTPUT_INVALID",void 0,l)}}catch(i){f("HANDLER_ERROR",i instanceof N?i.key:void 0,i)}})})}async function C(e){let o=globalThis[Symbol.for(oe)],n=o?.v===1?o.context.getStore()?.ctx:void 0;if(!n?.faasInvoke)throw new E("DURABLE_NO_CONTEXT");try{let t=await n.faasInvoke({method:"durable",params:JSON.stringify(e)});if(!t||t.code!==0)throw new E(t?.data?.reason??"INFRA_UNAVAILABLE",t?.msg,t?.data?.logId);return t.data}catch(t){if(t instanceof E)throw t;let r=t,c=[r?.code??r?.cause?.code,r?.message,r?.cause?.message].filter(d=>d!=null&&d!=="").join(": ")||(typeof t=="string"?t:"INFRA_UNAVAILABLE");throw new E("INFRA_UNAVAILABLE",c,r?.logId,{cause:t})}}var ce={start(e,o,n){return C({...n,action:"start",functionId:e,input:o})},get(e,o){return C({...o,action:"get",runId:e})},list(e){return C({...e,action:"list"})},cancel(e,o){return C({...o,action:"cancel",runId:e})},signal(e,o,n,t){return C({...t,action:"signal",runId:e,event:o,data:n})}};0&&(module.exports={DurableError,NonRetryableError,SDKError,StepFailedError,bindFunctionRuntime,createServerContext,defineDurableFunction,defineFunction,durable,normalizeRecordsResult});
package/dist/server.d.cts CHANGED
@@ -107,6 +107,7 @@ interface StepView {
107
107
  attempts: number;
108
108
  startedAt: number;
109
109
  endedAt?: number;
110
+ lastError?: OpError;
110
111
  }
111
112
  interface RunSummary {
112
113
  runId: string;
@@ -172,32 +173,52 @@ interface DurableStep<E extends Record<string, StandardSchemaV1>> {
172
173
  }): Promise<StandardSchemaV1.InferOutput<E[K]> | null>;
173
174
  progress(value: JSONValue): void;
174
175
  }
175
- interface DefineDurableFunctionOptions<I extends StandardSchemaV1, O extends StandardSchemaV1, E extends Record<string, StandardSchemaV1>> {
176
+ interface DefineDurableFunctionOptions<I extends StandardSchemaV1, O extends StandardSchemaV1, E extends Record<string, StandardSchemaV1> = {}> {
176
177
  input: I;
177
178
  output: O;
178
- events: E;
179
+ events?: E;
179
180
  handler(input: StandardSchemaV1.InferOutput<I>, step: DurableStep<E>, ctx: ServerContext): StandardSchemaV1.InferInput<O> | Promise<StandardSchemaV1.InferInput<O>>;
180
181
  }
181
182
  interface DefinedDurableFunction {
182
183
  readonly [key: symbol]: unknown;
183
184
  }
184
- declare function defineDurableFunction<I extends StandardSchemaV1, O extends StandardSchemaV1, E extends Record<string, StandardSchemaV1>>(definition: DefineDurableFunctionOptions<I, O, E>): DefinedDurableFunction;
185
+ declare function defineDurableFunction<I extends StandardSchemaV1, O extends StandardSchemaV1, E extends Record<string, StandardSchemaV1> = {}>(definition: DefineDurableFunctionOptions<I, O, E>): DefinedDurableFunction;
185
186
 
187
+ type FunctionId = keyof DurableFunctions extends never ? string : keyof DurableFunctions & string;
188
+ type Contract<F extends FunctionId> = F extends keyof DurableFunctions ? DurableFunctions[F] : {
189
+ input: JSONValue;
190
+ output: JSONValue;
191
+ events: Record<string, JSONValue>;
192
+ };
193
+ type Input<F extends FunctionId> = Contract<F> extends {
194
+ input: infer I;
195
+ } ? I : never;
196
+ type Output<F extends FunctionId> = Contract<F> extends {
197
+ output: infer O;
198
+ } ? O : never;
199
+ type Events<F extends FunctionId> = Contract<F> extends {
200
+ events: infer E;
201
+ } ? E : never;
202
+ type TypedRun<F extends FunctionId> = Omit<Run, 'input' | 'output'> & {
203
+ input?: Input<F>;
204
+ output: Output<F> | null;
205
+ };
186
206
  declare const durable: {
187
- start(functionId: string, input: JSONValue, options?: {
207
+ start<F extends FunctionId>(functionId: F, input: Input<F>, options?: {
188
208
  idempotencyKey?: string;
189
209
  }): Promise<StartResponse>;
190
- get(runId: string, options?: Pick<GetParams, "scope">): Promise<Run>;
210
+ get<F extends FunctionId>(runId: string, options?: Pick<GetParams, "scope">): Promise<TypedRun<F>>;
191
211
  list(options?: Omit<ListParams, "action">): Promise<ListResponse>;
192
212
  cancel(runId: string, options?: Pick<GetParams, "scope">): Promise<CancelResponse>;
193
- signal(runId: string, event: string, data: JSONValue, options: {
213
+ signal<F extends FunctionId, E extends keyof Events<F> & string>(runId: string, event: E, data: Events<F>[E], options: {
194
214
  eventId: string;
195
215
  }): Promise<SignalResponse>;
196
216
  };
197
217
 
198
218
  declare class DurableError extends Error {
199
- readonly reason: string;
200
- constructor(reason: string, message?: string);
219
+ readonly code: string;
220
+ readonly logId?: string | undefined;
221
+ constructor(code: string, message?: string, logId?: string | undefined, options?: ErrorOptions);
201
222
  }
202
223
  declare class NonRetryableError extends Error {
203
224
  constructor(message: string);
@@ -210,4 +231,8 @@ declare class StepFailedError extends Error {
210
231
 
211
232
  type LegacyFunctionHandler<Context = unknown> = (rawParams: unknown, context: Context) => unknown | Promise<unknown>;
212
233
 
213
- export { AttachmentInput, Attachments, DefineDurableFunctionOptions, DefineFunctionOptions, DefinedDurableFunction, DefinedFunction, DurableError, DurableStep, Duration, Fields, FunctionEnvelope, FunctionEnvelope as FunctionResult, JsonValue, LegacyFunctionHandler, NonRetryableError, RawFunctionContext, RecordsClient, RecordsOperation, RecordsResultRequest, RuntimeBuildProfile, ServerContext, StepExecutionContext, StepFailedError, StepRunOptions, Target, WriteResult, bindFunctionRuntime, createServerContext, defineDurableFunction, defineFunction, durable, normalizeRecordsResult };
234
+ /** CLI contracts generate augments this registry with { input; output; events } per function. */
235
+ interface DurableFunctions {
236
+ }
237
+
238
+ export { AttachmentInput, Attachments, DefineDurableFunctionOptions, DefineFunctionOptions, DefinedDurableFunction, DefinedFunction, DurableError, DurableFunctions, DurableStep, Duration, Fields, FunctionEnvelope, FunctionEnvelope as FunctionResult, JsonValue, LegacyFunctionHandler, NonRetryableError, RawFunctionContext, RecordsClient, RecordsOperation, RecordsResultRequest, RuntimeBuildProfile, ServerContext, StepExecutionContext, StepFailedError, StepRunOptions, Target, WriteResult, bindFunctionRuntime, createServerContext, defineDurableFunction, defineFunction, durable, normalizeRecordsResult };
package/dist/server.d.ts CHANGED
@@ -107,6 +107,7 @@ interface StepView {
107
107
  attempts: number;
108
108
  startedAt: number;
109
109
  endedAt?: number;
110
+ lastError?: OpError;
110
111
  }
111
112
  interface RunSummary {
112
113
  runId: string;
@@ -172,32 +173,52 @@ interface DurableStep<E extends Record<string, StandardSchemaV1>> {
172
173
  }): Promise<StandardSchemaV1.InferOutput<E[K]> | null>;
173
174
  progress(value: JSONValue): void;
174
175
  }
175
- interface DefineDurableFunctionOptions<I extends StandardSchemaV1, O extends StandardSchemaV1, E extends Record<string, StandardSchemaV1>> {
176
+ interface DefineDurableFunctionOptions<I extends StandardSchemaV1, O extends StandardSchemaV1, E extends Record<string, StandardSchemaV1> = {}> {
176
177
  input: I;
177
178
  output: O;
178
- events: E;
179
+ events?: E;
179
180
  handler(input: StandardSchemaV1.InferOutput<I>, step: DurableStep<E>, ctx: ServerContext): StandardSchemaV1.InferInput<O> | Promise<StandardSchemaV1.InferInput<O>>;
180
181
  }
181
182
  interface DefinedDurableFunction {
182
183
  readonly [key: symbol]: unknown;
183
184
  }
184
- declare function defineDurableFunction<I extends StandardSchemaV1, O extends StandardSchemaV1, E extends Record<string, StandardSchemaV1>>(definition: DefineDurableFunctionOptions<I, O, E>): DefinedDurableFunction;
185
+ declare function defineDurableFunction<I extends StandardSchemaV1, O extends StandardSchemaV1, E extends Record<string, StandardSchemaV1> = {}>(definition: DefineDurableFunctionOptions<I, O, E>): DefinedDurableFunction;
185
186
 
187
+ type FunctionId = keyof DurableFunctions extends never ? string : keyof DurableFunctions & string;
188
+ type Contract<F extends FunctionId> = F extends keyof DurableFunctions ? DurableFunctions[F] : {
189
+ input: JSONValue;
190
+ output: JSONValue;
191
+ events: Record<string, JSONValue>;
192
+ };
193
+ type Input<F extends FunctionId> = Contract<F> extends {
194
+ input: infer I;
195
+ } ? I : never;
196
+ type Output<F extends FunctionId> = Contract<F> extends {
197
+ output: infer O;
198
+ } ? O : never;
199
+ type Events<F extends FunctionId> = Contract<F> extends {
200
+ events: infer E;
201
+ } ? E : never;
202
+ type TypedRun<F extends FunctionId> = Omit<Run, 'input' | 'output'> & {
203
+ input?: Input<F>;
204
+ output: Output<F> | null;
205
+ };
186
206
  declare const durable: {
187
- start(functionId: string, input: JSONValue, options?: {
207
+ start<F extends FunctionId>(functionId: F, input: Input<F>, options?: {
188
208
  idempotencyKey?: string;
189
209
  }): Promise<StartResponse>;
190
- get(runId: string, options?: Pick<GetParams, "scope">): Promise<Run>;
210
+ get<F extends FunctionId>(runId: string, options?: Pick<GetParams, "scope">): Promise<TypedRun<F>>;
191
211
  list(options?: Omit<ListParams, "action">): Promise<ListResponse>;
192
212
  cancel(runId: string, options?: Pick<GetParams, "scope">): Promise<CancelResponse>;
193
- signal(runId: string, event: string, data: JSONValue, options: {
213
+ signal<F extends FunctionId, E extends keyof Events<F> & string>(runId: string, event: E, data: Events<F>[E], options: {
194
214
  eventId: string;
195
215
  }): Promise<SignalResponse>;
196
216
  };
197
217
 
198
218
  declare class DurableError extends Error {
199
- readonly reason: string;
200
- constructor(reason: string, message?: string);
219
+ readonly code: string;
220
+ readonly logId?: string | undefined;
221
+ constructor(code: string, message?: string, logId?: string | undefined, options?: ErrorOptions);
201
222
  }
202
223
  declare class NonRetryableError extends Error {
203
224
  constructor(message: string);
@@ -210,4 +231,8 @@ declare class StepFailedError extends Error {
210
231
 
211
232
  type LegacyFunctionHandler<Context = unknown> = (rawParams: unknown, context: Context) => unknown | Promise<unknown>;
212
233
 
213
- export { AttachmentInput, Attachments, DefineDurableFunctionOptions, DefineFunctionOptions, DefinedDurableFunction, DefinedFunction, DurableError, DurableStep, Duration, Fields, FunctionEnvelope, FunctionEnvelope as FunctionResult, JsonValue, LegacyFunctionHandler, NonRetryableError, RawFunctionContext, RecordsClient, RecordsOperation, RecordsResultRequest, RuntimeBuildProfile, ServerContext, StepExecutionContext, StepFailedError, StepRunOptions, Target, WriteResult, bindFunctionRuntime, createServerContext, defineDurableFunction, defineFunction, durable, normalizeRecordsResult };
234
+ /** CLI contracts generate augments this registry with { input; output; events } per function. */
235
+ interface DurableFunctions {
236
+ }
237
+
238
+ export { AttachmentInput, Attachments, DefineDurableFunctionOptions, DefineFunctionOptions, DefinedDurableFunction, DefinedFunction, DurableError, DurableFunctions, DurableStep, Duration, Fields, FunctionEnvelope, FunctionEnvelope as FunctionResult, JsonValue, LegacyFunctionHandler, NonRetryableError, RawFunctionContext, RecordsClient, RecordsOperation, RecordsResultRequest, RuntimeBuildProfile, ServerContext, StepExecutionContext, StepFailedError, StepRunOptions, Target, WriteResult, bindFunctionRuntime, createServerContext, defineDurableFunction, defineFunction, durable, normalizeRecordsResult };
package/dist/server.js CHANGED
@@ -1 +1 @@
1
- import{a as I}from"./chunk-3JX3FIBG.js";var S=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),N=e=>typeof e=="string"&&/^rec[A-Za-z0-9]{1,32}$/.test(e);function P(e){let r=new Set,n=t=>{if(!(t===null||typeof t=="string"||typeof t=="boolean"||typeof t=="number"&&Number.isFinite(t))){if(typeof t!="object"||!t||r.has(t)||Array.isArray(t)&&Object.getPrototypeOf(t)!==Array.prototype||!Array.isArray(t)&&Object.getPrototypeOf(t)!==Object.prototype&&Object.getPrototypeOf(t)!==null||Array.isArray(t)&&(Object.keys(t).length!==t.length||Object.keys(t).some((s,o)=>s!==String(o))))throw 0;r.add(t);for(let s of Reflect.ownKeys(t)){if(Array.isArray(t)&&s==="length")continue;if(typeof s!="string")throw 0;let o=Object.getOwnPropertyDescriptor(t,s);if(!o.enumerable||!("value"in o))throw 0;n(o.value)}r.delete(t)}};try{n(e)}catch{throw new I("SDK_OUTPUT_NOT_JSON","\u8F93\u51FA\u5FC5\u987B\u662F\u65E0\u635F JSON \u503C")}}function V(e,r,n){return{status:"unknown",code:e,retryable:!1,...r?{requestedIds:[...r]}:{},...n?{logid:n}:{}}}var se=e=>typeof e=="number"&&[401,403,404,91403,1254302,1254043,1254044].includes(e),B=e=>({status:"failed",code:"SDK_RECORDS_REJECTED",upstreamCode:e,retryable:!1,appliedIds:[]}),H=e=>Array.isArray(e)&&e.every(N)&&new Set(e).size===e.length;function W(e,r){let n=()=>V("SDK_RECORDS_RESULT_UNKNOWN",r.requestedIds);if(S(e)&&se(e.code))return B(e.code);if(!S(e)||e.code!==0||!S(e.data))return n();let t=e.data,s=t.ignored_fields??[];if(!Array.isArray(s)||!s.every(a=>S(a)&&["id","name","reason"].every(u=>typeof a[u]=="string")))return n();let o=t.record_not_found??[];if(!H(o))return n();let l=r.requestedIds??[],d,R;if(r.operation==="appendAttachments"||r.operation==="removeAttachments"){if(!S(t.attachments))return n();try{P(t.attachments)}catch{return n()}for(let[a,u]of Object.entries(t.attachments)){if(!N(a)||!l.includes(a)||!S(u)||!Object.keys(u).length)return n();for(let[m,g]of Object.entries(u))if(!/^fld[A-Za-z0-9]+$/.test(m)||!Array.isArray(g)||!g.every(b=>S(b)&&typeof b.file_token=="string"&&b.file_token.length>0))return n()}if(d=Object.keys(t.attachments),o.some(a=>!l.includes(a)||d.includes(a))||!s.length&&l.some(a=>!d.includes(a)&&!o.includes(a)))return n();R=t.attachments}else{if(!H(t.record_id_list))return n();let a=t.record_id_list;if(r.operation==="create"){if(a.length!==r.count||Object.hasOwn(t,"record_not_found"))return n();d=a}else if(r.operation==="update"){if(a.some(u=>!l.includes(u)||o.includes(u))||o.some(u=>!l.includes(u))||a.length+o.length!==l.length)return n();d=a}else{if(a.length!==l.length||a.some((u,m)=>u!==l[m])||o.some(u=>!l.includes(u)))return n();d=a.filter(u=>!o.includes(u))}}let p=R===void 0?{}:{attachments:R};return o.length||s.length?{status:"partial",appliedIds:d,notFoundIds:o,ignoredFields:s,...p}:{status:"success",appliedIds:d,notFoundIds:[],ignoredFields:[],...p}}var G={create:"records/batch_create",update:"records/batch_update",delete:"records/batch_delete",appendAttachments:"append_attachments",removeAttachments:"remove_attachments"},M=e=>({status:"failed",code:e,retryable:!1,appliedIds:[]});function ie(e){if(e?.platformEnv==="online")return e.brand==="feishu"?"https://open.feishu.cn":e.brand==="lark"?"https://open.larksuite.com":void 0;if(e?.brand==="feishu"){if(e.platformEnv==="pre")return"https://open.feishu-pre.cn";if(e.platformEnv==="boe")return"https://open.feishu-boe.cn"}}function Z(e,r){let n=async(t,s,o,l)=>{if(!r)return M("SDK_RUNTIME_PROFILE_MISSING");let d=ie(r);if(!d)return M("SDK_RUNTIME_PROFILE_UNSUPPORTED");if(l?.signal?.aborted)return M("SDK_CANCELLED");let R,p,a;try{if(!S(s)||typeof s.baseToken!="string"||typeof s.tableId!="string"||!/^[A-Za-z0-9]+$/.test(s.baseToken)||!/^tbl[A-Za-z0-9]+$/.test(s.tableId))throw 0;if(P(o),t==="create"){if(!Array.isArray(o)||!o.every(S))throw 0;a=o.length,R={create_records:o}}else if(t==="update"){if(!S(o)||!Object.values(o).every(S))throw 0;p=Object.keys(o),a=p.length,R={update_records:o}}else if(t==="delete"){if(!Array.isArray(o)||!o.every(N))throw 0;p=o,a=o.length,R={record_id_list:o}}else{if(!S(o))throw 0;let u=Object.create(null),m=0;for(let[g,b]of Object.entries(o)){if(!N(g)||!S(b))throw 0;for(let[O,f]of Object.entries(b)){if(!O.trim()||!Array.isArray(f))throw 0;for(let h of f){if(!S(h)||typeof h.file_token!="string"||!h.file_token.trim()||Object.keys(h).some(E=>!["file_token",...t==="appendAttachments"?["image_width","image_height"]:[]].includes(E)))throw 0;for(let E of["image_width","image_height"])if(h[E]!==void 0&&(typeof h[E]!="number"||!Number.isInteger(h[E])||h[E]<=0))throw 0}m+=f.length,f.length&&(u[g]??=Object.create(null),u[g][O]=f)}}if(m>50)throw 0;if(!m)return{status:"success",appliedIds:[],notFoundIds:[],ignoredFields:[],noop:!0};p=Object.keys(u),R={attachments:u}}if(a!==void 0&&(a<1||a>200)||p&&(!p.every(N)||new Set(p).size!==p.length))throw 0}catch{return M("SDK_RECORDS_INPUT_INVALID")}try{let u=await e.fetch(`${d}/open-apis/bitable/v1/apps/${encodeURIComponent(s.baseToken)}/tables/${encodeURIComponent(s.tableId)}/${G[t]}`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(R),signal:l?.signal}),m=u.headers.get("x-tt-logid")??void 0;if([401,403,404].includes(u.status))return B(u.status);if(!u.ok)return V("SDK_RECORDS_HTTP_ERROR",p,m);let g=W(await u.json(),{operation:t,requestedIds:p,count:a});return g.status==="unknown"&&m?{...g,logid:m}:g}catch(u){let m=u instanceof Error?u.name:"";return V(m==="AbortError"?"SDK_CANCELLED":m==="TimeoutError"?"SDK_TIMEOUT":"SDK_RECORDS_RESULT_UNKNOWN",p)}};return Object.fromEntries(Object.keys(G).map(t=>[t,(s,o,l)=>n(t,s,o,l)]))}var Y=Symbol("base-database-runtime-profile");function ae(e,r){let n=Object.freeze({platformEnv:r.platformEnv,brand:r.brand});return function(t,s){let o=Object.defineProperty({...s},Y,{value:n});return e.call(this,t,o)}}function C(e){return{...e,records:Z(e,e[Y])}}async function X(e,r,n){let t;try{t=await e["~standard"].validate(r)}catch{throw new I("SDK_VALIDATOR_FAILED","Schema \u6821\u9A8C\u5668\u6267\u884C\u5931\u8D25")}if(t.issues){let s=t.issues.map(o=>(o.path??[]).map(l=>{let d=typeof l=="object"?l.key:l;return typeof d=="number"||typeof d=="string"?d:"[symbol]"}));throw new I(`SDK_${n}_INVALID`,n==="INPUT"?"\u8F93\u5165\u4E0D\u7B26\u5408\u5951\u7EA6":"\u8F93\u51FA\u4E0D\u7B26\u5408\u5951\u7EA6",{paths:s})}return t.value}function ue(e){return async(r,n)=>{try{let t=await X(e.input,r,"INPUT"),s=await e.handler(t,C(n)),o=await X(e.output,s,"OUTPUT");return P(o),{code:0,msg:"success",data:o}}catch(t){let s=t instanceof I?t:new I("SDK_HANDLER_FAILED","\u51FD\u6570\u6267\u884C\u5931\u8D25");console.error(JSON.stringify({source:"sdk",code:s.code,paths:s.paths,retryable:s.retryable,outcome:s.outcome}));let o={code:s.wireCode,msg:s.safeMessage};return t instanceof I||Object.defineProperty(o,Symbol.for("base-site.function-error"),{value:t}),o}}}var Q="base-site.durable",ee="base-site.runtime";var A=class extends Error{constructor(n,t=n){super(t);this.reason=n;this.name="DurableError"}},_=class extends Error{constructor(r){super(r),this.name="NonRetryableError"}},k=class extends Error{constructor(n,t){super(t.message);this.key=n;this.error=t;this.name="StepFailedError"}};function J(e,r,n){let t="Unknown error",s="Error";try{e instanceof Error?(typeof e.message=="string"&&(t=e.message),typeof e.name=="string"&&(s=e.name)):typeof e=="string"&&(t=e)}catch{}t=t.slice(0,1024*4).replace(/([?&][^=&#\s]*?(?:token|ticket|code|secret|key|password|authorization)[^=&#\s]*=)[^&#\s]*/gi,"$1[REDACTED]").replace(/\bBearer\s+[^\s"'<>]+/gi,"Bearer [REDACTED]").replace(/[A-Za-z0-9_]{32,}/g,"[REDACTED]");let o="",l=0;for(let d of t){if(l+=new TextEncoder().encode(d).length,l>1024)break;o+=d}return{name:s,message:o,...r?{code:r}:{},...n?{key:n}:{},...e instanceof _?{retryable:!1}:{}}}function z(e){let r={ms:1,s:1e3,m:6e4,h:36e5,d:864e5},n=typeof e=="string"&&/^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/.exec(e),t=typeof e=="number"?e:n?Number(n[1])*r[n[2]]:NaN;if(!Number.isSafeInteger(t)||t<0)throw new Error("Invalid duration");return t}function q(e){return P(e),e}function $(e){return new TextEncoder().encode(JSON.stringify(e)).length}var T=()=>new Promise(()=>{});function ge(e){let r={v:1,async execute(n,t){try{return await ye(e,n,t)}catch(s){return{v:1,seq:n?.invocation?.seq??0,op:"fail",error:J(s,"HANDLER_ERROR")}}}};return{[Symbol.for(Q)]:r}}function ye(e,r,n){return new Promise(t=>{let s={v:1,seq:r.invocation.seq},o=new Set,l=new Map(r.steps.map(i=>[i.key,i])),d,R=!1,p=!1,a,u,m,g,b=Math.min(n.deadline,r.invocation.deadline),O=i=>{p||((!a||i.op==="fail")&&(a=i),queueMicrotask(()=>{p||!a||(p=!0,clearTimeout(E),clearTimeout(m),n.signal.removeEventListener("abort",h),u?.abort(),t({...a,...d!==void 0?{progress:d}:{}}))}))},f=(i,y,c=new Error(i))=>O({...s,op:"fail",error:J(c,i,y)}),h=()=>g?g():f("REPLAY_TIMEOUT"),E=setTimeout(h,Math.max(0,b-Date.now())),j=(i,y)=>{if(p||a?.op==="fail")return;if(Date.now()>=b){h();return}if(typeof i!="string"||i.length<1||i.length>128||/[\x00-\x1f\x7f-\x9f]/.test(i)){f("DEFINITION_INVALID",void 0,new Error("Invalid step key"));return}if(o.has(i)){f("DUPLICATE_STEP_KEY",i);return}o.add(i);let c=l.get(i);if(c){if(c.kind!==y){f("DEFINITION_KIND_MISMATCH",i);return}if(!c.ok)throw new k(i,c.error);return{fresh:!1,value:y==="sleep"?void 0:c.timedOut?null:c.value}}if(R){f("PARALLEL_STEPS",i);return}if(l.size>=100){f("STEP_LIMIT",i);return}return R=!0,{fresh:!0}},re={async run(i,y,c={}){let x=j(i,"run");if(!x)return T();if(!x.fresh)return x.value;let w,K=c.retries??3;try{if(w=c.timeout===void 0?b-Date.now():Math.min(z(c.timeout),b-Date.now()),!Number.isSafeInteger(K)||K<0||w<=0)throw new Error("Invalid step options")}catch(D){return f("DEFINITION_INVALID",i,D),T()}u=new AbortController;let oe=u.signal,v=Date.now(),U=(D,L)=>O({...s,op:"step",key:i,ok:!1,error:J(D,L,i),policy:{retries:K},durationMs:Math.max(0,Date.now()-v)});return g=()=>{U(new Error("Step exceeded its deadline"),"STEP_TIMEOUT"),u?.abort()},m=setTimeout(g,w),Promise.resolve().then(async()=>{if(!(a||p))try{let D=await y({signal:oe,attempt:r.invocation.attempt});if(Date.now()>=v+w){g?.();return}let L=q(D===void 0?null:D);if($(L)>262144){U(new _("Step result exceeds 256KB"),"STEP_RESULT_TOO_LARGE");return}O({...s,op:"step",key:i,ok:!0,value:L,durationMs:Math.max(0,Date.now()-v)})}catch(D){Date.now()>=v+w?g?.():U(D)}}),T()},async sleep(i,y){let c=j(i,"sleep");if(!c)return T();if(c.fresh){try{let x=z(y);if(x<1e3||x>2592e6)throw new Error("Sleep duration must be between 1s and 30d");O({...s,op:"sleep",key:i,durationMs:x})}catch(x){f("DEFINITION_INVALID",i,x)}return T()}},async waitForEvent(i,y,c){if(!Object.hasOwn(e.events,y))return f("EVENT_UNDECLARED",i),T();let x=j(i,"wait");if(!x)return T();if(!x.fresh)return x.value;try{let w=z(c.timeout);if(w<1e3||w>2592e6)throw new Error("Event timeout must be between 1s and 30d");O({...s,op:"wait",key:i,event:y,timeoutMs:w})}catch(w){f("DEFINITION_INVALID",i,w)}return T()},progress(i){if(!p)try{let y=q(i);$(y)<=4096?d=JSON.parse(JSON.stringify(y)):console.warn("Durable progress exceeds 4KB; discarded")}catch{f("DEFINITION_INVALID",void 0,new Error("Progress must be JSON"))}}};if(n.signal.addEventListener("abort",h,{once:!0}),n.signal.aborted||b<=Date.now()){h();return}Promise.resolve().then(async()=>{try{let i;try{let c=await e.input["~standard"].validate(r.input);if(c.issues)throw new Error("Input schema validation failed");i=c.value}catch(c){f("INPUT_INVALID",void 0,c);return}if(p||a)return;if(Date.now()>=b){f("REPLAY_TIMEOUT");return}let y=await e.handler(i,re,C(n.ctx));if(R||p||a)return;try{let c=await e.output["~standard"].validate(y);if(c.issues)throw new Error("Output schema validation failed");if(Date.now()>=b){f("REPLAY_TIMEOUT");return}let x=q(c.value);if($(x)>262144)throw new Error("Output exceeds 256KB");O({...s,op:"done",output:x})}catch(c){f("OUTPUT_INVALID",void 0,c)}}catch(i){f("HANDLER_ERROR",i instanceof k?i.key:void 0,i)}})})}async function F(e){let r=globalThis[Symbol.for(ee)],n=r?.v===1?r.context.getStore()?.ctx:void 0;if(!n?.faasInvoke)throw new A("DURABLE_NO_CONTEXT");try{let t=await n.faasInvoke({method:"durable",params:JSON.stringify(e)});if(!t||t.code!==0)throw new A(t?.data?.reason??"INFRA_UNAVAILABLE");return t.data}catch(t){throw t instanceof A?t:new A("INFRA_UNAVAILABLE")}}var xe={start(e,r,n){return F({...n,action:"start",functionId:e,input:r})},get(e,r){return F({...r,action:"get",runId:e})},list(e){return F({...e,action:"list"})},cancel(e,r){return F({...r,action:"cancel",runId:e})},signal(e,r,n,t){return F({...t,action:"signal",runId:e,event:r,data:n})}};export{A as DurableError,_ as NonRetryableError,I as SDKError,k as StepFailedError,ae as bindFunctionRuntime,C as createServerContext,ge as defineDurableFunction,ue as defineFunction,xe as durable,W as normalizeRecordsResult};
1
+ import{a as w}from"./chunk-3JX3FIBG.js";var S=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),N=e=>typeof e=="string"&&/^rec[A-Za-z0-9]{1,32}$/.test(e);function T(e){let o=new Set,r=t=>{if(!(t===null||typeof t=="string"||typeof t=="boolean"||typeof t=="number"&&Number.isFinite(t))){if(typeof t!="object"||!t||o.has(t)||Array.isArray(t)&&Object.getPrototypeOf(t)!==Array.prototype||!Array.isArray(t)&&Object.getPrototypeOf(t)!==Object.prototype&&Object.getPrototypeOf(t)!==null||Array.isArray(t)&&(Object.keys(t).length!==t.length||Object.keys(t).some((n,s)=>n!==String(s))))throw 0;o.add(t);for(let n of Reflect.ownKeys(t)){if(Array.isArray(t)&&n==="length")continue;if(typeof n!="string")throw 0;let s=Object.getOwnPropertyDescriptor(t,n);if(!s.enumerable||!("value"in s))throw 0;r(s.value)}o.delete(t)}};try{r(e)}catch{throw new w("SDK_OUTPUT_NOT_JSON","\u8F93\u51FA\u5FC5\u987B\u662F\u65E0\u635F JSON \u503C")}}function V(e,o,r){return{status:"unknown",code:e,retryable:!1,...o?{requestedIds:[...o]}:{},...r?{logid:r}:{}}}var ie=e=>typeof e=="number"&&[401,403,404,91403,1254302,1254043,1254044].includes(e),B=e=>({status:"failed",code:"SDK_RECORDS_REJECTED",upstreamCode:e,retryable:!1,appliedIds:[]}),H=e=>Array.isArray(e)&&e.every(N)&&new Set(e).size===e.length;function W(e,o){let r=()=>V("SDK_RECORDS_RESULT_UNKNOWN",o.requestedIds);if(S(e)&&ie(e.code))return B(e.code);if(!S(e)||e.code!==0||!S(e.data))return r();let t=e.data,n=t.ignored_fields??[];if(!Array.isArray(n)||!n.every(a=>S(a)&&["id","name","reason"].every(u=>typeof a[u]=="string")))return r();let s=t.record_not_found??[];if(!H(s))return r();let p=o.requestedIds??[],l,R;if(o.operation==="appendAttachments"||o.operation==="removeAttachments"){if(!S(t.attachments))return r();try{T(t.attachments)}catch{return r()}for(let[a,u]of Object.entries(t.attachments)){if(!N(a)||!p.includes(a)||!S(u)||!Object.keys(u).length)return r();for(let[m,g]of Object.entries(u))if(!/^fld[A-Za-z0-9]+$/.test(m)||!Array.isArray(g)||!g.every(b=>S(b)&&typeof b.file_token=="string"&&b.file_token.length>0))return r()}if(l=Object.keys(t.attachments),s.some(a=>!p.includes(a)||l.includes(a))||!n.length&&p.some(a=>!l.includes(a)&&!s.includes(a)))return r();R=t.attachments}else{if(!H(t.record_id_list))return r();let a=t.record_id_list;if(o.operation==="create"){if(a.length!==o.count||Object.hasOwn(t,"record_not_found"))return r();l=a}else if(o.operation==="update"){if(a.some(u=>!p.includes(u)||s.includes(u))||s.some(u=>!p.includes(u))||a.length+s.length!==p.length)return r();l=a}else{if(a.length!==p.length||a.some((u,m)=>u!==p[m])||s.some(u=>!p.includes(u)))return r();l=a.filter(u=>!s.includes(u))}}let d=R===void 0?{}:{attachments:R};return s.length||n.length?{status:"partial",appliedIds:l,notFoundIds:s,ignoredFields:n,...d}:{status:"success",appliedIds:l,notFoundIds:[],ignoredFields:[],...d}}var G={create:"records/batch_create",update:"records/batch_update",delete:"records/batch_delete",appendAttachments:"append_attachments",removeAttachments:"remove_attachments"},M=e=>({status:"failed",code:e,retryable:!1,appliedIds:[]});function ae(e){if(e?.platformEnv==="online")return e.brand==="feishu"?"https://open.feishu.cn":e.brand==="lark"?"https://open.larksuite.com":void 0;if(e?.brand==="feishu"){if(e.platformEnv==="pre")return"https://open.feishu-pre.cn";if(e.platformEnv==="boe")return"https://open.feishu-boe.cn"}}function Y(e,o){let r=async(t,n,s,p)=>{if(!o)return M("SDK_RUNTIME_PROFILE_MISSING");let l=ae(o);if(!l)return M("SDK_RUNTIME_PROFILE_UNSUPPORTED");if(p?.signal?.aborted)return M("SDK_CANCELLED");let R,d,a;try{if(!S(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(T(s),t==="create"){if(!Array.isArray(s)||!s.every(S))throw 0;a=s.length,R={create_records:s}}else if(t==="update"){if(!S(s)||!Object.values(s).every(S))throw 0;d=Object.keys(s),a=d.length,R={update_records:s}}else if(t==="delete"){if(!Array.isArray(s)||!s.every(N))throw 0;d=s,a=s.length,R={record_id_list:s}}else{if(!S(s))throw 0;let u=Object.create(null),m=0;for(let[g,b]of Object.entries(s)){if(!N(g)||!S(b))throw 0;for(let[O,f]of Object.entries(b)){if(!O.trim()||!Array.isArray(f))throw 0;for(let h of f){if(!S(h)||typeof h.file_token!="string"||!h.file_token.trim()||Object.keys(h).some(E=>!["file_token",...t==="appendAttachments"?["image_width","image_height"]:[]].includes(E)))throw 0;for(let E of["image_width","image_height"])if(h[E]!==void 0&&(typeof h[E]!="number"||!Number.isInteger(h[E])||h[E]<=0))throw 0}m+=f.length,f.length&&(u[g]??=Object.create(null),u[g][O]=f)}}if(m>50)throw 0;if(!m)return{status:"success",appliedIds:[],notFoundIds:[],ignoredFields:[],noop:!0};d=Object.keys(u),R={attachments:u}}if(a!==void 0&&(a<1||a>200)||d&&(!d.every(N)||new Set(d).size!==d.length))throw 0}catch{return M("SDK_RECORDS_INPUT_INVALID")}try{let u=await e.fetch(`${l}/open-apis/bitable/v1/apps/${encodeURIComponent(n.baseToken)}/tables/${encodeURIComponent(n.tableId)}/${G[t]}`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(R),signal:p?.signal}),m=u.headers.get("x-tt-logid")??void 0;if([401,403,404].includes(u.status))return B(u.status);if(!u.ok)return V("SDK_RECORDS_HTTP_ERROR",d,m);let g=W(await u.json(),{operation:t,requestedIds:d,count:a});return g.status==="unknown"&&m?{...g,logid:m}:g}catch(u){let m=u instanceof Error?u.name:"";return V(m==="AbortError"?"SDK_CANCELLED":m==="TimeoutError"?"SDK_TIMEOUT":"SDK_RECORDS_RESULT_UNKNOWN",d)}};return Object.fromEntries(Object.keys(G).map(t=>[t,(n,s,p)=>r(t,n,s,p)]))}var Z=Symbol("base-database-runtime-profile");function ue(e,o){let r=Object.freeze({platformEnv:o.platformEnv,brand:o.brand});return function(t,n){let s=Object.defineProperty({...n},Z,{value:r});return e.call(this,t,s)}}function _(e){return{...e,records:Y(e,e[Z])}}async function X(e,o,r){let t;try{t=await e["~standard"].validate(o)}catch{throw new w("SDK_VALIDATOR_FAILED","Schema \u6821\u9A8C\u5668\u6267\u884C\u5931\u8D25")}if(t.issues){let n=t.issues.map(s=>(s.path??[]).map(p=>{let l=typeof p=="object"?p.key:p;return typeof l=="number"||typeof l=="string"?l:"[symbol]"}));throw new w(`SDK_${r}_INVALID`,r==="INPUT"?"\u8F93\u5165\u4E0D\u7B26\u5408\u5951\u7EA6":"\u8F93\u51FA\u4E0D\u7B26\u5408\u5951\u7EA6",{paths:n})}return t.value}function ce(e){return async(o,r)=>{try{let t=await X(e.input,o,"INPUT"),n=await e.handler(t,_(r)),s=await X(e.output,n,"OUTPUT");return T(s),{code:0,msg:"success",data:s}}catch(t){let n=t instanceof w?t:new w("SDK_HANDLER_FAILED","\u51FD\u6570\u6267\u884C\u5931\u8D25");console.error(JSON.stringify({source:"sdk",code:n.code,paths:n.paths,retryable:n.retryable,outcome:n.outcome}));let s={code:n.wireCode,msg:n.safeMessage};return t instanceof w||Object.defineProperty(s,Symbol.for("base-site.function-error"),{value:t}),s}}}var Q="base-site.durable",ee="base-site.runtime";var F=class extends Error{constructor(r,t=r,n,s){super(t,s);this.code=r;this.logId=n;this.name="DurableError"}},k=class extends Error{constructor(o){super(o),this.name="NonRetryableError"}},P=class extends Error{constructor(r,t){super(t.message);this.key=r;this.error=t;this.name="StepFailedError"}};function J(e,o,r){let t="Unknown error",n="Error";try{e instanceof Error?(typeof e.message=="string"&&(t=e.message),typeof e.name=="string"&&(n=e.name)):typeof e=="string"&&(t=e)}catch{}t=t.slice(0,1024*4).replace(/([?&][^=&#\s]*?(?:token|ticket|code|secret|key|password|authorization)[^=&#\s]*=)[^&#\s]*/gi,"$1[REDACTED]").replace(/\bBearer\s+[^\s"'<>]+/gi,"Bearer [REDACTED]");let s="",p=0;for(let l of t){if(p+=new TextEncoder().encode(l).length,p>1024)break;s+=l}return{name:n,message:s,...o?{code:o}:{},...r?{key:r}:{},...e instanceof k?{retryable:!1}:{}}}function re(e,o){return`${e} schema validation failed: `+o.slice(0,3).map(r=>`${r.path?.map(n=>String(typeof n=="object"?n.key:n)).join(".")||"$"}: ${r.message}`).join("; ")}function $(e){let o={ms:1,s:1e3,m:6e4,h:36e5,d:864e5},r=typeof e=="string"&&/^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/.exec(e),t=typeof e=="number"?e:r?Number(r[1])*o[r[2]]:NaN;if(!Number.isSafeInteger(t)||t<0)throw new Error("Invalid duration");return t}function z(e){return T(e),e}function q(e){return new TextEncoder().encode(JSON.stringify(e)).length}var A=()=>new Promise(()=>{});function ye(e){let o={v:1,async execute(r,t){try{return await xe(e,r,t)}catch(n){return{v:1,seq:r?.invocation?.seq??0,op:"fail",error:J(n,"HANDLER_ERROR")}}}};return{[Symbol.for(Q)]:o}}function xe(e,o,r){return new Promise(t=>{let n={v:1,seq:o.invocation.seq},s=new Set,p=new Map(o.steps.map(i=>[i.key,i])),l,R=!1,d=!1,a,u,m,g,b=Math.min(r.deadline,o.invocation.deadline),O=i=>{d||((!a||i.op==="fail")&&(a=i),queueMicrotask(()=>{d||!a||(d=!0,clearTimeout(E),clearTimeout(m),r.signal.removeEventListener("abort",h),u?.abort(),t({...a,...l!==void 0?{progress:l}:{}}))}))},f=(i,y,c=new Error(i))=>O({...n,op:"fail",error:J(c,i,y)}),h=()=>g?g():f("REPLAY_TIMEOUT"),E=setTimeout(h,Math.max(0,b-Date.now())),j=(i,y)=>{if(d||a?.op==="fail")return;if(Date.now()>=b){h();return}if(typeof i!="string"||i.length<1||i.length>128||/[\x00-\x1f\x7f-\x9f]/.test(i)){f("DEFINITION_INVALID",void 0,new Error("Invalid step key"));return}if(s.has(i)){f("DUPLICATE_STEP_KEY",i);return}s.add(i);let c=p.get(i);if(c){if(c.kind!==y){f("DEFINITION_KIND_MISMATCH",i);return}if(!c.ok)throw new P(i,c.error);return{fresh:!1,value:y==="sleep"?void 0:c.timedOut?null:c.value}}if(R){f("PARALLEL_STEPS",i);return}if(p.size>=100){f("STEP_LIMIT",i);return}return R=!0,{fresh:!0}},oe={async run(i,y,c={}){let x=j(i,"run");if(!x)return A();if(!x.fresh)return x.value;let I,K=c.retries??3;try{if(I=c.timeout===void 0?b-Date.now():Math.min($(c.timeout),b-Date.now()),!Number.isSafeInteger(K)||K<0||I<=0)throw new Error("Invalid step options")}catch(D){return f("DEFINITION_INVALID",i,D),A()}u=new AbortController;let se=u.signal,C=Date.now(),U=(D,L)=>O({...n,op:"step",key:i,ok:!1,error:J(D,L,i),policy:{retries:K},durationMs:Math.max(0,Date.now()-C)});return g=()=>{U(new Error("Step exceeded its deadline"),"STEP_TIMEOUT"),u?.abort()},m=setTimeout(g,I),Promise.resolve().then(async()=>{if(!(a||d))try{let D=await y({signal:se,attempt:o.invocation.attempt});if(Date.now()>=C+I){g?.();return}let L=z(D===void 0?null:D);if(q(L)>262144){U(new k("Step result exceeds 256KB"),"STEP_RESULT_TOO_LARGE");return}O({...n,op:"step",key:i,ok:!0,value:L,durationMs:Math.max(0,Date.now()-C)})}catch(D){Date.now()>=C+I?g?.():U(D)}}),A()},async sleep(i,y){let c=j(i,"sleep");if(!c)return A();if(c.fresh){try{let x=$(y);if(x<1e3||x>2592e6)throw new Error("Sleep duration must be between 1s and 30d");O({...n,op:"sleep",key:i,durationMs:x})}catch(x){f("DEFINITION_INVALID",i,x)}return A()}},async waitForEvent(i,y,c){if(!Object.hasOwn(e.events??{},y))return f("EVENT_UNDECLARED",i),A();let x=j(i,"wait");if(!x)return A();if(!x.fresh)return x.value;try{let I=$(c.timeout);if(I<1e3||I>2592e6)throw new Error("Event timeout must be between 1s and 30d");O({...n,op:"wait",key:i,event:y,timeoutMs:I})}catch(I){f("DEFINITION_INVALID",i,I)}return A()},progress(i){if(!d)try{let y=z(i);q(y)<=4096?l=JSON.parse(JSON.stringify(y)):console.warn("Durable progress exceeds 4KB; discarded")}catch{f("DEFINITION_INVALID",void 0,new Error("Progress must be JSON"))}}};if(r.signal.addEventListener("abort",h,{once:!0}),r.signal.aborted||b<=Date.now()){h();return}Promise.resolve().then(async()=>{try{let i;try{let c=await e.input["~standard"].validate(o.input);if(c.issues)throw new Error(re("Input",c.issues));i=c.value}catch(c){f("INPUT_INVALID",void 0,c);return}if(d||a)return;if(Date.now()>=b){f("REPLAY_TIMEOUT");return}let y=await e.handler(i,oe,_(r.ctx));if(R||d||a)return;try{let c=await e.output["~standard"].validate(y);if(c.issues)throw new Error(re("Output",c.issues));if(Date.now()>=b){f("REPLAY_TIMEOUT");return}let x=z(c.value);if(q(x)>262144)throw new Error("Output exceeds 256KB");O({...n,op:"done",output:x})}catch(c){f("OUTPUT_INVALID",void 0,c)}}catch(i){f("HANDLER_ERROR",i instanceof P?i.key:void 0,i)}})})}async function v(e){let o=globalThis[Symbol.for(ee)],r=o?.v===1?o.context.getStore()?.ctx:void 0;if(!r?.faasInvoke)throw new F("DURABLE_NO_CONTEXT");try{let t=await r.faasInvoke({method:"durable",params:JSON.stringify(e)});if(!t||t.code!==0)throw new F(t?.data?.reason??"INFRA_UNAVAILABLE",t?.msg,t?.data?.logId);return t.data}catch(t){if(t instanceof F)throw t;let n=t,p=[n?.code??n?.cause?.code,n?.message,n?.cause?.message].filter(l=>l!=null&&l!=="").join(": ")||(typeof t=="string"?t:"INFRA_UNAVAILABLE");throw new F("INFRA_UNAVAILABLE",p,n?.logId,{cause:t})}}var Se={start(e,o,r){return v({...r,action:"start",functionId:e,input:o})},get(e,o){return v({...o,action:"get",runId:e})},list(e){return v({...e,action:"list"})},cancel(e,o){return v({...o,action:"cancel",runId:e})},signal(e,o,r,t){return v({...t,action:"signal",runId:e,event:o,data:r})}};export{F as DurableError,k as NonRetryableError,w as SDKError,P as StepFailedError,ue as bindFunctionRuntime,_ as createServerContext,ye as defineDurableFunction,ce as defineFunction,Se as durable,W as normalizeRecordsResult};
package/docs/durable.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  从 `/server` 导入 `defineDurableFunction`、`durable`、`NonRetryableError`、`StepFailedError` 与 `DurableError`。长时任务放在 `server/durable/<id>`,与普通 Function 共用依赖与构建。
4
4
 
5
- `defineDurableFunction({ input, output, events, handler })` 返回默认导出对象。handler 参数为 `(input, step, ctx)`;契约使用 Standard Schema(如 zod)。每轮推进按当前契约解析 input,default、transform 均生效;不合规时以 INPUT_INVALID 失败。handler 返回后校验 output。
5
+ `defineDurableFunction({ input, output, events, handler })` 返回默认导出对象。handler 参数为 `(input, step, ctx)`;契约使用 Standard Schema(如 zod)。`events` 可省略,默认 `{}`;未声明的事件不能等待或发送。每轮推进按当前契约解析 input,default、transform 均生效;不合规时以 INPUT_INVALID 失败。handler 返回后校验 output。INPUT_INVALID / OUTPUT_INVALID 的 message 附前 3 条 schema issues(字段路径与原因),UTF-8 总长不超过 1KB。
6
6
 
7
7
  - `step.run(key, callback, { timeout?, retries? })`:回调接收 `{ signal, attempt }`。默认重试 3 次(最多 4 次尝试),按 1 秒起、倍增至最多 60 秒的间隔退避;抛出 `NonRetryableError` 禁止重试。失败耗尽后重放抛出 `StepFailedError`,业务可捕获补偿。错误仅包含 key、error;重试次数见 durable.get 返回的 step 列表。
8
8
  - `step.sleep(key, duration)`:持久化等待。时长支持毫秒数以及 `ms`、`s`、`m`、`h`、`d` 后缀。
@@ -44,4 +44,74 @@ export function expenseApproval(service: {
44
44
 
45
45
  `durable.start(functionId, input, { idempotencyKey? })`、`get(runId, { scope? })`、`list({ functionId?, status?, scope?, pageToken?, pageSize? })`、`cancel(runId, { scope? })`、`signal(runId, event, data, { eventId })` 只能在请求上下文中调用。默认只查询或取消当前调用人启动的任务,全站点可见性需显式 scope: 'site'。审批业务需自行鉴权。
46
46
 
47
- 调用失败抛出 `DurableError`,reason 为平台字符串错误码;缺少请求上下文时为 DURABLE_NO_CONTEXT。业务身份不会缓存在模块变量中。
47
+ 调用失败抛出 `DurableError`,包含 `code`、`message` 和 `logId`。业务失败的 `code` 取自响应 `data.reason`,`logId` 取自 `data.logId`,`message` 保留响应 `msg`,不从 msg 猜错误码。缺少请求上下文时 code 为 DURABLE_NO_CONTEXT;网络异常的 code 固定为 INFRA_UNAVAILABLE,message 保留底层错误码(如 ECONNREFUSED)和原因,cause 保留原始异常,没有请求 LogID 时 logId 为 undefined。业务身份不会缓存在模块变量中。
48
+
49
+ `get` 的 `steps` 包含 `attempts` 和可选 `lastError`(最近一次失败的 name、message、code、key、retryable),重试过程中也可查看;step 不带 logId。run 在运行期间及结束后 7 天内可查询。运行错误仅遮盖 URL 中 token、ticket、code、secret、key、password、authorization 等参数值以及 Bearer 凭证,保留长记录 ID。
50
+
51
+ ## 契约类型生成
52
+
53
+ CLI `contracts generate` 从契约渲染 `server/src/generated/durable.d.ts`,增强 `/server` 导出的 `DurableFunctions` 接口;每个函数项为 `{ input; output; events }`,events 省略时生成为 `{}`。SDK 不提供这份文件的 codegen。确保 tsconfig 包含生成文件:
54
+
55
+ <!-- example: durable-control.ts -->
56
+ ```ts
57
+ import { durable, DurableError } from '@lark-base-open/base-database-app-sdk/server';
58
+ import type { z } from 'zod';
59
+ import type { input, output, events } from './durable';
60
+
61
+ // 应用中由 CLI contracts generate 写入 server/src/generated/durable.d.ts。
62
+ declare module '@lark-base-open/base-database-app-sdk/server' {
63
+ interface DurableFunctions {
64
+ expenseApproval: {
65
+ input: z.input<typeof input>;
66
+ output: z.output<typeof output>;
67
+ events: { approval: z.input<typeof events.approval> };
68
+ };
69
+ }
70
+ }
71
+
72
+ // 在普通 server Function 的请求上下文中调用;业务需自行鉴权。
73
+ export async function startExpense(value: z.input<typeof input>) {
74
+ try {
75
+ const { runId } = await durable.start('expenseApproval', value);
76
+ const run = await durable.get<'expenseApproval'>(runId);
77
+ return { runId, status: run.status, expenseId: run.output?.expenseId };
78
+ } catch (error) {
79
+ if (error instanceof DurableError) {
80
+ console.error({ code: error.code, message: error.message, logId: error.logId });
81
+ }
82
+ throw error;
83
+ }
84
+ }
85
+
86
+ export async function approveExpense(runId: string, eventId: string) {
87
+ return durable.signal<'expenseApproval', 'approval'>(runId, 'approval', { approved: true }, { eventId });
88
+ }
89
+ ```
90
+
91
+ `start` 根据 functionId 推断 input;`get<'expenseApproval'>(runId)` 显式指定函数来推断 output(未完成时可为 null);`signal<'expenseApproval', 'approval'>(runId, 'approval', { approved: true }, { eventId: 'decision-1' })` 显式指定函数与事件。runId 始终是 string,类型增强不改变运行时行为。未增强接口时,函数名和事件名接受 string,数据回退 JSONValue。
92
+
93
+ 完整调用示例见 [durable-control.ts](../examples/durable-control.ts)。
94
+
95
+ ## 声明 Timer Trigger
96
+
97
+ 在所属函数 `server/durable/<functionId>/meta.json` 声明 `triggers`:
98
+
99
+ <!-- example: durable-trigger.ts -->
100
+ ```ts
101
+ // 将此对象保存为 server/durable/dailyReport/meta.json 的 JSON 内容。
102
+ export const meta = {
103
+ "triggers": [{
104
+ "id": "daily-report",
105
+ "type": "timer",
106
+ "timer": {
107
+ "startAt": "2026-11-10T09:00:00+08:00",
108
+ "timezone": "Asia/Shanghai",
109
+ "repeat": { "unit": "DAY", "interval": 1 }
110
+ },
111
+ "input": { "scope": "yesterday" },
112
+ "enabled": true
113
+ }]
114
+ };
115
+ ```
116
+
117
+ id 在站点内唯一,为 1–64 位字母、数字、下划线或连字符。声明随部署、发布与版本恢复生效;input 必须符合所属函数契约。Preview 不自动触发,可用 CLI `durable trigger fire <triggerId>` 按声明 input 以站点 Owner 身份手动验证,需要站点管理权限。Prod 自动触发,CLI 只提供 `trigger enable/disable` 开关,已有 id 的线上开关在发布时保留。删除声明或停用 Trigger 不取消在途 run。SDK 仅提供 server 代码的 run 控制,不提供线上规则 CRUD;CLI 的 run.start/cancel/signal 限 Preview,Prod 仅可 get/list 查询。
package/docs/exports.md CHANGED
@@ -12,7 +12,7 @@
12
12
 
13
13
  值:`DurableError`、`NonRetryableError`、`SDKError`、`StepFailedError`、`bindFunctionRuntime`、`createServerContext`、`defineDurableFunction`、`defineFunction`、`durable`、`normalizeRecordsResult`。
14
14
 
15
- 类型与值完整清单:`AttachmentInput`、`Attachments`、`DefineDurableFunctionOptions`、`DefineFunctionOptions`、`DefinedDurableFunction`、`DefinedFunction`、`DiagnosticCategory`、`DurableError`、`DurableStep`、`Duration`、`Fields`、`FunctionEnvelope`、`FunctionResult`、`JsonValue`、`LegacyFunctionHandler`、`NonRetryableError`、`RawFunctionContext`、`RecordsClient`、`RecordsOperation`、`RecordsResultRequest`、`RuntimeBuildProfile`、`RuntimeDiagnostic`、`SDKError`、`SDKErrorOptions`、`ServerContext`、`StepExecutionContext`、`StepFailedError`、`StepRunOptions`、`Target`、`WriteResult`、`bindFunctionRuntime`、`createServerContext`、`defineDurableFunction`、`defineFunction`、`durable`、`normalizeRecordsResult`。
15
+ 类型与值完整清单:`AttachmentInput`、`Attachments`、`DefineDurableFunctionOptions`、`DefineFunctionOptions`、`DefinedDurableFunction`、`DefinedFunction`、`DiagnosticCategory`、`DurableError`、`DurableFunctions`、`DurableStep`、`Duration`、`Fields`、`FunctionEnvelope`、`FunctionResult`、`JsonValue`、`LegacyFunctionHandler`、`NonRetryableError`、`RawFunctionContext`、`RecordsClient`、`RecordsOperation`、`RecordsResultRequest`、`RuntimeBuildProfile`、`RuntimeDiagnostic`、`SDKError`、`SDKErrorOptions`、`ServerContext`、`StepExecutionContext`、`StepFailedError`、`StepRunOptions`、`Target`、`WriteResult`、`bindFunctionRuntime`、`createServerContext`、`defineDurableFunction`、`defineFunction`、`durable`、`normalizeRecordsResult`。
16
16
 
17
17
  ## shared
18
18
 
@@ -0,0 +1,32 @@
1
+ import { durable, DurableError } from '@lark-base-open/base-database-app-sdk/server';
2
+ import type { z } from 'zod';
3
+ import type { input, output, events } from './durable';
4
+
5
+ // 应用中由 CLI contracts generate 写入 server/src/generated/durable.d.ts。
6
+ declare module '@lark-base-open/base-database-app-sdk/server' {
7
+ interface DurableFunctions {
8
+ expenseApproval: {
9
+ input: z.input<typeof input>;
10
+ output: z.output<typeof output>;
11
+ events: { approval: z.input<typeof events.approval> };
12
+ };
13
+ }
14
+ }
15
+
16
+ // 在普通 server Function 的请求上下文中调用;业务需自行鉴权。
17
+ export async function startExpense(value: z.input<typeof input>) {
18
+ try {
19
+ const { runId } = await durable.start('expenseApproval', value);
20
+ const run = await durable.get<'expenseApproval'>(runId);
21
+ return { runId, status: run.status, expenseId: run.output?.expenseId };
22
+ } catch (error) {
23
+ if (error instanceof DurableError) {
24
+ console.error({ code: error.code, message: error.message, logId: error.logId });
25
+ }
26
+ throw error;
27
+ }
28
+ }
29
+
30
+ export async function approveExpense(runId: string, eventId: string) {
31
+ return durable.signal<'expenseApproval', 'approval'>(runId, 'approval', { approved: true }, { eventId });
32
+ }
@@ -0,0 +1,14 @@
1
+ // 将此对象保存为 server/durable/dailyReport/meta.json 的 JSON 内容。
2
+ export const meta = {
3
+ "triggers": [{
4
+ "id": "daily-report",
5
+ "type": "timer",
6
+ "timer": {
7
+ "startAt": "2026-11-10T09:00:00+08:00",
8
+ "timezone": "Asia/Shanghai",
9
+ "repeat": { "unit": "DAY", "interval": 1 }
10
+ },
11
+ "input": { "scope": "yesterday" },
12
+ "enabled": true
13
+ }]
14
+ };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lark-base-open/base-database-app-sdk",
3
- "version": "0.6.0-durable.2",
3
+ "version": "0.6.0-durable.4",
4
4
  "description": "Base Database 页面与服务端 SDK、平台组件及测试工具",
5
5
  "type": "module",
6
6
  "sideEffects": [
@@ -66,6 +66,16 @@
66
66
  "capabilities.json",
67
67
  "development-pairing.json"
68
68
  ],
69
+ "scripts": {
70
+ "build": "node scripts/sync-contract-schema.mjs --check && node scripts/sync-capabilities.mjs && tsup && tsup --config tsup.cjs.config.ts && cp src/page/theme.css dist/theme.css",
71
+ "test": "npm run check:migrations && node scripts/sync-capabilities.mjs --check && npm run build && node --import tsx --test test/*.test.ts && npm run test:types && npm run test:components",
72
+ "check:migrations": "node scripts/check-migrations.mjs",
73
+ "prepublishOnly": "npm run check:migrations",
74
+ "test:types": "tsc -p tsconfig.examples.json && tsc -p tsconfig.server.json && tsc -p tsconfig.cjs.json",
75
+ "test:browser": "node test/browser/verify.mjs && node test/browser/ui-verify.mjs",
76
+ "test:components": "vitest run",
77
+ "docs:exports": "node scripts/doc-exports.mjs"
78
+ },
69
79
  "dependencies": {
70
80
  "@lark-base-open/base-site-channel": "0.2.1",
71
81
  "@radix-ui/react-popover": "1.2.0",
@@ -84,6 +94,21 @@
84
94
  "optional": true
85
95
  }
86
96
  },
97
+ "devDependencies": {
98
+ "@testing-library/react": "16.3.0",
99
+ "@types/node": "22.15.0",
100
+ "@types/react": "19.2.17",
101
+ "@types/react-dom": "19.2.3",
102
+ "clean-publish": "7.1.0",
103
+ "jsdom": "26.1.0",
104
+ "msw": "2.11.6",
105
+ "pngjs": "7.0.0",
106
+ "tsup": "6.7.0",
107
+ "tsx": "4.20.3",
108
+ "typescript": "5.8.3",
109
+ "vitest": "3.2.4",
110
+ "zod": "4.2.1"
111
+ },
87
112
  "typesVersions": {
88
113
  "*": {
89
114
  "server": [
@@ -96,5 +121,11 @@
96
121
  "dist/codegen.d.cts"
97
122
  ]
98
123
  }
124
+ },
125
+ "clean-publish": {
126
+ "fields": [
127
+ "scripts"
128
+ ],
129
+ "beforeScript": "./scripts/prepare-publish.mjs"
99
130
  }
100
131
  }