@keynv/core 0.1.0-rc.23

package/dist/reference/parser-property.test.js

@@ -0,0 +1,115 @@
+import fc from 'fast-check';
+import { describe, expect, it } from 'vitest';
+import { buildAlias, findAliases, parseAlias } from './parser.js';
+const projectArb = fc
+    .stringMatching(/^[a-z0-9][a-z0-9-]{0,47}$/)
+    .filter((s) => s.length >= 1 && s.length <= 48);
+const envArb = fc
+    .stringMatching(/^[a-z0-9][a-z0-9-]{0,23}$/)
+    .filter((s) => s.length >= 1 && s.length <= 24);
+const keyArb = fc
+    .stringMatching(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/)
+    .filter((s) => s.length >= 1 && s.length <= 64);
+const aliasPartsArb = fc.record({
+    project: projectArb,
+    environment: envArb,
+    key: keyArb,
+});
+describe('parseAlias — properties', () => {
+    it('round-trips: build → parse yields the same components', () => {
+        fc.assert(fc.property(aliasPartsArb, (parts) => {
+            const built = buildAlias(parts);
+            expect(built).not.toBeNull();
+            if (!built)
+                return;
+            const reparsed = parseAlias(built.literal);
+            expect(reparsed).toEqual(built);
+        }), { numRuns: 500 });
+    });
+    it('is idempotent: parseAlias(parseAlias(x).literal) equals parseAlias(x)', () => {
+        fc.assert(fc.property(aliasPartsArb, (parts) => {
+            const first = parseAlias(`@${parts.project}.${parts.environment}.${parts.key}`);
+            if (!first)
+                return;
+            const second = parseAlias(first.literal);
+            expect(second).toEqual(first);
+        }), { numRuns: 500 });
+    });
+    it('never accepts a string with whitespace', () => {
+        fc.assert(fc.property(aliasPartsArb, fc.constantFrom(' ', '\t', '\n', '\r'), fc.integer({ min: 0, max: 80 }), (parts, ws, position) => {
+            const literal = `@${parts.project}.${parts.environment}.${parts.key}`;
+            if (position >= literal.length)
+                return;
+            const tampered = literal.slice(0, position) + ws + literal.slice(position);
+            expect(parseAlias(tampered)).toBeNull();
+        }), { numRuns: 500 });
+    });
+    it('never accepts non-string inputs', () => {
+        fc.assert(fc.property(fc.oneof(fc.constant(undefined), fc.constant(null), fc.integer(), fc.boolean(), fc.array(fc.string()), fc.object()), (notString) => {
+            expect(parseAlias(notString)).toBeNull();
+        }), { numRuns: 200 });
+    });
+});
+describe('findAliases — properties', () => {
+    it('every match parses back to itself', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 200 }), (text) => {
+            for (const m of findAliases(text)) {
+                const reparsed = parseAlias(m.literal);
+                expect(reparsed).not.toBeNull();
+                expect(reparsed?.project).toBe(m.project);
+                expect(reparsed?.environment).toBe(m.environment);
+                expect(reparsed?.key).toBe(m.key);
+            }
+        }), { numRuns: 500 });
+    });
+    it('match offsets reproduce the literal exactly', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 200 }), (text) => {
+            for (const m of findAliases(text)) {
+                expect(text.slice(m.start, m.end)).toBe(m.literal);
+            }
+        }), { numRuns: 500 });
+    });
+    it('matches do not overlap and are sorted', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 400 }), (text) => {
+            const matches = findAliases(text);
+            for (let i = 1; i < matches.length; i++) {
+                const cur = matches[i];
+                const prev = matches[i - 1];
+                if (!cur || !prev)
+                    continue;
+                expect(cur.start).toBeGreaterThanOrEqual(prev.end);
+            }
+        }), { numRuns: 500 });
+    });
+    it('embedding a built alias inside neutral context produces exactly one match', () => {
+        fc.assert(fc.property(aliasPartsArb, fc.constantFrom('use ', 'see (', '"', "'", ' '), fc.constantFrom(' here', ')', '"', "'", '!', '.'), (parts, prefix, suffix) => {
+            const built = buildAlias(parts);
+            if (!built)
+                return;
+            const text = `${prefix}${built.literal}${suffix}`;
+            const matches = findAliases(text);
+            expect(matches).toHaveLength(1);
+            expect(matches[0]?.literal).toBe(built.literal);
+        }), { numRuns: 300 });
+    });
+});
+describe('findAliases — performance budget', () => {
+    it('handles a 10K-line text in under 250ms', () => {
+        const lines = [];
+        for (let i = 0; i < 10_000; i++) {
+            const project = `proj${i % 1000}`;
+            const env = i % 2 === 0 ? 'dev' : 'prod';
+            const key = `key_${i}`;
+            lines.push(i % 5 === 0
+                ? `lorem ipsum @${project}.${env}.${key} dolor sit`
+                : 'lorem ipsum dolor sit amet consectetur');
+        }
+        const text = lines.join('\n');
+        const start = performance.now();
+        const matches = findAliases(text);
+        const elapsed = performance.now() - start;
+        expect(matches.length).toBeGreaterThan(0);
+        expect(elapsed).toBeLessThan(250);
+    });
+});
+//# sourceMappingURL=parser-property.test.js.map

package/dist/reference/parser-property.test.js.map

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

package/dist/reference/parser.d.ts

@@ -0,0 +1,54 @@
+import type { Alias, AliasMatch, FindMode } from './types.js';
+/**
+ * Parses an exact alias literal. Returns `null` if `input` is not a
+ * well-formed `@project.environment.key` reference.
+ *
+ * Strict: case-sensitive (lowercase only), exactly three components,
+ * each within the documented length limits.
+ */
+export declare function parseAlias(input: string): Alias | null;
+/**
+ * Scans a string for embedded aliases.
+ *
+ * The default `text` mode is conservative and avoids common false positives
+ * like email addresses. Use `argv` mode when scanning shell command arguments
+ * where patterns such as `mysql -p@billing.prod.db_password` are expected.
+ *
+ * Returned matches are ordered by `start` ascending and never overlap.
+ */
+export declare function findAliases(text: string, opts?: {
+    mode?: FindMode;
+}): AliasMatch[];
+/**
+ * Walks an argv array and returns every alias found inside any element.
+ *
+ * Uses `argv` mode automatically. The returned offsets are relative to the
+ * containing argv string.
+ */
+export declare function findAliasesInArgv(argv: readonly string[]): Array<{
+    argvIndex: number;
+    matches: AliasMatch[];
+}>;
+/**
+ * Replaces every alias found in `text` with the value returned by `resolve`.
+ *
+ * Replacement is right-to-left so that already-computed offsets remain
+ * valid. The resolver receives the parsed alias and returns the string that
+ * should appear in its place. Throwing inside the resolver propagates.
+ */
+export declare function replaceAliases(text: string, resolve: (alias: Alias) => string, opts?: {
+    mode?: FindMode;
+}): string;
+/**
+ * Builds an alias literal from validated components without parsing.
+ * Returns `null` if any component would fail validation.
+ *
+ * Useful for building aliases from server data (where components come from
+ * separate columns) without re-running the full parser.
+ */
+export declare function buildAlias(parts: {
+    project: string;
+    environment: string;
+    key: string;
+}): Alias | null;
+//# sourceMappingURL=parser.d.ts.map

package/dist/reference/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/reference/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgB9D;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAmBtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAO,GAAG,UAAU,EAAE,CAmBtF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAWrD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,EACjC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAO,GAC7B,MAAM,CAsBR;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,KAAK,GAAG,IAAI,CAUf"}

package/dist/reference/parser.js

@@ -0,0 +1,144 @@
+const PROJECT_RE = /^[a-z0-9][a-z0-9-]{0,47}$/;
+const ENV_RE = /^[a-z0-9][a-z0-9-]{0,23}$/;
+const KEY_RE = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;
+// Trailing boundary: forbid an immediately-following word char (would extend
+// the key) AND forbid a `.<alias-start>` (would imply a 4-part alias). A bare
+// trailing `.` — sentence punctuation — is allowed.
+const TRAILING_BOUNDARY = '(?!\\w|\\.[a-z0-9])';
+const TEXT_FIND_SOURCE = `(?<![\\w.@/])@[a-z0-9][a-z0-9-]{0,47}\\.[a-z0-9][a-z0-9-]{0,23}\\.[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}${TRAILING_BOUNDARY}`;
+const ARGV_FIND_SOURCE = `@[a-z0-9][a-z0-9-]{0,47}\\.[a-z0-9][a-z0-9-]{0,23}\\.[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}${TRAILING_BOUNDARY}`;
+const TEXT_FIND_RE = new RegExp(TEXT_FIND_SOURCE, 'g');
+const ARGV_FIND_RE = new RegExp(ARGV_FIND_SOURCE, 'g');
+/**
+ * Parses an exact alias literal. Returns `null` if `input` is not a
+ * well-formed `@project.environment.key` reference.
+ *
+ * Strict: case-sensitive (lowercase only), exactly three components,
+ * each within the documented length limits.
+ */
+export function parseAlias(input) {
+    if (typeof input !== 'string' || input.length < 6)
+        return null;
+    if (input.charCodeAt(0) !== 64)
+        return null;
+    const dot1 = input.indexOf('.', 1);
+    if (dot1 < 2)
+        return null;
+    const dot2 = input.indexOf('.', dot1 + 1);
+    if (dot2 < 0 || dot2 === dot1 + 1)
+        return null;
+    if (input.indexOf('.', dot2 + 1) !== -1)
+        return null;
+    const project = input.slice(1, dot1);
+    const environment = input.slice(dot1 + 1, dot2);
+    const key = input.slice(dot2 + 1);
+    if (!PROJECT_RE.test(project))
+        return null;
+    if (!ENV_RE.test(environment))
+        return null;
+    if (!KEY_RE.test(key))
+        return null;
+    return { literal: input, project, environment, key };
+}
+/**
+ * Scans a string for embedded aliases.
+ *
+ * The default `text` mode is conservative and avoids common false positives
+ * like email addresses. Use `argv` mode when scanning shell command arguments
+ * where patterns such as `mysql -p@billing.prod.db_password` are expected.
+ *
+ * Returned matches are ordered by `start` ascending and never overlap.
+ */
+export function findAliases(text, opts = {}) {
+    if (typeof text !== 'string' || text.length === 0)
+        return [];
+    const re = opts.mode === 'argv' ? ARGV_FIND_RE : TEXT_FIND_RE;
+    re.lastIndex = 0;
+    const matches = [];
+    for (const m of text.matchAll(re)) {
+        const literal = m[0];
+        const start = m.index;
+        if (start === undefined)
+            continue;
+        const parsed = parseAlias(literal);
+        if (!parsed)
+            continue;
+        matches.push({
+            ...parsed,
+            start,
+            end: start + literal.length,
+        });
+    }
+    return matches;
+}
+/**
+ * Walks an argv array and returns every alias found inside any element.
+ *
+ * Uses `argv` mode automatically. The returned offsets are relative to the
+ * containing argv string.
+ */
+export function findAliasesInArgv(argv) {
+    const result = [];
+    for (let i = 0; i < argv.length; i++) {
+        const element = argv[i];
+        if (typeof element !== 'string')
+            continue;
+        const matches = findAliases(element, { mode: 'argv' });
+        if (matches.length > 0) {
+            result.push({ argvIndex: i, matches });
+        }
+    }
+    return result;
+}
+/**
+ * Replaces every alias found in `text` with the value returned by `resolve`.
+ *
+ * Replacement is right-to-left so that already-computed offsets remain
+ * valid. The resolver receives the parsed alias and returns the string that
+ * should appear in its place. Throwing inside the resolver propagates.
+ */
+export function replaceAliases(text, resolve, opts = {}) {
+    if (typeof text !== 'string' || text.length === 0)
+        return text;
+    const matches = findAliases(text, opts);
+    if (matches.length === 0)
+        return text;
+    let out = text;
+    for (let i = matches.length - 1; i >= 0; i--) {
+        const m = matches[i];
+        if (!m)
+            continue;
+        const replacement = resolve(m);
+        // Circularity guard: only reject a replacement that is itself a FULLY
+        // VALID alias literal (`@project.env.key`). A value that merely starts
+        // with `@` plus a kebab segment — e.g. a real secret like `@my-token`
+        // or `@2fa-backup` — is not an alias and must pass through unchanged.
+        if (parseAlias(replacement) !== null) {
+            throw new Error(`replaceAliases: resolved value for ${m.literal} is itself a valid alias (${replacement}). Circular or misconfigured resolution detected.`);
+        }
+        out = out.slice(0, m.start) + replacement + out.slice(m.end);
+    }
+    return out;
+}
+/**
+ * Builds an alias literal from validated components without parsing.
+ * Returns `null` if any component would fail validation.
+ *
+ * Useful for building aliases from server data (where components come from
+ * separate columns) without re-running the full parser.
+ */
+export function buildAlias(parts) {
+    if (!PROJECT_RE.test(parts.project))
+        return null;
+    if (!ENV_RE.test(parts.environment))
+        return null;
+    if (!KEY_RE.test(parts.key))
+        return null;
+    return {
+        literal: `@${parts.project}.${parts.environment}.${parts.key}`,
+        project: parts.project,
+        environment: parts.environment,
+        key: parts.key,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/reference/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/reference/parser.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,2BAA2B,CAAC;AAC/C,MAAM,MAAM,GAAG,2BAA2B,CAAC;AAC3C,MAAM,MAAM,GAAG,kCAAkC,CAAC;AAElD,6EAA6E;AAC7E,8EAA8E;AAC9E,oDAAoD;AACpD,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAChD,MAAM,gBAAgB,GAAG,mGAAmG,iBAAiB,EAAE,CAAC;AAChJ,MAAM,gBAAgB,GAAG,sFAAsF,iBAAiB,EAAE,CAAC;AAEnI,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AACvD,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAE5C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IAC1C,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,KAAK,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAErD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAElC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAA4B,EAAE;IACtE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7D,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;IAC9D,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC;IAEjB,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QACtB,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,MAAM;YACT,KAAK;YACL,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAuB;IAEvB,MAAM,MAAM,GAAwD,EAAE,CAAC;IACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,SAAS;QAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAiC,EACjC,OAA4B,EAAE;IAE9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/B,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,sEAAsE;QACtE,IAAI,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,sCAAsC,CAAC,CAAC,OAAO,6BAA6B,WAAW,mDAAmD,CAC3I,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAI1B;IACC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO;QACL,OAAO,EAAE,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,GAAG,EAAE;QAC9D,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC;AACJ,CAAC"}

package/dist/reference/parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parser.test.d.ts.map

package/dist/reference/parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.d.ts","sourceRoot":"","sources":["../../src/reference/parser.test.ts"],"names":[],"mappings":""}

package/dist/reference/parser.test.js

@@ -0,0 +1,195 @@
+import { describe, expect, it } from 'vitest';
+import { buildAlias, findAliases, findAliasesInArgv, parseAlias, replaceAliases, } from './parser.js';
+describe('parseAlias — happy paths', () => {
+    it('parses a canonical alias', () => {
+        expect(parseAlias('@billing.prod.db_password')).toEqual({
+            literal: '@billing.prod.db_password',
+            project: 'billing',
+            environment: 'prod',
+            key: 'db_password',
+        });
+    });
+    it('parses kebab-case and snake_case keys together', () => {
+        expect(parseAlias('@auth-service.staging.jwt-signing-key')).toEqual({
+            literal: '@auth-service.staging.jwt-signing-key',
+            project: 'auth-service',
+            environment: 'staging',
+            key: 'jwt-signing-key',
+        });
+    });
+    it('parses uppercase keys (standard .env convention)', () => {
+        expect(parseAlias('@billing.prod.DATABASE_URL')).toEqual({
+            literal: '@billing.prod.DATABASE_URL',
+            project: 'billing',
+            environment: 'prod',
+            key: 'DATABASE_URL',
+        });
+        expect(parseAlias('@auth-service.staging.API_KEY')).toMatchObject({
+            key: 'API_KEY',
+        });
+        expect(parseAlias('@billing.prod.Secret_Token_1')).toMatchObject({
+            key: 'Secret_Token_1',
+        });
+    });
+    it('parses numeric components', () => {
+        expect(parseAlias('@p1.pr-1234.k_42')).toMatchObject({
+            project: 'p1',
+            environment: 'pr-1234',
+            key: 'k_42',
+        });
+    });
+    it('accepts max-length components', () => {
+        const project = `a${'b'.repeat(47)}`;
+        const environment = `a${'b'.repeat(23)}`;
+        const key = `a${'b'.repeat(63)}`;
+        const literal = `@${project}.${environment}.${key}`;
+        expect(parseAlias(literal)).toEqual({ literal, project, environment, key });
+    });
+});
+describe('parseAlias — rejections', () => {
+    it.each([
+        ['no @ prefix', 'billing.prod.db_password'],
+        ['empty', ''],
+        ['just @', '@'],
+        ['too short', '@a.b'],
+        ['only two parts', '@billing.prod'],
+        ['four parts', '@billing.prod.db.password'],
+        ['empty project', '@.prod.key'],
+        ['empty env', '@billing..key'],
+        ['empty key', '@billing.prod.'],
+        ['uppercase project', '@Billing.prod.key'],
+        ['uppercase env', '@billing.Prod.key'],
+        ['underscore in project (project allows kebab only)', '@bil_ling.prod.key'],
+        ['leading dash in project', '@-billing.prod.key'],
+        ['leading dash in env', '@billing.-prod.key'],
+        ['leading dash in key', '@billing.prod.-key'],
+        ['trailing newline', '@billing.prod.key\n'],
+        ['internal whitespace', '@billing. prod.key'],
+        ['too long project (49)', `@${'a'.repeat(49)}.prod.key`],
+        ['too long env (25)', `@billing.${'a'.repeat(25)}.key`],
+        ['too long key (65)', `@billing.prod.${'a'.repeat(65)}`],
+        ['extra @', '@@billing.prod.key'],
+        ['unicode', '@billing.prod.şifre'],
+    ])('rejects %s: %s', (_label, input) => {
+        expect(parseAlias(input)).toBeNull();
+    });
+    it('rejects non-string input', () => {
+        expect(parseAlias(undefined)).toBeNull();
+        expect(parseAlias(null)).toBeNull();
+        expect(parseAlias(42)).toBeNull();
+    });
+});
+describe('findAliases — text mode (conservative)', () => {
+    it('finds an alias inside a sentence', () => {
+        const text = 'Use @billing.prod.db_password before the migration.';
+        const matches = findAliases(text);
+        expect(matches).toHaveLength(1);
+        expect(matches[0]?.literal).toBe('@billing.prod.db_password');
+        expect(text.slice(matches[0]?.start, matches[0]?.end)).toBe('@billing.prod.db_password');
+    });
+    it('finds an alias inside double quotes', () => {
+        const text = 'connect to "@billing.prod.db_url" please';
+        expect(findAliases(text).map((m) => m.literal)).toEqual(['@billing.prod.db_url']);
+    });
+    it('finds an alias inside single quotes', () => {
+        const text = "connect to '@billing.prod.db_url'";
+        expect(findAliases(text).map((m) => m.literal)).toEqual(['@billing.prod.db_url']);
+    });
+    it('handles trailing punctuation', () => {
+        const text = 'aliases: (@billing.prod.db_password), end.';
+        expect(findAliases(text).map((m) => m.literal)).toEqual(['@billing.prod.db_password']);
+    });
+    it('finds multiple aliases on one line', () => {
+        const text = 'Two: @a.b.c and @x-1.y.z42 work.';
+        expect(findAliases(text).map((m) => m.literal)).toEqual(['@a.b.c', '@x-1.y.z42']);
+    });
+    it('does NOT match inside an email address', () => {
+        const text = 'contact support@billing.example.com for help';
+        expect(findAliases(text)).toEqual([]);
+    });
+    it('does NOT match inside a URL path', () => {
+        const text = 'see https://billing.example.com for details';
+        expect(findAliases(text)).toEqual([]);
+    });
+    it('does NOT match incomplete aliases', () => {
+        expect(findAliases('@billing.prod and @billing.prod.')).toEqual([]);
+    });
+});
+describe('findAliases — argv mode (permissive)', () => {
+    it('matches an alias glued onto a flag prefix', () => {
+        const matches = findAliases('-p@billing.prod.db_password', { mode: 'argv' });
+        expect(matches).toHaveLength(1);
+        expect(matches[0]?.literal).toBe('@billing.prod.db_password');
+    });
+    it('matches after =', () => {
+        const matches = findAliases('--password=@billing.prod.db_password', { mode: 'argv' });
+        expect(matches).toHaveLength(1);
+    });
+});
+describe('findAliasesInArgv', () => {
+    it('groups matches by argv element', () => {
+        const argv = ['mysql', '-p@billing.prod.db_password', '-h', '@billing.prod.db_host'];
+        const result = findAliasesInArgv(argv);
+        expect(result).toHaveLength(2);
+        expect(result[0]?.argvIndex).toBe(1);
+        expect(result[0]?.matches[0]?.literal).toBe('@billing.prod.db_password');
+        expect(result[1]?.argvIndex).toBe(3);
+        expect(result[1]?.matches[0]?.literal).toBe('@billing.prod.db_host');
+    });
+    it('ignores argv elements with no aliases', () => {
+        expect(findAliasesInArgv(['echo', 'hello'])).toEqual([]);
+    });
+});
+describe('replaceAliases', () => {
+    it('substitutes a single alias', () => {
+        const result = replaceAliases('@a.b.c', () => 'VALUE');
+        expect(result).toBe('VALUE');
+    });
+    it('substitutes multiple aliases preserving non-alias text', () => {
+        const text = 'connect @a.b.c and @x.y.z now';
+        const result = replaceAliases(text, (a) => `<${a.project}>`);
+        expect(result).toBe('connect <a> and <x> now');
+    });
+    it('is a no-op when no aliases match', () => {
+        expect(replaceAliases('plain text', () => 'X')).toBe('plain text');
+    });
+    it('preserves email-shaped strings in text mode', () => {
+        const text = 'contact support@billing.example.com';
+        expect(replaceAliases(text, () => 'X')).toBe(text);
+    });
+    it('substitutes inside argv-style strings when mode=argv', () => {
+        const result = replaceAliases('-p@a.b.c', () => 'PASS', { mode: 'argv' });
+        expect(result).toBe('-pPASS');
+    });
+    it('allows a resolved value that starts with @ + a kebab segment (not an alias)', () => {
+        // A real secret value like `@my-token` must pass through unchanged — it
+        // is a single segment, not a `@project.env.key` alias literal.
+        expect(replaceAliases('@a.b.c', () => '@my-token')).toBe('@my-token');
+        expect(replaceAliases('@a.b.c', () => '@2fa-backup')).toBe('@2fa-backup');
+    });
+    it('throws when a resolved value is itself a fully valid alias (real circularity)', () => {
+        expect(() => replaceAliases('@a.b.c', () => '@x.y.z')).toThrow(/circular|valid alias/i);
+    });
+});
+describe('buildAlias', () => {
+    it('builds a valid alias from components', () => {
+        expect(buildAlias({ project: 'billing', environment: 'prod', key: 'db_password' })).toEqual({
+            literal: '@billing.prod.db_password',
+            project: 'billing',
+            environment: 'prod',
+            key: 'db_password',
+        });
+    });
+    it('rejects invalid components', () => {
+        expect(buildAlias({ project: 'Billing', environment: 'prod', key: 'k' })).toBeNull();
+        expect(buildAlias({ project: 'b', environment: '_p', key: 'k' })).toBeNull();
+        expect(buildAlias({ project: 'b', environment: 'p', key: 'şifre' })).toBeNull();
+    });
+    it('accepts uppercase keys', () => {
+        expect(buildAlias({ project: 'billing', environment: 'prod', key: 'DATABASE_URL' })).toMatchObject({
+            key: 'DATABASE_URL',
+            literal: '@billing.prod.DATABASE_URL',
+        });
+    });
+});
+//# sourceMappingURL=parser.test.js.map

package/dist/reference/parser.test.js.map

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

package/dist/reference/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The decomposed parts of a keynv alias literal `@project.environment.key`.
+ *
+ * `literal` holds the original string including the leading `@`; `project`,
+ * `environment`, and `key` are the validated components.
+ */
+export interface Alias {
+    readonly literal: string;
+    readonly project: string;
+    readonly environment: string;
+    readonly key: string;
+}
+/**
+ * An alias detected inside a larger string, with its byte offsets.
+ *
+ * `start` is inclusive, `end` is exclusive. `text.slice(start, end)` equals
+ * `literal`.
+ */
+export interface AliasMatch extends Alias {
+    readonly start: number;
+    readonly end: number;
+}
+/**
+ * Selects how aggressive the finder is.
+ *
+ * - `'text'` (default): conservative. Aliases preceded by a word character,
+ *   `.`, `@`, or `/` are rejected, so e.g. `support@billing.example.com`
+ *   does not produce a false positive.
+ * - `'argv'`: permissive. Used when scanning shell argv where flag prefixes
+ *   like `-p@alias` are common; emails are unlikely.
+ */
+export type FindMode = 'text' | 'argv';
+/**
+ * Lexical limits for each component of an `@project.environment.key`
+ * alias. Exposed here so callers (e.g. validation in the server API)
+ * can reuse them.
+ */
+export declare const ALIAS_LIMITS: {
+    readonly project: {
+        readonly min: 1;
+        readonly max: 48;
+    };
+    readonly environment: {
+        readonly min: 1;
+        readonly max: 24;
+    };
+    readonly key: {
+        readonly min: 1;
+        readonly max: 64;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reference/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAIf,CAAC"}

package/dist/reference/types.js

@@ -0,0 +1,11 @@
+/**
+ * Lexical limits for each component of an `@project.environment.key`
+ * alias. Exposed here so callers (e.g. validation in the server API)
+ * can reuse them.
+ */
+export const ALIAS_LIMITS = {
+    project: { min: 1, max: 48 },
+    environment: { min: 1, max: 24 },
+    key: { min: 1, max: 64 },
+};
+//# sourceMappingURL=types.js.map

package/dist/reference/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reference/types.ts"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC5B,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAChC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;CAChB,CAAC"}