@powersync/service-core 0.0.0-dev-20240620165206

package/dist/auth/SupabaseKeyCollector.js

@@ -0,0 +1,61 @@
+import * as jose from 'jose';
+import { connectPgWirePool, pgwireRows } from '@powersync/service-jpgwire';
+import { KeySpec } from './KeySpec.js';
+import { retriedQuery } from '../util/pgwire_utils.js';
+/**
+ * Fetches key from the Supabase database.
+ *
+ * Unfortunately, despite the JWTs containing a kid, we have no way to lookup that kid
+ * before receiving a valid token.
+ */
+export class SupabaseKeyCollector {
+    constructor(connection) {
+        this.keyOptions = {
+            requiresAudience: ['authenticated'],
+            maxLifetimeSeconds: 86400 * 7 + 1200 // 1 week + 20 minutes margin
+        };
+        this.pool = connectPgWirePool(connection, {
+            // To avoid overloading the source database with open connections,
+            // limit to a single connection, and close the connection shortly
+            // after using it.
+            idleTimeout: 5000,
+            maxSize: 1
+        });
+    }
+    async getKeys() {
+        let row;
+        try {
+            const rows = pgwireRows(await retriedQuery(this.pool, `SELECT current_setting('app.settings.jwt_secret') as jwt_secret`));
+            row = rows[0];
+        }
+        catch (e) {
+            if (e.message?.includes('unrecognized configuration parameter')) {
+                throw new jose.errors.JOSEError(`Generate a new JWT secret on Supabase. Cause: ${e.message}`);
+            }
+            else {
+                throw e;
+            }
+        }
+        const secret = row?.jwt_secret;
+        if (secret == null) {
+            return {
+                keys: [],
+                errors: [new jose.errors.JWKSNoMatchingKey()]
+            };
+        }
+        else {
+            const key = {
+                kty: 'oct',
+                alg: 'HS256',
+                // While the secret is valid base64, the base64-encoded form is the secret value.
+                k: Buffer.from(secret, 'utf8').toString('base64url')
+            };
+            const imported = await KeySpec.importKey(key, this.keyOptions);
+            return {
+                keys: [imported],
+                errors: []
+            };
+        }
+    }
+}
+//# sourceMappingURL=SupabaseKeyCollector.js.map

package/dist/auth/SupabaseKeyCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupabaseKeyCollector.js","sourceRoot":"","sources":["../../src/auth/SupabaseKeyCollector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAc,OAAO,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAQ/B,YAAY,UAA8B;QALlC,eAAU,GAAe;YAC/B,gBAAgB,EAAE,CAAC,eAAe,CAAC;YACnC,kBAAkB,EAAE,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,6BAA6B;SACnE,CAAC;QAGA,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,UAAU,EAAE;YACxC,kEAAkE;YAClE,iEAAiE;YACjE,kBAAkB;YAClB,WAAW,EAAE,IAAK;YAClB,OAAO,EAAE,CAAC;SACX,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,GAA2B,CAAC;QAChC,IAAI;YACF,MAAM,IAAI,GAAG,UAAU,CACrB,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,iEAAiE,CAAC,CACjG,CAAC;YACF,GAAG,GAAG,IAAI,CAAC,CAAC,CAAQ,CAAC;SACtB;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,sCAAsC,CAAC,EAAE;gBAC/D,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,iDAAiD,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;aAC/F;iBAAM;gBACL,MAAM,CAAC,CAAC;aACT;SACF;QACD,MAAM,MAAM,GAAG,GAAG,EAAE,UAAgC,CAAC;QACrD,IAAI,MAAM,IAAI,IAAI,EAAE;YAClB,OAAO;gBACL,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;aAC9C,CAAC;SACH;aAAM;YACL,MAAM,GAAG,GAAa;gBACpB,GAAG,EAAE,KAAK;gBACV,GAAG,EAAE,OAAO;gBACZ,iFAAiF;gBACjF,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;aACrD,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/D,OAAO;gBACL,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,MAAM,EAAE,EAAE;aACX,CAAC;SACH;IACH,CAAC;CACF"}

package/dist/auth/auth-index.d.ts

@@ -0,0 +1,10 @@
+export * from './CachedKeyCollector.js';
+export * from './CompoundKeyCollector.js';
+export * from './JwtPayload.js';
+export * from './KeyCollector.js';
+export * from './KeySpec.js';
+export * from './KeyStore.js';
+export * from './LeakyBucket.js';
+export * from './RemoteJWKSCollector.js';
+export * from './StaticKeyCollector.js';
+export * from './SupabaseKeyCollector.js';

package/dist/auth/auth-index.js

@@ -0,0 +1,11 @@
+export * from './CachedKeyCollector.js';
+export * from './CompoundKeyCollector.js';
+export * from './JwtPayload.js';
+export * from './KeyCollector.js';
+export * from './KeySpec.js';
+export * from './KeyStore.js';
+export * from './LeakyBucket.js';
+export * from './RemoteJWKSCollector.js';
+export * from './StaticKeyCollector.js';
+export * from './SupabaseKeyCollector.js';
+//# sourceMappingURL=auth-index.js.map

package/dist/auth/auth-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-index.js","sourceRoot":"","sources":["../../src/auth/auth-index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/db/db-index.d.ts

@@ -0,0 +1 @@
+export * as mongo from './mongo.js';

package/dist/db/db-index.js

@@ -0,0 +1,2 @@
+export * as mongo from './mongo.js';
+//# sourceMappingURL=db-index.js.map

package/dist/db/db-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-index.js","sourceRoot":"","sources":["../../src/db/db-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC"}

package/dist/db/mongo.d.ts

@@ -0,0 +1,29 @@
+import * as mongo from 'mongodb';
+import { configFile } from '@powersync/service-types';
+/**
+ * Time for new connection to timeout.
+ */
+export declare const MONGO_CONNECT_TIMEOUT_MS = 10000;
+/**
+ * Time for individual requests to timeout the socket.
+ */
+export declare const MONGO_SOCKET_TIMEOUT_MS = 60000;
+/**
+ * Time for individual requests to timeout the operation.
+ *
+ * This is time spent on the cursor, not total time.
+ *
+ * Must be less than MONGO_SOCKET_TIMEOUT_MS to ensure proper error handling.
+ */
+export declare const MONGO_OPERATION_TIMEOUT_MS = 30000;
+export declare function createMongoClient(config: configFile.PowerSyncConfig['storage']): mongo.MongoClient;
+/**
+ * Wait up to a minute for authentication errors to resolve.
+ *
+ * There can be a delay between an Atlas user being created, and that user being
+ * available on the database cluster. This works around it.
+ *
+ * This is specifically relevant for migrations and teardown - other parts of the stack
+ * can generate handle these failures and just retry or restart.
+ */
+export declare function waitForAuth(db: mongo.Db): Promise<void>;

package/dist/db/mongo.js

@@ -0,0 +1,65 @@
+import * as mongo from 'mongodb';
+import * as timers from 'timers/promises';
+/**
+ * Time for new connection to timeout.
+ */
+export const MONGO_CONNECT_TIMEOUT_MS = 10000;
+/**
+ * Time for individual requests to timeout the socket.
+ */
+export const MONGO_SOCKET_TIMEOUT_MS = 60000;
+/**
+ * Time for individual requests to timeout the operation.
+ *
+ * This is time spent on the cursor, not total time.
+ *
+ * Must be less than MONGO_SOCKET_TIMEOUT_MS to ensure proper error handling.
+ */
+export const MONGO_OPERATION_TIMEOUT_MS = 30000;
+export function createMongoClient(config) {
+    return new mongo.MongoClient(config.uri, {
+        auth: {
+            username: config.username,
+            password: config.password
+        },
+        // Time for connection to timeout
+        connectTimeoutMS: MONGO_CONNECT_TIMEOUT_MS,
+        // Time for individual requests to timeout
+        socketTimeoutMS: MONGO_SOCKET_TIMEOUT_MS,
+        // How long to wait for new primary selection
+        serverSelectionTimeoutMS: 30000,
+        // Avoid too many connections:
+        // 1. It can overwhelm the source database.
+        // 2. Processing too many queries in parallel can cause the process to run out of memory.
+        maxPoolSize: 8,
+        maxConnecting: 3,
+        maxIdleTimeMS: 60000
+    });
+}
+/**
+ * Wait up to a minute for authentication errors to resolve.
+ *
+ * There can be a delay between an Atlas user being created, and that user being
+ * available on the database cluster. This works around it.
+ *
+ * This is specifically relevant for migrations and teardown - other parts of the stack
+ * can generate handle these failures and just retry or restart.
+ */
+export async function waitForAuth(db) {
+    const start = Date.now();
+    while (Date.now() - start < 60000) {
+        try {
+            await db.command({ ping: 1 });
+            // Success
+            break;
+        }
+        catch (e) {
+            if (e.codeName == 'AuthenticationFailed') {
+                await timers.setTimeout(1000);
+                continue;
+            }
+            throw e;
+        }
+    }
+}
+//# sourceMappingURL=mongo.js.map

package/dist/db/mongo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.js","sourceRoot":"","sources":["../../src/db/mongo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAI1C;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAM,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAM,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAM,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,MAA6C;IAC7E,OAAO,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE;QACvC,IAAI,EAAE;YACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B;QACD,iCAAiC;QACjC,gBAAgB,EAAE,wBAAwB;QAC1C,0CAA0C;QAC1C,eAAe,EAAE,uBAAuB;QACxC,6CAA6C;QAC7C,wBAAwB,EAAE,KAAM;QAEhC,8BAA8B;QAC9B,2CAA2C;QAC3C,yFAAyF;QACzF,WAAW,EAAE,CAAC;QAEd,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,KAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAY;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,KAAM,EAAE;QAClC,IAAI;YACF,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9B,UAAU;YACV,MAAM;SACP;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,CAAC,QAAQ,IAAI,sBAAsB,EAAE;gBACxC,MAAM,MAAM,CAAC,UAAU,CAAC,IAAK,CAAC,CAAC;gBAC/B,SAAS;aACV;YACD,MAAM,CAAC,CAAC;SACT;KACF;AACH,CAAC"}

package/dist/entry/cli-entry.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+import * as utils from '../util/util-index.js';
+/**
+ * Generates a Commander program which serves as the entry point
+ * for the PowerSync service.
+ * This registers standard actions for teardown and migrations.
+ * Optionally registers the start command handlers.
+ */
+export declare function generateEntryProgram(startHandlers?: Record<utils.ServiceRunner, utils.Runner>): {
+    program: Command;
+    /**
+     * Executes the main program. Ends the NodeJS process if an exception was caught.
+     */
+    execute: () => Promise<void>;
+};

package/dist/entry/cli-entry.js

@@ -0,0 +1,36 @@
+import { Command } from 'commander';
+import { registerMigrationAction } from './commands/migrate-action.js';
+import { registerTearDownAction } from './commands/teardown-action.js';
+import { registerStartAction } from './entry-index.js';
+import { logger } from '@powersync/lib-services-framework';
+/**
+ * Generates a Commander program which serves as the entry point
+ * for the PowerSync service.
+ * This registers standard actions for teardown and migrations.
+ * Optionally registers the start command handlers.
+ */
+export function generateEntryProgram(startHandlers) {
+    const entryProgram = new Command();
+    entryProgram.name('powersync-runner').description('CLI to initiate a PowerSync service runner');
+    registerTearDownAction(entryProgram);
+    registerMigrationAction(entryProgram);
+    if (startHandlers) {
+        registerStartAction(entryProgram, startHandlers);
+    }
+    return {
+        program: entryProgram,
+        /**
+         * Executes the main program. Ends the NodeJS process if an exception was caught.
+         */
+        execute: async function runProgram() {
+            try {
+                await entryProgram.parseAsync();
+            }
+            catch (e) {
+                logger.error('Fatal error', e);
+                process.exit(1);
+            }
+        }
+    };
+}
+//# sourceMappingURL=cli-entry.js.map

package/dist/entry/cli-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-entry.js","sourceRoot":"","sources":["../../src/entry/cli-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAyD;IAC5F,MAAM,YAAY,GAAG,IAAI,OAAO,EAAE,CAAC;IACnC,YAAY,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,4CAA4C,CAAC,CAAC;IAEhG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACrC,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAEtC,IAAI,aAAa,EAAE;QACjB,mBAAmB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;KAClD;IAED,OAAO;QACL,OAAO,EAAE,YAAY;QACrB;;WAEG;QACH,OAAO,EAAE,KAAK,UAAU,UAAU;YAChC,IAAI;gBACF,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;aACjC;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aACjB;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/entry/commands/config-command.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+import * as util from '../../util/util-index.js';
+/**
+ * Wraps a Command with the standard config options
+ */
+export declare function wrapConfigCommand(command: Command): Command;
+/**
+ * Extracts runner configuration params from Command options.
+ */
+export declare function extractRunnerOptions(options: any): util.RunnerConfig;

package/dist/entry/commands/config-command.js

@@ -0,0 +1,21 @@
+import * as util from '../../util/util-index.js';
+/**
+ * Wraps a Command with the standard config options
+ */
+export function wrapConfigCommand(command) {
+    return command
+        .option(`-c, --config-path [path]`, 'Path (inside container) to YAML config file. Defaults to process.env.POWERSYNC_CONFIG_PATH', util.env.POWERSYNC_CONFIG_PATH)
+        .option(`-c64, --config-base64 [base64]`, 'Base64 encoded YAML or JSON config file. Defaults to process.env.POWERSYNC_CONFIG_B64', util.env.POWERSYNC_CONFIG_B64)
+        .option(`-sync64, --sync-base64 [base64]`, 'Base64 encoded YAML Sync Rules. Defaults to process.env.POWERSYNC_SYNC_RULES_B64', util.env.POWERSYNC_SYNC_RULES_B64);
+}
+/**
+ * Extracts runner configuration params from Command options.
+ */
+export function extractRunnerOptions(options) {
+    return {
+        config_path: options.configPath,
+        config_base64: options.configBase64,
+        sync_rules_base64: options.syncBase64
+    };
+}
+//# sourceMappingURL=config-command.js.map

package/dist/entry/commands/config-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-command.js","sourceRoot":"","sources":["../../../src/entry/commands/config-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO,OAAO;SACX,MAAM,CACL,0BAA0B,EAC1B,4FAA4F,EAC5F,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAC/B;SACA,MAAM,CACL,gCAAgC,EAChC,uFAAuF,EACvF,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAC9B;SACA,MAAM,CACL,iCAAiC,EACjC,kFAAkF,EAClF,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAClC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAY;IAC/C,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,UAAU;QAC/B,aAAa,EAAE,OAAO,CAAC,YAAY;QACnC,iBAAiB,EAAE,OAAO,CAAC,UAAU;KACtC,CAAC;AACJ,CAAC"}

package/dist/entry/commands/migrate-action.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerMigrationAction(program: Command): Command;

package/dist/entry/commands/migrate-action.js

@@ -0,0 +1,18 @@
+import { extractRunnerOptions, wrapConfigCommand } from './config-command.js';
+import { migrate } from '../../migrations/migrations.js';
+const COMMAND_NAME = 'migrate';
+export function registerMigrationAction(program) {
+    const migrationCommand = program.command(COMMAND_NAME);
+    wrapConfigCommand(migrationCommand);
+    return migrationCommand
+        .description('Run migrations')
+        .argument('<direction>', 'Migration direction. `up` or `down`')
+        .action(async (direction, options) => {
+        const runnerConfig = extractRunnerOptions(options);
+        await migrate({
+            direction,
+            runner_config: runnerConfig
+        });
+    });
+}
+//# sourceMappingURL=migrate-action.js.map

package/dist/entry/commands/migrate-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-action.js","sourceRoot":"","sources":["../../../src/entry/commands/migrate-action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAGzD,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEvD,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAEpC,OAAO,gBAAgB;SACpB,WAAW,CAAC,gBAAgB,CAAC;SAC7B,QAAQ,CAAC,aAAa,EAAE,qCAAqC,CAAC;SAC9D,MAAM,CAAC,KAAK,EAAE,SAAoB,EAAE,OAAO,EAAE,EAAE;QAC9C,MAAM,YAAY,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEnD,MAAM,OAAO,CAAC;YACZ,SAAS;YACT,aAAa,EAAE,YAAY;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/entry/commands/start-action.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import * as utils from '../../util/util-index.js';
+export declare function registerStartAction(program: Command, handlers: Record<utils.ServiceRunner, utils.Runner>): Command;

package/dist/entry/commands/start-action.js

@@ -0,0 +1,15 @@
+import * as utils from '../../util/util-index.js';
+import { extractRunnerOptions, wrapConfigCommand } from './config-command.js';
+const COMMAND_NAME = 'start';
+export function registerStartAction(program, handlers) {
+    const startCommand = program.command(COMMAND_NAME);
+    wrapConfigCommand(startCommand);
+    return startCommand
+        .description('Starts a PowerSync service runner.')
+        .option(`-r, --runner-type [${Object.values(utils.ServiceRunner).join('|')}]`, 'Type of runner to start. Defaults to unified runner.', utils.env.PS_RUNNER_TYPE)
+        .action(async (options) => {
+        const runner = handlers[options.runnerType];
+        await runner(extractRunnerOptions(options));
+    });
+}
+//# sourceMappingURL=start-action.js.map

package/dist/entry/commands/start-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-action.js","sourceRoot":"","sources":["../../../src/entry/commands/start-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,YAAY,GAAG,OAAO,CAAC;AAE7B,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,QAAmD;IACvG,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnD,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAEhC,OAAO,YAAY;SAChB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CACL,sBAAsB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EACrE,sDAAsD,EACtD,KAAK,CAAC,GAAG,CAAC,cAAc,CACzB;SACA,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAiC,CAAC,CAAC;QACnE,MAAM,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/entry/commands/teardown-action.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerTearDownAction(program: Command): Command;

package/dist/entry/commands/teardown-action.js

@@ -0,0 +1,17 @@
+import { extractRunnerOptions, wrapConfigCommand } from './config-command.js';
+import { teardown } from '../../runner/teardown.js';
+const COMMAND_NAME = 'teardown';
+export function registerTearDownAction(program) {
+    const teardownCommand = program.command(COMMAND_NAME);
+    wrapConfigCommand(teardownCommand);
+    return teardownCommand
+        .argument('[ack]', 'Type `TEARDOWN` to confirm teardown should occur')
+        .description('Terminate all replicating sync rules, deleting the replication slots')
+        .action(async (ack, options) => {
+        if (ack !== 'TEARDOWN') {
+            throw new Error('TEARDOWN was not acknowledged.');
+        }
+        await teardown(extractRunnerOptions(options));
+    });
+}
+//# sourceMappingURL=teardown-action.js.map

package/dist/entry/commands/teardown-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teardown-action.js","sourceRoot":"","sources":["../../../src/entry/commands/teardown-action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtD,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAEnC,OAAO,eAAe;SACnB,QAAQ,CAAC,OAAO,EAAE,kDAAkD,CAAC;SACrE,WAAW,CAAC,sEAAsE,CAAC;SACnF,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;QAC7B,IAAI,GAAG,KAAK,UAAU,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;SACnD;QAED,MAAM,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/entry/entry-index.d.ts

@@ -0,0 +1,5 @@
+export * from './cli-entry.js';
+export * from './commands/config-command.js';
+export * from './commands/migrate-action.js';
+export * from './commands/start-action.js';
+export * from './commands/teardown-action.js';

package/dist/entry/entry-index.js

@@ -0,0 +1,6 @@
+export * from './cli-entry.js';
+export * from './commands/config-command.js';
+export * from './commands/migrate-action.js';
+export * from './commands/start-action.js';
+export * from './commands/teardown-action.js';
+//# sourceMappingURL=entry-index.js.map

package/dist/entry/entry-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-index.js","sourceRoot":"","sources":["../../src/entry/entry-index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export * from './api/api-index.js';
+export * as api from './api/api-index.js';
+export * from './auth/auth-index.js';
+export * as auth from './auth/auth-index.js';
+export * from './db/db-index.js';
+export * as db from './db/db-index.js';
+export * from './entry/entry-index.js';
+export * as entry from './entry/entry-index.js';
+export * as framework from '@powersync/lib-services-framework';
+export * from './metrics/Metrics.js';
+export * as metrics from './metrics/Metrics.js';
+export * from './migrations/migrations.js';
+export * as migrations from './migrations/migrations-index.js';
+export * from './replication/replication-index.js';
+export * as replication from './replication/replication-index.js';
+export * from './routes/routes-index.js';
+export * as routes from './routes/routes-index.js';
+export * from './storage/storage-index.js';
+export * as storage from './storage/storage-index.js';
+export * from './sync/sync-index.js';
+export * as sync from './sync/sync-index.js';
+export * from './system/CorePowerSyncSystem.js';
+export * as system from './system/system-index.js';
+export * from './util/util-index.js';
+export * as utils from './util/util-index.js';

package/dist/index.js

@@ -0,0 +1,28 @@
+// Provides global and namespaced exports
+export * from './api/api-index.js';
+export * as api from './api/api-index.js';
+export * from './auth/auth-index.js';
+export * as auth from './auth/auth-index.js';
+export * from './db/db-index.js';
+export * as db from './db/db-index.js';
+export * from './entry/entry-index.js';
+export * as entry from './entry/entry-index.js';
+// Re-export framework for easy use of Container API
+export * as framework from '@powersync/lib-services-framework';
+export * from './metrics/Metrics.js';
+export * as metrics from './metrics/Metrics.js';
+export * from './migrations/migrations.js';
+export * as migrations from './migrations/migrations-index.js';
+export * from './replication/replication-index.js';
+export * as replication from './replication/replication-index.js';
+export * from './routes/routes-index.js';
+export * as routes from './routes/routes-index.js';
+export * from './storage/storage-index.js';
+export * as storage from './storage/storage-index.js';
+export * from './sync/sync-index.js';
+export * as sync from './sync/sync-index.js';
+export * from './system/CorePowerSyncSystem.js';
+export * as system from './system/system-index.js';
+export * from './util/util-index.js';
+export * as utils from './util/util-index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAC;AAE1C,cAAc,sBAAsB,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,sBAAsB,CAAC;AAE7C,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,cAAc,wBAAwB,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAEhD,oDAAoD;AACpD,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAE/D,cAAc,sBAAsB,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAEhD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,KAAK,UAAU,MAAM,kCAAkC,CAAC;AAE/D,cAAc,oCAAoC,CAAC;AACnD,OAAO,KAAK,WAAW,MAAM,oCAAoC,CAAC;AAElE,cAAc,0BAA0B,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AAEnD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,KAAK,OAAO,MAAM,4BAA4B,CAAC;AAEtD,cAAc,sBAAsB,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,sBAAsB,CAAC;AAE7C,cAAc,iCAAiC,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AAEnD,cAAc,sBAAsB,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC"}

package/dist/locks/LockManager.d.ts

@@ -0,0 +1,10 @@
+import * as bson from 'bson';
+export declare class LockActiveError extends Error {
+    constructor();
+}
+export type LockManager = {
+    acquire: () => Promise<bson.ObjectId | null>;
+    refresh: (lock_id: bson.ObjectId) => Promise<void>;
+    release: (lock_id: bson.ObjectId) => Promise<void>;
+    lock: (handler: (refresh: () => Promise<void>) => Promise<void>) => Promise<void>;
+};

package/dist/locks/LockManager.js

@@ -0,0 +1,7 @@
+export class LockActiveError extends Error {
+    constructor() {
+        super('Lock is already active');
+        this.name = this.constructor.name;
+    }
+}
+//# sourceMappingURL=LockManager.js.map

package/dist/locks/LockManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockManager.js","sourceRoot":"","sources":["../../src/locks/LockManager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC;QACE,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;CACF"}

package/dist/locks/MongoLocks.d.ts

@@ -0,0 +1,36 @@
+import * as mongo from 'mongodb';
+import * as bson from 'bson';
+import { LockManager } from './LockManager.js';
+/**
+ * Lock Document Schema
+ */
+export type Lock = {
+    name: string;
+    active_lock?: {
+        lock_id: bson.ObjectId;
+        ts: Date;
+    };
+};
+export type Collection = mongo.Collection<Lock>;
+export type AcquireLockParams = {
+    /**
+     * Name of the process/user trying to acquire the lock.
+     */
+    name: string;
+    /**
+     * The TTL of the lock (ms). Default: 60000 ms (1 min)
+     */
+    timeout?: number;
+};
+export declare const releaseLock: (collection: Collection, lock_id: bson.ObjectId) => Promise<void>;
+export type CreateLockManagerParams = {
+    /**
+     * Name of the process/user trying to acquire the lock.
+     */
+    name: string;
+    /**
+     * The TTL for each lock (ms). Default: 60000 ms (1 min)
+     */
+    timeout?: number;
+};
+export declare const createMongoLockManager: (collection: Collection, params: CreateLockManagerParams) => LockManager;

package/dist/locks/MongoLocks.js

@@ -0,0 +1,81 @@
+import * as bson from 'bson';
+import { LockActiveError } from './LockManager.js';
+const DEFAULT_LOCK_TIMEOUT = 60 * 1000; // 1 minute
+const acquireLock = async (collection, params) => {
+    const now = new Date();
+    const lock_timeout = params.timeout ?? DEFAULT_LOCK_TIMEOUT;
+    const lock_id = new bson.ObjectId();
+    await collection.updateOne({
+        name: params.name
+    }, {
+        $setOnInsert: {
+            name: params.name
+        }
+    }, {
+        upsert: true
+    });
+    const expired_ts = now.getTime() - lock_timeout;
+    const res = await collection.updateOne({
+        $and: [
+            { name: params.name },
+            {
+                $or: [{ active_lock: { $exists: false } }, { 'active_lock.ts': { $lte: new Date(expired_ts) } }]
+            }
+        ]
+    }, {
+        $set: {
+            active_lock: {
+                lock_id: lock_id,
+                ts: now
+            }
+        }
+    });
+    if (res.modifiedCount === 0) {
+        return null;
+    }
+    return lock_id;
+};
+const refreshLock = async (collection, lock_id) => {
+    const res = await collection.updateOne({
+        'active_lock.lock_id': lock_id
+    }, {
+        $set: {
+            'active_lock.ts': new Date()
+        }
+    });
+    if (res.modifiedCount === 0) {
+        throw new Error('Lock not found, could not refresh');
+    }
+};
+export const releaseLock = async (collection, lock_id) => {
+    const res = await collection.updateOne({
+        'active_lock.lock_id': lock_id
+    }, {
+        $unset: {
+            active_lock: true
+        }
+    });
+    if (res.modifiedCount === 0) {
+        throw new Error('Lock not found, could not release');
+    }
+};
+export const createMongoLockManager = (collection, params) => {
+    return {
+        acquire: () => acquireLock(collection, params),
+        refresh: (lock_id) => refreshLock(collection, lock_id),
+        release: (lock_id) => releaseLock(collection, lock_id),
+        lock: async (handler) => {
+            const lock_id = await acquireLock(collection, params);
+            if (!lock_id) {
+                throw new LockActiveError();
+            }
+            try {
+                await handler(() => refreshLock(collection, lock_id));
+            }
+            finally {
+                await releaseLock(collection, lock_id);
+            }
+        }
+    };
+};
+//# sourceMappingURL=MongoLocks.js.map

package/dist/locks/MongoLocks.js.map

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

package/dist/locks/locks-index.d.ts

@@ -0,0 +1,2 @@
+export * from './LockManager.js';
+export * from './MongoLocks.js';

package/dist/locks/locks-index.js

@@ -0,0 +1,3 @@
+export * from './LockManager.js';
+export * from './MongoLocks.js';
+//# sourceMappingURL=locks-index.js.map

package/dist/locks/locks-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks-index.js","sourceRoot":"","sources":["../../src/locks/locks-index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}