@huevo/plugin-retry 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @huevo/plugin-retry
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Авторетраи на slow-рейт-лимиты для [huevo](https://www.npmjs.com/package/huevo).
+
+Любой эндпоинт huevo.su может ответить `{"error":"slow","retry":N}` — плагин
+ждёт `retry` секунд и повторяет запрос сам, незаметно для вашего кода.
+
+```
+npm i huevo @huevo/plugin-retry
+```
+
+```ts
+import { Huevo } from "huevo";
+import { retry } from "@huevo/plugin-retry";
+
+const huevo = Huevo.fromToken(session);
+huevo.use(retry({ maxRetries: 5 }));
+
+await huevo.clicker.post(400); // slow? подождёт и повторит — вы этого не заметите
+```
+
+## опции
+
+| Опция | По умолчанию | Описание |
+|---|---|---|
+| `maxRetries` | `3` | максимум повторов подряд на один запрос |
+| `margin` | `1` | запас к `retry`-секундам сервера, сек |
+| `onRetry` | — | колбэк `(waitMs, opts, attempt)` перед каждым повтором |
+
+Работает через response-интерцепторы ядра (`huevo.http.interceptors`) — ядро
+не содержит логики ретраев, плагин добавляет её снаружи.
+
+[Репозиторий](https://github.com/neverlane/huevo/tree/master/packages/retry) · MIT

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @huevo/plugin-retry — авторетраи на рейт-лимит.
+ *
+ * huevo.use(retry()) — и `{"error":"slow","retry":N}` от любого эндпоинта
+ * больше не ваши проблемы: SDK ждёт и повторяет сам.
+ *
+ * ```ts
+ * huevo.use(retry({ maxRetries: 5 }));
+ * ```
+ */
+import type { HuevoPlugin, RequestOpts } from 'huevo';
+export interface RetryOptions {
+    /** Максимум повторов подряд на один запрос. По умолчанию 3 */
+    maxRetries?: number;
+    /** Запас к retry-секундам сервера, сек. По умолчанию 1 */
+    margin?: number;
+    /** Колбэк перед каждым повтором */
+    onRetry?: (waitMs: number, opts: RequestOpts, attempt: number) => void;
+}
+export declare function retry(options?: RetryOptions): HuevoPlugin;

package/dist/index.js

@@ -0,0 +1,29 @@
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export function retry(options = {}) {
+    const maxRetries = options.maxRetries ?? 3;
+    const margin = options.margin ?? 1;
+    return (huevo) => {
+        const attempts = new WeakMap();
+        const interceptor = async (data, opts, retryFn) => {
+            if (!data || typeof data !== 'object' ||
+                data.error !== 'slow') {
+                return undefined; // не slow — не трогаем
+            }
+            const attempt = (attempts.get(opts) ?? 0) + 1;
+            attempts.set(opts, attempt);
+            if (attempt > maxRetries)
+                return undefined;
+            const retrySec = Number(data.retry) || 8;
+            const waitMs = (retrySec + margin) * 1000;
+            options.onRetry?.(waitMs, opts, attempt);
+            await sleep(waitMs);
+            return retryFn();
+        };
+        huevo.http.interceptors.push(interceptor);
+        return () => {
+            const i = huevo.http.interceptors.indexOf(interceptor);
+            if (i >= 0)
+                huevo.http.interceptors.splice(i, 1);
+        };
+    };
+}

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "@huevo/plugin-retry",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Авторетраи на slow-рейт-лимиты для huevo SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "huevo": "^0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neverlane/huevo.git",
+    "directory": "packages/retry"
+  },
+  "homepage": "https://github.com/neverlane/huevo/tree/master/packages/retry"
+}