@sapphire-sh/utils 1.82.0 → 1.84.0

package/lib/cjs/date.d.ts

@@ -1,3 +1,4 @@
 export declare const toLocalISOString: (date: Date) => string;
+export declare const formatDate: (date: Date, timeZone?: string) => string;
 export declare const formatDuration: (ms: number) => string;
 //# sourceMappingURL=date.d.ts.map

package/lib/cjs/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/date.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,KAAG,MAe7C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAmB3C,CAAC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/date.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,KAAG,MAe7C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,EAAE,WAAW,MAAM,KAAG,MACoD,CAAC;AAEhH,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAmB3C,CAAC"}

package/lib/cjs/date.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatDuration = exports.toLocalISOString = void 0;
+exports.formatDuration = exports.formatDate = exports.toLocalISOString = void 0;
 const toLocalISOString = (date) => {
     const year = date.getFullYear();
     const month = `${date.getMonth() + 1}`.padStart(2, '0');
@@ -16,6 +16,8 @@ const toLocalISOString = (date) => {
     return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}.${ms}${sign}${offsetHours}:${offsetMinutes}`;
 };
 exports.toLocalISOString = toLocalISOString;
+const formatDate = (date, timeZone) => new Intl.DateTimeFormat('en-CA', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(date);
+exports.formatDate = formatDate;
 const formatDuration = (ms) => {
     if (ms < 1000) {
         return `${ms}ms`;

package/lib/cjs/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/date.ts"],"names":[],"mappings":";;;AAAO,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAAU,EAAE;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACrC,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAElE,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,EAAE,GAAG,IAAI,GAAG,WAAW,IAAI,aAAa,EAAE,CAAC;AAC7G,CAAC,CAAC;AAfW,QAAA,gBAAgB,oBAe3B;AAEK,MAAM,cAAc,GAAG,CAAC,EAAU,EAAU,EAAE;IACpD,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACf,OAAO,GAAG,EAAE,IAAI,CAAC;IAClB,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC,CAAC;AAnBW,QAAA,cAAc,kBAmBzB"}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/date.ts"],"names":[],"mappings":"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"}

package/lib/cjs/download.d.ts

@@ -1,2 +1,2 @@
-export declare const download: (url: string, filePath: string, init?: RequestInit, timeoutMs?: number) => Promise<void>;
+export declare const download: (url: string, filePath: string, init?: RequestInit, timeoutMs?: number) => Promise<number>;
 //# sourceMappingURL=download.d.ts.map

package/lib/cjs/download.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/download.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ,GACpB,KAAK,MAAM,EACX,UAAU,MAAM,EAChB,OAAO,WAAW,EAClB,kBAAyB,KACvB,OAAO,CAAC,IAAI,CAUd,CAAC"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/download.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,QAAQ,GACpB,KAAK,MAAM,EACX,UAAU,MAAM,EAChB,OAAO,WAAW,EAClB,kBAAyB,KACvB,OAAO,CAAC,MAAM,CAgBhB,CAAC"}

package/lib/cjs/download.js

@@ -5,7 +5,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.download = void 0;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_stream_1 = require("node:stream");
+const promises_1 = require("node:stream/promises");
 const http_js_1 = require("./http.js");
+// fetch hands back the global ReadableStream, which Readable.fromWeb does not accept,
+// so the body is drained through its reader instead.
+const readChunks = async function* (body) {
+    const reader = body.getReader();
+    try {
+        for (;;) {
+            const result = await reader.read();
+            if (result.done) {
+                return;
+            }
+            yield result.value;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+};
 const download = async (url, filePath, init, timeoutMs = 5 * 60 * 1000) => {
     const resp = await fetch(url, {
         signal: AbortSignal.timeout(timeoutMs),
@@ -14,8 +33,12 @@ const download = async (url, filePath, init, timeoutMs = 5 * 60 * 1000) => {
     if (!resp.ok) {
         throw new http_js_1.HttpError(resp.status, resp.statusText);
     }
-    const buffer = await resp.arrayBuffer();
-    await node_fs_1.default.promises.writeFile(filePath, Buffer.from(buffer));
+    if (resp.body === null) {
+        throw new Error(`Response body is empty: ${url}`);
+    }
+    await (0, promises_1.pipeline)(node_stream_1.Readable.from(readChunks(resp.body)), node_fs_1.default.createWriteStream(filePath));
+    const { size } = await node_fs_1.default.promises.stat(filePath);
+    return size;
 };
 exports.download = download;
 //# sourceMappingURL=download.js.map

package/lib/cjs/download.js.map

@@ -1 +1 @@
-{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/download.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,uCAAsC;AAE/B,MAAM,QAAQ,GAAG,KAAK,EAC5B,GAAW,EACX,QAAgB,EAChB,IAAkB,EAClB,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EACT,EAAE;IAClB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;QACtC,GAAG,IAAI;KACP,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,IAAI,mBAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,iBAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5D,CAAC,CAAC;AAfW,QAAA,QAAQ,YAenB"}
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/download.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,6CAAuC;AACvC,mDAAgD;AAChD,uCAAsC;AAEtC,sFAAsF;AACtF,qDAAqD;AACrD,MAAM,UAAU,GAAG,KAAK,SAAS,CAAC,EAAE,IAAmC;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC;QACJ,SAAS,CAAC;YACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO;YACR,CAAC;YACD,MAAM,MAAM,CAAC,KAAK,CAAC;QACpB,CAAC;IACF,CAAC;YAAS,CAAC;QACV,MAAM,CAAC,WAAW,EAAE,CAAC;IACtB,CAAC;AACF,CAAC,CAAC;AAEK,MAAM,QAAQ,GAAG,KAAK,EAC5B,GAAW,EACX,QAAgB,EAChB,IAAkB,EAClB,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EACP,EAAE;IACpB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;QACtC,GAAG,IAAI;KACP,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,IAAI,mBAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,IAAA,mBAAQ,EAAC,sBAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,iBAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAErF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,iBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AArBW,QAAA,QAAQ,YAqBnB"}

package/lib/cjs/env.d.ts

@@ -0,0 +1,3 @@
+export declare const readEnv: (name: string) => string | undefined;
+export declare const requireEnv: (name: string) => string;
+//# sourceMappingURL=env.d.ts.map

package/lib/cjs/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAY/C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MAMzC,CAAC"}

package/lib/cjs/env.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireEnv = exports.readEnv = void 0;
+const readEnv = (name) => {
+    // The root entry re-exports modules that read env at load time, so a browser
+    // bundle without `process` must get undefined rather than a ReferenceError.
+    if (typeof process === 'undefined') {
+        return undefined;
+    }
+    const value = process.env[name];
+    if (value === undefined || value === '') {
+        return undefined;
+    }
+    return value;
+};
+exports.readEnv = readEnv;
+const requireEnv = (name) => {
+    const value = (0, exports.readEnv)(name);
+    if (value === undefined) {
+        throw new Error(`Missing required env var: ${name}`);
+    }
+    return value;
+};
+exports.requireEnv = requireEnv;
+//# sourceMappingURL=env.js.map

package/lib/cjs/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":";;;AAAO,MAAM,OAAO,GAAG,CAAC,IAAY,EAAsB,EAAE;IAC3D,6EAA6E;IAC7E,4EAA4E;IAC5E,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAZW,QAAA,OAAO,WAYlB;AAEK,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IAClD,MAAM,KAAK,GAAG,IAAA,eAAO,EAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AANW,QAAA,UAAU,cAMrB"}

package/lib/cjs/eslint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eslint.d.ts","sourceRoot":"","sources":["../../src/eslint.ts"],"names":[],"mappings":";AAOA,wBA0IE"}
+{"version":3,"file":"eslint.d.ts","sourceRoot":"","sources":["../../src/eslint.ts"],"names":[],"mappings":";AAOA,wBAuJE"}

package/lib/cjs/eslint.js

@@ -16,6 +16,7 @@ exports.default = (0, config_1.defineConfig)(js_1.default.configs.recommended, .
     rules: {
         // Sapphire
         'sapphire/no-control-characters': 'error',
+        'sapphire/prefer-read-env': 'error',
         // General
         'arrow-body-style': ['error', 'as-needed'],
         curly: 'error',
@@ -37,6 +38,7 @@ exports.default = (0, config_1.defineConfig)(js_1.default.configs.recommended, .
         'no-restricted-imports': [
             'error',
             { name: 'assert', message: 'Use `node:assert` instead.' },
+            { name: 'axios', message: 'Use fetch or fetchWithRetry from @sapphire-sh/utils instead.' },
             { name: 'buffer', message: 'Use `node:buffer` instead.' },
             { name: 'child_process', message: 'Use `node:child_process` instead.' },
             { name: 'cluster', message: 'Use `node:cluster` instead.' },
@@ -92,9 +94,9 @@ exports.default = (0, config_1.defineConfig)(js_1.default.configs.recommended, .
                 custom: { regex: '^I[A-Z]', match: false },
             },
         ],
-        '@typescript-eslint/no-explicit-any': 'warn',
+        '@typescript-eslint/no-explicit-any': 'error',
         '@typescript-eslint/no-namespace': 'off',
-        '@typescript-eslint/no-non-null-assertion': 'warn',
+        '@typescript-eslint/no-non-null-assertion': 'error',
         '@typescript-eslint/no-shadow': 'off',
         '@typescript-eslint/no-unnecessary-type-assertion': 'error',
         '@typescript-eslint/no-unused-vars': ['error', { varsIgnorePattern: '^_', argsIgnorePattern: '^_' }],
@@ -135,6 +137,16 @@ exports.default = (0, config_1.defineConfig)(js_1.default.configs.recommended, .
             project: true,
         },
     },
+}, {
+    // Test doubles implement only part of an interface, and some libraries return
+    // `unknown`, so test files narrow with `as` where production code must not.
+    files: ['**/*.test.ts', '**/*.test.tsx'],
+    rules: {
+        '@typescript-eslint/consistent-type-assertions': [
+            'error',
+            { assertionStyle: 'as', objectLiteralTypeAssertions: 'allow', arrayLiteralTypeAssertions: 'allow' },
+        ],
+    },
 }, {
     ignores: ['*.config.js', '**/*.json', 'coverage/', 'dist/', 'lib/', 'node_modules/'],
 });

package/lib/cjs/eslint.js.map

@@ -1 +1 @@
-{"version":3,"file":"eslint.js","sourceRoot":"","sources":["../../src/eslint.ts"],"names":[],"mappings":";;;;;AAAA,oDAAgC;AAChC,oFAA8C;AAC9C,kFAA4C;AAC5C,0CAA6C;AAC7C,0EAAyC;AACzC,qDAAkD;AAElD,kBAAe,IAAA,qBAAY,EAC1B,YAAM,CAAC,OAAO,CAAC,WAAW,EAC1B,GAAG,2BAAQ,CAAC,OAAO,CAAC,WAAW,EAC/B,gCAAQ,EACR,+BAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,EACnC;IACC,OAAO,EAAE;QACR,QAAQ,EAAE,+BAAc;KACxB;IACD,KAAK,EAAE;QACN,WAAW;QACX,gCAAgC,EAAE,OAAO;QAEzC,UAAU;QACV,kBAAkB,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;QAC1C,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC3B,YAAY,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC;QACrC,YAAY,EAAE,KAAK;QACnB,uBAAuB,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACzD,gBAAgB,EAAE,OAAO;QACzB,sBAAsB,EAAE,OAAO;QAC/B,mBAAmB,EAAE,OAAO;QAC5B,mBAAmB,EAAE,OAAO;QAC5B,uBAAuB,EAAE;YACxB,OAAO;YACP,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,8BAA8B,EAAE;YAC7D,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,2BAA2B,EAAE;YACvD,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,gCAAgC,EAAE;YACjE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,8BAA8B,EAAE;SAC7D;QACD,uBAAuB,EAAE;YACxB,OAAO;YACP,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE;YACzD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE;YACzD,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,mCAAmC,EAAE;YACvE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,6BAA6B,EAAE;YAC3D,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE;YACzD,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,2BAA2B,EAAE;YACvD,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,EAAE;YACnD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE;YACzD,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,wBAAwB,EAAE;YACjD,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,iCAAiC,EAAE;YACnE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE;YACrD,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,2BAA2B,EAAE;YACvD,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,2BAA2B,EAAE;YACvD,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,EAAE;YACnD,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,wBAAwB,EAAE;YACjD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE;YACrD,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,gCAAgC,EAAE;YACjE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,gCAAgC,EAAE;YACjE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,gCAAgC,EAAE;YACjE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,6BAA6B,EAAE;YAC3D,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,iCAAiC,EAAE;YACnE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,8BAA8B,EAAE;YAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE;YACzD,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,qCAAqC,EAAE;YAC3E,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,oCAAoC,EAAE;YACzE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE;YACzD,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,qCAAqC,EAAE;YAC3E,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,EAAE;YACnD,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,EAAE;YACnD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE;YACrD,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,oCAAoC,EAAE;YACzE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE;SACrD;QACD,kBAAkB,EAAE,OAAO;QAC3B,qBAAqB,EAAE,OAAO;QAC9B,QAAQ,EAAE,OAAO;QACjB,kBAAkB,EAAE,OAAO;QAC3B,uBAAuB,EAAE,OAAO;QAChC,cAAc,EAAE,OAAO;QACvB,sBAAsB,EAAE,OAAO;QAC/B,iBAAiB,EAAE,OAAO;QAC1B,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;QAC1D,IAAI,EAAE,OAAO;QAEb,aAAa;QACb,+BAA+B,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAChE,+CAA+C,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;QACvF,gDAAgD,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;QACxE,4CAA4C,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC;QAC9F,sCAAsC,EAAE;YACvC,OAAO;YACP;gBACC,QAAQ,EAAE,WAAW;gBACrB,MAAM,EAAE,CAAC,YAAY,CAAC;gBACtB,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE;aAC1C;SACD;QACD,oCAAoC,EAAE,MAAM;QAC5C,iCAAiC,EAAE,KAAK;QACxC,0CAA0C,EAAE,MAAM;QAClD,8BAA8B,EAAE,KAAK;QACrC,kDAAkD,EAAE,OAAO;QAC3D,mCAAmC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QACpG,8CAA8C,EAAE,OAAO;QACvD,0CAA0C,EAAE,OAAO;KACnD;CACD,EACD;IACC,uEAAuE;IACvE,KAAK,EAAE;QACN,sBAAsB,EAAE;YACvB,OAAO;YACP;gBACC,QAAQ,EAAE,6CAA6C;gBACvD,OAAO,EAAE,oCAAoC;aAC7C;YACD;gBACC,QAAQ,EAAE,8CAA8C;gBACxD,OAAO,EAAE,oDAAoD;aAC7D;YACD;gBACC,QAAQ,EAAE,mDAAmD;gBAC7D,OAAO,EAAE,mEAAmE;aAC5E;SACD;QACD,yCAAyC,EAAE,OAAO;QAClD,wCAAwC,EAAE,OAAO;QACjD,6CAA6C,EAAE,OAAO;QACtD,oCAAoC,EAAE,OAAO;QAC7C,2CAA2C,EAAE,OAAO;QACpD,iCAAiC,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC;QAC5D,+CAA+C,EAAE,OAAO;QACxD,gDAAgD,EAAE,CAAC,OAAO,EAAE,EAAE,mCAAmC,EAAE,IAAI,EAAE,CAAC;QAC1G,mCAAmC,EAAE,OAAO;QAC5C,8BAA8B,EAAE,OAAO;KACvC;IACD,eAAe,EAAE;QAChB,aAAa,EAAE;YACd,OAAO,EAAE,IAAI;SACb;KACD;CACD,EACD;IACC,OAAO,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC;CACpF,CACD,CAAC"}
+{"version":3,"file":"eslint.js","sourceRoot":"","sources":["../../src/eslint.ts"],"names":[],"mappings":"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"}

package/lib/cjs/eslintNext.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@eslint/config-helpers").Config[];
+export default _default;
+//# sourceMappingURL=eslintNext.d.ts.map

package/lib/cjs/eslintNext.d.ts.map

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

package/lib/cjs/eslintNext.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_web_vitals_1 = __importDefault(require("eslint-config-next/core-web-vitals"));
+const typescript_1 = __importDefault(require("eslint-config-next/typescript"));
+const config_1 = require("eslint/config");
+const eslint_js_1 = __importDefault(require("./eslint.js"));
+exports.default = (0, config_1.defineConfig)(...eslint_js_1.default, ...core_web_vitals_1.default, ...typescript_1.default, (0, config_1.globalIgnores)(['.next/**', 'out/**', 'build/**', 'next-env.d.ts']));
+//# sourceMappingURL=eslintNext.js.map

package/lib/cjs/eslintNext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslintNext.js","sourceRoot":"","sources":["../../src/eslintNext.ts"],"names":[],"mappings":";;;;;AAAA,yFAAmE;AACnE,+EAA2D;AAC3D,0CAA4D;AAC5D,4DAAyC;AAEzC,kBAAe,IAAA,qBAAY,EAC1B,GAAG,mBAAc,EACjB,GAAG,yBAAiB,EACpB,GAAG,oBAAc,EACjB,IAAA,sBAAa,EAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAClE,CAAC"}

package/lib/cjs/eslintRules.d.ts

@@ -1,4 +1,5 @@
 import type { ESLint, Rule } from 'eslint';
 export declare const noControlCharacters: Rule.RuleModule;
+export declare const preferReadEnv: Rule.RuleModule;
 export declare const sapphirePlugin: ESLint.Plugin;
 //# sourceMappingURL=eslintRules.d.ts.map

package/lib/cjs/eslintRules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eslintRules.d.ts","sourceRoot":"","sources":["../../src/eslintRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAO3C,eAAO,MAAM,mBAAmB,EAAE,IAAI,CAAC,UAgCtC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAInC,CAAC"}
+{"version":3,"file":"eslintRules.d.ts","sourceRoot":"","sources":["../../src/eslintRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAQ3C,eAAO,MAAM,mBAAmB,EAAE,IAAI,CAAC,UAgCtC,CAAC;AAUF,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,UAyBhC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAKnC,CAAC"}

package/lib/cjs/eslintRules.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sapphirePlugin = exports.noControlCharacters = void 0;
+exports.sapphirePlugin = exports.preferReadEnv = exports.noControlCharacters = void 0;
 // C0 control characters and DEL, excluding tab (U+0009), LF (U+000A), and CR (U+000D).
 // Matching control characters is the whole point of this rule, so no-control-regex is expected here.
 // eslint-disable-next-line no-control-regex
@@ -38,9 +38,41 @@ exports.noControlCharacters = {
         };
     },
 };
+const isProcessEnv = (node) => node.type === 'MemberExpression' &&
+    !node.computed &&
+    node.object.type === 'Identifier' &&
+    node.object.name === 'process' &&
+    node.property.type === 'Identifier' &&
+    node.property.name === 'env';
+exports.preferReadEnv = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow fallback operators on process.env values, which keep an empty string as a value',
+        },
+        schema: [],
+        messages: {
+            preferReadEnv: 'Use readEnv() from @sapphire-sh/utils instead of a fallback operator on process.env, which does not treat an empty string as unset.',
+        },
+    },
+    create(context) {
+        return {
+            LogicalExpression(node) {
+                if (node.operator !== '??' && node.operator !== '||') {
+                    return;
+                }
+                if (node.left.type !== 'MemberExpression' || !isProcessEnv(node.left.object)) {
+                    return;
+                }
+                context.report({ node, messageId: 'preferReadEnv' });
+            },
+        };
+    },
+};
 exports.sapphirePlugin = {
     rules: {
         'no-control-characters': exports.noControlCharacters,
+        'prefer-read-env': exports.preferReadEnv,
     },
 };
 //# sourceMappingURL=eslintRules.js.map

package/lib/cjs/eslintRules.js.map

@@ -1 +1 @@
-{"version":3,"file":"eslintRules.js","sourceRoot":"","sources":["../../src/eslintRules.ts"],"names":[],"mappings":";;;AAEA,uFAAuF;AACvF,qGAAqG;AACrG,4CAA4C;AAC5C,MAAM,yBAAyB,GAAG,IAAI,MAAM,CAAC,uDAAuD,EAAE,GAAG,CAAC,CAAC;AAE9F,QAAA,mBAAmB,GAAoB;IACnD,IAAI,EAAE;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACL,WAAW,EAAE,mEAAmE;SAChF;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACT,gBAAgB,EAAE,oDAAoD;SACtE;KACD;IACD,MAAM,CAAC,OAAO;QACb,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAC/B,OAAO;YACN,OAAO,CAAC,IAAI;gBACX,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;gBAClC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;oBAC9D,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;oBACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;oBAChF,OAAO,CAAC,MAAM,CAAC;wBACd,IAAI;wBACJ,GAAG,EAAE;4BACJ,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC;4BACxC,GAAG,EAAE,UAAU,CAAC,eAAe,CAAC,KAAK,GAAG,CAAC,CAAC;yBAC1C;wBACD,SAAS,EAAE,kBAAkB;wBAC7B,IAAI,EAAE,EAAE,IAAI,EAAE;qBACd,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;SACD,CAAC;IACH,CAAC;CACD,CAAC;AAEW,QAAA,cAAc,GAAkB;IAC5C,KAAK,EAAE;QACN,uBAAuB,EAAE,2BAAmB;KAC5C;CACD,CAAC"}
+{"version":3,"file":"eslintRules.js","sourceRoot":"","sources":["../../src/eslintRules.ts"],"names":[],"mappings":";;;AAGA,uFAAuF;AACvF,qGAAqG;AACrG,4CAA4C;AAC5C,MAAM,yBAAyB,GAAG,IAAI,MAAM,CAAC,uDAAuD,EAAE,GAAG,CAAC,CAAC;AAE9F,QAAA,mBAAmB,GAAoB;IACnD,IAAI,EAAE;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACL,WAAW,EAAE,mEAAmE;SAChF;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACT,gBAAgB,EAAE,oDAAoD;SACtE;KACD;IACD,MAAM,CAAC,OAAO;QACb,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAC/B,OAAO;YACN,OAAO,CAAC,IAAI;gBACX,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;gBAClC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;oBAC9D,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;oBACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;oBAChF,OAAO,CAAC,MAAM,CAAC;wBACd,IAAI;wBACJ,GAAG,EAAE;4BACJ,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC;4BACxC,GAAG,EAAE,UAAU,CAAC,eAAe,CAAC,KAAK,GAAG,CAAC,CAAC;yBAC1C;wBACD,SAAS,EAAE,kBAAkB;wBAC7B,IAAI,EAAE,EAAE,IAAI,EAAE;qBACd,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;SACD,CAAC;IACH,CAAC;CACD,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAU,EAAW,EAAE,CAC5C,IAAI,CAAC,IAAI,KAAK,kBAAkB;IAChC,CAAC,IAAI,CAAC,QAAQ;IACd,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;IACjC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;IAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;IACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC;AAEjB,QAAA,aAAa,GAAoB;IAC7C,IAAI,EAAE;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACL,WAAW,EAAE,0FAA0F;SACvG;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACT,aAAa,EACZ,qIAAqI;SACtI;KACD;IACD,MAAM,CAAC,OAAO;QACb,OAAO;YACN,iBAAiB,CAAC,IAAI;gBACrB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtD,OAAO;gBACR,CAAC;gBACD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC9E,OAAO;gBACR,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAC;YACtD,CAAC;SACD,CAAC;IACH,CAAC;CACD,CAAC;AAEW,QAAA,cAAc,GAAkB;IAC5C,KAAK,EAAE;QACN,uBAAuB,EAAE,2BAAmB;QAC5C,iBAAiB,EAAE,qBAAa;KAChC;CACD,CAAC"}

package/lib/cjs/format.d.ts

@@ -0,0 +1,2 @@
+export declare const formatBytes: (bytes: number) => string;
+//# sourceMappingURL=format.d.ts.map

package/lib/cjs/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAc3C,CAAC"}

package/lib/cjs/format.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBytes = void 0;
+const BYTES_PER_UNIT = 1024;
+const BYTE_UNITS = ['KB', 'MB', 'GB', 'TB'];
+const roundToDisplay = (value) => Number(value.toFixed(1));
+const formatBytes = (bytes) => {
+    if (bytes < BYTES_PER_UNIT) {
+        return `${bytes} B`;
+    }
+    let value = bytes / BYTES_PER_UNIT;
+    let unitIndex = 0;
+    while (roundToDisplay(value) >= BYTES_PER_UNIT && unitIndex < BYTE_UNITS.length - 1) {
+        value /= BYTES_PER_UNIT;
+        unitIndex += 1;
+    }
+    return `${value.toFixed(1)} ${BYTE_UNITS[unitIndex]}`;
+};
+exports.formatBytes = formatBytes;
+//# sourceMappingURL=format.js.map

package/lib/cjs/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":";;;AAAA,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAE5C,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IACpD,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;QAC5B,OAAO,GAAG,KAAK,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,GAAG,cAAc,CAAC;IACnC,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,cAAc,IAAI,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrF,KAAK,IAAI,cAAc,CAAC;QACxB,SAAS,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;AACvD,CAAC,CAAC;AAdW,QAAA,WAAW,eActB"}

package/lib/cjs/fs.d.ts

@@ -1,2 +1,5 @@
+export declare const fileExists: (path: string) => Promise<boolean>;
 export declare const mkdir: (path: string) => Promise<void>;
+export declare const readJson: <T>(path: string) => Promise<T>;
+export declare const writeJson: (path: string, data: unknown) => Promise<void>;
 //# sourceMappingURL=fs.d.ts.map

package/lib/cjs/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAUtD,CAAC"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAU9D,CAAC;AAEF,eAAO,MAAM,KAAK,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAKtD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAU,CAAC,EAAE,MAAM,MAAM,KAAG,OAAO,CAAC,CAAC,CAIzD,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,MAAM,MAAM,EAAE,MAAM,OAAO,KAAG,OAAO,CAAC,IAAI,CAEzE,CAAC"}

package/lib/cjs/fs.js

@@ -3,20 +3,36 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mkdir = void 0;
+exports.writeJson = exports.readJson = exports.mkdir = exports.fileExists = void 0;
 const node_fs_1 = __importDefault(require("node:fs"));
-const mkdir = async (path) => {
+const fileExists = async (path) => {
     try {
         await node_fs_1.default.promises.lstat(path);
+        return true;
     }
     catch (error) {
         if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-            await node_fs_1.default.promises.mkdir(path, { recursive: true });
-        }
-        else {
-            throw error;
+            return false;
         }
+        throw error;
     }
 };
+exports.fileExists = fileExists;
+const mkdir = async (path) => {
+    if (await (0, exports.fileExists)(path)) {
+        return;
+    }
+    await node_fs_1.default.promises.mkdir(path, { recursive: true });
+};
 exports.mkdir = mkdir;
+const readJson = async (path) => {
+    const text = await node_fs_1.default.promises.readFile(path, 'utf-8');
+    const parsed = JSON.parse(text);
+    return parsed;
+};
+exports.readJson = readJson;
+const writeJson = async (path, data) => {
+    await node_fs_1.default.promises.writeFile(path, `${JSON.stringify(data, null, 2)}\n`);
+};
+exports.writeJson = writeJson;
 //# sourceMappingURL=fs.js.map

package/lib/cjs/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AAElB,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;IAC1D,IAAI,CAAC;QACJ,MAAM,iBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1E,MAAM,iBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACP,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;AACF,CAAC,CAAC;AAVW,QAAA,KAAK,SAUhB"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AAElB,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IAClE,IAAI,CAAC;QACJ,MAAM,iBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1E,OAAO,KAAK,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC,CAAC;AAVW,QAAA,UAAU,cAUrB;AAEK,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;IAC1D,IAAI,MAAM,IAAA,kBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO;IACR,CAAC;IACD,MAAM,iBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC;AALW,QAAA,KAAK,SAKhB;AAEK,MAAM,QAAQ,GAAG,KAAK,EAAK,IAAY,EAAc,EAAE;IAC7D,MAAM,IAAI,GAAG,MAAM,iBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,MAAM,GAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAJW,QAAA,QAAQ,YAInB;AAEK,MAAM,SAAS,GAAG,KAAK,EAAE,IAAY,EAAE,IAAa,EAAiB,EAAE;IAC7E,MAAM,iBAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB"}

package/lib/cjs/http.d.ts

@@ -1,6 +1,7 @@
 export declare class HttpError extends Error {
     readonly status: number;
-    constructor(status: number, statusText: string);
+    readonly retryAfterMs?: number | undefined;
+    constructor(status: number, statusText: string, retryAfterMs?: number | undefined);
 }
 export interface FetchRetryOptions {
     maxRetries?: number;
@@ -9,4 +10,5 @@ export interface FetchRetryOptions {
     timeoutMs?: number;
 }
 export declare const fetchWithRetry: (url: string, init?: RequestInit, retryOptions?: FetchRetryOptions) => Promise<Response>;
+export declare const fetchJson: <T>(url: string, init?: RequestInit, retryOptions?: FetchRetryOptions) => Promise<T>;
 //# sourceMappingURL=http.d.ts.map

package/lib/cjs/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAEA,qBAAa,SAAU,SAAQ,KAAK;aAElB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,UAAU,EAAE,MAAM;CAInB;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,cAAc,GAC1B,KAAK,MAAM,EACX,OAAO,WAAW,EAClB,eAAe,iBAAiB,KAC9B,OAAO,CAAC,QAAQ,CA6BlB,CAAC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAEA,qBAAa,SAAU,SAAQ,KAAK;aAElB,MAAM,EAAE,MAAM;aAEd,YAAY,CAAC,EAAE,MAAM;gBAFrB,MAAM,EAAE,MAAM,EAC9B,UAAU,EAAE,MAAM,EACF,YAAY,CAAC,EAAE,MAAM,YAAA;CAItC;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD,eAAO,MAAM,cAAc,GAC1B,KAAK,MAAM,EACX,OAAO,WAAW,EAClB,eAAe,iBAAiB,KAC9B,OAAO,CAAC,QAAQ,CAwBlB,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,CAAC,EAAE,KAAK,MAAM,EAAE,OAAO,WAAW,EAAE,eAAe,iBAAiB,KAAG,OAAO,CAAC,CAAC,CAI/G,CAAC"}

package/lib/cjs/http.js

@@ -1,18 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchWithRetry = exports.HttpError = void 0;
-const sleep_js_1 = require("./sleep.js");
+exports.fetchJson = exports.fetchWithRetry = exports.HttpError = void 0;
+const retry_js_1 = require("./retry.js");
 class HttpError extends Error {
     status;
-    constructor(status, statusText) {
+    retryAfterMs;
+    constructor(status, statusText, retryAfterMs) {
         super(`HTTP ${status} ${statusText}`);
         this.status = status;
+        this.retryAfterMs = retryAfterMs;
     }
 }
 exports.HttpError = HttpError;
+const parseRetryAfterMs = (response) => {
+    const header = response.headers.get('retry-after');
+    if (header === null || header === '') {
+        return undefined;
+    }
+    return Number.parseInt(header, 10) * 1000;
+};
 const fetchWithRetry = async (url, init, retryOptions) => {
     const { maxRetries = 3, baseDelayMs = 1000, jitterMs = 500, timeoutMs = 30000 } = retryOptions ?? {};
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    return (0, retry_js_1.retry)(async () => {
         const resp = await fetch(url, {
             signal: AbortSignal.timeout(timeoutMs),
             ...init,
@@ -20,18 +29,20 @@ const fetchWithRetry = async (url, init, retryOptions) => {
         if (resp.ok) {
             return resp;
         }
-        const error = new HttpError(resp.status, resp.statusText);
-        const isTransient = resp.status === 429 || resp.status >= 500;
-        if (!isTransient || attempt === maxRetries) {
-            throw error;
-        }
-        const retryAfterHeader = resp.headers.get('retry-after');
-        const delay = retryAfterHeader !== null && retryAfterHeader !== ''
-            ? Number.parseInt(retryAfterHeader, 10) * 1000
-            : baseDelayMs * 2 ** attempt;
-        await (0, sleep_js_1.sleep)(delay, jitterMs);
-    }
-    throw new Error('unreachable');
+        throw new HttpError(resp.status, resp.statusText, parseRetryAfterMs(resp));
+    }, {
+        maxAttempts: maxRetries + 1,
+        baseDelayMs,
+        jitterMs,
+        isRetryable: (error) => error instanceof HttpError && (error.status === 429 || error.status >= 500),
+        delayMs: (error) => (error instanceof HttpError ? error.retryAfterMs : undefined),
+    });
 };
 exports.fetchWithRetry = fetchWithRetry;
+const fetchJson = async (url, init, retryOptions) => {
+    const resp = await (0, exports.fetchWithRetry)(url, init, retryOptions);
+    const parsed = await resp.json();
+    return parsed;
+};
+exports.fetchJson = fetchJson;
 //# sourceMappingURL=http.js.map

package/lib/cjs/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":";;;AAAA,yCAAmC;AAEnC,MAAa,SAAU,SAAQ,KAAK;IAElB;IADjB,YACiB,MAAc,EAC9B,UAAkB;QAElB,KAAK,CAAC,QAAQ,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;QAHtB,WAAM,GAAN,MAAM,CAAQ;IAI/B,CAAC;CACD;AAPD,8BAOC;AASM,MAAM,cAAc,GAAG,KAAK,EAClC,GAAW,EACX,IAAkB,EAClB,YAAgC,EACZ,EAAE;IACtB,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,EAAE,QAAQ,GAAG,GAAG,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,YAAY,IAAI,EAAE,CAAC;IAErG,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;YACtC,GAAG,IAAI;SACP,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;QAE9D,IAAI,CAAC,WAAW,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,KAAK,CAAC;QACb,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,KAAK,GACV,gBAAgB,KAAK,IAAI,IAAI,gBAAgB,KAAK,EAAE;YACnD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC,GAAG,IAAI;YAC9C,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC;QAC/B,MAAM,IAAA,gBAAK,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;AAChC,CAAC,CAAC;AAjCW,QAAA,cAAc,kBAiCzB"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":";;;AAAA,yCAAmC;AAEnC,MAAa,SAAU,SAAQ,KAAK;IAElB;IAEA;IAHjB,YACiB,MAAc,EAC9B,UAAkB,EACF,YAAqB;QAErC,KAAK,CAAC,QAAQ,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;QAJtB,WAAM,GAAN,MAAM,CAAQ;QAEd,iBAAY,GAAZ,YAAY,CAAS;IAGtC,CAAC;CACD;AARD,8BAQC;AASD,MAAM,iBAAiB,GAAG,CAAC,QAAkB,EAAsB,EAAE;IACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;AAC3C,CAAC,CAAC;AAEK,MAAM,cAAc,GAAG,KAAK,EAClC,GAAW,EACX,IAAkB,EAClB,YAAgC,EACZ,EAAE;IACtB,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,EAAE,QAAQ,GAAG,GAAG,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,YAAY,IAAI,EAAE,CAAC;IAErG,OAAO,IAAA,gBAAK,EACX,KAAK,IAAI,EAAE;QACV,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;YACtC,GAAG,IAAI;SACP,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,CAAC,EACD;QACC,WAAW,EAAE,UAAU,GAAG,CAAC;QAC3B,WAAW;QACX,QAAQ;QACR,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;QACnG,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;KACjF,CACD,CAAC;AACH,CAAC,CAAC;AA5BW,QAAA,cAAc,kBA4BzB;AAEK,MAAM,SAAS,GAAG,KAAK,EAAK,GAAW,EAAE,IAAkB,EAAE,YAAgC,EAAc,EAAE;IACnH,MAAM,IAAI,GAAG,MAAM,IAAA,sBAAc,EAAC,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAM,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAJW,QAAA,SAAS,aAIpB"}

package/lib/cjs/index.d.ts

@@ -1,12 +1,24 @@
-export { formatDuration, toLocalISOString } from './date.js';
+export { formatDate, formatDuration, toLocalISOString } from './date.js';
+export { readEnv, requireEnv } from './env.js';
 export { serializeError } from './error.js';
+export { formatBytes } from './format.js';
 export { getEnumValue } from './getEnumValue.js';
-export { HttpError, fetchWithRetry } from './http.js';
+export { HttpError, fetchJson, fetchWithRetry } from './http.js';
 export type { FetchRetryOptions } from './http.js';
 export { isNonNullable } from './isNonNullable.js';
+export { getArray, getBoolean, getNumber, getObject, getString, isJsonObject, parseJson } from './json.js';
+export type { JsonObject, JsonValue } from './json.js';
 export { LogLevel, logger } from './logger.js';
-export { notifyMattermost, notifySlack } from './notify.js';
+export type { LogEntry, LogSink } from './logger.js';
+export { clamp } from './math.js';
+export { notifyMattermost, notifySlack, pingHealthchecks } from './notify.js';
 export { Queue } from './queue.js';
+export { retry } from './retry.js';
+export type { RetryOptions } from './retry.js';
+export { createSerialLimiter } from './serialLimiter.js';
+export type { SerialLimiter } from './serialLimiter.js';
+export { chunkLines, createSlackLogBatcher } from './slackLogBatcher.js';
+export type { SlackLogBatcher, SlackLogBatcherOptions } from './slackLogBatcher.js';
 export { sleep } from './sleep.js';
 export { escapeHtml } from './string.js';
 export { throttle } from './throttle.js';

package/lib/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3G,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}

package/lib/cjs/index.js

@@ -1,26 +1,51 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.throttle = exports.escapeHtml = exports.sleep = exports.Queue = exports.notifySlack = exports.notifyMattermost = exports.logger = exports.LogLevel = exports.isNonNullable = exports.fetchWithRetry = exports.HttpError = exports.getEnumValue = exports.serializeError = exports.toLocalISOString = exports.formatDuration = void 0;
+exports.throttle = exports.escapeHtml = exports.sleep = exports.createSlackLogBatcher = exports.chunkLines = exports.createSerialLimiter = exports.retry = exports.Queue = exports.pingHealthchecks = exports.notifySlack = exports.notifyMattermost = exports.clamp = exports.logger = exports.LogLevel = exports.parseJson = exports.isJsonObject = exports.getString = exports.getObject = exports.getNumber = exports.getBoolean = exports.getArray = exports.isNonNullable = exports.fetchWithRetry = exports.fetchJson = exports.HttpError = exports.getEnumValue = exports.formatBytes = exports.serializeError = exports.requireEnv = exports.readEnv = exports.toLocalISOString = exports.formatDuration = exports.formatDate = void 0;
 var date_js_1 = require("./date.js");
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return date_js_1.formatDate; } });
 Object.defineProperty(exports, "formatDuration", { enumerable: true, get: function () { return date_js_1.formatDuration; } });
 Object.defineProperty(exports, "toLocalISOString", { enumerable: true, get: function () { return date_js_1.toLocalISOString; } });
+var env_js_1 = require("./env.js");
+Object.defineProperty(exports, "readEnv", { enumerable: true, get: function () { return env_js_1.readEnv; } });
+Object.defineProperty(exports, "requireEnv", { enumerable: true, get: function () { return env_js_1.requireEnv; } });
 var error_js_1 = require("./error.js");
 Object.defineProperty(exports, "serializeError", { enumerable: true, get: function () { return error_js_1.serializeError; } });
+var format_js_1 = require("./format.js");
+Object.defineProperty(exports, "formatBytes", { enumerable: true, get: function () { return format_js_1.formatBytes; } });
 var getEnumValue_js_1 = require("./getEnumValue.js");
 Object.defineProperty(exports, "getEnumValue", { enumerable: true, get: function () { return getEnumValue_js_1.getEnumValue; } });
 var http_js_1 = require("./http.js");
 Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return http_js_1.HttpError; } });
+Object.defineProperty(exports, "fetchJson", { enumerable: true, get: function () { return http_js_1.fetchJson; } });
 Object.defineProperty(exports, "fetchWithRetry", { enumerable: true, get: function () { return http_js_1.fetchWithRetry; } });
 var isNonNullable_js_1 = require("./isNonNullable.js");
 Object.defineProperty(exports, "isNonNullable", { enumerable: true, get: function () { return isNonNullable_js_1.isNonNullable; } });
+var json_js_1 = require("./json.js");
+Object.defineProperty(exports, "getArray", { enumerable: true, get: function () { return json_js_1.getArray; } });
+Object.defineProperty(exports, "getBoolean", { enumerable: true, get: function () { return json_js_1.getBoolean; } });
+Object.defineProperty(exports, "getNumber", { enumerable: true, get: function () { return json_js_1.getNumber; } });
+Object.defineProperty(exports, "getObject", { enumerable: true, get: function () { return json_js_1.getObject; } });
+Object.defineProperty(exports, "getString", { enumerable: true, get: function () { return json_js_1.getString; } });
+Object.defineProperty(exports, "isJsonObject", { enumerable: true, get: function () { return json_js_1.isJsonObject; } });
+Object.defineProperty(exports, "parseJson", { enumerable: true, get: function () { return json_js_1.parseJson; } });
 var logger_js_1 = require("./logger.js");
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_js_1.LogLevel; } });
 Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_js_1.logger; } });
+var math_js_1 = require("./math.js");
+Object.defineProperty(exports, "clamp", { enumerable: true, get: function () { return math_js_1.clamp; } });
 var notify_js_1 = require("./notify.js");
 Object.defineProperty(exports, "notifyMattermost", { enumerable: true, get: function () { return notify_js_1.notifyMattermost; } });
 Object.defineProperty(exports, "notifySlack", { enumerable: true, get: function () { return notify_js_1.notifySlack; } });
+Object.defineProperty(exports, "pingHealthchecks", { enumerable: true, get: function () { return notify_js_1.pingHealthchecks; } });
 var queue_js_1 = require("./queue.js");
 Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return queue_js_1.Queue; } });
+var retry_js_1 = require("./retry.js");
+Object.defineProperty(exports, "retry", { enumerable: true, get: function () { return retry_js_1.retry; } });
+var serialLimiter_js_1 = require("./serialLimiter.js");
+Object.defineProperty(exports, "createSerialLimiter", { enumerable: true, get: function () { return serialLimiter_js_1.createSerialLimiter; } });
+var slackLogBatcher_js_1 = require("./slackLogBatcher.js");
+Object.defineProperty(exports, "chunkLines", { enumerable: true, get: function () { return slackLogBatcher_js_1.chunkLines; } });
+Object.defineProperty(exports, "createSlackLogBatcher", { enumerable: true, get: function () { return slackLogBatcher_js_1.createSlackLogBatcher; } });
 var sleep_js_1 = require("./sleep.js");
 Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return sleep_js_1.sleep; } });
 var string_js_1 = require("./string.js");