@quadnix/octo 0.0.30 → 0.2.0

package/dist/utilities/hcl/hcl.utility.d.ts

@@ -0,0 +1,128 @@
+import type { TerraformService } from '../../services/terraform/terraform.service.js';
+/**
+ * One parsed HCL block: each attribute by name, and each nested block by its type. An attribute holding
+ * a quoted string is unquoted; any other value (a number, a list, a reference, a `jsonencode(...)` call)
+ * is kept as the HCL text it was rendered as. A nested block repeated in its parent (two `ingress`
+ * blocks) is an array.
+ *
+ * @group Utilities/Hcl
+ */
+export type HclBlock = {
+    [key: string]: string | HclBlock | HclBlock[];
+};
+/**
+ * Reads, serializes and diffs the terraform octo renders.
+ *
+ * The render format is octo-owned and regular: `# <moduleId>/<file>` section headers, and top-level
+ * blocks that start on a line with no indent. So everything here is plain string work, needing no external
+ * HCL parser or diff library. {@link parse} reads the blocks a module test asserts on,
+ * {@link serialize} flattens a render into one string, {@link unifiedDiff} is the generic line-diff
+ * engine, and {@link diffBlocks} layers octo's block structure on top of it.
+ *
+ * @group Utilities/Hcl
+ */
+export declare class HclUtility {
+    /**
+     * The `# <moduleId>/<file>` line {@link serialize} puts before each file.
+     *
+     * @internal
+     */
+    private static readonly SECTION_HEADER;
+    /**
+     * Diffs two {@link serialize} renders at the block level. A block is identified by its header line,
+     * and blocks sharing a header (one `provider "aws"` per alias) by their first body line too, so a
+     * body change reads as `~` (a line-level {@link unifiedDiff} of what changed inside the block),
+     * not as an unrelated add + remove. An added block shows its full new body, a removed block its full
+     * old body — symmetric, with nothing trimmed away. The `+`/`-`/`~` vocabulary mirrors the
+     * `digestDiffs` digest, tagged with `moduleId/file`. Returns `'<no changes>'` when nothing moved.
+     */
+    static diffBlocks(previous: string, current: string): string;
+    /**
+     * Reads the `resource` and `data` blocks of rendered terraform, keyed by their terraform address:
+     * `<type>.<name>` for a resource, `data.<type>.<name>` for a data source. It takes one file's text or
+     * a whole {@link serialize} render, such as the `hclRender` a module test gets back, since resource
+     * and data addresses are unique across an app.
+     *
+     * It reads octo's own render format, not arbitrary HCL: one attribute or block per line, and a value
+     * spanning lines only inside brackets.
+     *
+     * @example
+     * ```ts
+     * const { resource } = HclUtility.parse(hclRender);
+     * expect(Object.keys(resource)).toContain('aws_vpc.vpc-region-475bfa');
+     * expect(resource['aws_vpc.vpc-region-475bfa'].cidr_block).toBe('10.0.0.0/16');
+     * ```
+     */
+    static parse(hcl: string): {
+        data: Record<string, HclBlock>;
+        resource: Record<string, HclBlock>;
+    };
+    /**
+     * Flattens the rendered terragrunt folders into one snapshot-friendly string: folders sorted by
+     * module id, files in a stable order, each prefixed with a `# <moduleId>/<file>` header. An empty
+     * file shows a `<empty>` body, so the file is still visible in the snapshot rather than omitted.
+     */
+    static serialize(moduleFiles: ReturnType<TerraformService['renderAllModules']>): string;
+    /**
+     * Produces a git-style unified line diff of two multi-line strings, collapsing unchanged regions
+     * to at most `contextLines` of surrounding context per change and emitting `@@ -a,c +b,c @@` hunk
+     * headers. Changed lines are tagged `- ` (only in `before`) and `+ ` (only in `after`); context
+     * lines are tagged with two spaces, so the markers line up. Pure plain text, no ANSI color, so it
+     * is safe to embed in a snapshot.
+     *
+     * Returns an empty string when the two inputs are identical.
+     */
+    static unifiedDiff(before: string, after: string, { contextLines }?: {
+        contextLines?: number;
+    }): string;
+    /**
+     * How many brackets a line opens, less how many it closes, ignoring those inside quoted strings.
+     *
+     * @internal
+     */
+    private static bracketDepth;
+    /**
+     * Builds the shortest edit script between two line arrays via the classic longest-common-subsequence
+     * DP. Quadratic in the number of lines, which is fine for the small blocks this serves. A removal is
+     * preferred over an addition on ties so a changed line reads as `-old` then `+new`.
+     *
+     * @internal
+     */
+    private static diffLines;
+    /**
+     * Keys blocks by their header line (e.g. `resource "aws_vpc" "vpc-x" {`), adding the first body line
+     * for a header in `repeatedHeaders`, and an occurrence number for any key still taken.
+     *
+     * @internal
+     */
+    private static keyBlocks;
+    /**
+     * Splits a {@link serialize} render into its top-level blocks, grouped by `moduleId/file`. Relies on
+     * octo's regular render format — `# <moduleId>/<file>` section headers, and a top-level block
+     * starting on a line with no indent that is not a closing bracket.
+     *
+     * @internal
+     */
+    private static parseBlocks;
+    /**
+     * Parses the lines inside a block. An attribute whose value opens more brackets than it closes runs
+     * on to the line that closes them, and is kept as text; `key = {` on its own is an object, parsed
+     * like a nested block.
+     *
+     * @internal
+     */
+    private static parseBody;
+    /**
+     * Returns the header lines that more than one of these blocks starts with.
+     *
+     * @internal
+     */
+    private static repeatedHeaders;
+    /**
+     * Splits lines into top-level blocks, each trimmed. A block starts on a line with no indent that is not a
+     * closing bracket, so a blank line inside a block does not end it.
+     *
+     * @internal
+     */
+    private static splitTopLevelBlocks;
+}

package/dist/utilities/hcl/hcl.utility.js

@@ -0,0 +1,402 @@
+/**
+ * Reads, serializes and diffs the terraform octo renders.
+ *
+ * The render format is octo-owned and regular: `# <moduleId>/<file>` section headers, and top-level
+ * blocks that start on a line with no indent. So everything here is plain string work, needing no external
+ * HCL parser or diff library. {@link parse} reads the blocks a module test asserts on,
+ * {@link serialize} flattens a render into one string, {@link unifiedDiff} is the generic line-diff
+ * engine, and {@link diffBlocks} layers octo's block structure on top of it.
+ *
+ * @group Utilities/Hcl
+ */
+export class HclUtility {
+    /**
+     * The `# <moduleId>/<file>` line {@link serialize} puts before each file.
+     *
+     * @internal
+     */
+    static { this.SECTION_HEADER = /^# (.+\/.+\.(?:tf|hcl))$/; }
+    /**
+     * Diffs two {@link serialize} renders at the block level. A block is identified by its header line,
+     * and blocks sharing a header (one `provider "aws"` per alias) by their first body line too, so a
+     * body change reads as `~` (a line-level {@link unifiedDiff} of what changed inside the block),
+     * not as an unrelated add + remove. An added block shows its full new body, a removed block its full
+     * old body — symmetric, with nothing trimmed away. The `+`/`-`/`~` vocabulary mirrors the
+     * `digestDiffs` digest, tagged with `moduleId/file`. Returns `'<no changes>'` when nothing moved.
+     */
+    static diffBlocks(previous, current) {
+        const previousSections = HclUtility.parseBlocks(previous);
+        const currentSections = HclUtility.parseBlocks(current);
+        const entries = [];
+        const keys = [...new Set([...previousSections.keys(), ...currentSections.keys()])].sort((a, b) => a.localeCompare(b));
+        for (const key of keys) {
+            const previousTexts = previousSections.get(key) ?? [];
+            const currentTexts = currentSections.get(key) ?? [];
+            // A header repeated on either side is keyed with its first body line on both sides.
+            const repeatedHeaders = new Set([
+                ...HclUtility.repeatedHeaders(previousTexts),
+                ...HclUtility.repeatedHeaders(currentTexts),
+            ]);
+            const previousBlocks = HclUtility.keyBlocks(previousTexts, repeatedHeaders);
+            const currentBlocks = HclUtility.keyBlocks(currentTexts, repeatedHeaders);
+            const headers = [...new Set([...previousBlocks.keys(), ...currentBlocks.keys()])].sort((a, b) => a.localeCompare(b));
+            for (const header of headers) {
+                const before = previousBlocks.get(header);
+                const after = currentBlocks.get(header);
+                if (before === undefined) {
+                    entries.push(`+ ${key}\n${after}`);
+                }
+                else if (after === undefined) {
+                    entries.push(`- ${key}\n${before}`);
+                }
+                else if (before !== after) {
+                    entries.push(`~ ${key} ${header}\n${HclUtility.unifiedDiff(before, after, { contextLines: 1 })}`);
+                }
+            }
+        }
+        return entries.length > 0 ? entries.join('\n\n') : '<no changes>';
+    }
+    /**
+     * Reads the `resource` and `data` blocks of rendered terraform, keyed by their terraform address:
+     * `<type>.<name>` for a resource, `data.<type>.<name>` for a data source. It takes one file's text or
+     * a whole {@link serialize} render, such as the `hclRender` a module test gets back, since resource
+     * and data addresses are unique across an app.
+     *
+     * It reads octo's own render format, not arbitrary HCL: one attribute or block per line, and a value
+     * spanning lines only inside brackets.
+     *
+     * @example
+     * ```ts
+     * const { resource } = HclUtility.parse(hclRender);
+     * expect(Object.keys(resource)).toContain('aws_vpc.vpc-region-475bfa');
+     * expect(resource['aws_vpc.vpc-region-475bfa'].cidr_block).toBe('10.0.0.0/16');
+     * ```
+     */
+    static parse(hcl) {
+        const parsed = { data: {}, resource: {} };
+        const lines = hcl.split('\n').filter((line) => !HclUtility.SECTION_HEADER.test(line));
+        for (const block of HclUtility.splitTopLevelBlocks(lines)) {
+            const blockLines = block.split('\n');
+            const header = /^(data|resource) "([^"]+)" "([^"]+)" \{$/.exec(blockLines[0]);
+            if (!header) {
+                continue;
+            }
+            const [, kind, type, name] = header;
+            const body = HclUtility.parseBody(blockLines.slice(1, -1));
+            if (kind === 'resource') {
+                parsed.resource[`${type}.${name}`] = body;
+            }
+            else {
+                parsed.data[`data.${type}.${name}`] = body;
+            }
+        }
+        return parsed;
+    }
+    /**
+     * Flattens the rendered terragrunt folders into one snapshot-friendly string: folders sorted by
+     * module id, files in a stable order, each prefixed with a `# <moduleId>/<file>` header. An empty
+     * file shows a `<empty>` body, so the file is still visible in the snapshot rather than omitted.
+     */
+    static serialize(moduleFiles) {
+        const parts = [];
+        for (const moduleId of [...moduleFiles.keys()].sort((a, b) => a.localeCompare(b))) {
+            const files = moduleFiles.get(moduleId);
+            const entries = [
+                ['main.tf', files.mainTf],
+                ['outputs.tf', files.outputsTf],
+                ['terragrunt.hcl', files.terragruntHcl],
+                ['variables.tf', files.variablesTf],
+            ];
+            for (const [name, content] of entries) {
+                const trimmed = content.trim();
+                parts.push(`# ${moduleId}/${name}\n${trimmed || '<empty>'}`);
+            }
+        }
+        return parts.join('\n\n');
+    }
+    /**
+     * Produces a git-style unified line diff of two multi-line strings, collapsing unchanged regions
+     * to at most `contextLines` of surrounding context per change and emitting `@@ -a,c +b,c @@` hunk
+     * headers. Changed lines are tagged `- ` (only in `before`) and `+ ` (only in `after`); context
+     * lines are tagged with two spaces, so the markers line up. Pure plain text, no ANSI color, so it
+     * is safe to embed in a snapshot.
+     *
+     * Returns an empty string when the two inputs are identical.
+     */
+    static unifiedDiff(before, after, { contextLines = 3 } = {}) {
+        const a = before.length === 0 ? [] : before.split('\n');
+        const b = after.length === 0 ? [] : after.split('\n');
+        const operations = HclUtility.diffLines(a, b);
+        if (operations.every((o) => o.type === 'common')) {
+            return '';
+        }
+        // An op is kept when it is itself a change, or within `contextLines` of one. Consecutive kept ops
+        // form a hunk; the runs of dropped ops between them are the collapsed unchanged regions.
+        const isKept = operations.map((_, index) => {
+            const from = Math.max(0, index - contextLines);
+            const to = Math.min(operations.length - 1, index + contextLines);
+            for (let k = from; k <= to; k++) {
+                if (operations[k].type !== 'common') {
+                    return true;
+                }
+            }
+            return false;
+        });
+        const hunks = [];
+        let index = 0;
+        while (index < operations.length) {
+            if (!isKept[index]) {
+                index++;
+                continue;
+            }
+            const start = index;
+            while (index < operations.length && isKept[index]) {
+                index++;
+            }
+            const end = index; // exclusive.
+            let aCount = 0;
+            let bCount = 0;
+            const lines = [];
+            for (let k = start; k < end; k++) {
+                const op = operations[k];
+                if (op.type === 'common') {
+                    aCount++;
+                    bCount++;
+                    lines.push(`  ${op.text}`);
+                }
+                else if (op.type === 'remove') {
+                    aCount++;
+                    lines.push(`- ${op.text}`);
+                }
+                else {
+                    bCount++;
+                    lines.push(`+ ${op.text}`);
+                }
+            }
+            // `aBefore`/`bBefore` count the lines consumed before this hunk, so the hunk starts on the next
+            // line. A hunk that adds or removes nothing on a side reports that side at the boundary line
+            // with a zero count, matching unified-diff convention.
+            const aBefore = operations.slice(0, start).filter((o) => o.type !== 'add').length;
+            const bBefore = operations.slice(0, start).filter((o) => o.type !== 'remove').length;
+            const aStart = aCount > 0 ? aBefore + 1 : aBefore;
+            const bStart = bCount > 0 ? bBefore + 1 : bBefore;
+            hunks.push(`@@ -${aStart},${aCount} +${bStart},${bCount} @@\n${lines.join('\n')}`);
+        }
+        return hunks.join('\n');
+    }
+    /**
+     * How many brackets a line opens, less how many it closes, ignoring those inside quoted strings.
+     *
+     * @internal
+     */
+    static bracketDepth(line) {
+        let depth = 0;
+        let inString = false;
+        for (let index = 0; index < line.length; index++) {
+            const character = line[index];
+            if (inString) {
+                if (character === '\\') {
+                    index++;
+                }
+                else if (character === '"') {
+                    inString = false;
+                }
+            }
+            else if (character === '"') {
+                inString = true;
+            }
+            else if ('([{'.includes(character)) {
+                depth++;
+            }
+            else if (')]}'.includes(character)) {
+                depth--;
+            }
+        }
+        return depth;
+    }
+    /**
+     * Builds the shortest edit script between two line arrays via the classic longest-common-subsequence
+     * DP. Quadratic in the number of lines, which is fine for the small blocks this serves. A removal is
+     * preferred over an addition on ties so a changed line reads as `-old` then `+new`.
+     *
+     * @internal
+     */
+    static diffLines(a, b) {
+        const n = a.length;
+        const m = b.length;
+        const commonLength = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+        for (let i = n - 1; i >= 0; i--) {
+            for (let j = m - 1; j >= 0; j--) {
+                commonLength[i][j] =
+                    a[i] === b[j] ? commonLength[i + 1][j + 1] + 1 : Math.max(commonLength[i + 1][j], commonLength[i][j + 1]);
+            }
+        }
+        const operations = [];
+        let i = 0;
+        let j = 0;
+        while (i < n && j < m) {
+            if (a[i] === b[j]) {
+                operations.push({ text: a[i], type: 'common' });
+                i++;
+                j++;
+            }
+            else if (commonLength[i + 1][j] >= commonLength[i][j + 1]) {
+                operations.push({ text: a[i], type: 'remove' });
+                i++;
+            }
+            else {
+                operations.push({ text: b[j], type: 'add' });
+                j++;
+            }
+        }
+        while (i < n) {
+            operations.push({ text: a[i], type: 'remove' });
+            i++;
+        }
+        while (j < m) {
+            operations.push({ text: b[j], type: 'add' });
+            j++;
+        }
+        return operations;
+    }
+    /**
+     * Keys blocks by their header line (e.g. `resource "aws_vpc" "vpc-x" {`), adding the first body line
+     * for a header in `repeatedHeaders`, and an occurrence number for any key still taken.
+     *
+     * @internal
+     */
+    static keyBlocks(texts, repeatedHeaders) {
+        const blocks = new Map();
+        for (const text of texts) {
+            const [header, firstBodyLine = ''] = text.split('\n');
+            const baseKey = repeatedHeaders.has(header) ? `${header} ${firstBodyLine.trim()}` : header;
+            let key = baseKey;
+            for (let occurrence = 2; blocks.has(key); occurrence++) {
+                key = `${baseKey} #${occurrence}`;
+            }
+            blocks.set(key, text);
+        }
+        return blocks;
+    }
+    /**
+     * Splits a {@link serialize} render into its top-level blocks, grouped by `moduleId/file`. Relies on
+     * octo's regular render format — `# <moduleId>/<file>` section headers, and a top-level block
+     * starting on a line with no indent that is not a closing bracket.
+     *
+     * @internal
+     */
+    static parseBlocks(serialized) {
+        const sections = new Map();
+        if (!serialized) {
+            return sections;
+        }
+        let currentKey;
+        let buffer = [];
+        const flush = () => {
+            if (currentKey === undefined) {
+                return;
+            }
+            sections.set(currentKey, HclUtility.splitTopLevelBlocks(buffer));
+            buffer = [];
+        };
+        for (const line of serialized.split('\n')) {
+            const header = HclUtility.SECTION_HEADER.exec(line);
+            if (header) {
+                flush();
+                currentKey = header[1];
+            }
+            else {
+                buffer.push(line);
+            }
+        }
+        flush();
+        return sections;
+    }
+    /**
+     * Parses the lines inside a block. An attribute whose value opens more brackets than it closes runs
+     * on to the line that closes them, and is kept as text; `key = {` on its own is an object, parsed
+     * like a nested block.
+     *
+     * @internal
+     */
+    static parseBody(lines) {
+        const body = {};
+        // Finds the line closing the block or value opened on line `start`.
+        const closingLine = (start) => {
+            let depth = 0;
+            for (let index = start; index < lines.length; index++) {
+                depth += HclUtility.bracketDepth(lines[index]);
+                if (depth <= 0) {
+                    return index;
+                }
+            }
+            return lines.length - 1;
+        };
+        let index = 0;
+        while (index < lines.length) {
+            const line = lines[index];
+            const attribute = /^\s*([\w-]+)\s*=\s*(.*)$/.exec(line);
+            if (attribute) {
+                const [, key, value] = attribute;
+                const end = closingLine(index);
+                if (value === '{') {
+                    body[key] = HclUtility.parseBody(lines.slice(index + 1, end));
+                }
+                else {
+                    const text = [value, ...lines.slice(index + 1, end + 1)].join('\n').trim();
+                    body[key] = /^"(?:[^"\\]|\\.)*"$/.test(text) ? text.slice(1, -1) : text;
+                }
+                index = end + 1;
+                continue;
+            }
+            const nestedBlock = /^\s*([\w-]+)(?:\s+"[^"]*")*\s*\{$/.exec(line);
+            if (nestedBlock) {
+                const [, key] = nestedBlock;
+                const end = closingLine(index);
+                const nested = HclUtility.parseBody(lines.slice(index + 1, end));
+                const existing = body[key];
+                if (existing === undefined) {
+                    body[key] = nested;
+                }
+                else if (Array.isArray(existing)) {
+                    existing.push(nested);
+                }
+                else {
+                    body[key] = [existing, nested];
+                }
+                index = end + 1;
+                continue;
+            }
+            index++;
+        }
+        return body;
+    }
+    /**
+     * Returns the header lines that more than one of these blocks starts with.
+     *
+     * @internal
+     */
+    static repeatedHeaders(texts) {
+        const headers = texts.map((t) => t.split('\n')[0]);
+        return headers.filter((h, index) => headers.indexOf(h) !== index);
+    }
+    /**
+     * Splits lines into top-level blocks, each trimmed. A block starts on a line with no indent that is not a
+     * closing bracket, so a blank line inside a block does not end it.
+     *
+     * @internal
+     */
+    static splitTopLevelBlocks(lines) {
+        const blocks = [];
+        for (const line of lines) {
+            if (line.trim() && !/^[\s)\]}]/.test(line)) {
+                blocks.push([line]);
+            }
+            else if (blocks.length > 0) {
+                blocks[blocks.length - 1].push(line);
+            }
+        }
+        return blocks.map((block) => block.join('\n').trim());
+    }
+}
+//# sourceMappingURL=hcl.utility.js.map

package/dist/utilities/hcl/hcl.utility.js.map

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

package/dist/utilities/http/http.utility.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The one place octo speaks HTTP.
+ *
+ * A response is handed back whatever its status, so the caller decides what a refusal means instead
+ * of catching one. Only a request that never reached a server throws.
+ *
+ * @internal
+ */
+export declare class HttpUtility {
+    /**
+     * Downloads `url` into `filePath`, streaming it so its size is not bounded by memory. False when the
+     * server refused it or the download was cut short, which can leave part of the file behind.
+     *
+     * @internal
+     * @throws {@link TransactionError} When the host could not be reached at all.
+     */
+    static downloadToFile(url: string, filePath: string): Promise<boolean>;
+    /**
+     * What a refused request said went wrong, as one line. A service that answers a list - a failed
+     * validation usually does - is read as a sentence, and a body that is not JSON as its status.
+     *
+     * @internal
+     */
+    static readErrorMessage(response: Response): Promise<string>;
+    /**
+     * A body may be a stream, which is sent as it is read rather than held in memory. A stream's length
+     * is unknown to fetch, so a server that needs one is given `Content-Length` in `headers`.
+     *
+     * @internal
+     * @throws {@link TransactionError} When the host could not be reached at all, which is a different
+     * thing from being refused by it and is the caller's to report differently.
+     */
+    static send(url: string, { body, headers, method }?: {
+        body?: BodyInit;
+        headers?: Record<string, string>;
+        method?: string;
+    }): Promise<Response>;
+    /**
+     * {@link HttpUtility.send} with a JSON body, which is every request octo makes that carries one
+     * other than an upload.
+     *
+     * @internal
+     */
+    static sendJson(url: string, { body, headers, method }?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        method?: string;
+    }): Promise<Response>;
+    /**
+     * PUTs the file at `filePath` to `url`, streaming it so its size is not bounded by memory, with its
+     * `Content-Length`, which a presigned URL is usually signed with.
+     *
+     * @internal
+     * @throws {@link TransactionError} When the host could not be reached at all.
+     */
+    static uploadFile(url: string, filePath: string, headers?: Record<string, string>): Promise<Response>;
+}