@alexmitchell/melondb 0.0.0-stage → 0.1.1

package/lib/createMelon.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMelon = void 0;
+const watermelondb_1 = require("@nozbe/watermelondb");
+const randomId_1 = require("@nozbe/watermelondb/utils/common/randomId");
+const createWatermelon_1 = require("./createWatermelon");
+const sanitizeCircular_1 = require("./sanitizeCircular");
+const createMelon = (params) => {
+    const logging = params.logging ?? true;
+    if (params.idGenerator) {
+        (0, randomId_1.setGenerator)(params.idGenerator);
+    }
+    const watermelon = (0, createWatermelon_1.createWatermelon)(params);
+    /**
+     * Enhance a component with observable data while keeping strong type safety.
+     *
+     * @template Injected - Props injected into the component by the enhancer.
+     * @template Query - Props required by the enhancer (used to trigger observables).
+     * @template Props - Additional props required by the component (not used by the enhancer).
+     */
+    const enhance = (enhancer, Component) => {
+        return enhancer(Component);
+    };
+    const get = (tableName) => {
+        return watermelon.get(tableName);
+    };
+    const getRowById = async (tableName, id) => {
+        try {
+            const rows = await get(tableName).query(watermelondb_1.Q.where("id", id)).fetch();
+            return rows[0] ?? null;
+        }
+        catch {
+            if (logging) {
+                console.error("[🍈 MelonDB] Cannot find row:", tableName, id);
+            }
+            return null;
+        }
+    };
+    const insert = async (tableName, data) => {
+        return await watermelon.write(async () => {
+            const collection = get(tableName);
+            const record = await collection.create((record) => {
+                Object.assign(record, data);
+            });
+            return record.id;
+        });
+    };
+    const insertBatch = async (tableName, data) => {
+        return await watermelon.write(async () => {
+            const collection = get(tableName);
+            const newRows = data.map((row) => collection.prepareCreate((record) => {
+                Object.assign(record, row);
+            }));
+            await watermelon.batch(newRows);
+        });
+    };
+    const updateRow = async (model, updater) => {
+        return await watermelon.write(() => model.update(updater));
+    };
+    /**
+     * Update one column inside a write transaction.
+     * If the model has an `updatedDate` field, it is set to now (ISO string).
+     */
+    const updateColumn = (model, property, value) => {
+        return model.database.write(() => {
+            return model.update((row) => {
+                row[property] = value;
+                if ("updatedDate" in row) {
+                    row.updatedDate = new Date().toISOString();
+                }
+            });
+        });
+    };
+    /**
+     * Update several columns in one write transaction.
+     * If the model has an `updatedDate` field, it is set to now (ISO string).
+     */
+    const updateColumns = (model, columns) => {
+        return model.database.write(() => {
+            return model.update((row) => {
+                columns.forEach(({ property, value }) => {
+                    row[property] = value;
+                });
+                if ("updatedDate" in row) {
+                    row.updatedDate = new Date().toISOString();
+                }
+            });
+        });
+    };
+    const deleteRow = async (row) => {
+        await watermelon.write(async () => {
+            await row.markAsDeleted();
+        });
+    };
+    const deleteRowById = async (tableName, id) => {
+        if (!id) {
+            return;
+        }
+        const row = await getRowById(tableName, id);
+        if (!row) {
+            return;
+        }
+        return await deleteRow(row);
+    };
+    const deleteBatch = async (rows) => {
+        if (rows.length === 0) {
+            return;
+        }
+        await rows[0].collection.database.write(async () => {
+            for (const row of rows) {
+                await row.markAsDeleted();
+            }
+        });
+    };
+    /**
+     * Soft-delete every row in a table (`markAsDeleted`) in one write transaction.
+     */
+    const deleteTable = async (tableName) => {
+        await watermelon.write(async () => {
+            const collection = watermelon.collections.get(tableName);
+            const records = await collection.query().fetch();
+            if (records.length === 0) {
+                return;
+            }
+            for (const record of records) {
+                await record.markAsDeleted();
+            }
+        });
+    };
+    /**
+     * Permanently destroy every row in a table, in batched writes.
+     */
+    const emptyTable = async (tableName, batchSize = 500) => {
+        await watermelon.write(async () => {
+            const collection = watermelon.collections.get(tableName);
+            const records = await collection.query().fetch();
+            if (records.length === 0) {
+                return;
+            }
+            for (let i = 0; i < records.length; i += batchSize) {
+                const chunk = records.slice(i, i + batchSize);
+                const prepared = chunk.map((r) => r.prepareDestroyPermanently());
+                await watermelon.batch(prepared);
+            }
+        });
+    };
+    const getRowCount = async (tableName) => {
+        return await get(tableName).query().fetchCount();
+    };
+    const logRowCount = async (tableName) => {
+        const count = await getRowCount(tableName);
+        console.log(`[🍈 MelonDB] Total ${tableName} rows in DB: ${count}`);
+    };
+    const logAllRows = async (tableName) => {
+        const rows = await get(tableName).query().fetch();
+        for (const row of rows) {
+            console.log(JSON.stringify((0, sanitizeCircular_1.sanitizeCircular)(row)));
+        }
+    };
+    // Observers must unmount before unsafeResetDatabase — see WatermelonDB #102
+    let databaseAvailable = true;
+    const databaseAvailableListeners = new Set();
+    const getDatabaseAvailable = () => databaseAvailable;
+    const subscribeDatabaseAvailable = (listener) => {
+        databaseAvailableListeners.add(listener);
+        return () => {
+            databaseAvailableListeners.delete(listener);
+        };
+    };
+    const setDatabaseAvailable = (available) => {
+        if (databaseAvailable === available) {
+            return;
+        }
+        databaseAvailable = available;
+        databaseAvailableListeners.forEach((listener) => listener(available));
+    };
+    /**
+     * Reset the database safely: flip `databaseAvailable` to false first so UI
+     * that subscribes can unmount observers, then call `unsafeResetDatabase`.
+     */
+    const resetDatabase = async () => {
+        setDatabaseAvailable(false);
+        await new Promise((resolve) => {
+            requestAnimationFrame(() => {
+                requestAnimationFrame(() => resolve());
+            });
+        });
+        // Yield a macrotask so React can finish unmounting observers before we wipe the DB.
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        try {
+            await watermelon.write(async () => {
+                await watermelon.unsafeResetDatabase();
+                if (logging) {
+                    console.log("[🍈 MelonDB] Database reset");
+                }
+            });
+        }
+        finally {
+            setDatabaseAvailable(true);
+        }
+    };
+    return {
+        /** Underlying WatermelonDB `Database` instance. */
+        db: watermelon,
+        enhance,
+        get,
+        getRowById,
+        insert,
+        insertBatch,
+        updateRow,
+        updateColumn,
+        updateColumns,
+        deleteRow,
+        deleteRowById,
+        deleteBatch,
+        deleteTable,
+        emptyTable,
+        getRowCount,
+        logRowCount,
+        logAllRows,
+        resetDatabase,
+        getDatabaseAvailable,
+        subscribeDatabaseAvailable,
+    };
+};
+exports.createMelon = createMelon;
+//# sourceMappingURL=createMelon.js.map

package/lib/createMelon.js.map

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

package/lib/createWatermelon.d.ts

@@ -0,0 +1,16 @@
+import { Database } from '@nozbe/watermelondb';
+import { DatabaseProps } from '@nozbe/watermelondb/Database';
+import { AppSchemaSpec } from '@nozbe/watermelondb/Schema';
+import { SchemaMigrationsSpec } from '@nozbe/watermelondb/Schema/migrations';
+export type WatermelonParams = {
+    version: AppSchemaSpec['version'];
+    tables: AppSchemaSpec['tables'];
+    migrations: SchemaMigrationsSpec['migrations'];
+    modelClasses: DatabaseProps['modelClasses'];
+};
+/**
+ * Create a WatermelonDB `Database` with the usual schema + migrations setup,
+ * and a platform adapter (SQLite on native, LokiJS on web).
+ */
+export declare const createWatermelon: ({ version, tables, migrations, modelClasses, }: WatermelonParams) => Database;
+//# sourceMappingURL=createWatermelon.d.ts.map

package/lib/createWatermelon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWatermelon.d.ts","sourceRoot":"","sources":["../src/createWatermelon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAEL,oBAAoB,EACrB,MAAM,uCAAuC,CAAA;AAG9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IACjC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC/B,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAA;IAC9C,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;CAC5C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,gDAK9B,gBAAgB,aAgBlB,CAAA"}

package/lib/createWatermelon.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWatermelon = void 0;
+const watermelondb_1 = require("@nozbe/watermelondb");
+const migrations_1 = require("@nozbe/watermelondb/Schema/migrations");
+const createAdapter_1 = require("./createAdapter");
+/**
+ * Create a WatermelonDB `Database` with the usual schema + migrations setup,
+ * and a platform adapter (SQLite on native, LokiJS on web).
+ */
+const createWatermelon = ({ version, tables, migrations, modelClasses, }) => {
+    const schema = (0, watermelondb_1.appSchema)({
+        version,
+        tables,
+    });
+    const migrationConfig = (0, migrations_1.schemaMigrations)({
+        migrations,
+    });
+    const adapter = (0, createAdapter_1.createAdapter)({ schema, migrations: migrationConfig });
+    return new watermelondb_1.Database({
+        adapter,
+        modelClasses,
+    });
+};
+exports.createWatermelon = createWatermelon;
+//# sourceMappingURL=createWatermelon.js.map

package/lib/createWatermelon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWatermelon.js","sourceRoot":"","sources":["../src/createWatermelon.ts"],"names":[],"mappings":";;;AAAA,sDAAyD;AAGzD,sEAG8C;AAC9C,mDAA+C;AAS/C;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAAC,EAC/B,OAAO,EACP,MAAM,EACN,UAAU,EACV,YAAY,GACK,EAAE,EAAE;IACrB,MAAM,MAAM,GAAG,IAAA,wBAAS,EAAC;QACvB,OAAO;QACP,MAAM;KACP,CAAC,CAAA;IAEF,MAAM,eAAe,GAAG,IAAA,6BAAgB,EAAC;QACvC,UAAU;KACX,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC,CAAA;IAEtE,OAAO,IAAI,uBAAQ,CAAC;QAClB,OAAO;QACP,YAAY;KACb,CAAC,CAAA;AACJ,CAAC,CAAA;AArBY,QAAA,gBAAgB,oBAqB5B"}

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+export { createMelon } from "./createMelon";
+export type { Melon, MelonParams } from "./createMelon";
+export { createWatermelon } from "./createWatermelon";
+export type { WatermelonParams } from "./createWatermelon";
+export { createAdapter } from "./createAdapter";
+export { cleanRow } from "./cleanRow";
+export type { DirtyRaw } from "./cleanRow";
+export { sanitizeCircular } from "./sanitizeCircular";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeCircular = exports.cleanRow = exports.createAdapter = exports.createWatermelon = exports.createMelon = void 0;
+var createMelon_1 = require("./createMelon");
+Object.defineProperty(exports, "createMelon", { enumerable: true, get: function () { return createMelon_1.createMelon; } });
+var createWatermelon_1 = require("./createWatermelon");
+Object.defineProperty(exports, "createWatermelon", { enumerable: true, get: function () { return createWatermelon_1.createWatermelon; } });
+var createAdapter_1 = require("./createAdapter");
+Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return createAdapter_1.createAdapter; } });
+var cleanRow_1 = require("./cleanRow");
+Object.defineProperty(exports, "cleanRow", { enumerable: true, get: function () { return cleanRow_1.cleanRow; } });
+var sanitizeCircular_1 = require("./sanitizeCircular");
+Object.defineProperty(exports, "sanitizeCircular", { enumerable: true, get: function () { return sanitizeCircular_1.sanitizeCircular; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAGpB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAGzB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAGjB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/lib/sanitizeCircular.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Strip circular WatermelonDB model references so rows can be logged or
+ * JSON.stringified during debugging.
+ */
+export declare const sanitizeCircular: (obj: unknown, seen?: WeakSet<object>) => unknown;
+//# sourceMappingURL=sanitizeCircular.d.ts.map

package/lib/sanitizeCircular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeCircular.d.ts","sourceRoot":"","sources":["../src/sanitizeCircular.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,KAAK,OAAO,EACZ,sBAA4B,KAC3B,OAkEF,CAAA"}

package/lib/sanitizeCircular.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeCircular = void 0;
+const watermelondb_1 = require("@nozbe/watermelondb");
+/**
+ * Strip circular WatermelonDB model references so rows can be logged or
+ * JSON.stringified during debugging.
+ */
+const sanitizeCircular = (obj, seen = new WeakSet()) => {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (typeof obj !== 'object') {
+        return obj;
+    }
+    if (seen.has(obj)) {
+        return '[Circular Reference]';
+    }
+    if (obj instanceof watermelondb_1.Model) {
+        seen.add(obj);
+        const plain = {};
+        for (const key in obj) {
+            if (key !== '_raw' && key !== 'collection' && key !== 'database') {
+                try {
+                    const value = obj[key];
+                    if (typeof value !== 'function') {
+                        plain[key] = (0, exports.sanitizeCircular)(value, seen);
+                    }
+                }
+                catch {
+                    // Skip properties that throw on access
+                }
+            }
+        }
+        if ('_raw' in obj && typeof obj._raw === 'object') {
+            const raw = obj._raw;
+            for (const key in raw) {
+                if (key !== '_status' && key !== '_changed' && key !== 'id') {
+                    plain[key] = (0, exports.sanitizeCircular)(raw[key], seen);
+                }
+            }
+        }
+        plain._modelType = obj.constructor.name;
+        if ('id' in obj) {
+            plain.id = obj.id;
+        }
+        return plain;
+    }
+    if (Array.isArray(obj)) {
+        seen.add(obj);
+        return obj.map((item) => (0, exports.sanitizeCircular)(item, seen));
+    }
+    seen.add(obj);
+    const sanitized = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            try {
+                sanitized[key] = (0, exports.sanitizeCircular)(obj[key], seen);
+            }
+            catch {
+                sanitized[key] = '[Error accessing property]';
+            }
+        }
+    }
+    return sanitized;
+};
+exports.sanitizeCircular = sanitizeCircular;
+//# sourceMappingURL=sanitizeCircular.js.map

package/lib/sanitizeCircular.js.map

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

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@alexmitchell/melondb",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "private": false,
+  "description": "Typed helpers for WatermelonDB: less write() boilerplate, safer collection access, safer database resets.",
+  "license": "MIT",
+  "author": "Alex Mitchell",
+  "keywords": [
+    "watermelondb",
+    "react-native",
+    "expo",
+    "sqlite",
+    "offline",
+    "database",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlexanderDMitchell/melondb.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AlexanderDMitchell/melondb/issues"
+  },
+  "homepage": "https://github.com/AlexanderDMitchell/melondb#readme",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "react-native": "./src/index.ts",
+  "source": "./src/index.ts",
+  "files": [
+    "lib",
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf lib"
+  },
+  "peerDependencies": {
+    "@nozbe/watermelondb": ">=0.27.0",
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@nozbe/watermelondb": "^0.28.0",
+    "@types/react": "~19.2.2",
+    "react": "19.2.3",
+    "typescript": "~5.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": [
+    "./src/index.ts",
+    "./lib/index.js"
+  ]
+}

package/src/cleanRow.ts

@@ -0,0 +1,22 @@
+export type DirtyRaw = {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [key: string]: any
+}
+
+/**
+ * Build a mapper that strips WatermelonDB meta fields (`_status`, `_changed`)
+ * from a model's `_raw` and optionally merges extra fields.
+ *
+ * Useful when exporting rows to JSON, PDF, or a remote API.
+ */
+export const cleanRow = (changes: DirtyRaw = {}) => {
+  return (row?: DirtyRaw): DirtyRaw | undefined => {
+    if (!row) {
+      return undefined
+    }
+
+    const { _status, _changed, ...rest } = row._raw
+
+    return { ...rest, ...changes }
+  }
+}

package/src/createAdapter.ts

@@ -0,0 +1,7 @@
+import SQLiteAdapter from "@nozbe/watermelondb/adapters/sqlite";
+import { SQLiteAdapterOptions } from "@nozbe/watermelondb/adapters/sqlite/type";
+
+/** Native (iOS / Android) SQLite adapter. */
+export const createAdapter = (options: SQLiteAdapterOptions) => {
+  return new SQLiteAdapter(options);
+};

package/src/createAdapter.web.ts

@@ -0,0 +1,12 @@
+import LokiJSAdapter, {
+  LokiAdapterOptions,
+} from '@nozbe/watermelondb/adapters/lokijs'
+
+/** Web adapter (LokiJS + IndexedDB). Metro/webpack resolve this via `.web.ts`. */
+export const createAdapter = (options: LokiAdapterOptions) => {
+  return new LokiJSAdapter({
+    useWebWorker: false,
+    useIncrementalIndexedDB: true,
+    ...options,
+  })
+}