@tapstack/db 1.0.7 → 3.0.0

package/dist/adapters/nodejs.adapter.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Tapstack API Adapter
+ * Implements IInstanceAdapter for the Tapstack API at api.tapstack.com
+ */
+import { IInstanceAdapter, AdapterConfig, HttpMethod, RequestOptions } from './types';
+/**
+ * Default Tapstack API URL
+ */
+export declare const DEFAULT_API_URL = "https://api.tapstack.com";
+/**
+ * Configuration for the Tapstack API adapter
+ */
+export interface NodeJSAdapterConfig extends AdapterConfig {
+    /**
+     * Base URL of the Tapstack API
+     * @default 'https://api.tapstack.com'
+     */
+    baseUrl?: string;
+    /**
+     * API key for authentication (for programmatic access)
+     */
+    apiKey?: string;
+    /**
+     * Service token for service-to-service calls
+     */
+    serviceToken?: string;
+    /**
+     * User token for frontend calls (static)
+     */
+    userToken?: string;
+    /**
+     * Function to get dynamic user token (alternative to static userToken)
+     * Use this in frontend apps where the token may change
+     */
+    getUserToken?: () => Promise<string | null>;
+}
+export declare class NodeJSAdapter implements IInstanceAdapter {
+    private config;
+    private workspaceId;
+    private baseUrl;
+    constructor(config: NodeJSAdapterConfig);
+    /**
+     * Map SDK paths to REST API paths
+     * Converts paths like 'records/contacts' to '/api/v1/objects/contacts/records'
+     */
+    private mapPath;
+    /**
+     * Make a request to the Tapstack API
+     */
+    request<T>(method: HttpMethod, path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Upload a file to the Tapstack API
+     */
+    upload<T>(path: string, file: File | Blob, metadata?: Record<string, string>): Promise<T>;
+    /**
+     * Set the workspace context
+     */
+    setWorkspaceId(workspaceId: string | null): void;
+    /**
+     * Get the current workspace ID
+     */
+    getWorkspaceId(): string | null;
+}

package/dist/adapters/nodejs.adapter.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * Tapstack API Adapter
+ * Implements IInstanceAdapter for the Tapstack API at api.tapstack.com
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeJSAdapter = exports.DEFAULT_API_URL = void 0;
+const types_1 = require("./types");
+/**
+ * Default Tapstack API URL
+ */
+exports.DEFAULT_API_URL = 'https://api.tapstack.com';
+class NodeJSAdapter {
+    constructor(config) {
+        this.config = config;
+        this.workspaceId = config.workspaceId ?? null;
+        this.baseUrl = config.baseUrl ?? exports.DEFAULT_API_URL;
+    }
+    /**
+     * Map SDK paths to REST API paths
+     * Converts paths like 'records/contacts' to '/api/v1/objects/contacts/records'
+     */
+    mapPath(path) {
+        // Already a full path
+        if (path.startsWith('/api/')) {
+            return path;
+        }
+        // Schema operations
+        if (path.startsWith('schema/objects')) {
+            return `/api/v1/objects${path.replace('schema/objects', '')}`;
+        }
+        if (path.startsWith('schema/fields/')) {
+            const parts = path.split('/');
+            const objectSlug = parts[2];
+            const rest = parts.slice(3).join('/');
+            return `/api/v1/objects/${objectSlug}/fields${rest ? `/${rest}` : ''}`;
+        }
+        // Record operations: records/{objectSlug}/... -> /api/v1/objects/{objectSlug}/records/...
+        if (path.startsWith('records/')) {
+            const parts = path.split('/');
+            const objectSlug = parts[1];
+            const rest = parts.slice(2).join('/');
+            return `/api/v1/objects/${objectSlug}/records${rest ? `/${rest}` : ''}`;
+        }
+        // File operations
+        if (path.startsWith('files')) {
+            return `/api/v1${path.startsWith('/') ? path : `/${path}`}`;
+        }
+        // Automation operations
+        if (path.startsWith('automations')) {
+            return `/api/v1${path.startsWith('/') ? path : `/${path}`}`;
+        }
+        // Conversation operations
+        if (path.startsWith('conversations')) {
+            return `/api/v1${path.startsWith('/') ? path : `/${path}`}`;
+        }
+        // AI operations
+        if (path.startsWith('ai')) {
+            return `/api/v1${path.startsWith('/') ? path : `/${path}`}`;
+        }
+        // Organization operations
+        if (path.startsWith('organizations')) {
+            return `/api${path.startsWith('/') ? path : `/${path}`}`;
+        }
+        // Workspace operations
+        if (path.startsWith('workspaces')) {
+            return `/api${path.startsWith('/') ? path : `/${path}`}`;
+        }
+        // Activity operations
+        if (path.startsWith('activity')) {
+            return `/api/v1${path.startsWith('/') ? path : `/${path}`}`;
+        }
+        // Default: add /api prefix
+        return `/api/${path}`;
+    }
+    /**
+     * Make a request to the Tapstack API
+     */
+    async request(method, path, options) {
+        // Build the URL - API uses /api/v1 prefix for data operations
+        const apiPath = this.mapPath(path);
+        let url = `${this.baseUrl}${apiPath}`;
+        // Add query parameters
+        if (options?.params) {
+            const params = new URLSearchParams(options.params);
+            if (this.workspaceId && !options.params.workspaceId) {
+                params.set('workspaceId', this.workspaceId);
+            }
+            url += `?${params.toString()}`;
+        }
+        else if (this.workspaceId) {
+            url += `?workspaceId=${this.workspaceId}`;
+        }
+        // Build headers
+        const headers = {
+            'Content-Type': 'application/json',
+            ...this.config.defaultHeaders,
+            ...options?.headers,
+        };
+        // Add authentication
+        if (this.config.apiKey) {
+            headers['X-API-Key'] = this.config.apiKey;
+        }
+        if (this.config.serviceToken) {
+            headers['Authorization'] = `Bearer ${this.config.serviceToken}`;
+        }
+        else if (this.config.userToken) {
+            headers['Authorization'] = `Bearer ${this.config.userToken}`;
+        }
+        else if (this.config.getUserToken) {
+            const token = await this.config.getUserToken();
+            if (token) {
+                headers['Authorization'] = `Bearer ${token}`;
+            }
+        }
+        // Add workspace header
+        if (this.workspaceId) {
+            headers['X-Workspace-Id'] = this.workspaceId;
+        }
+        // Make the request
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: options?.body ? JSON.stringify(options.body) : undefined,
+        });
+        // Handle authentication errors
+        if (response.status === 401) {
+            this.config.onAuthError?.();
+            throw new types_1.AdapterError('Unauthorized', 'UNAUTHORIZED', 401);
+        }
+        // Parse response
+        const data = (await response.json());
+        // Handle API errors
+        if (!data.success) {
+            throw new types_1.AdapterError(data.error?.message || 'Request failed', data.error?.code || 'UNKNOWN_ERROR', response.status);
+        }
+        return data.data;
+    }
+    /**
+     * Upload a file to the Tapstack API
+     */
+    async upload(path, file, metadata) {
+        const apiPath = this.mapPath(path);
+        let url = `${this.baseUrl}${apiPath}`;
+        if (this.workspaceId) {
+            url += `?workspaceId=${this.workspaceId}`;
+        }
+        const headers = {
+            ...this.config.defaultHeaders,
+        };
+        if (this.config.apiKey) {
+            headers['X-API-Key'] = this.config.apiKey;
+        }
+        if (this.config.serviceToken) {
+            headers['Authorization'] = `Bearer ${this.config.serviceToken}`;
+        }
+        else if (this.config.userToken) {
+            headers['Authorization'] = `Bearer ${this.config.userToken}`;
+        }
+        else if (this.config.getUserToken) {
+            const token = await this.config.getUserToken();
+            if (token) {
+                headers['Authorization'] = `Bearer ${token}`;
+            }
+        }
+        if (this.workspaceId) {
+            headers['X-Workspace-Id'] = this.workspaceId;
+        }
+        const formData = new FormData();
+        formData.append('file', file);
+        if (metadata) {
+            for (const [key, value] of Object.entries(metadata)) {
+                formData.append(key, value);
+            }
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: formData,
+        });
+        if (response.status === 401) {
+            this.config.onAuthError?.();
+            throw new types_1.AdapterError('Unauthorized', 'UNAUTHORIZED', 401);
+        }
+        const data = (await response.json());
+        if (!data.success) {
+            throw new types_1.AdapterError(data.error?.message || 'Upload failed', data.error?.code || 'UPLOAD_ERROR', response.status);
+        }
+        return data.data;
+    }
+    /**
+     * Set the workspace context
+     */
+    setWorkspaceId(workspaceId) {
+        this.workspaceId = workspaceId;
+    }
+    /**
+     * Get the current workspace ID
+     */
+    getWorkspaceId() {
+        return this.workspaceId;
+    }
+}
+exports.NodeJSAdapter = NodeJSAdapter;

package/dist/adapters/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Instance Adapter Interface
+ * Defines the contract for backend adapters (Edge Functions, Node.js API, etc.)
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface RequestOptions {
+    body?: unknown;
+    params?: Record<string, string>;
+    headers?: Record<string, string>;
+}
+/**
+ * Core adapter interface that all backend implementations must implement
+ */
+export interface IInstanceAdapter {
+    /**
+     * Make an HTTP request to the backend
+     */
+    request<T>(method: HttpMethod, path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Upload a file to the backend
+     */
+    upload<T>(path: string, file: File | Blob, metadata?: Record<string, string>): Promise<T>;
+    /**
+     * Set the workspace context for subsequent requests
+     */
+    setWorkspaceId(workspaceId: string | null): void;
+    /**
+     * Get the current workspace ID
+     */
+    getWorkspaceId(): string | null;
+}
+/**
+ * Base configuration shared by all adapters
+ */
+export interface AdapterConfig {
+    /**
+     * Workspace ID for scoping requests
+     */
+    workspaceId?: string;
+    /**
+     * Callback when authentication fails
+     */
+    onAuthError?: () => void;
+    /**
+     * Custom headers to include in all requests
+     */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * Standard API response format from Instance API
+ */
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Paginated response format
+ */
+export interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+/**
+ * Error thrown by adapters
+ */
+export declare class AdapterError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined);
+}

package/dist/adapters/types.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Instance Adapter Interface
+ * Defines the contract for backend adapters (Edge Functions, Node.js API, etc.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdapterError = void 0;
+/**
+ * Error thrown by adapters
+ */
+class AdapterError extends Error {
+    constructor(message, code, statusCode) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'AdapterError';
+    }
+}
+exports.AdapterError = AdapterError;

package/dist/index.d.ts

@@ -1,29 +1,109 @@
+/**
+ * @tapstack/db - Tapstack Database Client
+ *
+ * A client for interacting with the Tapstack API at api.tapstack.com.
+ * Provides typed access to objects, fields, records, and more.
+ */
 export * from './types';
-export * from './modules/objects';
-export * from './modules/fields';
-export * from './modules/records';
-import { AxiosResponse } from 'axios';
-import { BaseClient, BaseClientConfig } from '@tapstack/core';
+export * from './adapters';
+export * from './modules';
+import { IInstanceAdapter } from './adapters/types';
+import { NodeJSAdapterConfig } from './adapters/nodejs.adapter';
 import { ObjectModule } from './modules/objects';
 import { FieldModule } from './modules/fields';
 import { RecordModule } from './modules/records';
-import { CreateFieldPayload, CreateObjectPayload } from './types';
-export interface TapstackDBClientConfig extends BaseClientConfig {
-}
-export declare class TapstackDBClient extends BaseClient {
+import { OrganizationModule } from './modules/organizations';
+import { WorkspaceModule } from './modules/workspaces';
+import { FileModule } from './modules/files';
+import { AutomationModule } from './modules/automations';
+import { ConversationModule } from './modules/conversations';
+/**
+ * Main Tapstack Database Client
+ * Uses an adapter to communicate with the Tapstack API
+ */
+export declare class TapstackDBClient {
     readonly objects: ObjectModule;
     readonly fields: FieldModule;
     readonly records: RecordModule;
-    constructor(config: TapstackDBClientConfig);
-    getObject(slug: string): Promise<AxiosResponse<any>>;
-    getAllObjects(): Promise<AxiosResponse<any>>;
-    createObject(data: CreateObjectPayload): Promise<AxiosResponse<any>>;
-    updateObject(slug: string, data: Partial<CreateObjectPayload>): Promise<AxiosResponse<any>>;
-    deleteObject(slug: string): Promise<AxiosResponse<any>>;
-    getFields(slug: string): Promise<AxiosResponse<any>>;
-    getField(slug: string, fieldID: string): Promise<AxiosResponse<any>>;
-    createField(slug: string, data: CreateFieldPayload): Promise<AxiosResponse<any>>;
-    updateField(slug: string, fieldID: string, data: Partial<CreateFieldPayload>): Promise<AxiosResponse<any>>;
-    deleteField(slug: string, fieldID: string): Promise<AxiosResponse<any>>;
-    query(slug: string, variables: any): Promise<AxiosResponse<any>>;
+    readonly organizations: OrganizationModule;
+    readonly workspaces: WorkspaceModule;
+    readonly files: FileModule;
+    readonly automations: AutomationModule;
+    readonly conversations: ConversationModule;
+    private adapter;
+    constructor(adapter: IInstanceAdapter);
+    /**
+     * Set the workspace context for all subsequent requests
+     */
+    setWorkspaceId(workspaceId: string | null): void;
+    /**
+     * Get the current workspace ID
+     */
+    getWorkspaceId(): string | null;
+    /**
+     * Get the underlying adapter (for advanced use cases)
+     */
+    getAdapter(): IInstanceAdapter;
+}
+/**
+ * Client configuration options
+ */
+export type TapstackClientConfig = NodeJSAdapterConfig;
+/**
+ * Create a Tapstack API client
+ *
+ * @example
+ * ```typescript
+ * // With API key authentication
+ * const client = createClient({
+ *   apiKey: 'your-api-key',
+ *   workspaceId: 'ws-123',
+ * });
+ *
+ * // With user token (for frontend apps)
+ * const client = createClient({
+ *   getUserToken: async () => accessToken,
+ *   workspaceId: 'ws-123',
+ * });
+ *
+ * // With custom base URL
+ * const client = createClient({
+ *   baseUrl: 'https://custom-api.example.com',
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * // Usage
+ * const objects = await client.objects.list();
+ * const records = await client.records.list('contacts');
+ * ```
+ */
+export declare function createClient(config: TapstackClientConfig): TapstackDBClient;
+/**
+ * Create a client with a custom adapter
+ * Use this for advanced scenarios or custom backends
+ *
+ * @example
+ * ```typescript
+ * class CustomAdapter implements IInstanceAdapter {
+ *   // ... implementation
+ * }
+ *
+ * const client = createCustomClient(new CustomAdapter());
+ * ```
+ */
+export declare function createCustomClient(adapter: IInstanceAdapter): TapstackDBClient;
+/**
+ * @deprecated Use createClient instead
+ */
+export declare const createNodeJSClient: typeof createClient;
+/**
+ * @deprecated Use TapstackClientConfig instead
+ */
+export interface TapstackDBClientConfig {
+    baseURL: string;
+    apiKey: string;
 }
+/**
+ * @deprecated Use createClient instead
+ */
+export declare function createLegacyClient(config: TapstackDBClientConfig): TapstackDBClient;

package/dist/index.js

@@ -1,4 +1,10 @@
 "use strict";
+/**
+ * @tapstack/db - Tapstack Database Client
+ *
+ * A client for interacting with the Tapstack API at api.tapstack.com.
+ * Provides typed access to objects, fields, records, and more.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,54 +20,121 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TapstackDBClient = void 0;
+exports.createNodeJSClient = exports.TapstackDBClient = void 0;
+exports.createClient = createClient;
+exports.createCustomClient = createCustomClient;
+exports.createLegacyClient = createLegacyClient;
+// Export all types
 __exportStar(require("./types"), exports);
-__exportStar(require("./modules/objects"), exports);
-__exportStar(require("./modules/fields"), exports);
-__exportStar(require("./modules/records"), exports);
-const core_1 = require("@tapstack/core");
+// Export adapters
+__exportStar(require("./adapters"), exports);
+// Export modules
+__exportStar(require("./modules"), exports);
+const nodejs_adapter_1 = require("./adapters/nodejs.adapter");
 const objects_1 = require("./modules/objects");
 const fields_1 = require("./modules/fields");
 const records_1 = require("./modules/records");
-class TapstackDBClient extends core_1.BaseClient {
-    constructor(config) {
-        super(config);
-        this.objects = new objects_1.ObjectModule(this.client);
-        this.fields = new fields_1.FieldModule(this.client);
-        this.records = new records_1.RecordModule(this.client);
+const organizations_1 = require("./modules/organizations");
+const workspaces_1 = require("./modules/workspaces");
+const files_1 = require("./modules/files");
+const automations_1 = require("./modules/automations");
+const conversations_1 = require("./modules/conversations");
+/**
+ * Main Tapstack Database Client
+ * Uses an adapter to communicate with the Tapstack API
+ */
+class TapstackDBClient {
+    constructor(adapter) {
+        this.adapter = adapter;
+        this.objects = new objects_1.ObjectModule(adapter);
+        this.fields = new fields_1.FieldModule(adapter);
+        this.records = new records_1.RecordModule(adapter);
+        this.organizations = new organizations_1.OrganizationModule(adapter);
+        this.workspaces = new workspaces_1.WorkspaceModule(adapter);
+        this.files = new files_1.FileModule(adapter);
+        this.automations = new automations_1.AutomationModule(adapter);
+        this.conversations = new conversations_1.ConversationModule(adapter);
     }
-    async getObject(slug) {
-        return this.client.get(`/system/${slug}`);
+    /**
+     * Set the workspace context for all subsequent requests
+     */
+    setWorkspaceId(workspaceId) {
+        this.adapter.setWorkspaceId(workspaceId);
     }
-    async getAllObjects() {
-        return this.client.get(`/system`);
+    /**
+     * Get the current workspace ID
+     */
+    getWorkspaceId() {
+        return this.adapter.getWorkspaceId();
     }
-    async createObject(data) {
-        return this.client.post(`/system`, data);
-    }
-    async updateObject(slug, data) {
-        return this.client.put(`/system/${slug}`, data);
-    }
-    async deleteObject(slug) {
-        return this.client.delete(`/system/${slug}`);
-    }
-    async getFields(slug) {
-        return this.client.get(`/system/${slug}/fields`);
-    }
-    async getField(slug, fieldID) {
-        return this.client.get(`/system/${slug}/fields/${fieldID}`);
-    }
-    async createField(slug, data) {
-        return this.client.post(`/system/${slug}/fields`, data);
-    }
-    async updateField(slug, fieldID, data) {
-        return this.client.put(`/system/${slug}/fields/${fieldID}`, data);
-    }
-    async deleteField(slug, fieldID) {
-        return this.client.delete(`/system/${slug}/fields/${fieldID}`);
-    }
-    async query(slug, variables) {
-        return this.client.post(`/${slug}`, variables);
+    /**
+     * Get the underlying adapter (for advanced use cases)
+     */
+    getAdapter() {
+        return this.adapter;
     }
 }
 exports.TapstackDBClient = TapstackDBClient;
+/**
+ * Create a Tapstack API client
+ *
+ * @example
+ * ```typescript
+ * // With API key authentication
+ * const client = createClient({
+ *   apiKey: 'your-api-key',
+ *   workspaceId: 'ws-123',
+ * });
+ *
+ * // With user token (for frontend apps)
+ * const client = createClient({
+ *   getUserToken: async () => accessToken,
+ *   workspaceId: 'ws-123',
+ * });
+ *
+ * // With custom base URL
+ * const client = createClient({
+ *   baseUrl: 'https://custom-api.example.com',
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * // Usage
+ * const objects = await client.objects.list();
+ * const records = await client.records.list('contacts');
+ * ```
+ */
+function createClient(config) {
+    const adapter = new nodejs_adapter_1.NodeJSAdapter(config);
+    return new TapstackDBClient(adapter);
+}
+/**
+ * Create a client with a custom adapter
+ * Use this for advanced scenarios or custom backends
+ *
+ * @example
+ * ```typescript
+ * class CustomAdapter implements IInstanceAdapter {
+ *   // ... implementation
+ * }
+ *
+ * const client = createCustomClient(new CustomAdapter());
+ * ```
+ */
+function createCustomClient(adapter) {
+    return new TapstackDBClient(adapter);
+}
+// ==================== Legacy Exports (for backwards compatibility) ====================
+/**
+ * @deprecated Use createClient instead
+ */
+exports.createNodeJSClient = createClient;
+/**
+ * @deprecated Use createClient instead
+ */
+function createLegacyClient(config) {
+    const adapter = new nodejs_adapter_1.NodeJSAdapter({
+        baseUrl: config.baseURL.replace('/api', ''),
+        apiKey: config.apiKey,
+    });
+    return new TapstackDBClient(adapter);
+}