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,56 @@
1
+ // Server-owned global memory grants. Caller identity comes only from aiToolAuth;
2
+ // settings are read on every check, including immediately before a tool writes.
3
+ const settings = require("../config/settings.cjs");
4
+ const { isCurrentCaller } = require("./aiToolAuth.cjs");
5
+ const { sameUserSync } = require("../utils/permissions.cjs");
6
+
7
+ function globalMemoryAccess(context = {}) {
8
+ const caller = context?.caller;
9
+ if (!isCurrentCaller(caller) || !caller.chatId) {
10
+ return Object.freeze({ read: false, write: false });
11
+ }
12
+ // Auto Reply may only read global memory. It skips the linked account's own
13
+ // messages, so no owner can be the sender, and a write grant would only let
14
+ // external senders steer what the AI saves.
15
+ if (context.memoryScope === "chat") {
16
+ return Object.freeze({ read: context.autoReplyGlobal?.read === true, write: false });
17
+ }
18
+
19
+ const where = settings.get("ai_global_memory_where");
20
+ const allowedHere =
21
+ where === "all" ||
22
+ (!caller.isGroup &&
23
+ (where === "private" ||
24
+ (where === "own_chat" && caller.candidates.some((id) => sameUserSync(caller.chatId, id)))));
25
+ const permits = (value) =>
26
+ allowedHere &&
27
+ (value === "everyone" ||
28
+ (value === "owner" && caller.isOwner) ||
29
+ (value === "privileged" && (caller.isOwner || caller.isBotAdmin)));
30
+
31
+ return Object.freeze({
32
+ read: permits(settings.get("ai_global_memory_read")),
33
+ write: permits(settings.get("ai_global_memory_write")),
34
+ });
35
+ }
36
+
37
+ const MEMORY_TOOLS = new Set(["search_memory", "save_memory", "forget_memory", "summarize_chat"]);
38
+
39
+ function stripMemoryToolParts(history) {
40
+ if (!Array.isArray(history)) return [];
41
+ return history.flatMap((entry) => {
42
+ if (!Array.isArray(entry?.parts)) return [];
43
+ // Text alongside a tool call was intermediate output, never a chat reply.
44
+ const intermediate = entry.role === "model" && entry.parts.some((part) => part?.functionCall);
45
+ const parts = entry.parts.filter(
46
+ (part) =>
47
+ part?.thought !== true &&
48
+ !(intermediate && typeof part?.text === "string") &&
49
+ !MEMORY_TOOLS.has(part?.functionCall?.name) &&
50
+ !MEMORY_TOOLS.has(part?.functionResponse?.name),
51
+ );
52
+ return parts.length ? [{ ...entry, parts }] : [];
53
+ });
54
+ }
55
+
56
+ module.exports = { globalMemoryAccess, stripMemoryToolParts };
@@ -0,0 +1,362 @@
1
+ // src/services/updateCheck.cjs
2
+ // Update checker service for Phase 09.
3
+ //
4
+ // Detects channel (Google Play vs GitHub releases), performs strict SemVer
5
+ // comparison, bounds network streams and deadlines, caches public metadata
6
+ // in RAM with promise coalescing, and ensures zero startup requests.
7
+
8
+ const { LINKS, safeOfficialUrl, releaseDetailUrl } = require("../config/official-links.cjs");
9
+ const logger = require("../utils/logger.cjs");
10
+
11
+ const GITHUB_RELEASES_URL = "https://api.github.com/repos/Abdodiab2005/levix/releases?per_page=10";
12
+ const GITHUB_LATEST_URL = "https://api.github.com/repos/Abdodiab2005/levix/releases/latest";
13
+ const SUCCESS_TTL_MS = 15 * 60 * 1000; // 15 minutes
14
+ const ERROR_TTL_MS = 60 * 1000; // 1 minute
15
+ const TIMEOUT_MS = 8000; // 8 seconds maximum for request + body
16
+ const MAX_RESPONSE_BYTES = 1024 * 1024; // Includes GitHub's asset metadata, never asset bytes.
17
+ const MAX_RELEASE_NOTES_LENGTH = 6000; // 6000 characters plain text
18
+
19
+ function packageVersion() {
20
+ return String(require("../../package.json").version);
21
+ }
22
+
23
+ /**
24
+ * Determines installation channel:
25
+ * Play ONLY when LEVIX_ANDROID === '1' and argv has '--levix-play-install'.
26
+ * Internal native boot fact, not a database setting.
27
+ */
28
+ function getInstallChannel(env = process.env, argv = process.argv) {
29
+ if (env?.LEVIX_ANDROID === "1" && Array.isArray(argv) && argv.includes("--levix-play-install")) {
30
+ return "play";
31
+ }
32
+ return "github";
33
+ }
34
+
35
+ const SEMVER_REGEX =
36
+ /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
37
+
38
+ /**
39
+ * Strictly parses a SemVer string. Accepts an optional leading 'v' tag prefix.
40
+ */
41
+ function parseSemVer(versionString) {
42
+ if (typeof versionString !== "string") return null;
43
+ if (versionString.length > 128) return null;
44
+ const normalized = versionString.replace(/^v/, "");
45
+ const match = normalized.match(SEMVER_REGEX);
46
+ if (!match) return null;
47
+
48
+ return {
49
+ raw: versionString,
50
+ major: BigInt(match[1]),
51
+ minor: BigInt(match[2]),
52
+ patch: BigInt(match[3]),
53
+ prerelease: match[4] ? match[4].split(".") : null,
54
+ build: match[5] ? match[5].split(".") : null,
55
+ };
56
+ }
57
+
58
+ /**
59
+ * Compares two SemVer representations (objects or strings) per SemVer 2.0.0 rules:
60
+ * Returns 1 if a > b, -1 if a < b, 0 if equal.
61
+ * Build metadata is ignored in precedence.
62
+ */
63
+ function compareSemVer(a, b) {
64
+ const vA = typeof a === "string" ? parseSemVer(a) : a;
65
+ const vB = typeof b === "string" ? parseSemVer(b) : b;
66
+ if (!vA || !vB) throw new Error("Invalid SemVer comparison operands");
67
+
68
+ if (vA.major !== vB.major) return vA.major > vB.major ? 1 : -1;
69
+ if (vA.minor !== vB.minor) return vA.minor > vB.minor ? 1 : -1;
70
+ if (vA.patch !== vB.patch) return vA.patch > vB.patch ? 1 : -1;
71
+
72
+ if (!vA.prerelease && !vB.prerelease) return 0;
73
+ if (!vA.prerelease && vB.prerelease) return 1;
74
+ if (vA.prerelease && !vB.prerelease) return -1;
75
+
76
+ const len = Math.max(vA.prerelease.length, vB.prerelease.length);
77
+ for (let i = 0; i < len; i++) {
78
+ if (i >= vA.prerelease.length) return -1;
79
+ if (i >= vB.prerelease.length) return 1;
80
+
81
+ const partA = vA.prerelease[i];
82
+ const partB = vB.prerelease[i];
83
+ if (partA === partB) continue;
84
+
85
+ const numA = /^\d+$/.test(partA);
86
+ const numB = /^\d+$/.test(partB);
87
+
88
+ if (numA && numB) {
89
+ const nA = BigInt(partA);
90
+ const nB = BigInt(partB);
91
+ if (nA !== nB) return nA > nB ? 1 : -1;
92
+ } else if (numA && !numB) {
93
+ return -1;
94
+ } else if (!numA && numB) {
95
+ return 1;
96
+ } else {
97
+ return partA > partB ? 1 : -1;
98
+ }
99
+ }
100
+
101
+ return 0;
102
+ }
103
+
104
+ /**
105
+ * Checks if a candidate release is eligible for the current installation:
106
+ * - Stable installations never receive prereleases.
107
+ * - Prerelease installations can receive newer same-base prereleases OR stable/newer releases.
108
+ */
109
+ function isEligibleCandidate(candidate, current) {
110
+ const vCand = typeof candidate === "string" ? parseSemVer(candidate) : candidate;
111
+ const vCurr = typeof current === "string" ? parseSemVer(current) : current;
112
+ if (!vCand || !vCurr) return false;
113
+
114
+ if (compareSemVer(vCand, vCurr) <= 0) return false;
115
+
116
+ if (!vCurr.prerelease) {
117
+ return !vCand.prerelease;
118
+ }
119
+
120
+ if (!vCand.prerelease) return true;
121
+
122
+ return vCand.major === vCurr.major && vCand.minor === vCurr.minor && vCand.patch === vCurr.patch;
123
+ }
124
+
125
+ /**
126
+ * Sanitizes plain-text release notes to at most 6000 characters.
127
+ */
128
+ function sanitizeReleaseNotes(body) {
129
+ if (typeof body !== "string") return null;
130
+ const cleaned = body.replace(/\p{Cc}/gu, (char) => ("\t\r\n".includes(char) ? char : "")).trim();
131
+ if (!cleaned) return null;
132
+ if (cleaned.length > MAX_RELEASE_NOTES_LENGTH) {
133
+ return cleaned.slice(0, MAX_RELEASE_NOTES_LENGTH);
134
+ }
135
+ return cleaned;
136
+ }
137
+
138
+ /**
139
+ * Reads a response body safely with a maximum byte limit and abortion check.
140
+ */
141
+ async function fetchReleases(fetchImpl, timeoutMs = TIMEOUT_MS, url = GITHUB_RELEASES_URL) {
142
+ const controller = new AbortController();
143
+ let reader;
144
+ let timer;
145
+ const deadline = new Promise((_, reject) => {
146
+ timer = setTimeout(() => {
147
+ controller.abort();
148
+ reject(new Error("Update check timed out"));
149
+ }, timeoutMs);
150
+ });
151
+ const request = async () => {
152
+ const res = await fetchImpl(url, {
153
+ headers: { Accept: "application/vnd.github+json", "User-Agent": "Levix-UpdateCheck" },
154
+ redirect: "error",
155
+ signal: controller.signal,
156
+ });
157
+ if (res.url && res.url !== url) throw new Error("Invalid response URL");
158
+ if (res.status === 404 && url === GITHUB_LATEST_URL) return [];
159
+ if (!res.ok) throw new Error("Invalid response");
160
+ if (!(res.headers.get("content-type") || "").toLowerCase().includes("application/json")) {
161
+ throw new Error("Invalid content type");
162
+ }
163
+ const length = res.headers.get("content-length");
164
+ if (length && (!/^\d+$/.test(length) || Number(length) > MAX_RESPONSE_BYTES)) {
165
+ throw new Error("Response too large");
166
+ }
167
+ if (!res.body?.getReader) throw new Error("Missing response stream");
168
+ reader = res.body.getReader();
169
+ const chunks = [];
170
+ let size = 0;
171
+ while (true) {
172
+ controller.signal.throwIfAborted();
173
+ const { done, value } = await reader.read();
174
+ if (done) break;
175
+ size += value.byteLength;
176
+ if (size > MAX_RESPONSE_BYTES) throw new Error("Response too large");
177
+ chunks.push(value);
178
+ }
179
+ const data = JSON.parse(Buffer.concat(chunks).toString("utf8"));
180
+ if (url === GITHUB_LATEST_URL) {
181
+ if (!data || Array.isArray(data) || typeof data.tag_name !== "string")
182
+ throw new Error("Invalid latest release");
183
+ return [data];
184
+ }
185
+ if (!Array.isArray(data) || data.length > 10) throw new Error("Invalid releases payload");
186
+ return data;
187
+ };
188
+ try {
189
+ return await Promise.race([request(), deadline]);
190
+ } finally {
191
+ clearTimeout(timer);
192
+ controller.abort();
193
+ try {
194
+ reader?.cancel().catch(() => {});
195
+ } catch {}
196
+ try {
197
+ reader?.releaseLock();
198
+ } catch {}
199
+ }
200
+ }
201
+
202
+ /**
203
+ * Creates an update checker instance with deterministic dependencies for testing.
204
+ */
205
+ function createUpdateChecker(options = {}) {
206
+ const fetchImpl = options.fetchImpl || globalThis.fetch;
207
+ const now = typeof options.now === "function" ? options.now : Date.now;
208
+ const version = options.version ?? packageVersion();
209
+ const channelOption = options.channel !== undefined ? options.channel : getInstallChannel;
210
+
211
+ let cache = null; // { result, expiresAt }
212
+ let inFlightPromise = null;
213
+
214
+ async function doCheck() {
215
+ const currentChannel = typeof channelOption === "function" ? channelOption() : channelOption;
216
+ const currentVersion = String(version);
217
+
218
+ if (currentChannel === "play") {
219
+ return {
220
+ channel: "play",
221
+ status: "play",
222
+ currentVersion,
223
+ latestVersion: null,
224
+ url: LINKS.play,
225
+ releaseNotes: null,
226
+ };
227
+ }
228
+
229
+ const currentSemVer = parseSemVer(currentVersion);
230
+ if (!currentSemVer) {
231
+ return {
232
+ channel: "github",
233
+ status: "unavailable",
234
+ currentVersion,
235
+ latestVersion: null,
236
+ url: LINKS.releases,
237
+ releaseNotes: null,
238
+ };
239
+ }
240
+
241
+ try {
242
+ const timeout = Math.min(TIMEOUT_MS, Math.max(1, options.timeoutMs ?? TIMEOUT_MS));
243
+ const [stable, previews] = await Promise.all([
244
+ fetchReleases(fetchImpl, timeout, GITHUB_LATEST_URL),
245
+ currentSemVer.prerelease ? fetchReleases(fetchImpl, timeout) : Promise.resolve([]),
246
+ ]);
247
+ const releases = [...stable, ...previews];
248
+ const eligible = [];
249
+
250
+ for (const item of releases) {
251
+ if (!item || typeof item !== "object") continue;
252
+ if (item.draft === true) continue;
253
+ if (typeof item.tag_name !== "string") continue;
254
+
255
+ const tag = item.tag_name;
256
+ const candidateSemVer = parseSemVer(tag);
257
+ if (!candidateSemVer) continue;
258
+
259
+ const trustedUrl = releaseDetailUrl(tag);
260
+ if (!trustedUrl || !safeOfficialUrl(trustedUrl)) continue;
261
+ if (item.html_url !== trustedUrl) continue;
262
+ if (typeof item.draft !== "boolean" || typeof item.prerelease !== "boolean") continue;
263
+ if (item.prerelease !== Boolean(candidateSemVer.prerelease)) continue;
264
+
265
+ if (!isEligibleCandidate(candidateSemVer, currentSemVer)) continue;
266
+
267
+ eligible.push({
268
+ semver: candidateSemVer,
269
+ version: candidateSemVer.raw.replace(/^[vV]/, ""),
270
+ url: trustedUrl,
271
+ releaseNotes: sanitizeReleaseNotes(item.body),
272
+ });
273
+ }
274
+
275
+ if (eligible.length === 0) {
276
+ if (previews.length === 10) throw new Error("Preview channel scan incomplete");
277
+ return {
278
+ channel: "github",
279
+ status: "up_to_date",
280
+ currentVersion,
281
+ latestVersion: null,
282
+ url: LINKS.releases,
283
+ releaseNotes: null,
284
+ };
285
+ }
286
+
287
+ eligible.sort((a, b) => compareSemVer(b.semver, a.semver));
288
+ const best = eligible[0];
289
+
290
+ return {
291
+ channel: "github",
292
+ status: "available",
293
+ currentVersion,
294
+ latestVersion: best.version,
295
+ url: best.url,
296
+ releaseNotes: best.releaseNotes,
297
+ };
298
+ } catch (err) {
299
+ logger.debug?.("[updateCheck] Official release metadata unavailable");
300
+ return {
301
+ channel: "github",
302
+ status: "unavailable",
303
+ currentVersion,
304
+ latestVersion: null,
305
+ url: LINKS.releases,
306
+ releaseNotes: null,
307
+ };
308
+ }
309
+ }
310
+
311
+ async function checkForUpdates() {
312
+ const currentTime = now();
313
+ if (cache && currentTime < cache.expiresAt) {
314
+ return cache.result;
315
+ }
316
+
317
+ if (inFlightPromise) {
318
+ return inFlightPromise;
319
+ }
320
+
321
+ inFlightPromise = (async () => {
322
+ try {
323
+ const result = await doCheck();
324
+ const isError = result.status === "unavailable";
325
+ const ttl = isError ? ERROR_TTL_MS : SUCCESS_TTL_MS;
326
+ cache = {
327
+ result: Object.freeze(result),
328
+ expiresAt: now() + ttl,
329
+ };
330
+ return result;
331
+ } finally {
332
+ inFlightPromise = null;
333
+ }
334
+ })();
335
+
336
+ return inFlightPromise;
337
+ }
338
+
339
+ return { checkForUpdates };
340
+ }
341
+
342
+ const defaultChecker = createUpdateChecker();
343
+ function checkForUpdates() {
344
+ return defaultChecker.checkForUpdates();
345
+ }
346
+
347
+ module.exports = {
348
+ createUpdateChecker,
349
+ checkForUpdates,
350
+ getInstallChannel,
351
+ parseSemVer,
352
+ compareSemVer,
353
+ isEligibleCandidate,
354
+ sanitizeReleaseNotes,
355
+ GITHUB_RELEASES_URL,
356
+ GITHUB_LATEST_URL,
357
+ SUCCESS_TTL_MS,
358
+ ERROR_TTL_MS,
359
+ TIMEOUT_MS,
360
+ MAX_RESPONSE_BYTES,
361
+ MAX_RELEASE_NOTES_LENGTH,
362
+ };
@@ -3,11 +3,12 @@
3
3
  // Every failure a person can see is a StickerError with a code from CODES.
4
4
  // The panel API answers `{ error, code, ...details }` with the status below and
5
5
  // the dashboard translates the code; a bot command replies with userMessage(),
6
- // which goes through tr() so it follows the reply language of the message.
6
+ // which reads the catalog through t() so it follows the reply language of the
7
+ // message.
7
8
  // Internal detail (ffmpeg stderr, paths) belongs in `cause` and the log, never
8
9
  // in `message` or `details`.
9
10
 
10
- const { tr } = require("../utils/i18n.cjs");
11
+ const { t, withLang, currentLang } = require("../utils/i18n.cjs");
11
12
  const { isolate } = require("../utils/bidi.cjs");
12
13
 
13
14
  const CODES = Object.freeze({
@@ -90,137 +91,92 @@ function toResponseBody(error) {
90
91
  }
91
92
 
92
93
  function userMessageIn(lang, error) {
93
- const pick = (en, ar) => (lang === "ar" ? ar : en);
94
- return message(pick, error);
94
+ // withLang is what forces the catalog onto `lang`; only "en" is used today.
95
+ return withLang(lang, () => message(error));
95
96
  }
96
97
 
97
98
  /** A reply for the person who sent the command, in the language of that message. */
98
99
  function userMessage(error) {
99
- return message(tr, error);
100
+ return message(error);
100
101
  }
101
102
 
102
- function message(pick, error) {
103
+ function message(error) {
103
104
  const d = (isStickerError(error) && error.details) || {};
104
105
  switch (isStickerError(error) ? error.code : "INTERNAL") {
105
106
  case "NO_MEDIA":
106
- return pick(
107
- "Send or reply to an image, GIF, video or sticker.",
108
- "أرسل صورة أو صورة متحركة أو فيديو أو ملصقًا، أو رد على واحد منها.",
109
- );
107
+ return t("bot.stickers.errors.noMedia");
110
108
  case "UNSUPPORTED_TYPE":
111
- return pick(
112
- "That file type can't be made into a sticker. Use a JPEG, PNG, WebP, GIF or MP4/WebM video.",
113
- "لا يمكن تحويل هذا النوع من الملفات إلى ملصق. استخدم صورة JPEG أو PNG أو WebP أو GIF أو فيديو MP4/WebM.",
114
- );
109
+ return t("bot.stickers.errors.unsupportedType");
115
110
  case "TOO_LARGE":
116
111
  if (d.limitFrames) {
117
- return pick(
118
- `The animation has too many frames (limit ${d.limitFrames}).`,
119
- `في الرسم المتحرك إطارات كثيرة جدًا (الحد ${d.limitFrames}).`,
120
- );
112
+ return t("bot.stickers.errors.tooManyFrames", { limitFrames: d.limitFrames });
121
113
  }
122
- return pick(
123
- `The file is too large (limit ${formatMb(d.limitBytes)}).`,
124
- `الملف كبير جدًا (الحد ${formatMb(d.limitBytes)}).`,
125
- );
114
+ return t("bot.stickers.errors.tooLarge", { limitMb: formatMb(d.limitBytes) });
126
115
  case "DIMENSIONS_TOO_LARGE":
127
- return pick(
128
- `The image is too large (limit ${d.limit || 4096} px per side).`,
129
- `أبعاد الصورة كبيرة جدًا (الحد ${d.limit || 4096} بكسل لكل ضلع).`,
130
- );
116
+ return t("bot.stickers.errors.dimensionsTooLarge", { limit: d.limit || 4096 });
131
117
  case "VIDEO_TOO_LONG":
132
- return pick(
133
- `The video is too long (limit ${d.limitSeconds || 10} seconds). Send a shorter clip, or trim it in the panel's Sticker Studio.`,
134
- `الفيديو طويل جدًا (الحد ${secondsAr(d.limitSeconds || 10)}). أرسل مقطعًا أقصر، أو اقتطع جزءًا منه في استوديو الملصقات في لوحة التحكم.`,
135
- );
118
+ return videoTooLong(d.limitSeconds);
136
119
  case "CORRUPT":
137
- return pick(
138
- "The file is damaged or incomplete, so it can't be read.",
139
- "الملف تالف أو غير مكتمل، ولا يمكن قراءته.",
140
- );
120
+ return t("bot.stickers.errors.corrupt");
141
121
  case "CONVERSION_FAILED":
142
- return pick(
143
- "The sticker could not be created from this file.",
144
- "تعذّر إنشاء ملصق من هذا الملف.",
145
- );
122
+ return t("bot.stickers.errors.conversionFailed");
146
123
  case "OUTPUT_TOO_LARGE":
147
- return pick(
148
- "Even at the lowest quality the sticker is over WhatsApp's size limit. Try a shorter or simpler clip.",
149
- "حجم الملصق يتجاوز حد واتساب حتى بأقل جودة. جرّب مقطعًا أقصر أو أبسط.",
150
- );
124
+ return t("bot.stickers.errors.outputTooLarge");
151
125
  case "ENCODER_MISSING":
152
- return pick(
153
- "This Levix build can't encode stickers (its FFmpeg has no WebP encoder). Update Levix.",
154
- "لا يستطيع إصدار Levix هذا ترميز الملصقات (أداة FFmpeg فيه بلا مرمّز WebP). حدّث Levix.",
155
- );
126
+ return t("bot.stickers.errors.encoderMissing");
156
127
  case "TIMEOUT":
157
- return pick(
158
- "The conversion took too long and was stopped.",
159
- "استغرق التحويل وقتًا طويلًا فأُوقف.",
160
- );
128
+ return t("bot.stickers.errors.timeout");
161
129
  case "BUSY":
162
- return pick(
163
- "Levix is converting other stickers right now. Try again in a moment.",
164
- "يحوّل Levix ملصقات أخرى الآن. حاول مرة أخرى بعد قليل.",
165
- );
130
+ return t("bot.stickers.errors.busy");
166
131
  case "NOT_FOUND":
167
- return pick("That sticker is not in your library.", "هذا الملصق غير موجود في مكتبتك.");
132
+ return t("bot.stickers.errors.notFound");
168
133
  case "PACK_NOT_FOUND":
169
- return pick(
170
- `There is no pack named "${isolate(d.name || "")}".`,
171
- `لا توجد حزمة باسم "${isolate(d.name || "")}".`,
172
- );
134
+ return t("bot.stickers.errors.packNotFound", { name: isolate(d.name || "") });
173
135
  case "PACK_EXISTS":
174
- return pick(
175
- `A pack named "${isolate(d.name || "")}" already exists.`,
176
- `توجد حزمة باسم "${isolate(d.name || "")}" بالفعل.`,
177
- );
136
+ return t("bot.stickers.errors.packExists", { name: isolate(d.name || "") });
178
137
  case "INVALID_NAME":
179
- return pick(
180
- "Pack names are 1–40 characters: letters, digits, spaces, - _ ' . & , or emoji, and can't be a command word.",
181
- "اسم الحزمة من 1 إلى 40 حرفًا: حروف أو أرقام أو مسافات أو - _ ' . & , أو رموز تعبيرية، ولا يجوز أن يكون كلمة أمر.",
182
- );
138
+ return t("bot.stickers.errors.invalidName");
183
139
  case "INVALID_OPTIONS":
184
- return pick("Those sticker options are not valid.", "خيارات الملصق هذه غير صالحة.");
140
+ return t("bot.stickers.errors.invalidOptions");
185
141
  case "LIBRARY_FULL":
186
- return pick(
187
- `Your sticker library is full (${d.limit || 0} stickers). Delete some first.`,
188
- `مكتبة ملصقاتك ممتلئة (${d.limit || 0} ملصق). احذف بعضها أولًا.`,
189
- );
142
+ return t("bot.stickers.errors.libraryFull", { limit: d.limit || 0 });
190
143
  case "PACK_LIMIT":
191
- return pick(
192
- `You can have at most ${d.limit || 0} packs.`,
193
- `الحد الأقصى لعدد الحزم ${d.limit || 0}.`,
194
- );
144
+ return t("bot.stickers.errors.packLimit", { limit: d.limit || 0 });
195
145
  case "IN_USE":
196
- return pick(
197
- "This sticker is in one or more packs. Confirm to delete it everywhere.",
198
- "هذا الملصق موجود في حزمة أو أكثر. أكّد لحذفه من كل مكان.",
199
- );
146
+ return t("bot.stickers.errors.inUse");
200
147
  case "STORAGE_UNAVAILABLE":
201
- return pick(
202
- "The sticker library can't be written right now.",
203
- "لا يمكن الكتابة في مكتبة الملصقات الآن.",
204
- );
148
+ return t("bot.stickers.errors.storageUnavailable");
205
149
  case "NOT_CONNECTED":
206
- return pick(
207
- "WhatsApp is not connected, so nothing can be sent.",
208
- "واتساب غير متصل، فلا يمكن إرسال شيء.",
209
- );
150
+ return t("bot.stickers.errors.notConnected");
210
151
  case "CANCELLED":
211
- return pick("The conversion was cancelled.", "أُلغي التحويل.");
152
+ return t("bot.stickers.errors.cancelled");
212
153
  default:
213
- return pick("Something went wrong with the sticker.", "حدث خطأ في الملصق.");
154
+ return t("bot.stickers.errors.internal");
214
155
  }
215
156
  }
216
157
 
217
- // Arabic counts agree with the number: 3–10 take the plural, 11 and up the
218
- // singular accusative.
219
- function secondsAr(n) {
220
- if (n === 1) return "ثانية واحدة";
221
- if (n === 2) return "ثانيتان";
222
- if (n >= 3 && n <= 10) return `${n} ثوانٍ`;
223
- return `${n} ثانية`;
158
+ // The old Arabic phrase is "few" only for 3 through 10. CLDR "few" also covers
159
+ // 103 and 203, so the count passed to t() is a number in the category that
160
+ // matches the old phrase. {n} is the number shown. Arabic for 1 and 2 has no
161
+ // digit. Every category still contains {n}, so those two pass an empty {n}.
162
+ // The sentence already has one space before that token. -1 and -2 are CLDR
163
+ // one and two, but the old phrase uses the leftover form for them.
164
+ function secondsPluralCount(n) {
165
+ if (n === 1 || n === 2 || n === 0) return n;
166
+ if (n >= 3 && n <= 10) return 3;
167
+ const mod = Math.abs(n % 100);
168
+ if (mod >= 3 && mod <= 10) return 11;
169
+ if (!Number.isFinite(n) || n === -1 || n === -2) return 100;
170
+ return n;
171
+ }
172
+
173
+ function videoTooLong(limitSeconds) {
174
+ const n = limitSeconds || 10;
175
+ const bare = currentLang() === "ar" && (n === 1 || n === 2);
176
+ return t("bot.stickers.errors.videoTooLong", {
177
+ count: secondsPluralCount(n),
178
+ n: bare ? "" : n,
179
+ });
224
180
  }
225
181
 
226
182
  function formatMb(bytes) {
@@ -768,24 +768,29 @@ function mergePacks(owner, sourceId, intoPackId) {
768
768
  return { pack: packDto(store.stickerPackGet(bound.key, intoPackId)), moved };
769
769
  }
770
770
 
771
- function clearAll() {
771
+ function resetForActivation() {
772
772
  require("./jobs.cjs").cancelAll();
773
773
  epoch++;
774
+ try { require("./uploads.cjs").discardAll(); }
775
+ catch (error) { logger.warn({ err: error }, "[Stickers] failed to discard uploads"); }
776
+ }
777
+
778
+ function clearAll() {
779
+ resetForActivation();
774
780
  store.stickerClearAll();
775
781
  try {
782
+ // discardAll() forgets upload ids even when file deletion fails. Unlink
783
+ // must also remove those bytes before a different account can pair.
784
+ fs.rmSync(dataPath("tmp", "stickers"), { recursive: true, force: true });
776
785
  fs.rmSync(dataPath("stickers"), { recursive: true, force: true });
777
786
  } catch (error) {
778
787
  logger.error({ err: error }, "[Stickers] failed to remove sticker files");
779
788
  throw new StickerError("STORAGE_UNAVAILABLE", {}, { cause: error });
780
789
  }
781
- try {
782
- require("./uploads.cjs").discardAll();
783
- } catch (error) {
784
- logger.warn({ err: error }, "[Stickers] failed to discard uploads");
785
- }
786
790
  }
787
791
 
788
792
  module.exports = {
793
+ resetForActivation,
789
794
  saveSticker,
790
795
  hasRoom,
791
796
  findStickerByContent,
@@ -814,4 +819,6 @@ module.exports = {
814
819
  clearAll,
815
820
  epoch: () => epoch,
816
821
  fileNameFor,
822
+ webpPath,
823
+ thumbPath,
817
824
  };
@@ -100,4 +100,4 @@ async function forMessage(msg, sock) {
100
100
  return store.stickerOwnerEnsure(lid);
101
101
  }
102
102
 
103
- module.exports = { forPanel, forMessage };
103
+ module.exports = { forPanel, forMessage, normalizedLid, normalizedPn };