Skip to content

keel 1.0.0

Choose a tag to compare

@jackson-asmith jackson-asmith released this 14 Oct 17:44
· 19 commits to main since this release
687243c

First release of keel: PowerShell modules for unattended automation that sends email and calls REST APIs.

keel.Mail 1.0.0

Send-Email sends mail through Microsoft Graph by default, with Send-MailMessage-style parameters.

  • Graph authentication: an access token, an existing Microsoft Graph SDK session, or app-only sign-in with a certificate or client secret.
  • SMTP: explicit SMTP delivery, or SMTP fallback when Graph refuses a message or can't be reached.
  • No duplicate sends: retries and fallback happen only when the failure proves Graph didn't accept the message. When delivery is uncertain, Send-Email stops with a GraphDeliveryUnknown error instead of risking a second copy. The Graph SDK's own retries are turned off for each send for the same reason.
  • Attachments: one or more files, checked against Graph's 3 MB inline limit before anything is sent.
  • Host configuration: defaults for routing, credentials, Cc, and Reply-To come from KEEL_* environment variables, so many scripts on a host can be reconfigured in one place. Explicit parameters always win.
  • Supports -WhatIf and -Confirm.

keel.Http 1.0.0

Vendor-neutral retry helpers for REST calls.

  • Invoke-WithBoundedRetry: exponential backoff with jitter, a configurable list of retryable status codes, and Retry-After support.
  • Get-RetryableStatusCode: reads the HTTP status from errors raised by Invoke-RestMethod, Invoke-WebRequest, and the Graph SDK, across PowerShell versions.

Requirements

  • Windows PowerShell 5.1 or PowerShell 7+.
  • For Graph delivery: the Mail.Send application permission, plus an access token or Microsoft.Graph.Authentication.

On Windows PowerShell 5.1, SMTP delivery can't set a Reply-To header, because 5.1's Send-MailMessage has no -ReplyTo parameter. The message is sent without it and a warning is written.

Documentation

  • README: installation, usage, environment variables, and testing.
  • ADR 0001: why configuration comes from environment variables.
  • ADR 0002: why keel never resends after an ambiguous Graph failure.

Tested on Ubuntu, macOS, and Windows with PowerShell 7, and on Windows PowerShell 5.1.