@ketrics/ketrics-cli 0.2.2 → 0.3.0

package/dist/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAgEnC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAgEnC"}

package/dist/src/cli.js

@@ -12,7 +12,7 @@ const build_1 = require("./commands/build");
 const deploy_1 = require("./commands/deploy");
 const validate_1 = require("./commands/validate");
 const run_1 = require("./commands/run");
-const VERSION = "0.1.1";
+const version_1 = require("./version");
 /**
  * Create and configure CLI program
  */
@@ -21,7 +21,7 @@ function createCLI() {
     program
         .name("ketrics")
         .description("CLI tool for deploying applications to Ketrics platform")
-        .version(VERSION, "-v, --version", "Show CLI version");
+        .version(version_1.VERSION, "-v, --version", "Show CLI version");
     // Create command
     program
         .command("create <app-name>")

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAcH,8BAgEC;AA5ED,yCAAoC;AACpC,8CAAkD;AAClD,4CAAgD;AAChD,8CAAkD;AAClD,kDAAsD;AACtD,wCAA4C;AAE5C,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB;;GAEG;AACH,SAAgB,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CAAC,yDAAyD,CAAC;SACtE,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAEzD,iBAAiB;IACjB,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,uBAAuB,EAAE,oDAAoD,CAAC;SACrF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACjC,MAAM,IAAA,sBAAa,EAAC,OAAO,EAAE;YAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,gBAAgB;IAChB,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,IAAA,oBAAY,GAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEL,iBAAiB;IACjB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,WAAW,EAAE,yDAAyD,CAAC;SAC9E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,IAAA,sBAAa,EAAC;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,mBAAmB;IACnB,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;SAC5D,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,IAAA,0BAAe,EAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEL,cAAc;IACd,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,eAAe,EAAE,4CAA4C,CAAC;SACrE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAClC,MAAM,IAAA,gBAAU,EAAC,QAAQ,EAAE;YACzB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAaH,8BAgEC;AA3ED,yCAAoC;AACpC,8CAAkD;AAClD,4CAAgD;AAChD,8CAAkD;AAClD,kDAAsD;AACtD,wCAA4C;AAC5C,uCAAoC;AAEpC;;GAEG;AACH,SAAgB,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CAAC,yDAAyD,CAAC;SACtE,OAAO,CAAC,iBAAO,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAEzD,iBAAiB;IACjB,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,uBAAuB,EAAE,oDAAoD,CAAC;SACrF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACjC,MAAM,IAAA,sBAAa,EAAC,OAAO,EAAE;YAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,gBAAgB;IAChB,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,IAAA,oBAAY,GAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEL,iBAAiB;IACjB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,WAAW,EAAE,yDAAyD,CAAC;SAC9E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,IAAA,sBAAa,EAAC;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,mBAAmB;IACnB,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;SAC5D,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,IAAA,0BAAe,EAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEL,cAAc;IACd,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,eAAe,EAAE,4CAA4C,CAAC;SACrE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAClC,MAAM,IAAA,gBAAU,EAAC,QAAQ,EAAE;YACzB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.3.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/src/version.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+// Auto-generated - do not edit
+exports.VERSION = "0.3.0";
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAAA,+BAA+B;AAClB,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@ketrics/ketrics-cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "CLI tool for deploying applications to Ketrics platform",
   "main": "dist/index.js",
   "bin": {
     "ketrics": "./dist/bin/ketrics.js"
   },
   "scripts": {
-    "build": "tsc",
+    "prebuild": "node scripts/generate-version.js",
+    "build": "npm run prebuild && tsc",
     "dev": "ts-node bin/ketrics.ts",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run build"

package/templates/HelloWorld/README.md

@@ -1,134 +1,111 @@
-# Ketrics Test Application
+# Ketrics Application Template
 
-Test applications for validating the Ketrics CLI deployment workflow.
+A starter template for building applications on the Ketrics platform, demonstrating all SDK features.
 
 ## 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
+├── ketrics.config.json    # Application configuration
+├── backend/               # TypeScript handlers for Runtime API
+│   └── src/
+│       ├── index.ts       # Main exports (echo, info)
+│       ├── volumes.ts     # Volume storage examples
+│       ├── database.ts    # Database connection examples
+│       ├── pdf.ts         # PDF generation examples
+│       ├── excel.ts       # Excel workbook examples
+│       ├── secrets.ts     # Secret management examples
+│       ├── messages.ts    # User messaging examples
+│       ├── jobs.ts        # Background job examples
+│       └── http.ts        # HTTP client examples
+├── frontend/              # React + TypeScript + Vite frontend
+│   └── src/
+│       ├── App.tsx        # Main UI with feature demos
+│       └── services/      # API client (payload-wrapped requests)
+└── tests/                 # Test request definitions
 ```
 
-## Frontend
+## Backend Functions
+
+| Function | Description |
+| --- | --- |
+| `echo` | Returns payload with full context info |
+| `info` | Returns runtime environment details |
+| `saveFile` | Write JSON and text files to a volume |
+| `readFile` | Read and parse files from a volume |
+| `listFiles` | List files in a volume with prefix filtering |
+| `generateDownloadUrl` | Generate a temporary download URL |
+| `copyFile` | Copy a file within a volume |
+| `queryUsers` | Query records from a database |
+| `insertRecord` | Insert a record into a database |
+| `transferFunds` | Database transaction example |
+| `createSimplePdf` | Generate a simple PDF document |
+| `createInvoicePdf` | Generate an invoice-style PDF |
+| `createSpreadsheet` | Create an Excel workbook |
+| `exportDataToExcel` | Export data to a multi-sheet Excel file |
+| `getSecret` | Retrieve an encrypted secret |
+| `sendNotification` | Send a notification to the current user |
+| `sendBulkNotification` | Send notifications to multiple users |
+| `scheduleBackgroundJob` | Schedule a background job |
+| `getJobStatus` | Check background job status |
+| `fetchExternalApi` | Make an external HTTP request |
+
+## Ketrics SDK (v0.8.0)
+
+Backend handlers access the `ketrics` global object injected at runtime:
 
-A simple React application demonstrating:
+```typescript
+// Context
+ketrics.tenant          // { id, code, name }
+ketrics.application     // { id, code, name, version, deploymentId }
+ketrics.requestor       // { type, userId, email, name, applicationPermissions }
+ketrics.runtime         // { nodeVersion, runtime, region }
+ketrics.environment     // key-value environment variables
+
+// Utilities
+ketrics.console         // { log, error, warn, info, debug } → CloudWatch
+ketrics.http            // { get, post, put, delete } → external APIs
+
+// Feature Modules
+ketrics.Volume          // .connect(code) → S3-backed file storage
+ketrics.Database        // .connect(code) → SQL databases (PostgreSQL, MySQL, etc.)
+ketrics.Secret          // .get(code) → encrypted secrets
+ketrics.Excel           // .create() / .read(buffer) → Excel workbooks
+ketrics.Pdf             // .create() / .read(buffer) → PDF documents
+ketrics.Job             // .runInBackground(params) → async job execution
+ketrics.Messages        // .send(params) → user notifications
+```
 
-- React + TypeScript + Vite setup
-- Zod schema validation
-- Deployment via Ketrics CLI
+## Setup
 
-### Setup
+### Backend
 
 ```bash
-cd frontend
+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
-   ```
-
-## 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
+### Frontend
 
-**Echo:**
-
-```json
-{
-  "message": "Hello, World!"
-}
+```bash
+cd frontend
+npm install
+npm run build
 ```
 
-**Greet:**
+## Deploy
 
-```json
-{
-  "name": "John"
-}
+```bash
+ketrics deploy
 ```
 
-**Calculate:**
+## API Request Format
 
-```json
-{
-  "operation": "add",
-  "a": 10,
-  "b": 5
-}
-```
-
-**Fetch:**
+All function calls use the Runtime API with payload wrapped in a `payload` property:
 
 ```json
+POST /tenants/{tenantId}/applications/{applicationId}/functions/{functionName}
 {
-  "url": "https://api.example.com/data"
+  "payload": { "your": "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

package/templates/HelloWorld/backend/package.json

@@ -9,7 +9,7 @@
     "clean": "rm -rf dist"
   },
   "devDependencies": {
-    "@ketrics/sdk-backend": "0.7.1",
+    "@ketrics/sdk-backend": "0.8.0",
     "@types/node": ">=24.0.0",
     "esbuild": "^0.27.2",
     "ts-node": "^1.7.1",

package/templates/HelloWorld/backend/src/database.ts

@@ -0,0 +1,108 @@
+/**
+ * Database Examples
+ *
+ * Demonstrates external SQL database operations using ketrics.Database.
+ * Data connections must be configured and granted to the application in the Ketrics portal.
+ *
+ * Supports PostgreSQL, MySQL, SQL Server, and Oracle databases.
+ */
+
+/**
+ * Query records from a database.
+ */
+const queryUsers = async (payload: { limit?: number }) => {
+  const db = await ketrics.Database.connect("my-database");
+
+  try {
+    const result = await db.query<{ id: number; name: string; email: string }>(
+      "SELECT id, name, email FROM users ORDER BY name LIMIT $1",
+      [payload?.limit || 10],
+    );
+
+    return {
+      users: result.rows,
+      rowCount: result.rowCount,
+    };
+  } finally {
+    await db.close();
+  }
+};
+
+/**
+ * Insert a record into a database.
+ */
+const insertRecord = async (payload: { name: string; email: string }) => {
+  if (!payload?.name || !payload?.email) {
+    throw new Error("name and email are required");
+  }
+
+  const db = await ketrics.Database.connect("my-database");
+
+  try {
+    const result = await db.execute(
+      "INSERT INTO users (name, email, created_at) VALUES ($1, $2, NOW())",
+      [payload.name, payload.email],
+    );
+
+    return {
+      affectedRows: result.affectedRows,
+      insertId: result.insertId,
+    };
+  } finally {
+    await db.close();
+  }
+};
+
+/**
+ * Perform a database transaction - demonstrates atomic multi-step operations.
+ * Transactions automatically commit on success or rollback on error.
+ */
+const transferFunds = async (payload: {
+  fromAccountId: number;
+  toAccountId: number;
+  amount: number;
+}) => {
+  if (!payload?.fromAccountId || !payload?.toAccountId || !payload?.amount) {
+    throw new Error("fromAccountId, toAccountId, and amount are required");
+  }
+
+  if (payload.amount <= 0) {
+    throw new Error("Amount must be positive");
+  }
+
+  const db = await ketrics.Database.connect("my-database");
+
+  try {
+    const result = await db.transaction(async (tx) => {
+      // Debit source account
+      const debit = await tx.execute(
+        "UPDATE accounts SET balance = balance - $1 WHERE id = $2 AND balance >= $1",
+        [payload.amount, payload.fromAccountId],
+      );
+
+      if (debit.affectedRows === 0) {
+        throw new Error("Insufficient funds or account not found");
+      }
+
+      // Credit destination account
+      await tx.execute(
+        "UPDATE accounts SET balance = balance + $1 WHERE id = $2",
+        [payload.amount, payload.toAccountId],
+      );
+
+      // Log the transfer
+      await tx.execute(
+        "INSERT INTO transfers (from_account, to_account, amount, created_at) VALUES ($1, $2, $3, NOW())",
+        [payload.fromAccountId, payload.toAccountId, payload.amount],
+      );
+
+      return { transferred: payload.amount };
+    });
+
+    return result;
+  } finally {
+    await db.close();
+  }
+};
+
+export { queryUsers, insertRecord, transferFunds };

package/templates/HelloWorld/backend/src/excel.ts

@@ -0,0 +1,118 @@
+/**
+ * Excel Examples
+ *
+ * Demonstrates Excel workbook creation using ketrics.Excel.
+ * Generated workbooks can be saved to a volume for download.
+ */
+
+/**
+ * Create a spreadsheet with headers and sample data.
+ */
+const createSpreadsheet = async () => {
+  const workbook = ketrics.Excel.create();
+
+  // Create a worksheet with column definitions
+  const sheet = workbook.addWorksheet("Employees", {
+    tabColor: "4472C4",
+  });
+
+  // Define columns
+  sheet.columns = [
+    { header: "ID", key: "id", width: 10 },
+    { header: "Name", key: "name", width: 25 },
+    { header: "Department", key: "department", width: 20 },
+    { header: "Start Date", key: "startDate", width: 15 },
+    { header: "Salary", key: "salary", width: 15 },
+  ];
+
+  // Add rows
+  const employees = [
+    { id: 1, name: "Alice Johnson", department: "Engineering", startDate: "2024-01-15", salary: 95000 },
+    { id: 2, name: "Bob Smith", department: "Marketing", startDate: "2023-06-01", salary: 78000 },
+    { id: 3, name: "Carol Williams", department: "Engineering", startDate: "2024-03-20", salary: 105000 },
+    { id: 4, name: "David Brown", department: "Sales", startDate: "2023-09-10", salary: 82000 },
+    { id: 5, name: "Eva Martinez", department: "Engineering", startDate: "2024-07-01", salary: 92000 },
+  ];
+
+  sheet.addRows(employees);
+
+  // Save to volume
+  const buffer = await workbook.toBuffer();
+  const volume = await ketrics.Volume.connect("test-volume");
+  const result = await volume.put("reports/employees.xlsx", buffer, {
+    contentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  });
+
+  const downloadUrl = await volume.generateDownloadUrl("reports/employees.xlsx", {
+    expiresIn: 3600,
+  });
+
+  return {
+    file: { key: result.key, size: result.size },
+    downloadUrl: downloadUrl.url,
+    rowCount: employees.length,
+  };
+};
+
+/**
+ * Export dynamic data to Excel - demonstrates creating a multi-sheet
+ * workbook with a summary sheet and a data sheet.
+ */
+const exportDataToExcel = async (payload: { title?: string }) => {
+  const title = payload?.title || "Data Export";
+
+  const workbook = ketrics.Excel.create();
+
+  // Summary sheet
+  const summarySheet = workbook.addWorksheet("Summary");
+  summarySheet.columns = [
+    { header: "Property", key: "property", width: 25 },
+    { header: "Value", key: "value", width: 40 },
+  ];
+
+  summarySheet.addRows([
+    { property: "Report Title", value: title },
+    { property: "Generated By", value: ketrics.application.name },
+    { property: "Tenant", value: ketrics.tenant.name },
+    { property: "Generated At", value: new Date().toISOString() },
+    { property: "Requestor", value: ketrics.requestor.name },
+  ]);
+
+  // Data sheet with sample data
+  const dataSheet = workbook.addWorksheet("Data");
+  dataSheet.columns = [
+    { header: "Category", key: "category", width: 20 },
+    { header: "Month", key: "month", width: 15 },
+    { header: "Revenue", key: "revenue", width: 15 },
+    { header: "Expenses", key: "expenses", width: 15 },
+    { header: "Profit", key: "profit", width: 15 },
+  ];
+
+  const sampleData = [
+    { category: "Product A", month: "January", revenue: 50000, expenses: 30000, profit: 20000 },
+    { category: "Product A", month: "February", revenue: 55000, expenses: 31000, profit: 24000 },
+    { category: "Product B", month: "January", revenue: 35000, expenses: 20000, profit: 15000 },
+    { category: "Product B", month: "February", revenue: 40000, expenses: 22000, profit: 18000 },
+  ];
+
+  dataSheet.addRows(sampleData);
+
+  // Save to volume
+  const buffer = await workbook.toBuffer();
+  const volume = await ketrics.Volume.connect("test-volume");
+  const fileName = `reports/export-${Date.now()}.xlsx`;
+  const result = await volume.put(fileName, buffer, {
+    contentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  });
+
+  const downloadUrl = await volume.generateDownloadUrl(fileName, { expiresIn: 3600 });
+
+  return {
+    file: { key: result.key, size: result.size },
+    downloadUrl: downloadUrl.url,
+    sheets: ["Summary", "Data"],
+    dataRowCount: sampleData.length,
+  };
+};
+
+export { createSpreadsheet, exportDataToExcel };

package/templates/HelloWorld/backend/src/http.ts

@@ -0,0 +1,22 @@
+/**
+ * HTTP Client Examples
+ *
+ * Demonstrates making external HTTP requests using ketrics.http.
+ * The HTTP client supports GET, POST, PUT, and DELETE methods.
+ */
+
+/**
+ * Fetch data from an external API.
+ */
+const fetchExternalApi = async (payload: { url?: string }) => {
+  const url = payload?.url || "https://jsonplaceholder.typicode.com/posts/1";
+
+  const response = await ketrics.http.get<{ id: number; title: string; body: string }>(url);
+
+  return {
+    data: response,
+    fetchedAt: new Date().toISOString(),
+  };
+};
+
+export { fetchExternalApi };