appbuild-oceanbase-console 1.11.0 → 1.12.0

package/dist/cjs/sdk.js

@@ -434,9 +434,9 @@ Query.notTouches = (attribute, values) => new Query("notTouches", attribute, [va
 /**
  * Environment detection helpers
  */
-const isBrowser = typeof window !== 'undefined';
+const isBrowser$1 = typeof window !== 'undefined';
 // Memory storage for server-side environment
-class MemoryStorage {
+class MemoryStorage$1 {
     constructor() {
         this.data = new Map();
     }
@@ -450,9 +450,9 @@ class MemoryStorage {
         this.data.delete(key);
     }
 }
-const memoryStorage = new MemoryStorage();
-const getStorage = () => isBrowser ? window.localStorage : memoryStorage;
-const getLocation = () => isBrowser ? window.location : { host: 'nodejs' };
+const memoryStorage$1 = new MemoryStorage$1();
+const getStorage$1 = () => isBrowser$1 ? window.localStorage : memoryStorage$1;
+const getLocation = () => isBrowser$1 ? window.location : { host: 'nodejs' };
 const getWebSocket = () => {
     if (typeof WebSocket !== 'undefined')
         return WebSocket;
@@ -619,7 +619,7 @@ class Client {
                         case 'connected':
                             let session = this.config.session;
                             if (!session) {
-                                const storage = getStorage();
+                                const storage = getStorage$1();
                                 const cookieFallback = storage.getItem('cookieFallback');
                                 if (cookieFallback) {
                                     const cookie = JSON.parse(cookieFallback);
@@ -772,6 +772,19 @@ class Client {
         this.config.mode = value;
         return this;
     }
+    /**
+     * Set Session Refresh Handler
+     *
+     * Set a callback function that will be called when a 401 error is detected.
+     * This allows automatic re-login when session expires.
+     *
+     * @param handler Function that returns a Promise to refresh the session
+     * @returns {this}
+     */
+    setSessionRefreshHandler(handler) {
+        this.sessionRefreshHandler = handler;
+        return this;
+    }
     /**
      * Subscribes to Appwrite events and passes you the payload in realtime.
      *
@@ -818,7 +831,7 @@ class Client {
     prepareRequest(method, url, headers = {}, params = {}) {
         method = method.toUpperCase();
         headers = Object.assign({}, this.headers, headers);
-        const storage = getStorage();
+        const storage = getStorage$1();
         const cookieFallback = storage.getItem('cookieFallback');
         if (cookieFallback) {
             headers['X-Fallback-Cookies'] = cookieFallback;
@@ -906,7 +919,7 @@ class Client {
             return this.call('GET', new URL(this.config.endpoint + '/ping'));
         });
     }
-    call(method, url, headers = {}, params = {}, responseType = 'json') {
+    call(method, url, headers = {}, params = {}, responseType = 'json', retryOn401 = true) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
             const { uri, options } = this.prepareRequest(method, url, headers, params);
@@ -950,6 +963,17 @@ class Client {
                 };
             }
             if (400 <= response.status) {
+                // Handle 401 Unauthorized with automatic re-login
+                if (response.status === 401 && retryOn401 && this.sessionRefreshHandler) {
+                    try {
+                        yield this.sessionRefreshHandler();
+                        // Retry the request once after re-login
+                        return this.call(method, url, headers, params, responseType, false);
+                    }
+                    catch (refreshError) {
+                        // If refresh fails, throw the original 401 error
+                    }
+                }
                 let responseText = '';
                 if (((_b = response.headers.get('content-type')) === null || _b === void 0 ? void 0 : _b.includes('application/json')) || responseType === 'arrayBuffer') {
                     responseText = JSON.stringify(data);
@@ -961,9 +985,9 @@ class Client {
             }
             const cookieFallback = response.headers.get('X-Fallback-Cookies');
             if (cookieFallback) {
-                const storage = getStorage();
+                const storage = getStorage$1();
                 storage.setItem('cookieFallback', cookieFallback);
-                if (isBrowser) {
+                if (isBrowser$1) {
                     console.warn('Appwrite is using localStorage for session management. Increase your security by adding a custom domain as your API endpoint.');
                 }
             }
@@ -13943,6 +13967,26 @@ class Role {
     }
 }
 
+/**
+ * Exception thrown when migration execution fails
+ * Contains information about all failed operations
+ */
+class MigrationExecutionException extends Error {
+    constructor(failedOperations, totalOperations) {
+        const failedCount = failedOperations.length;
+        const succeededCount = totalOperations - failedCount;
+        const errorMessages = failedOperations.map(fo => `  - ${fo.operation.type} for collection ${fo.operation.collectionId}: ${fo.errorMessage}`).join('\n');
+        const message = `Migration execution completed with ${failedCount} failure(s) out of ${totalOperations} operation(s).\n` +
+            `Succeeded: ${succeededCount}, Failed: ${failedCount}\n\n` +
+            `Failed operations:\n${errorMessages}`;
+        super(message);
+        this.name = 'MigrationExecutionException';
+        this.failedOperations = failedOperations;
+        this.totalOperations = totalOperations;
+        this.succeededOperations = succeededCount;
+        this.failedOperationsCount = failedCount;
+    }
+}
 /**
  * Database Schema Migration Tool
  *
@@ -13968,10 +14012,24 @@ class SchemaMigration {
     }
     /**
      * Check if an attribute key is a built-in field that cannot be modified
-     * Built-in fields: id, createdAt, updatedAt
+     * Built-in fields include:
+     * - Fields starting with '$' prefix (e.g., $id, $createdAt, $updatedAt)
+     * - Legacy field names: id, createdAt, updatedAt
      */
     isBuiltInAttribute(key) {
-        return key === 'id' || key === 'createdAt' || key === 'updatedAt' || key === '$id' || key === '$createdAt' || key === '$updatedAt';
+        // Check if starts with '$' prefix (all system/built-in fields)
+        if (key.startsWith('$')) {
+            return true;
+        }
+        // Legacy field names for backwards compatibility
+        return key === 'id' || key === 'createdAt' || key === 'updatedAt';
+    }
+    /**
+     * Check if an index key is a built-in index that cannot be modified
+     * Built-in indexes start with '$' prefix
+     */
+    isBuiltInIndex(key) {
+        return key.startsWith('$');
     }
     /**
      * Check if an index contains any built-in attributes
@@ -13989,6 +14047,7 @@ class SchemaMigration {
             // Store schema for later use in execution
             this._currentSchema = schema;
             const operations = [];
+            const skippedBuiltIns = [];
             // If databaseId is empty, create a database with id "default"
             let databaseId = schema.databaseId;
             if (!databaseId || databaseId.trim() === '') {
@@ -14034,8 +14093,14 @@ class SchemaMigration {
                     // For new tables, create all attributes and indexes
                     // Process target attributes
                     for (const targetAttr of targetCollection.attributes) {
-                        // Skip built-in attributes (id, createdAt, updatedAt)
+                        // Skip built-in attributes (starting with '$' or legacy names)
                         if (this.isBuiltInAttribute(targetAttr.key)) {
+                            skippedBuiltIns.push({
+                                collectionId: collectionId,
+                                key: targetAttr.key,
+                                type: 'attribute',
+                                reason: `Built-in column '${targetAttr.key}' is automatically managed by the system`
+                            });
                             continue;
                         }
                         operations.push({
@@ -14049,9 +14114,24 @@ class SchemaMigration {
                     // Process target indexes
                     if (targetCollection.indexes) {
                         for (const targetIndex of targetCollection.indexes) {
+                            // Skip built-in indexes (starting with '$')
+                            if (this.isBuiltInIndex(targetIndex.key)) {
+                                skippedBuiltIns.push({
+                                    collectionId: collectionId,
+                                    key: targetIndex.key,
+                                    type: 'index',
+                                    reason: `Built-in index '${targetIndex.key}' is automatically managed by the system`
+                                });
+                                continue;
+                            }
                             // Skip indexes that contain built-in attributes
                             if (this.indexContainsBuiltInAttributes(targetIndex)) {
-                                console.log(`Skipping index ${targetIndex.key} because it contains built-in attributes`);
+                                skippedBuiltIns.push({
+                                    collectionId: collectionId,
+                                    key: targetIndex.key,
+                                    type: 'index',
+                                    reason: `Index '${targetIndex.key}' references built-in columns and is automatically managed`
+                                });
                                 continue;
                             }
                             operations.push({
@@ -14090,8 +14170,14 @@ class SchemaMigration {
                     });
                     // Process target attributes
                     for (const targetAttr of targetCollection.attributes) {
-                        // Skip built-in attributes (id, createdAt, updatedAt)
+                        // Skip built-in attributes (starting with '$' or legacy names)
                         if (this.isBuiltInAttribute(targetAttr.key)) {
+                            skippedBuiltIns.push({
+                                collectionId: collectionId,
+                                key: targetAttr.key,
+                                type: 'attribute',
+                                reason: `Built-in column '${targetAttr.key}' is automatically managed by the system`
+                            });
                             continue;
                         }
                         const currentCol = currentColumnsMap.get(targetAttr.key);
@@ -14129,8 +14215,9 @@ class SchemaMigration {
                     }
                     // Check for columns to delete (columns in current but not in target)
                     for (const [key, currentAttr] of currentColumnsMap.entries()) {
-                        // Skip built-in attributes (id, createdAt, updatedAt)
+                        // Skip built-in attributes (starting with '$' or legacy names)
                         if (this.isBuiltInAttribute(key)) {
+                            // Don't add to skippedBuiltIns here since these are existing columns, not from target schema
                             continue;
                         }
                         const targetAttr = targetCollection.attributes.find(a => a.key === key);
@@ -14157,9 +14244,24 @@ class SchemaMigration {
                         });
                         // Process target indexes
                         for (const targetIndex of targetCollection.indexes) {
+                            // Skip built-in indexes (starting with '$')
+                            if (this.isBuiltInIndex(targetIndex.key)) {
+                                skippedBuiltIns.push({
+                                    collectionId: collectionId,
+                                    key: targetIndex.key,
+                                    type: 'index',
+                                    reason: `Built-in index '${targetIndex.key}' is automatically managed by the system`
+                                });
+                                continue;
+                            }
                             // Skip indexes that contain built-in attributes
                             if (this.indexContainsBuiltInAttributes(targetIndex)) {
-                                console.log(`Skipping index ${targetIndex.key} because it contains built-in attributes`);
+                                skippedBuiltIns.push({
+                                    collectionId: collectionId,
+                                    key: targetIndex.key,
+                                    type: 'index',
+                                    reason: `Index '${targetIndex.key}' references built-in columns and is automatically managed`
+                                });
                                 continue;
                             }
                             const currentIndex = currentIndexesMap.get(targetIndex.key);
@@ -14197,10 +14299,15 @@ class SchemaMigration {
                         }
                         // Check for indexes to delete
                         for (const [key, currentIndex] of currentIndexesMap.entries()) {
+                            // Skip built-in indexes (starting with '$')
+                            if (this.isBuiltInIndex(key)) {
+                                // Don't add to skippedBuiltIns here since these are existing indexes, not from target schema
+                                continue;
+                            }
                             // Skip indexes that contain built-in attributes
                             const indexAttributes = currentIndex.columns || [];
                             if (indexAttributes.some((attr) => this.isBuiltInAttribute(attr))) {
-                                console.log(`Skipping deletion of index ${key} because it contains built-in attributes`);
+                                // Don't add to skippedBuiltIns here since these are existing indexes
                                 continue;
                             }
                             const targetIndex = targetCollection.indexes.find(i => i.key === key);
@@ -14242,7 +14349,8 @@ class SchemaMigration {
             };
             return {
                 operations,
-                summary
+                summary,
+                skippedBuiltIns
             };
         });
     }
@@ -14347,22 +14455,60 @@ class SchemaMigration {
                 plan.operations.forEach((op, index) => {
                     console.log(`${index + 1}. [${op.type}] ${op.reason}`);
                 });
+                // Display skipped built-in items
+                if (plan.skippedBuiltIns && plan.skippedBuiltIns.length > 0) {
+                    console.log('\n=== SKIPPED BUILT-IN ITEMS ===');
+                    console.log('The following items are built-in (starting with "$") and automatically managed by the system:');
+                    const skippedAttributes = plan.skippedBuiltIns.filter(item => item.type === 'attribute');
+                    const skippedIndexes = plan.skippedBuiltIns.filter(item => item.type === 'index');
+                    if (skippedAttributes.length > 0) {
+                        console.log('\nBuilt-in Columns:');
+                        skippedAttributes.forEach(item => {
+                            console.log(`  - [${item.collectionId}] ${item.key}: ${item.reason}`);
+                        });
+                    }
+                    if (skippedIndexes.length > 0) {
+                        console.log('\nBuilt-in Indexes:');
+                        skippedIndexes.forEach(item => {
+                            console.log(`  - [${item.collectionId}] ${item.key}: ${item.reason}`);
+                        });
+                    }
+                }
                 return;
             }
             // Store schema for use in executeOperation
             this._currentSchema = schema;
-            // Execute operations in order
+            // Execute operations in order and collect all failures
+            const failedOperations = [];
             for (const operation of plan.operations) {
                 try {
                     yield this.executeOperation(operation);
                 }
                 catch (error) {
                     if (error instanceof AppwriteException) {
-                        throw new Error(`Failed to execute ${operation.type} for collection ${operation.collectionId}: ${error.message}`);
+                        // Collect the error instead of throwing immediately
+                        const errorMessage = `Failed to execute ${operation.type} for collection ${operation.collectionId}: ${error.message}`;
+                        failedOperations.push({
+                            operation,
+                            error,
+                            errorMessage
+                        });
+                    }
+                    else {
+                        // For non-AppwriteException errors, still collect but mark as unexpected
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        failedOperations.push({
+                            operation,
+                            error: new AppwriteException(`Unexpected error: ${errorMessage}`, 500, 'unexpected_error', JSON.stringify(error)),
+                            errorMessage: `Unexpected error during ${operation.type} for collection ${operation.collectionId}: ${errorMessage}`
+                        });
                     }
-                    throw error;
                 }
             }
+            // If there were any failures, throw an exception with all failure details
+            if (failedOperations.length > 0) {
+                throw new MigrationExecutionException(failedOperations, plan.operations.length);
+            }
         });
     }
     /**
@@ -14592,6 +14738,11 @@ class SchemaMigration {
                     if (!operation.index) {
                         throw new Error('Index definition missing for createIndex operation');
                     }
+                    // Skip built-in indexes (starting with '$')
+                    if (this.isBuiltInIndex(operation.index.key)) {
+                        console.log(`Skipping createIndex for built-in index: ${operation.index.key}`);
+                        break;
+                    }
                     // Skip indexes that contain built-in attributes
                     if (this.indexContainsBuiltInAttributes(operation.index)) {
                         console.log(`Skipping createIndex for index ${operation.index.key} because it contains built-in attributes`);
@@ -14613,6 +14764,11 @@ class SchemaMigration {
                     if (!operation.indexKey) {
                         throw new Error('Index key missing for deleteIndex operation');
                     }
+                    // Skip built-in indexes (starting with '$')
+                    if (this.isBuiltInIndex(operation.indexKey)) {
+                        console.log(`Skipping deleteIndex for built-in index: ${operation.indexKey}`);
+                        break;
+                    }
                     // Check if index exists before deleting
                     try {
                         const indexesList = yield this.databases.listIndexes({
@@ -25532,6 +25688,27 @@ class Vcs {
     }
 }
 
+/**
+ * Environment detection helper
+ */
+const isBrowser = typeof window !== 'undefined';
+// Memory storage for server-side environment
+class MemoryStorage {
+    constructor() {
+        this.data = new Map();
+    }
+    getItem(key) {
+        return this.data.get(key) || null;
+    }
+    setItem(key, value) {
+        this.data.set(key, value);
+    }
+    removeItem(key) {
+        this.data.delete(key);
+    }
+}
+const memoryStorage = new MemoryStorage();
+const getStorage = () => isBrowser ? window.localStorage : memoryStorage;
 var RealtimeCode;
 (function (RealtimeCode) {
     RealtimeCode[RealtimeCode["NORMAL_CLOSURE"] = 1000] = "NORMAL_CLOSURE";
@@ -25773,7 +25950,7 @@ class Realtime {
         }
     }
     handleResponseConnected(message) {
-        var _a, _b;
+        var _a;
         if (!message.data) {
             return;
         }
@@ -25781,15 +25958,19 @@ class Realtime {
         let session = this.client.config.session;
         if (!session) {
             try {
-                const cookie = JSON.parse((_a = window.localStorage.getItem('cookieFallback')) !== null && _a !== void 0 ? _a : '{}');
-                session = cookie === null || cookie === void 0 ? void 0 : cookie[`a_session_${this.client.config.project}`];
+                const storage = getStorage();
+                const cookieFallback = storage.getItem('cookieFallback');
+                if (cookieFallback) {
+                    const cookie = JSON.parse(cookieFallback);
+                    session = cookie === null || cookie === void 0 ? void 0 : cookie[`a_session_${this.client.config.project}`];
+                }
             }
             catch (error) {
                 console.error('Failed to parse cookie fallback:', error);
             }
         }
         if (session && !messageData.user) {
-            (_b = this.socket) === null || _b === void 0 ? void 0 : _b.send(JSON.stringify({
+            (_a = this.socket) === null || _a === void 0 ? void 0 : _a.send(JSON.stringify({
                 type: 'authentication',
                 data: {
                     session
@@ -27655,16 +27836,8 @@ exports.MessageStatus = void 0;
     MessageStatus["Failed"] = "failed";
 })(exports.MessageStatus || (exports.MessageStatus = {}));
 
-// 全局默认 API endpoint 配置
-let defaultApiEndpoint = null;
-function setDefaultApiEndpoint(endpoint) {
-    if (!endpoint.startsWith('http://') && !endpoint.startsWith('https://')) {
-        throw new Error('Invalid endpoint URL: ' + endpoint);
-    }
-    defaultApiEndpoint = endpoint;
-}
 function getApiEndpoint(region) {
-    return defaultApiEndpoint || 'https://appbuild.oceanbase.com/v1';
+    return 'https://appbuild.oceanbase.com/v1';
 }
 function createConsoleSdk(client) {
     return {
@@ -27792,6 +27965,7 @@ exports.Health = Health;
 exports.ID = ID;
 exports.Locale = Locale;
 exports.Messaging = Messaging;
+exports.MigrationExecutionException = MigrationExecutionException;
 exports.Migrations = Migrations;
 exports.Operator = Operator;
 exports.Organizations = Organizations;
@@ -27813,5 +27987,4 @@ exports.Vcs = Vcs;
 exports.getApiEndpoint = getApiEndpoint;
 exports.realtime = realtime;
 exports.sdk = sdk;
-exports.setDefaultApiEndpoint = setDefaultApiEndpoint;
 //# sourceMappingURL=sdk.js.map