sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ Account/ ContactInformation.ts

import * as account from "@distilled.cloud/aws/account";
import { isResolved } from "alchemy/Diff";
import * as Provider from "alchemy/Provider";
import { Resource } from "alchemy/Resource";
import * as Effect from "effect/Effect";
import type { Providers } from "../Providers.ts";
import { unwrapSensitive } from "./internal.ts";

export interface ContactInformationProps {
  /** Full name of the primary contact. */
  fullName: string;
  /** First line of the primary contact's mailing address. */
  addressLine1: string;
  /** Second line of the mailing address, if any. */
  addressLine2?: string;
  /** Third line of the mailing address, if any. */
  addressLine3?: string;
  /** City of the primary contact address. */
  city: string;
  /** State or region of the primary contact address, if applicable. */
  stateOrRegion?: string;
  /** District or county of the primary contact address, if applicable. */
  districtOrCounty?: string;
  /** Postal code of the primary contact address. */
  postalCode: string;
  /** ISO-3166 two-letter country code of the primary contact address. */
  countryCode: string;
  /** Phone number of the primary contact. */
  phoneNumber: string;
  /** Company name associated with the primary contact, if any. */
  companyName?: string;
  /** Website URL associated with the primary contact, if any. */
  websiteUrl?: string;
  /**
   * Account ID to operate on. Only usable from an Organizations management or
   * delegated-admin account with trusted access enabled; omit to target the
   * calling account.
   */
  accountId?: string;
}

export interface ContactInformation extends Resource<
  "AWS.Account.ContactInformation",
  ContactInformationProps,
  {
    fullName: string;
    addressLine1: string;
    addressLine2?: string;
    addressLine3?: string;
    city: string;
    stateOrRegion?: string;
    districtOrCounty?: string;
    postalCode: string;
    countryCode: string;
    phoneNumber: string;
    companyName?: string;
    websiteUrl?: string;
  },
  never,
  Providers
> {}

/**
 * The primary contact information of an AWS account — the account-global
 * mailing address and phone number AWS uses to reach the account owner. Every
 * account has exactly one primary contact; this resource upserts it via
 * `account:PutContactInformation`. AWS does not allow deleting the primary
 * contact, so destroying the resource stops managing it and leaves the last
 * value in place.
 *
 * ### Setting the Primary Contact
 * **Example:** Primary Contact for the Calling Account
 * ```typescript
 * const contact = yield* ContactInformation("PrimaryContact", {
 *   fullName: "Jane Doe",
 *   addressLine1: "123 Any Street",
 *   city: "Seattle",
 *   stateOrRegion: "WA",
 *   postalCode: "98101",
 *   countryCode: "US",
 *   phoneNumber: "+12065551234",
 *   companyName: "Acme Corp",
 *   websiteUrl: "https://acme.example.com",
 * });
 * ```
 *
 * **Example:** Primary Contact for an Organizations Member Account
 * ```typescript
 * const contact = yield* ContactInformation("MemberContact", {
 *   fullName: "Acme Ops",
 *   addressLine1: "123 Any Street",
 *   city: "Seattle",
 *   postalCode: "98101",
 *   countryCode: "US",
 *   phoneNumber: "+12065551234",
 *   accountId: "123456789012",
 * });
 * ```
 *
 * @resource
 */
export const ContactInformation = Resource<ContactInformation>("AWS.Account.ContactInformation");

export const ContactInformationProvider = () =>
  Provider.effect(
    ContactInformation,
    Effect.gen(function* () {
      const toAttributes = (contact: account.ContactInformation) => ({
        fullName: unwrapSensitive(contact.FullName) ?? "",
        addressLine1: unwrapSensitive(contact.AddressLine1) ?? "",
        addressLine2: unwrapSensitive(contact.AddressLine2),
        addressLine3: unwrapSensitive(contact.AddressLine3),
        city: unwrapSensitive(contact.City) ?? "",
        stateOrRegion: unwrapSensitive(contact.StateOrRegion),
        districtOrCounty: unwrapSensitive(contact.DistrictOrCounty),
        postalCode: unwrapSensitive(contact.PostalCode) ?? "",
        countryCode: unwrapSensitive(contact.CountryCode) ?? "",
        phoneNumber: unwrapSensitive(contact.PhoneNumber) ?? "",
        companyName: unwrapSensitive(contact.CompanyName),
        websiteUrl: unwrapSensitive(contact.WebsiteUrl),
      });

      const observe = (accountId: string | undefined) =>
        account.getContactInformation({ AccountId: accountId }).pipe(
          Effect.map((r) =>
            r.ContactInformation ? toAttributes(r.ContactInformation) : undefined,
          ),
          Effect.catchTag("ResourceNotFoundException", () => Effect.undefined),
        );

      return {
        // Account-global singleton setting: nuke must not wipe the real
        // primary contact of the account.
        nuke: { skip: true },
        stables: [],
        // Targeting a different account manages a different singleton, so an
        // accountId change replaces rather than mutating the old target.
        diff: Effect.fn(function* ({ olds, news }) {
          if (!isResolved(news)) return;
          if ((olds?.accountId ?? news.accountId) !== news.accountId) {
            return { action: "replace" } as const;
          }
        }),
        read: Effect.fn(function* ({ olds }) {
          return yield* observe(olds?.accountId);
        }),
        reconcile: Effect.fn(function* ({ news, session }) {
          // The primary contact is a singleton driven entirely by
          // `putContactInformation`, which is a full upsert — the request
          // payload *is* the desired state.
          yield* account.putContactInformation({
            ContactInformation: {
              FullName: news.fullName,
              AddressLine1: news.addressLine1,
              AddressLine2: news.addressLine2,
              AddressLine3: news.addressLine3,
              City: news.city,
              StateOrRegion: news.stateOrRegion,
              DistrictOrCounty: news.districtOrCounty,
              PostalCode: news.postalCode,
              CountryCode: news.countryCode,
              PhoneNumber: news.phoneNumber,
              CompanyName: news.companyName,
              WebsiteUrl: news.websiteUrl,
            },
            AccountId: news.accountId,
          });
          yield* session.note(news.fullName);
          return {
            fullName: news.fullName,
            addressLine1: news.addressLine1,
            addressLine2: news.addressLine2,
            addressLine3: news.addressLine3,
            city: news.city,
            stateOrRegion: news.stateOrRegion,
            districtOrCounty: news.districtOrCounty,
            postalCode: news.postalCode,
            countryCode: news.countryCode,
            phoneNumber: news.phoneNumber,
            companyName: news.companyName,
            websiteUrl: news.websiteUrl,
          };
        }),
        // Account-global singleton: return the one contact if it exists.
        list: () => observe(undefined).pipe(Effect.map((contact) => (contact ? [contact] : []))),
        // AWS does not allow deleting the primary contact of an account —
        // destroy just stops managing it and leaves the last value in place.
        delete: Effect.fn(function* () {}),
      };
    }),
  );