@gurulu/cli 0.4.7 → 1.0.0

package/dist/frameworks/detect.js

@@ -1,458 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectFramework = detectFramework;
-exports.getSetupSnippet = getSetupSnippet;
-exports.getFrameworkDisplayName = getFrameworkDisplayName;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-function detectFramework(projectDir) {
-    const pkgPath = path_1.default.join(projectDir, 'package.json');
-    const hasPkgJson = fs_1.default.existsSync(pkgPath);
-    // Read package.json early so we can dedupe iOS-vs-React-Native (RN repos
-    // commonly host an `ios/MyApp.xcodeproj` and a top-level Package.swift in
-    // monorepos — without the RN check first we'd return `ios-swift` and ship
-    // the wrong SDK snippet).
-    let deps = {};
-    if (hasPkgJson) {
-        try {
-            const pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
-            deps = { ...pkg.dependencies, ...pkg.devDependencies };
-        }
-        catch {
-            /* malformed package.json — fall through to filesystem detection */
-        }
-        if (deps['react-native'])
-            return 'react-native';
-    }
-    // Mobile framework detection (non-package.json based)
-    if (fs_1.default.existsSync(path_1.default.join(projectDir, 'pubspec.yaml')))
-        return 'flutter';
-    const hasSwiftPkg = fs_1.default.existsSync(path_1.default.join(projectDir, 'Package.swift'));
-    let hasXcodeProj = false;
-    try {
-        hasXcodeProj = fs_1.default
-            .readdirSync(projectDir)
-            .some((f) => f.endsWith('.xcodeproj') || f.endsWith('.xcworkspace'));
-    }
-    catch {
-        /* unreadable dir — treat as no Xcode project */
-    }
-    if (hasSwiftPkg || hasXcodeProj)
-        return 'ios-swift';
-    if (!hasPkgJson) {
-        // Android detection (no package.json means no RN false positive)
-        if (fs_1.default.existsSync(path_1.default.join(projectDir, 'build.gradle.kts')) ||
-            fs_1.default.existsSync(path_1.default.join(projectDir, 'build.gradle')) ||
-            fs_1.default.existsSync(path_1.default.join(projectDir, 'app', 'build.gradle')) ||
-            fs_1.default.existsSync(path_1.default.join(projectDir, 'app', 'build.gradle.kts'))) {
-            return 'android-kotlin';
-        }
-        return 'html';
-    }
-    if (deps['next']) {
-        // Check for app router
-        if (fs_1.default.existsSync(path_1.default.join(projectDir, 'src', 'app')) || fs_1.default.existsSync(path_1.default.join(projectDir, 'app'))) {
-            return 'nextjs-app';
-        }
-        return 'nextjs-pages';
-    }
-    if (deps['@nestjs/core'])
-        return 'nestjs';
-    if (deps['nuxt'])
-        return 'nuxt3';
-    if (deps['@sveltejs/kit'])
-        return 'sveltekit';
-    if (deps['svelte'])
-        return 'svelte';
-    if (deps['astro'])
-        return 'astro';
-    if (deps['vue'])
-        return 'vue3';
-    if (deps['@vitejs/plugin-react'])
-        return 'react-vite';
-    if (deps['react-scripts'])
-        return 'react-cra';
-    if (deps['fastify'])
-        return 'fastify';
-    if (deps['hono'])
-        return 'hono';
-    if (deps['express'])
-        return 'express';
-    return 'unknown';
-}
-function getSetupSnippet(framework, siteId, token) {
-    switch (framework) {
-        case 'nextjs-app':
-            return {
-                file: 'src/lib/gurulu.tsx',
-                code: `'use client';
-import { useEffect } from 'react';
-import { usePathname, useSearchParams } from 'next/navigation';
-
-export function GuruluProvider() {
-  const pathname = usePathname();
-  const searchParams = useSearchParams();
-
-  useEffect(() => {
-    const script = document.createElement('script');
-    script.src = 'https://cdn.gurulu.io/t.js';
-    script.async = true;
-    script.dataset.siteId = '${siteId}';
-    script.dataset.token = '${token}';
-    document.head.appendChild(script);
-    return () => { document.head.removeChild(script); };
-  }, []);
-
-  useEffect(() => {
-    if (typeof window !== 'undefined' && (window as any).gurulu) {
-      (window as any).gurulu.track('pageview', {
-        page_url: pathname + (searchParams?.toString() ? '?' + searchParams.toString() : ''),
-      });
-    }
-  }, [pathname, searchParams]);
-
-  return null;
-}`,
-                instruction: 'Add <GuruluProvider /> inside <body> in your root layout.tsx',
-            };
-        case 'nextjs-pages':
-            return {
-                file: 'src/lib/gurulu.tsx',
-                code: `import Script from 'next/script';
-
-export function GuruluScript() {
-  return (
-    <Script
-      src="https://cdn.gurulu.io/t.js"
-      data-site-id="${siteId}"
-      data-token="${token}"
-      strategy="afterInteractive"
-    />
-  );
-}`,
-                instruction: 'Add <GuruluScript /> in your _app.tsx',
-            };
-        case 'react-vite':
-        case 'react-cra':
-            return {
-                file: 'src/gurulu.ts',
-                code: `// Gurulu.io Analytics
-export function initGurulu() {
-  if (typeof document === 'undefined') return;
-  const script = document.createElement('script');
-  script.src = 'https://cdn.gurulu.io/t.js';
-  script.async = true;
-  script.dataset.siteId = '${siteId}';
-  script.dataset.token = '${token}';
-  document.head.appendChild(script);
-}`,
-                instruction: 'Call initGurulu() in your main.tsx or index.tsx entry point',
-            };
-        case 'vue3':
-            return {
-                file: 'src/plugins/gurulu.ts',
-                code: `// Gurulu.io Analytics Plugin
-import type { App } from 'vue';
-
-export const guruluPlugin = {
-  install(app: App) {
-    if (typeof document === 'undefined') return;
-    const script = document.createElement('script');
-    script.src = 'https://cdn.gurulu.io/t.js';
-    script.async = true;
-    script.dataset.siteId = '${siteId}';
-    script.dataset.token = '${token}';
-    document.head.appendChild(script);
-  },
-};`,
-                instruction: 'Add app.use(guruluPlugin) in your main.ts',
-            };
-        case 'nuxt3':
-            return {
-                file: 'plugins/gurulu.client.ts',
-                code: `// Gurulu.io Analytics Plugin
-export default defineNuxtPlugin(() => {
-  if (typeof document === 'undefined') return;
-  const script = document.createElement('script');
-  script.src = 'https://cdn.gurulu.io/t.js';
-  script.async = true;
-  script.dataset.siteId = '${siteId}';
-  script.dataset.token = '${token}';
-  document.head.appendChild(script);
-});`,
-                instruction: 'Plugin auto-registered via plugins/ directory',
-            };
-        case 'svelte':
-            return {
-                file: 'src/lib/gurulu.ts',
-                code: `// Gurulu.io Analytics
-import { onMount } from 'svelte';
-
-export function initGurulu() {
-  onMount(() => {
-    const script = document.createElement('script');
-    script.src = 'https://cdn.gurulu.io/t.js';
-    script.async = true;
-    script.dataset.siteId = '${siteId}';
-    script.dataset.token = '${token}';
-    document.head.appendChild(script);
-  });
-}`,
-                instruction: 'Call initGurulu() in your root +layout.svelte or App.svelte',
-            };
-        case 'sveltekit':
-            return {
-                file: 'src/lib/gurulu.ts',
-                code: `// Gurulu.io Analytics
-import { browser } from '$app/environment';
-
-export function initGurulu() {
-  if (!browser) return;
-  const script = document.createElement('script');
-  script.src = 'https://cdn.gurulu.io/t.js';
-  script.async = true;
-  script.dataset.siteId = '${siteId}';
-  script.dataset.token = '${token}';
-  document.head.appendChild(script);
-}`,
-                instruction: 'Call initGurulu() in your root +layout.svelte onMount',
-            };
-        case 'astro':
-            return {
-                file: 'src/components/Gurulu.astro',
-                code: `---
-// Gurulu.io Analytics
----
-<script src="https://cdn.gurulu.io/t.js" data-site-id="${siteId}" data-token="${token}" async></script>`,
-                instruction: 'Add <Gurulu /> in your Layout.astro <head>',
-            };
-        case 'express':
-            return {
-                file: 'src/gurulu.ts',
-                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';
-
-export const gurulu = new Gurulu({
-  siteId: '${siteId}',
-  token: '${token}',
-  endpoint: 'https://gurulu.io',
-});
-
-export function guruluMiddleware(req: Request, res: Response, next: NextFunction) {
-  // 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'] || '',
-    },
-  }).catch(() => {});
-  next();
-}`,
-                instruction: 'Add app.use(guruluMiddleware) in your Express app',
-            };
-        case 'fastify':
-            return {
-                file: 'src/gurulu.ts',
-                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';
-
-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) => {
-    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) || '',
-      },
-    }).catch(() => {});
-  });
-}`,
-                instruction: 'Register with fastify.register(guruluPlugin) in your Fastify app',
-            };
-        case 'hono':
-            return {
-                file: 'src/gurulu.ts',
-                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';
-
-export const gurulu = new Gurulu({
-  siteId: '${siteId}',
-  token: '${token}',
-  endpoint: 'https://gurulu.io',
-});
-
-export const guruluMiddleware: MiddlewareHandler = async (c, next) => {
-  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') || '',
-    },
-  }).catch(() => {});
-  await next();
-};`,
-                instruction: 'Add app.use(guruluMiddleware) in your Hono app',
-            };
-        case 'nestjs':
-            return {
-                file: 'src/gurulu.middleware.ts',
-                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 gurulu = new Gurulu({
-  siteId: '${siteId}',
-  token: '${token}',
-  endpoint: 'https://gurulu.io',
-});
-
-@Injectable()
-export class GuruluMiddleware implements NestMiddleware {
-  use(req: Request, res: Response, next: NextFunction) {
-    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'] || '',
-      },
-    }).catch(() => {});
-    next();
-  }
-}`,
-                instruction: 'Apply GuruluMiddleware in your AppModule configure()',
-            };
-        case 'react-native':
-            return {
-                file: '',
-                code: `// npm install @gurulu/react-native
-import Gurulu from '@gurulu/react-native';
-
-Gurulu.initialize({
-  siteId: '${siteId}',
-  token: '${token}',
-  endpoint: 'https://ingest.gurulu.io/api/ingest/v1/collect',
-});`,
-                instruction: 'Run "npm install @gurulu/react-native" and add initialization to your App entry point',
-            };
-        case 'ios-swift':
-            return {
-                file: '',
-                code: `// Package.swift: add .package(url: "https://github.com/Preatan/gurulu-ios-sdk", from: "0.1.0")
-// AppDelegate.swift or @main App:
-import GuruluSDK
-
-GuruluSDK.shared.initialize(config: GuruluConfig(
-    siteId: "${siteId}",
-    token: "${token}",
-    endpoint: URL(string: "https://ingest.gurulu.io/api/ingest/v1/collect")!
-))`,
-                instruction: 'Add the SPM dependency and initialize in your AppDelegate or @main App struct',
-            };
-        case 'android-kotlin':
-            return {
-                file: '',
-                code: `// build.gradle.kts: implementation("com.github.Preatan:gurulu.io:android-sdk-0.1.0")
-// repositories: maven { url = uri("https://jitpack.io") }
-// Application.onCreate():
-import io.gurulu.sdk.GuruluSdk
-import io.gurulu.sdk.GuruluConfig
-
-GuruluSdk.initialize(GuruluConfig(
-    siteId = "${siteId}",
-    token = "${token}",
-    endpoint = "https://ingest.gurulu.io/api/ingest/v1/collect"
-))`,
-                instruction: 'Add JitPack repository and dependency, then initialize in your Application.onCreate()',
-            };
-        case 'flutter':
-            return {
-                file: '',
-                code: `// pubspec.yaml: gurulu_flutter: ^0.1.0
-import 'package:gurulu_flutter/gurulu_flutter.dart';
-
-await GuruluFlutter.initialize(config: {
-  'siteId': '${siteId}',
-  'token': '${token}',
-  'endpoint': 'https://ingest.gurulu.io/api/ingest/v1/collect',
-});`,
-                instruction: 'Add gurulu_flutter to pubspec.yaml and initialize in your main() function',
-            };
-        case 'html':
-            return {
-                file: '',
-                code: `<script src="https://cdn.gurulu.io/t.js" data-site-id="${siteId}" data-token="${token}" async></script>`,
-                instruction: 'Add this script tag before </head> in your HTML',
-            };
-        default:
-            return {
-                file: 'src/gurulu.ts',
-                code: `// Gurulu.io Analytics
-const script = document.createElement('script');
-script.src = 'https://cdn.gurulu.io/t.js';
-script.async = true;
-script.dataset.siteId = '${siteId}';
-script.dataset.token = '${token}';
-document.head.appendChild(script);`,
-                instruction: 'Import this file in your app entry point',
-            };
-    }
-}
-function getFrameworkDisplayName(fw) {
-    const names = {
-        'nextjs-app': 'Next.js (App Router)',
-        'nextjs-pages': 'Next.js (Pages Router)',
-        'react-vite': 'React (Vite)',
-        'react-cra': 'React (CRA)',
-        'vue3': 'Vue 3',
-        'nuxt3': 'Nuxt 3',
-        'svelte': 'Svelte',
-        'sveltekit': 'SvelteKit',
-        'astro': 'Astro',
-        'express': 'Express',
-        'fastify': 'Fastify',
-        'hono': 'Hono',
-        'nestjs': 'NestJS',
-        'html': 'HTML',
-        'react-native': 'React Native',
-        'ios-swift': 'iOS (Swift)',
-        'android-kotlin': 'Android (Kotlin)',
-        'flutter': 'Flutter',
-        'unknown': 'Unknown',
-    };
-    return names[fw];
-}

package/dist/install-intent-proposal.d.ts

@@ -1,99 +0,0 @@
-/**
- * Phase 18.6 — CLI install-time intent proposal rendering + interaction.
- *
- * Pure UI logic (plus a small interactive loop) that turns an `InstallIntent`
- * payload into a human-readable proposal and lets the user toggle individual
- * events/funnels before sending the accepted subset to the backend. This file
- * has NO hard limit on event/funnel count — a full iGaming intent with 20
- * events is rendered in full.
- *
- * Testability: the render function returns a plain string so snapshot-style
- * tests can assert structure. The interactive runner accepts injected I/O so
- * tests can drive it without real stdin/stdout.
- */
-export type Confidence = 'high' | 'medium' | 'low';
-export interface ProposedEvent {
-    name: string;
-    category: 'acquisition' | 'activation' | 'retention' | 'revenue' | 'referral' | 'compliance' | 'support' | 'engagement';
-    source: {
-        route?: string;
-        mutation?: string;
-        inferred?: boolean;
-        inferredFrom?: string;
-    };
-    properties: string[];
-    confidence: Confidence;
-    reasoning: string;
-}
-export interface ProposedFunnel {
-    name: string;
-    category: 'activation' | 'monetization' | 'retention' | 'compliance' | 'engagement';
-    steps: string[];
-    reasoning: string;
-}
-export interface InstallIntent {
-    vertical: string;
-    confidence: Confidence;
-    reasoning: string;
-    alternativeVerticals: Array<{
-        name: string;
-        confidence: Confidence;
-        note?: string;
-    }>;
-    events: ProposedEvent[];
-    funnels: ProposedFunnel[];
-    analyzerMode: 'llm' | 'heuristic';
-    modelVersion?: string;
-    promptVersion?: string;
-}
-export interface ProposalState {
-    intent: InstallIntent;
-    eventSelected: boolean[];
-    funnelSelected: boolean[];
-}
-export declare function initProposalState(intent: InstallIntent): ProposalState;
-/**
- * Render the proposal to a plain string (TTY colour escapes applied by the
- * caller if `colorize` is true). No truncation — every event/funnel is shown.
- */
-export declare function renderProposal(state: ProposalState, opts?: {
-    colorize?: boolean;
-}): string;
-export interface ApplyCommandResult {
-    state: ProposalState;
-    done: boolean;
-    quit: boolean;
-}
-/**
- * Apply a single user command to the proposal state. Exported so tests can
- * exercise the state machine directly without any I/O.
- */
-export declare function applyCommand(state: ProposalState, raw: string): ApplyCommandResult;
-export interface ProposalIo {
-    print: (line: string) => void;
-    prompt: (q: string) => Promise<string>;
-    isPiped: boolean;
-}
-export interface ProposalDecision {
-    accepted: {
-        events: ProposedEvent[];
-        funnels: ProposedFunnel[];
-    };
-    rejected: {
-        events: ProposedEvent[];
-        funnels: ProposedFunnel[];
-    };
-    quit: boolean;
-}
-export declare function splitDecision(state: ProposalState): ProposalDecision;
-export interface RunProposalOpts {
-    intent: InstallIntent;
-    io: ProposalIo;
-    /** If true (piped / --yes / CI), skip interactive loop and accept everything. */
-    nonInteractive?: boolean;
-}
-/**
- * Drive the interactive proposal loop. Returns the accepted + rejected split
- * plus a `quit` flag the caller uses to decide whether to continue the install.
- */
-export declare function runProposal(opts: RunProposalOpts): Promise<ProposalDecision>;