@ketrics/ketrics-cli 0.1.0

package/templates/ketrics-app-v1/backend/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "app3",
+  "version": "1.0.0",
+  "description": "My Ketrics application backend",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --target=es2020 --outfile=dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@ketrics/sdk-backend": "^0.3.0",
+    "@types/node": "^20.10.0",
+    "esbuild": "^0.24.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  }
+}

package/templates/ketrics-app-v1/backend/src/index.ts

@@ -0,0 +1,41 @@
+/**
+ * Ketrics Application Backend
+ *
+ * Exports handler functions compatible with Ketrics data-plane-api.
+ *
+ * The `ketrics` global object is automatically typed via @ketrics/sdk.
+ * No imports needed - just use `ketrics.*` directly.
+ *
+ * Available SDK features:
+ * - ketrics.tenant, ketrics.application, ketrics.user, ketrics.env (context)
+ * - ketrics.console (logging to CloudWatch)
+ * - ketrics.http (HTTP client for external APIs)
+ * - ketrics.Volume.connect(code) (S3-backed storage)
+ * - ketrics.DatabaseConnection.connect(code) (external databases)
+ * - ketrics.Secret.get(code) (encrypted secrets)
+ */
+
+// ============================================================================
+// Basic Handlers
+// ============================================================================
+
+import { saveFile, readFile, generateDownloadUrl } from "./volume";
+
+/**
+ * Echo handler - returns payload with context info
+ *
+ * @param payload - Any payload to echo back
+ * @returns Payload with additional context information
+ */
+
+const echo = async (payload: unknown) => {
+  ketrics.console.log("Echo called with payload:", payload);
+
+  return {
+    tenantName: ketrics.tenant.name,
+    userEmail: ketrics.user.email,
+    applicationCode: ketrics.application.code,
+  };
+};
+
+export { echo, saveFile, readFile, generateDownloadUrl };

package/templates/ketrics-app-v1/backend/src/volume.ts

@@ -0,0 +1,48 @@
+const saveFile = async () => {
+  const volume = await ketrics.Volume.connect("test-volume");
+
+  const data = {
+    id: ketrics.application.id,
+    code: ketrics.application.code,
+    name: ketrics.application.name,
+    version: ketrics.application.version,
+    deploymentId: ketrics.application.deploymentId,
+  };
+
+  // Write text/JSON content
+  const resultData = await volume.put("output/data.json", JSON.stringify(data), {
+    contentType: "application/json",
+  });
+  console.log(resultData.key, resultData.etag, resultData.size);
+
+  // Write binary content
+  const buffer = Buffer.from("Hello World");
+  const resultBuffer = await volume.put("files/hello.txt", buffer);
+
+  return {
+    data,
+    dataFile: { key: resultData.key, etag: resultData.etag, size: resultData.size },
+    bufferFile: { key: resultBuffer.key, etag: resultBuffer.etag, size: resultBuffer.size },
+  };
+};
+
+const readFile = async () => {
+  const volume = await ketrics.Volume.connect("test-volume");
+  const file = await volume.get("output/data.json");
+  if (!file) {
+    throw new Error("File not found");
+  }
+  const content = await file.content.toString();
+  return {
+    content: content,
+    parsed: JSON.parse(content),
+  };
+};
+
+const generateDownloadUrl = async () => {
+  const volume = await ketrics.Volume.connect("test-volume");
+  const results = await volume.generateDownloadUrl("output/data.json"); // URL valid for 1 hour
+  return { url: results.url };
+};
+
+export { saveFile, readFile, generateDownloadUrl };

package/templates/ketrics-app-v1/backend/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "types": ["node", "@ketrics/sdk-backend"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/ketrics-app-v1/frontend/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Ketrics Test Application</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>