ztechno_cli 0.0.2

package/LICENSE

@@ -0,0 +1 @@
+MIT

package/README.md

@@ -0,0 +1,159 @@
+# ztechno_cli
+
+CLI tools for the ZTechno framework to build, push, and remotely update Docker containers.
+
+## Installation
+
+```bash
+npm install -g ztechno_cli
+```
+
+Or use via `npx`:
+
+```bash
+npx ztechno_cli <command>
+```
+
+---
+
+## Commands
+
+### `ztechno-cli-build`
+
+Builds a Docker image tagged as `<awsAccountId>/<packagename>:<tag>`.
+
+```bash
+ztechno-cli-build [options]
+
+Options:
+  --name <name>       Image name          (default: package.json "name")
+  --account <id>      AWS Account ID      (default: package.json "config.awsAccountId")
+  --tag <tag>         Image tag           (default: "latest")
+  --context <path>    Build context path  (default: ".")
+  -h, --help          Show help
+```
+
+---
+
+### `ztechno-cli-push`
+
+Pushes a Docker image to the registry.
+
+```bash
+ztechno-cli-push [options]
+
+Options:
+  --name <name>       Image name          (default: package.json "name")
+  --account <id>      AWS Account ID      (default: package.json "config.awsAccountId")
+  --tag <tag>         Image tag           (default: "latest")
+  -h, --help          Show help
+```
+
+---
+
+### `ztechno-cli-update`
+
+Triggers a remote Docker container update via the ZTechno V2 Secure API (HMAC-signed).
+
+```bash
+ztechno-cli-update <packagename>:<port>
+ztechno-cli-update                       # auto-detect from .env / package.json
+```
+
+**Auto-detection priority:**
+1. `.env` file — `hostname`, `packagename`, `port`, `volumes`, `ZTECHNO_API_SECRET`
+2. `package.json` — `"name"` as packagename, `"config.hostname"`, `"config.port"`, `"config.volumes"`
+
+---
+
+### `ztechno-cli-publish`
+
+Runs the full pipeline: **build → push → remote update**.
+
+```bash
+ztechno-cli-publish [options]
+
+Options:
+  --name <name>       Image name          (default: package.json "name")
+  --account <id>      AWS Account ID      (default: package.json "config.awsAccountId")
+  --tag <tag>         Image tag           (default: "latest")
+  --context <path>    Build context path  (default: ".")
+  -h, --help          Show help
+```
+
+The remote update step is skipped automatically if `hostname` or `port` is not configured.
+
+---
+
+## Configuration
+
+### `.env` file
+
+Place a `.env` file in your project root:
+
+```env
+ZTECHNO_API_SECRET=your_secret_here
+hostname=192.168.1.100
+packagename=my-image
+port=3000
+volumes=/host/data:/app/data,/host/logs:/app/logs
+```
+
+### `package.json`
+
+```json
+{
+  "name": "my-image",
+  "config": {
+    "awsAccountId": "000123456789",
+    "hostname": "192.168.1.100",
+    "port": 3000,
+    "volumes": [
+      "/host/data:/app/data",
+      "/host/logs:/app/logs"
+    ]
+  }
+}
+```
+
+---
+
+## Programmatic Usage
+
+All commands are also exported as functions for use in your own scripts.
+
+```typescript
+import { dockerBuild } from 'ztechno_cli/lib/scripts/docker-build'
+import { dockerPush } from 'ztechno_cli/lib/scripts/docker-push'
+import { updateDocker } from 'ztechno_cli/lib/scripts/docker-update'
+import { dockerPublish } from 'ztechno_cli/lib/scripts/docker-publish'
+
+// Build
+dockerBuild({ packagename: 'my-image', awsAccountId: '000123456789' })
+
+// Push
+dockerPush({ packagename: 'my-image', awsAccountId: '000123456789' })
+
+// Remote update
+await updateDocker({
+  hostname: '192.168.1.100',
+  packagename: 'my-image',
+  port: 3000,
+  volumes: ['/host/data:/app/data'],
+})
+
+// Full pipeline
+await dockerPublish()
+```
+
+---
+
+## Security
+
+Remote update requests are authenticated with an **HMAC-SHA256** signature derived from `ZTECHNO_API_SECRET`. The signature covers the timestamp, package name, port, and volumes to prevent replay and tampering attacks.
+
+---
+
+## License
+
+MIT — Ivan Auda (ZTechnologies International)

package/lib/scripts/docker-build.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Build a Docker image tagged as <awsAccountId>/<packagename>:latest
+ * @param opt.packagename - Override the image name (defaults to package.json name)
+ * @param opt.awsAccountId - Override the AWS Account ID (defaults to package.json config.awsAccountId)
+ * @param opt.tag - Override the tag (defaults to "latest")
+ * @param opt.context - Docker build context path (defaults to ".")
+ */
+export declare function dockerBuild(opt?: {
+    packagename?: string;
+    awsAccountId?: string;
+    tag?: string;
+    context?: string;
+}): void;

package/lib/scripts/docker-build.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerBuild = dockerBuild;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+// ANSI color helpers
+const red = (msg) => `\x1b[31m${msg}\x1b[0m`;
+const green = (msg) => `\x1b[32m${msg}\x1b[0m`;
+const cyan = (msg) => `\x1b[36m${msg}\x1b[0m`;
+function loadPackageJson() {
+    const pkgPath = path_1.default.join(process.cwd(), 'package.json');
+    if (!fs_1.default.existsSync(pkgPath)) {
+        throw new Error(`No package.json found in ${process.cwd()}`);
+    }
+    return JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
+}
+/**
+ * Build a Docker image tagged as <awsAccountId>/<packagename>:latest
+ * @param opt.packagename - Override the image name (defaults to package.json name)
+ * @param opt.awsAccountId - Override the AWS Account ID (defaults to package.json config.awsAccountId)
+ * @param opt.tag - Override the tag (defaults to "latest")
+ * @param opt.context - Docker build context path (defaults to ".")
+ */
+function dockerBuild(opt) {
+    const pkg = loadPackageJson();
+    const packagename = opt?.packagename || pkg.name;
+    const awsAccountId = opt?.awsAccountId || pkg.config?.awsAccountId || process.env.AWS_ACCOUNT_ID;
+    const tag = opt?.tag || 'latest';
+    const context = opt?.context || '.';
+    if (!packagename) {
+        throw new Error('Missing package name. Set "name" in package.json or pass --name.');
+    }
+    if (!awsAccountId) {
+        throw new Error('Missing AWS Account ID. Set "config.awsAccountId" in package.json or AWS_ACCOUNT_ID env var.');
+    }
+    const image = `${awsAccountId}/${packagename}:${tag}`;
+    const cmd = `docker build -t ${image} ${context}`;
+    console.log(green(`[Docker Build]`));
+    console.log(cyan(`> ${cmd}`));
+    (0, child_process_1.execSync)(cmd, { stdio: 'inherit' });
+    console.log(green(`✓ Built ${image}`));
+}
+const USAGE = `
+Usage:
+  ztechno-cli-build [options]
+
+Options:
+  --name <name>       Override image name (default: package.json "name")
+  --account <id>      Override AWS Account ID (default: package.json "config.awsAccountId")
+  --tag <tag>         Override tag (default: "latest")
+  --context <path>    Docker build context (default: ".")
+  -h, --help          Show this help
+
+package.json format:
+  {
+    "name": "my-image",
+    "config": {
+      "awsAccountId": "00028463827"
+    }
+  }
+`.trim();
+if (require.main === module) {
+    try {
+        const args = process.argv.slice(2);
+        if (args.includes('--help') || args.includes('-h')) {
+            console.log(USAGE);
+            process.exit(0);
+        }
+        const getArg = (flag) => {
+            const idx = args.indexOf(flag);
+            return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+        };
+        dockerBuild({
+            packagename: getArg('--name'),
+            awsAccountId: getArg('--account'),
+            tag: getArg('--tag'),
+            context: getArg('--context'),
+        });
+    }
+    catch (err) {
+        console.error(red(`✗ Error: ${err.message}`));
+        process.exit(1);
+    }
+}

package/lib/scripts/docker-publish.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Run the full Docker publish pipeline: build → push → update
+ * All options are auto-detected from package.json and .env
+ * @param opt.packagename - Override the image name
+ * @param opt.awsAccountId - Override the AWS Account ID
+ * @param opt.tag - Override the tag (defaults to "latest")
+ * @param opt.context - Docker build context path (defaults to ".")
+ * @param opt.port - Override the port for remote update
+ * @param opt.volumes - Override volumes for remote update
+ */
+export declare function dockerPublish(opt?: {
+    packagename?: string;
+    awsAccountId?: string;
+    tag?: string;
+    context?: string;
+    hostname?: string;
+    port?: string | number;
+    volumes?: string[];
+}): Promise<void>;

package/lib/scripts/docker-publish.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerPublish = dockerPublish;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const dotenv_1 = require("dotenv");
+const docker_build_1 = require("./docker-build");
+const docker_push_1 = require("./docker-push");
+const docker_update_1 = require("./docker-update");
+// ANSI color helpers
+const red = (msg) => `\x1b[31m${msg}\x1b[0m`;
+const green = (msg) => `\x1b[32m${msg}\x1b[0m`;
+const cyan = (msg) => `\x1b[36m${msg}\x1b[0m`;
+function loadPackageJson() {
+    const pkgPath = path_1.default.join(process.cwd(), 'package.json');
+    if (!fs_1.default.existsSync(pkgPath)) {
+        throw new Error(`No package.json found in ${process.cwd()}`);
+    }
+    return JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
+}
+/**
+ * Run the full Docker publish pipeline: build → push → update
+ * All options are auto-detected from package.json and .env
+ * @param opt.packagename - Override the image name
+ * @param opt.awsAccountId - Override the AWS Account ID
+ * @param opt.tag - Override the tag (defaults to "latest")
+ * @param opt.context - Docker build context path (defaults to ".")
+ * @param opt.port - Override the port for remote update
+ * @param opt.volumes - Override volumes for remote update
+ */
+async function dockerPublish(opt) {
+    // Load .env so ZTECHNO_API_SECRET (and other vars) are available
+    (0, dotenv_1.config)({ path: path_1.default.join(process.cwd(), '.env') });
+    const pkg = loadPackageJson();
+    const packagename = opt?.packagename || pkg.name;
+    const awsAccountId = opt?.awsAccountId || pkg.config?.awsAccountId || process.env.AWS_ACCOUNT_ID;
+    const tag = opt?.tag || 'latest';
+    console.log(cyan(`\n[Docker Publish Pipeline]`));
+    console.log(cyan(`  Image: ${awsAccountId}/${packagename}:${tag}\n`));
+    // Step 1: Build
+    console.log(cyan(`── Step 1/3: Build ──`));
+    (0, docker_build_1.dockerBuild)({ packagename, awsAccountId, tag, context: opt?.context });
+    // Step 2: Push
+    console.log(cyan(`\n── Step 2/3: Push ──`));
+    (0, docker_push_1.dockerPush)({ packagename, awsAccountId, tag });
+    // Step 3: Update remote
+    console.log(cyan(`\n── Step 3/3: Update Remote ──`));
+    const hostname = opt?.hostname || pkg.config?.hostname || process.env.hostname;
+    const port = opt?.port || pkg.config?.port;
+    let volumes = opt?.volumes;
+    if (!volumes && pkg.config?.volumes) {
+        volumes = Array.isArray(pkg.config.volumes)
+            ? pkg.config.volumes
+            : pkg.config.volumes.split(',').filter(Boolean);
+    }
+    if (!port || !hostname) {
+        console.log(green(`✓ Build & push complete. Skipping remote update (no port or hostname configured).`));
+        return;
+    }
+    await (0, docker_update_1.updateDocker)({
+        hostname,
+        packagename: packagename,
+        port,
+        volumes,
+        c: console,
+    });
+    console.log(green(`\n✓ Publish pipeline complete!`));
+}
+const USAGE = `
+Usage:
+  ztechno-cli-publish [options]
+
+Runs: docker build → docker push → remote update
+
+Options:
+  --name <name>       Override image name (default: package.json "name")
+  --account <id>      Override AWS Account ID (default: package.json "config.awsAccountId")
+  --tag <tag>         Override tag (default: "latest")
+  --context <path>    Docker build context (default: ".")
+  -h, --help          Show this help
+
+package.json format:
+  {
+    "name": "my-image",
+    "config": {
+      "awsAccountId": "00028463827",
+      "port": 3000,
+      "volumes": ["/data:/app/data"]
+    }
+  }
+`.trim();
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(USAGE);
+        process.exit(0);
+    }
+    const getArg = (flag) => {
+        const idx = args.indexOf(flag);
+        return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+    };
+    dockerPublish({
+        packagename: getArg('--name'),
+        awsAccountId: getArg('--account'),
+        tag: getArg('--tag'),
+        context: getArg('--context'),
+    }).catch(err => {
+        console.error(red(`✗ Error: ${err.message}`));
+        process.exit(1);
+    });
+}

package/lib/scripts/docker-push.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Push a Docker image tagged as <awsAccountId>/<packagename>:latest
+ * @param opt.packagename - Override the image name (defaults to package.json name)
+ * @param opt.awsAccountId - Override the AWS Account ID (defaults to package.json config.awsAccountId)
+ * @param opt.tag - Override the tag (defaults to "latest")
+ */
+export declare function dockerPush(opt?: {
+    packagename?: string;
+    awsAccountId?: string;
+    tag?: string;
+}): void;

package/lib/scripts/docker-push.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerPush = dockerPush;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+// ANSI color helpers
+const red = (msg) => `\x1b[31m${msg}\x1b[0m`;
+const green = (msg) => `\x1b[32m${msg}\x1b[0m`;
+const cyan = (msg) => `\x1b[36m${msg}\x1b[0m`;
+function loadPackageJson() {
+    const pkgPath = path_1.default.join(process.cwd(), 'package.json');
+    if (!fs_1.default.existsSync(pkgPath)) {
+        throw new Error(`No package.json found in ${process.cwd()}`);
+    }
+    return JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
+}
+/**
+ * Push a Docker image tagged as <awsAccountId>/<packagename>:latest
+ * @param opt.packagename - Override the image name (defaults to package.json name)
+ * @param opt.awsAccountId - Override the AWS Account ID (defaults to package.json config.awsAccountId)
+ * @param opt.tag - Override the tag (defaults to "latest")
+ */
+function dockerPush(opt) {
+    const pkg = loadPackageJson();
+    const packagename = opt?.packagename || pkg.name;
+    const awsAccountId = opt?.awsAccountId || pkg.config?.awsAccountId || process.env.AWS_ACCOUNT_ID;
+    const tag = opt?.tag || 'latest';
+    if (!packagename) {
+        throw new Error('Missing package name. Set "name" in package.json or pass --name.');
+    }
+    if (!awsAccountId) {
+        throw new Error('Missing AWS Account ID. Set "config.awsAccountId" in package.json or AWS_ACCOUNT_ID env var.');
+    }
+    const image = `${awsAccountId}/${packagename}:${tag}`;
+    const cmd = `docker push ${image}`;
+    console.log(green(`[Docker Push]`));
+    console.log(cyan(`> ${cmd}`));
+    (0, child_process_1.execSync)(cmd, { stdio: 'inherit' });
+    console.log(green(`✓ Pushed ${image}`));
+}
+const USAGE = `
+Usage:
+  ztechno-cli-push [options]
+
+Options:
+  --name <name>       Override image name (default: package.json "name")
+  --account <id>      Override AWS Account ID (default: package.json "config.awsAccountId")
+  --tag <tag>         Override tag (default: "latest")
+  -h, --help          Show this help
+
+package.json format:
+  {
+    "name": "my-image",
+    "config": {
+      "awsAccountId": "00028463827"
+    }
+  }
+`.trim();
+if (require.main === module) {
+    try {
+        const args = process.argv.slice(2);
+        if (args.includes('--help') || args.includes('-h')) {
+            console.log(USAGE);
+            process.exit(0);
+        }
+        const getArg = (flag) => {
+            const idx = args.indexOf(flag);
+            return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+        };
+        dockerPush({
+            packagename: getArg('--name'),
+            awsAccountId: getArg('--account'),
+            tag: getArg('--tag'),
+        });
+    }
+    catch (err) {
+        console.error(red(`✗ Error: ${err.message}`));
+        process.exit(1);
+    }
+}

package/lib/scripts/docker-update.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+export interface DockerUpdateOptions {
+    /** The hostname of the Docker host */
+    hostname: string;
+    /** The package/image name */
+    packagename: string;
+    /** The port number */
+    port: string | number;
+    /** Optional array of volume mappings */
+    volumes?: string[];
+    /** Optional logger (defaults to silent) */
+    c?: {
+        log: (...args: any[]) => void;
+        error: (...args: any[]) => void;
+    };
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+export interface DockerUpdateResult {
+    success: boolean;
+    message?: string;
+    err?: string;
+}
+/**
+ * Update a remote Docker container via the V2 Secure API
+ * @param opt - Update options
+ * @returns Promise resolving to success status and message
+ */
+export declare function updateDocker(opt: DockerUpdateOptions): Promise<DockerUpdateResult>;

package/lib/scripts/docker-update.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateDocker = updateDocker;
+const http_1 = __importDefault(require("http"));
+const crypto_1 = __importDefault(require("crypto"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const dotenv_1 = require("dotenv");
+// ANSI color helpers
+const red = (msg) => `\x1b[31m${msg}\x1b[0m`;
+const green = (msg) => `\x1b[32m${msg}\x1b[0m`;
+const cyan = (msg) => `\x1b[36m${msg}\x1b[0m`;
+const blue = (msg) => `\x1b[34m${msg}\x1b[0m`;
+/** Default request timeout in milliseconds (30 seconds) */
+const REQUEST_TIMEOUT_MS = 30000;
+/**
+ * Update a remote Docker container via the V2 Secure API
+ * @param opt - Update options
+ * @returns Promise resolving to success status and message
+ */
+function updateDocker(opt) {
+    return new Promise((resolve, reject) => {
+        const { hostname, packagename, port, volumes, c, timeout = REQUEST_TIMEOUT_MS } = opt;
+        const secretKey = process.env.ZTECHNO_API_SECRET;
+        if (!secretKey) {
+            c?.log(red('✗ Error: ZTECHNO_API_SECRET environment variable not set'));
+            return reject(new Error('ZTECHNO_API_SECRET environment variable not set'));
+        }
+        // Generate timestamp and HMAC signature
+        const timestamp = Date.now().toString();
+        const volumesString = volumes && volumes.length > 0 ? volumes.join(',') : '';
+        const payload = timestamp + packagename + port + volumesString;
+        const signature = crypto_1.default.createHmac('sha256', secretKey).update(payload).digest('hex');
+        c?.log(green(`[Updating Remote Docker via V2 Secure API]`));
+        // Build query parameters with proper encoding
+        const query = new URLSearchParams({ port: String(port) });
+        if (volumesString) {
+            query.set('volumes', volumesString);
+        }
+        const options = {
+            hostname,
+            port: 7998,
+            path: `/v2/images/${encodeURIComponent(packagename)}/update?${query}`,
+            method: 'GET',
+            timeout,
+            headers: {
+                'x-timestamp': timestamp,
+                'x-signature': signature
+            }
+        };
+        const req = http_1.default.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                try {
+                    const response = JSON.parse(data);
+                    c?.log(cyan(`Status Code: ${res.statusCode}`));
+                    c?.log(blue(`Response: ${JSON.stringify(response, null, 2)}`));
+                    if (response.success) {
+                        c?.log(green(`✓ ${response.message}`));
+                    }
+                    else {
+                        c?.log(red(`✗ Error: ${response.err}`));
+                    }
+                    resolve(response);
+                }
+                catch (err) {
+                    c?.log(red(`Failed to parse response: ${data}`));
+                    c?.error(err);
+                    reject(err);
+                }
+            });
+        });
+        req.on('timeout', () => {
+            req.destroy();
+            const err = new Error(`Request timed out after ${timeout}ms`);
+            c?.log(red(`✗ ${err.message}`));
+            reject(err);
+        });
+        req.on('error', (err) => {
+            c?.log(red(`✗ Request failed: ${err.message}`));
+            reject(err);
+        });
+        req.end();
+    });
+}
+/**
+ * Read the consumer's package.json from the current working directory.
+ * Returns null if not found or unreadable.
+ */
+function loadPackageJson() {
+    try {
+        const pkgPath = path_1.default.join(process.cwd(), 'package.json');
+        if (!fs_1.default.existsSync(pkgPath))
+            return null;
+        return JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Auto-detect options from .env and/or package.json in the current working directory.
+ *
+ * Resolution order for each field:
+ *   1. .env / environment variable
+ *   2. package.json (name → packagename, config.port → port, config.volumes → volumes)
+ *
+ * Required: packagename, port, ZTECHNO_API_SECRET (env only)
+ * Optional: volumes (comma-separated)
+ */
+function loadOptionsFromEnv() {
+    // Load .env file
+    const envPath = path_1.default.join(process.cwd(), '.env');
+    const cfg = (0, dotenv_1.config)({ path: envPath });
+    if (cfg.error && cfg.error.message && !cfg.error.message.includes('ENOENT')) {
+        throw cfg.error;
+    }
+    // Load package.json as fallback
+    const pkg = loadPackageJson();
+    const hostname = cfg.parsed?.hostname || process.env.hostname || pkg?.config?.hostname;
+    const packagename = cfg.parsed?.packagename || process.env.packagename || pkg?.name;
+    const port = cfg.parsed?.port || process.env.port || (pkg?.config?.port != null ? String(pkg.config.port) : undefined);
+    const volumesRaw = cfg.parsed?.volumes || process.env.volumes || pkg?.config?.volumes;
+    if (pkg) {
+        console.log(`Detected package.json: ${pkg.name || '(unnamed)'}`);
+    }
+    if (!hostname) {
+        throw new Error('Missing hostname. Set it in .env or environment variable.');
+    }
+    if (!packagename) {
+        throw new Error('Missing packagename. Set it in .env, environment, or package.json "name".');
+    }
+    if (!port) {
+        throw new Error('Missing port. Set it in .env, environment, or package.json "config.port".');
+    }
+    // Normalize volumes: accept string[] from package.json or comma-separated string from .env
+    let volumes;
+    if (Array.isArray(volumesRaw)) {
+        volumes = volumesRaw.filter(Boolean);
+    }
+    else if (typeof volumesRaw === 'string') {
+        volumes = volumesRaw.split(',').filter(Boolean);
+    }
+    return { hostname, packagename, port, volumes };
+}
+const USAGE = `
+Usage:
+  ztechno-cli-update <packagename>:<port>
+  ztechno-cli-update                         (auto-detect from .env / package.json)
+
+Auto-detection priority:
+  1. .env file      → packagename, port, volumes, ZTECHNO_API_SECRET
+  2. package.json   → "name" as packagename, "config.port", "config.volumes"
+
+.env file format:
+  ZTECHNO_API_SECRET=your_secret
+  hostname=192.168.1.100
+  packagename=my-image
+  port=3000
+  volumes=/host/path:/container/path   (optional, comma-separated)
+
+package.json format:
+  {
+    "name": "my-image",
+    "config": {
+      "hostname": "192.168.1.100",
+      "port": 3000,
+      "volumes": ["/host/path:/container/path", "/logs:/app/logs"]
+    }
+  }
+`.trim();
+// Run if executed directly (node docker-update.js or npx ztechno-cli-update)
+if (require.main === module) {
+    const main = async () => {
+        const arg = process.argv[2];
+        if (arg === '--help' || arg === '-h') {
+            console.log(USAGE);
+            return;
+        }
+        // No argument: load from .env
+        if (arg === undefined) {
+            const { hostname, packagename, port, volumes } = loadOptionsFromEnv();
+            await updateDocker({ hostname, packagename, port, volumes, c: console });
+            return;
+        }
+        // Argument with colon: packagename:port
+        if (arg.includes(':')) {
+            const [packagename, port] = arg.split(':');
+            if (!packagename || !port) {
+                throw new Error(`Invalid argument "${arg}". Expected format: <packagename>:<port>`);
+            }
+            const { hostname } = loadOptionsFromEnv();
+            await updateDocker({ hostname, packagename, port, c: console });
+            return;
+        }
+        console.error(red(`✗ Invalid argument: "${arg}"`));
+        console.log(USAGE);
+        process.exit(1);
+    };
+    main().catch(err => {
+        console.error(red(`✗ Error: ${err.message}`));
+        process.exit(1);
+    });
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "ztechno_cli",
+  "version": "0.0.2",
+  "description": "Core files for ztechno framework",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "typings": "lib/index.d.ts",
+  "license": "MIT",
+  "author": "Ivan Auda (ZTechnologies International)",
+  "files": [
+    "lib/**/*"
+  ],
+  "scripts": {
+    "test": "jest --config jestconfig.json",
+    "build": "tsc",
+    "format": "prettier --write \"lib/**/*.ts\" \"lib/**/*.js\"",
+    "lint": "tslint --project tsconfig.json \"src/**/*.ts\"",
+    "preversion": "npm run lint",
+    "version": "npm run format && git add -A src",
+    "postversion": "git push && git push --tags",
+    "update": "npm run build && npm version patch && npm publish"
+  },
+  "bin": {
+    "ztechno-cli-build": "lib/scripts/docker-build.js",
+    "ztechno-cli-push": "lib/scripts/docker-push.js",
+    "ztechno-cli-update": "lib/scripts/docker-update.js",
+    "ztechno-cli-publish": "lib/scripts/docker-publish.js"
+  },
+  "keywords": [
+    "ztechno",
+    "cli"
+  ],
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.3.0",
+    "dotenv": "^17.3.1",
+    "prettier": "^3.8.1",
+    "tslint": "^6.1.3",
+    "tslint-config-prettier": "^1.18.0",
+    "tslint-eslint-rules": "^5.4.0",
+    "typescript": "^5.9.3"
+  }
+}