@kyyinfinite/zapo-message 0.0.0-stage → 1.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 (191) hide show
  1. package/CHANGELOG.md +159 -0
  2. package/LICENSE +20 -0
  3. package/README.md +532 -2
  4. package/build.config.json +28 -0
  5. package/dist/airich/airich.d.ts +180 -0
  6. package/dist/airich/airich.js +548 -0
  7. package/dist/airich/context.d.ts +24 -0
  8. package/dist/airich/context.js +48 -0
  9. package/dist/airich/encode.d.ts +3 -0
  10. package/dist/airich/encode.js +16 -0
  11. package/dist/airich/index.d.ts +20 -0
  12. package/dist/airich/index.js +11 -0
  13. package/dist/airich/inline.d.ts +45 -0
  14. package/dist/airich/inline.js +152 -0
  15. package/dist/airich/nodes.d.ts +30 -0
  16. package/dist/airich/nodes.js +121 -0
  17. package/dist/airich/primitives.d.ts +144 -0
  18. package/dist/airich/primitives.js +230 -0
  19. package/dist/airich/protocol.d.ts +35 -0
  20. package/dist/airich/protocol.js +65 -0
  21. package/dist/airich/table.d.ts +22 -0
  22. package/dist/airich/table.js +35 -0
  23. package/dist/airich/tokenizer.d.ts +13 -0
  24. package/dist/airich/tokenizer.js +717 -0
  25. package/dist/airich/transport.d.ts +15 -0
  26. package/dist/airich/transport.js +56 -0
  27. package/dist/branding.d.ts +5 -0
  28. package/dist/branding.js +9 -0
  29. package/dist/btn/builders.d.ts +246 -0
  30. package/dist/btn/builders.js +710 -0
  31. package/dist/btn/media-slot.d.ts +28 -0
  32. package/dist/btn/media-slot.js +323 -0
  33. package/dist/btn/media-source.d.ts +38 -0
  34. package/dist/btn/media-source.js +116 -0
  35. package/dist/btn/sharp-loader.d.ts +5 -0
  36. package/dist/btn/sharp-loader.js +18 -0
  37. package/dist/btn/thumbnail.d.ts +21 -0
  38. package/dist/btn/thumbnail.js +124 -0
  39. package/dist/btn/validators.d.ts +40 -0
  40. package/dist/btn/validators.js +135 -0
  41. package/dist/btn.d.ts +1 -0
  42. package/dist/btn.js +1 -0
  43. package/dist/core/async-send.d.ts +20 -0
  44. package/dist/core/async-send.js +1 -0
  45. package/dist/core/base-builder.d.ts +20 -0
  46. package/dist/core/base-builder.js +67 -0
  47. package/dist/core/errors.d.ts +30 -0
  48. package/dist/core/errors.js +61 -0
  49. package/dist/download.d.ts +24 -0
  50. package/dist/download.js +123 -0
  51. package/dist/index.d.ts +38 -0
  52. package/dist/index.js +22 -0
  53. package/dist/integration/augment.d.ts +97 -0
  54. package/dist/integration/augment.js +1 -0
  55. package/dist/integration/auto.d.ts +8 -0
  56. package/dist/integration/auto.js +79 -0
  57. package/dist/integration/index.d.ts +4 -0
  58. package/dist/integration/index.js +2 -0
  59. package/dist/integration/methods.d.ts +25 -0
  60. package/dist/integration/methods.js +24 -0
  61. package/dist/interactive.d.ts +24 -0
  62. package/dist/interactive.js +121 -0
  63. package/dist/media-gate.d.ts +99 -0
  64. package/dist/media-gate.js +322 -0
  65. package/dist/message/album.d.ts +33 -0
  66. package/dist/message/album.js +107 -0
  67. package/dist/message/contact.d.ts +29 -0
  68. package/dist/message/contact.js +123 -0
  69. package/dist/message/forward.d.ts +23 -0
  70. package/dist/message/forward.js +77 -0
  71. package/dist/message/index.d.ts +26 -0
  72. package/dist/message/index.js +13 -0
  73. package/dist/message/link-preview.d.ts +28 -0
  74. package/dist/message/link-preview.js +98 -0
  75. package/dist/message/location.d.ts +24 -0
  76. package/dist/message/location.js +94 -0
  77. package/dist/message/media.d.ts +90 -0
  78. package/dist/message/media.js +123 -0
  79. package/dist/message/poll.d.ts +24 -0
  80. package/dist/message/poll.js +98 -0
  81. package/dist/message/reaction.d.ts +20 -0
  82. package/dist/message/reaction.js +71 -0
  83. package/dist/message/sticker.d.ts +29 -0
  84. package/dist/message/sticker.js +44 -0
  85. package/dist/message/target.d.ts +18 -0
  86. package/dist/message/target.js +24 -0
  87. package/dist/message/text.d.ts +17 -0
  88. package/dist/message/text.js +29 -0
  89. package/dist/message/vcard.d.ts +9 -0
  90. package/dist/message/vcard.js +23 -0
  91. package/dist/message/webp.d.ts +6 -0
  92. package/dist/message/webp.js +57 -0
  93. package/dist/payloads.d.ts +180 -0
  94. package/dist/payloads.js +1 -0
  95. package/dist/serialize.d.ts +41 -0
  96. package/dist/serialize.js +93 -0
  97. package/dist/status.d.ts +3 -0
  98. package/dist/status.js +21 -0
  99. package/dist/zapo-client.d.ts +44 -0
  100. package/dist/zapo-client.js +1 -0
  101. package/examples/airich.ts +59 -0
  102. package/examples/buttons.ts +48 -0
  103. package/examples/client-methods.ts +58 -0
  104. package/examples/hybrid.ts +133 -0
  105. package/examples/serialize.ts +61 -0
  106. package/package.json +271 -4
  107. package/scripts/check-no-comments.mjs +101 -0
  108. package/scripts/compare-golden.mjs +461 -0
  109. package/scripts/lib-config.mjs +9 -0
  110. package/scripts/smoke-auto.mjs +75 -0
  111. package/scripts/test-external-consumer.mjs +316 -0
  112. package/scripts/verify-package.mjs +78 -0
  113. package/src/airich/airich.ts +970 -0
  114. package/src/airich/context.ts +96 -0
  115. package/src/airich/encode.ts +25 -0
  116. package/src/airich/index.ts +98 -0
  117. package/src/airich/inline.ts +272 -0
  118. package/src/airich/nodes.ts +174 -0
  119. package/src/airich/primitives.ts +474 -0
  120. package/src/airich/protocol.ts +133 -0
  121. package/src/airich/table.ts +70 -0
  122. package/src/airich/tokenizer.ts +799 -0
  123. package/src/airich/transport.ts +106 -0
  124. package/src/branding.ts +23 -0
  125. package/src/btn/builders.ts +1073 -0
  126. package/src/btn/media-slot.ts +486 -0
  127. package/src/btn/media-source.ts +189 -0
  128. package/src/btn/sharp-loader.ts +23 -0
  129. package/src/btn/thumbnail.ts +182 -0
  130. package/src/btn/validators.ts +237 -0
  131. package/src/btn.ts +8 -0
  132. package/src/core/async-send.ts +28 -0
  133. package/src/core/base-builder.ts +104 -0
  134. package/src/core/errors.ts +82 -0
  135. package/src/download.ts +212 -0
  136. package/src/index.ts +229 -0
  137. package/src/integration/augment.ts +262 -0
  138. package/src/integration/auto.ts +103 -0
  139. package/src/integration/index.ts +8 -0
  140. package/src/integration/methods.ts +45 -0
  141. package/src/interactive.ts +188 -0
  142. package/src/media-gate.ts +499 -0
  143. package/src/message/album.ts +187 -0
  144. package/src/message/contact.ts +170 -0
  145. package/src/message/forward.ts +123 -0
  146. package/src/message/index.ts +83 -0
  147. package/src/message/link-preview.ts +148 -0
  148. package/src/message/location.ts +150 -0
  149. package/src/message/media.ts +323 -0
  150. package/src/message/poll.ts +158 -0
  151. package/src/message/reaction.ts +133 -0
  152. package/src/message/sticker.ts +100 -0
  153. package/src/message/target.ts +38 -0
  154. package/src/message/text.ts +61 -0
  155. package/src/message/vcard.ts +36 -0
  156. package/src/message/webp.ts +78 -0
  157. package/src/payloads.ts +204 -0
  158. package/src/serialize.ts +180 -0
  159. package/src/status.ts +29 -0
  160. package/src/zapo-client.ts +84 -0
  161. package/test/airich-inline.test.ts +200 -0
  162. package/test/airich-primitives.test.ts +226 -0
  163. package/test/airich-tokenizer.test.ts +145 -0
  164. package/test/airich.golden.test.ts +406 -0
  165. package/test/airich.test.ts +1006 -0
  166. package/test/btn-button.test.ts +416 -0
  167. package/test/btn-header.test.ts +646 -0
  168. package/test/btn-legacy.test.ts +342 -0
  169. package/test/btn-lifecycle.test.ts +295 -0
  170. package/test/btn-list.test.ts +261 -0
  171. package/test/btn-media-source.test.ts +150 -0
  172. package/test/btn-thumbnail.test.ts +160 -0
  173. package/test/builder-compat.test.ts +264 -0
  174. package/test/helpers.ts +27 -0
  175. package/test/hybrid-airich.test.ts +345 -0
  176. package/test/hybrid-client.test.ts +239 -0
  177. package/test/hybrid-errors.test.ts +557 -0
  178. package/test/hybrid-interactive.test.ts +455 -0
  179. package/test/hybrid.golden.test.ts +349 -0
  180. package/test/hybrid.test.ts +479 -0
  181. package/test/integration-auto.test.ts +159 -0
  182. package/test/integration.fakeserver.test.ts +440 -0
  183. package/test/media-gate.test.ts +215 -0
  184. package/test/message-album.test.ts +145 -0
  185. package/test/message-builders.test.ts +401 -0
  186. package/test/message-media.test.ts +303 -0
  187. package/test/message.fakeserver.test.ts +284 -0
  188. package/test/message.golden.test.ts +254 -0
  189. package/test/serializer.test.ts +448 -0
  190. package/tsconfig.json +26 -0
  191. package/tsconfig.test.json +10 -0
package/package.json CHANGED
@@ -1,6 +1,273 @@
1
1
  {
2
2
  "name": "@kyyinfinite/zapo-message",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.0.0",
4
+ "description": "WhatsApp message toolkit for ZapoJS: hybrid async + fluent builders (text, buttons, lists, media, stickers, polls, contacts, albums, reactions, forwards, location), AIRich rich responses, serialization and interactive parsing. Import once, use on any ZapoJS client.",
5
+ "type": "module",
6
+ "license": "ISC",
7
+ "author": "kyyinfinite (Avelyna)",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "git+https://github.com/kyyinfinite/avelyna.git"
11
+ },
12
+ "keywords": [
13
+ "whatsapp",
14
+ "zapo",
15
+ "zapo-js",
16
+ "message",
17
+ "buttons",
18
+ "native-flow",
19
+ "rich-response",
20
+ "airich",
21
+ "sdk",
22
+ "fluent",
23
+ "builder",
24
+ "media",
25
+ "sticker",
26
+ "poll"
27
+ ],
28
+ "engines": {
29
+ "node": ">=20.9.0"
30
+ },
31
+ "main": "./dist/index.js",
32
+ "types": "./dist/index.d.ts",
33
+ "exports": {
34
+ ".": {
35
+ "types": "./dist/index.d.ts",
36
+ "default": "./dist/index.js"
37
+ },
38
+ "./btn.js": {
39
+ "types": "./dist/btn.d.ts",
40
+ "default": "./dist/btn.js"
41
+ },
42
+ "./btn/builders.js": {
43
+ "types": "./dist/btn/builders.d.ts",
44
+ "default": "./dist/btn/builders.js"
45
+ },
46
+ "./btn/media-slot.js": {
47
+ "types": "./dist/btn/media-slot.d.ts",
48
+ "default": "./dist/btn/media-slot.js"
49
+ },
50
+ "./btn/media-source.js": {
51
+ "types": "./dist/btn/media-source.d.ts",
52
+ "default": "./dist/btn/media-source.js"
53
+ },
54
+ "./btn/thumbnail.js": {
55
+ "types": "./dist/btn/thumbnail.d.ts",
56
+ "default": "./dist/btn/thumbnail.js"
57
+ },
58
+ "./btn/validators.js": {
59
+ "types": "./dist/btn/validators.d.ts",
60
+ "default": "./dist/btn/validators.js"
61
+ },
62
+ "./core/base-builder.js": {
63
+ "types": "./dist/core/base-builder.d.ts",
64
+ "default": "./dist/core/base-builder.js"
65
+ },
66
+ "./core/errors.js": {
67
+ "types": "./dist/core/errors.d.ts",
68
+ "default": "./dist/core/errors.js"
69
+ },
70
+ "./airich/index.js": {
71
+ "types": "./dist/airich/index.d.ts",
72
+ "default": "./dist/airich/index.js"
73
+ },
74
+ "./airich/airich.js": {
75
+ "types": "./dist/airich/airich.d.ts",
76
+ "default": "./dist/airich/airich.js"
77
+ },
78
+ "./airich/context.js": {
79
+ "types": "./dist/airich/context.d.ts",
80
+ "default": "./dist/airich/context.js"
81
+ },
82
+ "./airich/encode.js": {
83
+ "types": "./dist/airich/encode.d.ts",
84
+ "default": "./dist/airich/encode.js"
85
+ },
86
+ "./airich/inline.js": {
87
+ "types": "./dist/airich/inline.d.ts",
88
+ "default": "./dist/airich/inline.js"
89
+ },
90
+ "./airich/nodes.js": {
91
+ "types": "./dist/airich/nodes.d.ts",
92
+ "default": "./dist/airich/nodes.js"
93
+ },
94
+ "./airich/primitives.js": {
95
+ "types": "./dist/airich/primitives.d.ts",
96
+ "default": "./dist/airich/primitives.js"
97
+ },
98
+ "./airich/protocol.js": {
99
+ "types": "./dist/airich/protocol.d.ts",
100
+ "default": "./dist/airich/protocol.js"
101
+ },
102
+ "./airich/table.js": {
103
+ "types": "./dist/airich/table.d.ts",
104
+ "default": "./dist/airich/table.js"
105
+ },
106
+ "./airich/tokenizer.js": {
107
+ "types": "./dist/airich/tokenizer.d.ts",
108
+ "default": "./dist/airich/tokenizer.js"
109
+ },
110
+ "./airich/transport.js": {
111
+ "types": "./dist/airich/transport.d.ts",
112
+ "default": "./dist/airich/transport.js"
113
+ },
114
+ "./serialize.js": {
115
+ "types": "./dist/serialize.d.ts",
116
+ "default": "./dist/serialize.js"
117
+ },
118
+ "./interactive.js": {
119
+ "types": "./dist/interactive.d.ts",
120
+ "default": "./dist/interactive.js"
121
+ },
122
+ "./download.js": {
123
+ "types": "./dist/download.d.ts",
124
+ "default": "./dist/download.js"
125
+ },
126
+ "./status.js": {
127
+ "types": "./dist/status.d.ts",
128
+ "default": "./dist/status.js"
129
+ },
130
+ "./media-gate.js": {
131
+ "types": "./dist/media-gate.d.ts",
132
+ "default": "./dist/media-gate.js"
133
+ },
134
+ "./branding.js": {
135
+ "types": "./dist/branding.d.ts",
136
+ "default": "./dist/branding.js"
137
+ },
138
+ "./zapo-client.js": {
139
+ "types": "./dist/zapo-client.d.ts",
140
+ "default": "./dist/zapo-client.js"
141
+ },
142
+ "./package.json": "./package.json",
143
+ "./message/index.js": {
144
+ "types": "./dist/message/index.d.ts",
145
+ "default": "./dist/message/index.js"
146
+ },
147
+ "./message/text.js": {
148
+ "types": "./dist/message/text.d.ts",
149
+ "default": "./dist/message/text.js"
150
+ },
151
+ "./message/link-preview.js": {
152
+ "types": "./dist/message/link-preview.d.ts",
153
+ "default": "./dist/message/link-preview.js"
154
+ },
155
+ "./message/reaction.js": {
156
+ "types": "./dist/message/reaction.d.ts",
157
+ "default": "./dist/message/reaction.js"
158
+ },
159
+ "./message/forward.js": {
160
+ "types": "./dist/message/forward.d.ts",
161
+ "default": "./dist/message/forward.js"
162
+ },
163
+ "./message/contact.js": {
164
+ "types": "./dist/message/contact.d.ts",
165
+ "default": "./dist/message/contact.js"
166
+ },
167
+ "./message/poll.js": {
168
+ "types": "./dist/message/poll.d.ts",
169
+ "default": "./dist/message/poll.js"
170
+ },
171
+ "./message/media.js": {
172
+ "types": "./dist/message/media.d.ts",
173
+ "default": "./dist/message/media.js"
174
+ },
175
+ "./message/sticker.js": {
176
+ "types": "./dist/message/sticker.d.ts",
177
+ "default": "./dist/message/sticker.js"
178
+ },
179
+ "./message/album.js": {
180
+ "types": "./dist/message/album.d.ts",
181
+ "default": "./dist/message/album.js"
182
+ },
183
+ "./message/webp.js": {
184
+ "types": "./dist/message/webp.d.ts",
185
+ "default": "./dist/message/webp.js"
186
+ },
187
+ "./message/vcard.js": {
188
+ "types": "./dist/message/vcard.d.ts",
189
+ "default": "./dist/message/vcard.js"
190
+ },
191
+ "./message/target.js": {
192
+ "types": "./dist/message/target.d.ts",
193
+ "default": "./dist/message/target.js"
194
+ },
195
+ "./integration/index.js": {
196
+ "types": "./dist/integration/index.d.ts",
197
+ "default": "./dist/integration/index.js"
198
+ },
199
+ "./integration/auto.js": {
200
+ "types": "./dist/integration/auto.d.ts",
201
+ "default": "./dist/integration/auto.js"
202
+ },
203
+ "./integration/methods.js": {
204
+ "types": "./dist/integration/methods.d.ts",
205
+ "default": "./dist/integration/methods.js"
206
+ },
207
+ "./integration/augment.js": {
208
+ "types": "./dist/integration/augment.d.ts",
209
+ "default": "./dist/integration/augment.js"
210
+ },
211
+ "./btn/sharp-loader.js": {
212
+ "types": "./dist/btn/sharp-loader.d.ts",
213
+ "default": "./dist/btn/sharp-loader.js"
214
+ },
215
+ "./core/async-send.js": {
216
+ "types": "./dist/core/async-send.d.ts",
217
+ "default": "./dist/core/async-send.js"
218
+ },
219
+ "./message/location.js": {
220
+ "types": "./dist/message/location.d.ts",
221
+ "default": "./dist/message/location.js"
222
+ }
223
+ },
224
+ "files": [
225
+ "dist",
226
+ "src",
227
+ "test",
228
+ "examples",
229
+ "docs",
230
+ "scripts",
231
+ "tsconfig.json",
232
+ "tsconfig.test.json",
233
+ "build.config.json",
234
+ "README.md",
235
+ "CHANGELOG.md",
236
+ "LICENSE"
237
+ ],
238
+ "scripts": {
239
+ "build": "tsc -p tsconfig.json",
240
+ "build:test": "tsc -p tsconfig.test.json",
241
+ "test": "npm run build && npm run build:test && node --test \"dist-test/*.test.js\"",
242
+ "test:fast": "node --test \"dist-test/*.test.js\"",
243
+ "test:integration": "node --test dist-test/integration.fakeserver.test.js",
244
+ "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json",
245
+ "lint": "node scripts/check-no-comments.mjs && tsc --noEmit -p tsconfig.json",
246
+ "format": "prettier --check src test examples scripts",
247
+ "format:fix": "prettier --write src test examples scripts",
248
+ "check:comments": "node scripts/check-no-comments.mjs",
249
+ "verify:package": "node scripts/verify-package.mjs",
250
+ "verify:consumer": "node scripts/test-external-consumer.mjs",
251
+ "prepack": "npm run build"
252
+ },
253
+ "peerDependencies": {
254
+ "zapo-js": ">=1.11.0 <2.0.0",
255
+ "sharp": ">=0.33.0"
256
+ },
257
+ "dependencies": {
258
+ "file-type": "^22.0.2"
259
+ },
260
+ "devDependencies": {
261
+ "@types/node": "^22.10.0",
262
+ "@zapo-js/fake-server": "1.3.1",
263
+ "prettier": "^3.4.2",
264
+ "typescript": "^5.7.2",
265
+ "zapo-js": "1.11.0",
266
+ "sharp": "^0.35.4"
267
+ },
268
+ "peerDependenciesMeta": {
269
+ "sharp": {
270
+ "optional": true
271
+ }
272
+ }
273
+ }
@@ -0,0 +1,101 @@
1
+ import { createScanner, isTemplateLiteralKind, SyntaxKind } from "typescript";
2
+ import { readFileSync, readdirSync, statSync } from "node:fs";
3
+ import { join, relative } from "node:path";
4
+ import { readConfig } from "./lib-config.mjs";
5
+
6
+ const config = await readConfig();
7
+ const roots = config.noComments.include;
8
+
9
+ const listFiles = (dir) => {
10
+ const out = [];
11
+ for (const entry of readdirSync(dir)) {
12
+ const full = join(dir, entry);
13
+ const info = statSync(full);
14
+ if (info.isDirectory()) out.push(...listFiles(full));
15
+ else if (entry.endsWith(".ts")) out.push(full);
16
+ }
17
+ return out;
18
+ };
19
+
20
+ const divisionPreceding = new Set([
21
+ SyntaxKind.Identifier,
22
+ SyntaxKind.NumericLiteral,
23
+ SyntaxKind.StringLiteral,
24
+ SyntaxKind.BigIntLiteral,
25
+ SyntaxKind.CloseParenToken,
26
+ SyntaxKind.CloseBracketToken,
27
+ SyntaxKind.CloseBraceToken,
28
+ ]);
29
+
30
+ const findComments = (text, fileName) => {
31
+ const scanner = createScanner(1, false, 0, text);
32
+ const comments = [];
33
+ let token = scanner.scan();
34
+ let last = SyntaxKind.Unknown;
35
+ while (token !== SyntaxKind.EndOfFileToken) {
36
+ if (token === SyntaxKind.SlashToken) {
37
+ const divisionContext = divisionPreceding.has(last);
38
+ if (!divisionContext) {
39
+ token = scanner.reScanSlashToken();
40
+ if (token === SyntaxKind.SlashEqualsToken) {
41
+ comments.push({
42
+ fileName,
43
+ pos: scanner.getTokenStart(),
44
+ text: scanner.getTokenText(),
45
+ });
46
+ token = scanner.scan();
47
+ last = token;
48
+ continue;
49
+ }
50
+ last = token;
51
+ token = scanner.scan();
52
+ continue;
53
+ }
54
+ }
55
+ if (
56
+ token === SyntaxKind.SingleLineCommentTrivia ||
57
+ token === SyntaxKind.MultiLineCommentTrivia
58
+ ) {
59
+ comments.push({
60
+ fileName,
61
+ pos: scanner.getTokenStart(),
62
+ text: scanner.getTokenText(),
63
+ });
64
+ }
65
+ last = token;
66
+ token = scanner.scan();
67
+ }
68
+ return comments;
69
+ };
70
+
71
+ const violations = [];
72
+ for (const root of roots) {
73
+ let files;
74
+ try {
75
+ files = listFiles(root);
76
+ } catch {
77
+ continue;
78
+ }
79
+ for (const file of files) {
80
+ const text = readFileSync(file, "utf8");
81
+ for (const comment of findComments(text, file)) {
82
+ violations.push(comment);
83
+ }
84
+ }
85
+ }
86
+
87
+ if (violations.length > 0) {
88
+ console.error(
89
+ `no-comments check FAILED: ${violations.length} comment(s) found`,
90
+ );
91
+ for (const violation of violations) {
92
+ console.error(
93
+ ` ${relative(process.cwd(), violation.fileName)} @ ${violation.pos}: ${violation.text.slice(0, 80)}`,
94
+ );
95
+ }
96
+ process.exit(1);
97
+ }
98
+
99
+ console.log(
100
+ `no-comments check passed: ${roots.join(", ")} contain zero comments`,
101
+ );