@zintrust/core 2.4.1 → 2.4.3

package/src/tools/notification/drivers/Console.ts

@@ -1,18 +0,0 @@
-export const ConsoleDriver = Object.freeze({
-  async send(
-    _recipient: string,
-    _message: string,
-    _options: Record<string, unknown> = {}
-  ): Promise<{ ok: boolean }> {
-    // Console driver is for development & simple systems — it should not throw
-    // Keep implementation minimal and synchronous-friendly
-    // Use out of band logging via ErrorHandler/Logger if required by callers
-    // Here we simply return a small payload indicating success
-    // Example: { ok: true }
-    // NOTE: keep body small to avoid leaking test runner logs
-    await Promise.resolve();
-    return { ok: true };
-  },
-});
-
-export default ConsoleDriver;

package/src/tools/notification/drivers/Slack.ts

@@ -1,47 +0,0 @@
-import { tracedFetch } from '@common/ExternalServiceUtils';
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-export type SlackConfig = {
-  webhookUrl: string;
-};
-
-export type SlackMessage = Record<string, unknown>;
-
-export const SlackDriver = Object.freeze({
-  async send(
-    config: SlackConfig,
-    payload: SlackMessage
-  ): Promise<{ ok: boolean; status?: number }> {
-    const url = config.webhookUrl ?? '';
-    if (typeof url !== 'string' || url.trim() === '') {
-      throw ErrorFactory.createConfigError('Slack: missing webhook URL');
-    }
-
-    const res = await tracedFetch(
-      url,
-      {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify(payload),
-      },
-      { source: 'slack' }
-    );
-
-    if (!res.ok) {
-      const text = await res.text();
-      throw ErrorFactory.createConnectionError(`Slack webhook failed (${res.status})`, {
-        status: res.status,
-        body: text,
-      });
-    }
-
-    return { ok: true, status: res.status };
-  },
-});
-
-export const sendSlackWebhook = async (
-  config: SlackConfig,
-  payload: SlackMessage
-): Promise<{ ok: boolean; status?: number }> => SlackDriver.send(config, payload);
-
-export default SlackDriver;

package/src/tools/notification/drivers/SlackNotification.ts

@@ -1,17 +0,0 @@
-import notificationConfig from '@config/notification';
-import { SlackDriver } from '@notification/drivers/Slack';
-
-export const SlackNotificationDriver = Object.freeze({
-  async send(_recipient: string, message: string, options: Record<string, unknown> = {}) {
-    const cfg = notificationConfig.providers.slack;
-
-    const payload: Record<string, unknown> = {
-      text: message,
-      ...options,
-    };
-
-    return SlackDriver.send({ webhookUrl: cfg.webhookUrl }, payload);
-  },
-});
-
-export default SlackNotificationDriver;

package/src/tools/notification/drivers/Termii.ts

@@ -1,47 +0,0 @@
-import { readEnvString, safeFetch, validateRequiredParams } from '@common/ExternalServiceUtils';
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-/**
- * Termii SMS Driver (skeleton)
- * - Reads TERMII_API_KEY and TERMII_SENDER from env
- * - POSTs to Termii API endpoint
- */
-export const TermiiDriver = Object.freeze({
-  async send(recipient: string, message: string, options: Record<string, unknown> = {}) {
-    validateRequiredParams({ recipient, message }, ['recipient', 'message']);
-
-    const apiKey = readEnvString('TERMII_API_KEY');
-    const sender = readEnvString('TERMII_SENDER');
-
-    if (!apiKey) {
-      throw ErrorFactory.createConfigError('TERMII_API_KEY is not configured');
-    }
-
-    const payload = {
-      to: recipient,
-      from: sender,
-      sms: message,
-      api_key: apiKey,
-      ...options,
-    } as Record<string, unknown>;
-
-    // Use shared fetch wrapper
-    const url = 'https://api.termii.com/sms/send';
-    const res = await safeFetch(
-      url,
-      {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-        },
-        body: JSON.stringify(payload),
-      },
-      { source: 'termii' }
-    );
-
-    const json = await res.json().catch(() => ({}));
-    return json;
-  },
-});
-
-export default TermiiDriver;

package/src/tools/notification/drivers/Twilio.ts

@@ -1,82 +0,0 @@
-import { tracedFetch } from '@common/ExternalServiceUtils';
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-export type TwilioConfig = {
-  accountSid: string;
-  authToken: string;
-  from: string;
-};
-
-export type TwilioMessage = {
-  to: string;
-  body: string;
-};
-
-const buildUrl = (accountSid: string): string => {
-  const base = 'https://api.twilio.com/2010-04-01/Accounts/';
-  return `${base}${accountSid}/Messages.json`;
-};
-
-export const TwilioDriver = Object.freeze({
-  async send(
-    config: TwilioConfig,
-    payload: TwilioMessage
-  ): Promise<{ ok: boolean; status?: number }> {
-    const accountSid = config.accountSid ?? '';
-    const authToken = config.authToken ?? '';
-    const from = config.from ?? '';
-
-    if (typeof accountSid !== 'string' || accountSid.trim() === '') {
-      throw ErrorFactory.createConfigError('Twilio: missing accountSid');
-    }
-    if (typeof authToken !== 'string' || authToken.trim() === '') {
-      throw ErrorFactory.createConfigError('Twilio: missing authToken');
-    }
-    if (typeof from !== 'string' || from.trim() === '') {
-      throw ErrorFactory.createConfigError('Twilio: missing from number');
-    }
-
-    if (typeof payload.to !== 'string' || payload.to.trim() === '') {
-      throw ErrorFactory.createValidationError('Twilio: missing to number');
-    }
-
-    const url = buildUrl(accountSid);
-
-    const params = new URLSearchParams();
-    params.append('To', payload.to);
-    params.append('From', from);
-    params.append('Body', payload.body);
-
-    const basic = Buffer.from(`${accountSid}:${authToken}`).toString('base64');
-
-    const res = await tracedFetch(
-      url,
-      {
-        method: 'POST',
-        headers: {
-          Authorization: `Basic ${basic}`,
-          'content-type': 'application/x-www-form-urlencoded',
-        },
-        body: params.toString(),
-      },
-      { source: 'twilio' }
-    );
-
-    if (!res.ok) {
-      const body = await res.text();
-      throw ErrorFactory.createConnectionError(`Twilio API failed (${res.status})`, {
-        status: res.status,
-        body,
-      });
-    }
-
-    return { ok: true, status: res.status };
-  },
-});
-
-export const sendSms = async (
-  config: TwilioConfig,
-  payload: TwilioMessage
-): Promise<{ ok: boolean; status?: number }> => TwilioDriver.send(config, payload);
-
-export default TwilioDriver;

package/src/tools/notification/drivers/TwilioNotification.ts

@@ -1,19 +0,0 @@
-import notificationConfig from '@config/notification';
-import { TwilioDriver } from '@notification/drivers/Twilio';
-
-export const TwilioNotificationDriver = Object.freeze({
-  async send(recipient: string, message: string) {
-    const cfg = notificationConfig.providers.twilio;
-
-    return TwilioDriver.send(
-      {
-        accountSid: cfg.accountSid,
-        authToken: cfg.authToken,
-        from: cfg.fromNumber,
-      },
-      { to: recipient, body: message }
-    );
-  },
-});
-
-export default TwilioNotificationDriver;

package/src/tools/notification/templates/markdown/index.ts

@@ -1,49 +0,0 @@
-import { readFileSync } from '@node-singletons/fs';
-import { join } from '@node-singletons/path';
-
-export const loadTemplate = (
-  name: string
-): { subject?: string; content: string; variables?: string[] } => {
-  const parts = name.split('/');
-  const dir = join(
-    process.cwd(),
-    'src',
-    'tools',
-    'notification',
-    'templates',
-    'markdown',
-    ...parts.slice(0, -1)
-  );
-  const leaf = parts.at(-1) ?? '';
-  const filePath = join(dir, `${leaf}.md`);
-  const raw = readFileSync(filePath, 'utf-8');
-
-  const meta: { subject?: string; variables?: string[] } = {};
-  const lines = raw.split(/\r?\n/);
-  let i = 0;
-  for (; i < lines.length; i++) {
-    const line = lines[i].trim();
-    // Fast path: must look like an HTML comment and contain a colon separator.
-    if (!line.startsWith('<!--') || !line.endsWith('-->')) break;
-    const inner = line.slice(4, -3).trim();
-    const colonIndex = inner.indexOf(':');
-    if (colonIndex === -1) break;
-    const key = inner.slice(0, colonIndex).trim().toLowerCase();
-    const val = inner.slice(colonIndex + 1).trim();
-    if (!key) break;
-    if (key === 'subject') meta.subject = val;
-    if (key === 'variables') {
-      meta.variables = val
-        .split(',')
-        .map((s) => s.trim())
-        .filter(Boolean);
-    }
-  }
-
-  const content = lines.slice(i).join('\n').trim();
-  return { content, ...meta };
-};
-
-export { listTemplates, renderTemplate } from '@notification/templates/markdown/registry';
-
-export default { loadTemplate };

package/src/tools/notification/templates/markdown/notifications/new-follow.md

@@ -1,12 +0,0 @@
-<!-- Subject: New follower -->
-<!-- Variables: name, follower -->
-
-# New follower
-
-Hi {{name}},
-
-**{{follower}}** started following you.
-
----
-
-Open your profile to see their activity.

package/src/tools/notification/templates/markdown/registry.ts

@@ -1,45 +0,0 @@
-import { readdirSync, statSync } from '@node-singletons/fs';
-import { join, relative } from '@node-singletons/path';
-import { loadTemplate } from '@notification/templates/markdown';
-import { MarkdownRenderer } from '@tools/templates';
-
-const BASE = join(process.cwd(), 'src', 'tools', 'notification', 'templates', 'markdown');
-
-const walkDir = (dir: string, base = dir): string[] => {
-  const entries = readdirSync(dir);
-  let files: string[] = [];
-  for (const e of entries) {
-    const p = join(dir, e);
-    const s = statSync(p);
-    if (s.isDirectory()) {
-      files = files.concat(walkDir(p, base));
-      continue;
-    }
-    if (e.endsWith('.md')) {
-      const rel = relative(base, p).replaceAll('\\', '/');
-      const withoutExt = rel.toLowerCase().endsWith('.md') ? rel.slice(0, -3) : rel;
-      files.push(withoutExt);
-    }
-  }
-  return files;
-};
-
-export const listTemplates = (): string[] => {
-  return walkDir(BASE);
-};
-
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-export const renderTemplate = (
-  name: string,
-  vars: Record<string, unknown> = {}
-): { html: string; meta: ReturnType<typeof loadTemplate> } => {
-  const tpl = loadTemplate(name);
-  // Basic validation: subject required
-  if (tpl.subject === null || tpl.subject === undefined || tpl.subject.trim() === '')
-    throw ErrorFactory.createValidationError('Notification template missing subject', { name });
-  const html = MarkdownRenderer.render(tpl.content, vars);
-  return { html, meta: tpl };
-};
-
-export default { listTemplates, renderTemplate };

package/src/tools/notification/testing.ts

@@ -1,50 +0,0 @@
-import { ErrorFactory } from '@exceptions/ZintrustError';
-
-type SentRecord = {
-  provider: string;
-  payload: unknown;
-  config: unknown;
-};
-
-export const NotificationFake = Object.freeze({
-  _sent: [] as Array<SentRecord>,
-
-  async send(provider: string, config: unknown, payload: unknown): Promise<{ ok: boolean }> {
-    this._sent.push({ provider, config, payload });
-    await Promise.resolve();
-    return { ok: true };
-  },
-
-  assertSent(predicate: (r: SentRecord) => boolean) {
-    if (!this._sent.some(predicate))
-      throw ErrorFactory.createValidationError('Expected notification to be sent');
-  },
-
-  assertNotSent(predicate: (r: SentRecord) => boolean) {
-    if (this._sent.some(predicate))
-      throw ErrorFactory.createValidationError('Expected notification to NOT be sent');
-  },
-
-  assertSentCount(expected: number) {
-    if (this._sent.length !== expected) {
-      throw ErrorFactory.createValidationError('Unexpected notification send count', {
-        expected,
-        actual: this._sent.length,
-      });
-    }
-  },
-
-  getSent(): Array<SentRecord> {
-    return [...this._sent];
-  },
-
-  lastSent(): SentRecord | undefined {
-    return this._sent.length > 0 ? this._sent.at(-1) : undefined;
-  },
-
-  reset() {
-    this._sent.length = 0;
-  },
-});
-
-export default NotificationFake;

package/src/tools/notification/testingHelpers.ts

@@ -1,44 +0,0 @@
-import { Env } from '@config/env';
-import { NotificationRegistry } from '@notification/Registry';
-import NotificationFake from '@notification/testing';
-
-// NOTE: This testing helper intentionally mutates runtime env values
-// via Env.set() to temporarily override NOTIFICATION_DRIVER for test isolation.
-
-type DriverLike = {
-  send(recipient: string, message: string, options?: Record<string, unknown>): Promise<unknown>;
-};
-
-export const useFakeDriver = (
-  name = 'notification-fake',
-  fake: unknown = NotificationFake
-): { driverName: string; restore: () => void } => {
-  let previous: DriverLike | undefined;
-  try {
-    previous = NotificationRegistry.get(name) as DriverLike;
-  } catch {
-    previous = undefined;
-  }
-
-  const fakeDriver = fake as DriverLike;
-  NotificationRegistry.register(name, fakeDriver);
-  const prevEnv = Env.get('NOTIFICATION_DRIVER', '');
-  Env.set('NOTIFICATION_DRIVER', name);
-
-  return {
-    driverName: name,
-    restore() {
-      // Restore previous driver if present, otherwise keep fake registered
-      if (previous === undefined) {
-        NotificationRegistry.register(name, NotificationFake as unknown as DriverLike);
-      } else {
-        NotificationRegistry.register(name, previous);
-      }
-
-      if (prevEnv === '') Env.unset('NOTIFICATION_DRIVER');
-      else Env.set('NOTIFICATION_DRIVER', prevEnv);
-    },
-  };
-};
-
-export default { useFakeDriver };