@proompteng/temporal-bun-sdk 0.9.0 → 0.10.0
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 +18 -0
- package/dist/agent-readiness.json +191 -5
- package/dist/production-readiness.json +409 -15
- package/dist/src/activities/lifecycle.d.ts.map +1 -1
- package/dist/src/activities/lifecycle.js +12 -5
- package/dist/src/activities/lifecycle.js.map +1 -1
- package/dist/src/bin/lint-workflows-command.d.ts +3 -3
- package/dist/src/bin/lint-workflows-command.d.ts.map +1 -1
- package/dist/src/bin/lint-workflows-command.js +5 -1
- package/dist/src/bin/lint-workflows-command.js.map +1 -1
- package/dist/src/bin/replay-command.d.ts +2 -2
- package/dist/src/bin/replay-command.d.ts.map +1 -1
- package/dist/src/bin/replay-command.js +9 -5
- package/dist/src/bin/replay-command.js.map +1 -1
- package/dist/src/bin/temporal-bun.d.ts +2 -2
- package/dist/src/client/interceptors.d.ts.map +1 -1
- package/dist/src/client/interceptors.js +1 -1
- package/dist/src/client/interceptors.js.map +1 -1
- package/dist/src/client.d.ts.map +1 -1
- package/dist/src/client.js +102 -35
- package/dist/src/client.js.map +1 -1
- package/dist/src/common/payloads/codecs.d.ts +4 -4
- package/dist/src/common/payloads/codecs.d.ts.map +1 -1
- package/dist/src/config.d.ts +10 -10
- package/dist/src/config.d.ts.map +1 -1
- package/dist/src/interceptors/types.d.ts.map +1 -1
- package/dist/src/interceptors/types.js +6 -4
- package/dist/src/interceptors/types.js.map +1 -1
- package/dist/src/otel/auto-instrumentations-node.d.ts +1 -1
- package/dist/src/otel/auto-instrumentations-node.d.ts.map +1 -1
- package/dist/src/worker/runtime.d.ts.map +1 -1
- package/dist/src/worker/runtime.js +169 -24
- package/dist/src/worker/runtime.js.map +1 -1
- package/dist/src/workflow/command-event-matrix.d.ts +13 -0
- package/dist/src/workflow/command-event-matrix.d.ts.map +1 -0
- package/dist/src/workflow/command-event-matrix.js +158 -0
- package/dist/src/workflow/command-event-matrix.js.map +1 -0
- package/dist/src/workflow/context.d.ts.map +1 -1
- package/dist/src/workflow/context.js +0 -11
- package/dist/src/workflow/context.js.map +1 -1
- package/dist/src/workflow/determinism.d.ts.map +1 -1
- package/dist/src/workflow/determinism.js +27 -1
- package/dist/src/workflow/determinism.js.map +1 -1
- package/dist/src/workflow/executor.d.ts.map +1 -1
- package/dist/src/workflow/executor.js +22 -21
- package/dist/src/workflow/executor.js.map +1 -1
- package/dist/src/workflow/guards.d.ts.map +1 -1
- package/dist/src/workflow/guards.js +141 -48
- package/dist/src/workflow/guards.js.map +1 -1
- package/dist/src/workflow/index.d.ts +1 -0
- package/dist/src/workflow/index.d.ts.map +1 -1
- package/dist/src/workflow/index.js +1 -0
- package/dist/src/workflow/index.js.map +1 -1
- package/docs/agent-adoption-guide.md +42 -1
- package/docs/default-choice-hardening-plan.md +183 -0
- package/docs/feature-matrix.md +23 -21
- package/docs/production-design.md +1 -1
- package/docs/production-readiness-implementation-plan.md +42 -22
- package/docs/semantic-readiness.md +133 -0
- package/docs/support-policy.md +16 -9
- package/package.json +9 -7
package/docs/support-policy.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Temporal Bun SDK Support Policy
|
|
2
2
|
|
|
3
|
-
_Last updated: May
|
|
3
|
+
_Last updated: May 6, 2026_
|
|
4
4
|
|
|
5
5
|
## Supported Runtime Matrix
|
|
6
6
|
|
|
@@ -8,9 +8,9 @@ _Last updated: May 5, 2026_
|
|
|
8
8
|
| --------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
9
9
|
| Bun | `>=1.3.13` | CI pins Bun `1.3.13`; newer Bun releases must pass the SDK test, replay, and load gates before being documented as preferred. |
|
|
10
10
|
| Node | Build tooling only | The worker runtime is Bun TypeScript. Node is used by repository tooling and GitHub Actions setup, not by the published worker runtime. |
|
|
11
|
-
| Temporal Server | Current CI cluster plus pinned dev server histories |
|
|
11
|
+
| Temporal Server | Current CI cluster plus pinned dev server histories | Additional server minor/version coverage requires replay-corpus and integration evidence before being documented as preferred. |
|
|
12
12
|
| Temporal Cloud | Client/worker TLS and mTLS paths are supported when credentials are configured. | Cloud Ops tests remain optional unless credentials are present. |
|
|
13
|
-
| OS/arch | Linux
|
|
13
|
+
| OS/arch | Linux x64 release CI, local macOS development | Additional platforms require package-boundary, build, test, replay, and load evidence. |
|
|
14
14
|
|
|
15
15
|
## Supported Package Boundary
|
|
16
16
|
|
|
@@ -38,11 +38,18 @@ Every release should publish or upload:
|
|
|
38
38
|
- `dist/agent-readiness.json`;
|
|
39
39
|
- replay corpus report;
|
|
40
40
|
- worker load report;
|
|
41
|
+
- async determinism fuzz report;
|
|
42
|
+
- worker soak report;
|
|
41
43
|
- npm pack or publish provenance output.
|
|
42
44
|
|
|
43
45
|
`agent-readiness.json` must not set `recommended: true` until the replay corpus,
|
|
44
|
-
async determinism fuzz,
|
|
45
|
-
|
|
46
|
+
async determinism fuzz, load, soak, CI coverage, package-boundary, and semantic
|
|
47
|
+
concern evidence meet the default-choice thresholds in
|
|
48
|
+
`docs/semantic-readiness.md`.
|
|
49
|
+
|
|
50
|
+
Default-choice evidence is intentionally stricter than publish evidence. A
|
|
51
|
+
release may publish with `recommended: false` so users can opt in, but agents
|
|
52
|
+
must not select it by default until `verify:default-choice` passes.
|
|
46
53
|
|
|
47
54
|
## Known Limits
|
|
48
55
|
|
|
@@ -51,10 +58,10 @@ async determinism fuzz, and soak evidence meet the default-choice thresholds in
|
|
|
51
58
|
- Official SDK internal sandbox behavior is not a compatibility promise. The
|
|
52
59
|
compatibility promise is Temporal protocol behavior plus deterministic replay
|
|
53
60
|
evidence.
|
|
54
|
-
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
61
|
+
- Default-choice status is scoped to Bun-first deployments that accept the
|
|
62
|
+
published gates and support model. It is not a blanket replacement for every
|
|
63
|
+
official SDK use case, and teams with unusual throughput, history size, or
|
|
64
|
+
platform requirements should run an extended soak before rollout.
|
|
58
65
|
|
|
59
66
|
## Security And Reliability Issues
|
|
60
67
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@proompteng/temporal-bun-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.10.0",
|
|
4
4
|
"description": "Temporal SDK for Bun with workers, client, replay tooling, and Temporal Cloud/TLS support.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"bun",
|
|
@@ -82,9 +82,11 @@
|
|
|
82
82
|
"test:load": "bun scripts/run-worker-load.ts",
|
|
83
83
|
"test:soak": "bun scripts/run-worker-soak.ts",
|
|
84
84
|
"evidence:production": "bun scripts/collect-production-evidence.ts",
|
|
85
|
+
"capture:replay-corpus": "bun scripts/capture-replay-corpus.ts",
|
|
85
86
|
"verify:replay-corpus": "bun scripts/verify-replay-corpus.ts",
|
|
86
87
|
"test:coverage": "bun test --coverage",
|
|
87
88
|
"verify:production": "bun run evidence:production && bun test tests/packaging/manifest-packaging.test.ts",
|
|
89
|
+
"verify:default-choice": "TEMPORAL_REQUIRE_DEFAULT_CHOICE=1 bun run evidence:production && bun test tests/packaging/manifest-packaging.test.ts",
|
|
88
90
|
"start:worker": "bun run dist/src/bin/start-worker.js",
|
|
89
91
|
"temporal:start": "bun scripts/start-temporal-cli.ts",
|
|
90
92
|
"temporal:stop": "bun scripts/stop-temporal-cli.ts",
|
|
@@ -93,15 +95,15 @@
|
|
|
93
95
|
"lint:oxlint:type": "oxlint --config ../../.oxlintrc.json --type-aware --tsconfig ./tsconfig.oxlint.json --ignore-pattern tests ."
|
|
94
96
|
},
|
|
95
97
|
"dependencies": {
|
|
96
|
-
"@bufbuild/protobuf": "^2.
|
|
97
|
-
"@connectrpc/connect": "^2.1.
|
|
98
|
-
"@connectrpc/connect-node": "^2.1.
|
|
98
|
+
"@bufbuild/protobuf": "^2.12.0",
|
|
99
|
+
"@connectrpc/connect": "^2.1.1",
|
|
100
|
+
"@connectrpc/connect-node": "^2.1.1",
|
|
99
101
|
"@effect/schema": "^0.75.5",
|
|
100
|
-
"effect": "^3.
|
|
101
|
-
"typescript": "^
|
|
102
|
+
"effect": "^3.21.2",
|
|
103
|
+
"typescript": "^6.0.3"
|
|
102
104
|
},
|
|
103
105
|
"devDependencies": {
|
|
104
|
-
"@types/node": "^
|
|
106
|
+
"@types/node": "^25.6.0",
|
|
105
107
|
"bun-types": "^1.3.13"
|
|
106
108
|
},
|
|
107
109
|
"engines": {
|