@haneinfo/state-machine 0.19.0 → 0.20.1

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 (51) hide show
  1. package/README.md +56 -0
  2. package/agent-guide.md +10 -0
  3. package/dist/config.d.ts +4 -0
  4. package/dist/config.d.ts.map +1 -1
  5. package/dist/config.js +4 -0
  6. package/dist/config.js.map +1 -1
  7. package/dist/data-change.service.d.ts +76 -0
  8. package/dist/data-change.service.d.ts.map +1 -0
  9. package/dist/data-change.service.js +241 -0
  10. package/dist/data-change.service.js.map +1 -0
  11. package/dist/data-changes.d.ts +78 -0
  12. package/dist/data-changes.d.ts.map +1 -0
  13. package/dist/data-changes.js +105 -0
  14. package/dist/data-changes.js.map +1 -0
  15. package/dist/index.d.ts +3 -1
  16. package/dist/index.d.ts.map +1 -1
  17. package/dist/index.js +5 -1
  18. package/dist/index.js.map +1 -1
  19. package/dist/mcp-tools.d.ts +7 -1
  20. package/dist/mcp-tools.d.ts.map +1 -1
  21. package/dist/mcp-tools.js +77 -3
  22. package/dist/mcp-tools.js.map +1 -1
  23. package/dist/plugin.d.ts +1 -1
  24. package/dist/plugin.d.ts.map +1 -1
  25. package/dist/plugin.js +13 -2
  26. package/dist/plugin.js.map +1 -1
  27. package/dist/prisma-store.d.ts.map +1 -1
  28. package/dist/prisma-store.js +38 -0
  29. package/dist/prisma-store.js.map +1 -1
  30. package/dist/runtime.service.d.ts +7 -0
  31. package/dist/runtime.service.d.ts.map +1 -1
  32. package/dist/runtime.service.js +60 -0
  33. package/dist/runtime.service.js.map +1 -1
  34. package/dist/state-machine.controller.d.ts +18 -1
  35. package/dist/state-machine.controller.d.ts.map +1 -1
  36. package/dist/state-machine.controller.js +31 -2
  37. package/dist/state-machine.controller.js.map +1 -1
  38. package/dist/state-machine.module.d.ts.map +1 -1
  39. package/dist/state-machine.module.js +3 -0
  40. package/dist/state-machine.module.js.map +1 -1
  41. package/dist/store.d.ts +7 -0
  42. package/dist/store.d.ts.map +1 -1
  43. package/dist/store.js +25 -0
  44. package/dist/store.js.map +1 -1
  45. package/dist/types.d.ts +8 -0
  46. package/dist/types.d.ts.map +1 -1
  47. package/dist/types.js.map +1 -1
  48. package/haneinfo.plugin.json +14 -3
  49. package/package.json +6 -5
  50. package/prisma/data-changes.sql +24 -0
  51. package/prisma/state-machine.prisma +26 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@haneinfo/state-machine",
3
- "version": "0.19.0",
3
+ "version": "0.20.1",
4
4
  "private": false,
5
5
  "description": "State machine mechanism: StateMachine definitions (states, transitions, frozen states) and the runtime for business-object instances, registered with @haneinfo/definition-registry.",
6
6
  "files": [
@@ -38,12 +38,13 @@
38
38
  "./package.json": "./package.json"
39
39
  },
40
40
  "dependencies": {
41
- "@haneinfo/plugin-api": "1.20.0",
42
- "@haneinfo/form": "0.4.2"
41
+ "@haneinfo/plugin-api": "1.22.0",
42
+ "@haneinfo/form": "0.4.4",
43
+ "@haneinfo/diff": "0.1.0"
43
44
  },
44
45
  "peerDependencies": {
45
46
  "@haneinfo/common": "^0.3.4 || ^0.4.0 || ^0.5.0",
46
- "@haneinfo/definition-registry": "^0.1.0",
47
+ "@haneinfo/definition-registry": "^0.1.0 || ^0.2.0",
47
48
  "@haneinfo/plugin-host-nest": "^2.0.0",
48
49
  "@nestjs/common": "^11.0.0",
49
50
  "@nestjs/core": "^11.0.0",
@@ -64,8 +65,8 @@
64
65
  "vitest": "^4.1.11",
65
66
  "zod": "^4.4.0",
66
67
  "@haneinfo/common": "0.5.0",
68
+ "@haneinfo/definition-registry": "0.2.1",
67
69
  "@haneinfo/plugin-host-nest": "2.1.0",
68
- "@haneinfo/definition-registry": "0.1.16",
69
70
  "@haneinfo/plugin-testkit": "2.3.0"
70
71
  },
71
72
  "license": "UNLICENSED",
@@ -0,0 +1,24 @@
1
+ -- @haneinfo/state-machine: per-field instance data change log (draft decision 202610-d9a5).
2
+ -- No backfill: instances created before this table have no history (historyStartsAtRevision).
3
+ CREATE TABLE instance_data_changes (
4
+ id TEXT NOT NULL,
5
+ instance_id TEXT NOT NULL,
6
+ revision INTEGER NOT NULL,
7
+ field_id TEXT NOT NULL,
8
+ before JSONB,
9
+ after JSONB,
10
+ truncated BOOLEAN NOT NULL DEFAULT false,
11
+ actor_type TEXT NOT NULL,
12
+ actor_id TEXT,
13
+ source TEXT NOT NULL,
14
+ at TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
15
+ CONSTRAINT instance_data_changes_pkey PRIMARY KEY (id),
16
+ CONSTRAINT instance_data_changes_actor_type_check CHECK (actor_type IN ('USER', 'SYSTEM', 'MECHANISM')),
17
+ CONSTRAINT instance_data_changes_source_check CHECK (source IN ('CREATE', 'PATCH', 'TRANSITION', 'IMPORT')),
18
+ CONSTRAINT instance_data_changes_instance_id_fkey FOREIGN KEY (instance_id)
19
+ REFERENCES state_machine_instances(id) ON DELETE CASCADE ON UPDATE CASCADE
20
+ );
21
+ CREATE INDEX instance_data_changes_instance_id_revision_idx
22
+ ON instance_data_changes(instance_id, revision);
23
+ CREATE INDEX instance_data_changes_instance_id_field_id_revision_idx
24
+ ON instance_data_changes(instance_id, field_id, revision);
@@ -21,6 +21,7 @@ model StateMachineInstance {
21
21
  history StateMachineTransition[]
22
22
  numbers StateMachineNumber[]
23
23
  readers StateMachineInstanceReader[]
24
+ dataChanges InstanceDataChange[]
24
25
 
25
26
  @@index([machineCode, archivedAt])
26
27
  @@index([deletedAt])
@@ -81,3 +82,28 @@ model StateMachineInstanceReader {
81
82
  @@index([principalType, principalId])
82
83
  @@map("state_machine_instance_readers")
83
84
  }
85
+
86
+ /// Append-only per-field data change log, written in the transaction of every data write. `before`
87
+ /// and `after` are SQL NULL when the field was absent or the value exceeded the size limit
88
+ /// (`truncated`); a stored JSON null is a null value. Formula fields are not recorded. @internal
89
+ model InstanceDataChange {
90
+ id String @id @default(uuid())
91
+ instanceId String @map("instance_id")
92
+ instance StateMachineInstance @relation(fields: [instanceId], references: [id], onDelete: Cascade)
93
+ /// The instance revision the write produced.
94
+ revision Int
95
+ fieldId String @map("field_id")
96
+ before Json?
97
+ after Json?
98
+ truncated Boolean @default(false)
99
+ /// USER, SYSTEM or MECHANISM.
100
+ actorType String @map("actor_type")
101
+ actorId String? @map("actor_id")
102
+ /// CREATE, PATCH, TRANSITION or IMPORT.
103
+ source String
104
+ at DateTime @default(now())
105
+
106
+ @@index([instanceId, revision])
107
+ @@index([instanceId, fieldId, revision])
108
+ @@map("instance_data_changes")
109
+ }