import * as Effect from "effect/Effect";
import * as AWSBindings from "../AWSBindings.ts";
import type { Repository } from "./Repository.ts";
/**
* Shared scaffolding for the ECR HTTP bindings.
*
* NOT exported from `index.ts` — every thin `{Op}Http.ts` in this service is
* a `Layer.effect(Cap, makeEcrRepositoryHttpBinding({ … }))`. Everything
* except the operation and the IAM action list is boilerplate: per the ECR
* service authorization reference every repository-scoped action authorizes
* against the repository ARN, and the runtime callable injects the bound
* {@link Repository}'s `repositoryName` into every request.
*/
/** The repository-scoping fields every repository-scoped ECR operation takes. */
export interface RepositoryScopedRequest {
registryId?: string;
repositoryName: string;
}
/**
* Build the impl Effect for a repository-scoped ECR operation. The
* deploy-time half grants `iamActions` on the bound repository's ARN; the
* runtime callable injects the repository's `repositoryName` into every
* request (the registry defaults to the caller's own account).
*
* Registry-level operations (`ecr:GetAuthorizationToken`, which authorizes
* only on `Resource: ["*"]`) stay bespoke in their own `{Op}Http.ts`.
*/
export const makeEcrRepositoryHttpBinding = <I extends RepositoryScopedRequest, A, E, R>(options: {
/**
* Short capability name used in the binding sid and runtime span, e.g.
* `"DescribeImages"`.
*/
capability: string;
/** The distilled operation implementing the capability. */
operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
/** IAM actions granted on the bound repository's ARN. */
iamActions: readonly string[];
}) =>
Effect.gen(function* () {
const bind = yield* AWSBindings.Bind;
const op = yield* AWSBindings.withCredentials(options.operation);
return Effect.fn(function* (repository: Repository) {
const RepositoryName = yield* repository.repositoryName;
if (!globalThis.__ALCHEMY_RUNTIME__) {
yield* bind`AWS.ECR.${options.capability}(${repository})`({
policyStatements: [
{
Effect: "Allow",
Action: [...options.iamActions],
Resource: [repository.repositoryArn],
},
],
});
}
// The request is optional at the impl level so contracts whose
// remaining fields are all optional (DescribeImages, ListImages, …) can
// declare `(request?: …)`; contracts with required fields keep the
// parameter required and narrow this signature.
return Effect.fn(`AWS.ECR.${options.capability}(${repository.LogicalId})`)(function* (
request?: Omit<I, keyof RepositoryScopedRequest>,
) {
return yield* op({
...request,
repositoryName: yield* RepositoryName,
} as unknown as I);
});
});
});