synapse-storage 2.1.0

package/dist/core/storage/utils/storage.utils.js

@@ -0,0 +1,57 @@
+export const pathUtils = {
+    join: (...parts) => parts.filter(Boolean).join('.'),
+    getParent: (path) => {
+        const segments = path.split('.');
+        return segments.slice(0, -1).join('.');
+    },
+    isSubPath: (parent, child) => child.startsWith(`${parent}.`),
+    getSegments: (path) => path.split('.'),
+};
+export const dataUtils = {
+    flatten: (obj, prefix = '') => Object.keys(obj).reduce((acc, key) => {
+        const prefixKey = prefix ? `${prefix}.${key}` : key;
+        if (typeof obj[key] === 'object' && obj[key] !== null) {
+            if (Array.isArray(obj[key])) {
+                acc[prefixKey] = obj[key];
+            }
+            else {
+                Object.assign(acc, dataUtils.flatten(obj[key], prefixKey));
+            }
+        }
+        else {
+            acc[prefixKey] = obj[key];
+        }
+        return acc;
+    }, {}),
+    unflatten: (flat) => {
+        const result = {};
+        for (const key in flat) {
+            const segments = pathUtils.getSegments(key);
+            let current = result;
+            for (let i = 0; i < segments.length - 1; i++) {
+                const segment = segments[i];
+                current[segment] = current[segment] || {};
+                current = current[segment];
+            }
+            current[segments[segments.length - 1]] = flat[key];
+        }
+        return result;
+    },
+    clone: (data) => JSON.parse(JSON.stringify(data)),
+    merge: (target, source) => {
+        const merged = dataUtils.clone(target);
+        for (const key in source) {
+            if (typeof source[key] === 'object' && source[key] !== null) {
+                if (typeof merged[key] !== 'object') {
+                    merged[key] = {};
+                }
+                merged[key] = dataUtils.merge(merged[key], source[key]);
+            }
+            else {
+                merged[key] = source[key];
+            }
+        }
+        return merged;
+    },
+};
+//# sourceMappingURL=storage.utils.js.map

package/dist/core/storage/utils/storage.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.utils.js","sourceRoot":"","sources":["../../../../src/core/storage/utils/storage.utils.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,SAAS,GAA8B;IAClD,IAAI,EAAE,CAAC,GAAG,KAAe,EAAU,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;IACrE,SAAS,EAAE,CAAC,IAAY,EAAU,EAAE;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAChC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxC,CAAC;IACD,SAAS,EAAE,CAAC,MAAc,EAAE,KAAa,EAAW,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC;IACrF,WAAW,EAAE,CAAC,IAAY,EAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;CACzD,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAA8B;IAClD,OAAO,EAAE,CAAC,GAAQ,EAAE,MAAM,GAAG,EAAE,EAAuB,EAAE,CACtD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CACrB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACX,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;QAEnD,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC5B,GAAG,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;YAC3B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;YAC5D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,CAAC;QAED,OAAO,GAAG,CAAA;IACZ,CAAC,EACD,EAAyB,CAC1B;IACH,SAAS,EAAE,CAAC,IAAyB,EAAO,EAAE;QAC5C,MAAM,MAAM,GAAG,EAAE,CAAA;QAEjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;YAC3C,IAAI,OAAO,GAAwB,MAAM,CAAA;YAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;gBAC3B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;gBACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;YAC5B,CAAC;YAED,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;QACpD,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IACD,KAAK,EAAE,CAAI,IAAO,EAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,EAAE,CAAC,MAAW,EAAE,MAAW,EAAO,EAAE;QACvC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAEtC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC5D,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACpC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;gBAClB,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YACzD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA"}

package/dist/examples/_example5.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=_example5.d.ts.map

package/dist/examples/_example5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_example5.d.ts","sourceRoot":"","sources":["../../src/examples/_example5.tsx"],"names":[],"mappings":""}

package/dist/examples/_example5.js

@@ -0,0 +1,184 @@
+"use strict";
+// import React, { useState } from 'react'
+// import { MemoryStorage, StoragePluginModule, ILogger } from 'synapse'
+// import { LoggingPlugin, ValidationPlugin } from './plugins'
+//
+// // Типы данных
+// interface User {
+//   name: string;
+//   age: number;
+// }
+//
+// // Создаем модуль плагинов
+// const plugins = new StoragePluginModule(undefined, console, 'demoStorage')
+//
+// // Создаем стейт для ошибок, чтобы компоненты могли получить к нему доступ
+// const validationErrors: { [key: string]: string } = {}
+//
+// // Добавляем логирующий плагин
+// await plugins.add(new LoggingPlugin({ logLevel: 'debug' }))
+//
+// // Добавляем плагин валидации с обработчиком ошибок
+// const validation = new ValidationPlugin({
+//   throwOnInvalid: true, // Все равно генерировать ошибку
+//   onValidationError: (key, value, message) => {
+//     // Сохраняем ошибку в общем объекте
+//     validationErrors[key] = message
+//     console.error(`Validation error for ${key}: ${message}`, value)
+//   },
+// })
+//
+// // Настраиваем правила валидации
+// validation.addValidator('user', (value) => {
+//   // Сбрасываем ошибки при каждой валидации
+//   validationErrors.user = ''
+//
+//   if (!value || typeof value !== 'object') {
+//     return { valid: false, message: 'User must be an object' }
+//   }
+//
+//   if (!value.name || value.name.trim() === '') {
+//     return { valid: false, message: 'User must have a name' }
+//   }
+//
+//   if (typeof value.age !== 'number' || value.age < 10) {
+//     return { valid: false, message: 'Возраст должен быть больше 10' }
+//   }
+//
+//   return { valid: true }
+// })
+//
+// await plugins.add(validation)
+//
+//
+// // Создаем хранилище с плагинами
+// const storage = await new MemoryStorage<{user?: User}>({
+//   name: 'demoStorage',
+//   initialState: { version: '1.0.0' },
+// }, plugins).initialize()
+//
+// // Компонент для демонстрации
+// export function Example5() {
+//   const [user, setUser] = useState<User | null>(null)
+//   const [name, setName] = useState('')
+//   const [age, setAge] = useState('')
+//   const [error, setError] = useState<string | null>(null)
+//   const [fieldErrors, setFieldErrors] = useState<{name?: string, age?: string}>({})
+//
+//   // Функция для сохранения пользователя
+//   const saveUser = async () => {
+//     try {
+//       // Сбрасываем ошибки при каждой отправке
+//       setError(null)
+//       setFieldErrors({})
+//
+//       const userData: User = {
+//         name,
+//         age: parseInt(age, 10) || 0, // Преобразуем в число или 0, если невалидно
+//       }
+//
+//       await storage.set('user', userData)
+//       setUser(userData)
+//       console.log('User saved successfully')
+//     } catch (err) {
+//       // Получаем сообщение ошибки
+//       const errorMessage = err instanceof Error ? err.message : String(err)
+//
+//       // Устанавливаем общую ошибку
+//       setError(errorMessage)
+//
+//       // Определяем, какое поле вызвало ошибку и устанавливаем ошибку для него
+//       if (errorMessage.includes('name')) {
+//         setFieldErrors((prev) => ({ ...prev, name: 'Имя обязательно' }))
+//       }
+//
+//       if (errorMessage.includes('возраст') || errorMessage.includes('больше 10')) {
+//         setFieldErrors((prev) => ({ ...prev, age: 'Возраст должен быть больше 10' }))
+//       }
+//
+//       console.error('Error saving user:', errorMessage)
+//     }
+//   }
+//
+//   return (
+//     <div style={{ fontFamily: 'Arial', padding: '20px' }}>
+//       <h2>Пример с валидацией</h2>
+//
+//       {/* Если есть общая ошибка, показываем её */}
+//       {error && (
+//         <div style={{
+//           padding: '10px',
+//           backgroundColor: '#ffebee',
+//           color: '#d32f2f',
+//           borderRadius: '4px',
+//           marginBottom: '15px',
+//         }}
+//         >
+//           {error}
+//         </div>
+//       )}
+//
+//       <div style={{ marginBottom: '20px' }}>
+//         <div style={{ marginBottom: '10px' }}>
+//           <label style={{ display: 'block', marginBottom: '5px' }}>Имя:</label>
+//           <input
+//             type="text"
+//             value={name}
+//             onChange={(e) => setName(e.target.value)}
+//             style={{
+//               padding: '8px',
+//               width: '250px',
+//               border: fieldErrors.name ? '1px solid #d32f2f' : '1px solid #ccc',
+//             }}
+//           />
+//           {fieldErrors.name && (
+//             <div style={{ color: '#d32f2f', fontSize: '14px', marginTop: '5px' }}>
+//               {fieldErrors.name}
+//             </div>
+//           )}
+//         </div>
+//
+//         <div style={{ marginBottom: '15px' }}>
+//           <label style={{ display: 'block', marginBottom: '5px' }}>Возраст:</label>
+//           <input
+//             type="number"
+//             value={age}
+//             onChange={(e) => setAge(e.target.value)}
+//             style={{
+//               padding: '8px',
+//               width: '250px',
+//               border: fieldErrors.age ? '1px solid #d32f2f' : '1px solid #ccc',
+//             }}
+//           />
+//           {fieldErrors.age && (
+//             <div style={{ color: '#d32f2f', fontSize: '14px', marginTop: '5px' }}>
+//               {fieldErrors.age}
+//             </div>
+//           )}
+//         </div>
+//
+//         <button
+//           onClick={saveUser}
+//           style={{
+//             padding: '10px 15px',
+//             backgroundColor: '#4CAF50',
+//             color: 'white',
+//             border: 'none',
+//             borderRadius: '4px',
+//             cursor: 'pointer',
+//           }}
+//         >
+//           Сохранить
+//         </button>
+//       </div>
+//
+//       <div style={{ border: '1px solid #ddd', padding: '15px', borderRadius: '4px' }}>
+//         <h3>Текущие данные:</h3>
+//         <pre style={{ backgroundColor: '#f5f5f5', padding: '10px', borderRadius: '4px' }}>
+//           {user ? JSON.stringify(user, null, 2) : 'Нет данных'}
+//         </pre>
+//       </div>
+//     </div>
+//   )
+// }
+//# sourceMappingURL=_example5.js.map

package/dist/examples/_example5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_example5.js","sourceRoot":"","sources":["../../src/examples/_example5.tsx"],"names":[],"mappings":"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"}

package/dist/examples/_example6.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=_example6.d.ts.map

package/dist/examples/_example6.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_example6.d.ts","sourceRoot":"","sources":["../../src/examples/_example6.tsx"],"names":[],"mappings":""}

package/dist/examples/_example6.js

@@ -0,0 +1,168 @@
+"use strict";
+// import React, { useEffect, useState } from 'react'
+// import { IndexedDBStorage, LocalStorage, MemoryStorage, SelectorModule } from 'synapse'
+//
+// interface Counter {
+//   value: number;
+//   lastUpdated?: Date;
+// }
+//
+// // Создаем хранилища
+// const counter1 = await new MemoryStorage<Counter>({
+//   name: 'counter1',
+//   initialState: { value: 1 },
+// }).initialize()
+//
+// const counter2 = await new IndexedDBStorage<Counter>({
+//   name: 'counter2',
+//   options: {
+//     dbVersion: 2,
+//     storeName: 'counter23',
+//     dbName: 'counter23',
+//   },
+//   initialState: { value: 2 },
+// }).initialize()
+//
+// const counter3 = await new LocalStorage<Counter>({
+//   name: 'counter3',
+//   initialState: { value: 3 },
+// }).initialize()
+//
+// const counter1Selector = new SelectorModule<Counter>(counter1, console)
+// const counter2Selector = new SelectorModule(counter2)
+// const counter3Selector = new SelectorModule(counter3)
+//
+// const counter1ValueSelector = counter1Selector.createSelector((s) => s.value)
+// const counter2ValueSelector = counter2Selector.createSelector((s) => s.value)
+// const counter3ValueSelector = counter3Selector.createSelector((s) => s.value)
+//
+// const sum = counter3Selector.createSelector(
+//   [counter1ValueSelector, counter2ValueSelector, counter3ValueSelector],
+//   (a, b, c) => a + b + c,
+// )
+//
+// sum.subscribe({
+//   notify: (value) => {
+//     console.log('sum-notify', value)
+//   },
+// })
+//
+// counter1ValueSelector.subscribe({
+//   notify: (value) => {
+//     console.log('counter1ValueUnsubscribe', value)
+//   },
+// })
+//
+// counter2ValueSelector.subscribe({
+//   notify: async (value) => {
+//     console.log('counter2ValueUnsubscribe', value)
+//   },
+// })
+//
+// // Компонент для демонстрации работы middleware
+//
+// export const Example6 = React.memo(() => {
+//   const [counter1Value, setCounter1Value] = useState(0)
+//   const [counter2Value, setCounter2Value] = useState(0)
+//   const [counter3Value, setCounter3Value] = useState(0)
+//
+//   useEffect(() => {
+//     sum.select().then((r) => {
+//       console.log('result', r)
+//     })
+//     const a = sum.select().then((r) => r)
+//     console.log('a', a)
+//   }, [])
+//
+//   useEffect(() => {
+//     // Подписываемся на изменения counter1
+//     const unsubscribe1 = counter1.subscribe((s) => s.value, setCounter1Value)
+//     return () => {
+//       unsubscribe1()
+//     }
+//   }, [])
+//
+//   useEffect(() => {
+//     // Подписываемся на изменения counter1
+//     const unsubscribe2 = counter2.subscribe((s) => s.value, setCounter2Value)
+//     return () => {
+//       unsubscribe2()
+//     }
+//   }, [])
+//   useEffect(() => {
+//     // Подписываемся на изменения counter1
+//     const unsubscribe3 = counter3.subscribe((s) => s.value, setCounter3Value)
+//     return () => {
+//       unsubscribe3()
+//     }
+//   }, [])
+//
+//   // Функции для обновления счетчиков
+//   const updateCounter1 = async () => {
+//     await counter1.update((state) => {
+//       state.value++
+//     })
+//   }
+//
+//   const updateCounter2 = async () => {
+//     await counter2.update((state) => {
+//       state.value++
+//     })
+//   }
+//
+//   const updateCounter3 = async () => {
+//     await counter3.set('value', counter3Value + 1)
+//   }
+//
+//   return (
+//     <div style={{ fontFamily: 'Arial', padding: '20px' }}>
+//       <h2>Middleware Testing</h2>
+//
+//       <div style={{ display: 'flex', gap: '20px', marginBottom: '20px' }}>
+//         <div style={{ border: '1px solid #ccc', padding: '15px', borderRadius: '5px' }}>
+//           <h3>Counter 1 (Both Middlewares)</h3>
+//           <p>
+//             Value:
+//             {counter1Value}
+//           </p>
+//           <button
+//             onClick={updateCounter1}
+//             style={{ padding: '8px 15px', backgroundColor: '#4CAF50', color: 'white', border: 'none', borderRadius: '4px' }}
+//           >
+//             Increment
+//           </button>
+//         </div>
+//
+//         <div style={{ border: '1px solid #ccc', padding: '15px', borderRadius: '5px' }}>
+//           <h3>Counter 2 (ShallowCompare)</h3>
+//           <p>
+//             Value:
+//             {counter2Value}
+//           </p>
+//           <button
+//             onClick={updateCounter2}
+//             style={{ padding: '8px 15px', backgroundColor: '#2196F3', color: 'white', border: 'none', borderRadius: '4px' }}
+//           >
+//             Update
+//           </button>
+//           <p><small>Every 3rd click tries to set the same value</small></p>
+//         </div>
+//
+//         <div style={{ border: '1px solid #ccc', padding: '15px', borderRadius: '5px' }}>
+//           <h3>Counter 3 (Batching)</h3>
+//           <p>
+//             Value:
+//             {counter3Value}
+//           </p>
+//           <button
+//             onClick={updateCounter3}
+//             style={{ padding: '8px 15px', backgroundColor: '#FF9800', color: 'white', border: 'none', borderRadius: '4px' }}
+//           >
+//             Batch Update
+//           </button>
+//         </div>
+//       </div>
+//     </div>
+//   )
+// })
+//# sourceMappingURL=_example6.js.map

package/dist/examples/_example6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_example6.js","sourceRoot":"","sources":["../../src/examples/_example6.tsx"],"names":[],"mappings":";AAAA,qDAAqD;AACrD,0FAA0F;AAC1F,EAAE;AACF,sBAAsB;AACtB,mBAAmB;AACnB,wBAAwB;AACxB,IAAI;AACJ,EAAE;AACF,uBAAuB;AACvB,sDAAsD;AACtD,sBAAsB;AACtB,gCAAgC;AAChC,kBAAkB;AAClB,EAAE;AACF,yDAAyD;AACzD,sBAAsB;AACtB,eAAe;AACf,oBAAoB;AACpB,8BAA8B;AAC9B,2BAA2B;AAC3B,OAAO;AACP,gCAAgC;AAChC,kBAAkB;AAClB,EAAE;AACF,qDAAqD;AACrD,sBAAsB;AACtB,gCAAgC;AAChC,kBAAkB;AAClB,EAAE;AACF,0EAA0E;AAC1E,wDAAwD;AACxD,wDAAwD;AACxD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,EAAE;AACF,+CAA+C;AAC/C,2EAA2E;AAC3E,4BAA4B;AAC5B,IAAI;AACJ,EAAE;AACF,kBAAkB;AAClB,yBAAyB;AACzB,uCAAuC;AACvC,OAAO;AACP,KAAK;AACL,EAAE;AACF,oCAAoC;AACpC,yBAAyB;AACzB,qDAAqD;AACrD,OAAO;AACP,KAAK;AACL,EAAE;AACF,oCAAoC;AACpC,+BAA+B;AAC/B,qDAAqD;AACrD,OAAO;AACP,KAAK;AACL,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,6CAA6C;AAC7C,0DAA0D;AAC1D,0DAA0D;AAC1D,0DAA0D;AAC1D,EAAE;AACF,sBAAsB;AACtB,iCAAiC;AACjC,iCAAiC;AACjC,SAAS;AACT,4CAA4C;AAC5C,0BAA0B;AAC1B,WAAW;AACX,EAAE;AACF,sBAAsB;AACtB,6CAA6C;AAC7C,gFAAgF;AAChF,qBAAqB;AACrB,uBAAuB;AACvB,QAAQ;AACR,WAAW;AACX,EAAE;AACF,sBAAsB;AACtB,6CAA6C;AAC7C,gFAAgF;AAChF,qBAAqB;AACrB,uBAAuB;AACvB,QAAQ;AACR,WAAW;AACX,sBAAsB;AACtB,6CAA6C;AAC7C,gFAAgF;AAChF,qBAAqB;AACrB,uBAAuB;AACvB,QAAQ;AACR,WAAW;AACX,EAAE;AACF,wCAAwC;AACxC,yCAAyC;AACzC,yCAAyC;AACzC,sBAAsB;AACtB,SAAS;AACT,MAAM;AACN,EAAE;AACF,yCAAyC;AACzC,yCAAyC;AACzC,sBAAsB;AACtB,SAAS;AACT,MAAM;AACN,EAAE;AACF,yCAAyC;AACzC,qDAAqD;AACrD,MAAM;AACN,EAAE;AACF,aAAa;AACb,6DAA6D;AAC7D,oCAAoC;AACpC,EAAE;AACF,6EAA6E;AAC7E,2FAA2F;AAC3F,kDAAkD;AAClD,gBAAgB;AAChB,qBAAqB;AACrB,8BAA8B;AAC9B,iBAAiB;AACjB,oBAAoB;AACpB,uCAAuC;AACvC,+HAA+H;AAC/H,cAAc;AACd,wBAAwB;AACxB,sBAAsB;AACtB,iBAAiB;AACjB,EAAE;AACF,2FAA2F;AAC3F,gDAAgD;AAChD,gBAAgB;AAChB,qBAAqB;AACrB,8BAA8B;AAC9B,iBAAiB;AACjB,oBAAoB;AACpB,uCAAuC;AACvC,+HAA+H;AAC/H,cAAc;AACd,qBAAqB;AACrB,sBAAsB;AACtB,8EAA8E;AAC9E,iBAAiB;AACjB,EAAE;AACF,2FAA2F;AAC3F,0CAA0C;AAC1C,gBAAgB;AAChB,qBAAqB;AACrB,8BAA8B;AAC9B,iBAAiB;AACjB,oBAAoB;AACpB,uCAAuC;AACvC,+HAA+H;AAC/H,cAAc;AACd,2BAA2B;AAC3B,sBAAsB;AACtB,iBAAiB;AACjB,eAAe;AACf,aAAa;AACb,MAAM;AACN,KAAK"}

package/dist/examples/plugins.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=plugins.d.ts.map

package/dist/examples/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/examples/plugins.ts"],"names":[],"mappings":""}

package/dist/examples/plugins.js

@@ -0,0 +1,176 @@
+"use strict";
+// import { IStoragePlugin, PluginContext, StorageKeyType } from 'synapse'
+//
+// /**
+//  * Пример 1: LoggingPlugin
+//  *
+//  * Плагин для логирования операций хранилища.
+//  * Записывает информацию о всех операциях в консоль или пользовательский логгер.
+//  */
+// export class LoggingPlugin implements IStoragePlugin {
+//   name = 'logging'
+//
+//   constructor(
+//     private options: {
+//       logLevel?: 'info' | 'debug' | 'verbose',
+//       customLogger?: (message: string, data?: any) => void
+//     } = {},
+//   ) {}
+//
+//   private log(message: string, data?: any): void {
+//     const formattedMessage = `[LoggingPlugin] ${message}`
+//
+//     if (this.options.customLogger) {
+//       this.options.customLogger(formattedMessage, data)
+//     } else if (this.options.logLevel === 'verbose') {
+//       console.log(formattedMessage, data)
+//     } else if (this.options.logLevel === 'debug' || !this.options.logLevel) {
+//       console.log(formattedMessage)
+//     } else {
+//       console.log(formattedMessage)
+//     }
+//   }
+//
+//   async initialize(): Promise<void> {
+//     this.log('Плагин инициализирован')
+//   }
+//
+//   async destroy(): Promise<void> {
+//     this.log('Плагин уничтожен')
+//   }
+//
+//   async onBeforeSet<T>(value: T, context: PluginContext): Promise<T> {
+//     this.log(
+//       `Сохранение значения в хранилище ${context.storageName}`,
+//       this.options.logLevel === 'verbose' ? value : undefined,
+//     )
+//     return value
+//   }
+//
+//   async onAfterSet<T>(key: StorageKeyType, value: T, context: PluginContext): Promise<T> {
+//     this.log(
+//       `Значение сохранено по ключу ${String(key)}`,
+//       this.options.logLevel === 'verbose' ? value : undefined,
+//     )
+//     return value
+//   }
+//
+//   async onBeforeGet(key: StorageKeyType, context: PluginContext): Promise<StorageKeyType> {
+//     this.log(`Запрос значения по ключу ${String(key)}`)
+//     return key
+//   }
+//
+//   async onAfterGet<T>(key: StorageKeyType, value: T | undefined, context: PluginContext): Promise<T | undefined> {
+//     if (value === undefined) {
+//       this.log(`Значение не найдено по ключу ${String(key)}`)
+//     } else {
+//       this.log(
+//         `Получено значение по ключу ${String(key)}`,
+//         this.options.logLevel === 'verbose' ? value : undefined,
+//       )
+//     }
+//     return value
+//   }
+//
+//   async onBeforeDelete(key: StorageKeyType, context: PluginContext): Promise<boolean> {
+//     this.log(`Запрос на удаление значения по ключу ${String(key)}`)
+//     return true
+//   }
+//
+//   async onAfterDelete(key: StorageKeyType, context: PluginContext): Promise<void> {
+//     this.log(`Значение удалено по ключу ${String(key)}`)
+//   }
+//
+//   async onClear(context: PluginContext): Promise<void> {
+//     this.log(`Хранилище ${context.storageName} очищено`)
+//   }
+// }
+//
+// /**
+//  * Пример 2: ValidationPlugin
+//  *
+//  * Плагин для валидации данных перед сохранением в хранилище.
+//  * Позволяет устанавливать правила валидации для определенных ключей.
+//  */
+// export class ValidationPlugin implements IStoragePlugin {
+//   name = 'validation'
+//
+//   private validators = new Map<string, (value: any) => { valid: boolean, message?: string }>()
+//
+//   constructor(
+//     private options: {
+//       throwOnInvalid?: boolean;
+//       onValidationError?: (key: string, value: any, message: string) => void;
+//     } = { throwOnInvalid: true },
+//   ) {}
+//
+//   /**
+//    * Добавляет правило валидации для определенного ключа
+//    *
+//    * @param key Ключ, для которого применяется валидация
+//    * @param validator Функция валидации, возвращающая результат проверки
+//    * @returns Экземпляр плагина для цепочки вызовов
+//    */
+//   addValidator(
+//     key: string,
+//     validator: (value: any) => { valid: boolean, message?: string },
+//   ): this {
+//     this.validators.set(key, validator)
+//     return this
+//   }
+//
+//   /**
+//    * Помощник для создания валидатора по JSON-схеме
+//    *
+//    * @param schema Объект описывающий схему данных
+//    * @returns Функция-валидатор
+//    */
+//   static schemaValidator(schema: any): (value: any) => { valid: boolean, message?: string } {
+//     return (value: any) => {
+//       // Здесь должна быть реализация проверки по JSON-схеме
+//       // Для примера используем упрощенную логику
+//       if (schema.type === 'object' && typeof value !== 'object') {
+//         return { valid: false, message: 'Value must be an object' }
+//       }
+//
+//       if (schema.type === 'array' && !Array.isArray(value)) {
+//         return { valid: false, message: 'Value must be an array' }
+//       }
+//
+//       if (schema.required && Array.isArray(schema.required)) {
+//         for (const prop of schema.required) {
+//           if (value[prop] === undefined) {
+//             return { valid: false, message: `Required property "${prop}" is missing` }
+//           }
+//         }
+//       }
+//
+//       return { valid: true }
+//     }
+//   }
+//
+//   async onBeforeSet<T>(value: T, context: PluginContext): Promise<T> {
+//     // Получаем ключ из метаданных (должен быть добавлен хранилищем)
+//     const key = context.metadata?.key
+//
+//     if (key && this.validators.has(key)) {
+//       const validator = this.validators.get(key)!
+//       const result = validator(value)
+//
+//       if (!result.valid) {
+//         const errorMessage = result.message || `Validation failed for key "${key}"`
+//
+//         if (this.options.onValidationError) {
+//           this.options.onValidationError(key, value, errorMessage)
+//         }
+//
+//         if (this.options.throwOnInvalid) {
+//           throw new Error(errorMessage)
+//         }
+//       }
+//     }
+//
+//     return value
+//   }
+// }
+//# sourceMappingURL=plugins.js.map

package/dist/examples/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/examples/plugins.ts"],"names":[],"mappings":"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"}

package/dist/examples/pokemons/PokemonList.d.ts

@@ -0,0 +1,2 @@
+export declare function SimplePokemonViewer(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PokemonList.d.ts.map

package/dist/examples/pokemons/PokemonList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PokemonList.d.ts","sourceRoot":"","sources":["../../../src/examples/pokemons/PokemonList.tsx"],"names":[],"mappings":"AAcA,wBAAgB,mBAAmB,4CA0JlC"}