@njdamstra/appwrite-utils-cli 1.10.0 → 1.11.0

package/src/collections/attributes.ts

@@ -593,6 +593,74 @@ const createLegacyAttribute = async (
         attribute.array || false
       );
       break;
+    case "varchar":
+      await db.createVarcharAttribute(
+        dbId,
+        collectionId,
+        attribute.key,
+        (attribute as any).size || 255,
+        attribute.required || false,
+        (attribute as any).xdefault !== undefined && !attribute.required
+          ? (attribute as any).xdefault
+          : undefined,
+        attribute.array || false,
+        (attribute as any).encrypt
+      );
+      break;
+    case "text":
+    case "mediumtext":
+    case "longtext": {
+      const createFn = attribute.type === "text"
+        ? db.createTextAttribute.bind(db)
+        : attribute.type === "mediumtext"
+          ? db.createMediumtextAttribute.bind(db)
+          : db.createLongtextAttribute.bind(db);
+      await createFn(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        (attribute as any).xdefault !== undefined && !attribute.required
+          ? (attribute as any).xdefault
+          : undefined,
+        attribute.array || false,
+        (attribute as any).encrypt
+      );
+      break;
+    }
+    case "point":
+      await db.createPointAttribute(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        (attribute as any).xdefault !== undefined && !attribute.required
+          ? (attribute as any).xdefault
+          : undefined
+      );
+      break;
+    case "line":
+      await db.createLineAttribute(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        (attribute as any).xdefault !== undefined && !attribute.required
+          ? (attribute as any).xdefault
+          : undefined
+      );
+      break;
+    case "polygon":
+      await db.createPolygonAttribute(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        (attribute as any).xdefault !== undefined && !attribute.required
+          ? (attribute as any).xdefault
+          : undefined
+      );
+      break;
     case "relationship":
       await db.createRelationshipAttribute(
         dbId,
@@ -615,6 +683,10 @@ const createLegacyAttribute = async (
           type: (attribute as any).type,
           supportedTypes: [
             "string",
+            "varchar",
+            "text",
+            "mediumtext",
+            "longtext",
             "integer",
             "double",
             "float",
@@ -624,6 +696,9 @@ const createLegacyAttribute = async (
             "ip",
             "url",
             "enum",
+            "point",
+            "line",
+            "polygon",
             "relationship",
           ],
           operation: "createLegacyAttribute",
@@ -770,6 +845,70 @@ const updateLegacyAttribute = async (
           : null
       );
       break;
+    case "varchar":
+      await db.updateVarcharAttribute(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        !attribute.required && (attribute as any).xdefault !== undefined
+          ? (attribute as any).xdefault
+          : null,
+        (attribute as any).size
+      );
+      break;
+    case "text":
+    case "mediumtext":
+    case "longtext": {
+      const updateFn = attribute.type === "text"
+        ? db.updateTextAttribute.bind(db)
+        : attribute.type === "mediumtext"
+          ? db.updateMediumtextAttribute.bind(db)
+          : db.updateLongtextAttribute.bind(db);
+      await updateFn(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        !attribute.required && (attribute as any).xdefault !== undefined
+          ? (attribute as any).xdefault
+          : null
+      );
+      break;
+    }
+    case "point":
+      await db.updatePointAttribute(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        !attribute.required && (attribute as any).xdefault !== undefined
+          ? (attribute as any).xdefault
+          : null
+      );
+      break;
+    case "line":
+      await db.updateLineAttribute(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        !attribute.required && (attribute as any).xdefault !== undefined
+          ? (attribute as any).xdefault
+          : null
+      );
+      break;
+    case "polygon":
+      await db.updatePolygonAttribute(
+        dbId,
+        collectionId,
+        attribute.key,
+        attribute.required || false,
+        !attribute.required && (attribute as any).xdefault !== undefined
+          ? (attribute as any).xdefault
+          : null
+      );
+      break;
     case "relationship":
       await db.updateRelationshipAttribute(
         dbId,
@@ -1048,6 +1187,14 @@ const getComparableFields = (type: string): string[] => {
     case "string":
       return [...baseFields, "size", "encrypt"];
 
+    case "varchar":
+      return [...baseFields, "size", "encrypt"];
+
+    case "text":
+    case "mediumtext":
+    case "longtext":
+      return [...baseFields, "encrypt"];
+
     case "integer":
     case "double":
     case "float":
@@ -1056,6 +1203,11 @@ const getComparableFields = (type: string): string[] => {
     case "enum":
       return [...baseFields, "elements"];
 
+    case "point":
+    case "line":
+    case "polygon":
+      return baseFields;
+
     case "relationship":
       return [
         ...baseFields,

package/src/collections/indexes.ts

@@ -1,5 +1,5 @@
 import { indexSchema, type Index } from "@njdamstra/appwrite-utils";
-import { Databases, IndexType, Query, type Models } from "node-appwrite";
+import { Databases, IndexType, OrderBy, Query, type Models } from "node-appwrite";
 import type { DatabaseAdapter } from "@njdamstra/appwrite-utils-helpers";
 import { delay, tryAwaitWithRetry, calculateExponentialBackoff, isLegacyDatabases, MessageFormatter } from "@njdamstra/appwrite-utils-helpers";
 
@@ -327,10 +327,10 @@ export const createOrUpdateIndex = async (
       index.key,
       index.type as IndexType,
       index.attributes,
-      orders
+      orders as OrderBy[]
     );
   }
-  
+
   return newIndex;
 };
 

package/src/collections/tableOperations.ts

@@ -32,6 +32,10 @@ interface ColumnOperationPlan {
 // Property configuration for different column types
 const MUTABLE_PROPERTIES = {
   string: ["required", "default", "size", "array"],
+  varchar: ["required", "default", "size", "array"],
+  text: ["required", "default", "array"],
+  mediumtext: ["required", "default", "array"],
+  longtext: ["required", "default", "array"],
   integer: ["required", "default", "min", "max", "array"],
   float: ["required", "default", "min", "max", "array"],
   double: ["required", "default", "min", "max", "array"],
@@ -41,11 +45,18 @@ const MUTABLE_PROPERTIES = {
   ip: ["required", "default", "array"],
   url: ["required", "default", "array"],
   enum: ["required", "default", "elements", "array"],
+  point: ["required", "default"],
+  line: ["required", "default"],
+  polygon: ["required", "default"],
   relationship: ["required", "default"],
 } as const;
 
 const IMMUTABLE_PROPERTIES = {
   string: ["encrypt", "key"],
+  varchar: ["encrypt", "key"],
+  text: ["encrypt", "key"],
+  mediumtext: ["encrypt", "key"],
+  longtext: ["encrypt", "key"],
   integer: ["encrypt", "key"],
   float: ["encrypt", "key"],
   double: ["encrypt", "key"],
@@ -55,11 +66,18 @@ const IMMUTABLE_PROPERTIES = {
   ip: ["key"],
   url: ["key"],
   enum: ["key"],
+  point: ["key"],
+  line: ["key"],
+  polygon: ["key"],
   relationship: ["key", "relatedCollection", "relationType", "twoWay", "twoWayKey", "onDelete"],
 } as const;
 
 const TYPE_CHANGE_REQUIRES_RECREATE = [
   "string",
+  "varchar",
+  "text",
+  "mediumtext",
+  "longtext",
   "integer",
   "float",
   "double",
@@ -69,6 +87,9 @@ const TYPE_CHANGE_REQUIRES_RECREATE = [
   "ip",
   "url",
   "enum",
+  "point",
+  "line",
+  "polygon",
   "relationship",
 ];
 
@@ -117,6 +138,13 @@ export function normalizeAttributeToComparable(attr: Attribute): ComparableColum
     base.size = (attr as any).size ?? 255;
     base.encrypt = !!((attr as any).encrypt);
   }
+  if (t === 'varchar') {
+    base.size = (attr as any).size ?? 255;
+    base.encrypt = !!((attr as any).encrypt);
+  }
+  if (t === 'text' || t === 'mediumtext' || t === 'longtext') {
+    base.encrypt = !!((attr as any).encrypt);
+  }
   if (t === 'integer' || t === 'float' || t === 'double') {
     const min = toNumber((attr as any).min);
     const max = toNumber((attr as any).max);
@@ -162,6 +190,13 @@ export function normalizeColumnToComparable(col: any): ComparableColumn {
     base.size = typeof col?.size === 'number' ? col.size : undefined;
     base.encrypt = !!col?.encrypt;
   }
+  if (t === 'varchar') {
+    base.size = typeof col?.size === 'number' ? col.size : undefined;
+    base.encrypt = !!col?.encrypt;
+  }
+  if (t === 'text' || t === 'mediumtext' || t === 'longtext') {
+    base.encrypt = !!col?.encrypt;
+  }
   if (t === 'integer' || t === 'float' || t === 'double') {
     // Preserve raw min/max without forcing extremes; compare with Decimal in shallowEqual
     const rawMin = (col as any)?.min;

package/src/functions/methods.ts

@@ -137,7 +137,7 @@ export const createFunction = async (
     functionConfig.logging,
     functionConfig.entrypoint,
     functionConfig.commands,
-    functionConfig.scopes,
+    functionConfig.scopes as any[],
     functionConfig.installationId,
     functionConfig.providerRepositoryId,
     functionConfig.providerBranch,
@@ -217,7 +217,7 @@ export const updateFunction = async (
     functionConfig.logging,
     functionConfig.entrypoint,
     functionConfig.commands,
-    functionConfig.scopes,
+    functionConfig.scopes as any[],
     functionConfig.installationId,
     functionConfig.providerRepositoryId,
     functionConfig.providerBranch,

package/src/interactiveCLI.ts

@@ -46,6 +46,7 @@ import { storageCommands } from "./cli/commands/storageCommands.js";
 import { transferCommands } from "./cli/commands/transferCommands.js";
 import { schemaCommands } from "./cli/commands/schemaCommands.js";
 import { importFileCommands } from "./cli/commands/importFileCommands.js";
+import { migrateCommands } from "./cli/commands/migrateCommands.js";
 
 enum CHOICES {
   MIGRATE_CONFIG = "🔄 Migrate TypeScript config to YAML (.appwrite structure)",
@@ -71,6 +72,7 @@ enum CHOICES {
   RELOAD_CONFIG = "🔄 Reload configuration files",
   UPDATE_FUNCTION_SPEC = "⚙️ Update function specifications",
   MANAGE_BUCKETS = "🪣 Manage storage buckets",
+  MIGRATE_STRINGS = "🔄 Migrate string attributes to varchar/text types",
   EXIT = "👋 Exit",
 }
 
@@ -92,7 +94,7 @@ export class InteractiveCLI {
   async run(): Promise<void> {
     MessageFormatter.banner(
       "Appwrite Utils CLI",
-      "Welcome to Appwrite Utils CLI Tool by Zach Handley"
+      "Welcome to Appwrite Utils CLI Tool"
     );
     MessageFormatter.info(
       "For more information, visit https://github.com/njdamstra/AppwriteUtils"
@@ -203,6 +205,10 @@ export class InteractiveCLI {
         case CHOICES.MANAGE_BUCKETS:
           await this.manageBuckets();
           break;
+        case CHOICES.MIGRATE_STRINGS:
+          await this.initControllerIfNeeded();
+          await migrateCommands.migrateStrings(this);
+          break;
         case CHOICES.EXIT:
           MessageFormatter.success("Goodbye!");
           process.exit(0);
@@ -1069,7 +1075,7 @@ export class InteractiveCLI {
         compression: bucketCompressionType as Compression,
         encryption: bucketEncryption,
         antivirus: bucketAntivirus,
-      },
+      } as any,
       bucketId.length > 0 ? bucketId : ulid()
     );
   }
@@ -1111,7 +1117,7 @@ export class InteractiveCLI {
       name: db.name,
       enabled: true,
       type: "tablesdb" as DatabaseType,
-    }));
+    } as Models.Database));
   }
 
 

package/src/main.ts

@@ -82,6 +82,12 @@ interface CliOptions {
   importFile?: string;
   targetDb?: string;
   targetTable?: string;
+  // String attribute migration
+  migrateStringsAnalyze?: boolean;
+  migrateStringsExecute?: string;
+  migrateStringsOutput?: string;
+  migrateStringsKeepBackups?: boolean;
+  migrateStringsDryRun?: boolean;
 }
 
 type ParsedArgv = ArgumentsCamelCase<CliOptions>;
@@ -621,6 +627,32 @@ const argv = yargs(hideBin(process.argv))
     type: "string",
     description: "Target table ID for --importFile (prompted if omitted)",
   })
+  .option("migrateStringsAnalyze", {
+    alias: ["migrate-strings-analyze"],
+    type: "boolean",
+    description: "Analyze local configs and generate a string-to-varchar/text migration plan (YAML)",
+  })
+  .option("migrateStringsExecute", {
+    alias: ["migrate-strings-execute"],
+    type: "string",
+    description: "Execute a string migration plan from the given YAML path",
+  })
+  .option("migrateStringsOutput", {
+    alias: ["migrate-strings-output"],
+    type: "string",
+    description: "Output path for the migration plan (default: ./migrate-strings-plan.yaml)",
+  })
+  .option("migrateStringsKeepBackups", {
+    alias: ["migrate-strings-keep-backups"],
+    type: "boolean",
+    default: true,
+    description: "Keep backup attributes after migration (default: true)",
+  })
+  .option("migrateStringsDryRun", {
+    alias: ["migrate-strings-dry-run"],
+    type: "boolean",
+    description: "Dry run — show what would happen without making changes",
+  })
   .parse() as ParsedArgv;
 
 async function main() {
@@ -842,6 +874,43 @@ async function main() {
       return;
     }
 
+    // String attribute migration (analyze or execute)
+    if (argv.migrateStringsAnalyze || argv.migrateStringsExecute) {
+      const { analyzeStringAttributes, executeMigrationPlan } = await import(
+        "./migrations/migrateStrings.js"
+      );
+
+      if (argv.migrateStringsAnalyze) {
+        if (!controller.config) {
+          MessageFormatter.error("No Appwrite configuration found", undefined, {
+            prefix: "Migration",
+          });
+          return;
+        }
+        analyzeStringAttributes(controller.config, {
+          outputPath: argv.migrateStringsOutput,
+        });
+      } else if (argv.migrateStringsExecute) {
+        if (!controller.adapter) {
+          MessageFormatter.error(
+            "No database adapter available. Ensure config has valid credentials.",
+            undefined,
+            { prefix: "Migration" }
+          );
+          return;
+        }
+        const results = await executeMigrationPlan(controller.adapter, {
+          planPath: argv.migrateStringsExecute,
+          keepBackups: argv.migrateStringsKeepBackups ?? true,
+          dryRun: argv.migrateStringsDryRun ?? false,
+        });
+        if (results.failed > 0) {
+          process.exit(1);
+        }
+      }
+      return;
+    }
+
     // List backups if requested
     if (parsedArgv.listBackups) {
       const { AdapterFactory } = await import("@njdamstra/appwrite-utils-helpers");