@powersync/service-core 0.0.0-dev-20240620165206

package/dist/util/config/compound-config-collector.js

@@ -0,0 +1,130 @@
+import { normalizeConnection } from '@powersync/service-types';
+import * as auth from '../../auth/auth-index.js';
+import { Base64ConfigCollector } from './collectors/impl/base64-config-collector.js';
+import { FileSystemConfigCollector } from './collectors/impl/filesystem-config-collector.js';
+import { Base64SyncRulesCollector } from './sync-rules/impl/base64-sync-rules-collector.js';
+import { InlineSyncRulesCollector } from './sync-rules/impl/inline-sync-rules-collector.js';
+import { FileSystemSyncRulesCollector } from './sync-rules/impl/filesystem-sync-rules-collector.js';
+import { FallbackConfigCollector } from './collectors/impl/fallback-config-collector.js';
+import { logger } from '@powersync/lib-services-framework';
+const POWERSYNC_DEV_KID = 'powersync-dev';
+const DEFAULT_COLLECTOR_OPTIONS = {
+    configCollectors: [new Base64ConfigCollector(), new FileSystemConfigCollector(), new FallbackConfigCollector()],
+    syncRulesCollectors: [
+        new Base64SyncRulesCollector(),
+        new FileSystemSyncRulesCollector(),
+        new InlineSyncRulesCollector()
+    ]
+};
+export class CompoundConfigCollector {
+    constructor(options = DEFAULT_COLLECTOR_OPTIONS) {
+        this.options = options;
+    }
+    /**
+     * Collects and resolves base config
+     */
+    async collectConfig(runner_config = {}) {
+        const baseConfig = await this.collectBaseConfig(runner_config);
+        const connections = baseConfig.replication?.connections ?? [];
+        if (connections.length > 1) {
+            throw new Error('Only a single replication connection is supported currently');
+        }
+        const mapped = connections.map((c) => {
+            const conf = {
+                type: 'postgresql',
+                ...normalizeConnection(c),
+                debug_api: c.debug_api ?? false
+            };
+            return conf;
+        });
+        const collectors = new auth.CompoundKeyCollector();
+        const keyStore = new auth.KeyStore(collectors);
+        const inputKeys = baseConfig.client_auth?.jwks?.keys ?? [];
+        const staticCollector = await auth.StaticKeyCollector.importKeys(inputKeys);
+        collectors.add(staticCollector);
+        if (baseConfig.client_auth?.supabase && mapped.length > 0) {
+            collectors.add(new auth.CachedKeyCollector(new auth.SupabaseKeyCollector(mapped[0])));
+        }
+        let jwks_uris = baseConfig.client_auth?.jwks_uri ?? [];
+        if (typeof jwks_uris == 'string') {
+            jwks_uris = [jwks_uris];
+        }
+        for (let uri of jwks_uris) {
+            collectors.add(new auth.CachedKeyCollector(new auth.RemoteJWKSCollector(uri, { block_local_ip: !!baseConfig.client_auth?.block_local_jwks })));
+        }
+        const baseDevKey = (baseConfig.client_auth?.jwks?.keys ?? []).find((key) => key.kid == POWERSYNC_DEV_KID);
+        let devKey;
+        if (baseConfig.dev?.demo_auth && baseDevKey != null && baseDevKey.kty == 'oct') {
+            devKey = await auth.KeySpec.importKey(baseDevKey);
+        }
+        const sync_rules = await this.collectSyncRules(baseConfig, runner_config);
+        let jwt_audiences = baseConfig.client_auth?.audience ?? [];
+        let config = {
+            connection: mapped[0],
+            storage: baseConfig.storage,
+            client_keystore: keyStore,
+            // Dev tokens only use the static keys, no external key sources
+            // We may restrict this even further to only the powersync-dev key.
+            dev_client_keystore: new auth.KeyStore(staticCollector),
+            api_tokens: baseConfig.api?.tokens ?? [],
+            dev: {
+                demo_auth: baseConfig.dev?.demo_auth ?? false,
+                demo_client: baseConfig.dev?.demo_client ?? false,
+                demo_password: baseConfig.dev?.demo_password,
+                crud_api: baseConfig.dev?.crud_api ?? false,
+                dev_key: devKey
+            },
+            port: baseConfig.port ?? 8080,
+            sync_rules,
+            jwt_audiences,
+            token_max_expiration: '1d',
+            metadata: baseConfig.metadata ?? {},
+            migrations: baseConfig.migrations,
+            telemetry: {
+                disable_telemetry_sharing: baseConfig.telemetry?.disable_telemetry_sharing ?? false,
+                internal_service_endpoint: baseConfig.telemetry?.internal_service_endpoint ?? 'https://pulse.journeyapps.com/v1/metrics'
+            },
+            slot_name_prefix: connections[0]?.slot_name_prefix ?? 'powersync_'
+        };
+        return config;
+    }
+    /**
+     * Collects the base PowerSyncConfig from various registered collectors.
+     * @throws if no collector could return a configuration.
+     */
+    async collectBaseConfig(runner_config) {
+        for (const collector of this.options.configCollectors) {
+            try {
+                const baseConfig = await collector.collect(runner_config);
+                if (baseConfig) {
+                    return baseConfig;
+                }
+                logger.debug(`Could not collect PowerSync config with ${collector.name} method. Moving on to next method if available.`);
+            }
+            catch (ex) {
+                // An error in a collector is a hard stop
+                throw new Error(`Could not collect config using ${collector.name} method. Caught exception: ${ex}`);
+            }
+        }
+        throw new Error('PowerSyncConfig could not be collected using any of the registered config collectors.');
+    }
+    async collectSyncRules(baseConfig, runnerConfig) {
+        for (const collector of this.options.syncRulesCollectors) {
+            try {
+                const config = await collector.collect(baseConfig, runnerConfig);
+                if (config) {
+                    return config;
+                }
+                logger.debug(`Could not collect sync rules with ${collector.name} method. Moving on to next method if available.`);
+            }
+            catch (ex) {
+                // An error in a collector is a hard stop
+                throw new Error(`Could not collect sync rules using ${collector.name} method. Caught exception: ${ex}`);
+            }
+        }
+        return {
+            present: false
+        };
+    }
+}
+//# sourceMappingURL=compound-config-collector.js.map

package/dist/util/config/compound-config-collector.js.map

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

package/dist/util/config/sync-rules/impl/base64-sync-rules-collector.d.ts

@@ -0,0 +1,7 @@
+import { RunnerConfig, SyncRulesConfig } from '../../types.js';
+import { SyncRulesCollector } from '../sync-collector.js';
+import { configFile } from '@powersync/service-types';
+export declare class Base64SyncRulesCollector extends SyncRulesCollector {
+    get name(): string;
+    collect(baseConfig: configFile.PowerSyncConfig, runnerConfig: RunnerConfig): Promise<SyncRulesConfig | null>;
+}

package/dist/util/config/sync-rules/impl/base64-sync-rules-collector.js

@@ -0,0 +1,17 @@
+import { SyncRulesCollector } from '../sync-collector.js';
+export class Base64SyncRulesCollector extends SyncRulesCollector {
+    get name() {
+        return 'Base64';
+    }
+    async collect(baseConfig, runnerConfig) {
+        const { sync_rules_base64 } = runnerConfig;
+        if (!sync_rules_base64) {
+            return null;
+        }
+        return {
+            present: true,
+            content: Buffer.from(sync_rules_base64, 'base64').toString()
+        };
+    }
+}
+//# sourceMappingURL=base64-sync-rules-collector.js.map

package/dist/util/config/sync-rules/impl/base64-sync-rules-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64-sync-rules-collector.js","sourceRoot":"","sources":["../../../../../src/util/config/sync-rules/impl/base64-sync-rules-collector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,OAAO,wBAAyB,SAAQ,kBAAkB;IAC9D,IAAI,IAAI;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAsC,EAAE,YAA0B;QAC9E,MAAM,EAAE,iBAAiB,EAAE,GAAG,YAAY,CAAC;QAC3C,IAAI,CAAC,iBAAiB,EAAE;YACtB,OAAO,IAAI,CAAC;SACb;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE;SAC7D,CAAC;IACJ,CAAC;CACF"}

package/dist/util/config/sync-rules/impl/filesystem-sync-rules-collector.d.ts

@@ -0,0 +1,7 @@
+import { RunnerConfig, SyncRulesConfig } from '../../types.js';
+import { SyncRulesCollector } from '../sync-collector.js';
+import { configFile } from '@powersync/service-types';
+export declare class FileSystemSyncRulesCollector extends SyncRulesCollector {
+    get name(): string;
+    collect(baseConfig: configFile.PowerSyncConfig, runnerConfig: RunnerConfig): Promise<SyncRulesConfig | null>;
+}

package/dist/util/config/sync-rules/impl/filesystem-sync-rules-collector.js

@@ -0,0 +1,21 @@
+import * as path from 'path';
+import { SyncRulesCollector } from '../sync-collector.js';
+export class FileSystemSyncRulesCollector extends SyncRulesCollector {
+    get name() {
+        return 'FileSystem';
+    }
+    async collect(baseConfig, runnerConfig) {
+        const sync_path = baseConfig.sync_rules?.path;
+        if (!sync_path) {
+            return null;
+        }
+        const { config_path } = runnerConfig;
+        // Depending on the container, the sync rules may not actually be present.
+        // Only persist the path here, and load on demand using `loadSyncRules()`.
+        return {
+            present: true,
+            path: config_path ? path.resolve(path.dirname(config_path), sync_path) : sync_path
+        };
+    }
+}
+//# sourceMappingURL=filesystem-sync-rules-collector.js.map

package/dist/util/config/sync-rules/impl/filesystem-sync-rules-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-sync-rules-collector.js","sourceRoot":"","sources":["../../../../../src/util/config/sync-rules/impl/filesystem-sync-rules-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,OAAO,4BAA6B,SAAQ,kBAAkB;IAClE,IAAI,IAAI;QACN,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAsC,EAAE,YAA0B;QAC9E,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE;YACd,OAAO,IAAI,CAAC;SACb;QAED,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC;QAErC,0EAA0E;QAC1E,0EAA0E;QAC1E,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;SACnF,CAAC;IACJ,CAAC;CACF"}

package/dist/util/config/sync-rules/impl/inline-sync-rules-collector.d.ts

@@ -0,0 +1,7 @@
+import { SyncRulesConfig } from '../../types.js';
+import { SyncRulesCollector } from '../sync-collector.js';
+import { configFile } from '@powersync/service-types';
+export declare class InlineSyncRulesCollector extends SyncRulesCollector {
+    get name(): string;
+    collect(baseConfig: configFile.PowerSyncConfig): Promise<SyncRulesConfig | null>;
+}

package/dist/util/config/sync-rules/impl/inline-sync-rules-collector.js

@@ -0,0 +1,17 @@
+import { SyncRulesCollector } from '../sync-collector.js';
+export class InlineSyncRulesCollector extends SyncRulesCollector {
+    get name() {
+        return 'Inline';
+    }
+    async collect(baseConfig) {
+        const content = baseConfig.sync_rules?.content;
+        if (!content) {
+            return null;
+        }
+        return {
+            present: true,
+            ...baseConfig.sync_rules
+        };
+    }
+}
+//# sourceMappingURL=inline-sync-rules-collector.js.map

package/dist/util/config/sync-rules/impl/inline-sync-rules-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-sync-rules-collector.js","sourceRoot":"","sources":["../../../../../src/util/config/sync-rules/impl/inline-sync-rules-collector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,OAAO,wBAAyB,SAAQ,kBAAkB;IAC9D,IAAI,IAAI;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAsC;QAClD,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE;YACZ,OAAO,IAAI,CAAC;SACb;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,GAAG,UAAU,CAAC,UAAU;SACzB,CAAC;IACJ,CAAC;CACF"}

package/dist/util/config/sync-rules/sync-collector.d.ts

@@ -0,0 +1,6 @@
+import { configFile } from '@powersync/service-types';
+import { RunnerConfig, SyncRulesConfig } from '../types.js';
+export declare abstract class SyncRulesCollector {
+    abstract get name(): string;
+    abstract collect(baseConfig: configFile.PowerSyncConfig, runnerConfig: RunnerConfig): Promise<SyncRulesConfig | null>;
+}

package/dist/util/config/sync-rules/sync-collector.js

@@ -0,0 +1,3 @@
+export class SyncRulesCollector {
+}
+//# sourceMappingURL=sync-collector.js.map

package/dist/util/config/sync-rules/sync-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-collector.js","sourceRoot":"","sources":["../../../../src/util/config/sync-rules/sync-collector.ts"],"names":[],"mappings":"AAGA,MAAM,OAAgB,kBAAkB;CAIvC"}

package/dist/util/config/types.d.ts

@@ -0,0 +1,57 @@
+import { NormalizedPostgresConnection, configFile } from '@powersync/service-types';
+import { KeySpec } from '../../auth/KeySpec.js';
+import { KeyStore } from '../../auth/KeyStore.js';
+export declare enum ServiceRunner {
+    UNIFIED = "unified",
+    API = "api",
+    SYNC = "sync"
+}
+export type RunnerConfig = {
+    config_path?: string;
+    config_base64?: string;
+    sync_rules_base64?: string;
+};
+export type MigrationContext = {
+    runner_config: RunnerConfig;
+};
+export type Runner = (config: RunnerConfig) => Promise<void>;
+export type ResolvedConnection = configFile.PostgresConnection & NormalizedPostgresConnection;
+export type SyncRulesConfig = {
+    present: boolean;
+    content?: string;
+    path?: string;
+};
+export type ResolvedPowerSyncConfig = {
+    connection?: ResolvedConnection;
+    storage: configFile.StorageConfig;
+    dev: {
+        demo_auth: boolean;
+        demo_password?: string;
+        crud_api: boolean;
+        demo_client: boolean;
+        /**
+         * Only present when demo_auth == true
+         */
+        dev_key?: KeySpec;
+    };
+    client_keystore: KeyStore;
+    /**
+     * Keystore for development tokens.
+     */
+    dev_client_keystore: KeyStore;
+    port: number;
+    sync_rules: SyncRulesConfig;
+    api_tokens: string[];
+    jwt_audiences: string[];
+    token_max_expiration: string;
+    metadata: Record<string, string>;
+    migrations?: {
+        disable_auto_migration?: boolean;
+    };
+    telemetry: {
+        disable_telemetry_sharing: boolean;
+        internal_service_endpoint: string;
+    };
+    /** Prefix for postgres replication slot names. May eventually be connection-specific. */
+    slot_name_prefix: string;
+};

package/dist/util/config/types.js

@@ -0,0 +1,7 @@
+export var ServiceRunner;
+(function (ServiceRunner) {
+    ServiceRunner["UNIFIED"] = "unified";
+    ServiceRunner["API"] = "api";
+    ServiceRunner["SYNC"] = "sync";
+})(ServiceRunner || (ServiceRunner = {}));
+//# sourceMappingURL=types.js.map

package/dist/util/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/util/config/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,4BAAW,CAAA;IACX,8BAAa,CAAA;AACf,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB"}

package/dist/util/config.d.ts

@@ -0,0 +1,7 @@
+import { ResolvedConnection, ResolvedPowerSyncConfig, RunnerConfig } from './config/types.js';
+/**
+ * Build a single URI from full postgres credentials.
+ */
+export declare function buildDemoPgUri(options: ResolvedConnection): string;
+export declare function loadConfig(runnerConfig?: RunnerConfig): Promise<ResolvedPowerSyncConfig>;
+export declare function loadSyncRules(config: ResolvedPowerSyncConfig): Promise<string | undefined>;

package/dist/util/config.js

@@ -0,0 +1,35 @@
+import * as fs from 'fs/promises';
+import { baseUri } from '@powersync/service-types';
+import { CompoundConfigCollector } from './config/compound-config-collector.js';
+/**
+ * Build a single URI from full postgres credentials.
+ */
+export function buildDemoPgUri(options) {
+    if (!options.debug_api) {
+        throw new Error('Not supported');
+    }
+    const uri = new URL(baseUri(options));
+    uri.username = options.username;
+    uri.password = options.password;
+    if (options.sslmode != 'disable') {
+        // verify-full is tricky to actually use on a client, since they won't have the cert
+        // Just use "require" by default
+        // uri.searchParams.set('sslmode', options.sslmode);
+        uri.searchParams.set('sslmode', 'require');
+    }
+    return uri.toString();
+}
+export function loadConfig(runnerConfig = {}) {
+    const collector = new CompoundConfigCollector();
+    return collector.collectConfig(runnerConfig);
+}
+export async function loadSyncRules(config) {
+    const sync_rules = config.sync_rules;
+    if (sync_rules.content) {
+        return sync_rules.content;
+    }
+    else if (sync_rules.path) {
+        return await fs.readFile(sync_rules.path, 'utf-8');
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/util/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/util/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACxD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;QACtB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;KAClC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAChC,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAChC,IAAI,OAAO,CAAC,OAAO,IAAI,SAAS,EAAE;QAChC,oFAAoF;QACpF,gCAAgC;QAChC,oDAAoD;QACpD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;KAC5C;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,eAA6B,EAAE;IACxD,MAAM,SAAS,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAChD,OAAO,SAAS,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA+B;IACjE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IAAI,UAAU,CAAC,OAAO,EAAE;QACtB,OAAO,UAAU,CAAC,OAAO,CAAC;KAC3B;SAAM,IAAI,UAAU,CAAC,IAAI,EAAE;QAC1B,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;KACpD;AACH,CAAC"}

package/dist/util/env.d.ts

@@ -0,0 +1,9 @@
+export declare const env: {
+    PS_RUNNER_TYPE: string;
+    POWERSYNC_CONFIG_PATH?: string | undefined;
+    POWERSYNC_CONFIG_B64?: string | undefined;
+    POWERSYNC_SYNC_RULES_B64?: string | undefined;
+    METRICS_PORT?: number | undefined;
+    NODE_ENV?: string | undefined;
+};
+export type Env = typeof env;

package/dist/util/env.js

@@ -0,0 +1,26 @@
+import { utils } from '@powersync/lib-services-framework';
+import { ServiceRunner } from './config/types.js';
+export const env = utils.collectEnvironmentVariables({
+    /**
+     * Path to configuration file in filesystem
+     */
+    POWERSYNC_CONFIG_PATH: utils.type.string.optional(),
+    /**
+     * Base64 encoded contents of configuration file
+     */
+    POWERSYNC_CONFIG_B64: utils.type.string.optional(),
+    /**
+     * Base64 encoded contents of sync rules YAML
+     */
+    POWERSYNC_SYNC_RULES_B64: utils.type.string.optional(),
+    /**
+     * Runner to be started in this process
+     */
+    PS_RUNNER_TYPE: utils.type.string.default(ServiceRunner.UNIFIED),
+    /**
+     * Port for metrics
+     */
+    METRICS_PORT: utils.type.number.optional(),
+    NODE_ENV: utils.type.string.optional()
+});
+//# sourceMappingURL=env.js.map

package/dist/util/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/util/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,2BAA2B,CAAC;IACnD;;OAEG;IACH,qBAAqB,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;IACnD;;OAEG;IACH,oBAAoB,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;IAClD;;OAEG;IACH,wBAAwB,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;IACtD;;OAEG;IACH,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC;IAChE;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;IAE1C,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

package/dist/util/memory-tracking.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Track and log memory usage.
+ *
+ * Only for debugging purposes. This could add significant overhead and/or side-effects,
+ * and should not be used in production.
+ */
+export declare function trackMemoryUsage(): void;

package/dist/util/memory-tracking.js

@@ -0,0 +1,58 @@
+import { logger } from '@powersync/lib-services-framework';
+/**
+ * Track and log memory usage.
+ *
+ * Only for debugging purposes. This could add significant overhead and/or side-effects,
+ * and should not be used in production.
+ */
+export function trackMemoryUsage() {
+    let lastMem = process.memoryUsage();
+    let bufferMemory = {
+        alloc: 0,
+        allocUnsafe: 0,
+        allocUnsafeSlow: 0,
+        from: 0,
+        concat: 0
+    };
+    const bufferRegistry = new FinalizationRegistry((v) => {
+        const [key, value] = v;
+        bufferMemory[key] -= value;
+    });
+    for (let key of Object.keys(bufferMemory)) {
+        const typedKey = key;
+        const originalFunction = Buffer[typedKey];
+        Buffer[typedKey] = function (...args) {
+            const buffer = originalFunction.apply(this, args);
+            bufferMemory[typedKey] += buffer.byteLength;
+            bufferRegistry.register(buffer, [typedKey, buffer.byteLength]);
+            return buffer;
+        };
+    }
+    setInterval(() => {
+        const mem = process.memoryUsage();
+        let isDifferent = false;
+        for (const key in mem) {
+            if (Math.abs(mem[key] - lastMem[key]) > 5000000) {
+                isDifferent = true;
+            }
+        }
+        if (isDifferent) {
+            lastMem = mem;
+            const output = `RSS ${mb(mem.rss)} (
+        HAT ${mb(mem.heapTotal)} (
+          HU ${mb(mem.heapUsed)}
+        ),
+        buffers ${mb(mem.arrayBuffers)} (
+          alloc ${mb(bufferMemory.alloc + bufferMemory.allocUnsafe + bufferMemory.allocUnsafeSlow)},
+          from ${mb(bufferMemory.from)}
+          concat ${mb(bufferMemory.concat)}
+        )
+      )`.replaceAll(/\s+/g, ' ');
+            logger.info(output);
+        }
+    }, 50);
+}
+function mb(n) {
+    return Math.round(n / 1024 / 1024) + 'mb';
+}
+//# sourceMappingURL=memory-tracking.js.map

package/dist/util/memory-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tracking.js","sourceRoot":"","sources":["../../src/util/memory-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEpC,IAAI,YAAY,GAAG;QACjB,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,CAAC;QACd,eAAe,EAAE,CAAC;QAClB,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;KACV,CAAC;IAEF,MAAM,cAAc,GAAG,IAAI,oBAAoB,CAAsC,CAAC,CAAC,EAAE,EAAE;QACzF,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,YAAY,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,KAAK,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE;QACzC,MAAM,QAAQ,GAAG,GAAgC,CAAC;QAClD,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAA+B,CAAC;QACxE,MAAM,CAAC,QAAQ,CAAC,GAAG,UAAU,GAAG,IAAW;YACzC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAClD,YAAY,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC;YAC5C,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YAC/D,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;KACH;IAED,WAAW,CAAC,GAAG,EAAE;QACf,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAElC,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE;YACrB,IAAI,IAAI,CAAC,GAAG,CAAE,GAAW,CAAC,GAAG,CAAC,GAAI,OAAe,CAAC,GAAG,CAAC,CAAC,GAAG,OAAS,EAAE;gBACnE,WAAW,GAAG,IAAI,CAAC;aACpB;SACF;QAED,IAAI,WAAW,EAAE;YACf,OAAO,GAAG,GAAG,CAAC;YAEd,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;cACzB,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC;eAChB,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC;;kBAEb,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC;kBACpB,EAAE,CAAC,YAAY,CAAC,KAAK,GAAG,YAAY,CAAC,WAAW,GAAG,YAAY,CAAC,eAAe,CAAC;iBACjF,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;mBACnB,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC;;QAElC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAE3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACrB;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,SAAS,EAAE,CAAC,CAAS;IACnB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AAC5C,CAAC"}

package/dist/util/migration_lib.d.ts

@@ -0,0 +1,11 @@
+import * as pgwire from '@powersync/service-jpgwire';
+export type MigrationFunction = (db: pgwire.PgConnection) => Promise<void>;
+export declare class Migrations {
+    private migrations;
+    add(id: number, name: string, up: MigrationFunction): void;
+    up(db: pgwire.PgConnection): Promise<void>;
+    getCurrentMigration(db: pgwire.PgConnection): Promise<{
+        id: number;
+    }>;
+    ensureMigrationsTable(db: pgwire.PgConnection): Promise<void>;
+}

package/dist/util/migration_lib.js

@@ -0,0 +1,64 @@
+// Very loosely based on https://github.com/porsager/postgres-shift/
+export class Migrations {
+    constructor() {
+        this.migrations = [];
+    }
+    add(id, name, up) {
+        if (this.migrations.length > 0 && this.migrations[this.migrations.length - 1].id >= id) {
+            throw new Error('Migration ids must be strictly incrementing');
+        }
+        this.migrations.push({ id, up, name });
+    }
+    async up(db) {
+        await db.query('BEGIN');
+        try {
+            await this.ensureMigrationsTable(db);
+            const current = await this.getCurrentMigration(db);
+            let currentId = current ? current.id : 0;
+            for (let migration of this.migrations) {
+                if (migration.id <= currentId) {
+                    continue;
+                }
+                await migration.up(db);
+                await db.query({
+                    statement: `
+      insert into migrations (
+        migration_id,
+        name
+      ) values (
+        $1,
+        $2
+      )
+    `,
+                    params: [
+                        { type: 'int4', value: migration.id },
+                        { type: 'varchar', value: migration.name }
+                    ]
+                });
+            }
+            await db.query('COMMIT');
+        }
+        catch (e) {
+            await db.query('ROLLBACK');
+            throw e;
+        }
+    }
+    getCurrentMigration(db) {
+        return db
+            .query(`
+      select migration_id as id from migrations
+      order by migration_id desc
+      limit 1
+    `)
+            .then((results) => ({ id: results.rows[0][0] }));
+    }
+    async ensureMigrationsTable(db) {
+        await db.query(`create table if not exists migrations (
+        migration_id serial primary key,
+        created_at timestamp with time zone not null default now(),
+        name text
+      )
+    `);
+    }
+}
+//# sourceMappingURL=migration_lib.js.map

package/dist/util/migration_lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration_lib.js","sourceRoot":"","sources":["../../src/util/migration_lib.ts"],"names":[],"mappings":"AAUA,oEAAoE;AACpE,MAAM,OAAO,UAAU;IAAvB;QACU,eAAU,GAAgB,EAAE,CAAC;IAkEvC,CAAC;IAhEC,GAAG,CAAC,EAAU,EAAE,IAAY,EAAE,EAAqB;QACjD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;YACtF,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;SAChE;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,EAAE,CAAC,EAAuB;QAC9B,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI;YACF,MAAM,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAEzC,KAAK,IAAI,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE;gBACrC,IAAI,SAAS,CAAC,EAAE,IAAI,SAAS,EAAE;oBAC7B,SAAS;iBACV;gBACD,MAAM,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAEvB,MAAM,EAAE,CAAC,KAAK,CAAC;oBACb,SAAS,EAAE;;;;;;;;KAQhB;oBACK,MAAM,EAAE;wBACN,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE;wBACrC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE;qBAC3C;iBACF,CAAC,CAAC;aACJ;YAED,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SAC1B;QAAC,OAAO,CAAC,EAAE;YACV,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC3B,MAAM,CAAC,CAAC;SACT;IACH,CAAC;IAED,mBAAmB,CAAC,EAAuB;QACzC,OAAO,EAAE;aACN,KAAK,CACJ;;;;KAIH,CACE;aACA,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAW,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,EAAuB;QACjD,MAAM,EAAE,CAAC,KAAK,CAAC;;;;;KAKd,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/util/pgwire_utils.d.ts

@@ -0,0 +1,24 @@
+import * as bson from 'bson';
+import * as pgwire from '@powersync/service-jpgwire';
+import { SqliteJsonValue, SqliteRow, ToastableSqliteRow } from '@powersync/service-sync-rules';
+import * as replication from '../replication/replication-index.js';
+/**
+ * pgwire message -> SQLite row.
+ * @param message
+ */
+export declare function constructAfterRecord(message: pgwire.PgoutputInsert | pgwire.PgoutputUpdate): SqliteRow;
+export declare function hasToastedValues(row: ToastableSqliteRow): boolean;
+export declare function isCompleteRow(row: ToastableSqliteRow): row is SqliteRow;
+/**
+ * pgwire message -> SQLite row.
+ * @param message
+ */
+export declare function constructBeforeRecord(message: pgwire.PgoutputDelete | pgwire.PgoutputUpdate): SqliteRow | undefined;
+export declare function getUuidReplicaIdentityString(tuple: ToastableSqliteRow, columns: replication.ReplicationColumn[]): string;
+export declare function uuidForRow(row: SqliteRow): string;
+export declare function getUuidReplicaIdentityBson(tuple: ToastableSqliteRow, columns: replication.ReplicationColumn[]): bson.UUID;
+export declare function uuidForRowBson(row: SqliteRow): bson.UUID;
+export declare function escapeIdentifier(identifier: string): string;
+export declare function autoParameter(arg: SqliteJsonValue | boolean): pgwire.StatementParam;
+export declare function retriedQuery(db: pgwire.PgClient, ...statements: pgwire.Statement[]): Promise<pgwire.PgResult>;
+export declare function retriedQuery(db: pgwire.PgClient, query: string): Promise<pgwire.PgResult>;