@t4h.framework/smtp 0.7.5 → 0.7.7

package/.ai/skills/framework-smtp/SKILL.md

@@ -1,282 +1,92 @@
 ---
 name: framework-smtp
 description: >-
-  Guides correct use of @t4h.framework/smtp in T4H Framework workflows: SMTP
-  send-email activity (SmtpSendEmailActivity), SmtpSendEmailClaim, reconciler-bound
-  Smtp client, recipients/cc/bcc normalization, HTML bodies, Binary attachments,
-  and SmtpSendEmailOutput. Use when sending email from workflows, wiring SMTP
-  claim providers, testing email activities, implementing SmtpSendEmailClaim,
-  or working in packages/smtp.
+  Guides the use of @t4h.framework/smtp to send email from a T4H Framework
+  workflow: the Smtp client and its send() method, the default from, to/cc/bcc
+  recipients, HTML bodies, Binary attachments, SmtpSendEmailOutput.messageId,
+  and how to test with TestWorkflowEnvironment and mockClaim of
+  SmtpSendEmailClaim. Use when a workflow must send an email, a notification
+  or a report with an attachment, or when someone asks for nodemailer, an SMTP
+  transport or an smtp:// connection string in a workflow.
 ---
 
 # @t4h.framework/smtp
 
-SMTP activity, claim, and a reconciler-aware client for sending email inside workflows. Package path: `framework/packages/smtp`. Peer dependency: `@t4h.framework/core` (for `SyncActivity`, `Claim`, `History`, `Binary`, `SerializableClass`).
+## Send an email
 
-Import surface (from `src/smtp.ts` only — do not reference unexported modules):
+1. Declare the connection string as a `Secret` in the `EnvDesign` in
+   `src/constants/environments.ts`. The URL (`smtp://user:pass@host:587`)
+   carries the password.
+2. Create one `Smtp` client and call `send` in the workflow body.
 
 ```typescript
-import {
-  Smtp,
-  SmtpSendEmailActivity,
-  SmtpSendEmailClaim,
-  SmtpSendEmailOutput,
-  type SmtpOptions,
-  type SmtpSendEmailActivityOptions,
-  type SmtpSendEmailActivityInput,
-  type SmtpSendEmailActivityAttachment,
-  type ISmtpSendEmailOutput,
-} from '@t4h.framework/smtp'
-```
-
-Node `>=22`. See [README.md](../../../README.md) for a short overview (note: README may say `sendEmail` on the claim; the actual method is **`send`**).
-
----
-
-## Architecture
-
-`Workflow` → `Smtp.send` (`History.bind(SmtpSendEmailActivity)`) → `SmtpSendEmailActivity.toInput` / `run` → `SmtpSendEmailClaim.send` → `SmtpSendEmailOutput`.
-
-```
-┌─────────────┐     send()      ┌────────────────────────┐     run()     ┌─────────────────────┐
-│    Smtp     │ ──────────────► │ SmtpSendEmailActivity  │ ────────────► │ SmtpSendEmailClaim  │
-│ (client)    │  reconciler     │ (SyncActivity)         │  Claim.smtp   │ (runtime impl)      │
-└─────────────┘                 └────────────────────────┘               └─────────────────────┘
-```
-
-Never call nodemailer or raw SMTP sockets directly in workflow code if the step must be replayable — use `Smtp` / `SmtpSendEmailActivity`.
-
----
-
-## SmtpSendEmailClaim (required for delivery)
-
-Abstract dependency; the **runtime** must register a concrete implementation:
-
-```typescript
-{ provide: SmtpSendEmailClaim, value: new MySmtpSendEmailClaimImpl() }
-```
-
-Contract (from source):
-
-```typescript
-abstract class SmtpSendEmailClaim {
-  abstract send(
-    input: SmtpSendEmailActivityInput,
-  ): ISmtpSendEmailOutput | Promise<ISmtpSendEmailOutput>
-}
-
-type ISmtpSendEmailOutput = { messageId: string }
-```
+// src/constants/environments.ts
+import { EnvDesign, Secret } from '@t4h.framework/core'
 
-`SmtpSendEmailActivity.run` passes the full **`SmtpSendEmailActivityInput`** payload to `claim.send` (sync or async).
-
----
-
-## Send options and payload
-
-The exported `SmtpSendEmailActivity` — driven by `smtp.send` or directly via
-`History.reconciler(SmtpSendEmailActivity, smtp, content)` — is replay-safe and
-delegates to `SmtpSendEmailClaim.send`, returning a `SmtpSendEmailOutput`. Its
-input shapes:
-
-### SmtpSendEmailActivityOptions (what `smtp.send` accepts)
-
-| Field | Type | Required | Notes |
-|-------|------|----------|-------|
-| `to` | `string \| readonly string[]` | yes | Normalized to `readonly string[]` in input |
-| `subject` | `string` | yes | |
-| `html` | `string` | yes | HTML body |
-| `from` | `string?` | no | Overrides `smtp.options.from` |
-| `cc` | `string \| readonly string[]?` | no | String → single-element array |
-| `bcc` | `string \| readonly string[]?` | no | String → single-element array |
-| `attachments` | `readonly SmtpSendEmailActivityAttachment[]?` | no | Passed through unchanged |
-
-### SmtpSendEmailActivityInput (claim / activity payload)
-
-| Field | Type | Notes |
-|-------|------|-------|
-| `connectionString` | `Secret` | From `smtp.connectionString`; the host reads the value when it sends |
-| `from` | `string?` | `content.from ?? smtp.options.from` |
-| `to` | `readonly string[]` | Always an array after `toInput` |
-| `cc` | `readonly string[]?` | Omitted if not set |
-| `bcc` | `readonly string[]?` | Omitted if not set |
-| `subject` | `string` | |
-| `html` | `string` | |
-| `attachments` | `readonly SmtpSendEmailActivityAttachment[]?` | |
-
-### Attachments
-
-```typescript
-import type { Binary } from '@t4h.framework/core'
-
-type SmtpSendEmailActivityAttachment = {
-  filename: string
-  content: Binary
-}
-```
-
-Use framework `Binary` instances (e.g. from an HTTP `response.body`).
-
----
-
-## Smtp client
-
-High-level API: holds `connectionString` (a `Secret` from the `EnvDesign`, since the URL `smtp://user:pass@host:587` carries the password — a string is a `tsc` error) and optional default `from`, extends `SerializableClass` for workflow persistence.
-
-```typescript
-const smtp = new Smtp(environments.SMTP_URL, {
-  from: 'noreply@example.com',
-})
-
-const result = await smtp.send({
-  to: 'recipient@example.com',
-  subject: 'Hello',
-  html: '<p>Hello world</p>',
-})
-
-result.messageId // string — via SmtpSendEmailOutput
-```
-
-- `send(options)` returns a promise of `SmtpSendEmailOutput` when history/reconciler completes (same pattern as `http` client).
-- Default `from`: set on `Smtp` constructor options; per-send `from` in `send()` wins over `smtp.options.from`.
-- `toSerializable()` / `fromSerializable()` restore `connectionString` and `options` (see `Smtp.spec.ts`).
-
-### Multiple recipients, cc, bcc
-
-```typescript
-await smtp.send({
-  to: ['alice@example.com', 'bob@example.com'],
-  cc: 'manager@example.com',
-  bcc: ['audit@example.com'],
-  subject: 'Team Update',
-  html: '<p>Weekly report.</p>',
-})
-```
-
-### Using the exported activity directly via `History.reconciler`
-
-Prefer `smtp.send` in workflows. When you need the exported activity directly,
-drive the **shipped** `SmtpSendEmailActivity` through `History.reconciler` — a
-ready, replay-safe helper. Never define or extend your own activity:
-
-```typescript
-import { History } from '@t4h.framework/core'
-import { Smtp, SmtpSendEmailActivity } from '@t4h.framework/smtp'
-
-const smtp = new Smtp(environments.SMTP_URL) // Secret
-const result = await History.reconciler(SmtpSendEmailActivity, smtp, {
-  to: 'user@example.com',
-  subject: 'Subject',
-  html: '<p>Body</p>',
+export const environments = EnvDesign({
+  SMTP_URL: { type: Secret },
 })
 ```
 
-Runs inside a workflow (the runtime, or `TestWorkflowEnvironment` in tests, provides the reconciler context).
-
----
-
-## SmtpSendEmailOutput
-
 ```typescript
-class SmtpSendEmailOutput {
-  constructor(public readonly raw: ISmtpSendEmailOutput)
-  get messageId(): string
-}
-```
-
-Activity and `Smtp.send` surface this type, not the raw `{ messageId }` object.
-
----
-
-## Workflow example
-
-```typescript
-import { App, EnvDesign, Secret, Workflow } from '@t4h.framework/core'
-import { http } from '@t4h.framework/http'
 import { Smtp } from '@t4h.framework/smtp'
-import Type from 'typebox'
-
-const env = EnvDesign({
-  SMTP_CONNECTION_STRING: { type: Secret }, // carries the password
-  SMTP_FROM: { type: String },
-})
 
-const smtp = new Smtp(env.SMTP_CONNECTION_STRING)
+import { environments } from '../constants/environments.js'
 
-export default new App({
-  id: 'email',
-  workflows: [
-    new Workflow({ id: 'send-email', schema: Type.String() }, async input => {
-      const response = await http.get('https://picsum.photos/300/200')
+const smtp = new Smtp(environments.SMTP_URL, { from: 'noreply@example.com' })
 
-      await smtp.send({
-        from: env.SMTP_FROM,
-        to: input,
-        subject: 'Hello World!',
-        html: '<p>...</p>',
-        attachments: [{ filename: 'image.png', content: response.body.binary }],
-      })
-    }),
-  ],
+const result = await smtp.send({
+  to: input.email,
+  subject: 'Report',
+  html: '<p>See attached.</p>',
+  attachments: [{ filename: 'report.pdf', content: reportBinary }],
 })
-```
-
-Connection strings are opaque to the package; dev implementation expects URL form with credentials in the authority (e.g. `smtp://user:pass@host:587`, `smtps://...`).
-
----
 
-## Testing
-
-Run package tests: `yarn test` in `packages/smtp` (Vitest).
+result.messageId
+```
 
-Test the **workflow** with `TestWorkflowEnvironment` from
-`@t4h.framework/core/testing`, mocking `SmtpSendEmailClaim` — the single claim
-the send activity resolves. See the **framework-workflow-testing** skill for the
-harness API.
+## Traps
+
+- The method is `send`, on the client and on `SmtpSendEmailClaim`. There is no
+  `sendEmail`.
+- `new Smtp(...)` takes a `Secret`. A string literal or a `String` env entry is
+  a type error.
+- The body field is `html`. There is no `text` field.
+- An attachment `content` is a `Binary` (from `sftp.get`, an HTTP body, `write`
+  of `@t4h.framework/fs`). Never build a `Binary` by hand; see the
+  `framework-fs` skill.
+- A `from` in `send` wins over the client default. Without both, `from` is
+  `undefined` and the claim decides.
+- `@t4h.framework/core/no-io-in-workflow` rejects `nodemailer` in a workflow.
+  Do not call an SMTP library; use `Smtp`.
+- Do not `new` or `extend` `SmtpSendEmailActivity`
+  (`@t4h.framework/core/no-framework-activity-in-app`). Use `smtp.send`.
+- The runtime must provide `SmtpSendEmailClaim`.
+
+## Test
+
+Mock `SmtpSendEmailClaim` with its `send` method. The mock receives the
+normalized input: `to`, `cc` and `bcc` are always arrays.
 
 ```typescript
 import { TestWorkflowEnvironment, mockClaim } from '@t4h.framework/core/testing'
 import { SmtpSendEmailClaim } from '@t4h.framework/smtp'
 
-const mockSend = vi.fn().mockImplementation(async () => ({ messageId: 'msg-123' }))
+const send = vi.fn().mockResolvedValue({ messageId: 'msg-123' })
 
 const env = TestWorkflowEnvironment.create({ now: 0 })
 
 await env.execute(workflow, input, {
-  claims: [mockClaim(SmtpSendEmailClaim, { send: mockSend })],
-  env: { SMTP_CONNECTION_STRING: 'smtp://user:pass@smtp.example.com:587' },
+  claims: [mockClaim(SmtpSendEmailClaim, { send })],
+  env: { SMTP_URL: 'smtp://user:pass@smtp.example.com:587' },
 })
 
-// `send` receives the normalized activity input (single `to` becomes an array, etc.)
-expect(mockSend.mock.calls[0][0]).toMatchObject({
-  to: ['recipient@example.com'],
-  subject: 'Test',
-  html: '<p>Hello</p>',
-})
+expect(send.mock.calls[0][0]).toMatchObject({ to: ['recipient@example.com'] })
 ```
 
----
-
-## Implementing SmtpSendEmailClaim
-
-1. Subclass `SmtpSendEmailClaim` and implement **`send(input: SmtpSendEmailActivityInput)`**.
-2. Read `connectionString`, `from`, `to`, `cc`, `bcc`, `subject`, `html`, `attachments` from `input` (arrays already normalized).
-3. Return `{ messageId: string }` (or a Promise thereof). `messageId` is what workflows expose via `SmtpSendEmailOutput.messageId`.
-4. For attachments, consume `Binary` via `.stream()`, `.contentType`, etc.
-5. Register: `{ provide: SmtpSendEmailClaim, value: new MyClaim() }`.
-
----
-
-## Checklist for agents
-
-1. In workflows, use **`Smtp` + `smtp.send()`** (or `History.reconciler` with the exported `SmtpSendEmailActivity`) — never define or extend your own activity.
-2. Ensure runtime provides **`SmtpSendEmailClaim`** (or a mock in tests).
-3. Use **`html`** for the message body; required fields on send options are **`to`**, **`subject`**, **`html`**.
-4. Set default **`from`** on `new Smtp(connectionString, { from })` or per-send; per-send wins.
-5. Pass **`Binary`** for attachment `content`, not raw `Buffer` in activity options.
-6. Expect **`SmtpSendEmailOutput`** from `send`, not a plain object — use `.messageId`.
-7. Test workflows with **`TestWorkflowEnvironment`** + **`mockClaim(SmtpSendEmailClaim, { send })`**; assert on the mock's `mock.calls`.
-8. Do not document or import APIs not exported from `@t4h.framework/smtp`.
-9. For core workflow/reconciler concepts, use the **framework-core** skill (`@t4h.framework/core`).
+## Reference
 
-See also: `packages/smtp/README.md`; **framework-workflow-testing** for the test harness.
+- Guide: https://tech4humans-brasil.github.io/framework/smtp/
+- Secrets: https://tech4humans-brasil.github.io/framework/core/environment
+- Workflow testing: https://tech4humans-brasil.github.io/framework/core/testing
+- Types: `node_modules/@t4h.framework/smtp/dist/smtp.d.ts`

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @t4h.framework/smtp
 
+## 0.7.7
+
+### Patch Changes
+
+- [#257](https://github.com/tech4humans-brasil/framework/pull/257) [`586bfb4`](https://github.com/tech4humans-brasil/framework/commit/586bfb4663f4a478527ee0c8db360603f034d615) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - The smtp README is now short and links to the site. The docs page now has the testing and runtime sections, and the README no longer names a `sendEmail` claim method: the method is `send`.
+
+## 0.7.6
+
+### Patch Changes
+
+- [#241](https://github.com/tech4humans-brasil/framework/pull/241) [`f6b8454`](https://github.com/tech4humans-brasil/framework/commit/f6b845484d22e7c8e7240fe2e113f1cdea7c8ce3) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Adds seven rules to `@t4h.framework/core/eslint` and turns them on in `configs.recommended`:
+  - `no-io-in-workflow` reports `fetch` and calls to network, file, database and mail modules in a workflow and in the `constructor`, `toInput` and `toOutput` of an activity. It also reports `zlib` and `stream` calls there, because they work on the content in memory on each replay.
+  - `no-binary-subclass` reports a class that extends `Binary`.
+  - `no-framework-activity-in-app` reports `new` and `extends` on an activity of a framework package other than the core.
+  - `no-testing-import-in-source` reports an import of a `@t4h.framework/<package>/testing` entry out of a test file.
+  - `require-workflow-id` reports a `Workflow` with no `id`.
+  - `no-secret-to-string` reports a `Secret` that becomes a string.
+  - `no-literal-secret-in-authorization` reports a string literal in the `secret` or `clientSecret` field of an `Authorization`.
+
+  The package skills now name these rules in place of the text that the rules enforce. The docs and skills give each `Workflow` an `id`, read the HMAC secret from `EnvDesign`, and do not document a custom HTTP activity.
+
+- [#243](https://github.com/tech4humans-brasil/framework/pull/243) [`0ffd663`](https://github.com/tech4humans-brasil/framework/commit/0ffd663ce8369edd7b54206cb3216568ad1de471) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - The README examples read each value from `environments`, an `EnvDesign` in `src/constants/environments.ts`, and pass each credential as a `Secret`. They no longer use `process.env`, the raw `env` from the core or a literal in a `Secret` field. The jwks README describes the real context fields (`signature`, `rawPayload`) and says that a token that `jwt.verify` rejects throws.
+
+- [#240](https://github.com/tech4humans-brasil/framework/pull/240) [`0606115`](https://github.com/tech4humans-brasil/framework/commit/0606115e2e0baa994e9f0ed3559ee54ecac88e44) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - The skills do not repeat a rule that a lint rule, `tsc` or a runtime error already enforces. Each such rule is now one line that names the gate. The examples that broke a gate (`process.env`, `as any`, an inline secret, an `EnvDesign` in a workflow file, `ref.output` before `wait()`) are correct now.
+
+- [#228](https://github.com/tech4humans-brasil/framework/pull/228) [`d29e1ab`](https://github.com/tech4humans-brasil/framework/commit/d29e1ab29a039b13c3e4b075472bd615566ae75e) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Uses exact types and `unknown` in place of `any`, and checks external data with guards.
+  - harness: the fix-issues prompt lists each sensor as `- checkTypes: PASS`. Before, it printed `- 0: [object Object]`.
+  - hmac: an algorithm name such as `constructor` throws `Unsupported algorithm`.
+  - oidc: a discovery response with no `introspection_endpoint`, or a null introspection body, throws a clear error.
+  - `HttpRequestActivity.toOutput` takes `HttpRequestActivityOutput` in place of `any`.
+
 ## 0.7.5
 
 ## 0.7.4

package/README.md

@@ -1,106 +1,49 @@
 # @t4h.framework/smtp
 
-SMTP activity, claim, and a high-level client for sending emails within workflows.
+Sends email from a T4H Framework workflow. Each send is a durable step, so a
+replay does not send the message again.
 
-## Claim
+## Install
 
-### SmtpSendEmailClaim
-
-Abstract dependency for sending emails via SMTP. The runtime must provide a concrete implementation.
-
-```typescript
-import { SmtpSendEmailClaim } from '@t4h.framework/smtp'
-
-// the runtime provides this:
-// { provide: SmtpSendEmailClaim, value: new MySmtpSendEmailClaimImpl() }
-```
-
-### Interface
-
-```typescript
-abstract class SmtpSendEmailClaim {
-  public abstract sendEmail(
-    input: SmtpSendEmailActivityInput,
-  ): ISmtpSendEmailOutput | Promise<ISmtpSendEmailOutput>
-}
+```bash
+npm install @t4h.framework/smtp
 ```
 
-## Activity
+Peer dependency: `@t4h.framework/core`.
 
-### SmtpSendEmailActivity
+## Usage
 
-A `SyncActivity` that sends an email and returns a `SmtpSendEmailOutput`. Internally it uses `SmtpSendEmailClaim` to perform the delivery.
+The connection string carries the password, so declare it with
+`type: Secret` in the `EnvDesign` in `src/constants/environments.ts`:
 
 ```typescript
-import { SmtpSendEmailActivity } from '@t4h.framework/smtp'
-```
-
-## Smtp
-
-High-level SMTP client that wraps `SmtpSendEmailActivity` behind a simple API. Instantiated with a connection string and optional defaults.
-
-### Basic usage
-
-```typescript
-import { Smtp } from '@t4h.framework/smtp'
-
-const smtp = new Smtp('smtp://user:pass@smtp.example.com:587')
+// src/constants/environments.ts
+import { EnvDesign, Secret } from '@t4h.framework/core'
 
-const result = await smtp.send({
-  from: 'noreply@example.com',
-  to: 'recipient@example.com',
-  subject: 'Hello',
-  html: '<p>Hello world</p>',
+export const environments = EnvDesign({
+  SMTP_URL: { type: Secret },
 })
-
-result.messageId // string
 ```
 
-### Default sender
-
 ```typescript
-const smtp = new Smtp('smtp://user:pass@smtp.example.com:587', {
-  from: 'noreply@example.com',
-})
-
-const result = await smtp.send({
-  to: 'recipient@example.com',
-  subject: 'Hello',
-  html: '<p>Hello world</p>',
-})
-```
-
-### Multiple recipients, cc, and bcc
+import { Workflow } from '@t4h.framework/core'
+import { Smtp } from '@t4h.framework/smtp'
 
-```typescript
-const result = await smtp.send({
-  to: ['alice@example.com', 'bob@example.com'],
-  cc: 'manager@example.com',
-  bcc: ['audit@example.com'],
-  subject: 'Team Update',
-  html: '<p>Weekly report attached.</p>',
-})
-```
+import { environments } from './constants/environments.js'
 
-### Attachments
+const smtp = new Smtp(environments.SMTP_URL, { from: 'noreply@example.com' })
 
-```typescript
-import type { Binary } from '@t4h.framework/core'
+const notify = new Workflow({ id: 'notify' }, async () => {
+  const result = await smtp.send({
+    to: 'recipient@example.com',
+    subject: 'Hello',
+    html: '<p>Hello world</p>',
+  })
 
-const result = await smtp.send({
-  to: 'recipient@example.com',
-  subject: 'Report',
-  html: '<p>See attached.</p>',
-  attachments: [attachment],
+  return { messageId: result.messageId }
 })
 ```
 
-## Output
+## Documentation
 
-The `SmtpSendEmailOutput` object provides access to the sent message identifier:
-
-```typescript
-const result = await smtp.send({ ... })
-
-result.messageId // string — the message ID returned by the SMTP server
-```
+https://tech4humans-brasil.github.io/framework/smtp/

package/dist/activities/SmtpSendEmailActivity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SmtpSendEmailActivity.d.ts","sourceRoot":"","sources":["../../src/activities/SmtpSendEmailActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAS,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE9E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE7C,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAA;AAEzC,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAC9B,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,SAAS,MAAM,EAAE,CAAA;IACrB,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtB,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAA;CACzD,CAAA;AAED,QAAA,MAAM,+BAA+B,eAEpC,CAAA;AAED,qBAAa,qBAAsB,SAAQ,YAAY,CACrD,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,4BAA4B,CAAC,EAC5D,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,CACpB;IACC,OAAO,CAAC,QAAQ,CAAC,CAAC,+BAA+B,CAAC,CAEhD;IAEK,OAAO,CACZ,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,4BAA4B,GACpC,0BAA0B;IA6BtB,GAAG,CAAC,OAAO,EAAE,0BAA0B;IAIvC,QAAQ,CAAC,MAAM,EAAE,oBAAoB;CAG7C"}
+{"version":3,"file":"SmtpSendEmailActivity.d.ts","sourceRoot":"","sources":["../../src/activities/SmtpSendEmailActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAS,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE9E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE7C,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAA;AAEzC,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAC9B,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,SAAS,MAAM,EAAE,CAAA;IACrB,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtB,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAA;CACzD,CAAA;AAUD,QAAA,MAAM,+BAA+B,eAEpC,CAAA;AAED,qBAAa,qBAAsB,SAAQ,YAAY,CACrD,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,4BAA4B,CAAC,EAC5D,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,CACpB;IACC,OAAO,CAAC,QAAQ,CAAC,CAAC,+BAA+B,CAAC,CAEhD;IAEK,OAAO,CACZ,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,4BAA4B,GACpC,0BAA0B;IAqBtB,GAAG,CAAC,OAAO,EAAE,0BAA0B;IAIvC,QAAQ,CAAC,MAAM,EAAE,oBAAoB;CAG7C"}

package/dist/activities/SmtpSendEmailActivity.js

@@ -1,6 +1,11 @@
 import { Binary, Claim, SyncActivity } from '@t4h.framework/core';
 import { SmtpSendEmailClaim } from '../models/SmtpSendEmailClaim.js';
 import { SmtpSendEmailOutput, } from '../models/SmtpSendEmailOutput.js';
+function toOptionalRecipients(recipients) {
+    if (!recipients)
+        return undefined;
+    return typeof recipients === 'string' ? [recipients] : recipients;
+}
 const SMTP_SEND_EMAIL_ACTIVITY_CLAIMS = Symbol('smtp-send-email-activity-claims');
 export class SmtpSendEmailActivity extends SyncActivity {
     [SMTP_SEND_EMAIL_ACTIVITY_CLAIMS] = new Claim({
@@ -8,17 +13,9 @@ export class SmtpSendEmailActivity extends SyncActivity {
     });
     toInput(smtp, content) {
         const from = content.from ?? smtp.options.from;
-        const to = Array.isArray(content.to) ? content.to : [content.to];
-        const cc = content.cc
-            ? Array.isArray(content.cc)
-                ? content.cc
-                : [content.cc]
-            : undefined;
-        const bcc = content.bcc
-            ? Array.isArray(content.bcc)
-                ? content.bcc
-                : [content.bcc]
-            : undefined;
+        const to = typeof content.to === 'string' ? [content.to] : content.to;
+        const cc = toOptionalRecipients(content.cc);
+        const bcc = toOptionalRecipients(content.bcc);
         return {
             connectionString: smtp.connectionString,
             from,

package/dist/activities/SmtpSendEmailActivity.js.map

@@ -1 +1 @@
-{"version":3,"file":"SmtpSendEmailActivity.js","sourceRoot":"","sources":["../../src/activities/SmtpSendEmailActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAA;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EACL,mBAAmB,GAEpB,MAAM,kCAAkC,CAAA;AA4BzC,MAAM,+BAA+B,GAAG,MAAM,CAC5C,iCAAiC,CAClC,CAAA;AAED,MAAM,OAAO,qBAAsB,SAAQ,YAK1C;IACkB,CAAC,+BAA+B,CAAC,GAAG,IAAI,KAAK,CAAC;QAC7D,IAAI,EAAE,kBAAkB;KACzB,CAAC,CAAA;IAEK,OAAO,CACZ,IAAU,EACV,OAAqC;QAErC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;QAE9C,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAEhE,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE;YACnB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,CAAC,CAAC,OAAO,CAAC,EAAE;gBACZ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAChB,CAAC,CAAC,SAAS,CAAA;QAEb,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG;YACrB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC1B,CAAC,CAAC,OAAO,CAAC,GAAG;gBACb,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;YACjB,CAAC,CAAC,SAAS,CAAA;QAEb,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE;YACF,EAAE;YACF,GAAG;YACH,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAA;IACH,CAAC;IAEM,GAAG,CAAC,OAAmC;QAC5C,OAAO,IAAI,CAAC,+BAA+B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjE,CAAC;IAEM,QAAQ,CAAC,MAA4B;QAC1C,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACxC,CAAC;CACF"}
+{"version":3,"file":"SmtpSendEmailActivity.js","sourceRoot":"","sources":["../../src/activities/SmtpSendEmailActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAA;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EACL,mBAAmB,GAEpB,MAAM,kCAAkC,CAAA;AA4BzC,SAAS,oBAAoB,CAC3B,UAAkD;IAElD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IAEjC,OAAO,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;AACnE,CAAC;AAED,MAAM,+BAA+B,GAAG,MAAM,CAC5C,iCAAiC,CAClC,CAAA;AAED,MAAM,OAAO,qBAAsB,SAAQ,YAK1C;IACkB,CAAC,+BAA+B,CAAC,GAAG,IAAI,KAAK,CAAC;QAC7D,IAAI,EAAE,kBAAkB;KACzB,CAAC,CAAA;IAEK,OAAO,CACZ,IAAU,EACV,OAAqC;QAErC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;QAE9C,MAAM,EAAE,GAAG,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAA;QAErE,MAAM,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAE3C,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAE7C,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE;YACF,EAAE;YACF,GAAG;YACH,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAA;IACH,CAAC;IAEM,GAAG,CAAC,OAAmC;QAC5C,OAAO,IAAI,CAAC,+BAA+B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjE,CAAC;IAEM,QAAQ,CAAC,MAA4B;QAC1C,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACxC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t4h.framework/smtp",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "description": "SMTP module for the T4H Framework",
   "homepage": "https://github.com/tech4humans-brasil/framework/tree/main/packages/smtp",
   "bugs": "https://github.com/tech4humans-brasil/framework/issues",
@@ -26,12 +26,14 @@
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
     "check-types": "tsc --noEmit",
+    "check-package": "publint --strict && attw --pack . --profile esm-only",
+    "lint": "eslint . --max-warnings 0",
     "prepublishOnly": "yarn build",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "devDependencies": {
-    "@t4h.framework/core": "^0.19.0",
+    "@t4h.framework/core": "^0.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },