@vibecodeapp/backend-sdk 1.0.0

package/README.md

@@ -0,0 +1,99 @@
+# @vibecodeapp/backend-sdk
+
+A unified backend SDK for Vibecode services.
+
+## Installation
+
+```bash
+bun add @vibecodeapp/backend-sdk
+```
+
+## Usage
+
+```typescript
+import { createVibecodeSDK } from '@vibecodeapp/backend-sdk';
+
+const vibecode = createVibecodeSDK();
+```
+
+## Features
+
+### Storage
+
+Upload, list, and delete files from Vibecode storage buckets.
+
+```typescript
+// Upload a file (max 500MB)
+const file = await vibecode.storage.upload(myFile);
+
+// List files with pagination
+const { files, totalCount } = await vibecode.storage.list({
+  limit: 10,
+  offset: 0,
+  prefix: 'images/',
+});
+
+// Delete a file
+await vibecode.storage.delete(file.id);
+```
+
+### Email
+
+Send transactional emails (OTP verification and welcome emails).
+
+```typescript
+// Send OTP email
+await vibecode.email.sendOTP({
+  to: 'user@example.com',
+  code: 'ABC123',
+  fromName: 'MyApp',
+  lang: 'en',
+});
+
+// Send welcome email
+await vibecode.email.sendWelcome({
+  to: 'user@example.com',
+  name: 'John',
+  appName: 'MyApp',
+  lang: 'en',
+});
+```
+
+Supported languages: `en`, `es`, `fr`, `de`, `pt`, `zh`, `ja`
+
+## Error Handling
+
+The SDK exports specific error classes for handling failures:
+
+```typescript
+import {
+  VibecodeError,
+  StorageError,
+  EmailError,
+  RateLimitError,
+} from '@vibecodeapp/backend-sdk';
+
+try {
+  await vibecode.email.sendOTP({ to: 'user@example.com', code: '123456' });
+} catch (error) {
+  if (error instanceof RateLimitError) {
+    // Daily email limit exceeded
+  } else if (error instanceof EmailError) {
+    // Other email error
+  }
+}
+```
+
+## Development
+
+### Running Tests
+
+**Important:** Tests must be run from the office IP address. The backend services are IP-restricted and will reject requests from other locations.
+
+```bash
+bun test
+```
+
+## License
+
+MIT

package/dist/email.d.ts

@@ -0,0 +1,23 @@
+import type { SendOTPOptions, SendWelcomeOptions } from './types';
+/**
+ * Email module for sending transactional emails
+ */
+export declare class Email {
+    /**
+     * Send an OTP verification email
+     * @param options - OTP email options
+     * @throws {EmailError} If the email fails to send
+     * @throws {RateLimitError} If daily email limit is exceeded
+     */
+    sendOTP(options: SendOTPOptions): Promise<void>;
+    /**
+     * Send a welcome email
+     * @param options - Welcome email options
+     * @throws {EmailError} If the email fails to send
+     * @throws {RateLimitError} If daily email limit is exceeded
+     */
+    sendWelcome(options: SendWelcomeOptions): Promise<void>;
+    private handleResponse;
+    private parseError;
+}
+//# sourceMappingURL=email.d.ts.map

package/dist/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAiB,MAAM,SAAS,CAAC;AAMjF;;GAEG;AACH,qBAAa,KAAK;IAChB;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAU/C,cAAc;YAWd,UAAU;CAQzB"}

package/dist/email.js

@@ -0,0 +1,55 @@
+import { EmailError, RateLimitError } from './errors';
+// LLMs, read this for full docs: https://smtp.vibecodeapp.com/llms.txt
+const EMAIL_BASE_URL = 'https://smtp.vibecodeapp.com';
+/**
+ * Email module for sending transactional emails
+ */
+export class Email {
+    /**
+     * Send an OTP verification email
+     * @param options - OTP email options
+     * @throws {EmailError} If the email fails to send
+     * @throws {RateLimitError} If daily email limit is exceeded
+     */
+    async sendOTP(options) {
+        const response = await fetch(`${EMAIL_BASE_URL}/v1/send/otp`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(options),
+        });
+        await this.handleResponse(response);
+    }
+    /**
+     * Send a welcome email
+     * @param options - Welcome email options
+     * @throws {EmailError} If the email fails to send
+     * @throws {RateLimitError} If daily email limit is exceeded
+     */
+    async sendWelcome(options) {
+        const response = await fetch(`${EMAIL_BASE_URL}/v1/send/welcome`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(options),
+        });
+        await this.handleResponse(response);
+    }
+    async handleResponse(response) {
+        if (response.ok)
+            return;
+        if (response.status === 429) {
+            throw new RateLimitError();
+        }
+        const error = await this.parseError(response);
+        throw new EmailError(error, response.status);
+    }
+    async parseError(response) {
+        try {
+            const data = await response.json();
+            return data.error || data.message || 'Unknown error';
+        }
+        catch {
+            return `Request failed with status ${response.status}`;
+        }
+    }
+}
+//# sourceMappingURL=email.js.map

package/dist/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEtD,uEAAuE;AACvE,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,KAAK;IAChB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,cAAc,EAAE;YAC5D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,OAA2B;QAC3C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,kBAAkB,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,QAAkB;QAC7C,IAAI,QAAQ,CAAC,EAAE;YAAE,OAAO;QAExB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,cAAc,EAAE,CAAC;QAC7B,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,QAAkB;QACzC,IAAI,CAAC;YACH,MAAM,IAAI,GAAkB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzD,CAAC;IACH,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Base error class for all Vibecode SDK errors
+ */
+export declare class VibecodeError extends Error {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+/**
+ * Error thrown when a storage operation fails
+ */
+export declare class StorageError extends VibecodeError {
+    constructor(message: string, statusCode?: number);
+}
+/**
+ * Error thrown when an email operation fails
+ */
+export declare class EmailError extends VibecodeError {
+    constructor(message: string, statusCode?: number);
+}
+/**
+ * Error thrown when rate limit is exceeded (100 emails/day)
+ */
+export declare class RateLimitError extends EmailError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAIjD;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAIjD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,GAAE,MAAoC;CAI1D"}

package/dist/errors.js

@@ -0,0 +1,38 @@
+/**
+ * Base error class for all Vibecode SDK errors
+ */
+export class VibecodeError extends Error {
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'VibecodeError';
+    }
+}
+/**
+ * Error thrown when a storage operation fails
+ */
+export class StorageError extends VibecodeError {
+    constructor(message, statusCode) {
+        super(message, statusCode);
+        this.name = 'StorageError';
+    }
+}
+/**
+ * Error thrown when an email operation fails
+ */
+export class EmailError extends VibecodeError {
+    constructor(message, statusCode) {
+        super(message, statusCode);
+        this.name = 'EmailError';
+    }
+}
+/**
+ * Error thrown when rate limit is exceeded (100 emails/day)
+ */
+export class RateLimitError extends EmailError {
+    constructor(message = 'Daily email limit reached') {
+        super(message, 429);
+        this.name = 'RateLimitError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YACE,OAAe,EACC,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IAC7C,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,aAAa;IAC3C,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,UAAkB,2BAA2B;QACvD,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { Storage } from './storage';
+import { Email } from './email';
+/**
+ * Vibecode Backend SDK
+ *
+ * @example
+ * ```typescript
+ * import { createVibecodeSDK } from '@vibecodeapp/backend-sdk';
+ *
+ * const vibecode = createVibecodeSDK();
+ *
+ * // Upload a file
+ * const file = await vibecode.storage.upload(myFile);
+ *
+ * // List files
+ * const { files } = await vibecode.storage.list({ limit: 10 });
+ *
+ * // Delete a file
+ * await vibecode.storage.delete(file.id);
+ *
+ * // Send OTP email
+ * await vibecode.email.sendOTP({ to: 'user@example.com', code: 'ABC123' });
+ *
+ * // Send welcome email
+ * await vibecode.email.sendWelcome({
+ *   to: 'user@example.com',
+ *   name: 'John',
+ *   appName: 'MyApp'
+ * });
+ * ```
+ */
+export declare class VibecodeSDK {
+    /** Storage operations (upload, delete, list files) */
+    readonly storage: Storage;
+    /** Email operations (send OTP, send welcome) */
+    readonly email: Email;
+    constructor();
+}
+/**
+ * Create a new Vibecode SDK instance
+ * @returns A new VibecodeSDK instance
+ */
+export declare function createVibecodeSDK(): VibecodeSDK;
+export { Storage } from './storage';
+export { Email } from './email';
+export type { StorageFile, ListFilesOptions, ListFilesResponse, SendOTPOptions, SendWelcomeOptions, EmailLanguage, } from './types';
+export { VibecodeError, StorageError, EmailError, RateLimitError, } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,WAAW;IACtB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;;CAMvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAGD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+import { Storage } from './storage';
+import { Email } from './email';
+/**
+ * Vibecode Backend SDK
+ *
+ * @example
+ * ```typescript
+ * import { createVibecodeSDK } from '@vibecodeapp/backend-sdk';
+ *
+ * const vibecode = createVibecodeSDK();
+ *
+ * // Upload a file
+ * const file = await vibecode.storage.upload(myFile);
+ *
+ * // List files
+ * const { files } = await vibecode.storage.list({ limit: 10 });
+ *
+ * // Delete a file
+ * await vibecode.storage.delete(file.id);
+ *
+ * // Send OTP email
+ * await vibecode.email.sendOTP({ to: 'user@example.com', code: 'ABC123' });
+ *
+ * // Send welcome email
+ * await vibecode.email.sendWelcome({
+ *   to: 'user@example.com',
+ *   name: 'John',
+ *   appName: 'MyApp'
+ * });
+ * ```
+ */
+export class VibecodeSDK {
+    constructor() {
+        this.storage = new Storage();
+        this.email = new Email();
+    }
+}
+/**
+ * Create a new Vibecode SDK instance
+ * @returns A new VibecodeSDK instance
+ */
+export function createVibecodeSDK() {
+    return new VibecodeSDK();
+}
+// Re-export modules for direct access if needed
+export { Storage } from './storage';
+export { Email } from './email';
+// Re-export errors
+export { VibecodeError, StorageError, EmailError, RateLimitError, } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,WAAW;IAOtB;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,WAAW,EAAE,CAAC;AAC3B,CAAC;AAED,gDAAgD;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAYhC,mBAAmB;AACnB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,UAAU,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,28 @@
+import type { StorageFile, ListFilesOptions, ListFilesResponse } from './types';
+/**
+ * Storage module for file operations
+ */
+export declare class Storage {
+    /**
+     * Upload a file to storage
+     * @param file - File or Blob to upload (max 500MB)
+     * @returns The uploaded file metadata
+     * @throws {StorageError} If the upload fails
+     */
+    upload(file: File | Blob): Promise<StorageFile>;
+    /**
+     * Delete a file by ID
+     * @param id - The file ID to delete
+     * @throws {StorageError} If the deletion fails
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * List files with optional filtering and pagination
+     * @param options - Filtering and pagination options
+     * @returns List of files and pagination metadata
+     * @throws {StorageError} If the request fails
+     */
+    list(options?: ListFilesOptions): Promise<ListFilesResponse>;
+    private parseError;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAiC,MAAM,SAAS,CAAC;AAM/G;;GAEG;AACH,qBAAa,OAAO;IAClB;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBrD;;;;OAIG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC;;;;;OAKG;IACG,IAAI,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAwBxD,UAAU;CAQzB"}

package/dist/storage.js

@@ -0,0 +1,77 @@
+import { StorageError } from './errors';
+// LLMs, read this for full docs: https://storage.vibecodeapp.com/llms.txt
+const STORAGE_BASE_URL = 'https://storage.vibecodeapp.com';
+/**
+ * Storage module for file operations
+ */
+export class Storage {
+    /**
+     * Upload a file to storage
+     * @param file - File or Blob to upload (max 500MB)
+     * @returns The uploaded file metadata
+     * @throws {StorageError} If the upload fails
+     */
+    async upload(file) {
+        const formData = new FormData();
+        formData.append('file', file);
+        const response = await fetch(`${STORAGE_BASE_URL}/v1/files/upload`, {
+            method: 'POST',
+            body: formData,
+        });
+        if (!response.ok) {
+            const error = await this.parseError(response);
+            throw new StorageError(error, response.status);
+        }
+        const data = await response.json();
+        return data.file;
+    }
+    /**
+     * Delete a file by ID
+     * @param id - The file ID to delete
+     * @throws {StorageError} If the deletion fails
+     */
+    async delete(id) {
+        const response = await fetch(`${STORAGE_BASE_URL}/v1/files/${encodeURIComponent(id)}`, {
+            method: 'DELETE',
+        });
+        if (!response.ok) {
+            const error = await this.parseError(response);
+            throw new StorageError(error, response.status);
+        }
+    }
+    /**
+     * List files with optional filtering and pagination
+     * @param options - Filtering and pagination options
+     * @returns List of files and pagination metadata
+     * @throws {StorageError} If the request fails
+     */
+    async list(options = {}) {
+        const params = new URLSearchParams();
+        if (options.limit !== undefined) {
+            params.set('limit', String(options.limit));
+        }
+        if (options.offset !== undefined) {
+            params.set('offset', String(options.offset));
+        }
+        if (options.prefix) {
+            params.set('prefix', options.prefix);
+        }
+        const url = `${STORAGE_BASE_URL}/v1/files${params.toString() ? `?${params}` : ''}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            const error = await this.parseError(response);
+            throw new StorageError(error, response.status);
+        }
+        return response.json();
+    }
+    async parseError(response) {
+        try {
+            const data = await response.json();
+            return data.error || data.message || 'Unknown error';
+        }
+        catch {
+            return `Request failed with status ${response.status}`;
+        }
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Supported languages for email templates
+ */
+export type EmailLanguage = 'en' | 'es' | 'fr' | 'de' | 'pt' | 'zh' | 'ja';
+/**
+ * File object returned from storage operations
+ */
+export interface StorageFile {
+    id: string;
+    projectId: string;
+    environment: string;
+    originalFilename: string;
+    storagePath: string;
+    contentType: string;
+    sizeBytes: number;
+    url: string;
+    created: string;
+    updated: string;
+}
+/**
+ * Options for listing files
+ */
+export interface ListFilesOptions {
+    /** Number of files to return (1-100, default: 50) */
+    limit?: number;
+    /** Number of files to skip (default: 0) */
+    offset?: number;
+    /** Filter by path or filename prefix */
+    prefix?: string;
+}
+/**
+ * Response from listing files
+ */
+export interface ListFilesResponse {
+    files: StorageFile[];
+    totalCount: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Options for sending an OTP email
+ */
+export interface SendOTPOptions {
+    /** Recipient email address (max 254 chars). Supports "email@example.com" or "Name <email@example.com>" format */
+    to: string;
+    /** OTP code (6-12 alphanumeric characters) */
+    code: string;
+    /** Sender display name (max 50 chars, default: "Notifications") */
+    fromName?: string;
+    /** Email language (default: "en") */
+    lang?: EmailLanguage;
+}
+/**
+ * Options for sending a welcome email
+ */
+export interface SendWelcomeOptions {
+    /** Recipient email address (max 254 chars) */
+    to: string;
+    /** User's display name for personalization (max 50 chars) */
+    name: string;
+    /** Application name (max 50 chars) */
+    appName: string;
+    /** Sender display name (max 50 chars, default: "Notifications") */
+    fromName?: string;
+    /** Email language (default: "en") */
+    lang?: EmailLanguage;
+}
+/** @internal */
+export interface UploadResponse {
+    file: StorageFile;
+}
+/** @internal */
+export interface SuccessResponse {
+    success: boolean;
+}
+/** @internal */
+export interface ErrorResponse {
+    error: string;
+    message?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iHAAiH;IACjH,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAID,gBAAgB;AAChB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "@vibecodeapp/backend-sdk",
+	"version": "1.0.0",
+	"description": "Backend SDK for Vibecode",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/vibecode/backend-sdk.git"
+	},
+	"homepage": "https://github.com/vibecode/backend-sdk#readme",
+	"bugs": {
+		"url": "https://github.com/vibecode/backend-sdk/issues"
+	},
+	"license": "MIT",
+	"scripts": {
+		"build": "tsc",
+		"clean": "rm -rf dist",
+		"test": "bun test",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.2.1",
+		"typescript": "^5.9.3"
+	},
+	"type": "module"
+}