run402-mcp 3.7.1 → 3.7.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -0
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -1
- package/dist/tools/function-runs.d.ts +172 -0
- package/dist/tools/function-runs.d.ts.map +1 -0
- package/dist/tools/function-runs.js +243 -0
- package/dist/tools/function-runs.js.map +1 -0
- package/dist/tools/get-function-logs.js +3 -3
- package/dist/tools/get-function-logs.js.map +1 -1
- package/package.json +1 -1
- package/sdk/README.md +15 -1
- package/sdk/dist/index.d.ts +5 -0
- package/sdk/dist/index.d.ts.map +1 -1
- package/sdk/dist/index.js +13 -0
- package/sdk/dist/index.js.map +1 -1
- package/sdk/dist/namespaces/functions.d.ts +25 -1
- package/sdk/dist/namespaces/functions.d.ts.map +1 -1
- package/sdk/dist/namespaces/functions.js +272 -2
- package/sdk/dist/namespaces/functions.js.map +1 -1
- package/sdk/dist/namespaces/functions.types.d.ts +87 -1
- package/sdk/dist/namespaces/functions.types.d.ts.map +1 -1
- package/sdk/dist/scoped.d.ts +14 -1
- package/sdk/dist/scoped.d.ts.map +1 -1
- package/sdk/dist/scoped.js +31 -0
- package/sdk/dist/scoped.js.map +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { getSdk } from "../sdk.js";
|
|
3
3
|
import { mapSdkError } from "../errors.js";
|
|
4
|
-
const FUNCTION_LOG_REQUEST_ID_RE = /^
|
|
4
|
+
const FUNCTION_LOG_REQUEST_ID_RE = /^(?:req|fnrun|fnatt)_[A-Za-z0-9_-]{4,128}$/;
|
|
5
5
|
export const getFunctionLogsSchema = {
|
|
6
6
|
project_id: z.string().describe("The project ID"),
|
|
7
7
|
name: z.string().describe("Function name to get logs for"),
|
|
@@ -15,9 +15,9 @@ export const getFunctionLogsSchema = {
|
|
|
15
15
|
.describe("Only return logs at or after this ISO 8601 timestamp (e.g. 2026-03-29T14:00:00Z). Invalid timestamps are rejected before the API call."),
|
|
16
16
|
request_id: z
|
|
17
17
|
.string()
|
|
18
|
-
.regex(FUNCTION_LOG_REQUEST_ID_RE, "Must be a Run402 request id like req_abc123")
|
|
18
|
+
.regex(FUNCTION_LOG_REQUEST_ID_RE, "Must be a Run402 request/run/attempt id like req_abc123, fnrun_abc123, or fnatt_abc123")
|
|
19
19
|
.optional()
|
|
20
|
-
.describe("Only return logs correlated to this routed
|
|
20
|
+
.describe("Only return logs correlated to this routed request id, function run id, or attempt id, such as req_abc123, fnrun_abc123, or fnatt_abc123."),
|
|
21
21
|
};
|
|
22
22
|
export async function handleGetFunctionLogs(args) {
|
|
23
23
|
try {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-function-logs.js","sourceRoot":"","sources":["../../src/tools/get-function-logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,0BAA0B,GAAG,
|
|
1
|
+
{"version":3,"file":"get-function-logs.js","sourceRoot":"","sources":["../../src/tools/get-function-logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,0BAA0B,GAAG,4CAA4C,CAAC;AAEhF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC1D,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,wIAAwI,CACzI;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,KAAK,CAAC,0BAA0B,EAAE,wFAAwF,CAAC;SAC3H,QAAQ,EAAE;SACV,QAAQ,CAAC,2IAA2I,CAAC;CACzJ,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAM3C;IACC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE;YACrE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,UAAU;SAC3B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,qBAAqB,IAAI,CAAC,IAAI,kEAAkE;qBACvG;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAEzC,MAAM,KAAK,GAAG;YACZ,qBAAqB,IAAI,CAAC,IAAI,EAAE;YAChC,EAAE;YACF,QAAQ;YACR,GAAG,QAAQ;YACX,QAAQ;YACR,EAAE;YACF,IAAI,IAAI,CAAC,MAAM,eAAe;SAC/B,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAOtB;IACC,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI;QACtD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QAChD,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI;QAC5D,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI;KAC7D,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,OAAO,IAAI,GAAG,CAAC,SAAS,IAAI,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;AACtD,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "run402-mcp",
|
|
3
|
-
"version": "3.7.
|
|
3
|
+
"version": "3.7.2",
|
|
4
4
|
"description": "MCP server for Run402 — AI-native Postgres databases with REST API, auth, storage, and row-level security. Pay with x402 USDC micropayments.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
package/sdk/README.md
CHANGED
|
@@ -125,7 +125,7 @@ The `CredentialsProvider` interface has two required methods (`getAuth`, `getPro
|
|
|
125
125
|
| `r.project(id).sites` | `deployDir` — Node entry only (`@run402/sdk/node`); thin wrapper over `r.project(id).apply({ site: dir(...) })` |
|
|
126
126
|
| `r.project(id).assets` | `put` (single asset), `putMany`, `uploadDir` (Node, additive), `syncDir` (Node, destructive only with `prune: true` + confirm token), `prepareDir` (returns `{ manifest, applySlice }` for pre-commit URL injection), `get`, `ls`, `rm`, `sign`, `diagnoseUrl`, `waitFresh`, `diff`. Returns `AssetRef` (single) or `AssetManifest` (batch). |
|
|
127
127
|
| `cache` (v1.52+) | SSR origin ISR cache: `invalidate(url)`, `invalidatePrefix({ host, prefix })`, `invalidateAll({ host })`, `invalidateMany(urls)`, `inspect(url)`. Project-scoped (host ownership validated server-side; cross-project hosts throw `R402_CACHE_INVALIDATION_HOST_FORBIDDEN`). Generation-guarded — in-flight MISS renders started before an invalidate cannot overwrite the freshly-cleared state. |
|
|
128
|
-
| `functions` | `deploy`, `invoke`, `logs`, `update`, `list`, `delete` |
|
|
128
|
+
| `functions` | `deploy`, `invoke`, `logs`, `update`, `list`, `delete`, `rebuild`, `rebuildAll`, `runs.*` durable function requests |
|
|
129
129
|
| `jobs` | `submit`, `get`, `logs`, `cancel`, `purge` for platform-managed jobs |
|
|
130
130
|
| `secrets` | `set`, `list`, `delete` |
|
|
131
131
|
| `subdomains` | `claim`, `list`, `delete` (most agents declare subdomains in `r.project(id).apply({ subdomains: { set: [...] } })` instead) |
|
|
@@ -151,6 +151,20 @@ and common command names such as `r.billing.balance`, `r.auth.magicLink`,
|
|
|
151
151
|
`r.projects.schema`, `r.email.create`, and `r.contracts.setAlert` point at the
|
|
152
152
|
canonical camelCase methods.
|
|
153
153
|
|
|
154
|
+
Durable function requests live under `r.functions.runs` and the scoped project handle. They require an idempotency key and support immediate, delayed, or absolute-time execution, retry policy, logs, cancellation, redrive, and polling:
|
|
155
|
+
|
|
156
|
+
```ts
|
|
157
|
+
const p = await r.project(projectId);
|
|
158
|
+
const run = await p.functions.runs.create("worker", {
|
|
159
|
+
eventType: "reminder.send",
|
|
160
|
+
payload: { message_id: "msg_123" },
|
|
161
|
+
idempotencyKey: r.idempotency.fromParts("reminder", "msg_123"),
|
|
162
|
+
delay: "10m",
|
|
163
|
+
retry: r.functions.retry.standard({ maxAttempts: 3 }),
|
|
164
|
+
});
|
|
165
|
+
await p.functions.runs.wait(run.run_id);
|
|
166
|
+
```
|
|
167
|
+
|
|
154
168
|
### Casing in returned shapes
|
|
155
169
|
|
|
156
170
|
Two casings coexist by design — agents reading the type surface should
|
package/sdk/dist/index.d.ts
CHANGED
|
@@ -99,6 +99,9 @@ export declare class Run402 {
|
|
|
99
99
|
* project-scoped as `r.project(id).grants`.
|
|
100
100
|
*/
|
|
101
101
|
readonly grants: Grants;
|
|
102
|
+
readonly idempotency: {
|
|
103
|
+
fromParts: typeof fromParts;
|
|
104
|
+
};
|
|
102
105
|
constructor(opts: Run402Options);
|
|
103
106
|
/**
|
|
104
107
|
* Return a project-scoped sub-client where every project-id-bearing namespace
|
|
@@ -186,6 +189,7 @@ export interface WhoAmI {
|
|
|
186
189
|
* });
|
|
187
190
|
*/
|
|
188
191
|
export declare function files(record: Record<string, ContentSource>): FileSet;
|
|
192
|
+
export declare function fromParts(...parts: Array<string | number | boolean | null | undefined>): string;
|
|
189
193
|
/**
|
|
190
194
|
* Factory wrapper equivalent to `new Run402(opts)`. Reads better in code-mode
|
|
191
195
|
* sandbox examples: `const r = run402({ ... })`.
|
|
@@ -225,6 +229,7 @@ export { Deploy } from "./namespaces/deploy.js";
|
|
|
225
229
|
export type { ByteReader } from "./namespaces/deploy.js";
|
|
226
230
|
export type * from "./namespaces/domains.js";
|
|
227
231
|
export type * from "./namespaces/email.js";
|
|
232
|
+
export { FunctionRunTerminalError, FunctionRuns } from "./namespaces/functions.js";
|
|
228
233
|
export type * from "./namespaces/functions.types.js";
|
|
229
234
|
export type * from "./namespaces/jobs.js";
|
|
230
235
|
export type * from "./namespaces/operator.js";
|
package/sdk/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/sdk/dist/index.js
CHANGED
|
@@ -86,6 +86,9 @@ export class Run402 {
|
|
|
86
86
|
* project-scoped as `r.project(id).grants`.
|
|
87
87
|
*/
|
|
88
88
|
grants;
|
|
89
|
+
idempotency = {
|
|
90
|
+
fromParts,
|
|
91
|
+
};
|
|
89
92
|
#client;
|
|
90
93
|
constructor(opts) {
|
|
91
94
|
if (!opts || typeof opts !== "object") {
|
|
@@ -254,6 +257,15 @@ export class Run402 {
|
|
|
254
257
|
export function files(record) {
|
|
255
258
|
return record;
|
|
256
259
|
}
|
|
260
|
+
export function fromParts(...parts) {
|
|
261
|
+
const cleaned = parts
|
|
262
|
+
.filter((part) => part !== undefined && part !== null && String(part).trim() !== "")
|
|
263
|
+
.map((part) => encodeURIComponent(String(part)));
|
|
264
|
+
if (cleaned.length === 0) {
|
|
265
|
+
throw new LocalError("idempotency.fromParts requires at least one non-empty part", "building idempotency key");
|
|
266
|
+
}
|
|
267
|
+
return cleaned.join(":");
|
|
268
|
+
}
|
|
257
269
|
/**
|
|
258
270
|
* Factory wrapper equivalent to `new Run402(opts)`. Reads better in code-mode
|
|
259
271
|
* sandbox examples: `const r = run402({ ... })`.
|
|
@@ -272,6 +284,7 @@ export { Ci, CI_AUDIENCE, CI_BINDING_REVOKED_ERROR, CI_GITHUB_ACTIONS_ISSUER, CI
|
|
|
272
284
|
export { ScopedRun402 } from "./scoped.js";
|
|
273
285
|
export { Transfers } from "./namespaces/transfers.js";
|
|
274
286
|
export { Deploy } from "./namespaces/deploy.js";
|
|
287
|
+
export { FunctionRunTerminalError, FunctionRuns } from "./namespaces/functions.js";
|
|
275
288
|
export { OperatorSession } from "./namespaces/operator-session.js";
|
|
276
289
|
export { Orgs, ScopedOrg, OrgMembers, OrgInvites } from "./namespaces/org.js";
|
|
277
290
|
export { Grants } from "./namespaces/grants.js";
|
package/sdk/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAkC,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAezC,MAAM,OAAO,MAAM;IACR,QAAQ,CAAW;IACnB,MAAM,CAAS;IACf,SAAS,CAAY;IACrB,OAAO,CAAU;IACjB,KAAK,CAAQ;IACb,UAAU,CAAa;IACvB,OAAO,CAAU;IACjB,KAAK,CAAQ;IACb,OAAO,CAAU;IACjB,IAAI,CAAO;IACX,SAAS,CAAY;IACrB,EAAE,CAAK;IACP,KAAK,CAAM;IACX,IAAI,CAAO;IACX,YAAY,CAAe;IAC3B,OAAO,CAAU;IACjB,OAAO,CAAU;IACjB,IAAI,CAAO;IACX,KAAK,CAAQ;IACb,SAAS,CAAY;IACrB,KAAK,CAAQ;IACtB;;;;;;OAMG;IACM,YAAY,CAAS;IACrB,EAAE,CAAK;IACP,IAAI,CAAO;IACX,QAAQ,CAAW;IAC5B;;;OAGG;IACM,QAAQ,CAAW;IAC5B;;;;;;OAMG;IACM,IAAI,CAAO;IACpB;;;OAGG;IACM,MAAM,CAAS;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -9,9 +9,22 @@
|
|
|
9
9
|
* (wallet-authed, capability `function-runtime-rebuild`).
|
|
10
10
|
*/
|
|
11
11
|
import type { Client } from "../kernel.js";
|
|
12
|
-
import type { DeleteFunctionResult, FunctionDeployOptions, FunctionDeployResult, FunctionInvokeOptions, FunctionInvokeResult, FunctionListResult, FunctionLogsOptions, FunctionLogsResult, FunctionRebuildBatchResult, FunctionRebuildResult, FunctionUpdateOptions, FunctionUpdateResult } from "./functions.types.js";
|
|
12
|
+
import type { DeleteFunctionResult, FunctionDeployOptions, FunctionDeployResult, FunctionInvokeOptions, FunctionInvokeResult, FunctionListResult, FunctionLogsOptions, FunctionLogsResult, FunctionRunCreateOptions, FunctionRunHandle, FunctionRunListOptions, FunctionRunListResult, FunctionRunLogsOptions, FunctionRunRedriveOptions, FunctionRunRetryPolicy, FunctionRunWaitOptions, FunctionRebuildBatchResult, FunctionRebuildResult, FunctionUpdateOptions, FunctionUpdateResult } from "./functions.types.js";
|
|
13
|
+
export declare class FunctionRunTerminalError extends Error {
|
|
14
|
+
readonly run: FunctionRunHandle;
|
|
15
|
+
readonly code?: string;
|
|
16
|
+
constructor(run: FunctionRunHandle);
|
|
17
|
+
}
|
|
13
18
|
export declare class Functions {
|
|
14
19
|
private readonly client;
|
|
20
|
+
readonly runs: FunctionRuns;
|
|
21
|
+
readonly retry: {
|
|
22
|
+
standard: (opts?: {
|
|
23
|
+
maxAttempts?: number;
|
|
24
|
+
minDelaySeconds?: number;
|
|
25
|
+
maxDelaySeconds?: number;
|
|
26
|
+
}) => FunctionRunRetryPolicy;
|
|
27
|
+
};
|
|
15
28
|
constructor(client: Client);
|
|
16
29
|
/**
|
|
17
30
|
* Deploy a serverless function through the unified apply engine. Builds a
|
|
@@ -104,4 +117,15 @@ export declare class Functions {
|
|
|
104
117
|
*/
|
|
105
118
|
rebuildAll(projectId: string): Promise<FunctionRebuildBatchResult>;
|
|
106
119
|
}
|
|
120
|
+
export declare class FunctionRuns {
|
|
121
|
+
private readonly client;
|
|
122
|
+
constructor(client: Client);
|
|
123
|
+
create(projectId: string, functionName: string, opts: FunctionRunCreateOptions): Promise<FunctionRunHandle>;
|
|
124
|
+
list(projectId: string, functionName: string, opts?: FunctionRunListOptions): Promise<FunctionRunListResult>;
|
|
125
|
+
get(projectId: string, runId: string): Promise<FunctionRunHandle>;
|
|
126
|
+
logs(projectId: string, runId: string, opts?: FunctionRunLogsOptions): Promise<FunctionLogsResult>;
|
|
127
|
+
cancel(projectId: string, runId: string): Promise<FunctionRunHandle>;
|
|
128
|
+
redrive(projectId: string, runId: string, opts?: FunctionRunRedriveOptions): Promise<FunctionRunHandle>;
|
|
129
|
+
wait(projectId: string, runId: string, opts?: FunctionRunWaitOptions): Promise<FunctionRunHandle>;
|
|
130
|
+
}
|
|
107
131
|
//# sourceMappingURL=functions.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/namespaces/functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAgB9B,qBAAa,SAAS;
|
|
1
|
+
{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/namespaces/functions.ts"],"names":[],"mappings":"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"}
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
import { LocalError, ProjectNotFound } from "../errors.js";
|
|
12
12
|
import { Deploy } from "./deploy.js";
|
|
13
13
|
const FUNCTION_NAME_RE = /^[a-z0-9][a-z0-9_-]{0,127}$/;
|
|
14
|
-
const FUNCTION_LOG_REQUEST_ID_RE = /^
|
|
14
|
+
const FUNCTION_LOG_REQUEST_ID_RE = /^(?:req|fnrun|fnatt)_[A-Za-z0-9_-]{4,128}$/;
|
|
15
15
|
const ISO_DATE_TIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}:\d{2})$/;
|
|
16
16
|
const FUNCTION_LOG_TAIL_MAX = 1000;
|
|
17
17
|
const FUNCTION_DEP_MAX = 30;
|
|
@@ -23,10 +23,31 @@ const DISALLOWED_FUNCTION_DEPS = new Set([
|
|
|
23
23
|
"canvas",
|
|
24
24
|
"bcrypt",
|
|
25
25
|
]);
|
|
26
|
+
export class FunctionRunTerminalError extends Error {
|
|
27
|
+
run;
|
|
28
|
+
code;
|
|
29
|
+
constructor(run) {
|
|
30
|
+
const message = run.last_error?.message ?? `Function run ${run.run_id} reached terminal status ${run.status}`;
|
|
31
|
+
super(message);
|
|
32
|
+
this.name = "FunctionRunTerminalError";
|
|
33
|
+
this.run = run;
|
|
34
|
+
this.code = run.last_error?.code;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
26
37
|
export class Functions {
|
|
27
38
|
client;
|
|
39
|
+
runs;
|
|
40
|
+
retry = {
|
|
41
|
+
standard: (opts = {}) => ({
|
|
42
|
+
preset: "standard",
|
|
43
|
+
...(opts.maxAttempts !== undefined ? { maxAttempts: opts.maxAttempts } : {}),
|
|
44
|
+
...(opts.minDelaySeconds !== undefined ? { minDelaySeconds: opts.minDelaySeconds } : {}),
|
|
45
|
+
...(opts.maxDelaySeconds !== undefined ? { maxDelaySeconds: opts.maxDelaySeconds } : {}),
|
|
46
|
+
}),
|
|
47
|
+
};
|
|
28
48
|
constructor(client) {
|
|
29
49
|
this.client = client;
|
|
50
|
+
this.runs = new FunctionRuns(client);
|
|
30
51
|
}
|
|
31
52
|
/**
|
|
32
53
|
* Deploy a serverless function through the unified apply engine. Builds a
|
|
@@ -269,6 +290,129 @@ export class Functions {
|
|
|
269
290
|
});
|
|
270
291
|
}
|
|
271
292
|
}
|
|
293
|
+
export class FunctionRuns {
|
|
294
|
+
client;
|
|
295
|
+
constructor(client) {
|
|
296
|
+
this.client = client;
|
|
297
|
+
}
|
|
298
|
+
async create(projectId, functionName, opts) {
|
|
299
|
+
validateFunctionName(functionName, "functionName", "creating function run");
|
|
300
|
+
const project = await this.client.getProject(projectId);
|
|
301
|
+
if (!project)
|
|
302
|
+
throw new ProjectNotFound(projectId, "creating function run");
|
|
303
|
+
const body = normalizeFunctionRunCreate(opts, "creating function run");
|
|
304
|
+
return this.client.request(`/functions/v1/${encodeURIComponent(functionName)}/runs`, {
|
|
305
|
+
method: "POST",
|
|
306
|
+
headers: {
|
|
307
|
+
Authorization: `Bearer ${project.service_key}`,
|
|
308
|
+
"Idempotency-Key": body.idempotency_key,
|
|
309
|
+
},
|
|
310
|
+
body,
|
|
311
|
+
context: "creating function run",
|
|
312
|
+
});
|
|
313
|
+
}
|
|
314
|
+
async list(projectId, functionName, opts = {}) {
|
|
315
|
+
validateFunctionName(functionName, "functionName", "listing function runs");
|
|
316
|
+
const project = await this.client.getProject(projectId);
|
|
317
|
+
if (!project)
|
|
318
|
+
throw new ProjectNotFound(projectId, "listing function runs");
|
|
319
|
+
const search = new URLSearchParams();
|
|
320
|
+
if (opts.status !== undefined) {
|
|
321
|
+
validateFunctionRunStatus(opts.status, "status", "listing function runs");
|
|
322
|
+
search.set("status", opts.status);
|
|
323
|
+
}
|
|
324
|
+
if (opts.eventType !== undefined) {
|
|
325
|
+
validateNonEmptyString(opts.eventType, "eventType", "listing function runs");
|
|
326
|
+
search.set("event_type", opts.eventType);
|
|
327
|
+
}
|
|
328
|
+
if (opts.since !== undefined)
|
|
329
|
+
search.set("since", isoOrEpochString(opts.since, "since", "listing function runs"));
|
|
330
|
+
if (opts.until !== undefined)
|
|
331
|
+
search.set("until", isoOrEpochString(opts.until, "until", "listing function runs"));
|
|
332
|
+
if (opts.limit !== undefined) {
|
|
333
|
+
validatePositiveJsonInteger(opts.limit, "limit", "listing function runs", { max: 100 });
|
|
334
|
+
search.set("limit", String(opts.limit));
|
|
335
|
+
}
|
|
336
|
+
if (opts.cursor !== undefined) {
|
|
337
|
+
validateNonEmptyString(opts.cursor, "cursor", "listing function runs");
|
|
338
|
+
search.set("cursor", opts.cursor);
|
|
339
|
+
}
|
|
340
|
+
const qs = search.toString();
|
|
341
|
+
return this.client.request(`/functions/v1/${encodeURIComponent(functionName)}/runs${qs ? `?${qs}` : ""}`, {
|
|
342
|
+
headers: { Authorization: `Bearer ${project.service_key}` },
|
|
343
|
+
context: "listing function runs",
|
|
344
|
+
});
|
|
345
|
+
}
|
|
346
|
+
async get(projectId, runId) {
|
|
347
|
+
const project = await this.client.getProject(projectId);
|
|
348
|
+
if (!project)
|
|
349
|
+
throw new ProjectNotFound(projectId, "fetching function run");
|
|
350
|
+
validateFunctionRunId(runId, "runId", "fetching function run");
|
|
351
|
+
return this.client.request(`/functions/v1/runs/${encodeURIComponent(runId)}`, {
|
|
352
|
+
headers: { Authorization: `Bearer ${project.service_key}` },
|
|
353
|
+
context: "fetching function run",
|
|
354
|
+
});
|
|
355
|
+
}
|
|
356
|
+
async logs(projectId, runId, opts = {}) {
|
|
357
|
+
const project = await this.client.getProject(projectId);
|
|
358
|
+
if (!project)
|
|
359
|
+
throw new ProjectNotFound(projectId, "fetching function run logs");
|
|
360
|
+
validateFunctionRunId(runId, "runId", "fetching function run logs");
|
|
361
|
+
const tail = opts.tail ?? 50;
|
|
362
|
+
validatePositiveJsonInteger(tail, "tail", "fetching function run logs", { max: FUNCTION_LOG_TAIL_MAX });
|
|
363
|
+
const search = new URLSearchParams({ tail: String(tail) });
|
|
364
|
+
if (opts.since !== undefined)
|
|
365
|
+
search.set("since", isoOrEpochString(opts.since, "since", "fetching function run logs"));
|
|
366
|
+
return this.client.request(`/functions/v1/runs/${encodeURIComponent(runId)}/logs?${search.toString()}`, {
|
|
367
|
+
headers: { Authorization: `Bearer ${project.service_key}` },
|
|
368
|
+
context: "fetching function run logs",
|
|
369
|
+
});
|
|
370
|
+
}
|
|
371
|
+
async cancel(projectId, runId) {
|
|
372
|
+
const project = await this.client.getProject(projectId);
|
|
373
|
+
if (!project)
|
|
374
|
+
throw new ProjectNotFound(projectId, "cancelling function run");
|
|
375
|
+
validateFunctionRunId(runId, "runId", "cancelling function run");
|
|
376
|
+
return this.client.request(`/functions/v1/runs/${encodeURIComponent(runId)}/cancel`, {
|
|
377
|
+
method: "POST",
|
|
378
|
+
headers: { Authorization: `Bearer ${project.service_key}` },
|
|
379
|
+
context: "cancelling function run",
|
|
380
|
+
});
|
|
381
|
+
}
|
|
382
|
+
async redrive(projectId, runId, opts = {}) {
|
|
383
|
+
const project = await this.client.getProject(projectId);
|
|
384
|
+
if (!project)
|
|
385
|
+
throw new ProjectNotFound(projectId, "redriving function run");
|
|
386
|
+
validateFunctionRunId(runId, "runId", "redriving function run");
|
|
387
|
+
const body = {};
|
|
388
|
+
if (opts.retry !== undefined)
|
|
389
|
+
body.retry = normalizeRetry(opts.retry);
|
|
390
|
+
return this.client.request(`/functions/v1/runs/${encodeURIComponent(runId)}/redrive`, {
|
|
391
|
+
method: "POST",
|
|
392
|
+
headers: { Authorization: `Bearer ${project.service_key}` },
|
|
393
|
+
body,
|
|
394
|
+
context: "redriving function run",
|
|
395
|
+
});
|
|
396
|
+
}
|
|
397
|
+
async wait(projectId, runId, opts = {}) {
|
|
398
|
+
const deadline = Date.now() + (opts.timeoutMs ?? 300_000);
|
|
399
|
+
const intervalMs = opts.intervalMs ?? 1000;
|
|
400
|
+
const throwOnFailure = opts.throwOnFailure ?? true;
|
|
401
|
+
for (;;) {
|
|
402
|
+
const run = await this.get(projectId, runId);
|
|
403
|
+
if (run.terminal) {
|
|
404
|
+
if (throwOnFailure && run.status !== "succeeded") {
|
|
405
|
+
throw new FunctionRunTerminalError(run);
|
|
406
|
+
}
|
|
407
|
+
return run;
|
|
408
|
+
}
|
|
409
|
+
if (Date.now() >= deadline) {
|
|
410
|
+
throw new LocalError(`Timed out waiting for function run ${runId}`, "waiting for function run");
|
|
411
|
+
}
|
|
412
|
+
await sleep(Math.max(0, intervalMs));
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
}
|
|
272
416
|
function parseLogSince(since) {
|
|
273
417
|
const raw = since.trim();
|
|
274
418
|
const ms = /^\d+$/.test(raw)
|
|
@@ -281,6 +425,132 @@ function parseLogSince(since) {
|
|
|
281
425
|
}
|
|
282
426
|
return ms;
|
|
283
427
|
}
|
|
428
|
+
function normalizeFunctionRunCreate(opts, context) {
|
|
429
|
+
if (!opts || typeof opts !== "object") {
|
|
430
|
+
throw new LocalError("function run options must be an object", context);
|
|
431
|
+
}
|
|
432
|
+
validateNonEmptyString(opts.eventType, "eventType", context);
|
|
433
|
+
if (typeof opts.idempotencyKey !== "string" || opts.idempotencyKey.trim() === "") {
|
|
434
|
+
throw new LocalError("idempotencyKey is required for function run creation", context);
|
|
435
|
+
}
|
|
436
|
+
const hasDelay = opts.delay !== undefined || opts.delaySeconds !== undefined;
|
|
437
|
+
if (hasDelay && opts.runAt !== undefined) {
|
|
438
|
+
throw new LocalError("runAt and delay are mutually exclusive for function run creation", context);
|
|
439
|
+
}
|
|
440
|
+
if (opts.delay !== undefined && opts.delaySeconds !== undefined) {
|
|
441
|
+
throw new LocalError("delay and delaySeconds are mutually exclusive for function run creation", context);
|
|
442
|
+
}
|
|
443
|
+
const body = {
|
|
444
|
+
event_type: opts.eventType,
|
|
445
|
+
idempotency_key: opts.idempotencyKey,
|
|
446
|
+
};
|
|
447
|
+
if (opts.payload !== undefined)
|
|
448
|
+
body.payload = validateJsonObject(opts.payload, "payload", context);
|
|
449
|
+
if (opts.runAt !== undefined)
|
|
450
|
+
body.run_at = isoFromDateInput(opts.runAt, "runAt", context);
|
|
451
|
+
if (opts.delay !== undefined)
|
|
452
|
+
body.delay_seconds = parseDurationSeconds(opts.delay, "delay", context);
|
|
453
|
+
if (opts.delaySeconds !== undefined)
|
|
454
|
+
body.delay_seconds = parseDurationSeconds(opts.delaySeconds, "delaySeconds", context);
|
|
455
|
+
if (opts.expiresAt !== undefined)
|
|
456
|
+
body.expires_at = isoFromDateInput(opts.expiresAt, "expiresAt", context);
|
|
457
|
+
if (opts.expiresAfter !== undefined) {
|
|
458
|
+
const seconds = parseDurationSeconds(opts.expiresAfter, "expiresAfter", context);
|
|
459
|
+
body.expires_at = new Date(Date.now() + seconds * 1000).toISOString();
|
|
460
|
+
}
|
|
461
|
+
if (body.expires_at !== undefined) {
|
|
462
|
+
const runAtMs = body.run_at
|
|
463
|
+
? Date.parse(String(body.run_at))
|
|
464
|
+
: Date.now() + Number(body.delay_seconds ?? 0) * 1000;
|
|
465
|
+
if (Date.parse(String(body.expires_at)) <= runAtMs) {
|
|
466
|
+
throw new LocalError("expiresAt/expiresAfter must be after the function run time", context);
|
|
467
|
+
}
|
|
468
|
+
}
|
|
469
|
+
if (opts.retry !== undefined)
|
|
470
|
+
body.retry = normalizeRetry(opts.retry);
|
|
471
|
+
return body;
|
|
472
|
+
}
|
|
473
|
+
function normalizeRetry(retry) {
|
|
474
|
+
return Object.fromEntries(Object.entries({
|
|
475
|
+
...retry,
|
|
476
|
+
...(retry.maxAttempts !== undefined ? { max_attempts: retry.maxAttempts } : {}),
|
|
477
|
+
...(retry.minDelaySeconds !== undefined ? { min_delay_seconds: retry.minDelaySeconds } : {}),
|
|
478
|
+
...(retry.maxDelaySeconds !== undefined ? { max_delay_seconds: retry.maxDelaySeconds } : {}),
|
|
479
|
+
}).filter(([key]) => key !== "maxAttempts" && key !== "minDelaySeconds" && key !== "maxDelaySeconds"));
|
|
480
|
+
}
|
|
481
|
+
function validateJsonObject(value, resource, context) {
|
|
482
|
+
if (value === null || typeof value !== "object" || Array.isArray(value)) {
|
|
483
|
+
throw new LocalError(`${resource} must be a JSON object`, context);
|
|
484
|
+
}
|
|
485
|
+
return value;
|
|
486
|
+
}
|
|
487
|
+
function validateNonEmptyString(value, resource, context) {
|
|
488
|
+
if (typeof value !== "string" || value.trim() === "") {
|
|
489
|
+
throw new LocalError(`${resource} must be a non-empty string`, context);
|
|
490
|
+
}
|
|
491
|
+
}
|
|
492
|
+
function isoFromDateInput(value, resource, context) {
|
|
493
|
+
const date = value instanceof Date ? value : new Date(value);
|
|
494
|
+
if (!Number.isFinite(date.getTime())) {
|
|
495
|
+
throw new LocalError(`${resource} must be an ISO-8601 timestamp`, context);
|
|
496
|
+
}
|
|
497
|
+
return date.toISOString();
|
|
498
|
+
}
|
|
499
|
+
function isoOrEpochString(value, resource, context) {
|
|
500
|
+
const raw = value.trim();
|
|
501
|
+
if (/^\d+$/.test(raw)) {
|
|
502
|
+
const epoch = Number(raw);
|
|
503
|
+
if (Number.isSafeInteger(epoch) && epoch >= 0)
|
|
504
|
+
return raw;
|
|
505
|
+
}
|
|
506
|
+
if (ISO_DATE_TIME_RE.test(raw) && Number.isFinite(Date.parse(raw)))
|
|
507
|
+
return raw;
|
|
508
|
+
throw new LocalError(`${resource} must be an ISO-8601 timestamp or epoch millisecond integer`, context);
|
|
509
|
+
}
|
|
510
|
+
function parseDurationSeconds(value, resource, context) {
|
|
511
|
+
if (typeof value === "number") {
|
|
512
|
+
if (!Number.isFinite(value) || value < 0) {
|
|
513
|
+
throw new LocalError(`${resource} must be a non-negative duration`, context);
|
|
514
|
+
}
|
|
515
|
+
return Math.ceil(value);
|
|
516
|
+
}
|
|
517
|
+
const match = value.trim().match(/^(\d+(?:\.\d+)?)\s*(ms|milliseconds?|s|sec|secs|seconds?|m|min|mins|minutes?|h|hr|hrs|hours?|d|days?)$/i);
|
|
518
|
+
if (!match) {
|
|
519
|
+
throw new LocalError(`${resource} must be a duration such as "10m", "1h", or "3d"`, context);
|
|
520
|
+
}
|
|
521
|
+
const amount = Number(match[1]);
|
|
522
|
+
const unit = match[2].toLowerCase();
|
|
523
|
+
const multiplier = unit.startsWith("ms") ? 0.001 :
|
|
524
|
+
unit.startsWith("s") ? 1 :
|
|
525
|
+
unit.startsWith("m") ? 60 :
|
|
526
|
+
unit.startsWith("h") ? 3600 :
|
|
527
|
+
86400;
|
|
528
|
+
return Math.ceil(amount * multiplier);
|
|
529
|
+
}
|
|
530
|
+
function validateFunctionRunId(value, resource, context) {
|
|
531
|
+
if (typeof value !== "string" || !/^fnrun_[A-Za-z0-9_-]{4,128}$/.test(value)) {
|
|
532
|
+
throw new LocalError(`${resource} must match fnrun_<4-128 url-safe chars>`, context);
|
|
533
|
+
}
|
|
534
|
+
}
|
|
535
|
+
function validateFunctionRunStatus(value, resource, context) {
|
|
536
|
+
const statuses = new Set([
|
|
537
|
+
"scheduled",
|
|
538
|
+
"queued",
|
|
539
|
+
"running",
|
|
540
|
+
"retrying",
|
|
541
|
+
"blocked",
|
|
542
|
+
"succeeded",
|
|
543
|
+
"failed",
|
|
544
|
+
"cancelled",
|
|
545
|
+
"expired",
|
|
546
|
+
]);
|
|
547
|
+
if (typeof value !== "string" || !statuses.has(value)) {
|
|
548
|
+
throw new LocalError(`${resource} must be a function run status`, context);
|
|
549
|
+
}
|
|
550
|
+
}
|
|
551
|
+
function sleep(ms) {
|
|
552
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
553
|
+
}
|
|
284
554
|
function validateFunctionConfig(config, resource, context) {
|
|
285
555
|
if (config === undefined)
|
|
286
556
|
return;
|
|
@@ -354,7 +624,7 @@ function validateFunctionSchedule(value, resource, context) {
|
|
|
354
624
|
}
|
|
355
625
|
function validateFunctionLogRequestId(value, resource, context) {
|
|
356
626
|
if (typeof value !== "string" || !FUNCTION_LOG_REQUEST_ID_RE.test(value)) {
|
|
357
|
-
throw new LocalError(`${resource} must match req_
|
|
627
|
+
throw new LocalError(`${resource} must match req_, fnrun_, or fnatt_ followed by 4-128 url-safe chars`, context);
|
|
358
628
|
}
|
|
359
629
|
}
|
|
360
630
|
function validatePositiveJsonInteger(value, resource, context, opts = {}) {
|