@sapphire-sh/utils 1.82.0 → 1.83.0

package/lib/notify.js

@@ -27,6 +27,22 @@ export const notifySlack = async (url, text) => {
         await sleep(delayMs);
     }
 };
+export const pingHealthchecks = async (url, timeoutMs = 4096) => {
+    try {
+        const resp = await fetch(url, {
+            method: 'GET',
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!resp.ok) {
+            logger.warn('[pingHealthchecks] ping failed', { status: resp.status });
+        }
+    }
+    catch (error) {
+        logger.warn('[pingHealthchecks] ping threw', {
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+};
 export const notifyMattermost = async (baseUrl, token, channelId, message) => {
     logger.debug('[notifyMattermost] posting to channel', { channelId, messageLength: message.length });
     const resp = await fetch(`${baseUrl}/api/v4/posts`, {

package/lib/notify.js.map

@@ -1 +1 @@
-{"version":3,"file":"notify.js","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,GAAW,EAAE,IAAY,EAAiB,EAAE;IAC7E,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACR,cAAc,EAAE,kBAAkB;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO;QACR,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,OAAO,GACZ,gBAAgB,KAAK,IAAI,IAAI,gBAAgB,KAAK,EAAE;YACnD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC,GAAG,IAAI;YAC9C,CAAC,CAAC,uBAAuB,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3E,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACpC,OAAe,EACf,KAAa,EACb,SAAiB,EACjB,OAAe,EACC,EAAE;IAClB,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpG,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,eAAe,EAAE;QACnD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACR,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,cAAc,EAAE,kBAAkB;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;KACxD,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;AACF,CAAC,CAAC"}
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"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"}

package/lib/retry.d.ts

@@ -0,0 +1,10 @@
+export interface RetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    jitterMs?: number;
+    isRetryable?: (error: unknown) => boolean;
+    delayMs?: (error: unknown, attempt: number) => number | undefined;
+    onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
+}
+export declare const retry: <T>(fn: () => Promise<T>, options?: RetryOptions) => Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/lib/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrE;AAED,eAAO,MAAM,KAAK,GAAU,CAAC,EAAE,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,CAAC,CAuBtF,CAAC"}

package/lib/retry.js

@@ -0,0 +1,18 @@
+import { sleep } from './sleep.js';
+export const retry = async (fn, options) => {
+    const { maxAttempts = 4, baseDelayMs = 1024, jitterMs = 512, isRetryable = () => true, delayMs, onRetry, } = options ?? {};
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (attempt >= maxAttempts || !isRetryable(error)) {
+                throw error;
+            }
+            const resolvedDelayMs = delayMs?.(error, attempt) ?? baseDelayMs * 2 ** (attempt - 1);
+            onRetry?.(error, attempt, resolvedDelayMs);
+            await sleep(resolvedDelayMs, jitterMs);
+        }
+    }
+};
+//# sourceMappingURL=retry.js.map

package/lib/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAWnC,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EAAK,EAAoB,EAAE,OAAsB,EAAc,EAAE;IAC1F,MAAM,EACL,WAAW,GAAG,CAAC,EACf,WAAW,GAAG,IAAI,EAClB,QAAQ,GAAG,GAAG,EACd,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,EACxB,OAAO,EACP,OAAO,GACP,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC;YACJ,OAAO,MAAM,EAAE,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,OAAO,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnD,MAAM,KAAK,CAAC;YACb,CAAC;YAED,MAAM,eAAe,GAAG,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACtF,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;YAC3C,MAAM,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;IACF,CAAC;AACF,CAAC,CAAC"}

package/lib/serialLimiter.d.ts

@@ -0,0 +1,3 @@
+export type SerialLimiter = <T>(task: () => Promise<T>, key?: string) => Promise<T>;
+export declare const createSerialLimiter: (minIntervalMs: number) => SerialLimiter;
+//# sourceMappingURL=serialLimiter.d.ts.map

package/lib/serialLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialLimiter.d.ts","sourceRoot":"","sources":["../src/serialLimiter.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpF,eAAO,MAAM,mBAAmB,GAAI,eAAe,MAAM,KAAG,aA2B3D,CAAC"}

package/lib/serialLimiter.js

@@ -0,0 +1,25 @@
+import { sleep } from './sleep.js';
+export const createSerialLimiter = (minIntervalMs) => {
+    const tails = new Map();
+    const startedAt = new Map();
+    return async (task, key = '') => {
+        const previous = tails.get(key);
+        const run = (async () => {
+            if (previous !== undefined) {
+                await previous;
+            }
+            const previousStartedAt = startedAt.get(key);
+            if (previousStartedAt !== undefined) {
+                const remainingMs = minIntervalMs - (Date.now() - previousStartedAt);
+                if (remainingMs > 0) {
+                    await sleep(remainingMs);
+                }
+            }
+            startedAt.set(key, Date.now());
+            return task();
+        })();
+        tails.set(key, Promise.allSettled([run]));
+        return run;
+    };
+};
+//# sourceMappingURL=serialLimiter.js.map

package/lib/serialLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialLimiter.js","sourceRoot":"","sources":["../src/serialLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAqB,EAAiB,EAAE;IAC3E,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,OAAO,KAAK,EAAK,IAAsB,EAAE,GAAG,GAAG,EAAE,EAAc,EAAE;QAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEhC,MAAM,GAAG,GAAG,CAAC,KAAK,IAAgB,EAAE;YACnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,QAAQ,CAAC;YAChB,CAAC;YAED,MAAM,iBAAiB,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;gBACrC,MAAM,WAAW,GAAG,aAAa,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC,CAAC;gBACrE,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;oBACrB,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC1B,CAAC;YACF,CAAC;YAED,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,EAAE,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;QAEL,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,GAAG,CAAC;IACZ,CAAC,CAAC;AACH,CAAC,CAAC"}

package/lib/slackLogBatcher.d.ts

@@ -0,0 +1,12 @@
+export interface SlackLogBatcherOptions {
+    webhookUrl: string;
+    flushIntervalMs?: number;
+    maxChunkLength?: number;
+}
+export interface SlackLogBatcher {
+    enqueue: (line: string) => void;
+    flush: () => Promise<void>;
+}
+export declare const chunkLines: (lines: string[], maxLength: number) => string[];
+export declare const createSlackLogBatcher: (options: SlackLogBatcherOptions) => SlackLogBatcher;
+//# sourceMappingURL=slackLogBatcher.d.ts.map

package/lib/slackLogBatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slackLogBatcher.d.ts","sourceRoot":"","sources":["../src/slackLogBatcher.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,EAAE,EAAE,WAAW,MAAM,KAAG,MAAM,EAoBrE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,SAAS,sBAAsB,KAAG,eAiCvE,CAAC"}

package/lib/slackLogBatcher.js

@@ -0,0 +1,49 @@
+import { logger } from './logger.js';
+import { notifySlack } from './notify.js';
+export const chunkLines = (lines, maxLength) => {
+    const chunks = [];
+    let current = null;
+    for (const line of lines) {
+        if (current === null) {
+            current = line;
+        }
+        else if (current.length + 1 + line.length > maxLength) {
+            chunks.push(current);
+            current = line;
+        }
+        else {
+            current = `${current}\n${line}`;
+        }
+    }
+    if (current !== null) {
+        chunks.push(current);
+    }
+    return chunks;
+};
+export const createSlackLogBatcher = (options) => {
+    const { webhookUrl, flushIntervalMs = 4096, maxChunkLength = 16384 } = options;
+    let queue = [];
+    let timer = null;
+    const flush = async () => {
+        if (timer !== null) {
+            globalThis.clearTimeout(timer);
+            timer = null;
+        }
+        const lines = queue;
+        queue = [];
+        for (const chunk of chunkLines(lines, maxChunkLength)) {
+            try {
+                await notifySlack(webhookUrl, chunk);
+            }
+            catch (error) {
+                logger.error('[slackLogBatcher] failed to send a chunk', error instanceof Error ? error : { error: String(error) });
+            }
+        }
+    };
+    const enqueue = (line) => {
+        queue.push(line);
+        timer ??= globalThis.setTimeout(() => void flush(), flushIntervalMs);
+    };
+    return { enqueue, flush };
+};
+//# sourceMappingURL=slackLogBatcher.js.map

package/lib/slackLogBatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slackLogBatcher.js","sourceRoot":"","sources":["../src/slackLogBatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa1C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,SAAiB,EAAY,EAAE;IAC1E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAkB,IAAI,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,CAAC;YACP,OAAO,GAAG,GAAG,OAAO,KAAK,IAAI,EAAE,CAAC;QACjC,CAAC;IACF,CAAC;IAED,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAA+B,EAAmB,EAAE;IACzF,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,EAAE,cAAc,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAE/E,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,KAAK,GAAoD,IAAI,CAAC;IAElE,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACpB,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,KAAK,GAAG,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC;QACpB,KAAK,GAAG,EAAE,CAAC;QAEX,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC;gBACJ,MAAM,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,KAAK,CACX,0CAA0C,EAC1C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CACzD,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE;QAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,KAAK,KAAK,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;IACtE,CAAC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC,CAAC"}

package/lib/vitestNext.d.ts

@@ -0,0 +1,3 @@
+declare const _default: Record<string, any>;
+export default _default;
+//# sourceMappingURL=vitestNext.d.ts.map

package/lib/vitestNext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitestNext.d.ts","sourceRoot":"","sources":["../src/vitestNext.ts"],"names":[],"mappings":";AAKA,wBAUG"}

package/lib/vitestNext.js

@@ -0,0 +1,16 @@
+import path from 'node:path';
+import { mergeConfig } from 'vitest/config';
+import base from './vitest.js';
+// vitest runs from the project root, so cwd-relative paths point at the consuming project.
+export default mergeConfig(base, {
+    resolve: {
+        alias: {
+            '@': path.resolve(process.cwd(), 'src'),
+        },
+    },
+    test: {
+        include: ['src/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
+        exclude: ['**/node_modules/**', '**/.next/**'],
+    },
+});
+//# sourceMappingURL=vitestNext.js.map

package/lib/vitestNext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitestNext.js","sourceRoot":"","sources":["../src/vitestNext.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,IAAI,MAAM,aAAa,CAAC;AAE/B,2FAA2F;AAC3F,eAAe,WAAW,CAAC,IAAI,EAAE;IAChC,OAAO,EAAE;QACR,KAAK,EAAE;YACN,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;SACvC;KACD;IACD,IAAI,EAAE;QACL,OAAO,EAAE,CAAC,sCAAsC,CAAC;QACjD,OAAO,EAAE,CAAC,oBAAoB,EAAE,aAAa,CAAC;KAC9C;CACD,CAAC,CAAC"}

package/package.json

@@ -1,8 +1,9 @@
 {
 	"name": "@sapphire-sh/utils",
-	"version": "1.82.0",
+	"version": "1.83.0",
 	"description": "@sapphire-sh/utils",
 	"type": "module",
+	"sideEffects": false,
 	"main": "./lib/index.js",
 	"types": "./lib/index.d.ts",
 	"bin": {
@@ -19,6 +20,11 @@
 			"require": "./lib/cjs/eslint.js",
 			"types": "./lib/eslint.d.ts"
 		},
+		"./eslint/next": {
+			"import": "./lib/eslintNext.js",
+			"require": "./lib/cjs/eslintNext.js",
+			"types": "./lib/eslintNext.d.ts"
+		},
 		"./prettier": {
 			"import": "./lib/prettier.js",
 			"require": "./lib/cjs/prettier.js",
@@ -29,6 +35,11 @@
 			"require": "./lib/cjs/vitest.js",
 			"types": "./lib/vitest.d.ts"
 		},
+		"./vitest/next": {
+			"import": "./lib/vitestNext.js",
+			"require": "./lib/cjs/vitestNext.js",
+			"types": "./lib/vitestNext.d.ts"
+		},
 		"./browser": {
 			"import": "./lib/browser.js",
 			"require": "./lib/cjs/browser.js",
@@ -76,8 +87,10 @@
 	"peerDependencies": {
 		"@eslint/js": ">=9.0.0",
 		"eslint": ">=9.0.0",
+		"eslint-config-next": ">=16.0.0",
 		"eslint-config-prettier": ">=9.0.0",
 		"eslint-plugin-promise": ">=7.0.0",
+		"next": ">=16.0.0",
 		"prettier": ">=3.0.0",
 		"prettier-plugin-organize-imports": ">=4.0.0",
 		"typescript-eslint": ">=8.0.0",
@@ -90,12 +103,18 @@
 		"eslint": {
 			"optional": true
 		},
+		"eslint-config-next": {
+			"optional": true
+		},
 		"eslint-config-prettier": {
 			"optional": true
 		},
 		"eslint-plugin-promise": {
 			"optional": true
 		},
+		"next": {
+			"optional": true
+		},
 		"typescript-eslint": {
 			"optional": true
 		},
@@ -108,6 +127,7 @@
 		"@types/node": "^25.5.0",
 		"@vitest/coverage-v8": "^4.1.1",
 		"eslint": "^9.24.0",
+		"eslint-config-next": "^16.3.5",
 		"eslint-config-prettier": "^10.1.2",
 		"eslint-plugin-promise": "^7.2.1",
 		"prettier": "^3.8.1",