@particle-academy/fancy-connector-core 0.9.0 → 0.10.1

package/dist/index.d.cts

@@ -1256,6 +1256,92 @@ declare function classifyThrown(cause: unknown, ctx: ConnectorErrorContext): Con
  */
 declare function httpFailure(status: number, body: string, retryAfter?: string | null): Error;
 
+/**
+ * RFC 5545 in, a structured invite and its join targets out — the read MOIC's
+ * meeting bot needs from nothing but the text a calendar API hands back.
+ *
+ * Written from scratch (the owner: no third-party code), as ONE
+ * implementation in two runtimes — `php/src/Ical.php` is the twin — and held
+ * to the authored corpus under `fixtures/ical/`, which both must reproduce
+ * exactly. `fixtures/ical/README.md` lists every decision a case pins; the
+ * ones easy to get differently in two languages are restated here:
+ *
+ * - Folded lines (a line break followed by a single space or tab) join
+ *   before anything else runs; TEXT values are then RFC 5545-unescaped
+ *   (`\n`, `\,`, `\;`, `\\`).
+ * - `DTSTART`/`DTEND` always come back as UTC instants. A `Z` suffix passes
+ *   through; a `TZID` parameter resolves through the calendar's own
+ *   `VTIMEZONE` (an unknown TZID is refused BY NAME, never guessed); a value
+ *   with neither — RFC 5545's FLOATING time — is treated as UTC, a decision
+ *   named here rather than left to look like an oversight: resolving a
+ *   floating time correctly needs the READER's timezone, which nothing in
+ *   the invite carries.
+ * - `RRULE` support is intentionally narrow: `FREQ` daily/weekly/monthly/
+ *   yearly with `INTERVAL`, `COUNT` and `UNTIL`, and `BYDAY` for WEEKLY only.
+ *   No `BYMONTHDAY`, `BYSETPOS`, `BYWEEKNO`, `BYYEARDAY`, `WKST`, `EXDATE` or
+ *   `RDATE` — a recurring invite using one of those still parses (its RRULE
+ *   fields are read, never dropped), but `nextOccurrence` does not attempt
+ *   to walk it.
+ * - Join targets are ALLOW-LISTED: Google Meet, Zoom (with its meeting id
+ *   and passcode read out of the URL), Microsoft Teams, and a dial-in phone
+ *   number with a passcode read from its own line. Anything else is ignored,
+ *   never guessed at — a bot that tried an unknown link shape would attempt
+ *   to join something it cannot handle.
+ */
+type InviteMethod = "REQUEST" | "CANCEL";
+type Attendee = {
+    name: string | null;
+    email: string;
+    role: string | null;
+    partstat: string | null;
+};
+type RecurrenceRule = {
+    freq: "DAILY" | "WEEKLY" | "MONTHLY" | "YEARLY";
+    interval: number;
+    count: number | null;
+    until: string | null;
+    byDay: string[] | null;
+};
+type Invite = {
+    method: InviteMethod;
+    uid: string;
+    sequence: number;
+    summary: string | null;
+    description: string | null;
+    location: string | null;
+    status: string | null;
+    dtstart: string;
+    dtend: string | null;
+    organizer: {
+        name: string | null;
+        email: string;
+    } | null;
+    attendees: Attendee[];
+    rrule: RecurrenceRule | null;
+};
+type JoinTargetKind = "google-meet" | "zoom" | "teams" | "dial-in";
+type JoinTarget = {
+    kind: JoinTargetKind;
+    url: string | null;
+    meetingId: string | null;
+    passcode: string | null;
+    phone: string | null;
+};
+declare function parseInvite(raw: string): Invite;
+/**
+ * The next occurrence at or after `afterIso`, or `null` when the series (or
+ * the single occurrence, for a non-recurring invite) has nothing left to
+ * offer at or after that instant.
+ */
+declare function nextOccurrence(invite: Invite, afterIso: string): string | null;
+/**
+ * The allow-listed places a bot can actually join, in the order they appear
+ * in the text. Anything else — Webex, a generic link, an unrecognised
+ * dial-in shape — is not returned: a shape this package does not know is a
+ * shape a bot should not guess at.
+ */
+declare function joinTargets(invite: Invite): JoinTarget[];
+
 /**
  * A run, a position inside it, and how many times that position has been tried.
  *
@@ -1567,18 +1653,6 @@ declare function byteRangeOf(text: string, charIndex: number, substring: string)
  * exception three frames away.
  */
 declare function sliceByteRange(text: string, range: ByteRange): string;
-/**
- * Bare URLs in `text`, with their UTF-8 byte ranges.
- *
- * Trailing punctuation is excluded: a link at the end of a sentence would
- * otherwise swallow the full stop and 404. Closing brackets go too, for the same
- * reason and because a URL in parentheses is common in prose.
- *
- * This is the generic half of a "link facet" — a connector maps the ranges into
- * whatever its provider's rich-text shape is. The package owns the offsets
- * because the offsets are what people get wrong; it does not own the provider's
- * schema, because that is the provider's.
- */
 declare function linkRanges(text: string): Array<ByteRange & {
     url: string;
 }>;
@@ -2603,4 +2677,4 @@ declare function verifyDelivery(trigger: TriggerDescriptor, delivery: InboundDel
  */
 declare function triggerEvent(trigger: TriggerDescriptor, connection: ResolvedConnection, injected: unknown, config: Record<string, unknown>): unknown;
 
-export { AMBIGUOUS_REFUSAL, type ApiContract, type Attempt, type ByteRange, CANONICAL_METRICS, CONNECTOR_API_VERSION, CONNECTOR_MODES, CREDENTIAL_SCOPES, type CallOptions, type CallResult, type Capabilities, type Catalogue, type ChainLinks, type ChainOutcome, type ChainRef, type ChallengeHandshake, type Citation, type Classified, type ConnectionCredentials, type ConnectionHost, type ConnectionSpec, type Connector, ConnectorAmbiguous, ConnectorApiMismatch, ConnectorAuthError, ConnectorConfigError, ConnectorError, type ConnectorErrorContext, type ConnectorFaker, ConnectorIdempotencyExpiredError, type ConnectorMode, ConnectorModeError, ConnectorRateLimited, type ConnectorRequest, ConnectorRequestError, type ConnectorResult, ConnectorTransient, ConnectorUnreachable, type ContractOperation, type CredentialField, type CredentialScope, DEFAULT_IDEMPOTENCY_WINDOW_SECONDS, DEFAULT_RETRY, type DeliveryDeclaration, type DeliveryMechanism, type DeliveryOutcome, type DriftFinding, type DriftReport, EXPIRES_AT_UNITS, type ExpiresAtUnit, FAKE_EPOCH, type FailureKind, type FakeRequest, type FakeValues, type HmacScheme, type HmacVerificationSpec, type HostEnvironment, type IdempotencyOptions, type InboundDelivery, type LeaseAction, type LeaseDeclaration, type LeaseState, MAX_IDEMPOTENCY_KEY_LENGTH, type MetricDescriptor, type MetricSample, type MimeAttachment, type MimeHeader, type MimeMessage, type MimePart, type ModeInputs, NO_IDEMPOTENCY_KEY_WARNING, PROBLEM_SEVERITIES, type PreparedRequest, type ProbeOutcome, type ProbeReport, type ProbeResult, type ProbeSpec, type Problem, type ProviderAdapter, RENDERER_VERSION, REVIEW_STALE_DAYS, type RecordedShape, type RenderRules, type RenderedPayload, type RequestedMode, type ResolveOptions, type ResolvedConnection, type RetryPolicy, type RunIdentity, SANDBOX_KINDS, SUPPORTED_CONNECTOR_API, type SandboxKind, type Segment, type ServiceDescriptor, type SetupStep, type ShapeMismatch, type SharedTokenScheme, type SharedTokenVerificationSpec, type SpecSource, type SubscriptionLease, type TextUnit, type Transport, type TransportResponse, type TriggerDescriptor, type VerifyResult, type WebhookVerification, type WebhookVerificationSpec, assertConnectorApi, byteRangeOf, callConnector, capabilityProblems, checkAgainstOpenApi, checkAgainstRecordedShape, classifyError, classifyHttp, classifyStatus, classifyThrown, compareShape, connectionsFor, constantTimeEquals, deliver, fakeRequest, fakeValues, getConnectionHost, graphemes, handshakeResponse, header, hmac, httpFailure, idempotencyKeyFor, isEmptyPayload, isRemote, isSharedTokenScheme, isSharedTokenSpec, isUnconditionallyRetryable, leaseAction, leaseFromResponse, leaseRenewAt, leaseState, linkRanges, measure, parseMime, payloadHash, postChain, probe, providerProblems, providerSandboxIsSelectable, registerConnectionHost, registerTransport, render, reported, resetRateState, resolveConnection, resolveConnectorMode, respectRate, runIdentityFrom, runKeyFrom, runProbes, sandboxIsSelectable, sandboxRefusal, satisfiesMinimum, secretKeyBytes, seedFrom, shapeOf, shouldRetry, sliceByteRange, splitToFit, subscriptionLease, triggerEvent, unchecked, utf8Length, verifyDelivery, verifyHmac, verifySharedToken, withResolvedLimit };
+export { AMBIGUOUS_REFUSAL, type ApiContract, type Attempt, type Attendee, type ByteRange, CANONICAL_METRICS, CONNECTOR_API_VERSION, CONNECTOR_MODES, CREDENTIAL_SCOPES, type CallOptions, type CallResult, type Capabilities, type Catalogue, type ChainLinks, type ChainOutcome, type ChainRef, type ChallengeHandshake, type Citation, type Classified, type ConnectionCredentials, type ConnectionHost, type ConnectionSpec, type Connector, ConnectorAmbiguous, ConnectorApiMismatch, ConnectorAuthError, ConnectorConfigError, ConnectorError, type ConnectorErrorContext, type ConnectorFaker, ConnectorIdempotencyExpiredError, type ConnectorMode, ConnectorModeError, ConnectorRateLimited, type ConnectorRequest, ConnectorRequestError, type ConnectorResult, ConnectorTransient, ConnectorUnreachable, type ContractOperation, type CredentialField, type CredentialScope, DEFAULT_IDEMPOTENCY_WINDOW_SECONDS, DEFAULT_RETRY, type DeliveryDeclaration, type DeliveryMechanism, type DeliveryOutcome, type DriftFinding, type DriftReport, EXPIRES_AT_UNITS, type ExpiresAtUnit, FAKE_EPOCH, type FailureKind, type FakeRequest, type FakeValues, type HmacScheme, type HmacVerificationSpec, type HostEnvironment, type IdempotencyOptions, type InboundDelivery, type Invite, type InviteMethod, type JoinTarget, type JoinTargetKind, type LeaseAction, type LeaseDeclaration, type LeaseState, MAX_IDEMPOTENCY_KEY_LENGTH, type MetricDescriptor, type MetricSample, type MimeAttachment, type MimeHeader, type MimeMessage, type MimePart, type ModeInputs, NO_IDEMPOTENCY_KEY_WARNING, PROBLEM_SEVERITIES, type PreparedRequest, type ProbeOutcome, type ProbeReport, type ProbeResult, type ProbeSpec, type Problem, type ProviderAdapter, RENDERER_VERSION, REVIEW_STALE_DAYS, type RecordedShape, type RecurrenceRule, type RenderRules, type RenderedPayload, type RequestedMode, type ResolveOptions, type ResolvedConnection, type RetryPolicy, type RunIdentity, SANDBOX_KINDS, SUPPORTED_CONNECTOR_API, type SandboxKind, type Segment, type ServiceDescriptor, type SetupStep, type ShapeMismatch, type SharedTokenScheme, type SharedTokenVerificationSpec, type SpecSource, type SubscriptionLease, type TextUnit, type Transport, type TransportResponse, type TriggerDescriptor, type VerifyResult, type WebhookVerification, type WebhookVerificationSpec, assertConnectorApi, byteRangeOf, callConnector, capabilityProblems, checkAgainstOpenApi, checkAgainstRecordedShape, classifyError, classifyHttp, classifyStatus, classifyThrown, compareShape, connectionsFor, constantTimeEquals, deliver, fakeRequest, fakeValues, getConnectionHost, graphemes, handshakeResponse, header, hmac, httpFailure, idempotencyKeyFor, isEmptyPayload, isRemote, isSharedTokenScheme, isSharedTokenSpec, isUnconditionallyRetryable, joinTargets, leaseAction, leaseFromResponse, leaseRenewAt, leaseState, linkRanges, measure, nextOccurrence, parseInvite, parseMime, payloadHash, postChain, probe, providerProblems, providerSandboxIsSelectable, registerConnectionHost, registerTransport, render, reported, resetRateState, resolveConnection, resolveConnectorMode, respectRate, runIdentityFrom, runKeyFrom, runProbes, sandboxIsSelectable, sandboxRefusal, satisfiesMinimum, secretKeyBytes, seedFrom, shapeOf, shouldRetry, sliceByteRange, splitToFit, subscriptionLease, triggerEvent, unchecked, utf8Length, verifyDelivery, verifyHmac, verifySharedToken, withResolvedLimit };

package/dist/index.d.ts

@@ -1256,6 +1256,92 @@ declare function classifyThrown(cause: unknown, ctx: ConnectorErrorContext): Con
  */
 declare function httpFailure(status: number, body: string, retryAfter?: string | null): Error;
 
+/**
+ * RFC 5545 in, a structured invite and its join targets out — the read MOIC's
+ * meeting bot needs from nothing but the text a calendar API hands back.
+ *
+ * Written from scratch (the owner: no third-party code), as ONE
+ * implementation in two runtimes — `php/src/Ical.php` is the twin — and held
+ * to the authored corpus under `fixtures/ical/`, which both must reproduce
+ * exactly. `fixtures/ical/README.md` lists every decision a case pins; the
+ * ones easy to get differently in two languages are restated here:
+ *
+ * - Folded lines (a line break followed by a single space or tab) join
+ *   before anything else runs; TEXT values are then RFC 5545-unescaped
+ *   (`\n`, `\,`, `\;`, `\\`).
+ * - `DTSTART`/`DTEND` always come back as UTC instants. A `Z` suffix passes
+ *   through; a `TZID` parameter resolves through the calendar's own
+ *   `VTIMEZONE` (an unknown TZID is refused BY NAME, never guessed); a value
+ *   with neither — RFC 5545's FLOATING time — is treated as UTC, a decision
+ *   named here rather than left to look like an oversight: resolving a
+ *   floating time correctly needs the READER's timezone, which nothing in
+ *   the invite carries.
+ * - `RRULE` support is intentionally narrow: `FREQ` daily/weekly/monthly/
+ *   yearly with `INTERVAL`, `COUNT` and `UNTIL`, and `BYDAY` for WEEKLY only.
+ *   No `BYMONTHDAY`, `BYSETPOS`, `BYWEEKNO`, `BYYEARDAY`, `WKST`, `EXDATE` or
+ *   `RDATE` — a recurring invite using one of those still parses (its RRULE
+ *   fields are read, never dropped), but `nextOccurrence` does not attempt
+ *   to walk it.
+ * - Join targets are ALLOW-LISTED: Google Meet, Zoom (with its meeting id
+ *   and passcode read out of the URL), Microsoft Teams, and a dial-in phone
+ *   number with a passcode read from its own line. Anything else is ignored,
+ *   never guessed at — a bot that tried an unknown link shape would attempt
+ *   to join something it cannot handle.
+ */
+type InviteMethod = "REQUEST" | "CANCEL";
+type Attendee = {
+    name: string | null;
+    email: string;
+    role: string | null;
+    partstat: string | null;
+};
+type RecurrenceRule = {
+    freq: "DAILY" | "WEEKLY" | "MONTHLY" | "YEARLY";
+    interval: number;
+    count: number | null;
+    until: string | null;
+    byDay: string[] | null;
+};
+type Invite = {
+    method: InviteMethod;
+    uid: string;
+    sequence: number;
+    summary: string | null;
+    description: string | null;
+    location: string | null;
+    status: string | null;
+    dtstart: string;
+    dtend: string | null;
+    organizer: {
+        name: string | null;
+        email: string;
+    } | null;
+    attendees: Attendee[];
+    rrule: RecurrenceRule | null;
+};
+type JoinTargetKind = "google-meet" | "zoom" | "teams" | "dial-in";
+type JoinTarget = {
+    kind: JoinTargetKind;
+    url: string | null;
+    meetingId: string | null;
+    passcode: string | null;
+    phone: string | null;
+};
+declare function parseInvite(raw: string): Invite;
+/**
+ * The next occurrence at or after `afterIso`, or `null` when the series (or
+ * the single occurrence, for a non-recurring invite) has nothing left to
+ * offer at or after that instant.
+ */
+declare function nextOccurrence(invite: Invite, afterIso: string): string | null;
+/**
+ * The allow-listed places a bot can actually join, in the order they appear
+ * in the text. Anything else — Webex, a generic link, an unrecognised
+ * dial-in shape — is not returned: a shape this package does not know is a
+ * shape a bot should not guess at.
+ */
+declare function joinTargets(invite: Invite): JoinTarget[];
+
 /**
  * A run, a position inside it, and how many times that position has been tried.
  *
@@ -1567,18 +1653,6 @@ declare function byteRangeOf(text: string, charIndex: number, substring: string)
  * exception three frames away.
  */
 declare function sliceByteRange(text: string, range: ByteRange): string;
-/**
- * Bare URLs in `text`, with their UTF-8 byte ranges.
- *
- * Trailing punctuation is excluded: a link at the end of a sentence would
- * otherwise swallow the full stop and 404. Closing brackets go too, for the same
- * reason and because a URL in parentheses is common in prose.
- *
- * This is the generic half of a "link facet" — a connector maps the ranges into
- * whatever its provider's rich-text shape is. The package owns the offsets
- * because the offsets are what people get wrong; it does not own the provider's
- * schema, because that is the provider's.
- */
 declare function linkRanges(text: string): Array<ByteRange & {
     url: string;
 }>;
@@ -2603,4 +2677,4 @@ declare function verifyDelivery(trigger: TriggerDescriptor, delivery: InboundDel
  */
 declare function triggerEvent(trigger: TriggerDescriptor, connection: ResolvedConnection, injected: unknown, config: Record<string, unknown>): unknown;
 
-export { AMBIGUOUS_REFUSAL, type ApiContract, type Attempt, type ByteRange, CANONICAL_METRICS, CONNECTOR_API_VERSION, CONNECTOR_MODES, CREDENTIAL_SCOPES, type CallOptions, type CallResult, type Capabilities, type Catalogue, type ChainLinks, type ChainOutcome, type ChainRef, type ChallengeHandshake, type Citation, type Classified, type ConnectionCredentials, type ConnectionHost, type ConnectionSpec, type Connector, ConnectorAmbiguous, ConnectorApiMismatch, ConnectorAuthError, ConnectorConfigError, ConnectorError, type ConnectorErrorContext, type ConnectorFaker, ConnectorIdempotencyExpiredError, type ConnectorMode, ConnectorModeError, ConnectorRateLimited, type ConnectorRequest, ConnectorRequestError, type ConnectorResult, ConnectorTransient, ConnectorUnreachable, type ContractOperation, type CredentialField, type CredentialScope, DEFAULT_IDEMPOTENCY_WINDOW_SECONDS, DEFAULT_RETRY, type DeliveryDeclaration, type DeliveryMechanism, type DeliveryOutcome, type DriftFinding, type DriftReport, EXPIRES_AT_UNITS, type ExpiresAtUnit, FAKE_EPOCH, type FailureKind, type FakeRequest, type FakeValues, type HmacScheme, type HmacVerificationSpec, type HostEnvironment, type IdempotencyOptions, type InboundDelivery, type LeaseAction, type LeaseDeclaration, type LeaseState, MAX_IDEMPOTENCY_KEY_LENGTH, type MetricDescriptor, type MetricSample, type MimeAttachment, type MimeHeader, type MimeMessage, type MimePart, type ModeInputs, NO_IDEMPOTENCY_KEY_WARNING, PROBLEM_SEVERITIES, type PreparedRequest, type ProbeOutcome, type ProbeReport, type ProbeResult, type ProbeSpec, type Problem, type ProviderAdapter, RENDERER_VERSION, REVIEW_STALE_DAYS, type RecordedShape, type RenderRules, type RenderedPayload, type RequestedMode, type ResolveOptions, type ResolvedConnection, type RetryPolicy, type RunIdentity, SANDBOX_KINDS, SUPPORTED_CONNECTOR_API, type SandboxKind, type Segment, type ServiceDescriptor, type SetupStep, type ShapeMismatch, type SharedTokenScheme, type SharedTokenVerificationSpec, type SpecSource, type SubscriptionLease, type TextUnit, type Transport, type TransportResponse, type TriggerDescriptor, type VerifyResult, type WebhookVerification, type WebhookVerificationSpec, assertConnectorApi, byteRangeOf, callConnector, capabilityProblems, checkAgainstOpenApi, checkAgainstRecordedShape, classifyError, classifyHttp, classifyStatus, classifyThrown, compareShape, connectionsFor, constantTimeEquals, deliver, fakeRequest, fakeValues, getConnectionHost, graphemes, handshakeResponse, header, hmac, httpFailure, idempotencyKeyFor, isEmptyPayload, isRemote, isSharedTokenScheme, isSharedTokenSpec, isUnconditionallyRetryable, leaseAction, leaseFromResponse, leaseRenewAt, leaseState, linkRanges, measure, parseMime, payloadHash, postChain, probe, providerProblems, providerSandboxIsSelectable, registerConnectionHost, registerTransport, render, reported, resetRateState, resolveConnection, resolveConnectorMode, respectRate, runIdentityFrom, runKeyFrom, runProbes, sandboxIsSelectable, sandboxRefusal, satisfiesMinimum, secretKeyBytes, seedFrom, shapeOf, shouldRetry, sliceByteRange, splitToFit, subscriptionLease, triggerEvent, unchecked, utf8Length, verifyDelivery, verifyHmac, verifySharedToken, withResolvedLimit };
+export { AMBIGUOUS_REFUSAL, type ApiContract, type Attempt, type Attendee, type ByteRange, CANONICAL_METRICS, CONNECTOR_API_VERSION, CONNECTOR_MODES, CREDENTIAL_SCOPES, type CallOptions, type CallResult, type Capabilities, type Catalogue, type ChainLinks, type ChainOutcome, type ChainRef, type ChallengeHandshake, type Citation, type Classified, type ConnectionCredentials, type ConnectionHost, type ConnectionSpec, type Connector, ConnectorAmbiguous, ConnectorApiMismatch, ConnectorAuthError, ConnectorConfigError, ConnectorError, type ConnectorErrorContext, type ConnectorFaker, ConnectorIdempotencyExpiredError, type ConnectorMode, ConnectorModeError, ConnectorRateLimited, type ConnectorRequest, ConnectorRequestError, type ConnectorResult, ConnectorTransient, ConnectorUnreachable, type ContractOperation, type CredentialField, type CredentialScope, DEFAULT_IDEMPOTENCY_WINDOW_SECONDS, DEFAULT_RETRY, type DeliveryDeclaration, type DeliveryMechanism, type DeliveryOutcome, type DriftFinding, type DriftReport, EXPIRES_AT_UNITS, type ExpiresAtUnit, FAKE_EPOCH, type FailureKind, type FakeRequest, type FakeValues, type HmacScheme, type HmacVerificationSpec, type HostEnvironment, type IdempotencyOptions, type InboundDelivery, type Invite, type InviteMethod, type JoinTarget, type JoinTargetKind, type LeaseAction, type LeaseDeclaration, type LeaseState, MAX_IDEMPOTENCY_KEY_LENGTH, type MetricDescriptor, type MetricSample, type MimeAttachment, type MimeHeader, type MimeMessage, type MimePart, type ModeInputs, NO_IDEMPOTENCY_KEY_WARNING, PROBLEM_SEVERITIES, type PreparedRequest, type ProbeOutcome, type ProbeReport, type ProbeResult, type ProbeSpec, type Problem, type ProviderAdapter, RENDERER_VERSION, REVIEW_STALE_DAYS, type RecordedShape, type RecurrenceRule, type RenderRules, type RenderedPayload, type RequestedMode, type ResolveOptions, type ResolvedConnection, type RetryPolicy, type RunIdentity, SANDBOX_KINDS, SUPPORTED_CONNECTOR_API, type SandboxKind, type Segment, type ServiceDescriptor, type SetupStep, type ShapeMismatch, type SharedTokenScheme, type SharedTokenVerificationSpec, type SpecSource, type SubscriptionLease, type TextUnit, type Transport, type TransportResponse, type TriggerDescriptor, type VerifyResult, type WebhookVerification, type WebhookVerificationSpec, assertConnectorApi, byteRangeOf, callConnector, capabilityProblems, checkAgainstOpenApi, checkAgainstRecordedShape, classifyError, classifyHttp, classifyStatus, classifyThrown, compareShape, connectionsFor, constantTimeEquals, deliver, fakeRequest, fakeValues, getConnectionHost, graphemes, handshakeResponse, header, hmac, httpFailure, idempotencyKeyFor, isEmptyPayload, isRemote, isSharedTokenScheme, isSharedTokenSpec, isUnconditionallyRetryable, joinTargets, leaseAction, leaseFromResponse, leaseRenewAt, leaseState, linkRanges, measure, nextOccurrence, parseInvite, parseMime, payloadHash, postChain, probe, providerProblems, providerSandboxIsSelectable, registerConnectionHost, registerTransport, render, reported, resetRateState, resolveConnection, resolveConnectorMode, respectRate, runIdentityFrom, runKeyFrom, runProbes, sandboxIsSelectable, sandboxRefusal, satisfiesMinimum, secretKeyBytes, seedFrom, shapeOf, shouldRetry, sliceByteRange, splitToFit, subscriptionLease, triggerEvent, unchecked, utf8Length, verifyDelivery, verifyHmac, verifySharedToken, withResolvedLimit };

package/dist/index.js

@@ -860,6 +860,325 @@ function unchecked(contract) {
   };
 }
 
+// src/ical.ts
+function unfold(text) {
+  return text.replace(/\r\n|\r|\n/g, "\n").replace(/\n[ \t]/g, "");
+}
+function unescapeText(value) {
+  return value.replace(/\\[nN]/g, "\n").replace(/\\,/g, ",").replace(/\\;/g, ";").replace(/\\\\/g, "\\");
+}
+function parseLine(line) {
+  const colon = findUnquoted(line, ":");
+  const head = colon === -1 ? line : line.slice(0, colon);
+  const value = colon === -1 ? "" : line.slice(colon + 1);
+  const [name = "", ...paramParts] = head.split(";");
+  const params = {};
+  for (const part of paramParts) {
+    const eq = part.indexOf("=");
+    if (eq === -1) continue;
+    const key = part.slice(0, eq).toUpperCase();
+    let raw = part.slice(eq + 1);
+    if (raw.startsWith('"') && raw.endsWith('"')) raw = raw.slice(1, -1);
+    params[key] = raw;
+  }
+  return { name: name.toUpperCase(), params, value };
+}
+function findUnquoted(line, char) {
+  let quoted = false;
+  for (let i = 0; i < line.length; i++) {
+    if (line[i] === '"') quoted = !quoted;
+    else if (line[i] === char && !quoted) return i;
+  }
+  return -1;
+}
+function blockLines(lines, name) {
+  const blocks = [];
+  let depth = 0;
+  let current = null;
+  for (const raw of lines) {
+    const upper = raw.toUpperCase();
+    if (upper === `BEGIN:${name}`) {
+      if (depth === 0) current = [];
+      depth++;
+      continue;
+    }
+    if (upper === `END:${name}`) {
+      depth--;
+      if (depth === 0 && current !== null) {
+        blocks.push(current);
+        current = null;
+      }
+      continue;
+    }
+    if (current !== null) current.push(raw);
+  }
+  return blocks;
+}
+var WEEKDAY_CODES = ["SU", "MO", "TU", "WE", "TH", "FR", "SA"];
+function parseByDayOrdinal(token) {
+  const match = /^(-?\d+)([A-Z]{2})$/.exec(token);
+  if (!match) throw new Error(`ical: VTIMEZONE rule has an unreadable BYDAY "${token}"`);
+  const [, ordinalText, weekdayText] = match;
+  const weekday = WEEKDAY_CODES.indexOf(weekdayText ?? "");
+  if (weekday === -1) throw new Error(`ical: VTIMEZONE rule names an unknown weekday "${weekdayText}"`);
+  return { ordinal: Number(ordinalText), weekday };
+}
+function parseTzTransition(lines) {
+  const props = lines.map(parseLine);
+  const get = (name) => props.find((p) => p.name === name)?.value;
+  const offsetFrom = get("TZOFFSETFROM");
+  const offsetTo = get("TZOFFSETTO");
+  const rrule = get("RRULE");
+  if (!offsetFrom || !offsetTo || !rrule) {
+    throw new Error("ical: a VTIMEZONE sub-component needs TZOFFSETFROM, TZOFFSETTO and an RRULE");
+  }
+  const parts = Object.fromEntries(rrule.split(";").map((p) => p.split("=")));
+  const month = Number(parts.BYMONTH);
+  const { ordinal, weekday } = parseByDayOrdinal(parts.BYDAY ?? "");
+  if (!month || Number.isNaN(ordinal)) {
+    throw new Error(`ical: this package only reads a yearly BYMONTH+BYDAY transition rule, got "${rrule}"`);
+  }
+  return { offsetFrom, offsetTo, month, ordinal, weekday };
+}
+function offsetMinutes(offset) {
+  const match = /^([+-])(\d{2}):?(\d{2})/.exec(offset);
+  if (!match) throw new Error(`ical: unreadable UTC offset "${offset}"`);
+  const sign = match[1] === "-" ? -1 : 1;
+  return sign * (Number(match[2]) * 60 + Number(match[3]));
+}
+function nthWeekdayOfMonth(year, month1, weekday, ordinal) {
+  if (ordinal > 0) {
+    const first = Date.UTC(year, month1 - 1, 1);
+    const firstWeekday = new Date(first).getUTCDay();
+    const offset2 = (weekday - firstWeekday + 7) % 7;
+    return 1 + offset2 + (ordinal - 1) * 7;
+  }
+  const lastDay = new Date(Date.UTC(year, month1, 0)).getUTCDate();
+  const last = Date.UTC(year, month1 - 1, lastDay);
+  const lastWeekday = new Date(last).getUTCDay();
+  const offset = (lastWeekday - weekday + 7) % 7;
+  return lastDay - offset - (-ordinal - 1) * 7;
+}
+function parseTimezones(lines) {
+  const zones = /* @__PURE__ */ new Map();
+  for (const block of blockLines(lines, "VTIMEZONE")) {
+    const tzid = block.map(parseLine).find((p) => p.name === "TZID")?.value;
+    if (!tzid) continue;
+    const standardBlocks = blockLines(block, "STANDARD");
+    const daylightBlocks = blockLines(block, "DAYLIGHT");
+    const standardBlock = standardBlocks[0];
+    if (!standardBlock) {
+      throw new Error(`ical: VTIMEZONE "${tzid}" has no STANDARD component`);
+    }
+    zones.set(tzid, {
+      standard: parseTzTransition(standardBlock),
+      daylight: daylightBlocks[0] ? parseTzTransition(daylightBlocks[0]) : null
+    });
+  }
+  return zones;
+}
+function resolveTz(zone, y, mo, d, h, mi, s) {
+  const naiveUtcMs = Date.UTC(y, mo - 1, d, h, mi, s);
+  if (!zone.daylight) {
+    return new Date(naiveUtcMs - offsetMinutes(zone.standard.offsetTo) * 6e4).toISOString();
+  }
+  const springDay = nthWeekdayOfMonth(y, zone.daylight.month, zone.daylight.weekday, zone.daylight.ordinal);
+  const fallDay = nthWeekdayOfMonth(y, zone.standard.month, zone.standard.weekday, zone.standard.ordinal);
+  const spring = Date.UTC(y, zone.daylight.month - 1, springDay);
+  const fall = Date.UTC(y, zone.standard.month - 1, fallDay);
+  const inDaylight = naiveUtcMs >= spring && naiveUtcMs < fall;
+  const offset = inDaylight ? zone.daylight.offsetTo : zone.standard.offsetTo;
+  return new Date(naiveUtcMs - offsetMinutes(offset) * 6e4).toISOString();
+}
+function parseDateTimeParts(value) {
+  const match = /^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})(Z)?$/.exec(value);
+  if (!match) throw new Error(`ical: unreadable date-time "${value}"`);
+  return {
+    y: Number(match[1]),
+    mo: Number(match[2]),
+    d: Number(match[3]),
+    h: Number(match[4]),
+    mi: Number(match[5]),
+    s: Number(match[6]),
+    utc: Boolean(match[7])
+  };
+}
+function resolveInstant(prop, zones) {
+  const parts = parseDateTimeParts(prop.value);
+  if (parts.utc) return new Date(Date.UTC(parts.y, parts.mo - 1, parts.d, parts.h, parts.mi, parts.s)).toISOString();
+  const tzid = prop.params.TZID;
+  if (!tzid) {
+    return new Date(Date.UTC(parts.y, parts.mo - 1, parts.d, parts.h, parts.mi, parts.s)).toISOString();
+  }
+  const zone = zones.get(tzid);
+  if (!zone) {
+    throw new Error(`ical: DTSTART/DTEND names TZID "${tzid}", which this calendar's VTIMEZONE does not define`);
+  }
+  return resolveTz(zone, parts.y, parts.mo, parts.d, parts.h, parts.mi, parts.s);
+}
+function emailOf(value) {
+  return value.replace(/^mailto:/i, "");
+}
+function parseAttendee(prop) {
+  return {
+    name: prop.params.CN ?? null,
+    email: emailOf(prop.value),
+    role: prop.params.ROLE ?? null,
+    partstat: prop.params.PARTSTAT ?? null
+  };
+}
+var FREQS = ["DAILY", "WEEKLY", "MONTHLY", "YEARLY"];
+function parseRRule(value) {
+  const parts = Object.fromEntries(
+    value.split(";").map((p) => {
+      const eq = p.indexOf("=");
+      return [p.slice(0, eq).toUpperCase(), p.slice(eq + 1)];
+    })
+  );
+  const freq = parts.FREQ;
+  if (!FREQS.includes(freq)) {
+    throw new Error(`ical: RRULE FREQ must be one of ${FREQS.join(", ")}, got "${parts.FREQ}"`);
+  }
+  return {
+    freq,
+    interval: parts.INTERVAL ? Number(parts.INTERVAL) : 1,
+    count: parts.COUNT ? Number(parts.COUNT) : null,
+    until: parts.UNTIL ? resolveInstant({ name: "UNTIL", params: {}, value: parts.UNTIL }, /* @__PURE__ */ new Map()) : null,
+    byDay: parts.BYDAY ? parts.BYDAY.split(",") : null
+  };
+}
+function parseInvite(raw) {
+  const lines = unfold(raw).split("\n").filter((l) => l.length > 0);
+  const zones = parseTimezones(lines);
+  const eventBlocks = blockLines(lines, "VEVENT");
+  const firstEvent = eventBlocks[0];
+  if (!firstEvent) throw new Error("ical: no VEVENT in this calendar");
+  const props = firstEvent.map(parseLine);
+  const methodValue = (lines.find((l) => l.toUpperCase().startsWith("METHOD:")) ?? "").split(":")[1];
+  const get = (name) => props.find((p) => p.name === name);
+  const getAll = (name) => props.filter((p) => p.name === name);
+  const text = (name) => {
+    const p = get(name);
+    return p ? unescapeText(p.value) : null;
+  };
+  const method = (methodValue ?? "REQUEST").trim().toUpperCase();
+  if (method !== "REQUEST" && method !== "CANCEL") {
+    throw new Error(`ical: METHOD must be REQUEST or CANCEL, got "${methodValue}"`);
+  }
+  const uidProp = get("UID");
+  if (!uidProp) throw new Error("ical: VEVENT has no UID");
+  const dtstartProp = get("DTSTART");
+  if (!dtstartProp) throw new Error("ical: VEVENT has no DTSTART");
+  const dtendProp = get("DTEND");
+  const organizerProp = get("ORGANIZER");
+  const rruleProp = get("RRULE");
+  return {
+    method,
+    uid: uidProp.value,
+    sequence: get("SEQUENCE") ? Number(get("SEQUENCE").value) : 0,
+    summary: text("SUMMARY"),
+    description: text("DESCRIPTION"),
+    location: text("LOCATION"),
+    status: get("STATUS")?.value ?? null,
+    dtstart: resolveInstant(dtstartProp, zones),
+    dtend: dtendProp ? resolveInstant(dtendProp, zones) : null,
+    organizer: organizerProp ? { name: organizerProp.params.CN ?? null, email: emailOf(organizerProp.value) } : null,
+    attendees: getAll("ATTENDEE").map(parseAttendee),
+    rrule: rruleProp ? parseRRule(rruleProp.value) : null
+  };
+}
+var DAY_MS = 864e5;
+function addCalendarUnit(ms, freq, interval) {
+  const d = new Date(ms);
+  if (freq === "DAILY") return ms + interval * DAY_MS;
+  if (freq === "WEEKLY") return ms + interval * 7 * DAY_MS;
+  const months = freq === "YEARLY" ? interval * 12 : interval;
+  const day = d.getUTCDate();
+  const next = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + months, 1, d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds()));
+  const daysInNext = new Date(Date.UTC(next.getUTCFullYear(), next.getUTCMonth() + 1, 0)).getUTCDate();
+  next.setUTCDate(Math.min(day, daysInNext));
+  return next.getTime();
+}
+function* occurrences(rrule, dtstartMs) {
+  const untilMs = rrule.until ? Date.parse(rrule.until) : null;
+  let n = 0;
+  const emit = (ms) => {
+    if (untilMs !== null && ms > untilMs) return false;
+    n++;
+    return true;
+  };
+  if (rrule.freq === "WEEKLY" && rrule.byDay?.length) {
+    const wanted = [...new Set(rrule.byDay.map((d) => WEEKDAY_CODES.indexOf(d)))].sort((a, b) => a - b);
+    const dtstart = new Date(dtstartMs);
+    const timeOfDay = dtstartMs - Date.UTC(dtstart.getUTCFullYear(), dtstart.getUTCMonth(), dtstart.getUTCDate());
+    const startOfWeek = dtstartMs - timeOfDay - dtstart.getUTCDay() * DAY_MS;
+    let weekIndex = 0;
+    while (true) {
+      if (weekIndex % rrule.interval === 0) {
+        for (const weekday of wanted) {
+          const candidate = startOfWeek + weekIndex * 7 * DAY_MS + weekday * DAY_MS + timeOfDay;
+          if (candidate < dtstartMs) continue;
+          if (!emit(candidate)) return;
+          yield candidate;
+          if (rrule.count && n >= rrule.count) return;
+        }
+      }
+      weekIndex++;
+    }
+  }
+  let current = dtstartMs;
+  while (true) {
+    if (!emit(current)) return;
+    yield current;
+    if (rrule.count && n >= rrule.count) return;
+    current = addCalendarUnit(current, rrule.freq, rrule.interval);
+  }
+}
+function nextOccurrence(invite, afterIso) {
+  const afterMs = Date.parse(afterIso);
+  const dtstartMs = Date.parse(invite.dtstart);
+  if (!invite.rrule) {
+    return dtstartMs >= afterMs ? invite.dtstart : null;
+  }
+  for (const ms of occurrences(invite.rrule, dtstartMs)) {
+    if (ms >= afterMs) return new Date(ms).toISOString();
+  }
+  return null;
+}
+var ZOOM_LINK = /https:\/\/[\w.-]*zoom\.us\/j\/(\d+)(\?[^\s)]*)?/g;
+var MEET_LINK = /https:\/\/meet\.google\.com\/[a-z0-9-]+/gi;
+var TEAMS_LINK = /https:\/\/teams\.(?:microsoft|live)\.com\/l\/meetup-join\/[^\s)]+/gi;
+var DIAL_LINE = /^Dial(?:-in)?[:\s]+([+0-9][0-9\s().-]{6,}\d)/im;
+var PASSCODE_LINE = /Passcode[:\s]+([A-Za-z0-9]+)/i;
+function joinTargets(invite) {
+  const text = invite.description ?? "";
+  const targets = [];
+  for (const match of text.matchAll(ZOOM_LINK)) {
+    const query = match[2] ?? "";
+    const passcode = /[?&]pwd=([^&\s]+)/.exec(query)?.[1] ?? null;
+    targets.push({
+      index: match.index ?? 0,
+      target: { kind: "zoom", url: match[0], meetingId: match[1] ?? null, passcode, phone: null }
+    });
+  }
+  for (const match of text.matchAll(MEET_LINK)) {
+    targets.push({ index: match.index ?? 0, target: { kind: "google-meet", url: match[0], meetingId: null, passcode: null, phone: null } });
+  }
+  for (const match of text.matchAll(TEAMS_LINK)) {
+    targets.push({ index: match.index ?? 0, target: { kind: "teams", url: match[0], meetingId: null, passcode: null, phone: null } });
+  }
+  const dial = DIAL_LINE.exec(text);
+  const dialedPhone = dial?.[1];
+  if (dial && dialedPhone !== void 0) {
+    const passcode = PASSCODE_LINE.exec(text)?.[1] ?? null;
+    targets.push({
+      index: dial.index,
+      target: { kind: "dial-in", url: null, meetingId: null, passcode, phone: dialedPhone.trim() }
+    });
+  }
+  return targets.sort((a, b) => a.index - b.index).map((t) => t.target);
+}
+
 // src/idempotency.ts
 var DEFAULT_IDEMPOTENCY_WINDOW_SECONDS = 24 * 60 * 60;
 var MAX_IDEMPOTENCY_KEY_LENGTH = 255;
@@ -1424,11 +1743,17 @@ function sliceByteRange(text, range) {
   const bytes = encoder.encode(text);
   return new TextDecoder().decode(bytes.slice(range.byteStart, range.byteEnd));
 }
+var TRAILING_PUNCTUATION = /* @__PURE__ */ new Set([".", ",", ";", ":", "!", "?", ")", "]", "}", "'", '"']);
+function trimTrailingPunctuation(raw) {
+  let end = raw.length;
+  while (end > 0 && TRAILING_PUNCTUATION.has(raw[end - 1])) end -= 1;
+  return raw.slice(0, end);
+}
 function linkRanges(text) {
   const found = [];
   for (const match of text.matchAll(/https?:\/\/[^\s]+/g)) {
     if (match.index === void 0) continue;
-    const url = match[0].replace(/[.,;:!?)\]}'"]+$/, "");
+    const url = trimTrailingPunctuation(match[0]);
     found.push({ ...byteRangeOf(text, match.index, url), url });
   }
   return found;
@@ -1799,12 +2124,15 @@ export {
   isSharedTokenScheme,
   isSharedTokenSpec,
   isUnconditionallyRetryable,
+  joinTargets,
   leaseAction,
   leaseFromResponse,
   leaseRenewAt,
   leaseState,
   linkRanges,
   measure,
+  nextOccurrence,
+  parseInvite,
   parseMime,
   payloadHash,
   postChain,