@powersync/service-module-mssql 0.0.0-dev-20251128080741

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @powersync/service-module-mssql
+
+## 0.0.0-dev-20251128080741
+
+### Minor Changes
+
+- f51f987: - First iteration of MSSQL replication using Change Data Capture (CDC).
+  - Supports resumable snapshot replication
+  - Uses CDC polling for replication
+
+### Patch Changes
+
+- Updated dependencies [57f7660]
+- Updated dependencies [0156d10]
+- Updated dependencies [f51f987]
+  - @powersync/service-core@0.0.0-dev-20251128080741
+  - @powersync/service-types@0.0.0-dev-20251128080741
+  - @powersync/service-sync-rules@0.0.0-dev-20251128080741
+  - @powersync/service-errors@0.0.0-dev-20251128080741
+  - @powersync/lib-services-framework@0.0.0-dev-20251128080741

package/LICENSE

@@ -0,0 +1,67 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2023-2025 Journey Mobile, Inc.
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under these Terms and Conditions, as indicated by our inclusion of these Terms and Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents, Redistribution and Trademark clauses below, we hereby grant you the right to use, copy, modify, create derivative works, publicly perform, publicly display and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use means making the Software available to others in a commercial product or service that:
+
+1. substitutes for the Software;
+2. substitutes for any other product or service we offer using the Software that exists as of the date we make the Software available; or
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+2. for non-commercial education;
+3. for non-commercial research; and
+4. in connection with professional services that you provide to a licensee using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our patents, the license grant above includes a license under our patents. If you make a claim against any party that the Software infringes or contributes to the infringement of any patent, then your patent license to the Software ends immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of the Software.
+If you redistribute any copies, modifications or derivatives of the Software, you must include a copy of or a link to these Terms and Conditions and not remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of the Software, you have no right under these Terms and Conditions to use our trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under the Apache License, Version 2.0 that is effective on the second anniversary of the date we make the Software available. On or after that date, you may use the Software under the Apache License, Version 2.0, in which case the following will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

package/README.md

@@ -0,0 +1,3 @@
+# PowerSync MSSQL Module
+
+MSSQL replication module for PowerSync

package/ci/init-mssql.sql

@@ -0,0 +1,50 @@
+-- Create database (idempotent)
+IF DB_ID('$(DATABASE)') IS NULL
+BEGIN
+    CREATE DATABASE [$(DATABASE)];
+END
+GO
+
+-- Enable CDC at the database level (idempotent)
+USE [$(DATABASE)];
+IF (SELECT is_cdc_enabled FROM sys.databases WHERE name = '$(DATABASE)') = 0
+BEGIN
+    EXEC sys.sp_cdc_enable_db;
+END
+GO
+
+-- Create PowerSync checkpoints table
+-- Powersync requires this table to ensure regular checkpoints appear in CDC
+IF OBJECT_ID('dbo._powersync_checkpoints', 'U') IS NULL
+BEGIN
+    CREATE TABLE dbo._powersync_checkpoints (
+        id INT IDENTITY PRIMARY KEY,
+        last_updated DATETIME NOT NULL DEFAULT (GETDATE())
+);
+END
+
+GRANT INSERT, UPDATE ON dbo._powersync_checkpoints TO [$(DB_USER)];
+GO
+
+-- Enable CDC for the powersync checkpoints table
+IF NOT EXISTS (SELECT 1 FROM cdc.change_tables WHERE source_object_id = OBJECT_ID(N'dbo._powersync_checkpoints'))
+    BEGIN
+    EXEC sys.sp_cdc_enable_table
+        @source_schema = N'dbo',
+        @source_name   = N'_powersync_checkpoints',
+        @role_name     = N'cdc_reader',
+        @supports_net_changes = 0;
+END
+GO
+
+-- Wait until capture job exists - usually takes a few seconds after enabling CDC on a table for the first time
+DECLARE @tries int = 10;
+WHILE @tries > 0 AND NOT EXISTS (SELECT 1 FROM msdb.dbo.cdc_jobs WHERE job_type = N'capture')
+BEGIN
+    WAITFOR DELAY '00:00:01';
+    SET @tries -= 1;
+END;
+
+-- Set the CDC capture job polling interval to 1 second (default is 5 seconds)
+EXEC sys.sp_cdc_change_job @job_type = N'capture', @pollinginterval = 1;
+GO

package/dist/api/MSSQLRouteAPIAdapter.d.ts

@@ -0,0 +1,21 @@
+import { api, ParseSyncRulesOptions, PatternResult, ReplicationHeadCallback, ReplicationLagOptions } from '@powersync/service-core';
+import * as service_types from '@powersync/service-types';
+import { SqlSyncRules, TablePattern } from '@powersync/service-sync-rules';
+import * as types from '../types/types.js';
+import { ExecuteSqlResponse } from '@powersync/service-types/dist/routes.js';
+import { MSSQLConnectionManager } from '../replication/MSSQLConnectionManager.js';
+export declare class MSSQLRouteAPIAdapter implements api.RouteAPI {
+    protected config: types.ResolvedMSSQLConnectionConfig;
+    protected connectionManager: MSSQLConnectionManager;
+    constructor(config: types.ResolvedMSSQLConnectionConfig);
+    createReplicationHead<T>(callback: ReplicationHeadCallback<T>): Promise<T>;
+    executeQuery(query: string, params: any[]): Promise<ExecuteSqlResponse>;
+    getConnectionSchema(): Promise<service_types.DatabaseSchema[]>;
+    getConnectionStatus(): Promise<service_types.ConnectionStatusV2>;
+    getDebugTablesInfo(tablePatterns: TablePattern[], sqlSyncRules: SqlSyncRules): Promise<PatternResult[]>;
+    getParseSyncRulesOptions(): ParseSyncRulesOptions;
+    getReplicationLagBytes(options: ReplicationLagOptions): Promise<number | undefined>;
+    getSourceConfig(): Promise<service_types.configFile.ResolvedDataSourceConfig>;
+    [Symbol.asyncDispose](): Promise<void>;
+    shutdown(): Promise<void>;
+}

package/dist/api/MSSQLRouteAPIAdapter.js

@@ -0,0 +1,248 @@
+import * as service_types from '@powersync/service-types';
+import * as sync_rules from '@powersync/service-sync-rules';
+import * as types from '../types/types.js';
+import { MSSQLConnectionManager } from '../replication/MSSQLConnectionManager.js';
+import { checkSourceConfiguration, createCheckpoint, getDebugTableInfo, getLatestLSN, POWERSYNC_CHECKPOINTS_TABLE } from '../utils/mssql.js';
+import { getTablesFromPattern } from '../utils/schema.js';
+import { toExpressionTypeFromMSSQLType } from '../common/mssqls-to-sqlite.js';
+export class MSSQLRouteAPIAdapter {
+    config;
+    connectionManager;
+    constructor(config) {
+        this.config = config;
+        this.connectionManager = new MSSQLConnectionManager(config, {});
+    }
+    async createReplicationHead(callback) {
+        const currentLSN = await getLatestLSN(this.connectionManager);
+        const result = await callback(currentLSN.toString());
+        // Updates the powersync checkpoints table on the source database, ensuring that an update with a newer LSN will be captured by the CDC.
+        await createCheckpoint(this.connectionManager);
+        return result;
+    }
+    async executeQuery(query, params) {
+        if (!this.config.debug_api) {
+            return service_types.internal_routes.ExecuteSqlResponse.encode({
+                results: {
+                    columns: [],
+                    rows: []
+                },
+                success: false,
+                error: 'SQL querying is not enabled'
+            });
+        }
+        try {
+            const { recordset: result } = await this.connectionManager.query(query, params);
+            return service_types.internal_routes.ExecuteSqlResponse.encode({
+                success: true,
+                results: {
+                    columns: Object.values(result.columns).map((column) => column.name),
+                    rows: result.map((row) => {
+                        return Object.values(row).map((value) => {
+                            const sqlValue = sync_rules.applyValueContext(sync_rules.toSyncRulesValue(row), sync_rules.CompatibilityContext.FULL_BACKWARDS_COMPATIBILITY);
+                            if (typeof sqlValue == 'bigint') {
+                                return Number(row);
+                            }
+                            else if (value instanceof Date) {
+                                return value.toISOString();
+                            }
+                            else if (sync_rules.isJsonValue(sqlValue)) {
+                                return sqlValue;
+                            }
+                            else {
+                                return null;
+                            }
+                        });
+                    })
+                }
+            });
+        }
+        catch (e) {
+            return service_types.internal_routes.ExecuteSqlResponse.encode({
+                results: {
+                    columns: [],
+                    rows: []
+                },
+                success: false,
+                error: e.message
+            });
+        }
+    }
+    async getConnectionSchema() {
+        const { recordset: results } = await this.connectionManager.query(`
+      SELECT 
+        sch.name AS schema_name,
+        tbl.name AS table_name,
+        col.name AS column_name,
+        typ.name AS data_type,
+        CASE 
+          WHEN typ.name IN ('nvarchar', 'nchar') 
+            AND col.max_length > 0 
+            AND col.max_length != -1
+          THEN typ.name + '(' + CAST(col.max_length / 2 AS VARCHAR) + ')'
+          WHEN typ.name IN ('varchar', 'char', 'varbinary', 'binary') 
+            AND col.max_length > 0 
+            AND col.max_length != -1
+          THEN typ.name + '(' + CAST(col.max_length AS VARCHAR) + ')'
+          WHEN typ.name IN ('varchar', 'nvarchar', 'char', 'nchar') 
+            AND col.max_length = -1
+          THEN typ.name + '(MAX)'
+          WHEN typ.name IN ('decimal', 'numeric')
+            AND col.precision > 0
+          THEN typ.name + '(' + CAST(col.precision AS VARCHAR) + ',' + CAST(col.scale AS VARCHAR) + ')'
+          WHEN typ.name IN ('float', 'real')
+            AND col.precision > 0
+          THEN typ.name + '(' + CAST(col.precision AS VARCHAR) + ')'
+          ELSE typ.name
+        END AS formatted_type
+      FROM sys.tables AS tbl
+        JOIN sys.schemas AS sch ON sch.schema_id = tbl.schema_id
+        JOIN sys.columns AS col ON col.object_id = tbl.object_id
+        JOIN sys.types AS typ ON typ.user_type_id = col.user_type_id
+      WHERE sch.name = '${this.connectionManager.schema}'
+        AND sch.name NOT IN ('sys', 'INFORMATION_SCHEMA', 'cdc')
+        AND tbl.name NOT IN ('systranschemas', '${POWERSYNC_CHECKPOINTS_TABLE}')
+        AND tbl.type = 'U'
+        AND col.is_computed = 0
+      ORDER BY sch.name, tbl.name, col.column_id
+    `);
+        /**
+         * Reduces the SQL results into a Record of {@link DatabaseSchema}
+         * then returns the values as an array.
+         */
+        const schemas = {};
+        for (const row of results) {
+            const schemaName = row.schema_name;
+            const tableName = row.table_name;
+            const columnName = row.column_name;
+            const dataType = row.data_type;
+            const formattedType = row.formatted_type || dataType;
+            const schema = schemas[schemaName] ||
+                (schemas[schemaName] = {
+                    name: schemaName,
+                    tables: []
+                });
+            let table = schema.tables.find((t) => t.name === tableName);
+            if (!table) {
+                table = {
+                    name: tableName,
+                    columns: []
+                };
+                schema.tables.push(table);
+            }
+            table.columns.push({
+                name: columnName,
+                type: formattedType,
+                sqlite_type: toExpressionTypeFromMSSQLType(dataType).typeFlags,
+                internal_type: formattedType,
+                pg_type: formattedType
+            });
+        }
+        return Object.values(schemas);
+    }
+    async getConnectionStatus() {
+        const base = {
+            id: this.config?.id ?? '',
+            uri: this.config == null ? '' : types.baseUri(this.config)
+        };
+        try {
+            await this.connectionManager.query(`SELECT 'PowerSync connection test'`);
+        }
+        catch (e) {
+            return {
+                ...base,
+                connected: false,
+                errors: [{ level: 'fatal', message: `${e.code} - message: ${e.message}` }]
+            };
+        }
+        try {
+            const errors = await checkSourceConfiguration(this.connectionManager);
+            if (errors.length) {
+                return {
+                    ...base,
+                    connected: true,
+                    errors: errors.map((e) => ({ level: 'fatal', message: e }))
+                };
+            }
+        }
+        catch (e) {
+            return {
+                ...base,
+                connected: true,
+                errors: [{ level: 'fatal', message: e.message }]
+            };
+        }
+        return {
+            ...base,
+            connected: true,
+            errors: []
+        };
+    }
+    async getDebugTablesInfo(tablePatterns, sqlSyncRules) {
+        const result = [];
+        for (const tablePattern of tablePatterns) {
+            const schema = tablePattern.schema;
+            const patternResult = {
+                schema: schema,
+                pattern: tablePattern.tablePattern,
+                wildcard: tablePattern.isWildcard
+            };
+            result.push(patternResult);
+            const tables = await getTablesFromPattern(this.connectionManager, tablePattern);
+            if (tablePattern.isWildcard) {
+                patternResult.tables = [];
+                for (const table of tables) {
+                    const details = await getDebugTableInfo({
+                        connectionManager: this.connectionManager,
+                        tablePattern,
+                        table,
+                        syncRules: sqlSyncRules
+                    });
+                    patternResult.tables.push(details);
+                }
+            }
+            else {
+                if (tables.length == 0) {
+                    // This should tenchnically never happen, but we'll handle it anyway.
+                    const resolvedTable = {
+                        objectId: 0,
+                        schema: schema,
+                        name: tablePattern.name
+                    };
+                    patternResult.table = await getDebugTableInfo({
+                        connectionManager: this.connectionManager,
+                        tablePattern,
+                        table: resolvedTable,
+                        syncRules: sqlSyncRules
+                    });
+                }
+                else {
+                    patternResult.table = await getDebugTableInfo({
+                        connectionManager: this.connectionManager,
+                        tablePattern,
+                        table: tables[0],
+                        syncRules: sqlSyncRules
+                    });
+                }
+            }
+        }
+        return result;
+    }
+    getParseSyncRulesOptions() {
+        return {
+            defaultSchema: this.connectionManager.schema
+        };
+    }
+    async getReplicationLagBytes(options) {
+        return undefined;
+    }
+    async getSourceConfig() {
+        return this.config;
+    }
+    async [Symbol.asyncDispose]() {
+        await this.shutdown();
+    }
+    async shutdown() {
+        await this.connectionManager.end();
+    }
+}
+//# sourceMappingURL=MSSQLRouteAPIAdapter.js.map

package/dist/api/MSSQLRouteAPIAdapter.js.map

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

package/dist/common/LSN.d.ts

@@ -0,0 +1,37 @@
+/**
+ *  Helper class for interpreting and manipulating SQL Server Log Sequence Numbers (LSNs).
+ *  In SQL Server, an LSN is stored as a 10-byte binary value.
+ *  But it is commonly represented in a human-readable format as three hexadecimal parts separated by colons:
+ *  `00000000:00000000:0000`.
+ *
+ *  The three parts represent different hierarchical levels of the transaction log:
+ *  1. The first part identifies the Virtual Log File (VLF).
+ *  2. The second part points to the log block within the VLF.
+ *  3. The third part specifies the exact log record within the log block.
+ */
+export declare class LSN {
+    /**
+     *  The zero or null LSN value. All other LSN values are greater than this.
+     */
+    static ZERO: string;
+    protected value: string;
+    private constructor();
+    /**
+     *  Converts this LSN back into its raw 10-byte binary representation for use in SQL Server functions.
+     */
+    toBinary(): Buffer;
+    /**
+     *  Converts a raw 10-byte binary LSN value into its string representation.
+     *  An error is thrown if the binary value is not exactly 10 bytes.
+     *  @param rawLSN
+     */
+    static fromBinary(rawLSN: Buffer): LSN;
+    /**
+     *  Creates an LSN instance from the provided string representation. An error is thrown if the format is invalid.
+     *  @param stringLSN
+     */
+    static fromString(stringLSN: string): LSN;
+    compare(other: LSN): -1 | 0 | 1;
+    valueOf(): string;
+    toString(): string;
+}

package/dist/common/LSN.js

@@ -0,0 +1,64 @@
+import { ReplicationAssertionError } from '@powersync/service-errors';
+/**
+ *  Helper class for interpreting and manipulating SQL Server Log Sequence Numbers (LSNs).
+ *  In SQL Server, an LSN is stored as a 10-byte binary value.
+ *  But it is commonly represented in a human-readable format as three hexadecimal parts separated by colons:
+ *  `00000000:00000000:0000`.
+ *
+ *  The three parts represent different hierarchical levels of the transaction log:
+ *  1. The first part identifies the Virtual Log File (VLF).
+ *  2. The second part points to the log block within the VLF.
+ *  3. The third part specifies the exact log record within the log block.
+ */
+export class LSN {
+    /**
+     *  The zero or null LSN value. All other LSN values are greater than this.
+     */
+    static ZERO = '00000000:00000000:0000';
+    value;
+    constructor(lsn) {
+        this.value = lsn;
+    }
+    /**
+     *  Converts this LSN back into its raw 10-byte binary representation for use in SQL Server functions.
+     */
+    toBinary() {
+        let sanitized = this.value.replace(/:/g, '');
+        return Buffer.from(sanitized, 'hex');
+    }
+    /**
+     *  Converts a raw 10-byte binary LSN value into its string representation.
+     *  An error is thrown if the binary value is not exactly 10 bytes.
+     *  @param rawLSN
+     */
+    static fromBinary(rawLSN) {
+        if (rawLSN.length !== 10) {
+            throw new ReplicationAssertionError(`LSN must be 10 bytes, got ${rawLSN.length}`);
+        }
+        const hex = rawLSN.toString('hex').toUpperCase(); // 20 hex chars
+        return new LSN(`${hex.slice(0, 8)}:${hex.slice(8, 16)}:${hex.slice(16, 20)}`);
+    }
+    /**
+     *  Creates an LSN instance from the provided string representation. An error is thrown if the format is invalid.
+     *  @param stringLSN
+     */
+    static fromString(stringLSN) {
+        if (!/^[0-9A-Fa-f]{8}:[0-9A-Fa-f]{8}:[0-9A-Fa-f]{4}$/.test(stringLSN)) {
+            throw new ReplicationAssertionError(`Invalid LSN string. Expected format is [00000000:00000000:0000]. Got: ${stringLSN}`);
+        }
+        return new LSN(stringLSN);
+    }
+    compare(other) {
+        if (this.value === other.value) {
+            return 0;
+        }
+        return this.value < other.value ? -1 : 1;
+    }
+    valueOf() {
+        return this.value;
+    }
+    toString() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=LSN.js.map

package/dist/common/LSN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LSN.js","sourceRoot":"","sources":["../../src/common/LSN.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;;;;GAUG;AAEH,MAAM,OAAO,GAAG;IACd;;OAEG;IACH,MAAM,CAAC,IAAI,GAAG,wBAAwB,CAAC;IAE7B,KAAK,CAAS;IAExB,YAAoB,GAAW;QAC7B,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,SAAS,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAc;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,yBAAyB,CAAC,6BAA6B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,eAAe;QAEjE,OAAO,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAiB;QACjC,IAAI,CAAC,gDAAgD,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,yBAAyB,CACjC,yEAAyE,SAAS,EAAE,CACrF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,CAAC,KAAU;QAChB,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC"}

package/dist/common/MSSQLSourceTable.d.ts

@@ -0,0 +1,27 @@
+import { SourceTable } from '@powersync/service-core';
+export interface CaptureInstance {
+    name: string;
+    schema: string;
+}
+export interface MSSQLSourceTableOptions {
+    sourceTable: SourceTable;
+    /**
+     *  The unique name of the CDC capture instance for this table
+     */
+    captureInstance: CaptureInstance;
+}
+export declare class MSSQLSourceTable {
+    private options;
+    constructor(options: MSSQLSourceTableOptions);
+    get sourceTable(): SourceTable;
+    updateSourceTable(updated: SourceTable): void;
+    get captureInstance(): string;
+    get cdcSchema(): string;
+    get CTTable(): string;
+    get allChangesFunction(): string;
+    get netChangesFunction(): string;
+    /**
+     *  Escapes this source table's name and schema for use in MSSQL queries.
+     */
+    toQualifiedName(): string;
+}

package/dist/common/MSSQLSourceTable.js

@@ -0,0 +1,35 @@
+import { toQualifiedTableName } from '../utils/mssql.js';
+export class MSSQLSourceTable {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    get sourceTable() {
+        return this.options.sourceTable;
+    }
+    updateSourceTable(updated) {
+        this.options.sourceTable = updated;
+    }
+    get captureInstance() {
+        return this.options.captureInstance.name;
+    }
+    get cdcSchema() {
+        return this.options.captureInstance.schema;
+    }
+    get CTTable() {
+        return `${this.cdcSchema}.${this.captureInstance}_CT`;
+    }
+    get allChangesFunction() {
+        return `${this.cdcSchema}.fn_cdc_get_all_changes_${this.captureInstance}`;
+    }
+    get netChangesFunction() {
+        return `${this.cdcSchema}.fn_cdc_get_net_changes_${this.captureInstance}`;
+    }
+    /**
+     *  Escapes this source table's name and schema for use in MSSQL queries.
+     */
+    toQualifiedName() {
+        return toQualifiedTableName(this.sourceTable.schema, this.sourceTable.name);
+    }
+}
+//# sourceMappingURL=MSSQLSourceTable.js.map

package/dist/common/MSSQLSourceTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MSSQLSourceTable.js","sourceRoot":"","sources":["../../src/common/MSSQLSourceTable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAezD,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;IAAG,CAAC;IAExD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;IAClC,CAAC;IAED,iBAAiB,CAAC,OAAoB;QACpC,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC;IACrC,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO;QACT,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,eAAe,KAAK,CAAC;IACxD,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,GAAG,IAAI,CAAC,SAAS,2BAA2B,IAAI,CAAC,eAAe,EAAE,CAAC;IAC5E,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,GAAG,IAAI,CAAC,SAAS,2BAA2B,IAAI,CAAC,eAAe,EAAE,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/common/MSSQLSourceTableCache.d.ts

@@ -0,0 +1,14 @@
+import { SourceTable } from '@powersync/service-core';
+import { MSSQLSourceTable } from './MSSQLSourceTable.js';
+export declare class MSSQLSourceTableCache {
+    private cache;
+    set(table: MSSQLSourceTable): void;
+    /**
+     *  Updates the underlying source table of the cached MSSQLSourceTable.
+     *  @param updatedTable
+     */
+    updateSourceTable(updatedTable: SourceTable): void;
+    get(tableId: number): MSSQLSourceTable | undefined;
+    getAll(): MSSQLSourceTable[];
+    delete(tableId: number): boolean;
+}

package/dist/common/MSSQLSourceTableCache.js

@@ -0,0 +1,28 @@
+import { ServiceAssertionError } from '@powersync/service-errors';
+export class MSSQLSourceTableCache {
+    cache = new Map();
+    set(table) {
+        this.cache.set(table.sourceTable.objectId, table);
+    }
+    /**
+     *  Updates the underlying source table of the cached MSSQLSourceTable.
+     *  @param updatedTable
+     */
+    updateSourceTable(updatedTable) {
+        const existingTable = this.cache.get(updatedTable.objectId);
+        if (!existingTable) {
+            throw new ServiceAssertionError('Tried to update a non-existing MSSQLSourceTable in the cache');
+        }
+        existingTable.updateSourceTable(updatedTable);
+    }
+    get(tableId) {
+        return this.cache.get(tableId);
+    }
+    getAll() {
+        return Array.from(this.cache.values());
+    }
+    delete(tableId) {
+        return this.cache.delete(tableId);
+    }
+}
+//# sourceMappingURL=MSSQLSourceTableCache.js.map

package/dist/common/MSSQLSourceTableCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MSSQLSourceTableCache.js","sourceRoot":"","sources":["../../src/common/MSSQLSourceTableCache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,OAAO,qBAAqB;IACxB,KAAK,GAAG,IAAI,GAAG,EAAqC,CAAC;IAE7D,GAAG,CAAC,KAAuB;QACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,QAAS,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,YAAyB;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,QAAS,CAAC,CAAC;QAE7D,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,qBAAqB,CAAC,8DAA8D,CAAC,CAAC;QAClG,CAAC;QACD,aAAa,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF"}