@c9up/ream 0.1.3

package/dist/helpers/string.js

@@ -0,0 +1,429 @@
+import { randomBytes } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Split an arbitrary-cased string into lowercase words.
+ * Handles camelCase, PascalCase, snake_case, kebab-case, and space-separated.
+ */
+function splitWords(s) {
+    return (s
+        // Insert space before uppercase letters that follow lowercase letters or digits
+        .replace(/([a-z\d])([A-Z])/g, '$1 $2')
+        // Insert space before uppercase letters followed by lowercase (handles "XMLParser" -> "XML Parser")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        // Replace non-alphanumeric separators with space
+        .replace(/[\s\-_]+/g, ' ')
+        .trim()
+        .toLowerCase()
+        .split(' ')
+        .filter((w) => w.length > 0));
+}
+// ---------------------------------------------------------------------------
+// Case conversion
+// ---------------------------------------------------------------------------
+/**
+ * Converts a string to camelCase.
+ * @example camelCase('user_name') // 'userName'
+ */
+export function camelCase(s) {
+    const words = splitWords(s);
+    return words.map((w, i) => (i === 0 ? w : w.charAt(0).toUpperCase() + w.slice(1))).join('');
+}
+/**
+ * Converts a string to snake_case.
+ * @example snakeCase('userName') // 'user_name'
+ */
+export function snakeCase(s) {
+    return splitWords(s).join('_');
+}
+/**
+ * Converts a string to PascalCase.
+ * @example pascalCase('user team') // 'UserTeam'
+ */
+export function pascalCase(s) {
+    return splitWords(s)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+}
+/**
+ * Converts a string to dash-case (kebab-case). Optionally capitalizes each segment.
+ * @example dashCase('helloWorld') // 'hello-world'
+ * @example dashCase('helloWorld', { capitalize: true }) // 'Hello-World'
+ */
+export function dashCase(s, options) {
+    const words = splitWords(s);
+    const segments = options?.capitalize
+        ? words.map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        : words;
+    return segments.join('-');
+}
+/**
+ * Converts a string to Title Case.
+ * @example titleCase('hello world') // 'Hello World'
+ */
+export function titleCase(s) {
+    return splitWords(s)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+/**
+ * Converts a snake_case/camelCase string to a human-readable form.
+ * @example humanize('user_name') // 'User name'
+ */
+export function humanize(s) {
+    const words = splitWords(s);
+    if (words.length === 0)
+        return '';
+    return [words[0]?.charAt(0).toUpperCase() + words[0]?.slice(1), ...words.slice(1)].join(' ');
+}
+// ---------------------------------------------------------------------------
+// Truncation / excerpt
+// ---------------------------------------------------------------------------
+/**
+ * Truncates a string to maxLength characters.
+ * @example truncate('Hello world', 8) // 'Hello wo...'
+ */
+export function truncate(text, maxLength, options) {
+    const suffix = options?.suffix !== undefined ? options.suffix : '...';
+    if (text.length <= maxLength)
+        return text;
+    const limit = maxLength - suffix.length;
+    if (limit <= 0)
+        return suffix.slice(0, maxLength);
+    if (options?.completeWords) {
+        const truncated = text.slice(0, limit);
+        const lastSpace = truncated.lastIndexOf(' ');
+        return (lastSpace > 0 ? truncated.slice(0, lastSpace) : truncated) + suffix;
+    }
+    return text.slice(0, limit) + suffix;
+}
+/**
+ * Strips HTML tags then truncates. See `truncate` for options.
+ * @example excerpt('<p>Hello world</p>', 8) // 'Hello wo...'
+ */
+export function excerpt(text, maxLength, options) {
+    const stripped = text.replace(/<[^>]*>/g, '');
+    return truncate(stripped, maxLength, options);
+}
+// ---------------------------------------------------------------------------
+// HTML / escaping
+// ---------------------------------------------------------------------------
+const HTML_ESCAPE_MAP = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+    '`': '&#96;',
+};
+/**
+ * Escapes HTML special characters. Optionally encodes non-ASCII characters as numeric entities.
+ * @example escapeHTML('<b>hi</b>') // '&lt;b&gt;hi&lt;/b&gt;'
+ */
+export function escapeHTML(text, options) {
+    let result = text.replace(/[&<>"'`]/g, (ch) => HTML_ESCAPE_MAP[ch] ?? ch);
+    if (options?.encodeSymbols) {
+        result = result.replace(/[\u0080-\uFFFF]/g, (ch) => {
+            const code = ch.codePointAt(0);
+            return code !== undefined ? `&#x${code.toString(16).toUpperCase()};` : ch;
+        });
+    }
+    return result;
+}
+/**
+ * Encodes only non-ASCII characters as &#xHEX; numeric entities.
+ * @example encodeSymbols('héllo') // 'h&#xE9;llo'
+ */
+export function encodeSymbols(text) {
+    return text.replace(/[\u0080-\uFFFF]/g, (ch) => {
+        const code = ch.codePointAt(0);
+        return code !== undefined ? `&#x${code.toString(16).toUpperCase()};` : ch;
+    });
+}
+// ---------------------------------------------------------------------------
+// Whitespace / checks
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if the string is empty or contains only whitespace.
+ * @example isEmpty('  ') // true
+ */
+export function isEmpty(value) {
+    return value.trim().length === 0;
+}
+/**
+ * Trims a string and collapses internal whitespace sequences to a single space.
+ * @example condenseWhitespace('  hello   world  ') // 'hello world'
+ */
+export function condenseWhitespace(s) {
+    return s.trim().replace(/\s+/g, ' ');
+}
+// ---------------------------------------------------------------------------
+// Slugs
+// ---------------------------------------------------------------------------
+/**
+ * Converts a string to a URL-friendly slug.
+ * @example slug('Hello World!') // 'hello-world'
+ */
+export function slug(text, options) {
+    const replacement = options?.replacement !== undefined ? options.replacement : '-';
+    const lower = options?.lower !== false;
+    const strict = options?.strict === true;
+    let result = lower ? text.toLowerCase() : text;
+    if (strict) {
+        result = result.replace(/[^a-zA-Z0-9\s]/g, '');
+    }
+    else {
+        result = result.replace(/[^\w\s-]/g, '');
+    }
+    result = result
+        .replace(/[\s_]+/g, replacement)
+        .replace(new RegExp(`${escapeForRegex(replacement)}+`, 'g'), replacement)
+        .replace(new RegExp(`^${escapeForRegex(replacement)}|${escapeForRegex(replacement)}$`, 'g'), '');
+    return result;
+}
+function escapeForRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+// ---------------------------------------------------------------------------
+// Pluralization
+// ---------------------------------------------------------------------------
+const IRREGULAR_PLURAL = {
+    person: 'people',
+    child: 'children',
+    foot: 'feet',
+    mouse: 'mice',
+    man: 'men',
+    woman: 'women',
+    tooth: 'teeth',
+    goose: 'geese',
+    ox: 'oxen',
+    leaf: 'leaves',
+    half: 'halves',
+    knife: 'knives',
+    life: 'lives',
+    wife: 'wives',
+    wolf: 'wolves',
+    loaf: 'loaves',
+    potato: 'potatoes',
+    tomato: 'tomatoes',
+    cactus: 'cacti',
+    focus: 'foci',
+    fungus: 'fungi',
+    nucleus: 'nuclei',
+    syllabus: 'syllabi',
+    analysis: 'analyses',
+    diagnosis: 'diagnoses',
+    oasis: 'oases',
+    thesis: 'theses',
+    crisis: 'crises',
+    phenomenon: 'phenomena',
+    criterion: 'criteria',
+    datum: 'data',
+};
+const IRREGULAR_SINGULAR = Object.fromEntries(Object.entries(IRREGULAR_PLURAL).map(([s, p]) => [p, s]));
+const UNCOUNTABLE = new Set([
+    'sheep',
+    'fish',
+    'deer',
+    'series',
+    'species',
+    'money',
+    'rice',
+    'information',
+    'equipment',
+    'aircraft',
+    'police',
+]);
+/**
+ * Returns the plural form of an English word.
+ * @example plural('person') // 'people'; plural('box') // 'boxes'
+ */
+export function plural(word) {
+    const lower = word.toLowerCase();
+    if (UNCOUNTABLE.has(lower))
+        return word;
+    const irregular = IRREGULAR_PLURAL[lower];
+    if (irregular)
+        return irregular;
+    if (/(?:s|x|z|ch|sh)$/i.test(word))
+        return `${word}es`;
+    if (/[^aeiou]y$/i.test(word))
+        return `${word.slice(0, -1)}ies`;
+    if (/f$/i.test(word))
+        return `${word.slice(0, -1)}ves`;
+    if (/fe$/i.test(word))
+        return `${word.slice(0, -2)}ves`;
+    return `${word}s`;
+}
+/**
+ * Returns the singular form of an English word.
+ * @example singular('people') // 'person'; singular('boxes') // 'box'
+ */
+export function singular(word) {
+    const lower = word.toLowerCase();
+    if (UNCOUNTABLE.has(lower))
+        return word;
+    const irregular = IRREGULAR_SINGULAR[lower];
+    if (irregular)
+        return irregular;
+    if (/ves$/i.test(word)) {
+        const base = word.slice(0, -3);
+        if (/[lw]$/i.test(base))
+            return `${base}f`;
+        return `${base}fe`;
+    }
+    if (/ies$/i.test(word))
+        return `${word.slice(0, -3)}y`;
+    if (/(?:s|x|z|ch|sh)es$/i.test(word))
+        return word.slice(0, -2);
+    if (/s$/i.test(word) && !/ss$/i.test(word))
+        return word.slice(0, -1);
+    return word;
+}
+/**
+ * Returns true if the word appears to be plural.
+ * @example isPlural('dogs') // true
+ */
+export function isPlural(word) {
+    const lower = word.toLowerCase();
+    if (UNCOUNTABLE.has(lower))
+        return true;
+    return lower !== singular(lower);
+}
+/**
+ * Returns true if the word appears to be singular.
+ * @example isSingular('dog') // true
+ */
+export function isSingular(word) {
+    const lower = word.toLowerCase();
+    if (UNCOUNTABLE.has(lower))
+        return true;
+    return singular(lower) === lower;
+}
+// ---------------------------------------------------------------------------
+// Random / numeric
+// ---------------------------------------------------------------------------
+/**
+ * Returns a base64url random string of exactly `length` characters.
+ * @example random(16) // e.g. 'Xk3mN9pQ2vR7tZ1w'
+ */
+export function random(length) {
+    const bytesNeeded = Math.ceil((length * 3) / 4) + 4;
+    return randomBytes(bytesNeeded).toString('base64url').slice(0, length);
+}
+/**
+ * Alias for `random`. Generates a base64url random string of `size` characters.
+ * @example generateRandom(16) // e.g. 'Xk3mN9pQ2vR7tZ1w'
+ */
+export function generateRandom(size) {
+    return random(size);
+}
+/**
+ * Returns the ordinal representation of a number.
+ * @example ordinal(1) // '1st'; ordinal(11) // '11th'; ordinal(22) // '22nd'
+ */
+export function ordinal(n) {
+    const abs = Math.abs(n);
+    const mod100 = abs % 100;
+    const mod10 = abs % 10;
+    if (mod100 >= 11 && mod100 <= 13)
+        return `${n}th`;
+    if (mod10 === 1)
+        return `${n}st`;
+    if (mod10 === 2)
+        return `${n}nd`;
+    if (mod10 === 3)
+        return `${n}rd`;
+    return `${n}th`;
+}
+// ---------------------------------------------------------------------------
+// Time / path
+// ---------------------------------------------------------------------------
+/**
+ * Formats an hrtime tuple to a human-readable string.
+ * @example prettyHrTime([0, 1234567]) // '1.235 ms'
+ * @example prettyHrTime([2, 500000000]) // '2.500 s'
+ */
+export function prettyHrTime(time) {
+    const [seconds, nanoseconds] = time;
+    const totalNs = seconds * 1e9 + nanoseconds;
+    const totalMs = totalNs / 1e6;
+    const totalS = totalNs / 1e9;
+    if (totalNs < 1e6) {
+        return `${(totalNs / 1e3).toFixed(3)} μs`;
+    }
+    if (totalMs < 1000) {
+        return `${totalMs.toFixed(3)} ms`;
+    }
+    if (totalS < 60) {
+        return `${totalS.toFixed(3)} s`;
+    }
+    const mins = Math.floor(totalS / 60);
+    const secs = totalS - mins * 60;
+    return `${mins}m ${secs.toFixed(0)}s`;
+}
+/**
+ * Converts Windows backslash paths to Unix forward slashes.
+ * @example toUnixSlash('C:\\foo\\bar') // 'C:/foo/bar'
+ */
+export function toUnixSlash(p) {
+    return p.replace(/\\/g, '/');
+}
+// ---------------------------------------------------------------------------
+// Templating
+// ---------------------------------------------------------------------------
+/**
+ * Interpolates `{{ key.path }}` placeholders in a template string using `data`.
+ * Escape with backslash: `\{{` outputs literal `{{`. Missing keys produce empty string.
+ *
+ * @example
+ * interpolate('Hello {{ user.name }}!', { user: { name: 'Alice' } }) // 'Hello Alice!'
+ */
+export function interpolate(template, data) {
+    return template.replace(/\\(\{\{[\s\S]*?\}\})|(\{\{\s*([\w.]+)\s*\}\})/g, (match, escaped, _full, path) => {
+        if (escaped !== undefined)
+            return escaped;
+        if (path === undefined)
+            return match;
+        const keys = path.split('.');
+        let current = data;
+        for (const key of keys) {
+            if (current === null || current === undefined || typeof current !== 'object') {
+                return '';
+            }
+            current = current[key];
+        }
+        return current !== null && current !== undefined ? String(current) : '';
+    });
+}
+// ---------------------------------------------------------------------------
+// Default export
+// ---------------------------------------------------------------------------
+const string = {
+    camelCase,
+    snakeCase,
+    pascalCase,
+    dashCase,
+    titleCase,
+    humanize,
+    truncate,
+    excerpt,
+    escapeHTML,
+    encodeSymbols,
+    isEmpty,
+    condenseWhitespace,
+    slug,
+    plural,
+    singular,
+    isPlural,
+    isSingular,
+    random,
+    generateRandom,
+    ordinal,
+    prettyHrTime,
+    toUnixSlash,
+    interpolate,
+};
+export default string;
+//# sourceMappingURL=string.js.map

package/dist/helpers/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/helpers/string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CACL,CAAC;QACC,gFAAgF;SAC/E,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC;QACtC,oGAAoG;SACnG,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;QAC1C,iDAAiD;SAChD,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAC/B,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,UAAU,CAAC,CAAC,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,OAAkC;IACpE,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IAC3B,MAAM,QAAQ,GAAG,OAAO,EAAE,UAAU;QAClC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,KAAK,CAAA;IACT,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,UAAU,CAAC,CAAC,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACjC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9F,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,SAAiB,EACjB,OAAsD;IAEtD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;IACrE,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAA;IACzC,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,CAAA;IACvC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IACjD,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QACtC,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QAC5C,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CAAA;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,CAAA;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,SAAiB,EACjB,OAAsD;IAEtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAC7C,OAAO,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;AAC/C,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,eAAe,GAA2B;IAC9C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;CACb,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAqC;IAC5E,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;IACzE,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;QAC3B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE;YACjD,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;YAC9B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAC3E,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;QAC9B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3E,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACtC,CAAC;AAED,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,IAAI,CAClB,IAAY,EACZ,OAAqE;IAErE,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAA;IAClF,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,KAAK,KAAK,CAAA;IACtC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAEvC,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAE9C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAA;IAChD,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,GAAG,MAAM;SACZ,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;SAC/B,OAAO,CAAC,IAAI,MAAM,CAAC,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,WAAW,CAAC;SACxE,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,cAAc,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;IAElG,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,gBAAgB,GAA2B;IAC/C,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,MAAM;CACd,CAAA;AAED,MAAM,kBAAkB,GAA2B,MAAM,CAAC,WAAW,CACnE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACzD,CAAA;AAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,OAAO;IACP,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,OAAO;IACP,MAAM;IACN,aAAa;IACb,WAAW;IACX,UAAU;IACV,QAAQ;CACT,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAChC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAA;IAC/B,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,IAAI,CAAA;IACtD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IAC9D,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IACtD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IACvD,OAAO,GAAG,IAAI,GAAG,CAAA;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAChC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC3C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAA;IAC/B,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC9B,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,GAAG,IAAI,GAAG,CAAA;QAC1C,OAAO,GAAG,IAAI,IAAI,CAAA;IACpB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;IACtD,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9D,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACpE,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAChC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,OAAO,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAChC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,CAAA;AAClC,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;IACnD,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACvB,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAA;IACxB,MAAM,KAAK,GAAG,GAAG,GAAG,EAAE,CAAA;IACtB,IAAI,MAAM,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC,IAAI,CAAA;IACjD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,IAAI,CAAA;IAChC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,IAAI,CAAA;IAChC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,IAAI,CAAA;IAChC,OAAO,GAAG,CAAC,IAAI,CAAA;AACjB,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAsB;IACjD,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,IAAI,CAAA;IACnC,MAAM,OAAO,GAAG,OAAO,GAAG,GAAG,GAAG,WAAW,CAAA;IAC3C,MAAM,OAAO,GAAG,OAAO,GAAG,GAAG,CAAA;IAC7B,MAAM,MAAM,GAAG,OAAO,GAAG,GAAG,CAAA;IAE5B,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;IAC3C,CAAC;IACD,IAAI,OAAO,GAAG,IAAI,EAAE,CAAC;QACnB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;IACnC,CAAC;IACD,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QAChB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IACjC,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,EAAE,CAAA;IAC/B,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,IAA6B;IACzE,OAAO,QAAQ,CAAC,OAAO,CACrB,gDAAgD,EAChD,CAAC,KAAK,EAAE,OAA2B,EAAE,KAAyB,EAAE,IAAwB,EAAE,EAAE;QAC1F,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAA;QACzC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAA;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC5B,IAAI,OAAO,GAAY,IAAI,CAAA;QAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7E,OAAO,EAAE,CAAA;YACX,CAAC;YACD,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAA;QACrD,CAAC;QACD,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACzE,CAAC,CACF,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,MAAM,GAAG;IACb,SAAS;IACT,SAAS;IACT,UAAU;IACV,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,UAAU;IACV,aAAa;IACb,OAAO;IACP,kBAAkB;IAClB,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,MAAM;IACN,cAAc;IACd,OAAO;IACP,YAAY;IACZ,WAAW;IACX,WAAW;CACZ,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/helpers/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * TypeScript type helpers — utility types for the Ream framework.
+ * Pattern aligned with @adonisjs/core/helpers/types.
+ */
+/** Infer route parameters from a route pattern string. */
+export type InferRouteParams<T extends string> = T extends `${string}:${infer Param}/${infer Rest}` ? {
+    [K in Param | keyof InferRouteParams<`/${Rest}`>]: string;
+} : T extends `${string}:${infer Param}` ? {
+    [K in Param]: string;
+} : Record<string, never>;
+/** Accept a single value or an array. */
+export type OneOrMore<T> = T | T[];
+/** Create a nominal/opaque type from a base type. */
+export type Opaque<Base, Tag extends string> = Base & {
+    readonly __tag: Tag;
+};
+/** Unwrap an opaque type back to its base. */
+export type UnwrapOpaque<T> = T extends Opaque<infer Base, string> ? Base : T;
+/** Accept sync or async values. */
+export type AsyncOrSync<T> = T | Promise<T>;
+/** Constructor type. */
+export type Constructor<T = unknown, Args extends unknown[] = unknown[]> = new (...args: Args) => T;
+/** Abstract constructor type. */
+export type AbstractConstructor<T = unknown> = abstract new (...args: unknown[]) => T;
+/** Extract only function property keys from a type, optionally excluding inherited ones. */
+export type ExtractFunctions<T, Ignore extends keyof T = never> = {
+    [K in Exclude<keyof T, Ignore>]: T[K] extends (...args: unknown[]) => unknown ? K : never;
+}[Exclude<keyof T, Ignore>];
+/** Prettify a type intersection for better IDE display. */
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Extract keys whose value type may be undefined. */
+export type ExtractUndefined<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? K : never;
+}[keyof T];
+/** Extract keys whose value type cannot be undefined. */
+export type ExtractDefined<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? never : K;
+}[keyof T];
+/** Lazy module import — `() => import('module')` returning a default export. */
+export type LazyImport<T> = () => Promise<{
+    default: T;
+}>;
+/** Unwrap the default export from a LazyImport type. */
+export type UnWrapLazyImport<T> = T extends LazyImport<infer U> ? U : T;
+/** Unwrap a Promise type to its resolved value. */
+export type UnwrapPromise<T> = T extends Promise<infer U> ? U : T;
+/** Make specific keys optional. */
+export type MakeOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/** Make specific keys required. */
+export type MakeRequired<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/** Make specific keys nullable. */
+export type MakeNullable<T, K extends keyof T> = Omit<T, K> & {
+    [P in K]: T[P] | null;
+};
+/** Recursively make all properties optional. */
+export type DeepPartial<T> = T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/** Recursively make all properties required. */
+export type DeepRequired<T> = T extends object ? {
+    [K in keyof T]-?: DeepRequired<T[K]>;
+} : T;
+/** Recursively make all properties readonly. */
+export type DeepReadonly<T> = T extends object ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
+/** An object with no properties (different from `{}` which accepts anything). */
+export type EmptyObject = Record<string, never>;
+/** Extract keys whose value matches a given type. */
+export type ExtractKeysOfType<T, V> = {
+    [K in keyof T]: T[K] extends V ? K : never;
+}[keyof T];
+/** All-of: every member of the union must satisfy. */
+export type AllOf<T extends readonly unknown[]> = T extends readonly [infer Head, ...infer Tail] ? Head & AllOf<Tail> : unknown;
+/** None-of: a value that does not match any of the given types. */
+export type NoneOf<T, Excluded> = T extends Excluded ? never : T;
+/** Type guard signature: `(value: unknown) => value is T`. */
+export type TypeGuard<T> = (value: unknown) => value is T;
+/** Brand a primitive with a tag for nominal typing (alias for Opaque, AdonisJS naming). */
+export type Brand<Base, Tag extends string> = Opaque<Base, Tag>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/helpers/types.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript type helpers — utility types for the Ream framework.
+ * Pattern aligned with @adonisjs/core/helpers/types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/helpers/types.js.map

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

package/dist/http/Exception.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Exception system — AdonisJS-compatible exception handling.
+ *
+ * - Exception: base class with self-handling support
+ * - ExceptionHandler: global exception handler with content negotiation
+ * - Built-in E_* exceptions
+ */
+import type { HttpContext } from './HttpContext.js';
+/**
+ * Base exception class. Extend this to create self-handling exceptions.
+ *
+ * Usage:
+ *   throw new Exception('Something went wrong', { status: 400, code: 'E_BAD_REQUEST' })
+ *
+ * Self-handled exception:
+ *   class PaymentFailed extends Exception {
+ *     static status = 402
+ *     static code = 'E_PAYMENT_FAILED'
+ *     async handle(error: this, ctx: HttpContext) {
+ *       ctx.response.status(402).json({ error: 'Payment failed' })
+ *     }
+ *     async report(error: this, ctx: HttpContext) {
+ *       logger.error('Payment failed', { userId: ctx.auth.user?.id })
+ *     }
+ *   }
+ */
+export declare class Exception extends Error {
+    static status: number;
+    static code: string;
+    status: number;
+    code: string;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+    });
+    /** Override to self-handle the exception (convert to HTTP response). */
+    handle?(error: this, ctx: HttpContext): Promise<void> | void;
+    /** Override to report the exception (logging, monitoring). Never send HTTP from here. */
+    report?(error: this, ctx: HttpContext): Promise<void> | void;
+}
+export declare class E_ROUTE_NOT_FOUND extends Exception {
+    static status: number;
+    static code: string;
+    constructor(method: string, path: string);
+}
+export declare class E_UNAUTHORIZED extends Exception {
+    static status: number;
+    static code: string;
+    constructor(message?: string);
+    handle(_error: this, ctx: HttpContext): void;
+}
+export declare class E_FORBIDDEN extends Exception {
+    static status: number;
+    static code: string;
+    required?: string[];
+    constructor(message?: string, required?: string[]);
+    handle(_error: this, ctx: HttpContext): void;
+}
+export declare class E_VALIDATION_ERROR extends Exception {
+    static status: number;
+    static code: string;
+    errors: unknown[];
+    constructor(errors: unknown[]);
+    handle(_error: this, ctx: HttpContext): void;
+}
+export declare class E_ROW_NOT_FOUND extends Exception {
+    static status: number;
+    static code: string;
+    constructor(model?: string);
+    handle(_error: this, ctx: HttpContext): void;
+}
+export declare class E_HTTP_EXCEPTION extends Exception {
+    constructor(message: string, status: number);
+}
+/**
+ * Global exception handler — catches all unhandled exceptions and converts
+ * them to HTTP responses.
+ *
+ * Extend this in your app:
+ *   export default class Handler extends ExceptionHandler {
+ *     protected debug = app.inDev
+ *     protected ignoreStatuses = [400, 401, 404, 422]
+ *   }
+ *
+ * Flow:
+ * 1. If exception has handle() → self-handled (bypass global)
+ * 2. Else → this.handle() → content negotiation (JSON or HTML)
+ * 3. Then → this.report() → logging/monitoring
+ */
+export declare class ExceptionHandler {
+    #private;
+    protected debug: boolean;
+    protected ignoreStatuses: number[];
+    protected ignoreCodes: string[];
+    constructor(debug?: boolean);
+    /** Convert an exception to an HTTP response. */
+    handle(error: unknown, ctx: HttpContext): Promise<void>;
+    /** Log/report an exception. Override for custom monitoring. */
+    report(error: unknown, ctx: HttpContext): Promise<void>;
+    /** Provide additional context for error reports. Override for custom data. */
+    protected context(ctx: HttpContext): Record<string, unknown>;
+}
+//# sourceMappingURL=Exception.d.ts.map

package/dist/http/Exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Exception.d.ts","sourceRoot":"","sources":["../../src/http/Exception.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,MAAM,CAAC,MAAM,SAAM;IACnB,MAAM,CAAC,IAAI,SAAc;IAEzB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;gBAEA,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IASzE,wEAAwE;IACxE,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAE5D,yFAAyF;IACzF,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAC7D;AAID,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAsB;gBAE9B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAGzC;AAED,qBAAa,cAAe,SAAQ,SAAS;IAC3C,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAmB;gBAE3B,OAAO,SAA4B;IAItC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;CAGtD;AAED,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAgB;IAEpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;gBAEP,OAAO,SAA6B,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE;IAK5D,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;CAStD;AAED,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAuB;IAE3C,MAAM,EAAE,OAAO,EAAE,CAAA;gBAEL,MAAM,EAAE,OAAO,EAAE;IAKpB,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;CAGtD;AAED,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAoB;gBAE5B,KAAK,CAAC,EAAE,MAAM;IAOjB,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;CAGtD;AAED,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAG5C;AAID;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;;IAC3B,SAAS,CAAC,KAAK,EAAE,OAAO,CAAA;IACxB,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,CAAuB;IACzD,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAK;gBAExB,KAAK,UAAQ;IAIzB,gDAAgD;IAC1C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C7D,+DAA+D;IACzD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7D,8EAA8E;IAC9E,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQ7D"}