@plures/unum 0.2.2

package/dist/gunComponent.js

@@ -0,0 +1,205 @@
+/**
+ * unum - PluresDB-powered Component Wrapper
+ *
+ * This module provides a higher-level component wrapper that simplifies
+ * binding Svelte components to PluresDB (pluresdb npm package) data.
+ */
+import { gun as gunStore } from './GunContext.js';
+import { writable, get } from 'svelte/store';
+/**
+ * Wraps any Svelte component with PluresDB integration
+ *
+ * @param {Component} Component - The Svelte component to wrap
+ * @param {Object} options - Configuration options
+ * @param {string} options.path - The PluresDB path to store data
+ * @param {string} [options.id] - Optional ID for this specific instance
+ * @param {Object} [options.defaultData] - Default data to use if PluresDB has no data
+ * @returns {Component} A new component that wraps the original with PluresDB integration
+ */
+export function gunComponent(Component, { path, id, defaultData = {} }) {
+    // Generate unique ID if not provided
+    const instanceId = id || `${path}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+    const gunPath = `${path}/${instanceId}`;
+    // Create a component that properly works with Svelte 5 runes mode
+    return function GunWrappedComponent(props) {
+        // Create a store for our props
+        const propsStore = writable({ ...defaultData, ...props });
+        // Flag to prevent circular updates
+        let isUpdatingFromGun = false;
+        // Gun reference and unsubscribe function
+        let gunNodeRef = null;
+        let gunUnsubscribe = null;
+        // Last known state for comparison
+        let lastKnownState = { ...defaultData, ...props };
+        // Setup Gun subscription
+        let cleanup = null;
+        // Set up our Gun subscription
+        function setup() {
+            const unsubGun = gunStore.subscribe($gun => {
+                if (!$gun)
+                    return;
+                // Get the Gun node for this component
+                const gunNode = $gun.get(gunPath);
+                gunNodeRef = gunNode;
+                // Initialize with default data if empty
+                gunNode.once(data => {
+                    if (!data || Object.keys(data).filter(k => k !== '_').length === 0) {
+                        // Initialize with combined default and initial props
+                        const initialData = { ...defaultData, ...props };
+                        gunNode.put(initialData);
+                    }
+                });
+                // Subscribe to Gun data changes
+                if (gunUnsubscribe) {
+                    gunUnsubscribe();
+                }
+                // Listen for updates
+                gunUnsubscribe = gunNode.on((data) => {
+                    if (!data)
+                        return;
+                    // Filter out Gun metadata
+                    const cleanData = {};
+                    for (const key in data) {
+                        if (key !== '_' && !key.startsWith('_')) {
+                            cleanData[key] = data[key];
+                        }
+                    }
+                    // Prevent circular updates
+                    if (JSON.stringify(cleanData) !== JSON.stringify(lastKnownState)) {
+                        isUpdatingFromGun = true;
+                        // Update store
+                        propsStore.set(cleanData);
+                        // Update last known state
+                        lastKnownState = { ...cleanData };
+                        // Reset update flag after a tick
+                        setTimeout(() => {
+                            isUpdatingFromGun = false;
+                        }, 0);
+                    }
+                });
+            });
+            // Return cleanup function
+            return () => {
+                if (gunUnsubscribe) {
+                    gunUnsubscribe();
+                    gunUnsubscribe = null;
+                }
+                unsubGun();
+            };
+        }
+        // Handle changes from the component
+        function handleUpdate(event) {
+            if (isUpdatingFromGun)
+                return;
+            const detail = event?.detail;
+            if (!detail)
+                return;
+            // Update our state
+            lastKnownState = { ...lastKnownState, ...detail };
+            // Update Gun
+            if (gunNodeRef) {
+                gunNodeRef.put(lastKnownState);
+            }
+        }
+        // Update Gun when props change
+        function syncToGun() {
+            if (isUpdatingFromGun || !gunNodeRef)
+                return;
+            // Get current props
+            const currentProps = get(propsStore);
+            // Update Gun if different
+            if (JSON.stringify(currentProps) !== JSON.stringify(lastKnownState)) {
+                lastKnownState = { ...currentProps };
+                gunNodeRef.put(currentProps);
+            }
+        }
+        // Create our component instance with proper lifecycle hooks
+        return {
+            // Set up when component is created  
+            $$render() {
+                // Setup our Gun subscription if needed
+                if (!cleanup) {
+                    cleanup = setup();
+                }
+                // Get derived props
+                const $props = get(propsStore);
+                // Sync to Gun when props change
+                syncToGun();
+                // Render the component with derived props
+                return Component.render
+                    ? Component.render($props, {}) // For Svelte compiler >= 5
+                    : Component({ ...props, ...$props });
+            },
+            // Set up event handlers
+            $$events: {
+                update: handleUpdate,
+                change: handleUpdate,
+                input: handleUpdate,
+            },
+            // Clean up subscriptions when component is destroyed
+            $$destroy() {
+                if (cleanup) {
+                    cleanup();
+                    cleanup = null;
+                }
+            }
+        };
+    };
+}
+/**
+ * Creates a Svelte component that wraps another component with PluresDB integration
+ * This provides a cleaner API for creating PluresDB-powered components
+ *
+ * @param {Component} Component - The component to wrap
+ * @param {string} path - PluresDB path for data storage
+ * @param {Object} [options] - Additional options
+ * @param {string} [options.id] - Optional ID for this instance
+ * @param {Object} [options.defaultData] - Default data to use
+ * @returns {Component} A new Svelte component
+ *
+ * @example
+ * // Create a PluresDB-powered TodoApp
+ * import { wrapWithGun } from '$lib/unum/gunComponent';
+ * import TodoApp from './TodoApp.svelte';
+ *
+ * // Simple API - component knows nothing about PluresDB
+ * export const PluresTodοApp = wrapWithGun(TodoApp, 'todos', {
+ *   defaultData: { items: [] }
+ * });
+ *
+ * // In a parent component, use it like a normal component
+ * <PluresTodοApp title="My Todo List" />
+ */
+export function wrapWithGun(Component, path, options = {}) {
+    // Create a properly formatted component wrapper
+    const WrappedComponent = function (props) {
+        const wrapper = gunComponent(Component, {
+            path,
+            id: options.id,
+            defaultData: options.defaultData || {}
+        });
+        // Create a new instance of the wrapper with the props
+        const instance = new wrapper(props);
+        // Return the instance
+        return instance;
+    };
+    // Make it look like a Svelte component
+    WrappedComponent.$$render = function ($$props) {
+        const props = $$props || {};
+        const instance = new WrappedComponent(props);
+        return instance.$$render ? instance.$$render() : '';
+    };
+    // Add other important Svelte component properties
+    WrappedComponent.render = function (props, options) {
+        const wrapper = gunComponent(Component, {
+            path,
+            id: options?.id || options.id,
+            defaultData: options.defaultData || {}
+        });
+        // For Svelte 5
+        const instance = new wrapper(props);
+        return instance.$$render ? instance.$$render() : '';
+    };
+    return WrappedComponent;
+}
+//# sourceMappingURL=gunComponent.js.map

package/dist/gunComponent.js.map

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

package/dist/gunify.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Creates a Gun-powered version of any Svelte component
+ *
+ * This function takes a component and returns a new function component
+ * that automatically binds Gun.js data to the original component's props structure.
+ *
+ * @param {Component} Component - The Svelte component to enhance
+ * @param {Object} options - Options for the binding
+ * @param {string} options.path - Gun.js path for the data
+ * @param {string} [options.id] - Optional ID for specific component instance
+ * @param {Object} [options.defaultProps] - Default props to use when Gun data is not available
+ * @returns {Component} A new component that wraps the original with Gun.js binding
+ *
+ * @example
+ * // Create a Gun-powered TodoList component
+ * import { unum } from '$lib/svgun/unum';
+ * import TodoList from './TodoList.svelte';
+ *
+ * export const GunTodoList = unum(TodoList, {
+ *   path: 'todos',
+ *   defaultProps: { items: [] }
+ * });
+ *
+ * // In a parent component or route
+ * <GunTodoList />
+ */
+export function unum(Component: any, options: {
+    path: string;
+    id?: string;
+    defaultProps?: any;
+}): any;
+/**
+ * Universal binding between Gun.js and any component data
+ *
+ * This function creates a reactive binding that syncs component data
+ * to Gun.js in a generic way, without caring about the specific structure.
+ *
+ * @param {string} path - Gun.js path for the data
+ * @param {Object} [options] - Configuration options
+ * @param {Object} [options.defaultData={}] - Default data to use when Gun data is not available
+ * @returns {Object} A binding object with subscriber, data object, and change handler
+ */
+export function connect(path: string, options?: {
+    defaultData?: any;
+}): any;
+//# sourceMappingURL=gunify.d.ts.map

package/dist/gunify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gunify.d.ts","sourceRoot":"","sources":["../src/gunify.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,8CAlBG;IAAwB,IAAI,EAApB,MAAM;IACW,EAAE,GAAnB,MAAM;IACW,YAAY;CACrC,OAsIF;AAED;;;;;;;;;;GAUG;AACH,8BALW,MAAM,YAEd;IAAyB,WAAW;CACpC,OAwKF"}

package/dist/gunify.js

@@ -0,0 +1,294 @@
+/**
+ * unum - Component-agnostic Gun.js data binding for Svelte components
+ *
+ * This module provides a clean way to bind Gun.js data to Svelte components
+ * without the components knowing anything about Gun.js.
+ */
+import { getContext } from 'svelte';
+import { writable, derived } from 'svelte/store';
+import { gun as gunStore } from './GunContext.js';
+/**
+ * Creates a Gun-powered version of any Svelte component
+ *
+ * This function takes a component and returns a new function component
+ * that automatically binds Gun.js data to the original component's props structure.
+ *
+ * @param {Component} Component - The Svelte component to enhance
+ * @param {Object} options - Options for the binding
+ * @param {string} options.path - Gun.js path for the data
+ * @param {string} [options.id] - Optional ID for specific component instance
+ * @param {Object} [options.defaultProps] - Default props to use when Gun data is not available
+ * @returns {Component} A new component that wraps the original with Gun.js binding
+ *
+ * @example
+ * // Create a Gun-powered TodoList component
+ * import { unum } from '$lib/svgun/unum';
+ * import TodoList from './TodoList.svelte';
+ *
+ * export const GunTodoList = unum(TodoList, {
+ *   path: 'todos',
+ *   defaultProps: { items: [] }
+ * });
+ *
+ * // In a parent component or route
+ * <GunTodoList />
+ */
+export function unum(Component, options) {
+    const { path, id, defaultProps = {} } = options;
+    // Use id if provided, otherwise generate a unique one
+    const nodePath = id ? `${path}_${id}` : path;
+    // Return a new component function (Svelte 5 style)
+    return function GunifiedComponent($$props) {
+        const props = $$props || {};
+        // Create a store for the component props
+        const propsStore = writable({ ...defaultProps, ...props });
+        // Subscribe to the Gun instance
+        const gunStoreValue = getContext('gun') || gunStore;
+        let gun = null;
+        let unsubscribe = null;
+        // Subscribe to Gun updates when the component is created
+        const unsubscribeFromGun = gunStoreValue.subscribe($gun => {
+            if (!$gun)
+                return;
+            gun = $gun;
+            // Get the Gun node for this component
+            const node = gun.get(nodePath);
+            // Initialize Gun data with default props if empty
+            node.once(data => {
+                if (!data || Object.keys(data).length === 0) {
+                    const initialData = { ...defaultProps, ...props };
+                    node.put(initialData);
+                }
+            });
+            // Subscribe to Gun data changes
+            unsubscribe = node.on((data) => {
+                if (!data)
+                    return;
+                // Filter out Gun metadata
+                const cleanData = {};
+                for (const k in data) {
+                    if (k !== '_' && !k.startsWith('_')) {
+                        cleanData[k] = data[k];
+                    }
+                }
+                // Update props store
+                propsStore.update(current => ({
+                    ...current,
+                    ...cleanData
+                }));
+            });
+        });
+        // Create the derived props for the component
+        const derivedProps = derived(propsStore, $props => $props);
+        // Handle component events
+        function handleEvent(event) {
+            const { detail } = event;
+            // If Gun instance is available
+            if (gun) {
+                const node = gun.get(nodePath);
+                if (node && detail) {
+                    // Update Gun data with event detail
+                    node.put(detail);
+                }
+            }
+            // Also update the local props store
+            if (detail) {
+                propsStore.update(current => ({
+                    ...current,
+                    ...detail
+                }));
+            }
+        }
+        // Listener for all update events
+        function addEventListeners(element) {
+            if (element) {
+                element.addEventListener('update', handleEvent);
+            }
+            return () => {
+                if (element) {
+                    element.removeEventListener('update', handleEvent);
+                }
+            };
+        }
+        // Return the wrapped component
+        return {
+            component: Component,
+            props: derivedProps,
+            $$slot_def: {},
+            events: {
+                update: handleEvent
+            },
+            onMount(instance) {
+                if (instance && instance.$$root) {
+                    // Add event listeners to the component's root element
+                    return addEventListeners(instance.$$root);
+                }
+            },
+            // Clean up when component is destroyed
+            destroy() {
+                if (unsubscribeFromGun) {
+                    unsubscribeFromGun();
+                }
+                if (unsubscribe) {
+                    unsubscribe();
+                }
+            }
+        };
+    };
+}
+/**
+ * Universal binding between Gun.js and any component data
+ *
+ * This function creates a reactive binding that syncs component data
+ * to Gun.js in a generic way, without caring about the specific structure.
+ *
+ * @param {string} path - Gun.js path for the data
+ * @param {Object} [options] - Configuration options
+ * @param {Object} [options.defaultData={}] - Default data to use when Gun data is not available
+ * @returns {Object} A binding object with subscriber, data object, and change handler
+ */
+export function connect(path, options = {}) {
+    const { defaultData = {} } = options;
+    // Create a reactive store
+    const dataStore = writable({ ...defaultData });
+    // Variable to prevent circular updates
+    let isUpdatingFromGun = false;
+    let isFirstUpdate = true;
+    // Use internal reference to track the current data state
+    let currentData = { ...defaultData };
+    // Setup Gun connection
+    const unsubscribeFromGun = gunStore.subscribe($gun => {
+        if (!$gun)
+            return;
+        // Get the Gun node
+        const node = $gun.get(path);
+        // Initialize data if empty
+        node.once(initialData => {
+            if (!initialData || Object.keys(initialData).filter(k => k !== '_').length === 0) {
+                // Initialize Gun with default data
+                node.put(defaultData);
+                // Update the store with default data
+                dataStore.set(defaultData);
+                currentData = { ...defaultData };
+            }
+            else {
+                // Filter out Gun metadata
+                const cleanData = {};
+                for (const k in initialData) {
+                    if (k !== '_' && !k.startsWith('_')) {
+                        cleanData[k] = initialData[k];
+                    }
+                }
+                // Update store with existing data
+                dataStore.set(cleanData);
+                currentData = { ...cleanData };
+            }
+        });
+        // Subscribe to Gun data changes
+        const unsubscribe = node.on((data) => {
+            if (!data)
+                return;
+            // Filter out Gun metadata
+            const cleanData = {};
+            for (const k in data) {
+                if (k !== '_' && !k.startsWith('_')) {
+                    cleanData[k] = data[k];
+                }
+            }
+            if (isFirstUpdate || JSON.stringify(cleanData) !== JSON.stringify(currentData)) {
+                isFirstUpdate = false;
+                isUpdatingFromGun = true;
+                // Update store with clean data
+                dataStore.set(cleanData);
+                // Update our internal reference
+                currentData = { ...cleanData };
+                // Reset flag after update
+                setTimeout(() => {
+                    isUpdatingFromGun = false;
+                }, 0);
+            }
+        });
+        return function cleanup() {
+            unsubscribe();
+        };
+    });
+    // Create reactive data object that syncs with Gun
+    const data = {};
+    // Set up a proxy to detect changes to data properties
+    const proxy = new Proxy(data, {
+        get(target, prop) {
+            // Get the latest data from the store
+            const storeData = currentData;
+            return storeData[prop];
+        },
+        set(target, prop, value) {
+            // Skip if we're in the middle of updating from Gun
+            if (isUpdatingFromGun)
+                return true;
+            // Create updated data
+            const updatedData = { ...currentData };
+            updatedData[prop] = value;
+            // Update Gun
+            gunStore.update($gun => {
+                if ($gun) {
+                    $gun.get(path).put(updatedData);
+                }
+                return $gun;
+            });
+            // Update our internal reference
+            currentData = { ...updatedData };
+            // Update store
+            dataStore.set(updatedData);
+            return true;
+        }
+    });
+    // Generic function to handle any component data changes
+    function handleComponentChange(newData) {
+        // Skip if we're in the middle of updating from Gun
+        if (isUpdatingFromGun)
+            return;
+        // Safety check for newData
+        if (!newData)
+            return;
+        // Update Gun with the new data
+        gunStore.update($gun => {
+            if ($gun) {
+                $gun.get(path).put(newData);
+            }
+            return $gun;
+        });
+        // Update our internal reference
+        currentData = { ...newData };
+        // Update store
+        dataStore.set(newData);
+    }
+    // Expose methods for updating data
+    return {
+        data: proxy,
+        subscribe: dataStore.subscribe,
+        set: handleComponentChange,
+        update(updater) {
+            // Skip if we're in the middle of updating from Gun
+            if (isUpdatingFromGun)
+                return;
+            // Apply updater to current data
+            const updatedData = updater(currentData);
+            handleComponentChange(updatedData);
+        },
+        updateField(field, value) {
+            // Skip if we're in the middle of updating from Gun
+            if (isUpdatingFromGun)
+                return;
+            // Update a specific field
+            const updatedData = { ...currentData };
+            updatedData[field] = value;
+            handleComponentChange(updatedData);
+        },
+        // Universal change handler for any component data
+        handleChange: handleComponentChange,
+        destroy() {
+            unsubscribeFromGun();
+        }
+    };
+}
+//# sourceMappingURL=gunify.js.map

package/dist/gunify.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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: {
+    component: Function;
+    db: any;
+    path: string;
+    id?: string;
+    defaultData?: any;
+    props?: any;
+}): Function;
+export * from "./store.js";
+export * from "./actions.js";
+export * from "./plures-helper.js";
+export * from "./plures-helper.js";
+/**
+ * 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 gunComponent(options: {
+    component: Function;
+    db: any;
+    path: string;
+    id?: string;
+    defaultData?: any;
+    props?: any;
+}): Function;
+import { gun } from './GunContext.js';
+export { unum, connect, gun, gun as db, gun as plures };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;;;;;GAgBG;AACH,yCARG;IAA0B,SAAS;IACX,EAAE;IACF,IAAI,EAApB,MAAM;IACW,EAAE,GAAnB,MAAM;IACW,WAAW;IACX,KAAK;CAC9B,YA+LF;;;;;AA9MD;;;;;;;;;;;;;;;;GAgBG;AACH,sCARG;IAA0B,SAAS;IACX,EAAE;IACF,IAAI,EAApB,MAAM;IACW,EAAE,GAAnB,MAAM;IACW,WAAW;IACX,KAAK;CAC9B,YA+LF;oBAnNmB,iBAAiB"}