@haneinfo/state-machine 0.0.0-stage → 0.1.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.
- package/LICENSE +14 -0
- package/agent-guide.md +113 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +35 -0
- package/dist/index.js.map +1 -0
- package/dist/kind.d.ts +12 -0
- package/dist/kind.d.ts.map +1 -0
- package/dist/kind.js +48 -0
- package/dist/kind.js.map +1 -0
- package/dist/mcp-tools.d.ts +58 -0
- package/dist/mcp-tools.d.ts.map +1 -0
- package/dist/mcp-tools.js +131 -0
- package/dist/mcp-tools.js.map +1 -0
- package/dist/plugin.d.ts +11 -0
- package/dist/plugin.d.ts.map +1 -0
- package/dist/plugin.js +72 -0
- package/dist/plugin.js.map +1 -0
- package/dist/prisma-store.d.ts +8 -0
- package/dist/prisma-store.d.ts.map +1 -0
- package/dist/prisma-store.js +76 -0
- package/dist/prisma-store.js.map +1 -0
- package/dist/runtime.service.d.ts +66 -0
- package/dist/runtime.service.d.ts.map +1 -0
- package/dist/runtime.service.js +292 -0
- package/dist/runtime.service.js.map +1 -0
- package/dist/semantics.d.ts +8 -0
- package/dist/semantics.d.ts.map +1 -0
- package/dist/semantics.js +83 -0
- package/dist/semantics.js.map +1 -0
- package/dist/simulate.d.ts +20 -0
- package/dist/simulate.d.ts.map +1 -0
- package/dist/simulate.js +46 -0
- package/dist/simulate.js.map +1 -0
- package/dist/state-machine.controller.d.ts +22 -0
- package/dist/state-machine.controller.d.ts.map +1 -0
- package/dist/state-machine.controller.js +143 -0
- package/dist/state-machine.controller.js.map +1 -0
- package/dist/state-machine.module.d.ts +11 -0
- package/dist/state-machine.module.d.ts.map +1 -0
- package/dist/state-machine.module.js +60 -0
- package/dist/state-machine.module.js.map +1 -0
- package/dist/store.d.ts +58 -0
- package/dist/store.d.ts.map +1 -0
- package/dist/store.js +73 -0
- package/dist/store.js.map +1 -0
- package/dist/testing.d.ts +19 -0
- package/dist/testing.d.ts.map +1 -0
- package/dist/testing.js +23 -0
- package/dist/testing.js.map +1 -0
- package/dist/types.d.ts +29 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +8 -0
- package/dist/types.js.map +1 -0
- package/examples/definitions/equipment-loan/equipment-loan-flow.state-machine.json +43 -0
- package/haneinfo.plugin.json +56 -0
- package/package.json +79 -3
- package/plugin.d.ts +2 -0
- package/plugin.js +4 -0
- package/prisma/state-machine.prisma +40 -0
- package/schemas/state-machine.spec.json +66 -0
- package/testing.d.ts +2 -0
- package/testing.js +2 -0
- package/README.md +0 -3
package/package.json
CHANGED
|
@@ -1,6 +1,82 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@haneinfo/state-machine",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"description": "
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"private": false,
|
|
5
|
+
"description": "State machine mechanism: StateMachine definitions (states, transitions, frozen states) and the runtime for business-object instances, registered with @haneinfo/definition-registry.",
|
|
6
|
+
"files": [
|
|
7
|
+
"dist",
|
|
8
|
+
"examples",
|
|
9
|
+
"schemas",
|
|
10
|
+
"prisma",
|
|
11
|
+
"agent-guide.md",
|
|
12
|
+
"haneinfo.plugin.json",
|
|
13
|
+
"plugin.js",
|
|
14
|
+
"plugin.d.ts",
|
|
15
|
+
"testing.js",
|
|
16
|
+
"testing.d.ts"
|
|
17
|
+
],
|
|
18
|
+
"type": "commonjs",
|
|
19
|
+
"main": "./dist/index.js",
|
|
20
|
+
"types": "./dist/index.d.ts",
|
|
21
|
+
"exports": {
|
|
22
|
+
".": {
|
|
23
|
+
"types": "./dist/index.d.ts",
|
|
24
|
+
"default": "./dist/index.js"
|
|
25
|
+
},
|
|
26
|
+
"./plugin": {
|
|
27
|
+
"types": "./dist/plugin.d.ts",
|
|
28
|
+
"default": "./dist/plugin.js"
|
|
29
|
+
},
|
|
30
|
+
"./testing": {
|
|
31
|
+
"types": "./dist/testing.d.ts",
|
|
32
|
+
"default": "./dist/testing.js"
|
|
33
|
+
},
|
|
34
|
+
"./schemas/state-machine.spec.json": "./schemas/state-machine.spec.json",
|
|
35
|
+
"./prisma/state-machine.prisma": "./prisma/state-machine.prisma",
|
|
36
|
+
"./haneinfo.plugin.json": "./haneinfo.plugin.json",
|
|
37
|
+
"./agent-guide.md": "./agent-guide.md",
|
|
38
|
+
"./package.json": "./package.json"
|
|
39
|
+
},
|
|
40
|
+
"dependencies": {
|
|
41
|
+
"@haneinfo/plugin-api": "1.6.1"
|
|
42
|
+
},
|
|
43
|
+
"peerDependencies": {
|
|
44
|
+
"@haneinfo/common": "^0.3.4",
|
|
45
|
+
"@haneinfo/definition-registry": "^0.1.0",
|
|
46
|
+
"@haneinfo/plugin-host-nest": "^2.0.0",
|
|
47
|
+
"@nestjs/common": "^11.0.0",
|
|
48
|
+
"@nestjs/core": "^11.0.0",
|
|
49
|
+
"@prisma/client": "^6.19.0",
|
|
50
|
+
"zod": "^4.4.0"
|
|
51
|
+
},
|
|
52
|
+
"peerDependenciesMeta": {
|
|
53
|
+
"@haneinfo/definition-registry": {
|
|
54
|
+
"optional": true
|
|
55
|
+
}
|
|
56
|
+
},
|
|
57
|
+
"devDependencies": {
|
|
58
|
+
"@nestjs/common": "^11.0.0",
|
|
59
|
+
"@nestjs/core": "^11.0.0",
|
|
60
|
+
"@prisma/client": "^6.19.0",
|
|
61
|
+
"@types/node": "^24.13.0",
|
|
62
|
+
"typescript": "^5.9.3",
|
|
63
|
+
"vitest": "^4.1.11",
|
|
64
|
+
"zod": "^4.4.0",
|
|
65
|
+
"@haneinfo/common": "0.3.4",
|
|
66
|
+
"@haneinfo/plugin-host-nest": "2.1.0",
|
|
67
|
+
"@haneinfo/plugin-testkit": "2.3.0",
|
|
68
|
+
"@haneinfo/form": "0.1.1",
|
|
69
|
+
"@haneinfo/definition-registry": "0.1.1"
|
|
70
|
+
},
|
|
71
|
+
"license": "UNLICENSED",
|
|
72
|
+
"publishConfig": {
|
|
73
|
+
"registry": "https://registry.npmjs.org/",
|
|
74
|
+
"access": "public"
|
|
75
|
+
},
|
|
76
|
+
"scripts": {
|
|
77
|
+
"build": "tsc -p tsconfig.build.json",
|
|
78
|
+
"dev": "tsc -p tsconfig.build.json --watch",
|
|
79
|
+
"test": "vitest run",
|
|
80
|
+
"typecheck": "tsc --noEmit"
|
|
81
|
+
}
|
|
6
82
|
}
|
package/plugin.d.ts
ADDED
package/plugin.js
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
// Compatibility shim for consumers whose TypeScript config uses "classic"/"node10"
|
|
2
|
+
// moduleResolution, which resolves `@haneinfo/state-machine/plugin` by looking for a real file
|
|
3
|
+
// at the package root -- it does not consult package.json's "exports" map at all.
|
|
4
|
+
module.exports = require('./dist/plugin');
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/// One business-object instance of a published StateMachine, pinned to the definitions it started
|
|
2
|
+
/// with (`bundle`). `revision` is the compare-and-set version every transition bumps. @internal
|
|
3
|
+
model StateMachineInstance {
|
|
4
|
+
id String @id @default(cuid())
|
|
5
|
+
machineCode String @map("machine_code")
|
|
6
|
+
machineVersion Int @map("machine_version")
|
|
7
|
+
bundle Json
|
|
8
|
+
state String
|
|
9
|
+
data Json
|
|
10
|
+
submitterId String? @map("submitter_id")
|
|
11
|
+
revision Int @default(1)
|
|
12
|
+
finished Boolean @default(false)
|
|
13
|
+
startedAt DateTime @map("started_at")
|
|
14
|
+
stateEnteredAt DateTime @map("state_entered_at")
|
|
15
|
+
updatedAt DateTime @default(now()) @updatedAt @map("updated_at")
|
|
16
|
+
history StateMachineTransition[]
|
|
17
|
+
|
|
18
|
+
@@index([machineCode, state])
|
|
19
|
+
@@index([submitterId])
|
|
20
|
+
@@map("state_machine_instances")
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/// Append-only history: the start and every transition, with what caused it. @internal
|
|
24
|
+
model StateMachineTransition {
|
|
25
|
+
id String @id @default(cuid())
|
|
26
|
+
instanceId String @map("instance_id")
|
|
27
|
+
instance StateMachineInstance @relation(fields: [instanceId], references: [id], onDelete: Cascade)
|
|
28
|
+
transition String?
|
|
29
|
+
fromState String? @map("from_state")
|
|
30
|
+
toState String @map("to_state")
|
|
31
|
+
/// START, USER, ASSIGNMENT or TIMER.
|
|
32
|
+
triggerType String @map("trigger_type")
|
|
33
|
+
triggerUserId String? @map("trigger_user_id")
|
|
34
|
+
/// Assignment or Timer code for mechanism-driven transitions.
|
|
35
|
+
triggerRef String? @map("trigger_ref")
|
|
36
|
+
at DateTime @default(now())
|
|
37
|
+
|
|
38
|
+
@@index([instanceId, at])
|
|
39
|
+
@@map("state_machine_transitions")
|
|
40
|
+
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"title": "StateMachine spec",
|
|
4
|
+
"description": "States and transitions of a business object. Transitions are taken by a person in the App (checking permission), by an Assignment response, or by a Timer action.",
|
|
5
|
+
"type": "object",
|
|
6
|
+
"additionalProperties": false,
|
|
7
|
+
"required": ["states", "transitions"],
|
|
8
|
+
"properties": {
|
|
9
|
+
"subject": {
|
|
10
|
+
"description": "The Form whose values every instance carries as its data. Optional.",
|
|
11
|
+
"type": "object",
|
|
12
|
+
"additionalProperties": false,
|
|
13
|
+
"required": ["kind", "code"],
|
|
14
|
+
"properties": {
|
|
15
|
+
"kind": { "const": "Form" },
|
|
16
|
+
"code": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"states": {
|
|
20
|
+
"type": "array",
|
|
21
|
+
"minItems": 1,
|
|
22
|
+
"maxItems": 100,
|
|
23
|
+
"items": {
|
|
24
|
+
"type": "object",
|
|
25
|
+
"additionalProperties": false,
|
|
26
|
+
"required": ["key", "label", "type"],
|
|
27
|
+
"properties": {
|
|
28
|
+
"key": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_]*$", "maxLength": 64 },
|
|
29
|
+
"label": { "type": "string", "minLength": 1, "maxLength": 200 },
|
|
30
|
+
"description": { "type": "string", "maxLength": 2000 },
|
|
31
|
+
"type": { "enum": ["INITIAL", "NORMAL", "FINAL"] },
|
|
32
|
+
"frozen": {
|
|
33
|
+
"type": "boolean",
|
|
34
|
+
"description": "While the instance is in this state its data cannot be changed."
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
},
|
|
39
|
+
"transitions": {
|
|
40
|
+
"type": "array",
|
|
41
|
+
"maxItems": 200,
|
|
42
|
+
"items": {
|
|
43
|
+
"type": "object",
|
|
44
|
+
"additionalProperties": false,
|
|
45
|
+
"required": ["key", "from", "to", "label"],
|
|
46
|
+
"properties": {
|
|
47
|
+
"key": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_]*$", "maxLength": 64 },
|
|
48
|
+
"label": { "type": "string", "minLength": 1, "maxLength": 200 },
|
|
49
|
+
"description": { "type": "string", "maxLength": 2000 },
|
|
50
|
+
"from": {
|
|
51
|
+
"type": "array",
|
|
52
|
+
"minItems": 1,
|
|
53
|
+
"uniqueItems": true,
|
|
54
|
+
"items": { "type": "string", "minLength": 1 }
|
|
55
|
+
},
|
|
56
|
+
"to": { "type": "string", "minLength": 1 },
|
|
57
|
+
"permission": {
|
|
58
|
+
"description": "RBAC permission a person needs to take this transition in the App. Absent: any signed-in person who can read the instance. Assignment and Timer actions do not check it.",
|
|
59
|
+
"type": "string",
|
|
60
|
+
"pattern": "^[a-z][a-z0-9-]*(:[a-z][a-z0-9-]*)+$"
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
package/testing.d.ts
ADDED
package/testing.js
ADDED
package/README.md
DELETED