deepline 0.3.87 → 0.3.88

package/dist/bundling-sources/shared_libs/monitors/lifecycle-notifications.ts

@@ -1,473 +0,0 @@
-// Internal Slack notifications for monitor / triggered-play lifecycle + activity.
-//
-// These are thin, best-effort helpers (mirroring
-// `src/lib/plays/team-notifications.ts`) that build a Slack payload via
-// `buildSlackActivityPayload` and dispatch it through `sendSlackEventSafe` on
-// one of two internal channels:
-//
-//   - `monitor_activity`        (#deepline-monitor-activity)
-//       monitor created/deployed, monitor activity (every hit), triggered play
-//       published, monitor disabled, monitor deleted.
-//   - `monitor_error_activity`  (#deepline-monitor-error-activity)
-//       monitor entered error state, activity-processing/dispatch failures.
-//
-// LOCKED DECISIONS encoded here:
-//   - Volume: EVERY single activity hit posts. No throttling/batching.
-//   - Internal actor: alerts fire even for getaero.io / deepline.com staff
-//     (we set `bypassInternalActorBlock`), BUT synthetic `@deepline.local`
-//     dev-bootstrap test orgs are always suppressed (see
-//     `shouldSuppressMonitorActor` + the transport-level guard in
-//     `slack-events.ts`).
-//   - Environments: ALL (dev + preview + prod). The two channels declare
-//     `requiredEnv: 'all'` in `slack-events.ts`, so they post in local dev too.
-//   - Spend: NEVER include provider spend. These payloads carry only keys,
-//     counts, and trigger metadata — no provider-cost fields.
-
-import { after } from 'next/server';
-import {
-  buildSlackActivityPayload,
-  isSyntheticActorEmail,
-  sendSlackEventSafe,
-} from '@/lib/slack-events';
-import { getRuntimeEnv } from '@/lib/runtime-env';
-
-/**
- * Schedule a best-effort Slack dispatch WITHOUT blocking the caller. The
- * monitor-activity path is on the provider-webhook ack hot path, so the actual
- * Slack POST must run in the background. We prefer Next's `after()` (runs after
- * the response is flushed) and fall back to a detached promise when no request
- * scope is active (e.g. tests, crons, non-Next callers). Either way the dispatch
- * never throws into the ack/write path.
- */
-function scheduleSlackDispatch(run: () => Promise<unknown>): void {
-  const detach = () => {
-    void run().catch((error) => {
-      console.warn('[monitor-lifecycle.slack_dispatch_failed]', {
-        error: error instanceof Error ? error.message : String(error),
-      });
-    });
-  };
-  // `after` must be called synchronously inside a request/render scope. Outside
-  // a scope it throws synchronously, so we catch and fall back to a detached
-  // promise (tests, crons, non-Next callers).
-  try {
-    after(run);
-  } catch {
-    detach();
-  }
-}
-
-export type MonitorTriggerType = 'webhook' | 'cron' | 'sqlListeners';
-
-export type MonitorActivitySource =
-  | 'provider_webhook_callback'
-  | 'crm_webhook_callback'
-  | 'sql_listener'
-  | 'scheduled_monitor_sync'
-  | string;
-
-/**
- * One monitor-activity hit (a webhook callback / SQL-listener firing / CRM
- * webhook / scheduled sync that wrote rows and/or dispatched plays).
- *
- * NOTE: deliberately no provider-cost field. Pass only keys and counts.
- */
-export type MonitorActivityNotification = {
-  orgId: string;
-  /** Stable Deepline-managed monitor key, when known. */
-  monitorKey?: string | null;
-  /** Source provider (e.g. "instantly", "theirstack"). */
-  provider?: string | null;
-  /** Source capability / monitor tool capability, when known. */
-  sourceCapability?: string | null;
-  /** Short label identifying the write site. */
-  source: MonitorActivitySource;
-  /** Count of typed rows written by the monitor writer for this hit. */
-  rowsWritten?: number | null;
-  /** Count of plays dispatched off the rows this hit wrote. */
-  playsDispatched?: number | null;
-  /** Names of plays dispatched, best-effort (deduped). */
-  playNames?: string[] | null;
-  /** Actor email when one is available (often absent for webhook callbacks). */
-  actorEmail?: string | null;
-  requestedAt?: string;
-};
-
-/**
- * The injectable dispatcher seam for monitor-activity notifications. The default
- * builds a Slack payload and sends it on `monitor_activity`. Tests (and the gold
- * E2E) capture at THIS seam rather than mocking fetch / standing up a fake Slack
- * server, so they assert the exact `{ orgId, monitorKey, rowsWritten,
- * playsDispatched }` shape that reaches the notifier.
- */
-export type MonitorActivityNotifier = (
-  notification: MonitorActivityNotification,
-) => void | Promise<void>;
-
-let activityNotifierOverride: MonitorActivityNotifier | null = null;
-
-/**
- * Override the monitor-activity notifier (test seam). Returns a restore fn.
- */
-export function setMonitorActivityNotifier(
-  notifier: MonitorActivityNotifier | null,
-): () => void {
-  const previous = activityNotifierOverride;
-  activityNotifierOverride = notifier;
-  return () => {
-    activityNotifierOverride = previous;
-  };
-}
-
-export function resolveMonitorActivityNotifier(): MonitorActivityNotifier {
-  return activityNotifierOverride ?? defaultMonitorActivityNotifier;
-}
-
-/**
- * Central actor rule. We WANT alerts for real customers AND for getaero.io /
- * deepline.com internal staff, so callers set `bypassInternalActorBlock` on the
- * payload. The one identity we always drop is the synthetic `@deepline.local`
- * dev-bootstrap test org. `slack-events.ts` enforces the same suppression at the
- * transport layer; this lets us skip the build/dispatch work entirely.
- */
-export function shouldSuppressMonitorActor(
-  actorEmail: string | null | undefined,
-): boolean {
-  return isSyntheticActorEmail(actorEmail);
-}
-
-function normalizeCount(value: number | null | undefined): number | null {
-  if (typeof value !== 'number' || !Number.isFinite(value)) return null;
-  return Math.max(0, Math.trunc(value));
-}
-
-function monitorLabel(input: {
-  monitorKey?: string | null;
-  provider?: string | null;
-  sourceCapability?: string | null;
-}): string {
-  const key = input.monitorKey?.trim();
-  const capability =
-    input.sourceCapability?.trim() ||
-    (input.provider?.trim() ? input.provider.trim() : '');
-  if (key && capability) return `${key} (${capability})`;
-  return key || capability || '(unknown monitor)';
-}
-
-const defaultMonitorActivityNotifier: MonitorActivityNotifier = (
-  notification,
-) => {
-  if (shouldSuppressMonitorActor(notification.actorEmail)) return;
-  const requestedAt = notification.requestedAt ?? new Date().toISOString();
-  const runtimeEnv = getRuntimeEnv();
-  const rowsWritten = normalizeCount(notification.rowsWritten);
-  const playsDispatched = normalizeCount(notification.playsDispatched);
-  const label = monitorLabel(notification);
-  const playNames = (notification.playNames ?? []).filter(Boolean);
-  const primary =
-    `${label} | rows ${rowsWritten ?? 0} | plays ${playsDispatched ?? 0}`.trim();
-
-  // Build the payload now (cheap), dispatch the Slack POST off the ack hot path.
-  const payload = buildSlackActivityPayload({
-    source: `monitor_activity:${notification.source}`,
-    activityTitle: 'Monitor activity:',
-    activityPrimary: primary,
-    requestedAt,
-    fallbackText: `Monitor activity - ${label} | rows ${rowsWritten ?? 0} | plays ${playsDispatched ?? 0} | ${notification.source}`,
-    fields: [
-      { label: 'Monitor', value: notification.monitorKey ?? null },
-      { label: 'Provider', value: notification.provider ?? null },
-      { label: 'Capability', value: notification.sourceCapability ?? null },
-      { label: 'Source', value: notification.source },
-      { label: 'Rows written', value: rowsWritten },
-      { label: 'Plays dispatched', value: playsDispatched },
-      {
-        label: 'Plays',
-        value: playNames.length > 0 ? playNames.join(', ') : null,
-      },
-      { label: 'Org ID', value: notification.orgId },
-      { label: 'Actor', value: notification.actorEmail ?? null },
-      { label: 'Environment', value: runtimeEnv },
-    ],
-    extra: {
-      orgId: notification.orgId,
-      monitorKey: notification.monitorKey ?? null,
-      provider: notification.provider ?? null,
-      sourceCapability: notification.sourceCapability ?? null,
-      source: notification.source,
-      rowsWritten,
-      playsDispatched,
-      actorEmail: notification.actorEmail ?? null,
-      runtimeEnv,
-      // Alert real customers AND getaero.io / deepline.com staff. The
-      // synthetic `@deepline.local` actor is dropped above and by transport.
-      bypassInternalActorBlock: true,
-    },
-  });
-  scheduleSlackDispatch(() => sendSlackEventSafe('monitor_activity', payload));
-};
-
-/**
- * Monitor activity (EVERY hit) -> #deepline-monitor-activity.
- * Shared by all activity sources (provider webhook callback, CRM webhook,
- * SQL-listener firings, scheduled provider sync). Best-effort: never throws.
- */
-export async function notifyMonitorActivity(
-  notification: MonitorActivityNotification,
-): Promise<void> {
-  try {
-    await resolveMonitorActivityNotifier()(notification);
-  } catch (error) {
-    console.warn('[monitor-lifecycle.activity_notify_failed]', {
-      org_id: notification.orgId,
-      source: notification.source,
-      error: error instanceof Error ? error.message : String(error),
-    });
-  }
-}
-
-/**
- * Monitor created/deployed -> #deepline-monitor-activity.
- */
-export async function notifyMonitorDeployed(input: {
-  orgId: string;
-  monitorKey: string;
-  tool?: string | null;
-  name?: string | null;
-  actorEmail?: string | null;
-  mode?: string | null;
-  requestedAt?: string;
-}): Promise<void> {
-  if (shouldSuppressMonitorActor(input.actorEmail)) return;
-  const requestedAt = input.requestedAt ?? new Date().toISOString();
-  const runtimeEnv = getRuntimeEnv();
-  const displayName = input.name?.trim() || input.monitorKey;
-  const tool = input.tool?.trim() || '(unknown tool)';
-  const primary = `${displayName} | ${tool}`;
-  await sendSlackEventSafe(
-    'monitor_activity',
-    buildSlackActivityPayload({
-      source: 'monitor_deployed',
-      activityTitle: 'Monitor deployed:',
-      activityPrimary: primary,
-      requestedAt,
-      fallbackText: `Monitor deployed - ${displayName} | ${tool} | org ${input.orgId}`,
-      fields: [
-        { label: 'Monitor', value: input.monitorKey },
-        { label: 'Name', value: input.name ?? null },
-        { label: 'Tool', value: input.tool ?? null },
-        { label: 'Mode', value: input.mode ?? null },
-        { label: 'Org ID', value: input.orgId },
-        { label: 'Actor', value: input.actorEmail ?? null },
-        { label: 'Environment', value: runtimeEnv },
-      ],
-      extra: {
-        orgId: input.orgId,
-        monitorKey: input.monitorKey,
-        tool: input.tool ?? null,
-        actorEmail: input.actorEmail ?? null,
-        email: input.actorEmail ?? null,
-        runtimeEnv,
-        bypassInternalActorBlock: true,
-      },
-    }),
-  );
-}
-
-/**
- * Triggered play published (cron / webhook / sqlListeners) ->
- * #deepline-monitor-activity. Only fire when the published bindings actually
- * declare a trigger; the caller gates on that.
- */
-export async function notifyTriggeredPlayPublished(input: {
-  orgId: string;
-  playName: string;
-  triggerTypes: MonitorTriggerType[];
-  liveVersion?: number | null;
-  actorEmail?: string | null;
-  requestedAt?: string;
-}): Promise<void> {
-  if (shouldSuppressMonitorActor(input.actorEmail)) return;
-  const triggerTypes = [...new Set(input.triggerTypes)].filter(Boolean);
-  if (triggerTypes.length === 0) return;
-  const requestedAt = input.requestedAt ?? new Date().toISOString();
-  const runtimeEnv = getRuntimeEnv();
-  const triggerLabel = triggerTypes.join(', ');
-  const primary = `${input.playName} | triggers: ${triggerLabel}`;
-  await sendSlackEventSafe(
-    'monitor_activity',
-    buildSlackActivityPayload({
-      source: 'triggered_play_published',
-      activityTitle: 'Triggered play published:',
-      activityPrimary: primary,
-      requestedAt,
-      fallbackText: `Triggered play published - ${input.playName} | triggers ${triggerLabel} | org ${input.orgId}`,
-      fields: [
-        { label: 'Play', value: input.playName },
-        { label: 'Trigger type', value: triggerLabel },
-        {
-          label: 'Live version',
-          value:
-            typeof input.liveVersion === 'number' ? input.liveVersion : null,
-        },
-        { label: 'Org ID', value: input.orgId },
-        { label: 'Actor', value: input.actorEmail ?? null },
-        { label: 'Environment', value: runtimeEnv },
-      ],
-      extra: {
-        orgId: input.orgId,
-        playName: input.playName,
-        triggerTypes,
-        liveVersion: input.liveVersion ?? null,
-        actorEmail: input.actorEmail ?? null,
-        email: input.actorEmail ?? null,
-        runtimeEnv,
-        bypassInternalActorBlock: true,
-      },
-    }),
-  );
-}
-
-/**
- * Monitor disabled -> #deepline-monitor-activity.
- */
-export async function notifyMonitorDisabled(input: {
-  orgId: string;
-  monitorKey: string;
-  reason?: string | null;
-  actorEmail?: string | null;
-  requestedAt?: string;
-}): Promise<void> {
-  await notifyMonitorLifecycleState({
-    event: 'disabled',
-    title: 'Monitor disabled:',
-    source: 'monitor_disabled',
-    orgId: input.orgId,
-    monitorKey: input.monitorKey,
-    reason: input.reason ?? null,
-    actorEmail: input.actorEmail ?? null,
-    requestedAt: input.requestedAt,
-    channel: 'monitor_activity',
-  });
-}
-
-/**
- * Monitor deleted -> #deepline-monitor-activity.
- */
-export async function notifyMonitorDeleted(input: {
-  orgId: string;
-  monitorKey: string;
-  actorEmail?: string | null;
-  requestedAt?: string;
-}): Promise<void> {
-  await notifyMonitorLifecycleState({
-    event: 'deleted',
-    title: 'Monitor deleted:',
-    source: 'monitor_deleted',
-    orgId: input.orgId,
-    monitorKey: input.monitorKey,
-    reason: null,
-    actorEmail: input.actorEmail ?? null,
-    requestedAt: input.requestedAt,
-    channel: 'monitor_activity',
-  });
-}
-
-/**
- * Monitor entered error state -> #deepline-monitor-error-activity.
- * Also used for activity-processing / dispatch failures.
- */
-export async function notifyMonitorError(input: {
-  orgId: string;
-  monitorKey?: string | null;
-  provider?: string | null;
-  sourceCapability?: string | null;
-  reason?: string | null;
-  detail?: string | null;
-  source?: string;
-  actorEmail?: string | null;
-  requestedAt?: string;
-}): Promise<void> {
-  if (shouldSuppressMonitorActor(input.actorEmail)) return;
-  const requestedAt = input.requestedAt ?? new Date().toISOString();
-  const runtimeEnv = getRuntimeEnv();
-  const label = monitorLabel(input);
-  const reason = input.reason?.trim() || 'error';
-  const primary = `${label} | ${reason}`;
-  await sendSlackEventSafe(
-    'monitor_error_activity',
-    buildSlackActivityPayload({
-      source: input.source?.trim() || 'monitor_error',
-      activityTitle: 'Monitor error:',
-      activityPrimary: primary,
-      requestedAt,
-      fallbackText: `Monitor error - ${label} | ${reason} | org ${input.orgId}${input.detail ? ` | ${input.detail}` : ''}`,
-      fields: [
-        { label: 'Monitor', value: input.monitorKey ?? null },
-        { label: 'Provider', value: input.provider ?? null },
-        { label: 'Capability', value: input.sourceCapability ?? null },
-        { label: 'Reason', value: reason },
-        { label: 'Detail', value: input.detail ?? null },
-        { label: 'Org ID', value: input.orgId },
-        { label: 'Actor', value: input.actorEmail ?? null },
-        { label: 'Environment', value: runtimeEnv },
-      ],
-      extra: {
-        orgId: input.orgId,
-        monitorKey: input.monitorKey ?? null,
-        provider: input.provider ?? null,
-        sourceCapability: input.sourceCapability ?? null,
-        reason,
-        actorEmail: input.actorEmail ?? null,
-        email: input.actorEmail ?? null,
-        runtimeEnv,
-        bypassInternalActorBlock: true,
-      },
-    }),
-  );
-}
-
-async function notifyMonitorLifecycleState(input: {
-  event: 'disabled' | 'deleted';
-  title: string;
-  source: string;
-  orgId: string;
-  monitorKey: string;
-  reason: string | null;
-  actorEmail: string | null;
-  requestedAt?: string;
-  channel: 'monitor_activity';
-}): Promise<void> {
-  if (shouldSuppressMonitorActor(input.actorEmail)) return;
-  const requestedAt = input.requestedAt ?? new Date().toISOString();
-  const runtimeEnv = getRuntimeEnv();
-  const primary = input.reason
-    ? `${input.monitorKey} | ${input.reason}`
-    : input.monitorKey;
-  await sendSlackEventSafe(
-    input.channel,
-    buildSlackActivityPayload({
-      source: input.source,
-      activityTitle: input.title,
-      activityPrimary: primary,
-      requestedAt,
-      fallbackText: `Monitor ${input.event} - ${input.monitorKey} | org ${input.orgId}`,
-      fields: [
-        { label: 'Monitor', value: input.monitorKey },
-        { label: 'Reason', value: input.reason },
-        { label: 'Org ID', value: input.orgId },
-        { label: 'Actor', value: input.actorEmail ?? null },
-        { label: 'Environment', value: runtimeEnv },
-      ],
-      extra: {
-        orgId: input.orgId,
-        monitorKey: input.monitorKey,
-        event: input.event,
-        actorEmail: input.actorEmail ?? null,
-        email: input.actorEmail ?? null,
-        runtimeEnv,
-        bypassInternalActorBlock: true,
-      },
-    }),
-  );
-}

package/dist/bundling-sources/shared_libs/monitors/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "@deepline/monitors",
-  "version": "0.0.0",
-  "private": true,
-  "type": "module",
-  "exports": {
-    "./billing/*": "./billing/*.ts",
-    "./*.js": "./*.ts",
-    "./*": "./*.ts"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json --noEmit",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
-  },
-  "dependencies": {
-    "@deepline/billing": "workspace:*",
-    "@deepline/ingestion-v2": "workspace:*",
-    "@deepline/plays": "workspace:*",
-    "next": "16.3.0-canary.60",
-    "pg": "^8.19.0",
-    "react": "19.2.5"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/pg": "^8.16.0",
-    "@types/react": "^19.2.14",
-    "typescript": "^6.0.2"
-  }
-}