@lytjs/plugin-storage 4.0.5 → 4.2.0

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var b=Object.defineProperty;var J=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var F=(n,t)=>{for(var o in t)b(n,o,{get:t[o],enumerable:!0})},R=(n,t,o,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let g of N(t))!_.call(n,g)&&g!==o&&b(n,g,{get:()=>t[g],enumerable:!(l=J(t,g))||l.enumerable});return n};var j=n=>R(b({},"__esModule",{value:!0}),n);var B={};F(B,{createStorage:()=>A});module.exports=j(B);function w(n,t){return`${t}${n}`}function q(n,t){return n.startsWith(t)?n.slice(t.length):n}function x(n,t){let o=null;return function(...l){o&&clearTimeout(o),o=setTimeout(()=>n.apply(this,l),t)}}function A(n={}){let{prefix:t="lyt_",storage:o=typeof localStorage!="undefined"?localStorage:{},expire:l,debug:g=!1,serialize:P=JSON.stringify,deserialize:O=JSON.parse}=n,u=(...r)=>{};function c(r,e,i){try{let s={value:e,timestamp:Date.now()},a=i!=null?i:l;a&&(s.expire=Date.now()+a);let y=w(r,t);o.setItem(y,P(s)),u(`set ${r}`,e)}catch(s){}}function m(r,e){try{let i=w(r,t),s=o.getItem(i);if(!s)return e!=null?e:null;let a=O(s);return a.expire&&Date.now()>a.expire?(u(`${r} expired, removing`),h(r),e!=null?e:null):(u(`get ${r}`,a.value),a.value)}catch(i){return e!=null?e:null}}function h(r){try{let e=w(r,t);o.removeItem(e),u(`removed ${r}`)}catch(e){}}function $(){try{let r=T();for(let e of r)h(e);u("cleared all")}catch(r){}}function I(r){return m(r)!==null}function T(){try{let r=[];for(let e=0;e<o.length;e++){let i=o.key(e);i&&i.startsWith(t)&&r.push(q(i,t))}return r}catch(r){return[]}}function z(){return T().length}function W(r,e,i={}){let{immediate:s=!0,deep:a=!0,debounce:y=100}=i;if(typeof r.$watch=="function")return r.$watch(e,y>0?x(p=>{c(e,p)},y):p=>{c(e,p)},{immediate:s,deep:a});if(typeof globalThis.watch=="function"){let f=globalThis.watch;return f(()=>r[e],y>0?x(S=>{c(e,S)},y):S=>{c(e,S)},{immediate:s,deep:a})}let d=r[e],D=setInterval(()=>{let f=r[e];f!==d&&(d=f,c(e,f))},200);return s&&c(e,d),()=>clearInterval(D)}function K(r,e,i){let s=m(e,i);return s!==null&&(r[e]=s,u(`restored ${e}`,s)),r[e]}let v={install(r,e){r.config=r.config||{},r.config.globalProperties=r.config.globalProperties||{},r.config.globalProperties.$storage=v,typeof r.provide=="function"&&r.provide("storage",v)},set:c,get:m,remove:h,clear:$,has:I,keys:T,size:z,watch:W,restore:K,get storage(){return o}};return v}
+var b=Object.defineProperty;var J=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var F=(n,t)=>{for(var o in t)b(n,o,{get:t[o],enumerable:!0})},R=(n,t,o,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let g of N(t))!_.call(n,g)&&g!==o&&b(n,g,{get:()=>t[g],enumerable:!(l=J(t,g))||l.enumerable});return n};var j=n=>R(b({},"__esModule",{value:!0}),n);var B={};F(B,{createStorage:()=>A});module.exports=j(B);function w(n,t){return`${t}${n}`}function q(n,t){return n.startsWith(t)?n.slice(t.length):n}function x(n,t){let o=null;return function(...l){o&&clearTimeout(o),o=setTimeout(()=>n.apply(this,l),t)}}function A(n={}){let{prefix:t="lyt_",storage:o=typeof localStorage!="undefined"?localStorage:{},expire:l,debug:g=!1,serialize:P=JSON.stringify,deserialize:O=JSON.parse}=n,u=(...r)=>{};function c(r,e,i){try{let s={value:e,timestamp:Date.now()},a=i!=null?i:l;a&&(s.expire=Date.now()+a);let y=w(r,t);o.setItem(y,P(s)),u(`set ${r}`,e)}catch(s){}}function m(r,e){try{let i=w(r,t),s=o.getItem(i);if(!s)return e!=null?e:null;let a=O(s);return a.expire&&Date.now()>a.expire?(u(`${r} expired, removing`),h(r),e!=null?e:null):(u(`get ${r}`,a.value),a.value)}catch(i){return e!=null?e:null}}function h(r){try{let e=w(r,t);o.removeItem(e),u(`removed ${r}`)}catch(e){}}function $(){try{let r=T();for(let e of r)h(e);u("cleared all")}catch(r){}}function I(r){return m(r)!==null}function T(){try{let r=[];for(let e=0;e<o.length;e++){let i=o.key(e);i&&i.startsWith(t)&&r.push(q(i,t))}return r}catch(r){return[]}}function z(){return T().length}function W(r,e,i={}){let{immediate:s=!0,deep:a=!0,debounce:y=100}=i;if(typeof r.$watch=="function")return r.$watch(e,y>0?x(p=>{c(e,p)},y):p=>{c(e,p)},{immediate:s,deep:a});if(typeof globalThis.watch=="function"){let f=globalThis.watch;return f(()=>r[e],y>0?x(S=>{c(e,S)},y):S=>{c(e,S)},{immediate:s,deep:a})}let d=r[e],D=setInterval(()=>{let f=r[e];f!==d&&(d=f,c(e,f))},200);return s&&c(e,d),()=>clearInterval(D)}function K(r,e,i){let s=m(e,i);return s!==null&&(r[e]=s,u(`restored ${e}`,s)),r[e]}let v={install(r,e){r.config=r.config||{},r.config.globalProperties=r.config.globalProperties||{},r.config.globalProperties.$storage=v,typeof r.provide=="function"&&r.provide("storage",v)},set:c,get:m,remove:h,clear:$,has:I,keys:T,size:z,watch:W,restore:K,get storage(){return o}};return v}

package/dist/types/index.d.ts

@@ -0,0 +1,60 @@
+/** 存储类型 */
+type StorageType = 'local' | 'session';
+/** 存储配置选项 */
+interface StorageOptions {
+    /** key 前缀，默认 'lyt_' */
+    prefix?: string;
+    /** 使用的存储对象，默认 localStorage */
+    storage?: Storage;
+    /** 过期时间（毫秒），默认无过期 */
+    expire?: number;
+    /** 是否开启调试模式 */
+    debug?: boolean;
+    /** 数据序列化函数，默认 JSON.stringify */
+    serialize?: (value: any) => string;
+    /** 数据反序列化函数，默认 JSON.parse */
+    deserialize?: (value: string) => any;
+}
+/** 存储插件实例 */
+interface StoragePlugin {
+    /** 安装到 Lyt 应用 */
+    install: (app: any, options?: any) => void;
+    /** 设置值 */
+    set<T = any>(key: string, value: T, expire?: number): void;
+    /** 获取值 */
+    get<T = any>(key: string, defaultValue?: T): T | null;
+    /** 删除值 */
+    remove(key: string): void;
+    /** 清空所有（仅当前前缀的） */
+    clear(): void;
+    /** 检查 key 是否存在 */
+    has(key: string): boolean;
+    /** 获取所有 key（仅当前前缀的） */
+    keys(): string[];
+    /** 获取存储使用情况 */
+    size(): number;
+    /** 监听响应式对象变化，自动保存 */
+    watch(target: any, key: string, options?: WatchOptions): () => void;
+    /** 从存储恢复响应式对象 */
+    restore<T = any>(target: any, key: string, defaultValue?: T): T;
+    /** 原始存储对象 */
+    readonly storage: Storage;
+}
+/** watch 配置选项 */
+interface WatchOptions {
+    /** 是否立即执行一次保存 */
+    immediate?: boolean;
+    /** 深度监听 */
+    deep?: boolean;
+    /** 防抖延迟（毫秒） */
+    debounce?: number;
+}
+/**
+ * 创建本地存储持久化插件实例
+ * @param options 存储配置
+ * @returns StoragePlugin 插件实例
+ */
+declare function createStorage(options?: StorageOptions): StoragePlugin;
+export { createStorage };
+export type { StorageOptions, StoragePlugin, WatchOptions, StorageType };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAeA,WAAW;AACX,KAAK,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAEtC,aAAa;AACb,UAAU,cAAc;IACtB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,gCAAgC;IAChC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAA;IAClC,6BAA6B;IAC7B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAA;CACrC;AAYD,aAAa;AACb,UAAU,aAAa;IACrB,iBAAiB;IACjB,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IAC1C,UAAU;IACV,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,UAAU;IACV,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IACrD,UAAU;IACV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,mBAAmB;IACnB,KAAK,IAAI,IAAI,CAAA;IACb,kBAAkB;IAClB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,uBAAuB;IACvB,IAAI,IAAI,MAAM,EAAE,CAAA;IAChB,eAAe;IACf,IAAI,IAAI,MAAM,CAAA;IACd,qBAAqB;IACrB,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,IAAI,CAAA;IACnE,iBAAiB;IACjB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IAC/D,aAAa;IACb,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,iBAAiB;AACjB,UAAU,YAAY;IACpB,iBAAiB;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW;IACX,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAkCD;;;;GAIG;AACH,iBAAS,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CA8OlE;AAED,OAAO,EAAE,aAAa,EAAE,CAAA;AACxB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,CAAA"}

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@lytjs/plugin-storage",
-  "version": "4.0.5",
+  "version": "4.2.0",
   "description": "Lyt.js 本地存储持久化插件 - 自动保存响应式状态到 localStorage/sessionStorage",
-  "main": "./src/index.ts",
-  "module": "./src/index.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.ts",
-      "require": "./src/index.ts",
-      "default": "./src/index.ts"
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
     }
   },
   "sideEffects": false,