appwrite-utils-cli 1.9.7 → 1.12.0

package/dist/migrations/yaml/generateImportSchemas.js

@@ -1,6 +1,6 @@
 import fs from "fs";
 import path from "path";
-import { logger } from "../../shared/logging.js";
+import { logger } from 'appwrite-utils-helpers';
 /**
  * Generates JSON Schema for YAML import configurations.
  * Provides IntelliSense support for YAML files in IDEs.
@@ -1135,183 +1135,183 @@ export async function createImportExamples(appwriteFolderPath) {
         fs.mkdirSync(examplesDir, { recursive: true });
     }
     // User import example
-    const userImportExample = `# yaml-language-server: $schema=../.yaml_schemas/import-config.schema.json
-# User Import Configuration Example
-
-source:
-  file: "importData/users.json"
-  basePath: "RECORDS"
-  type: "json"
-
-target:
-  collection: "Users"
-  type: "create"
-  primaryKey: "user_id"
-  createUsers: true
-
-mapping:
-  attributes:
-    - oldKey: "user_id"
-      targetKey: "userId"
-      converters: ["anyToString"]
-      validation:
-        - rule: "required"
-          params: ["{userId}"]
-
-    - oldKey: "email"
-      targetKey: "email"
-      converters: ["anyToString", "stringToLowerCase"]
-      validation:
-        - rule: "email"
-          params: ["{email}"]
-        - rule: "required"
-          params: ["{email}"]
-
-    - oldKey: "full_name"
-      targetKey: "name"
-      converters: ["anyToString", "stringTrim"]
-
-    - oldKey: "profile_image_url"
-      targetKey: "avatar"
-      fileData:
-        path: "{profile_image_url}"
-        name: "{user_id}_avatar"
-      afterImport:
-        - action: "createFileAndUpdateField"
-          params: ["{dbId}", "{collId}", "{docId}", "avatar", "{bucketId}", "{filePath}", "{fileName}"]
-
-    - oldKey: "phone_number"
-      targetKey: "phone"
-      converters: ["anyToString"]
-      validation:
-        - rule: "phone"
-          params: ["{phone}"]
-
-    - oldKey: "is_active"
-      targetKey: "status"
-      converters: ["anyToBoolean"]
-
-  relationships: []
-
-options:
-  batchSize: 25
-  skipValidation: false
-  dryRun: false
-  continueOnError: true
+    const userImportExample = `# yaml-language-server: $schema=../.yaml_schemas/import-config.schema.json
+# User Import Configuration Example
+
+source:
+  file: "importData/users.json"
+  basePath: "RECORDS"
+  type: "json"
+
+target:
+  collection: "Users"
+  type: "create"
+  primaryKey: "user_id"
+  createUsers: true
+
+mapping:
+  attributes:
+    - oldKey: "user_id"
+      targetKey: "userId"
+      converters: ["anyToString"]
+      validation:
+        - rule: "required"
+          params: ["{userId}"]
+
+    - oldKey: "email"
+      targetKey: "email"
+      converters: ["anyToString", "stringToLowerCase"]
+      validation:
+        - rule: "email"
+          params: ["{email}"]
+        - rule: "required"
+          params: ["{email}"]
+
+    - oldKey: "full_name"
+      targetKey: "name"
+      converters: ["anyToString", "stringTrim"]
+
+    - oldKey: "profile_image_url"
+      targetKey: "avatar"
+      fileData:
+        path: "{profile_image_url}"
+        name: "{user_id}_avatar"
+      afterImport:
+        - action: "createFileAndUpdateField"
+          params: ["{dbId}", "{collId}", "{docId}", "avatar", "{bucketId}", "{filePath}", "{fileName}"]
+
+    - oldKey: "phone_number"
+      targetKey: "phone"
+      converters: ["anyToString"]
+      validation:
+        - rule: "phone"
+          params: ["{phone}"]
+
+    - oldKey: "is_active"
+      targetKey: "status"
+      converters: ["anyToBoolean"]
+
+  relationships: []
+
+options:
+  batchSize: 25
+  skipValidation: false
+  dryRun: false
+  continueOnError: true
 `;
     // Product import example with relationships
-    const productImportExample = `# yaml-language-server: $schema=../.yaml_schemas/import-config.schema.json
-# Product Import Configuration Example
-
-source:
-  file: "importData/products.json"
-  basePath: "products"
-  type: "json"
-
-target:
-  collection: "Products"
-  type: "create"
-  primaryKey: "product_id"
-  createUsers: false
-
-mapping:
-  attributes:
-    - oldKey: "product_id"
-      targetKey: "productId"
-      converters: ["anyToString"]
-
-    - oldKey: "name"
-      targetKey: "name"
-      converters: ["anyToString", "stringTrim"]
-      validation:
-        - rule: "required"
-          params: ["{name}"]
-        - rule: "minLength"
-          params: ["{name}", "3"]
-
-    - oldKey: "description"
-      targetKey: "description"
-      converters: ["anyToString"]
-
-    - oldKey: "price"
-      targetKey: "price"
-      converters: ["anyToNumber"]
-      validation:
-        - rule: "numeric"
-          params: ["{price}"]
-        - rule: "positive"
-          params: ["{price}"]
-
-    - oldKey: "category_id"
-      targetKey: "categoryId"
-      converters: ["anyToString"]
-
-    - oldKey: "image_urls"
-      targetKey: "images"
-      fileData:
-        path: "assets/products/{product_id}/"
-        name: "product_{product_id}_{index}"
-      afterImport:
-        - action: "createFileAndUpdateField"
-          params: ["{dbId}", "{collId}", "{docId}", "images", "{bucketId}", "{filePath}", "{fileName}"]
-
-    - valueToSet: "active"
-      targetKey: "status"
-
-  relationships:
-    - sourceField: "category_id"
-      targetField: "categoryId"
-      targetCollection: "Categories"
-      fieldToSet: "categoryId"
-
-    - sourceField: "vendor_id"
-      targetField: "vendorId"
-      targetCollection: "Vendors"
-
-options:
-  batchSize: 50
-  skipValidation: false
-  dryRun: false
-  continueOnError: true
+    const productImportExample = `# yaml-language-server: $schema=../.yaml_schemas/import-config.schema.json
+# Product Import Configuration Example
+
+source:
+  file: "importData/products.json"
+  basePath: "products"
+  type: "json"
+
+target:
+  collection: "Products"
+  type: "create"
+  primaryKey: "product_id"
+  createUsers: false
+
+mapping:
+  attributes:
+    - oldKey: "product_id"
+      targetKey: "productId"
+      converters: ["anyToString"]
+
+    - oldKey: "name"
+      targetKey: "name"
+      converters: ["anyToString", "stringTrim"]
+      validation:
+        - rule: "required"
+          params: ["{name}"]
+        - rule: "minLength"
+          params: ["{name}", "3"]
+
+    - oldKey: "description"
+      targetKey: "description"
+      converters: ["anyToString"]
+
+    - oldKey: "price"
+      targetKey: "price"
+      converters: ["anyToNumber"]
+      validation:
+        - rule: "numeric"
+          params: ["{price}"]
+        - rule: "positive"
+          params: ["{price}"]
+
+    - oldKey: "category_id"
+      targetKey: "categoryId"
+      converters: ["anyToString"]
+
+    - oldKey: "image_urls"
+      targetKey: "images"
+      fileData:
+        path: "assets/products/{product_id}/"
+        name: "product_{product_id}_{index}"
+      afterImport:
+        - action: "createFileAndUpdateField"
+          params: ["{dbId}", "{collId}", "{docId}", "images", "{bucketId}", "{filePath}", "{fileName}"]
+
+    - valueToSet: "active"
+      targetKey: "status"
+
+  relationships:
+    - sourceField: "category_id"
+      targetField: "categoryId"
+      targetCollection: "Categories"
+      fieldToSet: "categoryId"
+
+    - sourceField: "vendor_id"
+      targetField: "vendorId"
+      targetCollection: "Vendors"
+
+options:
+  batchSize: 50
+  skipValidation: false
+  dryRun: false
+  continueOnError: true
 `;
     // Update example
-    const updateExample = `# yaml-language-server: $schema=../.yaml_schemas/import-config.schema.json
-# Update Configuration Example
-
-source:
-  file: "importData/user_updates.json"
-  type: "json"
-
-target:
-  collection: "Users"
-  type: "update"
-  primaryKey: "user_id"
-
-mapping:
-  attributes:
-    - oldKey: "updated_email"
-      targetKey: "email"
-      converters: ["anyToString", "stringToLowerCase"]
-      validation:
-        - rule: "email"
-          params: ["{email}"]
-
-    - oldKey: "new_phone"
-      targetKey: "phone"
-      converters: ["anyToString"]
-
-    - oldKey: "last_login"
-      targetKey: "lastLoginAt"
-      converters: ["anyToDate", "dateToTimestamp"]
-
-  relationships: []
-
-options:
-  batchSize: 100
-  continueOnError: true
-  updateMapping:
-    originalIdField: "user_id"
-    targetField: "userId"
+    const updateExample = `# yaml-language-server: $schema=../.yaml_schemas/import-config.schema.json
+# Update Configuration Example
+
+source:
+  file: "importData/user_updates.json"
+  type: "json"
+
+target:
+  collection: "Users"
+  type: "update"
+  primaryKey: "user_id"
+
+mapping:
+  attributes:
+    - oldKey: "updated_email"
+      targetKey: "email"
+      converters: ["anyToString", "stringToLowerCase"]
+      validation:
+        - rule: "email"
+          params: ["{email}"]
+
+    - oldKey: "new_phone"
+      targetKey: "phone"
+      converters: ["anyToString"]
+
+    - oldKey: "last_login"
+      targetKey: "lastLoginAt"
+      converters: ["anyToDate", "dateToTimestamp"]
+
+  relationships: []
+
+options:
+  batchSize: 100
+  continueOnError: true
+  updateMapping:
+    originalIdField: "user_id"
+    targetField: "userId"
 `;
     // Write example files
     const examples = [

package/dist/setupCommands.d.ts

@@ -1,4 +1,4 @@
-import { type ApiMode } from "./utils/versionDetection.js";
+import { type ApiMode } from "appwrite-utils-helpers";
 /**
  * Terminology configuration for API mode-specific naming
  */

package/dist/setupCommands.js

@@ -1,12 +1,11 @@
 import { mkdirSync, writeFileSync, existsSync } from "node:fs";
 import path from "node:path";
 import { ulid } from "ulidx";
-import { MessageFormatter } from "./shared/messageFormatter.js";
-import { detectAppwriteVersionCached, fetchServerVersion, isVersionAtLeast } from "./utils/versionDetection.js";
-import { loadAppwriteProjectConfig, findAppwriteProjectConfig, isTablesDBProject } from "./utils/projectConfig.js";
-import { findYamlConfig, generateYamlConfigTemplate } from "./config/yamlConfig.js";
-import { loadYamlConfig } from "./config/yamlConfig.js";
-import { hasSessionAuth } from "./utils/sessionAuth.js";
+import { MessageFormatter } from "appwrite-utils-helpers";
+import { detectAppwriteVersionCached, fetchServerVersion, isVersionAtLeast } from "appwrite-utils-helpers";
+import { loadAppwriteProjectConfig, findAppwriteProjectConfig, isTablesDBProject } from "appwrite-utils-helpers";
+import { findYamlConfig, generateYamlConfigTemplate, loadYamlConfig } from "appwrite-utils-helpers";
+import { hasSessionAuth } from "appwrite-utils-helpers";
 /**
  * Get terminology configuration based on API mode
  */

package/dist/setupController.js

@@ -2,7 +2,7 @@ import { setupDirsFiles } from "./utils/setupFiles.js";
 import { loadConfig } from "./utils/loadConfigs.js";
 import path from "path";
 import fs from "fs";
-import { MessageFormatter } from "./shared/messageFormatter.js";
+import { MessageFormatter } from "appwrite-utils-helpers";
 export class SetupController {
     currentDir;
     config = null;

package/dist/shared/backupTracking.d.ts

@@ -1,4 +1,4 @@
-import type { DatabaseAdapter } from "../adapters/DatabaseAdapter.js";
+import type { DatabaseAdapter } from "appwrite-utils-helpers";
 import { type BackupMetadata } from "./backupMetadataSchema.js";
 /**
  * Creates the backup tracking table in the specified database

package/dist/shared/backupTracking.js

@@ -1,5 +1,5 @@
-import { logger } from "./logging.js";
-import { tryAwaitWithRetry } from "../utils/helperFunctions.js";
+import { logger } from 'appwrite-utils-helpers';
+import { tryAwaitWithRetry } from "appwrite-utils-helpers";
 import { Query, ID } from "node-appwrite";
 import { BACKUP_TABLE_ID, BACKUP_TABLE_NAME, BackupMetadataSchema } from "./backupMetadataSchema.js";
 /**

package/dist/shared/confirmationDialogs.js

@@ -1,6 +1,6 @@
 import inquirer from "inquirer";
 import chalk from "chalk";
-import { MessageFormatter } from "./messageFormatter.js";
+import { MessageFormatter } from 'appwrite-utils-helpers';
 export class ConfirmationDialogs {
     /**
      * Shows a confirmation dialog for destructive operations

package/dist/shared/migrationHelpers.d.ts

@@ -1,6 +1,6 @@
 import { type Databases } from "node-appwrite";
 import { z } from "zod";
-import type { DatabaseAdapter } from "../adapters/DatabaseAdapter.js";
+import type { DatabaseAdapter } from "appwrite-utils-helpers";
 /**
  * Object that contains the context for an action that needs to be executed after import
  * Used in the afterImportActionsDefinitions

package/dist/shared/migrationHelpers.js

@@ -2,10 +2,10 @@ import { ID, Query } from "node-appwrite";
 import { BatchSchema, OperationSchema } from "../storage/schemas.js";
 import { AttributeMappingsSchema } from "appwrite-utils";
 import { z } from "zod";
-import { logger } from "./logging.js";
-import { tryAwaitWithRetry } from "../utils/helperFunctions.js";
+import { logger } from 'appwrite-utils-helpers';
+import { tryAwaitWithRetry } from "appwrite-utils-helpers";
 import { findOrCreateOperation as findOrCreateOp, updateOperation as updateOp, getOperation as getOp } from "./operationsTable.js";
-import { MessageFormatter } from "./messageFormatter.js";
+import { MessageFormatter } from 'appwrite-utils-helpers';
 /**
  * Object that contains the context for an action that needs to be executed after import
  * Used in the afterImportActionsDefinitions
@@ -95,7 +95,7 @@ const findOrCreateOperationLegacy = async (database, collectionId, operationType
 export const findOrCreateOperation = async (db, databaseId, operationType, collectionId, data) => {
     // Use new operations table system
     return await findOrCreateOp(db, databaseId, operationType, {
-        targetCollection: collectionId,
+        targetTable: collectionId,
         data: data
     });
 };

package/dist/shared/operationQueue.d.ts

@@ -1,6 +1,6 @@
 import { type Databases, type Models } from "node-appwrite";
 import type { Attribute } from "appwrite-utils";
-import type { DatabaseAdapter } from "../adapters/DatabaseAdapter.js";
+import type { DatabaseAdapter } from "appwrite-utils-helpers";
 export interface QueuedOperation {
     type: "attribute";
     collectionId?: string;

package/dist/shared/operationQueue.js

@@ -1,9 +1,8 @@
 import { Query } from "node-appwrite";
-import { createOrUpdateAttributeWithStatusCheck } from "../collections/attributes.js";
+import { createOrUpdateAttributeWithStatusCheck } from "../collections/columns.js";
 import { fetchAndCacheCollectionByName } from "../collections/methods.js";
-import { tryAwaitWithRetry } from "../utils/helperFunctions.js";
-import { logger } from "../shared/logging.js";
-import { MessageFormatter } from "../shared/messageFormatter.js";
+import { tryAwaitWithRetry } from "appwrite-utils-helpers";
+import { logger, MessageFormatter } from "appwrite-utils-helpers";
 // Global state management
 export const queuedOperations = [];
 export const nameToIdMapping = new Map();

package/dist/shared/operationsTable.d.ts

@@ -1,4 +1,4 @@
-import type { DatabaseAdapter } from "../adapters/DatabaseAdapter.js";
+import type { DatabaseAdapter } from "appwrite-utils-helpers";
 import { type OperationRecord } from "./operationsTableSchema.js";
 /**
  * Creates the operations tracking table in the specified database

package/dist/shared/operationsTable.js

@@ -1,5 +1,5 @@
-import { logger } from "./logging.js";
-import { tryAwaitWithRetry } from "../utils/helperFunctions.js";
+import { logger } from 'appwrite-utils-helpers';
+import { tryAwaitWithRetry } from "appwrite-utils-helpers";
 import { Query, ID } from "node-appwrite";
 import { OPERATIONS_TABLE_ID, OPERATIONS_TABLE_NAME, OperationRecordSchema, } from "./operationsTableSchema.js";
 /**
@@ -25,58 +25,51 @@ async function tableExists(db, databaseId) {
  * Table is created with underscore prefix to indicate it's a system table
  */
 export async function createOperationsTable(db, databaseId) {
-    // Check if table already exists
     const exists = await tableExists(db, databaseId);
-    if (exists) {
-        logger.debug("Operations table already exists", {
+    if (!exists) {
+        logger.info("Creating operations tracking table", {
             databaseId,
             tableId: OPERATIONS_TABLE_ID,
         });
-        return;
-    }
-    logger.info("Creating operations tracking table", {
-        databaseId,
-        tableId: OPERATIONS_TABLE_ID,
-    });
-    // Create table
-    await tryAwaitWithRetry(async () => {
-        await db.createTable({
-            databaseId,
-            id: OPERATIONS_TABLE_ID,
-            name: OPERATIONS_TABLE_NAME,
+        await tryAwaitWithRetry(async () => {
+            await db.createTable({
+                databaseId,
+                id: OPERATIONS_TABLE_ID,
+                name: OPERATIONS_TABLE_NAME,
+            });
         });
-    });
-    // Create attributes with retry logic
+    }
+    // Always ensure attributes exist (handles partial creation from previous runs)
     const attributes = [
         {
             key: "operationType",
             type: "string",
-            size: 50,
+            size: 255,
             required: true,
         },
         {
-            key: "targetCollection",
+            key: "targetTable",
             type: "string",
-            size: 50,
+            size: 255,
             required: false,
         },
         {
             key: "status",
             type: "enum",
             elements: ["pending", "in_progress", "completed", "failed", "cancelled"],
-            required: true,
+            required: false,
             default: "pending",
         },
         {
             key: "progress",
             type: "integer",
-            required: true,
+            required: false,
             default: 0,
         },
         {
             key: "total",
             type: "integer",
-            required: true,
+            required: false,
             default: 0,
         },
         {
@@ -88,20 +81,28 @@ export async function createOperationsTable(db, databaseId) {
         {
             key: "error",
             type: "string",
-            size: 10000,
+            size: 65535,
             required: false,
         },
     ];
     for (const attr of attributes) {
-        await tryAwaitWithRetry(async () => {
+        try {
             await db.createAttribute({
                 databaseId,
                 tableId: OPERATIONS_TABLE_ID,
                 ...attr,
             });
-        });
+        }
+        catch (error) {
+            // Attribute may already exist from a previous run — that's fine, skip it
+            const msg = error instanceof Error ? error.message : String(error);
+            if (msg.includes("already exists") || msg.includes("column_already_exists")) {
+                continue;
+            }
+            throw error;
+        }
     }
-    logger.info("Operations tracking table created successfully", {
+    logger.info("Operations tracking table ready", {
         databaseId,
         tableId: OPERATIONS_TABLE_ID,
         attributes: attributes.length,
@@ -120,8 +121,8 @@ export async function findOrCreateOperation(db, databaseId, operationType, param
             Query.equal("operationType", operationType),
             Query.equal("status", "pending"),
         ];
-        if (params?.targetCollection) {
-            queries.push(Query.equal("targetCollection", params.targetCollection));
+        if (params?.targetTable) {
+            queries.push(Query.equal("targetTable", params.targetTable));
         }
         const response = await db.listRows({
             databaseId,
@@ -145,7 +146,7 @@ export async function findOrCreateOperation(db, databaseId, operationType, param
     // Create new operation
     const newOperation = {
         operationType,
-        targetCollection: params?.targetCollection,
+        targetTable: params?.targetTable,
         status: "pending",
         progress: params?.progress ?? 0,
         total: params?.total ?? 0,
@@ -172,8 +173,8 @@ export async function updateOperation(db, databaseId, operationId, updates) {
     const updateData = {};
     if (updates.operationType !== undefined)
         updateData.operationType = updates.operationType;
-    if (updates.targetCollection !== undefined)
-        updateData.targetCollection = updates.targetCollection;
+    if (updates.targetTable !== undefined)
+        updateData.targetTable = updates.targetTable;
     if (updates.status !== undefined)
         updateData.status = updates.status;
     if (updates.progress !== undefined)

package/dist/shared/operationsTableSchema.d.ts

@@ -10,7 +10,7 @@ export interface OperationRecord {
     $createdAt: string;
     $updatedAt: string;
     operationType: string;
-    targetCollection?: string;
+    targetTable?: string;
     status: OperationStatus;
     progress: number;
     total: number;
@@ -31,7 +31,7 @@ export declare const OperationRecordSchema: z.ZodObject<{
     $createdAt: z.ZodString;
     $updatedAt: z.ZodString;
     operationType: z.ZodString;
-    targetCollection: z.ZodOptional<z.ZodString>;
+    targetTable: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
         pending: "pending";
         in_progress: "in_progress";
@@ -44,5 +44,5 @@ export declare const OperationRecordSchema: z.ZodObject<{
     data: z.ZodOptional<z.ZodAny>;
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare const OPERATIONS_TABLE_ID = "_appwrite_operations";
+export declare const OPERATIONS_TABLE_ID = "appwrite_operations";
 export declare const OPERATIONS_TABLE_NAME = "Operations Tracking";