@proyecta-ai/sdk

@proyecta-ai/sdk

The official TypeScript SDK for the Proyecta platform API. Provides fully typed access to Commerce, AI, Analytics, Content, Email, Files, Domains, Push Notifications, and Connectors.

Installation

npm install @proyecta-ai/sdk

Quick start

import Proyecta from '@proyecta-ai/sdk';

const proyecta = new Proyecta({
    apiKey: process.env.PROYECTA_API_KEY,
});

// List products
const { data } = await proyecta.commerce.products.list();

// Create an AI chat completion
const { data: completion } = await proyecta.ai.chat.completions.create({
    body: {
        model: 'claude-sonnet-4-20250514',
        messages: [{ role: 'user', content: 'Hello' }],
    },
});

// Track an analytics event
await proyecta.analytics.track({
    body: {
        event: 'page_view',
        properties: { page: '/pricing' },
    },
});

// Send a transactional email
await proyecta.email.send({
    body: {
        to: 'user@example.com',
        subject: 'Welcome',
        html: '<h1>Welcome aboard</h1>',
    },
});

Configuration

const proyecta = new Proyecta({
    apiKey: 'pk_live_...', // Required. Your Proyecta API key.
    baseUrl: 'https://...', // Optional. Defaults to https://cloud.proyecta.dev
    apiVersion: '2025-12-09', // Optional. Sent as the Proyecta-Version header.
});

API surface