@bernierllc/backoff-retry 0.1.1 → 0.3.0
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.
- package/CHANGELOG.md +13 -0
- package/README.md +110 -0
- package/dist/enhancement-manager.d.ts +205 -0
- package/dist/enhancement-manager.d.ts.map +1 -0
- package/dist/enhancement-manager.js +533 -0
- package/dist/enhancement-manager.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -1
- package/dist/memory-protection.js +1 -1
- package/dist/memory-protection.js.map +1 -1
- package/dist/neveradmin/components/RetryAnalyticsPage.d.ts +15 -0
- package/dist/neveradmin/components/RetryAnalyticsPage.d.ts.map +1 -0
- package/dist/neveradmin/components/RetryAnalyticsPage.js +28 -0
- package/dist/neveradmin/components/RetryAnalyticsPage.js.map +1 -0
- package/dist/neveradmin/components/RetryConfigurationPage.d.ts +15 -0
- package/dist/neveradmin/components/RetryConfigurationPage.d.ts.map +1 -0
- package/dist/neveradmin/components/RetryConfigurationPage.js +28 -0
- package/dist/neveradmin/components/RetryConfigurationPage.js.map +1 -0
- package/dist/neveradmin/components/RetryEnhancementsPage.d.ts +15 -0
- package/dist/neveradmin/components/RetryEnhancementsPage.d.ts.map +1 -0
- package/dist/neveradmin/components/RetryEnhancementsPage.js +28 -0
- package/dist/neveradmin/components/RetryEnhancementsPage.js.map +1 -0
- package/dist/neveradmin/components/RetryOperationsPage.d.ts +15 -0
- package/dist/neveradmin/components/RetryOperationsPage.d.ts.map +1 -0
- package/dist/neveradmin/components/RetryOperationsPage.js +28 -0
- package/dist/neveradmin/components/RetryOperationsPage.js.map +1 -0
- package/dist/neveradmin/components/RetryOverviewPage.d.ts +15 -0
- package/dist/neveradmin/components/RetryOverviewPage.d.ts.map +1 -0
- package/dist/neveradmin/components/RetryOverviewPage.js +28 -0
- package/dist/neveradmin/components/RetryOverviewPage.js.map +1 -0
- package/dist/neveradmin/components/index.d.ts +7 -0
- package/dist/neveradmin/components/index.d.ts.map +1 -0
- package/dist/neveradmin/components/index.js +32 -0
- package/dist/neveradmin/components/index.js.map +1 -0
- package/dist/neveradmin/components/types.d.ts +64 -0
- package/dist/neveradmin/components/types.d.ts.map +1 -0
- package/dist/neveradmin/components/types.js +10 -0
- package/dist/neveradmin/components/types.js.map +1 -0
- package/dist/neveradmin/hooks/index.d.ts +5 -0
- package/dist/neveradmin/hooks/index.d.ts.map +1 -0
- package/dist/neveradmin/hooks/index.js +28 -0
- package/dist/neveradmin/hooks/index.js.map +1 -0
- package/dist/neveradmin/hooks/useRetryConfiguration.d.ts +23 -0
- package/dist/neveradmin/hooks/useRetryConfiguration.d.ts.map +1 -0
- package/dist/neveradmin/hooks/useRetryConfiguration.js +162 -0
- package/dist/neveradmin/hooks/useRetryConfiguration.js.map +1 -0
- package/dist/neveradmin/hooks/useRetryEnhancements.d.ts +39 -0
- package/dist/neveradmin/hooks/useRetryEnhancements.d.ts.map +1 -0
- package/dist/neveradmin/hooks/useRetryEnhancements.js +197 -0
- package/dist/neveradmin/hooks/useRetryEnhancements.js.map +1 -0
- package/dist/neveradmin/hooks/useRetryOperations.d.ts +28 -0
- package/dist/neveradmin/hooks/useRetryOperations.d.ts.map +1 -0
- package/dist/neveradmin/hooks/useRetryOperations.js +166 -0
- package/dist/neveradmin/hooks/useRetryOperations.js.map +1 -0
- package/dist/neveradmin/hooks/useRetryStats.d.ts +19 -0
- package/dist/neveradmin/hooks/useRetryStats.d.ts.map +1 -0
- package/dist/neveradmin/hooks/useRetryStats.js +81 -0
- package/dist/neveradmin/hooks/useRetryStats.js.map +1 -0
- package/dist/neveradmin/index.d.ts +6 -0
- package/dist/neveradmin/index.d.ts.map +1 -0
- package/dist/neveradmin/index.js +29 -0
- package/dist/neveradmin/index.js.map +1 -0
- package/dist/neveradmin/registration.d.ts +33 -0
- package/dist/neveradmin/registration.d.ts.map +1 -0
- package/dist/neveradmin/registration.js +96 -0
- package/dist/neveradmin/registration.js.map +1 -0
- package/dist/neveradmin/types.d.ts +88 -0
- package/dist/neveradmin/types.d.ts.map +1 -0
- package/dist/neveradmin/types.js +10 -0
- package/dist/neveradmin/types.js.map +1 -0
- package/dist/neveradmin/utils/formatting.d.ts +41 -0
- package/dist/neveradmin/utils/formatting.d.ts.map +1 -0
- package/dist/neveradmin/utils/formatting.js +142 -0
- package/dist/neveradmin/utils/formatting.js.map +1 -0
- package/dist/neveradmin/utils/index.d.ts +4 -0
- package/dist/neveradmin/utils/index.d.ts.map +1 -0
- package/dist/neveradmin/utils/index.js +27 -0
- package/dist/neveradmin/utils/index.js.map +1 -0
- package/dist/neveradmin/utils/permissions.d.ts +74 -0
- package/dist/neveradmin/utils/permissions.d.ts.map +1 -0
- package/dist/neveradmin/utils/permissions.js +152 -0
- package/dist/neveradmin/utils/permissions.js.map +1 -0
- package/dist/neveradmin/utils/validation.d.ts +38 -0
- package/dist/neveradmin/utils/validation.d.ts.map +1 -0
- package/dist/neveradmin/utils/validation.js +142 -0
- package/dist/neveradmin/utils/validation.js.map +1 -0
- package/dist/retry-manager.d.ts +32 -11
- package/dist/retry-manager.d.ts.map +1 -1
- package/dist/retry-manager.js +128 -82
- package/dist/retry-manager.js.map +1 -1
- package/dist/security/index.d.ts +3 -0
- package/dist/security/index.d.ts.map +1 -0
- package/dist/security/index.js +26 -0
- package/dist/security/index.js.map +1 -0
- package/dist/security/secure-storage.d.ts +61 -0
- package/dist/security/secure-storage.d.ts.map +1 -0
- package/dist/security/secure-storage.js +418 -0
- package/dist/security/secure-storage.js.map +1 -0
- package/dist/security/security-manager.d.ts +172 -0
- package/dist/security/security-manager.d.ts.map +1 -0
- package/dist/security/security-manager.js +417 -0
- package/dist/security/security-manager.js.map +1 -0
- package/dist/storage/backend-selector.d.ts +96 -0
- package/dist/storage/backend-selector.d.ts.map +1 -0
- package/dist/storage/backend-selector.js +466 -0
- package/dist/storage/backend-selector.js.map +1 -0
- package/dist/storage/index.d.ts +7 -0
- package/dist/storage/index.d.ts.map +1 -0
- package/dist/storage/index.js +30 -0
- package/dist/storage/index.js.map +1 -0
- package/dist/storage/memory-storage.d.ts +55 -0
- package/dist/storage/memory-storage.d.ts.map +1 -0
- package/dist/storage/memory-storage.js +106 -0
- package/dist/storage/memory-storage.js.map +1 -0
- package/dist/storage/postgresql-storage.d.ts +77 -0
- package/dist/storage/postgresql-storage.d.ts.map +1 -0
- package/dist/storage/postgresql-storage.js +314 -0
- package/dist/storage/postgresql-storage.js.map +1 -0
- package/dist/storage/redis-cluster-storage.d.ts +88 -0
- package/dist/storage/redis-cluster-storage.d.ts.map +1 -0
- package/dist/storage/redis-cluster-storage.js +414 -0
- package/dist/storage/redis-cluster-storage.js.map +1 -0
- package/dist/storage/redis-storage.d.ts +67 -0
- package/dist/storage/redis-storage.d.ts.map +1 -0
- package/dist/storage/redis-storage.js +236 -0
- package/dist/storage/redis-storage.js.map +1 -0
- package/dist/storage/types.d.ts +55 -0
- package/dist/storage/types.d.ts.map +1 -0
- package/dist/storage/types.js +10 -0
- package/dist/storage/types.js.map +1 -0
- package/dist/types.d.ts +7 -32
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +1 -0
- package/dist/types.js.map +1 -1
- package/package.json +15 -2
|
@@ -0,0 +1,236 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/*
|
|
3
|
+
Copyright (c) 2025 Bernier LLC
|
|
4
|
+
|
|
5
|
+
This file is licensed to the client under a limited-use license.
|
|
6
|
+
The client may use and modify this code *only within the scope of the project it was delivered for*.
|
|
7
|
+
Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
|
|
8
|
+
*/
|
|
9
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
12
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
13
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
14
|
+
}
|
|
15
|
+
Object.defineProperty(o, k2, desc);
|
|
16
|
+
}) : (function(o, m, k, k2) {
|
|
17
|
+
if (k2 === undefined) k2 = k;
|
|
18
|
+
o[k2] = m[k];
|
|
19
|
+
}));
|
|
20
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
21
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
22
|
+
}) : function(o, v) {
|
|
23
|
+
o["default"] = v;
|
|
24
|
+
});
|
|
25
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
26
|
+
var ownKeys = function(o) {
|
|
27
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
28
|
+
var ar = [];
|
|
29
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
30
|
+
return ar;
|
|
31
|
+
};
|
|
32
|
+
return ownKeys(o);
|
|
33
|
+
};
|
|
34
|
+
return function (mod) {
|
|
35
|
+
if (mod && mod.__esModule) return mod;
|
|
36
|
+
var result = {};
|
|
37
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
38
|
+
__setModuleDefault(result, mod);
|
|
39
|
+
return result;
|
|
40
|
+
};
|
|
41
|
+
})();
|
|
42
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
43
|
+
exports.RedisStorage = void 0;
|
|
44
|
+
/**
|
|
45
|
+
* Redis storage backend for retry states
|
|
46
|
+
*/
|
|
47
|
+
class RedisStorage {
|
|
48
|
+
constructor(connectionString, options = {}) {
|
|
49
|
+
this.lastAccess = new Date();
|
|
50
|
+
this.lastWrite = new Date();
|
|
51
|
+
this.connectionString = connectionString;
|
|
52
|
+
this.options = options;
|
|
53
|
+
this.prefix = options.prefix || 'backoff-retry:';
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Initialize the Redis client
|
|
57
|
+
*/
|
|
58
|
+
async initializeClient() {
|
|
59
|
+
if (this.client)
|
|
60
|
+
return;
|
|
61
|
+
try {
|
|
62
|
+
// Dynamic import to avoid requiring redis package if not used
|
|
63
|
+
const { createClient } = await Promise.resolve().then(() => __importStar(require('redis')));
|
|
64
|
+
this.client = createClient({
|
|
65
|
+
url: this.connectionString,
|
|
66
|
+
...this.options
|
|
67
|
+
});
|
|
68
|
+
await this.client.connect();
|
|
69
|
+
}
|
|
70
|
+
catch (error) {
|
|
71
|
+
throw new Error(`Failed to connect to Redis: ${error instanceof Error ? error.message : 'Unknown error'}`);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Get the full key name with prefix
|
|
76
|
+
*/
|
|
77
|
+
getFullKey(key) {
|
|
78
|
+
return `${this.prefix}${key}`;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Store a retry state
|
|
82
|
+
*/
|
|
83
|
+
async set(key, value) {
|
|
84
|
+
await this.initializeClient();
|
|
85
|
+
const fullKey = this.getFullKey(key);
|
|
86
|
+
const serializedValue = JSON.stringify(value);
|
|
87
|
+
await this.client.set(fullKey, serializedValue);
|
|
88
|
+
this.lastWrite = new Date();
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Get a retry state
|
|
92
|
+
*/
|
|
93
|
+
async get(key) {
|
|
94
|
+
await this.initializeClient();
|
|
95
|
+
const fullKey = this.getFullKey(key);
|
|
96
|
+
const value = await this.client.get(fullKey);
|
|
97
|
+
this.lastAccess = new Date();
|
|
98
|
+
if (!value)
|
|
99
|
+
return null;
|
|
100
|
+
try {
|
|
101
|
+
return JSON.parse(value);
|
|
102
|
+
}
|
|
103
|
+
catch (error) {
|
|
104
|
+
throw new Error(`Failed to parse retry state from Redis: ${error instanceof Error ? error.message : 'Unknown error'}`);
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Delete a retry state
|
|
109
|
+
*/
|
|
110
|
+
async delete(key) {
|
|
111
|
+
await this.initializeClient();
|
|
112
|
+
const fullKey = this.getFullKey(key);
|
|
113
|
+
await this.client.del(fullKey);
|
|
114
|
+
this.lastWrite = new Date();
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* List all retry states
|
|
118
|
+
*/
|
|
119
|
+
async list() {
|
|
120
|
+
await this.initializeClient();
|
|
121
|
+
const pattern = `${this.prefix}*`;
|
|
122
|
+
const keys = await this.client.keys(pattern);
|
|
123
|
+
this.lastAccess = new Date();
|
|
124
|
+
if (keys.length === 0)
|
|
125
|
+
return [];
|
|
126
|
+
const values = await Promise.all(keys.map(async (key) => {
|
|
127
|
+
const value = await this.client.get(key);
|
|
128
|
+
if (!value)
|
|
129
|
+
return null;
|
|
130
|
+
try {
|
|
131
|
+
return JSON.parse(value);
|
|
132
|
+
}
|
|
133
|
+
catch {
|
|
134
|
+
return null;
|
|
135
|
+
}
|
|
136
|
+
}));
|
|
137
|
+
return values.filter((value) => value !== null);
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Clear all retry states
|
|
141
|
+
*/
|
|
142
|
+
async clear() {
|
|
143
|
+
await this.initializeClient();
|
|
144
|
+
const pattern = `${this.prefix}*`;
|
|
145
|
+
const keys = await this.client.keys(pattern);
|
|
146
|
+
if (keys.length > 0) {
|
|
147
|
+
await this.client.del(keys);
|
|
148
|
+
}
|
|
149
|
+
this.lastWrite = new Date();
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Get storage statistics
|
|
153
|
+
*/
|
|
154
|
+
async getStats() {
|
|
155
|
+
await this.initializeClient();
|
|
156
|
+
const pattern = `${this.prefix}*`;
|
|
157
|
+
const keys = await this.client.keys(pattern);
|
|
158
|
+
if (keys.length === 0) {
|
|
159
|
+
return {
|
|
160
|
+
totalKeys: 0,
|
|
161
|
+
totalSize: 0,
|
|
162
|
+
averageKeySize: 0,
|
|
163
|
+
lastAccess: this.lastAccess,
|
|
164
|
+
lastWrite: this.lastWrite
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
// Get values for size calculation
|
|
168
|
+
const values = await Promise.all(keys.map(async (key) => {
|
|
169
|
+
const value = await this.client.get(key);
|
|
170
|
+
return value ? value.length : 0;
|
|
171
|
+
}));
|
|
172
|
+
const totalSize = values.reduce((sum, size) => sum + size, 0);
|
|
173
|
+
return {
|
|
174
|
+
totalKeys: keys.length,
|
|
175
|
+
totalSize,
|
|
176
|
+
averageKeySize: keys.length > 0 ? totalSize / keys.length : 0,
|
|
177
|
+
oldestKey: keys.length > 0 ? keys[0] : undefined,
|
|
178
|
+
newestKey: keys.length > 0 ? keys[keys.length - 1] : undefined,
|
|
179
|
+
lastAccess: this.lastAccess,
|
|
180
|
+
lastWrite: this.lastWrite
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* Test the connection
|
|
185
|
+
*/
|
|
186
|
+
async testConnection() {
|
|
187
|
+
try {
|
|
188
|
+
await this.initializeClient();
|
|
189
|
+
await this.client.ping();
|
|
190
|
+
return true;
|
|
191
|
+
}
|
|
192
|
+
catch {
|
|
193
|
+
return false;
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* Close the connection
|
|
198
|
+
*/
|
|
199
|
+
async close() {
|
|
200
|
+
if (this.client) {
|
|
201
|
+
await this.client.quit();
|
|
202
|
+
this.client = null;
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* Get Redis client info
|
|
207
|
+
*/
|
|
208
|
+
async getClientInfo() {
|
|
209
|
+
await this.initializeClient();
|
|
210
|
+
try {
|
|
211
|
+
const info = await this.client.info();
|
|
212
|
+
return { info };
|
|
213
|
+
}
|
|
214
|
+
catch (error) {
|
|
215
|
+
return { error: error instanceof Error ? error.message : 'Unknown error' };
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* Set expiration for a key
|
|
220
|
+
*/
|
|
221
|
+
async setExpiration(key, seconds) {
|
|
222
|
+
await this.initializeClient();
|
|
223
|
+
const fullKey = this.getFullKey(key);
|
|
224
|
+
await this.client.expire(fullKey, seconds);
|
|
225
|
+
}
|
|
226
|
+
/**
|
|
227
|
+
* Get time to live for a key
|
|
228
|
+
*/
|
|
229
|
+
async getTTL(key) {
|
|
230
|
+
await this.initializeClient();
|
|
231
|
+
const fullKey = this.getFullKey(key);
|
|
232
|
+
return await this.client.ttl(fullKey);
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
exports.RedisStorage = RedisStorage;
|
|
236
|
+
//# sourceMappingURL=redis-storage.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"redis-storage.js","sourceRoot":"","sources":["../../src/storage/redis-storage.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { RetryState } from '../types';
|
|
2
|
+
/**
|
|
3
|
+
* Interface for storage backends
|
|
4
|
+
*/
|
|
5
|
+
export interface StorageBackend {
|
|
6
|
+
/**
|
|
7
|
+
* Store a retry state
|
|
8
|
+
*/
|
|
9
|
+
set(key: string, value: RetryState): Promise<void>;
|
|
10
|
+
/**
|
|
11
|
+
* Get a retry state
|
|
12
|
+
*/
|
|
13
|
+
get(key: string): Promise<RetryState | null>;
|
|
14
|
+
/**
|
|
15
|
+
* Delete a retry state
|
|
16
|
+
*/
|
|
17
|
+
delete(key: string): Promise<void>;
|
|
18
|
+
/**
|
|
19
|
+
* List all retry states
|
|
20
|
+
*/
|
|
21
|
+
list(): Promise<RetryState[]>;
|
|
22
|
+
/**
|
|
23
|
+
* Clear all retry states
|
|
24
|
+
*/
|
|
25
|
+
clear(): Promise<void>;
|
|
26
|
+
/**
|
|
27
|
+
* Get storage statistics
|
|
28
|
+
*/
|
|
29
|
+
getStats(): Promise<StorageStats>;
|
|
30
|
+
/**
|
|
31
|
+
* Test the connection
|
|
32
|
+
*/
|
|
33
|
+
testConnection(): Promise<boolean>;
|
|
34
|
+
/**
|
|
35
|
+
* Close the connection
|
|
36
|
+
*/
|
|
37
|
+
close(): Promise<void>;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Storage statistics
|
|
41
|
+
*/
|
|
42
|
+
export interface StorageStats {
|
|
43
|
+
totalKeys: number;
|
|
44
|
+
totalSize: number;
|
|
45
|
+
averageKeySize: number;
|
|
46
|
+
oldestKey?: string;
|
|
47
|
+
newestKey?: string;
|
|
48
|
+
lastAccess?: Date;
|
|
49
|
+
lastWrite?: Date;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Storage backend factory function
|
|
53
|
+
*/
|
|
54
|
+
export type StorageBackendFactory = (options?: Record<string, any>) => Promise<StorageBackend>;
|
|
55
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE9B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAElC;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/*
|
|
3
|
+
Copyright (c) 2025 Bernier LLC
|
|
4
|
+
|
|
5
|
+
This file is licensed to the client under a limited-use license.
|
|
6
|
+
The client may use and modify this code *only within the scope of the project it was delivered for*.
|
|
7
|
+
Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
|
|
8
|
+
*/
|
|
9
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":";AAAA;;;;;;EAME"}
|
package/dist/types.d.ts
CHANGED
|
@@ -1,29 +1,10 @@
|
|
|
1
|
-
export
|
|
2
|
-
|
|
3
|
-
initialDelayMs: number;
|
|
4
|
-
maxDelayMs?: number;
|
|
5
|
-
backoffFactor?: number;
|
|
6
|
-
jitter?: boolean;
|
|
7
|
-
shouldRetry?: (err: any) => boolean;
|
|
8
|
-
onRetry?: (attempt: number, delay: number, err: any) => void;
|
|
9
|
-
onFailure?: (err: any) => void;
|
|
10
|
-
}
|
|
11
|
-
export interface RetryState {
|
|
12
|
-
id: string;
|
|
13
|
-
attempt: number;
|
|
14
|
-
lastAttempt: Date;
|
|
15
|
-
nextRetry: Date;
|
|
16
|
-
delay: number;
|
|
17
|
-
maxRetries: number;
|
|
18
|
-
status: 'pending' | 'retrying' | 'completed' | 'failed';
|
|
19
|
-
error?: any;
|
|
20
|
-
metadata?: Record<string, any>;
|
|
21
|
-
}
|
|
1
|
+
export type { RetryPolicyOptions as RetryOptions } from '@bernierllc/retry-policy';
|
|
2
|
+
export type { RetryState, RetryStateConfig, RetryStateUpdateOptions } from '@bernierllc/retry-state';
|
|
22
3
|
export interface StorageAdapter {
|
|
23
|
-
get(id: string): Promise<RetryState | null>;
|
|
24
|
-
set(id: string, state: RetryState): Promise<void>;
|
|
4
|
+
get(id: string): Promise<import('@bernierllc/retry-state').RetryState | null>;
|
|
5
|
+
set(id: string, state: import('@bernierllc/retry-state').RetryState): Promise<void>;
|
|
25
6
|
delete(id: string): Promise<void>;
|
|
26
|
-
list(prefix?: string): Promise<RetryState[]>;
|
|
7
|
+
list(prefix?: string): Promise<import('@bernierllc/retry-state').RetryState[]>;
|
|
27
8
|
clear(): Promise<void>;
|
|
28
9
|
}
|
|
29
10
|
export interface MemoryProtectionConfig {
|
|
@@ -35,7 +16,8 @@ export interface MemoryProtectionConfig {
|
|
|
35
16
|
export interface RetryManagerConfig {
|
|
36
17
|
storage: StorageAdapter;
|
|
37
18
|
memoryProtection?: MemoryProtectionConfig;
|
|
38
|
-
defaultOptions?: Partial<
|
|
19
|
+
defaultOptions?: Partial<import('@bernierllc/retry-policy').RetryPolicyOptions>;
|
|
20
|
+
enhancements?: any;
|
|
39
21
|
}
|
|
40
22
|
export interface RetryResult<T> {
|
|
41
23
|
success: boolean;
|
|
@@ -44,11 +26,4 @@ export interface RetryResult<T> {
|
|
|
44
26
|
attempts: number;
|
|
45
27
|
totalTime: number;
|
|
46
28
|
}
|
|
47
|
-
export interface RetryMetrics {
|
|
48
|
-
totalRetries: number;
|
|
49
|
-
successfulRetries: number;
|
|
50
|
-
failedRetries: number;
|
|
51
|
-
averageRetryTime: number;
|
|
52
|
-
memoryUsage: number;
|
|
53
|
-
}
|
|
54
29
|
//# sourceMappingURL=types.d.ts.map
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AASA,YAAY,EAAE,kBAAkB,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAErG,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,yBAAyB,EAAE,UAAU,GAAG,IAAI,CAAC,CAAC;IAC9E,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,yBAAyB,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,yBAAyB,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC,OAAO,0BAA0B,EAAE,kBAAkB,CAAC,CAAC;IAChF,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB"}
|
package/dist/types.js
CHANGED
|
@@ -7,4 +7,5 @@ The client may use and modify this code *only within the scope of the project it
|
|
|
7
7
|
Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
|
|
8
8
|
*/
|
|
9
9
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
|
+
// Metrics are now handled by @bernierllc/retry-metrics
|
|
10
11
|
//# sourceMappingURL=types.js.map
|
package/dist/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;EAME"}
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;AAoCF,wDAAwD"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bernierllc/backoff-retry",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "Portable async retry utility with exponential backoff, jitter, and error filtering for API and webhook management",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -25,11 +25,24 @@
|
|
|
25
25
|
"license": "ISC",
|
|
26
26
|
"repository": "https://github.com/bernier-llc/tools",
|
|
27
27
|
"dependencies": {
|
|
28
|
+
"events": "^3.3.0",
|
|
29
|
+
"@bernierllc/retry-policy": "^0.1.0",
|
|
30
|
+
"@bernierllc/retry-state": "^0.1.1",
|
|
31
|
+
"@bernierllc/retry-metrics": "^0.1.1"
|
|
32
|
+
},
|
|
33
|
+
"optionalDependencies": {
|
|
34
|
+
"@types/crypto-js": "^4.2.2",
|
|
35
|
+
"@types/ioredis": "^4.28.10",
|
|
36
|
+
"@types/pg": "^8.15.4",
|
|
37
|
+
"crypto-js": "^4.2.0",
|
|
38
|
+
"ioredis": "^5.6.1",
|
|
39
|
+
"pg": "^8.16.3",
|
|
28
40
|
"redis": "^4.6.0"
|
|
29
41
|
},
|
|
30
42
|
"devDependencies": {
|
|
31
43
|
"@types/jest": "^29.5.0",
|
|
32
44
|
"@types/node": "^20.0.0",
|
|
45
|
+
"@types/redis": "^4.0.11",
|
|
33
46
|
"jest": "^29.5.0",
|
|
34
47
|
"ts-jest": "^29.1.0",
|
|
35
48
|
"typescript": "^5.0.0"
|
|
@@ -37,4 +50,4 @@
|
|
|
37
50
|
"peerDependencies": {
|
|
38
51
|
"redis": "^4.6.0"
|
|
39
52
|
}
|
|
40
|
-
}
|
|
53
|
+
}
|