appwrite-utils-cli 1.9.7 → 1.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CONFIG_TODO.md +1189 -1189
- package/README.md +1004 -1004
- package/SELECTION_DIALOGS.md +145 -145
- package/SERVICE_IMPLEMENTATION_REPORT.md +462 -462
- package/package.json +6 -3
- package/scripts/copy-templates.ts +23 -23
- package/src/adapters/index.ts +11 -37
- package/src/backups/operations/bucketBackup.ts +277 -277
- package/src/backups/operations/collectionBackup.ts +310 -310
- package/src/backups/operations/comprehensiveBackup.ts +342 -342
- package/src/backups/schemas/bucketManifest.ts +78 -78
- package/src/backups/schemas/comprehensiveManifest.ts +76 -76
- package/src/backups/tracking/centralizedTracking.ts +352 -352
- package/src/cli/commands/configCommands.ts +265 -201
- package/src/cli/commands/databaseCommands.ts +931 -879
- package/src/cli/commands/functionCommands.ts +333 -332
- package/src/cli/commands/importFileCommands.ts +815 -0
- package/src/cli/commands/schemaCommands.ts +141 -141
- package/src/cli/commands/storageCommands.ts +2 -3
- package/src/cli/commands/transferCommands.ts +454 -457
- package/src/collections/attributes.ts.backup +1555 -1555
- package/src/collections/{attributes.ts → columns.ts} +15 -10
- package/src/collections/indexes.ts +350 -352
- package/src/collections/methods.ts +714 -700
- package/src/collections/tableOperations.ts +29 -8
- package/src/collections/transferOperations.ts +376 -377
- package/src/collections/wipeOperations.ts +449 -346
- package/src/databases/methods.ts +49 -49
- package/src/databases/setup.ts +77 -77
- package/src/examples/yamlTerminologyExample.ts +346 -346
- package/src/functions/deployments.ts +221 -220
- package/src/functions/fnConfigDiscovery.ts +2 -2
- package/src/functions/methods.ts +284 -284
- package/src/functions/templates/count-docs-in-collection/README.md +53 -53
- package/src/functions/templates/count-docs-in-collection/src/main.ts +159 -159
- package/src/functions/templates/count-docs-in-collection/src/request.ts +8 -8
- package/src/functions/templates/hono-typescript/README.md +285 -285
- package/src/functions/templates/hono-typescript/src/adapters/request.ts +73 -73
- package/src/functions/templates/hono-typescript/src/adapters/response.ts +105 -105
- package/src/functions/templates/hono-typescript/src/app.ts +179 -179
- package/src/functions/templates/hono-typescript/src/context.ts +102 -102
- package/src/functions/templates/hono-typescript/src/{index.ts → main.ts} +53 -53
- package/src/functions/templates/hono-typescript/src/middleware/appwrite.ts +118 -118
- package/src/functions/templates/typescript-node/README.md +31 -31
- package/src/functions/templates/typescript-node/src/context.ts +102 -102
- package/src/functions/templates/typescript-node/src/{index.ts → main.ts} +29 -29
- package/src/functions/templates/uv/README.md +30 -30
- package/src/functions/templates/uv/pyproject.toml +29 -29
- package/src/functions/templates/uv/src/context.py +124 -124
- package/src/functions/templates/uv/src/{index.py → main.py} +45 -45
- package/src/init.ts +62 -62
- package/src/interactiveCLI.ts +1095 -1030
- package/src/main.ts +1517 -1670
- package/src/migrations/afterImportActions.ts +579 -580
- package/src/migrations/appwriteToX.ts +634 -630
- package/src/migrations/comprehensiveTransfer.ts +2149 -2149
- package/src/migrations/dataLoader.ts +1729 -1702
- package/src/migrations/importController.ts +440 -428
- package/src/migrations/importDataActions.ts +315 -315
- package/src/migrations/relationships.ts +333 -334
- package/src/migrations/services/DataTransformationService.ts +195 -195
- package/src/migrations/services/FileHandlerService.ts +310 -310
- package/src/migrations/services/ImportOrchestrator.ts +674 -665
- package/src/migrations/services/RateLimitManager.ts +362 -362
- package/src/migrations/services/RelationshipResolver.ts +460 -460
- package/src/migrations/services/UserMappingService.ts +344 -344
- package/src/migrations/services/ValidationService.ts +333 -333
- package/src/migrations/transfer.ts +987 -942
- package/src/migrations/yaml/YamlImportConfigLoader.ts +438 -438
- package/src/migrations/yaml/YamlImportIntegration.ts +438 -438
- package/src/migrations/yaml/generateImportSchemas.ts +1347 -1347
- package/src/schemas/authUser.ts +23 -23
- package/src/setup.ts +8 -8
- package/src/setupCommands.ts +5 -6
- package/src/setupController.ts +42 -42
- package/src/shared/backupMetadataSchema.ts +93 -93
- package/src/shared/backupTracking.ts +211 -211
- package/src/shared/confirmationDialogs.ts +326 -326
- package/src/shared/migrationHelpers.ts +232 -232
- package/src/shared/operationLogger.ts +20 -20
- package/src/shared/operationQueue.ts +326 -327
- package/src/shared/operationsTable.ts +338 -338
- package/src/shared/operationsTableSchema.ts +60 -60
- package/src/shared/progressManager.ts +277 -277
- package/src/shared/relationshipExtractor.ts +214 -214
- package/src/shared/selectionDialogs.ts +775 -722
- package/src/storage/backupCompression.ts +88 -88
- package/src/storage/methods.ts +695 -682
- package/src/storage/schemas.ts +205 -205
- package/src/tables/indexManager.ts +408 -408
- package/src/types/node-appwrite-tablesdb.d.ts +43 -43
- package/src/types.ts +9 -9
- package/src/users/methods.ts +358 -359
- package/src/utils/configMigration.ts +347 -347
- package/src/utils/index.ts +2 -2
- package/src/utils/loadConfigs.ts +457 -449
- package/src/utils/setupFiles.ts +1236 -1238
- package/src/utilsController.ts +1263 -1213
- package/tests/README.md +496 -496
- package/tests/adapters/AdapterFactory.test.ts +276 -276
- package/tests/integration/syncOperations.test.ts +462 -462
- package/tests/jest.config.js +24 -24
- package/tests/migration/configMigration.test.ts +545 -545
- package/tests/setup.ts +61 -61
- package/tests/testUtils.ts +339 -339
- package/tests/utils/loadConfigs.test.ts +349 -349
- package/tests/validation/configValidation.test.ts +411 -411
- package/tsconfig.json +44 -44
- package/.appwrite/.yaml_schemas/appwrite-config.schema.json +0 -380
- package/.appwrite/.yaml_schemas/collection.schema.json +0 -255
- package/.appwrite/collections/Categories.yaml +0 -182
- package/.appwrite/collections/ExampleCollection.yaml +0 -36
- package/.appwrite/collections/Posts.yaml +0 -227
- package/.appwrite/collections/Users.yaml +0 -149
- package/.appwrite/config.yaml +0 -109
- package/.appwrite/import/README.md +0 -148
- package/.appwrite/import/categories-import.yaml +0 -129
- package/.appwrite/import/posts-import.yaml +0 -208
- package/.appwrite/import/users-import.yaml +0 -130
- package/.appwrite/importData/categories.json +0 -194
- package/.appwrite/importData/posts.json +0 -270
- package/.appwrite/importData/users.json +0 -220
- package/.appwrite/schemas/categories.json +0 -128
- package/.appwrite/schemas/exampleCollection.json +0 -52
- package/.appwrite/schemas/posts.json +0 -173
- package/.appwrite/schemas/users.json +0 -125
- package/dist/adapters/AdapterFactory.d.ts +0 -94
- package/dist/adapters/AdapterFactory.js +0 -420
- package/dist/adapters/DatabaseAdapter.d.ts +0 -243
- package/dist/adapters/DatabaseAdapter.js +0 -50
- package/dist/adapters/LegacyAdapter.d.ts +0 -50
- package/dist/adapters/LegacyAdapter.js +0 -615
- package/dist/adapters/TablesDBAdapter.d.ts +0 -45
- package/dist/adapters/TablesDBAdapter.js +0 -611
- package/dist/adapters/index.d.ts +0 -11
- package/dist/adapters/index.js +0 -12
- package/dist/backups/operations/bucketBackup.d.ts +0 -19
- package/dist/backups/operations/bucketBackup.js +0 -197
- package/dist/backups/operations/collectionBackup.d.ts +0 -30
- package/dist/backups/operations/collectionBackup.js +0 -201
- package/dist/backups/operations/comprehensiveBackup.d.ts +0 -25
- package/dist/backups/operations/comprehensiveBackup.js +0 -238
- package/dist/backups/schemas/bucketManifest.d.ts +0 -93
- package/dist/backups/schemas/bucketManifest.js +0 -33
- package/dist/backups/schemas/comprehensiveManifest.d.ts +0 -108
- package/dist/backups/schemas/comprehensiveManifest.js +0 -32
- package/dist/backups/tracking/centralizedTracking.d.ts +0 -34
- package/dist/backups/tracking/centralizedTracking.js +0 -274
- package/dist/cli/commands/configCommands.d.ts +0 -8
- package/dist/cli/commands/configCommands.js +0 -166
- package/dist/cli/commands/databaseCommands.d.ts +0 -14
- package/dist/cli/commands/databaseCommands.js +0 -644
- package/dist/cli/commands/functionCommands.d.ts +0 -7
- package/dist/cli/commands/functionCommands.js +0 -330
- package/dist/cli/commands/schemaCommands.d.ts +0 -7
- package/dist/cli/commands/schemaCommands.js +0 -169
- package/dist/cli/commands/storageCommands.d.ts +0 -5
- package/dist/cli/commands/storageCommands.js +0 -143
- package/dist/cli/commands/transferCommands.d.ts +0 -5
- package/dist/cli/commands/transferCommands.js +0 -384
- package/dist/collections/attributes.d.ts +0 -13
- package/dist/collections/attributes.js +0 -1333
- package/dist/collections/indexes.d.ts +0 -12
- package/dist/collections/indexes.js +0 -217
- package/dist/collections/methods.d.ts +0 -19
- package/dist/collections/methods.js +0 -587
- package/dist/collections/tableOperations.d.ts +0 -86
- package/dist/collections/tableOperations.js +0 -447
- package/dist/collections/transferOperations.d.ts +0 -8
- package/dist/collections/transferOperations.js +0 -412
- package/dist/collections/wipeOperations.d.ts +0 -16
- package/dist/collections/wipeOperations.js +0 -233
- package/dist/config/ConfigManager.d.ts +0 -450
- package/dist/config/ConfigManager.js +0 -650
- package/dist/config/configMigration.d.ts +0 -87
- package/dist/config/configMigration.js +0 -390
- package/dist/config/configValidation.d.ts +0 -66
- package/dist/config/configValidation.js +0 -358
- package/dist/config/index.d.ts +0 -8
- package/dist/config/index.js +0 -7
- package/dist/config/services/ConfigDiscoveryService.d.ts +0 -122
- package/dist/config/services/ConfigDiscoveryService.js +0 -322
- package/dist/config/services/ConfigLoaderService.d.ts +0 -129
- package/dist/config/services/ConfigLoaderService.js +0 -535
- package/dist/config/services/ConfigMergeService.d.ts +0 -208
- package/dist/config/services/ConfigMergeService.js +0 -308
- package/dist/config/services/ConfigValidationService.d.ts +0 -214
- package/dist/config/services/ConfigValidationService.js +0 -310
- package/dist/config/services/SessionAuthService.d.ts +0 -225
- package/dist/config/services/SessionAuthService.js +0 -456
- package/dist/config/services/__tests__/ConfigMergeService.test.d.ts +0 -1
- package/dist/config/services/__tests__/ConfigMergeService.test.js +0 -271
- package/dist/config/services/index.d.ts +0 -13
- package/dist/config/services/index.js +0 -10
- package/dist/config/yamlConfig.d.ts +0 -722
- package/dist/config/yamlConfig.js +0 -702
- package/dist/databases/methods.d.ts +0 -6
- package/dist/databases/methods.js +0 -35
- package/dist/databases/setup.d.ts +0 -5
- package/dist/databases/setup.js +0 -45
- package/dist/examples/yamlTerminologyExample.d.ts +0 -42
- package/dist/examples/yamlTerminologyExample.js +0 -272
- package/dist/functions/deployments.d.ts +0 -4
- package/dist/functions/deployments.js +0 -146
- package/dist/functions/fnConfigDiscovery.d.ts +0 -3
- package/dist/functions/fnConfigDiscovery.js +0 -108
- package/dist/functions/methods.d.ts +0 -16
- package/dist/functions/methods.js +0 -174
- package/dist/functions/pathResolution.d.ts +0 -37
- package/dist/functions/pathResolution.js +0 -185
- package/dist/functions/templates/count-docs-in-collection/README.md +0 -54
- package/dist/functions/templates/count-docs-in-collection/package.json +0 -25
- package/dist/functions/templates/count-docs-in-collection/src/main.ts +0 -159
- package/dist/functions/templates/count-docs-in-collection/src/request.ts +0 -9
- package/dist/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
- package/dist/functions/templates/hono-typescript/README.md +0 -286
- package/dist/functions/templates/hono-typescript/package.json +0 -26
- package/dist/functions/templates/hono-typescript/src/adapters/request.ts +0 -74
- package/dist/functions/templates/hono-typescript/src/adapters/response.ts +0 -106
- package/dist/functions/templates/hono-typescript/src/app.ts +0 -180
- package/dist/functions/templates/hono-typescript/src/context.ts +0 -103
- package/dist/functions/templates/hono-typescript/src/index.ts +0 -54
- package/dist/functions/templates/hono-typescript/src/middleware/appwrite.ts +0 -119
- package/dist/functions/templates/hono-typescript/tsconfig.json +0 -20
- package/dist/functions/templates/typescript-node/README.md +0 -32
- package/dist/functions/templates/typescript-node/package.json +0 -25
- package/dist/functions/templates/typescript-node/src/context.ts +0 -103
- package/dist/functions/templates/typescript-node/src/index.ts +0 -29
- package/dist/functions/templates/typescript-node/tsconfig.json +0 -28
- package/dist/functions/templates/uv/README.md +0 -31
- package/dist/functions/templates/uv/pyproject.toml +0 -30
- package/dist/functions/templates/uv/src/__init__.py +0 -0
- package/dist/functions/templates/uv/src/context.py +0 -125
- package/dist/functions/templates/uv/src/index.py +0 -46
- package/dist/init.d.ts +0 -2
- package/dist/init.js +0 -57
- package/dist/interactiveCLI.d.ts +0 -31
- package/dist/interactiveCLI.js +0 -898
- package/dist/main.d.ts +0 -2
- package/dist/main.js +0 -1180
- package/dist/migrations/afterImportActions.d.ts +0 -17
- package/dist/migrations/afterImportActions.js +0 -306
- package/dist/migrations/appwriteToX.d.ts +0 -211
- package/dist/migrations/appwriteToX.js +0 -491
- package/dist/migrations/comprehensiveTransfer.d.ts +0 -147
- package/dist/migrations/comprehensiveTransfer.js +0 -1317
- package/dist/migrations/dataLoader.d.ts +0 -753
- package/dist/migrations/dataLoader.js +0 -1250
- package/dist/migrations/importController.d.ts +0 -23
- package/dist/migrations/importController.js +0 -268
- package/dist/migrations/importDataActions.d.ts +0 -50
- package/dist/migrations/importDataActions.js +0 -230
- package/dist/migrations/relationships.d.ts +0 -29
- package/dist/migrations/relationships.js +0 -204
- package/dist/migrations/services/DataTransformationService.d.ts +0 -55
- package/dist/migrations/services/DataTransformationService.js +0 -158
- package/dist/migrations/services/FileHandlerService.d.ts +0 -75
- package/dist/migrations/services/FileHandlerService.js +0 -236
- package/dist/migrations/services/ImportOrchestrator.d.ts +0 -97
- package/dist/migrations/services/ImportOrchestrator.js +0 -485
- package/dist/migrations/services/RateLimitManager.d.ts +0 -138
- package/dist/migrations/services/RateLimitManager.js +0 -279
- package/dist/migrations/services/RelationshipResolver.d.ts +0 -120
- package/dist/migrations/services/RelationshipResolver.js +0 -332
- package/dist/migrations/services/UserMappingService.d.ts +0 -109
- package/dist/migrations/services/UserMappingService.js +0 -277
- package/dist/migrations/services/ValidationService.d.ts +0 -74
- package/dist/migrations/services/ValidationService.js +0 -260
- package/dist/migrations/transfer.d.ts +0 -26
- package/dist/migrations/transfer.js +0 -608
- package/dist/migrations/yaml/YamlImportConfigLoader.d.ts +0 -131
- package/dist/migrations/yaml/YamlImportConfigLoader.js +0 -383
- package/dist/migrations/yaml/YamlImportIntegration.d.ts +0 -93
- package/dist/migrations/yaml/YamlImportIntegration.js +0 -341
- package/dist/migrations/yaml/generateImportSchemas.d.ts +0 -30
- package/dist/migrations/yaml/generateImportSchemas.js +0 -1327
- package/dist/schemas/authUser.d.ts +0 -24
- package/dist/schemas/authUser.js +0 -17
- package/dist/setup.d.ts +0 -2
- package/dist/setup.js +0 -5
- package/dist/setupCommands.d.ts +0 -58
- package/dist/setupCommands.js +0 -490
- package/dist/setupController.d.ts +0 -9
- package/dist/setupController.js +0 -34
- package/dist/shared/attributeMapper.d.ts +0 -20
- package/dist/shared/attributeMapper.js +0 -203
- package/dist/shared/backupMetadataSchema.d.ts +0 -94
- package/dist/shared/backupMetadataSchema.js +0 -38
- package/dist/shared/backupTracking.d.ts +0 -18
- package/dist/shared/backupTracking.js +0 -176
- package/dist/shared/confirmationDialogs.d.ts +0 -75
- package/dist/shared/confirmationDialogs.js +0 -236
- package/dist/shared/errorUtils.d.ts +0 -54
- package/dist/shared/errorUtils.js +0 -95
- package/dist/shared/functionManager.d.ts +0 -48
- package/dist/shared/functionManager.js +0 -348
- package/dist/shared/jsonSchemaGenerator.d.ts +0 -50
- package/dist/shared/jsonSchemaGenerator.js +0 -290
- package/dist/shared/logging.d.ts +0 -61
- package/dist/shared/logging.js +0 -116
- package/dist/shared/messageFormatter.d.ts +0 -39
- package/dist/shared/messageFormatter.js +0 -162
- package/dist/shared/migrationHelpers.d.ts +0 -61
- package/dist/shared/migrationHelpers.js +0 -145
- package/dist/shared/operationLogger.d.ts +0 -10
- package/dist/shared/operationLogger.js +0 -12
- package/dist/shared/operationQueue.d.ts +0 -40
- package/dist/shared/operationQueue.js +0 -311
- package/dist/shared/operationsTable.d.ts +0 -26
- package/dist/shared/operationsTable.js +0 -286
- package/dist/shared/operationsTableSchema.d.ts +0 -48
- package/dist/shared/operationsTableSchema.js +0 -35
- package/dist/shared/progressManager.d.ts +0 -62
- package/dist/shared/progressManager.js +0 -215
- package/dist/shared/pydanticModelGenerator.d.ts +0 -17
- package/dist/shared/pydanticModelGenerator.js +0 -615
- package/dist/shared/relationshipExtractor.d.ts +0 -56
- package/dist/shared/relationshipExtractor.js +0 -138
- package/dist/shared/schemaGenerator.d.ts +0 -40
- package/dist/shared/schemaGenerator.js +0 -556
- package/dist/shared/selectionDialogs.d.ts +0 -214
- package/dist/shared/selectionDialogs.js +0 -544
- package/dist/storage/backupCompression.d.ts +0 -20
- package/dist/storage/backupCompression.js +0 -67
- package/dist/storage/methods.d.ts +0 -32
- package/dist/storage/methods.js +0 -472
- package/dist/storage/schemas.d.ts +0 -842
- package/dist/storage/schemas.js +0 -175
- package/dist/tables/indexManager.d.ts +0 -65
- package/dist/tables/indexManager.js +0 -294
- package/dist/types.d.ts +0 -4
- package/dist/types.js +0 -3
- package/dist/users/methods.d.ts +0 -16
- package/dist/users/methods.js +0 -277
- package/dist/utils/ClientFactory.d.ts +0 -87
- package/dist/utils/ClientFactory.js +0 -212
- package/dist/utils/configDiscovery.d.ts +0 -78
- package/dist/utils/configDiscovery.js +0 -472
- package/dist/utils/configMigration.d.ts +0 -1
- package/dist/utils/configMigration.js +0 -261
- package/dist/utils/constantsGenerator.d.ts +0 -31
- package/dist/utils/constantsGenerator.js +0 -321
- package/dist/utils/dataConverters.d.ts +0 -46
- package/dist/utils/dataConverters.js +0 -139
- package/dist/utils/directoryUtils.d.ts +0 -22
- package/dist/utils/directoryUtils.js +0 -59
- package/dist/utils/getClientFromConfig.d.ts +0 -39
- package/dist/utils/getClientFromConfig.js +0 -199
- package/dist/utils/helperFunctions.d.ts +0 -63
- package/dist/utils/helperFunctions.js +0 -156
- package/dist/utils/index.d.ts +0 -2
- package/dist/utils/index.js +0 -2
- package/dist/utils/loadConfigs.d.ts +0 -50
- package/dist/utils/loadConfigs.js +0 -358
- package/dist/utils/pathResolvers.d.ts +0 -53
- package/dist/utils/pathResolvers.js +0 -72
- package/dist/utils/projectConfig.d.ts +0 -122
- package/dist/utils/projectConfig.js +0 -206
- package/dist/utils/retryFailedPromises.d.ts +0 -2
- package/dist/utils/retryFailedPromises.js +0 -23
- package/dist/utils/sessionAuth.d.ts +0 -48
- package/dist/utils/sessionAuth.js +0 -164
- package/dist/utils/setupFiles.d.ts +0 -4
- package/dist/utils/setupFiles.js +0 -1192
- package/dist/utils/typeGuards.d.ts +0 -35
- package/dist/utils/typeGuards.js +0 -57
- package/dist/utils/validationRules.d.ts +0 -43
- package/dist/utils/validationRules.js +0 -42
- package/dist/utils/versionDetection.d.ts +0 -58
- package/dist/utils/versionDetection.js +0 -251
- package/dist/utils/yamlConverter.d.ts +0 -100
- package/dist/utils/yamlConverter.js +0 -428
- package/dist/utils/yamlLoader.d.ts +0 -70
- package/dist/utils/yamlLoader.js +0 -267
- package/dist/utilsController.d.ts +0 -107
- package/dist/utilsController.js +0 -873
- package/src/adapters/AdapterFactory.ts +0 -529
- package/src/adapters/DatabaseAdapter.ts +0 -319
- package/src/adapters/LegacyAdapter.ts +0 -844
- package/src/adapters/TablesDBAdapter.ts +0 -823
- package/src/config/ConfigManager.ts +0 -849
- package/src/config/README.md +0 -274
- package/src/config/configMigration.ts +0 -575
- package/src/config/configValidation.ts +0 -445
- package/src/config/index.ts +0 -10
- package/src/config/services/ConfigDiscoveryService.ts +0 -410
- package/src/config/services/ConfigLoaderService.ts +0 -732
- package/src/config/services/ConfigMergeService.ts +0 -388
- package/src/config/services/ConfigValidationService.ts +0 -394
- package/src/config/services/SessionAuthService.ts +0 -565
- package/src/config/services/__tests__/ConfigMergeService.test.ts +0 -351
- package/src/config/services/index.ts +0 -29
- package/src/config/yamlConfig.ts +0 -761
- package/src/functions/pathResolution.ts +0 -227
- package/src/functions/templates/count-docs-in-collection/package.json +0 -25
- package/src/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
- package/src/functions/templates/hono-typescript/package.json +0 -26
- package/src/functions/templates/hono-typescript/tsconfig.json +0 -20
- package/src/functions/templates/typescript-node/package.json +0 -25
- package/src/functions/templates/typescript-node/tsconfig.json +0 -28
- package/src/shared/attributeMapper.ts +0 -229
- package/src/shared/errorUtils.ts +0 -110
- package/src/shared/functionManager.ts +0 -537
- package/src/shared/jsonSchemaGenerator.ts +0 -383
- package/src/shared/logging.ts +0 -149
- package/src/shared/messageFormatter.ts +0 -208
- package/src/shared/pydanticModelGenerator.ts +0 -618
- package/src/shared/schemaGenerator.ts +0 -644
- package/src/utils/ClientFactory.ts +0 -240
- package/src/utils/configDiscovery.ts +0 -557
- package/src/utils/constantsGenerator.ts +0 -369
- package/src/utils/dataConverters.ts +0 -159
- package/src/utils/directoryUtils.ts +0 -61
- package/src/utils/getClientFromConfig.ts +0 -257
- package/src/utils/helperFunctions.ts +0 -228
- package/src/utils/pathResolvers.ts +0 -81
- package/src/utils/projectConfig.ts +0 -340
- package/src/utils/retryFailedPromises.ts +0 -29
- package/src/utils/sessionAuth.ts +0 -230
- package/src/utils/typeGuards.ts +0 -65
- package/src/utils/validationRules.ts +0 -88
- package/src/utils/versionDetection.ts +0 -292
- package/src/utils/yamlConverter.ts +0 -542
- package/src/utils/yamlLoader.ts +0 -371
- package/tmp-sync-test/.appwrite/collections/TestCollection.yaml +0 -7
|
@@ -4,17 +4,16 @@ import {
|
|
|
4
4
|
ID,
|
|
5
5
|
Query,
|
|
6
6
|
} from "node-appwrite";
|
|
7
|
-
import { tryAwaitWithRetry, delay, calculateExponentialBackoff } from "
|
|
8
|
-
import { MessageFormatter } from "../shared/messageFormatter.js";
|
|
7
|
+
import { tryAwaitWithRetry, delay, calculateExponentialBackoff, MessageFormatter } from "appwrite-utils-helpers";
|
|
9
8
|
import { chunk } from "es-toolkit";
|
|
10
|
-
import type { DatabaseAdapter } from "
|
|
11
|
-
import { isLegacyDatabases } from "
|
|
12
|
-
import { getAdapter } from "
|
|
13
|
-
|
|
14
|
-
/**
|
|
15
|
-
* Transfers all documents from one collection to another in a different database
|
|
16
|
-
* within the same Appwrite Project
|
|
17
|
-
*/
|
|
9
|
+
import type { DatabaseAdapter } from "appwrite-utils-helpers";
|
|
10
|
+
import { isLegacyDatabases } from "appwrite-utils-helpers";
|
|
11
|
+
import { getAdapter } from "appwrite-utils-helpers";
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Transfers all documents from one collection to another in a different database
|
|
15
|
+
* within the same Appwrite Project
|
|
16
|
+
*/
|
|
18
17
|
export const transferDocumentsBetweenDbsLocalToLocal = async (
|
|
19
18
|
db: Databases | DatabaseAdapter,
|
|
20
19
|
fromDbId: string,
|
|
@@ -172,327 +171,327 @@ export const transferDocumentsBetweenDbsLocalToLocal = async (
|
|
|
172
171
|
{ prefix: "Transfer" }
|
|
173
172
|
);
|
|
174
173
|
};
|
|
175
|
-
|
|
176
|
-
/**
|
|
177
|
-
* Enhanced document transfer with fault tolerance and exponential backoff
|
|
178
|
-
*/
|
|
179
|
-
const transferDocumentWithRetry = async (
|
|
180
|
-
db: Databases,
|
|
181
|
-
dbId: string,
|
|
182
|
-
collectionId: string,
|
|
183
|
-
documentId: string,
|
|
184
|
-
documentData: any,
|
|
185
|
-
permissions: string[],
|
|
186
|
-
maxRetries: number = 3,
|
|
187
|
-
retryCount: number = 0
|
|
188
|
-
): Promise<boolean> => {
|
|
189
|
-
try {
|
|
190
|
-
await db.createDocument(
|
|
191
|
-
dbId,
|
|
192
|
-
collectionId,
|
|
193
|
-
documentId,
|
|
194
|
-
documentData,
|
|
195
|
-
permissions
|
|
196
|
-
);
|
|
197
|
-
return true;
|
|
198
|
-
} catch (error: any) {
|
|
199
|
-
// Check if document already exists
|
|
200
|
-
if (error.code === 409 || error.message?.toLowerCase().includes('already exists')) {
|
|
201
|
-
await db.updateDocument(
|
|
202
|
-
dbId,
|
|
203
|
-
collectionId,
|
|
204
|
-
documentId,
|
|
205
|
-
documentData,
|
|
206
|
-
permissions
|
|
207
|
-
);
|
|
208
|
-
}
|
|
209
|
-
|
|
210
|
-
if (retryCount < maxRetries) {
|
|
211
|
-
// Calculate exponential backoff: 1s, 2s, 4s, max 8s
|
|
212
|
-
const exponentialDelay = calculateExponentialBackoff(retryCount, 1000, 8000);
|
|
213
|
-
MessageFormatter.progress(`Retrying document ${documentId} (attempt ${retryCount + 1}/${maxRetries}, backoff: ${exponentialDelay}ms)`, { prefix: "Transfer" });
|
|
214
|
-
|
|
215
|
-
await delay(exponentialDelay);
|
|
216
|
-
|
|
217
|
-
return await transferDocumentWithRetry(
|
|
218
|
-
db,
|
|
219
|
-
dbId,
|
|
220
|
-
collectionId,
|
|
221
|
-
documentId,
|
|
222
|
-
documentData,
|
|
223
|
-
permissions,
|
|
224
|
-
maxRetries,
|
|
225
|
-
retryCount + 1
|
|
226
|
-
);
|
|
227
|
-
}
|
|
228
|
-
|
|
229
|
-
MessageFormatter.error(`Failed to transfer document ${documentId} after ${maxRetries} retries`, error, { prefix: "Transfer" });
|
|
230
|
-
return false;
|
|
231
|
-
}
|
|
232
|
-
};
|
|
233
|
-
|
|
234
|
-
/**
|
|
235
|
-
* Check if endpoint supports bulk operations (cloud.appwrite.io)
|
|
236
|
-
*/
|
|
237
|
-
const supportsBulkOperations = (endpoint: string): boolean => {
|
|
238
|
-
return endpoint.includes('cloud.appwrite.io');
|
|
239
|
-
};
|
|
240
|
-
|
|
241
|
-
/**
|
|
242
|
-
* Direct HTTP implementation of bulk upsert API
|
|
243
|
-
*/
|
|
244
|
-
const bulkUpsertDocuments = async (
|
|
245
|
-
client: any,
|
|
246
|
-
dbId: string,
|
|
247
|
-
collectionId: string,
|
|
248
|
-
documents: any[]
|
|
249
|
-
): Promise<any> => {
|
|
250
|
-
const apiPath = `/databases/${dbId}/collections/${collectionId}/documents`;
|
|
251
|
-
const url = new URL(client.config.endpoint + apiPath);
|
|
252
|
-
|
|
253
|
-
const headers = {
|
|
254
|
-
'Content-Type': 'application/json',
|
|
255
|
-
'X-Appwrite-Project': client.config.project,
|
|
256
|
-
'X-Appwrite-Key': client.config.key
|
|
257
|
-
};
|
|
258
|
-
|
|
259
|
-
const response = await fetch(url.toString(), {
|
|
260
|
-
method: 'PUT',
|
|
261
|
-
headers,
|
|
262
|
-
body: JSON.stringify({ documents })
|
|
263
|
-
});
|
|
264
|
-
|
|
265
|
-
if (!response.ok) {
|
|
266
|
-
const errorData: any = await response.json().catch(() => ({ message: 'Unknown error' }));
|
|
267
|
-
throw new Error(`Bulk upsert failed: ${response.status} - ${errorData.message || 'Unknown error'}`);
|
|
268
|
-
}
|
|
269
|
-
|
|
270
|
-
return await response.json();
|
|
271
|
-
};
|
|
272
|
-
|
|
273
|
-
/**
|
|
274
|
-
* Direct HTTP implementation of bulk create API
|
|
275
|
-
*/
|
|
276
|
-
const bulkCreateDocuments = async (
|
|
277
|
-
client: any,
|
|
278
|
-
dbId: string,
|
|
279
|
-
collectionId: string,
|
|
280
|
-
documents: any[]
|
|
281
|
-
): Promise<any> => {
|
|
282
|
-
const apiPath = `/databases/${dbId}/collections/${collectionId}/documents`;
|
|
283
|
-
const url = new URL(client.config.endpoint + apiPath);
|
|
284
|
-
|
|
285
|
-
const headers = {
|
|
286
|
-
'Content-Type': 'application/json',
|
|
287
|
-
'X-Appwrite-Project': client.config.project,
|
|
288
|
-
'X-Appwrite-Key': client.config.key
|
|
289
|
-
};
|
|
290
|
-
|
|
291
|
-
const response = await fetch(url.toString(), {
|
|
292
|
-
method: 'POST',
|
|
293
|
-
headers,
|
|
294
|
-
body: JSON.stringify({ documents })
|
|
295
|
-
});
|
|
296
|
-
|
|
297
|
-
if (!response.ok) {
|
|
298
|
-
const errorData: any = await response.json().catch(() => ({ message: 'Unknown error' }));
|
|
299
|
-
throw new Error(`Bulk create failed: ${response.status} - ${errorData.message || 'Unknown error'}`);
|
|
300
|
-
}
|
|
301
|
-
|
|
302
|
-
return await response.json();
|
|
303
|
-
};
|
|
304
|
-
|
|
305
|
-
/**
|
|
306
|
-
* Enhanced bulk document creation using direct HTTP calls
|
|
307
|
-
*/
|
|
308
|
-
const transferDocumentsBulkUpsert = async (
|
|
309
|
-
client: any,
|
|
310
|
-
dbId: string,
|
|
311
|
-
collectionId: string,
|
|
312
|
-
documents: any[],
|
|
313
|
-
maxBatchSize: number = 1000
|
|
314
|
-
): Promise<{ successful: number; failed: number }> => {
|
|
315
|
-
let successful = 0;
|
|
316
|
-
let failed = 0;
|
|
317
|
-
|
|
318
|
-
// Prepare documents for bulk upsert
|
|
319
|
-
const preparedDocs = documents.map(doc => {
|
|
320
|
-
const toCreateObject: any = { ...doc };
|
|
321
|
-
delete toCreateObject.$databaseId;
|
|
322
|
-
delete toCreateObject.$collectionId;
|
|
323
|
-
delete toCreateObject.$createdAt;
|
|
324
|
-
delete toCreateObject.$updatedAt;
|
|
325
|
-
|
|
326
|
-
// Keep $id and $permissions for upsert functionality
|
|
327
|
-
return toCreateObject;
|
|
328
|
-
});
|
|
329
|
-
|
|
330
|
-
// Process in batches based on plan limits
|
|
331
|
-
const documentBatches = chunk(preparedDocs, maxBatchSize);
|
|
332
|
-
|
|
333
|
-
for (const batch of documentBatches) {
|
|
334
|
-
MessageFormatter.progress(`Bulk upserting ${batch.length} documents...`, { prefix: "Transfer" });
|
|
335
|
-
|
|
336
|
-
try {
|
|
337
|
-
// Try bulk upsert with direct HTTP call
|
|
338
|
-
const result = await bulkUpsertDocuments(client, dbId, collectionId, batch);
|
|
339
|
-
successful += result.documents?.length || batch.length;
|
|
340
|
-
MessageFormatter.success(`Bulk upserted ${result.documents?.length || batch.length} documents`, { prefix: "Transfer" });
|
|
341
|
-
|
|
342
|
-
} catch (error: any) {
|
|
343
|
-
MessageFormatter.progress(`Bulk upsert failed, trying smaller batch size...`, { prefix: "Transfer" });
|
|
344
|
-
|
|
345
|
-
// If bulk upsert fails, try with smaller batch size (Pro plan limit)
|
|
346
|
-
if (maxBatchSize > 100) {
|
|
347
|
-
const smallerBatches = chunk(batch, 100);
|
|
348
|
-
|
|
349
|
-
for (const smallBatch of smallerBatches) {
|
|
350
|
-
try {
|
|
351
|
-
const result = await bulkUpsertDocuments(client, dbId, collectionId, smallBatch);
|
|
352
|
-
successful += result.documents?.length || smallBatch.length;
|
|
353
|
-
MessageFormatter.success(`Bulk upserted ${result.documents?.length || smallBatch.length} documents (smaller batch)`, { prefix: "Transfer" });
|
|
354
|
-
} catch (smallBatchError: any) {
|
|
355
|
-
MessageFormatter.progress(`Smaller batch failed, falling back to individual transfers...`, { prefix: "Transfer" });
|
|
356
|
-
|
|
357
|
-
// Fall back to individual document transfer for this batch
|
|
358
|
-
const db = new Databases(client);
|
|
359
|
-
const { successful: indivSuccessful, failed: indivFailed } = await transferDocumentBatchWithRetryFallback(
|
|
360
|
-
db, dbId, collectionId, smallBatch.map((doc, index) => ({
|
|
361
|
-
...doc,
|
|
362
|
-
$id: documents[documentBatches.indexOf(batch) * maxBatchSize + smallerBatches.indexOf(smallBatch) * 100 + index]?.$id || ID.unique(),
|
|
363
|
-
$permissions: documents[documentBatches.indexOf(batch) * maxBatchSize + smallerBatches.indexOf(smallBatch) * 100 + index]?.$permissions || []
|
|
364
|
-
}))
|
|
365
|
-
);
|
|
366
|
-
successful += indivSuccessful;
|
|
367
|
-
failed += indivFailed;
|
|
368
|
-
}
|
|
369
|
-
|
|
370
|
-
// Add delay between batches
|
|
371
|
-
await delay(200);
|
|
372
|
-
}
|
|
373
|
-
} else {
|
|
374
|
-
// Fall back to individual document transfer
|
|
375
|
-
const db = new Databases(client);
|
|
376
|
-
const { successful: indivSuccessful, failed: indivFailed } = await transferDocumentBatchWithRetryFallback(
|
|
377
|
-
db, dbId, collectionId, batch.map((doc, index) => ({
|
|
378
|
-
...doc,
|
|
379
|
-
$id: documents[documentBatches.indexOf(batch) * maxBatchSize + index]?.$id || ID.unique(),
|
|
380
|
-
$permissions: documents[documentBatches.indexOf(batch) * maxBatchSize + index]?.$permissions || []
|
|
381
|
-
}))
|
|
382
|
-
);
|
|
383
|
-
successful += indivSuccessful;
|
|
384
|
-
failed += indivFailed;
|
|
385
|
-
}
|
|
386
|
-
}
|
|
387
|
-
|
|
388
|
-
// Add delay between major batches
|
|
389
|
-
if (documentBatches.indexOf(batch) < documentBatches.length - 1) {
|
|
390
|
-
await delay(500);
|
|
391
|
-
}
|
|
392
|
-
}
|
|
393
|
-
|
|
394
|
-
return { successful, failed };
|
|
395
|
-
};
|
|
396
|
-
|
|
397
|
-
/**
|
|
398
|
-
* Fallback batch document transfer with individual retry logic
|
|
399
|
-
*/
|
|
400
|
-
const transferDocumentBatchWithRetryFallback = async (
|
|
401
|
-
db: Databases,
|
|
402
|
-
dbId: string,
|
|
403
|
-
collectionId: string,
|
|
404
|
-
documents: any[],
|
|
405
|
-
batchSize: number = 10
|
|
406
|
-
): Promise<{ successful: number; failed: number }> => {
|
|
407
|
-
let successful = 0;
|
|
408
|
-
let failed = 0;
|
|
409
|
-
|
|
410
|
-
// Process documents in smaller batches to avoid overwhelming the server
|
|
411
|
-
const documentBatches = chunk(documents, batchSize);
|
|
412
|
-
|
|
413
|
-
for (const batch of documentBatches) {
|
|
414
|
-
MessageFormatter.progress(`Processing batch of ${batch.length} documents...`, { prefix: "Transfer" });
|
|
415
|
-
|
|
416
|
-
const batchPromises = batch.map(async (doc) => {
|
|
417
|
-
const toCreateObject: Partial<typeof doc> = { ...doc };
|
|
418
|
-
delete toCreateObject.$databaseId;
|
|
419
|
-
delete toCreateObject.$collectionId;
|
|
420
|
-
delete toCreateObject.$createdAt;
|
|
421
|
-
delete toCreateObject.$updatedAt;
|
|
422
|
-
delete toCreateObject.$id;
|
|
423
|
-
delete toCreateObject.$permissions;
|
|
424
|
-
|
|
425
|
-
const result = await transferDocumentWithRetry(
|
|
426
|
-
db,
|
|
427
|
-
dbId,
|
|
428
|
-
collectionId,
|
|
429
|
-
doc.$id,
|
|
430
|
-
toCreateObject,
|
|
431
|
-
doc.$permissions || []
|
|
432
|
-
);
|
|
433
|
-
|
|
434
|
-
return { docId: doc.$id, success: result };
|
|
435
|
-
});
|
|
436
|
-
|
|
437
|
-
const results = await Promise.allSettled(batchPromises);
|
|
438
|
-
|
|
439
|
-
results.forEach((result, index) => {
|
|
440
|
-
if (result.status === 'fulfilled') {
|
|
441
|
-
if (result.value.success) {
|
|
442
|
-
successful++;
|
|
443
|
-
} else {
|
|
444
|
-
failed++;
|
|
445
|
-
}
|
|
446
|
-
} else {
|
|
447
|
-
MessageFormatter.error(`Batch promise rejected for document ${batch[index].$id}`, new Error(String(result.reason)), { prefix: "Transfer" });
|
|
448
|
-
failed++;
|
|
449
|
-
}
|
|
450
|
-
});
|
|
451
|
-
|
|
452
|
-
// Add delay between batches to avoid rate limiting
|
|
453
|
-
if (documentBatches.indexOf(batch) < documentBatches.length - 1) {
|
|
454
|
-
await delay(500);
|
|
455
|
-
}
|
|
456
|
-
}
|
|
457
|
-
|
|
458
|
-
return { successful, failed };
|
|
459
|
-
};
|
|
460
|
-
|
|
461
|
-
/**
|
|
462
|
-
* Enhanced batch document transfer with fault tolerance and bulk API support
|
|
463
|
-
*/
|
|
464
|
-
const transferDocumentBatchWithRetry = async (
|
|
465
|
-
db: Databases,
|
|
466
|
-
client: any,
|
|
467
|
-
dbId: string,
|
|
468
|
-
collectionId: string,
|
|
469
|
-
documents: any[],
|
|
470
|
-
batchSize: number = 10
|
|
471
|
-
): Promise<{ successful: number; failed: number }> => {
|
|
472
|
-
// Check if we can use bulk operations
|
|
473
|
-
if (supportsBulkOperations(client.config.endpoint)) {
|
|
474
|
-
MessageFormatter.info(`Using bulk upsert API for faster document transfer`, { prefix: "Transfer" });
|
|
475
|
-
|
|
476
|
-
// Try with Scale plan limit first (2500), then Pro (1000), then Free (100)
|
|
477
|
-
const batchSizes = [1000, 100]; // Start with Pro plan, fallback to Free
|
|
478
|
-
|
|
479
|
-
for (const maxBatchSize of batchSizes) {
|
|
480
|
-
try {
|
|
481
|
-
return await transferDocumentsBulkUpsert(client, dbId, collectionId, documents, maxBatchSize);
|
|
482
|
-
} catch (error: any) {
|
|
483
|
-
MessageFormatter.progress(`Bulk upsert with batch size ${maxBatchSize} failed, trying smaller size...`, { prefix: "Transfer" });
|
|
484
|
-
continue;
|
|
485
|
-
}
|
|
486
|
-
}
|
|
487
|
-
|
|
488
|
-
// If all bulk operations fail, fall back to individual transfers
|
|
489
|
-
MessageFormatter.progress(`All bulk operations failed, falling back to individual document transfers`, { prefix: "Transfer" });
|
|
490
|
-
}
|
|
491
|
-
|
|
492
|
-
// Fall back to individual document transfer
|
|
493
|
-
return await transferDocumentBatchWithRetryFallback(db, dbId, collectionId, documents, batchSize);
|
|
494
|
-
};
|
|
495
|
-
|
|
174
|
+
|
|
175
|
+
/**
|
|
176
|
+
* Enhanced document transfer with fault tolerance and exponential backoff
|
|
177
|
+
*/
|
|
178
|
+
const transferDocumentWithRetry = async (
|
|
179
|
+
db: Databases,
|
|
180
|
+
dbId: string,
|
|
181
|
+
collectionId: string,
|
|
182
|
+
documentId: string,
|
|
183
|
+
documentData: any,
|
|
184
|
+
permissions: string[],
|
|
185
|
+
maxRetries: number = 3,
|
|
186
|
+
retryCount: number = 0
|
|
187
|
+
): Promise<boolean> => {
|
|
188
|
+
try {
|
|
189
|
+
await db.createDocument(
|
|
190
|
+
dbId,
|
|
191
|
+
collectionId,
|
|
192
|
+
documentId,
|
|
193
|
+
documentData,
|
|
194
|
+
permissions
|
|
195
|
+
);
|
|
196
|
+
return true;
|
|
197
|
+
} catch (error: any) {
|
|
198
|
+
// Check if document already exists
|
|
199
|
+
if (error.code === 409 || error.message?.toLowerCase().includes('already exists')) {
|
|
200
|
+
await db.updateDocument(
|
|
201
|
+
dbId,
|
|
202
|
+
collectionId,
|
|
203
|
+
documentId,
|
|
204
|
+
documentData,
|
|
205
|
+
permissions
|
|
206
|
+
);
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
if (retryCount < maxRetries) {
|
|
210
|
+
// Calculate exponential backoff: 1s, 2s, 4s, max 8s
|
|
211
|
+
const exponentialDelay = calculateExponentialBackoff(retryCount, 1000, 8000);
|
|
212
|
+
MessageFormatter.progress(`Retrying document ${documentId} (attempt ${retryCount + 1}/${maxRetries}, backoff: ${exponentialDelay}ms)`, { prefix: "Transfer" });
|
|
213
|
+
|
|
214
|
+
await delay(exponentialDelay);
|
|
215
|
+
|
|
216
|
+
return await transferDocumentWithRetry(
|
|
217
|
+
db,
|
|
218
|
+
dbId,
|
|
219
|
+
collectionId,
|
|
220
|
+
documentId,
|
|
221
|
+
documentData,
|
|
222
|
+
permissions,
|
|
223
|
+
maxRetries,
|
|
224
|
+
retryCount + 1
|
|
225
|
+
);
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
MessageFormatter.error(`Failed to transfer document ${documentId} after ${maxRetries} retries`, error, { prefix: "Transfer" });
|
|
229
|
+
return false;
|
|
230
|
+
}
|
|
231
|
+
};
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Check if endpoint supports bulk operations (cloud.appwrite.io)
|
|
235
|
+
*/
|
|
236
|
+
const supportsBulkOperations = (endpoint: string): boolean => {
|
|
237
|
+
return endpoint.includes('cloud.appwrite.io');
|
|
238
|
+
};
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* Direct HTTP implementation of bulk upsert API
|
|
242
|
+
*/
|
|
243
|
+
const bulkUpsertDocuments = async (
|
|
244
|
+
client: any,
|
|
245
|
+
dbId: string,
|
|
246
|
+
collectionId: string,
|
|
247
|
+
documents: any[]
|
|
248
|
+
): Promise<any> => {
|
|
249
|
+
const apiPath = `/databases/${dbId}/collections/${collectionId}/documents`;
|
|
250
|
+
const url = new URL(client.config.endpoint + apiPath);
|
|
251
|
+
|
|
252
|
+
const headers = {
|
|
253
|
+
'Content-Type': 'application/json',
|
|
254
|
+
'X-Appwrite-Project': client.config.project,
|
|
255
|
+
'X-Appwrite-Key': client.config.key
|
|
256
|
+
};
|
|
257
|
+
|
|
258
|
+
const response = await fetch(url.toString(), {
|
|
259
|
+
method: 'PUT',
|
|
260
|
+
headers,
|
|
261
|
+
body: JSON.stringify({ documents })
|
|
262
|
+
});
|
|
263
|
+
|
|
264
|
+
if (!response.ok) {
|
|
265
|
+
const errorData: any = await response.json().catch(() => ({ message: 'Unknown error' }));
|
|
266
|
+
throw new Error(`Bulk upsert failed: ${response.status} - ${errorData.message || 'Unknown error'}`);
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
return await response.json();
|
|
270
|
+
};
|
|
271
|
+
|
|
272
|
+
/**
|
|
273
|
+
* Direct HTTP implementation of bulk create API
|
|
274
|
+
*/
|
|
275
|
+
const bulkCreateDocuments = async (
|
|
276
|
+
client: any,
|
|
277
|
+
dbId: string,
|
|
278
|
+
collectionId: string,
|
|
279
|
+
documents: any[]
|
|
280
|
+
): Promise<any> => {
|
|
281
|
+
const apiPath = `/databases/${dbId}/collections/${collectionId}/documents`;
|
|
282
|
+
const url = new URL(client.config.endpoint + apiPath);
|
|
283
|
+
|
|
284
|
+
const headers = {
|
|
285
|
+
'Content-Type': 'application/json',
|
|
286
|
+
'X-Appwrite-Project': client.config.project,
|
|
287
|
+
'X-Appwrite-Key': client.config.key
|
|
288
|
+
};
|
|
289
|
+
|
|
290
|
+
const response = await fetch(url.toString(), {
|
|
291
|
+
method: 'POST',
|
|
292
|
+
headers,
|
|
293
|
+
body: JSON.stringify({ documents })
|
|
294
|
+
});
|
|
295
|
+
|
|
296
|
+
if (!response.ok) {
|
|
297
|
+
const errorData: any = await response.json().catch(() => ({ message: 'Unknown error' }));
|
|
298
|
+
throw new Error(`Bulk create failed: ${response.status} - ${errorData.message || 'Unknown error'}`);
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
return await response.json();
|
|
302
|
+
};
|
|
303
|
+
|
|
304
|
+
/**
|
|
305
|
+
* Enhanced bulk document creation using direct HTTP calls
|
|
306
|
+
*/
|
|
307
|
+
const transferDocumentsBulkUpsert = async (
|
|
308
|
+
client: any,
|
|
309
|
+
dbId: string,
|
|
310
|
+
collectionId: string,
|
|
311
|
+
documents: any[],
|
|
312
|
+
maxBatchSize: number = 1000
|
|
313
|
+
): Promise<{ successful: number; failed: number }> => {
|
|
314
|
+
let successful = 0;
|
|
315
|
+
let failed = 0;
|
|
316
|
+
|
|
317
|
+
// Prepare documents for bulk upsert
|
|
318
|
+
const preparedDocs = documents.map(doc => {
|
|
319
|
+
const toCreateObject: any = { ...doc };
|
|
320
|
+
delete toCreateObject.$databaseId;
|
|
321
|
+
delete toCreateObject.$collectionId;
|
|
322
|
+
delete toCreateObject.$createdAt;
|
|
323
|
+
delete toCreateObject.$updatedAt;
|
|
324
|
+
|
|
325
|
+
// Keep $id and $permissions for upsert functionality
|
|
326
|
+
return toCreateObject;
|
|
327
|
+
});
|
|
328
|
+
|
|
329
|
+
// Process in batches based on plan limits
|
|
330
|
+
const documentBatches = chunk(preparedDocs, maxBatchSize);
|
|
331
|
+
|
|
332
|
+
for (const batch of documentBatches) {
|
|
333
|
+
MessageFormatter.progress(`Bulk upserting ${batch.length} documents...`, { prefix: "Transfer" });
|
|
334
|
+
|
|
335
|
+
try {
|
|
336
|
+
// Try bulk upsert with direct HTTP call
|
|
337
|
+
const result = await bulkUpsertDocuments(client, dbId, collectionId, batch);
|
|
338
|
+
successful += result.documents?.length || batch.length;
|
|
339
|
+
MessageFormatter.success(`Bulk upserted ${result.documents?.length || batch.length} documents`, { prefix: "Transfer" });
|
|
340
|
+
|
|
341
|
+
} catch (error: any) {
|
|
342
|
+
MessageFormatter.progress(`Bulk upsert failed, trying smaller batch size...`, { prefix: "Transfer" });
|
|
343
|
+
|
|
344
|
+
// If bulk upsert fails, try with smaller batch size (Pro plan limit)
|
|
345
|
+
if (maxBatchSize > 100) {
|
|
346
|
+
const smallerBatches = chunk(batch, 100);
|
|
347
|
+
|
|
348
|
+
for (const smallBatch of smallerBatches) {
|
|
349
|
+
try {
|
|
350
|
+
const result = await bulkUpsertDocuments(client, dbId, collectionId, smallBatch);
|
|
351
|
+
successful += result.documents?.length || smallBatch.length;
|
|
352
|
+
MessageFormatter.success(`Bulk upserted ${result.documents?.length || smallBatch.length} documents (smaller batch)`, { prefix: "Transfer" });
|
|
353
|
+
} catch (smallBatchError: any) {
|
|
354
|
+
MessageFormatter.progress(`Smaller batch failed, falling back to individual transfers...`, { prefix: "Transfer" });
|
|
355
|
+
|
|
356
|
+
// Fall back to individual document transfer for this batch
|
|
357
|
+
const db = new Databases(client);
|
|
358
|
+
const { successful: indivSuccessful, failed: indivFailed } = await transferDocumentBatchWithRetryFallback(
|
|
359
|
+
db, dbId, collectionId, smallBatch.map((doc, index) => ({
|
|
360
|
+
...doc,
|
|
361
|
+
$id: documents[documentBatches.indexOf(batch) * maxBatchSize + smallerBatches.indexOf(smallBatch) * 100 + index]?.$id || ID.unique(),
|
|
362
|
+
$permissions: documents[documentBatches.indexOf(batch) * maxBatchSize + smallerBatches.indexOf(smallBatch) * 100 + index]?.$permissions || []
|
|
363
|
+
}))
|
|
364
|
+
);
|
|
365
|
+
successful += indivSuccessful;
|
|
366
|
+
failed += indivFailed;
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
// Add delay between batches
|
|
370
|
+
await delay(200);
|
|
371
|
+
}
|
|
372
|
+
} else {
|
|
373
|
+
// Fall back to individual document transfer
|
|
374
|
+
const db = new Databases(client);
|
|
375
|
+
const { successful: indivSuccessful, failed: indivFailed } = await transferDocumentBatchWithRetryFallback(
|
|
376
|
+
db, dbId, collectionId, batch.map((doc, index) => ({
|
|
377
|
+
...doc,
|
|
378
|
+
$id: documents[documentBatches.indexOf(batch) * maxBatchSize + index]?.$id || ID.unique(),
|
|
379
|
+
$permissions: documents[documentBatches.indexOf(batch) * maxBatchSize + index]?.$permissions || []
|
|
380
|
+
}))
|
|
381
|
+
);
|
|
382
|
+
successful += indivSuccessful;
|
|
383
|
+
failed += indivFailed;
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
|
|
387
|
+
// Add delay between major batches
|
|
388
|
+
if (documentBatches.indexOf(batch) < documentBatches.length - 1) {
|
|
389
|
+
await delay(500);
|
|
390
|
+
}
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
return { successful, failed };
|
|
394
|
+
};
|
|
395
|
+
|
|
396
|
+
/**
|
|
397
|
+
* Fallback batch document transfer with individual retry logic
|
|
398
|
+
*/
|
|
399
|
+
const transferDocumentBatchWithRetryFallback = async (
|
|
400
|
+
db: Databases,
|
|
401
|
+
dbId: string,
|
|
402
|
+
collectionId: string,
|
|
403
|
+
documents: any[],
|
|
404
|
+
batchSize: number = 10
|
|
405
|
+
): Promise<{ successful: number; failed: number }> => {
|
|
406
|
+
let successful = 0;
|
|
407
|
+
let failed = 0;
|
|
408
|
+
|
|
409
|
+
// Process documents in smaller batches to avoid overwhelming the server
|
|
410
|
+
const documentBatches = chunk(documents, batchSize);
|
|
411
|
+
|
|
412
|
+
for (const batch of documentBatches) {
|
|
413
|
+
MessageFormatter.progress(`Processing batch of ${batch.length} documents...`, { prefix: "Transfer" });
|
|
414
|
+
|
|
415
|
+
const batchPromises = batch.map(async (doc) => {
|
|
416
|
+
const toCreateObject: Partial<typeof doc> = { ...doc };
|
|
417
|
+
delete toCreateObject.$databaseId;
|
|
418
|
+
delete toCreateObject.$collectionId;
|
|
419
|
+
delete toCreateObject.$createdAt;
|
|
420
|
+
delete toCreateObject.$updatedAt;
|
|
421
|
+
delete toCreateObject.$id;
|
|
422
|
+
delete toCreateObject.$permissions;
|
|
423
|
+
|
|
424
|
+
const result = await transferDocumentWithRetry(
|
|
425
|
+
db,
|
|
426
|
+
dbId,
|
|
427
|
+
collectionId,
|
|
428
|
+
doc.$id,
|
|
429
|
+
toCreateObject,
|
|
430
|
+
doc.$permissions || []
|
|
431
|
+
);
|
|
432
|
+
|
|
433
|
+
return { docId: doc.$id, success: result };
|
|
434
|
+
});
|
|
435
|
+
|
|
436
|
+
const results = await Promise.allSettled(batchPromises);
|
|
437
|
+
|
|
438
|
+
results.forEach((result, index) => {
|
|
439
|
+
if (result.status === 'fulfilled') {
|
|
440
|
+
if (result.value.success) {
|
|
441
|
+
successful++;
|
|
442
|
+
} else {
|
|
443
|
+
failed++;
|
|
444
|
+
}
|
|
445
|
+
} else {
|
|
446
|
+
MessageFormatter.error(`Batch promise rejected for document ${batch[index].$id}`, new Error(String(result.reason)), { prefix: "Transfer" });
|
|
447
|
+
failed++;
|
|
448
|
+
}
|
|
449
|
+
});
|
|
450
|
+
|
|
451
|
+
// Add delay between batches to avoid rate limiting
|
|
452
|
+
if (documentBatches.indexOf(batch) < documentBatches.length - 1) {
|
|
453
|
+
await delay(500);
|
|
454
|
+
}
|
|
455
|
+
}
|
|
456
|
+
|
|
457
|
+
return { successful, failed };
|
|
458
|
+
};
|
|
459
|
+
|
|
460
|
+
/**
|
|
461
|
+
* Enhanced batch document transfer with fault tolerance and bulk API support
|
|
462
|
+
*/
|
|
463
|
+
const transferDocumentBatchWithRetry = async (
|
|
464
|
+
db: Databases,
|
|
465
|
+
client: any,
|
|
466
|
+
dbId: string,
|
|
467
|
+
collectionId: string,
|
|
468
|
+
documents: any[],
|
|
469
|
+
batchSize: number = 10
|
|
470
|
+
): Promise<{ successful: number; failed: number }> => {
|
|
471
|
+
// Check if we can use bulk operations
|
|
472
|
+
if (supportsBulkOperations(client.config.endpoint)) {
|
|
473
|
+
MessageFormatter.info(`Using bulk upsert API for faster document transfer`, { prefix: "Transfer" });
|
|
474
|
+
|
|
475
|
+
// Try with Scale plan limit first (2500), then Pro (1000), then Free (100)
|
|
476
|
+
const batchSizes = [1000, 100]; // Start with Pro plan, fallback to Free
|
|
477
|
+
|
|
478
|
+
for (const maxBatchSize of batchSizes) {
|
|
479
|
+
try {
|
|
480
|
+
return await transferDocumentsBulkUpsert(client, dbId, collectionId, documents, maxBatchSize);
|
|
481
|
+
} catch (error: any) {
|
|
482
|
+
MessageFormatter.progress(`Bulk upsert with batch size ${maxBatchSize} failed, trying smaller size...`, { prefix: "Transfer" });
|
|
483
|
+
continue;
|
|
484
|
+
}
|
|
485
|
+
}
|
|
486
|
+
|
|
487
|
+
// If all bulk operations fail, fall back to individual transfers
|
|
488
|
+
MessageFormatter.progress(`All bulk operations failed, falling back to individual document transfers`, { prefix: "Transfer" });
|
|
489
|
+
}
|
|
490
|
+
|
|
491
|
+
// Fall back to individual document transfer
|
|
492
|
+
return await transferDocumentBatchWithRetryFallback(db, dbId, collectionId, documents, batchSize);
|
|
493
|
+
};
|
|
494
|
+
|
|
496
495
|
export const transferDocumentsBetweenDbsLocalToRemote = async (
|
|
497
496
|
localDb: Databases | DatabaseAdapter,
|
|
498
497
|
endpoint: string,
|
|
@@ -511,17 +510,17 @@ export const transferDocumentsBetweenDbsLocalToRemote = async (
|
|
|
511
510
|
let totalDocumentsProcessed = 0;
|
|
512
511
|
let totalSuccessful = 0;
|
|
513
512
|
let totalFailed = 0;
|
|
514
|
-
|
|
515
|
-
// Fetch documents in larger batches (1000 at a time)
|
|
516
|
-
let hasMoreDocuments = true;
|
|
517
|
-
let lastDocumentId: string | undefined;
|
|
518
|
-
|
|
519
|
-
while (hasMoreDocuments) {
|
|
520
|
-
const queries = [Query.limit(1000)]; // Fetch 1000 documents at a time
|
|
521
|
-
if (lastDocumentId) {
|
|
522
|
-
queries.push(Query.cursorAfter(lastDocumentId));
|
|
523
|
-
}
|
|
524
|
-
|
|
513
|
+
|
|
514
|
+
// Fetch documents in larger batches (1000 at a time)
|
|
515
|
+
let hasMoreDocuments = true;
|
|
516
|
+
let lastDocumentId: string | undefined;
|
|
517
|
+
|
|
518
|
+
while (hasMoreDocuments) {
|
|
519
|
+
const queries = [Query.limit(1000)]; // Fetch 1000 documents at a time
|
|
520
|
+
if (lastDocumentId) {
|
|
521
|
+
queries.push(Query.cursorAfter(lastDocumentId));
|
|
522
|
+
}
|
|
523
|
+
|
|
525
524
|
const fromCollDocs = await tryAwaitWithRetry(async () => {
|
|
526
525
|
if (isLegacyDatabases(localDb)) {
|
|
527
526
|
return localDb.listDocuments(fromDbId, fromCollId, queries);
|
|
@@ -531,14 +530,14 @@ export const transferDocumentsBetweenDbsLocalToRemote = async (
|
|
|
531
530
|
return { documents: rows } as any;
|
|
532
531
|
}
|
|
533
532
|
});
|
|
534
|
-
|
|
535
|
-
if (fromCollDocs.documents.length === 0) {
|
|
536
|
-
hasMoreDocuments = false;
|
|
537
|
-
break;
|
|
538
|
-
}
|
|
539
|
-
|
|
540
|
-
MessageFormatter.progress(`Fetched ${fromCollDocs.documents.length} documents, processing for transfer...`, { prefix: "Transfer" });
|
|
541
|
-
|
|
533
|
+
|
|
534
|
+
if (fromCollDocs.documents.length === 0) {
|
|
535
|
+
hasMoreDocuments = false;
|
|
536
|
+
break;
|
|
537
|
+
}
|
|
538
|
+
|
|
539
|
+
MessageFormatter.progress(`Fetched ${fromCollDocs.documents.length} documents, processing for transfer...`, { prefix: "Transfer" });
|
|
540
|
+
|
|
542
541
|
// Prefer remote adapter bulk upsert if available
|
|
543
542
|
const prepared = fromCollDocs.documents.map((doc: any) => {
|
|
544
543
|
const data: any = { ...doc };
|
|
@@ -560,31 +559,31 @@ export const transferDocumentsBetweenDbsLocalToRemote = async (
|
|
|
560
559
|
const res = await transferDocumentBatchWithRetry(remoteDb, client, toDbId, toCollId, fromCollDocs.documents);
|
|
561
560
|
successful = res.successful; failed = res.failed;
|
|
562
561
|
}
|
|
563
|
-
|
|
564
|
-
totalDocumentsProcessed += fromCollDocs.documents.length;
|
|
565
|
-
totalSuccessful += successful;
|
|
566
|
-
totalFailed += failed;
|
|
567
|
-
|
|
568
|
-
// Check if we have more documents to process
|
|
569
|
-
if (fromCollDocs.documents.length < 1000) {
|
|
570
|
-
hasMoreDocuments = false;
|
|
571
|
-
} else {
|
|
572
|
-
lastDocumentId = fromCollDocs.documents[fromCollDocs.documents.length - 1].$id;
|
|
573
|
-
}
|
|
574
|
-
|
|
575
|
-
MessageFormatter.debug(`Batch complete: ${successful} successful, ${failed} failed`, undefined, { prefix: "Transfer" });
|
|
576
|
-
}
|
|
577
|
-
|
|
578
|
-
if (totalDocumentsProcessed === 0) {
|
|
579
|
-
MessageFormatter.info(`No documents found in collection ${fromCollId}`, { prefix: "Transfer" });
|
|
580
|
-
return;
|
|
581
|
-
}
|
|
582
|
-
|
|
583
|
-
const message = `Total documents processed: ${totalDocumentsProcessed}, successful: ${totalSuccessful}, failed: ${totalFailed}`;
|
|
584
|
-
|
|
585
|
-
if (totalFailed > 0) {
|
|
586
|
-
MessageFormatter.warning(message, { prefix: "Transfer" });
|
|
587
|
-
} else {
|
|
588
|
-
MessageFormatter.success(message, { prefix: "Transfer" });
|
|
589
|
-
}
|
|
562
|
+
|
|
563
|
+
totalDocumentsProcessed += fromCollDocs.documents.length;
|
|
564
|
+
totalSuccessful += successful;
|
|
565
|
+
totalFailed += failed;
|
|
566
|
+
|
|
567
|
+
// Check if we have more documents to process
|
|
568
|
+
if (fromCollDocs.documents.length < 1000) {
|
|
569
|
+
hasMoreDocuments = false;
|
|
570
|
+
} else {
|
|
571
|
+
lastDocumentId = fromCollDocs.documents[fromCollDocs.documents.length - 1].$id;
|
|
572
|
+
}
|
|
573
|
+
|
|
574
|
+
MessageFormatter.debug(`Batch complete: ${successful} successful, ${failed} failed`, undefined, { prefix: "Transfer" });
|
|
575
|
+
}
|
|
576
|
+
|
|
577
|
+
if (totalDocumentsProcessed === 0) {
|
|
578
|
+
MessageFormatter.info(`No documents found in collection ${fromCollId}`, { prefix: "Transfer" });
|
|
579
|
+
return;
|
|
580
|
+
}
|
|
581
|
+
|
|
582
|
+
const message = `Total documents processed: ${totalDocumentsProcessed}, successful: ${totalSuccessful}, failed: ${totalFailed}`;
|
|
583
|
+
|
|
584
|
+
if (totalFailed > 0) {
|
|
585
|
+
MessageFormatter.warning(message, { prefix: "Transfer" });
|
|
586
|
+
} else {
|
|
587
|
+
MessageFormatter.success(message, { prefix: "Transfer" });
|
|
588
|
+
}
|
|
590
589
|
};
|