@oneclick.dev/cms-core-modules 0.0.70 → 0.0.72

package/src/googleAnalytics/tools.ts

@@ -0,0 +1,158 @@
+export const tools = [
+  {
+    name: "getTopPages",
+    description: 'Show a card in chat with the most popular/visited pages on the website for a given period.',
+    executionMode: 'component',
+    chatComponent: 'TopPagesCard',
+    parameters: {
+      type: "object",
+      properties: {
+        startDate: {
+          type: "string",
+          description: "Start date for the report. Use relative formats like 'yesterday', '7daysAgo', '30daysAgo', '90daysAgo', '365daysAgo' or exact dates 'YYYY-MM-DD'. Default: '30daysAgo'"
+        },
+        endDate: {
+          type: "string",
+          description: "End date for the report. Use 'today', 'yesterday', or exact dates 'YYYY-MM-DD'. Default: 'today'"
+        },
+        limit: {
+          type: "number",
+          description: "Number of pages to show. Default: 10, max: 50",
+          default: 10
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "getVisitorStats",
+    description: 'Show a card in chat with visitor/traffic statistics (sessions, users, page views, bounce rate, etc.) for a given period. Use this when the user asks about traffic, visitors, how many people visited, etc.',
+    executionMode: 'component',
+    chatComponent: 'VisitorStatsCard',
+    parameters: {
+      type: "object",
+      properties: {
+        startDate: {
+          type: "string",
+          description: "Start date for the report. Use 'yesterday' for yesterday, '7daysAgo' for last week, '30daysAgo' for last month, '90daysAgo' for last quarter, '365daysAgo' for last year, or exact 'YYYY-MM-DD'. Default: '30daysAgo'"
+        },
+        endDate: {
+          type: "string",
+          description: "End date for the report. Use 'today', 'yesterday', or exact 'YYYY-MM-DD'. Default: 'today'"
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "getSearchTerms",
+    description: 'Show a card in chat with search terms/keywords that bring visitors to the website. Use this when the user asks about keywords, SEO terms, what people search for, or search queries.',
+    executionMode: 'component',
+    chatComponent: 'SearchTermsCard',
+    parameters: {
+      type: "object",
+      properties: {
+        startDate: {
+          type: "string",
+          description: "Start date for the report. Default: '30daysAgo'"
+        },
+        endDate: {
+          type: "string",
+          description: "End date for the report. Default: 'today'"
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "getTrafficSources",
+    description: 'Show a card in chat with where website visitors are coming from (traffic sources, channels, referrals). Use this when the user asks about traffic sources, where visitors come from, referrals, channels, etc.',
+    executionMode: 'component',
+    chatComponent: 'TrafficSourcesCard',
+    parameters: {
+      type: "object",
+      properties: {
+        startDate: {
+          type: "string",
+          description: "Start date for the report. Default: '30daysAgo'"
+        },
+        endDate: {
+          type: "string",
+          description: "End date for the report. Default: 'today'"
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "getRealtimeVisitors",
+    description: 'Show a card in chat with the current real-time active visitors on the website right now.',
+    executionMode: 'component',
+    chatComponent: 'RealtimeCard',
+    parameters: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  {
+    name: "getCountryBreakdown",
+    description: 'Show a card in chat with a geographic breakdown of where website visitors are located. Use this when the user asks about visitor countries, geographic distribution, or where their audience is from.',
+    executionMode: 'component',
+    chatComponent: 'CountryBreakdownCard',
+    parameters: {
+      type: "object",
+      properties: {
+        startDate: {
+          type: "string",
+          description: "Start date for the report. Default: '30daysAgo'"
+        },
+        endDate: {
+          type: "string",
+          description: "End date for the report. Default: 'today'"
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "getDeviceBreakdown",
+    description: 'Show a card in chat with a device breakdown (desktop, mobile, tablet) of website visitors. Use this when the user asks about what devices people use, mobile vs desktop traffic, or if their site is mobile-friendly.',
+    executionMode: 'component',
+    chatComponent: 'DeviceBreakdownCard',
+    parameters: {
+      type: "object",
+      properties: {
+        startDate: {
+          type: "string",
+          description: "Start date for the report. Default: '30daysAgo'"
+        },
+        endDate: {
+          type: "string",
+          description: "End date for the report. Default: 'today'"
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "getPeakHours",
+    description: 'Show a card in chat with peak traffic hours and a weekly heatmap showing when visitors are most active. Use this when the user asks about best times to post, peak hours, busiest times, or when their audience is online.',
+    executionMode: 'component',
+    chatComponent: 'PeakHoursCard',
+    parameters: {
+      type: "object",
+      properties: {
+        startDate: {
+          type: "string",
+          description: "Start date for the report. Default: '30daysAgo'"
+        },
+        endDate: {
+          type: "string",
+          description: "End date for the report. Default: 'today'"
+        }
+      },
+      required: []
+    }
+  },
+]

package/src/mailTemplates/tools.ts

@@ -0,0 +1 @@
+export const tools = []

package/src/productCollections/tools.ts

@@ -0,0 +1 @@
+export const tools = []

package/src/products/server.ts

@@ -0,0 +1,146 @@
+import { createRouter, defineEventHandler, createError, getRouterParam, getQuery } from 'h3'
+
+/**
+ * Dependencies injected by the CMS when creating this handler.
+ * Modules never import CMS internals directly — they receive them here.
+ */
+export interface ModuleHandlerDeps {
+  /** Initialize a Firebase Admin app for a project-level integration */
+  initFirebase: (event: any, integrationId: string) => Promise<any>
+  /** Normalize Firestore Timestamp fields to plain dates */
+  normalizeTimestamps: (data: any) => any
+}
+
+/**
+ * Products module server handler factory.
+ *
+ * Routes (relative to `/api/v1/modules/:instanceId/`):
+ *   GET /products              → list all products
+ *   GET /products/:productId   → get single product
+ *   GET /empty-stock           → get products with 0 stock (API-mode tool)
+ */
+export function createServerHandler(deps: ModuleHandlerDeps) {
+  const { initFirebase, normalizeTimestamps } = deps
+  const router = createRouter()
+
+  /**
+   * Resolve the Firebase app + collection name from the module instance config.
+   */
+  async function getFirebaseContext(event: any) {
+    const { supabase, instanceId } = event.context.module
+
+    const { data: moduleRow, error } = await supabase
+      .from('project_modules')
+      .select('config')
+      .eq('id', instanceId)
+      .single()
+
+    if (error || !moduleRow?.config) {
+      throw createError({ statusCode: 500, statusMessage: 'Failed to load module config.' })
+    }
+
+    const config = moduleRow.config as Record<string, any>
+    const integrationId = config.project as string
+    const collection = (config.productCollection as string) || 'products'
+
+    if (!integrationId) {
+      throw createError({ statusCode: 400, statusMessage: 'Products module has no Firebase integration configured.' })
+    }
+
+    const firebase = await initFirebase(event, integrationId)
+    return { firebase, collection }
+  }
+
+  // ── GET /products ──────────────────────────────────
+  router.get('/products', defineEventHandler(async (event) => {
+    try {
+      const { firebase, collection } = await getFirebaseContext(event)
+      const snapshot = await firebase.firestore().collection(collection).get()
+
+      return snapshot.docs.map((doc: any) => normalizeTimestamps({
+        id: doc.id,
+        ...doc.data(),
+      }))
+    } catch (err: any) {
+      console.error('Products handler — list error:', err)
+      throw createError({
+        statusCode: err.statusCode || 500,
+        statusMessage: err.statusMessage || 'Failed to list products',
+      })
+    }
+  }))
+
+  // ── GET /products/:productId ───────────────────────
+  router.get('/products/:productId', defineEventHandler(async (event) => {
+    const productId = getRouterParam(event, 'productId')
+    if (!productId) {
+      throw createError({ statusCode: 400, statusMessage: 'Product ID is required.' })
+    }
+
+    try {
+      const { firebase, collection } = await getFirebaseContext(event)
+      const snapshot = await firebase.firestore().collection(collection).doc(productId).get()
+
+      if (!snapshot.exists) {
+        throw createError({ statusCode: 404, statusMessage: 'Product not found.' })
+      }
+
+      return normalizeTimestamps({
+        id: snapshot.id,
+        ...snapshot.data(),
+      })
+    } catch (err: any) {
+      console.error('Products handler — get error:', err)
+      throw createError({
+        statusCode: err.statusCode || 500,
+        statusMessage: err.statusMessage || 'Failed to get product',
+      })
+    }
+  }))
+
+  // ── GET /empty-stock?category=... ──────────────────
+  router.get('/empty-stock', defineEventHandler(async (event) => {
+    const query = getQuery(event)
+    const category = query.category as string | undefined
+
+    try {
+      const { firebase, collection } = await getFirebaseContext(event)
+      let fbQuery: FirebaseFirestore.Query = firebase.firestore().collection(collection)
+        .where('stock', '==', 0)
+
+      if (category) {
+        fbQuery = fbQuery.where('collections', 'array-contains', category)
+      }
+
+      const snapshot = await fbQuery.get()
+      const products = snapshot.docs.map((doc: any) => normalizeTimestamps({
+        id: doc.id,
+        ...doc.data(),
+      }))
+
+      return {
+        count: products.length,
+        products: products.map((p: any) => ({
+          id: p.id,
+          title: p.title,
+          slug: p.slug,
+          stock: p.stock,
+          price: p.price,
+          currency: p.currency,
+          status: p.status,
+        })),
+      }
+    } catch (err: any) {
+      console.error('Products handler — empty-stock error:', err)
+      throw createError({
+        statusCode: err.statusCode || 500,
+        statusMessage: err.statusMessage || 'Failed to query empty stock',
+      })
+    }
+  }))
+
+  // ── POST /products/:productId/change-status ──────────────────
+  
+
+  return router.handler
+}

package/src/products/tools.ts

@@ -2,6 +2,7 @@ export const tools = [
   {
     name: "getEmptyStock",
     description: "Get a list of products with empty stock.",
+    executionMode: "api",
     parameters: {
       type: "object",
       properties: {
@@ -14,5 +15,23 @@ export const tools = [
         "category"
       ]
     }
+  },
+  {
+    name: "viewProductDetails",
+    description: 'Show a card in chat with details of a product based on product ID.',
+    executionMode: 'component',
+    chatComponent: 'ProductDetailsCard',
+    parameters: {
+      type: "object",
+      properties: {
+        productId: {
+          type: "string",
+          description: "ID of the product"
+        },
+      },
+      required: [
+        "productId"
+      ]
+    }
   }
 ]

package/src/promoCodes/tools.ts

@@ -0,0 +1 @@
+export const tools = []

package/src/table/tools.ts

@@ -1,25 +1 @@
-export const tools = {
-  getData: {
-    description: 'Gets the current table data',
-    params: {
-      size: {
-        type: 'number',
-        default: 10
-      }
-    },
-    returns: {
-      type: 'array'
-    }
-  },
-  filterTable: {
-    description: 'Filters the current table data',
-    params: {
-      filter: {
-        type: 'string'
-      }
-    },
-    returns: {
-      type: 'array'
-    }
-  }
-}
+export const tools = []