quickbase-js 0.1.0-beta.12 → 0.1.0-beta.14

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 (168) hide show
  1. package/README.md +48 -18
  2. package/dist/esm/quickbase.d.ts +13 -3
  3. package/dist/esm/quickbase.js +416 -49
  4. package/dist/esm/quickbase.js.map +1 -1
  5. package/dist/esm/quickbase.min.js +1 -1
  6. package/dist/esm/quickbase.min.js.map +1 -1
  7. package/dist/umd/quickbase.umd.js +416 -49
  8. package/dist/umd/quickbase.umd.js.map +1 -1
  9. package/dist/umd/quickbase.umd.min.js +1 -1
  10. package/dist/umd/quickbase.umd.min.js.map +1 -1
  11. package/package.json +11 -4
  12. package/CHANGELOG.md +0 -227
  13. package/build-common.js +0 -131
  14. package/build-esm.js +0 -71
  15. package/build-umd.js +0 -69
  16. package/docs/.vitepress/cache/deps/@theme_index.js +0 -275
  17. package/docs/.vitepress/cache/deps/@theme_index.js.map +0 -7
  18. package/docs/.vitepress/cache/deps/_metadata.json +0 -40
  19. package/docs/.vitepress/cache/deps/chunk-5A67QEFC.js +0 -12542
  20. package/docs/.vitepress/cache/deps/chunk-5A67QEFC.js.map +0 -7
  21. package/docs/.vitepress/cache/deps/chunk-7D4P4MMP.js +0 -9719
  22. package/docs/.vitepress/cache/deps/chunk-7D4P4MMP.js.map +0 -7
  23. package/docs/.vitepress/cache/deps/package.json +0 -3
  24. package/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js +0 -4504
  25. package/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js.map +0 -7
  26. package/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js +0 -583
  27. package/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js.map +0 -7
  28. package/docs/.vitepress/cache/deps/vue.js +0 -343
  29. package/docs/.vitepress/cache/deps/vue.js.map +0 -7
  30. package/docs/.vitepress/config.mts +0 -26
  31. package/docs/api-examples.md +0 -49
  32. package/docs/index.md +0 -59
  33. package/docs/markdown-examples.md +0 -85
  34. package/docs-data/api-docs.json +0 -4143
  35. package/examples/quicbase-jsCDN.html +0 -36
  36. package/examples/react.js +0 -48
  37. package/examples/vanillajs.html +0 -47
  38. package/index.md +0 -25
  39. package/open-api/fix-spec-main.ts +0 -133
  40. package/open-api/generate-unified-interface.ts +0 -104
  41. package/open-api/generateDocsJson.ts +0 -24
  42. package/open-api/output/quickbase-fixed.json +0 -11191
  43. package/open-api/post-process-generated.ts +0 -226
  44. package/open-api/regenerate-client.ts +0 -117
  45. package/open-api/schema/enhance-general.ts +0 -111
  46. package/open-api/schema/fix-arrays.ts +0 -68
  47. package/open-api/schema/tags/apps.ts +0 -90
  48. package/open-api/schema/tags/fields.ts +0 -471
  49. package/open-api/schema/tags/groups.ts +0 -51
  50. package/open-api/schema/tags/index.ts +0 -66
  51. package/open-api/schema/tags/records.ts +0 -115
  52. package/open-api/schema/tags/tables.ts +0 -211
  53. package/open-api/schema/tags/users.ts +0 -47
  54. package/open-api/types/spec.ts +0 -42
  55. package/open-api/utils/common.ts +0 -29
  56. package/open-api/utils/generateJsDoc.ts +0 -74
  57. package/open-api/utils/infer-schema.ts +0 -40
  58. package/open-api/utils/naming.ts +0 -10
  59. package/open-api/utils/sharedUtils.ts +0 -352
  60. package/playwright.config.ts +0 -37
  61. package/rollup.config.js +0 -114
  62. package/specs/QuickBase_RESTful_API_2025-03-04T06_22_39.725Z.json +0 -46878
  63. package/specs/split/apps.json +0 -1315
  64. package/specs/split/auth.json +0 -191
  65. package/specs/split/fields.json +0 -3869
  66. package/specs/split/records.json +0 -754
  67. package/specs/split/reports.json +0 -619
  68. package/specs/split/tables.json +0 -1605
  69. package/src/RateLimitError.ts +0 -12
  70. package/src/ThrottleBucket.ts +0 -77
  71. package/src/authorizationStrategy.ts +0 -310
  72. package/src/generated-unified/QuickbaseClient.ts +0 -1135
  73. package/src/generated-unified/missing-types-report.json +0 -3
  74. package/src/index.ts +0 -1
  75. package/src/invokeMethod.ts +0 -212
  76. package/src/quickbaseClient.ts +0 -199
  77. package/src/rateLimiter.ts +0 -30
  78. package/src/tokenCache.ts +0 -39
  79. package/src/utils.ts +0 -50
  80. package/tests/playwright/qb/auth/cacheSwitching.test.ts +0 -159
  81. package/tests/playwright/qb/auth/fetchTempToken401.test.ts +0 -219
  82. package/tests/playwright/qb/auth/getAppWithTempToken.test.ts +0 -162
  83. package/tests/playwright/qb/auth/getAppWithTempTokenConcurrency.test.ts +0 -208
  84. package/tests/playwright/qb/auth/getAppWithUserToken.test.ts +0 -153
  85. package/tests/playwright/qb/auth/getTempToken.test.ts +0 -152
  86. package/tests/playwright/qb/auth/tempTokenPrefetch.test.ts +0 -179
  87. package/tests/playwright/qb/auth/tempTokenRenewal.test.ts +0 -133
  88. package/tests/setup.ts +0 -53
  89. package/tests/vitest/qb/ThrottleBucket.test.ts +0 -77
  90. package/tests/vitest/qb/apps/copyApp.test.ts +0 -76
  91. package/tests/vitest/qb/apps/createApp.test.ts +0 -64
  92. package/tests/vitest/qb/apps/deleteApp.test.ts +0 -76
  93. package/tests/vitest/qb/apps/getApp.test.ts +0 -44
  94. package/tests/vitest/qb/apps/getAppEvents.test.ts +0 -67
  95. package/tests/vitest/qb/apps/updateApp.test.ts +0 -58
  96. package/tests/vitest/qb/auth/mockQuickbaseServer.ts +0 -60
  97. package/tests/vitest/qb/auth/retryUserToken401.test.ts +0 -73
  98. package/tests/vitest/qb/auth/ssoTokenConcurrency.test.ts +0 -68
  99. package/tests/vitest/qb/auth/ssoTokenIntegrationWithServer.test.ts +0 -65
  100. package/tests/vitest/qb/auth/userTokenConcurrency.test.ts +0 -63
  101. package/tests/vitest/qb/fields/createField.test.ts +0 -77
  102. package/tests/vitest/qb/fields/deleteFields.test.ts +0 -83
  103. package/tests/vitest/qb/fields/getField.test.ts +0 -85
  104. package/tests/vitest/qb/fields/getFieldUsage.test.ts +0 -82
  105. package/tests/vitest/qb/fields/getFields.test.ts +0 -232
  106. package/tests/vitest/qb/fields/getFieldsUsage.test.ts +0 -77
  107. package/tests/vitest/qb/fields/updateField.test.ts +0 -93
  108. package/tests/vitest/qb/formulas/runFormula.test.ts +0 -96
  109. package/tests/vitest/qb/index.ts +0 -29
  110. package/tests/vitest/qb/records/deleteRecords.test.ts +0 -110
  111. package/tests/vitest/qb/records/runQuery.test.ts +0 -146
  112. package/tests/vitest/qb/records/upsert.test.ts +0 -102
  113. package/tests/vitest/qb/tables/createRelationship.test.ts +0 -102
  114. package/tests/vitest/qb/tables/createTable.test.ts +0 -55
  115. package/tests/vitest/qb/tables/deleteRelationship.test.ts +0 -143
  116. package/tests/vitest/qb/tables/deleteTable.test.ts +0 -50
  117. package/tests/vitest/qb/tables/getAppTables.test.ts +0 -46
  118. package/tests/vitest/qb/tables/getRelationships.test.ts +0 -80
  119. package/tests/vitest/qb/tables/getTable.test.ts +0 -26
  120. package/tests/vitest/qb/tables/updateRelationship.test.ts +0 -250
  121. package/tests/vitest/qb/tables/updateTable.test.ts +0 -48
  122. package/tests/vitest/unit/ThrottleBucket.test.ts +0 -101
  123. package/tests/vitest/unit/apps/copyApp.test.ts +0 -581
  124. package/tests/vitest/unit/apps/createApp.test.ts +0 -186
  125. package/tests/vitest/unit/apps/deleteApp.test.ts +0 -216
  126. package/tests/vitest/unit/apps/getApp.test.ts +0 -128
  127. package/tests/vitest/unit/apps/getAppConcurrency.test.ts +0 -151
  128. package/tests/vitest/unit/apps/getAppEvents.test.ts +0 -193
  129. package/tests/vitest/unit/apps/updateApp.test.ts +0 -412
  130. package/tests/vitest/unit/auth/fetchTempToken401.test.ts +0 -81
  131. package/tests/vitest/unit/auth/getTempToken.test.ts +0 -119
  132. package/tests/vitest/unit/auth/retryTempToken401.test.ts +0 -95
  133. package/tests/vitest/unit/auth/retryTempTokenMaxRetries.test.ts +0 -206
  134. package/tests/vitest/unit/auth/retryUserToken401.test.ts +0 -69
  135. package/tests/vitest/unit/auth/ssoTokenRefresh.test.ts +0 -325
  136. package/tests/vitest/unit/auth/userTokenConcurrency.test.ts +0 -62
  137. package/tests/vitest/unit/fields/createField.test.ts +0 -451
  138. package/tests/vitest/unit/fields/deleteFields.test.ts +0 -141
  139. package/tests/vitest/unit/fields/getField.test.ts +0 -189
  140. package/tests/vitest/unit/fields/getFieldUsage.test.ts +0 -180
  141. package/tests/vitest/unit/fields/getFields.test.ts +0 -122
  142. package/tests/vitest/unit/fields/getFieldsUsage.test.ts +0 -160
  143. package/tests/vitest/unit/fields/updateField.test.ts +0 -285
  144. package/tests/vitest/unit/formulas/runFormula.test.ts +0 -205
  145. package/tests/vitest/unit/index.ts +0 -34
  146. package/tests/vitest/unit/quickbaseClientHttpMethods.test.ts +0 -139
  147. package/tests/vitest/unit/rateLimit.test.ts +0 -191
  148. package/tests/vitest/unit/records/deleteRecords.test.ts +0 -112
  149. package/tests/vitest/unit/records/runQuery.test.ts +0 -102
  150. package/tests/vitest/unit/records/upsert.test.ts +0 -234
  151. package/tests/vitest/unit/tables/createRelationship.test.ts +0 -212
  152. package/tests/vitest/unit/tables/createTable.test.ts +0 -70
  153. package/tests/vitest/unit/tables/deleteRelationship.test.ts +0 -97
  154. package/tests/vitest/unit/tables/deleteTable.test.ts +0 -77
  155. package/tests/vitest/unit/tables/getAppTables.test.ts +0 -85
  156. package/tests/vitest/unit/tables/getRelationships.test.ts +0 -259
  157. package/tests/vitest/unit/tables/getTable.test.ts +0 -233
  158. package/tests/vitest/unit/tables/updateRelationship.test.ts +0 -307
  159. package/tests/vitest/unit/tables/updateTable.test.ts +0 -80
  160. package/tests/vitest/unit/tokenLifespan.test.ts +0 -204
  161. package/tests/vitest/unit/umd.test.ts +0 -8
  162. package/tools/log-gen.ts +0 -251
  163. package/tools/log-gen.yaml +0 -4829
  164. package/tools/openapi-jars/openapi-generator-cli-7.12.0.jar +0 -0
  165. package/tsconfig.build.json +0 -17
  166. package/tsconfig.json +0 -32
  167. package/versionrc.json +0 -9
  168. package/vitest.config.ts +0 -27
@@ -1,250 +0,0 @@
1
- // tests/vitest/qb/tables/updateRelationship.test.ts
2
-
3
- import { describe, it, expect } from "vitest";
4
- import {
5
- createClient,
6
- QB_REALM,
7
- QB_USER_TOKEN,
8
- QB_TABLE_ID_1,
9
- QB_TABLE_ID_2,
10
- } from "@tests/setup.ts";
11
- import {
12
- UpdateRelationshipRequest,
13
- CreateFieldRequest,
14
- } from "@/generated/models";
15
-
16
- describe("QuickbaseClient Integration - updateRelationship", () => {
17
- let client: ReturnType<typeof createClient>;
18
- let relationshipId: number;
19
- let newLookupFieldId: number | undefined;
20
- let newChildFieldId: number | undefined;
21
- let generatedLookupFieldId: number | undefined;
22
- let generatedSummaryFieldId: number | undefined;
23
-
24
- // No beforeAll/afterAll since we'll create and delete within the test
25
-
26
- it("creates, updates, deletes, and verifies a relationship", async () => {
27
- // Validate environment variables
28
- if (!QB_REALM) throw new Error("QB_REALM is not defined in .env");
29
- if (!QB_USER_TOKEN) throw new Error("QB_USER_TOKEN is not defined in .env");
30
- if (!QB_TABLE_ID_1) throw new Error("QB_TABLE_ID_1 is not defined in .env");
31
- if (!QB_TABLE_ID_2) throw new Error("QB_TABLE_ID_2 is not defined in .env");
32
-
33
- // Initialize client
34
- client = createClient(fetch, {
35
- realm: QB_REALM,
36
- userToken: QB_USER_TOKEN,
37
- debug: true,
38
- });
39
-
40
- // Step 1: Create fields for the relationship update
41
- const lookupFieldRequest: CreateFieldRequest = {
42
- label: `Test Lookup Field_${Date.now()}`,
43
- fieldType: "text",
44
- };
45
- const lookupResponse = await client.createField({
46
- tableId: QB_TABLE_ID_1,
47
- body: lookupFieldRequest,
48
- });
49
- newLookupFieldId = lookupResponse.id;
50
- if (!newLookupFieldId) {
51
- throw new Error("Failed to retrieve ID for newly created lookup field");
52
- }
53
- console.log(
54
- `Created lookup field with ID ${newLookupFieldId} in parent table ${QB_TABLE_ID_1}`
55
- );
56
-
57
- const childFieldRequest: CreateFieldRequest = {
58
- label: `Test Child Numeric_${Date.now()}`,
59
- fieldType: "numeric",
60
- };
61
- const childResponse = await client.createField({
62
- tableId: QB_TABLE_ID_2,
63
- body: childFieldRequest,
64
- });
65
- newChildFieldId = childResponse.id;
66
- if (!newChildFieldId) {
67
- throw new Error("Failed to retrieve ID for newly created child field");
68
- }
69
- console.log(
70
- `Created child field with ID ${newChildFieldId} in child table ${QB_TABLE_ID_2}`
71
- );
72
-
73
- // Step 2: Create a new relationship
74
- const uniqueLabel = `TestRelationship_${Date.now()}`;
75
- const createRequestBody = {
76
- parentTableId: QB_TABLE_ID_1,
77
- foreignKeyField: { label: uniqueLabel },
78
- lookupFieldIds: [6], // Assuming field 6 exists in QB_TABLE_ID_1
79
- summaryFields: [
80
- {
81
- summaryFid: 6, // Assuming field 6 in QB_TABLE_ID_2 is numeric
82
- label: `Sum_${uniqueLabel}`,
83
- accumulationType: "SUM",
84
- },
85
- ],
86
- };
87
-
88
- console.log("Creating relationship with:", createRequestBody);
89
- const createResponse = await client.createRelationship({
90
- tableId: QB_TABLE_ID_2,
91
- body: createRequestBody,
92
- });
93
- console.log(
94
- "Created relationship response:",
95
- JSON.stringify(createResponse, null, 2)
96
- );
97
-
98
- expect(createResponse).toBeDefined();
99
- expect(createResponse.id).toBeDefined();
100
- expect(createResponse.parentTableId).toBe(QB_TABLE_ID_1);
101
- expect(createResponse.childTableId).toBe(QB_TABLE_ID_2);
102
- expect(createResponse.foreignKeyField?.label).toBe(uniqueLabel);
103
-
104
- relationshipId = createResponse.id;
105
-
106
- // Step 3: Update the relationship - Add a lookup field
107
- const tableId = QB_TABLE_ID_2;
108
- const initialResponse = await client.getRelationships({ tableId });
109
- const initialRelationship = initialResponse.relationships.find(
110
- (r) => r.id === relationshipId
111
- );
112
- const currentLookupFields = (initialRelationship?.lookupFields || []).map(
113
- (f) => f.id
114
- );
115
- console.log("Current lookupFields before update:", currentLookupFields);
116
-
117
- const updateLookupRequest: UpdateRelationshipRequest = {
118
- lookupFieldIds: [newLookupFieldId!],
119
- };
120
- console.log(
121
- "Adding lookup field request:",
122
- JSON.stringify(updateLookupRequest, null, 2)
123
- );
124
-
125
- const updateLookupResponse = await client.updateRelationship({
126
- tableId,
127
- relationshipId,
128
- body: updateLookupRequest,
129
- });
130
- console.log(
131
- "Update lookup response:",
132
- JSON.stringify(updateLookupResponse, null, 2)
133
- );
134
-
135
- const newLookup = updateLookupResponse.lookupFields.find(
136
- (f) =>
137
- f.label.includes("Test Lookup Field") &&
138
- !currentLookupFields.includes(f.id)
139
- );
140
- generatedLookupFieldId = newLookup?.id;
141
- console.log(
142
- `Captured generated lookup field ID: ${generatedLookupFieldId}`
143
- );
144
-
145
- expect(updateLookupResponse.id).toBe(relationshipId);
146
- expect(updateLookupResponse.childTableId).toBe(QB_TABLE_ID_2);
147
- expect(updateLookupResponse.parentTableId).toBe(QB_TABLE_ID_1);
148
- expect(
149
- updateLookupResponse.lookupFields.some((f) =>
150
- f.label.includes("Test Lookup Field")
151
- )
152
- ).toBe(true);
153
-
154
- // Step 4: Update the relationship - Add a summary field
155
- const currentSummaryFields = (updateLookupResponse.summaryFields || []).map(
156
- (f) => f.id
157
- );
158
- console.log("Current summaryFields before update:", currentSummaryFields);
159
-
160
- const updateSummaryRequest: UpdateRelationshipRequest = {
161
- summaryFields: [
162
- {
163
- summaryFid: newChildFieldId!,
164
- label: "Test Summary Field",
165
- accumulationType: "SUM",
166
- },
167
- ],
168
- };
169
- console.log(
170
- "Adding summary field request:",
171
- JSON.stringify(updateSummaryRequest, null, 2)
172
- );
173
-
174
- const updateSummaryResponse = await client.updateRelationship({
175
- tableId,
176
- relationshipId,
177
- body: updateSummaryRequest,
178
- });
179
- console.log(
180
- "Update summary response:",
181
- JSON.stringify(updateSummaryResponse, null, 2)
182
- );
183
-
184
- const newSummary = updateSummaryResponse.summaryFields.find(
185
- (f) =>
186
- f.label.includes("Test Summary Field") &&
187
- !currentSummaryFields.includes(f.id)
188
- );
189
- generatedSummaryFieldId = newSummary?.id;
190
- console.log(
191
- `Captured generated summary field ID: ${generatedSummaryFieldId}`
192
- );
193
-
194
- expect(updateSummaryResponse.id).toBe(relationshipId);
195
- expect(updateSummaryResponse.childTableId).toBe(QB_TABLE_ID_2);
196
- expect(updateSummaryResponse.parentTableId).toBe(QB_TABLE_ID_1);
197
- expect(
198
- updateSummaryResponse.summaryFields.some((f) =>
199
- f.label.includes("Test Summary Field")
200
- )
201
- ).toBe(true);
202
-
203
- // Step 5: Delete the relationship
204
- console.log("Deleting relationship with ID:", relationshipId);
205
- const deleteResponse = await client.deleteRelationship({
206
- tableId: QB_TABLE_ID_2,
207
- relationshipId,
208
- });
209
- console.log(
210
- "Delete relationship response:",
211
- JSON.stringify(deleteResponse, null, 2)
212
- );
213
-
214
- expect(deleteResponse).toBeDefined();
215
- expect(deleteResponse.relationshipId).toBe(relationshipId);
216
-
217
- // Step 6: Verify deletion
218
- const relationships = await client.getRelationships({
219
- tableId: QB_TABLE_ID_2,
220
- });
221
- console.log(
222
- "Relationships after deletion:",
223
- JSON.stringify(relationships, null, 2)
224
- );
225
- const deletedRelationship = relationships.relationships.find(
226
- (r) => r.id === relationshipId
227
- );
228
- expect(deletedRelationship).toBeUndefined(); // Confirm relationship is gone
229
-
230
- // Cleanup remaining fields from setup
231
- if (newLookupFieldId) {
232
- await client.deleteFields({
233
- tableId: QB_TABLE_ID_1,
234
- body: { fieldIds: [newLookupFieldId] },
235
- });
236
- console.log(
237
- `Deleted lookup field ${newLookupFieldId} from ${QB_TABLE_ID_1}`
238
- );
239
- }
240
- if (newChildFieldId) {
241
- await client.deleteFields({
242
- tableId: QB_TABLE_ID_2,
243
- body: { fieldIds: [newChildFieldId] },
244
- });
245
- console.log(
246
- `Deleted child field ${newChildFieldId} from ${QB_TABLE_ID_2}`
247
- );
248
- }
249
- }, 60000);
250
- });
@@ -1,48 +0,0 @@
1
- import { test, expect } from "vitest";
2
- import { quickbase } from "../../../../src/quickbaseClient";
3
-
4
- test(
5
- "QuickbaseClient Integration - updateTable > updates real table data in QuickBase",
6
- { timeout: 10000 },
7
- async () => {
8
- const config = {
9
- realm: process.env.QB_REALM || "",
10
- userToken: process.env.QB_USER_TOKEN || "",
11
- debug: true,
12
- };
13
- const client = quickbase(config);
14
- const appId = "buwai2zpe";
15
- const tableId = "buwai2zr4";
16
- const updatedBody = {
17
- name: "Root Updated " + Date.now(),
18
- description: "Integration test update",
19
- };
20
- const originalBody = {
21
- name: "Root",
22
- description: "",
23
- };
24
-
25
- console.log("Config used:", config);
26
- // Update the table
27
- const response = await client.updateTable({
28
- tableId,
29
- appId,
30
- body: updatedBody,
31
- });
32
- expect(response).toBeDefined();
33
- expect(response.id).toBe(tableId);
34
- expect(response.name).toBe(updatedBody.name);
35
- expect(response.description).toBe(updatedBody.description);
36
- console.log("Real API response:", response);
37
-
38
- // Cleanup: Revert the table to original state
39
- const cleanupResponse = await client.updateTable({
40
- tableId,
41
- appId,
42
- body: originalBody,
43
- });
44
- expect(cleanupResponse.name).toBe(originalBody.name);
45
- expect(cleanupResponse.description).toBe(originalBody.description);
46
- console.log("Cleanup API response:", cleanupResponse);
47
- }
48
- );
@@ -1,101 +0,0 @@
1
- // test/vitest/unit/ThrottleBucket.test.ts
2
- import { describe, it, expect, vi } from "vitest";
3
- import { ConcurrentThrottleBucket } from "@/ThrottleBucket"; // Should work with your alias
4
-
5
- describe("ConcurrentThrottleBucket Unit Tests", () => {
6
- it("allows burst capacity immediately", async () => {
7
- const bucket = new ConcurrentThrottleBucket(5, 3); // rate: 5, burst: 3
8
- const startTime = Date.now();
9
-
10
- await Promise.all([
11
- bucket.acquire().then(() => bucket.release()),
12
- bucket.acquire().then(() => bucket.release()),
13
- bucket.acquire().then(() => bucket.release()),
14
- ]);
15
-
16
- const duration = Date.now() - startTime;
17
- expect(duration).toBeLessThan(50); // All 3 should be instant (within 50ms)
18
- });
19
-
20
- it("delays calls beyond burst at correct rate", async () => {
21
- const bucket = new ConcurrentThrottleBucket(5, 3); // rate: 5 tokens/sec, burst: 3
22
- const timings: number[] = [];
23
- const recordTime = async () => {
24
- await bucket.acquire();
25
- timings.push(Date.now());
26
- bucket.release(); // Release slot
27
- };
28
-
29
- const startTime = Date.now();
30
- await Promise.all([
31
- recordTime(),
32
- recordTime(),
33
- recordTime(),
34
- recordTime(), // 4th call should delay
35
- ]);
36
-
37
- const durations = timings.map((t) => t - startTime);
38
- expect(durations.length).toBe(4);
39
- expect(durations[0]).toBeLessThan(50); // 1st call instant
40
- expect(durations[1]).toBeLessThan(50); // 2nd call instant
41
- expect(durations[2]).toBeLessThan(50); // 3rd call instant
42
- expect(durations[3]).toBeGreaterThanOrEqual(180); // 4th call delayed ~200ms
43
- expect(durations[3]).toBeLessThan(250); // Shouldn’t exceed 250ms
44
- });
45
-
46
- it("maintains rate over sustained calls", async () => {
47
- const bucket = new ConcurrentThrottleBucket(2, 2); // rate: 2 tokens/sec, burst: 2
48
- const timings: number[] = [];
49
- const recordTime = async () => {
50
- await bucket.acquire();
51
- timings.push(Date.now());
52
- bucket.release(); // Release slot
53
- };
54
-
55
- const startTime = Date.now();
56
- await Promise.all([
57
- recordTime(),
58
- recordTime(),
59
- recordTime(),
60
- recordTime(),
61
- recordTime(), // 5 calls total
62
- ]);
63
-
64
- const durations = timings.map((t) => t - startTime);
65
- expect(durations.length).toBe(5);
66
- expect(durations[0]).toBeLessThan(50); // 1st instant
67
- expect(durations[1]).toBeLessThan(50); // 2nd instant
68
- expect(durations[2]).toBeGreaterThanOrEqual(450); // 3rd delayed ~500ms (1/2 sec)
69
- expect(durations[2]).toBeLessThan(550);
70
- expect(durations[3]).toBeGreaterThanOrEqual(950); // 4th delayed ~1000ms
71
- expect(durations[3]).toBeLessThan(1050);
72
- expect(durations[4]).toBeGreaterThanOrEqual(1450); // 5th delayed ~1500ms
73
- expect(durations[4]).toBeLessThan(1550);
74
- });
75
-
76
- it("handles high concurrency without exceeding burst", async () => {
77
- const bucket = new ConcurrentThrottleBucket(5, 3); // rate: 5, burst: 3
78
- const timings: number[] = [];
79
- const recordTime = async () => {
80
- await bucket.acquire();
81
- timings.push(Date.now());
82
- bucket.release(); // Release slot
83
- };
84
-
85
- const startTime = Date.now();
86
- await Promise.all(
87
- Array(10)
88
- .fill(null)
89
- .map(() => recordTime())
90
- ); // 10 concurrent calls
91
-
92
- const durations = timings.map((t) => t - startTime);
93
- expect(durations.length).toBe(10);
94
- expect(durations.slice(0, 3).every((d) => d < 50)).toBe(true); // First 3 instant
95
- for (let i = 3; i < 10; i++) {
96
- const expectedDelay = (i - 2) * 200; // After burst, 200ms per token
97
- expect(durations[i]).toBeGreaterThanOrEqual(expectedDelay - 50);
98
- expect(durations[i]).toBeLessThan(expectedDelay + 50);
99
- }
100
- });
101
- });