@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.
Files changed (61) hide show
  1. package/README.md +18 -0
  2. package/dist/agent-readiness.json +191 -5
  3. package/dist/production-readiness.json +409 -15
  4. package/dist/src/activities/lifecycle.d.ts.map +1 -1
  5. package/dist/src/activities/lifecycle.js +12 -5
  6. package/dist/src/activities/lifecycle.js.map +1 -1
  7. package/dist/src/bin/lint-workflows-command.d.ts +3 -3
  8. package/dist/src/bin/lint-workflows-command.d.ts.map +1 -1
  9. package/dist/src/bin/lint-workflows-command.js +5 -1
  10. package/dist/src/bin/lint-workflows-command.js.map +1 -1
  11. package/dist/src/bin/replay-command.d.ts +2 -2
  12. package/dist/src/bin/replay-command.d.ts.map +1 -1
  13. package/dist/src/bin/replay-command.js +9 -5
  14. package/dist/src/bin/replay-command.js.map +1 -1
  15. package/dist/src/bin/temporal-bun.d.ts +2 -2
  16. package/dist/src/client/interceptors.d.ts.map +1 -1
  17. package/dist/src/client/interceptors.js +1 -1
  18. package/dist/src/client/interceptors.js.map +1 -1
  19. package/dist/src/client.d.ts.map +1 -1
  20. package/dist/src/client.js +102 -35
  21. package/dist/src/client.js.map +1 -1
  22. package/dist/src/common/payloads/codecs.d.ts +4 -4
  23. package/dist/src/common/payloads/codecs.d.ts.map +1 -1
  24. package/dist/src/config.d.ts +10 -10
  25. package/dist/src/config.d.ts.map +1 -1
  26. package/dist/src/interceptors/types.d.ts.map +1 -1
  27. package/dist/src/interceptors/types.js +6 -4
  28. package/dist/src/interceptors/types.js.map +1 -1
  29. package/dist/src/otel/auto-instrumentations-node.d.ts +1 -1
  30. package/dist/src/otel/auto-instrumentations-node.d.ts.map +1 -1
  31. package/dist/src/worker/runtime.d.ts.map +1 -1
  32. package/dist/src/worker/runtime.js +169 -24
  33. package/dist/src/worker/runtime.js.map +1 -1
  34. package/dist/src/workflow/command-event-matrix.d.ts +13 -0
  35. package/dist/src/workflow/command-event-matrix.d.ts.map +1 -0
  36. package/dist/src/workflow/command-event-matrix.js +158 -0
  37. package/dist/src/workflow/command-event-matrix.js.map +1 -0
  38. package/dist/src/workflow/context.d.ts.map +1 -1
  39. package/dist/src/workflow/context.js +0 -11
  40. package/dist/src/workflow/context.js.map +1 -1
  41. package/dist/src/workflow/determinism.d.ts.map +1 -1
  42. package/dist/src/workflow/determinism.js +27 -1
  43. package/dist/src/workflow/determinism.js.map +1 -1
  44. package/dist/src/workflow/executor.d.ts.map +1 -1
  45. package/dist/src/workflow/executor.js +22 -21
  46. package/dist/src/workflow/executor.js.map +1 -1
  47. package/dist/src/workflow/guards.d.ts.map +1 -1
  48. package/dist/src/workflow/guards.js +141 -48
  49. package/dist/src/workflow/guards.js.map +1 -1
  50. package/dist/src/workflow/index.d.ts +1 -0
  51. package/dist/src/workflow/index.d.ts.map +1 -1
  52. package/dist/src/workflow/index.js +1 -0
  53. package/dist/src/workflow/index.js.map +1 -1
  54. package/docs/agent-adoption-guide.md +42 -1
  55. package/docs/default-choice-hardening-plan.md +183 -0
  56. package/docs/feature-matrix.md +23 -21
  57. package/docs/production-design.md +1 -1
  58. package/docs/production-readiness-implementation-plan.md +42 -22
  59. package/docs/semantic-readiness.md +133 -0
  60. package/docs/support-policy.md +16 -9
  61. package/package.json +9 -7
@@ -1,6 +1,6 @@
1
1
  # Temporal Bun SDK Support Policy
2
2
 
3
- _Last updated: May 5, 2026_
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 | Replay-corpus expansion must add explicit server minor coverage before the SDK is marked default-choice recommended. |
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 arm64 in CI, local macOS development | Additional platforms require package-boundary, build, test, replay, and load evidence. |
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, and soak evidence meet the default-choice thresholds in
45
- `docs/production-readiness-implementation-plan.md`.
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
- - Long-running default-choice status requires 24-hour soak artifacts and a broad
55
- replay corpus. Until those artifacts exist, agents should treat the SDK as
56
- production-capable for Bun-first deployments that accept the published gates,
57
- not as a blanket replacement for every official SDK use case.
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.9.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.1.0",
97
- "@connectrpc/connect": "^2.1.0",
98
- "@connectrpc/connect-node": "^2.1.0",
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.19.18",
101
- "typescript": "^5.9.3"
102
+ "effect": "^3.21.2",
103
+ "typescript": "^6.0.3"
102
104
  },
103
105
  "devDependencies": {
104
- "@types/node": "^22.7.5",
106
+ "@types/node": "^25.6.0",
105
107
  "bun-types": "^1.3.13"
106
108
  },
107
109
  "engines": {