@stravigor/core 0.1.0 → 0.2.0

package/src/mail/transports/alibaba_transport.ts

@@ -0,0 +1,88 @@
+import crypto from 'node:crypto'
+import { ExternalServiceError } from '../../exceptions/errors.ts'
+import type { MailTransport, MailMessage, MailResult, AlibabaConfig } from '../types.ts'
+
+/**
+ * Alibaba Cloud DirectMail (SingleSendMail) transport.
+ * Uses fetch with HMAC-SHA1 signature — no SDK dependency required.
+ *
+ * Note: SingleSendMail does not support CC, BCC, or attachments.
+ * Use the SMTP interface for those features.
+ *
+ * @see https://www.alibabacloud.com/help/en/directmail/latest/SingleSendMail
+ */
+export class AlibabaTransport implements MailTransport {
+  private accessKeyId: string
+  private accessKeySecret: string
+  private accountName: string
+  private region: string
+
+  constructor(config: AlibabaConfig) {
+    this.accessKeyId = config.accessKeyId
+    this.accessKeySecret = config.accessKeySecret
+    this.accountName = config.accountName
+    this.region = config.region ?? 'cn-hangzhou'
+  }
+
+  async send(message: MailMessage): Promise<MailResult> {
+    const toAddress = Array.isArray(message.to) ? message.to.join(',') : message.to
+
+    const params: Record<string, string> = {
+      Action: 'SingleSendMail',
+      AccountName: this.accountName,
+      AddressType: '1',
+      ReplyToAddress: message.replyTo ? 'true' : 'false',
+      ToAddress: toAddress,
+      Subject: message.subject,
+      Format: 'JSON',
+      Version: '2015-11-23',
+      AccessKeyId: this.accessKeyId,
+      SignatureMethod: 'HMAC-SHA1',
+      SignatureVersion: '1.0',
+      SignatureNonce: crypto.randomUUID(),
+      Timestamp: new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'),
+    }
+
+    if (message.html) params.HtmlBody = message.html
+    if (message.text) params.TextBody = message.text
+    if (message.from) params.FromAlias = message.from
+
+    const signature = this.sign(params)
+    params.Signature = signature
+
+    const body = new URLSearchParams(params).toString()
+    const url = `https://dm.${this.region}.aliyuncs.com`
+
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+      body,
+    })
+
+    if (!response.ok) {
+      const error = await response.text()
+      throw new ExternalServiceError('Alibaba DirectMail', response.status, error)
+    }
+
+    const data = (await response.json()) as { EnvId?: string; RequestId?: string }
+    const toArray = Array.isArray(message.to) ? message.to : [message.to]
+    return { messageId: data.EnvId ?? data.RequestId, accepted: toArray }
+  }
+
+  private percentEncode(str: string): string {
+    return encodeURIComponent(str).replace(/\+/g, '%20').replace(/\*/g, '%2A').replace(/~/g, '%7E')
+  }
+
+  private sign(params: Record<string, string>): string {
+    const sortedKeys = Object.keys(params).sort()
+    const canonicalized = sortedKeys
+      .map(k => `${this.percentEncode(k)}=${this.percentEncode(params[k]!)}`)
+      .join('&')
+
+    const stringToSign = `POST&${this.percentEncode('/')}&${this.percentEncode(canonicalized)}`
+
+    const hmac = crypto.createHmac('sha1', `${this.accessKeySecret}&`)
+    hmac.update(stringToSign)
+    return hmac.digest('base64')
+  }
+}

package/src/mail/transports/mailgun_transport.ts

@@ -0,0 +1,74 @@
+import { ExternalServiceError } from '../../exceptions/errors.ts'
+import type { MailTransport, MailMessage, MailResult, MailgunConfig } from '../types.ts'
+
+/**
+ * Mailgun HTTP API transport.
+ * Uses fetch with FormData — no SDK dependency required.
+ *
+ * @see https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Messages/
+ */
+export class MailgunTransport implements MailTransport {
+  private apiKey: string
+  private domain: string
+  private baseUrl: string
+
+  constructor(config: MailgunConfig) {
+    this.apiKey = config.apiKey
+    this.domain = config.domain
+    this.baseUrl = config.baseUrl ?? 'https://api.mailgun.net'
+  }
+
+  async send(message: MailMessage): Promise<MailResult> {
+    const form = new FormData()
+
+    form.append('from', message.from)
+    form.append('subject', message.subject)
+
+    const toArray = Array.isArray(message.to) ? message.to : [message.to]
+    form.append('to', toArray.join(', '))
+
+    if (message.cc) {
+      const ccArray = Array.isArray(message.cc) ? message.cc : [message.cc]
+      form.append('cc', ccArray.join(', '))
+    }
+    if (message.bcc) {
+      const bccArray = Array.isArray(message.bcc) ? message.bcc : [message.bcc]
+      form.append('bcc', bccArray.join(', '))
+    }
+    if (message.replyTo) form.append('h:Reply-To', message.replyTo)
+    if (message.html) form.append('html', message.html)
+    if (message.text) form.append('text', message.text)
+
+    if (message.attachments?.length) {
+      for (const a of message.attachments) {
+        const content =
+          typeof a.content === 'string'
+            ? new Blob([a.content], { type: a.contentType ?? 'application/octet-stream' })
+            : new Blob([a.content], { type: a.contentType ?? 'application/octet-stream' })
+
+        if (a.cid) {
+          form.append('inline', content, a.filename)
+        } else {
+          form.append('attachment', content, a.filename)
+        }
+      }
+    }
+
+    const credentials = btoa(`api:${this.apiKey}`)
+    const response = await fetch(`${this.baseUrl}/v3/${this.domain}/messages`, {
+      method: 'POST',
+      headers: {
+        Authorization: `Basic ${credentials}`,
+      },
+      body: form,
+    })
+
+    if (!response.ok) {
+      const error = await response.text()
+      throw new ExternalServiceError('Mailgun', response.status, error)
+    }
+
+    const data = (await response.json()) as { id: string }
+    return { messageId: data.id, accepted: toArray }
+  }
+}

package/src/mail/transports/resend_transport.ts

@@ -30,11 +30,10 @@ export class ResendTransport implements MailTransport {
     if (message.text) body.text = message.text
 
     if (message.attachments?.length) {
-      body.attachments = message.attachments.map((a) => ({
+      body.attachments = message.attachments.map(a => ({
         filename: a.filename,
-        content: typeof a.content === 'string'
-          ? a.content
-          : Buffer.from(a.content).toString('base64'),
+        content:
+          typeof a.content === 'string' ? a.content : Buffer.from(a.content).toString('base64'),
         content_type: a.contentType,
       }))
     }

package/src/mail/transports/sendgrid_transport.ts

@@ -19,17 +19,19 @@ export class SendGridTransport implements MailTransport {
   async send(message: MailMessage): Promise<MailResult> {
     const toArray = Array.isArray(message.to) ? message.to : [message.to]
 
-    const personalizations: Record<string, unknown>[] = [{
-      to: toArray.map((email) => ({ email })),
-    }]
+    const personalizations: Record<string, unknown>[] = [
+      {
+        to: toArray.map(email => ({ email })),
+      },
+    ]
 
     if (message.cc) {
       const ccArray = Array.isArray(message.cc) ? message.cc : [message.cc]
-      personalizations[0]!.cc = ccArray.map((email) => ({ email }))
+      personalizations[0]!.cc = ccArray.map(email => ({ email }))
     }
     if (message.bcc) {
       const bccArray = Array.isArray(message.bcc) ? message.bcc : [message.bcc]
-      personalizations[0]!.bcc = bccArray.map((email) => ({ email }))
+      personalizations[0]!.bcc = bccArray.map(email => ({ email }))
     }
 
     const content: { type: string; value: string }[] = []
@@ -46,11 +48,12 @@ export class SendGridTransport implements MailTransport {
     if (message.replyTo) body.reply_to = { email: message.replyTo }
 
     if (message.attachments?.length) {
-      body.attachments = message.attachments.map((a) => ({
+      body.attachments = message.attachments.map(a => ({
         filename: a.filename,
-        content: typeof a.content === 'string'
-          ? Buffer.from(a.content).toString('base64')
-          : Buffer.from(a.content).toString('base64'),
+        content:
+          typeof a.content === 'string'
+            ? Buffer.from(a.content).toString('base64')
+            : Buffer.from(a.content).toString('base64'),
         type: a.contentType,
         disposition: a.cid ? 'inline' : 'attachment',
         content_id: a.cid,

package/src/mail/transports/smtp_transport.ts

@@ -21,17 +21,17 @@ export class SmtpTransport implements MailTransport {
     const info = await this.transporter.sendMail({
       from: message.from,
       to: Array.isArray(message.to) ? message.to.join(', ') : message.to,
-      cc: message.cc
-        ? Array.isArray(message.cc) ? message.cc.join(', ') : message.cc
-        : undefined,
+      cc: message.cc ? (Array.isArray(message.cc) ? message.cc.join(', ') : message.cc) : undefined,
       bcc: message.bcc
-        ? Array.isArray(message.bcc) ? message.bcc.join(', ') : message.bcc
+        ? Array.isArray(message.bcc)
+          ? message.bcc.join(', ')
+          : message.bcc
         : undefined,
       replyTo: message.replyTo,
       subject: message.subject,
       html: message.html,
       text: message.text,
-      attachments: message.attachments?.map((a) => ({
+      attachments: message.attachments?.map(a => ({
         filename: a.filename,
         content: a.content,
         contentType: a.contentType,

package/src/mail/types.ts

@@ -55,6 +55,22 @@ export interface SendGridConfig {
   baseUrl?: string
 }
 
+export interface MailgunConfig {
+  apiKey: string
+  domain: string
+  /** Default: 'https://api.mailgun.net'. EU: 'https://api.eu.mailgun.net' */
+  baseUrl?: string
+}
+
+export interface AlibabaConfig {
+  accessKeyId: string
+  accessKeySecret: string
+  /** Sender address configured in Alibaba DirectMail. */
+  accountName: string
+  /** Default: 'cn-hangzhou' */
+  region?: string
+}
+
 export interface LogConfig {
   /** Write to 'console' or a file path. */
   output: 'console' | string
@@ -63,7 +79,7 @@ export interface LogConfig {
 // -- Top-level mail config ----------------------------------------------------
 
 export interface MailConfig {
-  /** Default transport name: 'smtp' | 'resend' | 'sendgrid' | 'log' */
+  /** Default transport name: 'smtp' | 'resend' | 'sendgrid' | 'mailgun' | 'alibaba' | 'log' */
   default: string
   /** Default "from" address. */
   from: string
@@ -76,5 +92,7 @@ export interface MailConfig {
   smtp: SmtpConfig
   resend: ResendConfig
   sendgrid: SendGridConfig
+  mailgun: MailgunConfig
+  alibaba: AlibabaConfig
   log: LogConfig
 }

package/src/notification/channels/discord_channel.ts

@@ -1,5 +1,10 @@
 import { ExternalServiceError } from '../../exceptions/errors.ts'
-import type { NotificationChannel, Notifiable, NotificationPayload, NotificationConfig } from '../types.ts'
+import type {
+  NotificationChannel,
+  Notifiable,
+  NotificationPayload,
+  NotificationConfig,
+} from '../types.ts'
 
 /**
  * Delivers notifications via Discord webhook.

package/src/notification/channels/webhook_channel.ts

@@ -1,5 +1,10 @@
 import { ExternalServiceError } from '../../exceptions/errors.ts'
-import type { NotificationChannel, Notifiable, NotificationPayload, NotificationConfig } from '../types.ts'
+import type {
+  NotificationChannel,
+  Notifiable,
+  NotificationPayload,
+  NotificationConfig,
+} from '../types.ts'
 
 /**
  * Delivers notifications via HTTP POST to a webhook URL.
@@ -28,8 +33,8 @@ export class WebhookChannel implements NotificationChannel {
 
     const headers: Record<string, string> = {
       'Content-Type': 'application/json',
-      ...(this.config.webhooks?.default?.headers),
-      ...(envelope.headers),
+      ...this.config.webhooks?.default?.headers,
+      ...envelope.headers,
     }
 
     const response = await fetch(url, {

package/src/notification/helpers.ts

@@ -16,7 +16,7 @@ import Database from '../database/database.ts'
  */
 export async function notify(
   notifiable: Notifiable | Notifiable[],
-  notification: BaseNotification,
+  notification: BaseNotification
 ): Promise<void> {
   const recipients = Array.isArray(notifiable) ? notifiable : [notifiable]
 
@@ -44,7 +44,7 @@ export async function notify(
           queue: notification.queueOptions().queue ?? NotificationManager.config.queue,
           delay: notification.queueOptions().delay,
           attempts: notification.queueOptions().attempts,
-        },
+        }
       )
     } else {
       await sendNow(recipient, notification)
@@ -187,10 +187,7 @@ export const notifications = {
         for (const binding of bindings) {
           const notification = binding.create(eventPayload)
           const recipients = await binding.recipients(eventPayload)
-          await notify(
-            Array.isArray(recipients) ? recipients : [recipients],
-            notification,
-          )
+          await notify(Array.isArray(recipients) ? recipients : [recipients], notification)
         }
       })
     }
@@ -207,7 +204,10 @@ function hydrateNotification(row: Record<string, unknown>): NotificationRecord {
     notifiableType: row.notifiable_type as string,
     notifiableId: row.notifiable_id as string,
     type: row.type as string,
-    data: (typeof row.data === 'string' ? JSON.parse(row.data) : row.data) as Record<string, unknown>,
+    data: (typeof row.data === 'string' ? JSON.parse(row.data) : row.data) as Record<
+      string,
+      unknown
+    >,
     readAt: (row.read_at as Date) ?? null,
     createdAt: row.created_at as Date,
   }

package/src/notification/notification_manager.ts

@@ -32,10 +32,13 @@ export default class NotificationManager {
   constructor(db: Database, config: Configuration) {
     NotificationManager._db = db
     NotificationManager._config = {
-      channels: (config.get('notification.channels', ['database']) as string[]),
+      channels: config.get('notification.channels', ['database']) as string[],
       queue: config.get('notification.queue', 'default') as string,
-      webhooks: (config.get('notification.webhooks', {}) as Record<string, { url: string; headers?: Record<string, string> }>),
-      discord: (config.get('notification.discord', {}) as Record<string, string>),
+      webhooks: config.get('notification.webhooks', {}) as Record<
+        string,
+        { url: string; headers?: Record<string, string> }
+      >,
+      discord: config.get('notification.discord', {}) as Record<string, string>,
     }
 
     // Register built-in channels
@@ -47,9 +50,7 @@ export default class NotificationManager {
 
   static get db(): Database {
     if (!NotificationManager._db) {
-      throw new Error(
-        'NotificationManager not configured. Resolve it through the container first.'
-      )
+      throw new Error('NotificationManager not configured. Resolve it through the container first.')
     }
     return NotificationManager._db
   }

package/src/orm/base_model.ts

@@ -22,7 +22,9 @@ export default class BaseModel {
   /** The underlying database connection. */
   static get db(): Database {
     if (!BaseModel._db) {
-      throw new ConfigurationError('Database not configured. Resolve BaseModel through the container first.')
+      throw new ConfigurationError(
+        'Database not configured. Resolve BaseModel through the container first.'
+      )
     }
     return BaseModel._db
   }
@@ -341,7 +343,7 @@ export default class BaseModel {
 }
 
 /** Convert a raw DB row to a plain object with camelCase keys and DateTime hydration. */
-function hydrateRow(row: Record<string, unknown>): Record<string, unknown> {
+export function hydrateRow(row: Record<string, unknown>): Record<string, unknown> {
   const obj: Record<string, unknown> = {}
   for (const [column, value] of Object.entries(row)) {
     const prop = toCamelCase(column)

package/src/queue/queue.ts

@@ -86,7 +86,9 @@ export default class Queue {
 
   static get db(): Database {
     if (!Queue._db)
-      throw new ConfigurationError('Queue not configured. Resolve Queue through the container first.')
+      throw new ConfigurationError(
+        'Queue not configured. Resolve Queue through the container first.'
+      )
     return Queue._db
   }
 

package/src/scheduler/cron.ts

@@ -17,11 +17,11 @@ export interface CronExpression {
 }
 
 const FIELD_RANGES: [number, number][] = [
-  [0, 59],  // minute
-  [0, 23],  // hour
-  [1, 31],  // day of month
-  [1, 12],  // month
-  [0, 6],   // day of week
+  [0, 59], // minute
+  [0, 23], // hour
+  [1, 31], // day of month
+  [1, 12], // month
+  [0, 6], // day of week
 ]
 
 // Parse a 5-field cron string into expanded numeric arrays.
@@ -37,7 +37,13 @@ export function parseCron(expression: string): CronExpression {
     parseField(part, FIELD_RANGES[i]![0], FIELD_RANGES[i]![1])
   )
 
-  return { minute: minute!, hour: hour!, dayOfMonth: dayOfMonth!, month: month!, dayOfWeek: dayOfWeek! }
+  return {
+    minute: minute!,
+    hour: hour!,
+    dayOfMonth: dayOfMonth!,
+    month: month!,
+    dayOfWeek: dayOfWeek!,
+  }
 }
 
 /**

package/src/scheduler/schedule.ts

@@ -4,13 +4,20 @@ import type { CronExpression } from './cron.ts'
 export type TaskHandler = () => void | Promise<void>
 
 const DAY_NAMES: Record<string, number> = {
-  sunday: 0, sun: 0,
-  monday: 1, mon: 1,
-  tuesday: 2, tue: 2,
-  wednesday: 3, wed: 3,
-  thursday: 4, thu: 4,
-  friday: 5, fri: 5,
-  saturday: 6, sat: 6,
+  sunday: 0,
+  sun: 0,
+  monday: 1,
+  mon: 1,
+  tuesday: 2,
+  tue: 2,
+  wednesday: 3,
+  wed: 3,
+  thursday: 4,
+  thu: 4,
+  friday: 5,
+  fri: 5,
+  saturday: 6,
+  sat: 6,
 }
 
 /**
@@ -176,7 +183,9 @@ function dayToNumber(day: string): number {
   const n = DAY_NAMES[day.toLowerCase()]
   if (n === undefined) {
     throw new Error(
-      `Invalid day name "${day}": expected one of ${Object.keys(DAY_NAMES).filter((_, i) => i % 2 === 0).join(', ')}`
+      `Invalid day name "${day}": expected one of ${Object.keys(DAY_NAMES)
+        .filter((_, i) => i % 2 === 0)
+        .join(', ')}`
     )
   }
   return n

package/src/session/session_manager.ts

@@ -41,7 +41,9 @@ export default class SessionManager {
 
   static get db(): Database {
     if (!SessionManager._db) {
-      throw new ConfigurationError('SessionManager not configured. Resolve it through the container first.')
+      throw new ConfigurationError(
+        'SessionManager not configured. Resolve it through the container first.'
+      )
     }
     return SessionManager._db
   }

package/src/storage/storage_manager.ts

@@ -48,7 +48,9 @@ export default class StorageManager {
 
   static get driver(): StorageDriver {
     if (!StorageManager._driver) {
-      throw new ConfigurationError('StorageManager not configured. Resolve it through the container first.')
+      throw new ConfigurationError(
+        'StorageManager not configured. Resolve it through the container first.'
+      )
     }
     return StorageManager._driver
   }

package/src/view/compiler.ts

@@ -159,9 +159,7 @@ function compileDirective(
     }
 
     case 'islands': {
-      const src = token.args
-        ? token.args.replace(/^['"]|['"]$/g, '').trim()
-        : '/islands.js'
+      const src = token.args ? token.args.replace(/^['"]|['"]$/g, '').trim() : '/islands.js'
       lines.push(`__out += '<script src="${escapeJs(src)}"><\\/script>';`)
       break
     }

package/src/view/islands/island_builder.ts

@@ -25,7 +25,7 @@ export class IslandBuilder {
     this.islandsDir = resolve(options.islandsDir ?? './islands')
     this.outDir = resolve(options.outDir ?? './public')
     this.outFile = options.outFile ?? 'islands.js'
-    this.minify = options.minify ?? (Bun.env.NODE_ENV === 'production')
+    this.minify = options.minify ?? Bun.env.NODE_ENV === 'production'
   }
 
   /** Discover all .vue files in the islands directory. */
@@ -123,9 +123,9 @@ export class IslandBuilder {
       target: 'browser',
       plugins: [virtualEntryPlugin, vueSfcPlugin()],
       define: {
-        '__VUE_OPTIONS_API__': 'true',
-        '__VUE_PROD_DEVTOOLS__': 'false',
-        '__VUE_PROD_HYDRATION_MISMATCH_DETAILS__': 'false',
+        __VUE_OPTIONS_API__: 'true',
+        __VUE_PROD_DEVTOOLS__: 'false',
+        __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: 'false',
       },
     })
 

package/src/view/islands/vue_plugin.ts

@@ -11,7 +11,7 @@ export function vueSfcPlugin(): BunPlugin {
   return {
     name: 'vue-sfc',
     setup(build) {
-      build.onLoad({ filter: /\.vue$/ }, async (args) => {
+      build.onLoad({ filter: /\.vue$/ }, async args => {
         const source = await Bun.file(args.path).text()
         const id = hashId(args.path)
         const scopeId = `data-v-${id}`
@@ -35,11 +35,13 @@ export function vueSfcPlugin(): BunPlugin {
             id,
             inlineTemplate: !!descriptor.scriptSetup,
             sourceMap: false,
-            templateOptions: scoped ? {
-              scoped: true,
-              id,
-              compilerOptions: { scopeId },
-            } : undefined,
+            templateOptions: scoped
+              ? {
+                  scoped: true,
+                  id,
+                  compilerOptions: { scopeId },
+                }
+              : undefined,
           })
           scriptCode = result.content
           bindings = result.bindings
@@ -62,7 +64,7 @@ export function vueSfcPlugin(): BunPlugin {
 
           if (result.errors.length > 0) {
             throw new Error(
-              `Vue template error in ${args.path}:\n${result.errors.map(e => typeof e === 'string' ? e : e.message).join('\n')}`
+              `Vue template error in ${args.path}:\n${result.errors.map(e => (typeof e === 'string' ? e : e.message)).join('\n')}`
             )
           }
 
@@ -100,10 +102,7 @@ export function vueSfcPlugin(): BunPlugin {
           // <script setup> with inlineTemplate — scriptCode is a complete module
           // Rewrite the default export to capture the component and set __scopeId
           if (scoped) {
-            output += scriptCode.replace(
-              /export\s+default\s+/,
-              'const __sfc__ = '
-            ) + '\n'
+            output += scriptCode.replace(/export\s+default\s+/, 'const __sfc__ = ') + '\n'
             output += `__sfc__.__scopeId = ${JSON.stringify(scopeId)};\n`
             output += 'export default __sfc__;\n'
           } else {
@@ -112,10 +111,7 @@ export function vueSfcPlugin(): BunPlugin {
         } else {
           // Options API — stitch script + template render function
           if (scriptCode) {
-            output += scriptCode.replace(
-              /export\s+default\s*\{/,
-              'const __component__ = {'
-            ) + '\n'
+            output += scriptCode.replace(/export\s+default\s*\{/, 'const __component__ = {') + '\n'
           } else {
             output += 'const __component__ = {};\n'
           }

package/src/view/tokenizer.ts

@@ -16,7 +16,17 @@ export interface Token {
   line: number
 }
 
-const DIRECTIVES = new Set(['if', 'elseif', 'else', 'end', 'each', 'layout', 'block', 'include', 'islands'])
+const DIRECTIVES = new Set([
+  'if',
+  'elseif',
+  'else',
+  'end',
+  'each',
+  'layout',
+  'block',
+  'include',
+  'islands',
+])
 
 export function tokenize(source: string): Token[] {
   const tokens: Token[] = []