@drakkar.software/sunglasses-storage-localstorage 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,22 @@
+import { IStorageAdapter } from '@drakkar.software/sunglasses-core';
+
+/**
+ * IStorageAdapter implementation using the browser's localStorage API.
+ *
+ * Keys are namespaced with a configurable prefix (default: 'sg_') to avoid
+ * collisions with other libraries or application data.
+ *
+ * Works in:
+ * - All modern browsers
+ * - Node.js environments that polyfill globalThis.localStorage
+ */
+declare class LocalStorageAdapter implements IStorageAdapter {
+    private readonly prefix;
+    constructor(prefix?: string);
+    read(key: string): Promise<string | null>;
+    write(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    private prefixed;
+}
+
+export { LocalStorageAdapter };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { IStorageAdapter } from '@drakkar.software/sunglasses-core';
+
+/**
+ * IStorageAdapter implementation using the browser's localStorage API.
+ *
+ * Keys are namespaced with a configurable prefix (default: 'sg_') to avoid
+ * collisions with other libraries or application data.
+ *
+ * Works in:
+ * - All modern browsers
+ * - Node.js environments that polyfill globalThis.localStorage
+ */
+declare class LocalStorageAdapter implements IStorageAdapter {
+    private readonly prefix;
+    constructor(prefix?: string);
+    read(key: string): Promise<string | null>;
+    write(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    private prefixed;
+}
+
+export { LocalStorageAdapter };

package/dist/index.js

@@ -0,0 +1,61 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  LocalStorageAdapter: () => LocalStorageAdapter
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/LocalStorageAdapter.ts
+var LocalStorageAdapter = class {
+  constructor(prefix = "sg_") {
+    this.prefix = prefix;
+  }
+  async read(key) {
+    try {
+      return globalThis.localStorage.getItem(this.prefixed(key));
+    } catch {
+      return null;
+    }
+  }
+  async write(key, value) {
+    try {
+      globalThis.localStorage.setItem(this.prefixed(key), value);
+    } catch (err) {
+      if (err instanceof Error && err.name === "QuotaExceededError") {
+        console.warn("[SunGlasses] LocalStorageAdapter: storage quota exceeded \u2014 event data may not persist");
+      }
+    }
+  }
+  async delete(key) {
+    try {
+      globalThis.localStorage.removeItem(this.prefixed(key));
+    } catch {
+    }
+  }
+  prefixed(key) {
+    return `${this.prefix}${key}`;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LocalStorageAdapter
+});

package/dist/index.mjs

@@ -0,0 +1,34 @@
+// src/LocalStorageAdapter.ts
+var LocalStorageAdapter = class {
+  constructor(prefix = "sg_") {
+    this.prefix = prefix;
+  }
+  async read(key) {
+    try {
+      return globalThis.localStorage.getItem(this.prefixed(key));
+    } catch {
+      return null;
+    }
+  }
+  async write(key, value) {
+    try {
+      globalThis.localStorage.setItem(this.prefixed(key), value);
+    } catch (err) {
+      if (err instanceof Error && err.name === "QuotaExceededError") {
+        console.warn("[SunGlasses] LocalStorageAdapter: storage quota exceeded \u2014 event data may not persist");
+      }
+    }
+  }
+  async delete(key) {
+    try {
+      globalThis.localStorage.removeItem(this.prefixed(key));
+    } catch {
+    }
+  }
+  prefixed(key) {
+    return `${this.prefix}${key}`;
+  }
+};
+export {
+  LocalStorageAdapter
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@drakkar.software/sunglasses-storage-localstorage",
+  "version": "0.1.0",
+  "description": "localStorage storage adapter for SunGlasses (web)",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@drakkar.software/sunglasses-core": "0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "@drakkar.software/sunglasses-tsconfig": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "clean": "rm -rf dist .tsbuildinfo"
+  }
+}