@wowsql/sdk 3.6.0 → 3.8.0

package/dist/schema.js

@@ -1,116 +1,245 @@
 "use strict";
 /**
- * Schema management client for WowSQL.
- * Requires SERVICE ROLE key.
+ * WowSQL Schema SDK - DDL operations for PostgreSQL.
+ * Requires a SERVICE ROLE key (wowsql_service_...).
+ *
+ * @version 3.0.0
+ * @license MIT
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WowSQLSchema = void 0;
+exports.WowSQLSchema = exports.SchemaPermissionError = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("./errors");
+Object.defineProperty(exports, "SchemaPermissionError", { enumerable: true, get: function () { return errors_1.SchemaPermissionError; } });
+// ==================== Schema Client ====================
 class WowSQLSchema {
     /**
      * Initialize schema client.
      *
-     * ⚠️ IMPORTANT: Requires SERVICE ROLE key, not anonymous key!
+     * Requires a SERVICE ROLE key. Anonymous keys cannot perform DDL operations.
      *
-     * @param projectUrl - Project URL (e.g., "https://myproject.wowsql.com")
-     * @param serviceKey - SERVICE ROLE key (not anonymous key!)
+     * @example
+     * ```typescript
+     * const schema = new WowSQLSchema({
+     *   projectUrl: 'myproject',
+     *   serviceKey: 'wowsql_service_...'
+     * });
+     *
+     * await schema.createTable({
+     *   tableName: 'products',
+     *   columns: [
+     *     { name: 'id', type: 'SERIAL', auto_increment: true },
+     *     { name: 'name', type: 'VARCHAR(255)', nullable: false },
+     *     { name: 'price', type: 'NUMERIC(10,2)', default: '0' },
+     *     { name: 'tags', type: 'TEXT[]' },
+     *     { name: 'metadata', type: 'JSONB', default: "'{}'" },
+     *     { name: 'created_at', type: 'TIMESTAMPTZ', default: 'CURRENT_TIMESTAMP' }
+     *   ],
+     *   primaryKey: 'id',
+     *   indexes: ['name']
+     * });
+     * ```
      */
-    constructor(projectUrl, serviceKey) {
-        this.baseUrl = projectUrl.replace(/\/$/, '');
-        this.serviceKey = serviceKey;
+    constructor(config, serviceKey) {
+        if (typeof config === 'string') {
+            this.baseUrl = config.replace(/\/$/, '');
+            if (!this.baseUrl.startsWith('http')) {
+                this.baseUrl = `https://${this.baseUrl}`;
+            }
+            this.client = axios_1.default.create({
+                baseURL: `${this.baseUrl}/api/v2/schema`,
+                headers: {
+                    'Authorization': `Bearer ${serviceKey}`,
+                    'Content-Type': 'application/json',
+                },
+                timeout: 30000,
+            });
+        }
+        else {
+            const protocol = config.secure !== false ? 'https' : 'http';
+            if (config.projectUrl.startsWith('http://') || config.projectUrl.startsWith('https://')) {
+                this.baseUrl = config.projectUrl.replace(/\/+$/, '');
+            }
+            else {
+                const domain = config.baseDomain || 'wowsql.com';
+                if (config.projectUrl.includes(`.${domain}`) || config.projectUrl.endsWith(domain)) {
+                    this.baseUrl = `${protocol}://${config.projectUrl}`;
+                }
+                else {
+                    this.baseUrl = `${protocol}://${config.projectUrl}.${domain}`;
+                }
+            }
+            this.client = axios_1.default.create({
+                baseURL: `${this.baseUrl}/api/v2/schema`,
+                headers: {
+                    'Authorization': `Bearer ${config.serviceKey}`,
+                    'Content-Type': 'application/json',
+                },
+                timeout: config.timeout || 30000,
+            });
+        }
+        this.client.interceptors.response.use((response) => response, (error) => {
+            if (error.response) {
+                const data = error.response.data;
+                const message = data?.detail || data?.message || error.message;
+                if (error.response.status === 403) {
+                    throw new errors_1.SchemaPermissionError(message, 403, data);
+                }
+                throw new errors_1.WOWSQLError(message, error.response.status, data);
+            }
+            throw new errors_1.WOWSQLError(error.message);
+        });
     }
     /**
-     * Create a new table.
+     * Create a new table with PostgreSQL column types.
+     *
+     * Supported PostgreSQL types: SERIAL, BIGSERIAL, VARCHAR(n), TEXT, INT, BIGINT,
+     * BOOLEAN, NUMERIC(p,s), REAL, DOUBLE PRECISION, TIMESTAMPTZ, DATE, TIME,
+     * UUID, JSONB, TEXT[], INT[], BYTEA, etc.
      */
     async createTable(options) {
-        const url = `${this.baseUrl}/api/v2/schema/tables`;
-        const response = await fetch(url, {
-            method: 'POST',
-            headers: {
-                'Authorization': `Bearer ${this.serviceKey}`,
-                'Content-Type': 'application/json'
-            },
-            body: JSON.stringify({
-                table_name: options.tableName,
-                columns: options.columns,
-                primary_key: options.primaryKey,
-                indexes: options.indexes
-            })
+        const response = await this.client.post('/tables', {
+            table_name: options.tableName,
+            columns: options.columns,
+            primary_key: options.primaryKey,
+            indexes: options.indexes,
         });
-        if (response.status === 403) {
-            throw new Error('Schema operations require a SERVICE ROLE key. ' +
-                'You are using an anonymous key which cannot modify database schema.');
-        }
-        if (!response.ok) {
-            const error = await response.json();
-            throw new Error(`Failed to create table: ${error.detail || response.statusText}`);
-        }
-        return response.json();
+        return response.data;
     }
     /**
      * Alter an existing table.
+     *
+     * Operations:
+     * - `add_column`: Add a new column
+     * - `drop_column`: Remove a column
+     * - `modify_column`: Change column type/constraints (PostgreSQL ALTER COLUMN ... TYPE)
+     * - `rename_column`: Rename a column
      */
     async alterTable(options) {
-        const url = `${this.baseUrl}/api/v2/schema/tables/${options.tableName}`;
-        const response = await fetch(url, {
-            method: 'PATCH',
-            headers: {
-                'Authorization': `Bearer ${this.serviceKey}`,
-                'Content-Type': 'application/json'
-            },
-            body: JSON.stringify(options)
+        const response = await this.client.patch(`/tables/${options.tableName}`, {
+            table_name: options.tableName,
+            operation: options.operation,
+            column_name: options.columnName,
+            column_type: options.columnType,
+            new_column_name: options.newColumnName,
+            nullable: options.nullable,
+            default: options.default,
         });
-        if (response.status === 403) {
-            throw new Error('Schema operations require a SERVICE ROLE key.');
-        }
-        if (!response.ok) {
-            const error = await response.json();
-            throw new Error(`Failed to alter table: ${error.detail || response.statusText}`);
-        }
-        return response.json();
+        return response.data;
     }
     /**
      * Drop a table.
      *
-     * ⚠️ WARNING: This operation cannot be undone!
+     * WARNING: This operation cannot be undone!
+     *
+     * @param tableName - Table to drop
+     * @param cascade - If true, also drops dependent objects (foreign keys, views, etc.)
      */
     async dropTable(tableName, cascade = false) {
-        const url = `${this.baseUrl}/api/v2/schema/tables/${tableName}?cascade=${cascade}`;
-        const response = await fetch(url, {
-            method: 'DELETE',
-            headers: {
-                'Authorization': `Bearer ${this.serviceKey}`
-            }
+        const response = await this.client.delete(`/tables/${tableName}`, {
+            params: { cascade },
         });
-        if (response.status === 403) {
-            throw new Error('Schema operations require a SERVICE ROLE key.');
-        }
-        if (!response.ok) {
-            const error = await response.json();
-            throw new Error(`Failed to drop table: ${error.detail || response.statusText}`);
-        }
-        return response.json();
+        return response.data;
     }
     /**
      * Execute raw SQL for schema operations.
+     *
+     * Only DDL statements are allowed: CREATE TABLE, ALTER TABLE, DROP TABLE,
+     * CREATE INDEX, DROP INDEX, CREATE EXTENSION, CREATE TYPE, ALTER TYPE,
+     * CREATE SEQUENCE, ALTER SEQUENCE, DROP SEQUENCE.
+     *
+     * @param sql - SQL DDL statement
      */
     async executeSQL(sql) {
-        const url = `${this.baseUrl}/api/v2/schema/execute`;
-        const response = await fetch(url, {
-            method: 'POST',
-            headers: {
-                'Authorization': `Bearer ${this.serviceKey}`,
-                'Content-Type': 'application/json'
-            },
-            body: JSON.stringify({ sql })
+        const response = await this.client.post('/execute', { sql });
+        return response.data;
+    }
+    // ==================== Convenience Methods ====================
+    /**
+     * Add a column to an existing table.
+     */
+    async addColumn(tableName, columnName, columnType, options) {
+        return this.alterTable({
+            tableName,
+            operation: 'add_column',
+            columnName,
+            columnType,
+            nullable: options?.nullable,
+            default: options?.default,
         });
-        if (response.status === 403) {
-            throw new Error('Schema operations require a SERVICE ROLE key.');
-        }
-        if (!response.ok) {
-            const error = await response.json();
-            throw new Error(`Failed to execute SQL: ${error.detail || response.statusText}`);
-        }
-        return response.json();
+    }
+    /**
+     * Drop a column from a table.
+     */
+    async dropColumn(tableName, columnName) {
+        return this.alterTable({
+            tableName,
+            operation: 'drop_column',
+            columnName,
+        });
+    }
+    /**
+     * Rename a column in a table.
+     */
+    async renameColumn(tableName, oldName, newName) {
+        return this.alterTable({
+            tableName,
+            operation: 'rename_column',
+            columnName: oldName,
+            newColumnName: newName,
+        });
+    }
+    /**
+     * Modify a column's type or constraints.
+     */
+    async modifyColumn(tableName, columnName, columnType, options) {
+        return this.alterTable({
+            tableName,
+            operation: 'modify_column',
+            columnName,
+            columnType,
+            nullable: options?.nullable,
+            default: options?.default,
+        });
+    }
+    /**
+     * Create an index using raw SQL.
+     *
+     * @param tableName - Table to index
+     * @param columnNames - Column(s) to include in the index
+     * @param options - Index options
+     */
+    async createIndex(tableName, columnNames, options) {
+        const cols = Array.isArray(columnNames) ? columnNames : [columnNames];
+        const indexName = options?.name || `idx_${tableName}_${cols.join('_')}`;
+        const unique = options?.unique ? 'UNIQUE ' : '';
+        const using = options?.using ? ` USING ${options.using}` : '';
+        const colList = cols.map(c => `"${c}"`).join(', ');
+        const sql = `CREATE ${unique}INDEX IF NOT EXISTS "${indexName}" ON "${tableName}"${using} (${colList})`;
+        return this.executeSQL(sql);
+    }
+    /**
+     * List all tables in the database.
+     * Uses the v2 tables endpoint (GET /api/v2/tables).
+     */
+    async listTables() {
+        const response = await this.client.get('/tables', {
+            baseURL: `${this.baseUrl}/api/v2`,
+        });
+        return response.data.tables;
+    }
+    /**
+     * Get the schema for a specific table.
+     * Uses the v2 tables endpoint (GET /api/v2/tables/{name}/schema).
+     */
+    async getTableSchema(tableName) {
+        const response = await this.client.get(`/tables/${tableName}/schema`, {
+            baseURL: `${this.baseUrl}/api/v2`,
+        });
+        return response.data;
     }
 }
 exports.WowSQLSchema = WowSQLSchema;