appwrite-utils-cli 1.11.0 → 1.12.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/{src/adapters/index.ts → dist/adapters/index.d.ts} +0 -1
- package/dist/adapters/index.js +10 -0
- package/dist/backups/operations/bucketBackup.d.ts +19 -0
- package/dist/backups/operations/bucketBackup.js +197 -0
- package/dist/backups/operations/collectionBackup.d.ts +30 -0
- package/dist/backups/operations/collectionBackup.js +201 -0
- package/dist/backups/operations/comprehensiveBackup.d.ts +25 -0
- package/dist/backups/operations/comprehensiveBackup.js +238 -0
- package/dist/backups/schemas/bucketManifest.d.ts +93 -0
- package/dist/backups/schemas/bucketManifest.js +33 -0
- package/dist/backups/schemas/comprehensiveManifest.d.ts +108 -0
- package/dist/backups/schemas/comprehensiveManifest.js +32 -0
- package/dist/backups/tracking/centralizedTracking.d.ts +34 -0
- package/dist/backups/tracking/centralizedTracking.js +274 -0
- package/dist/cli/commands/configCommands.d.ts +8 -0
- package/dist/cli/commands/configCommands.js +210 -0
- package/dist/cli/commands/databaseCommands.d.ts +14 -0
- package/dist/cli/commands/databaseCommands.js +696 -0
- package/dist/cli/commands/functionCommands.d.ts +7 -0
- package/dist/cli/commands/functionCommands.js +330 -0
- package/dist/cli/commands/importFileCommands.d.ts +7 -0
- package/dist/cli/commands/importFileCommands.js +674 -0
- package/dist/cli/commands/schemaCommands.d.ts +7 -0
- package/dist/cli/commands/schemaCommands.js +169 -0
- package/dist/cli/commands/storageCommands.d.ts +5 -0
- package/dist/cli/commands/storageCommands.js +142 -0
- package/dist/cli/commands/transferCommands.d.ts +5 -0
- package/dist/cli/commands/transferCommands.js +382 -0
- package/dist/collections/columns.d.ts +13 -0
- package/dist/collections/columns.js +1339 -0
- package/dist/collections/indexes.d.ts +12 -0
- package/dist/collections/indexes.js +215 -0
- package/dist/collections/methods.d.ts +19 -0
- package/dist/collections/methods.js +605 -0
- package/dist/collections/tableOperations.d.ts +87 -0
- package/dist/collections/tableOperations.js +466 -0
- package/dist/collections/transferOperations.d.ts +8 -0
- package/dist/collections/transferOperations.js +411 -0
- package/dist/collections/wipeOperations.d.ts +17 -0
- package/dist/collections/wipeOperations.js +306 -0
- package/dist/databases/methods.d.ts +6 -0
- package/dist/databases/methods.js +35 -0
- package/dist/databases/setup.d.ts +5 -0
- package/dist/databases/setup.js +45 -0
- package/dist/examples/yamlTerminologyExample.d.ts +42 -0
- package/dist/examples/yamlTerminologyExample.js +272 -0
- package/dist/functions/deployments.d.ts +4 -0
- package/dist/functions/deployments.js +146 -0
- package/dist/functions/fnConfigDiscovery.d.ts +3 -0
- package/dist/functions/fnConfigDiscovery.js +108 -0
- package/dist/functions/methods.d.ts +16 -0
- package/dist/functions/methods.js +174 -0
- package/dist/init.d.ts +2 -0
- package/dist/init.js +57 -0
- package/dist/interactiveCLI.d.ts +36 -0
- package/dist/interactiveCLI.js +952 -0
- package/dist/main.d.ts +2 -0
- package/dist/main.js +1125 -0
- package/dist/migrations/afterImportActions.d.ts +17 -0
- package/dist/migrations/afterImportActions.js +305 -0
- package/dist/migrations/appwriteToX.d.ts +211 -0
- package/dist/migrations/appwriteToX.js +493 -0
- package/dist/migrations/comprehensiveTransfer.d.ts +147 -0
- package/dist/migrations/comprehensiveTransfer.js +1315 -0
- package/dist/migrations/dataLoader.d.ts +755 -0
- package/dist/migrations/dataLoader.js +1272 -0
- package/dist/migrations/importController.d.ts +25 -0
- package/dist/migrations/importController.js +283 -0
- package/dist/migrations/importDataActions.d.ts +50 -0
- package/dist/migrations/importDataActions.js +230 -0
- package/dist/migrations/relationships.d.ts +29 -0
- package/dist/migrations/relationships.js +203 -0
- package/dist/migrations/services/DataTransformationService.d.ts +55 -0
- package/dist/migrations/services/DataTransformationService.js +158 -0
- package/dist/migrations/services/FileHandlerService.d.ts +75 -0
- package/dist/migrations/services/FileHandlerService.js +236 -0
- package/dist/migrations/services/ImportOrchestrator.d.ts +99 -0
- package/dist/migrations/services/ImportOrchestrator.js +493 -0
- package/dist/migrations/services/RateLimitManager.d.ts +138 -0
- package/dist/migrations/services/RateLimitManager.js +279 -0
- package/dist/migrations/services/RelationshipResolver.d.ts +120 -0
- package/dist/migrations/services/RelationshipResolver.js +332 -0
- package/dist/migrations/services/UserMappingService.d.ts +109 -0
- package/dist/migrations/services/UserMappingService.js +277 -0
- package/dist/migrations/services/ValidationService.d.ts +74 -0
- package/dist/migrations/services/ValidationService.js +260 -0
- package/dist/migrations/transfer.d.ts +30 -0
- package/dist/migrations/transfer.js +661 -0
- package/dist/migrations/yaml/YamlImportConfigLoader.d.ts +131 -0
- package/dist/migrations/yaml/YamlImportConfigLoader.js +383 -0
- package/dist/migrations/yaml/YamlImportIntegration.d.ts +93 -0
- package/dist/migrations/yaml/YamlImportIntegration.js +341 -0
- package/dist/migrations/yaml/generateImportSchemas.d.ts +30 -0
- package/dist/migrations/yaml/generateImportSchemas.js +1327 -0
- package/dist/schemas/authUser.d.ts +24 -0
- package/dist/schemas/authUser.js +17 -0
- package/dist/setup.d.ts +2 -0
- package/{src/setup.ts → dist/setup.js} +0 -3
- package/dist/setupCommands.d.ts +58 -0
- package/dist/setupCommands.js +489 -0
- package/dist/setupController.d.ts +9 -0
- package/dist/setupController.js +34 -0
- package/dist/shared/backupMetadataSchema.d.ts +94 -0
- package/dist/shared/backupMetadataSchema.js +38 -0
- package/dist/shared/backupTracking.d.ts +18 -0
- package/dist/shared/backupTracking.js +176 -0
- package/dist/shared/confirmationDialogs.d.ts +75 -0
- package/dist/shared/confirmationDialogs.js +236 -0
- package/dist/shared/migrationHelpers.d.ts +61 -0
- package/dist/shared/migrationHelpers.js +145 -0
- package/{src/shared/operationLogger.ts → dist/shared/operationLogger.d.ts} +1 -11
- package/dist/shared/operationLogger.js +12 -0
- package/dist/shared/operationQueue.d.ts +40 -0
- package/dist/shared/operationQueue.js +310 -0
- package/dist/shared/operationsTable.d.ts +26 -0
- package/dist/shared/operationsTable.js +287 -0
- package/dist/shared/operationsTableSchema.d.ts +48 -0
- package/dist/shared/operationsTableSchema.js +35 -0
- package/dist/shared/progressManager.d.ts +62 -0
- package/dist/shared/progressManager.js +215 -0
- package/dist/shared/relationshipExtractor.d.ts +56 -0
- package/dist/shared/relationshipExtractor.js +138 -0
- package/dist/shared/selectionDialogs.d.ts +220 -0
- package/dist/shared/selectionDialogs.js +588 -0
- package/dist/storage/backupCompression.d.ts +20 -0
- package/dist/storage/backupCompression.js +67 -0
- package/dist/storage/methods.d.ts +44 -0
- package/dist/storage/methods.js +475 -0
- package/dist/storage/schemas.d.ts +842 -0
- package/dist/storage/schemas.js +175 -0
- package/dist/tables/indexManager.d.ts +65 -0
- package/dist/tables/indexManager.js +294 -0
- package/{src/types.ts → dist/types.d.ts} +1 -6
- package/dist/types.js +3 -0
- package/dist/users/methods.d.ts +16 -0
- package/dist/users/methods.js +276 -0
- package/dist/utils/configMigration.d.ts +1 -0
- package/dist/utils/configMigration.js +261 -0
- package/dist/utils/index.js +2 -0
- package/dist/utils/loadConfigs.d.ts +50 -0
- package/dist/utils/loadConfigs.js +357 -0
- package/dist/utils/setupFiles.d.ts +4 -0
- package/dist/utils/setupFiles.js +1190 -0
- package/dist/utilsController.d.ts +114 -0
- package/dist/utilsController.js +898 -0
- package/package.json +6 -3
- package/CHANGELOG.md +0 -35
- package/CONFIG_TODO.md +0 -1189
- package/SELECTION_DIALOGS.md +0 -146
- package/SERVICE_IMPLEMENTATION_REPORT.md +0 -462
- package/scripts/copy-templates.ts +0 -23
- package/src/backups/operations/bucketBackup.ts +0 -277
- package/src/backups/operations/collectionBackup.ts +0 -310
- package/src/backups/operations/comprehensiveBackup.ts +0 -342
- package/src/backups/schemas/bucketManifest.ts +0 -78
- package/src/backups/schemas/comprehensiveManifest.ts +0 -76
- package/src/backups/tracking/centralizedTracking.ts +0 -352
- package/src/cli/commands/configCommands.ts +0 -265
- package/src/cli/commands/databaseCommands.ts +0 -931
- package/src/cli/commands/functionCommands.ts +0 -419
- package/src/cli/commands/importFileCommands.ts +0 -815
- package/src/cli/commands/schemaCommands.ts +0 -200
- package/src/cli/commands/storageCommands.ts +0 -151
- package/src/cli/commands/transferCommands.ts +0 -454
- package/src/collections/attributes.ts.backup +0 -1555
- package/src/collections/columns.ts +0 -2025
- package/src/collections/indexes.ts +0 -350
- package/src/collections/methods.ts +0 -714
- package/src/collections/tableOperations.ts +0 -542
- package/src/collections/transferOperations.ts +0 -589
- package/src/collections/wipeOperations.ts +0 -449
- package/src/databases/methods.ts +0 -49
- package/src/databases/setup.ts +0 -77
- package/src/examples/yamlTerminologyExample.ts +0 -346
- package/src/functions/deployments.ts +0 -221
- package/src/functions/fnConfigDiscovery.ts +0 -103
- package/src/functions/methods.ts +0 -284
- package/src/init.ts +0 -62
- package/src/interactiveCLI.ts +0 -1201
- package/src/main.ts +0 -1517
- package/src/migrations/afterImportActions.ts +0 -579
- package/src/migrations/appwriteToX.ts +0 -668
- package/src/migrations/comprehensiveTransfer.ts +0 -2285
- package/src/migrations/dataLoader.ts +0 -1729
- package/src/migrations/importController.ts +0 -440
- package/src/migrations/importDataActions.ts +0 -315
- package/src/migrations/relationships.ts +0 -333
- package/src/migrations/services/DataTransformationService.ts +0 -196
- package/src/migrations/services/FileHandlerService.ts +0 -311
- package/src/migrations/services/ImportOrchestrator.ts +0 -675
- package/src/migrations/services/RateLimitManager.ts +0 -363
- package/src/migrations/services/RelationshipResolver.ts +0 -461
- package/src/migrations/services/UserMappingService.ts +0 -345
- package/src/migrations/services/ValidationService.ts +0 -349
- package/src/migrations/transfer.ts +0 -1113
- package/src/migrations/yaml/YamlImportConfigLoader.ts +0 -439
- package/src/migrations/yaml/YamlImportIntegration.ts +0 -446
- package/src/migrations/yaml/generateImportSchemas.ts +0 -1354
- package/src/schemas/authUser.ts +0 -23
- package/src/setupCommands.ts +0 -602
- package/src/setupController.ts +0 -43
- package/src/shared/backupMetadataSchema.ts +0 -93
- package/src/shared/backupTracking.ts +0 -211
- package/src/shared/confirmationDialogs.ts +0 -327
- package/src/shared/migrationHelpers.ts +0 -232
- package/src/shared/operationQueue.ts +0 -376
- package/src/shared/operationsTable.ts +0 -338
- package/src/shared/operationsTableSchema.ts +0 -60
- package/src/shared/progressManager.ts +0 -278
- package/src/shared/relationshipExtractor.ts +0 -214
- package/src/shared/selectionDialogs.ts +0 -802
- package/src/storage/backupCompression.ts +0 -88
- package/src/storage/methods.ts +0 -711
- package/src/storage/schemas.ts +0 -205
- package/src/tables/indexManager.ts +0 -409
- package/src/types/node-appwrite-tablesdb.d.ts +0 -44
- package/src/users/methods.ts +0 -358
- package/src/utils/configMigration.ts +0 -348
- package/src/utils/loadConfigs.ts +0 -457
- package/src/utils/setupFiles.ts +0 -1236
- package/src/utilsController.ts +0 -1263
- package/tests/README.md +0 -497
- package/tests/adapters/AdapterFactory.test.ts +0 -277
- package/tests/integration/syncOperations.test.ts +0 -463
- package/tests/jest.config.js +0 -25
- package/tests/migration/configMigration.test.ts +0 -546
- package/tests/setup.ts +0 -62
- package/tests/testUtils.ts +0 -340
- package/tests/utils/loadConfigs.test.ts +0 -350
- package/tests/validation/configValidation.test.ts +0 -412
- package/tsconfig.json +0 -44
- /package/{src → dist}/functions/templates/count-docs-in-collection/README.md +0 -0
- /package/{src → dist}/functions/templates/count-docs-in-collection/src/main.ts +0 -0
- /package/{src → dist}/functions/templates/count-docs-in-collection/src/request.ts +0 -0
- /package/{src → dist}/functions/templates/hono-typescript/README.md +0 -0
- /package/{src → dist}/functions/templates/hono-typescript/src/adapters/request.ts +0 -0
- /package/{src → dist}/functions/templates/hono-typescript/src/adapters/response.ts +0 -0
- /package/{src → dist}/functions/templates/hono-typescript/src/app.ts +0 -0
- /package/{src → dist}/functions/templates/hono-typescript/src/context.ts +0 -0
- /package/{src → dist}/functions/templates/hono-typescript/src/main.ts +0 -0
- /package/{src → dist}/functions/templates/hono-typescript/src/middleware/appwrite.ts +0 -0
- /package/{src → dist}/functions/templates/typescript-node/README.md +0 -0
- /package/{src → dist}/functions/templates/typescript-node/src/context.ts +0 -0
- /package/{src → dist}/functions/templates/typescript-node/src/main.ts +0 -0
- /package/{src → dist}/functions/templates/uv/README.md +0 -0
- /package/{src → dist}/functions/templates/uv/pyproject.toml +0 -0
- /package/{src → dist}/functions/templates/uv/src/__init__.py +0 -0
- /package/{src → dist}/functions/templates/uv/src/context.py +0 -0
- /package/{src → dist}/functions/templates/uv/src/main.py +0 -0
- /package/{src/utils/index.ts → dist/utils/index.d.ts} +0 -0
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
import { Client, Databases, Storage, type Models } from "node-appwrite";
|
|
2
|
+
import { type AppwriteConfig, type AppwriteFunction, type Specification } from "appwrite-utils";
|
|
3
|
+
import { type AfterImportActions, type ConverterFunctions, type ValidationRules } from "appwrite-utils";
|
|
4
|
+
import { type TransferOptions } from "./migrations/transfer.js";
|
|
5
|
+
import type { DatabaseAdapter } from 'appwrite-utils-helpers';
|
|
6
|
+
import { type ValidationResult } from "appwrite-utils-helpers";
|
|
7
|
+
import type { DatabaseSelection, BucketSelection } from "./shared/selectionDialogs.js";
|
|
8
|
+
export interface SetupOptions {
|
|
9
|
+
databases?: Models.Database[];
|
|
10
|
+
collections?: string[];
|
|
11
|
+
doBackup?: boolean;
|
|
12
|
+
wipeDatabase?: boolean;
|
|
13
|
+
wipeCollections?: boolean;
|
|
14
|
+
wipeDocumentStorage?: boolean;
|
|
15
|
+
wipeUsers?: boolean;
|
|
16
|
+
transferUsers?: boolean;
|
|
17
|
+
generateSchemas?: boolean;
|
|
18
|
+
importData?: boolean;
|
|
19
|
+
checkDuplicates?: boolean;
|
|
20
|
+
shouldWriteFile?: boolean;
|
|
21
|
+
}
|
|
22
|
+
export interface ControllerInitOptions {
|
|
23
|
+
validate?: boolean;
|
|
24
|
+
strictMode?: boolean;
|
|
25
|
+
useSession?: boolean;
|
|
26
|
+
sessionCookie?: string;
|
|
27
|
+
preferJson?: boolean;
|
|
28
|
+
overrides?: {
|
|
29
|
+
appwriteEndpoint?: string;
|
|
30
|
+
appwriteProject?: string;
|
|
31
|
+
appwriteKey?: string;
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
export declare class UtilsController {
|
|
35
|
+
private static instance;
|
|
36
|
+
private isInitialized;
|
|
37
|
+
/**
|
|
38
|
+
* Get the UtilsController singleton instance
|
|
39
|
+
*/
|
|
40
|
+
static getInstance(currentUserDir: string, directConfig?: {
|
|
41
|
+
appwriteEndpoint?: string;
|
|
42
|
+
appwriteProject?: string;
|
|
43
|
+
appwriteKey?: string;
|
|
44
|
+
}): UtilsController;
|
|
45
|
+
/**
|
|
46
|
+
* Clear the singleton instance (useful for testing)
|
|
47
|
+
*/
|
|
48
|
+
static clearInstance(): void;
|
|
49
|
+
private appwriteFolderPath?;
|
|
50
|
+
private appwriteConfigPath?;
|
|
51
|
+
private currentUserDir;
|
|
52
|
+
config?: AppwriteConfig;
|
|
53
|
+
appwriteServer?: Client;
|
|
54
|
+
database?: Databases;
|
|
55
|
+
storage?: Storage;
|
|
56
|
+
adapter?: DatabaseAdapter;
|
|
57
|
+
converterDefinitions: ConverterFunctions;
|
|
58
|
+
validityRuleDefinitions: ValidationRules;
|
|
59
|
+
afterImportActionsDefinitions: AfterImportActions;
|
|
60
|
+
constructor(currentUserDir: string, directConfig?: {
|
|
61
|
+
appwriteEndpoint?: string;
|
|
62
|
+
appwriteProject?: string;
|
|
63
|
+
appwriteKey?: string;
|
|
64
|
+
});
|
|
65
|
+
init(options?: ControllerInitOptions): Promise<void>;
|
|
66
|
+
reloadConfig(): Promise<void>;
|
|
67
|
+
ensureDatabaseConfigBucketsExist(databases?: Models.Database[]): Promise<void>;
|
|
68
|
+
pushGlobalBuckets(selectedBucketIds?: string[]): Promise<void>;
|
|
69
|
+
ensureDatabasesExist(databases?: Models.Database[]): Promise<void>;
|
|
70
|
+
ensureCollectionsExist(database: Models.Database, collections?: Models.Collection[]): Promise<void>;
|
|
71
|
+
getDatabasesByIds(ids: string[]): Promise<Models.Database[] | undefined>;
|
|
72
|
+
fetchAllBuckets(): Promise<{
|
|
73
|
+
buckets: Models.Bucket[];
|
|
74
|
+
}>;
|
|
75
|
+
wipeOtherDatabases(databasesToKeep: Models.Database[]): Promise<void>;
|
|
76
|
+
wipeUsers(): Promise<void>;
|
|
77
|
+
backupDatabase(database: Models.Database, format?: 'json' | 'zip'): Promise<void>;
|
|
78
|
+
listAllFunctions(): Promise<Models.Function[]>;
|
|
79
|
+
findFunctionDirectories(): Promise<Map<any, any>>;
|
|
80
|
+
deployFunction(functionName: string, functionPath?: string, functionConfig?: AppwriteFunction): Promise<void>;
|
|
81
|
+
syncFunctions(): Promise<void>;
|
|
82
|
+
wipeDatabase(database: Models.Database, wipeBucket?: boolean): Promise<void>;
|
|
83
|
+
wipeBucketFromDatabase(database: Models.Database): Promise<void>;
|
|
84
|
+
wipeCollection(database: Models.Database, collection: Models.Collection): Promise<void>;
|
|
85
|
+
wipeDocumentStorage(bucketId: string): Promise<void>;
|
|
86
|
+
createOrUpdateCollectionsForDatabases(databases: Models.Database[], collections?: Models.Collection[]): Promise<void>;
|
|
87
|
+
createOrUpdateCollections(database: Models.Database, deletedCollections?: {
|
|
88
|
+
collectionId: string;
|
|
89
|
+
collectionName: string;
|
|
90
|
+
}[], collections?: Models.Collection[]): Promise<void>;
|
|
91
|
+
generateSchemas(): Promise<void>;
|
|
92
|
+
importData(options?: SetupOptions): Promise<void>;
|
|
93
|
+
synchronizeConfigurations(databases?: Models.Database[], config?: AppwriteConfig, databaseSelections?: DatabaseSelection[], bucketSelections?: BucketSelection[]): Promise<void>;
|
|
94
|
+
selectivePull(databaseSelections: DatabaseSelection[], bucketSelections: BucketSelection[]): Promise<void>;
|
|
95
|
+
selectivePush(databaseSelections: DatabaseSelection[], bucketSelections: BucketSelection[]): Promise<void>;
|
|
96
|
+
syncDb(databases?: Models.Database[], collections?: Models.Collection[]): Promise<void>;
|
|
97
|
+
getAppwriteFolderPath(): string | undefined;
|
|
98
|
+
transferData(options: TransferOptions): Promise<void>;
|
|
99
|
+
updateFunctionSpecifications(functionId: string, specification: Specification): Promise<void>;
|
|
100
|
+
/**
|
|
101
|
+
* Validates the current configuration for collections/tables conflicts
|
|
102
|
+
*/
|
|
103
|
+
validateConfiguration(strictMode?: boolean): Promise<ValidationResult>;
|
|
104
|
+
/**
|
|
105
|
+
* Get current session information for debugging/logging purposes
|
|
106
|
+
* Delegates to ConfigManager for session info
|
|
107
|
+
*/
|
|
108
|
+
getSessionInfo(): Promise<{
|
|
109
|
+
hasSession: boolean;
|
|
110
|
+
authMethod?: string;
|
|
111
|
+
email?: string;
|
|
112
|
+
expiresAt?: string;
|
|
113
|
+
}>;
|
|
114
|
+
}
|