@c9up/ream 0.1.34 → 0.2.0

package/dist/health/Result.js

@@ -0,0 +1,55 @@
+/**
+ * A chainable builder for a check result (AdonisJS `Result`).
+ */
+export class Result {
+    message;
+    status;
+    finishedAt;
+    /** Free-form data attached to the result. */
+    meta;
+    constructor(message, status, finishedAt) {
+        this.message = message;
+        this.status = status;
+        this.finishedAt = finishedAt;
+    }
+    /** A passing result. */
+    static ok(message) {
+        return new Result(message, 'ok', new Date());
+    }
+    static failed(message, error) {
+        const result = new Result(typeof message === 'string' ? message : message.message, 'error', new Date());
+        if (error)
+            result.setMetaData({ error });
+        if (typeof message !== 'string')
+            result.setMetaData({ error: message });
+        return result;
+    }
+    /** A result that is not yet failing but wants attention. */
+    static warning(message) {
+        return new Result(message, 'warning', new Date());
+    }
+    /** Override when the check finished. */
+    setFinishedAt(finishedAt) {
+        this.finishedAt = finishedAt;
+        return this;
+    }
+    /** Replace the meta-data wholesale. */
+    setMetaData(metaData) {
+        this.meta = metaData;
+        return this;
+    }
+    /** Shallow-merge into the existing meta-data. */
+    mergeMetaData(metaData) {
+        this.meta = { ...this.meta, ...metaData };
+        return this;
+    }
+    toJSON() {
+        return {
+            finishedAt: this.finishedAt,
+            message: this.message,
+            status: this.status,
+            ...(this.meta ? { meta: this.meta } : {}),
+        };
+    }
+}
+//# sourceMappingURL=Result.js.map

package/dist/health/Result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.js","sourceRoot":"","sources":["../../src/health/Result.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,MAAM;IACjB,OAAO,CAAQ;IACf,MAAM,CAA6B;IACnC,UAAU,CAAM;IAChB,6CAA6C;IAC7C,IAAI,CAA4B;IAEhC,YAAY,OAAe,EAAE,MAAmC,EAAE,UAAgB;QAChF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED,wBAAwB;IACxB,MAAM,CAAC,EAAE,CAAC,OAAe;QACvB,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC;IAKD,MAAM,CAAC,MAAM,CAAC,OAAuB,EAAE,KAAa;QAClD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EACvD,OAAO,EACP,IAAI,IAAI,EAAE,CACX,CAAA;QACD,IAAI,KAAK;YAAE,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACxC,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QACvE,OAAO,MAAM,CAAA;IACf,CAAC;IAED,4DAA4D;IAC5D,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,wCAAwC;IACxC,aAAa,CAAC,UAAgB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,uCAAuC;IACvC,WAAW,CAAC,QAAiC;QAC3C,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAA;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,iDAAiD;IACjD,aAAa,CAAC,QAAiC;QAC7C,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAA;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM;QACJ,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAA;IACH,CAAC;CACF"}

package/dist/health/checks/DiskSpaceCheck.d.ts

@@ -0,0 +1,29 @@
+import { BaseCheck } from '../BaseCheck.js';
+import type { HealthCheckResult } from '../types.js';
+/**
+ * Watches how full the disk is (AdonisJS `DiskSpaceCheck`).
+ *
+ * NAMED DEVIATION — upstream depends on the `check-disk-space` package, which
+ * shells out to `df` on POSIX and `wmic` on Windows. Ream reads Node's own
+ * `fs.statfs` instead: no dependency, no subprocess, and the same two numbers.
+ * `bavail` rather than `bfree` is deliberate — it is the space actually
+ * available to this process, which is what `df` reports and what an operator
+ * means by "free".
+ */
+export declare class DiskSpaceCheck extends BaseCheck {
+    #private;
+    name: string;
+    /** The mount point to measure. */
+    diskPath: string;
+    /** Warn once this percentage of the disk is used. */
+    warnWhenExceeds(valueInPercentage: number): this;
+    /** Fail once this percentage of the disk is used. */
+    failWhenExceeds(valueInPercentage: number): this;
+    /** Replace how the reading is taken, so a test can drive the thresholds. */
+    compute(callback: () => Promise<{
+        free: number;
+        size: number;
+    }>): this;
+    run(): Promise<HealthCheckResult>;
+}
+//# sourceMappingURL=DiskSpaceCheck.d.ts.map

package/dist/health/checks/DiskSpaceCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiskSpaceCheck.d.ts","sourceRoot":"","sources":["../../../src/health/checks/DiskSpaceCheck.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,SAAS;;IAQ3C,IAAI,SAAqB;IACzB,kCAAkC;IAClC,QAAQ,SAA8C;IAEtD,qDAAqD;IACrD,eAAe,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAKhD,qDAAqD;IACrD,eAAe,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAKhD,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAKhE,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAuBxC"}

package/dist/health/checks/DiskSpaceCheck.js

@@ -0,0 +1,58 @@
+import { statfs } from 'node:fs/promises';
+import { BaseCheck } from '../BaseCheck.js';
+import { Result } from '../Result.js';
+/**
+ * Watches how full the disk is (AdonisJS `DiskSpaceCheck`).
+ *
+ * NAMED DEVIATION — upstream depends on the `check-disk-space` package, which
+ * shells out to `df` on POSIX and `wmic` on Windows. Ream reads Node's own
+ * `fs.statfs` instead: no dependency, no subprocess, and the same two numbers.
+ * `bavail` rather than `bfree` is deliberate — it is the space actually
+ * available to this process, which is what `df` reports and what an operator
+ * means by "free".
+ */
+export class DiskSpaceCheck extends BaseCheck {
+    #warnThreshold = 75;
+    #failThreshold = 80;
+    #computeFn = async () => {
+        const stats = await statfs(this.diskPath);
+        return { free: Number(stats.bavail) * stats.bsize, size: Number(stats.blocks) * stats.bsize };
+    };
+    name = 'Disk space check';
+    /** The mount point to measure. */
+    diskPath = process.platform === 'win32' ? 'C:\\' : '/';
+    /** Warn once this percentage of the disk is used. */
+    warnWhenExceeds(valueInPercentage) {
+        this.#warnThreshold = valueInPercentage;
+        return this;
+    }
+    /** Fail once this percentage of the disk is used. */
+    failWhenExceeds(valueInPercentage) {
+        this.#failThreshold = valueInPercentage;
+        return this;
+    }
+    /** Replace how the reading is taken, so a test can drive the thresholds. */
+    compute(callback) {
+        this.#computeFn = callback;
+        return this;
+    }
+    async run() {
+        const { free, size } = await this.#computeFn();
+        const usedPercentage = Math.floor(((size - free) / size) * 100);
+        const metaData = {
+            sizeInPercentage: {
+                used: usedPercentage,
+                failureThreshold: this.#failThreshold,
+                warningThreshold: this.#warnThreshold,
+            },
+        };
+        if (usedPercentage >= this.#failThreshold) {
+            return Result.failed(`Disk usage is ${usedPercentage}%, which is above the threshold of ${this.#failThreshold}%`).mergeMetaData(metaData);
+        }
+        if (usedPercentage >= this.#warnThreshold) {
+            return Result.warning(`Disk usage is ${usedPercentage}%, which is above the threshold of ${this.#warnThreshold}%`).mergeMetaData(metaData);
+        }
+        return Result.ok('Disk usage is under defined thresholds').mergeMetaData(metaData);
+    }
+}
+//# sourceMappingURL=DiskSpaceCheck.js.map

package/dist/health/checks/DiskSpaceCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiskSpaceCheck.js","sourceRoot":"","sources":["../../../src/health/checks/DiskSpaceCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGrC;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,cAAc,GAAG,EAAE,CAAA;IACnB,cAAc,GAAG,EAAE,CAAA;IACnB,UAAU,GAAkD,KAAK,IAAI,EAAE;QACrE,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;IAC/F,CAAC,CAAA;IAED,IAAI,GAAG,kBAAkB,CAAA;IACzB,kCAAkC;IAClC,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAA;IAEtD,qDAAqD;IACrD,eAAe,CAAC,iBAAyB;QACvC,IAAI,CAAC,cAAc,GAAG,iBAAiB,CAAA;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qDAAqD;IACrD,eAAe,CAAC,iBAAyB;QACvC,IAAI,CAAC,cAAc,GAAG,iBAAiB,CAAA;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4EAA4E;IAC5E,OAAO,CAAC,QAAuD;QAC7D,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAA;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QAC9C,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAA;QAC/D,MAAM,QAAQ,GAAG;YACf,gBAAgB,EAAE;gBAChB,IAAI,EAAE,cAAc;gBACpB,gBAAgB,EAAE,IAAI,CAAC,cAAc;gBACrC,gBAAgB,EAAE,IAAI,CAAC,cAAc;aACtC;SACF,CAAA;QAED,IAAI,cAAc,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,OAAO,MAAM,CAAC,MAAM,CAClB,iBAAiB,cAAc,sCAAsC,IAAI,CAAC,cAAc,GAAG,CAC5F,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC3B,CAAC;QACD,IAAI,cAAc,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,OAAO,MAAM,CAAC,OAAO,CACnB,iBAAiB,cAAc,sCAAsC,IAAI,CAAC,cAAc,GAAG,CAC5F,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,wCAAwC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IACpF,CAAC;CACF"}

package/dist/health/checks/MemoryHeapCheck.d.ts

@@ -0,0 +1,21 @@
+import { BaseCheck } from '../BaseCheck.js';
+import type { HealthCheckResult } from '../types.js';
+/**
+ * Watches the V8 heap (AdonisJS `MemoryHeapCheck`).
+ */
+export declare class MemoryHeapCheck extends BaseCheck {
+    #private;
+    name: string;
+    /** Warn above this size — `'300 mb'` or a byte count. Clears any percentage. */
+    warnWhenExceeds(value: string | number): this;
+    /** Fail above this size. Clears any percentage. */
+    failWhenExceeds(value: string | number): this;
+    /** Warn above this share of the heap ceiling. Clears any byte threshold. */
+    warnWhenExceedsPercentage(valueInPercentage: number): this;
+    /** Fail above this share of the heap ceiling. Clears any byte threshold. */
+    failWhenExceedsPercentage(valueInPercentage: number): this;
+    /** Replace how the reading is taken, so a test can drive the thresholds. */
+    compute(callback: () => NodeJS.MemoryUsage): this;
+    run(): Promise<HealthCheckResult>;
+}
+//# sourceMappingURL=MemoryHeapCheck.d.ts.map

package/dist/health/checks/MemoryHeapCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryHeapCheck.d.ts","sourceRoot":"","sources":["../../../src/health/checks/MemoryHeapCheck.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;;IAO5C,IAAI,SAAsB;IAE1B,gFAAgF;IAChF,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7C,mDAAmD;IACnD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7C,4EAA4E;IAC5E,yBAAyB,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAO1D,4EAA4E;IAC5E,yBAAyB,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAO1D,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,WAAW,GAAG,IAAI;IAK3C,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAcxC"}

package/dist/health/checks/MemoryHeapCheck.js

@@ -0,0 +1,55 @@
+import v8 from 'node:v8';
+import { BaseCheck } from '../BaseCheck.js';
+import { assertPercentage, parseByteThreshold, runMemoryCheck } from './memory.js';
+/**
+ * Watches the V8 heap (AdonisJS `MemoryHeapCheck`).
+ */
+export class MemoryHeapCheck extends BaseCheck {
+    #warnThresholdBytes = 250 * 1024 ** 2;
+    #failThresholdBytes = 300 * 1024 ** 2;
+    #warnThresholdPercentage = null;
+    #failThresholdPercentage = null;
+    #computeFn = () => process.memoryUsage();
+    name = 'Memory heap check';
+    /** Warn above this size — `'300 mb'` or a byte count. Clears any percentage. */
+    warnWhenExceeds(value) {
+        this.#warnThresholdBytes = parseByteThreshold(value, 'warnWhenExceeds');
+        this.#warnThresholdPercentage = null;
+        return this;
+    }
+    /** Fail above this size. Clears any percentage. */
+    failWhenExceeds(value) {
+        this.#failThresholdBytes = parseByteThreshold(value, 'failWhenExceeds');
+        this.#failThresholdPercentage = null;
+        return this;
+    }
+    /** Warn above this share of the heap ceiling. Clears any byte threshold. */
+    warnWhenExceedsPercentage(valueInPercentage) {
+        assertPercentage(valueInPercentage, 'Warn');
+        this.#warnThresholdPercentage = valueInPercentage;
+        this.#warnThresholdBytes = null;
+        return this;
+    }
+    /** Fail above this share of the heap ceiling. Clears any byte threshold. */
+    failWhenExceedsPercentage(valueInPercentage) {
+        assertPercentage(valueInPercentage, 'Fail');
+        this.#failThresholdPercentage = valueInPercentage;
+        this.#failThresholdBytes = null;
+        return this;
+    }
+    /** Replace how the reading is taken, so a test can drive the thresholds. */
+    compute(callback) {
+        this.#computeFn = callback;
+        return this;
+    }
+    async run() {
+        const { heapUsed } = this.#computeFn();
+        return runMemoryCheck(heapUsed, {
+            warnBytes: this.#warnThresholdBytes,
+            failBytes: this.#failThresholdBytes,
+            warnPercentage: this.#warnThresholdPercentage,
+            failPercentage: this.#failThresholdPercentage,
+        }, { subject: 'Heap', ceilingKey: 'heapInBytes', ceilingName: 'maxHeapSize' }, () => v8.getHeapStatistics().heap_size_limit);
+    }
+}
+//# sourceMappingURL=MemoryHeapCheck.js.map

package/dist/health/checks/MemoryHeapCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryHeapCheck.js","sourceRoot":"","sources":["../../../src/health/checks/MemoryHeapCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAElF;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,mBAAmB,GAAkB,GAAG,GAAG,IAAI,IAAI,CAAC,CAAA;IACpD,mBAAmB,GAAkB,GAAG,GAAG,IAAI,IAAI,CAAC,CAAA;IACpD,wBAAwB,GAAkB,IAAI,CAAA;IAC9C,wBAAwB,GAAkB,IAAI,CAAA;IAC9C,UAAU,GAA6B,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;IAElE,IAAI,GAAG,mBAAmB,CAAA;IAE1B,gFAAgF;IAChF,eAAe,CAAC,KAAsB;QACpC,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;QACvE,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,mDAAmD;IACnD,eAAe,CAAC,KAAsB;QACpC,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;QACvE,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4EAA4E;IAC5E,yBAAyB,CAAC,iBAAyB;QACjD,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,wBAAwB,GAAG,iBAAiB,CAAA;QACjD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4EAA4E;IAC5E,yBAAyB,CAAC,iBAAyB;QACjD,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,wBAAwB,GAAG,iBAAiB,CAAA;QACjD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4EAA4E;IAC5E,OAAO,CAAC,QAAkC;QACxC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAA;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QACtC,OAAO,cAAc,CACnB,QAAQ,EACR;YACE,SAAS,EAAE,IAAI,CAAC,mBAAmB;YACnC,SAAS,EAAE,IAAI,CAAC,mBAAmB;YACnC,cAAc,EAAE,IAAI,CAAC,wBAAwB;YAC7C,cAAc,EAAE,IAAI,CAAC,wBAAwB;SAC9C,EACD,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,EAC1E,GAAG,EAAE,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,eAAe,CAC7C,CAAA;IACH,CAAC;CACF"}

package/dist/health/checks/MemoryRSSCheck.d.ts

@@ -0,0 +1,21 @@
+import { BaseCheck } from '../BaseCheck.js';
+import type { HealthCheckResult } from '../types.js';
+/**
+ * Watches the process' resident set size (AdonisJS `MemoryRSSCheck`).
+ */
+export declare class MemoryRSSCheck extends BaseCheck {
+    #private;
+    name: string;
+    /** Warn above this size — `'300 mb'` or a byte count. Clears any percentage. */
+    warnWhenExceeds(value: string | number): this;
+    /** Fail above this size. Clears any percentage. */
+    failWhenExceeds(value: string | number): this;
+    /** Warn above this share of total system memory. Clears any byte threshold. */
+    warnWhenExceedsPercentage(valueInPercentage: number): this;
+    /** Fail above this share of total system memory. Clears any byte threshold. */
+    failWhenExceedsPercentage(valueInPercentage: number): this;
+    /** Replace how the reading is taken, so a test can drive the thresholds. */
+    compute(callback: () => NodeJS.MemoryUsage): this;
+    run(): Promise<HealthCheckResult>;
+}
+//# sourceMappingURL=MemoryRSSCheck.d.ts.map

package/dist/health/checks/MemoryRSSCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryRSSCheck.d.ts","sourceRoot":"","sources":["../../../src/health/checks/MemoryRSSCheck.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpD;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;;IAO3C,IAAI,SAAqB;IAEzB,gFAAgF;IAChF,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7C,mDAAmD;IACnD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7C,+EAA+E;IAC/E,yBAAyB,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAO1D,+EAA+E;IAC/E,yBAAyB,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAO1D,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,WAAW,GAAG,IAAI;IAK3C,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAcxC"}

package/dist/health/checks/MemoryRSSCheck.js

@@ -0,0 +1,55 @@
+import os from 'node:os';
+import { BaseCheck } from '../BaseCheck.js';
+import { assertPercentage, parseByteThreshold, runMemoryCheck } from './memory.js';
+/**
+ * Watches the process' resident set size (AdonisJS `MemoryRSSCheck`).
+ */
+export class MemoryRSSCheck extends BaseCheck {
+    #warnThresholdBytes = 320 * 1024 ** 2;
+    #failThresholdBytes = 350 * 1024 ** 2;
+    #warnThresholdPercentage = null;
+    #failThresholdPercentage = null;
+    #computeFn = () => process.memoryUsage();
+    name = 'Memory RSS check';
+    /** Warn above this size — `'300 mb'` or a byte count. Clears any percentage. */
+    warnWhenExceeds(value) {
+        this.#warnThresholdBytes = parseByteThreshold(value, 'warnWhenExceeds');
+        this.#warnThresholdPercentage = null;
+        return this;
+    }
+    /** Fail above this size. Clears any percentage. */
+    failWhenExceeds(value) {
+        this.#failThresholdBytes = parseByteThreshold(value, 'failWhenExceeds');
+        this.#failThresholdPercentage = null;
+        return this;
+    }
+    /** Warn above this share of total system memory. Clears any byte threshold. */
+    warnWhenExceedsPercentage(valueInPercentage) {
+        assertPercentage(valueInPercentage, 'Warn');
+        this.#warnThresholdPercentage = valueInPercentage;
+        this.#warnThresholdBytes = null;
+        return this;
+    }
+    /** Fail above this share of total system memory. Clears any byte threshold. */
+    failWhenExceedsPercentage(valueInPercentage) {
+        assertPercentage(valueInPercentage, 'Fail');
+        this.#failThresholdPercentage = valueInPercentage;
+        this.#failThresholdBytes = null;
+        return this;
+    }
+    /** Replace how the reading is taken, so a test can drive the thresholds. */
+    compute(callback) {
+        this.#computeFn = callback;
+        return this;
+    }
+    async run() {
+        const { rss } = this.#computeFn();
+        return runMemoryCheck(rss, {
+            warnBytes: this.#warnThresholdBytes,
+            failBytes: this.#failThresholdBytes,
+            warnPercentage: this.#warnThresholdPercentage,
+            failPercentage: this.#failThresholdPercentage,
+        }, { subject: 'RSS', ceilingKey: 'memoryInBytes', ceilingName: 'totalSystemMemory' }, () => os.totalmem());
+    }
+}
+//# sourceMappingURL=MemoryRSSCheck.js.map

package/dist/health/checks/MemoryRSSCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryRSSCheck.js","sourceRoot":"","sources":["../../../src/health/checks/MemoryRSSCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAElF;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,mBAAmB,GAAkB,GAAG,GAAG,IAAI,IAAI,CAAC,CAAA;IACpD,mBAAmB,GAAkB,GAAG,GAAG,IAAI,IAAI,CAAC,CAAA;IACpD,wBAAwB,GAAkB,IAAI,CAAA;IAC9C,wBAAwB,GAAkB,IAAI,CAAA;IAC9C,UAAU,GAA6B,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;IAElE,IAAI,GAAG,kBAAkB,CAAA;IAEzB,gFAAgF;IAChF,eAAe,CAAC,KAAsB;QACpC,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;QACvE,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,mDAAmD;IACnD,eAAe,CAAC,KAAsB;QACpC,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;QACvE,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,+EAA+E;IAC/E,yBAAyB,CAAC,iBAAyB;QACjD,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,wBAAwB,GAAG,iBAAiB,CAAA;QACjD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,+EAA+E;IAC/E,yBAAyB,CAAC,iBAAyB;QACjD,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,wBAAwB,GAAG,iBAAiB,CAAA;QACjD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4EAA4E;IAC5E,OAAO,CAAC,QAAkC;QACxC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAA;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QACjC,OAAO,cAAc,CACnB,GAAG,EACH;YACE,SAAS,EAAE,IAAI,CAAC,mBAAmB;YACnC,SAAS,EAAE,IAAI,CAAC,mBAAmB;YACnC,cAAc,EAAE,IAAI,CAAC,wBAAwB;YAC7C,cAAc,EAAE,IAAI,CAAC,wBAAwB;SAC9C,EACD,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,EACjF,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CACpB,CAAA;IACH,CAAC;CACF"}

package/dist/health/checks/memory.d.ts

@@ -0,0 +1,24 @@
+import type { HealthCheckResult } from '../types.js';
+/**
+ * The shared body of the two memory checks.
+ *
+ * Upstream spells this logic out twice, once in `MemoryRSSCheck` and once in
+ * `MemoryHeapCheck`; only the reading, the ceiling it is compared against, and
+ * two strings differ. The public surface of both classes is unchanged — this is
+ * an internal detail, not a deviation.
+ */
+export type MemoryThresholds = {
+    warnBytes: number | null;
+    failBytes: number | null;
+    warnPercentage: number | null;
+    failPercentage: number | null;
+};
+export declare function runMemoryCheck(used: number, thresholds: MemoryThresholds, labels: {
+    subject: string;
+    ceilingKey: string;
+    ceilingName: string;
+}, readCeiling: () => number): HealthCheckResult;
+/** The threshold setters both memory checks expose, shared verbatim. */
+export declare function parseByteThreshold(value: string | number, method: string): number;
+export declare function assertPercentage(value: number, label: string): void;
+//# sourceMappingURL=memory.d.ts.map

package/dist/health/checks/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/health/checks/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,CAAA;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EACpE,WAAW,EAAE,MAAM,MAAM,GACxB,iBAAiB,CA8EnB;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGnE"}

package/dist/health/checks/memory.js

@@ -0,0 +1,88 @@
+import bytes from '../../helpers/bytes.js';
+import { Result } from '../Result.js';
+export function runMemoryCheck(used, thresholds, labels, readCeiling) {
+    const compareAsPercentage = thresholds.warnPercentage !== null || thresholds.failPercentage !== null;
+    let warnThreshold;
+    let failThreshold;
+    let valueToCompare;
+    let ceiling = null;
+    let usedPercentage = null;
+    if (compareAsPercentage) {
+        ceiling = readCeiling();
+        if (ceiling === 0) {
+            return Result.failed(`Cannot determine ${labels.ceilingName} (0 bytes).`).mergeMetaData({
+                [labels.ceilingKey]: { used, [labels.ceilingName]: ceiling },
+            });
+        }
+        usedPercentage = Math.floor((used / ceiling) * 100);
+        valueToCompare = usedPercentage;
+        if (thresholds.warnPercentage !== null)
+            warnThreshold = thresholds.warnPercentage;
+        else if (thresholds.warnBytes !== null)
+            warnThreshold = Math.floor((thresholds.warnBytes / ceiling) * 100);
+        else
+            return Result.failed('Warning threshold for percentage comparison is missing.');
+        if (thresholds.failPercentage !== null)
+            failThreshold = thresholds.failPercentage;
+        else if (thresholds.failBytes !== null)
+            failThreshold = Math.floor((thresholds.failBytes / ceiling) * 100);
+        else
+            return Result.failed('Failure threshold for percentage comparison is missing.');
+    }
+    else {
+        valueToCompare = used;
+        if (thresholds.warnBytes === null)
+            return Result.failed('Warning threshold (bytes) is missing.');
+        warnThreshold = thresholds.warnBytes;
+        if (thresholds.failBytes === null)
+            return Result.failed('Failure threshold (bytes) is missing.');
+        failThreshold = thresholds.failBytes;
+    }
+    const metaData = {};
+    if (compareAsPercentage) {
+        metaData.sizeInPercentage = {
+            used: usedPercentage,
+            failureThreshold: failThreshold,
+            warningThreshold: warnThreshold,
+        };
+        if (ceiling !== null) {
+            metaData[labels.ceilingKey] = {
+                used,
+                [labels.ceilingName]: ceiling,
+                failureThreshold: Math.floor((failThreshold / 100) * ceiling),
+                warningThreshold: Math.floor((warnThreshold / 100) * ceiling),
+            };
+        }
+    }
+    else {
+        metaData.memoryInBytes = {
+            used,
+            failureThreshold: failThreshold,
+            warningThreshold: warnThreshold,
+        };
+    }
+    const show = (value, threshold) => compareAsPercentage
+        ? { used: `${value}%`, limit: `${threshold}%` }
+        : { used: bytes.format(used), limit: bytes.format(threshold) };
+    if (valueToCompare >= failThreshold) {
+        const { used: u, limit } = show(valueToCompare, failThreshold);
+        return Result.failed(`${labels.subject} usage is ${u}, which is above the threshold of ${limit}`).mergeMetaData(metaData);
+    }
+    if (valueToCompare >= warnThreshold) {
+        const { used: u, limit } = show(valueToCompare, warnThreshold);
+        return Result.warning(`${labels.subject} usage is ${u}, which is above the threshold of ${limit}`).mergeMetaData(metaData);
+    }
+    return Result.ok(`${labels.subject} usage is under defined thresholds`).mergeMetaData(metaData);
+}
+/** The threshold setters both memory checks expose, shared verbatim. */
+export function parseByteThreshold(value, method) {
+    const parsed = bytes.parse(value);
+    if (parsed === null)
+        throw new Error(`Invalid byte value for ${method}: ${value}`);
+    return parsed;
+}
+export function assertPercentage(value, label) {
+    if (value < 0 || value > 100)
+        throw new Error(`${label} threshold percentage must be between 0 and 100.`);
+}
+//# sourceMappingURL=memory.js.map

package/dist/health/checks/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/health/checks/memory.ts"],"names":[],"mappings":"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"}

package/dist/health/index.d.ts

@@ -0,0 +1,9 @@
+export { BaseCheck } from './BaseCheck.js';
+export { DiskSpaceCheck } from './checks/DiskSpaceCheck.js';
+export { MemoryHeapCheck } from './checks/MemoryHeapCheck.js';
+export { MemoryRSSCheck } from './checks/MemoryRSSCheck.js';
+export { HealthChecks } from './HealthChecks.js';
+export { Result } from './Result.js';
+export * as tracingChannels from './tracing.js';
+export type { HealthCheckContract, HealthCheckReport, HealthCheckResult, HealthCheckTracingData, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,KAAK,eAAe,MAAM,cAAc,CAAA;AAC/C,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,YAAY,CAAA"}

package/dist/health/index.js

@@ -0,0 +1,8 @@
+export { BaseCheck } from './BaseCheck.js';
+export { DiskSpaceCheck } from './checks/DiskSpaceCheck.js';
+export { MemoryHeapCheck } from './checks/MemoryHeapCheck.js';
+export { MemoryRSSCheck } from './checks/MemoryRSSCheck.js';
+export { HealthChecks } from './HealthChecks.js';
+export { Result } from './Result.js';
+export * as tracingChannels from './tracing.js';
+//# sourceMappingURL=index.js.map

package/dist/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,KAAK,eAAe,MAAM,cAAc,CAAA"}

package/dist/health/tracing.d.ts

@@ -0,0 +1,12 @@
+import diagnostics_channel from 'node:diagnostics_channel';
+import type { HealthCheckTracingData } from './types.js';
+/**
+ * A diagnostics channel carrying every check run, so an APM can time checks
+ * without the app wiring anything.
+ *
+ * NAMED DEVIATION — the channel is `ream.health.check`, not upstream's
+ * `adonisjs.health.check`. A channel name is product identity, and a subscriber
+ * listening for both frameworks in one process must be able to tell them apart.
+ */
+export declare const healthCheck: diagnostics_channel.TracingChannel<"ream.health.check", HealthCheckTracingData>;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/health/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/health/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,iFAGF,CAAA"}

package/dist/health/tracing.js

@@ -0,0 +1,11 @@
+import diagnostics_channel from 'node:diagnostics_channel';
+/**
+ * A diagnostics channel carrying every check run, so an APM can time checks
+ * without the app wiring anything.
+ *
+ * NAMED DEVIATION — the channel is `ream.health.check`, not upstream's
+ * `adonisjs.health.check`. A channel name is product identity, and a subscriber
+ * listening for both frameworks in one process must be able to tell them apart.
+ */
+export const healthCheck = diagnostics_channel.tracingChannel('ream.health.check');
+//# sourceMappingURL=tracing.js.map

package/dist/health/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/health/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,MAAM,0BAA0B,CAAA;AAG1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC,cAAc,CAG3D,mBAAmB,CAAC,CAAA"}

package/dist/health/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Health-check contracts, mirroring `@adonisjs/core/health`.
+ */
+/** The outcome of running one check. */
+export type HealthCheckResult = {
+    /** A summary of the check result. */
+    message: string;
+    /** The status of the check. */
+    status: 'ok' | 'warning' | 'error';
+    /** When this check finished. */
+    finishedAt: Date;
+    /** Free-form data the check wants to expose alongside its verdict. */
+    meta?: Record<string, unknown>;
+};
+/** The report produced by running every registered check. */
+export type HealthCheckReport = {
+    /** False as soon as one check reports `error`. A warning stays healthy. */
+    isHealthy: boolean;
+    /** `error` beats `warning` beats `ok`. */
+    status: 'ok' | 'warning' | 'error';
+    /** When the whole report was computed. */
+    finishedAt: Date;
+    /** Identifying data for the process that produced the report. */
+    debugInfo: {
+        pid: number;
+        ppid?: number;
+        /** Seconds the process has been running. */
+        uptime: number;
+        version: string;
+        platform: string;
+    };
+    /** Each check's result, plus whether it came from the cache. */
+    checks: ({
+        isCached: boolean;
+        name: string;
+    } & HealthCheckResult)[];
+};
+/** What every check must implement. */
+export interface HealthCheckContract {
+    /** A unique name for the check. */
+    name: string;
+    /** Seconds to reuse a previous result for. Undefined means never cache. */
+    cacheDuration?: number;
+    /** Perform the check. */
+    run(): Promise<HealthCheckResult>;
+}
+/** What a tracing subscriber receives. */
+export type HealthCheckTracingData = {
+    check: HealthCheckContract;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/health/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/health/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAA;IAClC,gCAAgC;IAChC,UAAU,EAAE,IAAI,CAAA;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAA;IAClB,0CAA0C;IAC1C,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAA;IAClC,0CAA0C;IAC1C,UAAU,EAAE,IAAI,CAAA;IAChB,iEAAiE;IACjE,SAAS,EAAE;QACT,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,4CAA4C;QAC5C,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,gEAAgE;IAChE,MAAM,EAAE,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAAC,EAAE,CAAA;CACpE,CAAA;AAED,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yBAAyB;IACzB,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAClC;AAED,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,mBAAmB,CAAA;CAC3B,CAAA"}

package/dist/health/types.js

@@ -0,0 +1,5 @@
+/**
+ * Health-check contracts, mirroring `@adonisjs/core/health`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/health/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/health/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/helpers/bytes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Byte-size parsing and formatting, as `string.bytes` in AdonisJS.
+ *
+ * Upstream reaches for `@poppinss/string`, which wraps the `bytes` package.
+ * Ream carries the ~40 lines instead of the dependency, matching that package's
+ * semantics exactly: binary units (1 kb = 1024 b), a bare number string read as
+ * bytes, and `null` — never a throw — when the input cannot be read.
+ */
+/**
+ * Read a human-readable size into a number of bytes.
+ *
+ * A number passes through untouched. A string with no unit is read as bytes,
+ * so `'1024'` and `1024` agree. Returns `null` when there is no number to find.
+ */
+export declare function parse(value: string | number): number | null;
+/**
+ * Render a number of bytes for a human, picking the largest unit that leaves a
+ * value at or above 1. Returns `null` for a non-finite input.
+ */
+export declare function format(valueInBytes: number, options?: {
+    decimalPlaces?: number;
+}): string | null;
+declare const _default: {
+    parse: typeof parse;
+    format: typeof format;
+};
+export default _default;
+//# sourceMappingURL=bytes.d.ts.map

package/dist/helpers/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../src/helpers/bytes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAU3D;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAsBhG;;;;;AAED,wBAAgC"}