@selvajs/server 0.2.0-beta.1 → 0.2.0-beta.3

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 (192) hide show
  1. package/dist/access/__tests__/project-access-input.test.d.ts +2 -0
  2. package/dist/access/__tests__/project-access-input.test.d.ts.map +1 -0
  3. package/dist/access/__tests__/project-access-input.test.js +146 -0
  4. package/dist/access/__tests__/project-access-input.test.js.map +1 -0
  5. package/dist/access/index.d.ts +2 -0
  6. package/dist/access/index.d.ts.map +1 -0
  7. package/dist/access/index.js +4 -0
  8. package/dist/access/index.js.map +1 -0
  9. package/dist/access/project-access-input.d.ts +52 -0
  10. package/dist/access/project-access-input.d.ts.map +1 -0
  11. package/dist/access/project-access-input.js +56 -0
  12. package/dist/access/project-access-input.js.map +1 -0
  13. package/dist/compute/__tests__/client-cache.test.js +70 -1
  14. package/dist/compute/__tests__/client-cache.test.js.map +1 -1
  15. package/dist/compute/__tests__/definition-byte-cache.test.d.ts +2 -0
  16. package/dist/compute/__tests__/definition-byte-cache.test.d.ts.map +1 -0
  17. package/dist/compute/__tests__/definition-byte-cache.test.js +107 -0
  18. package/dist/compute/__tests__/definition-byte-cache.test.js.map +1 -0
  19. package/dist/compute/__tests__/rate-limit.test.js +36 -0
  20. package/dist/compute/__tests__/rate-limit.test.js.map +1 -1
  21. package/dist/compute/__tests__/solve-cache.test.d.ts +13 -0
  22. package/dist/compute/__tests__/solve-cache.test.d.ts.map +1 -0
  23. package/dist/compute/__tests__/solve-cache.test.js +234 -0
  24. package/dist/compute/__tests__/solve-cache.test.js.map +1 -0
  25. package/dist/compute/__tests__/solve-pipeline.test.js +327 -15
  26. package/dist/compute/__tests__/solve-pipeline.test.js.map +1 -1
  27. package/dist/compute/__tests__/transform-input.test.js +7 -1
  28. package/dist/compute/__tests__/transform-input.test.js.map +1 -1
  29. package/dist/compute/client-cache.d.ts +32 -8
  30. package/dist/compute/client-cache.d.ts.map +1 -1
  31. package/dist/compute/client-cache.js +24 -6
  32. package/dist/compute/client-cache.js.map +1 -1
  33. package/dist/compute/definition-byte-cache.d.ts +85 -0
  34. package/dist/compute/definition-byte-cache.d.ts.map +1 -0
  35. package/dist/compute/definition-byte-cache.js +110 -0
  36. package/dist/compute/definition-byte-cache.js.map +1 -0
  37. package/dist/compute/index.d.ts +7 -2
  38. package/dist/compute/index.d.ts.map +1 -1
  39. package/dist/compute/index.js +6 -1
  40. package/dist/compute/index.js.map +1 -1
  41. package/dist/compute/limits.d.ts +62 -0
  42. package/dist/compute/limits.d.ts.map +1 -1
  43. package/dist/compute/limits.js +35 -1
  44. package/dist/compute/limits.js.map +1 -1
  45. package/dist/compute/memory-solve-cache.d.ts +58 -0
  46. package/dist/compute/memory-solve-cache.d.ts.map +1 -0
  47. package/dist/compute/memory-solve-cache.js +0 -0
  48. package/dist/compute/memory-solve-cache.js.map +1 -0
  49. package/dist/compute/rate-limit.d.ts +12 -0
  50. package/dist/compute/rate-limit.d.ts.map +1 -1
  51. package/dist/compute/rate-limit.js +18 -0
  52. package/dist/compute/rate-limit.js.map +1 -1
  53. package/dist/compute/solve-cache-envelope.d.ts +53 -0
  54. package/dist/compute/solve-cache-envelope.d.ts.map +1 -0
  55. package/dist/compute/solve-cache-envelope.js +66 -0
  56. package/dist/compute/solve-cache-envelope.js.map +1 -0
  57. package/dist/compute/solve-cache-key.d.ts +65 -0
  58. package/dist/compute/solve-cache-key.d.ts.map +1 -0
  59. package/dist/compute/solve-cache-key.js +50 -0
  60. package/dist/compute/solve-cache-key.js.map +1 -0
  61. package/dist/compute/solve-cache-single-flight.d.ts +35 -0
  62. package/dist/compute/solve-cache-single-flight.d.ts.map +1 -0
  63. package/dist/compute/solve-cache-single-flight.js +48 -0
  64. package/dist/compute/solve-cache-single-flight.js.map +1 -0
  65. package/dist/compute/solve-pipeline.d.ts +71 -8
  66. package/dist/compute/solve-pipeline.d.ts.map +1 -1
  67. package/dist/compute/solve-pipeline.js +198 -15
  68. package/dist/compute/solve-pipeline.js.map +1 -1
  69. package/dist/compute/transform-input.d.ts.map +1 -1
  70. package/dist/compute/transform-input.js +21 -6
  71. package/dist/compute/transform-input.js.map +1 -1
  72. package/dist/definitions/__tests__/definition-service.test.d.ts +14 -0
  73. package/dist/definitions/__tests__/definition-service.test.d.ts.map +1 -0
  74. package/dist/definitions/__tests__/definition-service.test.js +95 -0
  75. package/dist/definitions/__tests__/definition-service.test.js.map +1 -0
  76. package/dist/definitions/definition-service.d.ts +1 -1
  77. package/dist/definitions/definition-service.d.ts.map +1 -1
  78. package/dist/definitions/definition-service.js +8 -4
  79. package/dist/definitions/definition-service.js.map +1 -1
  80. package/dist/errors/SentryErrorReporter.d.ts +17 -0
  81. package/dist/errors/SentryErrorReporter.d.ts.map +1 -0
  82. package/dist/errors/SentryErrorReporter.js +60 -0
  83. package/dist/errors/SentryErrorReporter.js.map +1 -0
  84. package/dist/errors/index.d.ts +2 -0
  85. package/dist/errors/index.d.ts.map +1 -0
  86. package/dist/errors/index.js +3 -0
  87. package/dist/errors/index.js.map +1 -0
  88. package/dist/http/__tests__/body-size.test.d.ts +2 -0
  89. package/dist/http/__tests__/body-size.test.d.ts.map +1 -0
  90. package/dist/http/__tests__/body-size.test.js +24 -0
  91. package/dist/http/__tests__/body-size.test.js.map +1 -0
  92. package/dist/http/__tests__/route-classifier.test.d.ts +2 -0
  93. package/dist/http/__tests__/route-classifier.test.d.ts.map +1 -0
  94. package/dist/http/__tests__/route-classifier.test.js +54 -0
  95. package/dist/http/__tests__/route-classifier.test.js.map +1 -0
  96. package/dist/http/__tests__/safe-redirect.test.d.ts +2 -0
  97. package/dist/http/__tests__/safe-redirect.test.d.ts.map +1 -0
  98. package/dist/http/__tests__/safe-redirect.test.js +44 -0
  99. package/dist/http/__tests__/safe-redirect.test.js.map +1 -0
  100. package/dist/http/__tests__/security-headers.test.d.ts +2 -0
  101. package/dist/http/__tests__/security-headers.test.d.ts.map +1 -0
  102. package/dist/http/__tests__/security-headers.test.js +24 -0
  103. package/dist/http/__tests__/security-headers.test.js.map +1 -0
  104. package/dist/http/body-size.d.ts +21 -0
  105. package/dist/http/body-size.d.ts.map +1 -0
  106. package/dist/http/body-size.js +20 -0
  107. package/dist/http/body-size.js.map +1 -0
  108. package/dist/http/index.d.ts +5 -0
  109. package/dist/http/index.d.ts.map +1 -0
  110. package/dist/http/index.js +6 -0
  111. package/dist/http/index.js.map +1 -0
  112. package/dist/http/redirect.d.ts +11 -0
  113. package/dist/http/redirect.d.ts.map +1 -0
  114. package/dist/http/redirect.js +20 -0
  115. package/dist/http/redirect.js.map +1 -0
  116. package/dist/http/route-classifier.d.ts +47 -0
  117. package/dist/http/route-classifier.d.ts.map +1 -0
  118. package/dist/http/route-classifier.js +37 -0
  119. package/dist/http/route-classifier.js.map +1 -0
  120. package/dist/http/security-headers.d.ts +31 -0
  121. package/dist/http/security-headers.d.ts.map +1 -0
  122. package/dist/http/security-headers.js +31 -0
  123. package/dist/http/security-headers.js.map +1 -0
  124. package/dist/index.d.ts +11 -2
  125. package/dist/index.d.ts.map +1 -1
  126. package/dist/index.js +11 -2
  127. package/dist/index.js.map +1 -1
  128. package/dist/ops/__tests__/semver.test.d.ts +2 -0
  129. package/dist/ops/__tests__/semver.test.d.ts.map +1 -0
  130. package/dist/ops/__tests__/semver.test.js +38 -0
  131. package/dist/ops/__tests__/semver.test.js.map +1 -0
  132. package/dist/ops/index.d.ts +2 -0
  133. package/dist/ops/index.d.ts.map +1 -0
  134. package/dist/ops/index.js +3 -0
  135. package/dist/ops/index.js.map +1 -0
  136. package/dist/ops/semver.d.ts +35 -0
  137. package/dist/ops/semver.d.ts.map +1 -0
  138. package/dist/ops/semver.js +55 -0
  139. package/dist/ops/semver.js.map +1 -0
  140. package/dist/tokens/__tests__/token-codec.test.d.ts +2 -0
  141. package/dist/tokens/__tests__/token-codec.test.d.ts.map +1 -0
  142. package/dist/tokens/__tests__/token-codec.test.js +50 -0
  143. package/dist/tokens/__tests__/token-codec.test.js.map +1 -0
  144. package/dist/tokens/index.d.ts +2 -0
  145. package/dist/tokens/index.d.ts.map +1 -0
  146. package/dist/tokens/index.js +3 -0
  147. package/dist/tokens/index.js.map +1 -0
  148. package/dist/tokens/token-codec.d.ts +54 -0
  149. package/dist/tokens/token-codec.d.ts.map +1 -0
  150. package/dist/tokens/token-codec.js +62 -0
  151. package/dist/tokens/token-codec.js.map +1 -0
  152. package/package.json +35 -2
  153. package/src/access/__tests__/project-access-input.test.ts +175 -0
  154. package/src/access/index.ts +9 -0
  155. package/src/access/project-access-input.ts +145 -0
  156. package/src/compute/__tests__/client-cache.test.ts +81 -1
  157. package/src/compute/__tests__/definition-byte-cache.test.ts +129 -0
  158. package/src/compute/__tests__/rate-limit.test.ts +37 -0
  159. package/src/compute/__tests__/solve-cache.test.ts +268 -0
  160. package/src/compute/__tests__/solve-pipeline.test.ts +380 -14
  161. package/src/compute/__tests__/transform-input.test.ts +8 -1
  162. package/src/compute/client-cache.ts +59 -16
  163. package/src/compute/definition-byte-cache.ts +168 -0
  164. package/src/compute/index.ts +34 -0
  165. package/src/compute/limits.ts +91 -1
  166. package/src/compute/memory-solve-cache.ts +0 -0
  167. package/src/compute/rate-limit.ts +27 -0
  168. package/src/compute/solve-cache-envelope.ts +98 -0
  169. package/src/compute/solve-cache-key.ts +85 -0
  170. package/src/compute/solve-cache-single-flight.ts +59 -0
  171. package/src/compute/solve-pipeline.ts +301 -22
  172. package/src/compute/transform-input.ts +20 -6
  173. package/src/definitions/__tests__/definition-service.test.ts +131 -0
  174. package/src/definitions/definition-service.ts +8 -4
  175. package/src/errors/SentryErrorReporter.ts +88 -0
  176. package/src/errors/index.ts +3 -0
  177. package/src/http/__tests__/body-size.test.ts +27 -0
  178. package/src/http/__tests__/route-classifier.test.ts +60 -0
  179. package/src/http/__tests__/safe-redirect.test.ts +47 -0
  180. package/src/http/__tests__/security-headers.test.ts +29 -0
  181. package/src/http/body-size.ts +24 -0
  182. package/src/http/index.ts +10 -0
  183. package/src/http/redirect.ts +16 -0
  184. package/src/http/route-classifier.ts +74 -0
  185. package/src/http/security-headers.ts +42 -0
  186. package/src/index.ts +11 -2
  187. package/src/ops/__tests__/semver.test.ts +42 -0
  188. package/src/ops/index.ts +3 -0
  189. package/src/ops/semver.ts +60 -0
  190. package/src/tokens/__tests__/token-codec.test.ts +63 -0
  191. package/src/tokens/index.ts +8 -0
  192. package/src/tokens/token-codec.ts +86 -0
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=project-access-input.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-access-input.test.d.ts","sourceRoot":"","sources":["../../../src/access/__tests__/project-access-input.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,146 @@
1
+ import { describe, it, expect, vi } from 'vitest';
2
+ import { createProjectAccessInputBuilder } from '../project-access-input.js';
3
+ const CTX = {
4
+ userId: 'user-1',
5
+ actingOrgId: 'org-1',
6
+ platformPermissions: ['manage_compute'],
7
+ orgPermissions: ['manage_org_members']
8
+ };
9
+ function project(visibility) {
10
+ return {
11
+ id: 'proj-1',
12
+ orgId: 'org-1',
13
+ name: 'P',
14
+ slug: 'p',
15
+ visibility,
16
+ ownerId: 'user-9',
17
+ createdBy: 'user-9',
18
+ updatedBy: 'user-9',
19
+ autoJoinOnUpload: false,
20
+ createdAt: '2026-01-01T00:00:00Z',
21
+ updatedAt: '2026-01-01T00:00:00Z'
22
+ };
23
+ }
24
+ // Row identity is all the builder consumes — it passes rows through opaquely.
25
+ const MEMBER = {
26
+ projectId: 'proj-1',
27
+ userId: 'user-1',
28
+ role: 'editor'
29
+ };
30
+ const ORG_MEMBER = {
31
+ orgId: 'org-1',
32
+ userId: 'user-1',
33
+ role: 'member'
34
+ };
35
+ const GRANT = {
36
+ projectId: 'proj-1',
37
+ orgId: 'org-2',
38
+ canSolve: true
39
+ };
40
+ function makeDeps(flags = {}) {
41
+ return {
42
+ getProjectMember: vi.fn().mockResolvedValue(MEMBER),
43
+ getOrgMember: vi.fn().mockResolvedValue(ORG_MEMBER),
44
+ listPlatformGrants: vi.fn().mockResolvedValue([GRANT]),
45
+ flags: vi.fn().mockReturnValue({
46
+ allowCrossOrgPublic: false,
47
+ enablePlatformProjects: false,
48
+ ...flags
49
+ })
50
+ };
51
+ }
52
+ describe('buildProjectAccessInput — per-visibility row fetching', () => {
53
+ it('private: fetches only the project member row', async () => {
54
+ const deps = makeDeps();
55
+ const builder = createProjectAccessInputBuilder(deps);
56
+ const input = await builder.buildProjectAccessInput(CTX, project('private'));
57
+ expect(input.member).toEqual(MEMBER);
58
+ expect(input.orgMember).toBeNull();
59
+ expect(input.platformGrants).toEqual([]);
60
+ expect(deps.getOrgMember).not.toHaveBeenCalled();
61
+ expect(deps.listPlatformGrants).not.toHaveBeenCalled();
62
+ });
63
+ it.each(['org', 'public'])('%s: fetches project member + org member', async (vis) => {
64
+ const deps = makeDeps();
65
+ const builder = createProjectAccessInputBuilder(deps);
66
+ const input = await builder.buildProjectAccessInput(CTX, project(vis));
67
+ expect(input.member).toEqual(MEMBER);
68
+ expect(input.orgMember).toEqual(ORG_MEMBER);
69
+ expect(deps.getOrgMember).toHaveBeenCalledWith(CTX, 'org-1', 'user-1');
70
+ });
71
+ it('public + ALLOW_CROSS_ORG_PUBLIC: skips the org member row', async () => {
72
+ const deps = makeDeps({ allowCrossOrgPublic: true });
73
+ const builder = createProjectAccessInputBuilder(deps);
74
+ const input = await builder.buildProjectAccessInput(CTX, project('public'));
75
+ expect(input.member).toEqual(MEMBER);
76
+ expect(input.orgMember).toBeNull();
77
+ expect(deps.getOrgMember).not.toHaveBeenCalled();
78
+ });
79
+ it('org visibility still fetches the org row when cross-org public is on', async () => {
80
+ const deps = makeDeps({ allowCrossOrgPublic: true });
81
+ const builder = createProjectAccessInputBuilder(deps);
82
+ const input = await builder.buildProjectAccessInput(CTX, project('org'));
83
+ expect(input.orgMember).toEqual(ORG_MEMBER);
84
+ });
85
+ it('platform + flag on: fetches grants only', async () => {
86
+ const deps = makeDeps({ enablePlatformProjects: true });
87
+ const builder = createProjectAccessInputBuilder(deps);
88
+ const input = await builder.buildProjectAccessInput(CTX, project('platform'));
89
+ expect(input.platformGrants).toEqual([GRANT]);
90
+ expect(input.member).toBeNull();
91
+ expect(deps.getProjectMember).not.toHaveBeenCalled();
92
+ expect(deps.getOrgMember).not.toHaveBeenCalled();
93
+ });
94
+ it('platform + flag off: skips the grant lookup entirely (feature disabled stays cheap)', async () => {
95
+ const deps = makeDeps({ enablePlatformProjects: false });
96
+ const builder = createProjectAccessInputBuilder(deps);
97
+ const input = await builder.buildProjectAccessInput(CTX, project('platform'));
98
+ expect(input.platformGrants).toEqual([]);
99
+ expect(deps.listPlatformGrants).not.toHaveBeenCalled();
100
+ });
101
+ it('threads ctx fields and flags into the input, with overrides winning', async () => {
102
+ const deps = makeDeps({ allowCrossOrgPublic: true });
103
+ const builder = createProjectAccessInputBuilder(deps);
104
+ const input = await builder.buildProjectAccessInput(CTX, project('private'), {
105
+ member: null
106
+ });
107
+ expect(input.userId).toBe('user-1');
108
+ expect(input.actingOrgId).toBe('org-1');
109
+ expect(input.orgPermissions).toEqual(CTX.orgPermissions);
110
+ expect(input.platformPermissions).toEqual(CTX.platformPermissions);
111
+ expect(input.allowCrossOrgPublic).toBe(true);
112
+ expect(input.member).toBeNull(); // override beat the fetched row
113
+ });
114
+ it('reads flags per call, not at builder creation', async () => {
115
+ const deps = makeDeps();
116
+ const builder = createProjectAccessInputBuilder(deps);
117
+ await builder.buildProjectAccessInput(CTX, project('private'));
118
+ deps.flags.mockReturnValue({ allowCrossOrgPublic: true, enablePlatformProjects: true });
119
+ const input = await builder.buildProjectAccessInput(CTX, project('private'));
120
+ expect(input.enablePlatformProjects).toBe(true);
121
+ });
122
+ });
123
+ describe('projectAccessInputFromRows', () => {
124
+ it('assembles from caller rows with zero I/O', () => {
125
+ const deps = makeDeps();
126
+ const builder = createProjectAccessInputBuilder(deps);
127
+ const input = builder.projectAccessInputFromRows(CTX, project('org'), {
128
+ member: MEMBER,
129
+ orgMember: ORG_MEMBER
130
+ });
131
+ expect(input.member).toEqual(MEMBER);
132
+ expect(input.orgMember).toEqual(ORG_MEMBER);
133
+ expect(input.platformGrants).toEqual([]);
134
+ expect(deps.getProjectMember).not.toHaveBeenCalled();
135
+ expect(deps.getOrgMember).not.toHaveBeenCalled();
136
+ expect(deps.listPlatformGrants).not.toHaveBeenCalled();
137
+ });
138
+ it('defaults omitted rows to null/empty', () => {
139
+ const builder = createProjectAccessInputBuilder(makeDeps());
140
+ const input = builder.projectAccessInputFromRows(CTX, project('private'), {});
141
+ expect(input.member).toBeNull();
142
+ expect(input.orgMember).toBeNull();
143
+ expect(input.platformGrants).toEqual([]);
144
+ });
145
+ });
146
+ //# sourceMappingURL=project-access-input.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-access-input.test.js","sourceRoot":"","sources":["../../../src/access/__tests__/project-access-input.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export { createProjectAccessInputBuilder, type ProjectAccessFlags, type ProjectAccessInputBuilder, type ProjectAccessInputDeps } from './project-access-input.js';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/access/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,+BAA+B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,MAAM,2BAA2B,CAAC"}
@@ -0,0 +1,4 @@
1
+ // Access-rule input assembly — marshals providers + flags into what
2
+ // platform's pure canView/canEdit/… rules consume.
3
+ export { createProjectAccessInputBuilder } from './project-access-input.js';
4
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/access/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,mDAAmD;AAEnD,OAAO,EACN,+BAA+B,EAI/B,MAAM,2BAA2B,CAAC"}
@@ -0,0 +1,52 @@
1
+ import type { Project, ProjectAccessInput, RequestContext } from '@selvajs/platform';
2
+ /**
3
+ * Assembly of `ProjectAccessInput` — the marshalling layer between an app's
4
+ * providers and platform's pure access rules (`canView`/`canEdit`/`canSolve`/
5
+ * `canManage`/…). The rules are pure functions over one input shape; the
6
+ * knowledge captured here is **which rows each project visibility needs**, so
7
+ * a consuming app doesn't reimplement (and mis-fetch) it:
8
+ *
9
+ * - `platform` → grants (skipped entirely while the feature flag is off)
10
+ * - `private` → caller's project member row
11
+ * - `org` / `public` → caller's project member row (for canEdit/canManage) and
12
+ * org member row (for canView). Cross-org public skips the org row.
13
+ *
14
+ * Wiring is injected: row lookups as functions (so lazily-initialized
15
+ * providers work unchanged) and flags read per call (so runtime flag flips
16
+ * behave like the app's own `flag()` reads).
17
+ */
18
+ export interface ProjectAccessFlags {
19
+ /** `ALLOW_CROSS_ORG_PUBLIC` — public visibility spans orgs when true. */
20
+ allowCrossOrgPublic: boolean;
21
+ /** `ENABLE_PLATFORM_PROJECTS` — platform visibility is live when true. */
22
+ enablePlatformProjects: boolean;
23
+ }
24
+ export interface ProjectAccessInputDeps {
25
+ getProjectMember(ctx: RequestContext, projectId: string, userId: string): Promise<ProjectAccessInput['member']>;
26
+ getOrgMember(ctx: RequestContext, orgId: string, userId: string): Promise<ProjectAccessInput['orgMember']>;
27
+ listPlatformGrants(ctx: RequestContext, projectId: string): Promise<ProjectAccessInput['platformGrants']>;
28
+ /** Read the two access-relevant feature flags. Called once per assembly. */
29
+ flags(): ProjectAccessFlags;
30
+ }
31
+ export interface ProjectAccessInputBuilder {
32
+ /**
33
+ * Build the rule input for any project-scope rule, fetching exactly the
34
+ * rows the rule will consult based on `project.visibility`. Other fields
35
+ * default to safe values; pass `overrides` for the rare callers that
36
+ * already loaded a row (e.g. tests, batched listing pages).
37
+ */
38
+ buildProjectAccessInput(ctx: RequestContext, project: Project, overrides?: Partial<ProjectAccessInput>): Promise<ProjectAccessInput>;
39
+ /**
40
+ * Build a `ProjectAccessInput` from caller-provided rows without any I/O.
41
+ * Used by listing pages that have already batch-loaded membership for many
42
+ * projects; the per-row predicate calls this instead of
43
+ * `buildProjectAccessInput` to avoid an N+1 fetch.
44
+ */
45
+ projectAccessInputFromRows(ctx: RequestContext, project: Project, rows: {
46
+ member?: ProjectAccessInput['member'];
47
+ orgMember?: ProjectAccessInput['orgMember'];
48
+ platformGrants?: ProjectAccessInput['platformGrants'];
49
+ }): ProjectAccessInput;
50
+ }
51
+ export declare function createProjectAccessInputBuilder(deps: ProjectAccessInputDeps): ProjectAccessInputBuilder;
52
+ //# sourceMappingURL=project-access-input.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-access-input.d.ts","sourceRoot":"","sources":["../../src/access/project-access-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErF;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,kBAAkB;IAClC,yEAAyE;IACzE,mBAAmB,EAAE,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,sBAAsB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACtC,gBAAgB,CACf,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,YAAY,CACX,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5C,kBAAkB,CACjB,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACjD,4EAA4E;IAC5E,KAAK,IAAI,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACzC;;;;;OAKG;IACH,uBAAuB,CACtB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,0BAA0B,CACzB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;QACL,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACtC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC5C,cAAc,CAAC,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;KACtD,GACC,kBAAkB,CAAC;CACtB;AAED,wBAAgB,+BAA+B,CAC9C,IAAI,EAAE,sBAAsB,GAC1B,yBAAyB,CAoE3B"}
@@ -0,0 +1,56 @@
1
+ export function createProjectAccessInputBuilder(deps) {
2
+ return {
3
+ async buildProjectAccessInput(ctx, project, overrides = {}) {
4
+ const { allowCrossOrgPublic, enablePlatformProjects } = deps.flags();
5
+ let member = null;
6
+ let orgMember = null;
7
+ let platformGrants = [];
8
+ if (project.visibility === 'platform') {
9
+ // When the flag is off the rule short-circuits before reading grants —
10
+ // skip the lookup to keep "feature disabled" cheap.
11
+ if (enablePlatformProjects) {
12
+ platformGrants = await deps.listPlatformGrants(ctx, project.id);
13
+ }
14
+ }
15
+ else if (project.visibility === 'private') {
16
+ member = await deps.getProjectMember(ctx, project.id, ctx.userId);
17
+ }
18
+ else {
19
+ const skipOrgMember = project.visibility === 'public' && allowCrossOrgPublic;
20
+ [member, orgMember] = await Promise.all([
21
+ deps.getProjectMember(ctx, project.id, ctx.userId),
22
+ skipOrgMember ? Promise.resolve(null) : deps.getOrgMember(ctx, project.orgId, ctx.userId)
23
+ ]);
24
+ }
25
+ return {
26
+ orgPermissions: ctx.orgPermissions,
27
+ platformPermissions: ctx.platformPermissions,
28
+ project,
29
+ member,
30
+ orgMember,
31
+ allowCrossOrgPublic,
32
+ enablePlatformProjects,
33
+ platformGrants,
34
+ actingOrgId: ctx.actingOrgId ?? null,
35
+ userId: ctx.userId,
36
+ ...overrides
37
+ };
38
+ },
39
+ projectAccessInputFromRows(ctx, project, rows) {
40
+ const { allowCrossOrgPublic, enablePlatformProjects } = deps.flags();
41
+ return {
42
+ orgPermissions: ctx.orgPermissions,
43
+ platformPermissions: ctx.platformPermissions,
44
+ project,
45
+ member: rows.member ?? null,
46
+ orgMember: rows.orgMember ?? null,
47
+ allowCrossOrgPublic,
48
+ enablePlatformProjects,
49
+ platformGrants: rows.platformGrants ?? [],
50
+ actingOrgId: ctx.actingOrgId ?? null,
51
+ userId: ctx.userId
52
+ };
53
+ }
54
+ };
55
+ }
56
+ //# sourceMappingURL=project-access-input.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-access-input.js","sourceRoot":"","sources":["../../src/access/project-access-input.ts"],"names":[],"mappings":"AA0EA,MAAM,UAAU,+BAA+B,CAC9C,IAA4B;IAE5B,OAAO;QACN,KAAK,CAAC,uBAAuB,CAC5B,GAAmB,EACnB,OAAgB,EAChB,YAAyC,EAAE;YAE3C,MAAM,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAErE,IAAI,MAAM,GAAiC,IAAI,CAAC;YAChD,IAAI,SAAS,GAAoC,IAAI,CAAC;YACtD,IAAI,cAAc,GAAyC,EAAE,CAAC;YAE9D,IAAI,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACvC,uEAAuE;gBACvE,oDAAoD;gBACpD,IAAI,sBAAsB,EAAE,CAAC;oBAC5B,cAAc,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;gBACjE,CAAC;YACF,CAAC;iBAAM,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7C,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACnE,CAAC;iBAAM,CAAC;gBACP,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,mBAAmB,CAAC;gBAC7E,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBACvC,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC;oBAClD,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;iBACzF,CAAC,CAAC;YACJ,CAAC;YAED,OAAO;gBACN,cAAc,EAAE,GAAG,CAAC,cAAc;gBAClC,mBAAmB,EAAE,GAAG,CAAC,mBAAmB;gBAC5C,OAAO;gBACP,MAAM;gBACN,SAAS;gBACT,mBAAmB;gBACnB,sBAAsB;gBACtB,cAAc;gBACd,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;gBACpC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,GAAG,SAAS;aACZ,CAAC;QACH,CAAC;QAED,0BAA0B,CACzB,GAAmB,EACnB,OAAgB,EAChB,IAIC;YAED,MAAM,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACrE,OAAO;gBACN,cAAc,EAAE,GAAG,CAAC,cAAc;gBAClC,mBAAmB,EAAE,GAAG,CAAC,mBAAmB;gBAC5C,OAAO;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;gBACjC,mBAAmB;gBACnB,sBAAsB;gBACtB,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,EAAE;gBACzC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;gBACpC,MAAM,EAAE,GAAG,CAAC,MAAM;aAClB,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}
@@ -10,6 +10,7 @@
10
10
  import { describe, it, expect, beforeEach, vi } from 'vitest';
11
11
  // --- Mock @selvajs/compute -------------------------------------------------
12
12
  const createdConfigs = [];
13
+ const createdSchedulerOptions = [];
13
14
  const disposedSchedulers = [];
14
15
  vi.mock('@selvajs/compute', () => {
15
16
  class GrasshopperClient {
@@ -21,7 +22,8 @@ vi.mock('@selvajs/compute', () => {
21
22
  constructor(config) {
22
23
  this.config = config;
23
24
  }
24
- createScheduler() {
25
+ createScheduler(options) {
26
+ createdSchedulerOptions.push(options);
25
27
  const scheduler = {
26
28
  disposed: false,
27
29
  dispose() {
@@ -38,6 +40,9 @@ import { createClientCache, serverIdentity } from '../client-cache.js';
38
40
  function baseConfig() {
39
41
  return {
40
42
  maxSolveDurationMs: 30_000,
43
+ maxConcurrentSolves: 4,
44
+ maxQueueDepth: 0,
45
+ queueWaitMs: 0,
41
46
  cachesolve: true,
42
47
  cacheerroredsolves: false,
43
48
  reuseServerDefinitionCache: true,
@@ -52,6 +57,7 @@ const server = (id, over = {}) => ({
52
57
  });
53
58
  beforeEach(() => {
54
59
  createdConfigs.length = 0;
60
+ createdSchedulerOptions.length = 0;
55
61
  disposedSchedulers.length = 0;
56
62
  });
57
63
  describe('createClientCache — keying', () => {
@@ -141,6 +147,69 @@ describe('createClientCache — X-Selva-Definition (ADR 0004 D2)', () => {
141
147
  expect(createdConfigs[0].headers).toBeUndefined();
142
148
  });
143
149
  });
150
+ describe('createClientCache — scheduler concurrency (audit B6)', () => {
151
+ it('forwards maxConcurrentSolves as the scheduler maxConcurrent in queue mode', async () => {
152
+ const cache = createClientCache({ ...baseConfig(), maxConcurrentSolves: 7 });
153
+ await cache.getClient(server('s1'));
154
+ expect(createdSchedulerOptions).toHaveLength(1);
155
+ // Queue mode with NO maxConcurrent defaults to 1 in the scheduler,
156
+ // serializing every solve on the server — the option must always be set.
157
+ expect(createdSchedulerOptions[0].mode).toBe('queue');
158
+ expect(createdSchedulerOptions[0].maxConcurrent).toBe(7);
159
+ });
160
+ });
161
+ describe('createClientCache — scheduler backpressure (audit B7)', () => {
162
+ it('forwards non-zero queue bounds to the scheduler', async () => {
163
+ const cache = createClientCache({ ...baseConfig(), maxQueueDepth: 12, queueWaitMs: 90_000 });
164
+ await cache.getClient(server('s1'));
165
+ expect(createdSchedulerOptions[0].maxQueueDepth).toBe(12);
166
+ expect(createdSchedulerOptions[0].queueWaitMs).toBe(90_000);
167
+ });
168
+ it('maps a 0 (disabled) queue bound to undefined so the scheduler stays unbounded', async () => {
169
+ // The scheduler treats undefined as unbounded/no-deadline; passing 0 would
170
+ // shed EVERY queued solve. Our `0 = off` convention must become undefined.
171
+ const cache = createClientCache({ ...baseConfig(), maxQueueDepth: 0, queueWaitMs: 0 });
172
+ await cache.getClient(server('s1'));
173
+ expect(createdSchedulerOptions[0].maxQueueDepth).toBeUndefined();
174
+ expect(createdSchedulerOptions[0].queueWaitMs).toBeUndefined();
175
+ });
176
+ });
177
+ describe('createClientCache — per-request telemetry sequence counters', () => {
178
+ it('onServerTiming bumps rhinoTiming.seq on every write', async () => {
179
+ const cache = createClientCache(baseConfig());
180
+ const entry = await cache.getClient(server('s1'));
181
+ expect(entry.rhinoTiming).toEqual({ last: null, seq: 0 });
182
+ createdConfigs[0].onServerTiming({ decode: 5, solve: 100, encode: 3 });
183
+ expect(entry.rhinoTiming.seq).toBe(1);
184
+ expect(entry.rhinoTiming.last).toEqual({ decode: 5, solve: 100, encode: 3 });
185
+ createdConfigs[0].onServerTiming({ decode: 1, solve: 2, encode: 3 });
186
+ expect(entry.rhinoTiming.seq).toBe(2);
187
+ expect(entry.rhinoTiming.last).toEqual({ decode: 1, solve: 2, encode: 3 });
188
+ });
189
+ it('onSettle bumps solveMeta.seq on every settle but writes last only on success', async () => {
190
+ const cache = createClientCache(baseConfig());
191
+ const entry = await cache.getClient(server('s1'));
192
+ const onSettle = createdSchedulerOptions[0].onSettle;
193
+ expect(entry.solveMeta).toEqual({ last: null, seq: 0 });
194
+ onSettle({ key: 'k' }, {
195
+ status: 'success',
196
+ fromCache: false,
197
+ definitionReuploaded: false,
198
+ durationMs: 10,
199
+ response: {}
200
+ });
201
+ expect(entry.solveMeta.seq).toBe(1);
202
+ expect(entry.solveMeta.last).toEqual({ fromCache: false, definitionReuploaded: false });
203
+ // An error settle must still count toward seq (the attribution guard in
204
+ // the pipeline needs to see ALL concurrent activity) without clobbering last.
205
+ onSettle({ key: 'k' }, { status: 'error', error: new Error('x'), durationMs: 5 });
206
+ expect(entry.solveMeta.seq).toBe(2);
207
+ expect(entry.solveMeta.last).toEqual({ fromCache: false, definitionReuploaded: false });
208
+ onSettle({ key: 'k' }, { status: 'success', fromCache: true, durationMs: 0, response: {} });
209
+ expect(entry.solveMeta.seq).toBe(3);
210
+ expect(entry.solveMeta.last).toEqual({ fromCache: true, definitionReuploaded: undefined });
211
+ });
212
+ });
144
213
  describe('serverIdentity', () => {
145
214
  it('derives identity from the id', () => {
146
215
  expect(serverIdentity({ id: 'abc' })).toBe('abc');
@@ -1 +1 @@
1
- {"version":3,"file":"client-cache.test.js","sourceRoot":"","sources":["../../../src/compute/__tests__/client-cache.test.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client-cache.test.js","sourceRoot":"","sources":["../../../src/compute/__tests__/client-cache.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=definition-byte-cache.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definition-byte-cache.test.d.ts","sourceRoot":"","sources":["../../../src/compute/__tests__/definition-byte-cache.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,107 @@
1
+ import { describe, it, expect, vi } from 'vitest';
2
+ import { createDefinitionByteCache } from '../definition-byte-cache.js';
3
+ /** A `Uint8Array` of `n` bytes filled with a marker so equality is checkable. */
4
+ function bytes(n, marker = 0) {
5
+ return new Uint8Array(n).fill(marker);
6
+ }
7
+ describe('createDefinitionByteCache', () => {
8
+ it('serves a warm entry without re-invoking the loader (hit) and reports it', async () => {
9
+ const cache = createDefinitionByteCache(10 * 1024 * 1024);
10
+ const load = vi.fn(async () => bytes(1024, 7));
11
+ const first = await cache.getOrLoad('v-1', load).load();
12
+ const second = await cache.getOrLoad('v-1', load).load();
13
+ expect(first).toEqual(second);
14
+ expect(load).toHaveBeenCalledTimes(1); // second call served from cache
15
+ const s = cache.stats();
16
+ expect(s.hits).toBe(1);
17
+ expect(s.misses).toBe(1);
18
+ expect(s.entries).toBe(1);
19
+ expect(s.bytes).toBe(1024);
20
+ });
21
+ it('per-ref outcome distinguishes miss (loader) from hit (warm)', async () => {
22
+ const cache = createDefinitionByteCache(10 * 1024 * 1024);
23
+ const load = async () => bytes(512);
24
+ const refMiss = cache.getOrLoad('v-1', load);
25
+ await refMiss.load();
26
+ expect(refMiss.outcome).toEqual({ loaded: true, fromCache: false });
27
+ const refHit = cache.getOrLoad('v-1', load);
28
+ await refHit.load();
29
+ expect(refHit.outcome).toEqual({ loaded: true, fromCache: true });
30
+ });
31
+ it("a ref whose load() is never called leaves outcome.loaded false (the 'skipped' verdict)", () => {
32
+ const cache = createDefinitionByteCache(10 * 1024 * 1024);
33
+ const ref = cache.getOrLoad('v-1', async () => bytes(1));
34
+ // The scheduler served a pointer-known solve — load() never ran.
35
+ expect(ref.outcome).toEqual({ loaded: false, fromCache: false });
36
+ });
37
+ it('evicts least-recently-used entries when the byte budget is exceeded', async () => {
38
+ // Budget holds ~2 of these 1 KB entries.
39
+ const cache = createDefinitionByteCache(2 * 1024);
40
+ const load = (marker) => async () => bytes(1024, marker);
41
+ await cache.getOrLoad('a', load(1)).load(); // [a]
42
+ await cache.getOrLoad('b', load(2)).load(); // [a,b]
43
+ // Touch 'a' so 'b' becomes the LRU victim.
44
+ await cache.getOrLoad('a', load(1)).load(); // hit → [b,a]
45
+ await cache.getOrLoad('c', load(3)).load(); // insert c → evict b → [a,c]
46
+ expect(cache.stats().entries).toBe(2);
47
+ expect(cache.stats().evictions).toBe(1);
48
+ expect(cache.stats().bytes).toBe(2 * 1024);
49
+ // 'a' survived (it was touched, so 'b' was the LRU victim) → served from
50
+ // cache without the loader. Checked BEFORE re-loading 'b', since bringing 'b'
51
+ // back would itself evict 'a' under the 2-entry budget.
52
+ const aLoad = vi.fn(load(1));
53
+ await cache.getOrLoad('a', aLoad).load();
54
+ expect(aLoad).toHaveBeenCalledTimes(0);
55
+ // 'b' was evicted → its next load calls the loader again (miss).
56
+ const bLoad = vi.fn(load(2));
57
+ await cache.getOrLoad('b', bLoad).load();
58
+ expect(bLoad).toHaveBeenCalledTimes(1);
59
+ });
60
+ it('never retains an entry larger than the whole budget (serves through, caches nothing)', async () => {
61
+ const cache = createDefinitionByteCache(1024);
62
+ const load = vi.fn(async () => bytes(4096));
63
+ const out = await cache.getOrLoad('big', load).load();
64
+ expect(out.byteLength).toBe(4096); // still served
65
+ expect(cache.stats().entries).toBe(0); // but not retained
66
+ expect(cache.stats().bytes).toBe(0);
67
+ // Every load re-fetches — nothing was cached.
68
+ await cache.getOrLoad('big', load).load();
69
+ expect(load).toHaveBeenCalledTimes(2);
70
+ });
71
+ it('keys on the passed version id — two versions that reused a fileKey never collide', async () => {
72
+ // The trap this cache exists to avoid: delete-latest-then-reupload reused a
73
+ // fileKey, but the version id (the KEY) is always fresh. Distinct ids →
74
+ // distinct entries, so the new version never serves the old bytes.
75
+ const cache = createDefinitionByteCache(10 * 1024 * 1024);
76
+ const oldBytes = bytes(1024, 1);
77
+ const newBytes = bytes(1024, 2);
78
+ const a = await cache.getOrLoad('version-old', async () => oldBytes).load();
79
+ const b = await cache.getOrLoad('version-new', async () => newBytes).load();
80
+ expect(a).toEqual(oldBytes);
81
+ expect(b).toEqual(newBytes);
82
+ expect(a).not.toEqual(b); // no cross-contamination despite a shared fileKey
83
+ expect(cache.stats().entries).toBe(2);
84
+ });
85
+ it('budget 0 disables caching entirely (every load hits the loader, nothing retained)', async () => {
86
+ const cache = createDefinitionByteCache(0);
87
+ const load = vi.fn(async () => bytes(16));
88
+ const ref1 = cache.getOrLoad('v-1', load);
89
+ await ref1.load();
90
+ await cache.getOrLoad('v-1', load).load();
91
+ expect(load).toHaveBeenCalledTimes(2);
92
+ expect(cache.stats().entries).toBe(0);
93
+ expect(cache.stats().bytes).toBe(0);
94
+ // Outcome still reports loaded, but never fromCache.
95
+ expect(ref1.outcome).toEqual({ loaded: true, fromCache: false });
96
+ });
97
+ it('re-storing the same key updates bytes without double-counting the budget', async () => {
98
+ const cache = createDefinitionByteCache(10 * 1024 * 1024);
99
+ // clear() to force a re-store path: first load caches, clear drops it, second caches again.
100
+ await cache.getOrLoad('v-1', async () => bytes(1024)).load();
101
+ expect(cache.stats().bytes).toBe(1024);
102
+ cache.clear();
103
+ expect(cache.stats().bytes).toBe(0);
104
+ expect(cache.stats().entries).toBe(0);
105
+ });
106
+ });
107
+ //# sourceMappingURL=definition-byte-cache.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definition-byte-cache.test.js","sourceRoot":"","sources":["../../../src/compute/__tests__/definition-byte-cache.test.ts"],"names":[],"mappings":"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"}
@@ -58,5 +58,41 @@ describe('createComputeRateLimiter', () => {
58
58
  // A different limiter instance is unaffected.
59
59
  expect(other.check('user:alice').allowed).toBe(true);
60
60
  });
61
+ // peek + clear support failure-counting flows (login limiting): peek gates
62
+ // the attempt without spending budget, check records a failure, clear
63
+ // forgives on success.
64
+ describe('peek / clear', () => {
65
+ it('peek never increments the counter', () => {
66
+ for (let i = 0; i < 1000; i++)
67
+ expect(limiter.peek('ip:1.2.3.4').allowed).toBe(true);
68
+ // Full budget still available after all those peeks.
69
+ for (let i = 0; i < MAX_PER_WINDOW; i++) {
70
+ expect(limiter.check('ip:1.2.3.4').allowed).toBe(true);
71
+ }
72
+ });
73
+ it('peek reports a full bucket with retryAfter, still without mutating it', () => {
74
+ for (let i = 0; i < MAX_PER_WINDOW; i++)
75
+ limiter.check('ip:1.2.3.4');
76
+ const result = limiter.peek('ip:1.2.3.4');
77
+ expect(result.allowed).toBe(false);
78
+ expect(result.retryAfter).toBeGreaterThan(0);
79
+ });
80
+ it('peek allows again once the window expires', () => {
81
+ for (let i = 0; i < MAX_PER_WINDOW; i++)
82
+ limiter.check('ip:1.2.3.4');
83
+ expect(limiter.peek('ip:1.2.3.4').allowed).toBe(false);
84
+ vi.advanceTimersByTime(WINDOW_MS + 1);
85
+ expect(limiter.peek('ip:1.2.3.4').allowed).toBe(true);
86
+ });
87
+ it('clear drops only the given key', () => {
88
+ for (let i = 0; i < MAX_PER_WINDOW; i++) {
89
+ limiter.check('ip:1.2.3.4');
90
+ limiter.check('ip:5.6.7.8');
91
+ }
92
+ limiter.clear('ip:1.2.3.4');
93
+ expect(limiter.peek('ip:1.2.3.4').allowed).toBe(true);
94
+ expect(limiter.peek('ip:5.6.7.8').allowed).toBe(false);
95
+ });
96
+ });
61
97
  });
62
98
  //# sourceMappingURL=rate-limit.test.js.map