@ultimat3/http 30.3.0 → 30.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/http",
-  "version": "30.3.0",
+  "version": "30.4.0",
   "description": "Owned request lifecycle over Bun.serve: router, ordered pipeline, problem+json errors",
   "keywords": [
     "ultimate",
@@ -45,9 +45,9 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "30.3.0",
-    "@ultimat3/i18n": "30.3.0",
-    "@ultimat3/schema": "30.3.0",
-    "@ultimat3/time": "30.3.0"
+    "@ultimat3/core": "30.4.0",
+    "@ultimat3/i18n": "30.4.0",
+    "@ultimat3/schema": "30.4.0",
+    "@ultimat3/time": "30.4.0"
   }
 }

package/src/index.ts

@@ -188,6 +188,7 @@ export {
   installedRateLimitStore,
   installRateLimitStore,
   resetRateLimitStore,
+  withScratchRateLimitStore,
 } from './rate-limit-installed';
 export type { RateLimitPeek } from './rate-limit-peek';
 export { rateLimitPeek, refilledTokens } from './rate-limit-peek';

package/src/rate-limit-installed.ts

@@ -77,3 +77,24 @@ export const assertInstalledRateLimitScope = (config: RateLimitConfig): void =>
   if (config.scope !== 'shared') return;
   if (current().scope !== 'shared') throw rateLimitNotShared('installed');
 };
+
+/**
+ * `fn` spending from a fresh store of its own, the installed one left exactly as it was — the
+ * contract exercise's runs (`@ultimat3/action`, `@ultimat3/query`): a test-time loop that must not
+ * leave the same file's next call a 429. It answers for the installed store's scope, so a
+ * `'shared'` declaration is still judged against what the app installed, not the scratch.
+ */
+export async function withScratchRateLimitStore<T>(fn: () => Promise<T>): Promise<T> {
+  const scratch = memoryRateLimitStore();
+  const release = adoptRateLimitStore({
+    scope: current().scope,
+    take: (key, bucket, cost, nowMs) => scratch.take(key, bucket, cost, nowMs),
+    peek: (key, bucket, nowMs) => scratch.peek(key, bucket, nowMs),
+    reset: (key) => scratch.reset(key),
+  });
+  try {
+    return await fn();
+  } finally {
+    release();
+  }
+}