adaptive-extender 0.7.1 → 0.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,5 @@
1
- ## 0.7.1 (19.10.2025)
2
- - Added module [archive-manager]().
1
+ ## 0.7.2 (20.10.2025)
2
+ - Added module [archive]().
3
3
 
4
4
  ## 0.6.1 (27.09.2025)
5
5
  - Added modules [promise](), [engine](), [parent-node](), [element]().
@@ -1,5 +1,31 @@
1
1
  import "../core/index.js";
2
- import type { ArchivablePrototype } from "../core/index.js";
2
+ import { type ArchivablePrototype } from "../core/index.js";
3
+ /**
4
+ * Represents a data archive stored in the local storage.
5
+ */
6
+ declare class Archive {
7
+ #private;
8
+ /**
9
+ * @param key The key to use for the local storage.
10
+ * @param initial The initial value to set if the archive is empty.
11
+ */
12
+ constructor(key: string, initial: any);
13
+ /**
14
+ * The key used in the local storage.
15
+ */
16
+ get key(): string;
17
+ /**
18
+ * The data stored in the archive.
19
+ * @throws {ReferenceError} If the archive is missing from the local storage.
20
+ * @throws {SyntaxError} If the archive is corrupted.
21
+ */
22
+ get data(): any;
23
+ /**
24
+ * The data stored in the archive.
25
+ * @throws {SyntaxError} If the value could not be processed.
26
+ */
27
+ set data(value: any);
28
+ }
3
29
  /**
4
30
  * Manages the archiving of an object.
5
31
  */
@@ -31,4 +57,32 @@ declare class ArchiveManager<T extends ArchivablePrototype> {
31
57
  */
32
58
  reset(): void;
33
59
  }
34
- export { ArchiveManager };
60
+ /**
61
+ * Provides a repository pattern for managing an archivable object with saving.
62
+ */
63
+ declare class ArchiveRepository<T extends ArchivablePrototype> {
64
+ #private;
65
+ /**
66
+ * @param key The key for the archive.
67
+ * @param prototype The prototype of the archivable object.
68
+ * @param args The arguments for the constructor of the archivable object.
69
+ */
70
+ constructor(key: string, prototype: T, ...args: ConstructorParameters<T>);
71
+ /**
72
+ * Key of the archive.
73
+ */
74
+ get key(): string;
75
+ /**
76
+ * The content of the archive.
77
+ */
78
+ get content(): InstanceType<T>;
79
+ /**
80
+ * Schedules a save of the content to the archive.
81
+ */
82
+ save(): void;
83
+ /**
84
+ * Resets the content of the archive to a new instance and updates the repository's content.
85
+ */
86
+ reset(): void;
87
+ }
88
+ export { Archive, ArchiveManager, ArchiveRepository };
@@ -1,5 +1,6 @@
1
1
  "use strict";
2
2
  import "../core/index.js";
3
+ import {} from "../core/index.js";
3
4
  //#region Archive
4
5
  /**
5
6
  * Represents a data archive stored in the local storage.
@@ -123,5 +124,65 @@ class ArchiveManager {
123
124
  }
124
125
  }
125
126
  //#endregion
126
- export { ArchiveManager };
127
+ //#region Archive repository
128
+ /**
129
+ * Provides a repository pattern for managing an archivable object with saving.
130
+ */
131
+ class ArchiveRepository {
132
+ #manager;
133
+ #content;
134
+ #idSaveTimeout = NaN;
135
+ /**
136
+ * @param key The key for the archive.
137
+ * @param prototype The prototype of the archivable object.
138
+ * @param args The arguments for the constructor of the archivable object.
139
+ */
140
+ constructor(key, prototype, ...args) {
141
+ this.#manager = new ArchiveManager(key, prototype, ...args);
142
+ this.#content = this.#manager.content;
143
+ window.addEventListener("beforeunload", (event) => {
144
+ if (Number.isNaN(this.#idSaveTimeout))
145
+ return;
146
+ event.returnValue = "Archive saving is in process. Do you want to interrupt?";
147
+ event.preventDefault();
148
+ });
149
+ }
150
+ /**
151
+ * Key of the archive.
152
+ */
153
+ get key() {
154
+ return this.#manager.key;
155
+ }
156
+ /**
157
+ * The content of the archive.
158
+ */
159
+ get content() {
160
+ return this.#content;
161
+ }
162
+ #handler() {
163
+ try {
164
+ this.#manager.content = this.#content;
165
+ }
166
+ finally {
167
+ this.#idSaveTimeout = NaN;
168
+ }
169
+ }
170
+ /**
171
+ * Schedules a save of the content to the archive.
172
+ */
173
+ save() {
174
+ if (!Number.isNaN(this.#idSaveTimeout))
175
+ clearTimeout(this.#idSaveTimeout);
176
+ this.#idSaveTimeout = setTimeout(this.#handler.bind(this));
177
+ }
178
+ /**
179
+ * Resets the content of the archive to a new instance and updates the repository's content.
180
+ */
181
+ reset() {
182
+ this.#manager.reset();
183
+ this.#content = this.#manager.content;
184
+ }
185
+ }
186
+ //#endregion
187
+ export { Archive, ArchiveManager, ArchiveRepository };
127
188
  //# sourceMappingURL=archive.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/web/archive.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/web/archive.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "adaptive-extender",
3
- "version": "0.7.1",
3
+ "version": "0.7.2",
4
4
  "description": "Adaptive library for JS/TS development environments",
5
5
  "type": "module",
6
6
  "main": "./dist/core/index.js",