@gurulu/cli 0.4.7 → 1.0.1

package/dist/lib/api.d.ts

@@ -0,0 +1,139 @@
+export interface ApiClientOptions {
+    endpoint: string;
+    apiKey?: string;
+}
+export interface ApiError {
+    code: string;
+    message: string;
+    status: number;
+}
+export declare class ApiHttpError extends Error {
+    status: number;
+    code: string;
+    constructor(opts: {
+        status: number;
+        code: string;
+        message: string;
+    });
+}
+export declare class ApiClient {
+    private opts;
+    constructor(opts: ApiClientOptions);
+    private headers;
+    get<T>(path: string, query?: Record<string, string | number>): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    private handle;
+}
+export interface RegistryPullResponse {
+    manifest_version: string;
+    schema_version: number;
+    workspace_id: string;
+    exported_at: string;
+    events: ManifestEvent[];
+}
+export interface ManifestEvent {
+    key: string;
+    name: string;
+    meaning: string;
+    type: 'interaction' | 'intent' | 'outcome';
+    lifecycle: 'draft' | 'active' | 'deprecated' | 'archived';
+    producerPrimary: string;
+    producerAllowed: string[];
+    producerForbidden: string[];
+    schemaVersion: number;
+    properties: ManifestProperty[];
+}
+export interface ManifestProperty {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'date' | 'json' | 'array';
+    required: boolean;
+    format?: string;
+    position?: number;
+}
+export interface RegistryPushBody {
+    action: 'add_event' | 'add_property' | 'modify_event';
+    source: 'cli' | 'mcp:cursor' | 'mcp:claude_code' | 'mcp:codex' | 'mcp:lovable' | 'mcp:generic';
+    payload: {
+        event_key: string;
+        name?: string;
+        meaning: string;
+        event_type: 'interaction' | 'intent' | 'outcome';
+        primary_producer?: 'script' | 'sdk_web' | 'sdk_server' | 'webhook' | 'playground' | 'agent' | 'cli';
+        required_properties?: Array<{
+            name: string;
+            type: string;
+            format?: string;
+        }>;
+        optional_properties?: Array<{
+            name: string;
+            type: string;
+        }>;
+    };
+}
+export interface RegistryPushResponse {
+    verification_id: string;
+    status: 'pending_approval';
+    event_key: string;
+    lifecycle: string;
+    message: string;
+}
+export interface RecentEventsResponse {
+    workspace_id: string;
+    count: number;
+    events: Array<{
+        event_id: string;
+        event_key: string;
+        event_type: 'interaction' | 'intent' | 'outcome';
+        occurred_at: string;
+        anonymous_id: string | null;
+        person_id: string | null;
+        properties: Record<string, unknown>;
+    }>;
+    note?: string;
+}
+export interface HealthOverviewResponse {
+    workspace_id: string;
+    registry: {
+        total_events: number;
+        by_type: {
+            interaction: number;
+            intent: number;
+            outcome: number;
+        };
+        by_lifecycle: {
+            draft: number;
+            active: number;
+            deprecated: number;
+            archived: number;
+        };
+    };
+    alarms: {
+        total: number;
+        active: number;
+        by_severity: {
+            critical: number;
+            warn: number;
+            info: number;
+        };
+    };
+    traffic: {
+        recent_events_24h: number;
+        clickhouse_available: boolean;
+    };
+}
+export interface DeviceStartResponse {
+    device_code: string;
+    user_code: string;
+    verification_url: string;
+    verification_url_complete: string;
+    expires_in: number;
+    interval: number;
+}
+export interface DeviceTokenResponse {
+    access_token: string;
+    token_type: 'Bearer';
+    workspace_id: string;
+    tenant_id: string;
+    expires_in: number | null;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/lib/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"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"}

package/dist/lib/codegen.d.ts

@@ -0,0 +1,4 @@
+import type { RegistryPullResponse } from './api.ts';
+export declare function generateTypescript(manifest: RegistryPullResponse): string;
+export declare function generateManifestLock(manifest: RegistryPullResponse): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/lib/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/lib/codegen.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAmC,oBAAoB,EAAE,MAAM,UAAU,CAAC;AA8BtF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAwDzE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAE3E"}

package/dist/lib/config.d.ts

@@ -0,0 +1,43 @@
+export interface ProjectConfig {
+    workspace_id: string;
+    endpoint: string;
+    sdk_preference: 'web' | 'node' | 'react';
+    registry_path: string;
+    generated_path: string;
+    manifest_lock_path: string;
+    auto_pull_on_init: boolean;
+}
+export interface GlobalCredentialEntry {
+    workspace_id: string;
+    api_key: string;
+    endpoint: string;
+    last_used: string;
+}
+export interface GlobalCredentials {
+    workspaces: GlobalCredentialEntry[];
+    default_workspace_id?: string;
+}
+export declare const DEFAULT_ENDPOINT: string;
+export declare function projectRoot(cwd?: string): string;
+export declare function projectConfigPath(cwd?: string): string;
+export declare function projectRegistryPath(cwd?: string): string;
+export declare function projectGeneratedPath(cwd?: string): string;
+export declare function projectManifestLockPath(cwd?: string): string;
+export declare function globalCredentialsPath(): string;
+export declare function ensureDir(path: string): void;
+export declare function readProjectConfig(cwd?: string): ProjectConfig | null;
+export declare function writeProjectConfig(cfg: ProjectConfig, cwd?: string): void;
+export declare function readGlobalCredentials(): GlobalCredentials;
+export declare function writeGlobalCredentials(creds: GlobalCredentials): void;
+export declare function findCredentialForWorkspace(workspaceId: string): GlobalCredentialEntry | null;
+export declare function upsertCredential(entry: GlobalCredentialEntry): void;
+export declare function removeCredential(workspaceId: string): boolean;
+export declare function resolveActiveCredential(opts: {
+    workspaceId?: string;
+    cwd?: string;
+}): {
+    workspaceId: string;
+    apiKey: string;
+    endpoint: string;
+} | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,gBAAgB,QAAyD,CAAC;AAEvF,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAErE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEvE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAExE;AAED,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE3E;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG5C;AAED,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,aAAa,GAAG,IAAI,CAQnF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAIxF;AAED,wBAAgB,qBAAqB,IAAI,iBAAiB,CAQzD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAYrE;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAG5F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAUnE;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAO7D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBnE"}

package/dist/lib/detect.d.ts

@@ -0,0 +1,27 @@
+export type Framework = 'next' | 'react' | 'vue' | 'nuxt' | 'svelte' | 'astro' | 'vite' | 'express' | 'fastify' | 'hono' | 'koa' | 'node-server' | 'unknown';
+export type Runtime = 'browser' | 'node' | 'unknown';
+export type PackageManager = 'bun' | 'pnpm' | 'yarn' | 'npm';
+export interface DetectedProject {
+    dir: string;
+    hasPackageJson: boolean;
+    framework: Framework;
+    runtime: Runtime;
+    packageManager: PackageManager;
+    packageJson: PackageJsonShape | null;
+}
+interface PackageJsonShape {
+    name?: string;
+    type?: 'module' | 'commonjs';
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}
+/**
+ * Walk up the directory tree (max 6 levels) looking for a lockfile.
+ * Monorepo workspaces typically have the lockfile at the repo root.
+ */
+export declare function detectPackageManager(dir: string): PackageManager;
+export declare function detectFramework(pkg: PackageJsonShape | null, dir: string): Framework;
+export declare function frameworkRuntime(fw: Framework): Runtime;
+export declare function detectProject(dir: string): DetectedProject;
+export {};
+//# sourceMappingURL=detect.d.ts.map

package/dist/lib/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/lib/detect.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,GACN,SAAS,GACT,SAAS,GACT,MAAM,GACN,KAAK,GACL,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACtC;AAED,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAiBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAchE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAkBpF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAmBvD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAW1D"}

package/dist/lib/detect.js

@@ -0,0 +1,106 @@
+// src/lib/detect.ts
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, parse } from "node:path";
+function readPackageJson(dir) {
+  const p = join(dir, "package.json");
+  if (!existsSync(p))
+    return null;
+  try {
+    return JSON.parse(readFileSync(p, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function hasDep(pkg, name) {
+  if (!pkg)
+    return false;
+  return Boolean(pkg.dependencies?.[name] ?? pkg.devDependencies?.[name]);
+}
+function detectPackageManager(dir) {
+  const root = parse(dir).root;
+  let cur = dir;
+  for (let i = 0;i < 6; i++) {
+    if (existsSync(join(cur, "bun.lock")) || existsSync(join(cur, "bun.lockb")))
+      return "bun";
+    if (existsSync(join(cur, "pnpm-lock.yaml")))
+      return "pnpm";
+    if (existsSync(join(cur, "yarn.lock")))
+      return "yarn";
+    if (existsSync(join(cur, "package-lock.json")))
+      return "npm";
+    if (cur === root)
+      break;
+    const parent = dirname(cur);
+    if (parent === cur)
+      break;
+    cur = parent;
+  }
+  return "npm";
+}
+function detectFramework(pkg, dir) {
+  if (!pkg)
+    return "unknown";
+  if (hasDep(pkg, "next"))
+    return "next";
+  if (hasDep(pkg, "nuxt"))
+    return "nuxt";
+  if (hasDep(pkg, "@sveltejs/kit") || hasDep(pkg, "svelte"))
+    return "svelte";
+  if (hasDep(pkg, "astro"))
+    return "astro";
+  if (hasDep(pkg, "vite") && (hasDep(pkg, "vue") || hasDep(pkg, "react")))
+    return "vite";
+  if (hasDep(pkg, "vue"))
+    return "vue";
+  if (hasDep(pkg, "react"))
+    return "react";
+  if (hasDep(pkg, "hono"))
+    return "hono";
+  if (hasDep(pkg, "fastify"))
+    return "fastify";
+  if (hasDep(pkg, "express"))
+    return "express";
+  if (hasDep(pkg, "koa"))
+    return "koa";
+  if (existsSync(join(dir, "server.js")) || existsSync(join(dir, "server.ts")))
+    return "node-server";
+  return "unknown";
+}
+function frameworkRuntime(fw) {
+  switch (fw) {
+    case "next":
+    case "react":
+    case "vue":
+    case "nuxt":
+    case "svelte":
+    case "astro":
+    case "vite":
+      return "browser";
+    case "express":
+    case "fastify":
+    case "hono":
+    case "koa":
+    case "node-server":
+      return "node";
+    default:
+      return "unknown";
+  }
+}
+function detectProject(dir) {
+  const pkg = readPackageJson(dir);
+  const framework = detectFramework(pkg, dir);
+  return {
+    dir,
+    hasPackageJson: pkg !== null,
+    framework,
+    runtime: frameworkRuntime(framework),
+    packageManager: detectPackageManager(dir),
+    packageJson: pkg
+  };
+}
+export {
+  frameworkRuntime,
+  detectProject,
+  detectPackageManager,
+  detectFramework
+};

package/dist/lib/exec-install.d.ts

@@ -0,0 +1,21 @@
+import type { InstallPlan } from './install-plan.ts';
+export interface ExecInstallOptions {
+    cwd: string;
+    /** Suppress stdout/stderr forwarding (still captured in result). */
+    silent?: boolean;
+    /** Hard timeout in ms (default 120s). */
+    timeoutMs?: number;
+}
+export interface ExecInstallResult {
+    ok: boolean;
+    exitCode: number | null;
+    durationMs: number;
+    command: string;
+    stderr?: string;
+}
+/**
+ * Spawn the package manager install command for the planned SDK.
+ * Streams output to the parent process (unless `silent: true`).
+ */
+export declare function execInstall(plan: InstallPlan, opts: ExecInstallOptions): Promise<ExecInstallResult>;
+//# sourceMappingURL=exec-install.d.ts.map

package/dist/lib/exec-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-install.d.ts","sourceRoot":"","sources":["../../src/lib/exec-install.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CA6D5B"}

package/dist/lib/install-plan.d.ts

@@ -0,0 +1,25 @@
+import type { DetectedProject, Framework, PackageManager } from './detect.ts';
+export type SdkPackage = '@gurulu/web' | '@gurulu/node';
+export interface InstallPlanContext {
+    /** Workspace key (pk_xxx) — script tag + init() içine inject. */
+    writeKey?: string;
+    /** Workspace UUID — CLI/MCP referansı. */
+    workspaceId?: string;
+    /** Server-side projeler için API key (sk_xxx). */
+    apiKey?: string;
+}
+export interface InstallPlan {
+    sdk: SdkPackage;
+    packageManager: PackageManager;
+    installCommand: string;
+    initSnippet: string;
+    envKeys: Array<{
+        key: string;
+        example: string;
+        required: boolean;
+    }>;
+    placementHint: string;
+    framework: Framework;
+}
+export declare function buildInstallPlan(detected: DetectedProject, ctx?: InstallPlanContext): InstallPlan;
+//# sourceMappingURL=install-plan.d.ts.map

package/dist/lib/install-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-plan.d.ts","sourceRoot":"","sources":["../../src/lib/install-plan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,cAAc,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,UAAU,CAAC;IAChB,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;CACtB;AA2JD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,EACzB,GAAG,GAAE,kBAAuB,GAC3B,WAAW,CAYb"}

package/dist/lib/install-plan.js

@@ -0,0 +1,161 @@
+// src/lib/install-plan.ts
+function installCmdFor(pm, pkg) {
+  switch (pm) {
+    case "bun":
+      return `bun add ${pkg}`;
+    case "pnpm":
+      return `pnpm add ${pkg}`;
+    case "yarn":
+      return `yarn add ${pkg}`;
+    default:
+      return `npm install ${pkg}`;
+  }
+}
+function sdkFor(framework) {
+  switch (framework) {
+    case "express":
+    case "fastify":
+    case "hono":
+    case "koa":
+    case "node-server":
+      return "@gurulu/node";
+    default:
+      return "@gurulu/web";
+  }
+}
+function snippetWeb(workspaceKey) {
+  return `import { createGurulu } from '@gurulu/web';
+
+const gurulu = createGurulu();
+gurulu.init({ workspace: '${workspaceKey}' });`;
+}
+function snippetNext(workspaceKey) {
+  return `// app/layout.tsx (or pages/_app.tsx)
+'use client';
+import { useEffect } from 'react';
+import { createGurulu } from '@gurulu/web';
+
+const gurulu = createGurulu();
+
+export function GuruluProvider({ children }: { children: React.ReactNode }) {
+  useEffect(() => {
+    gurulu.init({ workspace: '${workspaceKey}' });
+  }, []);
+  return <>{children}</>;
+}`;
+}
+function snippetNode(workspaceKey) {
+  return `import { createGurulu } from '@gurulu/node';
+
+const gurulu = createGurulu({
+  workspace: '${workspaceKey}',
+  apiKey: process.env.GURULU_API_KEY,
+});
+
+// In your handler:
+await gurulu.track('purchase.completed', {
+  user_id: 'u_42',
+  order_id: 'o_123',
+  total: 49.99,
+});`;
+}
+function snippetExpress(workspaceKey) {
+  return `import express from 'express';
+import { guruluMiddleware } from '@gurulu/node/middleware/express';
+
+const app = express();
+app.use(guruluMiddleware({
+  workspace: '${workspaceKey}',
+  apiKey: process.env.GURULU_API_KEY,
+}));`;
+}
+function snippetHono(workspaceKey) {
+  return `import { Hono } from 'hono';
+import { createGurulu } from '@gurulu/node';
+
+const gurulu = createGurulu({
+  workspace: '${workspaceKey}',
+  apiKey: process.env.GURULU_API_KEY,
+});
+
+const app = new Hono();
+app.post('/checkout/complete', async (c) => {
+  await gurulu.track('purchase.completed', await c.req.json());
+  return c.json({ ok: true });
+});`;
+}
+function placementHintFor(framework) {
+  switch (framework) {
+    case "next":
+      return "Add the GuruluProvider to app/layout.tsx (App Router) or pages/_app.tsx (Pages Router) and wrap children.";
+    case "nuxt":
+      return "Add to plugins/gurulu.client.ts and register in nuxt.config.ts.";
+    case "svelte":
+      return "Add to src/routes/+layout.svelte inside onMount().";
+    case "astro":
+      return "Add to src/layouts/Base.astro inside a <script> tag (or use a hydrated component).";
+    case "vite":
+    case "react":
+    case "vue":
+      return "Add to src/main.ts (or your entry file) before mounting the app.";
+    case "express":
+      return "Register guruluMiddleware before your route handlers in your app entry file.";
+    case "fastify":
+      return "Register the Gurulu plugin via fastify.register() before route definitions.";
+    case "hono":
+      return "Initialize the SDK at the top of your app file; call track() inside route handlers.";
+    case "koa":
+      return "Add as Koa middleware (app.use) before your routes.";
+    case "node-server":
+      return "Initialize the SDK at startup; call track() from your handlers.";
+    default:
+      return "Initialize the SDK at your app entry point.";
+  }
+}
+function initSnippetFor(framework, sdk, workspaceKey) {
+  if (sdk === "@gurulu/node") {
+    if (framework === "express")
+      return snippetExpress(workspaceKey);
+    if (framework === "hono")
+      return snippetHono(workspaceKey);
+    return snippetNode(workspaceKey);
+  }
+  if (framework === "next")
+    return snippetNext(workspaceKey);
+  return snippetWeb(workspaceKey);
+}
+function envKeysFor(sdk, framework) {
+  if (sdk === "@gurulu/node") {
+    return [
+      {
+        key: "GURULU_API_KEY",
+        example: "sk_live_xxxxxxxxxxxx",
+        required: true
+      }
+    ];
+  }
+  const envKey = framework === "next" ? "NEXT_PUBLIC_GURULU_WORKSPACE" : "VITE_GURULU_WORKSPACE";
+  return [
+    {
+      key: envKey,
+      example: "pk_live_xxxxxxxxxxxx",
+      required: false
+    }
+  ];
+}
+function buildInstallPlan(detected, ctx = {}) {
+  const sdk = sdkFor(detected.framework);
+  const workspaceKey = ctx.writeKey ?? "pk_xxxxxxxxxxxx";
+  return {
+    sdk,
+    packageManager: detected.packageManager,
+    installCommand: installCmdFor(detected.packageManager, sdk),
+    initSnippet: initSnippetFor(detected.framework, sdk, workspaceKey),
+    envKeys: envKeysFor(sdk, detected.framework),
+    placementHint: placementHintFor(detected.framework),
+    framework: detected.framework
+  };
+}
+export {
+  buildInstallPlan
+};

package/package.json

@@ -1,33 +1,64 @@
 {
   "name": "@gurulu/cli",
-  "version": "0.4.7",
-  "description": "Gurulu.io CLI — setup analytics in seconds",
+  "version": "1.0.1",
+  "private": false,
+  "license": "BUSL-1.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "description": "Gurulu CLI. init / pull / push / validate / doctor — registry as code, local schema sync.",
+  "homepage": "https://gurulu.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Preatan/gurulu.io.git",
+    "directory": "packages/cli"
+  },
   "bin": {
-    "gurulu": "bin/gurulu.js"
+    "gurulu": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./detect": {
+      "types": "./dist/lib/detect.d.ts",
+      "import": "./dist/lib/detect.js",
+      "default": "./dist/lib/detect.js"
+    },
+    "./install-plan": {
+      "types": "./dist/lib/install-plan.d.ts",
+      "import": "./dist/lib/install-plan.js",
+      "default": "./dist/lib/install-plan.js"
+    },
+    "./package.json": "./package.json"
   },
-  "main": "dist/index.js",
   "files": [
     "dist",
-    "bin",
-    "scripts"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
+    "build": "rm -rf dist && bun run build:js && bun run build:lib && bun run build:types && bun run build:bin",
+    "build:js": "bun build ./src/index.ts --outdir ./dist --target node --format=esm",
+    "build:lib": "bun build ./src/lib/detect.ts ./src/lib/install-plan.ts --outdir ./dist/lib --target node --format=esm",
+    "build:bin": "bun build ./src/bin.ts --outdir ./dist --target node --format=esm && chmod +x dist/bin.js",
+    "build:types": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "echo no-tests-yet",
+    "prepublishOnly": "bun run build",
+    "clean": "rm -rf dist .turbo"
   },
   "dependencies": {
-    "yargs": "^17.7.2",
-    "@babel/parser": "^7.24.0",
-    "@babel/traverse": "^7.24.0",
-    "@babel/generator": "^7.24.0"
+    "citty": "^0.1.6",
+    "undici": "^7.0.0"
   },
   "devDependencies": {
-    "@types/yargs": "^17.0.32",
-    "typescript": "^5.3.0",
-    "@types/node": "^20.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "license": "MIT"
+    "typescript": "^5.6.0"
+  }
 }

package/bin/gurulu.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-require('../dist/index.js');