mengram-ai 2.14.5 → 2.15.0

package/index.d.ts

@@ -155,11 +155,28 @@ export interface Webhook {
   last_error: string | null;
 }
 
+export interface BillingInfo {
+  plan: 'free' | 'pro' | 'business';
+  status: string;
+  current_period_end: string | null;
+  usage: Record<string, number>;
+  quotas: Record<string, number>;
+  rate_limit: number;
+}
+
 export declare class MengramError extends Error {
   statusCode: number;
   constructor(message: string, statusCode: number);
 }
 
+export declare class QuotaExceededError extends MengramError {
+  action: string;
+  limit: number;
+  current: number;
+  plan: string;
+  constructor(detail: { action: string; limit: number; current: number; plan: string });
+}
+
 export declare class MengramClient {
   constructor(apiKey: string, options?: MengramOptions);
 
@@ -241,6 +258,11 @@ export declare class MengramClient {
   dismissTrigger(triggerId: number): Promise<{ status: string; id: number }>;
   detectTriggers(userId: string, options?: { userId?: string }): Promise<any>;
 
+  // Billing
+  getBilling(): Promise<BillingInfo>;
+  createCheckout(plan: 'pro' | 'business'): Promise<{ checkout_url: string; transaction_id: string }>;
+  createPortal(): Promise<{ portal_url: string }>;
+
   // Import (v2.9)
   importChatgpt(zipPath: string, options?: { chunkSize?: number; onProgress?: (current: number, total: number, title: string) => void }): Promise<ImportResult>;
   importObsidian(vaultPath: string, options?: { chunkChars?: number; onProgress?: (current: number, total: number, title: string) => void }): Promise<ImportResult>;

package/index.js

@@ -66,12 +66,16 @@ class MengramClient {
             await new Promise(r => setTimeout(r, 1000 * (attempt + 1)));
             continue;
           }
+          // Quota exceeded — structured error
+          if (res.status === 402 && data.detail && typeof data.detail === 'object') {
+            throw new QuotaExceededError(data.detail);
+          }
           throw new MengramError(data.detail || `HTTP ${res.status}`, res.status);
         }
         return data;
       } catch (err) {
         if (err instanceof MengramError) {
-          if ([429, 502, 503, 504].includes(err.status) && attempt < 2) {
+          if ([429, 502, 503, 504].includes(err.statusCode) && attempt < 2) {
             lastErr = err;
             await new Promise(r => setTimeout(r, 1000 * (attempt + 1)));
             continue;
@@ -864,6 +868,33 @@ class MengramClient {
     return this._request('POST', `/v1/triggers/detect/${userId}`, null, params);
   }
 
+  // ---- Billing ----
+
+  /**
+   * Get current subscription plan, usage, and quotas.
+   * @returns {Promise<{plan: string, status: string, usage: object, quotas: object, rate_limit: number}>}
+   */
+  async getBilling() {
+    return this._request('GET', '/v1/billing');
+  }
+
+  /**
+   * Create Paddle checkout session for plan upgrade.
+   * @param {string} plan - 'pro' or 'business'
+   * @returns {Promise<{checkout_url: string, transaction_id: string}>}
+   */
+  async createCheckout(plan) {
+    return this._request('POST', '/v1/billing/checkout', null, { plan });
+  }
+
+  /**
+   * Create Paddle customer portal session for managing subscription.
+   * @returns {Promise<{portal_url: string}>}
+   */
+  async createPortal() {
+    return this._request('POST', '/v1/billing/portal');
+  }
+
   // ---- Import ----
 
   /**
@@ -1152,6 +1183,24 @@ class MengramError extends Error {
   }
 }
 
+class QuotaExceededError extends MengramError {
+  constructor(detail) {
+    const action = detail.action || 'unknown';
+    const limit = detail.limit || 0;
+    const current = detail.used || 0;
+    const plan = detail.plan || 'free';
+    super(
+      `Quota exceeded for '${action}': ${current}/${limit} (plan: ${plan}). Upgrade at https://mengram.io/dashboard`,
+      402
+    );
+    this.name = 'QuotaExceededError';
+    this.action = action;
+    this.limit = limit;
+    this.current = current;
+    this.plan = plan;
+  }
+}
+
 // Export for both CommonJS and ESM
-module.exports = { MengramClient, MengramError };
+module.exports = { MengramClient, MengramError, QuotaExceededError };
 module.exports.default = MengramClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mengram-ai",
-  "version": "2.14.5",
+  "version": "2.15.0",
   "description": "Human-like memory for AI — semantic, episodic & procedural memory. Experience-driven procedures, Cognitive Profile, unified search, memory agents. Free Mem0 alternative.",
   "main": "index.js",
   "types": "index.d.ts",