@slimr/dbsync 0.0.3

package/esm/DbSync.js.map

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

package/esm/DbTransaction.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Represents an atomic sequence of write operations.
+ * Operations are queued in memory and only executed against the target
+ * database when `commit()` is called.
+ */
+export declare class DbTransaction {
+    private executor;
+    /**
+     * Stores the pending CRUD operations.
+     * @internal Evaluated and executed by the executor function upon `commit()`.
+     */
+    private operations;
+    /**
+     * Initializes the transaction with an execution engine.
+     * Should be instantiated via `DbSync.getTransaction()` rather than directly.
+     *
+     * @internal
+     * @param executor Provides the context needed to process the queued operations.
+     */
+    constructor(executor: (ops: any[]) => Promise<void>);
+    /**
+     * Queues an insertion operation.
+     *
+     * @param storeName The name of the target object store.
+     * @param value The object payload to insert.
+     * @param key An optional explicit primary key.
+     */
+    add(storeName: string, value: any, key?: string | number): void;
+    /**
+     * Queues an upsert (insert or update) operation.
+     *
+     * @param storeName The name of the target object store.
+     * @param value The object payload to write.
+     * @param key An optional explicit primary key.
+     */
+    put(storeName: string, value: any, key?: string | number): void;
+    /**
+     * Queues a deletion operation.
+     *
+     * @param storeName The name of the target object store.
+     * @param key The primary key of the record to remove.
+     */
+    delete(storeName: string, key: string | number): void;
+    /**
+     * Queues an operation to remove all records from an object store.
+     *
+     * @param storeName The name of the object store to clear.
+     */
+    clear(storeName: string): void;
+    /**
+     * Executes all queued operations atomically within a single database transaction.
+     *
+     * @returns A promise that resolves when the transaction successfully completes.
+     */
+    commit(): Promise<void>;
+    /**
+     * Discards all pending operations without modifying the database.
+     */
+    cancel(): void;
+}

package/esm/DbTransaction.js

@@ -0,0 +1,78 @@
+// DbTransaction does not depend on DbSync now
+/**
+ * Represents an atomic sequence of write operations.
+ * Operations are queued in memory and only executed against the target
+ * database when `commit()` is called.
+ */
+export class DbTransaction {
+    executor;
+    /**
+     * Stores the pending CRUD operations.
+     * @internal Evaluated and executed by the executor function upon `commit()`.
+     */
+    operations = [];
+    /**
+     * Initializes the transaction with an execution engine.
+     * Should be instantiated via `DbSync.getTransaction()` rather than directly.
+     *
+     * @internal
+     * @param executor Provides the context needed to process the queued operations.
+     */
+    constructor(executor) {
+        this.executor = executor;
+    }
+    /**
+     * Queues an insertion operation.
+     *
+     * @param storeName The name of the target object store.
+     * @param value The object payload to insert.
+     * @param key An optional explicit primary key.
+     */
+    add(storeName, value, key) {
+        this.operations.push({ type: "add", storeName, value, key });
+    }
+    /**
+     * Queues an upsert (insert or update) operation.
+     *
+     * @param storeName The name of the target object store.
+     * @param value The object payload to write.
+     * @param key An optional explicit primary key.
+     */
+    put(storeName, value, key) {
+        this.operations.push({ type: "put", storeName, value, key });
+    }
+    /**
+     * Queues a deletion operation.
+     *
+     * @param storeName The name of the target object store.
+     * @param key The primary key of the record to remove.
+     */
+    delete(storeName, key) {
+        this.operations.push({ type: "delete", storeName, key });
+    }
+    /**
+     * Queues an operation to remove all records from an object store.
+     *
+     * @param storeName The name of the object store to clear.
+     */
+    clear(storeName) {
+        this.operations.push({ type: "clear", storeName });
+    }
+    /**
+     * Executes all queued operations atomically within a single database transaction.
+     *
+     * @returns A promise that resolves when the transaction successfully completes.
+     */
+    async commit() {
+        if (this.operations.length === 0)
+            return;
+        return this.executor(this.operations);
+    }
+    /**
+     * Discards all pending operations without modifying the database.
+     */
+    cancel() {
+        this.operations = [];
+    }
+}
+//# sourceMappingURL=DbTransaction.js.map

package/esm/DbTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbTransaction.js","sourceRoot":"","sources":["../src/DbTransaction.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAE9C;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAmBL;IAlBpB;;;OAGG;IACK,UAAU,GAKZ,EAAE,CAAA;IAER;;;;;;OAMG;IACH,YAAoB,QAAuC;QAAvC,aAAQ,GAAR,QAAQ,CAA+B;IAAG,CAAC;IAE/D;;;;;;OAMG;IACH,GAAG,CAAC,SAAiB,EAAE,KAAU,EAAE,GAAqB;QACvD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,SAAiB,EAAE,KAAU,EAAE,GAAqB;QACvD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAiB,EAAE,GAAoB;QAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;IACzD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAiB;QACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAA;IACnD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACX,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACtC,CAAC;IAED;;OAEG;IACH,MAAM;QACL,IAAI,CAAC,UAAU,GAAG,EAAE,CAAA;IACrB,CAAC;CACD"}

package/esm/DbTxRepository.d.ts

@@ -0,0 +1,41 @@
+import type { DbTransaction } from "./internal/DbTransaction.js";
+/**
+ * A typed repository wrapper for a single `DbTransaction` object store target.
+ * Provides a localized interface to queue write operations with strict typings
+ * to minimize boilerplate and enforce consistent data types for a specific table.
+ */
+export declare class DbTxRepository<T> {
+    protected tx: DbTransaction;
+    readonly storeName: string;
+    /**
+     * Initializes a new transaction repository tied to a specific object store.
+     *
+     * @param tx The active `DbTransaction` instance.
+     * @param storeName The name of the object store to queue writes for.
+     */
+    constructor(tx: DbTransaction, storeName: string);
+    /**
+     * Queues an insertion operation.
+     *
+     * @param value The object payload to insert.
+     * @param key An optional explicit primary key.
+     */
+    add(value: Partial<T>, key?: string | number): void;
+    /**
+     * Queues an upsert (insert or update) operation.
+     *
+     * @param value The complete object to upsert.
+     * @param key An optional explicit primary key.
+     */
+    put(value: T, key?: string | number): void;
+    /**
+     * Queues a deletion operation.
+     *
+     * @param key The primary key of the record to delete.
+     */
+    delete(key: string | number): void;
+    /**
+     * Queues an operation to remove all records from the object store.
+     */
+    clear(): void;
+}

package/esm/DbTxRepository.js

@@ -0,0 +1,52 @@
+/**
+ * A typed repository wrapper for a single `DbTransaction` object store target.
+ * Provides a localized interface to queue write operations with strict typings
+ * to minimize boilerplate and enforce consistent data types for a specific table.
+ */
+export class DbTxRepository {
+    tx;
+    storeName;
+    /**
+     * Initializes a new transaction repository tied to a specific object store.
+     *
+     * @param tx The active `DbTransaction` instance.
+     * @param storeName The name of the object store to queue writes for.
+     */
+    constructor(tx, storeName) {
+        this.tx = tx;
+        this.storeName = storeName;
+    }
+    /**
+     * Queues an insertion operation.
+     *
+     * @param value The object payload to insert.
+     * @param key An optional explicit primary key.
+     */
+    add(value, key) {
+        this.tx.add(this.storeName, value, key);
+    }
+    /**
+     * Queues an upsert (insert or update) operation.
+     *
+     * @param value The complete object to upsert.
+     * @param key An optional explicit primary key.
+     */
+    put(value, key) {
+        this.tx.put(this.storeName, value, key);
+    }
+    /**
+     * Queues a deletion operation.
+     *
+     * @param key The primary key of the record to delete.
+     */
+    delete(key) {
+        this.tx.delete(this.storeName, key);
+    }
+    /**
+     * Queues an operation to remove all records from the object store.
+     */
+    clear() {
+        this.tx.clear(this.storeName);
+    }
+}
+//# sourceMappingURL=DbTxRepository.js.map

package/esm/DbTxRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbTxRepository.js","sourceRoot":"","sources":["../src/DbTxRepository.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAQf;IACM;IARjB;;;;;OAKG;IACH,YACW,EAAiB,EACX,SAAiB;QADvB,OAAE,GAAF,EAAE,CAAe;QACX,cAAS,GAAT,SAAS,CAAQ;IAC/B,CAAC;IAEJ;;;;;OAKG;IACH,GAAG,CAAC,KAAiB,EAAE,GAAqB;QAC3C,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;IACxC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,KAAQ,EAAE,GAAqB;QAClC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;IACxC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAoB;QAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IACpC,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC9B,CAAC;CACD"}

package/esm/MigrationManager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Defines a single, sequential schema evolution step for a document structure.
+ * Migrations allow existing offline data to be selectively upgraded rather than wiped
+ * when backend domain modeling changes.
+ */
+export interface IMigration<T = any> {
+    /**
+     * An ascending integer determining execution order. A record currently at `storeVersion: 1`
+     * will only trigger migrations where `version >= 2`.
+     */
+    version: number;
+    /**
+     * A human-readable note summarizing the structural change.
+     */
+    note: string;
+    /**
+     * Mutates the provided record in-place to comply with the new schema structure.
+     *
+     * @param record The raw record needing an upgrade.
+     * @returns A promise that resolves when the record has been fully transformed.
+     */
+    upgrade(record: T): Promise<void>;
+}
+/**
+ * An engine for applying a suite of `IMigration` objects to all records
+ * across targeted `DbSync` object stores.
+ */
+export declare class MigrationManager {
+    private db;
+    /**
+     * Initializes the MigrationManager for a specific database instance.
+     *
+     * @internal
+     * @param db The `DbSync` instance used to traverse object stores and apply rewrites.
+     */
+    constructor(db: any);
+    /**
+     * Iterates through a map of object stores and systematically applies their respective migrations.
+     *
+     * @param schemaMigrations A dictionary mapping store names to arrays of `IMigration` steps.
+     */
+    runAll(schemaMigrations: Record<string, IMigration[]>): Promise<void>;
+    /**
+     * Sorts and attempts to apply a sequence of migrations to a single record in memory.
+     * Evaluates `storeVersion` to ensure migrations are only executed sequentially and exactly once.
+     *
+     * @param record The plain object to be upgraded.
+     * @param migrations The full list of potential migrations for the record's domain type.
+     * @returns The functionally upgraded record with an updated `storeVersion`.
+     */
+    static upgradeRecord<T>(record: any, migrations: IMigration<T>[]): Promise<any>;
+    /**
+     * Reads all records from a specific store, upgrades out-of-date entries,
+     * and atomically flushes the changed entries back within a single database transaction.
+     *
+     * @param storeName The name of the target object store.
+     * @param migrations The ordered array of migrations applicable to the store.
+     */
+    private upgradeStore;
+}

package/esm/MigrationManager.js

@@ -0,0 +1,65 @@
+/**
+ * An engine for applying a suite of `IMigration` objects to all records
+ * across targeted `DbSync` object stores.
+ */
+export class MigrationManager {
+    db;
+    /**
+     * Initializes the MigrationManager for a specific database instance.
+     *
+     * @internal
+     * @param db The `DbSync` instance used to traverse object stores and apply rewrites.
+     */
+    constructor(db) {
+        this.db = db;
+    } // db is DbSync instance
+    /**
+     * Iterates through a map of object stores and systematically applies their respective migrations.
+     *
+     * @param schemaMigrations A dictionary mapping store names to arrays of `IMigration` steps.
+     */
+    async runAll(schemaMigrations) {
+        for (const [storeName, migrations] of Object.entries(schemaMigrations)) {
+            await this.upgradeStore(storeName, migrations);
+        }
+    }
+    /**
+     * Sorts and attempts to apply a sequence of migrations to a single record in memory.
+     * Evaluates `storeVersion` to ensure migrations are only executed sequentially and exactly once.
+     *
+     * @param record The plain object to be upgraded.
+     * @param migrations The full list of potential migrations for the record's domain type.
+     * @returns The functionally upgraded record with an updated `storeVersion`.
+     */
+    static async upgradeRecord(record, migrations) {
+        const sortedMigrations = [...migrations].sort((a, b) => a.version - b.version);
+        for (const migration of sortedMigrations) {
+            const currentVersion = record.storeVersion || 0;
+            if (currentVersion < migration.version) {
+                await migration.upgrade(record);
+                record.storeVersion = migration.version;
+            }
+        }
+        return record;
+    }
+    /**
+     * Reads all records from a specific store, upgrades out-of-date entries,
+     * and atomically flushes the changed entries back within a single database transaction.
+     *
+     * @param storeName The name of the target object store.
+     * @param migrations The ordered array of migrations applicable to the store.
+     */
+    async upgradeStore(storeName, migrations) {
+        const allRecords = await this.db.findAll(storeName);
+        const tx = this.db.getTransaction();
+        for (const recordCurrent of allRecords) {
+            const recordNext = { ...recordCurrent };
+            await MigrationManager.upgradeRecord(recordNext, migrations);
+            if (recordNext.storeVersion !== recordCurrent.storeVersion) {
+                tx.put(storeName, recordNext);
+            }
+        }
+        await tx.commit();
+    }
+}
+//# sourceMappingURL=MigrationManager.js.map

package/esm/MigrationManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationManager.js","sourceRoot":"","sources":["../src/MigrationManager.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAOR;IANpB;;;;;OAKG;IACH,YAAoB,EAAO;QAAP,OAAE,GAAF,EAAE,CAAK;IAAG,CAAC,CAAC,wBAAwB;IAExD;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,gBAA8C;QAC1D,KAAK,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAC/C,CAAC;IACF,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAI,MAAW,EAAE,UAA2B;QAC5E,MAAM,gBAAgB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;QAC9E,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;YAC1C,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,IAAI,CAAC,CAAA;YAC/C,IAAI,cAAc,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;gBACxC,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBAC/B,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,OAAO,CAAA;YACxC,CAAC;QACF,CAAC;QACD,OAAO,MAAM,CAAA;IACd,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,UAAwB;QACrE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACnD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAA;QAEnC,KAAK,MAAM,aAAa,IAAI,UAAU,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,EAAE,GAAG,aAAa,EAAE,CAAA;YACvC,MAAM,gBAAgB,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;YAE5D,IAAI,UAAU,CAAC,YAAY,KAAK,aAAa,CAAC,YAAY,EAAE,CAAC;gBAC5D,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;YAC9B,CAAC;QACF,CAAC;QAED,MAAM,EAAE,CAAC,MAAM,EAAE,CAAA;IAClB,CAAC;CACD"}

package/esm/Repository.d.ts

@@ -0,0 +1,59 @@
+import type { DbSync } from "./DbSync.js";
+/**
+ * A typed repository wrapper for a single `DbSync` object store.
+ * Provides a localized CRUD interface to minimize boilerplate and
+ * enforce consistent data types for a specific table.
+ */
+export declare class Repository<T> {
+    protected db: DbSync;
+    readonly storeName: string;
+    /**
+     * Initializes a new repository tied to a specific object store.
+     *
+     * @param db The centralized `DbSync` instance.
+     * @param storeName The name of the object store this repository will manage.
+     */
+    constructor(db: DbSync, storeName: string);
+    /**
+     * Retrieves a single record by its primary key.
+     *
+     * @param id The primary key of the record to retrieve.
+     * @returns A promise resolving to the typed record, or `undefined` if not found.
+     */
+    findById(id: string | number): Promise<T | undefined>;
+    /**
+     * Retrieves all records currently held in the object store.
+     *
+     * @returns A promise resolving to an array of all typed records.
+     */
+    findAll(): Promise<T[]>;
+    /**
+     * Inserts a new record into the object store.
+     *
+     * @param value The object payload to insert.
+     * @param key An optional explicit primary key.
+     * @returns A promise resolving to the newly inserted record.
+     */
+    add(value: Partial<T>, key?: string | number): Promise<T>;
+    /**
+     * Inserts or updates an existing record in the object store.
+     *
+     * @param value The complete object to upsert.
+     * @param key An optional explicit primary key.
+     * @returns A promise resolving to the upserted record.
+     */
+    put(value: T, key?: string | number): Promise<T>;
+    /**
+     * Removes a record from the object store by its primary key.
+     *
+     * @param key The primary key of the record to delete.
+     * @returns A promise resolving when the deletion is complete.
+     */
+    delete(key: string | number): Promise<void>;
+    /**
+     * Discards all records present in the object store.
+     *
+     * @returns A promise resolving when the store has been completely cleared.
+     */
+    clear(): Promise<void>;
+}

package/esm/Repository.js

@@ -0,0 +1,74 @@
+/**
+ * A typed repository wrapper for a single `DbSync` object store.
+ * Provides a localized CRUD interface to minimize boilerplate and
+ * enforce consistent data types for a specific table.
+ */
+export class Repository {
+    db;
+    storeName;
+    /**
+     * Initializes a new repository tied to a specific object store.
+     *
+     * @param db The centralized `DbSync` instance.
+     * @param storeName The name of the object store this repository will manage.
+     */
+    constructor(db, storeName) {
+        this.db = db;
+        this.storeName = storeName;
+    }
+    /**
+     * Retrieves a single record by its primary key.
+     *
+     * @param id The primary key of the record to retrieve.
+     * @returns A promise resolving to the typed record, or `undefined` if not found.
+     */
+    async findById(id) {
+        return this.db.get(this.storeName, id);
+    }
+    /**
+     * Retrieves all records currently held in the object store.
+     *
+     * @returns A promise resolving to an array of all typed records.
+     */
+    async findAll() {
+        return this.db.findAll(this.storeName);
+    }
+    /**
+     * Inserts a new record into the object store.
+     *
+     * @param value The object payload to insert.
+     * @param key An optional explicit primary key.
+     * @returns A promise resolving to the newly inserted record.
+     */
+    async add(value, key) {
+        return this.db.add(this.storeName, value, key);
+    }
+    /**
+     * Inserts or updates an existing record in the object store.
+     *
+     * @param value The complete object to upsert.
+     * @param key An optional explicit primary key.
+     * @returns A promise resolving to the upserted record.
+     */
+    async put(value, key) {
+        return this.db.put(this.storeName, value, key);
+    }
+    /**
+     * Removes a record from the object store by its primary key.
+     *
+     * @param key The primary key of the record to delete.
+     * @returns A promise resolving when the deletion is complete.
+     */
+    async delete(key) {
+        return this.db.delete(this.storeName, key);
+    }
+    /**
+     * Discards all records present in the object store.
+     *
+     * @returns A promise resolving when the store has been completely cleared.
+     */
+    async clear() {
+        return this.db.clear(this.storeName);
+    }
+}
+//# sourceMappingURL=Repository.js.map

package/esm/Repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Repository.js","sourceRoot":"","sources":["../src/Repository.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAQX;IACM;IARjB;;;;;OAKG;IACH,YACW,EAAU,EACJ,SAAiB;QADvB,OAAE,GAAF,EAAE,CAAQ;QACJ,cAAS,GAAT,SAAS,CAAQ;IAC/B,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAmB;QACjC,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACZ,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAI,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,KAAiB,EAAE,GAAqB;QACjD,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAI,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;IAClD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,KAAQ,EAAE,GAAqB;QACxC,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAI,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;IAClD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,GAAoB;QAChC,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IAC3C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACV,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;CACD"}

package/esm/adapters/RestAdapter.d.ts

@@ -0,0 +1,13 @@
+import type { BackendAdapter, SyncPullResult } from "./types.js";
+export interface RestAdapterConfig {
+    url: string;
+}
+export declare class RestAdapter implements BackendAdapter {
+    private config;
+    constructor(config: RestAdapterConfig);
+    checkAuth(): Promise<boolean>;
+    login(email: string, code: string): Promise<boolean>;
+    logout(): Promise<void>;
+    pull(cursor: string): Promise<SyncPullResult>;
+    push(payload: any[]): Promise<void>;
+}

package/esm/adapters/RestAdapter.js

@@ -0,0 +1,43 @@
+export class RestAdapter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async checkAuth() {
+        const res = await fetch(`${this.config.url}/api/session`, { credentials: "include" });
+        return res.ok;
+    }
+    async login(email, code) {
+        const res = await fetch(`${this.config.url}/api/session/login`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            credentials: "include",
+            body: JSON.stringify({ email, code }),
+        });
+        if (!res.ok)
+            throw new Error("Login failed");
+        return true;
+    }
+    async logout() {
+        await fetch(`${this.config.url}/api/session/logout`, { method: "POST", credentials: "include" });
+    }
+    async pull(cursor) {
+        const res = await fetch(`${this.config.url}/api/posts?after=${cursor}&limit=40`, {
+            credentials: "include",
+        });
+        if (!res.ok)
+            throw { status: res.status };
+        return await res.json();
+    }
+    async push(payload) {
+        const res = await fetch(`${this.config.url}/api/posts/upsert-many`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            credentials: "include",
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok)
+            throw { status: res.status };
+    }
+}
+//# sourceMappingURL=RestAdapter.js.map

package/esm/adapters/RestAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestAdapter.js","sourceRoot":"","sources":["../../src/adapters/RestAdapter.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,WAAW;IACH;IAApB,YAAoB,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1C,KAAK,CAAC,SAAS;QACrB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;QACrF,OAAO,GAAG,CAAC,EAAE,CAAA;IACd,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,IAAY;QAC7C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,oBAAoB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACrC,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;QAC5C,OAAO,IAAI,CAAA;IACZ,CAAC;IAEM,KAAK,CAAC,MAAM;QAClB,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;IACjG,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAc;QAC/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,oBAAoB,MAAM,WAAW,EAAE;YAChF,WAAW,EAAE,SAAS;SACtB,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;QACzC,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,OAAc;QAC/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,wBAAwB,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC7B,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;IAC1C,CAAC;CACD"}

package/esm/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./RestAdapter.js";
+export * from "./types.js";

package/esm/adapters/index.js

@@ -0,0 +1,3 @@
+export * from "./RestAdapter.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/esm/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA"}

package/esm/adapters/types.d.ts

@@ -0,0 +1,11 @@
+export interface SyncPullResult {
+    items: any[];
+    hasMore: boolean;
+}
+export interface BackendAdapter {
+    checkAuth(): Promise<boolean>;
+    login(email: string, code: string): Promise<boolean>;
+    logout(): Promise<void>;
+    pull(cursor: string): Promise<SyncPullResult>;
+    push(payload: any[]): Promise<void>;
+}

package/esm/adapters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/esm/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":""}

package/esm/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./DbRepository.js";
+export * from "./DbSync.js";
+export * from "./DbTxRepository.js";

package/esm/index.js

@@ -0,0 +1,4 @@
+export * from "./DbRepository.js";
+export * from "./DbSync.js";
+export * from "./DbTxRepository.js";
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA"}

package/esm/internal/AuthManager.d.ts

@@ -0,0 +1,13 @@
+import type { BackendAdapter } from "../adapters/types.js";
+import type { StorageManager } from "./StorageManager.js";
+export declare class AuthManager {
+    private adapter;
+    private storage;
+    private disableSync;
+    isAuth: boolean;
+    constructor(adapter: BackendAdapter, storage: StorageManager, disableSync: () => void);
+    checkAuth(): Promise<boolean>;
+    login(email: string, code: string): Promise<void>;
+    logout(): Promise<void>;
+    reset(): Promise<void>;
+}