import * as b2bi from "@distilled.cloud/aws/b2bi";
import * as logs from "@distilled.cloud/aws/cloudwatch-logs";
import { unownedUnlessPrevious } from "alchemy/AdoptPolicy";
import { isResolved } from "alchemy/Diff";
import * as Provider from "alchemy/Provider";
import { Resource } from "alchemy/Resource";
import { createInternalTags, hasAlchemyTags } from "alchemy/Tags";
import * as Effect from "effect/Effect";
import * as Redacted from "effect/Redacted";
import * as Stream from "effect/Stream";
import type { Providers } from "../Providers.ts";
import { readB2biTags, syncB2biTags, toWireTags } from "./internal.ts";
export interface ProfileProps {
/**
* The name of the profile.
*/
name: string;
/**
* Name for the business associated with this profile.
*/
businessName: string;
/**
* The phone number associated with the business, in E.164 format
* (e.g. `+1234567890`).
*/
phone: string;
/**
* The email address associated with this customer profile.
*/
email?: string;
/**
* Whether Amazon Web Services logs each event in an Amazon CloudWatch log
* group for the profile. Immutable after creation — changing it replaces
* the profile.
* @default "ENABLED"
*/
logging?: "ENABLED" | "DISABLED";
/**
* User-defined tags for the profile.
*/
tags?: Record<string, string>;
}
export interface Profile extends Resource<
"AWS.B2BI.Profile",
ProfileProps,
{
/**
* Service-assigned unique ID of the profile.
*/
profileId: string;
/**
* ARN of the profile.
*/
profileArn: string;
/**
* Name of the profile.
*/
name: string;
/**
* Business name associated with the profile.
*/
businessName: string;
/**
* CloudWatch log group created for the profile when logging is enabled.
*/
logGroupName: string | undefined;
},
never,
Providers
> {}
/**
* An AWS B2B Data Interchange (B2BI) customer profile. A profile is the
* mechanism used to model a distinct private network; you can have up to
* five profiles per account. Profiles are credential-free and fully
* self-service, so their lifecycle is directly testable.
* ### Creating a Profile
* **Example:** Basic Profile
* ```typescript
* const profile = yield* B2BI.Profile("Acme", {
* name: "Acme Trading",
* businessName: "Acme Corp",
* phone: "+15555550100",
* email: "edi@acme.example",
* });
* ```
*
* ### Disabling CloudWatch Logging
* **Example:** Logging Disabled
* ```typescript
* const profile = yield* B2BI.Profile("Acme", {
* name: "Acme Trading",
* businessName: "Acme Corp",
* phone: "+15555550100",
* logging: "DISABLED",
* });
* ```
*
* @resource
*/
export const Profile = Resource<Profile>("AWS.B2BI.Profile");
const toAttrs = (r: b2bi.GetProfileResponse | b2bi.CreateProfileResponse) => ({
profileId: r.profileId,
profileArn: r.profileArn,
name: r.name,
businessName: r.businessName,
logGroupName: r.logGroupName,
});
export const ProfileProvider = () =>
Provider.effect(
Profile,
Effect.gen(function* () {
/** Find a profile by its user-facing name across all pages. */
const findByName = (name: string) =>
b2bi.listProfiles.items({}).pipe(
Stream.filter((s) => s.name === name),
Stream.runHead,
Effect.flatMap((head) =>
head._tag === "Some"
? b2bi
.getProfile({ profileId: head.value.profileId })
.pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.undefined))
: Effect.undefined,
),
);
return {
stables: ["profileId", "profileArn"],
diff: Effect.fn(function* ({ olds = {}, news }) {
if (!isResolved(news)) return undefined;
// logging has no member on updateProfile — it is immutable after
// create, so a change forces a replacement. Delete-first: profiles
// are recovered by name (findByName) and capped at 5 per account.
if ((olds.logging ?? "ENABLED") !== (news.logging ?? "ENABLED")) {
return { action: "replace", deleteFirst: true } as const;
}
}),
read: Effect.fn(function* ({ id, olds, output, previous }) {
const found = output?.profileId
? yield* b2bi
.getProfile({ profileId: output.profileId })
.pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.undefined))
: yield* findByName(olds?.name ?? "");
if (found === undefined) return undefined;
const attrs = toAttrs(found);
const tags = yield* readB2biTags(attrs.profileArn);
return (yield* hasAlchemyTags(id, tags))
? attrs
: unownedUnlessPrevious(attrs, previous, "profileId");
}),
reconcile: Effect.fn(function* ({ id, news, output, session }) {
const internalTags = yield* createInternalTags(id);
const desiredTags = { ...internalTags, ...news.tags };
// 1. Observe — cloud state is authoritative; output caches the id.
let live = output?.profileId
? yield* b2bi
.getProfile({ profileId: output.profileId })
.pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.undefined))
: yield* findByName(news.name);
// 2. Ensure — create if missing.
if (live === undefined) {
const created = yield* b2bi.createProfile({
name: news.name,
businessName: news.businessName,
phone: news.phone,
email: news.email,
logging: news.logging ?? "ENABLED",
tags: toWireTags(desiredTags),
});
live = yield* b2bi.getProfile({ profileId: created.profileId });
} else {
// 3. Sync — converge mutable settings (name/businessName/phone/
// email). logging is immutable after create (diff replaces).
// phone/email are sensitive members that may decode as Redacted.
const unwrap = (v: string | Redacted.Redacted<string> | undefined) =>
Redacted.isRedacted(v) ? Redacted.value(v) : v;
const nameDrift = live.name !== news.name;
const bizDrift = live.businessName !== news.businessName;
const phoneDrift = unwrap(live.phone) !== news.phone;
const emailDrift = news.email !== undefined && unwrap(live.email) !== news.email;
if (nameDrift || bizDrift || phoneDrift || emailDrift) {
yield* b2bi.updateProfile({
profileId: live.profileId,
name: news.name,
businessName: news.businessName,
phone: news.phone,
email: news.email,
});
live = yield* b2bi.getProfile({ profileId: live.profileId });
}
}
// 3b. Sync tags against observed cloud tags.
yield* syncB2biTags(live.profileArn, desiredTags);
yield* session.note(live.profileId);
return toAttrs(live);
}),
delete: Effect.fn(function* ({ output }) {
yield* b2bi
.deleteProfile({ profileId: output.profileId })
.pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.void));
// B2BI auto-creates /aws/vendedlogs/b2bi/profile/{profileId} when
// logging is ENABLED and deleteProfile does NOT remove it — every
// deleted profile would leak an orphaned log group. Reap it
// (idempotently) using the service-reported name when available.
const logGroupName =
output.logGroupName ?? `/aws/vendedlogs/b2bi/profile/${output.profileId}`;
yield* logs
.deleteLogGroup({ logGroupName })
.pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.void));
// NOTE: profile creation also auto-creates the shared account-level
// /aws/vendedlogs/b2bi/default log group. That group is a
// service-managed singleton and MUST NOT be reaped here: B2BI's
// internal log-delivery bookkeeping references it, and deleting it
// opens a ~60-90s window where subsequent B2BI creates in the
// account fail with "Unable to perform CreateLogDelivery"
// (verified live with /aws/vendedlogs/b2bi/transformers).
}),
list: () =>
b2bi.listProfiles.items({}).pipe(
Stream.mapEffect((s) =>
b2bi.getProfile({ profileId: s.profileId }).pipe(
Effect.map(toAttrs),
Effect.catchTag("ResourceNotFoundException", () => Effect.undefined),
),
),
Stream.filter((item) => item !== undefined),
Stream.runCollect,
Effect.map((chunk) => Array.from(chunk)),
),
};
}),
);