@sqlanvil/core 1.4.1 → 1.6.0

package/README.md

@@ -1,8 +1,8 @@
 # SQLAnvil
 
-**SQL workflow tool for BigQuery, Postgres, and Supabase.**
+**SQL workflow tool for BigQuery, Postgres, Supabase, and MySQL/MariaDB.**
 
-SQLAnvil is an open-source fork of [Dataform OSS](https://github.com/dataform-co/dataform) (Apache 2.0), extended with first-class PostgreSQL and Supabase support. Define your data transformations in SQLX, have SQLAnvil compile them to idiomatic SQL, and run them against your warehouse.
+SQLAnvil is an open-source fork of [Dataform OSS](https://github.com/dataform-co/dataform) (Apache 2.0), extended with first-class PostgreSQL, Supabase, and MySQL/MariaDB support. Define your data transformations in SQLX, have SQLAnvil compile them to idiomatic SQL, and run them against your warehouse.
 
 > **SQLAnvil is not affiliated with or endorsed by Google.** The Dataform name and related marks are trademarks of Google LLC. See [NOTICE](NOTICE) for attribution.
 
@@ -13,6 +13,7 @@ SQLAnvil is an open-source fork of [Dataform OSS](https://github.com/dataform-co
 - **BigQuery** — full support: partitioning, clustering, labels, materialized views, `MERGE`-based incremental upserts
 - **PostgreSQL** — idiomatic DDL: native partitioning, `INSERT ... ON CONFLICT` upserts, btree/gin/gist/brin indexes, tablespaces, fillfactor
 - **Supabase** — extends Postgres with RLS policies, Realtime publications, pgvector indexes, and Supabase Wrappers _(coming soon)_
+- **MySQL / MariaDB** — portable MySQL DDL: CTAS tables, `CREATE OR REPLACE VIEW`, `ON DUPLICATE KEY UPDATE` incremental upserts (one adapter, validated against both engines)
 - **SQLX + YAML + JS** — three authoring modes: SQL with config blocks, `actions.yaml` bulk definitions, or the JavaScript API
 
 ---

package/bundle.d.ts

@@ -1375,6 +1375,9 @@ namespace sqlanvil {
 
             /** TableConfig supabase */
             supabase?: (sqlanvil.ISupabaseOptions|null);
+
+            /** TableConfig mysql */
+            mysql?: (sqlanvil.IMysqlOptions|null);
         }
 
         /** Represents a TableConfig. */
@@ -1461,6 +1464,9 @@ namespace sqlanvil {
             /** TableConfig supabase. */
             public supabase?: (sqlanvil.ISupabaseOptions|null);
 
+            /** TableConfig mysql. */
+            public mysql?: (sqlanvil.IMysqlOptions|null);
+
             /**
              * Creates a new TableConfig instance using the specified properties.
              * @param [properties] Properties to set
@@ -1962,6 +1968,9 @@ namespace sqlanvil {
 
             /** IncrementalTableConfig supabase */
             supabase?: (sqlanvil.ISupabaseOptions|null);
+
+            /** IncrementalTableConfig mysql */
+            mysql?: (sqlanvil.IMysqlOptions|null);
         }
 
         /** Represents an IncrementalTableConfig. */
@@ -2060,6 +2069,9 @@ namespace sqlanvil {
             /** IncrementalTableConfig supabase. */
             public supabase?: (sqlanvil.ISupabaseOptions|null);
 
+            /** IncrementalTableConfig mysql. */
+            public mysql?: (sqlanvil.IMysqlOptions|null);
+
             /**
              * Creates a new IncrementalTableConfig instance using the specified properties.
              * @param [properties] Properties to set
@@ -4395,6 +4407,233 @@ namespace sqlanvil {
         }
     }
 
+    /** Properties of a MysqlOptions. */
+    interface IMysqlOptions {
+
+        /** MysqlOptions engine */
+        engine?: (string|null);
+
+        /** MysqlOptions charset */
+        charset?: (string|null);
+
+        /** MysqlOptions collation */
+        collation?: (string|null);
+
+        /** MysqlOptions indexes */
+        indexes?: (sqlanvil.MysqlOptions.IIndex[]|null);
+    }
+
+    /** Represents a MysqlOptions. */
+    class MysqlOptions implements IMysqlOptions {
+
+        /**
+         * Constructs a new MysqlOptions.
+         * @param [properties] Properties to set
+         */
+        constructor(properties?: sqlanvil.IMysqlOptions);
+
+        /** MysqlOptions engine. */
+        public engine: string;
+
+        /** MysqlOptions charset. */
+        public charset: string;
+
+        /** MysqlOptions collation. */
+        public collation: string;
+
+        /** MysqlOptions indexes. */
+        public indexes: sqlanvil.MysqlOptions.IIndex[];
+
+        /**
+         * Creates a new MysqlOptions instance using the specified properties.
+         * @param [properties] Properties to set
+         * @returns MysqlOptions instance
+         */
+        public static create(properties?: sqlanvil.IMysqlOptions): sqlanvil.MysqlOptions;
+
+        /**
+         * Encodes the specified MysqlOptions message. Does not implicitly {@link sqlanvil.MysqlOptions.verify|verify} messages.
+         * @param message MysqlOptions message or plain object to encode
+         * @param [writer] Writer to encode to
+         * @returns Writer
+         */
+        public static encode(message: sqlanvil.IMysqlOptions, writer?: $protobuf.Writer): $protobuf.Writer;
+
+        /**
+         * Encodes the specified MysqlOptions message, length delimited. Does not implicitly {@link sqlanvil.MysqlOptions.verify|verify} messages.
+         * @param message MysqlOptions message or plain object to encode
+         * @param [writer] Writer to encode to
+         * @returns Writer
+         */
+        public static encodeDelimited(message: sqlanvil.IMysqlOptions, writer?: $protobuf.Writer): $protobuf.Writer;
+
+        /**
+         * Decodes a MysqlOptions message from the specified reader or buffer.
+         * @param reader Reader or buffer to decode from
+         * @param [length] Message length if known beforehand
+         * @returns MysqlOptions
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): sqlanvil.MysqlOptions;
+
+        /**
+         * Decodes a MysqlOptions message from the specified reader or buffer, length delimited.
+         * @param reader Reader or buffer to decode from
+         * @returns MysqlOptions
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): sqlanvil.MysqlOptions;
+
+        /**
+         * Verifies a MysqlOptions message.
+         * @param message Plain object to verify
+         * @returns `null` if valid, otherwise the reason why it is not
+         */
+        public static verify(message: { [k: string]: any }): (string|null);
+
+        /**
+         * Creates a MysqlOptions message from a plain object. Also converts values to their respective internal types.
+         * @param object Plain object
+         * @returns MysqlOptions
+         */
+        public static fromObject(object: { [k: string]: any }): sqlanvil.MysqlOptions;
+
+        /**
+         * Creates a plain object from a MysqlOptions message. Also converts values to other types if specified.
+         * @param message MysqlOptions
+         * @param [options] Conversion options
+         * @returns Plain object
+         */
+        public static toObject(message: sqlanvil.MysqlOptions, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+        /**
+         * Converts this MysqlOptions to JSON.
+         * @returns JSON object
+         */
+        public toJSON(): { [k: string]: any };
+
+        /**
+         * Gets the default type url for MysqlOptions
+         * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+         * @returns The default type url
+         */
+        public static getTypeUrl(typeUrlPrefix?: string): string;
+    }
+
+    namespace MysqlOptions {
+
+        /** Properties of an Index. */
+        interface IIndex {
+
+            /** Index name */
+            name?: (string|null);
+
+            /** Index columns */
+            columns?: (string[]|null);
+
+            /** Index unique */
+            unique?: (boolean|null);
+        }
+
+        /** Represents an Index. */
+        class Index implements IIndex {
+
+            /**
+             * Constructs a new Index.
+             * @param [properties] Properties to set
+             */
+            constructor(properties?: sqlanvil.MysqlOptions.IIndex);
+
+            /** Index name. */
+            public name: string;
+
+            /** Index columns. */
+            public columns: string[];
+
+            /** Index unique. */
+            public unique: boolean;
+
+            /**
+             * Creates a new Index instance using the specified properties.
+             * @param [properties] Properties to set
+             * @returns Index instance
+             */
+            public static create(properties?: sqlanvil.MysqlOptions.IIndex): sqlanvil.MysqlOptions.Index;
+
+            /**
+             * Encodes the specified Index message. Does not implicitly {@link sqlanvil.MysqlOptions.Index.verify|verify} messages.
+             * @param message Index message or plain object to encode
+             * @param [writer] Writer to encode to
+             * @returns Writer
+             */
+            public static encode(message: sqlanvil.MysqlOptions.IIndex, writer?: $protobuf.Writer): $protobuf.Writer;
+
+            /**
+             * Encodes the specified Index message, length delimited. Does not implicitly {@link sqlanvil.MysqlOptions.Index.verify|verify} messages.
+             * @param message Index message or plain object to encode
+             * @param [writer] Writer to encode to
+             * @returns Writer
+             */
+            public static encodeDelimited(message: sqlanvil.MysqlOptions.IIndex, writer?: $protobuf.Writer): $protobuf.Writer;
+
+            /**
+             * Decodes an Index message from the specified reader or buffer.
+             * @param reader Reader or buffer to decode from
+             * @param [length] Message length if known beforehand
+             * @returns Index
+             * @throws {Error} If the payload is not a reader or valid buffer
+             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+             */
+            public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): sqlanvil.MysqlOptions.Index;
+
+            /**
+             * Decodes an Index message from the specified reader or buffer, length delimited.
+             * @param reader Reader or buffer to decode from
+             * @returns Index
+             * @throws {Error} If the payload is not a reader or valid buffer
+             * @throws {$protobuf.util.ProtocolError} If required fields are missing
+             */
+            public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): sqlanvil.MysqlOptions.Index;
+
+            /**
+             * Verifies an Index message.
+             * @param message Plain object to verify
+             * @returns `null` if valid, otherwise the reason why it is not
+             */
+            public static verify(message: { [k: string]: any }): (string|null);
+
+            /**
+             * Creates an Index message from a plain object. Also converts values to their respective internal types.
+             * @param object Plain object
+             * @returns Index
+             */
+            public static fromObject(object: { [k: string]: any }): sqlanvil.MysqlOptions.Index;
+
+            /**
+             * Creates a plain object from an Index message. Also converts values to other types if specified.
+             * @param message Index
+             * @param [options] Conversion options
+             * @returns Plain object
+             */
+            public static toObject(message: sqlanvil.MysqlOptions.Index, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+            /**
+             * Converts this Index to JSON.
+             * @returns JSON object
+             */
+            public toJSON(): { [k: string]: any };
+
+            /**
+             * Gets the default type url for Index
+             * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+             * @returns The default type url
+             */
+            public static getTypeUrl(typeUrlPrefix?: string): string;
+        }
+    }
+
     /** Properties of a SupabaseOptions. */
     interface ISupabaseOptions {
 
@@ -5000,6 +5239,133 @@ namespace sqlanvil {
         public static getTypeUrl(typeUrlPrefix?: string): string;
     }
 
+    /** Properties of a MysqlConnection. */
+    interface IMysqlConnection {
+
+        /** MysqlConnection host */
+        host?: (string|null);
+
+        /** MysqlConnection port */
+        port?: (number|null);
+
+        /** MysqlConnection database */
+        database?: (string|null);
+
+        /** MysqlConnection user */
+        user?: (string|null);
+
+        /** MysqlConnection password */
+        password?: (string|null);
+
+        /** MysqlConnection sslMode */
+        sslMode?: (string|null);
+    }
+
+    /** Represents a MysqlConnection. */
+    class MysqlConnection implements IMysqlConnection {
+
+        /**
+         * Constructs a new MysqlConnection.
+         * @param [properties] Properties to set
+         */
+        constructor(properties?: sqlanvil.IMysqlConnection);
+
+        /** MysqlConnection host. */
+        public host: string;
+
+        /** MysqlConnection port. */
+        public port: number;
+
+        /** MysqlConnection database. */
+        public database: string;
+
+        /** MysqlConnection user. */
+        public user: string;
+
+        /** MysqlConnection password. */
+        public password: string;
+
+        /** MysqlConnection sslMode. */
+        public sslMode: string;
+
+        /**
+         * Creates a new MysqlConnection instance using the specified properties.
+         * @param [properties] Properties to set
+         * @returns MysqlConnection instance
+         */
+        public static create(properties?: sqlanvil.IMysqlConnection): sqlanvil.MysqlConnection;
+
+        /**
+         * Encodes the specified MysqlConnection message. Does not implicitly {@link sqlanvil.MysqlConnection.verify|verify} messages.
+         * @param message MysqlConnection message or plain object to encode
+         * @param [writer] Writer to encode to
+         * @returns Writer
+         */
+        public static encode(message: sqlanvil.IMysqlConnection, writer?: $protobuf.Writer): $protobuf.Writer;
+
+        /**
+         * Encodes the specified MysqlConnection message, length delimited. Does not implicitly {@link sqlanvil.MysqlConnection.verify|verify} messages.
+         * @param message MysqlConnection message or plain object to encode
+         * @param [writer] Writer to encode to
+         * @returns Writer
+         */
+        public static encodeDelimited(message: sqlanvil.IMysqlConnection, writer?: $protobuf.Writer): $protobuf.Writer;
+
+        /**
+         * Decodes a MysqlConnection message from the specified reader or buffer.
+         * @param reader Reader or buffer to decode from
+         * @param [length] Message length if known beforehand
+         * @returns MysqlConnection
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): sqlanvil.MysqlConnection;
+
+        /**
+         * Decodes a MysqlConnection message from the specified reader or buffer, length delimited.
+         * @param reader Reader or buffer to decode from
+         * @returns MysqlConnection
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): sqlanvil.MysqlConnection;
+
+        /**
+         * Verifies a MysqlConnection message.
+         * @param message Plain object to verify
+         * @returns `null` if valid, otherwise the reason why it is not
+         */
+        public static verify(message: { [k: string]: any }): (string|null);
+
+        /**
+         * Creates a MysqlConnection message from a plain object. Also converts values to their respective internal types.
+         * @param object Plain object
+         * @returns MysqlConnection
+         */
+        public static fromObject(object: { [k: string]: any }): sqlanvil.MysqlConnection;
+
+        /**
+         * Creates a plain object from a MysqlConnection message. Also converts values to other types if specified.
+         * @param message MysqlConnection
+         * @param [options] Conversion options
+         * @returns Plain object
+         */
+        public static toObject(message: sqlanvil.MysqlConnection, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+        /**
+         * Converts this MysqlConnection to JSON.
+         * @returns JSON object
+         */
+        public toJSON(): { [k: string]: any };
+
+        /**
+         * Gets the default type url for MysqlConnection
+         * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+         * @returns The default type url
+         */
+        public static getTypeUrl(typeUrlPrefix?: string): string;
+    }
+
     /** Properties of a WarehouseConfig. */
     interface IWarehouseConfig {
 
@@ -5011,6 +5377,9 @@ namespace sqlanvil {
 
         /** WarehouseConfig supabase */
         supabase?: (sqlanvil.ISupabaseConnection|null);
+
+        /** WarehouseConfig mysql */
+        mysql?: (sqlanvil.IMysqlConnection|null);
     }
 
     /** Represents a WarehouseConfig. */
@@ -5031,8 +5400,11 @@ namespace sqlanvil {
         /** WarehouseConfig supabase. */
         public supabase?: (sqlanvil.ISupabaseConnection|null);
 
+        /** WarehouseConfig mysql. */
+        public mysql?: (sqlanvil.IMysqlConnection|null);
+
         /** WarehouseConfig connection. */
-        public connection?: ("bigquery"|"postgres"|"supabase");
+        public connection?: ("bigquery"|"postgres"|"supabase"|"mysql");
 
         /**
          * Creates a new WarehouseConfig instance using the specified properties.
@@ -6499,6 +6871,9 @@ namespace sqlanvil {
         /** Table supabase */
         supabase?: (sqlanvil.ISupabaseOptions|null);
 
+        /** Table mysql */
+        mysql?: (sqlanvil.IMysqlOptions|null);
+
         /** Table fileName */
         fileName?: (string|null);
     }
@@ -6584,6 +6959,9 @@ namespace sqlanvil {
         /** Table supabase. */
         public supabase?: (sqlanvil.ISupabaseOptions|null);
 
+        /** Table mysql. */
+        public mysql?: (sqlanvil.IMysqlOptions|null);
+
         /** Table fileName. */
         public fileName: string;
 
@@ -13422,6 +13800,7 @@ declare class Table extends ActionBuilder<sqlanvil.Table> {
     disabled(disabled?: boolean): this;
     bigquery(bigquery: sqlanvil.IBigQueryOptions): this;
     postgres(postgres: sqlanvil.IPostgresOptions): this;
+    mysql(mysql: sqlanvil.IMysqlOptions): this;
     supabase(supabase: sqlanvil.ISupabaseOptions): this;
     dependencies(value: Resolvable | Resolvable[]): this;
     hermetic(hermetic: boolean): void;
@@ -13488,6 +13867,7 @@ declare class IncrementalTable extends ActionBuilder<sqlanvil.Table> {
     uniqueKey(uniqueKey: string[]): void;
     bigquery(bigquery: sqlanvil.IBigQueryOptions): this;
     postgres(postgres: sqlanvil.IPostgresOptions): this;
+    mysql(mysql: sqlanvil.IMysqlOptions): this;
     supabase(supabase: sqlanvil.ISupabaseOptions): this;
     dependencies(value: Resolvable | Resolvable[]): this;
     hermetic(hermetic: boolean): void;
@@ -13934,7 +14314,7 @@ declare function jitCompiler(rpcCallback: RpcCallback): IJitCompiler;
 
 declare function main(coreExecutionRequest: Uint8Array | string): Uint8Array | string;
 
-declare const version = "1.4.1";
+declare const version = "1.6.0";
 
 declare const session: Session;
 declare const supportedFeatures: sqlanvil.SupportedFeatures[];