veryfront 0.0.49 → 0.0.51

package/dist/integrations/stripe/connector.json

@@ -0,0 +1,97 @@
+{
+  "name": "stripe",
+  "displayName": "Stripe",
+  "icon": "stripe.svg",
+  "description": "Access Stripe payment data, customers, subscriptions, and balance information",
+  "auth": {
+    "type": "api-key",
+    "keyName": "STRIPE_SECRET_KEY",
+    "headerName": "Authorization",
+    "headerPrefix": "Bearer",
+    "requiredApis": [
+      {
+        "name": "Stripe API",
+        "enableUrl": "https://dashboard.stripe.com/apikeys"
+      }
+    ]
+  },
+  "envVars": [
+    {
+      "name": "STRIPE_SECRET_KEY",
+      "description": "Stripe Secret Key (starts with sk_)",
+      "required": true,
+      "sensitive": true,
+      "docsUrl": "https://dashboard.stripe.com/apikeys"
+    },
+    {
+      "name": "STRIPE_WEBHOOK_SECRET",
+      "description": "Stripe Webhook Secret (optional, for webhook verification)",
+      "required": false,
+      "sensitive": true,
+      "docsUrl": "https://dashboard.stripe.com/webhooks"
+    }
+  ],
+  "tools": [
+    {
+      "id": "list-customers",
+      "name": "List Customers",
+      "description": "List Stripe customers with optional filtering",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-customer",
+      "name": "Get Customer",
+      "description": "Retrieve detailed information about a specific customer",
+      "requiresWrite": false
+    },
+    {
+      "id": "list-payments",
+      "name": "List Payments",
+      "description": "List payment intents with optional status filtering",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-balance",
+      "name": "Get Balance",
+      "description": "Retrieve the current account balance",
+      "requiresWrite": false
+    },
+    {
+      "id": "list-subscriptions",
+      "name": "List Subscriptions",
+      "description": "List subscriptions with optional status filtering",
+      "requiresWrite": false
+    }
+  ],
+  "prompts": [
+    {
+      "id": "check-balance",
+      "title": "Check account balance",
+      "prompt": "Check my Stripe account balance and provide a summary of available and pending funds.",
+      "category": "finance",
+      "icon": "currency"
+    },
+    {
+      "id": "recent-payments",
+      "title": "Recent payments",
+      "prompt": "Show me the most recent successful payments in my Stripe account.",
+      "category": "finance",
+      "icon": "payment"
+    },
+    {
+      "id": "customer-overview",
+      "title": "Customer overview",
+      "prompt": "Give me an overview of my Stripe customers including total count and recent additions.",
+      "category": "analytics",
+      "icon": "users"
+    },
+    {
+      "id": "subscription-status",
+      "title": "Subscription status",
+      "prompt": "Show me the status of all active subscriptions and any that are expiring soon.",
+      "category": "analytics",
+      "icon": "repeat"
+    }
+  ],
+  "suggestedWith": ["slack", "email", "analytics"]
+}

package/dist/integrations/stripe/files/_env.example

@@ -0,0 +1,6 @@
+# Stripe Integration
+# Get your API keys at https://dashboard.stripe.com/apikeys
+# Use test keys (sk_test_...) for development, live keys (sk_live_...) for production
+
+STRIPE_SECRET_KEY=sk_test_your_secret_key_here
+STRIPE_WEBHOOK_SECRET=whsec_your_webhook_secret_here

package/dist/integrations/stripe/files/ai/tools/get-balance.ts

@@ -0,0 +1,28 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { formatAmount, getBalance } from "../../lib/stripe-client.ts";
+
+export default tool({
+  id: "get-balance",
+  description: "Retrieve the current Stripe account balance including available and pending funds.",
+  inputSchema: z.object({}),
+  async execute() {
+    const balance = await getBalance();
+
+    return {
+      livemode: balance.livemode,
+      available: balance.available.map((bal) => ({
+        amount: formatAmount(bal.amount, bal.currency),
+        amountRaw: bal.amount,
+        currency: bal.currency,
+        sourceTypes: bal.source_types,
+      })),
+      pending: balance.pending.map((bal) => ({
+        amount: formatAmount(bal.amount, bal.currency),
+        amountRaw: bal.amount,
+        currency: bal.currency,
+        sourceTypes: bal.source_types,
+      })),
+    };
+  },
+});

package/dist/integrations/stripe/files/ai/tools/get-customer.ts

@@ -0,0 +1,26 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { formatDate, getCustomer } from "../../lib/stripe-client.ts";
+
+export default tool({
+  id: "get-customer",
+  description: "Retrieve detailed information about a specific Stripe customer by their ID.",
+  inputSchema: z.object({
+    customerId: z.string().describe("The Stripe customer ID (starts with cus_)"),
+  }),
+  async execute({ customerId }) {
+    const customer = await getCustomer(customerId);
+
+    return {
+      id: customer.id,
+      email: customer.email,
+      name: customer.name,
+      description: customer.description,
+      created: formatDate(customer.created),
+      balance: customer.balance,
+      currency: customer.currency,
+      defaultSource: customer.default_source,
+      metadata: customer.metadata,
+    };
+  },
+});

package/dist/integrations/stripe/files/ai/tools/list-customers.ts

@@ -0,0 +1,42 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { formatDate, listCustomers } from "../../lib/stripe-client.ts";
+
+export default tool({
+  id: "list-customers",
+  description: "List Stripe customers. Supports filtering by email and creation date range.",
+  inputSchema: z.object({
+    limit: z.number().min(1).max(100).default(10).describe(
+      "Maximum number of customers to retrieve",
+    ),
+    email: z.string().email().optional().describe("Filter by customer email address"),
+    createdAfter: z.number().optional().describe(
+      "Filter customers created after this Unix timestamp",
+    ),
+    createdBefore: z.number().optional().describe(
+      "Filter customers created before this Unix timestamp",
+    ),
+  }),
+  async execute({ limit, email, createdAfter, createdBefore }) {
+    const created: { gte?: number; lte?: number } | undefined = createdAfter || createdBefore
+      ? { gte: createdAfter, lte: createdBefore }
+      : undefined;
+
+    const customers = await listCustomers({
+      limit,
+      email,
+      created,
+    });
+
+    return customers.map((customer) => ({
+      id: customer.id,
+      email: customer.email,
+      name: customer.name,
+      description: customer.description,
+      created: formatDate(customer.created),
+      balance: customer.balance,
+      currency: customer.currency,
+      metadata: customer.metadata,
+    }));
+  },
+});

package/dist/integrations/stripe/files/ai/tools/list-payments.ts

@@ -0,0 +1,45 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { formatAmount, formatDate, listPaymentIntents } from "../../lib/stripe-client.ts";
+
+export default tool({
+  id: "list-payments",
+  description:
+    "List Stripe payment intents. Supports filtering by customer and creation date range.",
+  inputSchema: z.object({
+    limit: z.number().min(1).max(100).default(10).describe(
+      "Maximum number of payment intents to retrieve",
+    ),
+    customerId: z.string().optional().describe("Filter by customer ID (starts with cus_)"),
+    createdAfter: z.number().optional().describe(
+      "Filter payments created after this Unix timestamp",
+    ),
+    createdBefore: z.number().optional().describe(
+      "Filter payments created before this Unix timestamp",
+    ),
+  }),
+  async execute({ limit, customerId, createdAfter, createdBefore }) {
+    const created: { gte?: number; lte?: number } | undefined = createdAfter || createdBefore
+      ? { gte: createdAfter, lte: createdBefore }
+      : undefined;
+
+    const payments = await listPaymentIntents({
+      limit,
+      customer: customerId,
+      created,
+    });
+
+    return payments.map((payment) => ({
+      id: payment.id,
+      amount: formatAmount(payment.amount, payment.currency),
+      amountRaw: payment.amount,
+      currency: payment.currency,
+      status: payment.status,
+      customer: payment.customer,
+      description: payment.description,
+      receiptEmail: payment.receipt_email,
+      created: formatDate(payment.created),
+      metadata: payment.metadata,
+    }));
+  },
+});

package/dist/integrations/stripe/files/ai/tools/list-subscriptions.ts

@@ -0,0 +1,67 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { formatAmount, formatDate, listSubscriptions } from "../../lib/stripe-client.ts";
+
+export default tool({
+  id: "list-subscriptions",
+  description:
+    "List Stripe subscriptions. Supports filtering by customer, status, and creation date range.",
+  inputSchema: z.object({
+    limit: z.number().min(1).max(100).default(10).describe(
+      "Maximum number of subscriptions to retrieve",
+    ),
+    customerId: z.string().optional().describe("Filter by customer ID (starts with cus_)"),
+    status: z.enum([
+      "incomplete",
+      "incomplete_expired",
+      "trialing",
+      "active",
+      "past_due",
+      "canceled",
+      "unpaid",
+      "paused",
+    ]).optional().describe("Filter by subscription status"),
+    createdAfter: z.number().optional().describe(
+      "Filter subscriptions created after this Unix timestamp",
+    ),
+    createdBefore: z.number().optional().describe(
+      "Filter subscriptions created before this Unix timestamp",
+    ),
+  }),
+  async execute({ limit, customerId, status, createdAfter, createdBefore }) {
+    const created: { gte?: number; lte?: number } | undefined = createdAfter || createdBefore
+      ? { gte: createdAfter, lte: createdBefore }
+      : undefined;
+
+    const subscriptions = await listSubscriptions({
+      limit,
+      customer: customerId,
+      status,
+      created,
+    });
+
+    return subscriptions.map((subscription) => {
+      const items = subscription.items.data.map((item) => ({
+        id: item.id,
+        priceId: item.price.id,
+        amount: formatAmount(item.price.unit_amount, item.price.currency),
+        amountRaw: item.price.unit_amount,
+        currency: item.price.currency,
+        interval: item.price.recurring.interval,
+        intervalCount: item.price.recurring.interval_count,
+      }));
+
+      return {
+        id: subscription.id,
+        customer: subscription.customer,
+        status: subscription.status,
+        currentPeriodStart: formatDate(subscription.current_period_start),
+        currentPeriodEnd: formatDate(subscription.current_period_end),
+        created: formatDate(subscription.created),
+        canceledAt: subscription.canceled_at ? formatDate(subscription.canceled_at) : null,
+        items,
+        metadata: subscription.metadata,
+      };
+    });
+  },
+});

package/dist/integrations/stripe/files/app/api/auth/stripe/route.ts

@@ -0,0 +1,71 @@
+import { setApiKey } from "../../../../lib/token-store.ts";
+
+// Simple API key validation endpoint
+// In production, you may want to validate the key against Stripe API
+export async function POST(request: Request) {
+  try {
+    const body = await request.json();
+    const { apiKey } = body;
+
+    if (!apiKey || typeof apiKey !== "string") {
+      return Response.json(
+        { error: "API key is required" },
+        { status: 400 },
+      );
+    }
+
+    // Validate that it looks like a Stripe key
+    if (!apiKey.startsWith("sk_test_") && !apiKey.startsWith("sk_live_")) {
+      return Response.json(
+        { error: "Invalid Stripe API key format. Key should start with sk_test_ or sk_live_" },
+        { status: 400 },
+      );
+    }
+
+    // Optionally validate the key by making a test API call
+    try {
+      const response = await fetch("https://api.stripe.com/v1/balance", {
+        headers: {
+          "Authorization": `Bearer ${apiKey}`,
+          "Stripe-Version": "2024-12-18.acacia",
+        },
+      });
+
+      if (!response.ok) {
+        const error = await response.json();
+        return Response.json(
+          { error: `Invalid API key: ${error.error?.message || "Authentication failed"}` },
+          { status: 401 },
+        );
+      }
+    } catch (_error) {
+      return Response.json(
+        { error: "Failed to validate API key with Stripe" },
+        { status: 500 },
+      );
+    }
+
+    // Store the API key
+    setApiKey(apiKey);
+
+    return Response.json({
+      success: true,
+      message: "Stripe API key validated and stored successfully",
+    });
+  } catch (_error) {
+    return Response.json(
+      { error: "Internal server error" },
+      { status: 500 },
+    );
+  }
+}
+
+// Get authentication status
+export function GET() {
+  const apiKey = process.env.STRIPE_SECRET_KEY;
+
+  return Response.json({
+    authenticated: !!apiKey,
+    hasEnvKey: !!apiKey,
+  });
+}