notifkit 0.1.14 → 0.1.16

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 (89) hide show
  1. package/dashboard/dist/assets/index-C-DJYu0_.css +1 -0
  2. package/dashboard/dist/assets/index-CzFZcEon.js +318 -0
  3. package/dashboard/dist/index.html +2 -2
  4. package/dist/{bootstrap-m107TukN.mjs → bootstrap-BMDRPjgp.mjs} +1 -1
  5. package/dist/{bulk-xAd_biYV.mjs → bulk-CJ5QXiPa.mjs} +1 -1
  6. package/dist/index.d.mts +71 -27
  7. package/dist/index.mjs +2 -2
  8. package/dist/{main-CWIBUEc7.mjs → main-6_bXQBDH.mjs} +21 -41
  9. package/dist/{main-WkxXwP5q.mjs → main-8nP3qmCT.mjs} +29 -49
  10. package/dist/{main-HT5c6jyf.mjs → main-B82bsFoy.mjs} +183 -334
  11. package/dist/{main-C87TSAqM.mjs → main-CpaHF1Zw.mjs} +13 -15
  12. package/dist/{main-DRHL2bst.mjs → main-DULD8-th.mjs} +8 -6
  13. package/dist/{main-D_62f9fH.mjs → main-ZW5RaiOK.mjs} +77 -64
  14. package/dist/{main-5kVwbbnW.mjs → main-g1KEcXXp.mjs} +676 -582
  15. package/dist/{main-C0MjK1Au.mjs → main-mGIT8jv4.mjs} +4 -4
  16. package/dist/schedule-or-dispatch-Cd7GLfc3.mjs +52 -0
  17. package/dist/{src-DYqdD694.mjs → src-BE_EUpZ6.mjs} +93 -93
  18. package/package.json +1 -1
  19. package/scripts/create-admin.mjs +0 -0
  20. package/scripts/create-project.mjs +6 -2
  21. package/scripts/migrate.mjs +0 -0
  22. package/scripts/notifkit.mjs +0 -0
  23. package/src/client.ts +3 -3
  24. package/src/config/index.ts +1 -0
  25. package/src/contracts/common.ts +2 -0
  26. package/src/contracts/envelope.ts +1 -1
  27. package/src/contracts/events/notification-created.ts +2 -0
  28. package/src/contracts/events/notification-delivered.ts +1 -1
  29. package/src/contracts/events/notification-failed.ts +1 -1
  30. package/src/contracts/events/notification-requested.ts +3 -2
  31. package/src/contracts/helpers.ts +1 -2
  32. package/src/contracts/index.ts +1 -0
  33. package/src/contracts/registry.ts +1 -0
  34. package/src/contracts/sdk.ts +8 -37
  35. package/src/db/schema.ts +8 -13
  36. package/src/idempotency/index.ts +6 -8
  37. package/src/metrics/index.ts +2 -0
  38. package/src/rate-limiter/api-rate-limiter.ts +208 -0
  39. package/src/rate-limiter/index.ts +3 -411
  40. package/src/rate-limiter/project-settings-cache.ts +99 -0
  41. package/src/rate-limiter/user-throttle.ts +100 -0
  42. package/src/redis/index.ts +10 -3
  43. package/src/repositories/admin-user.ts +83 -0
  44. package/src/repositories/contact.ts +359 -0
  45. package/src/repositories/index.ts +9 -1416
  46. package/src/repositories/preference.ts +35 -0
  47. package/src/repositories/project.ts +110 -0
  48. package/src/repositories/segment.ts +16 -0
  49. package/src/repositories/template.ts +72 -0
  50. package/src/repositories/types.ts +49 -0
  51. package/src/repositories/user.ts +644 -0
  52. package/src/repositories/workflow.ts +64 -0
  53. package/src/services/ai/main.ts +29 -71
  54. package/src/services/api/admin-static.ts +4 -1
  55. package/src/services/api/handlers/auth.ts +109 -0
  56. package/src/services/api/handlers/campaigns.ts +191 -0
  57. package/src/services/api/handlers/events.ts +99 -0
  58. package/src/services/api/handlers/notifications.ts +356 -0
  59. package/src/services/api/handlers/projects.ts +116 -0
  60. package/src/services/api/handlers/shared.ts +262 -0
  61. package/src/services/api/handlers/suppressions.ts +95 -0
  62. package/src/services/api/handlers/system.ts +314 -0
  63. package/src/services/api/handlers/templates.ts +97 -0
  64. package/src/services/api/handlers/unsubscribe.ts +215 -0
  65. package/src/services/api/handlers/users.ts +262 -0
  66. package/src/services/api/handlers/workflows.ts +150 -0
  67. package/src/services/api/handlers.ts +25 -2190
  68. package/src/services/api/health.ts +133 -0
  69. package/src/services/api/http.ts +12 -0
  70. package/src/services/api/main.ts +32 -322
  71. package/src/services/api/router.ts +1 -1
  72. package/src/services/api/webhooks.ts +172 -0
  73. package/src/services/delivery/main.ts +256 -498
  74. package/src/services/engine/main.ts +31 -235
  75. package/src/services/engine/quiet-hours.ts +151 -0
  76. package/src/services/engine/schedule-or-dispatch.ts +104 -0
  77. package/src/services/enricher/main.ts +9 -21
  78. package/src/services/events/main.ts +2 -2
  79. package/src/services/scheduler/main.ts +16 -25
  80. package/src/services/workflow/duration.ts +24 -0
  81. package/src/services/workflow/main.ts +6 -164
  82. package/src/services/workflow/timers.ts +157 -0
  83. package/src/shared/events.ts +3 -2
  84. package/src/templates/render.ts +1 -0
  85. package/src/workers/index.ts +7 -4
  86. package/src/workflows/sdk.ts +1 -0
  87. package/dashboard/README.md +0 -29
  88. package/dashboard/dist/assets/index-ggpJKZqZ.js +0 -315
  89. package/dashboard/dist/assets/index-s-SXGIwv.css +0 -1
@@ -1,8 +1,9 @@
1
- import { $t as PUBSUB_CHANNELS, C as ContactRepository, D as TemplateRepository, Dn as normaliseTarget, En as getPriorityBucket, H as ProjectSettingsCache, Jt as buildStreamEvent, On as LRUCache, Sn as DataLoader, T as ProjectRepository, U as UserThrottle, Xt as ENRICHED_STREAMS, Yt as CONSUMER_GROUPS, Z as IdempotencyGuard, _ as TemplateCache, an as registry, c as BaseWorker, ct as scheduledPayloads, d as startHealthReporter, en as STREAMS, f as buildUnsubscribeHeaders, hn as readBaseConfig, kn as globalEmitter, lt as suppressions, pn as loadEnv, q as StreamProducer } from "./src-DYqdD694.mjs";
2
- import { a as uniqueConsumerId, i as shutdownWorker, n as createStreamConsumer, r as createWorkerRuntime, t as createPriorityProducers } from "./bootstrap-m107TukN.mjs";
1
+ import { An as globalEmitter, Cn as DataLoader, D as ContactRepository, E as TemplateRepository, G as ProjectSettingsCache, J as StreamProducer, On as normaliseTarget, Q as IdempotencyGuard, T as ProjectRepository, W as UserThrottle, Xt as CONSUMER_GROUPS, Yt as buildStreamEvent, Zt as ENRICHED_STREAMS, _ as TemplateCache, c as BaseWorker, d as startHealthReporter, en as PUBSUB_CHANNELS, f as buildUnsubscribeHeaders, gn as readBaseConfig, kn as LRUCache, mn as loadEnv, on as registry, tn as STREAMS, ut as suppressions } from "./src-BE_EUpZ6.mjs";
2
+ import { t as scheduleOrDispatch } from "./schedule-or-dispatch-Cd7GLfc3.mjs";
3
+ import { a as uniqueConsumerId, i as shutdownWorker, n as createStreamConsumer, r as createWorkerRuntime, t as createPriorityProducers } from "./bootstrap-BMDRPjgp.mjs";
3
4
  import { randomUUID } from "node:crypto";
4
5
  import { and, eq } from "drizzle-orm";
5
- //#region src/services/engine/main.ts
6
+ //#region src/services/engine/quiet-hours.ts
6
7
  function localTimeToUtc(year, month, day, hour, minute, second, timezone) {
7
8
  let utcMs = Date.UTC(year, month - 1, day, hour, minute, second);
8
9
  const formatter = new Intl.DateTimeFormat("en-US", {
@@ -72,9 +73,15 @@ function isInQuietHours(timezone, quietHours, fromDate = /* @__PURE__ */ new Dat
72
73
  targetMonth = nextDay.getUTCMonth() + 1;
73
74
  targetDay = nextDay.getUTCDate();
74
75
  }
76
+ let nextActive = localTimeToUtc(targetYear, targetMonth, targetDay, endH, endM, 0, timezone);
77
+ if (nextActive.getTime() <= date.getTime()) {
78
+ const currentSec = parseInt(parts.find((p) => p.type === "second")?.value ?? "0", 10);
79
+ const offsetMs = Date.UTC(year, month - 1, day, currentHour, currentMin, currentSec) - Math.floor(date.getTime() / 1e3) * 1e3;
80
+ nextActive = new Date(Date.UTC(targetYear, targetMonth - 1, targetDay, endH, endM, 0) - offsetMs);
81
+ }
75
82
  return {
76
83
  inQuietHours: true,
77
- nextActiveTime: localTimeToUtc(targetYear, targetMonth, targetDay, endH, endM, 0, timezone)
84
+ nextActiveTime: nextActive
78
85
  };
79
86
  }
80
87
  }
@@ -95,6 +102,8 @@ function isInQuietHours(timezone, quietHours, fromDate = /* @__PURE__ */ new Dat
95
102
  nextActiveTime: candidateTime
96
103
  };
97
104
  }
105
+ //#endregion
106
+ //#region src/services/engine/main.ts
98
107
  /** Idempotency stand-in for inline messages; see EngineWorker.process. */
99
108
  const NO_IDEMPOTENCY = {
100
109
  checkAndMark: async (_id, _ttl) => true,
@@ -118,7 +127,6 @@ var EngineWorker = class extends BaseWorker {
118
127
  idempotency;
119
128
  throttle;
120
129
  projectSettings;
121
- redisCli;
122
130
  templateCache;
123
131
  aiPendingProducer;
124
132
  scheduledProducer;
@@ -134,7 +142,6 @@ var EngineWorker = class extends BaseWorker {
134
142
  this.idempotency = options.idempotency;
135
143
  this.throttle = options.throttle;
136
144
  this.projectSettings = options.projectSettings;
137
- this.redisCli = options.redis;
138
145
  this.templateCache = options.templateCache;
139
146
  this.aiPendingProducer = options.aiPendingProducer;
140
147
  this.scheduledProducer = options.scheduledProducer;
@@ -377,10 +384,6 @@ var EngineWorker = class extends BaseWorker {
377
384
  }
378
385
  const taskId = `${enriched.rawEventId}:${contact.id || randomUUID()}`;
379
386
  const resolvedDestination = contact.target;
380
- if (enriched.channel === "email" && templateTopics.length > 0 && !config.UNSUBSCRIBE_SECRET) this.logger.warn({
381
- projectId: enriched.projectId,
382
- recipientId: enriched.recipientId
383
- }, "UNSUBSCRIBE_SECRET is not configured — email sent without RFC 8058 one-click unsubscribe headers");
384
387
  const unsubscribeHeaders = enriched.channel === "email" && templateTopics.length > 0 && config.UNSUBSCRIBE_SECRET && config.PUBLIC_URL && resolvedDestination ? buildUnsubscribeHeaders({
385
388
  claim: {
386
389
  projectId: enriched.projectId,
@@ -439,45 +442,21 @@ var EngineWorker = class extends BaseWorker {
439
442
  }, "task routed to AI worker");
440
443
  continue;
441
444
  }
442
- const envelope = buildStreamEvent("notification.dispatched", taskPayload, "engine", event.metadata.traceId);
443
- const now = Date.now();
444
- if ((enriched.scheduledAt ? new Date(enriched.scheduledAt).getTime() : now) > now) {
445
- await this.db.insert(scheduledPayloads).values({
446
- taskId,
447
- payload: {
448
- ...taskPayload,
449
- scheduledAt: enriched.scheduledAt
450
- }
451
- }).onConflictDoNothing();
452
- const scheduledEnvelope = buildStreamEvent("notification.scheduled", {
453
- projectId: enriched.projectId,
454
- enrichedEventId: event.id,
455
- taskId,
456
- scheduledAt: enriched.scheduledAt
457
- }, "engine", event.metadata.traceId);
458
- await this.scheduledProducer.publish(scheduledEnvelope);
459
- this.logger.debug({
460
- messageId: message.id,
461
- taskId,
462
- scheduledAt: enriched.scheduledAt,
463
- traceId: event.metadata.traceId
464
- }, "task scheduled and payload cached");
465
- } else {
466
- const p = getPriorityBucket(enriched.priority);
467
- const outboundProducer = this.outboundProducers[p] ?? this.outboundProducers["normal"];
468
- if (this.inlineNext) await this.inlineNext({
469
- ...envelope,
470
- id: randomUUID(),
471
- timestamp: (/* @__PURE__ */ new Date()).toISOString()
472
- });
473
- else await outboundProducer.publish(envelope);
474
- this.logger.debug({
475
- messageId: message.id,
476
- taskId,
477
- recipientId: enriched.recipientId,
478
- traceId: event.metadata.traceId
479
- }, "task dispatched");
480
- }
445
+ await scheduleOrDispatch({
446
+ db: this.db,
447
+ scheduledProducer: this.scheduledProducer,
448
+ outboundProducers: this.outboundProducers,
449
+ logger: this.logger,
450
+ inlineNext: this.inlineNext
451
+ }, taskPayload, {
452
+ source: "engine",
453
+ scheduledAt: enriched.scheduledAt,
454
+ messageId: message.id,
455
+ traceId: event.metadata.traceId,
456
+ logLevel: "debug",
457
+ scheduledMessage: "task scheduled and payload cached",
458
+ dispatchedMessage: "task dispatched"
459
+ });
481
460
  }
482
461
  await idempotency.markProcessed(idempotencyKey, customTtl);
483
462
  } catch (err) {
@@ -492,6 +471,7 @@ async function startEngineWorker() {
492
471
  templateRepo = new TemplateRepository(db);
493
472
  templateCache = new TemplateCache(templateRepo);
494
473
  const contactRepo = new ContactRepository(db);
474
+ if (!config.UNSUBSCRIBE_SECRET) logger.warn("UNSUBSCRIBE_SECRET is not configured — emails with topics are sent without RFC 8058 one-click unsubscribe headers");
495
475
  const consumerId = uniqueConsumerId("engine");
496
476
  ({consumer, pendingScanner} = createStreamConsumer({
497
477
  redis,