sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ QBusiness/ AssociatePermission.ts

import type * as qbusiness from "@distilled.cloud/aws/qbusiness";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { Application } from "./Application.ts";

/**
 * `AssociatePermission` request with `applicationId` injected from the bound application.
 */
export interface AssociatePermissionRequest extends Omit<
  qbusiness.AssociatePermissionRequest,
  "applicationId"
> {}

/**
 * Runtime binding for the `AssociatePermission` operation (IAM action
 * `qbusiness:AssociatePermission`), scoped to one {@link Application}.
 *
 * Adds a statement to the application's permission policy, granting
 * a principal (e.g. an ISV data accessor) cross-account access to Q
 * Business actions.
 * Provide the implementation with
 * `Effect.provide(AWS.QBusiness.AssociatePermissionHttp)`.
 *
 * ### Cross-Account Permissions
 * **Example:** Grant an ISV SearchRelevantContent
 * ```typescript
 * const associate = yield* AWS.QBusiness.AssociatePermission(app);
 *
 * yield* associate({
 *   statementId: "isv-search",
 *   actions: ["qbusiness:SearchRelevantContent"],
 *   principal: "arn:aws:iam::123456789012:role/IsvRole",
 * });
 * ```
 *
 * @binding
 */
export interface AssociatePermission extends Binding.Service<
  AssociatePermission,
  "AWS.QBusiness.AssociatePermission",
  (
    application: Application,
  ) => Effect.Effect<
    (
      request: AssociatePermissionRequest,
    ) => Effect.Effect<qbusiness.AssociatePermissionResponse, qbusiness.AssociatePermissionError>
  >
> {}
export const AssociatePermission = Binding.Service<AssociatePermission>(
  "AWS.QBusiness.AssociatePermission",
);