Add core TypeScript submodules: cron, retry, rate-limit, and crypto by bradleyshep · Pull Request #5903 · clockworklabs/SpacetimeDB

bradleyshep · 2026-09-09T18:29:18Z

Description of Changes

Adds reusable scheduling, retry, rate-limit, and cryptographic helpers for SpacetimeDB TypeScript modules.

Cron: calendar and interval jobs with typed arguments, time zones, and run history.
Retry: scheduled attempts, exponential backoff, and attempt history.
Rate-limit: fixed-window limits with configuration and administrative controls.
Crypto: hashing, encoding, and webhook-signature helpers.
Shared example UI/server support, package documentation, tests, and examples.
Registers the packages in the pnpm workspace and existing lint/build commands. Adds a submodule CI job for type checks, tests, and builds.

This is the prerequisite branch for the remaining submodule groups. It is based on master commit 3653d2ed4.

Example screenshots

Existing example screenshots from #5823:

Cron

Rate Limit

API and ABI breaking changes

No existing SpacetimeDB API or ABI is changed. This adds new TypeScript package APIs that need review before merge.

Rollback safety impact

n/a. This adds opt-in TypeScript packages and examples; it does not change existing server storage formats.

Expected complexity level and risk

3/5

The packages are opt-in and do not change existing server behavior. Complexity is in scheduling, retry recovery, and cron's direct use of the internal spacetime:sys@2.0 host ABI. Review failure recovery and repeated execution for applications that use these packages.

Testing

Verified locally on bradley/submodules-core:

Frozen-lockfile install for the root, SDK, and present submodule workspaces.
Type checks for the added packages.
Existing test scripts for the added packages and examples.
Build scripts for the added packages and examples.
Regenerate client bindings and verify no tracked changes.
Lint and formatting checks for the added packages and examples.
Verify workspace dependencies are present in this branch.
Review the public APIs, documentation, and cron host-ABI dependency.
Run local scheduling/recovery smoke tests against a running SpacetimeDB instance.

Commands used for this group:

pnpm -r -F "./spacetime-cron-ts/**" -F "./spacetime-retry-ts/**" -F "./spacetime-rate-limit-ts/**" -F "./spacetime-crypto-ts/**" -F "./spacetime-submodule-shared-ts/**" run typecheck
pnpm -r -F "./spacetime-cron-ts/**" -F "./spacetime-retry-ts/**" -F "./spacetime-rate-limit-ts/**" -F "./spacetime-crypto-ts/**" -F "./spacetime-submodule-shared-ts/**" run test
pnpm -r -F "./spacetime-cron-ts/**" -F "./spacetime-retry-ts/**" -F "./spacetime-rate-limit-ts/**" -F "./spacetime-crypto-ts/**" -F "./spacetime-submodule-shared-ts/**" run build
pnpm -r -F "./spacetime-cron-ts/**" -F "./spacetime-retry-ts/**" -F "./spacetime-rate-limit-ts/**" -F "./spacetime-crypto-ts/**" -F "./spacetime-submodule-shared-ts/**" run lint

The TypeScript SDK was built first. Live deployment and provider tests were not run during split validation. Existing workspace peer-dependency warnings remain.

clockwork-tien

There are places where we are using snake_case instead of camelCase, worth checking thoroughly to ensure consistency. I have also left additional comments inline.

clockwork-tien · 2026-09-16T14:00:59Z

+  "name": "@spacetimedb/crypto",
+  "description": "Deterministic hashing, encoding, and webhook-signature helpers for SpacetimeDB TypeScript modules.",
+  "version": "0.1.0",
+  "license": "BUSL-1.1",


Is BUSL-1.1 license intentional?

should be apache 2

clockwork-tien · 2026-09-16T14:04:08Z

+      : []
+);
+
+export const start_reactor = spacetimedb.procedure(


These should be lowerCamelCase

Suggested change

export const start_reactor = spacetimedb.procedure(

export const startReactor = spacetimedb.procedure(

clockwork-tien · 2026-09-16T14:04:20Z

+  }
+);
+
+export const tap_reactor = spacetimedb.procedure(


These should be lowerCamelCase

Suggested change

export const tap_reactor = spacetimedb.procedure(

export const tapReactor = spacetimedb.procedure(

clockwork-tien · 2026-09-16T14:04:38Z

+  }
+);
+
+export const buy_upgrade = spacetimedb.procedure(


Suggested change

export const buy_upgrade = spacetimedb.procedure(

export const buyUpgrade = spacetimedb.procedure(

clockwork-tien · 2026-09-16T14:04:46Z

+  }
+);
+
+export const repair_reactor = spacetimedb.procedure(


Suggested change

export const repair_reactor = spacetimedb.procedure(

export const repairReactor = spacetimedb.procedure(

clockwork-tien · 2026-09-16T14:09:02Z

+    return isAdmin(ctx) ? takeRows(retryCtx.db.retryTask.iter()) : [];
+  }
+
+  function retryHistoryAdmin(ctx: unknown): RetryHistoryRow[] {


retryHistory is never pruned, and with takeRows(iter(), 1000) after 1000 attempts the admin view stops showing anything recent

clockwork-tien · 2026-09-16T14:09:58Z

+npm install @spacetimedb/retry spacetimedb@^2.8.3
+```
+
+Requires SpacetimeDB 2.8.3 or later for submodule mounting.


Seems incorrect since nothing here mounts (no export default schema etc)

clockwork-tien · 2026-09-16T14:11:43Z

+
+## Requirements
+
+- SpacetimeDB CLI 2.8.3


Is it expected to pin the requirement to 2.8.3? e.g. the peer dependency is workspace:^

clockwork-tien · 2026-09-16T14:12:27Z

@@ -0,0 +1,340 @@
+// Verify the pure-TS implementations against published test vectors.


Worth adding here that hashing is @noble/hashes, not an implementation in this package

clockwork-tien · 2026-09-16T14:13:38Z

+      ranAt: retryCtx.timestamp,
+    });
+
+    const result = dispatchRetry(


Seems if a handler throws instead of returning retryFailed, the whole reducer aborts. Worth adding try/catch here

bradleyshep added 2 commits September 8, 2026 17:18

Add core TypeScript submodules and shared example support

646954a

Reuse noble hex conversion helpers

e0f5d86

bradleyshep requested review from bfops, cloutiertyler and jdetter as code owners September 9, 2026 18:29

Merge branch 'master' into bradley/submodules-core

a513320

bradleyshep mentioned this pull request Sep 9, 2026

Submodules (TS) #5823

Closed

7 tasks

bradleyshep requested a review from aasoni September 10, 2026 12:56

clockwork-tien requested changes Sep 16, 2026

View reviewed changes

bradleyshep and others added 3 commits September 17, 2026 08:52

Merge branch 'master' into bradley/submodules-core

f38ca85

Address core submodule review and retry failure handling

5418e2f

Use matching workspace artifacts for submodule CI

983341c

Navigation Menu

Add core TypeScript submodules: cron, retry, rate-limit, and crypto - #5903

Add core TypeScript submodules: cron, retry, rate-limit, and crypto#5903
bradleyshep wants to merge 6 commits into
masterfrom
bradley/submodules-core

bradleyshep commented Sep 9, 2026

Uh oh!

clockwork-tien left a comment

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

aasoni Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

clockwork-tien Sep 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	export const start_reactor = spacetimedb.procedure(
	export const startReactor = spacetimedb.procedure(

	export const tap_reactor = spacetimedb.procedure(
	export const tapReactor = spacetimedb.procedure(

	export const buy_upgrade = spacetimedb.procedure(
	export const buyUpgrade = spacetimedb.procedure(

	export const repair_reactor = spacetimedb.procedure(
	export const repairReactor = spacetimedb.procedure(

		@@ -0,0 +1,340 @@
		// Verify the pure-TS implementations against published test vectors.

Conversation

bradleyshep commented Sep 9, 2026

Description of Changes

Example screenshots

Cron

Rate Limit

API and ABI breaking changes

Rollback safety impact

Expected complexity level and risk

Testing

Uh oh!

clockwork-tien left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants