proactive-gate 0.2.3 → 0.2.4

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 (41) hide show
  1. package/README.md +63 -0
  2. package/package.json +4 -2
  3. package/spec/CONFORMANCE.md +83 -0
  4. package/spec/SPEC.md +140 -0
  5. package/spec/SPEC_VERSION +1 -0
  6. package/spec/fixtures/adaptive-timing/placeholder.json +58 -0
  7. package/spec/fixtures/budget/bypass-priority.json +100 -0
  8. package/spec/fixtures/budget/daily-atomic-commit.json +140 -0
  9. package/spec/fixtures/budget/near-limit.json +103 -0
  10. package/spec/fixtures/budget/race-second-commit-loses.json +93 -0
  11. package/spec/fixtures/budget/weekly-iso-week.json +134 -0
  12. package/spec/fixtures/consent/required.json +116 -0
  13. package/spec/fixtures/cooldown/three-dismissals.json +132 -0
  14. package/spec/fixtures/dedupe/already-delivered.json +87 -0
  15. package/spec/fixtures/dedupe/no-key-skips.json +49 -0
  16. package/spec/fixtures/defer/snooze-as-defer.json +138 -0
  17. package/spec/fixtures/mode/allow-list.json +139 -0
  18. package/spec/fixtures/ordering/kill-switch.json +56 -0
  19. package/spec/fixtures/ordering/short-circuit.json +235 -0
  20. package/spec/fixtures/policy/unknown-check-is-an-error.json +50 -0
  21. package/spec/fixtures/presets/cn-minor-mode.json +170 -0
  22. package/spec/fixtures/presets/kakao-brand-message.json +93 -0
  23. package/spec/fixtures/presets/kr-network-act-50.json +168 -0
  24. package/spec/fixtures/presets/telegram-bot.json +162 -0
  25. package/spec/fixtures/presets/us-tcpa.json +90 -0
  26. package/spec/fixtures/quiet-hours/apia.json +90 -0
  27. package/spec/fixtures/quiet-hours/caller-supplied-dates.json +197 -0
  28. package/spec/fixtures/quiet-hours/crosses-midnight-by-day.json +221 -0
  29. package/spec/fixtures/quiet-hours/dst-new-york.json +126 -0
  30. package/spec/fixtures/quiet-hours/istanbul.json +160 -0
  31. package/spec/fixtures/quiet-hours/wall-clock.json +94 -0
  32. package/spec/fixtures/quiet-hours/weekday-schedule.json +262 -0
  33. package/spec/fixtures/shadow/reject-continues.json +143 -0
  34. package/spec/fixtures/trust-ramp/first-week.json +154 -0
  35. package/spec/fixtures/utility/bounded-deferral-cap.json +60 -0
  36. package/spec/fixtures/utility/bounded-deferral.json +95 -0
  37. package/spec/fixtures/utility/floor.json +168 -0
  38. package/spec/schema/fixture.schema.json +58 -0
  39. package/spec/schema/policy.schema.json +23 -0
  40. package/spec/skip/python.txt +0 -0
  41. package/spec/skip/ts.txt +0 -0
package/spec/fixtures/presets/cn-minor-mode.json ADDED
@@ -0,0 +1,170 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "presets/cn-minor-mode",
5
+ "description": "cnMinorMode restricts minors to 06:00 to 22:00 China time and one message a day; adults pass.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "id": "consent"
11
+ },
12
+ {
13
+ "preset": "cnMinorMode"
14
+ }
15
+ ]
16
+ },
17
+ "tests": [
18
+ {
19
+ "description": "minor at 23:00 CST rejects",
20
+ "input": {
21
+ "user": {
22
+ "id": "u1",
23
+ "consent": true,
24
+ "proactiveEnabled": true,
25
+ "mode": "normal",
26
+ "intensity": "normal",
27
+ "timezone": "Europe/Istanbul",
28
+ "quietHours": {
29
+ "start": "22:00",
30
+ "end": "08:00"
31
+ },
32
+ "createdAt": "2026-01-01T00:00:00Z",
33
+ "minor": true
34
+ },
35
+ "candidate": {
36
+ "id": "c1",
37
+ "type": "reminder",
38
+ "priority": "normal",
39
+ "surfaces": [
40
+ "push",
41
+ "feed"
42
+ ]
43
+ },
44
+ "now": "2026-09-04T15:00:00Z"
45
+ },
46
+ "expect": {
47
+ "allowed": false,
48
+ "rejectedBy": "window:minor",
49
+ "trace": [
50
+ "consent",
51
+ "window:minor"
52
+ ]
53
+ }
54
+ },
55
+ {
56
+ "description": "adult at 23:00 CST passes both",
57
+ "input": {
58
+ "user": {
59
+ "id": "u1",
60
+ "consent": true,
61
+ "proactiveEnabled": true,
62
+ "mode": "normal",
63
+ "intensity": "normal",
64
+ "timezone": "Europe/Istanbul",
65
+ "quietHours": {
66
+ "start": "22:00",
67
+ "end": "08:00"
68
+ },
69
+ "createdAt": "2026-01-01T00:00:00Z",
70
+ "minor": false
71
+ },
72
+ "candidate": {
73
+ "id": "c1",
74
+ "type": "reminder",
75
+ "priority": "normal",
76
+ "surfaces": [
77
+ "push",
78
+ "feed"
79
+ ]
80
+ },
81
+ "now": "2026-09-04T15:00:00Z"
82
+ },
83
+ "expect": {
84
+ "allowed": true,
85
+ "trace": [
86
+ "consent",
87
+ "window:minor",
88
+ "dailyBudget"
89
+ ]
90
+ }
91
+ },
92
+ {
93
+ "description": "minor at noon CST: first message allowed and consumed",
94
+ "input": {
95
+ "user": {
96
+ "id": "u1",
97
+ "consent": true,
98
+ "proactiveEnabled": true,
99
+ "mode": "normal",
100
+ "intensity": "normal",
101
+ "timezone": "Europe/Istanbul",
102
+ "quietHours": {
103
+ "start": "22:00",
104
+ "end": "08:00"
105
+ },
106
+ "createdAt": "2026-01-01T00:00:00Z",
107
+ "minor": true
108
+ },
109
+ "candidate": {
110
+ "id": "c2",
111
+ "type": "reminder",
112
+ "priority": "normal",
113
+ "surfaces": [
114
+ "push",
115
+ "feed"
116
+ ]
117
+ },
118
+ "now": "2026-09-04T04:00:00Z"
119
+ },
120
+ "commit": true,
121
+ "expect": {
122
+ "allowed": true,
123
+ "trace": [
124
+ "consent",
125
+ "window:minor",
126
+ "dailyBudget"
127
+ ],
128
+ "commit": true
129
+ }
130
+ },
131
+ {
132
+ "description": "minor at noon CST: second message rejected",
133
+ "input": {
134
+ "user": {
135
+ "id": "u1",
136
+ "consent": true,
137
+ "proactiveEnabled": true,
138
+ "mode": "normal",
139
+ "intensity": "normal",
140
+ "timezone": "Europe/Istanbul",
141
+ "quietHours": {
142
+ "start": "22:00",
143
+ "end": "08:00"
144
+ },
145
+ "createdAt": "2026-01-01T00:00:00Z",
146
+ "minor": true
147
+ },
148
+ "candidate": {
149
+ "id": "c3",
150
+ "type": "reminder",
151
+ "priority": "normal",
152
+ "surfaces": [
153
+ "push",
154
+ "feed"
155
+ ]
156
+ },
157
+ "now": "2026-09-04T04:00:00Z"
158
+ },
159
+ "expect": {
160
+ "allowed": false,
161
+ "rejectedBy": "dailyBudget",
162
+ "trace": [
163
+ "consent",
164
+ "window:minor",
165
+ "dailyBudget"
166
+ ]
167
+ }
168
+ }
169
+ ]
170
+ }
package/spec/fixtures/presets/kakao-brand-message.json ADDED
@@ -0,0 +1,93 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "presets/kakao-brand-message",
5
+ "description": "kakaoBrandMessage runs 08:00 to 20:50 Korea time regardless of the recipient's zone.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "preset": "kakaoBrandMessage"
11
+ }
12
+ ]
13
+ },
14
+ "tests": [
15
+ {
16
+ "description": "21:00 KST rejects even for a user in Istanbul",
17
+ "input": {
18
+ "user": {
19
+ "id": "u1",
20
+ "consent": true,
21
+ "proactiveEnabled": true,
22
+ "mode": "normal",
23
+ "intensity": "normal",
24
+ "timezone": "Europe/Istanbul",
25
+ "quietHours": {
26
+ "start": "22:00",
27
+ "end": "08:00"
28
+ },
29
+ "createdAt": "2026-01-01T00:00:00Z",
30
+ "consents": {
31
+ "ad": true
32
+ }
33
+ },
34
+ "candidate": {
35
+ "id": "c1",
36
+ "type": "reminder",
37
+ "priority": "normal",
38
+ "surfaces": [
39
+ "push",
40
+ "feed"
41
+ ]
42
+ },
43
+ "now": "2026-09-04T12:00:00Z"
44
+ },
45
+ "expect": {
46
+ "allowed": false,
47
+ "rejectedBy": "window:kakao",
48
+ "trace": [
49
+ "consent:ad",
50
+ "window:kakao"
51
+ ]
52
+ }
53
+ },
54
+ {
55
+ "description": "10:00 KST passes",
56
+ "input": {
57
+ "user": {
58
+ "id": "u1",
59
+ "consent": true,
60
+ "proactiveEnabled": true,
61
+ "mode": "normal",
62
+ "intensity": "normal",
63
+ "timezone": "Europe/Istanbul",
64
+ "quietHours": {
65
+ "start": "22:00",
66
+ "end": "08:00"
67
+ },
68
+ "createdAt": "2026-01-01T00:00:00Z",
69
+ "consents": {
70
+ "ad": true
71
+ }
72
+ },
73
+ "candidate": {
74
+ "id": "c1",
75
+ "type": "reminder",
76
+ "priority": "normal",
77
+ "surfaces": [
78
+ "push",
79
+ "feed"
80
+ ]
81
+ },
82
+ "now": "2026-09-04T01:00:00Z"
83
+ },
84
+ "expect": {
85
+ "allowed": true,
86
+ "trace": [
87
+ "consent:ad",
88
+ "window:kakao"
89
+ ]
90
+ }
91
+ }
92
+ ]
93
+ }
package/spec/fixtures/presets/kr-network-act-50.json ADDED
@@ -0,0 +1,168 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "presets/kr-network-act-50",
5
+ "description": "krNetworkAct50 needs ad consent always and night consent 21:00 to 08:00.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "preset": "krNetworkAct50"
11
+ }
12
+ ]
13
+ },
14
+ "tests": [
15
+ {
16
+ "description": "no ad consent",
17
+ "input": {
18
+ "user": {
19
+ "id": "u1",
20
+ "consent": true,
21
+ "proactiveEnabled": true,
22
+ "mode": "normal",
23
+ "intensity": "normal",
24
+ "timezone": "Asia/Seoul",
25
+ "quietHours": {
26
+ "start": "22:00",
27
+ "end": "08:00"
28
+ },
29
+ "createdAt": "2026-01-01T00:00:00Z",
30
+ "consents": {}
31
+ },
32
+ "candidate": {
33
+ "id": "c1",
34
+ "type": "reminder",
35
+ "priority": "normal",
36
+ "surfaces": [
37
+ "push",
38
+ "feed"
39
+ ]
40
+ },
41
+ "now": "2026-09-04T03:00:00Z"
42
+ },
43
+ "expect": {
44
+ "allowed": false,
45
+ "rejectedBy": "consent:ad",
46
+ "trace": [
47
+ "consent:ad"
48
+ ]
49
+ }
50
+ },
51
+ {
52
+ "description": "ad consent at 12:00 KST passes",
53
+ "input": {
54
+ "user": {
55
+ "id": "u1",
56
+ "consent": true,
57
+ "proactiveEnabled": true,
58
+ "mode": "normal",
59
+ "intensity": "normal",
60
+ "timezone": "Asia/Seoul",
61
+ "quietHours": {
62
+ "start": "22:00",
63
+ "end": "08:00"
64
+ },
65
+ "createdAt": "2026-01-01T00:00:00Z",
66
+ "consents": {
67
+ "ad": true
68
+ }
69
+ },
70
+ "candidate": {
71
+ "id": "c1",
72
+ "type": "reminder",
73
+ "priority": "normal",
74
+ "surfaces": [
75
+ "push",
76
+ "feed"
77
+ ]
78
+ },
79
+ "now": "2026-09-04T03:00:00Z"
80
+ },
81
+ "expect": {
82
+ "allowed": true,
83
+ "trace": [
84
+ "consent:ad",
85
+ "consent:night"
86
+ ]
87
+ }
88
+ },
89
+ {
90
+ "description": "23:00 KST without night consent rejects",
91
+ "input": {
92
+ "user": {
93
+ "id": "u1",
94
+ "consent": true,
95
+ "proactiveEnabled": true,
96
+ "mode": "normal",
97
+ "intensity": "normal",
98
+ "timezone": "Asia/Seoul",
99
+ "quietHours": {
100
+ "start": "22:00",
101
+ "end": "08:00"
102
+ },
103
+ "createdAt": "2026-01-01T00:00:00Z",
104
+ "consents": {
105
+ "ad": true
106
+ }
107
+ },
108
+ "candidate": {
109
+ "id": "c1",
110
+ "type": "reminder",
111
+ "priority": "normal",
112
+ "surfaces": [
113
+ "push",
114
+ "feed"
115
+ ]
116
+ },
117
+ "now": "2026-09-04T14:00:00Z"
118
+ },
119
+ "expect": {
120
+ "allowed": false,
121
+ "rejectedBy": "consent:night",
122
+ "trace": [
123
+ "consent:ad",
124
+ "consent:night"
125
+ ]
126
+ }
127
+ },
128
+ {
129
+ "description": "23:00 KST with night consent passes",
130
+ "input": {
131
+ "user": {
132
+ "id": "u1",
133
+ "consent": true,
134
+ "proactiveEnabled": true,
135
+ "mode": "normal",
136
+ "intensity": "normal",
137
+ "timezone": "Asia/Seoul",
138
+ "quietHours": {
139
+ "start": "22:00",
140
+ "end": "08:00"
141
+ },
142
+ "createdAt": "2026-01-01T00:00:00Z",
143
+ "consents": {
144
+ "ad": true,
145
+ "night": true
146
+ }
147
+ },
148
+ "candidate": {
149
+ "id": "c1",
150
+ "type": "reminder",
151
+ "priority": "normal",
152
+ "surfaces": [
153
+ "push",
154
+ "feed"
155
+ ]
156
+ },
157
+ "now": "2026-09-04T14:00:00Z"
158
+ },
159
+ "expect": {
160
+ "allowed": true,
161
+ "trace": [
162
+ "consent:ad",
163
+ "consent:night"
164
+ ]
165
+ }
166
+ }
167
+ ]
168
+ }
package/spec/fixtures/presets/telegram-bot.json ADDED
@@ -0,0 +1,162 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "presets/telegram-bot",
5
+ "description": "telegramBot limits one message a second and twenty a minute per channel.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "preset": "telegramBot"
11
+ }
12
+ ]
13
+ },
14
+ "tests": [
15
+ {
16
+ "description": "first message in the second",
17
+ "input": {
18
+ "user": {
19
+ "id": "u1",
20
+ "consent": true,
21
+ "proactiveEnabled": true,
22
+ "mode": "normal",
23
+ "intensity": "normal",
24
+ "timezone": "Europe/Istanbul",
25
+ "quietHours": {
26
+ "start": "22:00",
27
+ "end": "08:00"
28
+ },
29
+ "createdAt": "2026-01-01T00:00:00Z"
30
+ },
31
+ "candidate": {
32
+ "id": "c1",
33
+ "type": "reminder",
34
+ "priority": "normal",
35
+ "surfaces": [
36
+ "push",
37
+ "feed"
38
+ ],
39
+ "channel": "chat-1"
40
+ },
41
+ "now": "2026-09-04T09:00:00Z"
42
+ },
43
+ "commit": true,
44
+ "expect": {
45
+ "allowed": true,
46
+ "trace": [
47
+ "rate:1/s",
48
+ "rate:20/min"
49
+ ],
50
+ "commit": true
51
+ }
52
+ },
53
+ {
54
+ "description": "second message in the same second is rejected",
55
+ "input": {
56
+ "user": {
57
+ "id": "u1",
58
+ "consent": true,
59
+ "proactiveEnabled": true,
60
+ "mode": "normal",
61
+ "intensity": "normal",
62
+ "timezone": "Europe/Istanbul",
63
+ "quietHours": {
64
+ "start": "22:00",
65
+ "end": "08:00"
66
+ },
67
+ "createdAt": "2026-01-01T00:00:00Z"
68
+ },
69
+ "candidate": {
70
+ "id": "c2",
71
+ "type": "reminder",
72
+ "priority": "normal",
73
+ "surfaces": [
74
+ "push",
75
+ "feed"
76
+ ],
77
+ "channel": "chat-1"
78
+ },
79
+ "now": "2026-09-04T09:00:00Z"
80
+ },
81
+ "expect": {
82
+ "allowed": false,
83
+ "rejectedBy": "rate:1/s",
84
+ "trace": [
85
+ "rate:1/s"
86
+ ]
87
+ }
88
+ },
89
+ {
90
+ "description": "another channel is unaffected",
91
+ "input": {
92
+ "user": {
93
+ "id": "u1",
94
+ "consent": true,
95
+ "proactiveEnabled": true,
96
+ "mode": "normal",
97
+ "intensity": "normal",
98
+ "timezone": "Europe/Istanbul",
99
+ "quietHours": {
100
+ "start": "22:00",
101
+ "end": "08:00"
102
+ },
103
+ "createdAt": "2026-01-01T00:00:00Z"
104
+ },
105
+ "candidate": {
106
+ "id": "c3",
107
+ "type": "reminder",
108
+ "priority": "normal",
109
+ "surfaces": [
110
+ "push",
111
+ "feed"
112
+ ],
113
+ "channel": "chat-2"
114
+ },
115
+ "now": "2026-09-04T09:00:00Z"
116
+ },
117
+ "expect": {
118
+ "allowed": true,
119
+ "trace": [
120
+ "rate:1/s",
121
+ "rate:20/min"
122
+ ]
123
+ }
124
+ },
125
+ {
126
+ "description": "next second on the first channel passes",
127
+ "input": {
128
+ "user": {
129
+ "id": "u1",
130
+ "consent": true,
131
+ "proactiveEnabled": true,
132
+ "mode": "normal",
133
+ "intensity": "normal",
134
+ "timezone": "Europe/Istanbul",
135
+ "quietHours": {
136
+ "start": "22:00",
137
+ "end": "08:00"
138
+ },
139
+ "createdAt": "2026-01-01T00:00:00Z"
140
+ },
141
+ "candidate": {
142
+ "id": "c4",
143
+ "type": "reminder",
144
+ "priority": "normal",
145
+ "surfaces": [
146
+ "push",
147
+ "feed"
148
+ ],
149
+ "channel": "chat-1"
150
+ },
151
+ "now": "2026-09-04T09:00:01Z"
152
+ },
153
+ "expect": {
154
+ "allowed": true,
155
+ "trace": [
156
+ "rate:1/s",
157
+ "rate:20/min"
158
+ ]
159
+ }
160
+ }
161
+ ]
162
+ }
package/spec/fixtures/presets/us-tcpa.json ADDED
@@ -0,0 +1,90 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "presets/us-tcpa",
5
+ "description": "usTcpa allows 08:00 to 21:00 in the user's zone.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "id": "consent"
11
+ },
12
+ {
13
+ "preset": "usTcpa"
14
+ }
15
+ ]
16
+ },
17
+ "tests": [
18
+ {
19
+ "description": "21:30 Chicago rejects",
20
+ "input": {
21
+ "user": {
22
+ "id": "u1",
23
+ "consent": true,
24
+ "proactiveEnabled": true,
25
+ "mode": "normal",
26
+ "intensity": "normal",
27
+ "timezone": "America/Chicago",
28
+ "quietHours": {
29
+ "start": "22:00",
30
+ "end": "08:00"
31
+ },
32
+ "createdAt": "2026-01-01T00:00:00Z"
33
+ },
34
+ "candidate": {
35
+ "id": "c1",
36
+ "type": "reminder",
37
+ "priority": "normal",
38
+ "surfaces": [
39
+ "push",
40
+ "feed"
41
+ ]
42
+ },
43
+ "now": "2026-09-05T02:30:00Z"
44
+ },
45
+ "expect": {
46
+ "allowed": false,
47
+ "rejectedBy": "window:tcpa",
48
+ "trace": [
49
+ "consent",
50
+ "window:tcpa"
51
+ ]
52
+ }
53
+ },
54
+ {
55
+ "description": "09:00 Chicago passes",
56
+ "input": {
57
+ "user": {
58
+ "id": "u1",
59
+ "consent": true,
60
+ "proactiveEnabled": true,
61
+ "mode": "normal",
62
+ "intensity": "normal",
63
+ "timezone": "America/Chicago",
64
+ "quietHours": {
65
+ "start": "22:00",
66
+ "end": "08:00"
67
+ },
68
+ "createdAt": "2026-01-01T00:00:00Z"
69
+ },
70
+ "candidate": {
71
+ "id": "c1",
72
+ "type": "reminder",
73
+ "priority": "normal",
74
+ "surfaces": [
75
+ "push",
76
+ "feed"
77
+ ]
78
+ },
79
+ "now": "2026-09-04T14:00:00Z"
80
+ },
81
+ "expect": {
82
+ "allowed": true,
83
+ "trace": [
84
+ "consent",
85
+ "window:tcpa"
86
+ ]
87
+ }
88
+ }
89
+ ]
90
+ }