alchemy 2.0.0-beta.30 → 2.0.0-beta.32

package/lib/AWS/ApiGateway/Method.js

@@ -0,0 +1,369 @@
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import * as Effect from "effect/Effect";
+import { deepEqual, isResolved } from "../../Diff.js";
+import * as Provider from "../../Provider.js";
+import { Resource } from "../../Resource.js";
+/**
+ * An HTTP method on an API Gateway Resource.
+ *
+ * A `Method` is a single HTTP verb (`GET`, `POST`, `ANY`, …) attached to a
+ * REST API resource path. Most methods also carry an `integration` — the
+ * downstream target that actually handles the request (a Lambda function,
+ * an HTTP endpoint, a mock response, etc.).
+ *
+ * @section Binding to a RestApi
+ * Pass the `RestApi` value on `restApi`. This threads the API id through
+ * and registers the method as a `RestApiBinding` on the API, so that any
+ * `Deployment` of the same API is automatically ordered after this method
+ * completes. You do not need to manage `Deployment.triggers` yourself.
+ *
+ * @example GET on the API root with a mock integration
+ * ```typescript
+ * yield* ApiGateway.Method("GetRoot", {
+ *   restApi: api,
+ *   httpMethod: "GET",
+ *   authorizationType: "NONE",
+ *   integration: { type: "MOCK" },
+ * });
+ * ```
+ *
+ * @section Lambda proxy integration
+ * For Lambda-backed APIs, the integration `uri` follows the
+ * `arn:aws:apigateway:<region>:lambda:path/2015-03-31/functions/<function-arn>/invocations`
+ * shape. Use `Output.map` to resolve the function ARN before building the
+ * URI, since the function's ARN is only known at deploy time.
+ *
+ * @example ANY method with Lambda AWS_PROXY integration
+ * ```typescript
+ * import * as Output from "alchemy/Output";
+ *
+ * const invokeUri = Output.map(
+ *   fn.functionArn,
+ *   (arn) =>
+ *     `arn:aws:apigateway:${region}:lambda:path/2015-03-31/functions/${arn}/invocations`,
+ * );
+ *
+ * yield* ApiGateway.Method("RootAny", {
+ *   restApi: api,
+ *   httpMethod: "ANY",
+ *   authorizationType: "NONE",
+ *   integration: {
+ *     type: "AWS_PROXY",
+ *     integrationHttpMethod: "POST",
+ *     uri: invokeUri,
+ *   },
+ * });
+ * ```
+ *
+ * @section Methods on sub-paths
+ * Attach a method to a nested path by creating an `ApiGateway.Resource` and
+ * passing its `resourceId` explicitly. `restApi` is still required so the
+ * method binds for deployment ordering.
+ *
+ * @example Method on `/items`
+ * ```typescript
+ * const items = yield* ApiGateway.Resource("Items", {
+ *   restApi: api,
+ *   parentId: api.rootResourceId,
+ *   pathPart: "items",
+ * });
+ *
+ * yield* ApiGateway.Method("ListItems", {
+ *   restApi: api,
+ *   resourceId: items.resourceId,
+ *   httpMethod: "GET",
+ *   authorizationType: "NONE",
+ *   integration: { type: "MOCK" },
+ * });
+ * ```
+ */
+export const MethodResource = Resource("AWS.ApiGateway.Method");
+const MethodImpl = (id, props) => Effect.gen(function* () {
+    const { restApi, ...rest } = props;
+    const restApiId = rest.restApiId ?? restApi?.restApiId;
+    const resourceId = rest.resourceId ?? restApi?.rootResourceId;
+    if (!restApiId || !resourceId) {
+        return yield* Effect.die("Method requires either `restApi` (preferred) or explicit " +
+            "`restApiId` and `resourceId`.");
+    }
+    const method = yield* MethodResource(id, {
+        ...rest,
+        restApiId,
+        resourceId,
+    });
+    if (restApi) {
+        yield* restApi.bind `${method}`({
+            kind: "method",
+            methodId: method.LogicalId,
+            restApiId: method.restApiId,
+            resourceId: method.resourceId,
+            httpMethod: method.httpMethod,
+        });
+    }
+    return method;
+});
+/**
+ * User-facing wrapper for the Method resource. Accepts `restApi: RestApi`
+ * as the idiomatic way to attach a method — this both forwards the API id
+ * and registers the method as a binding on the RestApi so the scheduler
+ * orders `Deployment` after it.
+ */
+export const Method = MethodImpl;
+const putIntegrationRequest = (restApiId, resourceId, httpMethod, integration) => ({
+    restApiId,
+    resourceId,
+    httpMethod,
+    type: integration.type,
+    integrationHttpMethod: integration.integrationHttpMethod,
+    uri: integration.uri,
+    connectionType: integration.connectionType,
+    connectionId: integration.connectionId,
+    credentials: integration.credentials,
+    requestParameters: integration.requestParameters,
+    requestTemplates: integration.requestTemplates,
+    passthroughBehavior: integration.passthroughBehavior,
+    cacheNamespace: integration.cacheNamespace,
+    cacheKeyParameters: integration.cacheKeyParameters,
+    contentHandling: integration.contentHandling,
+    timeoutInMillis: integration.timeoutInMillis,
+    tlsConfig: integration.tlsConfig,
+    responseTransferMode: integration.responseTransferMode,
+    integrationTarget: integration.integrationTarget,
+});
+const putMethod = (news) => ag.putMethod({
+    restApiId: news.restApiId,
+    resourceId: news.resourceId,
+    httpMethod: news.httpMethod,
+    authorizationType: news.authorizationType ?? "NONE",
+    authorizerId: news.authorizerId,
+    apiKeyRequired: news.apiKeyRequired,
+    operationName: news.operationName,
+    requestParameters: news.requestParameters,
+    requestModels: news.requestModels,
+    requestValidatorId: news.requestValidatorId,
+    authorizationScopes: news.authorizationScopes,
+});
+const deleteIntegrationSafe = (p) => ag
+    .deleteIntegration({
+    restApiId: p.restApiId,
+    resourceId: p.resourceId,
+    httpMethod: p.httpMethod,
+})
+    .pipe(Effect.catchTag("NotFoundException", () => Effect.void));
+const deleteMethodSafe = (p) => ag
+    .deleteMethod({
+    restApiId: p.restApiId,
+    resourceId: p.resourceId,
+    httpMethod: p.httpMethod,
+})
+    .pipe(Effect.catchTag("NotFoundException", () => Effect.void));
+const readMethodSnapshot = (p) => Effect.gen(function* () {
+    const method = yield* ag
+        .getMethod({
+        restApiId: p.restApiId,
+        resourceId: p.resourceId,
+        httpMethod: p.httpMethod,
+    })
+        .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)));
+    if (!method?.httpMethod)
+        return undefined;
+    const integ = yield* ag
+        .getIntegration({
+        restApiId: p.restApiId,
+        resourceId: p.resourceId,
+        httpMethod: p.httpMethod,
+    })
+        .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)));
+    const integration = integ?.type
+        ? {
+            type: integ.type,
+            integrationHttpMethod: integ.httpMethod,
+            uri: integ.uri,
+            connectionType: integ.connectionType,
+            connectionId: integ.connectionId,
+            credentials: integ.credentials,
+            requestParameters: integ.requestParameters,
+            requestTemplates: integ.requestTemplates,
+            passthroughBehavior: integ.passthroughBehavior,
+            cacheNamespace: integ.cacheNamespace,
+            cacheKeyParameters: integ.cacheKeyParameters,
+            contentHandling: integ.contentHandling,
+            timeoutInMillis: integ.timeoutInMillis,
+            tlsConfig: integ.tlsConfig,
+            responseTransferMode: integ.responseTransferMode,
+            integrationTarget: integ.integrationTarget,
+        }
+        : undefined;
+    return {
+        restApiId: p.restApiId,
+        resourceId: p.resourceId,
+        httpMethod: p.httpMethod,
+        authorizationType: method.authorizationType ?? "NONE",
+        authorizerId: method.authorizerId,
+        apiKeyRequired: method.apiKeyRequired,
+        operationName: method.operationName,
+        requestParameters: method.requestParameters,
+        requestModels: method.requestModels,
+        requestValidatorId: method.requestValidatorId,
+        authorizationScopes: method.authorizationScopes,
+        integration,
+    };
+});
+export const MethodProvider = () => Provider.effect(MethodResource, Effect.gen(function* () {
+    return {
+        stables: ["restApiId", "resourceId", "httpMethod"],
+        diff: Effect.fn(function* ({ news: newsIn, olds }) {
+            if (!isResolved(newsIn))
+                return;
+            const news = newsIn;
+            if (news.restApiId !== olds.restApiId ||
+                news.resourceId !== olds.resourceId ||
+                news.httpMethod !== olds.httpMethod) {
+                return { action: "replace" };
+            }
+        }),
+        read: Effect.fn(function* ({ output }) {
+            if (!output)
+                return undefined;
+            return yield* readMethodSnapshot({
+                restApiId: output.restApiId,
+                resourceId: output.resourceId,
+                httpMethod: output.httpMethod,
+            });
+        }),
+        reconcile: Effect.fn(function* ({ news: newsIn, output, session }) {
+            if (!isResolved(newsIn)) {
+                return yield* Effect.die("Method props were not resolved");
+            }
+            const news = newsIn;
+            const authType = news.authorizationType ?? "NONE";
+            // Methods are keyed by (restApiId, resourceId, httpMethod). All
+            // three are stable across the resource's lifetime, so we read
+            // them out of `output` when present and fall back to `news`.
+            const restApiId = (output?.restApiId ?? news.restApiId);
+            const resourceId = (output?.resourceId ?? news.resourceId);
+            const httpMethod = output?.httpMethod ?? news.httpMethod;
+            // Observe — read live method + integration as a single snapshot.
+            // `output.*` fields are never trusted as proxies for cloud state;
+            // they're at most a cache for the natural-key tuple above.
+            let observed = yield* readMethodSnapshot({
+                restApiId,
+                resourceId,
+                httpMethod,
+            });
+            // Ensure — putMethod creates the method shape (auth type,
+            // request models, scopes, etc.). Some of those fields cannot be
+            // patched in place by `updateMethod`, so on a "recreate-needed"
+            // diff we drop the existing method and re-put. This is also the
+            // path used on first reconcile when nothing exists.
+            const needsRecreate = observed !== undefined &&
+                (news.operationName !== observed.operationName ||
+                    !deepEqual(news.requestParameters, observed.requestParameters) ||
+                    !deepEqual(news.requestModels, observed.requestModels) ||
+                    news.requestValidatorId !== observed.requestValidatorId ||
+                    !deepEqual(news.authorizationScopes, observed.authorizationScopes));
+            if (observed === undefined || needsRecreate) {
+                if (needsRecreate) {
+                    yield* deleteIntegrationSafe({
+                        restApiId,
+                        resourceId,
+                        httpMethod,
+                    });
+                    yield* deleteMethodSafe({ restApiId, resourceId, httpMethod });
+                }
+                yield* putMethod({
+                    ...news,
+                    restApiId,
+                    resourceId,
+                    httpMethod,
+                });
+                if (news.integration) {
+                    yield* ag.putIntegration(putIntegrationRequest(restApiId, resourceId, httpMethod, news.integration));
+                }
+                yield* session.note(needsRecreate
+                    ? `Recreated method ${httpMethod}`
+                    : `Put method ${httpMethod} on resource ${resourceId}`);
+                // Re-read to get the canonical observed state for the rest of
+                // the reconciler. After a recreate everything matches `news`,
+                // so the patch step below becomes a no-op.
+                observed = yield* readMethodSnapshot({
+                    restApiId,
+                    resourceId,
+                    httpMethod,
+                });
+                if (!observed) {
+                    return yield* Effect.die("getMethod missing after put");
+                }
+            }
+            // Sync patchable scalar fields — observed ↔ desired.
+            const patches = [];
+            if (authType !== observed.authorizationType) {
+                patches.push({
+                    op: "replace",
+                    path: "/authorizationType",
+                    value: authType,
+                });
+            }
+            if (news.authorizerId !== observed.authorizerId) {
+                patches.push({
+                    op: "replace",
+                    path: "/authorizerId",
+                    value: news.authorizerId ?? "",
+                });
+            }
+            if (news.apiKeyRequired !== observed.apiKeyRequired) {
+                patches.push({
+                    op: "replace",
+                    path: "/apiKeyRequired",
+                    value: String(news.apiKeyRequired ?? false),
+                });
+            }
+            if (patches.length > 0) {
+                yield* ag.updateMethod({
+                    restApiId,
+                    resourceId,
+                    httpMethod,
+                    patchOperations: patches,
+                });
+            }
+            // Sync integration — putIntegration is an upsert; deleteIntegration
+            // tolerates missing integrations.
+            if (!deepEqual(news.integration, observed.integration)) {
+                if (news.integration) {
+                    yield* ag.putIntegration(putIntegrationRequest(restApiId, resourceId, httpMethod, news.integration));
+                }
+                else {
+                    yield* deleteIntegrationSafe({
+                        restApiId,
+                        resourceId,
+                        httpMethod,
+                    });
+                }
+            }
+            yield* session.note(`Reconciled method ${httpMethod}`);
+            const snap = yield* readMethodSnapshot({
+                restApiId,
+                resourceId,
+                httpMethod,
+            });
+            if (!snap) {
+                return yield* Effect.die("getMethod missing after reconcile");
+            }
+            return snap;
+        }),
+        delete: Effect.fn(function* ({ output, session }) {
+            yield* deleteIntegrationSafe({
+                restApiId: output.restApiId,
+                resourceId: output.resourceId,
+                httpMethod: output.httpMethod,
+            });
+            yield* deleteMethodSafe({
+                restApiId: output.restApiId,
+                resourceId: output.resourceId,
+                httpMethod: output.httpMethod,
+            });
+            yield* session.note(`Deleted method ${output.httpMethod}`);
+        }),
+    };
+}));
+//# sourceMappingURL=Method.js.map

package/lib/AWS/ApiGateway/Method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Method.js","sourceRoot":"","sources":["../../../src/AWS/ApiGateway/Method.ts"],"names":[],"mappings":"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"}

package/lib/AWS/ApiGateway/RestApi.d.ts

@@ -0,0 +1,164 @@
+import { Region } from "@distilled.cloud/aws/Region";
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import type { Input } from "../../Input.ts";
+import * as Provider from "../../Provider.ts";
+import { Resource } from "../../Resource.ts";
+import type { Providers } from "../Providers.ts";
+export interface RestApiProps {
+    /**
+     * Name of the REST API.
+     *
+     * If omitted, Alchemy generates a deterministic physical name.
+     */
+    name?: string;
+    description?: string;
+    version?: string;
+    cloneFrom?: string;
+    binaryMediaTypes?: string[];
+    minimumCompressionSize?: number;
+    apiKeySource?: ag.ApiKeySourceType;
+    endpointConfiguration?: ag.EndpointConfiguration;
+    /** Resource policy document as a JSON string. */
+    policy?: string;
+    disableExecuteApiEndpoint?: boolean;
+    securityPolicy?: ag.SecurityPolicy;
+    endpointAccessMode?: ag.EndpointAccessMode;
+    /** User-defined tags (Alchemy internal tags are merged automatically). */
+    tags?: Record<string, string>;
+}
+/**
+ * Structured metadata a child resource attaches to its RestApi via `.bind`.
+ *
+ * These bindings are the mechanism by which Methods, Resources, Authorizers,
+ * and other REST-API-scoped children declare a reverse dependency on the API
+ * itself. The presence of any such binding is what forces `RestApi.create` to
+ * run *after* every child has been created — which is exactly the ordering
+ * CloudFormation asks users to write manually via `DependsOn`.
+ *
+ * Consumers should not construct these directly; the child resource
+ * constructors (e.g. `Method`, `Resource`) handle binding on behalf of the
+ * user.
+ */
+export type RestApiBinding = {
+    kind: "method";
+    methodId: Input<string>;
+    restApiId: Input<string>;
+    resourceId: Input<string>;
+    httpMethod: Input<string>;
+} | {
+    kind: "resource";
+    resourceId: Input<string>;
+    parentId: Input<string>;
+    pathPart: Input<string>;
+} | {
+    kind: "authorizer";
+    authorizerId: Input<string>;
+};
+export interface RestApi extends Resource<"AWS.ApiGateway.RestApi", RestApiProps, {
+    restApiId: string;
+    rootResourceId: string;
+    name: string;
+    description: string | undefined;
+    version: string | undefined;
+    binaryMediaTypes: string[] | undefined;
+    minimumCompressionSize: number | undefined;
+    apiKeySource: ag.ApiKeySourceType | undefined;
+    endpointConfiguration: ag.EndpointConfiguration | undefined;
+    policy: string | undefined;
+    disableExecuteApiEndpoint: boolean | undefined;
+    securityPolicy: ag.SecurityPolicy | undefined;
+    endpointAccessMode: ag.EndpointAccessMode | undefined;
+    tags: Record<string, string>;
+}, RestApiBinding, Providers> {
+}
+/**
+ * An Amazon API Gateway REST API (v1).
+ *
+ * `RestApi` is the root of an API Gateway v1 stack. Every other ApiGateway
+ * resource — `Resource`, `Method`, `Authorizer`, `Deployment`, `Stage` —
+ * hangs off a `RestApi`. The only identity you need to thread through your
+ * stack is the `RestApi` value itself: child resources accept `restApi: api`
+ * and register themselves back onto the API so that deployments and stages
+ * wait for them without any user-authored dependency lists.
+ *
+ * @section Getting started
+ * A minimal API Gateway stack is four pieces: the `RestApi`, one or more
+ * `Method`s, a `Deployment` that snapshots those methods, and a `Stage` that
+ * exposes the deployment at a URL.
+ *
+ * @example Mock HTTP GET on the root path
+ * ```typescript
+ * import * as ApiGateway from "alchemy/AWS/ApiGateway";
+ *
+ * const api = yield* ApiGateway.RestApi("Api", {
+ *   endpointConfiguration: { types: ["REGIONAL"] },
+ * });
+ *
+ * yield* ApiGateway.Method("GetRoot", {
+ *   restApi: api,
+ *   httpMethod: "GET",
+ *   authorizationType: "NONE",
+ *   integration: { type: "MOCK" },
+ * });
+ *
+ * const deployment = yield* ApiGateway.Deployment("Release", {
+ *   restApi: api,
+ * });
+ *
+ * const stage = yield* ApiGateway.Stage("Prod", {
+ *   restApi: api,
+ *   stageName: "prod",
+ *   deploymentId: deployment.deploymentId,
+ * });
+ * ```
+ *
+ * @section How dependencies flow
+ * Writing `restApi: api` on a child (rather than `restApiId: api.restApiId`)
+ * does two things: it threads the restApi id through, and it registers a
+ * `RestApiBinding` back onto the API. The Alchemy scheduler sees those
+ * bindings as reverse edges from children into the API, and `Deployment`
+ * reads them to express a transitive dependency on every child. You never
+ * have to write a `DependsOn` list or a `triggers` hash — adding a new
+ * `Method` automatically orders it before the next `Deployment`.
+ *
+ * @section Private REST APIs
+ * @example Private REST API
+ * ```typescript
+ * const api = yield* ApiGateway.RestApi("PrivateApi", {
+ *   endpointConfiguration: {
+ *     types: ["PRIVATE"],
+ *     vpcEndpointIds: [endpoint.vpcEndpointId],
+ *   },
+ *   policy: JSON.stringify({
+ *     Version: "2012-10-17",
+ *     Statement: [{
+ *       Effect: "Allow",
+ *       Principal: "*",
+ *       Action: "execute-api:Invoke",
+ *       Resource: "*",
+ *     }],
+ *   }),
+ * });
+ * ```
+ *
+ * @section Binary payloads
+ * @example Enable binary media types
+ * ```typescript
+ * const api = yield* ApiGateway.RestApi("BinaryApi", {
+ *   binaryMediaTypes: ["application/octet-stream", "image/png"],
+ *   minimumCompressionSize: 1024,
+ * });
+ * ```
+ *
+ * @section Endpoint hardening
+ * @example Disable the default execute-api endpoint
+ * ```typescript
+ * const api = yield* ApiGateway.RestApi("CustomDomainOnlyApi", {
+ *   endpointConfiguration: { types: ["REGIONAL"] },
+ *   disableExecuteApiEndpoint: true,
+ * });
+ * ```
+ */
+export declare const RestApi: import("../../Resource.ts").ResourceClass<RestApi>;
+export declare const RestApiProvider: () => import("effect/Layer").Layer<Provider.Provider<RestApi>, never, import("effect/unstable/http/HttpClient").HttpClient | import("../../Stage.ts").Stage | import("../../Stack.ts").Stack | Region | import("@distilled.cloud/aws/Credentials").Credentials>;
+//# sourceMappingURL=RestApi.d.ts.map

package/lib/AWS/ApiGateway/RestApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestApi.d.ts","sourceRoot":"","sources":["../../../src/AWS/ApiGateway/RestApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAGvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC;IACnC,qBAAqB,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC;IACjD,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,cAAc,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC;IACnC,kBAAkB,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC;IAC3C,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACzB,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B,CAAC;AAEN,MAAM,WAAW,OAAQ,SAAQ,QAAQ,CACvC,wBAAwB,EACxB,YAAY,EACZ;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,YAAY,EAAE,EAAE,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAC9C,qBAAqB,EAAE,EAAE,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAC5D,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,yBAAyB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/C,cAAc,EAAE,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC;IAC9C,kBAAkB,EAAE,EAAE,CAAC,kBAAkB,GAAG,SAAS,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,EACD,cAAc,EACd,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AACH,eAAO,MAAM,OAAO,oDAA8C,CAAC;AAsHnE,eAAO,MAAM,eAAe,iQAuKzB,CAAC"}