blogwright-core 0.1.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Ant Stanley
+
+Portions of packages/cli/src/pds/rkey.ts are vendored from
+https://github.com/mastrojs/atproto (MIT License, © 2025 Mastro).
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# blogwright-core
+
+SigV4 transport, per-service AWS HTTP clients, config parsing, and the S3 state store
+used by [blogwright](https://www.npmjs.com/package/blogwright). Not useful on its
+own — install `blogwright` instead.
+
+Full documentation: https://github.com/antstanley/blogwright

package/dist/adapters/memory-fs.d.ts

@@ -0,0 +1,9 @@
+/** In-memory adapter for the FileSystem port, for tests. */
+import { type FileSystem } from '../ports.js';
+/**
+ * Build a Map-backed FileSystem seeded with `initialFiles` (path → content).
+ * Contents are text; `readBytes` returns the UTF-8 encoding. A directory
+ * "exists" when any file lives under it; inspect writes back through
+ * `readText`/`listFiles`.
+ */
+export declare function createMemoryFileSystem(initialFiles?: Record<string, string>): FileSystem;

package/dist/adapters/memory-fs.js

@@ -0,0 +1,54 @@
+/** In-memory adapter for the FileSystem port, for tests. */
+import { posix } from 'node:path';
+import { FileNotFoundError } from '../ports.js';
+function normalise(path) {
+    return posix.resolve('/', path);
+}
+function directoryPrefix(path) {
+    return path === '/' ? '/' : `${path}/`;
+}
+/**
+ * Build a Map-backed FileSystem seeded with `initialFiles` (path → content).
+ * Contents are text; `readBytes` returns the UTF-8 encoding. A directory
+ * "exists" when any file lives under it; inspect writes back through
+ * `readText`/`listFiles`.
+ */
+export function createMemoryFileSystem(initialFiles = {}) {
+    const files = new Map(Object.entries(initialFiles).map(([path, content]) => [normalise(path), content]));
+    function isDirectory(path) {
+        const prefix = directoryPrefix(path);
+        return [...files.keys()].some((key) => key.startsWith(prefix));
+    }
+    function contentOf(path) {
+        const content = files.get(normalise(path));
+        if (content === undefined)
+            throw new FileNotFoundError(path);
+        return content;
+    }
+    return {
+        async readText(path) {
+            return contentOf(path);
+        },
+        async readBytes(path) {
+            return new TextEncoder().encode(contentOf(path));
+        },
+        async writeText(path, text) {
+            files.set(normalise(path), text);
+        },
+        async exists(path) {
+            const key = normalise(path);
+            return files.has(key) || isDirectory(key);
+        },
+        async listFiles(dir) {
+            const key = normalise(dir);
+            if (!isDirectory(key))
+                throw new FileNotFoundError(dir);
+            const prefix = directoryPrefix(key);
+            return [...files.keys()]
+                .filter((path) => path.startsWith(prefix))
+                .map((path) => path.slice(prefix.length))
+                .sort();
+        },
+    };
+}
+//# sourceMappingURL=memory-fs.js.map

package/dist/adapters/memory-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-fs.js","sourceRoot":"","sources":["../../src/adapters/memory-fs.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAmB,MAAM,aAAa,CAAC;AAEjE,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,eAAuC,EAAE;IAC9E,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAClF,CAAC;IAEF,SAAS,WAAW,CAAC,IAAY;QAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,SAAS,SAAS,CAAC,IAAY;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,IAAY;YACzB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,IAAY;YAC1B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,IAAY;YACxC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAY;YACvB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,GAAW;YACzB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;iBACrB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;iBACzC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBACxC,IAAI,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/node-fs.d.ts

@@ -0,0 +1,4 @@
+/** Node adapter for the FileSystem port (real disk I/O via node:fs). */
+import { type FileSystem } from '../ports.js';
+/** Build the real-disk FileSystem adapter. */
+export declare function createNodeFileSystem(): FileSystem;

package/dist/adapters/node-fs.js

@@ -0,0 +1,65 @@
+/** Node adapter for the FileSystem port (real disk I/O via node:fs). */
+import { mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { dirname, join, relative } from 'node:path';
+import { FileNotFoundError } from '../ports.js';
+function isAbsence(err) {
+    const code = err.code;
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+function contextualise(operation, path, err) {
+    return new Error(`${operation} ${path} failed: ${err.message}`, { cause: err });
+}
+/** Build the real-disk FileSystem adapter. */
+export function createNodeFileSystem() {
+    return {
+        async readText(path) {
+            try {
+                return await readFile(path, 'utf8');
+            }
+            catch (err) {
+                throw isAbsence(err) ? new FileNotFoundError(path) : contextualise('reading', path, err);
+            }
+        },
+        async readBytes(path) {
+            try {
+                return await readFile(path);
+            }
+            catch (err) {
+                throw isAbsence(err) ? new FileNotFoundError(path) : contextualise('reading', path, err);
+            }
+        },
+        async writeText(path, text) {
+            try {
+                await mkdir(dirname(path), { recursive: true });
+                await writeFile(path, text);
+            }
+            catch (err) {
+                throw contextualise('writing', path, err);
+            }
+        },
+        async exists(path) {
+            try {
+                await stat(path);
+                return true;
+            }
+            catch (err) {
+                if (isAbsence(err))
+                    return false;
+                throw contextualise('checking', path, err);
+            }
+        },
+        async listFiles(dir) {
+            try {
+                const entries = await readdir(dir, { recursive: true, withFileTypes: true });
+                return entries
+                    .filter((entry) => entry.isFile())
+                    .map((entry) => relative(dir, join(entry.parentPath, entry.name)))
+                    .sort();
+            }
+            catch (err) {
+                throw isAbsence(err) ? new FileNotFoundError(dir) : contextualise('listing', dir, err);
+            }
+        },
+    };
+}
+//# sourceMappingURL=node-fs.js.map

package/dist/adapters/node-fs.js.map

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

package/dist/adapters/node-terminal.d.ts

@@ -0,0 +1,29 @@
+/** Node adapter for the Terminal port (process streams + node:readline). */
+import type { Terminal } from '../ports.js';
+/** The standard streams the adapter owns; injectable for adapter tests only. */
+export interface TerminalStreams {
+    input: NodeJS.ReadableStream & {
+        isTTY?: boolean | undefined;
+    };
+    output: NodeJS.WritableStream & {
+        isTTY?: boolean | undefined;
+    };
+    errorOutput: NodeJS.WritableStream;
+}
+export interface NodeTerminalOptions extends Partial<TerminalStreams> {
+    /**
+     * Force the minimal, machine-friendly presentation (`--plain`): the terminal
+     * reports non-interactive, so output is plain durable lines — no colour, no
+     * transient status, no prompts left hanging for automation.
+     */
+    plain?: boolean | undefined;
+    /** Disable colour only (https://no-color.org). Defaults to the NO_COLOR env var. */
+    noColor?: boolean | undefined;
+}
+/**
+ * Build the real Terminal adapter over the process's standard streams. TTY
+ * state is read once, at construction — never at module load or per call.
+ * The transient status line exists only on an interactive TTY; `write`/`error`
+ * clear it first so durable lines never interleave with a stale status.
+ */
+export declare function createNodeTerminal(options?: NodeTerminalOptions): Terminal;

package/dist/adapters/node-terminal.js

@@ -0,0 +1,58 @@
+/** Node adapter for the Terminal port (process streams + node:readline). */
+import { createInterface } from 'node:readline/promises';
+import { stripColors } from '../colors.js';
+const CLEAR_LINE = '\r\u001B[2K';
+/**
+ * Build the real Terminal adapter over the process's standard streams. TTY
+ * state is read once, at construction — never at module load or per call.
+ * The transient status line exists only on an interactive TTY; `write`/`error`
+ * clear it first so durable lines never interleave with a stale status.
+ */
+export function createNodeTerminal(options = {}) {
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stdout;
+    const errorOutput = options.errorOutput ?? process.stderr;
+    const plain = options.plain === true;
+    const noColor = options.noColor ?? Boolean(process.env.NO_COLOR);
+    const interactive = !plain && input.isTTY === true && output.isTTY === true;
+    const paint = (line) => (noColor || plain ? stripColors(line) : line);
+    let statusShown = false;
+    const clearStatus = () => {
+        if (!statusShown)
+            return;
+        output.write(CLEAR_LINE);
+        statusShown = false;
+    };
+    return {
+        isInteractive: interactive,
+        write(line) {
+            clearStatus();
+            output.write(`${paint(line)}\n`);
+        },
+        error(line) {
+            clearStatus();
+            errorOutput.write(`${paint(line)}\n`);
+        },
+        status(line) {
+            if (!interactive)
+                return;
+            if (line === '') {
+                clearStatus();
+                return;
+            }
+            output.write(`${CLEAR_LINE}${paint(line)}`);
+            statusShown = true;
+        },
+        async question(prompt) {
+            clearStatus();
+            const readline = createInterface({ input, output });
+            try {
+                return await readline.question(paint(prompt));
+            }
+            finally {
+                readline.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=node-terminal.js.map

package/dist/adapters/node-terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-terminal.js","sourceRoot":"","sources":["../../src/adapters/node-terminal.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAqB3C,MAAM,UAAU,GAAG,aAAa,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;IAC5E,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzB,WAAW,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,WAAW;QAE1B,KAAK,CAAC,IAAY;YAChB,WAAW,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,CAAC,IAAY;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,CAAC,IAAY;YACjB,IAAI,CAAC,WAAW;gBAAE,OAAO;YACzB,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;gBAChB,WAAW,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5C,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,MAAc;YAC3B,WAAW,EAAE,CAAC;YACd,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAChD,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/script-terminal.d.ts

@@ -0,0 +1,22 @@
+/** Scripted in-memory adapter for the Terminal port, for tests. */
+import type { Terminal } from '../ports.js';
+/** A Terminal that captures output and answers prompts from a script. */
+export interface ScriptedTerminal extends Terminal {
+    /** Lines written to standard output, in order. */
+    readonly writes: string[];
+    /** Lines written to standard error, in order. */
+    readonly errors: string[];
+    /** Transient status lines, in order ('' is a clear). */
+    readonly statuses: string[];
+    /** Prompts shown by `question`, in order. */
+    readonly prompts: string[];
+}
+/**
+ * Build a scripted Terminal. It reports interactive unless told otherwise
+ * (a scripted terminal exists to answer prompts) and hands out `answers` in
+ * order; a question beyond the script throws so a test never hangs on input.
+ */
+export declare function createScriptedTerminal(options?: {
+    interactive?: boolean | undefined;
+    answers?: string[] | undefined;
+}): ScriptedTerminal;

package/dist/adapters/script-terminal.js

@@ -0,0 +1,38 @@
+/** Scripted in-memory adapter for the Terminal port, for tests. */
+/**
+ * Build a scripted Terminal. It reports interactive unless told otherwise
+ * (a scripted terminal exists to answer prompts) and hands out `answers` in
+ * order; a question beyond the script throws so a test never hangs on input.
+ */
+export function createScriptedTerminal(options = {}) {
+    const pendingAnswers = [...(options.answers ?? [])];
+    const writes = [];
+    const errors = [];
+    const statuses = [];
+    const prompts = [];
+    return {
+        isInteractive: options.interactive ?? true,
+        writes,
+        errors,
+        statuses,
+        prompts,
+        write(line) {
+            writes.push(line);
+        },
+        error(line) {
+            errors.push(line);
+        },
+        status(line) {
+            statuses.push(line);
+        },
+        async question(prompt) {
+            prompts.push(prompt);
+            const answer = pendingAnswers.shift();
+            if (answer === undefined) {
+                throw new Error(`scripted terminal has no answer left for prompt: ${prompt}`);
+            }
+            return answer;
+        },
+    };
+}
+//# sourceMappingURL=script-terminal.js.map

package/dist/adapters/script-terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-terminal.js","sourceRoot":"","sources":["../../src/adapters/script-terminal.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAgBnE;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAiF,EAAE;IAEnF,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QAC1C,MAAM;QACN,MAAM;QACN,QAAQ;QACR,OAAO;QAEP,KAAK,CAAC,IAAY;YAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,IAAY;YAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAED,MAAM,CAAC,IAAY;YACjB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,MAAc;YAC3B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,oDAAoD,MAAM,EAAE,CAAC,CAAC;YAChF,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/aws/acm.d.ts

@@ -0,0 +1,20 @@
+import type { SigningClient } from './signer.js';
+export interface DomainValidationRecord {
+    name: string;
+    type: string;
+    value: string;
+}
+export interface CertificateStatus {
+    status: string;
+    validation: DomainValidationRecord[];
+}
+/** ACM client (AWS JSON 1.1). Certificates for CloudFront must live in us-east-1. */
+export declare class AcmClient {
+    private readonly client;
+    constructor(client: SigningClient);
+    private call;
+    /** Request a DNS-validated certificate and return its ARN. */
+    requestCertificate(domainName: string, idempotencyToken: string): Promise<string>;
+    describeCertificate(certificateArn: string): Promise<CertificateStatus>;
+    deleteCertificate(certificateArn: string): Promise<void>;
+}

package/dist/aws/acm.js

@@ -0,0 +1,55 @@
+import { AwsError } from './errors.js';
+const TARGET = 'CertificateManager';
+/** ACM client (AWS JSON 1.1). Certificates for CloudFront must live in us-east-1. */
+export class AcmClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async call(op, payload) {
+        const res = await this.client.send({
+            service: 'acm',
+            method: 'POST',
+            path: '/',
+            headers: {
+                'content-type': 'application/x-amz-json-1.1',
+                'x-amz-target': `${TARGET}.${op}`,
+            },
+            body: JSON.stringify(payload),
+        });
+        const text = res.text();
+        return (text ? JSON.parse(text) : {});
+    }
+    /** Request a DNS-validated certificate and return its ARN. */
+    async requestCertificate(domainName, idempotencyToken) {
+        const out = await this.call('RequestCertificate', {
+            DomainName: domainName,
+            ValidationMethod: 'DNS',
+            IdempotencyToken: idempotencyToken,
+        });
+        return out.CertificateArn;
+    }
+    async describeCertificate(certificateArn) {
+        const out = await this.call('DescribeCertificate', { CertificateArn: certificateArn });
+        const cert = out.Certificate ?? {};
+        const validation = [];
+        for (const opt of cert.DomainValidationOptions ?? []) {
+            const rr = opt.ResourceRecord;
+            if (rr?.Name && rr.Type && rr.Value) {
+                validation.push({ name: rr.Name, type: rr.Type, value: rr.Value });
+            }
+        }
+        return { status: cert.Status ?? 'PENDING_VALIDATION', validation };
+    }
+    async deleteCertificate(certificateArn) {
+        try {
+            await this.call('DeleteCertificate', { CertificateArn: certificateArn });
+        }
+        catch (err) {
+            if (err instanceof AwsError && err.isNotFound)
+                return;
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=acm.js.map

package/dist/aws/acm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acm.js","sourceRoot":"","sources":["../../src/aws/acm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,MAAM,GAAG,oBAAoB,CAAC;AAapC,qFAAqF;AACrF,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE9C,KAAK,CAAC,IAAI,CAAI,EAAU,EAAE,OAAe;QAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACjC,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG;YACT,OAAO,EAAE;gBACP,cAAc,EAAE,4BAA4B;gBAC5C,cAAc,EAAE,GAAG,MAAM,IAAI,EAAE,EAAE;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAM,CAAC;IAC7C,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,kBAAkB,CAAC,UAAkB,EAAE,gBAAwB;QACnE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAA6B,oBAAoB,EAAE;YAC5E,UAAU,EAAE,UAAU;YACtB,gBAAgB,EAAE,KAAK;YACvB,gBAAgB,EAAE,gBAAgB;SACnC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,cAAc,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,cAAsB;QAC9C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAOxB,qBAAqB,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC;QAE9D,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QACnC,MAAM,UAAU,GAA6B,EAAE,CAAC;QAChD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,uBAAuB,IAAI,EAAE,EAAE,CAAC;YACrD,MAAM,EAAE,GAAG,GAAG,CAAC,cAAc,CAAC;YAC9B,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gBACpC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,oBAAoB,EAAE,UAAU,EAAE,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,cAAsB;QAC5C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,UAAU;gBAAE,OAAO;YACtD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/aws/cloudfront.d.ts

@@ -0,0 +1,72 @@
+import type { SigningClient } from './signer.js';
+/** AWS managed "CachingOptimized" cache policy. */
+export declare const CACHING_OPTIMIZED = "658327ea-f89d-4fab-a63d-7e88639e58f6";
+/** AWS managed "CachingDisabled" cache policy (used for previews — no CDN caching). */
+export declare const CACHING_DISABLED = "4135ea2d-6df8-44a3-9df3-4b5a84be39ad";
+export interface DistributionSummary {
+    id: string;
+    arn: string;
+    domainName: string;
+    status: string;
+    etag: string | undefined;
+}
+export interface DistributionConfigInput {
+    callerReference: string;
+    comment: string;
+    bucketDomainName: string;
+    originPath: string;
+    originAccessControlId: string;
+    defaultRootObject: string;
+    aliases: string[];
+    acmCertificateArn: string | undefined;
+    /** Managed cache policy id (defaults to CachingOptimized). */
+    cachePolicyId?: string | undefined;
+    /** CloudFront Function ARN to associate on viewer-request (for preview routing). */
+    functionArn?: string | undefined;
+    /** Custom error responses (e.g. map the S3 REST origin's 403 for a missing key to /404.html). */
+    customErrorResponses?: CustomErrorResponse[] | undefined;
+}
+export interface CustomErrorResponse {
+    errorCode: number;
+    responsePagePath: string;
+    responseCode: number;
+    /** Seconds CloudFront caches the error response before re-querying the origin. */
+    errorCachingMinTtl?: number | undefined;
+}
+/** CloudFront client (REST-XML). Global service, signed in us-east-1. */
+export declare class CloudFrontClient {
+    private readonly client;
+    constructor(client: SigningClient);
+    createOriginAccessControl(name: string): Promise<string>;
+    deleteOriginAccessControl(id: string): Promise<void>;
+    createDistribution(input: DistributionConfigInput): Promise<DistributionSummary>;
+    getDistribution(id: string): Promise<DistributionSummary | undefined>;
+    /** Fetch the raw DistributionConfig XML plus its ETag (needed to update/disable). */
+    getDistributionConfig(id: string): Promise<{
+        config: string;
+        etag: string;
+    } | undefined>;
+    /**
+     * Reconcile the distribution's aliases and viewer certificate in place — the
+     * path taken when a domain is added (or changed) after the distribution was
+     * first created. Compares semantically (CNAME set + certificate ARN), since
+     * the returned config carries legacy elements our builder never emits.
+     * Returns true when a change was pushed.
+     */
+    setDistributionAliases(id: string, aliases: string[], acmCertificateArn: string | undefined): Promise<boolean>;
+    /**
+     * Disable a distribution by flipping its top-level `<Enabled>` to false. The config
+     * also contains `<Enabled>false</Enabled>` inside TrustedSigners/Logging, so the
+     * distribution-level flag must be matched specifically — it is the one immediately
+     * followed by `<ViewerCertificate>` in the schema.
+     */
+    disableDistribution(id: string): Promise<void>;
+    deleteDistribution(id: string): Promise<void>;
+    /** Invalidate paths (defaults to everything). Returns the invalidation id. */
+    createInvalidation(id: string, paths: string[], reference: string): Promise<string>;
+    private functionBody;
+    private describeFunction;
+    /** Create-or-update the function code and publish it. Returns the published ARN. */
+    ensureFunction(name: string, code: string, comment: string): Promise<string>;
+    deleteFunction(name: string): Promise<void>;
+}