botinabox 2.4.3 → 2.5.1

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 (276) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +190 -190
  3. package/bin/botinabox.mjs +1 -1
  4. package/dist/cli.js +0 -0
  5. package/dist/connectors/google/index.d.ts +67 -1
  6. package/dist/connectors/google/index.js +240 -0
  7. package/dist/index.js +19 -5
  8. package/package.json +100 -99
  9. package/dist/channels/discord/adapter.d.ts +0 -32
  10. package/dist/channels/discord/adapter.js +0 -70
  11. package/dist/channels/discord/inbound.d.ts +0 -25
  12. package/dist/channels/discord/inbound.js +0 -24
  13. package/dist/channels/discord/models.d.ts +0 -8
  14. package/dist/channels/discord/models.js +0 -5
  15. package/dist/channels/discord/outbound.d.ts +0 -14
  16. package/dist/channels/discord/outbound.js +0 -38
  17. package/dist/channels/slack/adapter.d.ts +0 -33
  18. package/dist/channels/slack/adapter.js +0 -74
  19. package/dist/channels/slack/inbound.d.ts +0 -59
  20. package/dist/channels/slack/inbound.js +0 -96
  21. package/dist/channels/slack/models.d.ts +0 -9
  22. package/dist/channels/slack/models.js +0 -5
  23. package/dist/channels/slack/outbound.d.ts +0 -12
  24. package/dist/channels/slack/outbound.js +0 -18
  25. package/dist/channels/slack/transcribe.d.ts +0 -41
  26. package/dist/channels/slack/transcribe.js +0 -106
  27. package/dist/channels/webhook/adapter.d.ts +0 -23
  28. package/dist/channels/webhook/adapter.js +0 -86
  29. package/dist/channels/webhook/hmac.d.ts +0 -13
  30. package/dist/channels/webhook/hmac.js +0 -26
  31. package/dist/channels/webhook/models.d.ts +0 -9
  32. package/dist/channels/webhook/models.js +0 -5
  33. package/dist/channels/webhook/server.d.ts +0 -20
  34. package/dist/channels/webhook/server.js +0 -91
  35. package/dist/chat-pipeline-C-XlLGNl.d.ts +0 -648
  36. package/dist/chat-pipeline-CR1KF6eX.d.ts +0 -652
  37. package/dist/chat-pipeline-DisuC8SB.d.ts +0 -643
  38. package/dist/chunk-2LGXQPEA.js +0 -41
  39. package/dist/chunk-3X3YKI4T.js +0 -357
  40. package/dist/chunk-D47AIFOD.js +0 -351
  41. package/dist/chunk-DSNJKNEW.js +0 -328
  42. package/dist/chunk-GS2JFL6I.js +0 -144
  43. package/dist/chunk-J6S6QMUY.js +0 -144
  44. package/dist/chunk-QLA6YOFN.js +0 -22
  45. package/dist/chunk-UACT2WXX.js +0 -381
  46. package/dist/cli/templates/config.yml.d.ts +0 -7
  47. package/dist/cli/templates/config.yml.js +0 -61
  48. package/dist/cli/templates/env.d.ts +0 -1
  49. package/dist/cli/templates/env.js +0 -30
  50. package/dist/cli/templates/index.ts.d.ts +0 -2
  51. package/dist/cli/templates/index.ts.js +0 -30
  52. package/dist/cli/templates/package.json.d.ts +0 -5
  53. package/dist/cli/templates/package.json.js +0 -28
  54. package/dist/connector-DDahQw-2.d.ts +0 -63
  55. package/dist/connectors/google/calendar-connector.d.ts +0 -40
  56. package/dist/connectors/google/calendar-connector.js +0 -243
  57. package/dist/connectors/google/gmail-connector.d.ts +0 -42
  58. package/dist/connectors/google/gmail-connector.js +0 -345
  59. package/dist/connectors/google/oauth.d.ts +0 -48
  60. package/dist/connectors/google/oauth.js +0 -112
  61. package/dist/connectors/google/types.d.ts +0 -78
  62. package/dist/connectors/google/types.js +0 -2
  63. package/dist/core/chat/auto-discovery.d.ts +0 -16
  64. package/dist/core/chat/auto-discovery.js +0 -54
  65. package/dist/core/chat/channel-registry.d.ts +0 -45
  66. package/dist/core/chat/channel-registry.js +0 -96
  67. package/dist/core/chat/chat-pipeline.d.ts +0 -113
  68. package/dist/core/chat/chat-pipeline.js +0 -395
  69. package/dist/core/chat/chat-responder.d.ts +0 -90
  70. package/dist/core/chat/chat-responder.js +0 -185
  71. package/dist/core/chat/formatter.d.ts +0 -11
  72. package/dist/core/chat/formatter.js +0 -60
  73. package/dist/core/chat/index.d.ts +0 -24
  74. package/dist/core/chat/index.js +0 -18
  75. package/dist/core/chat/message-interpreter.d.ts +0 -91
  76. package/dist/core/chat/message-interpreter.js +0 -166
  77. package/dist/core/chat/message-store.d.ts +0 -66
  78. package/dist/core/chat/message-store.js +0 -131
  79. package/dist/core/chat/notification-queue.d.ts +0 -34
  80. package/dist/core/chat/notification-queue.js +0 -111
  81. package/dist/core/chat/pipeline.d.ts +0 -38
  82. package/dist/core/chat/pipeline.js +0 -89
  83. package/dist/core/chat/policies.d.ts +0 -16
  84. package/dist/core/chat/policies.js +0 -25
  85. package/dist/core/chat/routing.d.ts +0 -17
  86. package/dist/core/chat/routing.js +0 -36
  87. package/dist/core/chat/session-key.d.ts +0 -30
  88. package/dist/core/chat/session-key.js +0 -65
  89. package/dist/core/chat/session-manager.d.ts +0 -17
  90. package/dist/core/chat/session-manager.js +0 -23
  91. package/dist/core/chat/text-chunker.d.ts +0 -9
  92. package/dist/core/chat/text-chunker.js +0 -48
  93. package/dist/core/chat/triage-router.d.ts +0 -75
  94. package/dist/core/chat/triage-router.js +0 -142
  95. package/dist/core/chat/types.d.ts +0 -5
  96. package/dist/core/chat/types.js +0 -5
  97. package/dist/core/config/defaults.d.ts +0 -2
  98. package/dist/core/config/defaults.js +0 -38
  99. package/dist/core/config/index.d.ts +0 -6
  100. package/dist/core/config/index.js +0 -4
  101. package/dist/core/config/interpolate.d.ts +0 -5
  102. package/dist/core/config/interpolate.js +0 -27
  103. package/dist/core/config/loader.d.ts +0 -24
  104. package/dist/core/config/loader.js +0 -59
  105. package/dist/core/config/schema.d.ts +0 -5
  106. package/dist/core/config/schema.js +0 -119
  107. package/dist/core/data/core-entity-contexts.d.ts +0 -14
  108. package/dist/core/data/core-entity-contexts.js +0 -197
  109. package/dist/core/data/core-migrations.d.ts +0 -5
  110. package/dist/core/data/core-migrations.js +0 -45
  111. package/dist/core/data/core-schema.d.ts +0 -6
  112. package/dist/core/data/core-schema.js +0 -454
  113. package/dist/core/data/data-store.d.ts +0 -67
  114. package/dist/core/data/data-store.js +0 -218
  115. package/dist/core/data/domain-entity-contexts.d.ts +0 -29
  116. package/dist/core/data/domain-entity-contexts.js +0 -321
  117. package/dist/core/data/domain-schema.d.ts +0 -36
  118. package/dist/core/data/domain-schema.js +0 -323
  119. package/dist/core/data/index.d.ts +0 -7
  120. package/dist/core/data/index.js +0 -7
  121. package/dist/core/data/types.d.ts +0 -111
  122. package/dist/core/data/types.js +0 -1
  123. package/dist/core/hooks/hook-bus.d.ts +0 -18
  124. package/dist/core/hooks/hook-bus.js +0 -120
  125. package/dist/core/hooks/index.d.ts +0 -2
  126. package/dist/core/hooks/index.js +0 -1
  127. package/dist/core/hooks/types.d.ts +0 -19
  128. package/dist/core/hooks/types.js +0 -1
  129. package/dist/core/index.d.ts +0 -4
  130. package/dist/core/index.js +0 -4
  131. package/dist/core/llm/auto-discovery.d.ts +0 -11
  132. package/dist/core/llm/auto-discovery.js +0 -49
  133. package/dist/core/llm/cost-tracker.d.ts +0 -6
  134. package/dist/core/llm/cost-tracker.js +0 -38
  135. package/dist/core/llm/index.d.ts +0 -4
  136. package/dist/core/llm/index.js +0 -3
  137. package/dist/core/llm/model-router.d.ts +0 -25
  138. package/dist/core/llm/model-router.js +0 -49
  139. package/dist/core/llm/provider-registry.d.ts +0 -9
  140. package/dist/core/llm/provider-registry.js +0 -25
  141. package/dist/core/llm/types.d.ts +0 -2
  142. package/dist/core/llm/types.js +0 -2
  143. package/dist/core/orchestrator/adapters/api-adapter.d.ts +0 -34
  144. package/dist/core/orchestrator/adapters/api-adapter.js +0 -88
  145. package/dist/core/orchestrator/adapters/cli-adapter.d.ts +0 -22
  146. package/dist/core/orchestrator/adapters/cli-adapter.js +0 -69
  147. package/dist/core/orchestrator/adapters/deterministic-adapter.d.ts +0 -35
  148. package/dist/core/orchestrator/adapters/deterministic-adapter.js +0 -75
  149. package/dist/core/orchestrator/adapters/env-whitelist.d.ts +0 -4
  150. package/dist/core/orchestrator/adapters/env-whitelist.js +0 -27
  151. package/dist/core/orchestrator/adapters/output-extractor.d.ts +0 -11
  152. package/dist/core/orchestrator/adapters/output-extractor.js +0 -59
  153. package/dist/core/orchestrator/adapters/process-manager.d.ts +0 -15
  154. package/dist/core/orchestrator/adapters/process-manager.js +0 -26
  155. package/dist/core/orchestrator/adapters/tool-loop.d.ts +0 -22
  156. package/dist/core/orchestrator/adapters/tool-loop.js +0 -66
  157. package/dist/core/orchestrator/agent-registry.d.ts +0 -31
  158. package/dist/core/orchestrator/agent-registry.js +0 -135
  159. package/dist/core/orchestrator/budget-controller.d.ts +0 -19
  160. package/dist/core/orchestrator/budget-controller.js +0 -73
  161. package/dist/core/orchestrator/chain-guard.d.ts +0 -14
  162. package/dist/core/orchestrator/chain-guard.js +0 -23
  163. package/dist/core/orchestrator/circuit-breaker.d.ts +0 -65
  164. package/dist/core/orchestrator/circuit-breaker.js +0 -159
  165. package/dist/core/orchestrator/claude-stream-parser.d.ts +0 -31
  166. package/dist/core/orchestrator/claude-stream-parser.js +0 -99
  167. package/dist/core/orchestrator/config-revisions.d.ts +0 -6
  168. package/dist/core/orchestrator/config-revisions.js +0 -17
  169. package/dist/core/orchestrator/dependency-resolver.d.ts +0 -20
  170. package/dist/core/orchestrator/dependency-resolver.js +0 -78
  171. package/dist/core/orchestrator/governance-gate.d.ts +0 -110
  172. package/dist/core/orchestrator/governance-gate.js +0 -170
  173. package/dist/core/orchestrator/learning-pipeline.d.ts +0 -109
  174. package/dist/core/orchestrator/learning-pipeline.js +0 -249
  175. package/dist/core/orchestrator/loop-detector.d.ts +0 -51
  176. package/dist/core/orchestrator/loop-detector.js +0 -133
  177. package/dist/core/orchestrator/ndjson-logger.d.ts +0 -6
  178. package/dist/core/orchestrator/ndjson-logger.js +0 -18
  179. package/dist/core/orchestrator/permission-relay.d.ts +0 -72
  180. package/dist/core/orchestrator/permission-relay.js +0 -164
  181. package/dist/core/orchestrator/run-manager.d.ts +0 -31
  182. package/dist/core/orchestrator/run-manager.js +0 -178
  183. package/dist/core/orchestrator/scheduler.d.ts +0 -70
  184. package/dist/core/orchestrator/scheduler.js +0 -198
  185. package/dist/core/orchestrator/secret-store.d.ts +0 -57
  186. package/dist/core/orchestrator/secret-store.js +0 -171
  187. package/dist/core/orchestrator/session-manager.d.ts +0 -13
  188. package/dist/core/orchestrator/session-manager.js +0 -66
  189. package/dist/core/orchestrator/task-queue.d.ts +0 -34
  190. package/dist/core/orchestrator/task-queue.js +0 -83
  191. package/dist/core/orchestrator/template-interpolate.d.ts +0 -5
  192. package/dist/core/orchestrator/template-interpolate.js +0 -18
  193. package/dist/core/orchestrator/user-registry.d.ts +0 -47
  194. package/dist/core/orchestrator/user-registry.js +0 -76
  195. package/dist/core/orchestrator/wakeup-queue.d.ts +0 -9
  196. package/dist/core/orchestrator/wakeup-queue.js +0 -45
  197. package/dist/core/orchestrator/workflow-engine.d.ts +0 -47
  198. package/dist/core/orchestrator/workflow-engine.js +0 -204
  199. package/dist/core/security/audit.d.ts +0 -20
  200. package/dist/core/security/audit.js +0 -33
  201. package/dist/core/security/column-validator.d.ts +0 -20
  202. package/dist/core/security/column-validator.js +0 -37
  203. package/dist/core/security/index.d.ts +0 -5
  204. package/dist/core/security/index.js +0 -5
  205. package/dist/core/security/process-env.d.ts +0 -13
  206. package/dist/core/security/process-env.js +0 -49
  207. package/dist/core/security/sanitizer.d.ts +0 -11
  208. package/dist/core/security/sanitizer.js +0 -39
  209. package/dist/core/security/types.d.ts +0 -11
  210. package/dist/core/security/types.js +0 -1
  211. package/dist/core/update/auto-update.d.ts +0 -21
  212. package/dist/core/update/auto-update.js +0 -102
  213. package/dist/core/update/backup-manager.d.ts +0 -7
  214. package/dist/core/update/backup-manager.js +0 -24
  215. package/dist/core/update/index.d.ts +0 -8
  216. package/dist/core/update/index.js +0 -6
  217. package/dist/core/update/migration-hooks.d.ts +0 -11
  218. package/dist/core/update/migration-hooks.js +0 -10
  219. package/dist/core/update/types.d.ts +0 -11
  220. package/dist/core/update/types.js +0 -1
  221. package/dist/core/update/update-checker.d.ts +0 -11
  222. package/dist/core/update/update-checker.js +0 -63
  223. package/dist/core/update/update-manager.d.ts +0 -25
  224. package/dist/core/update/update-manager.js +0 -101
  225. package/dist/core/update/version-utils.d.ts +0 -6
  226. package/dist/core/update/version-utils.js +0 -34
  227. package/dist/gmail-connector-2FVYTQJH.js +0 -6
  228. package/dist/gmail-connector-MNUBRNFM.js +0 -6
  229. package/dist/gmail-connector-PS2VLGNE.js +0 -6
  230. package/dist/gmail-connector-ULSMN6X2.js +0 -6
  231. package/dist/gmail-connector-URRFX6A3.js +0 -6
  232. package/dist/inbound-AFBUPSPG.js +0 -10
  233. package/dist/inbound-AFOHYNUY.js +0 -6
  234. package/dist/inbound-CGIXRXGC.js +0 -8
  235. package/dist/inbound-MCOLRH6U.js +0 -10
  236. package/dist/inbound-SNEMBLGA.js +0 -6
  237. package/dist/inbound-ZJHAYVMF.js +0 -10
  238. package/dist/provider-qqJYv9nv.d.ts +0 -75
  239. package/dist/providers/anthropic/models.d.ts +0 -2
  240. package/dist/providers/anthropic/models.js +0 -29
  241. package/dist/providers/anthropic/provider.d.ts +0 -13
  242. package/dist/providers/anthropic/provider.js +0 -119
  243. package/dist/providers/anthropic/tool-converter.d.ts +0 -10
  244. package/dist/providers/anthropic/tool-converter.js +0 -7
  245. package/dist/providers/ollama/provider.d.ts +0 -17
  246. package/dist/providers/ollama/provider.js +0 -185
  247. package/dist/providers/openai/models.d.ts +0 -2
  248. package/dist/providers/openai/models.js +0 -29
  249. package/dist/providers/openai/provider.d.ts +0 -13
  250. package/dist/providers/openai/provider.js +0 -163
  251. package/dist/providers/openai/tool-converter.d.ts +0 -10
  252. package/dist/providers/openai/tool-converter.js +0 -10
  253. package/dist/shared/constants.d.ts +0 -50
  254. package/dist/shared/constants.js +0 -64
  255. package/dist/shared/index.d.ts +0 -14
  256. package/dist/shared/index.js +0 -14
  257. package/dist/shared/types/agent.d.ts +0 -36
  258. package/dist/shared/types/agent.js +0 -2
  259. package/dist/shared/types/channel.d.ts +0 -70
  260. package/dist/shared/types/channel.js +0 -2
  261. package/dist/shared/types/config.d.ts +0 -111
  262. package/dist/shared/types/config.js +0 -2
  263. package/dist/shared/types/connector.d.ts +0 -77
  264. package/dist/shared/types/connector.js +0 -2
  265. package/dist/shared/types/execution.d.ts +0 -29
  266. package/dist/shared/types/execution.js +0 -2
  267. package/dist/shared/types/provider.d.ts +0 -73
  268. package/dist/shared/types/provider.js +0 -2
  269. package/dist/shared/types/task.d.ts +0 -47
  270. package/dist/shared/types/task.js +0 -2
  271. package/dist/shared/types/workflow.d.ts +0 -39
  272. package/dist/shared/types/workflow.js +0 -2
  273. package/dist/shared/utils.d.ts +0 -6
  274. package/dist/shared/utils.js +0 -13
  275. package/dist/update-check.d.ts +0 -5
  276. package/dist/update-check.js +0 -56
@@ -1,357 +0,0 @@
1
- // src/connectors/google/oauth.ts
2
- var _google;
3
- async function getGoogle() {
4
- if (!_google) {
5
- try {
6
- const mod = await import("googleapis");
7
- _google = mod.google;
8
- } catch {
9
- throw new Error(
10
- "googleapis is required for Google connectors. Install it: npm install googleapis"
11
- );
12
- }
13
- }
14
- return _google;
15
- }
16
- async function createOAuth2Client(config) {
17
- const google = await getGoogle();
18
- return new google.auth.OAuth2(
19
- config.clientId,
20
- config.clientSecret,
21
- config.redirectUri
22
- );
23
- }
24
- function getAuthUrl(client, scopes) {
25
- return client.generateAuthUrl({
26
- access_type: "offline",
27
- prompt: "consent",
28
- scope: scopes
29
- });
30
- }
31
- async function exchangeCode(client, code) {
32
- const { tokens } = await client.getToken(code);
33
- return tokens;
34
- }
35
- async function createServiceAccountClient(config, scopes) {
36
- const google = await getGoogle();
37
- const auth = new google.auth.GoogleAuth({
38
- ...config.keyFile ? { keyFile: config.keyFile } : {},
39
- ...config.credentials ? { credentials: config.credentials } : {},
40
- scopes,
41
- clientOptions: { subject: config.subject }
42
- });
43
- return auth.getClient();
44
- }
45
- async function loadTokens(getter, accountKey) {
46
- const raw = await getter(`google_tokens:${accountKey}`);
47
- if (!raw) return null;
48
- try {
49
- return JSON.parse(raw);
50
- } catch {
51
- return null;
52
- }
53
- }
54
- async function saveTokens(setter, accountKey, tokens) {
55
- await setter(`google_tokens:${accountKey}`, JSON.stringify(tokens));
56
- }
57
- async function refreshIfNeeded(client, tokens, saver) {
58
- const buffer = 6e4;
59
- const isExpired = tokens.expiry_date != null && Date.now() >= tokens.expiry_date - buffer;
60
- if (!isExpired) return tokens;
61
- client.setCredentials(tokens);
62
- const { credentials } = await client.refreshAccessToken();
63
- const refreshed = {
64
- access_token: credentials.access_token,
65
- refresh_token: credentials.refresh_token ?? tokens.refresh_token,
66
- expiry_date: credentials.expiry_date ?? void 0,
67
- token_type: credentials.token_type ?? "Bearer"
68
- };
69
- if (saver) {
70
- await saver(refreshed);
71
- }
72
- return refreshed;
73
- }
74
-
75
- // src/connectors/google/gmail-connector.ts
76
- var GoogleGmailConnector = class {
77
- id = "google-gmail";
78
- meta = {
79
- displayName: "Google Gmail",
80
- provider: "google",
81
- dataType: "email"
82
- };
83
- tokenLoader;
84
- tokenSaver;
85
- client = null;
86
- config = null;
87
- tokens = null;
88
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
89
- gmail = null;
90
- constructor(opts = {}) {
91
- this.tokenLoader = opts.tokenLoader;
92
- this.tokenSaver = opts.tokenSaver;
93
- }
94
- // ── Lifecycle ──────────────────────────────────────────────────
95
- async connect(config) {
96
- this.config = config;
97
- const scopes = config.scopes ?? [
98
- "https://www.googleapis.com/auth/gmail.readonly"
99
- ];
100
- if (config.serviceAccount) {
101
- this.client = await createServiceAccountClient(config.serviceAccount, scopes);
102
- } else if (config.oauth) {
103
- this.client = await createOAuth2Client(config.oauth);
104
- if (!this.tokenLoader) {
105
- throw new Error("tokenLoader required for OAuth2 flow");
106
- }
107
- this.tokens = await loadTokens(this.tokenLoader, config.account);
108
- if (!this.tokens) {
109
- throw new Error(
110
- `No stored tokens for account ${config.account}. Complete the OAuth flow first.`
111
- );
112
- }
113
- this.tokens = await refreshIfNeeded(
114
- this.client,
115
- this.tokens,
116
- this.tokenSaver ? async (t) => saveTokens(this.tokenSaver, config.account, t) : void 0
117
- );
118
- this.client.setCredentials(this.tokens);
119
- } else {
120
- throw new Error("Either serviceAccount or oauth config is required");
121
- }
122
- const { google } = await import("googleapis");
123
- this.gmail = google.gmail({ version: "v1", auth: this.client });
124
- }
125
- async disconnect() {
126
- this.client = null;
127
- this.gmail = null;
128
- this.tokens = null;
129
- this.config = null;
130
- }
131
- async healthCheck() {
132
- try {
133
- this.ensureConnected();
134
- const res = await this.gmail.users.getProfile({ userId: "me" });
135
- return { ok: true, account: res.data.emailAddress };
136
- } catch (err) {
137
- return { ok: false, error: errorMessage(err) };
138
- }
139
- }
140
- // ── Auth ───────────────────────────────────────────────────────
141
- async authenticate(codeProvider) {
142
- if (!this.config) {
143
- return { success: false, error: "Call connect() first to set config, or pass config and call authenticate() before connect()." };
144
- }
145
- try {
146
- if (!this.config.oauth) {
147
- return { success: false, error: "OAuth config required for browser-based authenticate(). Use serviceAccount for headless auth." };
148
- }
149
- if (!this.tokenSaver) {
150
- return { success: false, error: "tokenSaver required for authenticate() flow." };
151
- }
152
- const client = await createOAuth2Client(this.config.oauth);
153
- const scopes = this.config.scopes ?? [
154
- "https://www.googleapis.com/auth/gmail.readonly",
155
- "https://www.googleapis.com/auth/gmail.send"
156
- ];
157
- const authUrl = getAuthUrl(client, scopes);
158
- const code = await codeProvider(authUrl);
159
- const tokens = await exchangeCode(client, code);
160
- await saveTokens(this.tokenSaver, this.config.account, tokens);
161
- this.tokens = tokens;
162
- this.client = client;
163
- this.client.setCredentials(tokens);
164
- const { google } = await import("googleapis");
165
- this.gmail = google.gmail({ version: "v1", auth: this.client });
166
- return { success: true, account: this.config.account };
167
- } catch (err) {
168
- return { success: false, error: errorMessage(err) };
169
- }
170
- }
171
- // ── Sync ───────────────────────────────────────────────────────
172
- async sync(options) {
173
- this.ensureConnected();
174
- if (options?.cursor) {
175
- return this.syncIncremental(options.cursor, options.limit);
176
- }
177
- return this.syncFull(options);
178
- }
179
- /** Incremental sync using Gmail history API. */
180
- async syncIncremental(startHistoryId, limit) {
181
- const records = [];
182
- const errors = [];
183
- const seenIds = /* @__PURE__ */ new Set();
184
- let pageToken;
185
- let latestHistoryId = startHistoryId;
186
- do {
187
- const res = await this.gmail.users.history.list({
188
- userId: "me",
189
- startHistoryId,
190
- historyTypes: ["messageAdded"],
191
- ...pageToken ? { pageToken } : {}
192
- });
193
- latestHistoryId = res.data.historyId ?? latestHistoryId;
194
- const histories = res.data.history ?? [];
195
- for (const h of histories) {
196
- for (const added of h.messagesAdded ?? []) {
197
- const msgId = added.message?.id;
198
- if (!msgId || seenIds.has(msgId)) continue;
199
- seenIds.add(msgId);
200
- try {
201
- const record = await this.fetchMessage(msgId);
202
- records.push(record);
203
- } catch (err) {
204
- errors.push({ id: msgId, error: errorMessage(err) });
205
- }
206
- if (limit && records.length >= limit) {
207
- return { records, cursor: latestHistoryId, hasMore: true, errors };
208
- }
209
- }
210
- }
211
- pageToken = res.data.nextPageToken ?? void 0;
212
- } while (pageToken);
213
- return { records, cursor: latestHistoryId, hasMore: false, errors };
214
- }
215
- /** Full sync — list messages and fetch each one. */
216
- async syncFull(options) {
217
- const records = [];
218
- const errors = [];
219
- const maxResults = options?.limit ?? 100;
220
- let query = "";
221
- if (options?.since) {
222
- const epoch = Math.floor(new Date(options.since).getTime() / 1e3);
223
- query = `after:${epoch}`;
224
- }
225
- if (options?.filters?.q) {
226
- query = query ? `${query} ${options.filters.q}` : String(options.filters.q);
227
- }
228
- let pageToken;
229
- let collected = 0;
230
- do {
231
- const res = await this.gmail.users.messages.list({
232
- userId: "me",
233
- maxResults: Math.min(maxResults - collected, 100),
234
- ...query ? { q: query } : {},
235
- ...pageToken ? { pageToken } : {}
236
- });
237
- const messages = res.data.messages ?? [];
238
- for (const msg of messages) {
239
- try {
240
- const record = await this.fetchMessage(msg.id);
241
- records.push(record);
242
- } catch (err) {
243
- errors.push({ id: msg.id, error: errorMessage(err) });
244
- }
245
- collected++;
246
- if (collected >= maxResults) break;
247
- }
248
- pageToken = res.data.nextPageToken ?? void 0;
249
- } while (pageToken && collected < maxResults);
250
- const profile = await this.gmail.users.getProfile({ userId: "me" });
251
- const cursor = profile.data.historyId ?? void 0;
252
- return {
253
- records,
254
- cursor,
255
- hasMore: !!pageToken,
256
- errors
257
- };
258
- }
259
- // ── Push (send email) ─────────────────────────────────────────
260
- async push(payload) {
261
- this.ensureConnected();
262
- try {
263
- const toHeader = payload.to.map(formatAddress).join(", ");
264
- const ccHeader = payload.cc.length ? `Cc: ${payload.cc.map(formatAddress).join(", ")}\r
265
- ` : "";
266
- const bccHeader = payload.bcc.length ? `Bcc: ${payload.bcc.map(formatAddress).join(", ")}\r
267
- ` : "";
268
- const mime = [
269
- `To: ${toHeader}\r
270
- `,
271
- ccHeader,
272
- bccHeader,
273
- `Subject: ${payload.subject}\r
274
- `,
275
- `Content-Type: text/plain; charset="UTF-8"\r
276
- `,
277
- `\r
278
- `,
279
- payload.body ?? ""
280
- ].join("");
281
- const encoded = Buffer.from(mime).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
282
- const res = await this.gmail.users.messages.send({
283
- userId: "me",
284
- requestBody: { raw: encoded }
285
- });
286
- return { success: true, externalId: res.data.id };
287
- } catch (err) {
288
- return { success: false, error: errorMessage(err) };
289
- }
290
- }
291
- // ── Internals ─────────────────────────────────────────────────
292
- ensureConnected() {
293
- if (!this.gmail || !this.config) {
294
- throw new Error("GoogleGmailConnector is not connected. Call connect() first.");
295
- }
296
- }
297
- /** Fetch a single message by ID and parse into an EmailRecord. */
298
- async fetchMessage(messageId) {
299
- const res = await this.gmail.users.messages.get({
300
- userId: "me",
301
- id: messageId,
302
- format: "metadata",
303
- metadataHeaders: ["From", "To", "Cc", "Bcc", "Subject", "Date"]
304
- });
305
- const msg = res.data;
306
- const headers = msg.payload?.headers ?? [];
307
- const getHeader = (name) => headers.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value ?? "";
308
- return {
309
- gmailId: msg.id,
310
- threadId: msg.threadId,
311
- account: this.config.account,
312
- subject: getHeader("Subject"),
313
- from: parseAddress(getHeader("From")),
314
- to: parseAddressList(getHeader("To")),
315
- cc: parseAddressList(getHeader("Cc")),
316
- bcc: parseAddressList(getHeader("Bcc")),
317
- date: new Date(getHeader("Date")).toISOString(),
318
- snippet: msg.snippet ?? "",
319
- labels: msg.labelIds ?? [],
320
- isRead: !(msg.labelIds ?? []).includes("UNREAD")
321
- };
322
- }
323
- };
324
- function parseAddress(raw) {
325
- const match = raw.match(/^(.+?)\s*<([^>]+)>$/);
326
- if (match) {
327
- return { name: match[1].replace(/^["']|["']$/g, "").trim(), email: match[2] };
328
- }
329
- return { email: raw.trim() };
330
- }
331
- function parseAddressList(raw) {
332
- if (!raw.trim()) return [];
333
- const results = [];
334
- const parts = raw.split(/,(?=(?:[^<]*<[^>]*>)*[^>]*$)/);
335
- for (const part of parts) {
336
- const trimmed = part.trim();
337
- if (trimmed) results.push(parseAddress(trimmed));
338
- }
339
- return results;
340
- }
341
- function formatAddress(addr) {
342
- return addr.name ? `${addr.name} <${addr.email}>` : addr.email;
343
- }
344
- function errorMessage(err) {
345
- return err instanceof Error ? err.message : String(err);
346
- }
347
-
348
- export {
349
- createOAuth2Client,
350
- getAuthUrl,
351
- exchangeCode,
352
- createServiceAccountClient,
353
- loadTokens,
354
- saveTokens,
355
- refreshIfNeeded,
356
- GoogleGmailConnector
357
- };
@@ -1,351 +0,0 @@
1
- // src/connectors/google/oauth.ts
2
- var _google;
3
- async function getGoogle() {
4
- if (!_google) {
5
- try {
6
- const mod = await import("googleapis");
7
- _google = mod.google;
8
- } catch {
9
- throw new Error(
10
- "googleapis is required for Google connectors. Install it: npm install googleapis"
11
- );
12
- }
13
- }
14
- return _google;
15
- }
16
- async function createOAuth2Client(config) {
17
- const google = await getGoogle();
18
- return new google.auth.OAuth2(
19
- config.clientId,
20
- config.clientSecret,
21
- config.redirectUri
22
- );
23
- }
24
- function getAuthUrl(client, scopes) {
25
- return client.generateAuthUrl({
26
- access_type: "offline",
27
- prompt: "consent",
28
- scope: scopes
29
- });
30
- }
31
- async function exchangeCode(client, code) {
32
- const { tokens } = await client.getToken(code);
33
- return tokens;
34
- }
35
- async function createServiceAccountClient(config, scopes) {
36
- const google = await getGoogle();
37
- const auth = new google.auth.GoogleAuth({
38
- ...config.keyFile ? { keyFile: config.keyFile } : {},
39
- ...config.credentials ? { credentials: config.credentials } : {},
40
- scopes,
41
- clientOptions: { subject: config.subject }
42
- });
43
- return auth.getClient();
44
- }
45
- async function loadTokens(getter, accountKey) {
46
- const raw = await getter(`google_tokens:${accountKey}`);
47
- if (!raw) return null;
48
- try {
49
- return JSON.parse(raw);
50
- } catch {
51
- return null;
52
- }
53
- }
54
- async function saveTokens(setter, accountKey, tokens) {
55
- await setter(`google_tokens:${accountKey}`, JSON.stringify(tokens));
56
- }
57
- async function refreshIfNeeded(client, tokens, saver) {
58
- const buffer = 6e4;
59
- const isExpired = tokens.expiry_date != null && Date.now() >= tokens.expiry_date - buffer;
60
- if (!isExpired) return tokens;
61
- client.setCredentials(tokens);
62
- const { credentials } = await client.refreshAccessToken();
63
- const refreshed = {
64
- access_token: credentials.access_token,
65
- refresh_token: credentials.refresh_token ?? tokens.refresh_token,
66
- expiry_date: credentials.expiry_date ?? void 0,
67
- token_type: credentials.token_type ?? "Bearer"
68
- };
69
- if (saver) {
70
- await saver(refreshed);
71
- }
72
- return refreshed;
73
- }
74
-
75
- // src/connectors/google/gmail-connector.ts
76
- var GoogleGmailConnector = class {
77
- id = "google-gmail";
78
- meta = {
79
- displayName: "Google Gmail",
80
- provider: "google",
81
- dataType: "email"
82
- };
83
- tokenLoader;
84
- tokenSaver;
85
- client = null;
86
- config = null;
87
- tokens = null;
88
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
89
- gmail = null;
90
- constructor(opts = {}) {
91
- this.tokenLoader = opts.tokenLoader;
92
- this.tokenSaver = opts.tokenSaver;
93
- }
94
- // ── Lifecycle ──────────────────────────────────────────────────
95
- async connect(config) {
96
- this.config = config;
97
- const scopes = config.scopes ?? [
98
- "https://www.googleapis.com/auth/gmail.readonly"
99
- ];
100
- if (config.serviceAccount) {
101
- this.client = await createServiceAccountClient(config.serviceAccount, scopes);
102
- } else if (config.oauth) {
103
- this.client = await createOAuth2Client(config.oauth);
104
- if (!this.tokenLoader) {
105
- throw new Error("tokenLoader required for OAuth2 flow");
106
- }
107
- this.tokens = await loadTokens(this.tokenLoader, config.account);
108
- if (!this.tokens) {
109
- throw new Error(
110
- `No stored tokens for account ${config.account}. Complete the OAuth flow first.`
111
- );
112
- }
113
- this.tokens = await refreshIfNeeded(
114
- this.client,
115
- this.tokens,
116
- this.tokenSaver ? async (t) => saveTokens(this.tokenSaver, config.account, t) : void 0
117
- );
118
- this.client.setCredentials(this.tokens);
119
- } else {
120
- throw new Error("Either serviceAccount or oauth config is required");
121
- }
122
- const { google } = await import("googleapis");
123
- this.gmail = google.gmail({ version: "v1", auth: this.client });
124
- }
125
- async disconnect() {
126
- this.client = null;
127
- this.gmail = null;
128
- this.tokens = null;
129
- this.config = null;
130
- }
131
- async healthCheck() {
132
- try {
133
- this.ensureConnected();
134
- const res = await this.gmail.users.getProfile({ userId: "me" });
135
- return { ok: true, account: res.data.emailAddress };
136
- } catch (err) {
137
- return { ok: false, error: errorMessage(err) };
138
- }
139
- }
140
- // ── Auth ───────────────────────────────────────────────────────
141
- async authenticate(codeProvider) {
142
- if (!this.config) {
143
- return { success: false, error: "Call connect() first to set config, or pass config and call authenticate() before connect()." };
144
- }
145
- try {
146
- const client = await createOAuth2Client(this.config.oauth);
147
- const scopes = this.config.scopes ?? [
148
- "https://www.googleapis.com/auth/gmail.readonly",
149
- "https://www.googleapis.com/auth/gmail.send"
150
- ];
151
- const authUrl = getAuthUrl(client, scopes);
152
- const code = await codeProvider(authUrl);
153
- const tokens = await exchangeCode(client, code);
154
- await saveTokens(this.tokenSaver, this.config.account, tokens);
155
- this.tokens = tokens;
156
- this.client = client;
157
- this.client.setCredentials(tokens);
158
- const { google } = await import("googleapis");
159
- this.gmail = google.gmail({ version: "v1", auth: this.client });
160
- return { success: true, account: this.config.account };
161
- } catch (err) {
162
- return { success: false, error: errorMessage(err) };
163
- }
164
- }
165
- // ── Sync ───────────────────────────────────────────────────────
166
- async sync(options) {
167
- this.ensureConnected();
168
- if (options?.cursor) {
169
- return this.syncIncremental(options.cursor, options.limit);
170
- }
171
- return this.syncFull(options);
172
- }
173
- /** Incremental sync using Gmail history API. */
174
- async syncIncremental(startHistoryId, limit) {
175
- const records = [];
176
- const errors = [];
177
- const seenIds = /* @__PURE__ */ new Set();
178
- let pageToken;
179
- let latestHistoryId = startHistoryId;
180
- do {
181
- const res = await this.gmail.users.history.list({
182
- userId: "me",
183
- startHistoryId,
184
- historyTypes: ["messageAdded"],
185
- ...pageToken ? { pageToken } : {}
186
- });
187
- latestHistoryId = res.data.historyId ?? latestHistoryId;
188
- const histories = res.data.history ?? [];
189
- for (const h of histories) {
190
- for (const added of h.messagesAdded ?? []) {
191
- const msgId = added.message?.id;
192
- if (!msgId || seenIds.has(msgId)) continue;
193
- seenIds.add(msgId);
194
- try {
195
- const record = await this.fetchMessage(msgId);
196
- records.push(record);
197
- } catch (err) {
198
- errors.push({ id: msgId, error: errorMessage(err) });
199
- }
200
- if (limit && records.length >= limit) {
201
- return { records, cursor: latestHistoryId, hasMore: true, errors };
202
- }
203
- }
204
- }
205
- pageToken = res.data.nextPageToken ?? void 0;
206
- } while (pageToken);
207
- return { records, cursor: latestHistoryId, hasMore: false, errors };
208
- }
209
- /** Full sync — list messages and fetch each one. */
210
- async syncFull(options) {
211
- const records = [];
212
- const errors = [];
213
- const maxResults = options?.limit ?? 100;
214
- let query = "";
215
- if (options?.since) {
216
- const epoch = Math.floor(new Date(options.since).getTime() / 1e3);
217
- query = `after:${epoch}`;
218
- }
219
- if (options?.filters?.q) {
220
- query = query ? `${query} ${options.filters.q}` : String(options.filters.q);
221
- }
222
- let pageToken;
223
- let collected = 0;
224
- do {
225
- const res = await this.gmail.users.messages.list({
226
- userId: "me",
227
- maxResults: Math.min(maxResults - collected, 100),
228
- ...query ? { q: query } : {},
229
- ...pageToken ? { pageToken } : {}
230
- });
231
- const messages = res.data.messages ?? [];
232
- for (const msg of messages) {
233
- try {
234
- const record = await this.fetchMessage(msg.id);
235
- records.push(record);
236
- } catch (err) {
237
- errors.push({ id: msg.id, error: errorMessage(err) });
238
- }
239
- collected++;
240
- if (collected >= maxResults) break;
241
- }
242
- pageToken = res.data.nextPageToken ?? void 0;
243
- } while (pageToken && collected < maxResults);
244
- const profile = await this.gmail.users.getProfile({ userId: "me" });
245
- const cursor = profile.data.historyId ?? void 0;
246
- return {
247
- records,
248
- cursor,
249
- hasMore: !!pageToken,
250
- errors
251
- };
252
- }
253
- // ── Push (send email) ─────────────────────────────────────────
254
- async push(payload) {
255
- this.ensureConnected();
256
- try {
257
- const toHeader = payload.to.map(formatAddress).join(", ");
258
- const ccHeader = payload.cc.length ? `Cc: ${payload.cc.map(formatAddress).join(", ")}\r
259
- ` : "";
260
- const bccHeader = payload.bcc.length ? `Bcc: ${payload.bcc.map(formatAddress).join(", ")}\r
261
- ` : "";
262
- const mime = [
263
- `To: ${toHeader}\r
264
- `,
265
- ccHeader,
266
- bccHeader,
267
- `Subject: ${payload.subject}\r
268
- `,
269
- `Content-Type: text/plain; charset="UTF-8"\r
270
- `,
271
- `\r
272
- `,
273
- payload.body ?? ""
274
- ].join("");
275
- const encoded = Buffer.from(mime).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
276
- const res = await this.gmail.users.messages.send({
277
- userId: "me",
278
- requestBody: { raw: encoded }
279
- });
280
- return { success: true, externalId: res.data.id };
281
- } catch (err) {
282
- return { success: false, error: errorMessage(err) };
283
- }
284
- }
285
- // ── Internals ─────────────────────────────────────────────────
286
- ensureConnected() {
287
- if (!this.gmail || !this.config) {
288
- throw new Error("GoogleGmailConnector is not connected. Call connect() first.");
289
- }
290
- }
291
- /** Fetch a single message by ID and parse into an EmailRecord. */
292
- async fetchMessage(messageId) {
293
- const res = await this.gmail.users.messages.get({
294
- userId: "me",
295
- id: messageId,
296
- format: "metadata",
297
- metadataHeaders: ["From", "To", "Cc", "Bcc", "Subject", "Date"]
298
- });
299
- const msg = res.data;
300
- const headers = msg.payload?.headers ?? [];
301
- const getHeader = (name) => headers.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value ?? "";
302
- return {
303
- gmailId: msg.id,
304
- threadId: msg.threadId,
305
- account: this.config.account,
306
- subject: getHeader("Subject"),
307
- from: parseAddress(getHeader("From")),
308
- to: parseAddressList(getHeader("To")),
309
- cc: parseAddressList(getHeader("Cc")),
310
- bcc: parseAddressList(getHeader("Bcc")),
311
- date: new Date(getHeader("Date")).toISOString(),
312
- snippet: msg.snippet ?? "",
313
- labels: msg.labelIds ?? [],
314
- isRead: !(msg.labelIds ?? []).includes("UNREAD")
315
- };
316
- }
317
- };
318
- function parseAddress(raw) {
319
- const match = raw.match(/^(.+?)\s*<([^>]+)>$/);
320
- if (match) {
321
- return { name: match[1].replace(/^["']|["']$/g, "").trim(), email: match[2] };
322
- }
323
- return { email: raw.trim() };
324
- }
325
- function parseAddressList(raw) {
326
- if (!raw.trim()) return [];
327
- const results = [];
328
- const parts = raw.split(/,(?=(?:[^<]*<[^>]*>)*[^>]*$)/);
329
- for (const part of parts) {
330
- const trimmed = part.trim();
331
- if (trimmed) results.push(parseAddress(trimmed));
332
- }
333
- return results;
334
- }
335
- function formatAddress(addr) {
336
- return addr.name ? `${addr.name} <${addr.email}>` : addr.email;
337
- }
338
- function errorMessage(err) {
339
- return err instanceof Error ? err.message : String(err);
340
- }
341
-
342
- export {
343
- createOAuth2Client,
344
- getAuthUrl,
345
- exchangeCode,
346
- createServiceAccountClient,
347
- loadTokens,
348
- saveTokens,
349
- refreshIfNeeded,
350
- GoogleGmailConnector
351
- };