appwrite-utils-cli 1.9.7 → 1.12.0

package/dist/functions/templates/hono-typescript/src/app.ts

@@ -1,180 +1,180 @@
-import { Hono } from "hono";
-import { Client, Databases, Storage, Users } from "node-appwrite";
-import { appwriteMiddleware, requestLogger, errorHandler, appwriteHeaders } from "./middleware/appwrite.js";
-
-// Create the Hono app
-export const app = new Hono();
-
-// Global middleware - Applied to all routes
-app.use("*", errorHandler());
-app.use("*", requestLogger());
-app.use("*", appwriteHeaders());
-
-// Helper function to get initialized Appwrite client
-function getAppwriteClient(c: any) {
-  const appwriteContext = c.get("appwriteContext");
-
-  const client = new Client()
-    .setEndpoint(process.env["APPWRITE_FUNCTION_ENDPOINT"]!)
-    .setProject(process.env["APPWRITE_FUNCTION_PROJECT_ID"]!)
-    .setKey(appwriteContext.req.headers["x-appwrite-key"] || process.env["APPWRITE_FUNCTION_API_KEY"]!);
-
-  return {
-    client,
-    databases: new Databases(client),
-    storage: new Storage(client),
-    users: new Users(client),
-  };
-}
-
-// Routes
-
-// Health check endpoint
-app.get("/", (c) => {
-  c.log("Health check requested");
-  return c.json({
-    message: "Hello from {{functionName}} with Hono!",
-    functionName: "{{functionName}}",
-    timestamp: new Date().toISOString(),
-    method: c.req.method,
-    path: c.req.path,
-    appwriteTrigger: c.appwrite.trigger,
-    isAuthenticated: c.appwrite.isUserAuthenticated(),
-  });
-});
-
-// API health endpoint
-app.get("/health", (c) => {
-  return c.json({
-    status: "healthy",
-    timestamp: new Date().toISOString(),
-    version: "1.0.0",
-    environment: {
-      nodeVersion: process.version,
-      appwriteEndpoint: process.env["APPWRITE_FUNCTION_ENDPOINT"],
-      appwriteProject: process.env["APPWRITE_FUNCTION_PROJECT_ID"],
-      appwriteRuntime: process.env["APPWRITE_FUNCTION_RUNTIME_NAME"],
-    },
-  });
-});
-
-// Example API endpoints
-
-// GET /api/user - Get current user info
-app.get("/api/user", async (c) => {
-  if (!c.appwrite.isUserAuthenticated()) {
-    return c.json({ error: "User not authenticated" }, 401);
-  }
-
-  try {
-    const { users } = getAppwriteClient(c);
-    const user = await users.get(c.appwrite.userId!);
-
-    c.log(`Retrieved user info for ${user.email}`);
-    return c.json({ user });
-  } catch (error) {
-    c.error(`Failed to get user: ${error}`);
-    return c.json({ error: "Failed to retrieve user" }, 500);
-  }
-});
-
-// POST /api/webhook - Generic webhook handler
-app.post("/api/webhook", async (c) => {
-  const data = await c.req.json();
-
-  c.log(`Webhook received: ${JSON.stringify(data)}`);
-
-  // Process webhook data here
-  // Example: Save to database, send notifications, etc.
-
-  return c.json({
-    message: "Webhook processed successfully",
-    received: data,
-    timestamp: new Date().toISOString(),
-    event: c.appwrite.event,
-  });
-});
-
-// GET /api/databases - List databases (requires API key)
-app.get("/api/databases", async (c) => {
-  if (!c.appwrite.isApiKeyRequest()) {
-    return c.json({ error: "API key required" }, 401);
-  }
-
-  try {
-    const { databases } = getAppwriteClient(c);
-    const databasesList = await databases.list();
-
-    c.log(`Listed ${databasesList.databases.length} databases`);
-    return c.json({ databases: databasesList.databases });
-  } catch (error) {
-    c.error(`Failed to list databases: ${error}`);
-    return c.json({ error: "Failed to list databases" }, 500);
-  }
-});
-
-// POST /api/data/:databaseId/:collectionId - Create document
-app.post("/api/data/:databaseId/:collectionId", async (c) => {
-  const databaseId = c.req.param("databaseId");
-  const collectionId = c.req.param("collectionId");
-  const data = await c.req.json();
-
-  try {
-    const { databases } = getAppwriteClient(c);
-    const document = await databases.createDocument(
-      databaseId,
-      collectionId,
-      "unique()",
-      data
-    );
-
-    c.log(`Created document in ${databaseId}/${collectionId}`);
-    return c.json({ document }, 201);
-  } catch (error) {
-    c.error(`Failed to create document: ${error}`);
-    return c.json({ error: "Failed to create document" }, 500);
-  }
-});
-
-// GET /api/data/:databaseId/:collectionId - List documents
-app.get("/api/data/:databaseId/:collectionId", async (c) => {
-  const databaseId = c.req.param("databaseId");
-  const collectionId = c.req.param("collectionId");
-  const limit = parseInt(c.req.query("limit") || "25");
-  const offset = parseInt(c.req.query("offset") || "0");
-
-  try {
-    const { databases } = getAppwriteClient(c);
-    const documents = await databases.listDocuments(
-      databaseId,
-      collectionId,
-      undefined,
-      limit,
-      offset
-    );
-
-    c.log(`Listed ${documents.documents.length} documents from ${databaseId}/${collectionId}`);
-    return c.json({ documents: documents.documents, total: documents.total });
-  } catch (error) {
-    c.error(`Failed to list documents: ${error}`);
-    return c.json({ error: "Failed to list documents" }, 500);
-  }
-});
-
-// Handle 404s
-app.notFound((c) => {
-  c.log(`Route not found: ${c.req.method} ${c.req.path}`);
-  return c.json({
-    error: "Not Found",
-    message: `Route ${c.req.method} ${c.req.path} not found`,
-    availableRoutes: [
-      "GET /",
-      "GET /health",
-      "GET /api/user",
-      "POST /api/webhook",
-      "GET /api/databases",
-      "POST /api/data/:databaseId/:collectionId",
-      "GET /api/data/:databaseId/:collectionId",
-    ],
-  }, 404);
+import { Hono } from "hono";
+import { Client, Databases, Storage, Users } from "node-appwrite";
+import { appwriteMiddleware, requestLogger, errorHandler, appwriteHeaders } from "./middleware/appwrite.js";
+
+// Create the Hono app
+export const app = new Hono();
+
+// Global middleware - Applied to all routes
+app.use("*", errorHandler());
+app.use("*", requestLogger());
+app.use("*", appwriteHeaders());
+
+// Helper function to get initialized Appwrite client
+function getAppwriteClient(c: any) {
+  const appwriteContext = c.get("appwriteContext");
+
+  const client = new Client()
+    .setEndpoint(process.env["APPWRITE_FUNCTION_ENDPOINT"]!)
+    .setProject(process.env["APPWRITE_FUNCTION_PROJECT_ID"]!)
+    .setKey(appwriteContext.req.headers["x-appwrite-key"] || process.env["APPWRITE_FUNCTION_API_KEY"]!);
+
+  return {
+    client,
+    databases: new Databases(client),
+    storage: new Storage(client),
+    users: new Users(client),
+  };
+}
+
+// Routes
+
+// Health check endpoint
+app.get("/", (c) => {
+  c.log("Health check requested");
+  return c.json({
+    message: "Hello from {{functionName}} with Hono!",
+    functionName: "{{functionName}}",
+    timestamp: new Date().toISOString(),
+    method: c.req.method,
+    path: c.req.path,
+    appwriteTrigger: c.appwrite.trigger,
+    isAuthenticated: c.appwrite.isUserAuthenticated(),
+  });
+});
+
+// API health endpoint
+app.get("/health", (c) => {
+  return c.json({
+    status: "healthy",
+    timestamp: new Date().toISOString(),
+    version: "1.0.0",
+    environment: {
+      nodeVersion: process.version,
+      appwriteEndpoint: process.env["APPWRITE_FUNCTION_ENDPOINT"],
+      appwriteProject: process.env["APPWRITE_FUNCTION_PROJECT_ID"],
+      appwriteRuntime: process.env["APPWRITE_FUNCTION_RUNTIME_NAME"],
+    },
+  });
+});
+
+// Example API endpoints
+
+// GET /api/user - Get current user info
+app.get("/api/user", async (c) => {
+  if (!c.appwrite.isUserAuthenticated()) {
+    return c.json({ error: "User not authenticated" }, 401);
+  }
+
+  try {
+    const { users } = getAppwriteClient(c);
+    const user = await users.get(c.appwrite.userId!);
+
+    c.log(`Retrieved user info for ${user.email}`);
+    return c.json({ user });
+  } catch (error) {
+    c.error(`Failed to get user: ${error}`);
+    return c.json({ error: "Failed to retrieve user" }, 500);
+  }
+});
+
+// POST /api/webhook - Generic webhook handler
+app.post("/api/webhook", async (c) => {
+  const data = await c.req.json();
+
+  c.log(`Webhook received: ${JSON.stringify(data)}`);
+
+  // Process webhook data here
+  // Example: Save to database, send notifications, etc.
+
+  return c.json({
+    message: "Webhook processed successfully",
+    received: data,
+    timestamp: new Date().toISOString(),
+    event: c.appwrite.event,
+  });
+});
+
+// GET /api/databases - List databases (requires API key)
+app.get("/api/databases", async (c) => {
+  if (!c.appwrite.isApiKeyRequest()) {
+    return c.json({ error: "API key required" }, 401);
+  }
+
+  try {
+    const { databases } = getAppwriteClient(c);
+    const databasesList = await databases.list();
+
+    c.log(`Listed ${databasesList.databases.length} databases`);
+    return c.json({ databases: databasesList.databases });
+  } catch (error) {
+    c.error(`Failed to list databases: ${error}`);
+    return c.json({ error: "Failed to list databases" }, 500);
+  }
+});
+
+// POST /api/data/:databaseId/:collectionId - Create document
+app.post("/api/data/:databaseId/:collectionId", async (c) => {
+  const databaseId = c.req.param("databaseId");
+  const collectionId = c.req.param("collectionId");
+  const data = await c.req.json();
+
+  try {
+    const { databases } = getAppwriteClient(c);
+    const document = await databases.createDocument(
+      databaseId,
+      collectionId,
+      "unique()",
+      data
+    );
+
+    c.log(`Created document in ${databaseId}/${collectionId}`);
+    return c.json({ document }, 201);
+  } catch (error) {
+    c.error(`Failed to create document: ${error}`);
+    return c.json({ error: "Failed to create document" }, 500);
+  }
+});
+
+// GET /api/data/:databaseId/:collectionId - List documents
+app.get("/api/data/:databaseId/:collectionId", async (c) => {
+  const databaseId = c.req.param("databaseId");
+  const collectionId = c.req.param("collectionId");
+  const limit = parseInt(c.req.query("limit") || "25");
+  const offset = parseInt(c.req.query("offset") || "0");
+
+  try {
+    const { databases } = getAppwriteClient(c);
+    const documents = await databases.listDocuments(
+      databaseId,
+      collectionId,
+      undefined,
+      limit,
+      offset
+    );
+
+    c.log(`Listed ${documents.documents.length} documents from ${databaseId}/${collectionId}`);
+    return c.json({ documents: documents.documents, total: documents.total });
+  } catch (error) {
+    c.error(`Failed to list documents: ${error}`);
+    return c.json({ error: "Failed to list documents" }, 500);
+  }
+});
+
+// Handle 404s
+app.notFound((c) => {
+  c.log(`Route not found: ${c.req.method} ${c.req.path}`);
+  return c.json({
+    error: "Not Found",
+    message: `Route ${c.req.method} ${c.req.path} not found`,
+    availableRoutes: [
+      "GET /",
+      "GET /health",
+      "GET /api/user",
+      "POST /api/webhook",
+      "GET /api/databases",
+      "POST /api/data/:databaseId/:collectionId",
+      "GET /api/data/:databaseId/:collectionId",
+    ],
+  }, 404);
 });

package/dist/functions/templates/hono-typescript/src/context.ts

@@ -1,103 +1,103 @@
-import { z } from "zod";
-
-/**
- * Appwrite Request Headers Schema
- */
-export const AppwriteHeadersSchema = z.object({
-    "x-appwrite-trigger": z.enum(["http", "schedule", "event"]).optional(),
-    "x-appwrite-event": z.string().optional(),
-    "x-appwrite-key": z.string().optional(),
-    "x-appwrite-user-id": z.string().optional(),
-    "x-appwrite-user-jwt": z.string().optional(),
-    "x-appwrite-country-code": z.string().optional(),
-    "x-appwrite-continent-code": z.string().optional(),
-    "x-appwrite-continent-eu": z.string().optional(),
-}).catchall(z.string()); // Allow additional headers
-
-/**
- * Appwrite Environment Variables Schema
- */
-export const AppwriteEnvSchema = z.object({
-    APPWRITE_FUNCTION_API_ENDPOINT: z.string(),
-    APPWRITE_VERSION: z.string(),
-    APPWRITE_REGION: z.string(),
-    APPWRITE_FUNCTION_API_KEY: z.string().optional(),
-    APPWRITE_FUNCTION_ID: z.string(),
-    APPWRITE_FUNCTION_NAME: z.string(),
-    APPWRITE_FUNCTION_DEPLOYMENT: z.string(),
-    APPWRITE_FUNCTION_PROJECT_ID: z.string(),
-    APPWRITE_FUNCTION_RUNTIME_NAME: z.string(),
-    APPWRITE_FUNCTION_RUNTIME_VERSION: z.string(),
-});
-
-/**
- * Appwrite Request Schema (full version from docs)
- */
-export const AppwriteRequestSchema = z.object({
-    bodyText: z.string().optional(),
-    bodyJson: z.union([z.any(), z.string()]).transform((t) => {
-        if (typeof t === "string") {
-            try {
-                return JSON.parse(t);
-            } catch {
-                return null;
-            }
-        }
-        return t;
-    }).optional(),
-    body: z.any().optional(),
-    headers: AppwriteHeadersSchema,
-    scheme: z.enum(["http", "https"]).optional(),
-    method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS", "HEAD"]),
-    url: z.string().optional(),
-    host: z.string().optional(),
-    port: z.number().or(z.string()).optional(),
-    path: z.string().optional(),
-    queryString: z.string().optional(),
-    query: z.record(z.string(), z.any()).optional(),
-    variables: z.record(z.string(), z.any()).optional(),
-    text: z.any().optional(),
-    payload: z.string().optional(),
-});
-
-/**
- * Appwrite Response Schema
- */
-export const AppwriteResponseSchema = z.object({
-    json: z.any(),
-    text: z.any(),
-    empty: z.any().optional(),
-    binary: z.any().optional(),
-    redirect: z.any().optional(),
-});
-
-/**
- * Log Function Schema - Simple function type
- */
-export const AppwriteLogSchema = z.any();
-
-/**
- * Error Function Schema - Simple function type
- */
-export const AppwriteErrorSchema = z.any();
-
-/**
- * Complete Appwrite Context Schema
- */
-export const AppwriteContextSchema = z.object({
-    req: AppwriteRequestSchema,
-    res: AppwriteResponseSchema,
-    log: AppwriteLogSchema,
-    error: AppwriteErrorSchema,
-});
-
-/**
- * Type inference helpers
- */
-export type AppwriteHeaders = z.infer<typeof AppwriteHeadersSchema>;
-export type AppwriteEnv = z.infer<typeof AppwriteEnvSchema>;
-export type AppwriteRequest = z.infer<typeof AppwriteRequestSchema>;
-export type AppwriteResponse = z.infer<typeof AppwriteResponseSchema>;
-export type AppwriteLog = z.infer<typeof AppwriteLogSchema>;
-export type AppwriteError = z.infer<typeof AppwriteErrorSchema>;
+import { z } from "zod";
+
+/**
+ * Appwrite Request Headers Schema
+ */
+export const AppwriteHeadersSchema = z.object({
+    "x-appwrite-trigger": z.enum(["http", "schedule", "event"]).optional(),
+    "x-appwrite-event": z.string().optional(),
+    "x-appwrite-key": z.string().optional(),
+    "x-appwrite-user-id": z.string().optional(),
+    "x-appwrite-user-jwt": z.string().optional(),
+    "x-appwrite-country-code": z.string().optional(),
+    "x-appwrite-continent-code": z.string().optional(),
+    "x-appwrite-continent-eu": z.string().optional(),
+}).catchall(z.string()); // Allow additional headers
+
+/**
+ * Appwrite Environment Variables Schema
+ */
+export const AppwriteEnvSchema = z.object({
+    APPWRITE_FUNCTION_API_ENDPOINT: z.string(),
+    APPWRITE_VERSION: z.string(),
+    APPWRITE_REGION: z.string(),
+    APPWRITE_FUNCTION_API_KEY: z.string().optional(),
+    APPWRITE_FUNCTION_ID: z.string(),
+    APPWRITE_FUNCTION_NAME: z.string(),
+    APPWRITE_FUNCTION_DEPLOYMENT: z.string(),
+    APPWRITE_FUNCTION_PROJECT_ID: z.string(),
+    APPWRITE_FUNCTION_RUNTIME_NAME: z.string(),
+    APPWRITE_FUNCTION_RUNTIME_VERSION: z.string(),
+});
+
+/**
+ * Appwrite Request Schema (full version from docs)
+ */
+export const AppwriteRequestSchema = z.object({
+    bodyText: z.string().optional(),
+    bodyJson: z.union([z.any(), z.string()]).transform((t) => {
+        if (typeof t === "string") {
+            try {
+                return JSON.parse(t);
+            } catch {
+                return null;
+            }
+        }
+        return t;
+    }).optional(),
+    body: z.any().optional(),
+    headers: AppwriteHeadersSchema,
+    scheme: z.enum(["http", "https"]).optional(),
+    method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS", "HEAD"]),
+    url: z.string().optional(),
+    host: z.string().optional(),
+    port: z.number().or(z.string()).optional(),
+    path: z.string().optional(),
+    queryString: z.string().optional(),
+    query: z.record(z.string(), z.any()).optional(),
+    variables: z.record(z.string(), z.any()).optional(),
+    text: z.any().optional(),
+    payload: z.string().optional(),
+});
+
+/**
+ * Appwrite Response Schema
+ */
+export const AppwriteResponseSchema = z.object({
+    json: z.any(),
+    text: z.any(),
+    empty: z.any().optional(),
+    binary: z.any().optional(),
+    redirect: z.any().optional(),
+});
+
+/**
+ * Log Function Schema - Simple function type
+ */
+export const AppwriteLogSchema = z.any();
+
+/**
+ * Error Function Schema - Simple function type
+ */
+export const AppwriteErrorSchema = z.any();
+
+/**
+ * Complete Appwrite Context Schema
+ */
+export const AppwriteContextSchema = z.object({
+    req: AppwriteRequestSchema,
+    res: AppwriteResponseSchema,
+    log: AppwriteLogSchema,
+    error: AppwriteErrorSchema,
+});
+
+/**
+ * Type inference helpers
+ */
+export type AppwriteHeaders = z.infer<typeof AppwriteHeadersSchema>;
+export type AppwriteEnv = z.infer<typeof AppwriteEnvSchema>;
+export type AppwriteRequest = z.infer<typeof AppwriteRequestSchema>;
+export type AppwriteResponse = z.infer<typeof AppwriteResponseSchema>;
+export type AppwriteLog = z.infer<typeof AppwriteLogSchema>;
+export type AppwriteError = z.infer<typeof AppwriteErrorSchema>;
 export type AppwriteContext = z.infer<typeof AppwriteContextSchema>;

package/{src/functions/templates/hono-typescript/src/index.ts → dist/functions/templates/hono-typescript/src/main.ts}

@@ -1,54 +1,54 @@
-import { app } from "./app.js";
-import { AppwriteContext, AppwriteContextSchema } from "./context.js";
-import { convertAppwriteToWebRequest } from "./adapters/request.js";
-import { convertWebResponseToAppwrite } from "./adapters/response.js";
-import { appwriteMiddleware } from "./middleware/appwrite.js";
-
-/**
- * Main Appwrite function entry point
- * This function receives the Appwrite context and routes it through Hono
- */
-export default async function (context: AppwriteContext) {
-  const { req, res, log, error } = context;
-
-  try {
-    // Optional: Validate the context using Zod schema
-    AppwriteContextSchema.parse(context);
-    log("Context validation successful");
-
-    // Add Appwrite context middleware to the Hono app
-    app.use("*", appwriteMiddleware(context));
-
-    // Convert Appwrite request to Web API Request for Hono
-    const webRequest = convertAppwriteToWebRequest(req);
-
-    log(`Processing ${req.method} request to ${req.path || "/"}`);
-
-    // Create execution environment for Hono
-    const env = {
-      // Add any environment variables or context needed by Hono
-      APPWRITE_FUNCTION_ENDPOINT: process.env["APPWRITE_FUNCTION_ENDPOINT"],
-      APPWRITE_FUNCTION_PROJECT_ID: process.env["APPWRITE_FUNCTION_PROJECT_ID"],
-      APPWRITE_FUNCTION_API_KEY: process.env["APPWRITE_FUNCTION_API_KEY"],
-    };
-
-    // Process request through Hono app
-    const honoResponse = await app.fetch(webRequest, env);
-
-    // Convert Hono response back to Appwrite response format
-    await convertWebResponseToAppwrite(honoResponse, res);
-
-    log(`Request completed with status ${honoResponse.status}`);
-
-  } catch (validationError) {
-    error(`Function execution failed: ${validationError}`);
-
-    // Return error response
-    return res.json({
-      error: "Function execution failed",
-      message: validationError instanceof Error ? validationError.message : String(validationError),
-      functionName: "{{functionName}}",
-      timestamp: new Date().toISOString(),
-    }, 500);
-  }
+import { app } from "./app.js";
+import { AppwriteContext, AppwriteContextSchema } from "./context.js";
+import { convertAppwriteToWebRequest } from "./adapters/request.js";
+import { convertWebResponseToAppwrite } from "./adapters/response.js";
+import { appwriteMiddleware } from "./middleware/appwrite.js";
+
+/**
+ * Main Appwrite function entry point
+ * This function receives the Appwrite context and routes it through Hono
+ */
+export default async function (context: AppwriteContext) {
+  const { req, res, log, error } = context;
+
+  try {
+    // Optional: Validate the context using Zod schema
+    AppwriteContextSchema.parse(context);
+    log("Context validation successful");
+
+    // Add Appwrite context middleware to the Hono app
+    app.use("*", appwriteMiddleware(context));
+
+    // Convert Appwrite request to Web API Request for Hono
+    const webRequest = convertAppwriteToWebRequest(req);
+
+    log(`Processing ${req.method} request to ${req.path || "/"}`);
+
+    // Create execution environment for Hono
+    const env = {
+      // Add any environment variables or context needed by Hono
+      APPWRITE_FUNCTION_ENDPOINT: process.env["APPWRITE_FUNCTION_ENDPOINT"],
+      APPWRITE_FUNCTION_PROJECT_ID: process.env["APPWRITE_FUNCTION_PROJECT_ID"],
+      APPWRITE_FUNCTION_API_KEY: process.env["APPWRITE_FUNCTION_API_KEY"],
+    };
+
+    // Process request through Hono app
+    const honoResponse = await app.fetch(webRequest, env);
+
+    // Convert Hono response back to Appwrite response format
+    await convertWebResponseToAppwrite(honoResponse, res);
+
+    log(`Request completed with status ${honoResponse.status}`);
+
+  } catch (validationError) {
+    error(`Function execution failed: ${validationError}`);
+
+    // Return error response
+    return res.json({
+      error: "Function execution failed",
+      message: validationError instanceof Error ? validationError.message : String(validationError),
+      functionName: "{{functionName}}",
+      timestamp: new Date().toISOString(),
+    }, 500);
+  }
 }