comes-storage 0.0.1

package/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2026, Rafael Cheruti
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/build/index.d.ts

@@ -0,0 +1,3 @@
+import { EventSystem } from 'comes';
+import { Storage } from './storage.type';
+export declare const setupStorage: (storageName: string, events: string[], storage?: Storage, es?: EventSystem) => void;

package/build/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupStorage = void 0;
+const comes_1 = require("comes");
+const local_storage_1 = require("./local-storage");
+const setupStorage = (storageName, events, storage, es) => {
+    if (!es)
+        es = comes_1.es;
+    if (!storage)
+        storage = new local_storage_1.LocalStorageStorage();
+    for (let event of events) {
+        const initialMainObj = lastData(storageName, storage, es);
+        const initialObj = (storageName === event ? initialMainObj : initialMainObj[event]) || null;
+        es.send(event, initialObj);
+        es.addInter(event, (id, data) => {
+            let obj = lastData(storageName, storage, es);
+            if (storageName === id)
+                obj = data;
+            else
+                obj[id] = data;
+            storage.save(storageName, obj);
+            return data;
+        });
+    }
+};
+exports.setupStorage = setupStorage;
+const lastData = (storageName, storage, es) => {
+    let mainEntry = es.get(storageName);
+    let obj = mainEntry.last || {};
+    if (!mainEntry.date) {
+        obj = storage.load(storageName);
+        mainEntry.date = Date.now();
+        mainEntry.last = obj;
+    }
+    return obj;
+};

package/build/local-storage.d.ts

@@ -0,0 +1,11 @@
+import type { Storage } from './storage.type';
+/**
+ * A simple implementation of the Storage interface using the browser's localStorage.
+ * This class provides methods to load, save, and retrieve the last saved data for a given address.
+ */
+export declare class LocalStorageStorage implements Storage {
+    s: globalThis.Storage;
+    constructor();
+    load(address: string): any;
+    save(address: string, data: any): void;
+}

package/build/local-storage.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStorageStorage = void 0;
+/**
+ * A simple implementation of the Storage interface using the browser's localStorage.
+ * This class provides methods to load, save, and retrieve the last saved data for a given address.
+ */
+class LocalStorageStorage {
+    constructor() {
+        this.s = globalThis.localStorage;
+    }
+    load(address) {
+        var _a;
+        const str = ((_a = this.s) === null || _a === void 0 ? void 0 : _a.getItem(address)) || '{}';
+        try {
+            return JSON.parse(str);
+        }
+        catch (ex) {
+            console.error(`Error loading "${address}" from "localStorage"!`, ex);
+            return {};
+        }
+    }
+    save(address, data) {
+        var _a;
+        const str = JSON.stringify(data);
+        (_a = this.s) === null || _a === void 0 ? void 0 : _a.setItem(address, str);
+    }
+}
+exports.LocalStorageStorage = LocalStorageStorage;

package/build/storage.type.d.ts

@@ -0,0 +1,15 @@
+export type Storage = {
+    /**
+     * Must load the data from storage and return it. The data will be sent to the event system as the last value of the event.
+     * The event system will call this method when the event is first sent.
+     * @param address Address/ID of the event
+     * @returns The data loaded from storage
+     */
+    load: (address: string) => any;
+    /**
+     * Must save the data to storage. The event system will call this method whenever the event is sent with new data.
+     * @param address Address/ID of the event
+     * @param data Data to store/save
+     */
+    save: (address: string, data: any) => void;
+};

package/build/storage.type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "comes-storage",
+  "version": "0.0.1",
+  "description": "Simple Storage for ComES",
+  "keywords": [
+    "event",
+    "event-system",
+    "communication",
+    "event-system storage"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/rcheruti/comes-storage.git"
+  },
+  "homepage": "https://github.com/rcheruti/comes-storage#readme",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "dev": "ts-node src/index.ts",
+    "build": "rimraf build && tsc",
+    "test": "vitest"
+  },
+  "author": "RCC",
+  "license": "ISC",
+  "peerDependencies": {
+    "comes": ">=0.0.4"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "2.1.3",
+    "comes": "^0.0.4",
+    "rimraf": "^6.0.1",
+    "typescript": "5.6.3",
+    "vitest": "2.1.3"
+  }
+}