@haneinfo/state-machine 0.8.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 (55) hide show
  1. package/README.md +65 -0
  2. package/agent-guide.md +65 -0
  3. package/dist/access.d.ts +28 -0
  4. package/dist/access.d.ts.map +1 -0
  5. package/dist/access.js +21 -0
  6. package/dist/access.js.map +1 -0
  7. package/dist/index.d.ts +3 -0
  8. package/dist/index.d.ts.map +1 -1
  9. package/dist/index.js +3 -0
  10. package/dist/index.js.map +1 -1
  11. package/dist/instance-access.controller.d.ts +24 -0
  12. package/dist/instance-access.controller.d.ts.map +1 -0
  13. package/dist/instance-access.controller.js +67 -0
  14. package/dist/instance-access.controller.js.map +1 -0
  15. package/dist/instance-access.service.d.ts +53 -0
  16. package/dist/instance-access.service.d.ts.map +1 -0
  17. package/dist/instance-access.service.js +208 -0
  18. package/dist/instance-access.service.js.map +1 -0
  19. package/dist/mcp-tools.d.ts +3 -1
  20. package/dist/mcp-tools.d.ts.map +1 -1
  21. package/dist/mcp-tools.js +37 -2
  22. package/dist/mcp-tools.js.map +1 -1
  23. package/dist/plugin.d.ts +2 -1
  24. package/dist/plugin.d.ts.map +1 -1
  25. package/dist/plugin.js +6 -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 +52 -11
  29. package/dist/prisma-store.js.map +1 -1
  30. package/dist/reader-grants.d.ts +1 -1
  31. package/dist/reader-grants.d.ts.map +1 -1
  32. package/dist/reader-grants.js +4 -2
  33. package/dist/reader-grants.js.map +1 -1
  34. package/dist/runtime.service.d.ts +4 -2
  35. package/dist/runtime.service.d.ts.map +1 -1
  36. package/dist/runtime.service.js +65 -33
  37. package/dist/runtime.service.js.map +1 -1
  38. package/dist/state-machine.module.d.ts.map +1 -1
  39. package/dist/state-machine.module.js +5 -1
  40. package/dist/state-machine.module.js.map +1 -1
  41. package/dist/store.d.ts +11 -3
  42. package/dist/store.d.ts.map +1 -1
  43. package/dist/store.js +42 -8
  44. package/dist/store.js.map +1 -1
  45. package/dist/testing.d.ts +2 -1
  46. package/dist/testing.d.ts.map +1 -1
  47. package/dist/testing.js +1 -1
  48. package/dist/testing.js.map +1 -1
  49. package/dist/types.d.ts +1 -0
  50. package/dist/types.d.ts.map +1 -1
  51. package/dist/types.js.map +1 -1
  52. package/haneinfo.plugin.json +10 -4
  53. package/package.json +5 -5
  54. package/prisma/instance-access.sql +50 -0
  55. package/prisma/state-machine.prisma +13 -9
package/dist/testing.d.ts CHANGED
@@ -2,7 +2,7 @@
2
2
  * `@haneinfo/state-machine/testing` — a real runtime on in-memory stores, for mechanism and App
3
3
  * tests. Needs `@haneinfo/definition-registry` (its `/testing` registry) installed.
4
4
  */
5
- import type { DefinitionKindRegistration, IdentityStorePort, NotificationInboxPort, NumberingPort, OrgDirectoryPort, RbacPolicyPort } from '@haneinfo/plugin-api';
5
+ import type { DefinitionKindRegistration, DelegationResolverPort, IdentityStorePort, NotificationInboxPort, NumberingPort, OrgDirectoryPort, RbacPolicyPort } from '@haneinfo/plugin-api';
6
6
  import { type Clock, StateMachineRuntime } from './runtime.service';
7
7
  import { InMemoryStateMachineStore } from './store';
8
8
  import type { StateMachineConfig } from './types';
@@ -16,6 +16,7 @@ export declare function createTestStateMachineRuntime(options?: {
16
16
  numbering?: NumberingPort;
17
17
  orgDirectory?: OrgDirectoryPort;
18
18
  identity?: IdentityStorePort;
19
+ delegation?: DelegationResolverPort;
19
20
  }): {
20
21
  runtime: StateMachineRuntime;
21
22
  store: InMemoryStateMachineStore;
@@ -1 +1 @@
1
- {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,KAAK,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACzB;;;;;EAkBP"}
1
+ {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,0BAA0B,EAC1B,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,KAAK,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,UAAU,CAAC,EAAE,sBAAsB,CAAC;CAChC;;;;;EAmBP"}
package/dist/testing.js CHANGED
@@ -17,7 +17,7 @@ function createTestStateMachineRuntime(options = {}) {
17
17
  kinds: [kind_1.stateMachineDefinitionKind, ...(options.kinds ?? [])],
18
18
  });
19
19
  const store = new store_1.InMemoryStateMachineStore();
20
- const runtime = new runtime_service_1.StateMachineRuntime(store, definitions.registry, options.rbac, options.clock, options.notifications, options.config, options.numbering, options.orgDirectory, options.identity);
20
+ const runtime = new runtime_service_1.StateMachineRuntime(store, definitions.registry, options.rbac, options.clock, options.notifications, options.config, options.numbering, options.orgDirectory, options.identity, options.delegation);
21
21
  return { ...definitions, runtime, store };
22
22
  }
23
23
  //# sourceMappingURL=testing.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAkBH,sEA4BC;AA5CD,mEAAqF;AASrF,iCAAoD;AACpD,uDAAoE;AACpE,mCAAoD;AAGpD,iCAAoD;AAA3C,kHAAA,yBAAyB,OAAA;AAElC,SAAgB,6BAA6B,CAC3C,UASI,EAAE;IAEN,MAAM,WAAW,GAAG,IAAA,sCAA4B,EAAC;QAC/C,KAAK,EAAE,CAAC,iCAA0B,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;KAC9D,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,iCAAyB,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,qCAAmB,CACrC,KAAK,EACL,WAAW,CAAC,QAAQ,EACpB,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,QAAQ,CACjB,CAAC;IACF,OAAO,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC"}
1
+ {"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAmBH,sEA8BC;AA/CD,mEAAqF;AAUrF,iCAAoD;AACpD,uDAAoE;AACpE,mCAAoD;AAGpD,iCAAoD;AAA3C,kHAAA,yBAAyB,OAAA;AAElC,SAAgB,6BAA6B,CAC3C,UAUI,EAAE;IAEN,MAAM,WAAW,GAAG,IAAA,sCAA4B,EAAC;QAC/C,KAAK,EAAE,CAAC,iCAA0B,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;KAC9D,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,iCAAyB,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,qCAAmB,CACrC,KAAK,EACL,WAAW,CAAC,QAAQ,EACpB,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,UAAU,CACnB,CAAC;IACF,OAAO,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC"}
package/dist/types.d.ts CHANGED
@@ -6,6 +6,7 @@ export type StateType = 'INITIAL' | 'NORMAL' | 'FINAL' | 'CHOICE';
6
6
  export interface StateMachineConfig {
7
7
  failureRecipients?: PersonResolver[];
8
8
  appName?: string;
9
+ maxGrantedAccess?: number;
9
10
  }
10
11
  export interface StateDefinition {
11
12
  key: string;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAEhH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAClE,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yFAAyF;IACzF,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,uGAAuG;IACvG,MAAM,CAAC,EAAE;QAAE,UAAU,EAAE,cAAc,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,gGAAgG;IAChG,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,wBAAwB,EAAE,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAElF"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAEhH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAClE,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yFAAyF;IACzF,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,uGAAuG;IACvG,MAAM,CAAC,EAAE;QAAE,UAAU,EAAE,cAAc,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,gGAAgG;IAChG,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,wBAAwB,EAAE,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAElF"}
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gHAAgH;;AA6ChH,wCAEC;AAFD,SAAgB,cAAc,CAAC,IAAsB;IACnD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC/D,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gHAAgH;;AA8ChH,wCAEC;AAFD,SAAgB,cAAc,CAAC,IAAsB;IACnD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC/D,CAAC"}
@@ -5,7 +5,7 @@
5
5
  "cardinality": "singleton",
6
6
  "distribution": "official",
7
7
  "engine": {
8
- "haneinfoPluginApi": "^1.12.0",
8
+ "haneinfoPluginApi": "^1.14.0",
9
9
  "node": ">=22.0.0",
10
10
  "frameworks": {
11
11
  "@nestjs/common": "^11.0.5",
@@ -20,7 +20,8 @@
20
20
  "haneinfo.notification-inbox",
21
21
  "haneinfo.numbering",
22
22
  "haneinfo.org-directory",
23
- "haneinfo.identity-store"
23
+ "haneinfo.identity-store",
24
+ "haneinfo.delegation-resolver"
24
25
  ],
25
26
  "facets": {
26
27
  "backend": {
@@ -37,6 +38,10 @@
37
38
  }
38
39
  ],
39
40
  "mcpTools": [
41
+ {
42
+ "name": "list_instance_access",
43
+ "requiredScopes": ["{namespace}:instance:read"]
44
+ },
40
45
  {
41
46
  "name": "simulate_state_machine",
42
47
  "requiredScopes": ["{namespace}:definition:read"]
@@ -62,7 +67,7 @@
62
67
  "StateMachineInstanceReader"
63
68
  ],
64
69
  "schemaFragment": "prisma/state-machine.prisma",
65
- "schemaDigest": "sha256:03ad7c2ac273175f1d38d0ad59a93613babb2cdee59636739d9551502dd3294c"
70
+ "schemaDigest": "sha256:1dbdf105972d42bea5af3027d013fdbec157c6f3a06f2a2da114fb058f130251"
66
71
  },
67
72
  "permissions": {
68
73
  "definitions": [
@@ -70,7 +75,8 @@
70
75
  "state-machine:definition:write",
71
76
  "state-machine:definition:publish",
72
77
  "state-machine:instance:read",
73
- "state-machine:instance:write"
78
+ "state-machine:instance:write",
79
+ "state-machine:instance:admin"
74
80
  ]
75
81
  }
76
82
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@haneinfo/state-machine",
3
- "version": "0.8.0",
3
+ "version": "0.10.0",
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,8 +38,8 @@
38
38
  "./package.json": "./package.json"
39
39
  },
40
40
  "dependencies": {
41
- "@haneinfo/plugin-api": "1.12.0",
42
- "@haneinfo/form": "0.3.2"
41
+ "@haneinfo/plugin-api": "1.14.0",
42
+ "@haneinfo/form": "0.3.4"
43
43
  },
44
44
  "peerDependencies": {
45
45
  "@haneinfo/common": "^0.3.4",
@@ -63,10 +63,10 @@
63
63
  "typescript": "^5.9.3",
64
64
  "vitest": "^4.1.11",
65
65
  "zod": "^4.4.0",
66
- "@haneinfo/definition-registry": "0.1.7",
66
+ "@haneinfo/common": "0.3.4",
67
67
  "@haneinfo/plugin-host-nest": "2.1.0",
68
68
  "@haneinfo/plugin-testkit": "2.3.0",
69
- "@haneinfo/common": "0.3.4"
69
+ "@haneinfo/definition-registry": "0.1.9"
70
70
  },
71
71
  "license": "UNLICENSED",
72
72
  "publishConfig": {
@@ -0,0 +1,50 @@
1
+ -- Apply in an App migration before installing the upgraded runtime. Existing timestamps survive.
2
+ ALTER TABLE state_machine_instance_readers RENAME COLUMN user_id TO principal_id;
3
+ ALTER TABLE state_machine_instance_readers RENAME COLUMN reason TO source;
4
+ ALTER TABLE state_machine_instance_readers
5
+ ADD COLUMN principal_type text NOT NULL DEFAULT 'USER',
6
+ ADD COLUMN level text NOT NULL DEFAULT 'READ',
7
+ ADD COLUMN granted_by text;
8
+
9
+ UPDATE state_machine_instance_readers r
10
+ SET source = CASE
11
+ WHEN upper(r.source) ~ '(DELEGAT|PROXY)' THEN 'DELEGATED'
12
+ WHEN EXISTS (
13
+ SELECT 1 FROM assignment_tasks t
14
+ WHERE t.instance_id = r.instance_id AND t.assignee_id = r.principal_id
15
+ AND t.delegation_id IS NOT NULL
16
+ ) AND NOT EXISTS (
17
+ SELECT 1 FROM assignment_tasks t
18
+ WHERE t.instance_id = r.instance_id AND t.assignee_id = r.principal_id
19
+ AND t.delegation_id IS NULL
20
+ ) THEN 'DELEGATED'
21
+ ELSE 'ASSIGNED'
22
+ END;
23
+
24
+ ALTER TABLE state_machine_instance_readers DROP CONSTRAINT state_machine_instance_readers_pkey;
25
+ DROP INDEX IF EXISTS state_machine_instance_readers_user_id_idx;
26
+ ALTER TABLE state_machine_instance_readers
27
+ ALTER COLUMN principal_type DROP DEFAULT,
28
+ ALTER COLUMN level DROP DEFAULT,
29
+ ADD CONSTRAINT state_machine_instance_readers_pkey
30
+ PRIMARY KEY (instance_id, principal_type, principal_id, source),
31
+ ADD CONSTRAINT state_machine_instance_readers_principal_check
32
+ CHECK (principal_type IN ('USER', 'ROLE')),
33
+ ADD CONSTRAINT state_machine_instance_readers_level_check CHECK (level IN ('READ', 'WRITE')),
34
+ ADD CONSTRAINT state_machine_instance_readers_source_check
35
+ CHECK (source IN ('ASSIGNED', 'DELEGATED', 'GRANTED')),
36
+ ADD CONSTRAINT state_machine_instance_readers_permanent_check
37
+ CHECK (source = 'GRANTED' OR (principal_type = 'USER' AND level = 'READ'));
38
+ CREATE INDEX state_machine_instance_readers_instance_id_idx
39
+ ON state_machine_instance_readers (instance_id);
40
+ CREATE INDEX state_machine_instance_readers_principal_type_principal_id_idx
41
+ ON state_machine_instance_readers (principal_type, principal_id);
42
+
43
+ -- Backfill every existing task, irrespective of status, including both sources for a user.
44
+ -- If upgrading from an App without delegation, omit the DELEGATED branch and use ASSIGNED.
45
+ INSERT INTO state_machine_instance_readers
46
+ (instance_id, principal_type, principal_id, level, source)
47
+ SELECT DISTINCT instance_id, 'USER', assignee_id, 'READ',
48
+ CASE WHEN delegation_id IS NULL THEN 'ASSIGNED' ELSE 'DELEGATED' END
49
+ FROM assignment_tasks
50
+ ON CONFLICT (instance_id, principal_type, principal_id, source) DO NOTHING;
@@ -44,7 +44,7 @@ model StateMachineTransition {
44
44
  transition String?
45
45
  fromState String? @map("from_state")
46
46
  toState String @map("to_state")
47
- /// START, USER, ASSIGNMENT, TIMER, CHOICE or CHOICE_DECISION.
47
+ /// START, USER, ASSIGNMENT, TIMER, CHOICE, CHOICE_DECISION or ACCESS.
48
48
  triggerType String @map("trigger_type")
49
49
  triggerUserId String? @map("trigger_user_id")
50
50
  /// Assignment or Timer code for mechanism-driven transitions.
@@ -57,15 +57,19 @@ model StateMachineTransition {
57
57
  @@map("state_machine_transitions")
58
58
  }
59
59
 
60
- /// Append-only instance readers. Assignment grants survive every task status. @internal
60
+ /// Source-specific access. Assignment and delegation grants are permanent READ entries. @internal
61
61
  model StateMachineInstanceReader {
62
- instanceId String @map("instance_id")
63
- userId String @map("user_id")
64
- reason String
65
- createdAt DateTime @default(now()) @map("created_at")
66
- instance StateMachineInstance @relation(fields: [instanceId], references: [id], onDelete: Cascade)
62
+ instanceId String @map("instance_id")
63
+ principalType String @map("principal_type")
64
+ principalId String @map("principal_id")
65
+ level String
66
+ source String
67
+ grantedBy String? @map("granted_by")
68
+ createdAt DateTime @default(now()) @map("created_at")
69
+ instance StateMachineInstance @relation(fields: [instanceId], references: [id], onDelete: Cascade)
67
70
 
68
- @@id([instanceId, userId])
69
- @@index([userId])
71
+ @@id([instanceId, principalType, principalId, source])
72
+ @@index([instanceId])
73
+ @@index([principalType, principalId])
70
74
  @@map("state_machine_instance_readers")
71
75
  }