@vocoweb/meter 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 VocoWeb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+# @vocoweb/meter
+
+[![npm version](https://badge.fury.io/js/%40vocoweb%2Fmeter.svg)](https://www.npmjs.com/package/@vocoweb/meter)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Production-ready usage tracking and limits for B2B SaaS.
+
+## Overview
+
+`@vocoweb/meter` is the "Meter" module that makes usage-based pricing simple. Track usage, enforce limits, and display beautiful progress bars—all with a single function call.
+
+**Key Features:**
+- 📊 **Usage Tracking** - Track any metric (API calls, PDFs, storage, etc.)
+- 🎯 **Limit Enforcement** - Automatic 402 errors when limits exceeded
+- 🔄 **Auto Reset** - Monthly/daily/weekly reset periods
+- 📈 **Usage UI** - Pre-built progress bar component
+- ⚡ **High Performance** - Built on Supabase with row-level security
+
+## Installation
+
+```bash
+npm install @vocoweb/meter
+```
+
+## Quick Start
+
+### Server-Side
+
+```typescript
+import { meter } from '@vocoweb/meter';
+
+// Increment usage
+export async function POST(request: Request) {
+  const user = await auth.requireUser(request);
+  
+  // Check limit before generating
+  await meter.checkLimit(user.id, 'pdf_generated');
+  
+  // Generate PDF
+  const pdf = await generatePDF(data);
+  
+  // Increment counter
+  await meter.increment(user.id, 'pdf_generated', 1);
+  
+  return Response.json({ pdf });
+}
+
+// Get current usage
+export async function GET(request: Request) {
+  const user = await auth.requireUser(request);
+  const usage = await meter.getUsage(user.id, 'pdf_generated');
+  
+  return Response.json({
+    used: usage.current,
+    limit: usage.limit,
+    percentage: (usage.current / usage.limit) * 100,
+  });
+}
+```
+
+### Client-Side (React)
+
+```tsx
+import { VocoUsageBar } from '@vocoweb/meter/react';
+
+export default function Dashboard() {
+  return (
+    <div>
+      <h1>Dashboard</h1>
+      
+      <VocoUsageBar 
+        metric="pdf_generated" 
+        label="PDFs Generated This Month"
+      />
+      
+      <VocoUsageBar 
+        metric="api_calls" 
+        label="API Calls"
+        color="blue"
+      />
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### Server Methods
+
+- `increment(userId, metric, amount)` - Increment usage counter
+- `checkLimit(userId, metric)` - Check if within limit (throws 402 if exceeded)
+- `getUsage(userId, metric)` - Get current usage statistics
+- `resetUsage(userId, metric)` - Reset usage counter
+- `setLimit(userId, metric, limit)` - Update user's limit
+
+### React Components
+
+- `<VocoUsageBar metric="name" label="Label" />` - Usage progress bar
+
+## Configuration Example
+
+```typescript
+// vocoweb.config.ts
+export const config = {
+  limits: {
+    pdf_generated: { 
+      free: 10, 
+      pro: 100, 
+      enterprise: 1000 
+    },
+    api_calls: { 
+      free: 1000, 
+      pro: 10000, 
+      enterprise: 100000 
+    },
+  },
+  resetPeriod: 'monthly', // 'daily', 'weekly', 'monthly'
+};
+```
+
+## Environment Variables
+
+```bash
+# Supabase (Required)
+NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
+SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
+```
+
+## Database Schema
+
+```sql
+CREATE TABLE usage_metrics (
+  id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+  user_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
+  metric TEXT NOT NULL,
+  current_usage INTEGER DEFAULT 0,
+  limit_value INTEGER NOT NULL,
+  reset_at TIMESTAMPTZ NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  UNIQUE(user_id, metric)
+);
+```
+
+## License
+
+MIT © VocoWeb
+
+## Support
+
+- Email: legal@vocoweb.in
+- Documentation: [GitHub Wiki](https://github.com/vocoweb/vocoweb-meter/wiki)
+
+---
+
+**Built with care by [VocoWeb](https://vocoweb.in)**

package/dist/index.d.mts

@@ -0,0 +1,75 @@
+/**
+ * Type definitions for @vocoweb/meter
+ */
+type MetricName = string;
+type ResetPeriod = 'daily' | 'weekly' | 'monthly' | 'never';
+interface UsageMetric {
+    id: string;
+    userId: string;
+    metric: MetricName;
+    currentUsage: number;
+    limitValue: number;
+    resetAt: Date;
+    createdAt: Date;
+    updatedAt?: Date;
+}
+interface UsageStats {
+    current: number;
+    limit: number;
+    percentage: number;
+    remaining: number;
+}
+interface IncrementOptions {
+    userId: string;
+    metric: MetricName;
+    amount?: number;
+}
+interface SetLimitOptions {
+    userId: string;
+    metric: MetricName;
+    limit: number;
+}
+
+/**
+ * Server-side functions for @vocoweb/meter
+ */
+
+/**
+ * Increment usage counter
+ */
+declare function increment(userId: string, metric: MetricName, amount?: number): Promise<void>;
+/**
+ * Check if user is within limit (throws 402 if exceeded)
+ */
+declare function checkLimit(userId: string, metric: MetricName): Promise<void>;
+/**
+ * Get current usage statistics
+ */
+declare function getUsage(userId: string, metric: MetricName): Promise<UsageStats>;
+/**
+ * Reset usage counter
+ */
+declare function resetUsage(userId: string, metric: MetricName): Promise<void>;
+/**
+ * Set user's limit
+ */
+declare function setLimit(userId: string, metric: MetricName, limit: number): Promise<void>;
+
+/**
+ * @vocoweb/meter
+ * Production-ready usage tracking and limits
+ */
+
+/**
+ * Main meter API
+ */
+declare const meter: {
+    increment: typeof increment;
+    checkLimit: typeof checkLimit;
+    getUsage: typeof getUsage;
+    resetUsage: typeof resetUsage;
+    setLimit: typeof setLimit;
+};
+declare const VERSION = "1.0.0";
+
+export { type IncrementOptions, type MetricName, type ResetPeriod, type SetLimitOptions, type UsageMetric, type UsageStats, VERSION, checkLimit, getUsage, increment, meter, resetUsage, setLimit };

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Type definitions for @vocoweb/meter
+ */
+type MetricName = string;
+type ResetPeriod = 'daily' | 'weekly' | 'monthly' | 'never';
+interface UsageMetric {
+    id: string;
+    userId: string;
+    metric: MetricName;
+    currentUsage: number;
+    limitValue: number;
+    resetAt: Date;
+    createdAt: Date;
+    updatedAt?: Date;
+}
+interface UsageStats {
+    current: number;
+    limit: number;
+    percentage: number;
+    remaining: number;
+}
+interface IncrementOptions {
+    userId: string;
+    metric: MetricName;
+    amount?: number;
+}
+interface SetLimitOptions {
+    userId: string;
+    metric: MetricName;
+    limit: number;
+}
+
+/**
+ * Server-side functions for @vocoweb/meter
+ */
+
+/**
+ * Increment usage counter
+ */
+declare function increment(userId: string, metric: MetricName, amount?: number): Promise<void>;
+/**
+ * Check if user is within limit (throws 402 if exceeded)
+ */
+declare function checkLimit(userId: string, metric: MetricName): Promise<void>;
+/**
+ * Get current usage statistics
+ */
+declare function getUsage(userId: string, metric: MetricName): Promise<UsageStats>;
+/**
+ * Reset usage counter
+ */
+declare function resetUsage(userId: string, metric: MetricName): Promise<void>;
+/**
+ * Set user's limit
+ */
+declare function setLimit(userId: string, metric: MetricName, limit: number): Promise<void>;
+
+/**
+ * @vocoweb/meter
+ * Production-ready usage tracking and limits
+ */
+
+/**
+ * Main meter API
+ */
+declare const meter: {
+    increment: typeof increment;
+    checkLimit: typeof checkLimit;
+    getUsage: typeof getUsage;
+    resetUsage: typeof resetUsage;
+    setLimit: typeof setLimit;
+};
+declare const VERSION = "1.0.0";
+
+export { type IncrementOptions, type MetricName, type ResetPeriod, type SetLimitOptions, type UsageMetric, type UsageStats, VERSION, checkLimit, getUsage, increment, meter, resetUsage, setLimit };

package/dist/index.js

@@ -0,0 +1,96 @@
+'use strict';
+
+var supabaseJs = require('@supabase/supabase-js');
+
+// src/server.ts
+var getSupabaseClient = () => {
+  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
+  const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
+  if (!supabaseUrl || !supabaseKey) {
+    throw new Error("Supabase credentials not configured");
+  }
+  return supabaseJs.createClient(supabaseUrl, supabaseKey);
+};
+async function increment(userId, metric, amount = 1) {
+  const supabase = getSupabaseClient();
+  const { data: existing } = await supabase.from("usage_metrics").select("*").eq("user_id", userId).eq("metric", metric).single();
+  if (existing) {
+    const { error } = await supabase.from("usage_metrics").update({ current_usage: existing.current_usage + amount }).eq("id", existing.id);
+    if (error) throw new Error(`Failed to increment usage: ${error.message}`);
+  } else {
+    const { error } = await supabase.from("usage_metrics").insert({
+      user_id: userId,
+      metric,
+      current_usage: amount,
+      limit_value: 100,
+      // Default limit
+      reset_at: getNextResetDate("monthly")
+    });
+    if (error) throw new Error(`Failed to create metric: ${error.message}`);
+  }
+}
+async function checkLimit(userId, metric) {
+  const stats = await getUsage(userId, metric);
+  if (stats.current >= stats.limit) {
+    throw new Error(`Usage limit exceeded for ${metric}`, {
+      cause: { code: 402, metric, stats }
+    });
+  }
+}
+async function getUsage(userId, metric) {
+  const supabase = getSupabaseClient();
+  const { data, error } = await supabase.from("usage_metrics").select("*").eq("user_id", userId).eq("metric", metric).single();
+  if (error || !data) {
+    return { current: 0, limit: 100, percentage: 0, remaining: 100 };
+  }
+  const current = data.current_usage;
+  const limit = data.limit_value;
+  const percentage = current / limit * 100;
+  const remaining = Math.max(0, limit - current);
+  return { current, limit, percentage, remaining };
+}
+async function resetUsage(userId, metric) {
+  const supabase = getSupabaseClient();
+  const { error } = await supabase.from("usage_metrics").update({ current_usage: 0, reset_at: getNextResetDate("monthly") }).eq("user_id", userId).eq("metric", metric);
+  if (error) throw new Error(`Failed to reset usage: ${error.message}`);
+}
+async function setLimit(userId, metric, limit) {
+  const supabase = getSupabaseClient();
+  const { error } = await supabase.from("usage_metrics").update({ limit_value: limit }).eq("user_id", userId).eq("metric", metric);
+  if (error) throw new Error(`Failed to set limit: ${error.message}`);
+}
+function getNextResetDate(period) {
+  const date = /* @__PURE__ */ new Date();
+  switch (period) {
+    case "daily":
+      date.setDate(date.getDate() + 1);
+      break;
+    case "weekly":
+      date.setDate(date.getDate() + 7);
+      break;
+    case "monthly":
+      date.setMonth(date.getMonth() + 1);
+      break;
+  }
+  return date.toISOString();
+}
+
+// src/index.ts
+var meter = {
+  increment,
+  checkLimit,
+  getUsage,
+  resetUsage,
+  setLimit
+};
+var VERSION = "1.0.0";
+
+exports.VERSION = VERSION;
+exports.checkLimit = checkLimit;
+exports.getUsage = getUsage;
+exports.increment = increment;
+exports.meter = meter;
+exports.resetUsage = resetUsage;
+exports.setLimit = setLimit;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/index.ts"],"names":["createClient"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Server-side functions for @vocoweb/meter\n */\n\nimport { createClient } from '@supabase/supabase-js';\nimport type { MetricName, UsageStats } from './types';\n\nconst getSupabaseClient = () => {\n    const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;\n    const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;\n\n    if (!supabaseUrl || !supabaseKey) {\n        throw new Error('Supabase credentials not configured');\n    }\n\n    return createClient(supabaseUrl, supabaseKey);\n};\n\n/**\n * Increment usage counter\n */\nexport async function increment(userId: string, metric: MetricName, amount: number = 1): Promise<void> {\n    const supabase = getSupabaseClient();\n\n    // Get or create metric\n    const { data: existing } = await supabase\n        .from('usage_metrics')\n        .select('*')\n        .eq('user_id', userId)\n        .eq('metric', metric)\n        .single();\n\n    if (existing) {\n        const { error } = await supabase\n            .from('usage_metrics')\n            .update({ current_usage: existing.current_usage + amount })\n            .eq('id', existing.id);\n\n        if (error) throw new Error(`Failed to increment usage: ${error.message}`);\n    } else {\n        // Create new metric with default limit\n        const { error } = await supabase\n            .from('usage_metrics')\n            .insert({\n                user_id: userId,\n                metric,\n                current_usage: amount,\n                limit_value: 100, // Default limit\n                reset_at: getNextResetDate('monthly'),\n            });\n\n        if (error) throw new Error(`Failed to create metric: ${error.message}`);\n    }\n}\n\n/**\n * Check if user is within limit (throws 402 if exceeded)\n */\nexport async function checkLimit(userId: string, metric: MetricName): Promise<void> {\n    const stats = await getUsage(userId, metric);\n\n    if (stats.current >= stats.limit) {\n        throw new Error(`Usage limit exceeded for ${metric}`, {\n            cause: { code: 402, metric, stats },\n        });\n    }\n}\n\n/**\n * Get current usage statistics\n */\nexport async function getUsage(userId: string, metric: MetricName): Promise<UsageStats> {\n    const supabase = getSupabaseClient();\n\n    const { data, error } = await supabase\n        .from('usage_metrics')\n        .select('*')\n        .eq('user_id', userId)\n        .eq('metric', metric)\n        .single();\n\n    if (error || !data) {\n        return { current: 0, limit: 100, percentage: 0, remaining: 100 };\n    }\n\n    const current = data.current_usage;\n    const limit = data.limit_value;\n    const percentage = (current / limit) * 100;\n    const remaining = Math.max(0, limit - current);\n\n    return { current, limit, percentage, remaining };\n}\n\n/**\n * Reset usage counter\n */\nexport async function resetUsage(userId: string, metric: MetricName): Promise<void> {\n    const supabase = getSupabaseClient();\n\n    const { error } = await supabase\n        .from('usage_metrics')\n        .update({ current_usage: 0, reset_at: getNextResetDate('monthly') })\n        .eq('user_id', userId)\n        .eq('metric', metric);\n\n    if (error) throw new Error(`Failed to reset usage: ${error.message}`);\n}\n\n/**\n * Set user's limit\n */\nexport async function setLimit(userId: string, metric: MetricName, limit: number): Promise<void> {\n    const supabase = getSupabaseClient();\n\n    const { error } = await supabase\n        .from('usage_metrics')\n        .update({ limit_value: limit })\n        .eq('user_id', userId)\n        .eq('metric', metric);\n\n    if (error) throw new Error(`Failed to set limit: ${error.message}`);\n}\n\n/**\n * Get next reset date based on period\n */\nfunction getNextResetDate(period: 'daily' | 'weekly' | 'monthly'): string {\n    const date = new Date();\n\n    switch (period) {\n        case 'daily':\n            date.setDate(date.getDate() + 1);\n            break;\n        case 'weekly':\n            date.setDate(date.getDate() + 7);\n            break;\n        case 'monthly':\n            date.setMonth(date.getMonth() + 1);\n            break;\n    }\n\n    return date.toISOString();\n}\n","/**\n * @vocoweb/meter\n * Production-ready usage tracking and limits\n */\n\n// Types\nexport * from './types';\n\n// Server-side\nexport * from './server';\n\n// Import for unified API\nimport * as serverMeter from './server';\n\n/**\n * Main meter API\n */\nexport const meter = {\n    increment: serverMeter.increment,\n    checkLimit: serverMeter.checkLimit,\n    getUsage: serverMeter.getUsage,\n    resetUsage: serverMeter.resetUsage,\n    setLimit: serverMeter.setLimit,\n};\n\n// Version\nexport const VERSION = '1.0.0';\n"]}

package/dist/index.mjs

@@ -0,0 +1,88 @@
+import { createClient } from '@supabase/supabase-js';
+
+// src/server.ts
+var getSupabaseClient = () => {
+  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
+  const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
+  if (!supabaseUrl || !supabaseKey) {
+    throw new Error("Supabase credentials not configured");
+  }
+  return createClient(supabaseUrl, supabaseKey);
+};
+async function increment(userId, metric, amount = 1) {
+  const supabase = getSupabaseClient();
+  const { data: existing } = await supabase.from("usage_metrics").select("*").eq("user_id", userId).eq("metric", metric).single();
+  if (existing) {
+    const { error } = await supabase.from("usage_metrics").update({ current_usage: existing.current_usage + amount }).eq("id", existing.id);
+    if (error) throw new Error(`Failed to increment usage: ${error.message}`);
+  } else {
+    const { error } = await supabase.from("usage_metrics").insert({
+      user_id: userId,
+      metric,
+      current_usage: amount,
+      limit_value: 100,
+      // Default limit
+      reset_at: getNextResetDate("monthly")
+    });
+    if (error) throw new Error(`Failed to create metric: ${error.message}`);
+  }
+}
+async function checkLimit(userId, metric) {
+  const stats = await getUsage(userId, metric);
+  if (stats.current >= stats.limit) {
+    throw new Error(`Usage limit exceeded for ${metric}`, {
+      cause: { code: 402, metric, stats }
+    });
+  }
+}
+async function getUsage(userId, metric) {
+  const supabase = getSupabaseClient();
+  const { data, error } = await supabase.from("usage_metrics").select("*").eq("user_id", userId).eq("metric", metric).single();
+  if (error || !data) {
+    return { current: 0, limit: 100, percentage: 0, remaining: 100 };
+  }
+  const current = data.current_usage;
+  const limit = data.limit_value;
+  const percentage = current / limit * 100;
+  const remaining = Math.max(0, limit - current);
+  return { current, limit, percentage, remaining };
+}
+async function resetUsage(userId, metric) {
+  const supabase = getSupabaseClient();
+  const { error } = await supabase.from("usage_metrics").update({ current_usage: 0, reset_at: getNextResetDate("monthly") }).eq("user_id", userId).eq("metric", metric);
+  if (error) throw new Error(`Failed to reset usage: ${error.message}`);
+}
+async function setLimit(userId, metric, limit) {
+  const supabase = getSupabaseClient();
+  const { error } = await supabase.from("usage_metrics").update({ limit_value: limit }).eq("user_id", userId).eq("metric", metric);
+  if (error) throw new Error(`Failed to set limit: ${error.message}`);
+}
+function getNextResetDate(period) {
+  const date = /* @__PURE__ */ new Date();
+  switch (period) {
+    case "daily":
+      date.setDate(date.getDate() + 1);
+      break;
+    case "weekly":
+      date.setDate(date.getDate() + 7);
+      break;
+    case "monthly":
+      date.setMonth(date.getMonth() + 1);
+      break;
+  }
+  return date.toISOString();
+}
+
+// src/index.ts
+var meter = {
+  increment,
+  checkLimit,
+  getUsage,
+  resetUsage,
+  setLimit
+};
+var VERSION = "1.0.0";
+
+export { VERSION, checkLimit, getUsage, increment, meter, resetUsage, setLimit };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/index.ts"],"names":[],"mappings":";;;AAOA,IAAM,oBAAoB,MAAM;AAC5B,EAAA,MAAM,WAAA,GAAc,QAAQ,GAAA,CAAI,wBAAA;AAChC,EAAA,MAAM,WAAA,GAAc,QAAQ,GAAA,CAAI,yBAAA;AAEhC,EAAA,IAAI,CAAC,WAAA,IAAe,CAAC,WAAA,EAAa;AAC9B,IAAA,MAAM,IAAI,MAAM,qCAAqC,CAAA;AAAA,EACzD;AAEA,EAAA,OAAO,YAAA,CAAa,aAAa,WAAW,CAAA;AAChD,CAAA;AAKA,eAAsB,SAAA,CAAU,MAAA,EAAgB,MAAA,EAAoB,MAAA,GAAiB,CAAA,EAAkB;AACnG,EAAA,MAAM,WAAW,iBAAA,EAAkB;AAGnC,EAAA,MAAM,EAAE,MAAM,QAAA,EAAS,GAAI,MAAM,QAAA,CAC5B,IAAA,CAAK,eAAe,CAAA,CACpB,MAAA,CAAO,GAAG,CAAA,CACV,EAAA,CAAG,WAAW,MAAM,CAAA,CACpB,GAAG,QAAA,EAAU,MAAM,EACnB,MAAA,EAAO;AAEZ,EAAA,IAAI,QAAA,EAAU;AACV,IAAA,MAAM,EAAE,KAAA,EAAM,GAAI,MAAM,QAAA,CACnB,IAAA,CAAK,eAAe,CAAA,CACpB,MAAA,CAAO,EAAE,aAAA,EAAe,QAAA,CAAS,gBAAgB,MAAA,EAAQ,EACzD,EAAA,CAAG,IAAA,EAAM,SAAS,EAAE,CAAA;AAEzB,IAAA,IAAI,OAAO,MAAM,IAAI,MAAM,CAAA,2BAAA,EAA8B,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,EAC5E,CAAA,MAAO;AAEH,IAAA,MAAM,EAAE,OAAM,GAAI,MAAM,SACnB,IAAA,CAAK,eAAe,EACpB,MAAA,CAAO;AAAA,MACJ,OAAA,EAAS,MAAA;AAAA,MACT,MAAA;AAAA,MACA,aAAA,EAAe,MAAA;AAAA,MACf,WAAA,EAAa,GAAA;AAAA;AAAA,MACb,QAAA,EAAU,iBAAiB,SAAS;AAAA,KACvC,CAAA;AAEL,IAAA,IAAI,OAAO,MAAM,IAAI,MAAM,CAAA,yBAAA,EAA4B,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,EAC1E;AACJ;AAKA,eAAsB,UAAA,CAAW,QAAgB,MAAA,EAAmC;AAChF,EAAA,MAAM,KAAA,GAAQ,MAAM,QAAA,CAAS,MAAA,EAAQ,MAAM,CAAA;AAE3C,EAAA,IAAI,KAAA,CAAM,OAAA,IAAW,KAAA,CAAM,KAAA,EAAO;AAC9B,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,yBAAA,EAA4B,MAAM,CAAA,CAAA,EAAI;AAAA,MAClD,KAAA,EAAO,EAAE,IAAA,EAAM,GAAA,EAAK,QAAQ,KAAA;AAAM,KACrC,CAAA;AAAA,EACL;AACJ;AAKA,eAAsB,QAAA,CAAS,QAAgB,MAAA,EAAyC;AACpF,EAAA,MAAM,WAAW,iBAAA,EAAkB;AAEnC,EAAA,MAAM,EAAE,MAAM,KAAA,EAAM,GAAI,MAAM,QAAA,CACzB,IAAA,CAAK,eAAe,CAAA,CACpB,MAAA,CAAO,GAAG,CAAA,CACV,EAAA,CAAG,WAAW,MAAM,CAAA,CACpB,GAAG,QAAA,EAAU,MAAM,EACnB,MAAA,EAAO;AAEZ,EAAA,IAAI,KAAA,IAAS,CAAC,IAAA,EAAM;AAChB,IAAA,OAAO,EAAE,SAAS,CAAA,EAAG,KAAA,EAAO,KAAK,UAAA,EAAY,CAAA,EAAG,WAAW,GAAA,EAAI;AAAA,EACnE;AAEA,EAAA,MAAM,UAAU,IAAA,CAAK,aAAA;AACrB,EAAA,MAAM,QAAQ,IAAA,CAAK,WAAA;AACnB,EAAA,MAAM,UAAA,GAAc,UAAU,KAAA,GAAS,GAAA;AACvC,EAAA,MAAM,SAAA,GAAY,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,QAAQ,OAAO,CAAA;AAE7C,EAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,UAAA,EAAY,SAAA,EAAU;AACnD;AAKA,eAAsB,UAAA,CAAW,QAAgB,MAAA,EAAmC;AAChF,EAAA,MAAM,WAAW,iBAAA,EAAkB;AAEnC,EAAA,MAAM,EAAE,KAAA,EAAM,GAAI,MAAM,QAAA,CACnB,KAAK,eAAe,CAAA,CACpB,MAAA,CAAO,EAAE,aAAA,EAAe,CAAA,EAAG,UAAU,gBAAA,CAAiB,SAAS,CAAA,EAAG,CAAA,CAClE,EAAA,CAAG,WAAW,MAAM,CAAA,CACpB,EAAA,CAAG,QAAA,EAAU,MAAM,CAAA;AAExB,EAAA,IAAI,OAAO,MAAM,IAAI,MAAM,CAAA,uBAAA,EAA0B,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AACxE;AAKA,eAAsB,QAAA,CAAS,MAAA,EAAgB,MAAA,EAAoB,KAAA,EAA8B;AAC7F,EAAA,MAAM,WAAW,iBAAA,EAAkB;AAEnC,EAAA,MAAM,EAAE,OAAM,GAAI,MAAM,SACnB,IAAA,CAAK,eAAe,EACpB,MAAA,CAAO,EAAE,aAAa,KAAA,EAAO,EAC7B,EAAA,CAAG,SAAA,EAAW,MAAM,CAAA,CACpB,EAAA,CAAG,UAAU,MAAM,CAAA;AAExB,EAAA,IAAI,OAAO,MAAM,IAAI,MAAM,CAAA,qBAAA,EAAwB,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AACtE;AAKA,SAAS,iBAAiB,MAAA,EAAgD;AACtE,EAAA,MAAM,IAAA,uBAAW,IAAA,EAAK;AAEtB,EAAA,QAAQ,MAAA;AAAQ,IACZ,KAAK,OAAA;AACD,MAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,OAAA,EAAQ,GAAI,CAAC,CAAA;AAC/B,MAAA;AAAA,IACJ,KAAK,QAAA;AACD,MAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,OAAA,EAAQ,GAAI,CAAC,CAAA;AAC/B,MAAA;AAAA,IACJ,KAAK,SAAA;AACD,MAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,QAAA,EAAS,GAAI,CAAC,CAAA;AACjC,MAAA;AAAA;AAGR,EAAA,OAAO,KAAK,WAAA,EAAY;AAC5B;;;AC7HO,IAAM,KAAA,GAAQ;AAAA,EACjB,SAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA,UAAA;AAAA,EACA;AACJ;AAGO,IAAM,OAAA,GAAU","file":"index.mjs","sourcesContent":["/**\n * Server-side functions for @vocoweb/meter\n */\n\nimport { createClient } from '@supabase/supabase-js';\nimport type { MetricName, UsageStats } from './types';\n\nconst getSupabaseClient = () => {\n    const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;\n    const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;\n\n    if (!supabaseUrl || !supabaseKey) {\n        throw new Error('Supabase credentials not configured');\n    }\n\n    return createClient(supabaseUrl, supabaseKey);\n};\n\n/**\n * Increment usage counter\n */\nexport async function increment(userId: string, metric: MetricName, amount: number = 1): Promise<void> {\n    const supabase = getSupabaseClient();\n\n    // Get or create metric\n    const { data: existing } = await supabase\n        .from('usage_metrics')\n        .select('*')\n        .eq('user_id', userId)\n        .eq('metric', metric)\n        .single();\n\n    if (existing) {\n        const { error } = await supabase\n            .from('usage_metrics')\n            .update({ current_usage: existing.current_usage + amount })\n            .eq('id', existing.id);\n\n        if (error) throw new Error(`Failed to increment usage: ${error.message}`);\n    } else {\n        // Create new metric with default limit\n        const { error } = await supabase\n            .from('usage_metrics')\n            .insert({\n                user_id: userId,\n                metric,\n                current_usage: amount,\n                limit_value: 100, // Default limit\n                reset_at: getNextResetDate('monthly'),\n            });\n\n        if (error) throw new Error(`Failed to create metric: ${error.message}`);\n    }\n}\n\n/**\n * Check if user is within limit (throws 402 if exceeded)\n */\nexport async function checkLimit(userId: string, metric: MetricName): Promise<void> {\n    const stats = await getUsage(userId, metric);\n\n    if (stats.current >= stats.limit) {\n        throw new Error(`Usage limit exceeded for ${metric}`, {\n            cause: { code: 402, metric, stats },\n        });\n    }\n}\n\n/**\n * Get current usage statistics\n */\nexport async function getUsage(userId: string, metric: MetricName): Promise<UsageStats> {\n    const supabase = getSupabaseClient();\n\n    const { data, error } = await supabase\n        .from('usage_metrics')\n        .select('*')\n        .eq('user_id', userId)\n        .eq('metric', metric)\n        .single();\n\n    if (error || !data) {\n        return { current: 0, limit: 100, percentage: 0, remaining: 100 };\n    }\n\n    const current = data.current_usage;\n    const limit = data.limit_value;\n    const percentage = (current / limit) * 100;\n    const remaining = Math.max(0, limit - current);\n\n    return { current, limit, percentage, remaining };\n}\n\n/**\n * Reset usage counter\n */\nexport async function resetUsage(userId: string, metric: MetricName): Promise<void> {\n    const supabase = getSupabaseClient();\n\n    const { error } = await supabase\n        .from('usage_metrics')\n        .update({ current_usage: 0, reset_at: getNextResetDate('monthly') })\n        .eq('user_id', userId)\n        .eq('metric', metric);\n\n    if (error) throw new Error(`Failed to reset usage: ${error.message}`);\n}\n\n/**\n * Set user's limit\n */\nexport async function setLimit(userId: string, metric: MetricName, limit: number): Promise<void> {\n    const supabase = getSupabaseClient();\n\n    const { error } = await supabase\n        .from('usage_metrics')\n        .update({ limit_value: limit })\n        .eq('user_id', userId)\n        .eq('metric', metric);\n\n    if (error) throw new Error(`Failed to set limit: ${error.message}`);\n}\n\n/**\n * Get next reset date based on period\n */\nfunction getNextResetDate(period: 'daily' | 'weekly' | 'monthly'): string {\n    const date = new Date();\n\n    switch (period) {\n        case 'daily':\n            date.setDate(date.getDate() + 1);\n            break;\n        case 'weekly':\n            date.setDate(date.getDate() + 7);\n            break;\n        case 'monthly':\n            date.setMonth(date.getMonth() + 1);\n            break;\n    }\n\n    return date.toISOString();\n}\n","/**\n * @vocoweb/meter\n * Production-ready usage tracking and limits\n */\n\n// Types\nexport * from './types';\n\n// Server-side\nexport * from './server';\n\n// Import for unified API\nimport * as serverMeter from './server';\n\n/**\n * Main meter API\n */\nexport const meter = {\n    increment: serverMeter.increment,\n    checkLimit: serverMeter.checkLimit,\n    getUsage: serverMeter.getUsage,\n    resetUsage: serverMeter.resetUsage,\n    setLimit: serverMeter.setLimit,\n};\n\n// Version\nexport const VERSION = '1.0.0';\n"]}

package/dist/react.d.mts

@@ -0,0 +1,15 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * VocoUsageBar Component
+ * Usage progress bar
+ */
+interface VocoUsageBarProps {
+    metric: string;
+    label?: string;
+    color?: 'blue' | 'green' | 'red' | 'purple';
+    className?: string;
+}
+declare function VocoUsageBar({ metric, label, color, className, }: VocoUsageBarProps): react_jsx_runtime.JSX.Element;
+
+export { VocoUsageBar };

package/dist/react.d.ts

@@ -0,0 +1,15 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * VocoUsageBar Component
+ * Usage progress bar
+ */
+interface VocoUsageBarProps {
+    metric: string;
+    label?: string;
+    color?: 'blue' | 'green' | 'red' | 'purple';
+    className?: string;
+}
+declare function VocoUsageBar({ metric, label, color, className, }: VocoUsageBarProps): react_jsx_runtime.JSX.Element;
+
+export { VocoUsageBar };

package/dist/react.js

@@ -0,0 +1,79 @@
+'use strict';
+
+var React = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/components/VocoUsageBar.tsx
+function VocoUsageBar({
+  metric,
+  label,
+  color = "blue",
+  className = ""
+}) {
+  const [usage, setUsage] = React__namespace.useState({ current: 0, limit: 0, percentage: 0 });
+  const [loading, setLoading] = React__namespace.useState(true);
+  React__namespace.useEffect(() => {
+    async function fetchUsage() {
+      try {
+        const res = await fetch(`/api/usage?metric=${metric}`);
+        const data = await res.json();
+        setUsage(data);
+      } catch (error) {
+        console.error("Failed to fetch usage:", error);
+      } finally {
+        setLoading(false);
+      }
+    }
+    fetchUsage();
+  }, [metric]);
+  if (loading) {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "h-4 w-full animate-pulse rounded bg-gray-200" });
+  }
+  const colors = {
+    blue: "bg-blue-600",
+    green: "bg-green-600",
+    red: "bg-red-600",
+    purple: "bg-purple-600"
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `space-y-2 ${className}`, children: [
+    label && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between text-sm", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-medium", children: label }),
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-gray-600", children: [
+        usage.current,
+        " / ",
+        usage.limit
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "h-2 w-full overflow-hidden rounded-full bg-gray-200", children: /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        className: `h-full transition-all ${colors[color]}`,
+        style: { width: `${Math.min(usage.percentage, 100)}%` }
+      }
+    ) })
+  ] });
+}
+
+exports.VocoUsageBar = VocoUsageBar;
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/VocoUsageBar.tsx"],"names":["React","jsx","jsxs"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAgBO,SAAS,YAAA,CAAa;AAAA,EACzB,MAAA;AAAA,EACA,KAAA;AAAA,EACA,KAAA,GAAQ,MAAA;AAAA,EACR,SAAA,GAAY;AAChB,CAAA,EAAsB;AAClB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAUA,gBAAA,CAAA,QAAA,CAAS,EAAE,OAAA,EAAS,CAAA,EAAG,KAAA,EAAO,CAAA,EAAG,UAAA,EAAY,CAAA,EAAG,CAAA;AAChF,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAUA,0BAAS,IAAI,CAAA;AAEjD,EAAMA,2BAAU,MAAM;AAClB,IAAA,eAAe,UAAA,GAAa;AACxB,MAAA,IAAI;AACA,QAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,kBAAA,EAAqB,MAAM,CAAA,CAAE,CAAA;AACrD,QAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,QAAA,QAAA,CAAS,IAAI,CAAA;AAAA,MACjB,SAAS,KAAA,EAAO;AACZ,QAAA,OAAA,CAAQ,KAAA,CAAM,0BAA0B,KAAK,CAAA;AAAA,MACjD,CAAA,SAAE;AACE,QAAA,UAAA,CAAW,KAAK,CAAA;AAAA,MACpB;AAAA,IACJ;AAEA,IAAA,UAAA,EAAW;AAAA,EACf,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,IAAI,OAAA,EAAS;AACT,IAAA,uBAAOC,cAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,8CAAA,EAA+C,CAAA;AAAA,EACzE;AAEA,EAAA,MAAM,MAAA,GAAS;AAAA,IACX,IAAA,EAAM,aAAA;AAAA,IACN,KAAA,EAAO,cAAA;AAAA,IACP,GAAA,EAAK,YAAA;AAAA,IACL,MAAA,EAAQ;AAAA,GACZ;AAEA,EAAA,uBACIC,eAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAW,CAAA,UAAA,EAAa,SAAS,CAAA,CAAA,EACjC,QAAA,EAAA;AAAA,IAAA,KAAA,oBACGA,eAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,2CAAA,EACX,QAAA,EAAA;AAAA,sBAAAD,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,aAAA,EAAe,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,sBACrCC,eAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,eAAA,EACX,QAAA,EAAA;AAAA,QAAA,KAAA,CAAM,OAAA;AAAA,QAAQ,KAAA;AAAA,QAAI,KAAA,CAAM;AAAA,OAAA,EAC7B;AAAA,KAAA,EACJ,CAAA;AAAA,oBAEJD,cAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,qDAAA,EACX,QAAA,kBAAAA,cAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACG,SAAA,EAAW,CAAA,sBAAA,EAAyB,MAAA,CAAO,KAAK,CAAC,CAAA,CAAA;AAAA,QACjD,KAAA,EAAO,EAAE,KAAA,EAAO,CAAA,EAAG,IAAA,CAAK,IAAI,KAAA,CAAM,UAAA,EAAY,GAAG,CAAC,CAAA,CAAA,CAAA;AAAI;AAAA,KAC1D,EACJ;AAAA,GAAA,EACJ,CAAA;AAER","file":"react.js","sourcesContent":["/**\n * VocoUsageBar Component\n * Usage progress bar\n */\n\n'use client';\n\nimport * as React from 'react';\n\nexport interface VocoUsageBarProps {\n    metric: string;\n    label?: string;\n    color?: 'blue' | 'green' | 'red' | 'purple';\n    className?: string;\n}\n\nexport function VocoUsageBar({\n    metric,\n    label,\n    color = 'blue',\n    className = '',\n}: VocoUsageBarProps) {\n    const [usage, setUsage] = React.useState({ current: 0, limit: 0, percentage: 0 });\n    const [loading, setLoading] = React.useState(true);\n\n    React.useEffect(() => {\n        async function fetchUsage() {\n            try {\n                const res = await fetch(`/api/usage?metric=${metric}`);\n                const data = await res.json();\n                setUsage(data);\n            } catch (error) {\n                console.error('Failed to fetch usage:', error);\n            } finally {\n                setLoading(false);\n            }\n        }\n\n        fetchUsage();\n    }, [metric]);\n\n    if (loading) {\n        return <div className=\"h-4 w-full animate-pulse rounded bg-gray-200\" />;\n    }\n\n    const colors = {\n        blue: 'bg-blue-600',\n        green: 'bg-green-600',\n        red: 'bg-red-600',\n        purple: 'bg-purple-600',\n    };\n\n    return (\n        <div className={`space-y-2 ${className}`}>\n            {label && (\n                <div className=\"flex items-center justify-between text-sm\">\n                    <span className=\"font-medium\">{label}</span>\n                    <span className=\"text-gray-600\">\n                        {usage.current} / {usage.limit}\n                    </span>\n                </div>\n            )}\n            <div className=\"h-2 w-full overflow-hidden rounded-full bg-gray-200\">\n                <div\n                    className={`h-full transition-all ${colors[color]}`}\n                    style={{ width: `${Math.min(usage.percentage, 100)}%` }}\n                />\n            </div>\n        </div>\n    );\n}\n"]}

package/dist/react.mjs

@@ -0,0 +1,57 @@
+import * as React from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/components/VocoUsageBar.tsx
+function VocoUsageBar({
+  metric,
+  label,
+  color = "blue",
+  className = ""
+}) {
+  const [usage, setUsage] = React.useState({ current: 0, limit: 0, percentage: 0 });
+  const [loading, setLoading] = React.useState(true);
+  React.useEffect(() => {
+    async function fetchUsage() {
+      try {
+        const res = await fetch(`/api/usage?metric=${metric}`);
+        const data = await res.json();
+        setUsage(data);
+      } catch (error) {
+        console.error("Failed to fetch usage:", error);
+      } finally {
+        setLoading(false);
+      }
+    }
+    fetchUsage();
+  }, [metric]);
+  if (loading) {
+    return /* @__PURE__ */ jsx("div", { className: "h-4 w-full animate-pulse rounded bg-gray-200" });
+  }
+  const colors = {
+    blue: "bg-blue-600",
+    green: "bg-green-600",
+    red: "bg-red-600",
+    purple: "bg-purple-600"
+  };
+  return /* @__PURE__ */ jsxs("div", { className: `space-y-2 ${className}`, children: [
+    label && /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between text-sm", children: [
+      /* @__PURE__ */ jsx("span", { className: "font-medium", children: label }),
+      /* @__PURE__ */ jsxs("span", { className: "text-gray-600", children: [
+        usage.current,
+        " / ",
+        usage.limit
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "h-2 w-full overflow-hidden rounded-full bg-gray-200", children: /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: `h-full transition-all ${colors[color]}`,
+        style: { width: `${Math.min(usage.percentage, 100)}%` }
+      }
+    ) })
+  ] });
+}
+
+export { VocoUsageBar };
+//# sourceMappingURL=react.mjs.map
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/VocoUsageBar.tsx"],"names":[],"mappings":";;;;AAgBO,SAAS,YAAA,CAAa;AAAA,EACzB,MAAA;AAAA,EACA,KAAA;AAAA,EACA,KAAA,GAAQ,MAAA;AAAA,EACR,SAAA,GAAY;AAChB,CAAA,EAAsB;AAClB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAU,KAAA,CAAA,QAAA,CAAS,EAAE,OAAA,EAAS,CAAA,EAAG,KAAA,EAAO,CAAA,EAAG,UAAA,EAAY,CAAA,EAAG,CAAA;AAChF,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAU,eAAS,IAAI,CAAA;AAEjD,EAAM,gBAAU,MAAM;AAClB,IAAA,eAAe,UAAA,GAAa;AACxB,MAAA,IAAI;AACA,QAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,kBAAA,EAAqB,MAAM,CAAA,CAAE,CAAA;AACrD,QAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,QAAA,QAAA,CAAS,IAAI,CAAA;AAAA,MACjB,SAAS,KAAA,EAAO;AACZ,QAAA,OAAA,CAAQ,KAAA,CAAM,0BAA0B,KAAK,CAAA;AAAA,MACjD,CAAA,SAAE;AACE,QAAA,UAAA,CAAW,KAAK,CAAA;AAAA,MACpB;AAAA,IACJ;AAEA,IAAA,UAAA,EAAW;AAAA,EACf,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,IAAI,OAAA,EAAS;AACT,IAAA,uBAAO,GAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,8CAAA,EAA+C,CAAA;AAAA,EACzE;AAEA,EAAA,MAAM,MAAA,GAAS;AAAA,IACX,IAAA,EAAM,aAAA;AAAA,IACN,KAAA,EAAO,cAAA;AAAA,IACP,GAAA,EAAK,YAAA;AAAA,IACL,MAAA,EAAQ;AAAA,GACZ;AAEA,EAAA,uBACI,IAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAW,CAAA,UAAA,EAAa,SAAS,CAAA,CAAA,EACjC,QAAA,EAAA;AAAA,IAAA,KAAA,oBACG,IAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,2CAAA,EACX,QAAA,EAAA;AAAA,sBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,aAAA,EAAe,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,sBACrC,IAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,eAAA,EACX,QAAA,EAAA;AAAA,QAAA,KAAA,CAAM,OAAA;AAAA,QAAQ,KAAA;AAAA,QAAI,KAAA,CAAM;AAAA,OAAA,EAC7B;AAAA,KAAA,EACJ,CAAA;AAAA,oBAEJ,GAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,qDAAA,EACX,QAAA,kBAAA,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACG,SAAA,EAAW,CAAA,sBAAA,EAAyB,MAAA,CAAO,KAAK,CAAC,CAAA,CAAA;AAAA,QACjD,KAAA,EAAO,EAAE,KAAA,EAAO,CAAA,EAAG,IAAA,CAAK,IAAI,KAAA,CAAM,UAAA,EAAY,GAAG,CAAC,CAAA,CAAA,CAAA;AAAI;AAAA,KAC1D,EACJ;AAAA,GAAA,EACJ,CAAA;AAER","file":"react.mjs","sourcesContent":["/**\n * VocoUsageBar Component\n * Usage progress bar\n */\n\n'use client';\n\nimport * as React from 'react';\n\nexport interface VocoUsageBarProps {\n    metric: string;\n    label?: string;\n    color?: 'blue' | 'green' | 'red' | 'purple';\n    className?: string;\n}\n\nexport function VocoUsageBar({\n    metric,\n    label,\n    color = 'blue',\n    className = '',\n}: VocoUsageBarProps) {\n    const [usage, setUsage] = React.useState({ current: 0, limit: 0, percentage: 0 });\n    const [loading, setLoading] = React.useState(true);\n\n    React.useEffect(() => {\n        async function fetchUsage() {\n            try {\n                const res = await fetch(`/api/usage?metric=${metric}`);\n                const data = await res.json();\n                setUsage(data);\n            } catch (error) {\n                console.error('Failed to fetch usage:', error);\n            } finally {\n                setLoading(false);\n            }\n        }\n\n        fetchUsage();\n    }, [metric]);\n\n    if (loading) {\n        return <div className=\"h-4 w-full animate-pulse rounded bg-gray-200\" />;\n    }\n\n    const colors = {\n        blue: 'bg-blue-600',\n        green: 'bg-green-600',\n        red: 'bg-red-600',\n        purple: 'bg-purple-600',\n    };\n\n    return (\n        <div className={`space-y-2 ${className}`}>\n            {label && (\n                <div className=\"flex items-center justify-between text-sm\">\n                    <span className=\"font-medium\">{label}</span>\n                    <span className=\"text-gray-600\">\n                        {usage.current} / {usage.limit}\n                    </span>\n                </div>\n            )}\n            <div className=\"h-2 w-full overflow-hidden rounded-full bg-gray-200\">\n                <div\n                    className={`h-full transition-all ${colors[color]}`}\n                    style={{ width: `${Math.min(usage.percentage, 100)}%` }}\n                />\n            </div>\n        </div>\n    );\n}\n"]}

package/package.json

@@ -0,0 +1,80 @@
+{
+    "name": "@vocoweb/meter",
+    "version": "1.0.0",
+    "description": "Production-ready usage tracking and limits for B2B SaaS",
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        },
+        "./react": {
+            "import": "./dist/react.mjs",
+            "types": "./dist/react.d.ts"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "test": "vitest",
+        "lint": "eslint src",
+        "type-check": "tsc --noEmit",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "usage-tracking",
+        "metering",
+        "limits",
+        "quotas",
+        "usage-based-pricing",
+        "saas"
+    ],
+    "author": "VocoWeb <legal@vocoweb.in>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/vocoweb/vocoweb-meter.git"
+    },
+    "homepage": "https://github.com/vocoweb/vocoweb-meter#readme",
+    "peerDependencies": {
+        "next": ">=14.0.0",
+        "react": ">=18.0.0",
+        "react-dom": ">=18.0.0"
+    },
+    "peerDependenciesMeta": {
+        "next": {
+            "optional": true
+        }
+    },
+    "dependencies": {
+        "@supabase/supabase-js": "^2.39.0",
+        "class-variance-authority": "^0.7.0",
+        "clsx": "^2.1.0",
+        "lucide-react": "^0.468.0",
+        "tailwind-merge": "^2.2.0",
+        "zod": "^3.22.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.0",
+        "@types/react": "^18.2.0",
+        "@types/react-dom": "^18.2.0",
+        "eslint": "^8.56.0",
+        "tsup": "^8.0.0",
+        "typescript": "^5.3.0",
+        "vitest": "^1.2.0"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}