dominion-cli 0.1.0

package/dist/lib/dns-validation.js

@@ -0,0 +1,185 @@
+/**
+ * DNS record input validation.
+ *
+ * Validates record type, host format, and answer format per record type.
+ * Warns (but does not block) on common conflict patterns.
+ *
+ * Type validation uses the DnsRecordTypeSchema from schemas.ts.
+ * Answer validation is type-specific:
+ * - A: IPv4 address
+ * - AAAA: IPv6 address
+ * - CNAME/MX/NS/SRV/ANAME: hostname
+ * - TXT: any string
+ * - URL: valid URL
+ */
+/** Valid DNS record types for the CLI. */
+const VALID_TYPES = [
+    "A",
+    "AAAA",
+    "ANAME",
+    "CNAME",
+    "MX",
+    "NS",
+    "SRV",
+    "TXT",
+    "URL",
+];
+/** Default TTL in seconds (matches web app's DEFAULT_TTL). */
+export const DEFAULT_TTL = 300;
+/** Min / max TTL allowed by Name.com. */
+export const MIN_TTL = 300;
+export const MAX_TTL = 604800; // 7 days
+// ─── Regex patterns ──────────────────────────────────────────────────────────
+const IPV4_REGEX = /^(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?)$/;
+const IPV6_REGEX = /^(?:[a-fA-F0-9]{1,4}:){7}[a-fA-F0-9]{1,4}$|^::(?:[a-fA-F0-9]{1,4}:){0,5}[a-fA-F0-9]{1,4}$|^[a-fA-F0-9]{1,4}::(?:[a-fA-F0-9]{1,4}:){0,4}[a-fA-F0-9]{1,4}$|^(?:[a-fA-F0-9]{1,4}:){1,2}:(?:[a-fA-F0-9]{1,4}:){0,3}[a-fA-F0-9]{1,4}$|^(?:[a-fA-F0-9]{1,4}:){1,3}:(?:[a-fA-F0-9]{1,4}:){0,2}[a-fA-F0-9]{1,4}$|^(?:[a-fA-F0-9]{1,4}:){1,4}:(?:[a-fA-F0-9]{1,4}:)?[a-fA-F0-9]{1,4}$|^(?:[a-fA-F0-9]{1,4}:){1,5}:[a-fA-F0-9]{1,4}$|^(?:[a-fA-F0-9]{1,4}:){1,6}:$/;
+const HOSTNAME_REGEX = /^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)*[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.?$/;
+// ─── Validators ──────────────────────────────────────────────────────────────
+/**
+ * Validate that a string is a valid DNS record type.
+ */
+export function validateType(type) {
+    const upper = type.toUpperCase();
+    const errors = [];
+    const warnings = [];
+    if (!VALID_TYPES.includes(upper)) {
+        errors.push(`Invalid DNS record type "${type}". Valid types: ${VALID_TYPES.join(", ")}`);
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Validate the host/name field for a DNS record.
+ */
+export function validateHost(host) {
+    const errors = [];
+    const warnings = [];
+    if (host.startsWith(".")) {
+        errors.push("Host must not start with a leading dot. Use '@' for the root domain or a bare subdomain name.");
+    }
+    if (host.length > 253) {
+        errors.push("Host name exceeds maximum length of 253 characters.");
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Validate the answer/value field based on the record type.
+ */
+export function validateAnswer(type, answer) {
+    const errors = [];
+    const warnings = [];
+    switch (type) {
+        case "A":
+            if (!IPV4_REGEX.test(answer)) {
+                errors.push(`Invalid IPv4 address "${answer}". Expected format: 192.168.1.1`);
+            }
+            break;
+        case "AAAA":
+            if (!IPV6_REGEX.test(answer)) {
+                errors.push(`Invalid IPv6 address "${answer}". Expected format: 2001:db8::1`);
+            }
+            break;
+        case "CNAME":
+        case "MX":
+        case "NS":
+        case "ANAME":
+            if (!HOSTNAME_REGEX.test(answer)) {
+                errors.push(`Invalid hostname "${answer}". Expected a valid domain name.`);
+            }
+            break;
+        case "SRV":
+            // SRV answer format: priority weight port target
+            // But Name.com may accept just the target — be lenient
+            if (!HOSTNAME_REGEX.test(answer) && !/^\d+\s+\d+\s+\d+\s+\S+$/.test(answer)) {
+                warnings.push(`SRV answer "${answer}" may not be in expected format. Typical: <weight> <port> <target>`);
+            }
+            break;
+        case "TXT":
+            // TXT can be any string
+            if (answer.length === 0) {
+                errors.push("TXT record value cannot be empty.");
+            }
+            break;
+        case "URL":
+            try {
+                new URL(answer);
+            }
+            catch {
+                errors.push(`Invalid URL "${answer}". Expected a valid URL (e.g. https://example.com).`);
+            }
+            break;
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Validate TTL value.
+ */
+export function validateTtl(ttl) {
+    const errors = [];
+    const warnings = [];
+    if (!Number.isInteger(ttl)) {
+        errors.push("TTL must be an integer.");
+    }
+    else if (ttl < MIN_TTL) {
+        errors.push(`TTL must be at least ${MIN_TTL} seconds (5 minutes).`);
+    }
+    else if (ttl > MAX_TTL) {
+        errors.push(`TTL must be at most ${MAX_TTL} seconds (7 days).`);
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Validate priority (for MX and SRV records).
+ */
+export function validatePriority(type, priority) {
+    const errors = [];
+    const warnings = [];
+    if (type === "MX" || type === "SRV") {
+        if (priority === undefined || priority === null) {
+            warnings.push(`${type} records typically require a priority value. Defaulting to 10.`);
+        }
+        else if (!Number.isInteger(priority) || priority < 0 || priority > 65535) {
+            errors.push("Priority must be an integer between 0 and 65535.");
+        }
+    }
+    else if (priority !== undefined) {
+        warnings.push(`Priority is only used for MX and SRV records. It will be ignored for ${type} records.`);
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Full validation of a DNS record input.
+ * Returns combined results from all individual validators.
+ */
+export function validateDnsRecordInput(type, host, answer, ttl, priority) {
+    const allErrors = [];
+    const allWarnings = [];
+    // Type validation
+    const typeResult = validateType(type);
+    allErrors.push(...typeResult.errors);
+    allWarnings.push(...typeResult.warnings);
+    // Host validation
+    const hostResult = validateHost(host);
+    allErrors.push(...hostResult.errors);
+    allWarnings.push(...hostResult.warnings);
+    // Answer validation (only if type is valid)
+    if (typeResult.valid) {
+        const answerResult = validateAnswer(type.toUpperCase(), answer);
+        allErrors.push(...answerResult.errors);
+        allWarnings.push(...answerResult.warnings);
+        // Priority validation
+        const priorityResult = validatePriority(type.toUpperCase(), priority);
+        allErrors.push(...priorityResult.errors);
+        allWarnings.push(...priorityResult.warnings);
+    }
+    // TTL validation
+    if (ttl !== undefined) {
+        const ttlResult = validateTtl(ttl);
+        allErrors.push(...ttlResult.errors);
+        allWarnings.push(...ttlResult.warnings);
+    }
+    return {
+        valid: allErrors.length === 0,
+        errors: allErrors,
+        warnings: allWarnings,
+    };
+}
+//# sourceMappingURL=dns-validation.js.map

package/dist/lib/dns-validation.js.map

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

package/dist/lib/easter-eggs.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Easter egg detection for special domain searches.
+ *
+ * Certain domain names trigger fun pop-culture references
+ * in the search results display.
+ */
+export interface EasterEgg {
+    domain: string;
+    message: string;
+    color: string;
+}
+/**
+ * Check if a search query matches any easter egg domains.
+ * Checks both exact domain matches and keyword-based matches.
+ */
+export declare function findEasterEgg(query: string): EasterEgg | null;
+/**
+ * Get all registered easter egg domains for testing.
+ */
+export declare function getAllEasterEggs(): EasterEgg[];
+//# sourceMappingURL=easter-eggs.d.ts.map

package/dist/lib/easter-eggs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easter-eggs.d.ts","sourceRoot":"","sources":["../../src/lib/easter-eggs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAmCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgB7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAE9C"}

package/dist/lib/easter-eggs.js

@@ -0,0 +1,64 @@
+/**
+ * Easter egg detection for special domain searches.
+ *
+ * Certain domain names trigger fun pop-culture references
+ * in the search results display.
+ */
+const EASTER_EGGS = {
+    "skynet.ai": {
+        domain: "skynet.ai",
+        message: "I'll be back... and so will this domain. Judgment Day approaches.",
+        color: "red",
+    },
+    "delorean.io": {
+        domain: "delorean.io",
+        message: "Great Scott! Where we're going, we don't need roads... but we do need DNS.",
+        color: "yellow",
+    },
+    "hal9000.com": {
+        domain: "hal9000.com",
+        message: "I'm sorry, Dave. I'm afraid I can't let you register that domain.",
+        color: "red",
+    },
+    "winterfell.io": {
+        domain: "winterfell.io",
+        message: "Winter is coming... and so is your domain renewal.",
+        color: "cyan",
+    },
+    "hogwarts.edu": {
+        domain: "hogwarts.edu",
+        message: "You're a webmaster, Harry.",
+        color: "magenta",
+    },
+    "matrix.io": {
+        domain: "matrix.io",
+        message: "There is no domain. Only the one who frees their mind can see the DNS.",
+        color: "green",
+    },
+};
+/**
+ * Check if a search query matches any easter egg domains.
+ * Checks both exact domain matches and keyword-based matches.
+ */
+export function findEasterEgg(query) {
+    // Check exact domain match
+    const normalized = query.toLowerCase().trim();
+    if (EASTER_EGGS[normalized]) {
+        return EASTER_EGGS[normalized];
+    }
+    // Check if the query (without TLD) matches the SLD of any easter egg
+    for (const [domain, egg] of Object.entries(EASTER_EGGS)) {
+        const sld = domain.split(".")[0];
+        if (normalized === sld || normalized.startsWith(`${sld}.`)) {
+            return egg;
+        }
+    }
+    return null;
+}
+/**
+ * Get all registered easter egg domains for testing.
+ */
+export function getAllEasterEggs() {
+    return Object.values(EASTER_EGGS);
+}
+//# sourceMappingURL=easter-eggs.js.map

package/dist/lib/easter-eggs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"easter-eggs.js","sourceRoot":"","sources":["../../src/lib/easter-eggs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,GAA8B;IAC7C,WAAW,EAAE;QACX,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,KAAK;KACb;IACD,aAAa,EAAE;QACb,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,4EAA4E;QACrF,KAAK,EAAE,QAAQ;KAChB;IACD,aAAa,EAAE;QACb,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,KAAK;KACb;IACD,eAAe,EAAE;QACf,MAAM,EAAE,eAAe;QACvB,OAAO,EAAE,oDAAoD;QAC7D,KAAK,EAAE,MAAM;KACd;IACD,cAAc,EAAE;QACd,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,4BAA4B;QACrC,KAAK,EAAE,SAAS;KACjB;IACD,WAAW,EAAE;QACX,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,wEAAwE;QACjF,KAAK,EAAE,OAAO;KACf;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,2BAA2B;IAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;YAC3D,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC"}

package/dist/lib/error-personality.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Error personality — character messages + ASCII art for each DomainErrorCode.
+ *
+ * Every error code gets a personality: an icon, a witty "character" message,
+ * and a practical suggestion for what to do next. Displayed by ErrorDisplay.
+ */
+import type { DomainErrorCode } from "./types.js";
+export interface ErrorPersonality {
+    /** The DomainErrorCode this personality applies to */
+    code: DomainErrorCode;
+    /** Short icon/emoji for inline display */
+    icon: string;
+    /** Witty character message */
+    characterMessage: string;
+    /** Practical next-step suggestion */
+    suggestion: string;
+    /** ASCII art (optional, shown in full error display) */
+    art?: string;
+    /** Ink color name for the error display border */
+    color: string;
+}
+/**
+ * Get the personality for a given DomainErrorCode.
+ */
+export declare function getErrorPersonality(code: DomainErrorCode): ErrorPersonality;
+/**
+ * Get all error personalities (for testing / enumeration).
+ */
+export declare function getAllPersonalities(): ErrorPersonality[];
+/**
+ * Try to match a generic Error to a DomainErrorCode personality.
+ * Falls back to API_ERROR if the error doesn't have a recognized code.
+ */
+export declare function inferPersonality(error: unknown): ErrorPersonality;
+//# sourceMappingURL=error-personality.d.ts.map

package/dist/lib/error-personality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-personality.d.ts","sourceRoot":"","sources":["../../src/lib/error-personality.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA+ElD,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,IAAI,EAAE,eAAe,CAAC;IACtB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAuGD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,gBAAgB,CAE3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,EAAE,CAExD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAajE"}

package/dist/lib/error-personality.js

@@ -0,0 +1,191 @@
+/**
+ * Error personality — character messages + ASCII art for each DomainErrorCode.
+ *
+ * Every error code gets a personality: an icon, a witty "character" message,
+ * and a practical suggestion for what to do next. Displayed by ErrorDisplay.
+ */
+// ─── ASCII Art Fragments ─────────────────────────────────────────────────────
+const LOCK_ART = `
+    .--------.
+    / .------. \\
+   / /        \\ \\
+   | |        | |
+   | |   🔒   | |
+   \\ \\        / /
+    \\ '------' /
+     '--------'
+`;
+const HOURGLASS_ART = `
+     _____
+    |     |
+    |     |
+     \\   /
+      \\ /
+      / \\
+     /   \\
+    |     |
+    |_____|
+`;
+const MAGNIFY_ART = `
+       _____
+      /     \\
+     |       |
+     |   ?   |
+      \\_____/
+          \\
+           \\
+`;
+const BROKEN_PIPE_ART = `
+     ___     ___
+    |   |   |   |
+    |   |   |   |
+    |   |~~~|   |
+    |   |   |   |
+    |___|   |___|
+`;
+const SHIELD_ART = `
+      /|\\
+     / | \\
+    /  |  \\
+   /   |   \\
+  /    |    \\
+ /_____|_____\\
+ \\     |     /
+  \\    |    /
+   \\   |   /
+    \\  |  /
+     \\ | /
+      \\|/
+`;
+const EXPLOSION_ART = `
+      . * .
+    *  .*.  *
+   .  * . *  .
+    *  .*.  *
+      . * .
+`;
+const WARNING_ART = `
+        /\\
+       /  \\
+      / ⚠  \\
+     /      \\
+    /________\\
+`;
+const PERSONALITIES = {
+    AUTH_ERROR: {
+        code: "AUTH_ERROR",
+        icon: "🔒",
+        characterMessage: "The gates are sealed.",
+        suggestion: "Check your Name.com API username and token at https://www.name.com/account/api",
+        art: LOCK_ART,
+        color: "red",
+    },
+    RATE_LIMITED: {
+        code: "RATE_LIMITED",
+        icon: "⌛",
+        characterMessage: "The domain gods need a moment.",
+        suggestion: "You've hit the Name.com rate limit. Wait a few seconds and try again.",
+        art: HOURGLASS_ART,
+        color: "yellow",
+    },
+    DOMAIN_NOT_FOUND: {
+        code: "DOMAIN_NOT_FOUND",
+        icon: "🔍",
+        characterMessage: "Lost in the DNS wilderness.",
+        suggestion: "Double-check the domain name. It may not exist in your account, or it could be a typo.",
+        art: MAGNIFY_ART,
+        color: "yellow",
+    },
+    DOMAIN_NOT_AVAILABLE: {
+        code: "DOMAIN_NOT_AVAILABLE",
+        icon: "🚫",
+        characterMessage: "Someone beat you to it.",
+        suggestion: "This domain is already registered. Try a different name or TLD, or check back later.",
+        art: SHIELD_ART,
+        color: "red",
+    },
+    REGISTRATION_FAILED: {
+        code: "REGISTRATION_FAILED",
+        icon: "💥",
+        characterMessage: "The registration ritual has failed.",
+        suggestion: "Check your Name.com account balance and contact info. The domain may have been taken between search and purchase.",
+        art: EXPLOSION_ART,
+        color: "red",
+    },
+    DNS_ERROR: {
+        code: "DNS_ERROR",
+        icon: "🌐",
+        characterMessage: "The zone file rejects your offering.",
+        suggestion: "Verify the record type, host, and value are correct. Check for conflicting records.",
+        art: BROKEN_PIPE_ART,
+        color: "red",
+    },
+    RENEWAL_FAILED: {
+        code: "RENEWAL_FAILED",
+        icon: "📅",
+        characterMessage: "Time waits for no domain.",
+        suggestion: "Check your Name.com account balance. Ensure the domain is eligible for renewal.",
+        art: WARNING_ART,
+        color: "yellow",
+    },
+    INVALID_DOMAIN: {
+        code: "INVALID_DOMAIN",
+        icon: "❌",
+        characterMessage: "That's not a valid domain in any universe.",
+        suggestion: "Domain names must be alphanumeric with hyphens, followed by a valid TLD (e.g., example.com).",
+        color: "red",
+    },
+    VALIDATION_ERROR: {
+        code: "VALIDATION_ERROR",
+        icon: "⚙️",
+        characterMessage: "The inputs don't add up.",
+        suggestion: "Check the command arguments and try again. Run with --help for usage info.",
+        color: "yellow",
+    },
+    API_ERROR: {
+        code: "API_ERROR",
+        icon: "🔌",
+        characterMessage: "The Name.com servers aren't cooperating.",
+        suggestion: "This may be a temporary issue. Wait a moment and retry. If it persists, check https://www.namestatus.com/",
+        art: BROKEN_PIPE_ART,
+        color: "red",
+    },
+    NETWORK_ERROR: {
+        code: "NETWORK_ERROR",
+        icon: "📡",
+        characterMessage: "Lost connection to the domain dimension.",
+        suggestion: "Check your internet connection. If you're behind a proxy or firewall, ensure api.name.com is reachable.",
+        art: BROKEN_PIPE_ART,
+        color: "red",
+    },
+};
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Get the personality for a given DomainErrorCode.
+ */
+export function getErrorPersonality(code) {
+    return PERSONALITIES[code];
+}
+/**
+ * Get all error personalities (for testing / enumeration).
+ */
+export function getAllPersonalities() {
+    return Object.values(PERSONALITIES);
+}
+/**
+ * Try to match a generic Error to a DomainErrorCode personality.
+ * Falls back to API_ERROR if the error doesn't have a recognized code.
+ */
+export function inferPersonality(error) {
+    if (error &&
+        typeof error === "object" &&
+        "code" in error &&
+        typeof error.code === "string") {
+        const code = error.code;
+        if (PERSONALITIES[code]) {
+            return PERSONALITIES[code];
+        }
+    }
+    return PERSONALITIES.API_ERROR;
+}
+//# sourceMappingURL=error-personality.js.map

package/dist/lib/error-personality.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Error re-exports for convenience.
+ * DomainError is defined in types.ts — re-exported here for
+ * consumers that want to import errors from a dedicated module.
+ */
+export { DomainError } from "./types.js";
+export type { DomainErrorCode } from "./types.js";
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib/errors.js

@@ -0,0 +1,7 @@
+/**
+ * Error re-exports for convenience.
+ * DomainError is defined in types.ts — re-exported here for
+ * consumers that want to import errors from a dedicated module.
+ */
+export { DomainError } from "./types.js";
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib/konami.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Konami code detection for Ink terminal input.
+ *
+ * Listens for the classic sequence: up-up-down-down-left-right-left-right-b-a
+ * via Ink's useInput hook. When detected, triggers the callback (Matrix rain).
+ *
+ * Arrow keys arrive as special keys in Ink's input handler.
+ * Letter keys arrive as regular input characters.
+ */
+export interface KonamiStep {
+    type: "arrow" | "letter";
+    value: string;
+}
+export declare const KONAMI_SEQUENCE: KonamiStep[];
+/**
+ * Tracks progress through the Konami code sequence.
+ * Thread-safe for a single-threaded Node.js event loop.
+ */
+export declare class KonamiTracker {
+    private position;
+    private readonly onComplete;
+    private readonly timeout;
+    private lastInputTime;
+    /**
+     * @param onComplete - Callback fired when the full sequence is entered
+     * @param timeout - Max ms between inputs before resetting (default 5000)
+     */
+    constructor(onComplete: () => void, timeout?: number);
+    /**
+     * Process a key input from Ink's useInput hook.
+     *
+     * @param input - The character input (for letter keys)
+     * @param key - The key object from Ink (for arrow keys)
+     * @returns true if the sequence was just completed
+     */
+    handleInput(input: string, key: {
+        upArrow?: boolean;
+        downArrow?: boolean;
+        leftArrow?: boolean;
+        rightArrow?: boolean;
+    }): boolean;
+    /**
+     * Get current progress through the sequence (0 to 10).
+     */
+    getProgress(): number;
+    /**
+     * Reset the tracker state.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=konami.d.ts.map

package/dist/lib/konami.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"konami.d.ts","sourceRoot":"","sources":["../../src/lib/konami.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,eAAe,EAAE,UAAU,EAWvC,CAAC;AAIF;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,aAAa,CAAK;IAE1B;;;OAGG;gBACS,UAAU,EAAE,MAAM,IAAI,EAAE,OAAO,SAAO;IAKlD;;;;;;OAMG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,GAAG,EAAE;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GACA,OAAO;IAsDV;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}