@njdamstra/appwrite-utils-cli 1.8.9 → 1.10.1

package/dist/storage/schemas.d.ts

@@ -12,11 +12,11 @@ export declare const BackupSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type Backup = z.infer<typeof BackupSchema>;
 export declare const BackupCreateSchema: z.ZodObject<{
+    collections: z.ZodArray<z.ZodString>;
     documents: z.ZodDefault<z.ZodArray<z.ZodObject<{
         collectionId: z.ZodString;
         data: z.ZodString;
     }, z.core.$strip>>>;
-    collections: z.ZodArray<z.ZodString>;
     database: z.ZodString;
 }, z.core.$strip>;
 export type BackupCreate = z.infer<typeof BackupCreateSchema>;
@@ -56,7 +56,6 @@ export declare const OperationSchema: z.ZodObject<{
 export type Operation = z.infer<typeof OperationSchema>;
 export declare const OperationCreateSchema: z.ZodObject<{
     error: z.ZodString;
-    data: z.ZodAny;
     status: z.ZodDefault<z.ZodEnum<{
         error: "error";
         pending: "pending";
@@ -66,6 +65,7 @@ export declare const OperationCreateSchema: z.ZodObject<{
         cancelled: "cancelled";
     }>>;
     collectionId: z.ZodString;
+    data: z.ZodAny;
     operationType: z.ZodString;
     batches: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
     progress: z.ZodNumber;
@@ -91,6 +91,63 @@ export declare const getMigrationCollectionSchemas: () => {
                 error?: string | undefined;
                 xdefault?: string | null | undefined;
                 encrypt?: boolean | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "varchar";
+                size: number;
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: string | null | undefined;
+                encrypt?: boolean | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "text";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: string | null | undefined;
+                encrypt?: boolean | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "mediumtext";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: string | null | undefined;
+                encrypt?: boolean | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "longtext";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: string | null | undefined;
+                encrypt?: boolean | undefined;
             } | {
                 key: string;
                 required: boolean;
@@ -215,6 +272,45 @@ export declare const getMigrationCollectionSchemas: () => {
                 $updatedAt?: string | undefined;
                 error?: string | undefined;
                 xdefault?: string | null | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "point";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: number[] | null | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "line";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: number[][] | null | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "polygon";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: number[][][] | null | undefined;
             } | {
                 key: string;
                 required: boolean;
@@ -308,6 +404,63 @@ export declare const getMigrationCollectionSchemas: () => {
             error?: string | undefined;
             xdefault?: string | null | undefined;
             encrypt?: boolean | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "varchar";
+            size: number;
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: string | null | undefined;
+            encrypt?: boolean | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "text";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: string | null | undefined;
+            encrypt?: boolean | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "mediumtext";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: string | null | undefined;
+            encrypt?: boolean | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "longtext";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: string | null | undefined;
+            encrypt?: boolean | undefined;
         } | {
             key: string;
             required: boolean;
@@ -432,6 +585,45 @@ export declare const getMigrationCollectionSchemas: () => {
             $updatedAt?: string | undefined;
             error?: string | undefined;
             xdefault?: string | null | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "point";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: number[] | null | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "line";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: number[][] | null | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "polygon";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: number[][][] | null | undefined;
         } | {
             key: string;
             required: boolean;
@@ -474,6 +666,63 @@ export declare const getMigrationCollectionSchemas: () => {
                 error?: string | undefined;
                 xdefault?: string | null | undefined;
                 encrypt?: boolean | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "varchar";
+                size: number;
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: string | null | undefined;
+                encrypt?: boolean | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "text";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: string | null | undefined;
+                encrypt?: boolean | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "mediumtext";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: string | null | undefined;
+                encrypt?: boolean | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "longtext";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: string | null | undefined;
+                encrypt?: boolean | undefined;
             } | {
                 key: string;
                 required: boolean;
@@ -598,6 +847,45 @@ export declare const getMigrationCollectionSchemas: () => {
                 $updatedAt?: string | undefined;
                 error?: string | undefined;
                 xdefault?: string | null | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "point";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: number[] | null | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "line";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: number[][] | null | undefined;
+            } | {
+                key: string;
+                required: boolean;
+                type: "polygon";
+                array?: boolean | undefined;
+                format?: string | undefined;
+                status?: string | undefined;
+                attributes?: string[] | undefined;
+                orders?: string[] | undefined;
+                $createdAt?: string | undefined;
+                $updatedAt?: string | undefined;
+                error?: string | undefined;
+                xdefault?: number[][][] | null | undefined;
             } | {
                 key: string;
                 required: boolean;
@@ -691,6 +979,63 @@ export declare const getMigrationCollectionSchemas: () => {
             error?: string | undefined;
             xdefault?: string | null | undefined;
             encrypt?: boolean | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "varchar";
+            size: number;
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: string | null | undefined;
+            encrypt?: boolean | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "text";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: string | null | undefined;
+            encrypt?: boolean | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "mediumtext";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: string | null | undefined;
+            encrypt?: boolean | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "longtext";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: string | null | undefined;
+            encrypt?: boolean | undefined;
         } | {
             key: string;
             required: boolean;
@@ -815,6 +1160,45 @@ export declare const getMigrationCollectionSchemas: () => {
             $updatedAt?: string | undefined;
             error?: string | undefined;
             xdefault?: string | null | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "point";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: number[] | null | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "line";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: number[][] | null | undefined;
+        } | {
+            key: string;
+            required: boolean;
+            type: "polygon";
+            array?: boolean | undefined;
+            format?: string | undefined;
+            status?: string | undefined;
+            attributes?: string[] | undefined;
+            orders?: string[] | undefined;
+            $createdAt?: string | undefined;
+            $updatedAt?: string | undefined;
+            error?: string | undefined;
+            xdefault?: number[][][] | null | undefined;
         } | {
             key: string;
             required: boolean;

package/dist/tables/indexManager.d.ts

@@ -0,0 +1,65 @@
+import type { Index } from "@njdamstra/appwrite-utils";
+import type { DatabaseAdapter } from "@njdamstra/appwrite-utils-helpers";
+import type { Models } from "node-appwrite";
+export interface IndexOperation {
+    type: 'create' | 'update' | 'skip' | 'delete';
+    index: Index;
+    existingIndex?: Models.Index;
+    reason?: string;
+}
+export interface IndexOperationPlan {
+    toCreate: IndexOperation[];
+    toUpdate: IndexOperation[];
+    toSkip: IndexOperation[];
+    toDelete: IndexOperation[];
+}
+export interface IndexExecutionResult {
+    created: string[];
+    updated: string[];
+    skipped: string[];
+    deleted: string[];
+    errors: Array<{
+        key: string;
+        error: string;
+    }>;
+    summary: {
+        total: number;
+        created: number;
+        updated: number;
+        skipped: number;
+        deleted: number;
+        errors: number;
+    };
+}
+/**
+ * Plan index operations by comparing desired indexes with existing ones
+ * Uses the existing isIndexEqualToIndex function for consistent comparison
+ */
+export declare function planIndexOperations(desiredIndexes: Index[], existingIndexes: Models.Index[]): IndexOperationPlan;
+/**
+ * Plan index deletions for indexes that exist but aren't in the desired configuration
+ */
+export declare function planIndexDeletions(desiredIndexKeys: Set<string>, existingIndexes: Models.Index[]): IndexOperation[];
+/**
+ * Execute index operations with proper error handling and status monitoring
+ */
+export declare function executeIndexOperations(adapter: DatabaseAdapter, databaseId: string, tableId: string, plan: IndexOperationPlan): Promise<IndexExecutionResult>;
+/**
+ * Execute index deletions with proper error handling
+ */
+export declare function executeIndexDeletions(adapter: DatabaseAdapter, databaseId: string, tableId: string, deletions: IndexOperation[]): Promise<{
+    deleted: string[];
+    errors: Array<{
+        key: string;
+        error: string;
+    }>;
+}>;
+/**
+ * Main function to create/update indexes via adapter
+ * This replaces the messy inline code in methods.ts
+ */
+export declare function createOrUpdateIndexesViaAdapter(adapter: DatabaseAdapter, databaseId: string, tableId: string, desiredIndexes: Index[], configIndexes?: Index[]): Promise<void>;
+/**
+ * Handle index deletions for obsolete indexes
+ */
+export declare function deleteObsoleteIndexesViaAdapter(adapter: DatabaseAdapter, databaseId: string, tableId: string, desiredIndexKeys: Set<string>): Promise<void>;