appwrite-utils-cli 1.3.5 → 1.4.1

package/dist/migrations/dataLoader.js

@@ -619,7 +619,7 @@ export class DataLoader {
             userData.data.email = userData.data.email.toLowerCase();
         }
         if (!userData.success || !(userData.data.email || userData.data.phone)) {
-            logger.error(`Invalid user data: ${JSON.stringify(userData.error?.errors, undefined, 2)} or missing email/phone`);
+            logger.error(`Invalid user data: ${JSON.stringify(userData.error?.issues, undefined, 2)} or missing email/phone`);
             const userKeys = ["email", "phone", "name", "labels", "prefs"];
             userKeys.forEach((key) => {
                 if (transformedItem.hasOwnProperty(key)) {
@@ -719,6 +719,7 @@ export class DataLoader {
         const userDataToAdd = {
             rawData: item,
             finalData: userData.data,
+            context: {},
         };
         this.importMap.set(this.getCollectionKey("users"), {
             data: [...(usersMap?.data || []), userDataToAdd],

package/dist/migrations/relationships.d.ts

@@ -4,18 +4,17 @@ import type { AppwriteConfig } from "appwrite-utils";
  * Finds collections that have defined relationship attributes.
  */
 export declare const findCollectionsWithRelationships: (config: AppwriteConfig) => Map<string, {
-    type: "relationship";
     key: string;
+    type: "relationship";
     relatedCollection: string;
     relationType: "oneToMany" | "manyToOne" | "oneToOne" | "manyToMany";
     twoWay: boolean;
     twoWayKey: string;
     onDelete: "setNull" | "cascade" | "restrict";
     side: "parent" | "child";
-    description?: string | Record<string, string> | null | undefined;
+    error?: string | undefined;
     required?: boolean | undefined;
     array?: boolean | undefined;
-    error?: string | undefined;
     importMapping?: {
         originalIdField: string;
         targetField?: string | undefined;

package/dist/migrations/relationships.js

@@ -136,7 +136,7 @@ async function prepareDocumentUpdates(database, dbId, collectionName, documents,
                 console.log(`Related collection ${rel.relatedCollection} not found, skipping...`);
                 continue;
             }
-            const foundDocuments = await findDocumentsByOriginalId(database, dbId, relatedCollection, targetField, originalId);
+            const foundDocuments = await findDocumentsByOriginalId(database, dbId, relatedCollection, targetField, String(originalId));
             if (foundDocuments && foundDocuments.length > 0) {
                 const relationshipKey = rel.key;
                 const existingRefs = doc[relationshipKey] || [];

package/dist/migrations/services/UserMappingService.js

@@ -99,7 +99,7 @@ export class UserMappingService {
             userData.data.email = userData.data.email.toLowerCase();
         }
         if (!userData.success || !(userData.data.email || userData.data.phone)) {
-            logger.error(`Invalid user data: ${JSON.stringify(userData.error?.errors, undefined, 2)} or missing email/phone`);
+            logger.error(`Invalid user data: ${JSON.stringify(userData.error?.issues, undefined, 2)} or missing email/phone`);
             const userKeys = ["email", "phone", "name", "labels", "prefs"];
             userKeys.forEach((key) => {
                 if (transformedItem.hasOwnProperty(key)) {

package/dist/migrations/yaml/YamlImportConfigLoader.d.ts

@@ -4,180 +4,49 @@ export declare const YamlImportConfigSchema: z.ZodObject<{
     source: z.ZodObject<{
         file: z.ZodString;
         basePath: z.ZodOptional<z.ZodString>;
-        type: z.ZodDefault<z.ZodEnum<["json", "csv", "yaml"]>>;
-    }, "strip", z.ZodTypeAny, {
-        type: "json" | "csv" | "yaml";
-        file: string;
-        basePath?: string | undefined;
-    }, {
-        file: string;
-        type?: "json" | "csv" | "yaml" | undefined;
-        basePath?: string | undefined;
-    }>;
+        type: z.ZodDefault<z.ZodEnum<{
+            json: "json";
+            csv: "csv";
+            yaml: "yaml";
+        }>>;
+    }, z.core.$strip>;
     target: z.ZodObject<{
         collection: z.ZodString;
-        type: z.ZodDefault<z.ZodEnum<["create", "update"]>>;
+        type: z.ZodDefault<z.ZodEnum<{
+            create: "create";
+            update: "update";
+        }>>;
         primaryKey: z.ZodDefault<z.ZodString>;
         createUsers: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        type: "create" | "update";
-        collection: string;
-        primaryKey: string;
-        createUsers: boolean;
-    }, {
-        collection: string;
-        type?: "create" | "update" | undefined;
-        primaryKey?: string | undefined;
-        createUsers?: boolean | undefined;
-    }>;
+    }, z.core.$strip>;
     mapping: z.ZodObject<{
         attributes: z.ZodArray<z.ZodObject<{
             oldKey: z.ZodOptional<z.ZodString>;
-            oldKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            oldKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
             targetKey: z.ZodString;
             valueToSet: z.ZodOptional<z.ZodAny>;
             fileData: z.ZodOptional<z.ZodObject<{
                 path: z.ZodString;
                 name: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                name: string;
-            }, {
-                path: string;
-                name: string;
-            }>>;
-            converters: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            }, z.core.$strip>>;
+            converters: z.ZodDefault<z.ZodArray<z.ZodString>>;
             validation: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 rule: z.ZodString;
-                params: z.ZodArray<z.ZodString, "many">;
-            }, "strip", z.ZodTypeAny, {
-                params: string[];
-                rule: string;
-            }, {
-                params: string[];
-                rule: string;
-            }>, "many">>;
+                params: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>>;
             afterImport: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 action: z.ZodString;
-                params: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>, "many">;
-            }, "strip", z.ZodTypeAny, {
-                params: (string | Record<string, any>)[];
-                action: string;
-            }, {
-                params: (string | Record<string, any>)[];
-                action: string;
-            }>, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            validation: {
-                params: string[];
-                rule: string;
-            }[];
-            targetKey: string;
-            converters: string[];
-            afterImport: {
-                params: (string | Record<string, any>)[];
-                action: string;
-            }[];
-            oldKey?: string | undefined;
-            oldKeys?: string[] | undefined;
-            valueToSet?: any;
-            fileData?: {
-                path: string;
-                name: string;
-            } | undefined;
-        }, {
-            targetKey: string;
-            validation?: {
-                params: string[];
-                rule: string;
-            }[] | undefined;
-            oldKey?: string | undefined;
-            oldKeys?: string[] | undefined;
-            valueToSet?: any;
-            fileData?: {
-                path: string;
-                name: string;
-            } | undefined;
-            converters?: string[] | undefined;
-            afterImport?: {
-                params: (string | Record<string, any>)[];
-                action: string;
-            }[] | undefined;
-        }>, "many">;
+                params: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
         relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
             sourceField: z.ZodString;
             targetField: z.ZodString;
             targetCollection: z.ZodString;
             fieldToSet: z.ZodOptional<z.ZodString>;
             targetFieldToMatch: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            targetField: string;
-            sourceField: string;
-            targetCollection: string;
-            fieldToSet?: string | undefined;
-            targetFieldToMatch?: string | undefined;
-        }, {
-            targetField: string;
-            sourceField: string;
-            targetCollection: string;
-            fieldToSet?: string | undefined;
-            targetFieldToMatch?: string | undefined;
-        }>, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        attributes: {
-            validation: {
-                params: string[];
-                rule: string;
-            }[];
-            targetKey: string;
-            converters: string[];
-            afterImport: {
-                params: (string | Record<string, any>)[];
-                action: string;
-            }[];
-            oldKey?: string | undefined;
-            oldKeys?: string[] | undefined;
-            valueToSet?: any;
-            fileData?: {
-                path: string;
-                name: string;
-            } | undefined;
-        }[];
-        relationships: {
-            targetField: string;
-            sourceField: string;
-            targetCollection: string;
-            fieldToSet?: string | undefined;
-            targetFieldToMatch?: string | undefined;
-        }[];
-    }, {
-        attributes: {
-            targetKey: string;
-            validation?: {
-                params: string[];
-                rule: string;
-            }[] | undefined;
-            oldKey?: string | undefined;
-            oldKeys?: string[] | undefined;
-            valueToSet?: any;
-            fileData?: {
-                path: string;
-                name: string;
-            } | undefined;
-            converters?: string[] | undefined;
-            afterImport?: {
-                params: (string | Record<string, any>)[];
-                action: string;
-            }[] | undefined;
-        }[];
-        relationships?: {
-            targetField: string;
-            sourceField: string;
-            targetCollection: string;
-            fieldToSet?: string | undefined;
-            targetFieldToMatch?: string | undefined;
-        }[] | undefined;
-    }>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
     options: z.ZodDefault<z.ZodObject<{
         batchSize: z.ZodDefault<z.ZodNumber>;
         skipValidation: z.ZodDefault<z.ZodBoolean>;
@@ -186,133 +55,9 @@ export declare const YamlImportConfigSchema: z.ZodObject<{
         updateMapping: z.ZodOptional<z.ZodObject<{
             originalIdField: z.ZodString;
             targetField: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            targetField: string;
-            originalIdField: string;
-        }, {
-            targetField: string;
-            originalIdField: string;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        batchSize: number;
-        dryRun: boolean;
-        skipValidation: boolean;
-        continueOnError: boolean;
-        updateMapping?: {
-            targetField: string;
-            originalIdField: string;
-        } | undefined;
-    }, {
-        batchSize?: number | undefined;
-        dryRun?: boolean | undefined;
-        skipValidation?: boolean | undefined;
-        continueOnError?: boolean | undefined;
-        updateMapping?: {
-            targetField: string;
-            originalIdField: string;
-        } | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    options: {
-        batchSize: number;
-        dryRun: boolean;
-        skipValidation: boolean;
-        continueOnError: boolean;
-        updateMapping?: {
-            targetField: string;
-            originalIdField: string;
-        } | undefined;
-    };
-    target: {
-        type: "create" | "update";
-        collection: string;
-        primaryKey: string;
-        createUsers: boolean;
-    };
-    source: {
-        type: "json" | "csv" | "yaml";
-        file: string;
-        basePath?: string | undefined;
-    };
-    mapping: {
-        attributes: {
-            validation: {
-                params: string[];
-                rule: string;
-            }[];
-            targetKey: string;
-            converters: string[];
-            afterImport: {
-                params: (string | Record<string, any>)[];
-                action: string;
-            }[];
-            oldKey?: string | undefined;
-            oldKeys?: string[] | undefined;
-            valueToSet?: any;
-            fileData?: {
-                path: string;
-                name: string;
-            } | undefined;
-        }[];
-        relationships: {
-            targetField: string;
-            sourceField: string;
-            targetCollection: string;
-            fieldToSet?: string | undefined;
-            targetFieldToMatch?: string | undefined;
-        }[];
-    };
-}, {
-    target: {
-        collection: string;
-        type?: "create" | "update" | undefined;
-        primaryKey?: string | undefined;
-        createUsers?: boolean | undefined;
-    };
-    source: {
-        file: string;
-        type?: "json" | "csv" | "yaml" | undefined;
-        basePath?: string | undefined;
-    };
-    mapping: {
-        attributes: {
-            targetKey: string;
-            validation?: {
-                params: string[];
-                rule: string;
-            }[] | undefined;
-            oldKey?: string | undefined;
-            oldKeys?: string[] | undefined;
-            valueToSet?: any;
-            fileData?: {
-                path: string;
-                name: string;
-            } | undefined;
-            converters?: string[] | undefined;
-            afterImport?: {
-                params: (string | Record<string, any>)[];
-                action: string;
-            }[] | undefined;
-        }[];
-        relationships?: {
-            targetField: string;
-            sourceField: string;
-            targetCollection: string;
-            fieldToSet?: string | undefined;
-            targetFieldToMatch?: string | undefined;
-        }[] | undefined;
-    };
-    options?: {
-        batchSize?: number | undefined;
-        dryRun?: boolean | undefined;
-        skipValidation?: boolean | undefined;
-        continueOnError?: boolean | undefined;
-        updateMapping?: {
-            targetField: string;
-            originalIdField: string;
-        } | undefined;
-    } | undefined;
-}>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type YamlImportConfig = z.infer<typeof YamlImportConfigSchema>;
 /**
  * Service for loading and converting YAML import configurations.

package/dist/migrations/yaml/YamlImportConfigLoader.js

@@ -59,7 +59,12 @@ export const YamlImportConfigSchema = z.object({
             originalIdField: z.string().describe("Field in source data for matching"),
             targetField: z.string().describe("Field in collection to match against"),
         }).optional().describe("Configuration for update operations"),
-    }).default({}),
+    }).default(() => ({
+        batchSize: 50,
+        skipValidation: false,
+        dryRun: false,
+        continueOnError: true
+    })),
 });
 /**
  * Service for loading and converting YAML import configurations.
@@ -92,7 +97,7 @@ export class YamlImportConfigLoader {
         }
         catch (error) {
             if (error instanceof z.ZodError) {
-                const errorMessages = error.errors.map(err => `${err.path.join('.')}: ${err.message}`);
+                const errorMessages = error.issues.map(err => `${err.path.join('.')}: ${err.message}`);
                 throw new Error(`Invalid import configuration in ${configPath}:\n${errorMessages.join('\n')}`);
             }
             throw new Error(`Failed to load import configuration ${configPath}: ${error}`);

package/dist/schemas/authUser.d.ts

@@ -7,58 +7,18 @@ export declare const AuthUserSchema: z.ZodObject<{
     email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     prefs: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
-    labels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
-}, "strip", z.ZodTypeAny, {
-    $id: string;
-    prefs: Record<string, string>;
-    labels: string[];
-    name?: string | null | undefined;
-    $createdAt?: string | undefined;
-    $updatedAt?: string | undefined;
-    email?: string | null | undefined;
-    phone?: string | null | undefined;
-}, {
-    $id: string;
-    name?: string | null | undefined;
-    $createdAt?: string | undefined;
-    $updatedAt?: string | undefined;
-    email?: string | null | undefined;
-    phone?: string | null | undefined;
-    prefs?: Record<string, string> | undefined;
-    labels?: string[] | undefined;
-}>;
+    labels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
 export type AuthUser = z.infer<typeof AuthUserSchema>;
-export declare const AuthUserCreateSchema: z.ZodObject<Omit<{
-    $id: z.ZodString;
-    $createdAt: z.ZodOptional<z.ZodString>;
-    $updatedAt: z.ZodOptional<z.ZodString>;
+export declare const AuthUserCreateSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    $createdAt: z.ZodOptional<z.ZodString>;
+    $updatedAt: z.ZodOptional<z.ZodString>;
     phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     prefs: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
-    labels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
-}, "$id"> & {
+    labels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     userId: z.ZodOptional<z.ZodString>;
     password: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    prefs: Record<string, string>;
-    labels: string[];
-    password?: string | undefined;
-    name?: string | null | undefined;
-    $createdAt?: string | undefined;
-    $updatedAt?: string | undefined;
-    email?: string | null | undefined;
-    phone?: string | null | undefined;
-    userId?: string | undefined;
-}, {
-    password?: string | undefined;
-    name?: string | null | undefined;
-    $createdAt?: string | undefined;
-    $updatedAt?: string | undefined;
-    email?: string | null | undefined;
-    phone?: string | null | undefined;
-    prefs?: Record<string, string> | undefined;
-    labels?: string[] | undefined;
-    userId?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type AuthUserCreate = z.infer<typeof AuthUserCreateSchema>;

package/dist/schemas/authUser.js

@@ -6,7 +6,7 @@ export const AuthUserSchema = z.object({
     name: z.string().nullish(),
     email: z.string().email("Invalid Email Address").nullish(),
     phone: z.string().nullish(),
-    prefs: z.record(z.string()).optional().default({}),
+    prefs: z.record(z.string(), z.string()).optional().default({}),
     labels: z.array(z.string()).optional().default([]),
 });
 export const AuthUserCreateSchema = AuthUserSchema.omit({

package/dist/shared/jsonSchemaGenerator.d.ts

@@ -1,7 +1,6 @@
 import type { AppwriteConfig } from "appwrite-utils";
 export interface JsonSchemaProperty {
     type: string | string[];
-    description?: string;
     format?: string;
     minimum?: number;
     maximum?: number;
@@ -21,7 +20,6 @@ export interface JsonSchema {
     $schema: string;
     $id: string;
     title: string;
-    description?: string;
     type: "object";
     properties: Record<string, JsonSchemaProperty>;
     required: string[];

package/dist/shared/jsonSchemaGenerator.js

@@ -35,12 +35,6 @@ export class JsonSchemaGenerator {
         const property = {
             type: "string" // Default type
         };
-        // Set description if available
-        if (attribute.description) {
-            property.description = typeof attribute.description === 'string'
-                ? attribute.description
-                : JSON.stringify(attribute.description);
-        }
         // Handle array attributes
         if (attribute.array) {
             property.type = "array";
@@ -118,7 +112,6 @@ export class JsonSchemaGenerator {
                 }
                 else {
                     schema.type = "string";
-                    schema.description = "Document ID reference";
                 }
                 break;
             default:
@@ -132,31 +125,26 @@ export class JsonSchemaGenerator {
             $schema: "https://json-schema.org/draft/2020-12/schema",
             $id: `https://example.com/schemas/${toCamelCase(collection.name)}.json`,
             title: pascalName,
-            description: collection.description || `Schema for ${collection.name} collection`,
             type: "object",
             properties: {
                 // Standard Appwrite document fields
                 $id: {
                     type: "string",
-                    description: "Document ID",
                     pattern: "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,35}$"
                 },
                 $createdAt: {
                     type: "string",
-                    format: "date-time",
-                    description: "Document creation date"
+                    format: "date-time"
                 },
                 $updatedAt: {
                     type: "string",
-                    format: "date-time",
-                    description: "Document last update date"
+                    format: "date-time"
                 },
                 $permissions: {
                     type: "array",
                     items: {
                         type: "string"
-                    },
-                    description: "Document permissions"
+                    }
                 }
             },
             required: ["$id", "$createdAt", "$updatedAt"],
@@ -186,8 +174,7 @@ export class JsonSchemaGenerator {
                         $createdAt: { type: "string", format: "date-time" },
                         $updatedAt: { type: "string", format: "date-time" }
                     },
-                    additionalProperties: true,
-                    description: `Reference to ${rel.relatedCollection} document`
+                    additionalProperties: true
                 };
             });
         }