durability 5.0.0 → 5.2.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 (89) hide show
  1. package/README.md +238 -7
  2. package/dist/{durability-alarms.d.ts → alarms/index.d.ts} +23 -6
  3. package/dist/{durability-alarms.js → alarms/index.js} +96 -52
  4. package/dist/alarms/migrations.d.ts +9 -0
  5. package/dist/alarms/migrations.js +133 -0
  6. package/dist/errors.d.ts +15 -0
  7. package/dist/errors.js +24 -0
  8. package/dist/experimental.d.ts +11 -8
  9. package/dist/experimental.js +8 -5
  10. package/dist/{fanout.d.ts → fanout/index.d.ts} +13 -6
  11. package/dist/{fanout.js → fanout/index.js} +55 -49
  12. package/dist/fanout/migrations.d.ts +9 -0
  13. package/dist/fanout/migrations.js +181 -0
  14. package/dist/{stored-message.d.ts → fanout/stored-message.d.ts} +1 -1
  15. package/dist/index.d.ts +14 -9
  16. package/dist/index.js +13 -8
  17. package/dist/{log.d.ts → log/index.d.ts} +15 -3
  18. package/dist/{log.js → log/index.js} +152 -124
  19. package/dist/log/migrations.d.ts +18 -0
  20. package/dist/log/migrations.js +297 -0
  21. package/dist/{memoize.d.ts → memoize/index.d.ts} +1 -1
  22. package/dist/{memoize.js → memoize/index.js} +14 -11
  23. package/dist/memoize/migrations.d.ts +10 -0
  24. package/dist/memoize/migrations.js +21 -0
  25. package/dist/migrations.d.ts +1 -103
  26. package/dist/migrations.js +1 -570
  27. package/dist/{durability.d.ts → operations/index.d.ts} +13 -5
  28. package/dist/{durability.js → operations/index.js} +63 -46
  29. package/dist/operations/migrations.d.ts +10 -0
  30. package/dist/operations/migrations.js +150 -0
  31. package/dist/{outbox.d.ts → outbox/index.d.ts} +4 -4
  32. package/dist/{outbox.js → outbox/index.js} +18 -63
  33. package/dist/outbox/migrations.d.ts +9 -0
  34. package/dist/outbox/migrations.js +43 -0
  35. package/dist/{routing-client.js → routing/client.js} +1 -1
  36. package/dist/{routing.d.ts → routing/index.d.ts} +3 -3
  37. package/dist/{routing.js → routing/index.js} +3 -3
  38. package/dist/{load.d.ts → routing/load.d.ts} +1 -1
  39. package/dist/schedule/index.d.ts +165 -0
  40. package/dist/schedule/index.js +667 -0
  41. package/dist/schedule/migrations.d.ts +9 -0
  42. package/dist/schedule/migrations.js +118 -0
  43. package/dist/{scheduler.d.ts → scheduler/index.d.ts} +122 -22
  44. package/dist/scheduler/index.js +925 -0
  45. package/dist/{semaphore-client.d.ts → semaphore/client.d.ts} +1 -1
  46. package/dist/{semaphore-client.js → semaphore/client.js} +2 -2
  47. package/dist/{semaphore.d.ts → semaphore/index.d.ts} +10 -10
  48. package/dist/{semaphore.js → semaphore/index.js} +7 -7
  49. package/dist/{semaphore-leases.d.ts → semaphore/leases.d.ts} +17 -6
  50. package/dist/{semaphore-leases.js → semaphore/leases.js} +28 -12
  51. package/dist/semaphore/migrations.d.ts +18 -0
  52. package/dist/semaphore/migrations.js +444 -0
  53. package/dist/{semaphore-protocol.d.ts → semaphore/protocol.d.ts} +16 -8
  54. package/dist/{semaphore-protocol.js → semaphore/protocol.js} +37 -14
  55. package/dist/{semaphore-queue-store.d.ts → semaphore/queue-store.d.ts} +12 -6
  56. package/dist/{semaphore-queue-store.js → semaphore/queue-store.js} +87 -75
  57. package/dist/{semaphore-queue.d.ts → semaphore/queue.d.ts} +15 -5
  58. package/dist/{semaphore-queue.js → semaphore/queue.js} +105 -46
  59. package/dist/{semaphore-server.d.ts → semaphore/server.d.ts} +12 -4
  60. package/dist/{semaphore-server.js → semaphore/server.js} +51 -24
  61. package/dist/{semaphore-store.d.ts → semaphore/store.d.ts} +8 -3
  62. package/dist/{semaphore-store.js → semaphore/store.js} +35 -33
  63. package/dist/{client.d.ts → socket/client.d.ts} +3 -3
  64. package/dist/{client.js → socket/client.js} +4 -4
  65. package/dist/{socket.d.ts → socket/index.d.ts} +15 -4
  66. package/dist/{socket.js → socket/index.js} +66 -20
  67. package/dist/socket/migrations.d.ts +9 -0
  68. package/dist/socket/migrations.js +57 -0
  69. package/dist/{socket-protocol.d.ts → socket/protocol.d.ts} +1 -1
  70. package/dist/storage.d.ts +9 -2
  71. package/dist/storage.js +24 -11
  72. package/dist/{topology-client.d.ts → topology/client.d.ts} +2 -2
  73. package/dist/{topology-client.js → topology/client.js} +3 -3
  74. package/dist/{topology.d.ts → topology/index.d.ts} +17 -7
  75. package/dist/{topology.js → topology/index.js} +92 -58
  76. package/dist/topology/migrations.d.ts +10 -0
  77. package/dist/topology/migrations.js +138 -0
  78. package/dist/{tracker.d.ts → tracker/index.d.ts} +3 -3
  79. package/dist/{tracker.js → tracker/index.js} +2 -2
  80. package/package.json +11 -11
  81. package/dist/scheduler.js +0 -577
  82. /package/dist/{stored-message.js → fanout/stored-message.js} +0 -0
  83. /package/dist/{routing-client.d.ts → routing/client.d.ts} +0 -0
  84. /package/dist/{load.js → routing/load.js} +0 -0
  85. /package/dist/{socket-protocol.js → socket/protocol.js} +0 -0
  86. /package/dist/{topology-snapshot.d.ts → topology/snapshot.d.ts} +0 -0
  87. /package/dist/{topology-snapshot.js → topology/snapshot.js} +0 -0
  88. /package/dist/{tracked-source.d.ts → tracker/source.d.ts} +0 -0
  89. /package/dist/{tracked-source.js → tracker/source.js} +0 -0
@@ -0,0 +1,138 @@
1
+ /**
2
+ * Ordered SQLite migrations for the experimental topology coordinator.
3
+ * Publication and sync ride on outbox channels. Applied automatically on
4
+ * construction.
5
+ */
6
+ export const durabilityTopologyMigrations = [
7
+ {
8
+ name: 'durability_0011_create_topology',
9
+ up: `
10
+ CREATE TABLE IF NOT EXISTS durability_topology_groups (
11
+ group_id TEXT PRIMARY KEY,
12
+ version INTEGER NOT NULL,
13
+ members TEXT NOT NULL,
14
+ deleted INTEGER NOT NULL CHECK (deleted IN (0, 1)),
15
+ updated_at INTEGER NOT NULL
16
+ );
17
+ CREATE TABLE IF NOT EXISTS durability_topology_states (
18
+ group_id TEXT NOT NULL,
19
+ channel TEXT NOT NULL,
20
+ value TEXT NOT NULL,
21
+ PRIMARY KEY (group_id, channel)
22
+ );
23
+ CREATE TABLE IF NOT EXISTS durability_topology_writes (
24
+ id TEXT PRIMARY KEY,
25
+ group_id TEXT NOT NULL,
26
+ land_by INTEGER NOT NULL
27
+ );
28
+ CREATE INDEX IF NOT EXISTS durability_topology_writes_group_idx
29
+ ON durability_topology_writes (group_id, land_by);
30
+ `,
31
+ down: `
32
+ DROP INDEX IF EXISTS durability_topology_writes_group_idx;
33
+ DROP TABLE IF EXISTS durability_topology_writes;
34
+ DROP TABLE IF EXISTS durability_topology_states;
35
+ DROP TABLE IF EXISTS durability_topology_groups;
36
+ `,
37
+ },
38
+ {
39
+ // `owner_channel` is the topology instance; the existing `channel` column
40
+ // of durability_topology_states stays the state name.
41
+ name: 'durability_0022_topology_channels',
42
+ up: `
43
+ ALTER TABLE durability_topology_groups RENAME TO durability_topology_groups_before_channels;
44
+ CREATE TABLE durability_topology_groups (
45
+ group_id TEXT NOT NULL,
46
+ version INTEGER NOT NULL,
47
+ members TEXT NOT NULL,
48
+ deleted INTEGER NOT NULL CHECK (deleted IN (0, 1)),
49
+ updated_at INTEGER NOT NULL,
50
+ owner_channel TEXT NOT NULL DEFAULT 'default',
51
+ PRIMARY KEY (owner_channel, group_id)
52
+ );
53
+ INSERT INTO durability_topology_groups
54
+ (group_id, version, members, deleted, updated_at, owner_channel)
55
+ SELECT group_id, version, members, deleted, updated_at, 'default'
56
+ FROM durability_topology_groups_before_channels;
57
+ DROP TABLE durability_topology_groups_before_channels;
58
+
59
+ ALTER TABLE durability_topology_states RENAME TO durability_topology_states_before_channels;
60
+ CREATE TABLE durability_topology_states (
61
+ group_id TEXT NOT NULL,
62
+ channel TEXT NOT NULL,
63
+ value TEXT NOT NULL,
64
+ owner_channel TEXT NOT NULL DEFAULT 'default',
65
+ PRIMARY KEY (owner_channel, group_id, channel)
66
+ );
67
+ INSERT INTO durability_topology_states
68
+ (group_id, channel, value, owner_channel)
69
+ SELECT group_id, channel, value, 'default'
70
+ FROM durability_topology_states_before_channels;
71
+ DROP TABLE durability_topology_states_before_channels;
72
+
73
+ ALTER TABLE durability_topology_writes RENAME TO durability_topology_writes_before_channels;
74
+ CREATE TABLE durability_topology_writes (
75
+ id TEXT NOT NULL,
76
+ group_id TEXT NOT NULL,
77
+ land_by INTEGER NOT NULL,
78
+ owner_channel TEXT NOT NULL DEFAULT 'default',
79
+ PRIMARY KEY (owner_channel, id)
80
+ );
81
+ INSERT INTO durability_topology_writes
82
+ (id, group_id, land_by, owner_channel)
83
+ SELECT id, group_id, land_by, 'default'
84
+ FROM durability_topology_writes_before_channels;
85
+ DROP TABLE durability_topology_writes_before_channels;
86
+ CREATE INDEX durability_topology_writes_group_idx
87
+ ON durability_topology_writes (owner_channel, group_id, land_by);
88
+ `,
89
+ down: `
90
+ CREATE TABLE durability_topology_channel_guard (
91
+ owner_channel TEXT CONSTRAINT cannot_downgrade_nondefault_channels CHECK (owner_channel = 'default')
92
+ );
93
+ INSERT INTO durability_topology_channel_guard
94
+ SELECT owner_channel FROM durability_topology_groups
95
+ UNION SELECT owner_channel FROM durability_topology_states
96
+ UNION SELECT owner_channel FROM durability_topology_writes;
97
+ DROP TABLE durability_topology_channel_guard;
98
+
99
+ ALTER TABLE durability_topology_groups RENAME TO durability_topology_groups_with_channels;
100
+ CREATE TABLE durability_topology_groups (
101
+ group_id TEXT PRIMARY KEY,
102
+ version INTEGER NOT NULL,
103
+ members TEXT NOT NULL,
104
+ deleted INTEGER NOT NULL CHECK (deleted IN (0, 1)),
105
+ updated_at INTEGER NOT NULL
106
+ );
107
+ INSERT INTO durability_topology_groups
108
+ SELECT group_id, version, members, deleted, updated_at
109
+ FROM durability_topology_groups_with_channels;
110
+ DROP TABLE durability_topology_groups_with_channels;
111
+
112
+ ALTER TABLE durability_topology_states RENAME TO durability_topology_states_with_channels;
113
+ CREATE TABLE durability_topology_states (
114
+ group_id TEXT NOT NULL,
115
+ channel TEXT NOT NULL,
116
+ value TEXT NOT NULL,
117
+ PRIMARY KEY (group_id, channel)
118
+ );
119
+ INSERT INTO durability_topology_states
120
+ SELECT group_id, channel, value
121
+ FROM durability_topology_states_with_channels;
122
+ DROP TABLE durability_topology_states_with_channels;
123
+
124
+ ALTER TABLE durability_topology_writes RENAME TO durability_topology_writes_with_channels;
125
+ CREATE TABLE durability_topology_writes (
126
+ id TEXT PRIMARY KEY,
127
+ group_id TEXT NOT NULL,
128
+ land_by INTEGER NOT NULL
129
+ );
130
+ INSERT INTO durability_topology_writes
131
+ SELECT id, group_id, land_by
132
+ FROM durability_topology_writes_with_channels;
133
+ DROP TABLE durability_topology_writes_with_channels;
134
+ CREATE INDEX durability_topology_writes_group_idx
135
+ ON durability_topology_writes (group_id, land_by);
136
+ `,
137
+ },
138
+ ];
@@ -1,6 +1,6 @@
1
- import type { AnyDurabilityAlarms, DurabilityAlarms } from './durability-alarms.js';
2
- import type { AnyDurability, Durability, OperationResults } from './durability.js';
3
- import { type Names, type TrackedEntry, type TrackedResults, type TrackedSource, type TrackedState, type TrackedStatus, type UntypedSource } from './tracked-source.js';
1
+ import type { AnyDurabilityAlarms, DurabilityAlarms } from '../alarms/index.js';
2
+ import type { AnyDurability, Durability, OperationResults } from '../operations/index.js';
3
+ import { type Names, type TrackedEntry, type TrackedResults, type TrackedSource, type TrackedState, type TrackedStatus, type UntypedSource } from './source.js';
4
4
  /** A tracked state, or `not_found` when the record or its generation is gone. */
5
5
  export type TrackedResult<Result> = TrackedState<Result> | {
6
6
  status: 'not_found';
@@ -11,8 +11,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
11
11
  };
12
12
  var _DurabilityTracker_instances, _DurabilityTracker_sources, _DurabilityTracker_collect, _DurabilityTracker_source, _DurabilityTracker_handle, _DurabilityTracker_wait;
13
13
  import { z } from 'zod';
14
- import { traceMethods } from './dev.js';
15
- import { trackedSourceOf, } from './tracked-source.js';
14
+ import { traceMethods } from '../dev.js';
15
+ import { trackedSourceOf, } from './source.js';
16
16
  const limitSchema = z.number().int().min(1).max(100);
17
17
  const cursorSchema = z.tuple([
18
18
  z.number().int().nonnegative(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "durability",
3
- "version": "5.0.0",
3
+ "version": "5.2.0",
4
4
  "description": "Alarm-backed durable operations and typed WebSocket sync for Cloudflare Durable Objects",
5
5
  "type": "module",
6
6
  "license": "ISC",
@@ -16,24 +16,24 @@
16
16
  "import": "./dist/index.js"
17
17
  },
18
18
  "./client": {
19
- "types": "./dist/client.d.ts",
20
- "import": "./dist/client.js"
19
+ "types": "./dist/socket/client.d.ts",
20
+ "import": "./dist/socket/client.js"
21
21
  },
22
22
  "./experimental": {
23
23
  "types": "./dist/experimental.d.ts",
24
24
  "import": "./dist/experimental.js"
25
25
  },
26
26
  "./routing": {
27
- "types": "./dist/routing.d.ts",
28
- "import": "./dist/routing.js"
27
+ "types": "./dist/routing/index.d.ts",
28
+ "import": "./dist/routing/index.js"
29
29
  },
30
30
  "./socket": {
31
- "types": "./dist/socket.d.ts",
32
- "import": "./dist/socket.js"
31
+ "types": "./dist/socket/index.d.ts",
32
+ "import": "./dist/socket/index.js"
33
33
  },
34
34
  "./experimental/semaphore": {
35
- "types": "./dist/semaphore.d.ts",
36
- "import": "./dist/semaphore.js"
35
+ "types": "./dist/semaphore/index.d.ts",
36
+ "import": "./dist/semaphore/index.js"
37
37
  },
38
38
  "./utils": {
39
39
  "types": "./dist/utils.d.ts",
@@ -64,8 +64,8 @@
64
64
  "dependencies": {
65
65
  "@standard-schema/spec": "^1.1.0",
66
66
  "zod": "^4.4.3",
67
- "@durability/storage": "^0.1.1",
68
- "@durability/transforms": "^0.6.0"
67
+ "@durability/transforms": "^0.6.1",
68
+ "@durability/storage": "^0.1.1"
69
69
  },
70
70
  "peerDependencies": {
71
71
  "@cloudflare/workers-types": "^4.20260702.1"