supastash 0.2.0 → 0.2.2

package/dist/utils/syncStatus.js

@@ -1,129 +0,0 @@
-import { getSupastashDb } from "../db/dbInitializer";
-import { logWarn } from "./logs";
-import { createDeletedStatusTable, createSyncStatusTable, } from "./schema/createSyncStatus";
-const SYNC_STATUS_TABLE = "supastash_sync_status";
-const DELETED_STATUS_TABLE = "supastash_deleted_status";
-const LAST_CREATED_TABLE = "supastash_last_created";
-/**
- * Clears the sync log for a given table
- * @param tableName - The name of the table to clear the sync status for
- * @example
- * clearLocalSyncLog("users");
- */
-export async function clearLocalSyncLog(tableName) {
-    const db = await getSupastashDb();
-    await db.runAsync(`DELETE FROM ${SYNC_STATUS_TABLE} WHERE table_name = ?`, [
-        tableName,
-    ]);
-    await db.runAsync(`DELETE FROM ${LAST_CREATED_TABLE} WHERE table_name = ?`, [
-        tableName,
-    ]);
-}
-/**
- * Clears the sync log for all local tables
- * @example
- * clearAllLocalSyncLog();
- */
-export async function clearAllLocalSyncLog() {
-    const db = await getSupastashDb();
-    await db.runAsync(`DROP TABLE IF EXISTS ${SYNC_STATUS_TABLE}`);
-    await db.runAsync(`DROP TABLE IF EXISTS ${LAST_CREATED_TABLE}`);
-    await createSyncStatusTable();
-}
-/**
- * Gets the sync log for a given table
- * @param tableName - The name of the table to get the sync log for
- * @example
- * const syncLog = await getLocalSyncLog("users");
- * console.log(syncLog);
- * // { table_name: "users", last_synced_at: "2021-01-01T00:00:00.000Z" }
- */
-export async function getLocalSyncLog(tableName) {
-    const db = await getSupastashDb();
-    const syncStatus = await db.getFirstAsync(`SELECT * FROM ${SYNC_STATUS_TABLE} WHERE table_name = ?`, [tableName]);
-    const createdStatus = await db.getFirstAsync(`SELECT * FROM ${LAST_CREATED_TABLE} WHERE table_name = ?`, [tableName]);
-    if (!syncStatus) {
-        return null;
-    }
-    return {
-        ...syncStatus,
-        lastCreatedAt: createdStatus?.last_created_at,
-    };
-}
-/**
- * Sets the sync log for a given table
- * @param tableName - The name of the table to set the sync log for
- * @param lastSyncedAt - The last synced at timestamp
- * @param lastCreatedAt - The last created at timestamp
- * @example
- * setLocalSyncLog("users", new Date().toISOString());
- */
-export async function setLocalSyncLog(tableName, lastSyncedAt, lastCreatedAt) {
-    const db = await getSupastashDb();
-    if (lastSyncedAt) {
-        const row = await db.getFirstAsync(`SELECT last_synced_at FROM ${SYNC_STATUS_TABLE} WHERE table_name=? LIMIT 1`, [tableName]);
-        if (row?.last_synced_at &&
-            new Date(lastSyncedAt) > new Date(row.last_synced_at)) {
-            lastSyncedAt = row.last_synced_at;
-        }
-        await db.runAsync(`INSERT OR REPLACE INTO ${SYNC_STATUS_TABLE} (table_name, last_synced_at) VALUES (?, ?)`, [tableName, lastSyncedAt]);
-    }
-    else {
-        logWarn(`No last synced at timestamp for table ${tableName}`);
-    }
-    if (lastCreatedAt) {
-        const rowCreated = await db.getFirstAsync(`SELECT last_created_at FROM ${LAST_CREATED_TABLE} WHERE table_name=? LIMIT 1`, [tableName]);
-        if (rowCreated?.last_created_at &&
-            new Date(lastCreatedAt) > new Date(rowCreated.last_created_at)) {
-            lastCreatedAt = rowCreated.last_created_at;
-        }
-        await db.runAsync(`INSERT OR REPLACE INTO ${LAST_CREATED_TABLE} (table_name, last_created_at) VALUES (?, ?)`, [tableName, lastCreatedAt]);
-    }
-}
-/**
- * Clears the delete log for a given table
- * @param tableName - The name of the table to clear the delete log for
- * @example
- * clearLocalDeleteLog("users");
- */
-export async function clearLocalDeleteLog(tableName) {
-    const db = await getSupastashDb();
-    await db.runAsync(`DELETE FROM ${DELETED_STATUS_TABLE} WHERE table_name = ?`, [tableName]);
-}
-/**
- * Clears the delete status for all local tables
- * @example
- * clearAllLocalDeleteLog();
- */
-export async function clearAllLocalDeleteLog() {
-    const db = await getSupastashDb();
-    await db.runAsync(`DROP TABLE IF EXISTS ${DELETED_STATUS_TABLE}`);
-    await createDeletedStatusTable();
-}
-/**
- * Gets the delete log for a given table
- * @param tableName - The name of the table to get the delete log for
- * @example
- * const deleteLog = await getLocalDeleteLog("users");
- * console.log(deleteLog);
- * // { table_name: "users", last_deleted_at: "2021-01-01T00:00:00.000Z" }
- */
-export async function getLocalDeleteLog(tableName) {
-    const db = await getSupastashDb();
-    const deleteStatus = await db.getFirstAsync(`SELECT * FROM ${DELETED_STATUS_TABLE} WHERE table_name = ?`, [tableName]);
-    if (!deleteStatus) {
-        return null;
-    }
-    return deleteStatus;
-}
-/**
- * Sets the delete log for a given table
- * @param tableName - The name of the table to set the delete log for
- * @param lastDeletedAt - The last deleted at timestamp
- * @example
- * setLocalDeleteLog("users", new Date().toISOString());
- */
-export async function setLocalDeleteLog(tableName, lastDeletedAt) {
-    const db = await getSupastashDb();
-    await db.runAsync(`INSERT OR REPLACE INTO ${DELETED_STATUS_TABLE} (table_name, last_deleted_at) VALUES (?, ?)`, [tableName, lastDeletedAt]);
-}

package/dist/utils/syncUpdate.d.ts

@@ -1,7 +0,0 @@
-/**
- * Updates synced_at from null to a timeStamp
- * @param tableName - The name of the table to update
- * @param id - The id of the row to update
- */
-export declare function updateLocalSyncedAt(tableName: string, ids: string[]): Promise<void>;
-//# sourceMappingURL=syncUpdate.d.ts.map

package/dist/utils/syncUpdate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncUpdate.d.ts","sourceRoot":"","sources":["../../src/utils/syncUpdate.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,iBAczE"}

package/dist/utils/syncUpdate.js

@@ -1,18 +0,0 @@
-import { getSupastashDb } from "../db/dbInitializer";
-import { logError } from "./logs";
-/**
- * Updates synced_at from null to a timeStamp
- * @param tableName - The name of the table to update
- * @param id - The id of the row to update
- */
-export async function updateLocalSyncedAt(tableName, ids) {
-    try {
-        const db = await getSupastashDb();
-        const timeStamp = new Date().toISOString();
-        const placeholders = ids.map(() => "?").join(", ");
-        await db.runAsync(`UPDATE ${tableName} SET synced_at = ? WHERE id IN (${placeholders})`, [timeStamp, ...ids]);
-    }
-    catch (error) {
-        logError(error);
-    }
-}

package/dist/utils/tableValidator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tableValidator.d.ts","sourceRoot":"","sources":["../../src/utils/tableValidator.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,iBAOxD"}

package/dist/utils/toggleSupastashMode.d.ts

@@ -1,28 +0,0 @@
-import { SupastashMode } from "../types/supastashConfig.types";
-/**
- * Reinitializes Supastash in a different runtime mode.
- *
- * This performs a full, deterministic teardown and re-startup of Supastash
- * to safely transition between execution modes (e.g. "live" ↔ "ghost").
- *
- * Lifecycle guarantees:
- * 1. All active sync loops are stopped.
- * 2. All realtime subscriptions are unsubscribed.
- * 3. The Supastash configuration is updated with the new mode.
- * 4. The active local database connection is closed.
- * 5. A new database connection is opened using the resolved mode-specific database.
- * 6. Sync and realtime systems are restarted only when entering "live" mode.
- *
- * Important invariants:
- * - Mode switching is NOT supported at runtime without reinitialization.
- * - Ghost Mode guarantees zero network activity:
- *   no sync, no realtime, no background jobs, and no server access.
- * - Data written in Ghost Mode is fully isolated and never synchronized.
- *
- * This function must be the ONLY supported way to change Supastash modes.
- * Direct mutation of the Supastash configuration is unsafe and unsupported.
- *
- * @param mode The target Supastash runtime mode.
- */
-export declare function reinitializeSupastash(mode: SupastashMode): Promise<void>;
-//# sourceMappingURL=toggleSupastashMode.d.ts.map

package/dist/utils/toggleSupastashMode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toggleSupastashMode.d.ts","sourceRoot":"","sources":["../../src/utils/toggleSupastashMode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,aAAa,iBAoB9D"}

package/dist/utils/toggleSupastashMode.js

@@ -1,46 +0,0 @@
-import { configureSupastash, getSupastashConfig } from "../core/config";
-import { closeSupastashDb, getSupastashDb } from "../db/dbInitializer";
-import { supastashEventBus } from "./events/eventBus";
-/**
- * Reinitializes Supastash in a different runtime mode.
- *
- * This performs a full, deterministic teardown and re-startup of Supastash
- * to safely transition between execution modes (e.g. "live" ↔ "ghost").
- *
- * Lifecycle guarantees:
- * 1. All active sync loops are stopped.
- * 2. All realtime subscriptions are unsubscribed.
- * 3. The Supastash configuration is updated with the new mode.
- * 4. The active local database connection is closed.
- * 5. A new database connection is opened using the resolved mode-specific database.
- * 6. Sync and realtime systems are restarted only when entering "live" mode.
- *
- * Important invariants:
- * - Mode switching is NOT supported at runtime without reinitialization.
- * - Ghost Mode guarantees zero network activity:
- *   no sync, no realtime, no background jobs, and no server access.
- * - Data written in Ghost Mode is fully isolated and never synchronized.
- *
- * This function must be the ONLY supported way to change Supastash modes.
- * Direct mutation of the Supastash configuration is unsafe and unsupported.
- *
- * @param mode The target Supastash runtime mode.
- */
-export async function reinitializeSupastash(mode) {
-    // 1. HARD STOP — no branching here
-    supastashEventBus.emit("stopSupastashSync");
-    supastashEventBus.emit("unsubscribeRealtime");
-    // 2. Update config (mode switch)
-    const prev = getSupastashConfig();
-    configureSupastash({
-        ...prev,
-        supastashMode: mode,
-    });
-    await closeSupastashDb();
-    await getSupastashDb();
-    // 3. Restart ONLY if live
-    if (mode === "live") {
-        supastashEventBus.emit("startSupastashSync");
-        supastashEventBus.emit("restartRealtime");
-    }
-}