@forklaunch/implementation-messaging-twilio 1.0.0

package/lib/eject/services/sms.service.ts

@@ -0,0 +1,216 @@
+import { IdDto } from '@forklaunch/common';
+import {
+  evaluateTelemetryOptions,
+  MetricsDefinition,
+  OpenTelemetryCollector,
+  TelemetryOptions
+} from '@forklaunch/core/http';
+import { SmsStatusEnum } from '@forklaunch/implementation-messaging-base/enum';
+import { SmsMappers } from '@forklaunch/implementation-messaging-base/types';
+import { SmsService } from '@forklaunch/interfaces-messaging/interfaces';
+import { SendSmsDto } from '@forklaunch/interfaces-messaging/types';
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { EntityManager, InferEntity } from '@mikro-orm/core';
+import { TwilioMessageStatusEnum } from '../domain/enum/twilioMessageStatus.enum';
+import {
+  TwilioMessageResource,
+  TwilioSmsDtos,
+  TwilioSmsEntities,
+  TwilioStatusCallbackDto
+} from '../domain/types/twilio.types';
+import { SmsRecord } from '../persistence/entities';
+
+/**
+ * Maps a Twilio message status (from the Messages REST API or a delivery
+ * status callback) onto the canonical SmsStatusEnum.
+ */
+export const mapTwilioMessageStatus = (
+  messageStatus: string
+): SmsStatusEnum => {
+  switch (messageStatus) {
+    case TwilioMessageStatusEnum.SENT:
+      return SmsStatusEnum.SENT;
+    case TwilioMessageStatusEnum.DELIVERED:
+    case TwilioMessageStatusEnum.READ:
+      return SmsStatusEnum.DELIVERED;
+    case TwilioMessageStatusEnum.UNDELIVERED:
+      return SmsStatusEnum.UNDELIVERED;
+    case TwilioMessageStatusEnum.FAILED:
+    case TwilioMessageStatusEnum.CANCELED:
+      return SmsStatusEnum.FAILED;
+    case TwilioMessageStatusEnum.QUEUED:
+    case TwilioMessageStatusEnum.ACCEPTED:
+    case TwilioMessageStatusEnum.SCHEDULED:
+    case TwilioMessageStatusEnum.SENDING:
+    default:
+      return SmsStatusEnum.QUEUED;
+  }
+};
+
+const TWILIO_API_BASE_URL = 'https://api.twilio.com/2010-04-01';
+
+export class TwilioSmsService<
+  SchemaValidator extends AnySchemaValidator,
+  Entities extends TwilioSmsEntities = TwilioSmsEntities,
+  Dto extends TwilioSmsDtos = TwilioSmsDtos
+> implements SmsService<typeof SmsStatusEnum>
+{
+  private evaluatedTelemetryOptions: {
+    logging?: boolean;
+    metrics?: boolean;
+    tracing?: boolean;
+  };
+  protected readonly accountSid: string;
+  protected readonly authToken: string;
+  protected readonly fromNumber: string;
+  public em: EntityManager;
+  protected readonly openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>;
+  protected readonly schemaValidator: SchemaValidator;
+  protected readonly mappers: SmsMappers<typeof SmsStatusEnum, Entities, Dto>;
+
+  constructor(
+    accountSid: string,
+    authToken: string,
+    fromNumber: string,
+    em: EntityManager,
+    openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>,
+    schemaValidator: SchemaValidator,
+    mappers: SmsMappers<typeof SmsStatusEnum, Entities, Dto>,
+    readonly options?: {
+      telemetry?: TelemetryOptions;
+    }
+  ) {
+    this.accountSid = accountSid;
+    this.authToken = authToken;
+    this.fromNumber = fromNumber;
+    this.em = em;
+    this.openTelemetryCollector = openTelemetryCollector;
+    this.schemaValidator = schemaValidator;
+    this.mappers = mappers;
+    this.evaluatedTelemetryOptions = options?.telemetry
+      ? evaluateTelemetryOptions(options.telemetry).enabled
+      : {
+          logging: false,
+          metrics: false,
+          tracing: false
+        };
+  }
+
+  async sendSms(
+    smsDto: SendSmsDto,
+    em?: EntityManager,
+    ...args: unknown[]
+  ): Promise<Dto['SmsRecordMapper']> {
+    if (this.evaluatedTelemetryOptions.logging) {
+      this.openTelemetryCollector.info('Sending sms via twilio', {
+        to: smsDto.to
+      });
+    }
+
+    const smsRecord = await this.mappers.SendSmsMapper.toEntity(
+      smsDto,
+      em ?? this.em,
+      ...(args[0] instanceof EntityManager ? args.slice(1) : args)
+    );
+    const record = smsRecord as {
+      status: SmsStatusEnum;
+      providerMessageId?: string | null;
+      error?: string | null;
+    };
+
+    // the twilio package is intentionally dependency-free — the message is
+    // dispatched via the Twilio Messages REST API with plain fetch
+    const response = await fetch(
+      `${TWILIO_API_BASE_URL}/Accounts/${this.accountSid}/Messages.json`,
+      {
+        method: 'POST',
+        headers: {
+          Authorization: `Basic ${Buffer.from(
+            `${this.accountSid}:${this.authToken}`
+          ).toString('base64')}`,
+          'Content-Type': 'application/x-www-form-urlencoded'
+        },
+        body: new URLSearchParams({
+          To: smsDto.to,
+          From: this.fromNumber,
+          Body: smsDto.body
+        }).toString()
+      }
+    );
+
+    if (response.ok) {
+      const message = (await response.json()) as TwilioMessageResource;
+      record.providerMessageId = message.sid;
+      record.status = mapTwilioMessageStatus(message.status);
+      record.error = message.error_message ?? null;
+    } else {
+      const errorBody = await response.text();
+      record.status = SmsStatusEnum.FAILED;
+      record.error = `Twilio API error (${response.status}): ${errorBody}`;
+      this.openTelemetryCollector.error('Twilio message dispatch failed', {
+        status: response.status,
+        error: errorBody
+      });
+    }
+
+    await (em ?? this.em).transactional(async (innerEm) => {
+      await innerEm.persist(smsRecord);
+    });
+
+    return this.mappers.SmsRecordMapper.toDto(
+      smsRecord as InferEntity<Entities['SmsRecordMapper']>
+    );
+  }
+
+  async getSmsRecord(
+    { id }: IdDto,
+    em?: EntityManager
+  ): Promise<Dto['SmsRecordMapper']> {
+    if (this.evaluatedTelemetryOptions.logging) {
+      this.openTelemetryCollector.info('Getting sms record', { id });
+    }
+
+    const smsRecord = await (em ?? this.em).findOneOrFail(
+      this.mappers.SmsRecordMapper.entity as typeof SmsRecord,
+      { id }
+    );
+
+    return this.mappers.SmsRecordMapper.toDto(
+      smsRecord as InferEntity<Entities['SmsRecordMapper']>
+    );
+  }
+
+  /**
+   * Maps a Twilio delivery-status callback (MessageStatus, MessageSid,
+   * ErrorMessage) onto the persisted record's status.
+   */
+  async processStatusCallback(
+    payload: TwilioStatusCallbackDto,
+    em?: EntityManager
+  ): Promise<Dto['SmsRecordMapper']> {
+    if (this.evaluatedTelemetryOptions.logging) {
+      this.openTelemetryCollector.info('Processing twilio status callback', {
+        messageSid: payload.MessageSid,
+        messageStatus: payload.MessageStatus
+      });
+    }
+
+    const smsRecord = await (em ?? this.em).findOneOrFail(
+      this.mappers.SmsRecordMapper.entity as typeof SmsRecord,
+      { providerMessageId: payload.MessageSid }
+    );
+    const record = smsRecord as {
+      status: SmsStatusEnum;
+      error?: string | null;
+    };
+
+    record.status = mapTwilioMessageStatus(payload.MessageStatus);
+    record.error = payload.ErrorMessage ?? null;
+
+    await (em ?? this.em).flush();
+
+    return this.mappers.SmsRecordMapper.toDto(
+      smsRecord as InferEntity<Entities['SmsRecordMapper']>
+    );
+  }
+}

package/lib/persistence/entities/index.d.ts

@@ -0,0 +1,92 @@
+export declare const SmsRecord: import("@mikro-orm/core").EntitySchemaWithMeta<"SmsRecord", string, import("@mikro-orm/core").InferEntityFromProperties<{
+    readonly id: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "primary"> & {
+        primary: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly to: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly body: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly status: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<any, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, "accessor" | "array" | "autoincrement" | "check" | "collation" | "columnType" | "columnTypes" | "comment" | "compliance" | "concurrencyCheck" | "customOrder" | "default" | "defaultRaw" | "extra" | "fieldName" | "fieldNames" | "formula" | "generated" | "getter" | "getterName" | "groups" | "hidden" | "hydrate" | "ignoreSchemaChanges" | "index" | "lazy" | "length" | "name" | "nativeEnumName" | "nullable" | "onCreate" | "onUpdate" | "persist" | "precision" | "primary" | "ref" | "returning" | "runtimeType" | "scale" | "serializedName" | "serializedPrimaryKey" | "serializer" | "setter" | "type" | "unique" | "unsigned" | "version" | ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type")>, "accessor" | "array" | "autoincrement" | "check" | "collation" | "columnType" | "columnTypes" | "comment" | "compliance" | "concurrencyCheck" | "customOrder" | "default" | "defaultRaw" | "extra" | "fieldName" | "fieldNames" | "formula" | "generated" | "getter" | "getterName" | "groups" | "hidden" | "hydrate" | "ignoreSchemaChanges" | "index" | "lazy" | "length" | "name" | "nativeEnumName" | "nullable" | "onCreate" | "onUpdate" | "persist" | "precision" | "primary" | "ref" | "returning" | "runtimeType" | "scale" | "serializedName" | "serializedPrimaryKey" | "serializer" | "setter" | "type" | "unique" | "unsigned" | "version" | ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type")>;
+    readonly providerMessageId: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly error: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly metadata: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<unknown, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+}, undefined, never, never, false>, never, {
+    readonly id: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "primary"> & {
+        primary: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly to: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly body: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly status: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<any, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, "accessor" | "array" | "autoincrement" | "check" | "collation" | "columnType" | "columnTypes" | "comment" | "compliance" | "concurrencyCheck" | "customOrder" | "default" | "defaultRaw" | "extra" | "fieldName" | "fieldNames" | "formula" | "generated" | "getter" | "getterName" | "groups" | "hidden" | "hydrate" | "ignoreSchemaChanges" | "index" | "lazy" | "length" | "name" | "nativeEnumName" | "nullable" | "onCreate" | "onUpdate" | "persist" | "precision" | "primary" | "ref" | "returning" | "runtimeType" | "scale" | "serializedName" | "serializedPrimaryKey" | "serializer" | "setter" | "type" | "unique" | "unsigned" | "version" | ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type")>, "accessor" | "array" | "autoincrement" | "check" | "collation" | "columnType" | "columnTypes" | "comment" | "compliance" | "concurrencyCheck" | "customOrder" | "default" | "defaultRaw" | "extra" | "fieldName" | "fieldNames" | "formula" | "generated" | "getter" | "getterName" | "groups" | "hidden" | "hydrate" | "ignoreSchemaChanges" | "index" | "lazy" | "length" | "name" | "nativeEnumName" | "nullable" | "onCreate" | "onUpdate" | "persist" | "precision" | "primary" | "ref" | "returning" | "runtimeType" | "scale" | "serializedName" | "serializedPrimaryKey" | "serializer" | "setter" | "type" | "unique" | "unsigned" | "version" | ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type")>;
+    readonly providerMessageId: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly error: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly metadata: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<unknown, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+}, import("@mikro-orm/core").EntityCtor<import("@mikro-orm/core").InferEntityFromProperties<{
+    readonly id: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "primary"> & {
+        primary: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly to: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly body: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly status: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<any, import("@mikro-orm/core").EmptyOptions & {
+        readonly '~c': true;
+    }, "accessor" | "array" | "autoincrement" | "check" | "collation" | "columnType" | "columnTypes" | "comment" | "compliance" | "concurrencyCheck" | "customOrder" | "default" | "defaultRaw" | "extra" | "fieldName" | "fieldNames" | "formula" | "generated" | "getter" | "getterName" | "groups" | "hidden" | "hydrate" | "ignoreSchemaChanges" | "index" | "lazy" | "length" | "name" | "nativeEnumName" | "nullable" | "onCreate" | "onUpdate" | "persist" | "precision" | "primary" | "ref" | "returning" | "runtimeType" | "scale" | "serializedName" | "serializedPrimaryKey" | "serializer" | "setter" | "type" | "unique" | "unsigned" | "version" | ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type")>, "accessor" | "array" | "autoincrement" | "check" | "collation" | "columnType" | "columnTypes" | "comment" | "compliance" | "concurrencyCheck" | "customOrder" | "default" | "defaultRaw" | "extra" | "fieldName" | "fieldNames" | "formula" | "generated" | "getter" | "getterName" | "groups" | "hidden" | "hydrate" | "ignoreSchemaChanges" | "index" | "lazy" | "length" | "name" | "nativeEnumName" | "nullable" | "onCreate" | "onUpdate" | "persist" | "precision" | "primary" | "ref" | "returning" | "runtimeType" | "scale" | "serializedName" | "serializedPrimaryKey" | "serializer" | "setter" | "type" | "unique" | "unsigned" | "version" | ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type")>;
+    readonly providerMessageId: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly error: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<string, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+    readonly metadata: Pick<import("@mikro-orm/core").UniversalPropertyOptionsBuilder<unknown, Omit<import("@mikro-orm/core").EmptyOptions, "nullable"> & {
+        nullable: true;
+    } & {
+        readonly '~c': true;
+    }, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>, ("$type" | "lazyRef" | "strictNullable" | "~options" | "~type") | keyof import("@mikro-orm/core").PropertyOptions<any>>;
+}, undefined, never, never, false>>, undefined>;
+//# sourceMappingURL=index.d.ts.map

package/lib/persistence/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../persistence/entities/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CAWpB,CAAC"}

package/lib/persistence/entities/index.js

@@ -0,0 +1,42 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// persistence/entities/index.ts
+var entities_exports = {};
+__export(entities_exports, {
+  SmsRecord: () => SmsRecord
+});
+module.exports = __toCommonJS(entities_exports);
+var import_persistence = require("@forklaunch/core/persistence");
+var SmsRecord = (0, import_persistence.defineComplianceEntity)({
+  name: "SmsRecord",
+  properties: {
+    id: import_persistence.fp.string().primary().compliance("none"),
+    to: import_persistence.fp.string().compliance("pii"),
+    body: import_persistence.fp.string().compliance("pii"),
+    status: import_persistence.fp.enum().compliance("none"),
+    providerMessageId: import_persistence.fp.string().nullable().compliance("none"),
+    error: import_persistence.fp.string().nullable().compliance("none"),
+    metadata: import_persistence.fp.json().nullable().compliance("none")
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SmsRecord
+});

package/lib/persistence/entities/index.mjs

@@ -0,0 +1,17 @@
+// persistence/entities/index.ts
+import { defineComplianceEntity, fp } from "@forklaunch/core/persistence";
+var SmsRecord = defineComplianceEntity({
+  name: "SmsRecord",
+  properties: {
+    id: fp.string().primary().compliance("none"),
+    to: fp.string().compliance("pii"),
+    body: fp.string().compliance("pii"),
+    status: fp.enum().compliance("none"),
+    providerMessageId: fp.string().nullable().compliance("none"),
+    error: fp.string().nullable().compliance("none"),
+    metadata: fp.json().nullable().compliance("none")
+  }
+});
+export {
+  SmsRecord
+};

package/lib/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './sms.service';
+export * from '@forklaunch/interfaces-messaging/interfaces';
+export * from '@forklaunch/interfaces-messaging/types';
+//# sourceMappingURL=index.d.ts.map

package/lib/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../services/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAE9B,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC"}

package/lib/services/index.js

@@ -0,0 +1,193 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// services/index.ts
+var services_exports = {};
+__export(services_exports, {
+  TwilioSmsService: () => TwilioSmsService,
+  mapTwilioMessageStatus: () => mapTwilioMessageStatus
+});
+module.exports = __toCommonJS(services_exports);
+
+// services/sms.service.ts
+var import_http = require("@forklaunch/core/http");
+var import_enum = require("@forklaunch/implementation-messaging-base/enum");
+var import_core = require("@mikro-orm/core");
+
+// domain/enum/twilioMessageStatus.enum.ts
+var TwilioMessageStatusEnum = {
+  QUEUED: "queued",
+  ACCEPTED: "accepted",
+  SCHEDULED: "scheduled",
+  CANCELED: "canceled",
+  SENDING: "sending",
+  SENT: "sent",
+  DELIVERED: "delivered",
+  UNDELIVERED: "undelivered",
+  FAILED: "failed",
+  RECEIVING: "receiving",
+  RECEIVED: "received",
+  READ: "read"
+};
+
+// services/sms.service.ts
+var mapTwilioMessageStatus = (messageStatus) => {
+  switch (messageStatus) {
+    case TwilioMessageStatusEnum.SENT:
+      return import_enum.SmsStatusEnum.SENT;
+    case TwilioMessageStatusEnum.DELIVERED:
+    case TwilioMessageStatusEnum.READ:
+      return import_enum.SmsStatusEnum.DELIVERED;
+    case TwilioMessageStatusEnum.UNDELIVERED:
+      return import_enum.SmsStatusEnum.UNDELIVERED;
+    case TwilioMessageStatusEnum.FAILED:
+    case TwilioMessageStatusEnum.CANCELED:
+      return import_enum.SmsStatusEnum.FAILED;
+    case TwilioMessageStatusEnum.QUEUED:
+    case TwilioMessageStatusEnum.ACCEPTED:
+    case TwilioMessageStatusEnum.SCHEDULED:
+    case TwilioMessageStatusEnum.SENDING:
+    default:
+      return import_enum.SmsStatusEnum.QUEUED;
+  }
+};
+var TWILIO_API_BASE_URL = "https://api.twilio.com/2010-04-01";
+var TwilioSmsService = class {
+  constructor(accountSid, authToken, fromNumber, em, openTelemetryCollector, schemaValidator, mappers, options) {
+    this.options = options;
+    this.accountSid = accountSid;
+    this.authToken = authToken;
+    this.fromNumber = fromNumber;
+    this.em = em;
+    this.openTelemetryCollector = openTelemetryCollector;
+    this.schemaValidator = schemaValidator;
+    this.mappers = mappers;
+    this.evaluatedTelemetryOptions = options?.telemetry ? (0, import_http.evaluateTelemetryOptions)(options.telemetry).enabled : {
+      logging: false,
+      metrics: false,
+      tracing: false
+    };
+  }
+  options;
+  evaluatedTelemetryOptions;
+  accountSid;
+  authToken;
+  fromNumber;
+  em;
+  openTelemetryCollector;
+  schemaValidator;
+  mappers;
+  async sendSms(smsDto, em, ...args) {
+    if (this.evaluatedTelemetryOptions.logging) {
+      this.openTelemetryCollector.info("Sending sms via twilio", {
+        to: smsDto.to
+      });
+    }
+    const smsRecord = await this.mappers.SendSmsMapper.toEntity(
+      smsDto,
+      em ?? this.em,
+      ...args[0] instanceof import_core.EntityManager ? args.slice(1) : args
+    );
+    const record = smsRecord;
+    const response = await fetch(
+      `${TWILIO_API_BASE_URL}/Accounts/${this.accountSid}/Messages.json`,
+      {
+        method: "POST",
+        headers: {
+          Authorization: `Basic ${Buffer.from(
+            `${this.accountSid}:${this.authToken}`
+          ).toString("base64")}`,
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: new URLSearchParams({
+          To: smsDto.to,
+          From: this.fromNumber,
+          Body: smsDto.body
+        }).toString()
+      }
+    );
+    if (response.ok) {
+      const message = await response.json();
+      record.providerMessageId = message.sid;
+      record.status = mapTwilioMessageStatus(message.status);
+      record.error = message.error_message ?? null;
+    } else {
+      const errorBody = await response.text();
+      record.status = import_enum.SmsStatusEnum.FAILED;
+      record.error = `Twilio API error (${response.status}): ${errorBody}`;
+      this.openTelemetryCollector.error("Twilio message dispatch failed", {
+        status: response.status,
+        error: errorBody
+      });
+    }
+    await (em ?? this.em).transactional(async (innerEm) => {
+      await innerEm.persist(smsRecord);
+    });
+    return this.mappers.SmsRecordMapper.toDto(
+      smsRecord
+    );
+  }
+  async getSmsRecord({ id }, em) {
+    if (this.evaluatedTelemetryOptions.logging) {
+      this.openTelemetryCollector.info("Getting sms record", { id });
+    }
+    const smsRecord = await (em ?? this.em).findOneOrFail(
+      this.mappers.SmsRecordMapper.entity,
+      { id }
+    );
+    return this.mappers.SmsRecordMapper.toDto(
+      smsRecord
+    );
+  }
+  /**
+   * Maps a Twilio delivery-status callback (MessageStatus, MessageSid,
+   * ErrorMessage) onto the persisted record's status.
+   */
+  async processStatusCallback(payload, em) {
+    if (this.evaluatedTelemetryOptions.logging) {
+      this.openTelemetryCollector.info("Processing twilio status callback", {
+        messageSid: payload.MessageSid,
+        messageStatus: payload.MessageStatus
+      });
+    }
+    const smsRecord = await (em ?? this.em).findOneOrFail(
+      this.mappers.SmsRecordMapper.entity,
+      { providerMessageId: payload.MessageSid }
+    );
+    const record = smsRecord;
+    record.status = mapTwilioMessageStatus(payload.MessageStatus);
+    record.error = payload.ErrorMessage ?? null;
+    await (em ?? this.em).flush();
+    return this.mappers.SmsRecordMapper.toDto(
+      smsRecord
+    );
+  }
+};
+
+// services/index.ts
+__reExport(services_exports, require("@forklaunch/interfaces-messaging/interfaces"), module.exports);
+__reExport(services_exports, require("@forklaunch/interfaces-messaging/types"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TwilioSmsService,
+  mapTwilioMessageStatus,
+  ...require("@forklaunch/interfaces-messaging/interfaces"),
+  ...require("@forklaunch/interfaces-messaging/types")
+});