@vly-ai/integrations 0.5.2 → 0.6.1-beta.1

package/README.md

@@ -1,26 +1,36 @@
-# vly-integrations
+# @vly-ai/integrations
 
-First-order integrations for AI, email, and payments with automatic usage billing through Vly deployment tokens. Built on the AI SDK for reliable, type-safe AI Gateway integration.
+Access AI models and email services through [vly.ai](https://vly.ai) without managing multiple API keys or accounts. Built on the AI SDK for reliable, type-safe AI Gateway integration.
+
+## Why use @vly-ai/integrations?
+
+Instead of creating separate accounts and managing API keys for OpenAI, Anthropic, SendGrid, Resend, etc., get a single deployment token from [vly.ai](https://vly.ai) and access all these services with automatic usage-based billing:
+
+- **No API key management** - One token for all services (AI models, email, etc.)
+- **No separate accounts** - Skip creating accounts with OpenAI, Anthropic, SendGrid, etc.
+- **Usage-based billing** - Pay only for what you use, billed through your vly.ai deployment
+- **Multiple AI models** - Access GPT-5, Claude 4, Gemini, Llama, and more through one API
+- **Built on AI SDK** - Type-safe, production-ready integration
 
 ## Installation
 
 ```bash
-npm install vly-integrations
-# or
-yarn add vly-integrations
-# or
-pnpm add vly-integrations
+pnpm add @vly-ai/integrations
 ```
 
-No additional dependencies required! Built with fetch and AI SDK.
+## Getting Started
+
+1. Sign up at [vly.ai](https://vly.ai) and create a deployment
+2. Get your deployment token from the dashboard
+3. Set it as an environment variable: `VLY_INTEGRATION_KEY`
 
 ## Usage
 
 ```typescript
-import { createVlyIntegrations } from 'vly-integrations';
+import { createVlyIntegrations } from '@vly-ai/integrations';
 
 const vly = createVlyIntegrations({
-  deploymentToken: process.env.VLY_INTEGRATION_KEY,  // Uses VLY_INTEGRATION_KEY env var
+  deploymentToken: process.env.VLY_INTEGRATION_KEY,
   debug: false // optional
 });
 
@@ -50,25 +60,15 @@ const emailResult = await vly.email.send({
   html: '<h1>Welcome to our service!</h1>',
   text: 'Welcome to our service!'
 });
-
-// Create Payment Intent
-const paymentIntent = await vly.payments.createPaymentIntent({
-  amount: 2000, // $20.00 in cents
-  currency: 'usd',
-  description: 'Premium subscription',
-  customer: {
-    email: 'customer@example.com'
-  }
-});
 ```
 
 ## AI Gateway Integration
 
-Powered by the AI SDK with OpenAI-compatible provider for https://ai-gateway.vly.ai
+Powered by the AI SDK with OpenAI-compatible provider for https://integrations.vly.ai
 
 ### Supported Models
 
-The vly-integrations package supports **all models available through the Vercel AI Gateway**. This includes but is not limited to:
+The @vly-ai/integrations package supports **all models available through the Vercel AI Gateway**. This includes but is not limited to:
 
 - **OpenAI Models**: GPT-5, GPT-5 Mini, GPT-5 Nano, GPT-4, GPT-3.5, etc.
 - **Anthropic Claude**: Claude 4 Opus, Claude 4 Sonnet, Claude 3.7, Claude 3.5, Haiku, etc.
@@ -147,37 +147,6 @@ vly.email.verifyDomain(domain: string): Promise<ApiResponse>
 vly.email.listDomains(): Promise<ApiResponse>
 ```
 
-### Payments Integration
-
-```typescript
-// Payment Intents
-vly.payments.createPaymentIntent(intent: PaymentIntent): Promise<ApiResponse<PaymentIntentResponse>>
-vly.payments.confirmPaymentIntent(intentId: string, paymentMethodId: string): Promise<ApiResponse>
-vly.payments.getPaymentIntent(intentId: string): Promise<ApiResponse>
-vly.payments.cancelPaymentIntent(intentId: string): Promise<ApiResponse>
-
-// Subscriptions
-vly.payments.createSubscription(subscription: Subscription): Promise<ApiResponse<SubscriptionResponse>>
-vly.payments.updateSubscription(id: string, updates: Partial<Subscription>): Promise<ApiResponse>
-vly.payments.cancelSubscription(id: string, immediately?: boolean): Promise<ApiResponse>
-vly.payments.getSubscription(id: string): Promise<ApiResponse>
-vly.payments.listSubscriptions(customerId?: string): Promise<ApiResponse>
-
-// Checkout & Portal
-vly.payments.createCheckoutSession(session: CheckoutSession): Promise<ApiResponse>
-vly.payments.createCustomerPortal(session: CustomerPortalSession): Promise<ApiResponse>
-
-// Customer Management
-vly.payments.createCustomer(customer: Customer): Promise<ApiResponse>
-vly.payments.getCustomer(customerId: string): Promise<ApiResponse>
-vly.payments.updateCustomer(customerId: string, updates: CustomerUpdate): Promise<ApiResponse>
-
-// Payment Methods
-vly.payments.listPaymentMethods(customerId: string): Promise<ApiResponse>
-vly.payments.attachPaymentMethod(methodId: string, customerId: string): Promise<ApiResponse>
-vly.payments.detachPaymentMethod(methodId: string): Promise<ApiResponse>
-```
-
 ## Error Handling
 
 All methods return an `ApiResponse` object with the following structure:
@@ -227,15 +196,6 @@ const vly = createVlyIntegrations({
 });
 ```
 
-## What's New in v0.2.0
-
-- ✅ **AI SDK Integration**: Now powered by `@ai-sdk/openai-compatible` for better reliability
-- ✅ **No more axios**: Replaced with built-in fetch for lighter weight
-- ✅ **New AI models**: Support for GPT-5, Claude 4, and Claude 3.7 models
-- ✅ **Direct AI SDK access**: Get the provider for advanced AI SDK usage
-- ✅ **Better streaming**: Improved streaming support with AI SDK
-- ✅ **Type safety**: Enhanced TypeScript support
-
 ## Billing
 
 All API calls are automatically billed to your deployment based on usage. The billing happens transparently through your deployment token, and usage information is included in the API responses.

package/dist/index.d.mts

@@ -1,8 +1,9 @@
 import * as _ai_sdk_openai_compatible from '@ai-sdk/openai-compatible';
 export { CoreMessage } from 'ai';
+export { ScreenshotMessage, initScreenshotListener, initVly } from './project-thumbnail/index.mjs';
 
 interface VlyConfig {
-    deploymentToken: string;
+    deploymentToken?: string;
     debug?: boolean;
 }
 interface RequestOptions {
@@ -65,53 +66,6 @@ interface EmailResponse {
     messageId?: string;
     error?: string;
 }
-interface PaymentIntent {
-    amount: number;
-    currency?: string;
-    description?: string;
-    metadata?: Record<string, any>;
-    customer?: {
-        email?: string;
-        name?: string;
-        id?: string;
-    };
-}
-interface PaymentIntentResponse {
-    id: string;
-    clientSecret: string;
-    amount: number;
-    currency: string;
-    status: 'requires_payment_method' | 'requires_confirmation' | 'succeeded' | 'processing' | 'canceled';
-    paymentMethodTypes: string[];
-}
-interface Subscription {
-    customerId: string;
-    priceId: string;
-    metadata?: Record<string, any>;
-    trialPeriodDays?: number;
-    cancelAtPeriodEnd?: boolean;
-}
-interface SubscriptionResponse {
-    id: string;
-    customerId: string;
-    status: 'active' | 'past_due' | 'canceled' | 'incomplete' | 'trialing';
-    currentPeriodEnd: string;
-    items: Array<{
-        id: string;
-        priceId: string;
-        quantity: number;
-    }>;
-}
-interface CustomerPortalSession {
-    customerId: string;
-    returnUrl?: string;
-}
-interface CustomerPortalResponse {
-    id: string;
-    url: string;
-    returnUrl?: string;
-    created: number;
-}
 
 declare class VlyAI {
     private provider;
@@ -159,95 +113,12 @@ declare class VlyEmail extends VlyClient {
     }>>>;
 }
 
-declare class VlyPayments extends VlyClient {
-    createPaymentIntent(intent: PaymentIntent, options?: RequestOptions): Promise<ApiResponse<PaymentIntentResponse>>;
-    confirmPaymentIntent(intentId: string, paymentMethodId: string, options?: RequestOptions): Promise<ApiResponse<PaymentIntentResponse>>;
-    getPaymentIntent(intentId: string, options?: RequestOptions): Promise<ApiResponse<PaymentIntentResponse>>;
-    cancelPaymentIntent(intentId: string, options?: RequestOptions): Promise<ApiResponse<PaymentIntentResponse>>;
-    createSubscription(subscription: Subscription, options?: RequestOptions): Promise<ApiResponse<SubscriptionResponse>>;
-    updateSubscription(subscriptionId: string, updates: Partial<Subscription>, options?: RequestOptions): Promise<ApiResponse<SubscriptionResponse>>;
-    cancelSubscription(subscriptionId: string, immediately?: boolean, options?: RequestOptions): Promise<ApiResponse<SubscriptionResponse>>;
-    getSubscription(subscriptionId: string, options?: RequestOptions): Promise<ApiResponse<SubscriptionResponse>>;
-    listSubscriptions(customerId?: string, options?: RequestOptions & {
-        limit?: number;
-        offset?: number;
-    }): Promise<ApiResponse<{
-        subscriptions: SubscriptionResponse[];
-        hasMore: boolean;
-        total: number;
-    }>>;
-    createCustomerPortal(session: CustomerPortalSession, options?: RequestOptions): Promise<ApiResponse<CustomerPortalResponse>>;
-    createCheckoutSession(session: {
-        customerId?: string;
-        customerEmail?: string;
-        lineItems: Array<{
-            priceId: string;
-            quantity: number;
-        }>;
-        mode: 'payment' | 'subscription';
-        successUrl: string;
-        cancelUrl: string;
-        metadata?: Record<string, any>;
-    }, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        url: string;
-    }>>;
-    createCustomer(customer: {
-        email: string;
-        name?: string;
-        metadata?: Record<string, any>;
-    }, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        email: string;
-        name?: string;
-        created: number;
-    }>>;
-    getCustomer(customerId: string, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        email: string;
-        name?: string;
-        created: number;
-        metadata?: Record<string, any>;
-    }>>;
-    updateCustomer(customerId: string, updates: {
-        email?: string;
-        name?: string;
-        metadata?: Record<string, any>;
-    }, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        email: string;
-        name?: string;
-        created: number;
-        metadata?: Record<string, any>;
-    }>>;
-    listPaymentMethods(customerId: string, options?: RequestOptions): Promise<ApiResponse<Array<{
-        id: string;
-        type: string;
-        card?: {
-            brand: string;
-            last4: string;
-            expMonth: number;
-            expYear: number;
-        };
-        created: number;
-    }>>>;
-    attachPaymentMethod(paymentMethodId: string, customerId: string, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        customerId: string;
-        attached: boolean;
-    }>>;
-    detachPaymentMethod(paymentMethodId: string, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        detached: boolean;
-    }>>;
-}
-
 declare class VlyIntegrations {
-    ai: VlyAI;
-    email: VlyEmail;
-    payments: VlyPayments;
+    readonly ai: VlyAI;
+    readonly email: VlyEmail;
+    readonly config: Required<VlyConfig>;
     constructor(config: VlyConfig);
 }
 declare function createVlyIntegrations(config: VlyConfig): VlyIntegrations;
 
-export { type AICompletionRequest, type AICompletionResponse, type AIModel, type ApiResponse, type CustomerPortalResponse, type CustomerPortalSession, type EmailRequest, type EmailResponse, type PaymentIntent, type PaymentIntentResponse, type RequestOptions, type Subscription, type SubscriptionResponse, VlyAI, type VlyConfig, VlyEmail, VlyIntegrations, VlyPayments, createVlyIntegrations };
+export { type AICompletionRequest, type AICompletionResponse, type AIModel, type ApiResponse, type EmailRequest, type EmailResponse, type RequestOptions, VlyAI, type VlyConfig, VlyEmail, VlyIntegrations, createVlyIntegrations };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import * as _ai_sdk_openai_compatible from '@ai-sdk/openai-compatible';
 export { CoreMessage } from 'ai';
+export { ScreenshotMessage, initScreenshotListener, initVly } from './project-thumbnail/index.js';
 
 interface VlyConfig {
-    deploymentToken: string;
+    deploymentToken?: string;
     debug?: boolean;
 }
 interface RequestOptions {
@@ -65,53 +66,6 @@ interface EmailResponse {
     messageId?: string;
     error?: string;
 }
-interface PaymentIntent {
-    amount: number;
-    currency?: string;
-    description?: string;
-    metadata?: Record<string, any>;
-    customer?: {
-        email?: string;
-        name?: string;
-        id?: string;
-    };
-}
-interface PaymentIntentResponse {
-    id: string;
-    clientSecret: string;
-    amount: number;
-    currency: string;
-    status: 'requires_payment_method' | 'requires_confirmation' | 'succeeded' | 'processing' | 'canceled';
-    paymentMethodTypes: string[];
-}
-interface Subscription {
-    customerId: string;
-    priceId: string;
-    metadata?: Record<string, any>;
-    trialPeriodDays?: number;
-    cancelAtPeriodEnd?: boolean;
-}
-interface SubscriptionResponse {
-    id: string;
-    customerId: string;
-    status: 'active' | 'past_due' | 'canceled' | 'incomplete' | 'trialing';
-    currentPeriodEnd: string;
-    items: Array<{
-        id: string;
-        priceId: string;
-        quantity: number;
-    }>;
-}
-interface CustomerPortalSession {
-    customerId: string;
-    returnUrl?: string;
-}
-interface CustomerPortalResponse {
-    id: string;
-    url: string;
-    returnUrl?: string;
-    created: number;
-}
 
 declare class VlyAI {
     private provider;
@@ -159,95 +113,12 @@ declare class VlyEmail extends VlyClient {
     }>>>;
 }
 
-declare class VlyPayments extends VlyClient {
-    createPaymentIntent(intent: PaymentIntent, options?: RequestOptions): Promise<ApiResponse<PaymentIntentResponse>>;
-    confirmPaymentIntent(intentId: string, paymentMethodId: string, options?: RequestOptions): Promise<ApiResponse<PaymentIntentResponse>>;
-    getPaymentIntent(intentId: string, options?: RequestOptions): Promise<ApiResponse<PaymentIntentResponse>>;
-    cancelPaymentIntent(intentId: string, options?: RequestOptions): Promise<ApiResponse<PaymentIntentResponse>>;
-    createSubscription(subscription: Subscription, options?: RequestOptions): Promise<ApiResponse<SubscriptionResponse>>;
-    updateSubscription(subscriptionId: string, updates: Partial<Subscription>, options?: RequestOptions): Promise<ApiResponse<SubscriptionResponse>>;
-    cancelSubscription(subscriptionId: string, immediately?: boolean, options?: RequestOptions): Promise<ApiResponse<SubscriptionResponse>>;
-    getSubscription(subscriptionId: string, options?: RequestOptions): Promise<ApiResponse<SubscriptionResponse>>;
-    listSubscriptions(customerId?: string, options?: RequestOptions & {
-        limit?: number;
-        offset?: number;
-    }): Promise<ApiResponse<{
-        subscriptions: SubscriptionResponse[];
-        hasMore: boolean;
-        total: number;
-    }>>;
-    createCustomerPortal(session: CustomerPortalSession, options?: RequestOptions): Promise<ApiResponse<CustomerPortalResponse>>;
-    createCheckoutSession(session: {
-        customerId?: string;
-        customerEmail?: string;
-        lineItems: Array<{
-            priceId: string;
-            quantity: number;
-        }>;
-        mode: 'payment' | 'subscription';
-        successUrl: string;
-        cancelUrl: string;
-        metadata?: Record<string, any>;
-    }, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        url: string;
-    }>>;
-    createCustomer(customer: {
-        email: string;
-        name?: string;
-        metadata?: Record<string, any>;
-    }, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        email: string;
-        name?: string;
-        created: number;
-    }>>;
-    getCustomer(customerId: string, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        email: string;
-        name?: string;
-        created: number;
-        metadata?: Record<string, any>;
-    }>>;
-    updateCustomer(customerId: string, updates: {
-        email?: string;
-        name?: string;
-        metadata?: Record<string, any>;
-    }, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        email: string;
-        name?: string;
-        created: number;
-        metadata?: Record<string, any>;
-    }>>;
-    listPaymentMethods(customerId: string, options?: RequestOptions): Promise<ApiResponse<Array<{
-        id: string;
-        type: string;
-        card?: {
-            brand: string;
-            last4: string;
-            expMonth: number;
-            expYear: number;
-        };
-        created: number;
-    }>>>;
-    attachPaymentMethod(paymentMethodId: string, customerId: string, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        customerId: string;
-        attached: boolean;
-    }>>;
-    detachPaymentMethod(paymentMethodId: string, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        detached: boolean;
-    }>>;
-}
-
 declare class VlyIntegrations {
-    ai: VlyAI;
-    email: VlyEmail;
-    payments: VlyPayments;
+    readonly ai: VlyAI;
+    readonly email: VlyEmail;
+    readonly config: Required<VlyConfig>;
     constructor(config: VlyConfig);
 }
 declare function createVlyIntegrations(config: VlyConfig): VlyIntegrations;
 
-export { type AICompletionRequest, type AICompletionResponse, type AIModel, type ApiResponse, type CustomerPortalResponse, type CustomerPortalSession, type EmailRequest, type EmailResponse, type PaymentIntent, type PaymentIntentResponse, type RequestOptions, type Subscription, type SubscriptionResponse, VlyAI, type VlyConfig, VlyEmail, VlyIntegrations, VlyPayments, createVlyIntegrations };
+export { type AICompletionRequest, type AICompletionResponse, type AIModel, type ApiResponse, type EmailRequest, type EmailResponse, type RequestOptions, VlyAI, type VlyConfig, VlyEmail, VlyIntegrations, createVlyIntegrations };