levix-bot 4.9.1 → 5.0.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 (245) hide show
  1. package/README.md +57 -3
  2. package/SETUP.md +63 -7
  3. package/app.cjs +159 -46
  4. package/deploy/install.sh +10 -5
  5. package/package.json +9 -6
  6. package/public/dashboard/assets/40af6d88b63079a0-BZ8ojJNu.woff2 +0 -0
  7. package/public/dashboard/assets/481acf6760031cee-BypgxfGb.woff2 +0 -0
  8. package/public/dashboard/assets/6d3351fc535f8ef3-D2-eand5.woff2 +0 -0
  9. package/public/dashboard/assets/8ab0af53a3bda9d3-CyCXRvzh.woff2 +0 -0
  10. package/public/dashboard/assets/8f262393e9249e61-TQp-UTiE.woff2 +0 -0
  11. package/public/dashboard/assets/94d65887a83f1282-DmpS2jIq.woff2 +0 -0
  12. package/public/dashboard/assets/99e400330f36ae77-D3oMJlXt.woff2 +0 -0
  13. package/public/dashboard/assets/9d1f41b13e519d90-BVNSOH3d.woff2 +0 -0
  14. package/public/dashboard/assets/a005256cb957ecc7-CoYeBiSI.woff2 +0 -0
  15. package/public/dashboard/assets/b19c2080652a3c2b-DIC32ArD.woff2 +0 -0
  16. package/public/dashboard/assets/c4064400db3750ce-BehTv68k.woff2 +0 -0
  17. package/public/dashboard/assets/c69d345fa1068c2d-CmI34b-g.woff2 +0 -0
  18. package/public/dashboard/assets/cc27b30471250057-6fWv1k7M.woff2 +0 -0
  19. package/public/dashboard/assets/d8c30647abfeffe6-eXO_dkmS.woff2 +0 -0
  20. package/public/dashboard/assets/eb83d8d40af4411f-Buze_B52.woff2 +0 -0
  21. package/public/dashboard/assets/effc6711249e7349-qRpaaN48.woff2 +0 -0
  22. package/public/dashboard/assets/gateway-BDYet0pI.css +1 -0
  23. package/public/dashboard/assets/gateway-BYt6-s1O.js +1 -0
  24. package/public/dashboard/assets/index-B9wFpD_z.css +2 -0
  25. package/public/dashboard/assets/index-DWcQmu0_.js +124 -0
  26. package/public/dashboard/assets/index-Da-j89O-.js +458 -0
  27. package/public/dashboard/font-licenses/jetbrainsmono-OFL.txt +93 -0
  28. package/public/dashboard/font-licenses/plusjakartasans-OFL.txt +93 -0
  29. package/public/dashboard/font-licenses/tajawal-OFL.txt +93 -0
  30. package/public/dashboard/gateway.html +17 -0
  31. package/public/dashboard/index.html +3 -5
  32. package/public/ui-boot.js +33 -14
  33. package/scheduler.cjs +76 -23
  34. package/src/auth/auth-storage.cjs +54 -7
  35. package/src/auth/use-database-auth-state.js +70 -39
  36. package/src/automation/engine.js +412 -0
  37. package/src/automation/limits.cjs +6 -0
  38. package/src/automation/manage.js +290 -0
  39. package/src/automation/reactions.js +471 -0
  40. package/src/automation/rules.cjs +114 -0
  41. package/src/automation/status.cjs +76 -0
  42. package/src/backup/account.cjs +29 -0
  43. package/src/backup/activation.cjs +247 -0
  44. package/src/backup/content.cjs +36 -0
  45. package/src/backup/create.cjs +280 -0
  46. package/src/backup/extensions.cjs +101 -0
  47. package/src/backup/format.cjs +565 -0
  48. package/src/backup/jobs.cjs +111 -0
  49. package/src/backup/journal.cjs +41 -0
  50. package/src/backup/plan.cjs +223 -0
  51. package/src/backup/recovery.cjs +110 -0
  52. package/src/backup/restore.cjs +460 -0
  53. package/src/backup/uploads.cjs +146 -0
  54. package/src/bootstrap/core.js +50 -12
  55. package/src/bootstrap/panel.js +53 -2
  56. package/src/bootstrap/session-startup-policy.js +8 -1
  57. package/src/cli.js +163 -22
  58. package/src/commands/autodelete.cjs +41 -57
  59. package/src/commands/autoschedule.cjs +7 -33
  60. package/src/commands/blacklist.cjs +17 -35
  61. package/src/commands/block.cjs +4 -18
  62. package/src/commands/calc.cjs +22 -74
  63. package/src/commands/debt.cjs +28 -59
  64. package/src/commands/deleteschedule.cjs +7 -23
  65. package/src/commands/digit.cjs +5 -39
  66. package/src/commands/gemini.cjs +135 -218
  67. package/src/commands/group/add.cjs +28 -76
  68. package/src/commands/group/all.cjs +4 -15
  69. package/src/commands/group/antilink.cjs +28 -41
  70. package/src/commands/group/antispam.cjs +25 -35
  71. package/src/commands/group/approveall.cjs +7 -21
  72. package/src/commands/group/clearwarns.cjs +4 -18
  73. package/src/commands/group/deletenote.cjs +4 -18
  74. package/src/commands/group/demote.cjs +6 -23
  75. package/src/commands/group/flagged.cjs +10 -19
  76. package/src/commands/group/kick.cjs +26 -36
  77. package/src/commands/group/media.cjs +21 -36
  78. package/src/commands/group/members.cjs +16 -28
  79. package/src/commands/group/note.cjs +3 -14
  80. package/src/commands/group/policy.cjs +16 -37
  81. package/src/commands/group/promote.cjs +5 -22
  82. package/src/commands/group/removeall.cjs +6 -38
  83. package/src/commands/group/rules.cjs +4 -19
  84. package/src/commands/group/save.cjs +4 -18
  85. package/src/commands/group/setname.cjs +5 -19
  86. package/src/commands/group/setpp.cjs +8 -26
  87. package/src/commands/group/setrules.cjs +4 -15
  88. package/src/commands/group/setwarn.cjs +6 -23
  89. package/src/commands/group/tagadmins.cjs +5 -16
  90. package/src/commands/group/warn.cjs +5 -16
  91. package/src/commands/group/warns.cjs +12 -33
  92. package/src/commands/group/welcome.cjs +17 -34
  93. package/src/commands/group.cjs +91 -68
  94. package/src/commands/help.cjs +48 -89
  95. package/src/commands/lang.cjs +38 -97
  96. package/src/commands/listschedules.cjs +19 -30
  97. package/src/commands/loop.cjs +9 -55
  98. package/src/commands/md.cjs +2 -13
  99. package/src/commands/memory.cjs +53 -87
  100. package/src/commands/mod.cjs +40 -79
  101. package/src/commands/notes.cjs +4 -15
  102. package/src/commands/pack.cjs +26 -49
  103. package/src/commands/packs.cjs +8 -18
  104. package/src/commands/perm.cjs +48 -51
  105. package/src/commands/ping.cjs +2 -10
  106. package/src/commands/poll.cjs +5 -38
  107. package/src/commands/prayer.cjs +55 -36
  108. package/src/commands/qr.cjs +4 -18
  109. package/src/commands/rand.cjs +9 -58
  110. package/src/commands/restart.cjs +15 -33
  111. package/src/commands/schedule.cjs +5 -25
  112. package/src/commands/score.cjs +6 -27
  113. package/src/commands/send.cjs +4 -18
  114. package/src/commands/setprefix.cjs +11 -23
  115. package/src/commands/shortlink.cjs +13 -39
  116. package/src/commands/status.cjs +188 -76
  117. package/src/commands/sticker.cjs +5 -16
  118. package/src/commands/stickers.cjs +16 -20
  119. package/src/commands/stopbot.cjs +9 -25
  120. package/src/commands/stt.cjs +75 -107
  121. package/src/commands/todo.cjs +11 -31
  122. package/src/commands/toimage.cjs +11 -27
  123. package/src/commands/translate.cjs +53 -36
  124. package/src/commands/tts.cjs +46 -40
  125. package/src/commands/unblock.cjs +3 -17
  126. package/src/commands/update.cjs +23 -0
  127. package/src/commands/weather.cjs +40 -47
  128. package/src/config/ai-identity.cjs +14 -1
  129. package/src/config/baileys.config.js +16 -3
  130. package/src/config/data-dir.cjs +37 -0
  131. package/src/config/defaults.cjs +1 -0
  132. package/src/config/exit-codes.cjs +11 -0
  133. package/src/config/lock.cjs +55 -81
  134. package/src/config/official-links.cjs +61 -0
  135. package/src/config/paths.cjs +4 -33
  136. package/src/config/release.cjs +87 -0
  137. package/src/config/settings.cjs +199 -10
  138. package/src/core/connection.js +77 -9
  139. package/src/core/events.js +119 -33
  140. package/src/core/session.js +536 -84
  141. package/src/core/socket.js +81 -10
  142. package/src/db/copy.cjs +136 -0
  143. package/src/db/db.cjs +241 -36
  144. package/src/db/startup-guard.js +5 -0
  145. package/src/db/store.cjs +561 -54
  146. package/src/diagnostics/baileysLog.cjs +87 -0
  147. package/src/diagnostics/debugLog.cjs +16 -4
  148. package/src/diagnostics/device.cjs +4 -2
  149. package/src/diagnostics/nodeRuntime.cjs +131 -0
  150. package/src/diagnostics/signalSessionInspect.cjs +38 -0
  151. package/src/domain/command.js +24 -22
  152. package/src/extensions/autoReply.cjs +521 -0
  153. package/src/extensions/context.cjs +73 -0
  154. package/src/extensions/contract.cjs +69 -0
  155. package/src/extensions/entitlement/client.cjs +381 -0
  156. package/src/extensions/entitlement/index.cjs +629 -0
  157. package/src/extensions/entitlement/installation.cjs +117 -0
  158. package/src/extensions/entitlement/keys.cjs +72 -0
  159. package/src/extensions/entitlement/state.cjs +201 -0
  160. package/src/extensions/entitlement/target.cjs +7 -0
  161. package/src/extensions/entitlement/token.cjs +225 -0
  162. package/src/extensions/host.cjs +519 -0
  163. package/src/extensions/templateKeys.cjs +81 -0
  164. package/src/handlers/command.handler.js +191 -64
  165. package/src/handlers/group.handler.js +78 -18
  166. package/src/handlers/message.handler.js +56 -25
  167. package/src/i18n/catalog.generated.cjs +3537 -0
  168. package/src/index.js +51 -12
  169. package/src/legal/bundled/ar.json +102 -0
  170. package/src/legal/bundled/en.json +102 -0
  171. package/src/legal/bundled/es-419.json +102 -0
  172. package/src/legal/bundled/pt-BR.json +102 -0
  173. package/src/legal/cli.cjs +200 -0
  174. package/src/legal/consent.cjs +187 -0
  175. package/src/legal/document.cjs +156 -0
  176. package/src/legal/keys.cjs +100 -0
  177. package/src/legal/release.cjs +226 -0
  178. package/src/legal/remote.cjs +419 -0
  179. package/src/legal/terms.cjs +142 -0
  180. package/src/messaging/escape.cjs +31 -0
  181. package/src/messaging/health.cjs +65 -0
  182. package/src/messaging/identity.cjs +42 -0
  183. package/src/messaging/message.cjs +136 -0
  184. package/src/messaging/parser.cjs +88 -0
  185. package/src/messaging/router.cjs +217 -0
  186. package/src/middleware/permissions.middleware.js +34 -2
  187. package/src/panel/account-profile.cjs +489 -0
  188. package/src/panel/fallback-page.cjs +177 -0
  189. package/src/panel/password-reset.cjs +13 -14
  190. package/src/panel/recovery-email.cjs +3 -1
  191. package/src/routes/backup.api.esm.js +175 -0
  192. package/src/routes/dashboard.api.esm.js +183 -7
  193. package/src/routes/plus.api.esm.js +172 -0
  194. package/src/routes/reactions.api.esm.js +60 -0
  195. package/src/services/aiAgent.cjs +56 -43
  196. package/src/services/aiDocs.cjs +187 -0
  197. package/src/services/aiImage.cjs +183 -0
  198. package/src/services/aiMedia.cjs +146 -0
  199. package/src/services/aiProviders.cjs +76 -80
  200. package/src/services/aiRouter.cjs +2 -2
  201. package/src/services/aiToolAuth.cjs +76 -4
  202. package/src/services/aiTools.cjs +431 -105
  203. package/src/services/autoDelete.cjs +9 -1
  204. package/src/services/levix-docs.generated.json +2623 -0
  205. package/src/services/memoryPolicy.cjs +56 -0
  206. package/src/services/updateCheck.cjs +362 -0
  207. package/src/stickers/errors.cjs +53 -97
  208. package/src/stickers/library.cjs +13 -6
  209. package/src/stickers/owner.cjs +1 -1
  210. package/src/utils/commandContext.cjs +13 -0
  211. package/src/utils/commandDocs.cjs +42 -20
  212. package/src/utils/geminiHttpOptions.cjs +56 -0
  213. package/src/utils/geminiMedia.cjs +28 -3
  214. package/src/utils/groupMetadataCache.cjs +386 -21
  215. package/src/utils/httpsFetch.cjs +113 -0
  216. package/src/utils/i18n.cjs +117 -7
  217. package/src/utils/linkPreview.cjs +90 -0
  218. package/src/utils/logger.cjs +6 -0
  219. package/src/utils/markdownParser.cjs +3 -3
  220. package/src/utils/memory.cjs +375 -28
  221. package/src/utils/messageContent.cjs +7 -1
  222. package/src/utils/moderationAction.cjs +116 -73
  223. package/src/utils/moderationSummary.cjs +32 -56
  224. package/src/utils/permissionLevel.cjs +7 -28
  225. package/src/utils/permissions.cjs +23 -14
  226. package/src/utils/permissions.esm.js +99 -166
  227. package/src/utils/recentMessageCache.esm.js +241 -37
  228. package/src/utils/recurrence.cjs +78 -66
  229. package/src/utils/sendBotMessage.cjs +14 -29
  230. package/src/utils/sendBotMessage.esm.js +28 -13
  231. package/src/utils/statusMessage.cjs +94 -33
  232. package/src/utils/stickerBot.cjs +18 -16
  233. package/src/utils/storage.cjs +2 -0
  234. package/src/utils/storage.esm.js +2 -0
  235. package/src/utils/thumbnail.cjs +5 -21
  236. package/public/dashboard/assets/index-B1sOW2VX.js +0 -561
  237. package/public/dashboard/assets/index-CK8osB4o.css +0 -2
  238. package/public/dashboard.css +0 -3127
  239. package/public/dashboard.js +0 -1981
  240. package/public/gateway-i18n.js +0 -321
  241. package/public/gateway.js +0 -70
  242. package/views/dashboard.ejs +0 -775
  243. package/views/login.ejs +0 -408
  244. package/views/qr.ejs +0 -155
  245. package/views/setup.ejs +0 -118
@@ -0,0 +1,519 @@
1
+ // Public extension host. Loads one optional Plus module, activates it only
2
+ // while entitlement is live and plus_enabled is on, and isolates every hook.
3
+
4
+ const { createRequire } = require("node:module");
5
+ const fs = require("node:fs");
6
+ const path = require("node:path");
7
+ const { API_VERSION, validateManifest, validateHandlers } = require("./contract.cjs");
8
+ const { isCustomizable, validateOverride } = require("./templateKeys.cjs");
9
+ const { buildContext } = require("./context.cjs");
10
+ const autoReply = require("./autoReply.cjs");
11
+ const { setTemplateOverride } = require("../utils/i18n.cjs");
12
+
13
+ const ACTIVATE_MS = 5000;
14
+ const DEACTIVATE_MS = 5000;
15
+ const CONSIDER_MS = 2000;
16
+ const PANEL_MS = 10_000;
17
+ const POLL_MS = 5000;
18
+ const FAILURE_WINDOW_MS = 60_000;
19
+ const FAILURE_LIMIT = 5;
20
+
21
+ function defaultLoadModule() {
22
+ const file = path.join(
23
+ require("../config/paths.cjs").assetPath(),
24
+ "extensions/levix-plus/index.cjs",
25
+ );
26
+ if (!fs.existsSync(file)) return null;
27
+ return createRequire(file)(file);
28
+ }
29
+
30
+ function withDeadline(promise, ms, abort) {
31
+ return new Promise((resolve, reject) => {
32
+ const timer = setTimeout(() => {
33
+ try {
34
+ abort?.abort();
35
+ } catch {}
36
+ const err = new Error("deadline");
37
+ err.code = "DEADLINE";
38
+ reject(err);
39
+ }, ms);
40
+ Promise.resolve(promise).then(
41
+ (value) => {
42
+ clearTimeout(timer);
43
+ resolve(value);
44
+ },
45
+ (error) => {
46
+ clearTimeout(timer);
47
+ reject(error);
48
+ },
49
+ );
50
+ });
51
+ }
52
+
53
+ function createExtensionHost(opts = {}) {
54
+ const entitlement = opts.entitlement || require("./entitlement/index.cjs");
55
+ const loadModule = opts.loadModule || defaultLoadModule;
56
+ const settingsGet = opts.settingsGet || ((key) => require("../config/settings.cjs").get(key));
57
+ const log = opts.log || require("../utils/logger.cjs");
58
+ const now = opts.now || (() => Date.now());
59
+ const activateTimeoutMs = opts.activateTimeoutMs ?? ACTIVATE_MS;
60
+ const deactivateTimeoutMs = opts.deactivateTimeoutMs ?? DEACTIVATE_MS;
61
+ const considerTimeoutMs = opts.considerTimeoutMs ?? CONSIDER_MS;
62
+ const panelTimeoutMs = opts.panelTimeoutMs ?? PANEL_MS;
63
+ const pollMs = opts.pollMs ?? POLL_MS;
64
+ const failureWindowMs = opts.failureWindowMs ?? FAILURE_WINDOW_MS;
65
+ const failureLimit = opts.failureLimit ?? FAILURE_LIMIT;
66
+
67
+ let state = "absent";
68
+ let generation = 0;
69
+ let running = false;
70
+ let moduleLoaded;
71
+ let incompatible = false;
72
+ let handlers = null;
73
+ let controller = null;
74
+ let scopeSet = new Set();
75
+ let unsub = null;
76
+ let pollTimer = null;
77
+ let chain = Promise.resolve();
78
+ let lastEnabled = null;
79
+ const failures = [];
80
+ let didActivate = false;
81
+ let liveReconcilePending = false;
82
+
83
+ const listeners = new Set();
84
+
85
+ function subscribe(listener) {
86
+ if (typeof listener !== "function") return () => {};
87
+ listeners.add(listener);
88
+ return () => listeners.delete(listener);
89
+ }
90
+
91
+ function setState(next) {
92
+ if (state === next) return;
93
+ state = next;
94
+ for (const listener of listeners) {
95
+ try {
96
+ listener();
97
+ } catch {
98
+ // A listener failure cannot interrupt a state transition.
99
+ }
100
+ }
101
+ }
102
+
103
+ function plusEnabled() {
104
+ try {
105
+ return settingsGet("plus_enabled") !== false;
106
+ } catch {
107
+ return false;
108
+ }
109
+ }
110
+
111
+ function schedule() {
112
+ chain = chain.then(
113
+ () => reconcileNow(),
114
+ () => reconcileNow(),
115
+ );
116
+ return chain;
117
+ }
118
+
119
+ function isActive() {
120
+ if (state !== "active") return false;
121
+ let active = false;
122
+ try {
123
+ active = Boolean(entitlement.isActive?.("plus")) && plusEnabled();
124
+ } catch {}
125
+ if (!active && !liveReconcilePending) {
126
+ liveReconcilePending = true;
127
+ const settled = () => {
128
+ liveReconcilePending = false;
129
+ };
130
+ schedule().then(settled, settled);
131
+ }
132
+ return active;
133
+ }
134
+
135
+ function recordFailure(error) {
136
+ const t = now();
137
+ failures.push(t);
138
+ while (failures.length && t - failures[0] > failureWindowMs) failures.shift();
139
+ try {
140
+ log.warn?.({ err: error?.message || error }, "Plus extension failure");
141
+ } catch {}
142
+ if (failures.length >= failureLimit && state !== "failed") {
143
+ tripFailed();
144
+ }
145
+ }
146
+
147
+ function tripFailed() {
148
+ const wasActive = state === "active" || didActivate;
149
+ setState("failed");
150
+ handlers = null;
151
+ scopeSet = new Set();
152
+ try {
153
+ setTemplateOverride(null);
154
+ } catch {}
155
+ try {
156
+ controller?.abort();
157
+ } catch {}
158
+ didActivate = false;
159
+ if (wasActive && typeof moduleLoaded?.deactivate === "function") {
160
+ Promise.resolve()
161
+ .then(() => withDeadline(moduleLoaded.deactivate("failure"), deactivateTimeoutMs))
162
+ .catch(() => {});
163
+ }
164
+ }
165
+
166
+ function ensureLoaded() {
167
+ if (moduleLoaded) return moduleLoaded;
168
+ if (incompatible) return null;
169
+ try {
170
+ const mod = loadModule();
171
+ if (!mod) return null;
172
+ const check = validateManifest(mod);
173
+ if (!check.ok) {
174
+ incompatible = true;
175
+ setState("incompatible");
176
+ try {
177
+ log.warn?.({ reason: check.reason }, "Plus extension rejected");
178
+ } catch {}
179
+ return null;
180
+ }
181
+ moduleLoaded = mod;
182
+ return mod;
183
+ } catch {
184
+ incompatible = true;
185
+ setState("incompatible");
186
+ try {
187
+ log.warn?.("Plus extension failed to load");
188
+ } catch {}
189
+ return null;
190
+ }
191
+ }
192
+
193
+ function refreshScope() {
194
+ scopeSet = new Set();
195
+ const scopeFn = handlers?.autoReply?.scope;
196
+ if (typeof scopeFn !== "function") return;
197
+ try {
198
+ const value = scopeFn();
199
+ const list = value && typeof value[Symbol.iterator] === "function" ? value : [];
200
+ for (const jid of list) {
201
+ if (typeof jid === "string" && jid) scopeSet.add(jid);
202
+ }
203
+ } catch (error) {
204
+ recordFailure(error);
205
+ }
206
+ }
207
+
208
+ function invalidateScope() {
209
+ autoReply.abortAccountJobs();
210
+ refreshScope();
211
+ }
212
+
213
+ function runtimeView() {
214
+ return {
215
+ isActive,
216
+ generation: () => generation,
217
+ signal: () => controller?.signal,
218
+ getScope: () => scopeSet,
219
+ consider: (event, opts) => handlers?.autoReply?.consider?.(event, opts),
220
+ considerTimeoutMs: () => considerTimeoutMs,
221
+ recordFailure,
222
+ log,
223
+ now,
224
+ };
225
+ }
226
+
227
+ async function activateNow(mod) {
228
+ generation += 1;
229
+ const gen = generation;
230
+ try {
231
+ controller?.abort();
232
+ } catch {}
233
+ controller = new AbortController();
234
+ const ctx = buildContext({
235
+ id: mod.id,
236
+ signal: controller.signal,
237
+ generation: gen,
238
+ capabilities: mod.capabilities,
239
+ log,
240
+ invalidateScope,
241
+ aiReply: (job) =>
242
+ generation === gen
243
+ ? autoReply.runAiReply(runtimeView(), job)
244
+ : Promise.resolve({ sent: false }),
245
+ });
246
+ let returned;
247
+ try {
248
+ returned = await withDeadline(mod.activate(ctx), activateTimeoutMs, controller);
249
+ } catch (error) {
250
+ if (generation !== gen) return;
251
+ try {
252
+ controller.abort();
253
+ } catch {}
254
+ recordFailure(error);
255
+ if (state !== "failed") setState("inactive");
256
+ return;
257
+ }
258
+ if (generation !== gen || !running) return;
259
+ const enabled = plusEnabled();
260
+ if (!enabled || !entitlement.isActive?.("plus")) {
261
+ handlers = returned;
262
+ await deactivate(enabled ? "entitlement" : "disabled");
263
+ return;
264
+ }
265
+ const check = validateHandlers(mod.capabilities, returned);
266
+ if (!check.ok) {
267
+ try {
268
+ controller.abort();
269
+ } catch {}
270
+ recordFailure(check.reason);
271
+ try {
272
+ log.warn?.({ reason: check.reason }, "Plus extension handlers rejected");
273
+ } catch {}
274
+ if (state !== "failed") setState("inactive");
275
+ return;
276
+ }
277
+ handlers = returned;
278
+ refreshScope();
279
+ setTemplateOverride((key, locale) => templateFor(key, locale));
280
+ didActivate = true;
281
+ setState("active");
282
+ }
283
+
284
+ async function deactivate(reason) {
285
+ const mod = moduleLoaded;
286
+ const hadHandlers = Boolean(handlers);
287
+ handlers = null;
288
+ scopeSet = new Set();
289
+ didActivate = false;
290
+ try {
291
+ setTemplateOverride(null);
292
+ } catch {}
293
+ try {
294
+ controller?.abort();
295
+ } catch {}
296
+ if (reason === "disabled") setState("disabled");
297
+ else if (reason === "failure") setState("failed");
298
+ else if (reason === "shutdown") setState(moduleLoaded ? "inactive" : "absent");
299
+ else setState("inactive");
300
+ if (hadHandlers && typeof mod?.deactivate === "function") {
301
+ try {
302
+ await withDeadline(mod.deactivate(reason), deactivateTimeoutMs);
303
+ } catch (error) {
304
+ try {
305
+ log.warn?.({ err: error?.message }, "Plus deactivate failed");
306
+ } catch {}
307
+ }
308
+ }
309
+ }
310
+
311
+ async function reconcileNow() {
312
+ if (!running) return;
313
+ const enabled = plusEnabled();
314
+ const enabledChanged = lastEnabled !== null && lastEnabled !== enabled;
315
+ lastEnabled = enabled;
316
+ if (enabledChanged) {
317
+ failures.length = 0;
318
+ if (state === "failed" && enabled) setState("inactive");
319
+ }
320
+
321
+ if (state === "failed" && enabled) return;
322
+
323
+ const mod = ensureLoaded();
324
+ if (incompatible) return;
325
+ if (!mod) {
326
+ setState("absent");
327
+ return;
328
+ }
329
+
330
+ if (!enabled) {
331
+ if (didActivate || handlers) await deactivate("disabled");
332
+ else setState("disabled");
333
+ return;
334
+ }
335
+
336
+ const entitled = Boolean(entitlement.isActive?.("plus"));
337
+ if (!entitled) {
338
+ if (didActivate || handlers) await deactivate("entitlement");
339
+ else setState("inactive");
340
+ return;
341
+ }
342
+
343
+ if (state === "active" && handlers) return;
344
+ await activateNow(mod);
345
+ }
346
+
347
+ function templateFor(key, locale) {
348
+ if (!isActive() || typeof handlers?.templates?.resolve !== "function") return null;
349
+ if (!isCustomizable(key)) return null;
350
+ try {
351
+ const result = handlers.templates.resolve(key, locale);
352
+ const check = validateOverride(key, result);
353
+ if (!check.ok) return null;
354
+ return result;
355
+ } catch (error) {
356
+ recordFailure(error);
357
+ return null;
358
+ }
359
+ }
360
+
361
+ function hideWatermark(meta) {
362
+ if (!isActive() || typeof handlers?.watermark?.hide !== "function") return false;
363
+ try {
364
+ return handlers.watermark.hide(meta) === true;
365
+ } catch (error) {
366
+ recordFailure(error);
367
+ return false;
368
+ }
369
+ }
370
+
371
+ function hideProgress(meta) {
372
+ if (!isActive() || typeof handlers?.progress?.hide !== "function") return false;
373
+ try {
374
+ return handlers.progress.hide(meta) === true;
375
+ } catch (error) {
376
+ recordFailure(error);
377
+ return false;
378
+ }
379
+ }
380
+
381
+ function dispatchAutoReply(sock, msg, epoch) {
382
+ if (!isActive() || !handlers?.autoReply) return Promise.resolve();
383
+ return autoReply.dispatch(runtimeView(), sock, msg, epoch).catch((error) => {
384
+ try {
385
+ log.error?.({ err: error }, "auto-reply dispatch failed");
386
+ } catch {}
387
+ });
388
+ }
389
+
390
+ async function handlePanel(method, pathName, body, signal) {
391
+ if (!isActive()) return { status: 409, body: { error: "inactive" } };
392
+ if (typeof handlers?.panelApi?.handle !== "function") {
393
+ return { status: 404, body: { error: "not_found" } };
394
+ }
395
+ const requestAbort = new AbortController();
396
+ const combinedSignal = AbortSignal.any(
397
+ [signal, controller?.signal, requestAbort.signal].filter(Boolean),
398
+ );
399
+ try {
400
+ combinedSignal.throwIfAborted();
401
+ const result = await withDeadline(
402
+ handlers.panelApi.handle(method, pathName, body, {
403
+ signal: combinedSignal,
404
+ }),
405
+ panelTimeoutMs,
406
+ requestAbort,
407
+ );
408
+ if (!result || typeof result.status !== "number") {
409
+ return { status: 500, body: { error: "invalid" } };
410
+ }
411
+ return { status: result.status, body: result.body ?? {} };
412
+ } catch (error) {
413
+ recordFailure(error);
414
+ return { status: 500, body: { error: "failed" } };
415
+ }
416
+ }
417
+
418
+ function accountReset(reason) {
419
+ const allowed =
420
+ reason === "logged_out" || reason === "restore" || reason === "unlink" ? reason : "unlink";
421
+ try {
422
+ autoReply.abortAccountJobs();
423
+ } catch {}
424
+ const id = moduleLoaded?.id || "levix-plus";
425
+ require("../db/store.cjs").wipeExtStorage(id, "acct");
426
+ try {
427
+ if (typeof moduleLoaded?.onAccountReset === "function") moduleLoaded.onAccountReset(allowed);
428
+ } catch (error) {
429
+ try {
430
+ log.warn?.({ err: error?.message }, "Plus onAccountReset failed");
431
+ } catch {}
432
+ }
433
+ }
434
+
435
+ function start() {
436
+ if (!running) {
437
+ running = true;
438
+ try {
439
+ unsub = entitlement.subscribe?.(() => {
440
+ schedule();
441
+ });
442
+ } catch {}
443
+ pollTimer = setInterval(() => schedule(), Math.max(1000, pollMs));
444
+ pollTimer.unref?.();
445
+ }
446
+ return schedule();
447
+ }
448
+
449
+ async function stop() {
450
+ running = false;
451
+ try {
452
+ if (typeof unsub === "function") unsub();
453
+ } catch {}
454
+ unsub = null;
455
+ if (pollTimer) {
456
+ clearInterval(pollTimer);
457
+ pollTimer = null;
458
+ }
459
+ if (didActivate || handlers) await deactivate("shutdown");
460
+ else {
461
+ try {
462
+ controller?.abort();
463
+ } catch {}
464
+ try {
465
+ setTemplateOverride(null);
466
+ } catch {}
467
+ }
468
+ }
469
+
470
+ // Re-read stored config (a restore changed it): stop, then start, through the
471
+ // normal lifecycle. Does nothing when the host is not running. One at a time.
472
+ let reloading = null;
473
+ function reload() {
474
+ if (!running) return Promise.resolve(false);
475
+ if (!reloading) {
476
+ reloading = (async () => {
477
+ await stop();
478
+ await start();
479
+ return true;
480
+ })().finally(() => {
481
+ reloading = null;
482
+ });
483
+ }
484
+ return reloading;
485
+ }
486
+
487
+ return {
488
+ start,
489
+ stop,
490
+ reload,
491
+ subscribe,
492
+ status() {
493
+ return { state, generation };
494
+ },
495
+ accountReset,
496
+ templateFor,
497
+ hideWatermark,
498
+ hideProgress,
499
+ dispatchAutoReply,
500
+ handlePanel,
501
+ generation() {
502
+ return generation;
503
+ },
504
+ };
505
+ }
506
+
507
+ const host = createExtensionHost();
508
+
509
+ function reloadExtensions() {
510
+ return host.reload();
511
+ }
512
+
513
+ module.exports = {
514
+ API_VERSION,
515
+ createExtensionHost,
516
+ host,
517
+ reloadExtensions,
518
+ defaultLoadModule,
519
+ };
@@ -0,0 +1,81 @@
1
+ // Which bot.* catalog keys Plus may rewrite. English string entries only;
2
+ // plural objects are never customizable.
3
+
4
+ const catalog = require("../i18n/catalog.generated.cjs");
5
+ const { hasForbiddenChars } = require("../messaging/escape.cjs");
6
+
7
+ const ALLOWED_AREAS = new Set(["ai", "core", "schedules", "stickers", "tools", "help", "group"]);
8
+ const CORE_ALLOWED = new Set(["status", "restart", "stopbot"]);
9
+ const DENY_RE =
10
+ /owner(Only)?|noPermission|denied|forbidden|notAllowed|permission|security|password|reset|consent|legal|terms|privacy|route|unauthori|blocked|warn|kick|ban|flag|limit/i;
11
+
12
+ const PLACEHOLDER_RE = /\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
13
+ const MAX_OVERRIDE_CHARS = 1000;
14
+
15
+ function englishValue(key) {
16
+ return catalog.messages?.en?.[key];
17
+ }
18
+
19
+ function isCustomizable(key) {
20
+ if (typeof key !== "string" || !key.startsWith("bot.")) return false;
21
+ if (typeof englishValue(key) !== "string") return false;
22
+ if (key.startsWith("bot.moderation.")) return false;
23
+ if (key.startsWith("bot.core.message.")) return false;
24
+ if (DENY_RE.test(key)) return false;
25
+ const parts = key.split(".");
26
+ const area = parts[1];
27
+ if (!ALLOWED_AREAS.has(area)) return false;
28
+ if (area === "core" && !CORE_ALLOWED.has(parts[2])) return false;
29
+ return true;
30
+ }
31
+
32
+ let cachedKeys = null;
33
+ function customizableKeys() {
34
+ if (!cachedKeys) {
35
+ cachedKeys = Object.freeze(
36
+ Object.keys(catalog.messages?.en || {}).filter((key) => isCustomizable(key)),
37
+ );
38
+ }
39
+ return cachedKeys;
40
+ }
41
+
42
+ function placeholders(key) {
43
+ const value = englishValue(key);
44
+ if (typeof value !== "string") return [];
45
+ const names = [];
46
+ const seen = new Set();
47
+ for (const match of value.matchAll(PLACEHOLDER_RE)) {
48
+ if (!seen.has(match[1])) {
49
+ seen.add(match[1]);
50
+ names.push(match[1]);
51
+ }
52
+ }
53
+ return names;
54
+ }
55
+
56
+ function catalogTemplate(key, locale) {
57
+ const messages = catalog.messages || {};
58
+ const value = messages[locale]?.[key] ?? messages.en?.[key];
59
+ return typeof value === "string" ? value : null;
60
+ }
61
+
62
+ function validateOverride(key, text) {
63
+ if (!isCustomizable(key)) return { ok: false, reason: "key" };
64
+ if (typeof text !== "string") return { ok: false, reason: "type" };
65
+ if (text.length > MAX_OVERRIDE_CHARS) return { ok: false, reason: "length" };
66
+ if (hasForbiddenChars(text)) return { ok: false, reason: "chars" };
67
+ const allowed = new Set(placeholders(key));
68
+ for (const match of text.matchAll(PLACEHOLDER_RE)) {
69
+ if (!allowed.has(match[1])) return { ok: false, reason: "placeholder" };
70
+ }
71
+ return { ok: true };
72
+ }
73
+
74
+ module.exports = {
75
+ isCustomizable,
76
+ customizableKeys,
77
+ placeholders,
78
+ catalogTemplate,
79
+ validateOverride,
80
+ MAX_OVERRIDE_CHARS,
81
+ };