dbgate-types 6.2.0 → 6.3.0

package/dialect.d.ts

@@ -13,8 +13,11 @@ export interface SqlDialect {
   fallbackDataType?: string;
   explicitDropConstraint?: boolean;
   anonymousPrimaryKey?: boolean;
+  anonymousForeignKey?: boolean;
   defaultSchemaName?: string;
   enableConstraintsPerTable?: boolean;
+  enableAllForeignKeys?: boolean;
+  enableForeignKeyChecks?: boolean;
   requireStandaloneSelectForScopeIdentity?: boolean;
   allowMultipleValuesInsert?: boolean;
 
@@ -63,6 +66,7 @@ export interface SqlDialect {
   requireFromDual?: boolean;
   userDatabaseNamePrefix?: string; // c## in Oracle
   upperCaseAllDbObjectNames?: boolean;
+  defaultValueBeforeNullability?: boolean;
 
   predefinedDataTypes: string[];
 

package/dumper.d.ts

@@ -24,4 +24,5 @@ export interface SqlDumper extends AlterProcessor {
   truncateTable(table: NamedObjectInfo);
   beginTransaction();
   commitTransaction();
+  rollbackTransaction();
 }

package/engines.d.ts

@@ -40,6 +40,8 @@ export interface WriteTableOptions {
   truncate?: boolean;
   createIfNotExists?: boolean;
   commitAfterInsert?: boolean;
+  targetTableStructure?: TableInfo;
+  progressName?: string;
 }
 
 export interface EngineAuthType {
@@ -143,6 +145,31 @@ export interface DatabaseHandle<TClient = any> {
   treeKeySeparator?: string;
 }
 
+export type StreamResult = stream.Readable | (stream.Readable | stream.Writable)[];
+
+export interface CommandLineDefinition {
+  command: string;
+  args: string[];
+  env?: { [key: string]: string };
+  stdinFilePath?: string;
+}
+
+interface BackupRestoreSettingsBase {
+  database: string;
+  options?: { [key: string]: string };
+  argsFormat: 'shell' | 'spawn';
+}
+
+export interface BackupDatabaseSettings extends BackupRestoreSettingsBase {
+  outputFile: string;
+  selectedTables?: { pureName: string; schemaName?: string }[];
+  skippedTables?: { pureName: string; schemaName?: string }[];
+}
+
+export interface RestoreDatabaseSettings extends BackupRestoreSettingsBase {
+  inputFile: string;
+}
+
 export interface EngineDriver<TClient = any> extends FilterBehaviourProvider {
   engine: string;
   title: string;
@@ -153,7 +180,8 @@ export interface EngineDriver<TClient = any> extends FilterBehaviourProvider {
   supportedKeyTypes: SupportedDbKeyType[];
   dataEditorTypesBehaviour: DataEditorTypesBehaviour;
   supportsDatabaseUrl?: boolean;
-  supportsDatabaseDump?: boolean;
+  supportsDatabaseBackup?: boolean;
+  supportsDatabaseRestore?: boolean;
   supportsServerSummary?: boolean;
   supportsDatabaseProfiler?: boolean;
   requiresDefaultSortCriteria?: boolean;
@@ -161,8 +189,10 @@ export interface EngineDriver<TClient = any> extends FilterBehaviourProvider {
   profilerTimestampFunction?: string;
   profilerChartAggregateFunction?: string;
   profilerChartMeasures?: { label: string; field: string }[];
-  isElectronOnly?: boolean;
+  // isElectronOnly?: boolean;
   supportsTransactions?: boolean;
+  implicitTransactions?: boolean; // transaction is started with first SQL command, no BEGIN TRANSACTION is needed
+  premiumOnly?: boolean;
 
   collectionSingularLabel?: string;
   collectionPluralLabel?: string;
@@ -181,6 +211,7 @@ export interface EngineDriver<TClient = any> extends FilterBehaviourProvider {
   beforeConnectionSave?: (values: any) => any;
   databaseUrlPlaceholder?: string;
   defaultAuthTypeName?: string;
+  authTypeFirst?: boolean;
   defaultLocalDataCenter?: string;
   defaultSocketPath?: string;
   authTypeLabel?: string;
@@ -189,15 +220,11 @@ export interface EngineDriver<TClient = any> extends FilterBehaviourProvider {
   close(dbhan: DatabaseHandle<TClient>): Promise<any>;
   query(dbhan: DatabaseHandle<TClient>, sql: string, options?: QueryOptions): Promise<QueryResult>;
   stream(dbhan: DatabaseHandle<TClient>, sql: string, options: StreamOptions);
-  readQuery(dbhan: DatabaseHandle<TClient>, sql: string, structure?: TableInfo): Promise<stream.Readable>;
-  readJsonQuery(dbhan: DatabaseHandle<TClient>, query: any, structure?: TableInfo): Promise<stream.Readable>;
+  readQuery(dbhan: DatabaseHandle<TClient>, sql: string, structure?: TableInfo): Promise<StreamResult>;
+  readJsonQuery(dbhan: DatabaseHandle<TClient>, query: any, structure?: TableInfo): Promise<StreamResult>;
   // eg. PostgreSQL COPY FROM stdin
-  writeQueryFromStream(dbhan: DatabaseHandle<TClient>, sql: string): Promise<stream.Writable>;
-  writeTable(
-    dbhan: DatabaseHandle<TClient>,
-    name: NamedObjectInfo,
-    options: WriteTableOptions
-  ): Promise<stream.Writable>;
+  writeQueryFromStream(dbhan: DatabaseHandle<TClient>, sql: string): Promise<StreamResult>;
+  writeTable(dbhan: DatabaseHandle<TClient>, name: NamedObjectInfo, options: WriteTableOptions): Promise<StreamResult>;
   analyseSingleObject(
     dbhan: DatabaseHandle<TClient>,
     name: NamedObjectInfo,
@@ -257,7 +284,27 @@ export interface EngineDriver<TClient = any> extends FilterBehaviourProvider {
   ): any[];
   // adapts table info from different source (import, other database) to be suitable for this database
   adaptTableInfo(table: TableInfo): TableInfo;
+  // simple data type adapter
+  adaptDataType(dataType: string): string;
   listSchemas(dbhan: DatabaseHandle<TClient>): SchemaInfo[];
+  backupDatabaseCommand(
+    connection: any,
+    settings: BackupDatabaseSettings,
+    externalTools: { [tool: string]: string }
+  ): CommandLineDefinition;
+  restoreDatabaseCommand(
+    connection: any,
+    settings: RestoreDatabaseSettings,
+    externalTools: { [tool: string]: string }
+  ): CommandLineDefinition;
+  transformNativeCommandMessage(
+    message: {
+      message: string;
+      severity: 'info' | 'error';
+    },
+    command: 'backup' | 'restore'
+  ): { message: string; severity: 'info' | 'error' | 'debug' } | null;
+  getNativeOperationFormArgs(operation: 'backup' | 'restore'): any[];
 
   analyserClass?: any;
   dumperClass?: any;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "6.2.0",
+  "version": "6.3.0",
   "name": "dbgate-types",
   "homepage": "https://dbgate.org/",
   "repository": {

package/test-engines.d.ts

@@ -39,6 +39,7 @@ export type TestEngineInfo = {
   skipNonPkRename?: boolean;
   skipPkDrop?: boolean;
   skipOrderBy?: boolean;
+  skipImportModel?: boolean;
 
   forceSortResults?: boolean;
   forceSortStructureColumns?: boolean;