import * as Output from "alchemy/Output";
import type { Output as OutputType } from "alchemy/Output";
import * as Effect from "effect/Effect";
import * as AWSBindings from "../AWSBindings.ts";
import type { DataCatalog } from "./DataCatalog.ts";
import type { WorkGroup } from "./WorkGroup.ts";
/**
* Shared scaffolding for Athena HTTP bindings.
*
* NOT exported from `index.ts` — every thin `{Op}Http.ts` in this service is
* a `Layer.effect(Cap, make…HttpBinding({ … }))` over one of the two builders
* below. Everything except the operation, the IAM action list, and the
* injected identifier is boilerplate.
*/
/**
* Build the impl Effect for a workgroup-scoped query operation. Athena
* authorizes query-execution actions against the workgroup the query ran in,
* so the deploy-time half grants `actions` on the bound {@link WorkGroup}'s
* ARN. When `injectWorkGroup` is set, the runtime callable also injects the
* workgroup's name as the request's `WorkGroup` field (for operations like
* `ListQueryExecutions` that scope by workgroup in the request itself).
*/
export const makeWorkGroupScopedHttpBinding = <I, A, E, R>(options: {
/** Fully-qualified binding tag, e.g. `AWS.Athena.GetQueryExecution`. */
tag: string;
/** The distilled operation. */
operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
/** IAM actions granted on the workgroup ARN. */
actions: readonly string[];
/** Inject the bound workgroup's name as the request `WorkGroup` field. */
injectWorkGroup?: boolean;
}) =>
Effect.gen(function* () {
const bind = yield* AWSBindings.Bind;
const op = yield* AWSBindings.withCredentials(options.operation);
return Effect.fn(function* (workGroup: WorkGroup) {
const WorkGroupName = yield* workGroup.workGroupName;
if (!globalThis.__ALCHEMY_RUNTIME__) {
yield* bind`${options.tag}(${workGroup})`({
policyStatements: [
{
Effect: "Allow",
Action: [...options.actions],
Resource: [workGroup.workGroupArn],
},
],
});
}
return Effect.fn(`${options.tag}(${workGroup.LogicalId})`)(function* (
request: Omit<I, "WorkGroup">,
) {
return yield* op(
(options.injectWorkGroup
? { ...request, WorkGroup: yield* WorkGroupName }
: request) as I,
);
});
});
});
// The datacatalog ARN is `arn:aws:athena:{region}:{account}:datacatalog/{name}`
// — the Glue Data Catalog ARNs share that partition/region/account.
const glueArns = (dataCatalogArn: OutputType<string>) => {
const base = dataCatalogArn.pipe(
Output.map((arn) => {
const [, partition, , region, account] = arn.split(":");
return `arn:${partition}:glue:${region}:${account}`;
}),
);
return [
base.pipe(Output.map((b) => `${b}:catalog`)),
base.pipe(Output.map((b) => `${b}:database/*`)),
base.pipe(Output.map((b) => `${b}:table/*/*`)),
];
};
/**
* Build the impl Effect for a catalog-metadata operation. The runtime callable
* injects the bound {@link DataCatalog}'s name as `CatalogName`; the
* deploy-time half grants `actions` on the datacatalog ARN plus the Glue
* Data Catalog reads Athena performs on the caller's behalf when the catalog
* resolves through Glue.
*/
export const makeDataCatalogScopedHttpBinding = <
I extends { CatalogName: string },
A,
E,
R,
>(options: {
/** Fully-qualified binding tag, e.g. `AWS.Athena.GetDatabase`. */
tag: string;
/** The distilled operation; `CatalogName` is injected from the resource. */
operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
/** IAM actions granted on the datacatalog ARN. */
actions: readonly string[];
}) =>
Effect.gen(function* () {
const bind = yield* AWSBindings.Bind;
const op = yield* AWSBindings.withCredentials(options.operation);
return Effect.fn(function* (catalog: DataCatalog) {
const CatalogName = yield* catalog.name;
if (!globalThis.__ALCHEMY_RUNTIME__) {
yield* bind`${options.tag}(${catalog})`({
policyStatements: [
{
Effect: "Allow",
Action: [...options.actions],
Resource: [catalog.dataCatalogArn],
},
{
// Metadata reads through a GLUE-type catalog federate to the
// Glue Data Catalog with the caller's credentials.
Effect: "Allow",
Action: [
"glue:GetDatabase",
"glue:GetDatabases",
"glue:GetTable",
"glue:GetTables",
"glue:GetPartition",
"glue:GetPartitions",
],
Resource: glueArns(catalog.dataCatalogArn),
},
],
});
}
return Effect.fn(`${options.tag}(${catalog.LogicalId})`)(function* (
request: Omit<I, "CatalogName">,
) {
return yield* op({
...request,
CatalogName: yield* CatalogName,
} as I);
});
});
});