@powersync/service-module-mysql 0.0.0-dev-20241015210820

package/dist/replication/MySQLConnectionManager.d.ts

@@ -0,0 +1,43 @@
+import { NormalizedMySQLConnectionConfig } from '../types/types.js';
+import mysqlPromise from 'mysql2/promise';
+import mysql from 'mysql2';
+import ZongJi from '@powersync/mysql-zongji';
+export declare class MySQLConnectionManager {
+    options: NormalizedMySQLConnectionConfig;
+    poolOptions: mysqlPromise.PoolOptions;
+    /**
+     *  Pool that can create streamable connections
+     */
+    private readonly pool;
+    /**
+     *  Pool that can create promise-based connections
+     */
+    private readonly promisePool;
+    private binlogListeners;
+    constructor(options: NormalizedMySQLConnectionConfig, poolOptions: mysqlPromise.PoolOptions);
+    get connectionTag(): string;
+    get connectionId(): string;
+    get databaseName(): string;
+    /**
+     * Create a new replication listener
+     */
+    createBinlogListener(): ZongJi;
+    /**
+     *  Run a query using a connection from the pool
+     *  A promise with the result is returned
+     *  @param query
+     *  @param params
+     */
+    query(query: string, params?: any[]): Promise<[mysqlPromise.RowDataPacket[], mysqlPromise.FieldPacket[]]>;
+    /**
+     *  Get a streamable connection from this manager's pool
+     *  The connection should be released when it is no longer needed
+     */
+    getStreamingConnection(): Promise<mysql.PoolConnection>;
+    /**
+     *  Get a promise connection from this manager's pool
+     *  The connection should be released when it is no longer needed
+     */
+    getConnection(): Promise<mysqlPromise.PoolConnection>;
+    end(): Promise<void>;
+}

package/dist/replication/MySQLConnectionManager.js

@@ -0,0 +1,81 @@
+import * as mysql_utils from '../utils/mysql_utils.js';
+import ZongJi from '@powersync/mysql-zongji';
+export class MySQLConnectionManager {
+    constructor(options, poolOptions) {
+        this.options = options;
+        this.poolOptions = poolOptions;
+        this.binlogListeners = [];
+        // The pool is lazy - no connections are opened until a query is performed.
+        this.pool = mysql_utils.createPool(options, poolOptions);
+        this.promisePool = this.pool.promise();
+    }
+    get connectionTag() {
+        return this.options.tag;
+    }
+    get connectionId() {
+        return this.options.id;
+    }
+    get databaseName() {
+        return this.options.database;
+    }
+    /**
+     * Create a new replication listener
+     */
+    createBinlogListener() {
+        const listener = new ZongJi({
+            host: this.options.hostname,
+            user: this.options.username,
+            password: this.options.password
+        });
+        this.binlogListeners.push(listener);
+        return listener;
+    }
+    /**
+     *  Run a query using a connection from the pool
+     *  A promise with the result is returned
+     *  @param query
+     *  @param params
+     */
+    async query(query, params) {
+        return this.promisePool.query(query, params);
+    }
+    /**
+     *  Get a streamable connection from this manager's pool
+     *  The connection should be released when it is no longer needed
+     */
+    async getStreamingConnection() {
+        return new Promise((resolve, reject) => {
+            this.pool.getConnection((err, connection) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(connection);
+                }
+            });
+        });
+    }
+    /**
+     *  Get a promise connection from this manager's pool
+     *  The connection should be released when it is no longer needed
+     */
+    async getConnection() {
+        return this.promisePool.getConnection();
+    }
+    async end() {
+        for (const listener of this.binlogListeners) {
+            listener.stop();
+        }
+        await new Promise((resolve, reject) => {
+            this.pool.end((err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=MySQLConnectionManager.js.map

package/dist/replication/MySQLConnectionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLConnectionManager.js","sourceRoot":"","sources":["../../src/replication/MySQLConnectionManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,MAAM,MAAM,yBAAyB,CAAC;AAE7C,MAAM,OAAO,sBAAsB;IAYjC,YACS,OAAwC,EACxC,WAAqC;QADrC,YAAO,GAAP,OAAO,CAAiC;QACxC,gBAAW,GAAX,WAAW,CAA0B;QAJtC,oBAAe,GAAa,EAAE,CAAC;QAMrC,2EAA2E;QAC3E,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC;YAC1B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC3B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC3B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc;QACvC,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAkB,KAAK,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB;QAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;gBAC1C,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,UAAU,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,GAAG;QACP,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACpB,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/replication/MySQLConnectionManagerFactory.d.ts

@@ -0,0 +1,10 @@
+import mysql from 'mysql2/promise';
+import { MySQLConnectionManager } from './MySQLConnectionManager.js';
+import { ResolvedConnectionConfig } from '../types/types.js';
+export declare class MySQLConnectionManagerFactory {
+    private readonly connectionManagers;
+    private readonly connectionConfig;
+    constructor(connectionConfig: ResolvedConnectionConfig);
+    create(poolOptions: mysql.PoolOptions): MySQLConnectionManager;
+    shutdown(): Promise<void>;
+}

package/dist/replication/MySQLConnectionManagerFactory.js

@@ -0,0 +1,21 @@
+import { logger } from '@powersync/lib-services-framework';
+import { MySQLConnectionManager } from './MySQLConnectionManager.js';
+export class MySQLConnectionManagerFactory {
+    constructor(connectionConfig) {
+        this.connectionConfig = connectionConfig;
+        this.connectionManagers = [];
+    }
+    create(poolOptions) {
+        const manager = new MySQLConnectionManager(this.connectionConfig, poolOptions);
+        this.connectionManagers.push(manager);
+        return manager;
+    }
+    async shutdown() {
+        logger.info('Shutting down MySQL connection Managers...');
+        for (const manager of this.connectionManagers) {
+            await manager.end();
+        }
+        logger.info('MySQL connection Managers shutdown completed.');
+    }
+}
+//# sourceMappingURL=MySQLConnectionManagerFactory.js.map

package/dist/replication/MySQLConnectionManagerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLConnectionManagerFactory.js","sourceRoot":"","sources":["../../src/replication/MySQLConnectionManagerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,MAAM,OAAO,6BAA6B;IAIxC,YAAY,gBAA0C;QACpD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,WAA8B;QACnC,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;QAC/E,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC1D,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC9C,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QACtB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/replication/MySQLErrorRateLimiter.d.ts

@@ -0,0 +1,10 @@
+import { ErrorRateLimiter } from '@powersync/service-core';
+export declare class MySQLErrorRateLimiter implements ErrorRateLimiter {
+    nextAllowed: number;
+    waitUntilAllowed(options?: {
+        signal?: AbortSignal | undefined;
+    } | undefined): Promise<void>;
+    mayPing(): boolean;
+    reportError(e: any): void;
+    private setDelay;
+}

package/dist/replication/MySQLErrorRateLimiter.js

@@ -0,0 +1,43 @@
+import { setTimeout } from 'timers/promises';
+export class MySQLErrorRateLimiter {
+    constructor() {
+        this.nextAllowed = Date.now();
+    }
+    async waitUntilAllowed(options) {
+        const delay = Math.max(0, this.nextAllowed - Date.now());
+        // Minimum delay between connections, even without errors
+        this.setDelay(500);
+        await setTimeout(delay, undefined, { signal: options?.signal });
+    }
+    mayPing() {
+        return Date.now() >= this.nextAllowed;
+    }
+    reportError(e) {
+        const message = e.message ?? '';
+        if (message.includes('password authentication failed')) {
+            // Wait 15 minutes, to avoid triggering Supabase's fail2ban
+            this.setDelay(900000);
+        }
+        else if (message.includes('ENOTFOUND')) {
+            // DNS lookup issue - incorrect URI or deleted instance
+            this.setDelay(120000);
+        }
+        else if (message.includes('ECONNREFUSED')) {
+            // Could be fail2ban or similar
+            this.setDelay(120000);
+        }
+        else if (message.includes('Unable to do postgres query on ended pool') ||
+            message.includes('Postgres unexpectedly closed connection')) {
+            // Connection timed out - ignore / immediately retry
+            // We don't explicitly set the delay to 0, since there could have been another error that
+            // we need to respect.
+        }
+        else {
+            this.setDelay(30000);
+        }
+    }
+    setDelay(delay) {
+        this.nextAllowed = Math.max(this.nextAllowed, Date.now() + delay);
+    }
+}
+//# sourceMappingURL=MySQLErrorRateLimiter.js.map

package/dist/replication/MySQLErrorRateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLErrorRateLimiter.js","sourceRoot":"","sources":["../../src/replication/MySQLErrorRateLimiter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,OAAO,qBAAqB;IAAlC;QACE,gBAAW,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;IAuCnC,CAAC;IArCC,KAAK,CAAC,gBAAgB,CAAC,OAA0D;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACzD,yDAAyD;QACzD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC;IACxC,CAAC;IAED,WAAW,CAAC,CAAM;QAChB,MAAM,OAAO,GAAI,CAAC,CAAC,OAAkB,IAAI,EAAE,CAAC;QAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,CAAC;YACvD,2DAA2D;YAC3D,IAAI,CAAC,QAAQ,CAAC,MAAO,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACzC,uDAAuD;YACvD,IAAI,CAAC,QAAQ,CAAC,MAAO,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5C,+BAA+B;YAC/B,IAAI,CAAC,QAAQ,CAAC,MAAO,CAAC,CAAC;QACzB,CAAC;aAAM,IACL,OAAO,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAC7D,OAAO,CAAC,QAAQ,CAAC,yCAAyC,CAAC,EAC3D,CAAC;YACD,oDAAoD;YACpD,yFAAyF;YACzF,sBAAsB;QACxB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,KAAa;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/replication/zongji/zongji-utils.d.ts

@@ -0,0 +1,7 @@
+import { BinLogEvent, BinLogGTIDLogEvent, BinLogMutationEvent, BinLogRotationEvent, BinLogUpdateEvent, BinLogXidEvent } from '@powersync/mysql-zongji';
+export declare function eventIsGTIDLog(event: BinLogEvent): event is BinLogGTIDLogEvent;
+export declare function eventIsXid(event: BinLogEvent): event is BinLogXidEvent;
+export declare function eventIsRotation(event: BinLogEvent): event is BinLogRotationEvent;
+export declare function eventIsWriteMutation(event: BinLogEvent): event is BinLogMutationEvent;
+export declare function eventIsDeleteMutation(event: BinLogEvent): event is BinLogMutationEvent;
+export declare function eventIsUpdateMutation(event: BinLogEvent): event is BinLogUpdateEvent;

package/dist/replication/zongji/zongji-utils.js

@@ -0,0 +1,19 @@
+export function eventIsGTIDLog(event) {
+    return event.getEventName() == 'gtidlog';
+}
+export function eventIsXid(event) {
+    return event.getEventName() == 'xid';
+}
+export function eventIsRotation(event) {
+    return event.getEventName() == 'rotate';
+}
+export function eventIsWriteMutation(event) {
+    return event.getEventName() == 'writerows';
+}
+export function eventIsDeleteMutation(event) {
+    return event.getEventName() == 'deleterows';
+}
+export function eventIsUpdateMutation(event) {
+    return event.getEventName() == 'updaterows';
+}
+//# sourceMappingURL=zongji-utils.js.map

package/dist/replication/zongji/zongji-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zongji-utils.js","sourceRoot":"","sources":["../../../src/replication/zongji/zongji-utils.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,OAAO,KAAK,CAAC,YAAY,EAAE,IAAI,SAAS,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO,KAAK,CAAC,YAAY,EAAE,IAAI,KAAK,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,OAAO,KAAK,CAAC,YAAY,EAAE,IAAI,QAAQ,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,OAAO,KAAK,CAAC,YAAY,EAAE,IAAI,WAAW,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACtD,OAAO,KAAK,CAAC,YAAY,EAAE,IAAI,YAAY,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACtD,OAAO,KAAK,CAAC,YAAY,EAAE,IAAI,YAAY,CAAC;AAC9C,CAAC"}

package/dist/types/types.d.ts

@@ -0,0 +1,50 @@
+import * as t from 'ts-codec';
+export declare const MYSQL_CONNECTION_TYPE: "mysql";
+export interface NormalizedMySQLConnectionConfig {
+    id: string;
+    tag: string;
+    hostname: string;
+    port: number;
+    database: string;
+    username: string;
+    password: string;
+    cacert?: string;
+    client_certificate?: string;
+    client_private_key?: string;
+}
+export declare const MySQLConnectionConfig: t.Intersection<t.Codec<{
+    type: string;
+    id?: string | undefined;
+    tag?: string | undefined;
+    debug_api?: boolean | undefined;
+}, {
+    type: string;
+    id?: string | undefined;
+    tag?: string | undefined;
+    debug_api?: boolean | undefined;
+}, string, t.CodecProps>, t.ObjectCodec<{
+    type: t.LiteralCodec<"mysql">;
+    uri: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    hostname: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    port: t.OptionalCodec<t.Codec<number, string | number, string, t.CodecProps>>;
+    username: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    password: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    database: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    cacert: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    client_certificate: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+    client_private_key: t.OptionalCodec<t.Codec<string, string, string, t.CodecProps>>;
+}>>;
+/**
+ * Config input specified when starting services
+ */
+export type MySQLConnectionConfig = t.Decoded<typeof MySQLConnectionConfig>;
+/**
+ * Resolved version of {@link MySQLConnectionConfig}
+ */
+export type ResolvedConnectionConfig = MySQLConnectionConfig & NormalizedMySQLConnectionConfig;
+/**
+ * Validate and normalize connection options.
+ *
+ * Returns destructured options.
+ */
+export declare function normalizeConnectionConfig(options: MySQLConnectionConfig): NormalizedMySQLConnectionConfig;

package/dist/types/types.js

@@ -0,0 +1,61 @@
+import * as service_types from '@powersync/service-types';
+import * as t from 'ts-codec';
+import * as urijs from 'uri-js';
+export const MYSQL_CONNECTION_TYPE = 'mysql';
+export const MySQLConnectionConfig = service_types.configFile.DataSourceConfig.and(t.object({
+    type: t.literal(MYSQL_CONNECTION_TYPE),
+    uri: t.string.optional(),
+    hostname: t.string.optional(),
+    port: service_types.configFile.portCodec.optional(),
+    username: t.string.optional(),
+    password: t.string.optional(),
+    database: t.string.optional(),
+    cacert: t.string.optional(),
+    client_certificate: t.string.optional(),
+    client_private_key: t.string.optional()
+}));
+/**
+ * Validate and normalize connection options.
+ *
+ * Returns destructured options.
+ */
+export function normalizeConnectionConfig(options) {
+    let uri;
+    if (options.uri) {
+        uri = urijs.parse(options.uri);
+        if (uri.scheme != 'mysql') {
+            throw new Error(`Invalid URI - protocol must be mysql, got ${uri.scheme}`);
+        }
+    }
+    else {
+        uri = urijs.parse('mysql:///');
+    }
+    const hostname = options.hostname ?? uri.host ?? '';
+    const port = Number(options.port ?? uri.port ?? 3306);
+    const database = options.database ?? uri.path?.substring(1) ?? '';
+    const [uri_username, uri_password] = (uri.userinfo ?? '').split(':');
+    const username = options.username ?? uri_username ?? '';
+    const password = options.password ?? uri_password ?? '';
+    if (hostname == '') {
+        throw new Error(`hostname required`);
+    }
+    if (username == '') {
+        throw new Error(`username required`);
+    }
+    if (password == '') {
+        throw new Error(`password required`);
+    }
+    if (database == '') {
+        throw new Error(`database required`);
+    }
+    return {
+        id: options.id ?? 'default',
+        tag: options.tag ?? 'default',
+        hostname,
+        port,
+        database,
+        username,
+        password
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/mysql_utils.d.ts

@@ -0,0 +1,14 @@
+import mysql from 'mysql2';
+import mysqlPromise from 'mysql2/promise';
+import * as types from '../types/types.js';
+export type RetriedQueryOptions = {
+    connection: mysqlPromise.Connection;
+    query: string;
+    params?: any[];
+    retries?: number;
+};
+/**
+ * Retry a simple query - up to 2 attempts total.
+ */
+export declare function retriedQuery(options: RetriedQueryOptions): Promise<[mysql.RowDataPacket[], mysql.FieldPacket[]]>;
+export declare function createPool(config: types.NormalizedMySQLConnectionConfig, options?: mysql.PoolOptions): mysql.Pool;

package/dist/utils/mysql_utils.js

@@ -0,0 +1,38 @@
+import { logger } from '@powersync/lib-services-framework';
+import mysql from 'mysql2';
+/**
+ * Retry a simple query - up to 2 attempts total.
+ */
+export async function retriedQuery(options) {
+    const { connection, query, params = [], retries = 2 } = options;
+    for (let tries = retries;; tries--) {
+        try {
+            logger.debug(`Executing query: ${query}`);
+            return connection.query(query, params);
+        }
+        catch (e) {
+            if (tries == 1) {
+                throw e;
+            }
+            logger.warn('Query error, retrying', e);
+        }
+    }
+}
+export function createPool(config, options) {
+    const sslOptions = {
+        ca: config.cacert,
+        key: config.client_private_key,
+        cert: config.client_certificate
+    };
+    const hasSSLOptions = Object.values(sslOptions).some((v) => !!v);
+    // TODO confirm if default options are fine for Powersync use case
+    return mysql.createPool({
+        host: config.hostname,
+        user: config.username,
+        password: config.password,
+        database: config.database,
+        ssl: hasSSLOptions ? sslOptions : undefined,
+        ...(options || {})
+    });
+}
+//# sourceMappingURL=mysql_utils.js.map

package/dist/utils/mysql_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql_utils.js","sourceRoot":"","sources":["../../src/utils/mysql_utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAC3D,OAAO,KAAK,MAAM,QAAQ,CAAC;AAW3B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,EAAE,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAChE,KAAK,IAAI,KAAK,GAAG,OAAO,GAAI,KAAK,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;YAC1C,OAAO,UAAU,CAAC,KAAK,CAA+B,KAAK,EAAE,MAAM,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,CAAC;YACV,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA6C,EAAE,OAA2B;IACnG,MAAM,UAAU,GAAG;QACjB,EAAE,EAAE,MAAM,CAAC,MAAM;QACjB,GAAG,EAAE,MAAM,CAAC,kBAAkB;QAC9B,IAAI,EAAE,MAAM,CAAC,kBAAkB;KAChC,CAAC;IACF,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,kEAAkE;IAClE,OAAO,KAAK,CAAC,UAAU,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QAC3C,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;KACnB,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@powersync/service-module-mysql",
+  "repository": "https://github.com/powersync-ja/powersync-service",
+  "types": "dist/index.d.ts",
+  "version": "0.0.0-dev-20241015210820",
+  "license": "FSL-1.1-Apache-2.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "import": "./dist/types/types.js",
+      "require": "./dist/types/types.js",
+      "default": "./dist/types/types.js"
+    }
+  },
+  "dependencies": {
+    "@powersync/mysql-zongji": "0.0.0-dev-20241008105633",
+    "semver": "^7.5.4",
+    "async": "^3.2.4",
+    "mysql2": "^3.11.0",
+    "ts-codec": "^1.2.2",
+    "uri-js": "^4.4.1",
+    "uuid": "^9.0.1",
+    "@powersync/lib-services-framework": "0.0.0-dev-20241015210820",
+    "@powersync/service-core": "0.0.0-dev-20241015210820",
+    "@powersync/service-sync-rules": "0.0.0-dev-20241015210820",
+    "@powersync/service-types": "0.0.0-dev-20241015210820"
+  },
+  "devDependencies": {
+    "@types/semver": "^7.5.4",
+    "@types/async": "^3.2.24",
+    "@types/uuid": "^9.0.8",
+    "typescript": "^5.5.4",
+    "vite-tsconfig-paths": "^4.3.2",
+    "vitest": "^0.34.6"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "build:tests": "tsc -b test/tsconfig.json",
+    "clean": "rm -rf ./lib && tsc -b --clean",
+    "test": "vitest"
+  }
+}