sms-panel-manager 0.0.0-stage → 0.1.0

package/dist/nestjs.cjs

@@ -0,0 +1,151 @@
+'use strict';
+
+var common = require('@nestjs/common');
+var zod = require('zod');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+function createActionPayloadSchema(action) {
+  const shape = {
+    recipient: zod.z.string().min(1)
+  };
+  for (const [key, parameter] of Object.entries(action.params)) {
+    shape[key] = parameter.schema;
+  }
+  return zod.z.object(shape).strict();
+}
+function serializeSmsActions(actions) {
+  return Object.entries(actions).map(([key, action]) => ({
+    key,
+    title: action.title,
+    ...action.description === void 0 ? {} : { description: action.description },
+    parameters: Object.entries(action.params).map(
+      ([parameterKey, parameter]) => ({
+        key: parameterKey,
+        title: parameter.metadata.title,
+        ...parameter.metadata.description === void 0 ? {} : { description: parameter.metadata.description },
+        type: parameter.type,
+        required: !parameter.isOptional
+      })
+    )
+  }));
+}
+
+// src/core/phone.ts
+var IRAN_MOBILE_LOCAL = /^09\d{9}$/;
+var InvalidIranianMobileNumberError = class extends TypeError {
+  code = "invalid_recipient";
+  constructor() {
+    super("Recipient must be a valid Iranian mobile number.");
+    this.name = "InvalidIranianMobileNumberError";
+  }
+};
+function normalizeIranianMobile(input) {
+  const normalized = input.trim().replace(/^0098/, "0").replace(/^\+98/, "0").replace(/^98/, "0");
+  if (!IRAN_MOBILE_LOCAL.test(normalized)) {
+    throw new InvalidIranianMobileNumberError();
+  }
+  return `+98${normalized.slice(1)}`;
+}
+
+// src/core/manager.ts
+function createSmsManager(options) {
+  return {
+    async send(actionKey, payload, sendOptions = {}) {
+      const action = options.actions[actionKey];
+      if (action === void 0) {
+        throw new TypeError(`Unknown SMS action "${actionKey}".`);
+      }
+      const validated = createActionPayloadSchema(action).parse(payload);
+      const { recipient, ...parameters } = validated;
+      return options.executor.execute({
+        actionKey,
+        recipient: normalizeIranianMobile(recipient),
+        parameters,
+        options: sendOptions
+      });
+    }
+  };
+}
+
+// src/nestjs/index.ts
+function createSmsManagerToken(actions) {
+  return /* @__PURE__ */ Symbol(
+    `sms-panel-manager:${Object.keys(actions).sort().join(",")}`
+  );
+}
+function adminControllers(actions, admin) {
+  if (admin?.enabled !== true) return [];
+  if (admin.guard === void 0) {
+    throw new TypeError(
+      "NestJS SMS administration controllers require a host-supplied guard."
+    );
+  }
+  const routePrefix = admin.routePrefix ?? "admin/sms";
+  const metadata = serializeSmsActions(actions);
+  let SmsAdminController = class {
+    actions() {
+      return metadata;
+    }
+  };
+  __decorateClass([
+    common.Get("actions")
+  ], SmsAdminController.prototype, "actions", 1);
+  SmsAdminController = __decorateClass([
+    common.Controller(routePrefix),
+    common.UseGuards(admin.guard)
+  ], SmsAdminController);
+  return [SmsAdminController];
+}
+exports.SmsPanelModule = class SmsPanelModule {
+  static forRoot(options) {
+    const provider = {
+      provide: options.token,
+      useValue: createSmsManager({
+        actions: options.actions,
+        executor: options.executor
+      })
+    };
+    return {
+      module: exports.SmsPanelModule,
+      providers: [provider],
+      controllers: adminControllers(options.actions, options.admin),
+      exports: [options.token]
+    };
+  }
+  static forRootAsync(options) {
+    const provider = {
+      provide: options.token,
+      inject: [...options.inject ?? []],
+      useFactory: async (...dependencies) => {
+        const runtime = await options.useFactory(...dependencies);
+        return createSmsManager({
+          actions: options.actions,
+          executor: runtime.executor
+        });
+      }
+    };
+    return {
+      module: exports.SmsPanelModule,
+      ...options.imports === void 0 ? {} : { imports: options.imports },
+      providers: [provider],
+      controllers: adminControllers(options.actions, options.admin),
+      exports: [options.token]
+    };
+  }
+};
+exports.SmsPanelModule = __decorateClass([
+  common.Module({})
+], exports.SmsPanelModule);
+
+exports.createSmsManagerToken = createSmsManagerToken;
+//# sourceMappingURL=nestjs.cjs.map
+//# sourceMappingURL=nestjs.cjs.map

package/dist/nestjs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/actions.ts","../src/core/phone.ts","../src/core/manager.ts","../src/nestjs/index.ts"],"names":["z","Get","Controller","UseGuards","SmsPanelModule","Module"],"mappings":";;;;;;;;;;;;;;;AAwEO,SAAS,0BACd,MAAA,EAC4B;AAC5B,EAAA,MAAM,KAAA,GAAmC;AAAA,IACvC,SAAA,EAAWA,KAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC;AAAA,GAC7B;AAEA,EAAA,KAAA,MAAW,CAAC,KAAK,SAAS,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,MAAM,CAAA,EAAG;AAC5D,IAAA,KAAA,CAAM,GAAG,IAAI,SAAA,CAAU,MAAA;AAAA,EACzB;AAEA,EAAA,OAAOA,KAAA,CAAE,MAAA,CAAO,KAAK,CAAA,CAAE,MAAA,EAAO;AAChC;AAeO,SAAS,oBACd,OAAA,EACuC;AACvC,EAAA,OAAO,MAAA,CAAO,QAAQ,OAAO,CAAA,CAAE,IAAI,CAAC,CAAC,GAAA,EAAK,MAAM,CAAA,MAAO;AAAA,IACrD,GAAA;AAAA,IACA,OAAO,MAAA,CAAO,KAAA;AAAA,IACd,GAAI,OAAO,WAAA,KAAgB,MAAA,GACvB,EAAC,GACD,EAAE,WAAA,EAAa,MAAA,CAAO,WAAA,EAAY;AAAA,IACtC,UAAA,EAAY,MAAA,CAAO,OAAA,CAAQ,MAAA,CAAO,MAAM,CAAA,CAAE,GAAA;AAAA,MACxC,CAAC,CAAC,YAAA,EAAc,SAAS,CAAA,MAAO;AAAA,QAC9B,GAAA,EAAK,YAAA;AAAA,QACL,KAAA,EAAO,UAAU,QAAA,CAAS,KAAA;AAAA,QAC1B,GAAI,SAAA,CAAU,QAAA,CAAS,WAAA,KAAgB,MAAA,GACnC,EAAC,GACD,EAAE,WAAA,EAAa,SAAA,CAAU,QAAA,CAAS,WAAA,EAAY;AAAA,QAClD,MAAM,SAAA,CAAU,IAAA;AAAA,QAChB,QAAA,EAAU,CAAC,SAAA,CAAU;AAAA,OACvB;AAAA;AACF,GACF,CAAE,CAAA;AACJ;;;ACxHA,IAAM,iBAAA,GAAoB,WAAA;AAEnB,IAAM,+BAAA,GAAN,cAA8C,SAAA,CAAU;AAAA,EACpD,IAAA,GAAO,mBAAA;AAAA,EAEhB,WAAA,GAAc;AACZ,IAAA,KAAA,CAAM,kDAAkD,CAAA;AACxD,IAAA,IAAA,CAAK,IAAA,GAAO,iCAAA;AAAA,EACd;AACF,CAAA;AAEO,SAAS,uBAAuB,KAAA,EAA+B;AACpE,EAAA,MAAM,UAAA,GAAa,KAAA,CAChB,IAAA,EAAK,CACL,QAAQ,OAAA,EAAS,GAAG,CAAA,CACpB,OAAA,CAAQ,OAAA,EAAS,GAAG,CAAA,CACpB,OAAA,CAAQ,OAAO,GAAG,CAAA;AAErB,EAAA,IAAI,CAAC,iBAAA,CAAkB,IAAA,CAAK,UAAU,CAAA,EAAG;AACvC,IAAA,MAAM,IAAI,+BAAA,EAAgC;AAAA,EAC5C;AAEA,EAAA,OAAO,CAAA,GAAA,EAAM,UAAA,CAAW,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAClC;;;ACkBO,SAAS,iBAAgD,OAAA,EAGvC;AACvB,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,CAAK,SAAA,EAAW,OAAA,EAAS,WAAA,GAAc,EAAC,EAAG;AAC/C,MAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,OAAA,CAAQ,SAAS,CAAA;AACxC,MAAA,IAAI,WAAW,MAAA,EAAW;AACxB,QAAA,MAAM,IAAI,SAAA,CAAU,CAAA,oBAAA,EAAuB,SAAS,CAAA,EAAA,CAAI,CAAA;AAAA,MAC1D;AACA,MAAA,MAAM,SAAA,GAAY,yBAAA,CAA0B,MAAM,CAAA,CAAE,MAAM,OAAO,CAAA;AACjE,MAAA,MAAM,EAAE,SAAA,EAAW,GAAG,UAAA,EAAW,GAAI,SAAA;AAErC,MAAA,OAAO,OAAA,CAAQ,SAAS,OAAA,CAAQ;AAAA,QAC9B,SAAA;AAAA,QACA,SAAA,EAAW,uBAAuB,SAAmB,CAAA;AAAA,QACrD,UAAA;AAAA,QACA,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AAAA,GACF;AACF;;;ACjCO,SAAS,sBACd,OAAA,EAC2B;AAC3B,EAAA,uBAAO,MAAA;AAAA,IACL,CAAA,kBAAA,EAAqB,OAAO,IAAA,CAAK,OAAO,EAAE,IAAA,EAAK,CAAE,IAAA,CAAK,GAAG,CAAC,CAAA;AAAA,GAC5D;AACF;AAgCA,SAAS,gBAAA,CACP,SACA,KAAA,EACQ;AACR,EAAA,IAAI,KAAA,EAAO,OAAA,KAAY,IAAA,EAAM,OAAO,EAAC;AACrC,EAAA,IAAI,KAAA,CAAM,UAAU,MAAA,EAAW;AAC7B,IAAA,MAAM,IAAI,SAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,WAAA,GAAc,MAAM,WAAA,IAAe,WAAA;AACzC,EAAA,MAAM,QAAA,GAAW,oBAAoB,OAAO,CAAA;AAI5C,EAAA,IAAM,qBAAN,MAAyB;AAAA,IAEvB,OAAA,GAAiD;AAC/C,MAAA,OAAO,QAAA;AAAA,IACT;AAAA,GACF;AAHE,EAAA,eAAA,CAAA;AAAA,IADCC,WAAI,SAAS;AAAA,GAAA,EADV,kBAAA,CAEJ,SAAA,EAAA,SAAA,EAAA,CAAA,CAAA;AAFI,EAAA,kBAAA,GAAN,eAAA,CAAA;AAAA,IAFCC,kBAAW,WAAW,CAAA;AAAA,IACtBC,gBAAA,CAAU,MAAM,KAAK;AAAA,GAAA,EAChB,kBAAA,CAAA;AAON,EAAA,OAAO,CAAC,kBAAkB,CAAA;AAC5B;AAKaC,yBAAN,oBAAA,CAAqB;AAAA,EAC1B,OAAO,QACL,OAAA,EACe;AACf,IAAA,MAAM,QAAA,GAAqB;AAAA,MACzB,SAAS,OAAA,CAAQ,KAAA;AAAA,MACjB,UAAU,gBAAA,CAAiB;AAAA,QACzB,SAAS,OAAA,CAAQ,OAAA;AAAA,QACjB,UAAU,OAAA,CAAQ;AAAA,OACnB;AAAA,KACH;AAEA,IAAA,OAAO;AAAA,MACL,MAAA,EAAQA,sBAAA;AAAA,MACR,SAAA,EAAW,CAAC,QAAQ,CAAA;AAAA,MACpB,WAAA,EAAa,gBAAA,CAAiB,OAAA,CAAQ,OAAA,EAAS,QAAQ,KAAK,CAAA;AAAA,MAC5D,OAAA,EAAS,CAAC,OAAA,CAAQ,KAAK;AAAA,KACzB;AAAA,EACF;AAAA,EAEA,OAAO,aAIL,OAAA,EACe;AACf,IAAA,MAAM,QAAA,GAAqB;AAAA,MACzB,SAAS,OAAA,CAAQ,KAAA;AAAA,MACjB,QAAQ,CAAC,GAAI,OAAA,CAAQ,MAAA,IAAU,EAAG,CAAA;AAAA,MAClC,UAAA,EAAY,UAAU,YAAA,KAAgC;AACpD,QAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,UAAA,CAAW,GAAG,YAAY,CAAA;AACxD,QAAA,OAAO,gBAAA,CAAiB;AAAA,UACtB,SAAS,OAAA,CAAQ,OAAA;AAAA,UACjB,UAAU,OAAA,CAAQ;AAAA,SACnB,CAAA;AAAA,MACH;AAAA,KACF;AAEA,IAAA,OAAO;AAAA,MACL,MAAA,EAAQA,sBAAA;AAAA,MACR,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ;AAAA,MACpE,SAAA,EAAW,CAAC,QAAQ,CAAA;AAAA,MACpB,WAAA,EAAa,gBAAA,CAAiB,OAAA,CAAQ,OAAA,EAAS,QAAQ,KAAK,CAAA;AAAA,MAC5D,OAAA,EAAS,CAAC,OAAA,CAAQ,KAAK;AAAA,KACzB;AAAA,EACF;AACF;AA9CaA,sBAAA,GAAN,eAAA,CAAA;AAAA,EAHNC,aAAA,CAAO,EAAE;AAAA,CAAA,EAGGD,sBAAA,CAAA","file":"nestjs.cjs","sourcesContent":["import { z } from \"zod\";\n\nimport type { ParameterDescriptor } from \"./parameters.js\";\n\nexport type SmsParameterMap = Readonly<Record<string, ParameterDescriptor>>;\n\nexport interface SmsActionDefinition<\n  TParams extends SmsParameterMap = SmsParameterMap,\n> {\n  readonly title: string;\n  readonly description?: string;\n  readonly params: TParams;\n}\n\nexport type SmsActionMap = Readonly<Record<string, SmsActionDefinition>>;\n\nconst RESERVED_PARAMETER_KEYS = new Set([\n  \"recipient\",\n  \"idempotencyKey\",\n  \"signal\",\n  \"correlationId\",\n  \"metadata\",\n]);\n\nexport function defineSmsActions<const TActions extends SmsActionMap>(\n  actions: TActions,\n): TActions {\n  for (const [actionKey, action] of Object.entries(actions)) {\n    if (!/^[a-z][a-z0-9_]*$/.test(actionKey)) {\n      throw new TypeError(\n        `Invalid SMS action key \"${actionKey}\". Use lower snake_case.`,\n      );\n    }\n\n    for (const parameterKey of Object.keys(action.params)) {\n      if (RESERVED_PARAMETER_KEYS.has(parameterKey)) {\n        throw new TypeError(\n          `SMS action \"${actionKey}\" uses reserved parameter \"${parameterKey}\".`,\n        );\n      }\n    }\n  }\n\n  return actions;\n}\n\ntype RequiredParameterKeys<TParams extends SmsParameterMap> = {\n  [K in keyof TParams]-?: TParams[K][\"isOptional\"] extends true ? never : K;\n}[keyof TParams];\n\ntype OptionalParameterKeys<TParams extends SmsParameterMap> = {\n  [K in keyof TParams]-?: TParams[K][\"isOptional\"] extends true ? K : never;\n}[keyof TParams];\n\ntype InferDescriptor<TDescriptor extends ParameterDescriptor> = z.output<\n  TDescriptor[\"schema\"]\n>;\n\nexport type InferActionPayload<TAction extends SmsActionDefinition> = {\n  recipient: string;\n} & {\n  [K in RequiredParameterKeys<TAction[\"params\"]>]: InferDescriptor<\n    TAction[\"params\"][K]\n  >;\n} & {\n  [K in OptionalParameterKeys<TAction[\"params\"]>]?: InferDescriptor<\n    TAction[\"params\"][K]\n  > extends infer TValue\n    ? Exclude<TValue, undefined>\n    : never;\n};\n\nexport function createActionPayloadSchema(\n  action: SmsActionDefinition,\n): z.ZodObject<z.ZodRawShape> {\n  const shape: Record<string, z.ZodType> = {\n    recipient: z.string().min(1),\n  };\n\n  for (const [key, parameter] of Object.entries(action.params)) {\n    shape[key] = parameter.schema;\n  }\n\n  return z.object(shape).strict();\n}\n\nexport interface SerializableActionMetadata {\n  readonly key: string;\n  readonly title: string;\n  readonly description?: string;\n  readonly parameters: readonly {\n    readonly key: string;\n    readonly title: string;\n    readonly description?: string;\n    readonly type: ParameterDescriptor[\"type\"];\n    readonly required: boolean;\n  }[];\n}\n\nexport function serializeSmsActions(\n  actions: SmsActionMap,\n): readonly SerializableActionMetadata[] {\n  return Object.entries(actions).map(([key, action]) => ({\n    key,\n    title: action.title,\n    ...(action.description === undefined\n      ? {}\n      : { description: action.description }),\n    parameters: Object.entries(action.params).map(\n      ([parameterKey, parameter]) => ({\n        key: parameterKey,\n        title: parameter.metadata.title,\n        ...(parameter.metadata.description === undefined\n          ? {}\n          : { description: parameter.metadata.description }),\n        type: parameter.type,\n        required: !parameter.isOptional,\n      }),\n    ),\n  }));\n}\n","const IRAN_MOBILE_LOCAL = /^09\\d{9}$/;\n\nexport class InvalidIranianMobileNumberError extends TypeError {\n  readonly code = \"invalid_recipient\";\n\n  constructor() {\n    super(\"Recipient must be a valid Iranian mobile number.\");\n    this.name = \"InvalidIranianMobileNumberError\";\n  }\n}\n\nexport function normalizeIranianMobile(input: string): `+98${string}` {\n  const normalized = input\n    .trim()\n    .replace(/^0098/, \"0\")\n    .replace(/^\\+98/, \"0\")\n    .replace(/^98/, \"0\");\n\n  if (!IRAN_MOBILE_LOCAL.test(normalized)) {\n    throw new InvalidIranianMobileNumberError();\n  }\n\n  return `+98${normalized.slice(1)}`;\n}\n\nexport function toIranianLocalMobile(input: string): `09${string}` {\n  const canonical = normalizeIranianMobile(input);\n  return `0${canonical.slice(3)}` as `09${string}`;\n}\n","import {\n  createActionPayloadSchema,\n  type InferActionPayload,\n  type SmsActionMap,\n} from \"./actions.js\";\nimport { normalizeIranianMobile } from \"./phone.js\";\n\nexport interface SmsSendOptions {\n  readonly idempotencyKey?: string;\n  readonly signal?: AbortSignal;\n  readonly correlationId?: string;\n  readonly metadata?: Readonly<\n    Record<string, string | number | boolean | null>\n  >;\n}\n\nexport interface SmsSendResult {\n  readonly operationId: string;\n  readonly status: \"pending\" | \"submitted\" | \"delivered\" | \"failed\" | \"unknown\";\n  readonly providerMessageId?: string;\n}\n\nexport interface SmsSendCommand {\n  readonly actionKey: string;\n  readonly recipient: `+98${string}`;\n  readonly parameters: Readonly<Record<string, unknown>>;\n  readonly options: SmsSendOptions;\n}\n\nexport interface SmsSendExecutor {\n  execute(command: SmsSendCommand): Promise<SmsSendResult>;\n}\n\nexport interface SmsManager<TActions extends SmsActionMap> {\n  send<TKey extends keyof TActions & string>(\n    action: TKey,\n    payload: InferActionPayload<TActions[TKey]>,\n    options?: SmsSendOptions,\n  ): Promise<SmsSendResult>;\n}\n\nexport function createSmsManager<TActions extends SmsActionMap>(options: {\n  readonly actions: TActions;\n  readonly executor: SmsSendExecutor;\n}): SmsManager<TActions> {\n  return {\n    async send(actionKey, payload, sendOptions = {}) {\n      const action = options.actions[actionKey];\n      if (action === undefined) {\n        throw new TypeError(`Unknown SMS action \"${actionKey}\".`);\n      }\n      const validated = createActionPayloadSchema(action).parse(payload);\n      const { recipient, ...parameters } = validated;\n\n      return options.executor.execute({\n        actionKey,\n        recipient: normalizeIranianMobile(recipient as string),\n        parameters,\n        options: sendOptions,\n      });\n    },\n  };\n}\n","import {\n  Controller,\n  Get,\n  Module,\n  UseGuards,\n  type CanActivate,\n  type DynamicModule,\n  type FactoryProvider,\n  type ModuleMetadata,\n  type Provider,\n  type Type,\n} from \"@nestjs/common\";\n\nimport {\n  serializeSmsActions,\n  type SerializableActionMetadata,\n  type SmsActionMap,\n} from \"../core/actions.js\";\nimport {\n  createSmsManager,\n  type SmsManager,\n  type SmsSendExecutor,\n} from \"../core/manager.js\";\n\ndeclare const smsManagerTokenBrand: unique symbol;\nexport type SmsManagerToken<TActions extends SmsActionMap> = symbol & {\n  readonly [smsManagerTokenBrand]: TActions;\n};\n\nexport function createSmsManagerToken<TActions extends SmsActionMap>(\n  actions: TActions,\n): SmsManagerToken<TActions> {\n  return Symbol(\n    `sms-panel-manager:${Object.keys(actions).sort().join(\",\")}`,\n  ) as SmsManagerToken<TActions>;\n}\n\nexport interface SmsAdminModuleOptions {\n  readonly enabled?: boolean;\n  readonly guard?: Type<CanActivate>;\n  readonly routePrefix?: string;\n}\n\nexport interface SmsPanelModuleOptions<TActions extends SmsActionMap> {\n  readonly actions: TActions;\n  readonly token: SmsManagerToken<TActions>;\n  readonly executor: SmsSendExecutor;\n  readonly admin?: SmsAdminModuleOptions;\n}\n\nexport interface SmsPanelRuntimeOptions {\n  readonly executor: SmsSendExecutor;\n}\n\nexport interface SmsPanelModuleAsyncOptions<\n  TActions extends SmsActionMap,\n  TDependencies extends unknown[] = [],\n> extends Pick<ModuleMetadata, \"imports\"> {\n  readonly actions: TActions;\n  readonly token: SmsManagerToken<TActions>;\n  readonly admin?: SmsAdminModuleOptions;\n  readonly inject?: FactoryProvider[\"inject\"];\n  readonly useFactory: (\n    ...dependencies: TDependencies\n  ) => Promise<SmsPanelRuntimeOptions> | SmsPanelRuntimeOptions;\n}\n\nfunction adminControllers(\n  actions: SmsActionMap,\n  admin: SmsAdminModuleOptions | undefined,\n): Type[] {\n  if (admin?.enabled !== true) return [];\n  if (admin.guard === undefined) {\n    throw new TypeError(\n      \"NestJS SMS administration controllers require a host-supplied guard.\",\n    );\n  }\n\n  const routePrefix = admin.routePrefix ?? \"admin/sms\";\n  const metadata = serializeSmsActions(actions);\n\n  @Controller(routePrefix)\n  @UseGuards(admin.guard)\n  class SmsAdminController {\n    @Get(\"actions\")\n    actions(): readonly SerializableActionMetadata[] {\n      return metadata;\n    }\n  }\n\n  return [SmsAdminController];\n}\n\n@Module({})\n// Nest modules intentionally expose static registration methods.\n// eslint-disable-next-line @typescript-eslint/no-extraneous-class\nexport class SmsPanelModule {\n  static forRoot<TActions extends SmsActionMap>(\n    options: SmsPanelModuleOptions<TActions>,\n  ): DynamicModule {\n    const provider: Provider = {\n      provide: options.token,\n      useValue: createSmsManager({\n        actions: options.actions,\n        executor: options.executor,\n      }),\n    };\n\n    return {\n      module: SmsPanelModule,\n      providers: [provider],\n      controllers: adminControllers(options.actions, options.admin),\n      exports: [options.token],\n    };\n  }\n\n  static forRootAsync<\n    TActions extends SmsActionMap,\n    TDependencies extends unknown[] = [],\n  >(\n    options: SmsPanelModuleAsyncOptions<TActions, TDependencies>,\n  ): DynamicModule {\n    const provider: Provider = {\n      provide: options.token,\n      inject: [...(options.inject ?? [])],\n      useFactory: async (...dependencies: TDependencies) => {\n        const runtime = await options.useFactory(...dependencies);\n        return createSmsManager({\n          actions: options.actions,\n          executor: runtime.executor,\n        });\n      },\n    };\n\n    return {\n      module: SmsPanelModule,\n      ...(options.imports === undefined ? {} : { imports: options.imports }),\n      providers: [provider],\n      controllers: adminControllers(options.actions, options.admin),\n      exports: [options.token],\n    };\n  }\n}\n\nexport type InjectedSmsManager<TToken> =\n  TToken extends SmsManagerToken<infer TActions> ? SmsManager<TActions> : never;\n"]}

package/dist/nestjs.d.cts

@@ -0,0 +1,38 @@
+import { Type, CanActivate, DynamicModule, ModuleMetadata, FactoryProvider } from '@nestjs/common';
+import { SmsActionMap, SmsManager, SmsSendExecutor } from './index.cjs';
+import 'zod';
+
+declare const smsManagerTokenBrand: unique symbol;
+type SmsManagerToken<TActions extends SmsActionMap> = symbol & {
+    readonly [smsManagerTokenBrand]: TActions;
+};
+declare function createSmsManagerToken<TActions extends SmsActionMap>(actions: TActions): SmsManagerToken<TActions>;
+interface SmsAdminModuleOptions {
+    readonly enabled?: boolean;
+    readonly guard?: Type<CanActivate>;
+    readonly routePrefix?: string;
+}
+interface SmsPanelModuleOptions<TActions extends SmsActionMap> {
+    readonly actions: TActions;
+    readonly token: SmsManagerToken<TActions>;
+    readonly executor: SmsSendExecutor;
+    readonly admin?: SmsAdminModuleOptions;
+}
+interface SmsPanelRuntimeOptions {
+    readonly executor: SmsSendExecutor;
+}
+interface SmsPanelModuleAsyncOptions<TActions extends SmsActionMap, TDependencies extends unknown[] = []> extends Pick<ModuleMetadata, "imports"> {
+    readonly actions: TActions;
+    readonly token: SmsManagerToken<TActions>;
+    readonly admin?: SmsAdminModuleOptions;
+    readonly inject?: FactoryProvider["inject"];
+    readonly useFactory: (...dependencies: TDependencies) => Promise<SmsPanelRuntimeOptions> | SmsPanelRuntimeOptions;
+}
+declare class SmsPanelModule {
+    static forRoot<TActions extends SmsActionMap>(options: SmsPanelModuleOptions<TActions>): DynamicModule;
+    static forRootAsync<TActions extends SmsActionMap, TDependencies extends unknown[] = []>(options: SmsPanelModuleAsyncOptions<TActions, TDependencies>): DynamicModule;
+}
+type InjectedSmsManager<TToken> = TToken extends SmsManagerToken<infer TActions> ? SmsManager<TActions> : never;
+
+export { SmsPanelModule, createSmsManagerToken };
+export type { InjectedSmsManager, SmsAdminModuleOptions, SmsManagerToken, SmsPanelModuleAsyncOptions, SmsPanelModuleOptions, SmsPanelRuntimeOptions };

package/dist/nestjs.d.ts

@@ -0,0 +1,38 @@
+import { Type, CanActivate, DynamicModule, ModuleMetadata, FactoryProvider } from '@nestjs/common';
+import { SmsActionMap, SmsManager, SmsSendExecutor } from './index.js';
+import 'zod';
+
+declare const smsManagerTokenBrand: unique symbol;
+type SmsManagerToken<TActions extends SmsActionMap> = symbol & {
+    readonly [smsManagerTokenBrand]: TActions;
+};
+declare function createSmsManagerToken<TActions extends SmsActionMap>(actions: TActions): SmsManagerToken<TActions>;
+interface SmsAdminModuleOptions {
+    readonly enabled?: boolean;
+    readonly guard?: Type<CanActivate>;
+    readonly routePrefix?: string;
+}
+interface SmsPanelModuleOptions<TActions extends SmsActionMap> {
+    readonly actions: TActions;
+    readonly token: SmsManagerToken<TActions>;
+    readonly executor: SmsSendExecutor;
+    readonly admin?: SmsAdminModuleOptions;
+}
+interface SmsPanelRuntimeOptions {
+    readonly executor: SmsSendExecutor;
+}
+interface SmsPanelModuleAsyncOptions<TActions extends SmsActionMap, TDependencies extends unknown[] = []> extends Pick<ModuleMetadata, "imports"> {
+    readonly actions: TActions;
+    readonly token: SmsManagerToken<TActions>;
+    readonly admin?: SmsAdminModuleOptions;
+    readonly inject?: FactoryProvider["inject"];
+    readonly useFactory: (...dependencies: TDependencies) => Promise<SmsPanelRuntimeOptions> | SmsPanelRuntimeOptions;
+}
+declare class SmsPanelModule {
+    static forRoot<TActions extends SmsActionMap>(options: SmsPanelModuleOptions<TActions>): DynamicModule;
+    static forRootAsync<TActions extends SmsActionMap, TDependencies extends unknown[] = []>(options: SmsPanelModuleAsyncOptions<TActions, TDependencies>): DynamicModule;
+}
+type InjectedSmsManager<TToken> = TToken extends SmsManagerToken<infer TActions> ? SmsManager<TActions> : never;
+
+export { SmsPanelModule, createSmsManagerToken };
+export type { InjectedSmsManager, SmsAdminModuleOptions, SmsManagerToken, SmsPanelModuleAsyncOptions, SmsPanelModuleOptions, SmsPanelRuntimeOptions };

package/dist/nestjs.js

@@ -0,0 +1,149 @@
+import { Module, Get, Controller, UseGuards } from '@nestjs/common';
+import { z } from 'zod';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+function createActionPayloadSchema(action) {
+  const shape = {
+    recipient: z.string().min(1)
+  };
+  for (const [key, parameter] of Object.entries(action.params)) {
+    shape[key] = parameter.schema;
+  }
+  return z.object(shape).strict();
+}
+function serializeSmsActions(actions) {
+  return Object.entries(actions).map(([key, action]) => ({
+    key,
+    title: action.title,
+    ...action.description === void 0 ? {} : { description: action.description },
+    parameters: Object.entries(action.params).map(
+      ([parameterKey, parameter]) => ({
+        key: parameterKey,
+        title: parameter.metadata.title,
+        ...parameter.metadata.description === void 0 ? {} : { description: parameter.metadata.description },
+        type: parameter.type,
+        required: !parameter.isOptional
+      })
+    )
+  }));
+}
+
+// src/core/phone.ts
+var IRAN_MOBILE_LOCAL = /^09\d{9}$/;
+var InvalidIranianMobileNumberError = class extends TypeError {
+  code = "invalid_recipient";
+  constructor() {
+    super("Recipient must be a valid Iranian mobile number.");
+    this.name = "InvalidIranianMobileNumberError";
+  }
+};
+function normalizeIranianMobile(input) {
+  const normalized = input.trim().replace(/^0098/, "0").replace(/^\+98/, "0").replace(/^98/, "0");
+  if (!IRAN_MOBILE_LOCAL.test(normalized)) {
+    throw new InvalidIranianMobileNumberError();
+  }
+  return `+98${normalized.slice(1)}`;
+}
+
+// src/core/manager.ts
+function createSmsManager(options) {
+  return {
+    async send(actionKey, payload, sendOptions = {}) {
+      const action = options.actions[actionKey];
+      if (action === void 0) {
+        throw new TypeError(`Unknown SMS action "${actionKey}".`);
+      }
+      const validated = createActionPayloadSchema(action).parse(payload);
+      const { recipient, ...parameters } = validated;
+      return options.executor.execute({
+        actionKey,
+        recipient: normalizeIranianMobile(recipient),
+        parameters,
+        options: sendOptions
+      });
+    }
+  };
+}
+
+// src/nestjs/index.ts
+function createSmsManagerToken(actions) {
+  return /* @__PURE__ */ Symbol(
+    `sms-panel-manager:${Object.keys(actions).sort().join(",")}`
+  );
+}
+function adminControllers(actions, admin) {
+  if (admin?.enabled !== true) return [];
+  if (admin.guard === void 0) {
+    throw new TypeError(
+      "NestJS SMS administration controllers require a host-supplied guard."
+    );
+  }
+  const routePrefix = admin.routePrefix ?? "admin/sms";
+  const metadata = serializeSmsActions(actions);
+  let SmsAdminController = class {
+    actions() {
+      return metadata;
+    }
+  };
+  __decorateClass([
+    Get("actions")
+  ], SmsAdminController.prototype, "actions", 1);
+  SmsAdminController = __decorateClass([
+    Controller(routePrefix),
+    UseGuards(admin.guard)
+  ], SmsAdminController);
+  return [SmsAdminController];
+}
+var SmsPanelModule = class {
+  static forRoot(options) {
+    const provider = {
+      provide: options.token,
+      useValue: createSmsManager({
+        actions: options.actions,
+        executor: options.executor
+      })
+    };
+    return {
+      module: SmsPanelModule,
+      providers: [provider],
+      controllers: adminControllers(options.actions, options.admin),
+      exports: [options.token]
+    };
+  }
+  static forRootAsync(options) {
+    const provider = {
+      provide: options.token,
+      inject: [...options.inject ?? []],
+      useFactory: async (...dependencies) => {
+        const runtime = await options.useFactory(...dependencies);
+        return createSmsManager({
+          actions: options.actions,
+          executor: runtime.executor
+        });
+      }
+    };
+    return {
+      module: SmsPanelModule,
+      ...options.imports === void 0 ? {} : { imports: options.imports },
+      providers: [provider],
+      controllers: adminControllers(options.actions, options.admin),
+      exports: [options.token]
+    };
+  }
+};
+SmsPanelModule = __decorateClass([
+  Module({})
+], SmsPanelModule);
+
+export { SmsPanelModule, createSmsManagerToken };
+//# sourceMappingURL=nestjs.js.map
+//# sourceMappingURL=nestjs.js.map

package/dist/nestjs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/actions.ts","../src/core/phone.ts","../src/core/manager.ts","../src/nestjs/index.ts"],"names":[],"mappings":"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","file":"nestjs.js","sourcesContent":["import { z } from \"zod\";\n\nimport type { ParameterDescriptor } from \"./parameters.js\";\n\nexport type SmsParameterMap = Readonly<Record<string, ParameterDescriptor>>;\n\nexport interface SmsActionDefinition<\n  TParams extends SmsParameterMap = SmsParameterMap,\n> {\n  readonly title: string;\n  readonly description?: string;\n  readonly params: TParams;\n}\n\nexport type SmsActionMap = Readonly<Record<string, SmsActionDefinition>>;\n\nconst RESERVED_PARAMETER_KEYS = new Set([\n  \"recipient\",\n  \"idempotencyKey\",\n  \"signal\",\n  \"correlationId\",\n  \"metadata\",\n]);\n\nexport function defineSmsActions<const TActions extends SmsActionMap>(\n  actions: TActions,\n): TActions {\n  for (const [actionKey, action] of Object.entries(actions)) {\n    if (!/^[a-z][a-z0-9_]*$/.test(actionKey)) {\n      throw new TypeError(\n        `Invalid SMS action key \"${actionKey}\". Use lower snake_case.`,\n      );\n    }\n\n    for (const parameterKey of Object.keys(action.params)) {\n      if (RESERVED_PARAMETER_KEYS.has(parameterKey)) {\n        throw new TypeError(\n          `SMS action \"${actionKey}\" uses reserved parameter \"${parameterKey}\".`,\n        );\n      }\n    }\n  }\n\n  return actions;\n}\n\ntype RequiredParameterKeys<TParams extends SmsParameterMap> = {\n  [K in keyof TParams]-?: TParams[K][\"isOptional\"] extends true ? never : K;\n}[keyof TParams];\n\ntype OptionalParameterKeys<TParams extends SmsParameterMap> = {\n  [K in keyof TParams]-?: TParams[K][\"isOptional\"] extends true ? K : never;\n}[keyof TParams];\n\ntype InferDescriptor<TDescriptor extends ParameterDescriptor> = z.output<\n  TDescriptor[\"schema\"]\n>;\n\nexport type InferActionPayload<TAction extends SmsActionDefinition> = {\n  recipient: string;\n} & {\n  [K in RequiredParameterKeys<TAction[\"params\"]>]: InferDescriptor<\n    TAction[\"params\"][K]\n  >;\n} & {\n  [K in OptionalParameterKeys<TAction[\"params\"]>]?: InferDescriptor<\n    TAction[\"params\"][K]\n  > extends infer TValue\n    ? Exclude<TValue, undefined>\n    : never;\n};\n\nexport function createActionPayloadSchema(\n  action: SmsActionDefinition,\n): z.ZodObject<z.ZodRawShape> {\n  const shape: Record<string, z.ZodType> = {\n    recipient: z.string().min(1),\n  };\n\n  for (const [key, parameter] of Object.entries(action.params)) {\n    shape[key] = parameter.schema;\n  }\n\n  return z.object(shape).strict();\n}\n\nexport interface SerializableActionMetadata {\n  readonly key: string;\n  readonly title: string;\n  readonly description?: string;\n  readonly parameters: readonly {\n    readonly key: string;\n    readonly title: string;\n    readonly description?: string;\n    readonly type: ParameterDescriptor[\"type\"];\n    readonly required: boolean;\n  }[];\n}\n\nexport function serializeSmsActions(\n  actions: SmsActionMap,\n): readonly SerializableActionMetadata[] {\n  return Object.entries(actions).map(([key, action]) => ({\n    key,\n    title: action.title,\n    ...(action.description === undefined\n      ? {}\n      : { description: action.description }),\n    parameters: Object.entries(action.params).map(\n      ([parameterKey, parameter]) => ({\n        key: parameterKey,\n        title: parameter.metadata.title,\n        ...(parameter.metadata.description === undefined\n          ? {}\n          : { description: parameter.metadata.description }),\n        type: parameter.type,\n        required: !parameter.isOptional,\n      }),\n    ),\n  }));\n}\n","const IRAN_MOBILE_LOCAL = /^09\\d{9}$/;\n\nexport class InvalidIranianMobileNumberError extends TypeError {\n  readonly code = \"invalid_recipient\";\n\n  constructor() {\n    super(\"Recipient must be a valid Iranian mobile number.\");\n    this.name = \"InvalidIranianMobileNumberError\";\n  }\n}\n\nexport function normalizeIranianMobile(input: string): `+98${string}` {\n  const normalized = input\n    .trim()\n    .replace(/^0098/, \"0\")\n    .replace(/^\\+98/, \"0\")\n    .replace(/^98/, \"0\");\n\n  if (!IRAN_MOBILE_LOCAL.test(normalized)) {\n    throw new InvalidIranianMobileNumberError();\n  }\n\n  return `+98${normalized.slice(1)}`;\n}\n\nexport function toIranianLocalMobile(input: string): `09${string}` {\n  const canonical = normalizeIranianMobile(input);\n  return `0${canonical.slice(3)}` as `09${string}`;\n}\n","import {\n  createActionPayloadSchema,\n  type InferActionPayload,\n  type SmsActionMap,\n} from \"./actions.js\";\nimport { normalizeIranianMobile } from \"./phone.js\";\n\nexport interface SmsSendOptions {\n  readonly idempotencyKey?: string;\n  readonly signal?: AbortSignal;\n  readonly correlationId?: string;\n  readonly metadata?: Readonly<\n    Record<string, string | number | boolean | null>\n  >;\n}\n\nexport interface SmsSendResult {\n  readonly operationId: string;\n  readonly status: \"pending\" | \"submitted\" | \"delivered\" | \"failed\" | \"unknown\";\n  readonly providerMessageId?: string;\n}\n\nexport interface SmsSendCommand {\n  readonly actionKey: string;\n  readonly recipient: `+98${string}`;\n  readonly parameters: Readonly<Record<string, unknown>>;\n  readonly options: SmsSendOptions;\n}\n\nexport interface SmsSendExecutor {\n  execute(command: SmsSendCommand): Promise<SmsSendResult>;\n}\n\nexport interface SmsManager<TActions extends SmsActionMap> {\n  send<TKey extends keyof TActions & string>(\n    action: TKey,\n    payload: InferActionPayload<TActions[TKey]>,\n    options?: SmsSendOptions,\n  ): Promise<SmsSendResult>;\n}\n\nexport function createSmsManager<TActions extends SmsActionMap>(options: {\n  readonly actions: TActions;\n  readonly executor: SmsSendExecutor;\n}): SmsManager<TActions> {\n  return {\n    async send(actionKey, payload, sendOptions = {}) {\n      const action = options.actions[actionKey];\n      if (action === undefined) {\n        throw new TypeError(`Unknown SMS action \"${actionKey}\".`);\n      }\n      const validated = createActionPayloadSchema(action).parse(payload);\n      const { recipient, ...parameters } = validated;\n\n      return options.executor.execute({\n        actionKey,\n        recipient: normalizeIranianMobile(recipient as string),\n        parameters,\n        options: sendOptions,\n      });\n    },\n  };\n}\n","import {\n  Controller,\n  Get,\n  Module,\n  UseGuards,\n  type CanActivate,\n  type DynamicModule,\n  type FactoryProvider,\n  type ModuleMetadata,\n  type Provider,\n  type Type,\n} from \"@nestjs/common\";\n\nimport {\n  serializeSmsActions,\n  type SerializableActionMetadata,\n  type SmsActionMap,\n} from \"../core/actions.js\";\nimport {\n  createSmsManager,\n  type SmsManager,\n  type SmsSendExecutor,\n} from \"../core/manager.js\";\n\ndeclare const smsManagerTokenBrand: unique symbol;\nexport type SmsManagerToken<TActions extends SmsActionMap> = symbol & {\n  readonly [smsManagerTokenBrand]: TActions;\n};\n\nexport function createSmsManagerToken<TActions extends SmsActionMap>(\n  actions: TActions,\n): SmsManagerToken<TActions> {\n  return Symbol(\n    `sms-panel-manager:${Object.keys(actions).sort().join(\",\")}`,\n  ) as SmsManagerToken<TActions>;\n}\n\nexport interface SmsAdminModuleOptions {\n  readonly enabled?: boolean;\n  readonly guard?: Type<CanActivate>;\n  readonly routePrefix?: string;\n}\n\nexport interface SmsPanelModuleOptions<TActions extends SmsActionMap> {\n  readonly actions: TActions;\n  readonly token: SmsManagerToken<TActions>;\n  readonly executor: SmsSendExecutor;\n  readonly admin?: SmsAdminModuleOptions;\n}\n\nexport interface SmsPanelRuntimeOptions {\n  readonly executor: SmsSendExecutor;\n}\n\nexport interface SmsPanelModuleAsyncOptions<\n  TActions extends SmsActionMap,\n  TDependencies extends unknown[] = [],\n> extends Pick<ModuleMetadata, \"imports\"> {\n  readonly actions: TActions;\n  readonly token: SmsManagerToken<TActions>;\n  readonly admin?: SmsAdminModuleOptions;\n  readonly inject?: FactoryProvider[\"inject\"];\n  readonly useFactory: (\n    ...dependencies: TDependencies\n  ) => Promise<SmsPanelRuntimeOptions> | SmsPanelRuntimeOptions;\n}\n\nfunction adminControllers(\n  actions: SmsActionMap,\n  admin: SmsAdminModuleOptions | undefined,\n): Type[] {\n  if (admin?.enabled !== true) return [];\n  if (admin.guard === undefined) {\n    throw new TypeError(\n      \"NestJS SMS administration controllers require a host-supplied guard.\",\n    );\n  }\n\n  const routePrefix = admin.routePrefix ?? \"admin/sms\";\n  const metadata = serializeSmsActions(actions);\n\n  @Controller(routePrefix)\n  @UseGuards(admin.guard)\n  class SmsAdminController {\n    @Get(\"actions\")\n    actions(): readonly SerializableActionMetadata[] {\n      return metadata;\n    }\n  }\n\n  return [SmsAdminController];\n}\n\n@Module({})\n// Nest modules intentionally expose static registration methods.\n// eslint-disable-next-line @typescript-eslint/no-extraneous-class\nexport class SmsPanelModule {\n  static forRoot<TActions extends SmsActionMap>(\n    options: SmsPanelModuleOptions<TActions>,\n  ): DynamicModule {\n    const provider: Provider = {\n      provide: options.token,\n      useValue: createSmsManager({\n        actions: options.actions,\n        executor: options.executor,\n      }),\n    };\n\n    return {\n      module: SmsPanelModule,\n      providers: [provider],\n      controllers: adminControllers(options.actions, options.admin),\n      exports: [options.token],\n    };\n  }\n\n  static forRootAsync<\n    TActions extends SmsActionMap,\n    TDependencies extends unknown[] = [],\n  >(\n    options: SmsPanelModuleAsyncOptions<TActions, TDependencies>,\n  ): DynamicModule {\n    const provider: Provider = {\n      provide: options.token,\n      inject: [...(options.inject ?? [])],\n      useFactory: async (...dependencies: TDependencies) => {\n        const runtime = await options.useFactory(...dependencies);\n        return createSmsManager({\n          actions: options.actions,\n          executor: runtime.executor,\n        });\n      },\n    };\n\n    return {\n      module: SmsPanelModule,\n      ...(options.imports === undefined ? {} : { imports: options.imports }),\n      providers: [provider],\n      controllers: adminControllers(options.actions, options.admin),\n      exports: [options.token],\n    };\n  }\n}\n\nexport type InjectedSmsManager<TToken> =\n  TToken extends SmsManagerToken<infer TActions> ? SmsManager<TActions> : never;\n"]}

package/dist/provider-QoH6qlAe.d.cts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+
+type CredentialVerificationResult = {
+    readonly status: "verified";
+    readonly method: "account" | "credit" | "profile" | "lines";
+    readonly verifiedAt: Date;
+} | {
+    readonly status: "invalid";
+    readonly code: "invalid_credentials";
+} | {
+    readonly status: "unavailable";
+    readonly retryable: boolean;
+};
+type ProviderTemplateCapability = {
+    readonly binding: "named" | "ordered";
+    readonly canList: boolean;
+    readonly canInspect: boolean;
+    readonly canCreate: boolean;
+} | {
+    readonly binding: "fixed-slots";
+    readonly slots: readonly string[];
+    readonly canList: boolean;
+    readonly canInspect: boolean;
+    readonly canCreate: boolean;
+};
+interface ProviderCapabilities {
+    readonly credentialVerification: {
+        readonly mode: "account" | "credit" | "profile" | "lines";
+    } | {
+        readonly mode: "unsupported";
+    };
+    readonly templates: ProviderTemplateCapability;
+    readonly deliveryStatus: "poll" | "webhook" | "poll-and-webhook" | "unsupported";
+    readonly providerIdempotency: boolean;
+}
+interface ProviderCallContext {
+    readonly signal?: AbortSignal;
+    readonly correlationId?: string;
+}
+interface ProviderTemplateSendInput<TTemplateReference = unknown, TProviderParameters = unknown> {
+    readonly recipient: `+98${string}`;
+    readonly template: TTemplateReference;
+    readonly parameters: TProviderParameters;
+    readonly clientReferenceId?: string;
+}
+type ProviderSubmissionResult = {
+    readonly status: "accepted";
+    readonly providerMessageId: string;
+    readonly acceptedAt?: Date;
+} | {
+    readonly status: "rejected";
+    readonly code: string;
+    readonly retryable: false;
+} | {
+    readonly status: "pre-acceptance-failure";
+    readonly code: string;
+    readonly retryable: boolean;
+} | {
+    readonly status: "unknown";
+    readonly code: "unknown_outcome";
+};
+interface SmsProviderAdapter<TCredentials, TTemplateReference = unknown, TProviderParameters = unknown> {
+    readonly id: string;
+    readonly credentialSchema: z.ZodType<TCredentials>;
+    readonly capabilities: ProviderCapabilities;
+    verifyCredentials(credentials: TCredentials, context: ProviderCallContext): Promise<CredentialVerificationResult>;
+    sendTemplate(credentials: TCredentials, input: ProviderTemplateSendInput<TTemplateReference, TProviderParameters>, context: ProviderCallContext): Promise<ProviderSubmissionResult>;
+}
+
+export type { CredentialVerificationResult as C, ProviderCallContext as P, SmsProviderAdapter as S, ProviderCapabilities as a, ProviderSubmissionResult as b, ProviderTemplateCapability as c, ProviderTemplateSendInput as d };

package/dist/provider-QoH6qlAe.d.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+
+type CredentialVerificationResult = {
+    readonly status: "verified";
+    readonly method: "account" | "credit" | "profile" | "lines";
+    readonly verifiedAt: Date;
+} | {
+    readonly status: "invalid";
+    readonly code: "invalid_credentials";
+} | {
+    readonly status: "unavailable";
+    readonly retryable: boolean;
+};
+type ProviderTemplateCapability = {
+    readonly binding: "named" | "ordered";
+    readonly canList: boolean;
+    readonly canInspect: boolean;
+    readonly canCreate: boolean;
+} | {
+    readonly binding: "fixed-slots";
+    readonly slots: readonly string[];
+    readonly canList: boolean;
+    readonly canInspect: boolean;
+    readonly canCreate: boolean;
+};
+interface ProviderCapabilities {
+    readonly credentialVerification: {
+        readonly mode: "account" | "credit" | "profile" | "lines";
+    } | {
+        readonly mode: "unsupported";
+    };
+    readonly templates: ProviderTemplateCapability;
+    readonly deliveryStatus: "poll" | "webhook" | "poll-and-webhook" | "unsupported";
+    readonly providerIdempotency: boolean;
+}
+interface ProviderCallContext {
+    readonly signal?: AbortSignal;
+    readonly correlationId?: string;
+}
+interface ProviderTemplateSendInput<TTemplateReference = unknown, TProviderParameters = unknown> {
+    readonly recipient: `+98${string}`;
+    readonly template: TTemplateReference;
+    readonly parameters: TProviderParameters;
+    readonly clientReferenceId?: string;
+}
+type ProviderSubmissionResult = {
+    readonly status: "accepted";
+    readonly providerMessageId: string;
+    readonly acceptedAt?: Date;
+} | {
+    readonly status: "rejected";
+    readonly code: string;
+    readonly retryable: false;
+} | {
+    readonly status: "pre-acceptance-failure";
+    readonly code: string;
+    readonly retryable: boolean;
+} | {
+    readonly status: "unknown";
+    readonly code: "unknown_outcome";
+};
+interface SmsProviderAdapter<TCredentials, TTemplateReference = unknown, TProviderParameters = unknown> {
+    readonly id: string;
+    readonly credentialSchema: z.ZodType<TCredentials>;
+    readonly capabilities: ProviderCapabilities;
+    verifyCredentials(credentials: TCredentials, context: ProviderCallContext): Promise<CredentialVerificationResult>;
+    sendTemplate(credentials: TCredentials, input: ProviderTemplateSendInput<TTemplateReference, TProviderParameters>, context: ProviderCallContext): Promise<ProviderSubmissionResult>;
+}
+
+export type { CredentialVerificationResult as C, ProviderCallContext as P, SmsProviderAdapter as S, ProviderCapabilities as a, ProviderSubmissionResult as b, ProviderTemplateCapability as c, ProviderTemplateSendInput as d };