@amaster.ai/function-client 1.1.18 → 1.1.20
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/README.md +46 -0
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +12 -2
- package/dist/index.d.ts +12 -2
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1 +1,47 @@
|
|
|
1
1
|
# @amaster.ai/function-client
|
|
2
|
+
|
|
3
|
+
Function invocation client for AMaster edge functions.
|
|
4
|
+
|
|
5
|
+
```ts
|
|
6
|
+
import { createFunctionClient } from "@amaster.ai/function-client";
|
|
7
|
+
|
|
8
|
+
const client = createFunctionClient();
|
|
9
|
+
const result = await client.invoke<{ ok: boolean }>("sendEmail", {
|
|
10
|
+
to: "user@example.com",
|
|
11
|
+
});
|
|
12
|
+
|
|
13
|
+
if (result.error) {
|
|
14
|
+
console.error(result.error.message, result.invocationId);
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
if (result.data) {
|
|
18
|
+
console.log(result.data.ok);
|
|
19
|
+
}
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Invocation Metadata
|
|
23
|
+
|
|
24
|
+
`invoke()` returns the normal `ClientResult` fields plus edge runtime metadata:
|
|
25
|
+
|
|
26
|
+
| Field | Source header | Description |
|
|
27
|
+
| ----------------- | ---------------------------- | ------------------------------------------------------------------ |
|
|
28
|
+
| `invocationId` | `X-AMaster-Invocation-Id` | Unique id for this function call. Use it to query invocation logs. |
|
|
29
|
+
| `functionVersion` | `X-AMaster-Function-Version` | Function version selected by the runtime for this call. |
|
|
30
|
+
|
|
31
|
+
When a function behaves unexpectedly, keep `result.invocationId` with the
|
|
32
|
+
observed response and query the OpenTelemetry runtime logs by that exact id.
|
|
33
|
+
In agent-assisted debugging, use the Scheduler MCP runtime log search tool with
|
|
34
|
+
`invocation_id`:
|
|
35
|
+
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"invocation_id": "inv_xxx",
|
|
39
|
+
"limit": 20
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
For direct HTTP diagnostics, query the Scheduler logs API:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
curl "http://localhost:8080/api/v1/logs/search?invocation_id=${invocationId}&limit=20"
|
|
47
|
+
```
|
package/dist/index.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
'use strict';var httpClient=require('@amaster.ai/http-client');function r(n=httpClient.createHttpClient()){return {invoke(t,e){return
|
|
1
|
+
'use strict';var httpClient=require('@amaster.ai/http-client');var l="x-amaster-invocation-id",s="x-amaster-function-version";function r(n,t){if(!n)return null;if(typeof Headers<"u"&&n instanceof Headers)return n.get(t);if(typeof n=="object"&&"get"in n&&typeof n.get=="function"){let e=n.get(t);return e==null?null:String(e)}if(typeof n=="object"){let i=Object.entries(n).find(([u])=>u.toLowerCase()===t)?.[1];return Array.isArray(i)?i[0]==null?null:String(i[0]):i==null?null:String(i)}return null}function a(n){return {...n,invocationId:r(n.headers,l),functionVersion:r(n.headers,s)}}function f(n=httpClient.createHttpClient()){return {async invoke(t,e){if(!t)return {data:null,error:{message:"Function name is required",status:400},status:400,invocationId:null,functionVersion:null};let o=await n.request({url:`/api/func/${t}`,method:"post",headers:{"Content-Type":"application/json"},data:e??{}});return a(o)}}}exports.createFunctionClient=f;//# sourceMappingURL=index.cjs.map
|
|
2
2
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/function-client.ts"],"names":["createFunctionClient","http","createHttpClient","funcName","params"],"mappings":"+
|
|
1
|
+
{"version":3,"sources":["../src/function-client.ts"],"names":["INVOCATION_ID_HEADER","FUNCTION_VERSION_HEADER","getHeaderValue","headers","key","value","headerKey","withInvocationMetadata","result","createFunctionClient","http","createHttpClient","funcName","params"],"mappings":"+DAEA,IAAMA,CAAAA,CAAuB,yBAAA,CACvBC,EAA0B,4BAAA,CAahC,SAASC,EAAeC,CAAAA,CAAkBC,CAAAA,CAA4B,CACpE,GAAI,CAACD,EACH,OAAO,IAAA,CAGT,GAAI,OAAO,OAAA,CAAY,KAAeA,CAAAA,YAAmB,OAAA,CACvD,OAAOA,CAAAA,CAAQ,GAAA,CAAIC,CAAG,CAAA,CAGxB,GACE,OAAOD,CAAAA,EAAY,QAAA,EACnB,QAASA,CAAAA,EACT,OAAQA,EAA8B,GAAA,EAAQ,UAAA,CAC9C,CACA,IAAME,CAAAA,CAASF,EAAiD,GAAA,CAAIC,CAAG,EACvE,OAAOC,CAAAA,EAAS,KAAO,IAAA,CAAO,MAAA,CAAOA,CAAK,CAC5C,CAEA,GAAI,OAAOF,CAAAA,EAAY,SAAU,CAG/B,IAAME,EAFU,MAAA,CAAO,OAAA,CAAQF,CAAkC,CAAA,CACzC,IAAA,CAAK,CAAC,CAACG,CAAS,IAAMA,CAAAA,CAAU,WAAA,KAAkBF,CAAG,CAAA,GACrD,CAAC,CAAA,CACzB,OAAI,MAAM,OAAA,CAAQC,CAAK,EACdA,CAAAA,CAAM,CAAC,GAAK,IAAA,CAAO,IAAA,CAAO,OAAOA,CAAAA,CAAM,CAAC,CAAC,CAAA,CAE3CA,CAAAA,EAAS,IAAA,CAAO,IAAA,CAAO,OAAOA,CAAK,CAC5C,CAEA,OAAO,IACT,CAEA,SAASE,CAAAA,CAA0BC,EAAsD,CACvF,OAAO,CACL,GAAGA,CAAAA,CACH,aAAcN,CAAAA,CAAeM,CAAAA,CAAO,QAASR,CAAoB,CAAA,CACjE,gBAAiBE,CAAAA,CAAeM,CAAAA,CAAO,QAASP,CAAuB,CACzE,CACF,CAoBO,SAASQ,EAAqBC,CAAAA,CAAmBC,2BAAAA,GAAoC,CAC1F,OAAO,CACL,MAAM,MAAA,CACJC,EACAC,CAAAA,CACsC,CACtC,GAAI,CAACD,CAAAA,CACH,OAAO,CACL,IAAA,CAAM,KACN,KAAA,CAAO,CAAE,QAAS,2BAAA,CAA6B,MAAA,CAAQ,GAAI,CAAA,CAC3D,MAAA,CAAQ,IACR,YAAA,CAAc,IAAA,CACd,gBAAiB,IACnB,CAAA,CAEF,IAAMJ,CAAAA,CAAS,MAAME,EAAK,OAAA,CAAW,CACnC,IAAK,CAAA,UAAA,EAAaE,CAAQ,GAC1B,MAAA,CAAQ,MAAA,CACR,QAAS,CAAE,cAAA,CAAgB,kBAAmB,CAAA,CAC9C,IAAA,CAAMC,GAAU,EAClB,CAAC,CAAA,CACD,OAAON,EAAuBC,CAAM,CACtC,CACF,CACF","file":"index.cjs","sourcesContent":["import { type ClientResult, createHttpClient, type HttpClient } from \"@amaster.ai/http-client\";\n\nconst INVOCATION_ID_HEADER = \"x-amaster-invocation-id\";\nconst FUNCTION_VERSION_HEADER = \"x-amaster-function-version\";\n\nexport type FunctionInvocationResult<T> = ClientResult<T> & {\n /**\n * Runtime invocation id for this function call. Use it to query invocation logs.\n */\n invocationId: string | null;\n /**\n * Function version selected by the runtime for this call.\n */\n functionVersion: string | null;\n};\n\nfunction getHeaderValue(headers: unknown, key: string): string | null {\n if (!headers) {\n return null;\n }\n\n if (typeof Headers !== \"undefined\" && headers instanceof Headers) {\n return headers.get(key);\n }\n\n if (\n typeof headers === \"object\" &&\n \"get\" in headers &&\n typeof (headers as { get?: unknown }).get === \"function\"\n ) {\n const value = (headers as { get: (header: string) => unknown }).get(key);\n return value == null ? null : String(value);\n }\n\n if (typeof headers === \"object\") {\n const entries = Object.entries(headers as Record<string, unknown>);\n const matched = entries.find(([headerKey]) => headerKey.toLowerCase() === key);\n const value = matched?.[1];\n if (Array.isArray(value)) {\n return value[0] == null ? null : String(value[0]);\n }\n return value == null ? null : String(value);\n }\n\n return null;\n}\n\nfunction withInvocationMetadata<T>(result: ClientResult<T>): FunctionInvocationResult<T> {\n return {\n ...result,\n invocationId: getHeaderValue(result.headers, INVOCATION_ID_HEADER),\n functionVersion: getHeaderValue(result.headers, FUNCTION_VERSION_HEADER),\n };\n}\n\n/**\n * Function 调用客户端\n */\nexport type FunctionClient = {\n /**\n * 调用 function\n * @param funcName 函数名(对应 src/functions/{funcName}/index.ts 目录)\n * @param params 可选参数(会作为 JSON body 发送)\n */\n invoke<T = unknown>(\n funcName: string,\n params?: Record<string, unknown>\n ): Promise<FunctionInvocationResult<T>>;\n};\n\n/**\n * 创建 Function 客户端\n */\nexport function createFunctionClient(http: HttpClient = createHttpClient()): FunctionClient {\n return {\n async invoke<T = unknown>(\n funcName: string,\n params?: Record<string, unknown>\n ): Promise<FunctionInvocationResult<T>> {\n if (!funcName) {\n return {\n data: null,\n error: { message: \"Function name is required\", status: 400 },\n status: 400,\n invocationId: null,\n functionVersion: null,\n };\n }\n const result = await http.request<T>({\n url: `/api/func/${funcName}`,\n method: \"post\",\n headers: { \"Content-Type\": \"application/json\" },\n data: params ?? {},\n });\n return withInvocationMetadata(result);\n },\n };\n}\n"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
import { ClientResult, HttpClient } from '@amaster.ai/http-client';
|
|
2
2
|
|
|
3
|
+
type FunctionInvocationResult<T> = ClientResult<T> & {
|
|
4
|
+
/**
|
|
5
|
+
* Runtime invocation id for this function call. Use it to query invocation logs.
|
|
6
|
+
*/
|
|
7
|
+
invocationId: string | null;
|
|
8
|
+
/**
|
|
9
|
+
* Function version selected by the runtime for this call.
|
|
10
|
+
*/
|
|
11
|
+
functionVersion: string | null;
|
|
12
|
+
};
|
|
3
13
|
/**
|
|
4
14
|
* Function 调用客户端
|
|
5
15
|
*/
|
|
@@ -9,11 +19,11 @@ type FunctionClient = {
|
|
|
9
19
|
* @param funcName 函数名(对应 src/functions/{funcName}/index.ts 目录)
|
|
10
20
|
* @param params 可选参数(会作为 JSON body 发送)
|
|
11
21
|
*/
|
|
12
|
-
invoke<T = unknown>(funcName: string, params?: Record<string, unknown>): Promise<
|
|
22
|
+
invoke<T = unknown>(funcName: string, params?: Record<string, unknown>): Promise<FunctionInvocationResult<T>>;
|
|
13
23
|
};
|
|
14
24
|
/**
|
|
15
25
|
* 创建 Function 客户端
|
|
16
26
|
*/
|
|
17
27
|
declare function createFunctionClient(http?: HttpClient): FunctionClient;
|
|
18
28
|
|
|
19
|
-
export { type FunctionClient, createFunctionClient };
|
|
29
|
+
export { type FunctionClient, type FunctionInvocationResult, createFunctionClient };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
import { ClientResult, HttpClient } from '@amaster.ai/http-client';
|
|
2
2
|
|
|
3
|
+
type FunctionInvocationResult<T> = ClientResult<T> & {
|
|
4
|
+
/**
|
|
5
|
+
* Runtime invocation id for this function call. Use it to query invocation logs.
|
|
6
|
+
*/
|
|
7
|
+
invocationId: string | null;
|
|
8
|
+
/**
|
|
9
|
+
* Function version selected by the runtime for this call.
|
|
10
|
+
*/
|
|
11
|
+
functionVersion: string | null;
|
|
12
|
+
};
|
|
3
13
|
/**
|
|
4
14
|
* Function 调用客户端
|
|
5
15
|
*/
|
|
@@ -9,11 +19,11 @@ type FunctionClient = {
|
|
|
9
19
|
* @param funcName 函数名(对应 src/functions/{funcName}/index.ts 目录)
|
|
10
20
|
* @param params 可选参数(会作为 JSON body 发送)
|
|
11
21
|
*/
|
|
12
|
-
invoke<T = unknown>(funcName: string, params?: Record<string, unknown>): Promise<
|
|
22
|
+
invoke<T = unknown>(funcName: string, params?: Record<string, unknown>): Promise<FunctionInvocationResult<T>>;
|
|
13
23
|
};
|
|
14
24
|
/**
|
|
15
25
|
* 创建 Function 客户端
|
|
16
26
|
*/
|
|
17
27
|
declare function createFunctionClient(http?: HttpClient): FunctionClient;
|
|
18
28
|
|
|
19
|
-
export { type FunctionClient, createFunctionClient };
|
|
29
|
+
export { type FunctionClient, type FunctionInvocationResult, createFunctionClient };
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import {createHttpClient}from'@amaster.ai/http-client';function r(n=createHttpClient()){return {invoke(t,e){return
|
|
1
|
+
import {createHttpClient}from'@amaster.ai/http-client';var l="x-amaster-invocation-id",s="x-amaster-function-version";function r(n,t){if(!n)return null;if(typeof Headers<"u"&&n instanceof Headers)return n.get(t);if(typeof n=="object"&&"get"in n&&typeof n.get=="function"){let e=n.get(t);return e==null?null:String(e)}if(typeof n=="object"){let i=Object.entries(n).find(([u])=>u.toLowerCase()===t)?.[1];return Array.isArray(i)?i[0]==null?null:String(i[0]):i==null?null:String(i)}return null}function a(n){return {...n,invocationId:r(n.headers,l),functionVersion:r(n.headers,s)}}function f(n=createHttpClient()){return {async invoke(t,e){if(!t)return {data:null,error:{message:"Function name is required",status:400},status:400,invocationId:null,functionVersion:null};let o=await n.request({url:`/api/func/${t}`,method:"post",headers:{"Content-Type":"application/json"},data:e??{}});return a(o)}}}export{f as createFunctionClient};//# sourceMappingURL=index.js.map
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/function-client.ts"],"names":["createFunctionClient","http","createHttpClient","funcName","params"],"mappings":"
|
|
1
|
+
{"version":3,"sources":["../src/function-client.ts"],"names":["INVOCATION_ID_HEADER","FUNCTION_VERSION_HEADER","getHeaderValue","headers","key","value","headerKey","withInvocationMetadata","result","createFunctionClient","http","createHttpClient","funcName","params"],"mappings":"uDAEA,IAAMA,CAAAA,CAAuB,yBAAA,CACvBC,EAA0B,4BAAA,CAahC,SAASC,EAAeC,CAAAA,CAAkBC,CAAAA,CAA4B,CACpE,GAAI,CAACD,EACH,OAAO,IAAA,CAGT,GAAI,OAAO,OAAA,CAAY,KAAeA,CAAAA,YAAmB,OAAA,CACvD,OAAOA,CAAAA,CAAQ,GAAA,CAAIC,CAAG,CAAA,CAGxB,GACE,OAAOD,CAAAA,EAAY,QAAA,EACnB,QAASA,CAAAA,EACT,OAAQA,EAA8B,GAAA,EAAQ,UAAA,CAC9C,CACA,IAAME,CAAAA,CAASF,EAAiD,GAAA,CAAIC,CAAG,EACvE,OAAOC,CAAAA,EAAS,KAAO,IAAA,CAAO,MAAA,CAAOA,CAAK,CAC5C,CAEA,GAAI,OAAOF,CAAAA,EAAY,SAAU,CAG/B,IAAME,EAFU,MAAA,CAAO,OAAA,CAAQF,CAAkC,CAAA,CACzC,IAAA,CAAK,CAAC,CAACG,CAAS,IAAMA,CAAAA,CAAU,WAAA,KAAkBF,CAAG,CAAA,GACrD,CAAC,CAAA,CACzB,OAAI,MAAM,OAAA,CAAQC,CAAK,EACdA,CAAAA,CAAM,CAAC,GAAK,IAAA,CAAO,IAAA,CAAO,OAAOA,CAAAA,CAAM,CAAC,CAAC,CAAA,CAE3CA,CAAAA,EAAS,IAAA,CAAO,IAAA,CAAO,OAAOA,CAAK,CAC5C,CAEA,OAAO,IACT,CAEA,SAASE,CAAAA,CAA0BC,EAAsD,CACvF,OAAO,CACL,GAAGA,CAAAA,CACH,aAAcN,CAAAA,CAAeM,CAAAA,CAAO,QAASR,CAAoB,CAAA,CACjE,gBAAiBE,CAAAA,CAAeM,CAAAA,CAAO,QAASP,CAAuB,CACzE,CACF,CAoBO,SAASQ,EAAqBC,CAAAA,CAAmBC,gBAAAA,GAAoC,CAC1F,OAAO,CACL,MAAM,MAAA,CACJC,EACAC,CAAAA,CACsC,CACtC,GAAI,CAACD,CAAAA,CACH,OAAO,CACL,IAAA,CAAM,KACN,KAAA,CAAO,CAAE,QAAS,2BAAA,CAA6B,MAAA,CAAQ,GAAI,CAAA,CAC3D,MAAA,CAAQ,IACR,YAAA,CAAc,IAAA,CACd,gBAAiB,IACnB,CAAA,CAEF,IAAMJ,CAAAA,CAAS,MAAME,EAAK,OAAA,CAAW,CACnC,IAAK,CAAA,UAAA,EAAaE,CAAQ,GAC1B,MAAA,CAAQ,MAAA,CACR,QAAS,CAAE,cAAA,CAAgB,kBAAmB,CAAA,CAC9C,IAAA,CAAMC,GAAU,EAClB,CAAC,CAAA,CACD,OAAON,EAAuBC,CAAM,CACtC,CACF,CACF","file":"index.js","sourcesContent":["import { type ClientResult, createHttpClient, type HttpClient } from \"@amaster.ai/http-client\";\n\nconst INVOCATION_ID_HEADER = \"x-amaster-invocation-id\";\nconst FUNCTION_VERSION_HEADER = \"x-amaster-function-version\";\n\nexport type FunctionInvocationResult<T> = ClientResult<T> & {\n /**\n * Runtime invocation id for this function call. Use it to query invocation logs.\n */\n invocationId: string | null;\n /**\n * Function version selected by the runtime for this call.\n */\n functionVersion: string | null;\n};\n\nfunction getHeaderValue(headers: unknown, key: string): string | null {\n if (!headers) {\n return null;\n }\n\n if (typeof Headers !== \"undefined\" && headers instanceof Headers) {\n return headers.get(key);\n }\n\n if (\n typeof headers === \"object\" &&\n \"get\" in headers &&\n typeof (headers as { get?: unknown }).get === \"function\"\n ) {\n const value = (headers as { get: (header: string) => unknown }).get(key);\n return value == null ? null : String(value);\n }\n\n if (typeof headers === \"object\") {\n const entries = Object.entries(headers as Record<string, unknown>);\n const matched = entries.find(([headerKey]) => headerKey.toLowerCase() === key);\n const value = matched?.[1];\n if (Array.isArray(value)) {\n return value[0] == null ? null : String(value[0]);\n }\n return value == null ? null : String(value);\n }\n\n return null;\n}\n\nfunction withInvocationMetadata<T>(result: ClientResult<T>): FunctionInvocationResult<T> {\n return {\n ...result,\n invocationId: getHeaderValue(result.headers, INVOCATION_ID_HEADER),\n functionVersion: getHeaderValue(result.headers, FUNCTION_VERSION_HEADER),\n };\n}\n\n/**\n * Function 调用客户端\n */\nexport type FunctionClient = {\n /**\n * 调用 function\n * @param funcName 函数名(对应 src/functions/{funcName}/index.ts 目录)\n * @param params 可选参数(会作为 JSON body 发送)\n */\n invoke<T = unknown>(\n funcName: string,\n params?: Record<string, unknown>\n ): Promise<FunctionInvocationResult<T>>;\n};\n\n/**\n * 创建 Function 客户端\n */\nexport function createFunctionClient(http: HttpClient = createHttpClient()): FunctionClient {\n return {\n async invoke<T = unknown>(\n funcName: string,\n params?: Record<string, unknown>\n ): Promise<FunctionInvocationResult<T>> {\n if (!funcName) {\n return {\n data: null,\n error: { message: \"Function name is required\", status: 400 },\n status: 400,\n invocationId: null,\n functionVersion: null,\n };\n }\n const result = await http.request<T>({\n url: `/api/func/${funcName}`,\n method: \"post\",\n headers: { \"Content-Type\": \"application/json\" },\n data: params ?? {},\n });\n return withInvocationMetadata(result);\n },\n };\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@amaster.ai/function-client",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.20",
|
|
4
4
|
"description": "Function invocation client",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.cjs",
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"registry": "https://registry.npmjs.org/"
|
|
30
30
|
},
|
|
31
31
|
"dependencies": {
|
|
32
|
-
"@amaster.ai/http-client": "1.1.
|
|
32
|
+
"@amaster.ai/http-client": "1.1.20"
|
|
33
33
|
},
|
|
34
34
|
"peerDependencies": {
|
|
35
35
|
"axios": "^1.11.0"
|