@wizzard-packages/persistence 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aziz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,94 @@
+'use strict';
+
+// src/LocalStorageAdapter.ts
+var LocalStorageAdapter = class {
+  constructor(prefix = "wizard_") {
+    this.prefix = prefix;
+  }
+  getKey(stepId) {
+    return `${this.prefix}${stepId}`;
+  }
+  saveStep(stepId, data) {
+    if (typeof window === "undefined") return;
+    try {
+      const payload = { timestamp: Date.now(), data };
+      localStorage.setItem(this.getKey(stepId), JSON.stringify(payload));
+    } catch (error) {
+      console.warn("LocalStorageAdapter: Failed to save step", error);
+    }
+  }
+  getStep(stepId) {
+    if (typeof window === "undefined") return void 0;
+    try {
+      const item = localStorage.getItem(this.getKey(stepId));
+      if (!item) return void 0;
+      const parsed = JSON.parse(item);
+      if (parsed && typeof parsed === "object" && "timestamp" in parsed && "data" in parsed) {
+        return parsed.data;
+      }
+      return parsed;
+    } catch (error) {
+      console.warn("LocalStorageAdapter: Failed to get step", error);
+      return void 0;
+    }
+  }
+  getStepWithMeta(stepId) {
+    if (typeof window === "undefined") return void 0;
+    try {
+      const item = localStorage.getItem(this.getKey(stepId));
+      if (!item) return void 0;
+      const parsed = JSON.parse(item);
+      if (parsed && typeof parsed === "object" && "timestamp" in parsed && "data" in parsed) {
+        return parsed;
+      }
+      return { data: parsed, timestamp: 0 };
+    } catch (error) {
+      return void 0;
+    }
+  }
+  clearStep(stepId) {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.removeItem(this.getKey(stepId));
+    } catch (error) {
+      console.warn("LocalStorageAdapter: Failed to clear step", error);
+    }
+  }
+  clear() {
+    if (typeof window === "undefined") return;
+    Object.keys(localStorage).forEach((key) => {
+      if (key.startsWith(this.prefix)) {
+        localStorage.removeItem(key);
+      }
+    });
+  }
+};
+
+// src/MemoryAdapter.ts
+var MemoryAdapter = class {
+  constructor() {
+    this.storage = {};
+  }
+  saveStep(stepId, data) {
+    this.storage[stepId] = data;
+  }
+  getStep(stepId) {
+    return this.storage[stepId];
+  }
+  getStepWithMeta(stepId) {
+    const item = this.storage[stepId];
+    if (!item) return void 0;
+    return { data: item, timestamp: Date.now() };
+  }
+  clearStep(stepId) {
+    delete this.storage[stepId];
+  }
+  clear() {
+    this.storage = {};
+  }
+};
+
+exports.LocalStorageAdapter = LocalStorageAdapter;
+exports.MemoryAdapter = MemoryAdapter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/LocalStorageAdapter.ts","../src/MemoryAdapter.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { IPersistenceAdapter } from '@wizzard-packages/core';\n\n/**\n * Browser persistence adapter backed by localStorage.\n */\nexport class LocalStorageAdapter implements IPersistenceAdapter {\n  private prefix: string;\n\n  constructor(prefix: string = 'wizard_') {\n    this.prefix = prefix;\n  }\n\n  private getKey(stepId: string): string {\n    return `${this.prefix}${stepId}`;\n  }\n\n  saveStep<T>(stepId: string, data: T): void {\n    if (typeof window === 'undefined') return;\n    try {\n      const payload = { timestamp: Date.now(), data };\n      localStorage.setItem(this.getKey(stepId), JSON.stringify(payload));\n    } catch (error) {\n      console.warn('LocalStorageAdapter: Failed to save step', error);\n    }\n  }\n\n  getStep<T>(stepId: string): T | undefined {\n    if (typeof window === 'undefined') return undefined;\n    try {\n      const item = localStorage.getItem(this.getKey(stepId));\n      if (!item) return undefined;\n\n      const parsed = JSON.parse(item);\n      if (parsed && typeof parsed === 'object' && 'timestamp' in parsed && 'data' in parsed) {\n        return parsed.data as T;\n      }\n      return parsed as T;\n    } catch (error) {\n      console.warn('LocalStorageAdapter: Failed to get step', error);\n      return undefined;\n    }\n  }\n\n  getStepWithMeta<T>(stepId: string): { data: T; timestamp: number } | undefined {\n    if (typeof window === 'undefined') return undefined;\n    try {\n      const item = localStorage.getItem(this.getKey(stepId));\n      if (!item) return undefined;\n\n      const parsed = JSON.parse(item);\n      if (parsed && typeof parsed === 'object' && 'timestamp' in parsed && 'data' in parsed) {\n        return parsed as { data: T; timestamp: number };\n      }\n      return { data: parsed as T, timestamp: 0 };\n    } catch (error) {\n      return undefined;\n    }\n  }\n\n  clearStep(stepId: string): void {\n    if (typeof window === 'undefined') return;\n    try {\n      localStorage.removeItem(this.getKey(stepId));\n    } catch (error) {\n      console.warn('LocalStorageAdapter: Failed to clear step', error);\n    }\n  }\n\n  clear(): void {\n    if (typeof window === 'undefined') return;\n    Object.keys(localStorage).forEach((key) => {\n      if (key.startsWith(this.prefix)) {\n        localStorage.removeItem(key);\n      }\n    });\n  }\n}\n","import type { IPersistenceAdapter } from '@wizzard-packages/core';\n\n/**\n * In-memory persistence adapter for tests or ephemeral sessions.\n */\nexport class MemoryAdapter implements IPersistenceAdapter {\n  private storage: Record<string, any> = {};\n\n  saveStep<T>(stepId: string, data: T): void {\n    this.storage[stepId] = data;\n  }\n\n  getStep<T>(stepId: string): T | undefined {\n    return this.storage[stepId] as T;\n  }\n\n  getStepWithMeta<T>(stepId: string): { data: T; timestamp: number } | undefined {\n    const item = this.storage[stepId];\n    if (!item) return undefined;\n    return { data: item as T, timestamp: Date.now() };\n  }\n\n  clearStep(stepId: string): void {\n    delete this.storage[stepId];\n  }\n\n  clear(): void {\n    this.storage = {};\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,35 @@
+import { IPersistenceAdapter } from '@wizzard-packages/core';
+
+/**
+ * Browser persistence adapter backed by localStorage.
+ */
+declare class LocalStorageAdapter implements IPersistenceAdapter {
+    private prefix;
+    constructor(prefix?: string);
+    private getKey;
+    saveStep<T>(stepId: string, data: T): void;
+    getStep<T>(stepId: string): T | undefined;
+    getStepWithMeta<T>(stepId: string): {
+        data: T;
+        timestamp: number;
+    } | undefined;
+    clearStep(stepId: string): void;
+    clear(): void;
+}
+
+/**
+ * In-memory persistence adapter for tests or ephemeral sessions.
+ */
+declare class MemoryAdapter implements IPersistenceAdapter {
+    private storage;
+    saveStep<T>(stepId: string, data: T): void;
+    getStep<T>(stepId: string): T | undefined;
+    getStepWithMeta<T>(stepId: string): {
+        data: T;
+        timestamp: number;
+    } | undefined;
+    clearStep(stepId: string): void;
+    clear(): void;
+}
+
+export { LocalStorageAdapter, MemoryAdapter };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { IPersistenceAdapter } from '@wizzard-packages/core';
+
+/**
+ * Browser persistence adapter backed by localStorage.
+ */
+declare class LocalStorageAdapter implements IPersistenceAdapter {
+    private prefix;
+    constructor(prefix?: string);
+    private getKey;
+    saveStep<T>(stepId: string, data: T): void;
+    getStep<T>(stepId: string): T | undefined;
+    getStepWithMeta<T>(stepId: string): {
+        data: T;
+        timestamp: number;
+    } | undefined;
+    clearStep(stepId: string): void;
+    clear(): void;
+}
+
+/**
+ * In-memory persistence adapter for tests or ephemeral sessions.
+ */
+declare class MemoryAdapter implements IPersistenceAdapter {
+    private storage;
+    saveStep<T>(stepId: string, data: T): void;
+    getStep<T>(stepId: string): T | undefined;
+    getStepWithMeta<T>(stepId: string): {
+        data: T;
+        timestamp: number;
+    } | undefined;
+    clearStep(stepId: string): void;
+    clear(): void;
+}
+
+export { LocalStorageAdapter, MemoryAdapter };

package/dist/index.js

@@ -0,0 +1,91 @@
+// src/LocalStorageAdapter.ts
+var LocalStorageAdapter = class {
+  constructor(prefix = "wizard_") {
+    this.prefix = prefix;
+  }
+  getKey(stepId) {
+    return `${this.prefix}${stepId}`;
+  }
+  saveStep(stepId, data) {
+    if (typeof window === "undefined") return;
+    try {
+      const payload = { timestamp: Date.now(), data };
+      localStorage.setItem(this.getKey(stepId), JSON.stringify(payload));
+    } catch (error) {
+      console.warn("LocalStorageAdapter: Failed to save step", error);
+    }
+  }
+  getStep(stepId) {
+    if (typeof window === "undefined") return void 0;
+    try {
+      const item = localStorage.getItem(this.getKey(stepId));
+      if (!item) return void 0;
+      const parsed = JSON.parse(item);
+      if (parsed && typeof parsed === "object" && "timestamp" in parsed && "data" in parsed) {
+        return parsed.data;
+      }
+      return parsed;
+    } catch (error) {
+      console.warn("LocalStorageAdapter: Failed to get step", error);
+      return void 0;
+    }
+  }
+  getStepWithMeta(stepId) {
+    if (typeof window === "undefined") return void 0;
+    try {
+      const item = localStorage.getItem(this.getKey(stepId));
+      if (!item) return void 0;
+      const parsed = JSON.parse(item);
+      if (parsed && typeof parsed === "object" && "timestamp" in parsed && "data" in parsed) {
+        return parsed;
+      }
+      return { data: parsed, timestamp: 0 };
+    } catch (error) {
+      return void 0;
+    }
+  }
+  clearStep(stepId) {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.removeItem(this.getKey(stepId));
+    } catch (error) {
+      console.warn("LocalStorageAdapter: Failed to clear step", error);
+    }
+  }
+  clear() {
+    if (typeof window === "undefined") return;
+    Object.keys(localStorage).forEach((key) => {
+      if (key.startsWith(this.prefix)) {
+        localStorage.removeItem(key);
+      }
+    });
+  }
+};
+
+// src/MemoryAdapter.ts
+var MemoryAdapter = class {
+  constructor() {
+    this.storage = {};
+  }
+  saveStep(stepId, data) {
+    this.storage[stepId] = data;
+  }
+  getStep(stepId) {
+    return this.storage[stepId];
+  }
+  getStepWithMeta(stepId) {
+    const item = this.storage[stepId];
+    if (!item) return void 0;
+    return { data: item, timestamp: Date.now() };
+  }
+  clearStep(stepId) {
+    delete this.storage[stepId];
+  }
+  clear() {
+    this.storage = {};
+  }
+};
+
+export { LocalStorageAdapter, MemoryAdapter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/LocalStorageAdapter.ts","../src/MemoryAdapter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { IPersistenceAdapter } from '@wizzard-packages/core';\n\n/**\n * Browser persistence adapter backed by localStorage.\n */\nexport class LocalStorageAdapter implements IPersistenceAdapter {\n  private prefix: string;\n\n  constructor(prefix: string = 'wizard_') {\n    this.prefix = prefix;\n  }\n\n  private getKey(stepId: string): string {\n    return `${this.prefix}${stepId}`;\n  }\n\n  saveStep<T>(stepId: string, data: T): void {\n    if (typeof window === 'undefined') return;\n    try {\n      const payload = { timestamp: Date.now(), data };\n      localStorage.setItem(this.getKey(stepId), JSON.stringify(payload));\n    } catch (error) {\n      console.warn('LocalStorageAdapter: Failed to save step', error);\n    }\n  }\n\n  getStep<T>(stepId: string): T | undefined {\n    if (typeof window === 'undefined') return undefined;\n    try {\n      const item = localStorage.getItem(this.getKey(stepId));\n      if (!item) return undefined;\n\n      const parsed = JSON.parse(item);\n      if (parsed && typeof parsed === 'object' && 'timestamp' in parsed && 'data' in parsed) {\n        return parsed.data as T;\n      }\n      return parsed as T;\n    } catch (error) {\n      console.warn('LocalStorageAdapter: Failed to get step', error);\n      return undefined;\n    }\n  }\n\n  getStepWithMeta<T>(stepId: string): { data: T; timestamp: number } | undefined {\n    if (typeof window === 'undefined') return undefined;\n    try {\n      const item = localStorage.getItem(this.getKey(stepId));\n      if (!item) return undefined;\n\n      const parsed = JSON.parse(item);\n      if (parsed && typeof parsed === 'object' && 'timestamp' in parsed && 'data' in parsed) {\n        return parsed as { data: T; timestamp: number };\n      }\n      return { data: parsed as T, timestamp: 0 };\n    } catch (error) {\n      return undefined;\n    }\n  }\n\n  clearStep(stepId: string): void {\n    if (typeof window === 'undefined') return;\n    try {\n      localStorage.removeItem(this.getKey(stepId));\n    } catch (error) {\n      console.warn('LocalStorageAdapter: Failed to clear step', error);\n    }\n  }\n\n  clear(): void {\n    if (typeof window === 'undefined') return;\n    Object.keys(localStorage).forEach((key) => {\n      if (key.startsWith(this.prefix)) {\n        localStorage.removeItem(key);\n      }\n    });\n  }\n}\n","import type { IPersistenceAdapter } from '@wizzard-packages/core';\n\n/**\n * In-memory persistence adapter for tests or ephemeral sessions.\n */\nexport class MemoryAdapter implements IPersistenceAdapter {\n  private storage: Record<string, any> = {};\n\n  saveStep<T>(stepId: string, data: T): void {\n    this.storage[stepId] = data;\n  }\n\n  getStep<T>(stepId: string): T | undefined {\n    return this.storage[stepId] as T;\n  }\n\n  getStepWithMeta<T>(stepId: string): { data: T; timestamp: number } | undefined {\n    const item = this.storage[stepId];\n    if (!item) return undefined;\n    return { data: item as T, timestamp: Date.now() };\n  }\n\n  clearStep(stepId: string): void {\n    delete this.storage[stepId];\n  }\n\n  clear(): void {\n    this.storage = {};\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@wizzard-packages/persistence",
+  "version": "0.1.0",
+  "description": "Persistence adapters for Wizzard Stepper.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ZizzX/wizzard-packages.git",
+    "directory": "packages/persistence"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@wizzard-packages/core": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.16"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup src/index.ts --format cjs,esm --watch --dts",
+    "lint": "eslint .",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "type-check": "tsc --noEmit"
+  }
+}