@powersync/service-module-mongodb-storage 0.18.3 → 0.20.0

package/dist/storage/implementation/common/SingleBucketStore.d.ts

@@ -1,54 +0,0 @@
-import { mongo } from '@powersync/lib-service-mongodb';
-import { InternalOpId } from '@powersync/service-core';
-import { BucketDataProperties } from '../models.js';
-import { BucketDataDoc, BucketKey } from './BucketDataDoc.js';
-declare const GENERIC_ID: unique symbol;
-export type BucketDataDocumentGenericId = {
-    b: string;
-    o: InternalOpId;
-    [GENERIC_ID]: true;
-};
-/**
- * This document is never actually constructed - we use it as a "virtual" type.
- *
- * The actual implementations are BucketDataDocumentV1 or BucketDataDocumentV3.
- * They don't fully satisfy this interface, but this works to share common implementations.
- *
- * The idea is that we can have a common implementation between V1 & V3, using this type,
- * and operate on MongoDB collections.
- *
- * This interface serves two primary purposes:
- * 1. Captures properties that exist on both V1 and V3 storage models.
- * 2. Gives a common reference when querying or modifying collections.
- *
- * Generics would've been ideal, but they don't play well with MongoDB collections.
- */
-export interface BucketDataDocumentGeneric extends BucketDataProperties {
-    _id: BucketDataDocumentGenericId;
-}
-/**
- * Represent read/write access for a single bucket.
- *
- * This does not implement the actual collection operations, but supports the required conversions
- * between in-memory BucketDataDoc and the specific storage formats.
- */
-export interface SingleBucketStore {
-    readonly key: BucketKey;
-    readonly collection: mongo.Collection<BucketDataDocumentGeneric>;
-    docId(o: InternalOpId): BucketDataDocumentGenericId;
-    readonly minId: BucketDataDocumentGenericId;
-    readonly maxId: BucketDataDocumentGenericId;
-    /**
-     * Convert in-memory document -> persisted document.
-     */
-    toPersistedDocument(source: Omit<BucketDataDoc, 'bucketKey'>): BucketDataDocumentGeneric;
-    /**
-     * Convert persisted document -> in-memory document.
-     */
-    fromPersistedDocument(doc: BucketDataDocumentGeneric): BucketDataDoc;
-    /**
-     * Convert partial persisted document -> partial in-memory document.
-     */
-    fromPartialPersistedDocument<T extends keyof BucketDataProperties>(doc: Pick<BucketDataDocumentGeneric, '_id' | T>): Pick<BucketDataDoc, 'bucketKey' | 'o' | T>;
-}
-export {};

package/dist/storage/implementation/common/SingleBucketStore.js

@@ -1,3 +0,0 @@
-const GENERIC_ID = Symbol('BucketDataDocumentGenericId');
-export {};
-//# sourceMappingURL=SingleBucketStore.js.map

package/dist/storage/implementation/common/SingleBucketStore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SingleBucketStore.js","sourceRoot":"","sources":["../../../../src/storage/implementation/common/SingleBucketStore.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC"}

package/dist/storage/implementation/v3/SingleBucketStoreV3.d.ts

@@ -1,18 +0,0 @@
-import { mongo } from '@powersync/lib-service-mongodb';
-import { InternalOpId } from '@powersync/service-core';
-import { BucketDataDoc, BucketKey } from '../common/BucketDataDoc.js';
-import { BucketDataDocumentGeneric, BucketDataDocumentGenericId, SingleBucketStore } from '../common/SingleBucketStore.js';
-import { BucketDataProperties } from '../models.js';
-import { VersionedPowerSyncMongoV3 } from './VersionedPowerSyncMongoV3.js';
-export declare class SingleBucketStoreV3 implements SingleBucketStore {
-    private db;
-    readonly key: BucketKey;
-    readonly collection: mongo.Collection<BucketDataDocumentGeneric>;
-    constructor(db: VersionedPowerSyncMongoV3, key: BucketKey);
-    docId(o: InternalOpId): BucketDataDocumentGenericId;
-    get minId(): BucketDataDocumentGenericId;
-    get maxId(): BucketDataDocumentGenericId;
-    toPersistedDocument(source: Omit<BucketDataDoc, 'bucketKey'>): BucketDataDocumentGeneric;
-    fromPersistedDocument(doc: BucketDataDocumentGeneric): BucketDataDoc;
-    fromPartialPersistedDocument<T extends keyof BucketDataProperties>(doc: Pick<BucketDataDocumentGeneric, '_id' | T>): Pick<BucketDataDoc, 'bucketKey' | 'o' | T>;
-}

package/dist/storage/implementation/v3/SingleBucketStoreV3.js

@@ -1,84 +0,0 @@
-import { mongo } from '@powersync/lib-service-mongodb';
-import { loadBucketDataDocument, serializeBucketData } from './bucket-format.js';
-function extractPartialDocumentFields(doc) {
-    if (typeof doc !== 'object' || doc === null) {
-        throw new Error('Invalid partial document: expected object');
-    }
-    const d = doc;
-    const id = d._id;
-    if (typeof id !== 'object' || id === null || !('o' in id)) {
-        throw new Error('Invalid partial document: missing _id.o');
-    }
-    return d;
-}
-// MongoDB's MinKey/MaxKey are special sentinel values that don't match the bigint type
-// for _id.o in BucketDataDocumentGenericId, so we need an explicit cast.
-function minKeyForBucket(bucket) {
-    return {
-        b: bucket,
-        o: new mongo.MinKey()
-    };
-}
-function maxKeyForBucket(bucket) {
-    return {
-        b: bucket,
-        o: new mongo.MaxKey()
-    };
-}
-export class SingleBucketStoreV3 {
-    db;
-    key;
-    collection;
-    constructor(db, key) {
-        this.db = db;
-        this.key = key;
-        // Cast from the version-specific collection type to the generic interface
-        // used across storage versions.
-        this.collection = db.bucketData(key.replicationStreamId, key.definitionId);
-    }
-    docId(o) {
-        // `satisfies BucketDataKey` checks that we use the correct type for V3 storage
-        // `as BucketDataDocumentGenericId` does a cast to get the interface virtual type
-        return {
-            b: this.key.bucket,
-            o
-        };
-    }
-    get minId() {
-        return minKeyForBucket(this.key.bucket);
-    }
-    get maxId() {
-        return maxKeyForBucket(this.key.bucket);
-    }
-    toPersistedDocument(source) {
-        return serializeBucketData(this.key.bucket, [
-            { bucketKey: this.key, ...source }
-        ]);
-    }
-    fromPersistedDocument(doc) {
-        const generator = loadBucketDataDocument(this.key, doc);
-        const first = generator.next();
-        if (first.done) {
-            throw new Error('Empty ops array in BucketDataDocumentV3');
-        }
-        return first.value;
-    }
-    fromPartialPersistedDocument(doc) {
-        const document = doc;
-        const op = document.ops?.[0];
-        if (op == null) {
-            const fields = extractPartialDocumentFields(doc);
-            const { _id, ...rest } = fields;
-            return {
-                bucketKey: this.key,
-                o: _id.o,
-                ...rest
-            };
-        }
-        return {
-            bucketKey: this.key,
-            ...op
-        };
-    }
-}
-//# sourceMappingURL=SingleBucketStoreV3.js.map

package/dist/storage/implementation/v3/SingleBucketStoreV3.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SingleBucketStoreV3.js","sourceRoot":"","sources":["../../../../src/storage/implementation/v3/SingleBucketStoreV3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AASvD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIjF,SAAS,4BAA4B,CAAC,GAAY;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC;IACjB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,CAAmD,CAAC;AAC7D,CAAC;AAED,uFAAuF;AACvF,yEAAyE;AACzE,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO;QACL,CAAC,EAAE,MAAM;QACT,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,EAAE;KACoB,CAAC;AAC9C,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO;QACL,CAAC,EAAE,MAAM;QACT,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,EAAE;KACoB,CAAC;AAC9C,CAAC;AAED,MAAM,OAAO,mBAAmB;IAIpB;IACQ;IAJF,UAAU,CAA8C;IAExE,YACU,EAA6B,EACrB,GAAc;QADtB,OAAE,GAAF,EAAE,CAA2B;QACrB,QAAG,GAAH,GAAG,CAAW;QAE9B,0EAA0E;QAC1E,gCAAgC;QAChC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU,CAC7B,GAAG,CAAC,mBAAmB,EACvB,GAAG,CAAC,YAAY,CACyC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,CAAe;QACnB,+EAA+E;QAC/E,iFAAiF;QACjF,OAAO;YACL,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM;YAClB,CAAC;SACqD,CAAC;IAC3D,CAAC;IAED,IAAI,KAAK;QACP,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,KAAK;QACP,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,mBAAmB,CAAC,MAAwC;QAC1D,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE;YAC1C,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE;SACnC,CAAyC,CAAC;IAC7C,CAAC;IAED,qBAAqB,CAAC,GAA8B;QAClD,MAAM,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAsC,CAAC,CAAC;QAC3F,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,4BAA4B,CAC1B,GAA+C;QAE/C,MAAM,QAAQ,GAAG,GAA2D,CAAC;QAC7E,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,4BAA4B,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;YAChC,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,GAAG;gBACnB,CAAC,EAAE,GAAG,CAAC,CAAC;gBACR,GAAG,IAAI;aACsC,CAAC;QAClD,CAAC;QACD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,GAAG;YACnB,GAAG,EAAE;SACwC,CAAC;IAClD,CAAC;CACF"}

package/src/storage/implementation/common/SingleBucketStore.ts

@@ -1,63 +0,0 @@
-import { mongo } from '@powersync/lib-service-mongodb';
-import { InternalOpId } from '@powersync/service-core';
-import { BucketDataProperties } from '../models.js';
-import { BucketDataDoc, BucketKey } from './BucketDataDoc.js';
-
-const GENERIC_ID = Symbol('BucketDataDocumentGenericId');
-export type BucketDataDocumentGenericId = {
-  b: string;
-  o: InternalOpId;
-  // Hack to ensure this can't be constructed directly
-  [GENERIC_ID]: true;
-};
-
-/**
- * This document is never actually constructed - we use it as a "virtual" type.
- *
- * The actual implementations are BucketDataDocumentV1 or BucketDataDocumentV3.
- * They don't fully satisfy this interface, but this works to share common implementations.
- *
- * The idea is that we can have a common implementation between V1 & V3, using this type,
- * and operate on MongoDB collections.
- *
- * This interface serves two primary purposes:
- * 1. Captures properties that exist on both V1 and V3 storage models.
- * 2. Gives a common reference when querying or modifying collections.
- *
- * Generics would've been ideal, but they don't play well with MongoDB collections.
- */
-export interface BucketDataDocumentGeneric extends BucketDataProperties {
-  _id: BucketDataDocumentGenericId;
-}
-
-/**
- * Represent read/write access for a single bucket.
- *
- * This does not implement the actual collection operations, but supports the required conversions
- * between in-memory BucketDataDoc and the specific storage formats.
- */
-export interface SingleBucketStore {
-  readonly key: BucketKey;
-
-  readonly collection: mongo.Collection<BucketDataDocumentGeneric>;
-  docId(o: InternalOpId): BucketDataDocumentGenericId;
-  readonly minId: BucketDataDocumentGenericId;
-  readonly maxId: BucketDataDocumentGenericId;
-
-  /**
-   * Convert in-memory document -> persisted document.
-   */
-  toPersistedDocument(source: Omit<BucketDataDoc, 'bucketKey'>): BucketDataDocumentGeneric;
-
-  /**
-   * Convert persisted document -> in-memory document.
-   */
-  fromPersistedDocument(doc: BucketDataDocumentGeneric): BucketDataDoc;
-
-  /**
-   * Convert partial persisted document -> partial in-memory document.
-   */
-  fromPartialPersistedDocument<T extends keyof BucketDataProperties>(
-    doc: Pick<BucketDataDocumentGeneric, '_id' | T>
-  ): Pick<BucketDataDoc, 'bucketKey' | 'o' | T>;
-}

package/src/storage/implementation/v3/SingleBucketStoreV3.ts

@@ -1,108 +0,0 @@
-import { mongo } from '@powersync/lib-service-mongodb';
-import { InternalOpId } from '@powersync/service-core';
-import { BucketDataDoc, BucketKey } from '../common/BucketDataDoc.js';
-import {
-  BucketDataDocumentGeneric,
-  BucketDataDocumentGenericId,
-  SingleBucketStore
-} from '../common/SingleBucketStore.js';
-import { BucketDataKey, BucketDataProperties } from '../models.js';
-import { loadBucketDataDocument, serializeBucketData } from './bucket-format.js';
-import { BucketDataDocumentV3 } from './models.js';
-import { VersionedPowerSyncMongoV3 } from './VersionedPowerSyncMongoV3.js';
-
-function extractPartialDocumentFields(doc: unknown): { _id: { o: bigint }; [key: string]: unknown } {
-  if (typeof doc !== 'object' || doc === null) {
-    throw new Error('Invalid partial document: expected object');
-  }
-  const d = doc as Record<string, unknown>;
-  const id = d._id;
-  if (typeof id !== 'object' || id === null || !('o' in id)) {
-    throw new Error('Invalid partial document: missing _id.o');
-  }
-  return d as { _id: { o: bigint }; [key: string]: unknown };
-}
-
-// MongoDB's MinKey/MaxKey are special sentinel values that don't match the bigint type
-// for _id.o in BucketDataDocumentGenericId, so we need an explicit cast.
-function minKeyForBucket(bucket: string): BucketDataDocumentGenericId {
-  return {
-    b: bucket,
-    o: new mongo.MinKey()
-  } as unknown as BucketDataDocumentGenericId;
-}
-
-function maxKeyForBucket(bucket: string): BucketDataDocumentGenericId {
-  return {
-    b: bucket,
-    o: new mongo.MaxKey()
-  } as unknown as BucketDataDocumentGenericId;
-}
-
-export class SingleBucketStoreV3 implements SingleBucketStore {
-  public readonly collection: mongo.Collection<BucketDataDocumentGeneric>;
-
-  constructor(
-    private db: VersionedPowerSyncMongoV3,
-    public readonly key: BucketKey
-  ) {
-    // Cast from the version-specific collection type to the generic interface
-    // used across storage versions.
-    this.collection = db.bucketData(
-      key.replicationStreamId,
-      key.definitionId
-    ) as unknown as mongo.Collection<BucketDataDocumentGeneric>;
-  }
-
-  docId(o: InternalOpId): BucketDataDocumentGenericId {
-    // `satisfies BucketDataKey` checks that we use the correct type for V3 storage
-    // `as BucketDataDocumentGenericId` does a cast to get the interface virtual type
-    return {
-      b: this.key.bucket,
-      o
-    } satisfies BucketDataKey as BucketDataDocumentGenericId;
-  }
-
-  get minId(): BucketDataDocumentGenericId {
-    return minKeyForBucket(this.key.bucket);
-  }
-
-  get maxId(): BucketDataDocumentGenericId {
-    return maxKeyForBucket(this.key.bucket);
-  }
-
-  toPersistedDocument(source: Omit<BucketDataDoc, 'bucketKey'>): BucketDataDocumentGeneric {
-    return serializeBucketData(this.key.bucket, [
-      { bucketKey: this.key, ...source }
-    ]) as unknown as BucketDataDocumentGeneric;
-  }
-
-  fromPersistedDocument(doc: BucketDataDocumentGeneric): BucketDataDoc {
-    const generator = loadBucketDataDocument(this.key, doc as unknown as BucketDataDocumentV3);
-    const first = generator.next();
-    if (first.done) {
-      throw new Error('Empty ops array in BucketDataDocumentV3');
-    }
-    return first.value;
-  }
-
-  fromPartialPersistedDocument<T extends keyof BucketDataProperties>(
-    doc: Pick<BucketDataDocumentGeneric, '_id' | T>
-  ): Pick<BucketDataDoc, 'bucketKey' | 'o' | T> {
-    const document = doc as unknown as Pick<BucketDataDocumentV3, '_id' | 'ops'>;
-    const op = document.ops?.[0];
-    if (op == null) {
-      const fields = extractPartialDocumentFields(doc);
-      const { _id, ...rest } = fields;
-      return {
-        bucketKey: this.key,
-        o: _id.o,
-        ...rest
-      } as Pick<BucketDataDoc, 'bucketKey' | 'o' | T>;
-    }
-    return {
-      bucketKey: this.key,
-      ...op
-    } as Pick<BucketDataDoc, 'bucketKey' | 'o' | T>;
-  }
-}