@gurulu/cli 0.4.6 → 0.4.7

package/dist/commands/chat.d.ts

@@ -14,5 +14,6 @@ export interface ChatArgs {
     showSql?: boolean;
     profile?: string;
     context?: string;
+    site?: string;
 }
 export declare function chatCommand(args: ChatArgs): Promise<void>;

package/dist/commands/chat.js

@@ -54,6 +54,7 @@ async function askQuestion(question, args) {
         json: {
             question,
             context: args.context,
+            ...(args.site ? { siteId: args.site } : {}),
         },
     });
 }

package/dist/commands/events.js

@@ -248,11 +248,33 @@ async function verifyCmd(args) {
         console.log(`Unique event types: ${data.unique_types ?? 'N/A'}`);
     }
     else {
-        // Empty: no telemetry yet for the requested filter / definition. Without
-        // this branch the report printed only its header — users couldn't tell
-        // success from "no data found".
+        // Phase 33 P33-WA — three-state empty output instead of one generic
+        // "no telemetry yet" message. Helps the user tell apart "definition
+        // exists but never matched" vs "definition missing entirely" vs "no
+        // events at all on this site". Definition lookup is best-effort
+        // (extra HTTP call) so a 4xx falls through to the legacy message.
         if (filterEvent) {
-            (0, ui_1.info)(`No telemetry yet for "${filterEvent}". Track it from your app and run verify again.`);
+            let definitionExists = null;
+            try {
+                const defs = await (0, api_client_1.cliApiJson)(`/api/cli/events/definitions?siteId=${encodeURIComponent(args.site)}`, { profile: args.profile });
+                definitionExists = Array.isArray(defs.definitions)
+                    && defs.definitions.some((d) => d.eventName === filterEvent);
+            }
+            catch {
+                // best-effort — fall through to legacy message
+            }
+            if (definitionExists === true) {
+                (0, ui_1.info)(`✓ "${filterEvent}" is registered (catalog has it) but no telemetry has matched in the last 24h.`);
+                (0, ui_1.info)(`  Likely cause: SDK hasn't fired this event yet. Check your client code and run verify again.`);
+            }
+            else if (definitionExists === false) {
+                (0, ui_1.info)(`⚠ "${filterEvent}" is NOT registered yet (no CustomEventDefinition row).`);
+                (0, ui_1.info)(`  Phase 32 auto-registers on first sight, but you can also run:`);
+                (0, ui_1.info)(`  gurulu events define --site ${args.site} --event-name ${filterEvent} --display-name "..."`);
+            }
+            else {
+                (0, ui_1.info)(`No telemetry yet for "${filterEvent}". Track it from your app and run verify again.`);
+            }
         }
         else {
             (0, ui_1.info)('No telemetry data found for this site in the last 24h.');

package/dist/commands/insights.js

@@ -20,6 +20,18 @@ async function insightsCommand(args) {
             process.exit(1);
     }
 }
+function formatHighlight(h) {
+    if (typeof h === 'string')
+        return h;
+    if (h && typeof h === 'object') {
+        const o = h;
+        const arrow = o.trend === 'up' ? '↑' : o.trend === 'down' ? '↓' : '→';
+        const value = typeof o.value === 'number' ? o.value.toLocaleString() : String(o.value ?? '');
+        const delta = typeof o.delta === 'number' ? ` (${o.delta >= 0 ? '+' : ''}${o.delta.toFixed(1)}% ${arrow})` : '';
+        return `${o.label ?? 'metric'}: ${value}${delta}`;
+    }
+    return String(h);
+}
 async function todayCmd(args) {
     try {
         const body = await (0, api_client_1.cliApiJson)('/api/cli/insights', {
@@ -35,7 +47,7 @@ async function todayCmd(args) {
         if (Array.isArray(i.highlights)) {
             process.stdout.write(`Highlights:\n`);
             for (const h of i.highlights)
-                process.stdout.write(`  - ${h}\n`);
+                process.stdout.write(`  - ${formatHighlight(h)}\n`);
         }
     }
     catch (err) {

package/dist/commands/setup.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 2026-05-05 DF-5 — `gurulu setup --vertical saas` zero-friction lifecycle.
+ *
+ * Tek komutta:
+ *   - vertical event taxonomy'sini define et (idempotent)
+ *   - default funnel'ları kur
+ *   - acquisition + revenue + retention event'lerine goal bağla
+ *
+ * 23 ayrı komut yerine 1.
+ */
+export interface SetupArgs {
+    vertical?: string;
+    site?: string;
+    includeFunnels?: boolean;
+    includeGoals?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+    yes?: boolean;
+    profile?: string;
+}
+export declare function setupCommand(args: SetupArgs): Promise<void>;

package/dist/commands/setup.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * 2026-05-05 DF-5 — `gurulu setup --vertical saas` zero-friction lifecycle.
+ *
+ * Tek komutta:
+ *   - vertical event taxonomy'sini define et (idempotent)
+ *   - default funnel'ları kur
+ *   - acquisition + revenue + retention event'lerine goal bağla
+ *
+ * 23 ayrı komut yerine 1.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupCommand = setupCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+async function setupCommand(args) {
+    const vertical = (args.vertical || '').toLowerCase().trim();
+    if (!vertical) {
+        (0, ui_1.error)('--vertical required (e.g. saas, ecommerce, marketplace, fintech, healthcare, education, media, igaming, generic)');
+        process.exitCode = 1;
+        return;
+    }
+    if (!args.site) {
+        (0, ui_1.error)('--site required');
+        process.exitCode = 1;
+        return;
+    }
+    const path = '/api/cli/setup/apply-template' + (args.dryRun ? '?dry_run=1' : '');
+    const body = {
+        siteId: args.site,
+        vertical,
+        includeFunnels: args.includeFunnels !== false,
+        includeGoals: args.includeGoals !== false,
+    };
+    try {
+        const res = await (0, api_client_1.cliApiJson)(path, {
+            profile: args.profile,
+            method: 'POST',
+            json: body,
+        });
+        if (args.json) {
+            process.stdout.write(JSON.stringify(res, null, 2) + '\n');
+            return;
+        }
+        if ('dryRun' in res && res.dryRun) {
+            const a = res.after;
+            (0, ui_1.info)(`Dry-run preview — ${a.vertical} lifecycle taxonomy:`);
+            process.stdout.write(`\n  Events  (${a.events.length}): ${a.events.join(', ')}\n`);
+            process.stdout.write(`  Funnels (${a.funnels.length}): ${a.funnels.join(', ')}\n`);
+            process.stdout.write(`  Goals   (${a.goals.length}): ${a.goals.join(', ')}\n\n`);
+            (0, ui_1.info)('Re-run without --dry-run to apply.');
+            return;
+        }
+        const r = res;
+        (0, ui_1.success)(`Applied ${r.vertical} lifecycle taxonomy to site ${args.site}`);
+        process.stdout.write(`  Events:  ${r.events.created.length} created, ${r.events.skipped.length} skipped\n`);
+        process.stdout.write(`  Funnels: ${r.funnels.created.length} created, ${r.funnels.skipped.length} skipped\n`);
+        process.stdout.write(`  Goals:   ${r.goals.created.length} created, ${r.goals.skipped.length} skipped\n`);
+        if (r.events.created.length) {
+            process.stdout.write(`\n  New events: ${r.events.created.join(', ')}\n`);
+        }
+    }
+    catch (err) {
+        (0, ui_1.error)(`Setup failed: ${err?.message ?? String(err)}`);
+        process.exitCode = 1;
+    }
+}

package/dist/frameworks/detect.js

@@ -232,26 +232,33 @@ export function initGurulu() {
         case 'express':
             return {
                 file: 'src/gurulu.ts',
-                code: `// Gurulu.io Server Analytics
+                code: `// Gurulu.io Server Analytics — Phase 32 P32-A2 fix
+// Use the @gurulu/node SDK so retry, identity propagation, and the
+// correct ingest endpoint (/api/ingest/v1/server) are handled for you.
+//   npm install @gurulu/node
+import { Gurulu } from '@gurulu/node';
 import type { Request, Response, NextFunction } from 'express';
 
-const SITE_ID = '${siteId}';
-const TOKEN = '${token}';
+export const gurulu = new Gurulu({
+  siteId: '${siteId}',
+  token: '${token}',
+  endpoint: 'https://gurulu.io',
+});
 
 export function guruluMiddleware(req: Request, res: Response, next: NextFunction) {
-  // Track server-side pageview
-  fetch('https://ingest.gurulu.io/api/events', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + TOKEN },
-    body: JSON.stringify({
-      site_id: SITE_ID,
-      event: 'pageview',
+  // Identity propagation: read the anonymous_id the browser SDK set in a
+  // cookie / header so server-side events stitch onto the same user.
+  const anonymousId = (req.headers['x-gurulu-anonymous-id'] as string)
+    || (req.cookies?._gurulu_id as string)
+    || undefined;
+  gurulu.track({
+    eventName: 'pageview',
+    anonymousId,
+    properties: {
       url: req.originalUrl,
       referrer: req.headers.referer || '',
       user_agent: req.headers['user-agent'] || '',
-      ip: req.ip,
-      timestamp: new Date().toISOString(),
-    }),
+    },
   }).catch(() => {});
   next();
 }`,
@@ -260,26 +267,28 @@ export function guruluMiddleware(req: Request, res: Response, next: NextFunction
         case 'fastify':
             return {
                 file: 'src/gurulu.ts',
-                code: `// Gurulu.io Server Analytics — Fastify plugin
+                code: `// Gurulu.io Server Analytics — Fastify plugin (Phase 32 P32-A2 fix)
+//   npm install @gurulu/node
+import { Gurulu } from '@gurulu/node';
 import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
 
-const SITE_ID = '${siteId}';
-const TOKEN = '${token}';
+export const gurulu = new Gurulu({
+  siteId: '${siteId}',
+  token: '${token}',
+  endpoint: 'https://gurulu.io',
+});
 
 export async function guruluPlugin(fastify: FastifyInstance) {
   fastify.addHook('onRequest', async (req: FastifyRequest, _reply: FastifyReply) => {
-    fetch('https://ingest.gurulu.io/api/events', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + TOKEN },
-      body: JSON.stringify({
-        site_id: SITE_ID,
-        event: 'pageview',
+    const anonymousId = (req.headers['x-gurulu-anonymous-id'] as string) || undefined;
+    gurulu.track({
+      eventName: 'pageview',
+      anonymousId,
+      properties: {
         url: req.url,
         referrer: (req.headers.referer as string) || '',
         user_agent: (req.headers['user-agent'] as string) || '',
-        ip: req.ip,
-        timestamp: new Date().toISOString(),
-      }),
+      },
     }).catch(() => {});
   });
 }`,
@@ -288,24 +297,27 @@ export async function guruluPlugin(fastify: FastifyInstance) {
         case 'hono':
             return {
                 file: 'src/gurulu.ts',
-                code: `// Gurulu.io Server Analytics — Hono middleware
+                code: `// Gurulu.io Server Analytics — Hono middleware (Phase 32 P32-A2 fix)
+//   npm install @gurulu/node
+import { Gurulu } from '@gurulu/node';
 import type { MiddlewareHandler } from 'hono';
 
-const SITE_ID = '${siteId}';
-const TOKEN = '${token}';
+export const gurulu = new Gurulu({
+  siteId: '${siteId}',
+  token: '${token}',
+  endpoint: 'https://gurulu.io',
+});
 
 export const guruluMiddleware: MiddlewareHandler = async (c, next) => {
-  fetch('https://ingest.gurulu.io/api/events', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + TOKEN },
-    body: JSON.stringify({
-      site_id: SITE_ID,
-      event: 'pageview',
+  const anonymousId = c.req.header('x-gurulu-anonymous-id') || undefined;
+  gurulu.track({
+    eventName: 'pageview',
+    anonymousId,
+    properties: {
       url: c.req.url,
       referrer: c.req.header('referer') || '',
       user_agent: c.req.header('user-agent') || '',
-      timestamp: new Date().toISOString(),
-    }),
+    },
   }).catch(() => {});
   await next();
 };`,
@@ -314,28 +326,30 @@ export const guruluMiddleware: MiddlewareHandler = async (c, next) => {
         case 'nestjs':
             return {
                 file: 'src/gurulu.middleware.ts',
-                code: `// Gurulu.io Server Analytics Middleware
+                code: `// Gurulu.io Server Analytics Middleware (Phase 32 P32-A2 fix)
+//   npm install @gurulu/node
 import { Injectable, NestMiddleware } from '@nestjs/common';
 import { Request, Response, NextFunction } from 'express';
+import { Gurulu } from '@gurulu/node';
 
-const SITE_ID = '${siteId}';
-const TOKEN = '${token}';
+const gurulu = new Gurulu({
+  siteId: '${siteId}',
+  token: '${token}',
+  endpoint: 'https://gurulu.io',
+});
 
 @Injectable()
 export class GuruluMiddleware implements NestMiddleware {
   use(req: Request, res: Response, next: NextFunction) {
-    fetch('https://ingest.gurulu.io/api/events', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + TOKEN },
-      body: JSON.stringify({
-        site_id: SITE_ID,
-        event: 'pageview',
+    const anonymousId = (req.headers['x-gurulu-anonymous-id'] as string) || undefined;
+    gurulu.track({
+      eventName: 'pageview',
+      anonymousId,
+      properties: {
         url: req.originalUrl,
         referrer: req.headers.referer || '',
         user_agent: req.headers['user-agent'] || '',
-        ip: req.ip,
-        timestamp: new Date().toISOString(),
-      }),
+      },
     }).catch(() => {});
     next();
   }

package/dist/index.js

@@ -38,6 +38,8 @@ const funnels_1 = require("./commands/funnels");
 const heatmap_1 = require("./commands/heatmap");
 // Gurulu Chat — NL → SQL analytics
 const chat_1 = require("./commands/chat");
+// 2026-05-05 DF-5 — zero-friction lifecycle setup
+const setup_1 = require("./commands/setup");
 // Error tracking — source map upload
 const sourcemap_1 = require("./commands/sourcemap");
 // Phase 21 — database connect
@@ -619,18 +621,39 @@ const secrets_1 = require("./commands/secrets");
     format: args.format,
     json: args.json,
     profile: args.profile,
+}))
+    // ── 2026-05-05 DF-5 — zero-friction lifecycle setup ──────────────────
+    .command('setup', 'Apply a vertical lifecycle taxonomy (events + funnels + goals) in one shot', (y) => y
+    .option('vertical', {
+    type: 'string',
+    describe: 'saas | ecommerce | marketplace | fintech | healthcare | education | media | igaming | generic',
+})
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('include-funnels', { type: 'boolean', default: true, describe: 'Also create funnels' })
+    .option('include-goals', { type: 'boolean', default: true, describe: 'Also create goals' })
+    .option('dry-run', { type: 'boolean', describe: 'Preview without writing' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, setup_1.setupCommand)({
+    vertical: args.vertical,
+    site: args.site,
+    includeFunnels: args['include-funnels'],
+    includeGoals: args['include-goals'],
+    dryRun: args['dry-run'],
+    json: args.json,
+    profile: args.profile,
 }))
     // ── Gurulu Chat — NL → SQL analytics ─────────────────────────────────
     .command('chat [question]', 'Ask analytics questions in natural language (NL → SQL)', (y) => y
     .positional('question', { type: 'string', describe: 'Question to ask (omit for REPL mode)' })
     .option('json', { type: 'boolean', describe: 'Machine-readable JSON output' })
     .option('show-sql', { type: 'boolean', describe: 'Also print the generated SQL' })
-    .option('context', { type: 'string', describe: 'Additional context for the query' }), (args) => (0, chat_1.chatCommand)({
+    .option('context', { type: 'string', describe: 'Additional context for the query' })
+    .option('site', { type: 'string', describe: 'Site ID (overrides profile default)' }), (args) => (0, chat_1.chatCommand)({
     question: args.question,
     json: args.json,
     showSql: args['show-sql'],
     context: args.context,
     profile: args.profile,
+    site: args.site,
 }))
     // ── Error tracking — source map upload ────────────────────────────────
     .command('sourcemap <action>', 'Upload source maps for error deobfuscation (upload). Supports web/server JS .map and native dSYM/ProGuard.', (y) => y

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurulu/cli",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "Gurulu.io CLI — setup analytics in seconds",
   "bin": {
     "gurulu": "bin/gurulu.js"