import * as ssoAdmin from "@distilled.cloud/aws/sso-admin";
import { isResolved } from "alchemy/Diff";
import * as Provider from "alchemy/Provider";
import { Resource } from "alchemy/Resource";
import { normalizeDurationInput } from "alchemy/Util/Duration";
import * as Data from "effect/Data";
import * as Duration from "effect/Duration";
import * as Effect from "effect/Effect";
import * as Stream from "effect/Stream";
import type { Providers } from "../Providers.ts";
import { resolveInstance, retryIdentityCenter } from "./common.ts";
export class PermissionSetUnexpectedResponse extends Data.TaggedError(
"PermissionSetUnexpectedResponse",
)<{
readonly message: string;
readonly cause?: unknown;
}> {}
export interface PermissionSetProps {
/**
* Explicit IAM Identity Center instance ARN.
* If omitted, Alchemy adopts the only visible instance.
*/
instanceArn?: string;
/**
* Permission set name.
*/
name: string;
/**
* Optional human-readable description.
*/
description?: string;
/**
* Optional session duration, e.g. `"8 hours"` or `Duration.hours(8)`.
* Sent to Identity Center as an ISO-8601 string such as `PT8H` (a bare
* number is milliseconds).
*/
sessionDuration?: Duration.Input;
/**
* Optional relay state passed to supported applications.
*/
relayState?: string;
}
export interface PermissionSet extends Resource<
"AWS.IdentityCenter.PermissionSet",
PermissionSetProps,
{
/** The Identity Center instance the permission set lives in. */
instanceArn: string;
/** The ARN of the permission set. */
permissionSetArn: string;
/** The name of the permission set. */
name: string;
/** The description of the permission set. */
description: string | undefined;
/** The session duration in ISO-8601 format (e.g. `PT8H`). */
sessionDuration: string | undefined;
/** The relay state URL users land on after federating, if set. */
relayState: string | undefined;
/** When the permission set was created. */
createdDate: Date | undefined;
},
never,
Providers
> {}
/**
* An IAM Identity Center permission set.
* ### Creating Permission Sets
* **Example:** Administrator Access
* ```typescript
* const admin = yield* PermissionSet("AdministratorAccess", {
* name: "AdministratorAccess",
* description: "Administrator access for platform engineers",
* sessionDuration: "8 hours",
* });
* ```
*
* @resource
*/
export const PermissionSet = Resource<PermissionSet>("AWS.IdentityCenter.PermissionSet");
export const PermissionSetProvider = () =>
Provider.effect(
PermissionSet,
Effect.gen(function* () {
return {
stables: ["permissionSetArn", "instanceArn"],
list: () =>
Effect.gen(function* () {
// Permission sets live on an Identity Center instance. Resolve
// the single enabled SSO instance, enumerate every permission
// set ARN via `listPermissionSets` (exhaustively paginated by
// the distilled `.items` stream), then hydrate each into the
// exact `read` shape via `describePermissionSet` (bounded
// concurrency, typed per-item not-found handled inside
// `readPermissionSetByArn`).
const instance = yield* resolveInstance();
const arns = yield* ssoAdmin.listPermissionSets
.items({
InstanceArn: instance.InstanceArn!,
MaxResults: 100,
})
.pipe(Stream.runCollect);
const rows = yield* Effect.forEach(
arns,
(permissionSetArn) =>
readPermissionSetByArn({
instanceArn: instance.InstanceArn!,
permissionSetArn,
}),
{ concurrency: 10 },
);
return rows.filter((row): row is PermissionSet["Attributes"] => row !== undefined);
}),
diff: Effect.fn(function* ({ olds, news }) {
if (!isResolved(news)) return;
if (olds?.instanceArn !== news.instanceArn || olds?.name !== news.name) {
return { action: "replace" } as const;
}
}),
read: Effect.fn(function* ({ olds, output }) {
if (output?.permissionSetArn && output.instanceArn) {
return yield* readPermissionSetByArn({
instanceArn: output.instanceArn,
permissionSetArn: output.permissionSetArn,
});
}
if (!olds) {
return undefined;
}
return yield* readPermissionSetByName(olds);
}),
reconcile: Effect.fn(function* ({ news, output, session }) {
const instance = yield* resolveInstance(output?.instanceArn ?? news.instanceArn);
const desiredSessionDuration =
news.sessionDuration !== undefined
? toIsoSessionDuration(news.sessionDuration)
: undefined;
// Observe — find the permission set by ARN (when we already
// have one) or by name on the resolved instance.
let existing =
(output?.permissionSetArn
? yield* readPermissionSetByArn({
instanceArn: instance.InstanceArn!,
permissionSetArn: output.permissionSetArn,
})
: undefined) ??
(yield* readPermissionSetByName({
...news,
instanceArn: instance.InstanceArn,
}));
// Ensure — create the permission set if missing.
if (!existing) {
const response = yield* retryIdentityCenter(
ssoAdmin.createPermissionSet({
InstanceArn: instance.InstanceArn!,
Name: news.name,
Description: news.description,
SessionDuration: desiredSessionDuration,
RelayState: news.relayState,
}),
);
const createdArn = response.PermissionSet?.PermissionSetArn;
existing =
(createdArn
? yield* readPermissionSetByArn({
instanceArn: instance.InstanceArn!,
permissionSetArn: createdArn,
})
: undefined) ??
(yield* readPermissionSetByName({
...news,
instanceArn: instance.InstanceArn,
}));
if (!existing) {
return yield* new PermissionSetUnexpectedResponse({
message: `permission set '${news.name}' not found after create`,
});
}
yield* session.note(existing.permissionSetArn);
return existing;
}
// Sync mutable attributes — `updatePermissionSet` overwrites
// description, sessionDuration, relayState. Diff against
// observed cloud state so adoption converges; only call when
// there's a real delta.
if (
(existing.description ?? undefined) !== news.description ||
(existing.sessionDuration ?? undefined) !== desiredSessionDuration ||
(existing.relayState ?? undefined) !== news.relayState
) {
yield* retryIdentityCenter(
ssoAdmin.updatePermissionSet({
InstanceArn: existing.instanceArn,
PermissionSetArn: existing.permissionSetArn,
Description: news.description,
SessionDuration: desiredSessionDuration,
RelayState: news.relayState,
}),
);
const updated = yield* readPermissionSetByArn({
instanceArn: existing.instanceArn,
permissionSetArn: existing.permissionSetArn,
});
if (!updated) {
return yield* new PermissionSetUnexpectedResponse({
message: `permission set '${existing.permissionSetArn}' not found after update`,
});
}
yield* session.note(updated.permissionSetArn);
return updated;
}
yield* session.note(existing.permissionSetArn);
return existing;
}),
delete: Effect.fn(function* ({ output }) {
yield* retryIdentityCenter(
ssoAdmin
.deletePermissionSet({
InstanceArn: output.instanceArn,
PermissionSetArn: output.permissionSetArn,
})
.pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.void)),
);
}),
};
}),
);
/**
* Format a {@link Duration.Input} as the canonical ISO-8601 duration string
* (`PT8H`, `PT1H30M`, …) the `SessionDuration` wire field expects. ISO-8601
* is semantically part of the AWS field, so only the normalization (state
* round-trip re-hydration) comes from the central Duration util.
*/
const toIsoSessionDuration = (input: Duration.Input): string => {
const totalSeconds = Math.round(Duration.toSeconds(normalizeDurationInput(input)));
const hours = Math.floor(totalSeconds / 3600);
const minutes = Math.floor((totalSeconds % 3600) / 60);
const seconds = totalSeconds % 60;
const parts = [
hours > 0 ? `${hours}H` : "",
minutes > 0 ? `${minutes}M` : "",
seconds > 0 || totalSeconds === 0 ? `${seconds}S` : "",
].join("");
return `PT${parts}`;
};
const readPermissionSetByArn = Effect.fn(function* ({
instanceArn,
permissionSetArn,
}: {
instanceArn: string;
permissionSetArn: string;
}) {
const response = yield* retryIdentityCenter(
ssoAdmin
.describePermissionSet({
InstanceArn: instanceArn,
PermissionSetArn: permissionSetArn,
})
.pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.undefined)),
);
const permissionSet = response?.PermissionSet;
if (!permissionSet?.PermissionSetArn || !permissionSet.Name) {
return undefined;
}
return {
instanceArn,
permissionSetArn: permissionSet.PermissionSetArn,
name: permissionSet.Name,
description: permissionSet.Description,
sessionDuration: permissionSet.SessionDuration,
relayState: permissionSet.RelayState,
createdDate: permissionSet.CreatedDate,
} satisfies PermissionSet["Attributes"];
});
const readPermissionSetByName = Effect.fn(function* ({
instanceArn,
name,
}: Pick<PermissionSetProps, "instanceArn" | "name">) {
const instance = yield* resolveInstance(instanceArn);
const arns = yield* ssoAdmin.listPermissionSets
.items({
InstanceArn: instance.InstanceArn!,
MaxResults: 100,
})
.pipe(Stream.runCollect);
for (const permissionSetArn of arns) {
const permissionSet = yield* readPermissionSetByArn({
instanceArn: instance.InstanceArn!,
permissionSetArn,
});
if (permissionSet?.name === name) {
return permissionSet;
}
}
return undefined;
});