@cldmv/slothlet 3.3.0 → 3.4.0

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 (139) hide show
  1. package/README.md +9 -10
  2. package/REFERENCE.md +23 -0
  3. package/dist/lib/builders/api-assignment.mjs +1 -589
  4. package/dist/lib/builders/api_builder.mjs +1 -1385
  5. package/dist/lib/builders/builder.mjs +1 -78
  6. package/dist/lib/builders/modes-processor.mjs +1 -1800
  7. package/dist/lib/errors.mjs +9 -211
  8. package/dist/lib/factories/component-base.mjs +1 -80
  9. package/dist/lib/factories/context.mjs +1 -22
  10. package/dist/lib/handlers/api-cache-manager.mjs +1 -200
  11. package/dist/lib/handlers/api-manager.mjs +1 -2536
  12. package/dist/lib/handlers/context-async.mjs +1 -172
  13. package/dist/lib/handlers/context-live.mjs +1 -173
  14. package/dist/lib/handlers/hook-manager.mjs +1 -667
  15. package/dist/lib/handlers/lifecycle-token.mjs +1 -28
  16. package/dist/lib/handlers/lifecycle.mjs +1 -115
  17. package/dist/lib/handlers/materialize-manager.mjs +1 -48
  18. package/dist/lib/handlers/metadata.mjs +1 -501
  19. package/dist/lib/handlers/ownership.mjs +1 -322
  20. package/dist/lib/handlers/permission-manager.mjs +1 -392
  21. package/dist/lib/handlers/unified-wrapper.mjs +1 -3110
  22. package/dist/lib/handlers/version-manager.mjs +1 -885
  23. package/dist/lib/helpers/class-instance-wrapper.mjs +1 -109
  24. package/dist/lib/helpers/config.mjs +1 -439
  25. package/dist/lib/helpers/eventemitter-context.mjs +1 -349
  26. package/dist/lib/helpers/hint-detector.mjs +1 -47
  27. package/dist/lib/helpers/modes-utils.mjs +1 -37
  28. package/dist/lib/helpers/pattern-matcher.mjs +1 -125
  29. package/dist/lib/helpers/resolve-from-caller.mjs +1 -169
  30. package/dist/lib/helpers/sanitize.mjs +1 -340
  31. package/dist/lib/helpers/utilities.mjs +1 -70
  32. package/dist/lib/i18n/languages/de-de.json +1 -0
  33. package/dist/lib/i18n/languages/en-gb.json +1 -0
  34. package/dist/lib/i18n/languages/en-us.json +1 -0
  35. package/dist/lib/i18n/languages/es-es.json +412 -0
  36. package/dist/lib/i18n/languages/es-mx.json +1 -0
  37. package/dist/lib/i18n/languages/fr-fr.json +1 -0
  38. package/dist/lib/i18n/languages/hi-in.json +2 -1
  39. package/dist/lib/i18n/languages/ja-jp.json +1 -0
  40. package/dist/lib/i18n/languages/ko-kr.json +1 -0
  41. package/dist/lib/i18n/languages/pt-br.json +21 -20
  42. package/dist/lib/i18n/languages/ru-ru.json +2 -1
  43. package/dist/lib/i18n/languages/zh-cn.json +6 -5
  44. package/dist/lib/i18n/translations.mjs +1 -126
  45. package/dist/lib/modes/eager.mjs +1 -59
  46. package/dist/lib/modes/lazy.mjs +1 -81
  47. package/dist/lib/processors/flatten.mjs +1 -437
  48. package/dist/lib/processors/loader.mjs +1 -339
  49. package/dist/lib/processors/type-generator.mjs +1 -275
  50. package/dist/lib/processors/typescript.mjs +1 -172
  51. package/dist/lib/runtime/runtime-asynclocalstorage.mjs +1 -113
  52. package/dist/lib/runtime/runtime-livebindings.mjs +1 -78
  53. package/dist/lib/runtime/runtime.mjs +1 -102
  54. package/dist/slothlet.mjs +1 -817
  55. package/package.json +35 -31
  56. package/types/dist/lib/builders/api-assignment.d.mts +3 -92
  57. package/types/dist/lib/builders/api-assignment.d.mts.map +1 -1
  58. package/types/dist/lib/builders/api_builder.d.mts +102 -91
  59. package/types/dist/lib/builders/api_builder.d.mts.map +1 -1
  60. package/types/dist/lib/builders/builder.d.mts +1 -55
  61. package/types/dist/lib/builders/builder.d.mts.map +1 -1
  62. package/types/dist/lib/builders/modes-processor.d.mts +3 -27
  63. package/types/dist/lib/builders/modes-processor.d.mts.map +1 -1
  64. package/types/dist/lib/errors.d.mts +19 -109
  65. package/types/dist/lib/errors.d.mts.map +1 -1
  66. package/types/dist/lib/factories/component-base.d.mts +7 -177
  67. package/types/dist/lib/factories/component-base.d.mts.map +1 -1
  68. package/types/dist/lib/factories/context.d.mts +4 -22
  69. package/types/dist/lib/factories/context.d.mts.map +1 -1
  70. package/types/dist/lib/handlers/api-cache-manager.d.mts +20 -203
  71. package/types/dist/lib/handlers/api-cache-manager.d.mts.map +1 -1
  72. package/types/dist/lib/handlers/api-manager.d.mts +34 -408
  73. package/types/dist/lib/handlers/api-manager.d.mts.map +1 -1
  74. package/types/dist/lib/handlers/context-async.d.mts +23 -61
  75. package/types/dist/lib/handlers/context-async.d.mts.map +1 -1
  76. package/types/dist/lib/handlers/context-live.d.mts +22 -59
  77. package/types/dist/lib/handlers/context-live.d.mts.map +1 -1
  78. package/types/dist/lib/handlers/hook-manager.d.mts +46 -185
  79. package/types/dist/lib/handlers/hook-manager.d.mts.map +1 -1
  80. package/types/dist/lib/handlers/lifecycle-token.d.mts +3 -48
  81. package/types/dist/lib/handlers/lifecycle-token.d.mts.map +1 -1
  82. package/types/dist/lib/handlers/lifecycle.d.mts +5 -82
  83. package/types/dist/lib/handlers/lifecycle.d.mts.map +1 -1
  84. package/types/dist/lib/handlers/materialize-manager.d.mts +8 -70
  85. package/types/dist/lib/handlers/materialize-manager.d.mts.map +1 -1
  86. package/types/dist/lib/handlers/metadata.d.mts +17 -221
  87. package/types/dist/lib/handlers/metadata.d.mts.map +1 -1
  88. package/types/dist/lib/handlers/ownership.d.mts +44 -160
  89. package/types/dist/lib/handlers/ownership.d.mts.map +1 -1
  90. package/types/dist/lib/handlers/permission-manager.d.mts +40 -141
  91. package/types/dist/lib/handlers/permission-manager.d.mts.map +1 -1
  92. package/types/dist/lib/handlers/unified-wrapper.d.mts +26 -239
  93. package/types/dist/lib/handlers/unified-wrapper.d.mts.map +1 -1
  94. package/types/dist/lib/handlers/version-manager.d.mts +28 -225
  95. package/types/dist/lib/handlers/version-manager.d.mts.map +1 -1
  96. package/types/dist/lib/helpers/class-instance-wrapper.d.mts +2 -52
  97. package/types/dist/lib/helpers/class-instance-wrapper.d.mts.map +1 -1
  98. package/types/dist/lib/helpers/config.d.mts +125 -139
  99. package/types/dist/lib/helpers/config.d.mts.map +1 -1
  100. package/types/dist/lib/helpers/eventemitter-context.d.mts +3 -29
  101. package/types/dist/lib/helpers/eventemitter-context.d.mts.map +1 -1
  102. package/types/dist/lib/helpers/hint-detector.d.mts +2 -15
  103. package/types/dist/lib/helpers/hint-detector.d.mts.map +1 -1
  104. package/types/dist/lib/helpers/modes-utils.d.mts +3 -30
  105. package/types/dist/lib/helpers/modes-utils.d.mts.map +1 -1
  106. package/types/dist/lib/helpers/pattern-matcher.d.mts +3 -43
  107. package/types/dist/lib/helpers/pattern-matcher.d.mts.map +1 -1
  108. package/types/dist/lib/helpers/resolve-from-caller.d.mts +3 -27
  109. package/types/dist/lib/helpers/resolve-from-caller.d.mts.map +1 -1
  110. package/types/dist/lib/helpers/sanitize.d.mts +4 -92
  111. package/types/dist/lib/helpers/sanitize.d.mts.map +1 -1
  112. package/types/dist/lib/helpers/utilities.d.mts +4 -52
  113. package/types/dist/lib/helpers/utilities.d.mts.map +1 -1
  114. package/types/dist/lib/i18n/translations.d.mts +4 -37
  115. package/types/dist/lib/i18n/translations.d.mts.map +1 -1
  116. package/types/dist/lib/modes/eager.d.mts +8 -30
  117. package/types/dist/lib/modes/eager.d.mts.map +1 -1
  118. package/types/dist/lib/modes/lazy.d.mts +10 -43
  119. package/types/dist/lib/modes/lazy.d.mts.map +1 -1
  120. package/types/dist/lib/processors/flatten.d.mts +56 -107
  121. package/types/dist/lib/processors/flatten.d.mts.map +1 -1
  122. package/types/dist/lib/processors/loader.d.mts +6 -41
  123. package/types/dist/lib/processors/loader.d.mts.map +1 -1
  124. package/types/dist/lib/processors/type-generator.d.mts +2 -16
  125. package/types/dist/lib/processors/type-generator.d.mts.map +1 -1
  126. package/types/dist/lib/processors/typescript.d.mts +6 -53
  127. package/types/dist/lib/processors/typescript.d.mts.map +1 -1
  128. package/types/dist/lib/runtime/runtime-asynclocalstorage.d.mts +3 -71
  129. package/types/dist/lib/runtime/runtime-asynclocalstorage.d.mts.map +1 -1
  130. package/types/dist/lib/runtime/runtime-livebindings.d.mts +2 -37
  131. package/types/dist/lib/runtime/runtime-livebindings.d.mts.map +1 -1
  132. package/types/dist/lib/runtime/runtime.d.mts +3 -39
  133. package/types/dist/lib/runtime/runtime.d.mts.map +1 -1
  134. package/types/dist/slothlet.d.mts +3 -249
  135. package/types/dist/slothlet.d.mts.map +1 -1
  136. package/types/index.d.mts +36 -16
  137. package/types/index.d.mts.map +1 -0
  138. package/AGENT-USAGE.md +0 -736
  139. package/docs/API-RULES.md +0 -712
@@ -14,112 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
-
18
-
19
-
20
-
21
- import { EventEmitter } from "node:events";
22
-
23
-
24
- const EXCLUDED_CONSTRUCTORS = new Set([Object, Array, Promise, Date, RegExp, Error]);
25
-
26
-
27
- const EXCLUDED_INSTANCEOF_CLASSES = [ArrayBuffer, Map, Set, WeakMap, WeakSet, EventEmitter];
28
-
29
-
30
- export function runtime_shouldWrapMethod(value, prop) {
31
- return (
32
- typeof value === "function" &&
33
- typeof prop === "string" &&
34
- prop !== "constructor" &&
35
- !(prop in Object.prototype) &&
36
- !prop.startsWith("__")
37
- );
38
- }
39
-
40
-
41
- export function runtime_isClassInstance(val) {
42
- if (
43
- val == null ||
44
- typeof val !== "object" ||
45
- !val.constructor ||
46
- typeof val.constructor !== "function" ||
47
- EXCLUDED_CONSTRUCTORS.has(val.constructor)
48
- ) {
49
- return false;
50
- }
51
-
52
- for (const cls of EXCLUDED_INSTANCEOF_CLASSES) {
53
- if (typeof cls === "function" && val instanceof cls) {
54
- return false;
55
- }
56
- }
57
-
58
- return true;
59
- }
60
-
61
-
62
- export function runtime_wrapClassInstance(instance, contextManager, instanceID, instanceCache) {
63
- if (instanceCache.has(instance)) {
64
- return instanceCache.get(instance);
65
- }
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
- const methodCache = new Map();
75
-
76
- const wrappedInstance = new Proxy(instance, {
77
- get(target, prop, receiver) {
78
-
79
- if (methodCache.has(prop)) {
80
- return methodCache.get(prop);
81
- }
82
-
83
- const value = Reflect.get(target, prop, receiver);
84
-
85
-
86
-
87
- if (runtime_shouldWrapMethod(value, prop)) {
88
- const runtime_contextPreservingMethod = function (...args) {
89
-
90
-
91
- const result = contextManager.runInContext(instanceID, value, target, args);
92
-
93
-
94
- if (result != null && runtime_isClassInstance(result)) {
95
- return runtime_wrapClassInstance(result, contextManager, instanceID, instanceCache);
96
- }
97
-
98
- return result;
99
- };
100
-
101
-
102
- methodCache.set(prop, runtime_contextPreservingMethod);
103
- return runtime_contextPreservingMethod;
104
- }
105
-
106
-
107
- if (value != null && runtime_isClassInstance(value)) {
108
- return runtime_wrapClassInstance(value, contextManager, instanceID, instanceCache);
109
- }
110
-
111
- return value;
112
- },
113
-
114
- set(target, prop, value, receiver) {
115
-
116
- if (methodCache.has(prop)) {
117
- methodCache.delete(prop);
118
- }
119
- return Reflect.set(target, prop, value, receiver);
120
- }
121
- });
122
-
123
- instanceCache.set(instance, wrappedInstance);
124
- return wrappedInstance;
125
- }
17
+ import{EventEmitter}from"node:events";const EXCLUDED_CONSTRUCTORS=new Set([Object,Array,Promise,Date,RegExp,Error]);const EXCLUDED_INSTANCEOF_CLASSES=[ArrayBuffer,Map,Set,WeakMap,WeakSet,EventEmitter];function runtime_shouldWrapMethod(value,prop){return typeof value==="function"&&typeof prop==="string"&&prop!=="constructor"&&!(prop in Object.prototype)&&!prop.startsWith("__")}function runtime_isClassInstance(val){if(val==null||typeof val!=="object"||!val.constructor||typeof val.constructor!=="function"||EXCLUDED_CONSTRUCTORS.has(val.constructor)){return false}for(const cls of EXCLUDED_INSTANCEOF_CLASSES){if(typeof cls==="function"&&val instanceof cls){return false}}return true}function runtime_wrapClassInstance(instance,contextManager,instanceID,instanceCache){if(instanceCache.has(instance)){return instanceCache.get(instance)}const methodCache=new Map;const wrappedInstance=new Proxy(instance,{get(target,prop,receiver){if(methodCache.has(prop)){return methodCache.get(prop)}const value=Reflect.get(target,prop,receiver);if(runtime_shouldWrapMethod(value,prop)){const runtime_contextPreservingMethod=function(...args){const result=contextManager.runInContext(instanceID,value,target,args);if(result!=null&&runtime_isClassInstance(result)){return runtime_wrapClassInstance(result,contextManager,instanceID,instanceCache)}return result};methodCache.set(prop,runtime_contextPreservingMethod);return runtime_contextPreservingMethod}if(value!=null&&runtime_isClassInstance(value)){return runtime_wrapClassInstance(value,contextManager,instanceID,instanceCache)}return value},set(target,prop,value,receiver){if(methodCache.has(prop)){methodCache.delete(prop)}return Reflect.set(target,prop,value,receiver)}});instanceCache.set(instance,wrappedInstance);return wrappedInstance}export{runtime_isClassInstance,runtime_shouldWrapMethod,runtime_wrapClassInstance};
@@ -14,442 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
-
18
-
19
-
20
- import { ComponentBase } from "@cldmv/slothlet/factories/component-base";
21
- import { SlothletError } from "@cldmv/slothlet/errors";
22
-
23
-
24
- export class Config extends ComponentBase {
25
- static slothletProperty = "config";
26
-
27
-
28
- normalizeCollision(collision) {
29
- const validModes = ["skip", "warn", "replace", "merge", "merge-replace", "error"];
30
- const defaultMode = "merge";
31
-
32
-
33
- if (typeof collision === "string") {
34
- const normalized = collision.toLowerCase();
35
- const mode = validModes.includes(normalized) ? normalized : defaultMode;
36
- return { initial: mode, api: mode };
37
- }
38
-
39
-
40
- if (collision && typeof collision === "object") {
41
- const validateMode = (m) => {
42
- if (!m) return defaultMode;
43
- const normalized = String(m).toLowerCase();
44
- return validModes.includes(normalized) ? normalized : defaultMode;
45
- };
46
- return {
47
- initial: validateMode(collision.initial),
48
- api: validateMode(collision.api)
49
- };
50
- }
51
-
52
-
53
- return { initial: defaultMode, api: defaultMode };
54
- }
55
-
56
-
57
- normalizeRuntime(runtime) {
58
- if (!runtime || typeof runtime !== "string") {
59
- return "async";
60
- }
61
-
62
- const normalized = runtime.toLowerCase().trim();
63
-
64
-
65
- if (normalized === "async" || normalized === "asynclocal" || normalized === "asynclocalstorage") {
66
- return "async";
67
- }
68
-
69
-
70
- if (normalized === "live" || normalized === "livebindings" || normalized === "experimental") {
71
- return "live";
72
- }
73
-
74
-
75
- return "async";
76
- }
77
-
78
-
79
- normalizeMode(mode) {
80
- if (!mode || typeof mode !== "string") {
81
- return "eager";
82
- }
83
-
84
- const normalized = mode.toLowerCase().trim();
85
-
86
-
87
- if (normalized === "lazy" || normalized === "deferred" || normalized === "proxy") {
88
- return "lazy";
89
- }
90
-
91
-
92
- if (normalized === "eager" || normalized === "immediate" || normalized === "preload") {
93
- return "eager";
94
- }
95
-
96
-
97
- return "eager";
98
- }
99
-
100
-
101
- normalizeMutations(mutations) {
102
- const defaults = { add: true, remove: true, reload: true, permissions: true };
103
-
104
-
105
- if (!mutations || typeof mutations !== "object") {
106
- return defaults;
107
- }
108
-
109
-
110
- return {
111
- add: mutations.add === false ? false : true,
112
- remove: mutations.remove === false ? false : true,
113
- reload: mutations.reload === false ? false : true,
114
- permissions: mutations.permissions === false ? false : true
115
- };
116
- }
117
-
118
-
119
- normalizeDebug(debug) {
120
- if (!debug) {
121
- return {
122
- builder: false,
123
- api: false,
124
- index: false,
125
- modes: false,
126
- wrapper: false,
127
- ownership: false,
128
- context: false,
129
- initialization: false,
130
- materialize: false,
131
- versioning: false,
132
- permissions: false
133
- };
134
- }
135
-
136
-
137
- if (debug === true) {
138
- return {
139
- builder: true,
140
- api: true,
141
- index: true,
142
- modes: true,
143
- wrapper: true,
144
- ownership: true,
145
- context: true,
146
- initialization: true,
147
- materialize: true,
148
- versioning: true,
149
- permissions: true
150
- };
151
- }
152
-
153
-
154
- if (typeof debug === "object") {
155
- return {
156
- builder: debug.builder || false,
157
- api: debug.api || false,
158
- index: debug.index || false,
159
- modes: debug.modes || false,
160
- wrapper: debug.wrapper || false,
161
- ownership: debug.ownership || false,
162
- context: debug.context || false,
163
- initialization: debug.initialization || false,
164
- materialize: debug.materialize || false,
165
- versioning: debug.versioning || false,
166
- permissions: debug.permissions || false
167
- };
168
- }
169
-
170
-
171
- return {
172
- builder: false,
173
- api: false,
174
- index: false,
175
- modes: false,
176
- wrapper: false,
177
- ownership: false,
178
- context: false,
179
- initialization: false,
180
- materialize: false,
181
- versioning: false,
182
- permissions: false
183
- };
184
- }
185
-
186
-
187
- transformConfig(config = {}) {
188
-
189
- if (!config.dir) {
190
- throw new this.SlothletError("INVALID_CONFIG_DIR_MISSING", {}, null, { validationError: true });
191
- }
192
-
193
-
194
- const resolvedDir = this.slothlet.helpers.resolver.resolvePathFromCaller(config.dir);
195
-
196
-
197
-
198
- let mutations = null;
199
- if (config.allowMutation === false) {
200
-
201
- mutations = { add: false, remove: false, reload: false };
202
- if (!config.silent) {
203
- new this.SlothletWarning("V2_CONFIG_UNSUPPORTED", {
204
- option: "allowMutation",
205
- replacement: "api.mutations: { add: false, remove: false, reload: false }",
206
- hint: "The allowMutation config option was part of v2. Use api.mutations for granular control in v3."
207
- });
208
- }
209
- }
210
-
211
-
212
-
213
- let collision = null;
214
- if (config.collision && !config.api?.collision) {
215
- collision = this.normalizeCollision(config.collision);
216
- if (!config.silent) {
217
- new this.SlothletWarning("V2_CONFIG_UNSUPPORTED", {
218
- option: "collision",
219
- replacement: "api.collision",
220
- hint: "Root-level collision config was part of v2. Use api.collision in v3."
221
- });
222
- }
223
- }
224
-
225
-
226
- const apiConfig = config.api || {};
227
- const finalCollision = apiConfig.collision ? this.normalizeCollision(apiConfig.collision) : collision || this.normalizeCollision(null);
228
- const finalMutations = apiConfig.mutations ? this.normalizeMutations(apiConfig.mutations) : mutations || this.normalizeMutations(null);
229
-
230
-
231
- let scopeConfig = config.scope;
232
- if (scopeConfig && typeof scopeConfig === "object" && scopeConfig.merge) {
233
- const validMergeStrategies = ["shallow", "deep"];
234
- if (!validMergeStrategies.includes(scopeConfig.merge)) {
235
- throw new this.SlothletError(
236
- "INVALID_CONFIG",
237
- {
238
- option: "scope.merge",
239
- value: scopeConfig.merge,
240
- expected: validMergeStrategies.join(" or "),
241
- hint: `Invalid merge strategy: "${scopeConfig.merge}". Must be "shallow" or "deep".`,
242
- validationError: true
243
- },
244
- null,
245
- { validationError: true }
246
- );
247
- }
248
- }
249
-
250
-
251
- let hookConfig = { enabled: false, pattern: "**", suppressErrors: false };
252
- if (config.hook === true || config.hook === false) {
253
-
254
- hookConfig.enabled = config.hook;
255
- hookConfig.pattern = config.hook ? "**" : null;
256
- } else if (typeof config.hook === "string") {
257
-
258
- hookConfig.enabled = true;
259
- hookConfig.pattern = config.hook;
260
- } else if (config.hook && typeof config.hook === "object") {
261
-
262
- hookConfig.enabled = config.hook.enabled !== false;
263
- hookConfig.pattern = config.hook.pattern || "**";
264
- hookConfig.suppressErrors = config.hook.suppressErrors || false;
265
- }
266
-
267
-
268
- let trackingConfig = { materialization: false };
269
- if (config.tracking === true || config.tracking === false) {
270
-
271
- trackingConfig.materialization = config.tracking;
272
- } else if (config.tracking && typeof config.tracking === "object") {
273
-
274
- trackingConfig.materialization = config.tracking.materialization === true;
275
- }
276
-
277
-
278
- if (config.backgroundMaterialize === true) {
279
- trackingConfig.materialization = true;
280
- }
281
-
282
-
283
- if (config.versionDispatcher !== undefined && config.versionDispatcher !== null) {
284
- if (typeof config.versionDispatcher !== "string" && typeof config.versionDispatcher !== "function") {
285
- throw new this.SlothletError("INVALID_CONFIG_VERSION_DISPATCHER", {
286
- received: typeof config.versionDispatcher,
287
- validationError: true
288
- });
289
- }
290
- }
291
-
292
-
293
- const permissionsConfig = this.normalizePermissions(config.permissions);
294
-
295
-
296
- let i18nConfig = null;
297
- if (config.i18n && typeof config.i18n === "object") {
298
- i18nConfig = {
299
- language: typeof config.i18n.language === "string" ? config.i18n.language : undefined
300
- };
301
- }
302
-
303
-
304
- return {
305
- ...config,
306
- dir: resolvedDir,
307
- mode: this.normalizeMode(config.mode),
308
- runtime: this.normalizeRuntime(config.runtime),
309
- apiDepth: config.apiDepth !== undefined ? config.apiDepth : Infinity,
310
- reference: config.reference || null,
311
- context: config.context || null,
312
- i18n: i18nConfig,
313
- debug: this.normalizeDebug(config.debug),
314
- diagnostics: config.diagnostics === true,
315
- hook: hookConfig,
316
- collision: finalCollision,
317
- api: {
318
- collision: finalCollision,
319
- mutations: finalMutations
320
- },
321
- scope: scopeConfig,
322
- tracking: trackingConfig,
323
- backgroundMaterialize: config.backgroundMaterialize === true,
324
- silent: config.silent === true,
325
- typescript: this.normalizeTypeScript(config.typescript),
326
- env: this.normalizeEnv(config.env),
327
- versionDispatcher: config.versionDispatcher ?? null,
328
- permissions: permissionsConfig
329
- };
330
- }
331
-
332
-
333
- normalizeTypeScript(typescript) {
334
-
335
- if (!typescript) {
336
- return null;
337
- }
338
-
339
-
340
- if (typescript === true) {
341
- return { enabled: true, mode: "fast" };
342
- }
343
-
344
-
345
- if (typeof typescript === "string") {
346
- const mode = typescript.toLowerCase();
347
- if (mode === "fast" || mode === "strict") {
348
- return { enabled: true, mode };
349
- }
350
-
351
- return { enabled: true, mode: "fast" };
352
- }
353
-
354
-
355
- if (typeof typescript === "object") {
356
- const mode = typescript.mode === "strict" ? "strict" : "fast";
357
- return {
358
- enabled: true,
359
- mode,
360
- types: typescript.types || null,
361
- target: typescript.target || "es2020",
362
- sourcemap: typescript.sourcemap || false
363
- };
364
- }
365
-
366
-
367
- return null;
368
- }
369
-
370
-
371
- normalizeEnv(env) {
372
- if (!env || typeof env !== "object") {
373
- return null;
374
- }
375
- const include = Array.isArray(env.include) ? env.include.filter((k) => typeof k === "string") : null;
376
- if (include && include.length > 0) {
377
- return { include };
378
- }
379
- return null;
380
- }
381
-
382
-
383
- normalizePermissions(permissions) {
384
- if (!permissions || typeof permissions !== "object") {
385
- return null;
386
- }
387
-
388
-
389
- let defaultPolicy;
390
- if (permissions.defaultPolicy === "deny") {
391
- defaultPolicy = "deny";
392
- } else if (permissions.defaultPolicy === "allow" || permissions.defaultPolicy === undefined) {
393
- defaultPolicy = "allow";
394
- } else {
395
- throw new SlothletError(
396
- "INVALID_CONFIG",
397
- {
398
- option: "permissions.defaultPolicy",
399
- value: permissions.defaultPolicy,
400
- expected: '"allow" or "deny"',
401
- hint: "HINT_INVALID_CONFIG"
402
- },
403
- null,
404
- { validationError: true }
405
- );
406
- }
407
-
408
- const enabled = permissions.enabled !== false;
409
-
410
-
411
- let audit;
412
- if (permissions.audit === "verbose") {
413
- audit = "verbose";
414
- } else if (permissions.audit === "default" || permissions.audit === undefined) {
415
- audit = "default";
416
- } else if (permissions.audit === true) {
417
-
418
- audit = "default";
419
- } else if (permissions.audit === false) {
420
-
421
- audit = "default";
422
- } else {
423
- throw new SlothletError(
424
- "INVALID_CONFIG",
425
- {
426
- option: "permissions.audit",
427
- value: permissions.audit,
428
- expected: '"default" or "verbose"',
429
- hint: "HINT_INVALID_CONFIG"
430
- },
431
- null,
432
- { validationError: true }
433
- );
434
- }
435
-
436
-
437
- if (permissions.rules !== undefined && !Array.isArray(permissions.rules)) {
438
- throw new SlothletError(
439
- "INVALID_CONFIG",
440
- {
441
- option: "permissions.rules",
442
- value: permissions.rules,
443
- expected: "array",
444
- hint: "HINT_INVALID_CONFIG"
445
- },
446
- null,
447
- { validationError: true }
448
- );
449
- }
450
-
451
- const rules = Array.isArray(permissions.rules) ? permissions.rules : [];
452
-
453
- return { defaultPolicy, enabled, audit, rules };
454
- }
455
- }
17
+ import{ComponentBase}from"@cldmv/slothlet/factories/component-base";import{SlothletError}from"@cldmv/slothlet/errors";class Config extends ComponentBase{static slothletProperty="config";normalizeCollision(collision){const validModes=["skip","warn","replace","merge","merge-replace","error"];const defaultMode="merge";if(typeof collision==="string"){const normalized=collision.toLowerCase();const mode=validModes.includes(normalized)?normalized:defaultMode;return{initial:mode,api:mode}}if(collision&&typeof collision==="object"){const validateMode=m=>{if(!m)return defaultMode;const normalized=String(m).toLowerCase();return validModes.includes(normalized)?normalized:defaultMode};return{initial:validateMode(collision.initial),api:validateMode(collision.api)}}return{initial:defaultMode,api:defaultMode}}normalizeRuntime(runtime){if(!runtime||typeof runtime!=="string"){return"async"}const normalized=runtime.toLowerCase().trim();if(normalized==="async"||normalized==="asynclocal"||normalized==="asynclocalstorage"){return"async"}if(normalized==="live"||normalized==="livebindings"||normalized==="experimental"){return"live"}return"async"}normalizeMode(mode){if(!mode||typeof mode!=="string"){return"eager"}const normalized=mode.toLowerCase().trim();if(normalized==="lazy"||normalized==="deferred"||normalized==="proxy"){return"lazy"}if(normalized==="eager"||normalized==="immediate"||normalized==="preload"){return"eager"}return"eager"}normalizeMutations(mutations){const defaults={add:true,remove:true,reload:true,permissions:true};if(!mutations||typeof mutations!=="object"){return defaults}return{add:mutations.add===false?false:true,remove:mutations.remove===false?false:true,reload:mutations.reload===false?false:true,permissions:mutations.permissions===false?false:true}}normalizeDebug(debug){if(!debug){return{builder:false,api:false,index:false,modes:false,wrapper:false,ownership:false,context:false,initialization:false,materialize:false,versioning:false,permissions:false}}if(debug===true){return{builder:true,api:true,index:true,modes:true,wrapper:true,ownership:true,context:true,initialization:true,materialize:true,versioning:true,permissions:true}}if(typeof debug==="object"){return{builder:debug.builder||false,api:debug.api||false,index:debug.index||false,modes:debug.modes||false,wrapper:debug.wrapper||false,ownership:debug.ownership||false,context:debug.context||false,initialization:debug.initialization||false,materialize:debug.materialize||false,versioning:debug.versioning||false,permissions:debug.permissions||false}}return{builder:false,api:false,index:false,modes:false,wrapper:false,ownership:false,context:false,initialization:false,materialize:false,versioning:false,permissions:false}}transformConfig(config={}){if(!config.dir){throw new this.SlothletError("INVALID_CONFIG_DIR_MISSING",{},null,{validationError:true})}const resolvedDir=this.slothlet.helpers.resolver.resolvePathFromCaller(config.dir);let mutations=null;if(config.allowMutation===false){mutations={add:false,remove:false,reload:false};if(!config.silent){new this.SlothletWarning("V2_CONFIG_UNSUPPORTED",{option:"allowMutation",replacement:"api.mutations: { add: false, remove: false, reload: false }",hint:"The allowMutation config option was part of v2. Use api.mutations for granular control in v3."})}}let collision=null;if(config.collision&&!config.api?.collision){collision=this.normalizeCollision(config.collision);if(!config.silent){new this.SlothletWarning("V2_CONFIG_UNSUPPORTED",{option:"collision",replacement:"api.collision",hint:"Root-level collision config was part of v2. Use api.collision in v3."})}}const apiConfig=config.api||{};const finalCollision=apiConfig.collision?this.normalizeCollision(apiConfig.collision):collision||this.normalizeCollision(null);const finalMutations=apiConfig.mutations?this.normalizeMutations(apiConfig.mutations):mutations||this.normalizeMutations(null);let scopeConfig=config.scope;if(scopeConfig&&typeof scopeConfig==="object"&&scopeConfig.merge){const validMergeStrategies=["shallow","deep"];if(!validMergeStrategies.includes(scopeConfig.merge)){throw new this.SlothletError("INVALID_CONFIG",{option:"scope.merge",value:scopeConfig.merge,expected:validMergeStrategies.join(" or "),hint:`Invalid merge strategy: "${scopeConfig.merge}". Must be "shallow" or "deep".`,validationError:true},null,{validationError:true})}}let hookConfig={enabled:false,pattern:"**",suppressErrors:false};if(config.hook===true||config.hook===false){hookConfig.enabled=config.hook;hookConfig.pattern=config.hook?"**":null}else if(typeof config.hook==="string"){hookConfig.enabled=true;hookConfig.pattern=config.hook}else if(config.hook&&typeof config.hook==="object"){hookConfig.enabled=config.hook.enabled!==false;hookConfig.pattern=config.hook.pattern||"**";hookConfig.suppressErrors=config.hook.suppressErrors||false}let trackingConfig={materialization:false};if(config.tracking===true||config.tracking===false){trackingConfig.materialization=config.tracking}else if(config.tracking&&typeof config.tracking==="object"){trackingConfig.materialization=config.tracking.materialization===true}if(config.backgroundMaterialize===true){trackingConfig.materialization=true}if(config.versionDispatcher!==void 0&&config.versionDispatcher!==null){if(typeof config.versionDispatcher!=="string"&&typeof config.versionDispatcher!=="function"){throw new this.SlothletError("INVALID_CONFIG_VERSION_DISPATCHER",{received:typeof config.versionDispatcher,validationError:true})}}const permissionsConfig=this.normalizePermissions(config.permissions);let i18nConfig=null;if(config.i18n&&typeof config.i18n==="object"){i18nConfig={language:typeof config.i18n.language==="string"?config.i18n.language:void 0}}return{...config,dir:resolvedDir,mode:this.normalizeMode(config.mode),runtime:this.normalizeRuntime(config.runtime),apiDepth:config.apiDepth!==void 0?config.apiDepth:Infinity,reference:config.reference||null,context:config.context||null,i18n:i18nConfig,debug:this.normalizeDebug(config.debug),diagnostics:config.diagnostics===true,hook:hookConfig,collision:finalCollision,api:{collision:finalCollision,mutations:finalMutations},scope:scopeConfig,tracking:trackingConfig,backgroundMaterialize:config.backgroundMaterialize===true,silent:config.silent===true,typescript:this.normalizeTypeScript(config.typescript),env:this.normalizeEnv(config.env),versionDispatcher:config.versionDispatcher??null,permissions:permissionsConfig}}normalizeTypeScript(typescript){if(!typescript){return null}if(typescript===true){return{enabled:true,mode:"fast"}}if(typeof typescript==="string"){const mode=typescript.toLowerCase();if(mode==="fast"||mode==="strict"){return{enabled:true,mode}}return{enabled:true,mode:"fast"}}if(typeof typescript==="object"){const mode=typescript.mode==="strict"?"strict":"fast";return{enabled:true,mode,types:typescript.types||null,target:typescript.target||"es2020",sourcemap:typescript.sourcemap||false}}return null}normalizeEnv(env){if(!env||typeof env!=="object"){return null}const include=Array.isArray(env.include)?env.include.filter(k=>typeof k==="string"):null;if(include&&include.length>0){return{include}}return null}normalizePermissions(permissions){if(!permissions||typeof permissions!=="object"){return null}let defaultPolicy;if(permissions.defaultPolicy==="deny"){defaultPolicy="deny"}else if(permissions.defaultPolicy==="allow"||permissions.defaultPolicy===void 0){defaultPolicy="allow"}else{throw new SlothletError("INVALID_CONFIG",{option:"permissions.defaultPolicy",value:permissions.defaultPolicy,expected:'"allow" or "deny"',hint:"HINT_INVALID_CONFIG"},null,{validationError:true})}const enabled=permissions.enabled!==false;let audit;if(permissions.audit==="verbose"){audit="verbose"}else if(permissions.audit==="default"||permissions.audit===void 0){audit="default"}else if(permissions.audit===true){audit="default"}else if(permissions.audit===false){audit="default"}else{throw new SlothletError("INVALID_CONFIG",{option:"permissions.audit",value:permissions.audit,expected:'"default" or "verbose"',hint:"HINT_INVALID_CONFIG"},null,{validationError:true})}if(permissions.rules!==void 0&&!Array.isArray(permissions.rules)){throw new SlothletError("INVALID_CONFIG",{option:"permissions.rules",value:permissions.rules,expected:"array",hint:"HINT_INVALID_CONFIG"},null,{validationError:true})}const rules=Array.isArray(permissions.rules)?permissions.rules:[];return{defaultPolicy,enabled,audit,rules}}}export{Config};