@voidhash/mimic-effect 0.0.9 → 1.0.0-beta.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.
Files changed (227) hide show
  1. package/.turbo/turbo-build.log +136 -90
  2. package/README.md +385 -0
  3. package/dist/ColdStorage.cjs +60 -0
  4. package/dist/ColdStorage.d.cts +53 -0
  5. package/dist/ColdStorage.d.cts.map +1 -0
  6. package/dist/ColdStorage.d.mts +53 -0
  7. package/dist/ColdStorage.d.mts.map +1 -0
  8. package/dist/ColdStorage.mjs +60 -0
  9. package/dist/ColdStorage.mjs.map +1 -0
  10. package/dist/DocumentManager.cjs +263 -82
  11. package/dist/DocumentManager.d.cts +44 -22
  12. package/dist/DocumentManager.d.cts.map +1 -1
  13. package/dist/DocumentManager.d.mts +44 -22
  14. package/dist/DocumentManager.d.mts.map +1 -1
  15. package/dist/DocumentManager.mjs +259 -67
  16. package/dist/DocumentManager.mjs.map +1 -1
  17. package/dist/Errors.cjs +54 -0
  18. package/dist/Errors.d.cts +96 -0
  19. package/dist/Errors.d.cts.map +1 -0
  20. package/dist/Errors.d.mts +96 -0
  21. package/dist/Errors.d.mts.map +1 -0
  22. package/dist/Errors.mjs +48 -0
  23. package/dist/Errors.mjs.map +1 -0
  24. package/dist/HotStorage.cjs +100 -0
  25. package/dist/HotStorage.d.cts +70 -0
  26. package/dist/HotStorage.d.cts.map +1 -0
  27. package/dist/HotStorage.d.mts +70 -0
  28. package/dist/HotStorage.d.mts.map +1 -0
  29. package/dist/HotStorage.mjs +100 -0
  30. package/dist/HotStorage.mjs.map +1 -0
  31. package/dist/Metrics.cjs +143 -0
  32. package/dist/Metrics.d.cts +31 -0
  33. package/dist/Metrics.d.cts.map +1 -0
  34. package/dist/Metrics.d.mts +31 -0
  35. package/dist/Metrics.d.mts.map +1 -0
  36. package/dist/Metrics.mjs +126 -0
  37. package/dist/Metrics.mjs.map +1 -0
  38. package/dist/MimicAuthService.cjs +61 -45
  39. package/dist/MimicAuthService.d.cts +61 -48
  40. package/dist/MimicAuthService.d.cts.map +1 -1
  41. package/dist/MimicAuthService.d.mts +61 -48
  42. package/dist/MimicAuthService.d.mts.map +1 -1
  43. package/dist/MimicAuthService.mjs +60 -36
  44. package/dist/MimicAuthService.mjs.map +1 -1
  45. package/dist/MimicClusterServerEngine.cjs +521 -0
  46. package/dist/MimicClusterServerEngine.d.cts +17 -0
  47. package/dist/MimicClusterServerEngine.d.cts.map +1 -0
  48. package/dist/MimicClusterServerEngine.d.mts +17 -0
  49. package/dist/MimicClusterServerEngine.d.mts.map +1 -0
  50. package/dist/MimicClusterServerEngine.mjs +523 -0
  51. package/dist/MimicClusterServerEngine.mjs.map +1 -0
  52. package/dist/MimicServer.cjs +205 -96
  53. package/dist/MimicServer.d.cts +9 -110
  54. package/dist/MimicServer.d.cts.map +1 -1
  55. package/dist/MimicServer.d.mts +9 -110
  56. package/dist/MimicServer.d.mts.map +1 -1
  57. package/dist/MimicServer.mjs +206 -90
  58. package/dist/MimicServer.mjs.map +1 -1
  59. package/dist/MimicServerEngine.cjs +97 -0
  60. package/dist/MimicServerEngine.d.cts +78 -0
  61. package/dist/MimicServerEngine.d.cts.map +1 -0
  62. package/dist/MimicServerEngine.d.mts +78 -0
  63. package/dist/MimicServerEngine.d.mts.map +1 -0
  64. package/dist/MimicServerEngine.mjs +97 -0
  65. package/dist/MimicServerEngine.mjs.map +1 -0
  66. package/dist/PresenceManager.cjs +75 -91
  67. package/dist/PresenceManager.d.cts +17 -66
  68. package/dist/PresenceManager.d.cts.map +1 -1
  69. package/dist/PresenceManager.d.mts +17 -66
  70. package/dist/PresenceManager.d.mts.map +1 -1
  71. package/dist/PresenceManager.mjs +74 -78
  72. package/dist/PresenceManager.mjs.map +1 -1
  73. package/dist/Protocol.cjs +146 -0
  74. package/dist/Protocol.d.cts +203 -0
  75. package/dist/Protocol.d.cts.map +1 -0
  76. package/dist/Protocol.d.mts +203 -0
  77. package/dist/Protocol.d.mts.map +1 -0
  78. package/dist/Protocol.mjs +132 -0
  79. package/dist/Protocol.mjs.map +1 -0
  80. package/dist/Types.d.cts +172 -0
  81. package/dist/Types.d.cts.map +1 -0
  82. package/dist/Types.d.mts +172 -0
  83. package/dist/Types.d.mts.map +1 -0
  84. package/dist/_virtual/rolldown_runtime.cjs +1 -25
  85. package/dist/_virtual/rolldown_runtime.mjs +4 -1
  86. package/dist/index.cjs +37 -75
  87. package/dist/index.d.cts +13 -12
  88. package/dist/index.d.mts +13 -12
  89. package/dist/index.mjs +12 -12
  90. package/dist/testing/ColdStorageTestSuite.cjs +508 -0
  91. package/dist/testing/ColdStorageTestSuite.d.cts +36 -0
  92. package/dist/testing/ColdStorageTestSuite.d.cts.map +1 -0
  93. package/dist/testing/ColdStorageTestSuite.d.mts +36 -0
  94. package/dist/testing/ColdStorageTestSuite.d.mts.map +1 -0
  95. package/dist/testing/ColdStorageTestSuite.mjs +508 -0
  96. package/dist/testing/ColdStorageTestSuite.mjs.map +1 -0
  97. package/dist/testing/FailingStorage.cjs +135 -0
  98. package/dist/testing/FailingStorage.d.cts +43 -0
  99. package/dist/testing/FailingStorage.d.cts.map +1 -0
  100. package/dist/testing/FailingStorage.d.mts +43 -0
  101. package/dist/testing/FailingStorage.d.mts.map +1 -0
  102. package/dist/testing/FailingStorage.mjs +136 -0
  103. package/dist/testing/FailingStorage.mjs.map +1 -0
  104. package/dist/testing/HotStorageTestSuite.cjs +585 -0
  105. package/dist/testing/HotStorageTestSuite.d.cts +40 -0
  106. package/dist/testing/HotStorageTestSuite.d.cts.map +1 -0
  107. package/dist/testing/HotStorageTestSuite.d.mts +40 -0
  108. package/dist/testing/HotStorageTestSuite.d.mts.map +1 -0
  109. package/dist/testing/HotStorageTestSuite.mjs +585 -0
  110. package/dist/testing/HotStorageTestSuite.mjs.map +1 -0
  111. package/dist/testing/StorageIntegrationTestSuite.cjs +349 -0
  112. package/dist/testing/StorageIntegrationTestSuite.d.cts +35 -0
  113. package/dist/testing/StorageIntegrationTestSuite.d.cts.map +1 -0
  114. package/dist/testing/StorageIntegrationTestSuite.d.mts +35 -0
  115. package/dist/testing/StorageIntegrationTestSuite.d.mts.map +1 -0
  116. package/dist/testing/StorageIntegrationTestSuite.mjs +349 -0
  117. package/dist/testing/StorageIntegrationTestSuite.mjs.map +1 -0
  118. package/dist/testing/assertions.cjs +114 -0
  119. package/dist/testing/assertions.mjs +109 -0
  120. package/dist/testing/assertions.mjs.map +1 -0
  121. package/dist/testing/index.cjs +14 -0
  122. package/dist/testing/index.d.cts +6 -0
  123. package/dist/testing/index.d.mts +6 -0
  124. package/dist/testing/index.mjs +7 -0
  125. package/dist/testing/types.cjs +15 -0
  126. package/dist/testing/types.d.cts +90 -0
  127. package/dist/testing/types.d.cts.map +1 -0
  128. package/dist/testing/types.d.mts +90 -0
  129. package/dist/testing/types.d.mts.map +1 -0
  130. package/dist/testing/types.mjs +16 -0
  131. package/dist/testing/types.mjs.map +1 -0
  132. package/package.json +18 -3
  133. package/src/ColdStorage.ts +136 -0
  134. package/src/DocumentManager.ts +550 -190
  135. package/src/Errors.ts +114 -0
  136. package/src/HotStorage.ts +239 -0
  137. package/src/Metrics.ts +187 -0
  138. package/src/MimicAuthService.ts +126 -64
  139. package/src/MimicClusterServerEngine.ts +946 -0
  140. package/src/MimicServer.ts +448 -195
  141. package/src/MimicServerEngine.ts +276 -0
  142. package/src/PresenceManager.ts +169 -240
  143. package/src/Protocol.ts +350 -0
  144. package/src/Types.ts +231 -0
  145. package/src/index.ts +57 -23
  146. package/src/testing/ColdStorageTestSuite.ts +589 -0
  147. package/src/testing/FailingStorage.ts +286 -0
  148. package/src/testing/HotStorageTestSuite.ts +762 -0
  149. package/src/testing/StorageIntegrationTestSuite.ts +504 -0
  150. package/src/testing/assertions.ts +181 -0
  151. package/src/testing/index.ts +83 -0
  152. package/src/testing/types.ts +100 -0
  153. package/tests/ColdStorage.test.ts +24 -0
  154. package/tests/DocumentManager.test.ts +158 -287
  155. package/tests/HotStorage.test.ts +24 -0
  156. package/tests/MimicAuthService.test.ts +102 -134
  157. package/tests/MimicClusterServerEngine.test.ts +587 -0
  158. package/tests/MimicServer.test.ts +90 -226
  159. package/tests/MimicServerEngine.test.ts +521 -0
  160. package/tests/PresenceManager.test.ts +22 -63
  161. package/tests/Protocol.test.ts +190 -0
  162. package/tests/StorageIntegration.test.ts +259 -0
  163. package/tsconfig.json +1 -1
  164. package/tsdown.config.ts +1 -1
  165. package/dist/DocumentProtocol.cjs +0 -94
  166. package/dist/DocumentProtocol.d.cts +0 -113
  167. package/dist/DocumentProtocol.d.cts.map +0 -1
  168. package/dist/DocumentProtocol.d.mts +0 -113
  169. package/dist/DocumentProtocol.d.mts.map +0 -1
  170. package/dist/DocumentProtocol.mjs +0 -89
  171. package/dist/DocumentProtocol.mjs.map +0 -1
  172. package/dist/MimicConfig.cjs +0 -60
  173. package/dist/MimicConfig.d.cts +0 -141
  174. package/dist/MimicConfig.d.cts.map +0 -1
  175. package/dist/MimicConfig.d.mts +0 -141
  176. package/dist/MimicConfig.d.mts.map +0 -1
  177. package/dist/MimicConfig.mjs +0 -50
  178. package/dist/MimicConfig.mjs.map +0 -1
  179. package/dist/MimicDataStorage.cjs +0 -83
  180. package/dist/MimicDataStorage.d.cts +0 -113
  181. package/dist/MimicDataStorage.d.cts.map +0 -1
  182. package/dist/MimicDataStorage.d.mts +0 -113
  183. package/dist/MimicDataStorage.d.mts.map +0 -1
  184. package/dist/MimicDataStorage.mjs +0 -74
  185. package/dist/MimicDataStorage.mjs.map +0 -1
  186. package/dist/WebSocketHandler.cjs +0 -365
  187. package/dist/WebSocketHandler.d.cts +0 -34
  188. package/dist/WebSocketHandler.d.cts.map +0 -1
  189. package/dist/WebSocketHandler.d.mts +0 -34
  190. package/dist/WebSocketHandler.d.mts.map +0 -1
  191. package/dist/WebSocketHandler.mjs +0 -355
  192. package/dist/WebSocketHandler.mjs.map +0 -1
  193. package/dist/auth/NoAuth.cjs +0 -43
  194. package/dist/auth/NoAuth.d.cts +0 -22
  195. package/dist/auth/NoAuth.d.cts.map +0 -1
  196. package/dist/auth/NoAuth.d.mts +0 -22
  197. package/dist/auth/NoAuth.d.mts.map +0 -1
  198. package/dist/auth/NoAuth.mjs +0 -36
  199. package/dist/auth/NoAuth.mjs.map +0 -1
  200. package/dist/errors.cjs +0 -74
  201. package/dist/errors.d.cts +0 -89
  202. package/dist/errors.d.cts.map +0 -1
  203. package/dist/errors.d.mts +0 -89
  204. package/dist/errors.d.mts.map +0 -1
  205. package/dist/errors.mjs +0 -67
  206. package/dist/errors.mjs.map +0 -1
  207. package/dist/storage/InMemoryDataStorage.cjs +0 -57
  208. package/dist/storage/InMemoryDataStorage.d.cts +0 -19
  209. package/dist/storage/InMemoryDataStorage.d.cts.map +0 -1
  210. package/dist/storage/InMemoryDataStorage.d.mts +0 -19
  211. package/dist/storage/InMemoryDataStorage.d.mts.map +0 -1
  212. package/dist/storage/InMemoryDataStorage.mjs +0 -48
  213. package/dist/storage/InMemoryDataStorage.mjs.map +0 -1
  214. package/src/DocumentProtocol.ts +0 -112
  215. package/src/MimicConfig.ts +0 -211
  216. package/src/MimicDataStorage.ts +0 -157
  217. package/src/WebSocketHandler.ts +0 -735
  218. package/src/auth/NoAuth.ts +0 -46
  219. package/src/errors.ts +0 -113
  220. package/src/storage/InMemoryDataStorage.ts +0 -66
  221. package/tests/DocumentProtocol.test.ts +0 -113
  222. package/tests/InMemoryDataStorage.test.ts +0 -190
  223. package/tests/MimicConfig.test.ts +0 -290
  224. package/tests/MimicDataStorage.test.ts +0 -190
  225. package/tests/NoAuth.test.ts +0 -94
  226. package/tests/WebSocketHandler.test.ts +0 -321
  227. package/tests/errors.test.ts +0 -77
@@ -0,0 +1,135 @@
1
+ const require_ColdStorage = require('../ColdStorage.cjs');
2
+ const require_Errors = require('../Errors.cjs');
3
+ const require_HotStorage = require('../HotStorage.cjs');
4
+ let effect = require("effect");
5
+
6
+ //#region src/testing/FailingStorage.ts
7
+ /**
8
+ * @voidhash/mimic-effect/testing - FailingStorage
9
+ *
10
+ * Mock storage implementations that simulate failures for testing error handling.
11
+ * Use these to verify that your application correctly handles storage unavailability.
12
+ *
13
+ * @example
14
+ * ```typescript
15
+ * import { FailingStorage } from "@voidhash/mimic-effect/testing";
16
+ *
17
+ * // Create a ColdStorage that fails on load
18
+ * const failingCold = FailingStorage.makeColdStorage({ failLoad: true });
19
+ *
20
+ * // Create a HotStorage that fails after 3 successful appends
21
+ * const failingHot = FailingStorage.makeHotStorage({ failAfterN: 3, failAppend: true });
22
+ * ```
23
+ */
24
+ /**
25
+ * Create a ColdStorage layer that simulates failures.
26
+ * Wraps an in-memory storage and fails according to configuration.
27
+ */
28
+ const makeColdStorage = (config = {}) => effect.Layer.effect(require_ColdStorage.ColdStorageTag, effect.Effect.gen(function* () {
29
+ var _config$errorMessage;
30
+ const store = yield* effect.Ref.make(effect.HashMap.empty());
31
+ const operationCount = yield* effect.Ref.make(0);
32
+ const errorMessage = (_config$errorMessage = config.errorMessage) !== null && _config$errorMessage !== void 0 ? _config$errorMessage : "Simulated storage failure";
33
+ const shouldFail = (operation) => effect.Effect.gen(function* () {
34
+ const opFails = operation === "load" && config.failLoad || operation === "save" && config.failSave || operation === "delete" && config.failDelete;
35
+ if (config.failAfterN !== void 0) {
36
+ const count = yield* effect.Ref.get(operationCount);
37
+ yield* effect.Ref.update(operationCount, (n) => n + 1);
38
+ if (count < config.failAfterN) return false;
39
+ return opFails;
40
+ }
41
+ return opFails;
42
+ });
43
+ return {
44
+ load: (documentId) => effect.Effect.gen(function* () {
45
+ if (yield* shouldFail("load")) return yield* effect.Effect.fail(new require_Errors.ColdStorageError({
46
+ documentId,
47
+ operation: "load",
48
+ cause: new Error(errorMessage)
49
+ }));
50
+ const current = yield* effect.Ref.get(store);
51
+ const doc = effect.HashMap.get(current, documentId);
52
+ return doc._tag === "Some" ? doc.value : void 0;
53
+ }),
54
+ save: (documentId, document) => effect.Effect.gen(function* () {
55
+ if (yield* shouldFail("save")) return yield* effect.Effect.fail(new require_Errors.ColdStorageError({
56
+ documentId,
57
+ operation: "save",
58
+ cause: new Error(errorMessage)
59
+ }));
60
+ yield* effect.Ref.update(store, (map) => effect.HashMap.set(map, documentId, document));
61
+ }),
62
+ delete: (documentId) => effect.Effect.gen(function* () {
63
+ if (yield* shouldFail("delete")) return yield* effect.Effect.fail(new require_Errors.ColdStorageError({
64
+ documentId,
65
+ operation: "delete",
66
+ cause: new Error(errorMessage)
67
+ }));
68
+ yield* effect.Ref.update(store, (map) => effect.HashMap.remove(map, documentId));
69
+ })
70
+ };
71
+ }));
72
+ /**
73
+ * Create a HotStorage layer that simulates failures.
74
+ * Wraps an in-memory storage and fails according to configuration.
75
+ */
76
+ const makeHotStorage = (config = {}) => effect.Layer.effect(require_HotStorage.HotStorageTag, effect.Effect.gen(function* () {
77
+ var _config$errorMessage2;
78
+ const store = yield* effect.Ref.make(effect.HashMap.empty());
79
+ const operationCount = yield* effect.Ref.make(0);
80
+ const errorMessage = (_config$errorMessage2 = config.errorMessage) !== null && _config$errorMessage2 !== void 0 ? _config$errorMessage2 : "Simulated storage failure";
81
+ const shouldFail = (operation) => effect.Effect.gen(function* () {
82
+ const opFails = operation === "append" && config.failAppend || operation === "getEntries" && config.failGetEntries || operation === "truncate" && config.failTruncate;
83
+ if (config.failAfterN !== void 0) {
84
+ const count = yield* effect.Ref.get(operationCount);
85
+ yield* effect.Ref.update(operationCount, (n) => n + 1);
86
+ if (count < config.failAfterN) return false;
87
+ return opFails;
88
+ }
89
+ return opFails;
90
+ });
91
+ return {
92
+ append: (documentId, entry) => effect.Effect.gen(function* () {
93
+ if (yield* shouldFail("append")) return yield* effect.Effect.fail(new require_Errors.HotStorageError({
94
+ documentId,
95
+ operation: "append",
96
+ cause: new Error(errorMessage)
97
+ }));
98
+ yield* effect.Ref.update(store, (map) => {
99
+ const current = effect.HashMap.get(map, documentId);
100
+ const entries = current._tag === "Some" ? current.value : [];
101
+ return effect.HashMap.set(map, documentId, [...entries, entry]);
102
+ });
103
+ }),
104
+ getEntries: (documentId, sinceVersion) => effect.Effect.gen(function* () {
105
+ if (yield* shouldFail("getEntries")) return yield* effect.Effect.fail(new require_Errors.HotStorageError({
106
+ documentId,
107
+ operation: "getEntries",
108
+ cause: new Error(errorMessage)
109
+ }));
110
+ const current = yield* effect.Ref.get(store);
111
+ const existing = effect.HashMap.get(current, documentId);
112
+ return (existing._tag === "Some" ? existing.value : []).filter((e) => e.version > sinceVersion).sort((a, b) => a.version - b.version);
113
+ }),
114
+ truncate: (documentId, upToVersion) => effect.Effect.gen(function* () {
115
+ if (yield* shouldFail("truncate")) return yield* effect.Effect.fail(new require_Errors.HotStorageError({
116
+ documentId,
117
+ operation: "truncate",
118
+ cause: new Error(errorMessage)
119
+ }));
120
+ yield* effect.Ref.update(store, (map) => {
121
+ const existing = effect.HashMap.get(map, documentId);
122
+ if (existing._tag === "None") return map;
123
+ const filtered = existing.value.filter((e) => e.version > upToVersion);
124
+ return effect.HashMap.set(map, documentId, filtered);
125
+ });
126
+ })
127
+ };
128
+ }));
129
+ const FailingStorage = {
130
+ makeColdStorage,
131
+ makeHotStorage
132
+ };
133
+
134
+ //#endregion
135
+ exports.FailingStorage = FailingStorage;
@@ -0,0 +1,43 @@
1
+ import { ColdStorageTag } from "../ColdStorage.cjs";
2
+ import { HotStorageTag } from "../HotStorage.cjs";
3
+ import { Layer } from "effect";
4
+
5
+ //#region src/testing/FailingStorage.d.ts
6
+
7
+ /**
8
+ * Configuration for failing ColdStorage
9
+ */
10
+ interface FailingColdStorageConfig {
11
+ /** Fail load operations */
12
+ readonly failLoad?: boolean;
13
+ /** Fail save operations */
14
+ readonly failSave?: boolean;
15
+ /** Fail delete operations */
16
+ readonly failDelete?: boolean;
17
+ /** Fail after N successful operations (total across all operation types) */
18
+ readonly failAfterN?: number;
19
+ /** Custom error message */
20
+ readonly errorMessage?: string;
21
+ }
22
+ /**
23
+ * Configuration for failing HotStorage
24
+ */
25
+ interface FailingHotStorageConfig {
26
+ /** Fail append operations */
27
+ readonly failAppend?: boolean;
28
+ /** Fail getEntries operations */
29
+ readonly failGetEntries?: boolean;
30
+ /** Fail truncate operations */
31
+ readonly failTruncate?: boolean;
32
+ /** Fail after N successful operations (total across all operation types) */
33
+ readonly failAfterN?: number;
34
+ /** Custom error message */
35
+ readonly errorMessage?: string;
36
+ }
37
+ declare const FailingStorage: {
38
+ makeColdStorage: (config?: FailingColdStorageConfig) => Layer.Layer<ColdStorageTag>;
39
+ makeHotStorage: (config?: FailingHotStorageConfig) => Layer.Layer<HotStorageTag>;
40
+ };
41
+ //#endregion
42
+ export { FailingColdStorageConfig, FailingHotStorageConfig, FailingStorage };
43
+ //# sourceMappingURL=FailingStorage.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FailingStorage.d.cts","names":[],"sources":["../../src/testing/FailingStorage.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UA8BiB,wBAAA;;;;;;;;;;;;;;;UAgBA,uBAAA;;;;;;;;;;;;cA4OJ;6BAtNH,6BACP,KAAA,CAAM,MAAM;4BAqGL,4BACP,KAAA,CAAM,MAAM"}
@@ -0,0 +1,43 @@
1
+ import { ColdStorageTag } from "../ColdStorage.mjs";
2
+ import { HotStorageTag } from "../HotStorage.mjs";
3
+ import { Layer } from "effect";
4
+
5
+ //#region src/testing/FailingStorage.d.ts
6
+
7
+ /**
8
+ * Configuration for failing ColdStorage
9
+ */
10
+ interface FailingColdStorageConfig {
11
+ /** Fail load operations */
12
+ readonly failLoad?: boolean;
13
+ /** Fail save operations */
14
+ readonly failSave?: boolean;
15
+ /** Fail delete operations */
16
+ readonly failDelete?: boolean;
17
+ /** Fail after N successful operations (total across all operation types) */
18
+ readonly failAfterN?: number;
19
+ /** Custom error message */
20
+ readonly errorMessage?: string;
21
+ }
22
+ /**
23
+ * Configuration for failing HotStorage
24
+ */
25
+ interface FailingHotStorageConfig {
26
+ /** Fail append operations */
27
+ readonly failAppend?: boolean;
28
+ /** Fail getEntries operations */
29
+ readonly failGetEntries?: boolean;
30
+ /** Fail truncate operations */
31
+ readonly failTruncate?: boolean;
32
+ /** Fail after N successful operations (total across all operation types) */
33
+ readonly failAfterN?: number;
34
+ /** Custom error message */
35
+ readonly errorMessage?: string;
36
+ }
37
+ declare const FailingStorage: {
38
+ makeColdStorage: (config?: FailingColdStorageConfig) => Layer.Layer<ColdStorageTag>;
39
+ makeHotStorage: (config?: FailingHotStorageConfig) => Layer.Layer<HotStorageTag>;
40
+ };
41
+ //#endregion
42
+ export { FailingColdStorageConfig, FailingHotStorageConfig, FailingStorage };
43
+ //# sourceMappingURL=FailingStorage.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FailingStorage.d.mts","names":[],"sources":["../../src/testing/FailingStorage.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UA8BiB,wBAAA;;;;;;;;;;;;;;;UAgBA,uBAAA;;;;;;;;;;;;cA4OJ;6BAtNH,6BACP,KAAA,CAAM,MAAM;4BAqGL,4BACP,KAAA,CAAM,MAAM"}
@@ -0,0 +1,136 @@
1
+ import { ColdStorageTag } from "../ColdStorage.mjs";
2
+ import { ColdStorageError, HotStorageError } from "../Errors.mjs";
3
+ import { HotStorageTag } from "../HotStorage.mjs";
4
+ import { Effect, HashMap, Layer, Ref } from "effect";
5
+
6
+ //#region src/testing/FailingStorage.ts
7
+ /**
8
+ * @voidhash/mimic-effect/testing - FailingStorage
9
+ *
10
+ * Mock storage implementations that simulate failures for testing error handling.
11
+ * Use these to verify that your application correctly handles storage unavailability.
12
+ *
13
+ * @example
14
+ * ```typescript
15
+ * import { FailingStorage } from "@voidhash/mimic-effect/testing";
16
+ *
17
+ * // Create a ColdStorage that fails on load
18
+ * const failingCold = FailingStorage.makeColdStorage({ failLoad: true });
19
+ *
20
+ * // Create a HotStorage that fails after 3 successful appends
21
+ * const failingHot = FailingStorage.makeHotStorage({ failAfterN: 3, failAppend: true });
22
+ * ```
23
+ */
24
+ /**
25
+ * Create a ColdStorage layer that simulates failures.
26
+ * Wraps an in-memory storage and fails according to configuration.
27
+ */
28
+ const makeColdStorage = (config = {}) => Layer.effect(ColdStorageTag, Effect.gen(function* () {
29
+ var _config$errorMessage;
30
+ const store = yield* Ref.make(HashMap.empty());
31
+ const operationCount = yield* Ref.make(0);
32
+ const errorMessage = (_config$errorMessage = config.errorMessage) !== null && _config$errorMessage !== void 0 ? _config$errorMessage : "Simulated storage failure";
33
+ const shouldFail = (operation) => Effect.gen(function* () {
34
+ const opFails = operation === "load" && config.failLoad || operation === "save" && config.failSave || operation === "delete" && config.failDelete;
35
+ if (config.failAfterN !== void 0) {
36
+ const count = yield* Ref.get(operationCount);
37
+ yield* Ref.update(operationCount, (n) => n + 1);
38
+ if (count < config.failAfterN) return false;
39
+ return opFails;
40
+ }
41
+ return opFails;
42
+ });
43
+ return {
44
+ load: (documentId) => Effect.gen(function* () {
45
+ if (yield* shouldFail("load")) return yield* Effect.fail(new ColdStorageError({
46
+ documentId,
47
+ operation: "load",
48
+ cause: new Error(errorMessage)
49
+ }));
50
+ const current = yield* Ref.get(store);
51
+ const doc = HashMap.get(current, documentId);
52
+ return doc._tag === "Some" ? doc.value : void 0;
53
+ }),
54
+ save: (documentId, document) => Effect.gen(function* () {
55
+ if (yield* shouldFail("save")) return yield* Effect.fail(new ColdStorageError({
56
+ documentId,
57
+ operation: "save",
58
+ cause: new Error(errorMessage)
59
+ }));
60
+ yield* Ref.update(store, (map) => HashMap.set(map, documentId, document));
61
+ }),
62
+ delete: (documentId) => Effect.gen(function* () {
63
+ if (yield* shouldFail("delete")) return yield* Effect.fail(new ColdStorageError({
64
+ documentId,
65
+ operation: "delete",
66
+ cause: new Error(errorMessage)
67
+ }));
68
+ yield* Ref.update(store, (map) => HashMap.remove(map, documentId));
69
+ })
70
+ };
71
+ }));
72
+ /**
73
+ * Create a HotStorage layer that simulates failures.
74
+ * Wraps an in-memory storage and fails according to configuration.
75
+ */
76
+ const makeHotStorage = (config = {}) => Layer.effect(HotStorageTag, Effect.gen(function* () {
77
+ var _config$errorMessage2;
78
+ const store = yield* Ref.make(HashMap.empty());
79
+ const operationCount = yield* Ref.make(0);
80
+ const errorMessage = (_config$errorMessage2 = config.errorMessage) !== null && _config$errorMessage2 !== void 0 ? _config$errorMessage2 : "Simulated storage failure";
81
+ const shouldFail = (operation) => Effect.gen(function* () {
82
+ const opFails = operation === "append" && config.failAppend || operation === "getEntries" && config.failGetEntries || operation === "truncate" && config.failTruncate;
83
+ if (config.failAfterN !== void 0) {
84
+ const count = yield* Ref.get(operationCount);
85
+ yield* Ref.update(operationCount, (n) => n + 1);
86
+ if (count < config.failAfterN) return false;
87
+ return opFails;
88
+ }
89
+ return opFails;
90
+ });
91
+ return {
92
+ append: (documentId, entry) => Effect.gen(function* () {
93
+ if (yield* shouldFail("append")) return yield* Effect.fail(new HotStorageError({
94
+ documentId,
95
+ operation: "append",
96
+ cause: new Error(errorMessage)
97
+ }));
98
+ yield* Ref.update(store, (map) => {
99
+ const current = HashMap.get(map, documentId);
100
+ const entries = current._tag === "Some" ? current.value : [];
101
+ return HashMap.set(map, documentId, [...entries, entry]);
102
+ });
103
+ }),
104
+ getEntries: (documentId, sinceVersion) => Effect.gen(function* () {
105
+ if (yield* shouldFail("getEntries")) return yield* Effect.fail(new HotStorageError({
106
+ documentId,
107
+ operation: "getEntries",
108
+ cause: new Error(errorMessage)
109
+ }));
110
+ const current = yield* Ref.get(store);
111
+ const existing = HashMap.get(current, documentId);
112
+ return (existing._tag === "Some" ? existing.value : []).filter((e) => e.version > sinceVersion).sort((a, b) => a.version - b.version);
113
+ }),
114
+ truncate: (documentId, upToVersion) => Effect.gen(function* () {
115
+ if (yield* shouldFail("truncate")) return yield* Effect.fail(new HotStorageError({
116
+ documentId,
117
+ operation: "truncate",
118
+ cause: new Error(errorMessage)
119
+ }));
120
+ yield* Ref.update(store, (map) => {
121
+ const existing = HashMap.get(map, documentId);
122
+ if (existing._tag === "None") return map;
123
+ const filtered = existing.value.filter((e) => e.version > upToVersion);
124
+ return HashMap.set(map, documentId, filtered);
125
+ });
126
+ })
127
+ };
128
+ }));
129
+ const FailingStorage = {
130
+ makeColdStorage,
131
+ makeHotStorage
132
+ };
133
+
134
+ //#endregion
135
+ export { FailingStorage };
136
+ //# sourceMappingURL=FailingStorage.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FailingStorage.mjs","names":[],"sources":["../../src/testing/FailingStorage.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect/testing - FailingStorage\n *\n * Mock storage implementations that simulate failures for testing error handling.\n * Use these to verify that your application correctly handles storage unavailability.\n *\n * @example\n * ```typescript\n * import { FailingStorage } from \"@voidhash/mimic-effect/testing\";\n *\n * // Create a ColdStorage that fails on load\n * const failingCold = FailingStorage.makeColdStorage({ failLoad: true });\n *\n * // Create a HotStorage that fails after 3 successful appends\n * const failingHot = FailingStorage.makeHotStorage({ failAfterN: 3, failAppend: true });\n * ```\n */\nimport { Effect, Layer, Ref, HashMap } from \"effect\";\nimport { ColdStorageTag, type ColdStorage } from \"../ColdStorage\";\nimport { HotStorageTag, type HotStorage } from \"../HotStorage\";\nimport { ColdStorageError, HotStorageError } from \"../Errors\";\nimport type { StoredDocument, WalEntry } from \"../Types\";\n\n// =============================================================================\n// Configuration Types\n// =============================================================================\n\n/**\n * Configuration for failing ColdStorage\n */\nexport interface FailingColdStorageConfig {\n /** Fail load operations */\n readonly failLoad?: boolean;\n /** Fail save operations */\n readonly failSave?: boolean;\n /** Fail delete operations */\n readonly failDelete?: boolean;\n /** Fail after N successful operations (total across all operation types) */\n readonly failAfterN?: number;\n /** Custom error message */\n readonly errorMessage?: string;\n}\n\n/**\n * Configuration for failing HotStorage\n */\nexport interface FailingHotStorageConfig {\n /** Fail append operations */\n readonly failAppend?: boolean;\n /** Fail getEntries operations */\n readonly failGetEntries?: boolean;\n /** Fail truncate operations */\n readonly failTruncate?: boolean;\n /** Fail after N successful operations (total across all operation types) */\n readonly failAfterN?: number;\n /** Custom error message */\n readonly errorMessage?: string;\n}\n\n// =============================================================================\n// Failing ColdStorage\n// =============================================================================\n\n/**\n * Create a ColdStorage layer that simulates failures.\n * Wraps an in-memory storage and fails according to configuration.\n */\nexport const makeColdStorage = (\n config: FailingColdStorageConfig = {}\n): Layer.Layer<ColdStorageTag> =>\n Layer.effect(\n ColdStorageTag,\n Effect.gen(function* () {\n const store = yield* Ref.make(HashMap.empty<string, StoredDocument>());\n const operationCount = yield* Ref.make(0);\n\n const errorMessage = config.errorMessage ?? \"Simulated storage failure\";\n\n const shouldFail = (operation: \"load\" | \"save\" | \"delete\") =>\n Effect.gen(function* () {\n // Check if this specific operation should fail\n const opFails =\n (operation === \"load\" && config.failLoad) ||\n (operation === \"save\" && config.failSave) ||\n (operation === \"delete\" && config.failDelete);\n\n // If failAfterN is set, count operations first\n if (config.failAfterN !== undefined) {\n const count = yield* Ref.get(operationCount);\n yield* Ref.update(operationCount, (n) => n + 1);\n\n // Only start failing after N successful operations\n if (count < config.failAfterN) {\n return false;\n }\n // After N operations, fail if the specific op flag is set\n return opFails;\n }\n\n // No failAfterN - fail immediately if op flag is set\n return opFails;\n });\n\n const storage: ColdStorage = {\n load: (documentId) =>\n Effect.gen(function* () {\n const fail = yield* shouldFail(\"load\");\n if (fail) {\n return yield* Effect.fail(\n new ColdStorageError({\n documentId,\n operation: \"load\",\n cause: new Error(errorMessage),\n })\n );\n }\n\n const current = yield* Ref.get(store);\n const doc = HashMap.get(current, documentId);\n return doc._tag === \"Some\" ? doc.value : undefined;\n }),\n\n save: (documentId, document) =>\n Effect.gen(function* () {\n const fail = yield* shouldFail(\"save\");\n if (fail) {\n return yield* Effect.fail(\n new ColdStorageError({\n documentId,\n operation: \"save\",\n cause: new Error(errorMessage),\n })\n );\n }\n\n yield* Ref.update(store, (map) =>\n HashMap.set(map, documentId, document)\n );\n }),\n\n delete: (documentId) =>\n Effect.gen(function* () {\n const fail = yield* shouldFail(\"delete\");\n if (fail) {\n return yield* Effect.fail(\n new ColdStorageError({\n documentId,\n operation: \"delete\",\n cause: new Error(errorMessage),\n })\n );\n }\n\n yield* Ref.update(store, (map) => HashMap.remove(map, documentId));\n }),\n };\n\n return storage;\n })\n );\n\n// =============================================================================\n// Failing HotStorage\n// =============================================================================\n\n/**\n * Create a HotStorage layer that simulates failures.\n * Wraps an in-memory storage and fails according to configuration.\n */\nexport const makeHotStorage = (\n config: FailingHotStorageConfig = {}\n): Layer.Layer<HotStorageTag> =>\n Layer.effect(\n HotStorageTag,\n Effect.gen(function* () {\n const store = yield* Ref.make(HashMap.empty<string, WalEntry[]>());\n const operationCount = yield* Ref.make(0);\n\n const errorMessage = config.errorMessage ?? \"Simulated storage failure\";\n\n const shouldFail = (operation: \"append\" | \"getEntries\" | \"truncate\") =>\n Effect.gen(function* () {\n // Check if this specific operation should fail\n const opFails =\n (operation === \"append\" && config.failAppend) ||\n (operation === \"getEntries\" && config.failGetEntries) ||\n (operation === \"truncate\" && config.failTruncate);\n\n // If failAfterN is set, count operations first\n if (config.failAfterN !== undefined) {\n const count = yield* Ref.get(operationCount);\n yield* Ref.update(operationCount, (n) => n + 1);\n\n // Only start failing after N successful operations\n if (count < config.failAfterN) {\n return false;\n }\n // After N operations, fail if the specific op flag is set\n return opFails;\n }\n\n // No failAfterN - fail immediately if op flag is set\n return opFails;\n });\n\n const storage: HotStorage = {\n append: (documentId, entry) =>\n Effect.gen(function* () {\n const fail = yield* shouldFail(\"append\");\n if (fail) {\n return yield* Effect.fail(\n new HotStorageError({\n documentId,\n operation: \"append\",\n cause: new Error(errorMessage),\n })\n );\n }\n\n yield* Ref.update(store, (map) => {\n const current = HashMap.get(map, documentId);\n const entries = current._tag === \"Some\" ? current.value : [];\n return HashMap.set(map, documentId, [...entries, entry]);\n });\n }),\n\n getEntries: (documentId, sinceVersion) =>\n Effect.gen(function* () {\n const fail = yield* shouldFail(\"getEntries\");\n if (fail) {\n return yield* Effect.fail(\n new HotStorageError({\n documentId,\n operation: \"getEntries\",\n cause: new Error(errorMessage),\n })\n );\n }\n\n const current = yield* Ref.get(store);\n const existing = HashMap.get(current, documentId);\n const entries = existing._tag === \"Some\" ? existing.value : [];\n\n return entries\n .filter((e) => e.version > sinceVersion)\n .sort((a, b) => a.version - b.version);\n }),\n\n truncate: (documentId, upToVersion) =>\n Effect.gen(function* () {\n const fail = yield* shouldFail(\"truncate\");\n if (fail) {\n return yield* Effect.fail(\n new HotStorageError({\n documentId,\n operation: \"truncate\",\n cause: new Error(errorMessage),\n })\n );\n }\n\n yield* Ref.update(store, (map) => {\n const existing = HashMap.get(map, documentId);\n if (existing._tag === \"None\") {\n return map;\n }\n const filtered = existing.value.filter(\n (e) => e.version > upToVersion\n );\n return HashMap.set(map, documentId, filtered);\n });\n }),\n };\n\n return storage;\n })\n );\n\n// =============================================================================\n// Export Namespace\n// =============================================================================\n\nexport const FailingStorage = {\n makeColdStorage,\n makeHotStorage,\n};\n"],"mappings":"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"}