@ibgib/core-gib 0.1.54 → 0.1.57

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 (190) hide show
  1. package/CHANGELOG.md +11 -3
  2. package/README.md +12 -15
  3. package/dist/keystone/aggregate-details.respec.d.mts +2 -0
  4. package/dist/keystone/aggregate-details.respec.d.mts.map +1 -0
  5. package/dist/keystone/aggregate-details.respec.mjs +118 -0
  6. package/dist/keystone/aggregate-details.respec.mjs.map +1 -0
  7. package/dist/keystone/keystone-constants.d.mts +5 -0
  8. package/dist/keystone/keystone-constants.d.mts.map +1 -1
  9. package/dist/keystone/keystone-constants.mjs +6 -1
  10. package/dist/keystone/keystone-constants.mjs.map +1 -1
  11. package/dist/keystone/keystone-helpers.d.mts +7 -1
  12. package/dist/keystone/keystone-helpers.d.mts.map +1 -1
  13. package/dist/keystone/keystone-helpers.mjs +5 -2
  14. package/dist/keystone/keystone-helpers.mjs.map +1 -1
  15. package/dist/keystone/keystone-service-v1.d.mts +51 -0
  16. package/dist/keystone/keystone-service-v1.d.mts.map +1 -1
  17. package/dist/keystone/keystone-service-v1.mjs +176 -9
  18. package/dist/keystone/keystone-service-v1.mjs.map +1 -1
  19. package/dist/keystone/keystone-service-v1.respec.mjs +40 -98
  20. package/dist/keystone/keystone-service-v1.respec.mjs.map +1 -1
  21. package/dist/keystone/keystone-types.d.mts +5 -0
  22. package/dist/keystone/keystone-types.d.mts.map +1 -1
  23. package/dist/sync/graft-info/graft-info-helpers.respec.mjs +8 -8
  24. package/dist/sync/graft-info/graft-info-helpers.respec.mjs.map +1 -1
  25. package/dist/sync/sync-conflict-adv-multitimelines.respec.mjs +26 -30
  26. package/dist/sync/sync-conflict-adv-multitimelines.respec.mjs.map +1 -1
  27. package/dist/sync/sync-conflict-basic-divergence.respec.mjs +7 -8
  28. package/dist/sync/sync-conflict-basic-divergence.respec.mjs.map +1 -1
  29. package/dist/sync/sync-conflict-basic-multitimelines.respec.mjs +10 -11
  30. package/dist/sync/sync-conflict-basic-multitimelines.respec.mjs.map +1 -1
  31. package/dist/sync/sync-conflict-text-merge.respec.mjs +30 -33
  32. package/dist/sync/sync-conflict-text-merge.respec.mjs.map +1 -1
  33. package/dist/sync/sync-constants.d.mts +1 -56
  34. package/dist/sync/sync-constants.d.mts.map +1 -1
  35. package/dist/sync/sync-constants.mjs +2 -59
  36. package/dist/sync/sync-constants.mjs.map +1 -1
  37. package/dist/sync/sync-helpers.d.mts +0 -1
  38. package/dist/sync/sync-helpers.d.mts.map +1 -1
  39. package/dist/sync/sync-helpers.mjs +1 -6
  40. package/dist/sync/sync-helpers.mjs.map +1 -1
  41. package/dist/sync/sync-innerspace-constants.respec.mjs +5 -9
  42. package/dist/sync/sync-innerspace-constants.respec.mjs.map +1 -1
  43. package/dist/sync/sync-innerspace-deep-updates.respec.mjs +6 -7
  44. package/dist/sync/sync-innerspace-deep-updates.respec.mjs.map +1 -1
  45. package/dist/sync/sync-innerspace-dest-ahead-withid.respec.mjs +22 -22
  46. package/dist/sync/sync-innerspace-dest-ahead-withid.respec.mjs.map +1 -1
  47. package/dist/sync/sync-innerspace-dest-ahead.respec.mjs +8 -9
  48. package/dist/sync/sync-innerspace-dest-ahead.respec.mjs.map +1 -1
  49. package/dist/sync/sync-innerspace-multiple-timelines.respec.mjs +6 -7
  50. package/dist/sync/sync-innerspace-multiple-timelines.respec.mjs.map +1 -1
  51. package/dist/sync/sync-innerspace-partial-update.respec.mjs +7 -8
  52. package/dist/sync/sync-innerspace-partial-update.respec.mjs.map +1 -1
  53. package/dist/sync/sync-innerspace.respec.mjs +8 -11
  54. package/dist/sync/sync-innerspace.respec.mjs.map +1 -1
  55. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-http-node-adapter.mjs +10 -5
  56. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-http-node-adapter.mjs.map +1 -1
  57. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-types.d.mts +3 -1
  58. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-types.d.mts.map +1 -1
  59. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.d.mts +4 -2
  60. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.d.mts.map +1 -1
  61. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.mjs +37 -6
  62. package/dist/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.mjs.map +1 -1
  63. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-types.d.mts +3 -1
  64. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-types.d.mts.map +1 -1
  65. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.d.mts +4 -2
  66. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.d.mts.map +1 -1
  67. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.mjs +37 -0
  68. package/dist/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.mjs.map +1 -1
  69. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-types.d.mts +7 -1
  70. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-types.d.mts.map +1 -1
  71. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.d.mts +10 -2
  72. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.d.mts.map +1 -1
  73. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs +50 -38
  74. package/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs.map +1 -1
  75. package/dist/sync/sync-peer/sync-peer-types.d.mts +21 -5
  76. package/dist/sync/sync-peer/sync-peer-types.d.mts.map +1 -1
  77. package/dist/sync/sync-peer/sync-peer-v1.d.mts +30 -5
  78. package/dist/sync/sync-peer/sync-peer-v1.d.mts.map +1 -1
  79. package/dist/sync/sync-peer/sync-peer-v1.mjs +41 -25
  80. package/dist/sync/sync-peer/sync-peer-v1.mjs.map +1 -1
  81. package/dist/sync/sync-saga-context/sync-saga-context-helpers.d.mts +2 -11
  82. package/dist/sync/sync-saga-context/sync-saga-context-helpers.d.mts.map +1 -1
  83. package/dist/sync/sync-saga-context/sync-saga-context-helpers.mjs +7 -51
  84. package/dist/sync/sync-saga-context/sync-saga-context-helpers.mjs.map +1 -1
  85. package/dist/sync/sync-saga-context/sync-saga-context-types.d.mts +1 -47
  86. package/dist/sync/sync-saga-context/sync-saga-context-types.d.mts.map +1 -1
  87. package/dist/sync/sync-saga-coordinator.d.mts +6 -58
  88. package/dist/sync/sync-saga-coordinator.d.mts.map +1 -1
  89. package/dist/sync/sync-saga-coordinator.mjs +23 -425
  90. package/dist/sync/sync-saga-coordinator.mjs.map +1 -1
  91. package/dist/sync/sync-saga-message/sync-saga-message-types.d.mts +2 -2
  92. package/dist/sync/sync-saga-message/sync-saga-message-types.d.mts.map +1 -1
  93. package/dist/sync/sync-types.d.mts +2 -19
  94. package/dist/sync/sync-types.d.mts.map +1 -1
  95. package/dist/sync/sync-types.mjs.map +1 -1
  96. package/dist/test/mock-space.mjs +1 -1
  97. package/dist/test/mock-space.mjs.map +1 -1
  98. package/dist/test-helpers.d.mts +0 -6
  99. package/dist/test-helpers.d.mts.map +1 -1
  100. package/dist/test-helpers.mjs +2 -25
  101. package/dist/test-helpers.mjs.map +1 -1
  102. package/package.json +10 -34
  103. package/src/keystone/aggregate-details.respec.mts +137 -0
  104. package/src/keystone/docs/architecture.md +16 -0
  105. package/src/keystone/keystone-constants.mts +6 -1
  106. package/src/keystone/keystone-helpers.mts +9 -1
  107. package/src/keystone/keystone-service-v1.mts +216 -8
  108. package/src/keystone/keystone-service-v1.respec.mts +39 -103
  109. package/src/keystone/keystone-types.mts +6 -0
  110. package/src/sync/README.md +2 -87
  111. package/src/sync/docs/architecture.md +26 -5
  112. package/src/sync/docs/security.md +176 -0
  113. package/src/sync/graft-info/graft-info-helpers.respec.mts +7 -7
  114. package/src/sync/sync-conflict-adv-multitimelines.respec.mts +25 -29
  115. package/src/sync/sync-conflict-basic-divergence.respec.mts +6 -7
  116. package/src/sync/sync-conflict-basic-multitimelines.respec.mts +9 -10
  117. package/src/sync/sync-conflict-text-merge.respec.mts +29 -32
  118. package/src/sync/sync-constants.mts +2 -62
  119. package/src/sync/sync-helpers.mts +1 -8
  120. package/src/sync/sync-id-testlog.txt +421 -0
  121. package/src/sync/sync-innerspace-constants.respec.mts +4 -8
  122. package/src/sync/sync-innerspace-deep-updates.respec.mts +5 -6
  123. package/src/sync/sync-innerspace-dest-ahead-withid.respec.mts +23 -25
  124. package/src/sync/sync-innerspace-dest-ahead.respec.mts +7 -8
  125. package/src/sync/sync-innerspace-multiple-timelines.respec.mts +5 -6
  126. package/src/sync/sync-innerspace-partial-update.respec.mts +6 -7
  127. package/src/sync/sync-innerspace.respec.mts +7 -10
  128. package/src/sync/sync-peer/sync-peer-http-receiver/sync-http-node-adapter.mts +5 -5
  129. package/src/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-types.mts +5 -1
  130. package/src/sync/sync-peer/sync-peer-http-receiver/sync-peer-http-receiver-v1.mts +30 -9
  131. package/src/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-types.mts +3 -1
  132. package/src/sync/sync-peer/sync-peer-http-sender/sync-peer-http-sender-v1.mts +29 -2
  133. package/src/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-types.mts +7 -1
  134. package/src/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mts +51 -38
  135. package/src/sync/sync-peer/sync-peer-types.mts +23 -6
  136. package/src/sync/sync-peer/sync-peer-v1.mts +68 -28
  137. package/src/sync/sync-saga-context/sync-saga-context-helpers.mts +6 -66
  138. package/src/sync/sync-saga-context/sync-saga-context-types.mts +1 -48
  139. package/src/sync/sync-saga-coordinator.mts +12 -552
  140. package/src/sync/sync-saga-message/sync-saga-message-types.mts +2 -3
  141. package/src/sync/sync-types.mts +2 -22
  142. package/src/sync/unused-identity-backup.mts.md +311 -0
  143. package/src/test/mock-space.mts +1 -1
  144. package/src/test-helpers.mts +1 -26
  145. package/test_output.log +0 -0
  146. package/test_output_utf8.txt +398 -0
  147. package/.vscode/core-gib-snippets.code-snippets +0 -293
  148. package/.vscode/launch.json +0 -40
  149. package/.vscode/settings.json +0 -58
  150. package/.vscode/tasks.json +0 -37
  151. package/dist/sync/sync-peer/sync-peer-http.respec.d.mts +0 -2
  152. package/dist/sync/sync-peer/sync-peer-http.respec.d.mts.map +0 -1
  153. package/dist/sync/sync-peer/sync-peer-http.respec.mjs +0 -340
  154. package/dist/sync/sync-peer/sync-peer-http.respec.mjs.map +0 -1
  155. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.d.mts +0 -42
  156. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.d.mts.map +0 -1
  157. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.mjs +0 -312
  158. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.mjs.map +0 -1
  159. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.d.mts +0 -84
  160. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.d.mts.map +0 -1
  161. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mjs +0 -65
  162. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mjs.map +0 -1
  163. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.d.mts +0 -73
  164. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.d.mts.map +0 -1
  165. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.mjs +0 -667
  166. package/dist/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.mjs.map +0 -1
  167. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.d.mts +0 -2
  168. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.d.mts.map +0 -1
  169. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.mjs +0 -67
  170. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.mjs.map +0 -1
  171. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.d.mts +0 -2
  172. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.d.mts.map +0 -1
  173. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.mjs +0 -67
  174. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.mjs.map +0 -1
  175. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.d.mts +0 -2
  176. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.d.mts.map +0 -1
  177. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.mjs +0 -68
  178. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.mjs.map +0 -1
  179. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.d.mts +0 -2
  180. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.d.mts.map +0 -1
  181. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.mjs +0 -69
  182. package/dist/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.mjs.map +0 -1
  183. package/src/sync/sync-peer/sync-peer-http.respec.mts +0 -396
  184. package/src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.mts +0 -298
  185. package/src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mts +0 -150
  186. package/src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.mts +0 -666
  187. package/src/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_createAndInit.node-filesystem-space-v1.respec.mts +0 -87
  188. package/src/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_persistTransformResult.node-filesystem-space-v1.respec.mts +0 -88
  189. package/src/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_putGetDelete.node-filesystem-space-v1.respec.mts +0 -88
  190. package/src/witness/space/filesystem-space/node-filesystem-space/respec/testSpace_registerNewIbGib_GetLatest.node-filesystem-space-v1.respec.mts +0 -90
@@ -1,312 +0,0 @@
1
- /**
2
- * @module node-filesystem-space-helper
3
- *
4
- */
5
- import { readFile, } from 'node:fs/promises';
6
- import { default as pathUtils } from 'path';
7
- import { cwd } from 'node:process';
8
- import { extractErrorMsg, unique, } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
9
- import { getIbAndGib, } from '@ibgib/ts-gib/dist/helper.mjs';
10
- import { GIB, } from '@ibgib/ts-gib/dist/V1/index.mjs';
11
- import { validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
12
- import { GLOBAL_LOG_A_LOT } from '../../../../core-constants.mjs';
13
- import { parseSpaceIb, } from '../../space-helper.mjs';
14
- import { NodeFilesystemSpace_V1 } from './node-filesystem-space-v1.mjs';
15
- import { B2TFS_DEFAULT_ENCODINGS_TO_TRY, FILE_ENCODINGS } from './node-filesystem-space-types.mjs';
16
- const logalot = GLOBAL_LOG_A_LOT;
17
- /**
18
- * tries to read the given path. if fails **FOR ANY REASON**, @returns `null`.
19
- *
20
- * does not throw
21
- *
22
- * @returns file contents as string or `null`
23
- */
24
- export async function tryRead({ path, directory, encoding, }) {
25
- const lc = `[${tryRead.name}]`;
26
- try {
27
- if (logalot) {
28
- console.log(`${lc} starting...`);
29
- console.log(`${lc} cwd: ${cwd()}`);
30
- if (path.includes('bootstrap^gib')) {
31
- console.log(`${lc} trying bootstrap^gib... (I: dacfdbe5a2d640ab947a7c17e3c56f78)`);
32
- }
33
- }
34
- const fullPath = pathUtils.join(directory, path);
35
- if (logalot) {
36
- console.log(`${lc} fullPath: ${fullPath} (I: 459b416ac32c711bfbab54177839b323)`);
37
- }
38
- encoding ||= 'utf8';
39
- let resRead = undefined;
40
- resRead = await readFile(fullPath, { encoding: encoding });
41
- if (logalot) {
42
- console.log(`${lc} record found. data length: ${resRead?.length ?? 0}. fullPath: ${fullPath}. console.dir(resRead)... (I: 82e3ad9821bd4bf8a54c8facc61dbad0)`);
43
- console.dir(resRead);
44
- }
45
- return resRead;
46
- }
47
- catch (error) {
48
- if (logalot) {
49
- console.log(`${lc} fullPath not found from directory (${directory}) and path (${path})\nerror:\n${extractErrorMsg(error)} (I: 1fde689d29aa47fcb589b3e7dac8929b)`);
50
- }
51
- return null;
52
- }
53
- finally {
54
- if (logalot) {
55
- console.log(`${lc} complete. (I: e2615c944a464cd48a5635fe401562d9)`);
56
- }
57
- }
58
- }
59
- export async function tryRead_bin({ path, directory, encoding, }) {
60
- const lc = `[${tryRead_bin.name}]`;
61
- try {
62
- if (logalot) {
63
- console.log(`${lc} starting...`);
64
- console.log(`${lc} cwd: ${cwd()}`);
65
- if (path.includes('bootstrap^gib')) {
66
- console.log(`${lc} trying bootstrap^gib... (I: 5eb010444b814addb1a6bbe18ca3dbfa)`);
67
- }
68
- }
69
- const fullPath = pathUtils.join(directory, path);
70
- if (logalot) {
71
- console.log(`${lc} fullPath: ${fullPath} (I: c342bf56df354e9ab2653855a458b99d)`);
72
- }
73
- encoding ||= 'utf8';
74
- let resRead = undefined;
75
- let encodingsToTry = unique([
76
- encoding,
77
- ...FILE_ENCODINGS,
78
- ]);
79
- let { dataBuffer, dataString, inputPath, detectedEncoding } = await getFileDataAndEncoding({
80
- inputPath: path,
81
- encodingsToTry,
82
- });
83
- if (!dataBuffer) {
84
- throw new Error(`getFileDataAndEncoding yielded falsy dataBuffer (E: f7aac299212a1ae41d5bbef6079c4d24)`);
85
- }
86
- resRead = dataBuffer;
87
- if (logalot) {
88
- console.log(`${lc} record found. data length: ${resRead?.length ?? 0}. fullPath: ${fullPath}. console.dir(resRead)... (I: 438189ba2fd345d782f928ecc7dc6e58)`);
89
- console.dir(resRead);
90
- }
91
- return {
92
- dataBuffer, dataString, inputPath, detectedEncoding
93
- };
94
- }
95
- catch (error) {
96
- if (logalot) {
97
- console.log(`${lc} fullPath not found from directory (${directory}) and path (${path})\nerror:\n${extractErrorMsg(error)} (I: 882e54f079024c94864bdaa74979b397)`);
98
- }
99
- return null;
100
- }
101
- finally {
102
- if (logalot) {
103
- console.log(`${lc} complete. (I: 500e391835aa4d959adf4720fdc38c4b)`);
104
- }
105
- }
106
- }
107
- /**
108
- * basic validation for a node fs space ibgib
109
- */
110
- export async function validateNodeFilesystemSpace_V1Intrinsically({ space }) {
111
- const lc = `[${validateNodeFilesystemSpace_V1Intrinsically.name}]`;
112
- try {
113
- if (logalot) {
114
- console.log(`${lc} starting... (I: fcfe57145426ab4a5a0e961e87001922)`);
115
- }
116
- const errors = (await validateIbGibIntrinsically({ ibGib: space })) ?? [];
117
- const { ib, gib, data, rel8ns } = space;
118
- if (!ib) {
119
- errors.push('ib required. (E: e69ddadd947d4534ae60af9eda1bda47)');
120
- }
121
- if (!gib) {
122
- errors.push('gib required. (E: 9794fb92dd79473b9139c001f0634ec2)');
123
- }
124
- if (gib === GIB) {
125
- errors.push('gib cannot be primitive. (E: 651c12f1303d45aba54aa228eca1e575)');
126
- }
127
- if (!data) {
128
- errors.push('data required. (E: 264d13ce6b47400e8943bf046c57e8bc)');
129
- return errors;
130
- }
131
- if (!data.name) {
132
- errors.push('space name required. (E: 4845041c9f2e44098e1e7bb30fe3c13d)');
133
- }
134
- // if (!data.classname) { errors.push('classname required. (E: cb645bebf8fc4baabfbf74be39563008)') }
135
- if (data.classname && data.classname !== NodeFilesystemSpace_V1.name) {
136
- errors.push(`unknown classname (${data.classname}). data.classname !== FilesystemSpace_V1.name (E: e159eb46ca5e4c2b850998af88cb5840)`);
137
- }
138
- if (!data.baseDir) {
139
- errors.push(`data.baseDir required (E: 373544741a974ab9bc0001d3d63c2601).`);
140
- }
141
- if (!data.baseSubPath) {
142
- errors.push(`data.baseSubPath required. (E: 7336f8eb7c7846d48993e0db893fb7cb)`);
143
- }
144
- if (!data.binSubPath) {
145
- errors.push(`data.binSubPath required. (E: 3544a80a3cec4fdfb35d3e6ccb36dbd6)`);
146
- }
147
- if (!data.dnaSubPath) {
148
- errors.push(`data.dnaSubPath required. (E: 4d6e529cdd0f47a492545c31e1dda865)`);
149
- }
150
- if (!data.ibgibsSubPath) {
151
- errors.push(`data.ibgibsSubPath required. (E: 11b90fdc1b1c41b492c26a61da3409b8)`);
152
- }
153
- if (!data.metaSubPath) {
154
- errors.push(`data.metaSubPath required. (E: 259113f4f0bc488785f9019160c8a226)`);
155
- }
156
- if (data.n && typeof data.n !== 'number') {
157
- errors.push(`data.n must be a number. (E: e7c76f44b1114dba949d06146a8c169b)`);
158
- }
159
- if (data.n === undefined) {
160
- // the very first space record (tjp) has an undefined n and no rel8ns
161
- if (rel8ns) {
162
- errors.push(`rel8ns not expected when data.n is falsy (custom temporal junction point indicator I suppose...) (E: 08604c8b33524009886ac2c63eb34c50)`);
163
- }
164
- }
165
- if (!data.spaceSubPath) {
166
- errors.push(`data.spaceSubPath required. (E: 1688a59dfc6447b3bccb7690b233e4fa)`);
167
- }
168
- if (!data.uuid) {
169
- errors.push(`data.uuid required. (E: dd984a04d0d14d16a4faa300ec125960)`);
170
- }
171
- if (!data.encoding) {
172
- errors.push(`data.encoding required. (E: e75958932f614364a1765a875acad2ce)`);
173
- }
174
- /** should probably get this from Capacitor... */
175
- const validEncodings = ["utf8", "ascii", "utf16"];
176
- if (!validEncodings.includes(data.encoding)) {
177
- errors.push(`invalid encoding: ${data.encoding}. validEncodings: ${validEncodings.join(', ')} (E: b88b909521db42cbae684c2937c77079)`);
178
- }
179
- // ensure ib matches up with internal data
180
- const { spaceClassname, spaceId, spaceName } = parseSpaceIb({ spaceIb: ib });
181
- if (data.classname && (spaceClassname !== data.classname)) {
182
- errors.push(`ib's spaceClassname (${spaceClassname}) must match data.classname (${data.classname}) (E: 913b8b98717647fea832e4cca80d8ee6)`);
183
- }
184
- if (spaceId !== data.uuid) {
185
- errors.push(`ib's spaceId (${spaceId}) must match data.uuid (${data.uuid}) (E: b20f36f32bc244008b4df856f892a62a)`);
186
- }
187
- if (spaceName !== data.name) {
188
- errors.push(`ib's spaceName (${spaceName}) must match data.name (${data.name}) (E: cf599a9bf875464d9ec99c79cdee0452)`);
189
- }
190
- // ensure rel8ns make sense
191
- if (data.n === undefined && (rel8ns?.past ?? []).length > 0) {
192
- errors.push(`"past" rel8n not expected when data.n is falsy (E: 77bb7a90b40a4d989a9e53053776be86)`);
193
- }
194
- if (data.n && (rel8ns?.past ?? []).length === 0) {
195
- errors.push(`"past" rel8n required when data.n is truthy (E: 735e07bac58b44deb2523e3d349d5479)`);
196
- }
197
- if (data.n === 0 && (rel8ns?.past ?? []).length !== 1) {
198
- errors.push(`"past" rel8n expected to have a single record when data.n === 0 (E: 8915bb8084414d3b810cff9bccfc3ec6)`);
199
- }
200
- if (rel8ns && (rel8ns.past?.length ?? -1) > 0) {
201
- const pastAddrs = rel8ns.past;
202
- pastAddrs.forEach(x => {
203
- const { ib: pastIb } = getIbAndGib({ ibGibAddr: x });
204
- const pastIbInfo = parseSpaceIb({ spaceIb: pastIb });
205
- if (pastIbInfo.spaceClassname && (pastIbInfo.spaceClassname !== spaceClassname)) {
206
- errors.push(`rel8ns.past address classname (${pastIbInfo.spaceClassname}) must match current spaceClassname (${spaceClassname}) (E: 10b2f05597574558ad2f20db8e471a44)`);
207
- }
208
- if (pastIbInfo.spaceId !== spaceId) {
209
- errors.push(`rel8ns.past address spaceId (${pastIbInfo.spaceId}) must match current spaceId (${spaceId}) (E: 78b665a31fc34c68be3884d4cd4da35a)`);
210
- }
211
- // i want to allow this, but for now we're going to require not changing the name...
212
- if (pastIbInfo.spaceName !== spaceName) {
213
- errors.push(`rel8ns.past address spaceName (${pastIbInfo.spaceName}) must match current spaceName (${spaceName}) (E: 8a6621cbec9e48e7b6d880375c444bfe)`);
214
- }
215
- });
216
- }
217
- return errors;
218
- }
219
- catch (error) {
220
- console.error(`${lc} ${error.message}`);
221
- throw error;
222
- }
223
- finally {
224
- if (logalot) {
225
- console.log(`${lc} complete.`);
226
- }
227
- }
228
- }
229
- /**
230
- * gets the data and encoding of a given {@link inputPath} if that file exists.
231
- * if it doesn't exist, this will throw an ENOENT error, but this is not logged
232
- * as an error.
233
- *
234
- * this is because atow (03/2024) this is only used in a tryRead_bin function
235
- * where the file often does not exist.
236
- */
237
- export async function getFileDataAndEncoding({ inputPath, encodingsToTry = B2TFS_DEFAULT_ENCODINGS_TO_TRY, }) {
238
- const lc = `[${getFileDataAndEncoding.name}]`;
239
- try {
240
- if (logalot) {
241
- console.log(`${lc} starting... (I: b4688e6e5f28efa9ed95729f10a6df24)`);
242
- }
243
- let resDataAndEncoding = undefined;
244
- const dataBuffer = await readFile(inputPath);
245
- if (dataBuffer.length === 0) {
246
- console.warn(`${lc} file at inputPath (${inputPath}) has dataBuffer.length === 0, i.e., no data content. we are treating this as utf8. (W: 2ea55367538146d695482cfb6ec1b79a)`);
247
- return {
248
- inputPath,
249
- dataBuffer,
250
- detectedEncoding: 'utf8',
251
- dataString: '',
252
- }; /* <<<< returns early */
253
- }
254
- encodingsToTry ??= B2TFS_DEFAULT_ENCODINGS_TO_TRY;
255
- const tryEncoding = async (encoding) => {
256
- let res;
257
- try {
258
- const str = dataBuffer.toString(encoding ?? undefined);
259
- /**
260
- * doesn't include the node.js replacement unicode char
261
- */
262
- const isProbablyCorrect = !str.includes('\ufffd');
263
- res = [isProbablyCorrect, str];
264
- return res;
265
- }
266
- catch (error) {
267
- debugger;
268
- res = [false, undefined];
269
- }
270
- return res;
271
- };
272
- for (let i = 0; i < encodingsToTry.length; i++) {
273
- const maybeEncoding = encodingsToTry[i];
274
- const [isProbablyCorrectEncoding, dataString] = await tryEncoding(maybeEncoding);
275
- if (isProbablyCorrectEncoding) {
276
- resDataAndEncoding = {
277
- inputPath,
278
- dataString,
279
- detectedEncoding: maybeEncoding,
280
- dataBuffer,
281
- };
282
- break;
283
- }
284
- }
285
- if (!resDataAndEncoding) {
286
- debugger; // !resDataAndEncoding -> want to see why resDataAndEncoding is still undefined
287
- throw new Error(`couldn't turn dataBuffer (length: ${dataBuffer.length}) into dataString with encodingsToTry: (${encodingsToTry}). no idea why. (E: 557c7722f2df7703429778662d3ea224)`);
288
- // resDataAndEncoding = {
289
- // inputPath,
290
- // detectedEncoding: undefined,
291
- // dataString: undefined,
292
- // dataBuffer,
293
- // }
294
- }
295
- return resDataAndEncoding;
296
- }
297
- catch (error) {
298
- // i'm just suppressing ENOENT at this time because in context, this is
299
- // often the case. we do, however, rethrow the error for proper flow.
300
- const emsg = extractErrorMsg(error);
301
- if (!emsg.startsWith('ENOENT:')) {
302
- console.error(`${lc} ${emsg}`);
303
- }
304
- throw error;
305
- }
306
- finally {
307
- if (logalot) {
308
- console.log(`${lc} complete.`);
309
- }
310
- }
311
- }
312
- //# sourceMappingURL=node-filesystem-space-helper.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"node-filesystem-space-helper.mjs","sourceRoot":"","sources":["../../../../../src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-helper.mts"],"names":[],"mappings":"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"}
@@ -1,84 +0,0 @@
1
- /**
2
- * @module node-filesystem-space-types
3
- *
4
- * mostly interfaces, some constants
5
- */
6
- import { IbGibRel8ns_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
7
- import { FilesystemSpaceData_V1, FilesystemSpaceOptionsData, FilesystemSpaceOptionsRel8ns, FilesystemSpaceOptionsIbGib, FilesystemSpaceResultData, FilesystemSpaceResultRel8ns, FilesystemSpaceResultIbGib } from '../filesystem-space-v1.mjs';
8
- /**
9
- * This is the shape of data about this space itself (not the contained ibgibs' spaces).
10
- */
11
- export interface NodeFilesystemSpaceData_V1 extends FilesystemSpaceData_V1 {
12
- }
13
- /**
14
- * Used in bootstrapping.
15
- *
16
- * If you change this, please bump the version
17
- *
18
- * (but of course won't be the end of the world when this doesn't happen).
19
- */
20
- export declare const DEFAULT_NODE_FILESYSTEM_SPACE_DATA_V1: NodeFilesystemSpaceData_V1;
21
- /** Marker interface atm */
22
- export interface NodeFilesystemSpaceRel8ns_V1 extends IbGibRel8ns_V1 {
23
- }
24
- /**
25
- * Space options involve whether we're getting/putting ibgibs categorized as
26
- * meta, bin, dna.
27
- *
28
- * We'll leverage the fact that we don't need to get dna very often, and that
29
- * meta ibgibs act differently and are recorded differently.
30
- *
31
- * For example, we don't necessarily want to keep the past of certain meta
32
- * objects, because it may change (and thus grow) too quickly.
33
- */
34
- export interface NodeFilesystemSpaceOptionsData extends FilesystemSpaceOptionsData {
35
- }
36
- export interface NodeFilesystemSpaceOptionsRel8ns extends FilesystemSpaceOptionsRel8ns {
37
- }
38
- /** Marker interface atm */
39
- export interface NodeFilesystemSpaceOptionsIbGib extends FilesystemSpaceOptionsIbGib<NodeFilesystemSpaceOptionsData, NodeFilesystemSpaceOptionsRel8ns> {
40
- }
41
- /** Marker interface atm */
42
- export interface NodeFilesystemSpaceResultData extends FilesystemSpaceResultData {
43
- }
44
- export interface NodeFilesystemSpaceResultRel8ns extends FilesystemSpaceResultRel8ns {
45
- }
46
- export interface NodeFilesystemSpaceResultIbGib extends FilesystemSpaceResultIbGib<NodeFilesystemSpaceResultData, NodeFilesystemSpaceResultRel8ns> {
47
- }
48
- /**
49
- * currently i'm just taking this from the definition of node's `Buffer` type.
50
- *
51
- * ## notes
52
- *
53
- * * using this with handle-reify-file.mts when reading the file.
54
- * * 'binary' may resolve to 'latin1' per SO
55
- * * https://stackoverflow.com/questions/46441667/reading-binary-data-in-node-js
56
- */
57
- export type FileEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
58
- export declare const FileEncoding: {
59
- ascii: FileEncoding;
60
- utf8: FileEncoding;
61
- utf_8: FileEncoding;
62
- "utf-8": FileEncoding;
63
- utf16le: FileEncoding;
64
- ucs2: FileEncoding;
65
- ucs_2: FileEncoding;
66
- "ucs-2": FileEncoding;
67
- base64: FileEncoding;
68
- base64url: FileEncoding;
69
- latin1: FileEncoding;
70
- binary: FileEncoding;
71
- hex: FileEncoding;
72
- };
73
- /**
74
- * valid file encoding values per {@link FileEncoding}
75
- */
76
- export declare const FILE_ENCODINGS: FileEncoding[];
77
- export interface FileDataInfo {
78
- inputPath: string;
79
- detectedEncoding?: FileEncoding | undefined;
80
- dataString?: string | undefined;
81
- dataBuffer?: Uint8Array | undefined;
82
- }
83
- export declare const B2TFS_DEFAULT_ENCODINGS_TO_TRY: (FileEncoding | undefined)[];
84
- //# sourceMappingURL=node-filesystem-space-types.d.mts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"node-filesystem-space-types.d.mts","sourceRoot":"","sources":["../../../../../src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAG,MAAM,iCAAiC,CAAC;AAWlE,OAAO,EACH,sBAAsB,EACtB,0BAA0B,EAAE,4BAA4B,EAAE,2BAA2B,EACrF,yBAAyB,EAAE,2BAA2B,EAAE,0BAA0B,EACrF,MAAM,4BAA4B,CAAC;AAGpC;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;CACzE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC,EAAE,0BAuBnD,CAAA;AAED,2BAA2B;AAC3B,MAAM,WAAW,4BAA6B,SAAQ,cAAc;CAAI;AAExE;;;;;;;;;GASG;AACH,MAAM,WAAW,8BAA+B,SAAQ,0BAA0B;CACjF;AAED,MAAM,WAAW,gCAAiC,SAAQ,4BAA4B;CACrF;AAED,2BAA2B;AAC3B,MAAM,WAAW,+BACb,SAAQ,2BAA2B,CAAC,8BAA8B,EAAE,gCAAgC,CAAC;CACxG;AAED,2BAA2B;AAC3B,MAAM,WAAW,6BAA8B,SAAQ,yBAAyB;CAC/E;AAED,MAAM,WAAW,+BAAgC,SAAQ,2BAA2B;CACnF;AAED,MAAM,WAAW,8BACb,SAAQ,0BAA0B,CAAC,6BAA6B,EAAE,+BAA+B,CAAC;CACrG;AACD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAClB,OAAO,GACP,MAAM,GACN,OAAO,GACP,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,KAAK,CAAC;AACZ,eAAO,MAAM,YAAY;WACH,YAAY;UACd,YAAY;WACV,YAAY;aACR,YAAY;aACZ,YAAY;UAClB,YAAY;WACV,YAAY;aACR,YAAY;YACd,YAAY;eACN,YAAY;YAClB,YAAY;YACZ,YAAY;SAClB,YAAY;CAC7B,CAAC;AACF;;GAEG;AACH,eAAO,MAAM,cAAc,gBAA8B,CAAC;AAE1D,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACvC;AACD,eAAO,MAAM,8BAA8B,EAAE,CAAC,YAAY,GAAG,SAAS,CAAC,EAMtE,CAAC"}
@@ -1,65 +0,0 @@
1
- /**
2
- * @module node-filesystem-space-types
3
- *
4
- * mostly interfaces, some constants
5
- */
6
- import { DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS, IBGIB_SPACE_NAME_DEFAULT, ZERO_SPACE_ID } from '../../space-constants.mjs';
7
- import { IBGIB_BASE_SUBPATH, IBGIB_SPACE_SUBPATH_DEFAULT, IBGIB_BASE_DIR, IBGIB_ENCODING, IBGIB_IBGIBS_SUBPATH, IBGIB_META_SUBPATH, IBGIB_BIN_SUBPATH, IBGIB_DNA_SUBPATH, IBGIB_LONG_SUBPATH, DEFAULT_LONG_PATH_LENGTH, DEFAULT_FILESYSTEM_SPACE_DESCRIPTION, } from '../filesystem-constants.mjs';
8
- /**
9
- * Used in bootstrapping.
10
- *
11
- * If you change this, please bump the version
12
- *
13
- * (but of course won't be the end of the world when this doesn't happen).
14
- */
15
- export const DEFAULT_NODE_FILESYSTEM_SPACE_DATA_V1 = {
16
- version: '2',
17
- uuid: ZERO_SPACE_ID,
18
- name: IBGIB_SPACE_NAME_DEFAULT,
19
- classname: 'NodeFilesystemSpace_V1',
20
- baseDir: IBGIB_BASE_DIR,
21
- encoding: IBGIB_ENCODING,
22
- baseSubPath: IBGIB_BASE_SUBPATH,
23
- spaceSubPath: IBGIB_SPACE_SUBPATH_DEFAULT,
24
- ibgibsSubPath: IBGIB_IBGIBS_SUBPATH,
25
- metaSubPath: IBGIB_META_SUBPATH,
26
- binSubPath: IBGIB_BIN_SUBPATH,
27
- dnaSubPath: IBGIB_DNA_SUBPATH,
28
- longSubPath: IBGIB_LONG_SUBPATH,
29
- mitigateLongPaths: true,
30
- longPathLength: DEFAULT_LONG_PATH_LENGTH,
31
- persistOptsAndResultIbGibs: false,
32
- validateIbGibAddrsMatchIbGibs: false,
33
- longPollingIntervalMs: DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS,
34
- allowPrimitiveArgs: false,
35
- catchAllErrors: true,
36
- description: DEFAULT_FILESYSTEM_SPACE_DESCRIPTION,
37
- trace: false,
38
- };
39
- export const FileEncoding = {
40
- ascii: 'ascii',
41
- utf8: 'utf8',
42
- utf_8: 'utf-8',
43
- ['utf-8']: 'utf-8',
44
- utf16le: 'utf16le',
45
- ucs2: 'ucs2',
46
- ucs_2: 'ucs-2',
47
- ['ucs-2']: 'ucs-2',
48
- base64: 'base64',
49
- base64url: 'base64url',
50
- latin1: 'latin1',
51
- binary: 'binary',
52
- hex: 'hex',
53
- };
54
- /**
55
- * valid file encoding values per {@link FileEncoding}
56
- */
57
- export const FILE_ENCODINGS = Object.values(FileEncoding);
58
- export const B2TFS_DEFAULT_ENCODINGS_TO_TRY = [
59
- FileEncoding.utf8,
60
- FileEncoding.utf16le,
61
- FileEncoding.base64,
62
- FileEncoding.binary,
63
- undefined,
64
- ];
65
- //# sourceMappingURL=node-filesystem-space-types.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"node-filesystem-space-types.mjs","sourceRoot":"","sources":["../../../../../src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,uCAAuC,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC7H,OAAO,EACH,kBAAkB,EAAE,2BAA2B,EAAE,cAAc,EAC/D,cAAc,EAAE,oBAAoB,EAAE,kBAAkB,EACxD,iBAAiB,EAAE,iBAAiB,EACpC,kBAAkB,EAClB,wBAAwB,EACxB,oCAAoC,GACvC,MAAM,6BAA6B,CAAC;AAcrC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAA+B;IAC7E,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,wBAAwB;IAC9B,SAAS,EAAE,wBAAwB;IACnC,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,kBAAkB;IAC/B,YAAY,EAAE,2BAA2B;IACzC,aAAa,EAAE,oBAAoB;IACnC,WAAW,EAAE,kBAAkB;IAC/B,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE,iBAAiB;IAC7B,WAAW,EAAE,kBAAkB;IAC/B,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,wBAAwB;IACxC,0BAA0B,EAAE,KAAK;IACjC,6BAA6B,EAAE,KAAK;IACpC,qBAAqB,EAAE,uCAAuC;IAC9D,kBAAkB,EAAE,KAAK;IACzB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,oCAAoC;IACjD,KAAK,EAAE,KAAK;CACf,CAAA;AAyDD,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,KAAK,EAAE,OAAuB;IAC9B,IAAI,EAAE,MAAsB;IAC5B,KAAK,EAAE,OAAuB;IAC9B,CAAC,OAAO,CAAC,EAAE,OAAuB;IAClC,OAAO,EAAE,SAAyB;IAClC,IAAI,EAAE,MAAsB;IAC5B,KAAK,EAAE,OAAuB;IAC9B,CAAC,OAAO,CAAC,EAAE,OAAuB;IAClC,MAAM,EAAE,QAAwB;IAChC,SAAS,EAAE,WAA2B;IACtC,MAAM,EAAE,QAAwB;IAChC,MAAM,EAAE,QAAwB;IAChC,GAAG,EAAE,KAAqB;CAC7B,CAAC;AACF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAQ1D,MAAM,CAAC,MAAM,8BAA8B,GAAiC;IACxE,YAAY,CAAC,IAAI;IACjB,YAAY,CAAC,OAAO;IACpB,YAAY,CAAC,MAAM;IACnB,YAAY,CAAC,MAAM;IACnB,SAAS;CACZ,CAAC"}
@@ -1,73 +0,0 @@
1
- import { IbGib_V1, IbGibRel8ns_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
2
- import { Gib, Ib, IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
3
- import { DeleteIbGibFileOpts, DeleteIbGibFilesResult, GetIbGibFileOpts, GetIbGibFileResult, PutIbGibFileOpts, PutIbGibFileResult } from '../filesystem-types.mjs';
4
- import { FilesystemSpace_V1 } from '../filesystem-space-v1.mjs';
5
- import { NodeFilesystemSpaceData_V1, NodeFilesystemSpaceRel8ns_V1, NodeFilesystemSpaceOptionsData, NodeFilesystemSpaceOptionsRel8ns, NodeFilesystemSpaceOptionsIbGib, NodeFilesystemSpaceResultData, NodeFilesystemSpaceResultRel8ns } from './node-filesystem-space-types.mjs';
6
- /**
7
- * Base class convenience for a local space with V1 ibgibs working with the node
8
- * filesystem.
9
- *
10
- * Unfortunately, file systems have short file name requirements, where 255 is
11
- * often the max length of a filename. So this cannot store ibgibs directly by
12
- * their address.
13
- *
14
- * This naively caches ibGibs in memory. When not found there, will looks in
15
- * files using Ionic `FileSystem`.
16
- */
17
- export declare class NodeFilesystemSpace_V1<TData extends NodeFilesystemSpaceData_V1 = NodeFilesystemSpaceData_V1, TRel8ns extends NodeFilesystemSpaceRel8ns_V1 = NodeFilesystemSpaceRel8ns_V1> extends FilesystemSpace_V1<NodeFilesystemSpaceOptionsData, NodeFilesystemSpaceOptionsRel8ns, NodeFilesystemSpaceResultData, NodeFilesystemSpaceResultRel8ns, TData, TRel8ns> {
18
- /**
19
- * Log context for convenience with logging. (Ignore if you don't want to use this.)
20
- */
21
- protected lc: string;
22
- constructor(initialData?: TData, initialRel8ns?: TRel8ns);
23
- /**
24
- * Factory static method to create the space with the given
25
- * `dto` param's ibGib properties.
26
- *
27
- * We do this because when we persist this space (and its settings
28
- * located in `data`), we do not save the actual class instantiation
29
- * but just the ibgib properties. Use this factory method to
30
- * create a new space instance and rehydrate from that saved dto.
31
- *
32
- * ## notes
33
- *
34
- * * DTO stands for data transfer object.
35
- *
36
- * @param dto space ibGib dto that we're going to load from
37
- * @returns newly created space built upon `dto`
38
- */
39
- static createFromDto<TData extends NodeFilesystemSpaceData_V1 = NodeFilesystemSpaceData_V1, TRel8ns extends IbGibRel8ns_V1 = IbGibRel8ns_V1>(dto: IbGib_V1<TData, TRel8ns>): Promise<NodeFilesystemSpace_V1<TData, TRel8ns>>;
40
- protected validateWitnessArg(arg: NodeFilesystemSpaceOptionsIbGib): Promise<string[]>;
41
- /**
42
- * Initializes to default space values.
43
- */
44
- protected initialize(): Promise<void>;
45
- protected putFile({ ibGib, isDna, }: PutIbGibFileOpts): Promise<PutIbGibFileResult>;
46
- protected deleteFile({ addr, isDna, }: DeleteIbGibFileOpts): Promise<DeleteIbGibFilesResult>;
47
- protected getFile({ addr, isDna, }: GetIbGibFileOpts): Promise<GetIbGibFileResult>;
48
- protected ensurePermissions(): Promise<boolean>;
49
- protected ensureAllDirsExist(): Promise<void>;
50
- /**
51
- * actually executes the ensure functionality for given `paths`. If they
52
- * don't exist, then this tries to make the dirs.
53
- * @param paths to ensure exist.
54
- */
55
- protected ensureDirsImpl(paths: string[]): Promise<void>;
56
- /** */
57
- protected getMetaStoneAddrs({ ibGibAddr, tjpGib, fnFilterIb, }: {
58
- /**
59
- * addr of ibGib for which we're getting the metastones.
60
- */
61
- ibGibAddr: IbGibAddr;
62
- /**
63
- * tjpGib of the metastone's target ibgib
64
- */
65
- tjpGib: Gib;
66
- fnFilterIb?: (ib: Ib) => boolean;
67
- }): Promise<string[]>;
68
- }
69
- export declare function convertData({ data, encoding, }: {
70
- data: string;
71
- encoding: any;
72
- }): Promise<any>;
73
- //# sourceMappingURL=node-filesystem-space-v1.d.mts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"node-filesystem-space-v1.d.mts","sourceRoot":"","sources":["../../../../../src/witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.mts"],"names":[],"mappings":"AAOA,OAAO,EACH,QAAQ,EAAE,cAAc,EAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOlE,OAAO,EACH,mBAAmB,EAAE,sBAAsB,EAC3C,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EACrB,MAAM,yBAAyB,CAAC;AASjC,OAAO,EAAE,kBAAkB,EAAG,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACH,0BAA0B,EAAE,4BAA4B,EACxD,8BAA8B,EAAE,gCAAgC,EAAE,+BAA+B,EACjG,6BAA6B,EAAE,+BAA+B,EAGjE,MAAM,mCAAmC,CAAC;AAO3C;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB,CAC/B,KAAK,SAAS,0BAA0B,GAAG,0BAA0B,EACrE,OAAO,SAAS,4BAA4B,GAAG,4BAA4B,CAC7E,SAAQ,kBAAkB,CACxB,8BAA8B,EAC9B,gCAAgC,EAChC,6BAA6B,EAC7B,+BAA+B,EAC/B,KAAK,EACL,OAAO,CACV;IAEG;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,CAAsC;gBActD,WAAW,CAAC,EAAE,KAAK,EACnB,aAAa,CAAC,EAAE,OAAO;IAgB3B;;;;;;;;;;;;;;;OAeG;WACU,aAAa,CACtB,KAAK,SAAS,0BAA0B,GAAG,0BAA0B,EACrE,OAAO,SAAS,cAAc,GAAG,cAAc,EACjD,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;cASjE,kBAAkB,CAAC,GAAG,EAAE,+BAA+B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqB3F;;OAEG;cACa,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;cAwC3B,OAAO,CAAC,EACpB,KAAK,EACL,KAAK,GACR,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;cAkEjC,UAAU,CAAC,EACvB,IAAI,EACJ,KAAK,GACR,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC;cAwCxC,OAAO,CAAC,EACpB,IAAI,EACJ,KAAK,GACR,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;cA4GjC,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;cAMrC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCnD;;;;OAIG;cACa,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoE9D,MAAM;cACU,iBAAiB,CAAC,EAC9B,SAAS,EACT,MAAM,EACN,UAAU,GACb,EAAE;QACC;;WAEG;QACH,SAAS,EAAE,SAAS,CAAC;QACrB;;WAEG;QACH,MAAM,EAAE,GAAG,CAAC;QACZ,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC;KACpC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAqGxB;AACD,wBAAsB,WAAW,CAAC,EAC9B,IAAI,EACJ,QAAQ,GACX,EAAE;IACC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,GAAG,CAAC;CACjB,GAAG,OAAO,CAAC,GAAG,CAAC,CAWf"}