@geekmidas/cli 0.53.0 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# @geekmidas/cli
+
+## 1.0.0
+
+### Major Changes
+
+- [`ff7b115`](https://github.com/geekmidas/toolbox/commit/ff7b11599f60f84ac6cdc73714c853ecf786b2e8) Thanks [@geekmidas](https://github.com/geekmidas)! - Version 1 Stable release
+
+### Patch Changes
+
+- Updated dependencies [[`ff7b115`](https://github.com/geekmidas/toolbox/commit/ff7b11599f60f84ac6cdc73714c853ecf786b2e8)]:
+  - @geekmidas/constructs@1.0.0
+  - @geekmidas/envkit@1.0.0
+  - @geekmidas/errors@1.0.0
+  - @geekmidas/logger@1.0.0
+  - @geekmidas/schema@1.0.0
+  - @geekmidas/telescope@1.0.0

package/README.md

@@ -840,11 +840,32 @@ gkm deploy --provider docker --stage production --tag v1.0.0
 ```
 
 **Workflow:**
-1. Builds production bundle with `gkm build --provider server --production --stage <stage>`
-2. Encrypts secrets from `.gkm/secrets/<stage>.json` into the bundle
-3. Generates Docker files with `gkm docker`
-4. Builds and pushes Docker image
-5. (Dokploy) Triggers deployment via API with `GKM_MASTER_KEY`
+1. **Sniffs environment variables** - Automatically detects which env vars each app needs
+2. Builds production bundle with `gkm build --provider server --production --stage <stage>`
+3. Encrypts secrets from `.gkm/secrets/<stage>.json` into the bundle
+4. Generates Docker files with `gkm docker`
+5. Builds and pushes Docker image
+6. (Dokploy) Triggers deployment via API with `GKM_MASTER_KEY`
+
+**Environment Variable Detection:**
+
+The deploy command automatically detects required environment variables for each app using different strategies based on app configuration:
+
+| App Type | Detection Strategy |
+|----------|-------------------|
+| Frontend apps | Returns empty (no server secrets) |
+| Apps with `requiredEnv` | Uses explicit list from config |
+| Entry-based apps | Imports entry file in subprocess to capture `config.parse()` calls |
+| Route-based apps | Loads routes and calls `getEnvironment()` on each construct |
+| Apps with `envParser` only | Runs SnifferEnvironmentParser to detect usage |
+
+For route-based apps, the sniffer loads each endpoint/function/cron/subscriber and collects environment variables from:
+- All services attached to the construct (via `service.register()`)
+- Publisher service (if any)
+- Auditor storage service (if any)
+- Database service (if any)
+
+This allows the CLI to validate that all required secrets are configured before deployment, preventing runtime errors from missing environment variables.
 
 **Configuration:**
 

package/dist/CachedStateProvider-D73dCqfH.cjs

@@ -0,0 +1,60 @@
+
+//#region src/deploy/CachedStateProvider.ts
+/**
+* Cached state provider that wraps a remote provider with local cache.
+*/
+var CachedStateProvider = class {
+	constructor(remote, local) {
+		this.remote = remote;
+		this.local = local;
+	}
+	async read(stage) {
+		const localState = await this.local.read(stage);
+		if (localState) return localState;
+		const remoteState = await this.remote.read(stage);
+		if (remoteState) await this.local.write(stage, remoteState);
+		return remoteState;
+	}
+	async write(stage, state) {
+		await this.remote.write(stage, state);
+		await this.local.write(stage, state);
+	}
+	/**
+	* Force pull from remote to local.
+	* Used by `gkm state pull` command.
+	*/
+	async pull(stage) {
+		const remoteState = await this.remote.read(stage);
+		if (remoteState) await this.local.write(stage, remoteState);
+		return remoteState;
+	}
+	/**
+	* Force push from local to remote.
+	* Used by `gkm state push` command.
+	*/
+	async push(stage) {
+		const localState = await this.local.read(stage);
+		if (localState) await this.remote.write(stage, localState);
+		return localState;
+	}
+	/**
+	* Get both local and remote state for comparison.
+	* Used by `gkm state diff` command.
+	*/
+	async diff(stage) {
+		const [local, remote] = await Promise.all([this.local.read(stage), this.remote.read(stage)]);
+		return {
+			local,
+			remote
+		};
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'CachedStateProvider', {
+  enumerable: true,
+  get: function () {
+    return CachedStateProvider;
+  }
+});
+//# sourceMappingURL=CachedStateProvider-D73dCqfH.cjs.map

package/dist/CachedStateProvider-D73dCqfH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CachedStateProvider-D73dCqfH.cjs","names":["remote: StateProvider","local: StateProvider","stage: string","state: DokployStageState"],"sources":["../src/deploy/CachedStateProvider.ts"],"sourcesContent":["/**\n * Cached State Provider\n *\n * Wraps a remote state provider (SSM) with local filesystem cache.\n * - Read: Local first, then remote if missing\n * - Write: Remote first, then update local cache\n *\n * This enables fast local development while keeping SSM as source of truth.\n */\n\nimport type { StateProvider } from './StateProvider';\nimport type { DokployStageState } from './state';\n\n/**\n * Cached state provider that wraps a remote provider with local cache.\n */\nexport class CachedStateProvider implements StateProvider {\n\tconstructor(\n\t\tprivate readonly remote: StateProvider,\n\t\tprivate readonly local: StateProvider,\n\t) {}\n\n\tasync read(stage: string): Promise<DokployStageState | null> {\n\t\t// Try local cache first\n\t\tconst localState = await this.local.read(stage);\n\t\tif (localState) {\n\t\t\treturn localState;\n\t\t}\n\n\t\t// Fall back to remote\n\t\tconst remoteState = await this.remote.read(stage);\n\t\tif (remoteState) {\n\t\t\t// Update local cache\n\t\t\tawait this.local.write(stage, remoteState);\n\t\t}\n\n\t\treturn remoteState;\n\t}\n\n\tasync write(stage: string, state: DokployStageState): Promise<void> {\n\t\t// Write to remote first (source of truth)\n\t\tawait this.remote.write(stage, state);\n\n\t\t// Update local cache\n\t\tawait this.local.write(stage, state);\n\t}\n\n\t/**\n\t * Force pull from remote to local.\n\t * Used by `gkm state pull` command.\n\t */\n\tasync pull(stage: string): Promise<DokployStageState | null> {\n\t\tconst remoteState = await this.remote.read(stage);\n\t\tif (remoteState) {\n\t\t\tawait this.local.write(stage, remoteState);\n\t\t}\n\t\treturn remoteState;\n\t}\n\n\t/**\n\t * Force push from local to remote.\n\t * Used by `gkm state push` command.\n\t */\n\tasync push(stage: string): Promise<DokployStageState | null> {\n\t\tconst localState = await this.local.read(stage);\n\t\tif (localState) {\n\t\t\tawait this.remote.write(stage, localState);\n\t\t}\n\t\treturn localState;\n\t}\n\n\t/**\n\t * Get both local and remote state for comparison.\n\t * Used by `gkm state diff` command.\n\t */\n\tasync diff(stage: string): Promise<{\n\t\tlocal: DokployStageState | null;\n\t\tremote: DokployStageState | null;\n\t}> {\n\t\tconst [local, remote] = await Promise.all([\n\t\t\tthis.local.read(stage),\n\t\t\tthis.remote.read(stage),\n\t\t]);\n\t\treturn { local, remote };\n\t}\n}\n"],"mappings":";;;;;AAgBA,IAAa,sBAAb,MAA0D;CACzD,YACkBA,QACAC,OAChB;EAFgB;EACA;CACd;CAEJ,MAAM,KAAKC,OAAkD;EAE5D,MAAM,aAAa,MAAM,KAAK,MAAM,KAAK,MAAM;AAC/C,MAAI,WACH,QAAO;EAIR,MAAM,cAAc,MAAM,KAAK,OAAO,KAAK,MAAM;AACjD,MAAI,YAEH,OAAM,KAAK,MAAM,MAAM,OAAO,YAAY;AAG3C,SAAO;CACP;CAED,MAAM,MAAMA,OAAeC,OAAyC;AAEnE,QAAM,KAAK,OAAO,MAAM,OAAO,MAAM;AAGrC,QAAM,KAAK,MAAM,MAAM,OAAO,MAAM;CACpC;;;;;CAMD,MAAM,KAAKD,OAAkD;EAC5D,MAAM,cAAc,MAAM,KAAK,OAAO,KAAK,MAAM;AACjD,MAAI,YACH,OAAM,KAAK,MAAM,MAAM,OAAO,YAAY;AAE3C,SAAO;CACP;;;;;CAMD,MAAM,KAAKA,OAAkD;EAC5D,MAAM,aAAa,MAAM,KAAK,MAAM,KAAK,MAAM;AAC/C,MAAI,WACH,OAAM,KAAK,OAAO,MAAM,OAAO,WAAW;AAE3C,SAAO;CACP;;;;;CAMD,MAAM,KAAKA,OAGR;EACF,MAAM,CAAC,OAAO,OAAO,GAAG,MAAM,QAAQ,IAAI,CACzC,KAAK,MAAM,KAAK,MAAM,EACtB,KAAK,OAAO,KAAK,MAAM,AACvB,EAAC;AACF,SAAO;GAAE;GAAO;EAAQ;CACxB;AACD"}

package/dist/CachedStateProvider-DVyKfaMm.mjs

@@ -0,0 +1,54 @@
+//#region src/deploy/CachedStateProvider.ts
+/**
+* Cached state provider that wraps a remote provider with local cache.
+*/
+var CachedStateProvider = class {
+	constructor(remote, local) {
+		this.remote = remote;
+		this.local = local;
+	}
+	async read(stage) {
+		const localState = await this.local.read(stage);
+		if (localState) return localState;
+		const remoteState = await this.remote.read(stage);
+		if (remoteState) await this.local.write(stage, remoteState);
+		return remoteState;
+	}
+	async write(stage, state) {
+		await this.remote.write(stage, state);
+		await this.local.write(stage, state);
+	}
+	/**
+	* Force pull from remote to local.
+	* Used by `gkm state pull` command.
+	*/
+	async pull(stage) {
+		const remoteState = await this.remote.read(stage);
+		if (remoteState) await this.local.write(stage, remoteState);
+		return remoteState;
+	}
+	/**
+	* Force push from local to remote.
+	* Used by `gkm state push` command.
+	*/
+	async push(stage) {
+		const localState = await this.local.read(stage);
+		if (localState) await this.remote.write(stage, localState);
+		return localState;
+	}
+	/**
+	* Get both local and remote state for comparison.
+	* Used by `gkm state diff` command.
+	*/
+	async diff(stage) {
+		const [local, remote] = await Promise.all([this.local.read(stage), this.remote.read(stage)]);
+		return {
+			local,
+			remote
+		};
+	}
+};
+
+//#endregion
+export { CachedStateProvider };
+//# sourceMappingURL=CachedStateProvider-DVyKfaMm.mjs.map

package/dist/CachedStateProvider-DVyKfaMm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CachedStateProvider-DVyKfaMm.mjs","names":["remote: StateProvider","local: StateProvider","stage: string","state: DokployStageState"],"sources":["../src/deploy/CachedStateProvider.ts"],"sourcesContent":["/**\n * Cached State Provider\n *\n * Wraps a remote state provider (SSM) with local filesystem cache.\n * - Read: Local first, then remote if missing\n * - Write: Remote first, then update local cache\n *\n * This enables fast local development while keeping SSM as source of truth.\n */\n\nimport type { StateProvider } from './StateProvider';\nimport type { DokployStageState } from './state';\n\n/**\n * Cached state provider that wraps a remote provider with local cache.\n */\nexport class CachedStateProvider implements StateProvider {\n\tconstructor(\n\t\tprivate readonly remote: StateProvider,\n\t\tprivate readonly local: StateProvider,\n\t) {}\n\n\tasync read(stage: string): Promise<DokployStageState | null> {\n\t\t// Try local cache first\n\t\tconst localState = await this.local.read(stage);\n\t\tif (localState) {\n\t\t\treturn localState;\n\t\t}\n\n\t\t// Fall back to remote\n\t\tconst remoteState = await this.remote.read(stage);\n\t\tif (remoteState) {\n\t\t\t// Update local cache\n\t\t\tawait this.local.write(stage, remoteState);\n\t\t}\n\n\t\treturn remoteState;\n\t}\n\n\tasync write(stage: string, state: DokployStageState): Promise<void> {\n\t\t// Write to remote first (source of truth)\n\t\tawait this.remote.write(stage, state);\n\n\t\t// Update local cache\n\t\tawait this.local.write(stage, state);\n\t}\n\n\t/**\n\t * Force pull from remote to local.\n\t * Used by `gkm state pull` command.\n\t */\n\tasync pull(stage: string): Promise<DokployStageState | null> {\n\t\tconst remoteState = await this.remote.read(stage);\n\t\tif (remoteState) {\n\t\t\tawait this.local.write(stage, remoteState);\n\t\t}\n\t\treturn remoteState;\n\t}\n\n\t/**\n\t * Force push from local to remote.\n\t * Used by `gkm state push` command.\n\t */\n\tasync push(stage: string): Promise<DokployStageState | null> {\n\t\tconst localState = await this.local.read(stage);\n\t\tif (localState) {\n\t\t\tawait this.remote.write(stage, localState);\n\t\t}\n\t\treturn localState;\n\t}\n\n\t/**\n\t * Get both local and remote state for comparison.\n\t * Used by `gkm state diff` command.\n\t */\n\tasync diff(stage: string): Promise<{\n\t\tlocal: DokployStageState | null;\n\t\tremote: DokployStageState | null;\n\t}> {\n\t\tconst [local, remote] = await Promise.all([\n\t\t\tthis.local.read(stage),\n\t\t\tthis.remote.read(stage),\n\t\t]);\n\t\treturn { local, remote };\n\t}\n}\n"],"mappings":";;;;AAgBA,IAAa,sBAAb,MAA0D;CACzD,YACkBA,QACAC,OAChB;EAFgB;EACA;CACd;CAEJ,MAAM,KAAKC,OAAkD;EAE5D,MAAM,aAAa,MAAM,KAAK,MAAM,KAAK,MAAM;AAC/C,MAAI,WACH,QAAO;EAIR,MAAM,cAAc,MAAM,KAAK,OAAO,KAAK,MAAM;AACjD,MAAI,YAEH,OAAM,KAAK,MAAM,MAAM,OAAO,YAAY;AAG3C,SAAO;CACP;CAED,MAAM,MAAMA,OAAeC,OAAyC;AAEnE,QAAM,KAAK,OAAO,MAAM,OAAO,MAAM;AAGrC,QAAM,KAAK,MAAM,MAAM,OAAO,MAAM;CACpC;;;;;CAMD,MAAM,KAAKD,OAAkD;EAC5D,MAAM,cAAc,MAAM,KAAK,OAAO,KAAK,MAAM;AACjD,MAAI,YACH,OAAM,KAAK,MAAM,MAAM,OAAO,YAAY;AAE3C,SAAO;CACP;;;;;CAMD,MAAM,KAAKA,OAAkD;EAC5D,MAAM,aAAa,MAAM,KAAK,MAAM,KAAK,MAAM;AAC/C,MAAI,WACH,OAAM,KAAK,OAAO,MAAM,OAAO,WAAW;AAE3C,SAAO;CACP;;;;;CAMD,MAAM,KAAKA,OAGR;EACF,MAAM,CAAC,OAAO,OAAO,GAAG,MAAM,QAAQ,IAAI,CACzC,KAAK,MAAM,KAAK,MAAM,EACtB,KAAK,OAAO,KAAK,MAAM,AACvB,EAAC;AACF,SAAO;GAAE;GAAO;EAAQ;CACxB;AACD"}

package/dist/CachedStateProvider-D_uISMmJ.cjs

@@ -0,0 +1,3 @@
+const require_CachedStateProvider = require('./CachedStateProvider-D73dCqfH.cjs');
+
+exports.CachedStateProvider = require_CachedStateProvider.CachedStateProvider;

package/dist/CachedStateProvider-OiFUGr7p.mjs

@@ -0,0 +1,3 @@
+import { CachedStateProvider } from "./CachedStateProvider-DVyKfaMm.mjs";
+
+export { CachedStateProvider };

package/dist/HostingerProvider-DUV9-Tzg.cjs

@@ -0,0 +1,210 @@
+const require_credentials = require('./credentials-C8DWtnMY.cjs');
+
+//#region src/deploy/dns/hostinger-api.ts
+/**
+* Hostinger DNS API client
+*
+* API Documentation: https://developers.hostinger.com/
+* Authentication: Bearer token from hpanel.hostinger.com/profile/api
+*/
+const HOSTINGER_API_BASE = "https://developers.hostinger.com";
+/**
+* Hostinger API error
+*/
+var HostingerApiError = class extends Error {
+	constructor(message, status, statusText, errors) {
+		super(message);
+		this.status = status;
+		this.statusText = statusText;
+		this.errors = errors;
+		this.name = "HostingerApiError";
+	}
+};
+/**
+* Hostinger DNS API client
+*
+* @example
+* ```ts
+* const api = new HostingerApi(token);
+*
+* // Get all records for a domain
+* const records = await api.getRecords('traflabs.io');
+*
+* // Create/update records
+* await api.upsertRecords('traflabs.io', [
+*   { name: 'api.joemoer', type: 'A', ttl: 300, records: ['1.2.3.4'] }
+* ]);
+* ```
+*/
+var HostingerApi = class {
+	token;
+	constructor(token) {
+		this.token = token;
+	}
+	/**
+	* Make a request to the Hostinger API
+	*/
+	async request(method, endpoint, body) {
+		const url = `${HOSTINGER_API_BASE}${endpoint}`;
+		const response = await fetch(url, {
+			method,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${this.token}`
+			},
+			body: body ? JSON.stringify(body) : void 0
+		});
+		if (!response.ok) {
+			let errorMessage = `Hostinger API error: ${response.status} ${response.statusText}`;
+			let errors;
+			try {
+				const errorBody = await response.json();
+				if (errorBody.message) errorMessage = `Hostinger API error: ${errorBody.message}`;
+				errors = errorBody.errors;
+			} catch {}
+			throw new HostingerApiError(errorMessage, response.status, response.statusText, errors);
+		}
+		const text = await response.text();
+		if (!text || text.trim() === "") return void 0;
+		return JSON.parse(text);
+	}
+	/**
+	* Get all DNS records for a domain
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	*/
+	async getRecords(domain) {
+		const response = await this.request("GET", `/api/dns/v1/zones/${domain}`);
+		return response.data || [];
+	}
+	/**
+	* Create or update DNS records
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param records - Records to create/update
+	* @param overwrite - If true, replaces all existing records. If false, merges with existing.
+	*/
+	async upsertRecords(domain, records, overwrite = false) {
+		await this.request("PUT", `/api/dns/v1/zones/${domain}`, {
+			overwrite,
+			zone: records
+		});
+	}
+	/**
+	* Validate DNS records before applying
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param records - Records to validate
+	* @returns true if valid, throws if invalid
+	*/
+	async validateRecords(domain, records) {
+		await this.request("POST", `/api/dns/v1/zones/${domain}/validate`, {
+			overwrite: false,
+			zone: records
+		});
+		return true;
+	}
+	/**
+	* Delete specific DNS records
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param filters - Filters to match records for deletion
+	*/
+	async deleteRecords(domain, filters) {
+		await this.request("DELETE", `/api/dns/v1/zones/${domain}`, { filters });
+	}
+	/**
+	* Check if a specific record exists
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param name - Subdomain name (e.g., 'api.joemoer')
+	* @param type - Record type (e.g., 'A')
+	*/
+	async recordExists(domain, name, type = "A") {
+		const records = await this.getRecords(domain);
+		return records.some((r) => r.name === name && r.type === type);
+	}
+	/**
+	* Create a single A record if it doesn't exist
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param subdomain - Subdomain name (e.g., 'api.joemoer')
+	* @param ip - IP address to point to
+	* @param ttl - TTL in seconds (default: 300)
+	* @returns true if created, false if already exists
+	*/
+	async createARecordIfNotExists(domain, subdomain, ip, ttl = 300) {
+		const exists = await this.recordExists(domain, subdomain, "A");
+		if (exists) return false;
+		await this.upsertRecords(domain, [{
+			name: subdomain,
+			type: "A",
+			ttl,
+			records: [{ content: ip }]
+		}]);
+		return true;
+	}
+};
+
+//#endregion
+//#region src/deploy/dns/HostingerProvider.ts
+/**
+* Hostinger DNS provider implementation.
+*/
+var HostingerProvider = class {
+	name = "hostinger";
+	api = null;
+	/**
+	* Get or create the Hostinger API client.
+	*/
+	async getApi() {
+		if (this.api) return this.api;
+		const token = await require_credentials.getHostingerToken();
+		if (!token) throw new Error("Hostinger API token not configured. Run `gkm login --service=hostinger` or get your token from https://hpanel.hostinger.com/profile/api");
+		this.api = new HostingerApi(token);
+		return this.api;
+	}
+	async getRecords(domain) {
+		const api = await this.getApi();
+		const records = await api.getRecords(domain);
+		return records.map((r) => ({
+			name: r.name,
+			type: r.type,
+			ttl: r.ttl,
+			values: r.records.map((rec) => rec.content)
+		}));
+	}
+	async upsertRecords(domain, records) {
+		const api = await this.getApi();
+		const results = [];
+		const existingRecords = await api.getRecords(domain);
+		for (const record of records) {
+			const existing = existingRecords.find((r) => r.name === record.name && r.type === record.type);
+			const existingValue = existing?.records?.[0]?.content;
+			if (existing && existingValue === record.value) {
+				results.push({
+					record,
+					created: false,
+					unchanged: true
+				});
+				continue;
+			}
+			await api.upsertRecords(domain, [{
+				name: record.name,
+				type: record.type,
+				ttl: record.ttl,
+				records: [{ content: record.value }]
+			}]);
+			results.push({
+				record,
+				created: !existing,
+				unchanged: false
+			});
+		}
+		return results;
+	}
+};
+
+//#endregion
+exports.HostingerProvider = HostingerProvider;
+//# sourceMappingURL=HostingerProvider-DUV9-Tzg.cjs.map

package/dist/HostingerProvider-DUV9-Tzg.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostingerProvider-DUV9-Tzg.cjs","names":["message: string","status: number","statusText: string","errors?: Record<string, string[]>","token: string","method: 'GET' | 'POST' | 'PUT' | 'DELETE'","endpoint: string","body?: unknown","errors: Record<string, string[]> | undefined","domain: string","records: DnsRecord[]","filters: DnsRecordFilter[]","name: string","type: DnsRecordType","subdomain: string","ip: string","domain: string","records: UpsertDnsRecord[]","results: UpsertResult[]"],"sources":["../src/deploy/dns/hostinger-api.ts","../src/deploy/dns/HostingerProvider.ts"],"sourcesContent":["/**\n * Hostinger DNS API client\n *\n * API Documentation: https://developers.hostinger.com/\n * Authentication: Bearer token from hpanel.hostinger.com/profile/api\n */\n\nconst HOSTINGER_API_BASE = 'https://developers.hostinger.com';\n\n/**\n * DNS record types supported by Hostinger\n */\nexport type DnsRecordType =\n\t| 'A'\n\t| 'AAAA'\n\t| 'CNAME'\n\t| 'MX'\n\t| 'TXT'\n\t| 'NS'\n\t| 'SRV'\n\t| 'CAA';\n\n/**\n * A single DNS record\n */\nexport interface DnsRecord {\n\t/** Subdomain name (e.g., 'api.joemoer' for api.joemoer.traflabs.io) */\n\tname: string;\n\t/** Record type */\n\ttype: DnsRecordType;\n\t/** TTL in seconds */\n\tttl: number;\n\t/** Record values */\n\trecords: Array<{ content: string }>;\n}\n\n/**\n * Filter for deleting specific records\n */\nexport interface DnsRecordFilter {\n\tname: string;\n\ttype: DnsRecordType;\n}\n\n/**\n * API error response\n */\nexport interface HostingerErrorResponse {\n\tmessage?: string;\n\terrors?: Record<string, string[]>;\n}\n\n/**\n * Hostinger API error\n */\nexport class HostingerApiError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic status: number,\n\t\tpublic statusText: string,\n\t\tpublic errors?: Record<string, string[]>,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'HostingerApiError';\n\t}\n}\n\n/**\n * Hostinger DNS API client\n *\n * @example\n * ```ts\n * const api = new HostingerApi(token);\n *\n * // Get all records for a domain\n * const records = await api.getRecords('traflabs.io');\n *\n * // Create/update records\n * await api.upsertRecords('traflabs.io', [\n *   { name: 'api.joemoer', type: 'A', ttl: 300, records: ['1.2.3.4'] }\n * ]);\n * ```\n */\nexport class HostingerApi {\n\tprivate token: string;\n\n\tconstructor(token: string) {\n\t\tthis.token = token;\n\t}\n\n\t/**\n\t * Make a request to the Hostinger API\n\t */\n\tprivate async request<T>(\n\t\tmethod: 'GET' | 'POST' | 'PUT' | 'DELETE',\n\t\tendpoint: string,\n\t\tbody?: unknown,\n\t): Promise<T> {\n\t\tconst url = `${HOSTINGER_API_BASE}${endpoint}`;\n\n\t\tconst response = await fetch(url, {\n\t\t\tmethod,\n\t\t\theaders: {\n\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\tAuthorization: `Bearer ${this.token}`,\n\t\t\t},\n\t\t\tbody: body ? JSON.stringify(body) : undefined,\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tlet errorMessage = `Hostinger API error: ${response.status} ${response.statusText}`;\n\t\t\tlet errors: Record<string, string[]> | undefined;\n\n\t\t\ttry {\n\t\t\t\tconst errorBody = (await response.json()) as HostingerErrorResponse;\n\t\t\t\tif (errorBody.message) {\n\t\t\t\t\terrorMessage = `Hostinger API error: ${errorBody.message}`;\n\t\t\t\t}\n\t\t\t\terrors = errorBody.errors;\n\t\t\t} catch {\n\t\t\t\t// Ignore JSON parse errors\n\t\t\t}\n\n\t\t\tthrow new HostingerApiError(\n\t\t\t\terrorMessage,\n\t\t\t\tresponse.status,\n\t\t\t\tresponse.statusText,\n\t\t\t\terrors,\n\t\t\t);\n\t\t}\n\n\t\t// Handle empty responses\n\t\tconst text = await response.text();\n\t\tif (!text || text.trim() === '') {\n\t\t\treturn undefined as T;\n\t\t}\n\t\treturn JSON.parse(text) as T;\n\t}\n\n\t/**\n\t * Get all DNS records for a domain\n\t *\n\t * @param domain - Root domain (e.g., 'traflabs.io')\n\t */\n\tasync getRecords(domain: string): Promise<DnsRecord[]> {\n\t\tinterface RecordResponse {\n\t\t\tdata: Array<{\n\t\t\t\tname: string;\n\t\t\t\ttype: DnsRecordType;\n\t\t\t\tttl: number;\n\t\t\t\trecords: Array<{ content: string }>;\n\t\t\t}>;\n\t\t}\n\n\t\tconst response = await this.request<RecordResponse>(\n\t\t\t'GET',\n\t\t\t`/api/dns/v1/zones/${domain}`,\n\t\t);\n\n\t\treturn response.data || [];\n\t}\n\n\t/**\n\t * Create or update DNS records\n\t *\n\t * @param domain - Root domain (e.g., 'traflabs.io')\n\t * @param records - Records to create/update\n\t * @param overwrite - If true, replaces all existing records. If false, merges with existing.\n\t */\n\tasync upsertRecords(\n\t\tdomain: string,\n\t\trecords: DnsRecord[],\n\t\toverwrite = false,\n\t): Promise<void> {\n\t\tawait this.request('PUT', `/api/dns/v1/zones/${domain}`, {\n\t\t\toverwrite,\n\t\t\tzone: records,\n\t\t});\n\t}\n\n\t/**\n\t * Validate DNS records before applying\n\t *\n\t * @param domain - Root domain (e.g., 'traflabs.io')\n\t * @param records - Records to validate\n\t * @returns true if valid, throws if invalid\n\t */\n\tasync validateRecords(\n\t\tdomain: string,\n\t\trecords: DnsRecord[],\n\t): Promise<boolean> {\n\t\tawait this.request('POST', `/api/dns/v1/zones/${domain}/validate`, {\n\t\t\toverwrite: false,\n\t\t\tzone: records,\n\t\t});\n\t\treturn true;\n\t}\n\n\t/**\n\t * Delete specific DNS records\n\t *\n\t * @param domain - Root domain (e.g., 'traflabs.io')\n\t * @param filters - Filters to match records for deletion\n\t */\n\tasync deleteRecords(\n\t\tdomain: string,\n\t\tfilters: DnsRecordFilter[],\n\t): Promise<void> {\n\t\tawait this.request('DELETE', `/api/dns/v1/zones/${domain}`, {\n\t\t\tfilters,\n\t\t});\n\t}\n\n\t/**\n\t * Check if a specific record exists\n\t *\n\t * @param domain - Root domain (e.g., 'traflabs.io')\n\t * @param name - Subdomain name (e.g., 'api.joemoer')\n\t * @param type - Record type (e.g., 'A')\n\t */\n\tasync recordExists(\n\t\tdomain: string,\n\t\tname: string,\n\t\ttype: DnsRecordType = 'A',\n\t): Promise<boolean> {\n\t\tconst records = await this.getRecords(domain);\n\t\treturn records.some((r) => r.name === name && r.type === type);\n\t}\n\n\t/**\n\t * Create a single A record if it doesn't exist\n\t *\n\t * @param domain - Root domain (e.g., 'traflabs.io')\n\t * @param subdomain - Subdomain name (e.g., 'api.joemoer')\n\t * @param ip - IP address to point to\n\t * @param ttl - TTL in seconds (default: 300)\n\t * @returns true if created, false if already exists\n\t */\n\tasync createARecordIfNotExists(\n\t\tdomain: string,\n\t\tsubdomain: string,\n\t\tip: string,\n\t\tttl = 300,\n\t): Promise<boolean> {\n\t\tconst exists = await this.recordExists(domain, subdomain, 'A');\n\t\tif (exists) {\n\t\t\treturn false;\n\t\t}\n\n\t\tawait this.upsertRecords(domain, [\n\t\t\t{\n\t\t\t\tname: subdomain,\n\t\t\t\ttype: 'A',\n\t\t\t\tttl,\n\t\t\t\trecords: [{ content: ip }],\n\t\t\t},\n\t\t]);\n\n\t\treturn true;\n\t}\n}\n","/**\n * Hostinger DNS Provider\n *\n * Implements DnsProvider interface using the Hostinger DNS API.\n */\n\nimport { getHostingerToken } from '../../auth/credentials';\nimport type {\n\tDnsProvider,\n\tDnsRecord,\n\tUpsertDnsRecord,\n\tUpsertResult,\n} from './DnsProvider';\nimport { HostingerApi } from './hostinger-api';\n\n/**\n * Hostinger DNS provider implementation.\n */\nexport class HostingerProvider implements DnsProvider {\n\treadonly name = 'hostinger';\n\tprivate api: HostingerApi | null = null;\n\n\t/**\n\t * Get or create the Hostinger API client.\n\t */\n\tprivate async getApi(): Promise<HostingerApi> {\n\t\tif (this.api) {\n\t\t\treturn this.api;\n\t\t}\n\n\t\tconst token = await getHostingerToken();\n\t\tif (!token) {\n\t\t\tthrow new Error(\n\t\t\t\t'Hostinger API token not configured. Run `gkm login --service=hostinger` or get your token from https://hpanel.hostinger.com/profile/api',\n\t\t\t);\n\t\t}\n\n\t\tthis.api = new HostingerApi(token);\n\t\treturn this.api;\n\t}\n\n\tasync getRecords(domain: string): Promise<DnsRecord[]> {\n\t\tconst api = await this.getApi();\n\t\tconst records = await api.getRecords(domain);\n\n\t\treturn records.map((r) => ({\n\t\t\tname: r.name,\n\t\t\ttype: r.type,\n\t\t\tttl: r.ttl,\n\t\t\tvalues: r.records.map((rec) => rec.content),\n\t\t}));\n\t}\n\n\tasync upsertRecords(\n\t\tdomain: string,\n\t\trecords: UpsertDnsRecord[],\n\t): Promise<UpsertResult[]> {\n\t\tconst api = await this.getApi();\n\t\tconst results: UpsertResult[] = [];\n\n\t\t// Get existing records to check what already exists\n\t\tconst existingRecords = await api.getRecords(domain);\n\n\t\tfor (const record of records) {\n\t\t\tconst existing = existingRecords.find(\n\t\t\t\t(r) => r.name === record.name && r.type === record.type,\n\t\t\t);\n\n\t\t\tconst existingValue = existing?.records?.[0]?.content;\n\n\t\t\tif (existing && existingValue === record.value) {\n\t\t\t\t// Record exists with same value - unchanged\n\t\t\t\tresults.push({\n\t\t\t\t\trecord,\n\t\t\t\t\tcreated: false,\n\t\t\t\t\tunchanged: true,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Create or update the record\n\t\t\tawait api.upsertRecords(domain, [\n\t\t\t\t{\n\t\t\t\t\tname: record.name,\n\t\t\t\t\ttype: record.type,\n\t\t\t\t\tttl: record.ttl,\n\t\t\t\t\trecords: [{ content: record.value }],\n\t\t\t\t},\n\t\t\t]);\n\n\t\t\tresults.push({\n\t\t\t\trecord,\n\t\t\t\tcreated: !existing,\n\t\t\t\tunchanged: false,\n\t\t\t});\n\t\t}\n\n\t\treturn results;\n\t}\n}\n"],"mappings":"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"}

package/dist/HostingerProvider-DqUq6e9i.mjs

@@ -0,0 +1,210 @@
+import { getHostingerToken } from "./credentials-DT1dSxIx.mjs";
+
+//#region src/deploy/dns/hostinger-api.ts
+/**
+* Hostinger DNS API client
+*
+* API Documentation: https://developers.hostinger.com/
+* Authentication: Bearer token from hpanel.hostinger.com/profile/api
+*/
+const HOSTINGER_API_BASE = "https://developers.hostinger.com";
+/**
+* Hostinger API error
+*/
+var HostingerApiError = class extends Error {
+	constructor(message, status, statusText, errors) {
+		super(message);
+		this.status = status;
+		this.statusText = statusText;
+		this.errors = errors;
+		this.name = "HostingerApiError";
+	}
+};
+/**
+* Hostinger DNS API client
+*
+* @example
+* ```ts
+* const api = new HostingerApi(token);
+*
+* // Get all records for a domain
+* const records = await api.getRecords('traflabs.io');
+*
+* // Create/update records
+* await api.upsertRecords('traflabs.io', [
+*   { name: 'api.joemoer', type: 'A', ttl: 300, records: ['1.2.3.4'] }
+* ]);
+* ```
+*/
+var HostingerApi = class {
+	token;
+	constructor(token) {
+		this.token = token;
+	}
+	/**
+	* Make a request to the Hostinger API
+	*/
+	async request(method, endpoint, body) {
+		const url = `${HOSTINGER_API_BASE}${endpoint}`;
+		const response = await fetch(url, {
+			method,
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${this.token}`
+			},
+			body: body ? JSON.stringify(body) : void 0
+		});
+		if (!response.ok) {
+			let errorMessage = `Hostinger API error: ${response.status} ${response.statusText}`;
+			let errors;
+			try {
+				const errorBody = await response.json();
+				if (errorBody.message) errorMessage = `Hostinger API error: ${errorBody.message}`;
+				errors = errorBody.errors;
+			} catch {}
+			throw new HostingerApiError(errorMessage, response.status, response.statusText, errors);
+		}
+		const text = await response.text();
+		if (!text || text.trim() === "") return void 0;
+		return JSON.parse(text);
+	}
+	/**
+	* Get all DNS records for a domain
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	*/
+	async getRecords(domain) {
+		const response = await this.request("GET", `/api/dns/v1/zones/${domain}`);
+		return response.data || [];
+	}
+	/**
+	* Create or update DNS records
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param records - Records to create/update
+	* @param overwrite - If true, replaces all existing records. If false, merges with existing.
+	*/
+	async upsertRecords(domain, records, overwrite = false) {
+		await this.request("PUT", `/api/dns/v1/zones/${domain}`, {
+			overwrite,
+			zone: records
+		});
+	}
+	/**
+	* Validate DNS records before applying
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param records - Records to validate
+	* @returns true if valid, throws if invalid
+	*/
+	async validateRecords(domain, records) {
+		await this.request("POST", `/api/dns/v1/zones/${domain}/validate`, {
+			overwrite: false,
+			zone: records
+		});
+		return true;
+	}
+	/**
+	* Delete specific DNS records
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param filters - Filters to match records for deletion
+	*/
+	async deleteRecords(domain, filters) {
+		await this.request("DELETE", `/api/dns/v1/zones/${domain}`, { filters });
+	}
+	/**
+	* Check if a specific record exists
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param name - Subdomain name (e.g., 'api.joemoer')
+	* @param type - Record type (e.g., 'A')
+	*/
+	async recordExists(domain, name, type = "A") {
+		const records = await this.getRecords(domain);
+		return records.some((r) => r.name === name && r.type === type);
+	}
+	/**
+	* Create a single A record if it doesn't exist
+	*
+	* @param domain - Root domain (e.g., 'traflabs.io')
+	* @param subdomain - Subdomain name (e.g., 'api.joemoer')
+	* @param ip - IP address to point to
+	* @param ttl - TTL in seconds (default: 300)
+	* @returns true if created, false if already exists
+	*/
+	async createARecordIfNotExists(domain, subdomain, ip, ttl = 300) {
+		const exists = await this.recordExists(domain, subdomain, "A");
+		if (exists) return false;
+		await this.upsertRecords(domain, [{
+			name: subdomain,
+			type: "A",
+			ttl,
+			records: [{ content: ip }]
+		}]);
+		return true;
+	}
+};
+
+//#endregion
+//#region src/deploy/dns/HostingerProvider.ts
+/**
+* Hostinger DNS provider implementation.
+*/
+var HostingerProvider = class {
+	name = "hostinger";
+	api = null;
+	/**
+	* Get or create the Hostinger API client.
+	*/
+	async getApi() {
+		if (this.api) return this.api;
+		const token = await getHostingerToken();
+		if (!token) throw new Error("Hostinger API token not configured. Run `gkm login --service=hostinger` or get your token from https://hpanel.hostinger.com/profile/api");
+		this.api = new HostingerApi(token);
+		return this.api;
+	}
+	async getRecords(domain) {
+		const api = await this.getApi();
+		const records = await api.getRecords(domain);
+		return records.map((r) => ({
+			name: r.name,
+			type: r.type,
+			ttl: r.ttl,
+			values: r.records.map((rec) => rec.content)
+		}));
+	}
+	async upsertRecords(domain, records) {
+		const api = await this.getApi();
+		const results = [];
+		const existingRecords = await api.getRecords(domain);
+		for (const record of records) {
+			const existing = existingRecords.find((r) => r.name === record.name && r.type === record.type);
+			const existingValue = existing?.records?.[0]?.content;
+			if (existing && existingValue === record.value) {
+				results.push({
+					record,
+					created: false,
+					unchanged: true
+				});
+				continue;
+			}
+			await api.upsertRecords(domain, [{
+				name: record.name,
+				type: record.type,
+				ttl: record.ttl,
+				records: [{ content: record.value }]
+			}]);
+			results.push({
+				record,
+				created: !existing,
+				unchanged: false
+			});
+		}
+		return results;
+	}
+};
+
+//#endregion
+export { HostingerProvider };
+//# sourceMappingURL=HostingerProvider-DqUq6e9i.mjs.map