@dilipod/ui 0.4.29 → 0.4.30

package/dist/lib/slack.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Slack Block Kit Helpers
+ *
+ * Shared Slack message and block builders used by both platform and admin apps.
+ * Pure functions with zero dependencies — same pattern as email.ts.
+ *
+ * Transport layers (sendSlackMessage, sendSlackWebhook) stay local in each app.
+ */
+export interface SlackBlock {
+    type: string;
+    text?: {
+        type: string;
+        text: string;
+    };
+    elements?: SlackElement[];
+    fields?: SlackField[];
+}
+export interface SlackElement {
+    type: string;
+    text?: {
+        type: string;
+        text: string;
+    };
+    style?: string;
+    value?: string;
+    url?: string;
+    action_id?: string;
+}
+export interface SlackField {
+    type: string;
+    text: string;
+}
+export interface SlackMessage {
+    text: string;
+    blocks: SlackBlock[];
+}
+/**
+ * Build a single mrkdwn section block.
+ *
+ *   slackSection('*Hello* world')
+ */
+export declare function slackSection(mrkdwn: string): SlackBlock;
+/**
+ * Build a key-value fields block.
+ *
+ *   slackFields({ Worker: 'Invoice Bot', Status: 'Live' })
+ */
+export declare function slackFields(fields: Record<string, string | number>): SlackBlock;
+/**
+ * Build an actions block with buttons.
+ *
+ *   slackActions([
+ *     { text: 'View', url: 'https://...' },
+ *     { text: 'Approve', actionId: 'approve', style: 'primary', value: '123' },
+ *   ])
+ */
+export declare function slackActions(buttons: {
+    text: string;
+    url?: string;
+    value?: string;
+    actionId?: string;
+    style?: 'primary' | 'danger';
+}[]): SlackBlock;
+/**
+ * Build a complete Slack message with optional details, note, and button.
+ * Covers 90% of notification use cases.
+ *
+ *   slackMessage({
+ *     title: '🚀 New signup',
+ *     details: { Name: 'John', Email: 'john@acme.com' },
+ *     note: 'First user from this company',
+ *     buttonText: 'View Customer',
+ *     buttonUrl: 'https://admin.dilipod.com/customers/123',
+ *   })
+ */
+export declare function slackMessage(options: {
+    title: string;
+    details?: Record<string, string | number>;
+    note?: string;
+    buttonText?: string;
+    buttonUrl?: string;
+}): SlackMessage;
+//# sourceMappingURL=slack.d.ts.map

package/dist/lib/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/lib/slack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,UAAU,CAQ/E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;CAC7B,EAAE,GACF,UAAU,CAYZ;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,YAAY,CAmBf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dilipod/ui",
-  "version": "0.4.29",
+  "version": "0.4.30",
   "description": "Dilipod Design System - Shared UI components and styles",
   "author": "Dilipod <hello@dilipod.com>",
   "license": "MIT",

package/src/index.ts

@@ -318,6 +318,10 @@ export { formatCentsToEuros, formatEuros, formatDuration, formatRelativeTime } f
 // Email Template Helpers
 export { emailTemplate, buttonHtml, infoBoxHtml, noteBoxHtml } from './lib/email'
 
+// Slack Block Kit Helpers
+export { slackMessage, slackSection, slackFields, slackActions } from './lib/slack'
+export type { SlackBlock, SlackElement, SlackField, SlackMessage } from './lib/slack'
+
 // Utilities
 export { cn } from './lib/utils'
 

package/src/lib/slack.ts

@@ -0,0 +1,142 @@
+/**
+ * Slack Block Kit Helpers
+ *
+ * Shared Slack message and block builders used by both platform and admin apps.
+ * Pure functions with zero dependencies — same pattern as email.ts.
+ *
+ * Transport layers (sendSlackMessage, sendSlackWebhook) stay local in each app.
+ */
+
+// ============================================
+// Types
+// ============================================
+
+export interface SlackBlock {
+  type: string
+  text?: { type: string; text: string }
+  elements?: SlackElement[]
+  fields?: SlackField[]
+}
+
+export interface SlackElement {
+  type: string
+  text?: { type: string; text: string }
+  style?: string
+  value?: string
+  url?: string
+  action_id?: string
+}
+
+export interface SlackField {
+  type: string
+  text: string
+}
+
+export interface SlackMessage {
+  text: string
+  blocks: SlackBlock[]
+}
+
+// ============================================
+// Block Builders
+// ============================================
+
+/**
+ * Build a single mrkdwn section block.
+ *
+ *   slackSection('*Hello* world')
+ */
+export function slackSection(mrkdwn: string): SlackBlock {
+  return {
+    type: 'section',
+    text: { type: 'mrkdwn', text: mrkdwn },
+  }
+}
+
+/**
+ * Build a key-value fields block.
+ *
+ *   slackFields({ Worker: 'Invoice Bot', Status: 'Live' })
+ */
+export function slackFields(fields: Record<string, string | number>): SlackBlock {
+  return {
+    type: 'section',
+    fields: Object.entries(fields).map(([key, value]) => ({
+      type: 'mrkdwn',
+      text: `*${key}:*\n${value}`,
+    })),
+  }
+}
+
+/**
+ * Build an actions block with buttons.
+ *
+ *   slackActions([
+ *     { text: 'View', url: 'https://...' },
+ *     { text: 'Approve', actionId: 'approve', style: 'primary', value: '123' },
+ *   ])
+ */
+export function slackActions(
+  buttons: {
+    text: string
+    url?: string
+    value?: string
+    actionId?: string
+    style?: 'primary' | 'danger'
+  }[]
+): SlackBlock {
+  return {
+    type: 'actions',
+    elements: buttons.map((btn) => ({
+      type: 'button',
+      text: { type: 'plain_text', text: btn.text },
+      ...(btn.url ? { url: btn.url } : {}),
+      ...(btn.value ? { value: btn.value } : {}),
+      ...(btn.actionId ? { action_id: btn.actionId } : {}),
+      ...(btn.style ? { style: btn.style } : {}),
+    })),
+  }
+}
+
+// ============================================
+// Message Builder
+// ============================================
+
+/**
+ * Build a complete Slack message with optional details, note, and button.
+ * Covers 90% of notification use cases.
+ *
+ *   slackMessage({
+ *     title: '🚀 New signup',
+ *     details: { Name: 'John', Email: 'john@acme.com' },
+ *     note: 'First user from this company',
+ *     buttonText: 'View Customer',
+ *     buttonUrl: 'https://admin.dilipod.com/customers/123',
+ *   })
+ */
+export function slackMessage(options: {
+  title: string
+  details?: Record<string, string | number>
+  note?: string
+  buttonText?: string
+  buttonUrl?: string
+}): SlackMessage {
+  const blocks: SlackBlock[] = [slackSection(`*${options.title}*`)]
+
+  if (options.details && Object.keys(options.details).length > 0) {
+    blocks.push(slackFields(options.details))
+  }
+
+  if (options.note) {
+    blocks.push(slackSection(options.note))
+  }
+
+  if (options.buttonUrl && options.buttonText) {
+    blocks.push(slackActions([{ text: options.buttonText, url: options.buttonUrl }]))
+  }
+
+  return {
+    text: options.title,
+    blocks,
+  }
+}