@rudderjs/pulse 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,77 @@
+export type MetricType = 'request_count' | 'request_duration' | 'queue_throughput' | 'queue_wait_time' | 'cache_hits' | 'cache_misses' | 'exceptions' | 'active_users' | 'server_cpu' | 'server_memory';
+export type EntryType = 'slow_request' | 'slow_query' | 'exception' | 'failed_job';
+export interface PulseAggregate {
+    id: string;
+    bucket: Date;
+    type: MetricType;
+    key: string | null;
+    count: number;
+    sum: number;
+    min: number | null;
+    max: number | null;
+    createdAt: Date;
+}
+export interface PulseEntry {
+    id: string;
+    type: EntryType;
+    content: Record<string, unknown>;
+    createdAt: Date;
+}
+export interface PulseStorage {
+    /** Increment an aggregate bucket. Creates the bucket if it doesn't exist. */
+    record(type: MetricType, value: number, key?: string | null): void | Promise<void>;
+    /** Store an individual entry (slow request, exception, etc.) */
+    storeEntry(type: EntryType, content: Record<string, unknown>): void | Promise<void>;
+    /** Get aggregates for a metric type within a time period */
+    aggregates(type: MetricType, since: Date, key?: string | null): PulseAggregate[] | Promise<PulseAggregate[]>;
+    /** Get individual entries by type */
+    entries(type: EntryType, options?: EntryListOptions): PulseEntry[] | Promise<PulseEntry[]>;
+    /** Get the overview — latest bucket for each metric type */
+    overview(since: Date): PulseAggregate[] | Promise<PulseAggregate[]>;
+    /** Delete aggregates and entries older than the given date */
+    pruneOlderThan(date: Date): void | Promise<void>;
+}
+export interface EntryListOptions {
+    page?: number | undefined;
+    perPage?: number | undefined;
+    search?: string | undefined;
+}
+export interface Aggregator {
+    readonly name: string;
+    register(): void | Promise<void>;
+}
+export interface PulseConfig {
+    enabled?: boolean | undefined;
+    path?: string | undefined;
+    storage?: 'memory' | 'sqlite' | undefined;
+    sqlitePath?: string | undefined;
+    pruneAfterHours?: number | undefined;
+    slowRequestThreshold?: number | undefined;
+    slowQueryThreshold?: number | undefined;
+    recordRequests?: boolean | undefined;
+    recordQueues?: boolean | undefined;
+    recordCache?: boolean | undefined;
+    recordExceptions?: boolean | undefined;
+    recordUsers?: boolean | undefined;
+    recordServers?: boolean | undefined;
+    serverStatsIntervalMs?: number | undefined;
+    auth?: null | ((req: unknown) => boolean | Promise<boolean>) | undefined;
+}
+export declare const defaultConfig: {
+    enabled: boolean;
+    path: string;
+    storage: "memory";
+    sqlitePath: string;
+    pruneAfterHours: number;
+    slowRequestThreshold: number;
+    slowQueryThreshold: number;
+    recordRequests: boolean;
+    recordQueues: boolean;
+    recordCache: boolean;
+    recordExceptions: boolean;
+    recordUsers: boolean;
+    recordServers: boolean;
+    serverStatsIntervalMs: number;
+    auth: null | ((req: unknown) => boolean | Promise<boolean>);
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,19 @@
+// ─── Metric Types ──────────────────────────────────────────
+export const defaultConfig = {
+    enabled: true,
+    path: 'pulse',
+    storage: 'memory',
+    sqlitePath: '.pulse.db',
+    pruneAfterHours: 168, // 7 days
+    slowRequestThreshold: 1000, // ms
+    slowQueryThreshold: 100, // ms
+    recordRequests: true,
+    recordQueues: true,
+    recordCache: true,
+    recordExceptions: true,
+    recordUsers: true,
+    recordServers: true,
+    serverStatsIntervalMs: 15_000,
+    auth: null,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAkG9D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAgB,IAAI;IAC3B,IAAI,EAAmB,OAAO;IAC9B,OAAO,EAAgB,QAAiB;IACxC,UAAU,EAAa,WAAW;IAClC,eAAe,EAAQ,GAAG,EAAG,SAAS;IACtC,oBAAoB,EAAG,IAAI,EAAE,KAAK;IAClC,kBAAkB,EAAK,GAAG,EAAG,KAAK;IAClC,cAAc,EAAS,IAAI;IAC3B,YAAY,EAAW,IAAI;IAC3B,WAAW,EAAY,IAAI;IAC3B,gBAAgB,EAAO,IAAI;IAC3B,WAAW,EAAY,IAAI;IAC3B,aAAa,EAAU,IAAI;IAC3B,qBAAqB,EAAE,MAAM;IAC7B,IAAI,EAAmB,IAA6D;CACrF,CAAA"}

package/dist/ui/dashboard.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Renders the Pulse dashboard — a single page with metric cards that auto-refresh.
+ */
+export declare function dashboardPage(apiPrefix: string): string;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/ui/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/ui/dashboard.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAoOvD"}

package/dist/ui/dashboard.js

@@ -0,0 +1,234 @@
+import { layout } from './layout.js';
+/**
+ * Renders the Pulse dashboard — a single page with metric cards that auto-refresh.
+ */
+export function dashboardPage(apiPrefix) {
+    return layout('Dashboard', `
+    <div x-data="dashboard()" x-init="load()" x-cloak>
+      <!-- Metric Cards Grid -->
+      <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-6">
+        <!-- Request Throughput -->
+        <div class="bg-white rounded-xl border border-gray-200 p-5 shadow-sm">
+          <div class="flex items-center justify-between mb-3">
+            <h3 class="text-sm font-medium text-gray-500">Requests</h3>
+            <span class="text-xs text-gray-400" x-text="period"></span>
+          </div>
+          <div class="text-2xl font-bold" x-text="fmt(metrics.request_count?.total || 0)"></div>
+          <div class="text-sm text-gray-500 mt-1">
+            avg <span x-text="fmt(metrics.request_duration?.avg || 0)"></span>ms
+          </div>
+          <div class="sparkline mt-3" x-html="sparkline(requestBuckets)"></div>
+        </div>
+
+        <!-- Cache Hit Rate -->
+        <div class="bg-white rounded-xl border border-gray-200 p-5 shadow-sm">
+          <div class="flex items-center justify-between mb-3">
+            <h3 class="text-sm font-medium text-gray-500">Cache Hit Rate</h3>
+          </div>
+          <div class="text-2xl font-bold">
+            <span x-text="cacheData.hit_rate || 0"></span>%
+          </div>
+          <div class="text-sm text-gray-500 mt-1">
+            <span x-text="fmt(cacheData.total_hits || 0)"></span> hits /
+            <span x-text="fmt(cacheData.total_misses || 0)"></span> misses
+          </div>
+          <div class="mt-3 h-2 bg-gray-100 rounded-full overflow-hidden">
+            <div class="h-full bg-green-500 rounded-full transition-all" :style="'width:' + (cacheData.hit_rate || 0) + '%'"></div>
+          </div>
+        </div>
+
+        <!-- Queue Throughput -->
+        <div class="bg-white rounded-xl border border-gray-200 p-5 shadow-sm">
+          <div class="flex items-center justify-between mb-3">
+            <h3 class="text-sm font-medium text-gray-500">Queue Jobs</h3>
+          </div>
+          <div class="text-2xl font-bold" x-text="fmt(metrics.queue_throughput?.total || 0)"></div>
+          <div class="text-sm text-gray-500 mt-1">
+            avg wait <span x-text="fmt(metrics.queue_wait_time?.avg || 0)"></span>ms
+          </div>
+          <div class="sparkline mt-3" x-html="sparkline(queueBuckets)"></div>
+        </div>
+
+        <!-- Exceptions -->
+        <div class="bg-white rounded-xl border border-gray-200 p-5 shadow-sm">
+          <div class="flex items-center justify-between mb-3">
+            <h3 class="text-sm font-medium text-gray-500">Exceptions</h3>
+          </div>
+          <div class="text-2xl font-bold" :class="(metrics.exceptions?.total || 0) > 0 ? 'text-red-600' : ''"
+               x-text="fmt(metrics.exceptions?.total || 0)"></div>
+          <div class="text-sm text-gray-500 mt-1">
+            min <span x-text="metrics.exceptions?.min ?? 0"></span> /
+            max <span x-text="metrics.exceptions?.max ?? 0"></span>
+          </div>
+        </div>
+
+        <!-- Active Users -->
+        <div class="bg-white rounded-xl border border-gray-200 p-5 shadow-sm">
+          <div class="flex items-center justify-between mb-3">
+            <h3 class="text-sm font-medium text-gray-500">Active Users</h3>
+          </div>
+          <div class="text-2xl font-bold" x-text="fmt(metrics.active_users?.total || 0)"></div>
+          <div class="text-sm text-gray-500 mt-1">unique in period</div>
+        </div>
+
+        <!-- Server CPU -->
+        <div class="bg-white rounded-xl border border-gray-200 p-5 shadow-sm">
+          <div class="flex items-center justify-between mb-3">
+            <h3 class="text-sm font-medium text-gray-500">CPU Usage</h3>
+          </div>
+          <div class="text-2xl font-bold">
+            <span x-text="(metrics.server_cpu?.avg || 0).toFixed(1)"></span>%
+          </div>
+          <div class="mt-3 h-2 bg-gray-100 rounded-full overflow-hidden">
+            <div class="h-full rounded-full transition-all" :class="(metrics.server_cpu?.avg || 0) > 80 ? 'bg-red-500' : 'bg-blue-500'"
+                 :style="'width:' + Math.min(metrics.server_cpu?.avg || 0, 100) + '%'"></div>
+          </div>
+        </div>
+
+        <!-- Server Memory -->
+        <div class="bg-white rounded-xl border border-gray-200 p-5 shadow-sm">
+          <div class="flex items-center justify-between mb-3">
+            <h3 class="text-sm font-medium text-gray-500">Memory Usage</h3>
+          </div>
+          <div class="text-2xl font-bold">
+            <span x-text="(metrics.server_memory?.avg || 0).toFixed(1)"></span>%
+          </div>
+          <div class="mt-3 h-2 bg-gray-100 rounded-full overflow-hidden">
+            <div class="h-full rounded-full transition-all" :class="(metrics.server_memory?.avg || 0) > 80 ? 'bg-red-500' : 'bg-amber-500'"
+                 :style="'width:' + Math.min(metrics.server_memory?.avg || 0, 100) + '%'"></div>
+          </div>
+        </div>
+      </div>
+
+      <!-- Slow Requests Table -->
+      <div class="mt-8 bg-white rounded-xl border border-gray-200 shadow-sm">
+        <div class="px-5 py-4 border-b border-gray-100">
+          <h3 class="text-sm font-semibold text-gray-700">Slow Requests</h3>
+        </div>
+        <div class="overflow-x-auto">
+          <table class="w-full text-sm">
+            <thead class="bg-gray-50 text-gray-500 text-xs uppercase">
+              <tr>
+                <th class="px-5 py-3 text-left">Method</th>
+                <th class="px-5 py-3 text-left">Path</th>
+                <th class="px-5 py-3 text-right">Duration</th>
+                <th class="px-5 py-3 text-right">Time</th>
+              </tr>
+            </thead>
+            <tbody class="divide-y divide-gray-100">
+              <template x-for="r in slowRequests" :key="r.id">
+                <tr class="hover:bg-gray-50">
+                  <td class="px-5 py-3">
+                    <span class="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium"
+                          :class="r.content.method === 'GET' ? 'bg-green-100 text-green-700' : 'bg-blue-100 text-blue-700'"
+                          x-text="r.content.method"></span>
+                  </td>
+                  <td class="px-5 py-3 font-mono text-xs" x-text="r.content.path"></td>
+                  <td class="px-5 py-3 text-right text-red-600 font-medium" x-text="r.content.duration + 'ms'"></td>
+                  <td class="px-5 py-3 text-right text-gray-400 text-xs" x-text="ago(r.createdAt)"></td>
+                </tr>
+              </template>
+              <tr x-show="slowRequests.length === 0">
+                <td colspan="4" class="px-5 py-8 text-center text-gray-400">No slow requests recorded.</td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+      </div>
+
+      <!-- Recent Exceptions Table -->
+      <div class="mt-6 bg-white rounded-xl border border-gray-200 shadow-sm">
+        <div class="px-5 py-4 border-b border-gray-100">
+          <h3 class="text-sm font-semibold text-gray-700">Recent Exceptions</h3>
+        </div>
+        <div class="overflow-x-auto">
+          <table class="w-full text-sm">
+            <thead class="bg-gray-50 text-gray-500 text-xs uppercase">
+              <tr>
+                <th class="px-5 py-3 text-left">Class</th>
+                <th class="px-5 py-3 text-left">Message</th>
+                <th class="px-5 py-3 text-right">Time</th>
+              </tr>
+            </thead>
+            <tbody class="divide-y divide-gray-100">
+              <template x-for="e in exceptions" :key="e.id">
+                <tr class="hover:bg-gray-50">
+                  <td class="px-5 py-3 font-mono text-xs text-red-600" x-text="e.content.class"></td>
+                  <td class="px-5 py-3 text-gray-600 truncate max-w-md" x-text="e.content.message"></td>
+                  <td class="px-5 py-3 text-right text-gray-400 text-xs" x-text="ago(e.createdAt)"></td>
+                </tr>
+              </template>
+              <tr x-show="exceptions.length === 0">
+                <td colspan="3" class="px-5 py-8 text-center text-gray-400">No exceptions recorded.</td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+      </div>
+
+      <!-- Auto-refresh indicator -->
+      <div class="mt-4 text-center text-xs text-gray-400">
+        Auto-refreshes every 10 seconds
+      </div>
+    </div>
+
+    <script>
+      function dashboard() {
+        return {
+          period: new URLSearchParams(location.search).get('period') || '1h',
+          metrics: {},
+          cacheData: {},
+          requestBuckets: [],
+          queueBuckets: [],
+          slowRequests: [],
+          exceptions: [],
+
+          async load() {
+            await this.refresh()
+            setInterval(() => this.refresh(), 10000)
+          },
+
+          async refresh() {
+            const p = '?period=' + this.period
+            const [overview, cache, requests, queues, exceptions, slowReqs] = await Promise.all([
+              fetch('${apiPrefix}/overview' + p).then(r => r.json()),
+              fetch('${apiPrefix}/cache' + p).then(r => r.json()),
+              fetch('${apiPrefix}/requests' + p).then(r => r.json()),
+              fetch('${apiPrefix}/queues' + p).then(r => r.json()),
+              fetch('${apiPrefix}/exceptions' + p).then(r => r.json()),
+              fetch('${apiPrefix}/slow-requests?per_page=10').then(r => r.json()),
+            ])
+            this.metrics = overview.metrics || {}
+            this.cacheData = cache
+            this.requestBuckets = (requests.throughput || []).map(b => b.count)
+            this.queueBuckets = (queues.throughput || []).map(b => b.count)
+            this.slowRequests = slowReqs.data || []
+            this.exceptions = exceptions.recent || []
+          },
+
+          sparkline(data) {
+            if (!data.length) return '<span class="text-xs text-gray-300">No data</span>'
+            const max = Math.max(...data, 1)
+            return data.slice(-30).map(v =>
+              '<div class="bar" style="height:' + Math.max((v / max) * 100, 2) + '%"></div>'
+            ).join('')
+          },
+
+          fmt(n) {
+            if (n >= 1000000) return (n / 1000000).toFixed(1) + 'M'
+            if (n >= 1000) return (n / 1000).toFixed(1) + 'K'
+            return Math.round(n)
+          },
+
+          ago(dateStr) {
+            const s = Math.floor((Date.now() - new Date(dateStr).getTime()) / 1000)
+            if (s < 60) return s + 's ago'
+            if (s < 3600) return Math.floor(s / 60) + 'm ago'
+            if (s < 86400) return Math.floor(s / 3600) + 'h ago'
+            return Math.floor(s / 86400) + 'd ago'
+          }
+        }
+      }
+    </script>`, 'pulse');
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/ui/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/ui/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,MAAM,CAAC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA4LN,SAAS;uBACT,SAAS;uBACT,SAAS;uBACT,SAAS;uBACT,SAAS;uBACT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiClB,EAAE,OAAO,CAAC,CAAA;AACxB,CAAC"}

package/dist/ui/layout.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared HTML layout for Pulse UI pages.
+ * Uses Tailwind CSS (CDN) + Alpine.js (CDN) for a zero-build UI.
+ */
+export declare function layout(title: string, body: string, path: string): string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/ui/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/ui/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgDxE"}

package/dist/ui/layout.js

@@ -0,0 +1,54 @@
+/**
+ * Shared HTML layout for Pulse UI pages.
+ * Uses Tailwind CSS (CDN) + Alpine.js (CDN) for a zero-build UI.
+ */
+export function layout(title, body, path) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${title} — Pulse</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+  <script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js"></script>
+  <style>
+    [x-cloak] { display: none !important; }
+    .sparkline { display: flex; align-items: end; gap: 1px; height: 40px; }
+    .sparkline .bar { flex: 1; background: #6366f1; border-radius: 1px; min-width: 2px; transition: height 0.3s; }
+    .sparkline .bar:hover { background: #818cf8; }
+  </style>
+</head>
+<body class="bg-gray-50 text-gray-900 font-sans antialiased">
+  <div class="min-h-screen">
+    <!-- Header -->
+    <header class="bg-white border-b border-gray-200 px-6 py-4">
+      <div class="max-w-7xl mx-auto flex items-center justify-between">
+        <div class="flex items-center gap-3">
+          <div class="w-8 h-8 bg-indigo-600 rounded-lg flex items-center justify-center">
+            <svg class="w-5 h-5 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"/>
+            </svg>
+          </div>
+          <h1 class="text-lg font-semibold">Pulse</h1>
+        </div>
+        <div x-data="{ period: new URLSearchParams(location.search).get('period') || '1h' }">
+          <select x-model="period" @change="location.search = '?period=' + period"
+                  class="text-sm border-gray-300 rounded-md shadow-sm focus:ring-indigo-500 focus:border-indigo-500 px-3 py-1.5 border">
+            <option value="1h">Last hour</option>
+            <option value="6h">Last 6 hours</option>
+            <option value="24h">Last 24 hours</option>
+            <option value="7d">Last 7 days</option>
+          </select>
+        </div>
+      </div>
+    </header>
+
+    <!-- Content -->
+    <main class="max-w-7xl mx-auto px-6 py-8">
+      ${body}
+    </main>
+  </div>
+</body>
+</html>`;
+}
+//# sourceMappingURL=layout.js.map

package/dist/ui/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/ui/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY;IAC9D,OAAO;;;;;WAKE,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqCR,IAAI;;;;QAIJ,CAAA;AACR,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * True for Vite internals, source files, and static assets that should be excluded
+ * from request metrics. Used by request and user aggregators.
+ */
+export declare function isAsset(path: string): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ7C"}

package/dist/utils.js

@@ -0,0 +1,19 @@
+/**
+ * True for Vite internals, source files, and static assets that should be excluded
+ * from request metrics. Used by request and user aggregators.
+ */
+export function isAsset(path) {
+    if (path.startsWith('/@'))
+        return true; // Vite internals: /@vite, /@react-refresh, /@id, /@fs
+    if (path.startsWith('/node_modules'))
+        return true;
+    if (path.startsWith('/src/'))
+        return true; // Vite source modules during dev
+    if (path.startsWith('/pages/'))
+        return true; // Vike page modules during dev
+    if (path.startsWith('/.vite/'))
+        return true; // Vite cache
+    const segment = path.split('/').pop() ?? '';
+    return segment.includes('.'); // any file extension → static asset
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAa,OAAO,IAAI,CAAA,CAAE,sDAAsD;IACzG,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAA;IACjD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAU,OAAO,IAAI,CAAA,CAAE,iCAAiC;IACpF,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAQ,OAAO,IAAI,CAAA,CAAE,+BAA+B;IAClF,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAQ,OAAO,IAAI,CAAA,CAAE,aAAa;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;IAC3C,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA,CAAuB,oCAAoC;AACzF,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@rudderjs/pulse",
+  "version": "0.0.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rudderjs/rudder",
+    "directory": "packages/pulse"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "boost"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@rudderjs/contracts": "0.0.3",
+    "@rudderjs/core": "0.0.8"
+  },
+  "peerDependencies": {
+    "@rudderjs/router": "0.0.3",
+    "@rudderjs/middleware": "0.0.7",
+    "@rudderjs/log": "0.0.1",
+    "@rudderjs/orm": "0.0.6",
+    "@rudderjs/cache": "0.0.6",
+    "@rudderjs/queue": "0.0.5"
+  },
+  "peerDependenciesMeta": {
+    "@rudderjs/log": {
+      "optional": true
+    },
+    "@rudderjs/orm": {
+      "optional": true
+    },
+    "@rudderjs/cache": {
+      "optional": true
+    },
+    "@rudderjs/queue": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "better-sqlite3": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "typescript": "^5.4.0"
+  },
+  "author": "Suleiman Shahbari",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "clean": "rm -rf dist",
+    "test": "tsc -p tsconfig.test.json && node --test dist-test/index.test.js; EXIT=$?; rm -rf dist-test; exit $EXIT"
+  }
+}