sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ Personalize/ CreateDatasetImportJob.ts

import type * as personalize from "@distilled.cloud/aws/personalize";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";

/**
 * Runtime binding for `personalize:CreateDatasetImportJob` — Starts a bulk import of training data from S3 into a dataset — the
 * first step of the MLOps retraining loop. Grants
 * `personalize:CreateDatasetImportJob` on `*` plus `iam:PassRole`
 * (conditioned to `personalize.amazonaws.com`) for the data-access role
 * the service assumes to read the S3 bucket.
 * Provide the implementation with
 * `Effect.provide(AWS.Personalize.CreateDatasetImportJobHttp)`.
 *
 * ### Retraining Loop
 * **Example:** Import Training Data
 * ```typescript
 * // init
 * const createDatasetImportJob = yield* Personalize.CreateDatasetImportJob();
 *
 * const { datasetImportJobArn } = yield* createDatasetImportJob({
 *   jobName: "nightly-import",
 *   datasetArn,
 *   dataSource: { dataLocation: "s3://training-bucket/interactions.csv" },
 *   roleArn: importRoleArn,
 * });
 * ```
 *
 * @binding
 */
export interface CreateDatasetImportJob extends Binding.Service<
  CreateDatasetImportJob,
  "AWS.Personalize.CreateDatasetImportJob",
  () => Effect.Effect<
    (
      request: personalize.CreateDatasetImportJobRequest,
    ) => Effect.Effect<
      personalize.CreateDatasetImportJobResponse,
      personalize.CreateDatasetImportJobError
    >
  >
> {}
export const CreateDatasetImportJob = Binding.Service<CreateDatasetImportJob>(
  "AWS.Personalize.CreateDatasetImportJob",
);