@hefang/web-storage 0.0.1

package/README.md

@@ -0,0 +1,15 @@
+# @hefang/web-storage
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.11. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/getLocalStorage.d.ts

@@ -0,0 +1,2 @@
+export declare function getLocalStorage<T>(key: string): T | undefined;
+export declare function getLocalStorage<T>(key: string, defaultValue: T): T;

package/dist/getLocalStorage.js

@@ -0,0 +1,4 @@
+import { getStorage } from "./getStorage";
+export function getLocalStorage(key, defaultValue) {
+    return getStorage(localStorage, key, defaultValue);
+}

package/dist/getSessionStorage.d.ts

@@ -0,0 +1,2 @@
+export declare function getSessionStorage<T>(key: string): T | undefined;
+export declare function getSessionStorage<T>(key: string, defaultValue: T): T;

package/dist/getSessionStorage.js

@@ -0,0 +1,4 @@
+import { getStorage } from "./getStorage";
+export function getSessionStorage(key, defaultValue) {
+    return getStorage(sessionStorage, key, defaultValue);
+}

package/dist/getStorage.d.ts

@@ -0,0 +1,2 @@
+export declare function getStorage<T>(storage: Storage, key: string): T | undefined;
+export declare function getStorage<T>(storage: Storage, key: string, defaultValue: T): T;

package/dist/getStorage.js

@@ -0,0 +1,9 @@
+export function getStorage(storage, key, defaultValue) {
+    const value = storage.getItem(key);
+    try {
+        return value ? JSON.parse(value) : defaultValue;
+    }
+    catch {
+        return defaultValue;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./getLocalStorage";
+export * from "./getSessionStorage";
+export * from "./getStorage";
+export * from "./setLocalStorage";
+export * from "./setSessionStorage";
+export * from "./setStorage";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./getLocalStorage";
+export * from "./getSessionStorage";
+export * from "./getStorage";
+export * from "./setLocalStorage";
+export * from "./setSessionStorage";
+export * from "./setStorage";

package/dist/setLocalStorage.d.ts

@@ -0,0 +1 @@
+export declare function setLocalStorage(key: string, value: unknown): void;

package/dist/setLocalStorage.js

@@ -0,0 +1,4 @@
+import { setStorage } from "./setStorage";
+export function setLocalStorage(key, value) {
+    setStorage(localStorage, key, value);
+}

package/dist/setSessionStorage.d.ts

@@ -0,0 +1 @@
+export declare function setSessionStorage<T>(key: string, value: T): void;

package/dist/setSessionStorage.js

@@ -0,0 +1,4 @@
+import { setStorage } from "./setStorage";
+export function setSessionStorage(key, value) {
+    setStorage(sessionStorage, key, value);
+}

package/dist/setStorage.d.ts

@@ -0,0 +1 @@
+export declare function setStorage(storage: Storage, key: string, value: unknown): void;

package/dist/setStorage.js

@@ -0,0 +1,3 @@
+export function setStorage(storage, key, value) {
+    storage.setItem(key, JSON.stringify(value));
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@hefang/web-storage",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "require": "./dist/index.js",
+    "import": "./dist/index.js",
+    "default": "./src/index.ts"
+  },
+  "scripts": {
+    "build": "bun tsc --noEmit false",
+    "prepack": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}

package/src/getLocalStorage.ts

@@ -0,0 +1,7 @@
+import { getStorage } from "./getStorage";
+
+export function getLocalStorage<T>(key: string): T | undefined;
+export function getLocalStorage<T>(key: string, defaultValue: T): T;
+export function getLocalStorage<T>(key: string, defaultValue?: T): T | undefined {
+  return getStorage(localStorage, key, defaultValue);
+}

package/src/getSessionStorage.ts

@@ -0,0 +1,7 @@
+import { getStorage } from "./getStorage";
+
+export function getSessionStorage<T>(key: string): T | undefined;
+export function getSessionStorage<T>(key: string, defaultValue: T): T;
+export function getSessionStorage<T>(key: string, defaultValue?: T): T | undefined {
+  return getStorage(sessionStorage, key, defaultValue);
+}

package/src/getStorage.ts

@@ -0,0 +1,18 @@
+export function getStorage<T>(storage: Storage, key: string): T | undefined;
+export function getStorage<T>(
+  storage: Storage,
+  key: string,
+  defaultValue: T,
+): T;
+export function getStorage<T>(
+  storage: Storage,
+  key: string,
+  defaultValue?: T,
+): T | undefined {
+  const value = storage.getItem(key);
+  try {
+    return value ? JSON.parse(value) : defaultValue;
+  } catch {
+    return defaultValue;
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from "./getLocalStorage";
+export * from "./getSessionStorage";
+export * from "./getStorage";
+export * from "./setLocalStorage";
+export * from "./setSessionStorage";
+export * from "./setStorage";

package/src/setLocalStorage.ts

@@ -0,0 +1,5 @@
+import { setStorage } from "./setStorage";
+
+export function setLocalStorage(key: string, value: unknown) {
+  setStorage(localStorage, key, value);
+}

package/src/setSessionStorage.ts

@@ -0,0 +1,5 @@
+import { setStorage } from "./setStorage";
+
+export function setSessionStorage<T>(key: string, value: T): void {
+  setStorage(sessionStorage, key, value);
+}

package/src/setStorage.ts

@@ -0,0 +1,3 @@
+export function setStorage(storage: Storage, key: string, value: unknown) {
+  storage.setItem(key, JSON.stringify(value));
+}

package/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext", "DOM"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": false,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false,
+    "declaration": true,
+    "outDir": "dist"
+  }
+}