@plures/unum 0.2.2

package/dist/index.js

@@ -0,0 +1,200 @@
+/**
+ * unum - Local Svelte PluresDB Bindings
+ *
+ * A reactive Svelte binding library for PluresDB (pluresdb npm package).
+ */
+// Export store implementation
+export * from './store.js';
+// Export actions
+export * from './actions.js';
+// Export PluresDB helpers
+export * from './plures-helper.js';
+// Also export from gun-helper for backward compatibility
+export * from './plures-helper.js';
+/**
+ * Re-export unum and connect functions for easier imports
+ */
+import { unum, connect } from './unum.js';
+import { gun } from './GunContext.js';
+export { unum, connect, gun };
+export { gun as db, gun as plures }; // Alternative export names
+/**
+ * Creates a complete PluresDB-powered component with automatic synchronization
+ *
+ * This higher-level function creates a wrapped component that automatically
+ * syncs with PluresDB (from the 'pluresdb' npm package), without requiring any knowledge of
+ * the component's props structure. Just specify the component and path, and
+ * it handles the rest.
+ *
+ * @param {Object} options - Configuration options
+ * @param {Function} options.component - The component to bind with PluresDB data
+ * @param {Object} options.db - PluresDB instance from 'pluresdb' package (can also use 'gun' for compatibility)
+ * @param {string} options.path - PluresDB path for data storage
+ * @param {string} [options.id] - Optional ID for multiple instances of the same component
+ * @param {Object} [options.defaultData] - Default data to use ONLY if no data exists yet
+ * @param {Object} [options.props] - Additional props to pass to the component (not synced with PluresDB)
+ * @returns {Function} A self-contained component that handles the synchronization
+ */
+export function pluresComponent(options) {
+    const { component, db, gun, path, id, defaultData = {}, props: extraProps = {} } = options;
+    const dbInstance = db || gun; // Support both 'db' and 'gun' for compatibility
+    if (!component) {
+        console.error('Component is required for pluresComponent');
+        return () => null;
+    }
+    if (!dbInstance) {
+        console.error('PluresDB instance from the pluresdb package is required for pluresComponent');
+        return () => null;
+    }
+    if (!path) {
+        console.error('Path is required for pluresComponent');
+        return () => null;
+    }
+    // The full path including optional ID
+    const fullPath = id ? `${path}_${id}` : path;
+    // Return a dynamically created component constructor
+    return class PluresComponentWrapper {
+        constructor(options = {}) {
+            this.options = options;
+            this.Component = component;
+            this.instance = null;
+            this.isMounted = false;
+            this.dbNode = dbInstance.get(fullPath);
+            this.proxyData = null;
+            this.unsubscribe = null;
+            this.isUpdatingFromDb = false; // Flag to prevent circular updates
+            this.lastSnapshot = JSON.stringify({}); // Used to track changes
+            // Initialize data if empty
+            this.dbNode.once(data => {
+                if (!data || Object.keys(data).filter(k => k !== '_').length === 0) {
+                    // Only apply default data if empty
+                    if (defaultData && Object.keys(defaultData).length > 0) {
+                        this.dbNode.put(defaultData);
+                    }
+                }
+            });
+            // Create reactive proxy
+            this.proxyData = this.createReactiveProxy();
+        }
+        // Create a proxy that automatically syncs with PluresDB
+        createReactiveProxy() {
+            // Initial state
+            const state = { ...defaultData };
+            // Create proxy
+            const proxy = new Proxy(state, {
+                get: (target, prop) => {
+                    return target[prop];
+                },
+                set: (target, prop, value) => {
+                    // Set value in state
+                    target[prop] = value;
+                    // Only update PluresDB if not updating from PluresDB
+                    if (!this.isUpdatingFromDb && this.dbNode) {
+                        // Update PluresDB
+                        this.dbNode.get(prop).put(value);
+                        // Handle arrays
+                        if (Array.isArray(value)) {
+                            this.wrapArrayMethods(value, prop);
+                        }
+                    }
+                    // Update component if mounted
+                    if (this.isMounted && this.instance) {
+                        const props = {};
+                        props[prop] = value;
+                        this.instance.$set(props);
+                    }
+                    return true;
+                },
+                deleteProperty: (target, prop) => {
+                    delete target[prop];
+                    // Update PluresDB
+                    if (!this.isUpdatingFromDb && this.dbNode) {
+                        this.dbNode.get(prop).put(null);
+                    }
+                    return true;
+                }
+            });
+            return proxy;
+        }
+        // Wrap array methods to detect changes
+        wrapArrayMethods(array, propPath) {
+            ['push', 'pop', 'shift', 'unshift', 'splice', 'reverse', 'sort'].forEach(method => {
+                const original = array[method];
+                array[method] = function (...args) {
+                    // Call original
+                    const result = original.apply(this, args);
+                    // Update PluresDB with entire array
+                    if (this.dbNode) {
+                        this.dbNode.get(propPath).put(array);
+                    }
+                    return result;
+                }.bind(this);
+            });
+            return array;
+        }
+        mount(target) {
+            if (!target) {
+                console.error('Target element is required for mounting');
+                return this;
+            }
+            // Get initial props
+            const props = {
+                ...this.proxyData,
+                ...extraProps,
+                ...this.options?.props
+            };
+            // Create the component instance
+            this.instance = new this.Component({
+                target,
+                props
+            });
+            // Mark as mounted
+            this.isMounted = true;
+            // Subscribe to PluresDB updates
+            this.unsubscribe = this.dbNode.on((data) => {
+                if (!data)
+                    return;
+                // Filter out PluresDB metadata
+                const cleanData = {};
+                for (const key in data) {
+                    if (key !== '_' && !key.startsWith('_')) {
+                        cleanData[key] = data[key];
+                    }
+                }
+                // Update proxy without triggering PluresDB updates
+                this.isUpdatingFromDb = true;
+                try {
+                    // Update all properties
+                    for (const key in cleanData) {
+                        // Update proxy
+                        this.proxyData[key] = cleanData[key];
+                    }
+                    // Update component if mounted
+                    if (this.isMounted && this.instance) {
+                        this.instance.$set(cleanData);
+                    }
+                }
+                finally {
+                    this.isUpdatingFromDb = false;
+                }
+            });
+            return this;
+        }
+        destroy() {
+            // Unsubscribe from PluresDB
+            if (this.unsubscribe) {
+                this.unsubscribe();
+                this.unsubscribe = null;
+            }
+            // Destroy component
+            if (this.instance && typeof this.instance.$destroy === 'function') {
+                this.instance.$destroy();
+                this.instance = null;
+            }
+            this.isMounted = false;
+        }
+    };
+}
+// Legacy export for backward compatibility
+export const gunComponent = pluresComponent;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/plures-helper.d.ts

@@ -0,0 +1,41 @@
+/**
+ * unum - PluresDB Helper Utilities
+ *
+ * This module provides helper functions for working with PluresDB in Svelte.
+ * PluresDB is a Gun.js-compatible database available at npm package 'pluresdb'.
+ */
+/**
+ * Get a reference to the PluresDB constructor when loaded from CDN
+ */
+export function getPlures(options: any): any;
+/**
+ * Checks if PluresDB is available
+ */
+export function isPluresAvailable(): boolean;
+/**
+ * Helper to safely access PluresDB data with nested properties
+ */
+export function safeGet(obj: any, path: any, defaultValue?: any): any;
+/**
+ * Helper to safely process PluresDB data in a map operation
+ */
+export function safeMap(dbData: any, callback: any, filterFn?: any): any[];
+/**
+ * Create a PluresDB chain with safety checks
+ */
+export function safeChain(db: any, path: any): any;
+/**
+ * unum - PluresDB Helper Utilities
+ *
+ * This module provides helper functions for working with PluresDB in Svelte.
+ * PluresDB is a Gun.js-compatible database available at npm package 'pluresdb'.
+ */
+/**
+ * Get a reference to the PluresDB constructor when loaded from CDN
+ */
+export function getGun(options: any): any;
+/**
+ * Checks if PluresDB is available
+ */
+export function isGunAvailable(): boolean;
+//# sourceMappingURL=plures-helper.d.ts.map

package/dist/plures-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plures-helper.d.ts","sourceRoot":"","sources":["../src/plures-helper.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,6CAcC;AAED;;GAEG;AACH,6CAEC;AAED;;GAEG;AACH,sEAmBC;AAED;;GAEG;AACH,2EA2BC;AAED;;GAEG;AACH,mDAyBC;AArHD;;;;;GAKG;AAEH;;GAEG;AACH,0CAcC;AAED;;GAEG;AACH,0CAEC"}

package/dist/plures-helper.js

@@ -0,0 +1,114 @@
+/**
+ * unum - PluresDB Helper Utilities
+ *
+ * This module provides helper functions for working with PluresDB in Svelte.
+ * PluresDB is a Gun.js-compatible database available at npm package 'pluresdb'.
+ */
+/**
+ * Get a reference to the PluresDB constructor when loaded from CDN
+ */
+export function getPlures(options) {
+    // First check if PluresDB/Gun was loaded via CDN
+    if (typeof window !== 'undefined' && (window.GunDB || window.Gun)) {
+        try {
+            const DB = window.GunDB || window.Gun;
+            return new DB(options);
+        }
+        catch (error) {
+            console.error('Error initializing PluresDB:', error);
+            return null;
+        }
+    }
+    console.warn('PluresDB/Gun.js not available. Make sure to include it via CDN script tag or install the pluresdb npm package.');
+    return null;
+}
+/**
+ * Checks if PluresDB is available
+ */
+export function isPluresAvailable() {
+    return typeof window !== 'undefined' && (window.GunDB !== undefined || window.Gun !== undefined);
+}
+/**
+ * Helper to safely access PluresDB data with nested properties
+ */
+export function safeGet(obj, path, defaultValue = undefined) {
+    if (!obj)
+        return defaultValue;
+    try {
+        const parts = path.split('.');
+        let result = obj;
+        for (const part of parts) {
+            if (result === undefined || result === null) {
+                return defaultValue;
+            }
+            result = result[part];
+        }
+        return result === undefined ? defaultValue : result;
+    }
+    catch (error) {
+        console.error(`Error getting path ${path}:`, error);
+        return defaultValue;
+    }
+}
+/**
+ * Helper to safely process PluresDB data in a map operation
+ */
+export function safeMap(dbData, callback, filterFn = null) {
+    if (!dbData || typeof dbData !== 'object') {
+        return [];
+    }
+    try {
+        // Convert to entries and filter out metadata
+        let entries = Object.entries(dbData).filter(([key]) => key !== '_');
+        // Apply additional filter if provided
+        if (filterFn && typeof filterFn === 'function') {
+            entries = entries.filter(([key, value]) => filterFn(key, value));
+        }
+        // Map the data
+        return entries.map(([key, value]) => {
+            try {
+                return callback(key, value);
+            }
+            catch (error) {
+                console.error(`Error processing item ${key}:`, error);
+                return null;
+            }
+        }).filter(item => item !== null);
+    }
+    catch (error) {
+        console.error('Error processing PluresDB data:', error);
+        return [];
+    }
+}
+/**
+ * Create a PluresDB chain with safety checks
+ */
+export function safeChain(db, path) {
+    if (!db) {
+        console.error('No PluresDB instance provided');
+        return null;
+    }
+    try {
+        if (!path)
+            return db;
+        let chain = db;
+        const parts = path.split('.');
+        for (const part of parts) {
+            if (part === '#') {
+                chain = chain.map();
+            }
+            else {
+                chain = chain.get(part);
+            }
+        }
+        return chain;
+    }
+    catch (error) {
+        console.error(`Error creating PluresDB chain for path ${path}:`, error);
+        return null;
+    }
+}
+// Legacy exports for backward compatibility
+export const getGun = getPlures;
+export const isGunAvailable = isPluresAvailable;
+//# sourceMappingURL=plures-helper.js.map

package/dist/plures-helper.js.map

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

package/dist/runes.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Creates a reactive connection to a PluresDB path
+ * This is the primary API for Svelte 5 components to use PluresDB data
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { pluresData } from 'unum';
+ *
+ *   // Create a reactive connection to PluresDB data
+ *   const todos = pluresData('todos');
+ *
+ *   // Access a specific todo by ID
+ *   const todo = pluresData('todos', 'specific-id');
+ *
+ *   // Create a new todo
+ *   function addTodo(text) {
+ *     todos.add({ text, completed: false });
+ *   }
+ *
+ *   // Toggle a todo's completed status
+ *   function toggleTodo(id) {
+ *     todo.update(id, current => ({ ...current, completed: !current.completed }));
+ *   }
+ *
+ *   // Delete a todo
+ *   function deleteTodo(id) {
+ *     todos.remove(id);
+ *   }
+ * </script>
+ *
+ * <!-- Use the data directly in the template -->
+ * <ul>
+ *   {#each todos.list() as item}
+ *     <li>{item.text}</li>
+ *   {/each}
+ * </ul>
+ * ```
+ */
+export function pluresData(path: any, id?: any): {
+    readonly state: {};
+    readonly value: {};
+    list: () => any[];
+    add: (data: any) => void;
+    update: (itemId: any, updater: any) => void;
+    remove: (itemId?: any) => void;
+    subscribe: (callback: any) => () => void;
+    destroy: () => void;
+};
+/**
+ * Creates a derived state from PluresDB data - allows transforming/filtering PluresDB data
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { pluresData, pluresDerived } from 'unum';
+ *
+ *   const todos = pluresData('todos');
+ *   const completedTodos = pluresDerived(todos, items => items.filter(item => item.completed));
+ * </script>
+ *
+ * <h2>Completed Todos</h2>
+ * <ul>
+ *   {#each completedTodos.value as item}
+ *     <li>{item.text}</li>
+ *   {/each}
+ * </ul>
+ * ```
+ */
+export function pluresDerived(pluresData: any, transformer: any): {
+    readonly value: any[];
+    destroy(): void;
+};
+/**
+ * Creates a two-way binding between a form input and PluresDB data
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { pluresBind } from 'unum';
+ *
+ *   const userProfile = pluresData('userProfile');
+ *   const nameBinding = pluresBind(userProfile, 'name');
+ * </script>
+ *
+ * <input type="text" bind:value={nameBinding.value} />
+ * ```
+ */
+export function pluresBind(pluresData: any, field: any): {
+    value: any;
+    destroy(): void;
+};
+/**
+ * Creates a reactive connection to a PluresDB path
+ * This is the primary API for Svelte 5 components to use PluresDB data
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { pluresData } from 'unum';
+ *
+ *   // Create a reactive connection to PluresDB data
+ *   const todos = pluresData('todos');
+ *
+ *   // Access a specific todo by ID
+ *   const todo = pluresData('todos', 'specific-id');
+ *
+ *   // Create a new todo
+ *   function addTodo(text) {
+ *     todos.add({ text, completed: false });
+ *   }
+ *
+ *   // Toggle a todo's completed status
+ *   function toggleTodo(id) {
+ *     todo.update(id, current => ({ ...current, completed: !current.completed }));
+ *   }
+ *
+ *   // Delete a todo
+ *   function deleteTodo(id) {
+ *     todos.remove(id);
+ *   }
+ * </script>
+ *
+ * <!-- Use the data directly in the template -->
+ * <ul>
+ *   {#each todos.list() as item}
+ *     <li>{item.text}</li>
+ *   {/each}
+ * </ul>
+ * ```
+ */
+export function gunData(path: any, id?: any): {
+    readonly state: {};
+    readonly value: {};
+    list: () => any[];
+    add: (data: any) => void;
+    update: (itemId: any, updater: any) => void;
+    remove: (itemId?: any) => void;
+    subscribe: (callback: any) => () => void;
+    destroy: () => void;
+};
+/**
+ * Creates a derived state from PluresDB data - allows transforming/filtering PluresDB data
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { pluresData, pluresDerived } from 'unum';
+ *
+ *   const todos = pluresData('todos');
+ *   const completedTodos = pluresDerived(todos, items => items.filter(item => item.completed));
+ * </script>
+ *
+ * <h2>Completed Todos</h2>
+ * <ul>
+ *   {#each completedTodos.value as item}
+ *     <li>{item.text}</li>
+ *   {/each}
+ * </ul>
+ * ```
+ */
+export function gunDerived(pluresData: any, transformer: any): {
+    readonly value: any[];
+    destroy(): void;
+};
+/**
+ * Creates a two-way binding between a form input and PluresDB data
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { pluresBind } from 'unum';
+ *
+ *   const userProfile = pluresData('userProfile');
+ *   const nameBinding = pluresBind(userProfile, 'name');
+ * </script>
+ *
+ * <input type="text" bind:value={nameBinding.value} />
+ * ```
+ */
+export function gunBind(pluresData: any, field: any): {
+    value: any;
+    destroy(): void;
+};
+//# sourceMappingURL=runes.d.ts.map

package/dist/runes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runes.d.ts","sourceRoot":"","sources":["../src/runes.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH;;;;;;;;;EA+MC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;EAiCC;AAED;;;;;;;;;;;;;;GAcG;AACH;;;EA4BC;AA1VD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH;;;;;;;;;EA+MC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;EAiCC;AAED;;;;;;;;;;;;;;GAcG;AACH;;;EA4BC"}