@ketrics/ketrics-cli 0.1.0

package/dist/src/utils/logger.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Logger Utility
+ *
+ * Provides colored console output for CLI messages.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+exports.logger = {
+    /**
+     * Log info message (blue)
+     */
+    info: (message) => {
+        console.log(chalk_1.default.blue('ℹ'), message);
+    },
+    /**
+     * Log success message (green)
+     */
+    success: (message) => {
+        console.log(chalk_1.default.green('✔'), message);
+    },
+    /**
+     * Log warning message (yellow)
+     */
+    warn: (message) => {
+        console.log(chalk_1.default.yellow('⚠'), message);
+    },
+    /**
+     * Log error message (red)
+     */
+    error: (message) => {
+        console.log(chalk_1.default.red('✖'), message);
+    },
+    /**
+     * Log plain message
+     */
+    log: (message) => {
+        console.log(message);
+    },
+    /**
+     * Log newline
+     */
+    newline: () => {
+        console.log();
+    },
+    /**
+     * Log header (bold)
+     */
+    header: (message) => {
+        console.log();
+        console.log(chalk_1.default.bold(message));
+        console.log();
+    },
+    /**
+     * Log key-value pair
+     */
+    keyValue: (key, value) => {
+        console.log(`  ${chalk_1.default.gray(key + ':')} ${value}`);
+    },
+    /**
+     * Log indented message
+     */
+    indent: (message, level = 1) => {
+        const indent = '  '.repeat(level);
+        console.log(`${indent}${message}`);
+    },
+    /**
+     * Log file info
+     */
+    file: (path, size) => {
+        if (size) {
+            console.log(`    ${chalk_1.default.cyan(path)} ${chalk_1.default.gray(`(${size})`)}`);
+        }
+        else {
+            console.log(`    ${chalk_1.default.cyan(path)}`);
+        }
+    },
+    /**
+     * Log box with title
+     */
+    box: (title, content) => {
+        console.log();
+        console.log(chalk_1.default.bold.green(`  ✅ ${title}`));
+        console.log();
+        content.forEach((line) => {
+            console.log(`  ${line}`);
+        });
+        console.log();
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,kDAA0B;AAEb,QAAA,MAAM,GAAG;IACpB;;OAEG;IACH,IAAI,EAAE,CAAC,OAAe,EAAQ,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,OAAO,EAAE,CAAC,OAAe,EAAQ,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,IAAI,EAAE,CAAC,OAAe,EAAQ,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,EAAE,CAAC,OAAe,EAAQ,EAAE;QAC/B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,GAAG,EAAE,CAAC,OAAe,EAAQ,EAAE;QAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,OAAO,EAAE,GAAS,EAAE;QAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,EAAE,CAAC,OAAe,EAAQ,EAAE;QAChC,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;QAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,eAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,MAAM,EAAE,CAAC,OAAe,EAAE,KAAK,GAAG,CAAC,EAAQ,EAAE;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,EAAE,CAAC,IAAY,EAAE,IAAa,EAAQ,EAAE;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,OAAO,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,OAAO,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,EAAE,CAAC,KAAa,EAAE,OAAiB,EAAQ,EAAE;QAC9C,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACvB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/src/utils/spinner.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Spinner Utility
+ *
+ * Provides loading spinners for long-running operations.
+ */
+import { Ora } from 'ora';
+/**
+ * Create and start a spinner
+ */
+export declare function createSpinner(text: string): Ora;
+/**
+ * Execute an async operation with spinner
+ */
+export declare function withSpinner<T>(text: string, operation: () => Promise<T>, successText?: string): Promise<T>;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/src/utils/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/B;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAK/C;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/src/utils/spinner.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Spinner Utility
+ *
+ * Provides loading spinners for long-running operations.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpinner = createSpinner;
+exports.withSpinner = withSpinner;
+const ora_1 = __importDefault(require("ora"));
+/**
+ * Create and start a spinner
+ */
+function createSpinner(text) {
+    return (0, ora_1.default)({
+        text,
+        spinner: 'dots',
+    }).start();
+}
+/**
+ * Execute an async operation with spinner
+ */
+async function withSpinner(text, operation, successText) {
+    const spinner = createSpinner(text);
+    try {
+        const result = await operation();
+        spinner.succeed(successText || text);
+        return result;
+    }
+    catch (error) {
+        spinner.fail(text);
+        throw error;
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/src/utils/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../../src/utils/spinner.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;AAOH,sCAKC;AAKD,kCAeC;AA9BD,8CAA+B;AAE/B;;GAEG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAA,aAAG,EAAC;QACT,IAAI;QACJ,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC,KAAK,EAAE,CAAC;AACb,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,SAA2B,EAC3B,WAAoB;IAEpB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@ketrics/ketrics-cli",
+  "version": "0.1.0",
+  "description": "CLI tool for deploying applications to Ketrics platform",
+  "main": "dist/index.js",
+  "bin": {
+    "ketrics": "./dist/bin/ketrics.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node bin/ketrics.ts",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ketrics",
+    "cli",
+    "deploy",
+    "serverless"
+  ],
+  "author": "Ketrics",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.10.1",
+    "archiver": "^6.0.1",
+    "axios": "^1.6.0",
+    "chalk": "^4.1.2",
+    "commander": "^12.0.0",
+    "dotenv": "^16.3.1",
+    "glob": "^10.3.0",
+    "ora": "^5.4.1",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/archiver": "^6.0.2",
+    "@types/node": "^20.10.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ]
+}

package/templates/ketrics-app-v1/.env.example

@@ -0,0 +1,17 @@
+# Ketrics Deployment Configuration
+# Copy this file to .env and fill in your values
+
+# Deployment token from Ketrics dashboard
+KETRICS_TOKEN=ktd_your-token-id_your-secret-key
+
+# API URL (default for production)
+KETRICS_API_URL=https://api.ketrics.cl/api/v1
+
+# Your tenant ID
+KETRICS_TENANT_ID=your-tenant-uuid
+
+# Application ID for this backend
+KETRICS_APPLICATION_ID=your-application-uuid
+
+# Optional: Custom authentication token (JWT) for Ketrics API
+KETRICS_AUTH_TOKEN=your-jwt-auth-token

package/templates/ketrics-app-v1/README.md

@@ -0,0 +1,134 @@
+# Ketrics Test Application
+
+Test applications for validating the Ketrics CLI deployment workflow.
+
+## Structure
+
+```
+test-application/
+├── frontend/          # React + TypeScript + Vite frontend
+│   ├── src/
+│   ├── ketrics.config.json
+│   └── .env.example
+└── backend/           # TypeScript handlers for data-plane
+    ├── src/
+    ├── ketrics.config.json
+    └── .env.example
+```
+
+## Frontend
+
+A simple React application demonstrating:
+
+- React + TypeScript + Vite setup
+- Zod schema validation
+- Deployment via Ketrics CLI
+
+### Setup
+
+```bash
+cd frontend
+npm install
+npm run build
+```
+
+### Deploy
+
+1. Copy `.env.example` to `.env` and fill in your credentials:
+
+   ```bash
+   cp .env.example .env
+   ```
+
+2. Deploy:
+   ```bash
+   ketrics deploy
+   ```
+
+## Backend
+
+TypeScript handlers compatible with Ketrics data-plane-api.
+
+### Available Actions
+
+| Action      | Description                     |
+| ----------- | ------------------------------- |
+| `echo`      | Returns payload with context    |
+| `greet`     | Personalized greeting           |
+| `calculate` | Simple math operations          |
+| `fetch`     | Test HTTP client                |
+| `info`      | Environment and context info    |
+
+### Example Payloads
+
+**Echo:**
+
+```json
+{
+  "message": "Hello, World!"
+}
+```
+
+**Greet:**
+
+```json
+{
+  "name": "John"
+}
+```
+
+**Calculate:**
+
+```json
+{
+  "operation": "add",
+  "a": 10,
+  "b": 5
+}
+```
+
+**Fetch:**
+
+```json
+{
+  "url": "https://api.example.com/data"
+}
+```
+
+### Setup
+
+```bash
+cd backend
+npm install
+npm run build
+```
+
+### Deploy
+
+1. Copy `.env.example` to `.env` and fill in your credentials:
+
+   ```bash
+   cp .env.example .env
+   ```
+
+2. Deploy:
+   ```bash
+   ketrics deploy
+   ```
+
+## Ketrics SDK
+
+The backend handlers have access to the `ketrics` global object injected at runtime:
+
+```typescript
+ketrics.tenant    // { id, code, name }
+ketrics.application  // { id, code, name, version, deploymentId }
+ketrics.user      // { id, email, name, isAdmin }
+ketrics.env       // { nodeVersion, runtime, region }
+ketrics.console   // { log, error }
+ketrics.http      // { get, post }
+```
+
+## License
+
+MIT