import type * as schemas from "@distilled.cloud/aws/schemas";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { Schema } from "./Schema.ts";
/**
* Runtime binding for `schemas:DescribeSchema`.
*
* Reads the bound {@link Schema}'s document — the content, type, version,
* and description — so a function can fetch the authoritative event contract
* at runtime (e.g. to validate incoming payloads against the registered
* schema). The registry and schema names are injected from the binding; pass
* `SchemaVersion` to read a specific version instead of the latest. Provide
* the implementation with `Effect.provide(AWS.Schemas.DescribeSchemaHttp)`.
* ### Reading Schemas
* **Example:** Fetch The Latest Schema Document
* ```typescript
* // init — bind the operation to the schema
* const describeSchema = yield* AWS.Schemas.DescribeSchema(schema);
*
* // runtime
* const { Content, SchemaVersion } = yield* describeSchema();
* const document = JSON.parse(Content!);
* ```
*
* @binding
*/
export interface DescribeSchema extends Binding.Service<
DescribeSchema,
"AWS.Schemas.DescribeSchema",
(schema: Schema) => Effect.Effect<
(request?: {
/** The version of the schema to read. Defaults to the latest. */
SchemaVersion?: string;
}) => Effect.Effect<schemas.DescribeSchemaResponse, schemas.DescribeSchemaError>
>
> {}
export const DescribeSchema = Binding.Service<DescribeSchema>("AWS.Schemas.DescribeSchema");