@absolutejs/deploy 0.6.0 → 0.8.0

package/dist/hetznerDns.js

@@ -0,0 +1,169 @@
+// @bun
+// src/hetznerDns.ts
+var HETZNER_DNS_API_BASE = "https://dns.hetzner.com/api/v1";
+
+class HetznerDnsError extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.name = "HetznerDnsError";
+    this.status = status;
+    this.body = body;
+  }
+}
+var createHetznerDnsClient = (token, options = {}) => {
+  const base = options.baseUrl ?? HETZNER_DNS_API_BASE;
+  const f = options.fetch ?? fetch;
+  return {
+    request: async (method, path, body) => {
+      const init = {
+        headers: {
+          "auth-api-token": token,
+          "content-type": "application/json"
+        },
+        method
+      };
+      if (body !== undefined)
+        init.body = JSON.stringify(body);
+      const response = await f(`${base}${path}`, init);
+      if (response.status === 204)
+        return;
+      const text = await response.text();
+      const parsed = text.length > 0 ? JSON.parse(text) : undefined;
+      if (!response.ok) {
+        throw new HetznerDnsError(`Hetzner DNS API ${method} ${path} failed: ${response.status} ${response.statusText}`, response.status, parsed);
+      }
+      return parsed;
+    }
+  };
+};
+var resolveClient = (options) => {
+  if (options.client !== undefined)
+    return options.client;
+  if (options.token !== undefined && options.token.length > 0) {
+    return createHetznerDnsClient(options.token);
+  }
+  throw new Error("[deploy/hetzner-dns] either `token` or `client` must be provided");
+};
+var fqdnFromRelative = (relativeName, zoneName) => {
+  if (relativeName === "@")
+    return zoneName;
+  if (zoneName === "")
+    return relativeName;
+  if (relativeName.endsWith(`.${zoneName}`))
+    return relativeName;
+  return `${relativeName}.${zoneName}`;
+};
+var relativeFromFqdn = (fqdn, zoneName) => {
+  if (zoneName === "")
+    return fqdn;
+  const noTrailing = fqdn.endsWith(".") ? fqdn.slice(0, -1) : fqdn;
+  if (noTrailing === zoneName)
+    return "@";
+  if (noTrailing.endsWith(`.${zoneName}`)) {
+    return noTrailing.slice(0, -zoneName.length - 1);
+  }
+  return noTrailing;
+};
+var specMatchesRecord = (spec, record) => {
+  if (record.content !== spec.content)
+    return false;
+  if (spec.ttl !== undefined && record.ttl !== spec.ttl)
+    return false;
+  return true;
+};
+var hetznerDnsProvider = (options) => {
+  const client = resolveClient(options);
+  const { zoneId } = options;
+  const zoneName = options.zoneName ?? "";
+  const zoneLabel = zoneName !== "" ? zoneName : zoneId;
+  const toDnsRecord = (raw) => ({
+    content: raw.value,
+    id: raw.id,
+    name: fqdnFromRelative(raw.name, zoneName),
+    type: raw.type,
+    ...raw.ttl !== undefined ? { ttl: raw.ttl } : {}
+  });
+  const fetchAll = async () => {
+    const body = await client.request("GET", `/records?zone_id=${encodeURIComponent(zoneId)}&per_page=200`);
+    return body.records.map(toDnsRecord);
+  };
+  const list = async (filter) => {
+    const all = await fetchAll();
+    return all.filter((record) => {
+      if (filter?.name !== undefined && record.name !== filter.name) {
+        return false;
+      }
+      if (filter?.type !== undefined && record.type !== filter.type) {
+        return false;
+      }
+      return true;
+    });
+  };
+  const find = async (key) => {
+    const matches = (await fetchAll()).filter((record) => record.name === key.name && record.type === key.type);
+    if (matches.length === 0)
+      return;
+    if (matches.length > 1) {
+      throw new Error(`[deploy/hetzner-dns] multiple ${key.type} records for "${key.name}" in zone ${zoneLabel} \u2014 drifted state; resolve manually before upsert.`);
+    }
+    return matches[0];
+  };
+  const create = async (spec) => {
+    const relative = relativeFromFqdn(spec.name, zoneName);
+    const response = await client.request("POST", "/records", {
+      name: relative,
+      type: spec.type,
+      value: spec.content,
+      zone_id: zoneId,
+      ...spec.ttl !== undefined ? { ttl: spec.ttl } : {}
+    });
+    return toDnsRecord(response.record);
+  };
+  const update = async (id, spec) => {
+    const relative = relativeFromFqdn(spec.name, zoneName);
+    const response = await client.request("PUT", `/records/${id}`, {
+      name: relative,
+      type: spec.type,
+      value: spec.content,
+      zone_id: zoneId,
+      ...spec.ttl !== undefined ? { ttl: spec.ttl } : {}
+    });
+    return toDnsRecord(response.record);
+  };
+  const deleteRecord = async (id) => {
+    try {
+      await client.request("DELETE", `/records/${id}`);
+    } catch (error) {
+      if (error instanceof HetznerDnsError && error.status === 404)
+        return;
+      throw error;
+    }
+  };
+  const upsert = async (spec) => {
+    const existing = await find({ name: spec.name, type: spec.type });
+    if (existing === undefined)
+      return create(spec);
+    if (specMatchesRecord(spec, existing))
+      return existing;
+    return update(existing.id, spec);
+  };
+  return {
+    create,
+    delete: deleteRecord,
+    description: `hetzner dns zone "${zoneLabel}"`,
+    find,
+    list,
+    update,
+    upsert
+  };
+};
+export {
+  hetznerDnsProvider,
+  createHetznerDnsClient,
+  HetznerDnsError
+};
+
+//# debugId=46CBC2F7E260682464756E2164756E21
+//# sourceMappingURL=hetznerDns.js.map

package/dist/hetznerDns.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/hetznerDns.ts"],
+  "sourcesContent": [
+    "/**\n * @absolutejs/deploy/hetzner-dns — Hetzner DNS implementing the\n * {@link DnsProvider} contract from `./dns`.\n *\n * NOTE: Hetzner DNS is a SEPARATE service from Hetzner Cloud (compute).\n *   - Compute API: https://api.hetzner.cloud/v1, token = Bearer\n *   - DNS API:     https://dns.hetzner.com/api/v1, token = Auth-API-Token header\n *\n * Different auth header AND different base URL — get them confused\n * and every request fails. We use a separate client type +\n * `createHetznerDnsClient` factory to keep them distinct.\n *\n * Scope: one provider instance is bound to one zone (referenced by\n * `zoneId`). DNS record names in Hetzner are FQDN-style for the\n * apex (`'@'`) and relative for subdomains (`'api'` not\n * `'api.example.com'`).\n */\n\nimport type {\n\tDnsProvider,\n\tDnsRecord,\n\tDnsRecordFilter,\n\tDnsRecordSpec,\n\tDnsRecordType\n} from './dns';\n\nconst HETZNER_DNS_API_BASE = 'https://dns.hetzner.com/api/v1';\n\nexport type HetznerDnsClientLike = {\n\trequest: <T = unknown>(\n\t\tmethod: 'GET' | 'POST' | 'PUT' | 'DELETE',\n\t\tpath: string,\n\t\tbody?: unknown\n\t) => Promise<T>;\n};\n\ntype HetznerDnsRecordRaw = {\n\tid: string;\n\ttype: string;\n\tname: string;\n\tvalue: string;\n\tttl?: number;\n\tzone_id: string;\n};\n\nexport class HetznerDnsError extends Error {\n\treadonly status: number;\n\treadonly body: unknown;\n\tconstructor(message: string, status: number, body: unknown) {\n\t\tsuper(message);\n\t\tthis.name = 'HetznerDnsError';\n\t\tthis.status = status;\n\t\tthis.body = body;\n\t}\n}\n\n/**\n * fetch-backed default client. Uses Hetzner DNS's `Auth-API-Token`\n * header — NOT the Bearer-style auth used by Hetzner Cloud compute.\n */\nexport const createHetznerDnsClient = (\n\ttoken: string,\n\toptions: { baseUrl?: string; fetch?: typeof fetch } = {}\n): HetznerDnsClientLike => {\n\tconst base = options.baseUrl ?? HETZNER_DNS_API_BASE;\n\tconst f = options.fetch ?? fetch;\n\treturn {\n\t\trequest: async <T>(\n\t\t\tmethod: 'GET' | 'POST' | 'PUT' | 'DELETE',\n\t\t\tpath: string,\n\t\t\tbody?: unknown\n\t\t): Promise<T> => {\n\t\t\tconst init: RequestInit = {\n\t\t\t\theaders: {\n\t\t\t\t\t'auth-api-token': token,\n\t\t\t\t\t'content-type': 'application/json'\n\t\t\t\t},\n\t\t\t\tmethod\n\t\t\t};\n\t\t\tif (body !== undefined) init.body = JSON.stringify(body);\n\t\t\tconst response = await f(`${base}${path}`, init);\n\t\t\tif (response.status === 204) return undefined as T;\n\t\t\tconst text = await response.text();\n\t\t\tconst parsed = text.length > 0 ? JSON.parse(text) : undefined;\n\t\t\tif (!response.ok) {\n\t\t\t\tthrow new HetznerDnsError(\n\t\t\t\t\t`Hetzner DNS API ${method} ${path} failed: ${response.status} ${response.statusText}`,\n\t\t\t\t\tresponse.status,\n\t\t\t\t\tparsed\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn parsed as T;\n\t\t}\n\t};\n};\n\nexport type HetznerDnsProviderOptions = {\n\ttoken?: string;\n\tclient?: HetznerDnsClientLike;\n\t/** Hetzner DNS zone id (UUID-shaped). */\n\tzoneId: string;\n\t/** Optional zone name for log + record-name conversion. */\n\tzoneName?: string;\n};\n\nconst resolveClient = (\n\toptions: Pick<HetznerDnsProviderOptions, 'client' | 'token'>\n): HetznerDnsClientLike => {\n\tif (options.client !== undefined) return options.client;\n\tif (options.token !== undefined && options.token.length > 0) {\n\t\treturn createHetznerDnsClient(options.token);\n\t}\n\tthrow new Error(\n\t\t'[deploy/hetzner-dns] either `token` or `client` must be provided'\n\t);\n};\n\nconst fqdnFromRelative = (relativeName: string, zoneName: string): string => {\n\tif (relativeName === '@') return zoneName;\n\tif (zoneName === '') return relativeName;\n\tif (relativeName.endsWith(`.${zoneName}`)) return relativeName;\n\treturn `${relativeName}.${zoneName}`;\n};\n\nconst relativeFromFqdn = (fqdn: string, zoneName: string): string => {\n\tif (zoneName === '') return fqdn;\n\tconst noTrailing = fqdn.endsWith('.') ? fqdn.slice(0, -1) : fqdn;\n\tif (noTrailing === zoneName) return '@';\n\tif (noTrailing.endsWith(`.${zoneName}`)) {\n\t\treturn noTrailing.slice(0, -zoneName.length - 1);\n\t}\n\treturn noTrailing;\n};\n\nconst specMatchesRecord = (spec: DnsRecordSpec, record: DnsRecord): boolean => {\n\tif (record.content !== spec.content) return false;\n\tif (spec.ttl !== undefined && record.ttl !== spec.ttl) return false;\n\treturn true;\n};\n\nexport const hetznerDnsProvider = (\n\toptions: HetznerDnsProviderOptions\n): DnsProvider => {\n\tconst client = resolveClient(options);\n\tconst { zoneId } = options;\n\tconst zoneName = options.zoneName ?? '';\n\tconst zoneLabel = zoneName !== '' ? zoneName : zoneId;\n\n\tconst toDnsRecord = (raw: HetznerDnsRecordRaw): DnsRecord => ({\n\t\tcontent: raw.value,\n\t\tid: raw.id,\n\t\tname: fqdnFromRelative(raw.name, zoneName),\n\t\ttype: raw.type as DnsRecordType,\n\t\t...(raw.ttl !== undefined ? { ttl: raw.ttl } : {})\n\t});\n\n\tconst fetchAll = async (): Promise<DnsRecord[]> => {\n\t\tconst body = await client.request<{ records: HetznerDnsRecordRaw[] }>(\n\t\t\t'GET',\n\t\t\t`/records?zone_id=${encodeURIComponent(zoneId)}&per_page=200`\n\t\t);\n\t\treturn body.records.map(toDnsRecord);\n\t};\n\n\tconst list = async (filter?: DnsRecordFilter): Promise<DnsRecord[]> => {\n\t\tconst all = await fetchAll();\n\t\treturn all.filter((record) => {\n\t\t\tif (filter?.name !== undefined && record.name !== filter.name) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tif (filter?.type !== undefined && record.type !== filter.type) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\treturn true;\n\t\t});\n\t};\n\n\tconst find = async (key: {\n\t\tname: string;\n\t\ttype: DnsRecordType;\n\t}): Promise<DnsRecord | undefined> => {\n\t\tconst matches = (await fetchAll()).filter(\n\t\t\t(record) => record.name === key.name && record.type === key.type\n\t\t);\n\t\tif (matches.length === 0) return undefined;\n\t\tif (matches.length > 1) {\n\t\t\tthrow new Error(\n\t\t\t\t`[deploy/hetzner-dns] multiple ${key.type} records for \"${key.name}\" in zone ${zoneLabel} — drifted state; resolve manually before upsert.`\n\t\t\t);\n\t\t}\n\t\treturn matches[0];\n\t};\n\n\tconst create = async (spec: DnsRecordSpec): Promise<DnsRecord> => {\n\t\tconst relative = relativeFromFqdn(spec.name, zoneName);\n\t\tconst response = await client.request<{ record: HetznerDnsRecordRaw }>(\n\t\t\t'POST',\n\t\t\t'/records',\n\t\t\t{\n\t\t\t\tname: relative,\n\t\t\t\ttype: spec.type,\n\t\t\t\tvalue: spec.content,\n\t\t\t\tzone_id: zoneId,\n\t\t\t\t...(spec.ttl !== undefined ? { ttl: spec.ttl } : {})\n\t\t\t}\n\t\t);\n\t\treturn toDnsRecord(response.record);\n\t};\n\n\tconst update = async (\n\t\tid: string,\n\t\tspec: DnsRecordSpec\n\t): Promise<DnsRecord> => {\n\t\tconst relative = relativeFromFqdn(spec.name, zoneName);\n\t\tconst response = await client.request<{ record: HetznerDnsRecordRaw }>(\n\t\t\t'PUT',\n\t\t\t`/records/${id}`,\n\t\t\t{\n\t\t\t\tname: relative,\n\t\t\t\ttype: spec.type,\n\t\t\t\tvalue: spec.content,\n\t\t\t\tzone_id: zoneId,\n\t\t\t\t...(spec.ttl !== undefined ? { ttl: spec.ttl } : {})\n\t\t\t}\n\t\t);\n\t\treturn toDnsRecord(response.record);\n\t};\n\n\tconst deleteRecord = async (id: string): Promise<void> => {\n\t\ttry {\n\t\t\tawait client.request('DELETE', `/records/${id}`);\n\t\t} catch (error) {\n\t\t\tif (error instanceof HetznerDnsError && error.status === 404) return;\n\t\t\tthrow error;\n\t\t}\n\t};\n\n\tconst upsert = async (spec: DnsRecordSpec): Promise<DnsRecord> => {\n\t\tconst existing = await find({ name: spec.name, type: spec.type });\n\t\tif (existing === undefined) return create(spec);\n\t\tif (specMatchesRecord(spec, existing)) return existing;\n\t\treturn update(existing.id, spec);\n\t};\n\n\treturn {\n\t\tcreate,\n\t\tdelete: deleteRecord,\n\t\tdescription: `hetzner dns zone \"${zoneLabel}\"`,\n\t\tfind,\n\t\tlist,\n\t\tupdate,\n\t\tupsert\n\t};\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "46CBC2F7E260682464756E2164756E21",
+  "names": []
+}

package/dist/linode.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @absolutejs/deploy/linode — provision-or-reuse Target adapter for
+ * Linode (Akamai Cloud) instances. Sibling to digitalOceanTarget +
+ * hetznerTarget; same shape, Linode v4 API mappings.
+ *
+ * Idempotent by label — Linode allows duplicate labels per account
+ * but we treat duplicates as drifted state (throw on the second).
+ *
+ * Narrow LinodeClientLike interface keeps `@linode/api-v4` out as a
+ * hard dep. Default client uses `fetch` against `api.linode.com/v4`.
+ */
+import type { Target } from './targets';
+export type LinodeClientLike = {
+    request: <T = unknown>(method: 'GET' | 'POST' | 'DELETE', path: string, body?: unknown) => Promise<T>;
+};
+/** A Linode instance, narrowed to what we inspect. */
+export type LinodeInstance = {
+    id: number;
+    label: string;
+    status: 'running' | 'offline' | 'booting' | 'rebooting' | 'shutting_down' | 'provisioning' | 'deleting' | 'migrating' | 'rebuilding' | 'cloning' | 'restoring' | 'stopped';
+    /** Linode returns IPv4 as a flat string array; public IPs first. */
+    ipv4: string[];
+    region?: string;
+    type?: string;
+    tags?: string[];
+};
+export type LinodeTargetOptions = {
+    /** Linode Personal Access Token. Required unless `client` is set. */
+    token?: string;
+    /** Custom client. Overrides token-built default. */
+    client?: LinodeClientLike;
+    /** Instance label. Idempotency key. */
+    name: string;
+    /** Region slug — `'us-east'`, `'us-west'`, `'ap-south'`, etc. */
+    region: string;
+    /** Type slug — `'g6-nanode-1'`, `'g6-standard-1'`, etc. */
+    type: string;
+    /** Image slug — e.g. `'linode/ubuntu22.04'`. */
+    image: string;
+    /**
+     * SSH public keys (raw `ssh-rsa AAAA…` / `ssh-ed25519 AAAA…` strings)
+     * authorized for root login. At least one required for a usable target.
+     */
+    sshKeys: ReadonlyArray<string>;
+    /** Tags applied to the instance. */
+    tags?: ReadonlyArray<string>;
+    /** Cloud-init / StackScript user data, base64-encoded by us. */
+    userData?: string;
+    /**
+     * Root password. Linode requires a password at creation. Defaults to
+     * a random 32-char string — you should rely on `sshKeys` and never
+     * type this. Override only if you have a specific reason.
+     */
+    rootPass?: string;
+    /** Enable private IP. Default false. */
+    privateIp?: boolean;
+    /** Enable backups. Default false. */
+    backupsEnabled?: boolean;
+    /** SSH login user. Default `'root'`. */
+    user?: string;
+    /** SSH identity file. */
+    identity?: string;
+    /** SSH port. Default 22. */
+    port?: number;
+    provisionTimeoutMs?: number;
+    sshReadinessTimeoutMs?: number;
+    pollIntervalMs?: number;
+    onLog?: (line: string) => void;
+    probeSsh?: (host: string, port: number) => Promise<boolean>;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+};
+export type LinodeTarget = Target & {
+    readonly instanceId: number;
+    readonly ipv4: string;
+    destroy: () => Promise<void>;
+};
+export declare class LinodeError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export declare const createLinodeClient: (token: string, options?: {
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}) => LinodeClientLike;
+/** Find an instance by label. Throws on ambiguous duplicates. */
+export declare const findLinodeInstance: (client: LinodeClientLike, name: string) => Promise<LinodeInstance | undefined>;
+export declare const listLinodeInstances: (options: {
+    token?: string;
+    client?: LinodeClientLike;
+    tag?: string;
+}) => Promise<LinodeInstance[]>;
+export declare const destroyLinodeInstance: (options: {
+    token?: string;
+    client?: LinodeClientLike;
+    id: number;
+}) => Promise<void>;
+export declare const linodeTarget: (options: LinodeTargetOptions) => Promise<LinodeTarget>;