@scale-sense/storage-local 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { ScaleSenseStorage, ScaleSensePersistedState } from '@scale-sense/react';
+
+declare const DEFAULT_STORAGE_KEY: "scale-sense-storage";
+declare const DEFAULT_STORAGE_VERSION: 10;
+/** Synchronous read for store bootstrap (matches zustand persist hydration). */
+declare function readLocalStoragePersistedState(options?: {
+    key?: string;
+    version?: number;
+}): Partial<ScaleSensePersistedState> | null;
+declare function createLocalStorageAdapter(options?: {
+    key?: string;
+    version?: number;
+}): ScaleSenseStorage;
+
+export { DEFAULT_STORAGE_KEY, DEFAULT_STORAGE_VERSION, createLocalStorageAdapter, readLocalStoragePersistedState };

package/dist/index.js

@@ -0,0 +1,109 @@
+// src/createLocalStorageAdapter.ts
+import {
+  CONVERSION_CARD_KINDS,
+  parseHistoryEntry,
+  parseHistorySortMode,
+  SOURCE_KINDS
+} from "@scale-sense/core";
+var DEFAULT_STORAGE_KEY = "scale-sense-storage";
+var DEFAULT_STORAGE_VERSION = 10;
+var DEFAULT_VISIBLE_SOURCE_KINDS = [
+  "westernNumeric",
+  "chineseWords"
+];
+function defaultHidden() {
+  return Object.fromEntries(
+    SOURCE_KINDS.map((k) => [k, !DEFAULT_VISIBLE_SOURCE_KINDS.includes(k)])
+  );
+}
+function defaultConversionHidden() {
+  return Object.fromEntries(
+    CONVERSION_CARD_KINDS.map((k) => [k, true])
+  );
+}
+function migratePersistedState(persistedState) {
+  const state = persistedState;
+  const nextState = state.cardHidden ? state : {
+    ...state,
+    cardHidden: state.cardCollapsed ?? defaultHidden()
+  };
+  const migratedHistory = (nextState.history ?? []).map((h) => parseHistoryEntry(h)).filter((h) => h !== null);
+  const savedCustomUnits = Array.isArray(nextState.savedCustomUnits) ? nextState.savedCustomUnits.filter(
+    (u) => typeof u === "string"
+  ) : [];
+  return {
+    ...nextState,
+    conversionCardHidden: nextState.conversionCardHidden ?? defaultConversionHidden(),
+    history: migratedHistory,
+    historySortMode: parseHistorySortMode(nextState.historySortMode),
+    savedCustomUnits
+  };
+}
+function readEnvelope(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function loadPersistedState(key, version) {
+  if (typeof localStorage === "undefined") return null;
+  const raw = localStorage.getItem(key);
+  if (!raw) return null;
+  const envelope = readEnvelope(raw);
+  if (!envelope) return null;
+  const storedVersion = envelope.version ?? 0;
+  const innerState = envelope.state ?? envelope;
+  if (storedVersion !== version) {
+    return migratePersistedState(innerState);
+  }
+  return innerState;
+}
+function readLocalStoragePersistedState(options) {
+  const key = options?.key ?? DEFAULT_STORAGE_KEY;
+  const version = options?.version ?? DEFAULT_STORAGE_VERSION;
+  return loadPersistedState(key, version);
+}
+function createLocalStorageAdapter(options) {
+  const key = options?.key ?? DEFAULT_STORAGE_KEY;
+  const version = options?.version ?? DEFAULT_STORAGE_VERSION;
+  return {
+    async load() {
+      return loadPersistedState(key, version);
+    },
+    async save(state) {
+      if (typeof localStorage === "undefined") return;
+      const envelope = {
+        state: {
+          history: state.history,
+          historySortMode: state.historySortMode,
+          cardHidden: state.cardHidden,
+          conversionCardHidden: state.conversionCardHidden,
+          sourceKind: state.sourceKind,
+          rawInput: state.rawInput,
+          savedCustomUnits: state.savedCustomUnits
+        },
+        version
+      };
+      localStorage.setItem(key, JSON.stringify(envelope));
+    },
+    subscribe(listener) {
+      if (typeof window === "undefined") {
+        return () => {
+        };
+      }
+      const handler = (event) => {
+        if (event.key === key) listener();
+      };
+      window.addEventListener("storage", handler);
+      return () => window.removeEventListener("storage", handler);
+    }
+  };
+}
+export {
+  DEFAULT_STORAGE_KEY,
+  DEFAULT_STORAGE_VERSION,
+  createLocalStorageAdapter,
+  readLocalStoragePersistedState
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createLocalStorageAdapter.ts"],"sourcesContent":["import type { ConversionCardKind, SourceKind } from '@scale-sense/core'\nimport {\n  CONVERSION_CARD_KINDS,\n  type HistoryEntry,\n  parseHistoryEntry,\n  parseHistorySortMode,\n  SOURCE_KINDS,\n} from '@scale-sense/core'\nimport type {\n  ScaleSensePersistedState,\n  ScaleSenseStorage,\n} from '@scale-sense/react'\n\nexport const DEFAULT_STORAGE_KEY = 'scale-sense-storage' as const\nexport const DEFAULT_STORAGE_VERSION = 10 as const\n\nconst DEFAULT_VISIBLE_SOURCE_KINDS: SourceKind[] = [\n  'westernNumeric',\n  'chineseWords',\n]\n\nfunction defaultHidden(): Record<SourceKind, boolean> {\n  return Object.fromEntries(\n    SOURCE_KINDS.map((k) => [k, !DEFAULT_VISIBLE_SOURCE_KINDS.includes(k)]),\n  ) as Record<SourceKind, boolean>\n}\n\nfunction defaultConversionHidden(): Record<ConversionCardKind, boolean> {\n  return Object.fromEntries(\n    CONVERSION_CARD_KINDS.map((k) => [k, true]),\n  ) as Record<ConversionCardKind, boolean>\n}\n\ntype PersistedEnvelope = {\n  state?: unknown\n  version?: number\n}\n\n/**\n * Zustand-compatible migration for persisted state (version 10).\n * Ported from the commercial app useAppStore persist migrate block.\n */\nfunction migratePersistedState(\n  persistedState: unknown,\n): ScaleSensePersistedState {\n  const state = persistedState as {\n    cardCollapsed?: Record<SourceKind, boolean>\n    cardHidden?: Record<SourceKind, boolean>\n    conversionCardHidden?: Record<ConversionCardKind, boolean>\n    savedCustomUnits?: unknown\n    historySortMode?: unknown\n    history?: unknown[]\n    sourceKind?: SourceKind\n    rawInput?: string\n  }\n\n  const nextState = state.cardHidden\n    ? state\n    : {\n        ...state,\n        cardHidden: state.cardCollapsed ?? defaultHidden(),\n      }\n\n  const migratedHistory = (nextState.history ?? [])\n    .map((h) => parseHistoryEntry(h))\n    .filter((h): h is HistoryEntry => h !== null)\n\n  const savedCustomUnits = Array.isArray(nextState.savedCustomUnits)\n    ? nextState.savedCustomUnits.filter(\n        (u): u is string => typeof u === 'string',\n      )\n    : []\n\n  return {\n    ...nextState,\n    conversionCardHidden:\n      nextState.conversionCardHidden ?? defaultConversionHidden(),\n    history: migratedHistory,\n    historySortMode: parseHistorySortMode(nextState.historySortMode),\n    savedCustomUnits,\n  } as ScaleSensePersistedState\n}\n\nfunction readEnvelope(raw: string): PersistedEnvelope | null {\n  try {\n    return JSON.parse(raw) as PersistedEnvelope\n  } catch {\n    return null\n  }\n}\n\nfunction loadPersistedState(\n  key: string,\n  version: number,\n): Partial<ScaleSensePersistedState> | null {\n  if (typeof localStorage === 'undefined') return null\n\n  const raw = localStorage.getItem(key)\n  if (!raw) return null\n\n  const envelope = readEnvelope(raw)\n  if (!envelope) return null\n\n  const storedVersion = envelope.version ?? 0\n  const innerState = envelope.state ?? envelope\n\n  if (storedVersion !== version) {\n    return migratePersistedState(innerState)\n  }\n\n  return innerState as Partial<ScaleSensePersistedState>\n}\n\n/** Synchronous read for store bootstrap (matches zustand persist hydration). */\nexport function readLocalStoragePersistedState(options?: {\n  key?: string\n  version?: number\n}): Partial<ScaleSensePersistedState> | null {\n  const key = options?.key ?? DEFAULT_STORAGE_KEY\n  const version = options?.version ?? DEFAULT_STORAGE_VERSION\n  return loadPersistedState(key, version)\n}\n\nexport function createLocalStorageAdapter(options?: {\n  key?: string\n  version?: number\n}): ScaleSenseStorage {\n  const key = options?.key ?? DEFAULT_STORAGE_KEY\n  const version = options?.version ?? DEFAULT_STORAGE_VERSION\n\n  return {\n    async load() {\n      return loadPersistedState(key, version)\n    },\n\n    async save(state) {\n      if (typeof localStorage === 'undefined') return\n\n      const envelope: PersistedEnvelope = {\n        state: {\n          history: state.history,\n          historySortMode: state.historySortMode,\n          cardHidden: state.cardHidden,\n          conversionCardHidden: state.conversionCardHidden,\n          sourceKind: state.sourceKind,\n          rawInput: state.rawInput,\n          savedCustomUnits: state.savedCustomUnits,\n        },\n        version,\n      }\n\n      localStorage.setItem(key, JSON.stringify(envelope))\n    },\n\n    subscribe(listener) {\n      if (typeof window === 'undefined') {\n        return () => {}\n      }\n\n      const handler = (event: StorageEvent) => {\n        if (event.key === key) listener()\n      }\n\n      window.addEventListener('storage', handler)\n      return () => window.removeEventListener('storage', handler)\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@scale-sense/storage-local",
+  "version": "0.1.0",
+  "description": "localStorage adapter for ScaleSense persisted state",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scale-sense/scale-sense-sdk.git",
+    "directory": "packages/storage-local"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "biome check ."
+  },
+  "dependencies": {
+    "@scale-sense/core": "workspace:*",
+    "@scale-sense/react": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "~5.9.3"
+  }
+}