@distilled.cloud/stackit 0.0.0-stage → 1.0.0-rc.14

package/lib/protocol.js

@@ -0,0 +1,147 @@
+import * as API from "@distilled.cloud/core/api";
+import { HTTP_STATUS_MAP, InternalServerError, } from "@distilled.cloud/core/errors";
+import { buildRequest, getAnn, mapKeys, matchTypedError, } from "@distilled.cloud/core/protocol-http";
+import { unwrapRedactedDeep, wrapSensitive, } from "@distilled.cloud/core/protocol-rest";
+import { validateResponse } from "@distilled.cloud/core/response-validation";
+import { parseRetryAfterForStatus } from "@distilled.cloud/core/retry-after";
+import { httpSymbol } from "@distilled.cloud/core/trait";
+/**
+ * StackitProtocol — the shared bearer-REST protocol instantiated for STACKIT.
+ *
+ * STACKIT speaks plain JSON with no success envelope. FAILURES are
+ * `{ "message": "...", "error": "..." }` (the `ErrorMessage` schema most
+ * product specs share). Each product has its own host, baked into the
+ * generated operation's `T.Http({ baseUrl })` from the OpenAPI `servers`
+ * entry; this protocol reads that URL and rewrites it for the configured
+ * region (`eu01` by default).
+ *
+ * Auth is `Authorization: Bearer <token>`. The API version is a PATH
+ * segment (`/v1`, `/v2`, …), so the generated operations carry versioned
+ * routes against a version-less host.
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { Credentials } from "./credentials.js";
+import { StackitParseError, UnknownStackitError } from "./errors.js";
+/**
+ * Rewrite a spec `servers` URL for the configured region.
+ *
+ *   • `{region}` still in the template (IaaS v1:
+ *     `https://iaas.api.{region}stackit.cloud`, default `eu01.`) is
+ *     substituted. A glued `{region}stackit` means the spec's default
+ *     includes the trailing dot.
+ *   • `https://<svc>.api.stackit.cloud` becomes
+ *     `https://<svc>.api.<region>.stackit.cloud`.
+ *   • `region === "global"` leaves the URL alone (after dropping any
+ *     leftover `{region}`).
+ */
+export const applyRegion = (specUrl, region) => {
+    if (specUrl.includes("{region}")) {
+        if (region === "global")
+            return specUrl.replaceAll("{region}", "");
+        const glued = specUrl.includes("{region}stackit");
+        const value = glued && !region.endsWith(".") ? `${region}.` : region;
+        return specUrl.replaceAll("{region}", value);
+    }
+    if (region === "global")
+        return specUrl;
+    return specUrl.replace(/^(https:\/\/[a-z0-9-]+)\.api\.stackit\.cloud(?=[:/?]|$)/i, `$1.api.${region}.stackit.cloud`);
+};
+const errorEnvelope = (body) => {
+    if (body === null || typeof body !== "object")
+        return undefined;
+    const b = body;
+    const message = typeof b.message === "string" ? b.message : undefined;
+    const code = typeof b.error === "string"
+        ? b.error
+        : typeof b.code === "string" || typeof b.code === "number"
+            ? b.code
+            : undefined;
+    if (message === undefined && code === undefined)
+        return undefined;
+    return { code, message };
+};
+const fail = (e) => Effect.fail(e);
+const baseUrlFor = (creds, inputAst) => {
+    if (creds.apiBaseUrl !== undefined && creds.apiBaseUrl !== "") {
+        return creds.apiBaseUrl;
+    }
+    const http = getAnn(inputAst, httpSymbol);
+    const specUrl = http?.baseUrl;
+    if (typeof specUrl !== "string" || specUrl === "") {
+        throw new Error("STACKIT operation is missing T.Http({ baseUrl }) — regenerate from convert");
+    }
+    return applyRegion(specUrl, creds.region);
+};
+export const StackitProtocol = Layer.succeed(API.Protocol, API.Protocol.of({
+    encode: ({ input, inputAst }) => Effect.gen(function* () {
+        const resolve = yield* Credentials;
+        const creds = yield* resolve;
+        return buildRequest({
+            input: unwrapRedactedDeep(input),
+            inputAst,
+            baseUrl: baseUrlFor(creds, inputAst),
+            headers: {
+                Authorization: `Bearer ${Redacted.value(creds.token)}`,
+            },
+        });
+    }),
+    decode: ({ response, outputAst, errors: errorClasses, }) => Effect.gen(function* () {
+        const text = (yield* response.text.pipe(Effect.orDie)) ?? "";
+        if (process.env.DISTILLED_DEBUG_HTTP) {
+            console.error(`[distilled] <- ${response.status} ${text.slice(0, 400)}`);
+        }
+        let json;
+        let nonJson = false;
+        if (text.trim().length > 0) {
+            try {
+                json = JSON.parse(text);
+            }
+            catch {
+                nonJson = true;
+            }
+        }
+        const status = response.status;
+        const headers = response.headers;
+        if (status >= 400) {
+            const env = (nonJson ? undefined : errorEnvelope(json)) ?? {};
+            const message = env.message ?? (nonJson && text.trim() ? text.trim() : `HTTP ${status}`);
+            const typed = matchTypedError(errorClasses, status, [
+                {
+                    code: typeof env.code === "number" ? env.code : undefined,
+                    message,
+                },
+            ], { body: nonJson ? text : json, headers });
+            if (typed !== undefined)
+                return yield* fail(typed);
+            const StatusErrorClass = HTTP_STATUS_MAP[status];
+            if (StatusErrorClass) {
+                return yield* fail(new StatusErrorClass({
+                    message,
+                    retryAfter: parseRetryAfterForStatus(status, headers),
+                }));
+            }
+            if (status >= 500) {
+                return yield* fail(new InternalServerError({
+                    message,
+                    retryAfter: parseRetryAfterForStatus(status, headers),
+                }));
+            }
+            return yield* fail(new UnknownStackitError({
+                code: typeof env.code === "string"
+                    ? env.code
+                    : env.code !== undefined
+                        ? String(env.code)
+                        : undefined,
+                message,
+                body: nonJson ? text : json,
+            }));
+        }
+        // Strict mode checks the mapped body against the output schema.
+        const body = nonJson ? text : (json ?? {});
+        const mapped = yield* validateResponse(outputAst, mapKeys(outputAst, body, "decode"), (cause) => new StackitParseError({ body: nonJson ? text : json, cause })).pipe(Effect.catch(fail));
+        return wrapSensitive(outputAst, mapped);
+    }),
+}));
+//# sourceMappingURL=protocol.js.map

package/lib/protocol.js.map

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

package/lib/protocol.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.test.d.ts.map

package/lib/protocol.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.test.d.ts","sourceRoot":"","sources":["../src/protocol.test.ts"],"names":[],"mappings":""}

package/lib/protocol.test.js

@@ -0,0 +1,181 @@
+import * as CoreErrors from "@distilled.cloud/core/errors";
+import * as ResponseValidation from "@distilled.cloud/core/response-validation";
+import * as Effect from "effect/Effect";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientResponse from "effect/http/HttpClientResponse";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { describe, expect, test } from "vitest";
+import { Credentials, credentials } from "./credentials.js";
+import { StackitParseError, UnknownStackitError } from "./errors.js";
+import { applyRegion } from "./protocol.js";
+import * as Retry from "./retry.js";
+import { listServers } from "./services/iaas.js";
+import { BadRequest, Conflict, deleteProject, getProject, listProjects, NotFound, } from "./services/resource_manager.js";
+import { getInstance } from "./services/secrets_manager.js";
+const fakeStackit = (status = 200, body = "{}", headers = {}) => {
+    const calls = [];
+    const layer = Layer.succeed(HttpClient.HttpClient, HttpClient.make((request, url) => Effect.sync(() => {
+        calls.push({
+            method: request.method,
+            url,
+            headers: { ...request.headers },
+            body: request.body._tag === "Uint8Array"
+                ? new TextDecoder().decode(request.body.body)
+                : undefined,
+        });
+        return HttpClientResponse.fromWeb(request, new Response(body, { status, headers }));
+    })));
+    return { calls, layer };
+};
+const creds = (config = {}) => credentials({ token: Redacted.make("stackit-token"), ...config });
+const run = (operation, http, credentialsLayer = creds()) => Effect.runPromise(operation.pipe(Retry.none, Effect.provide(credentialsLayer), Effect.provide(http)));
+const runFlip = (operation, http) => Effect.runPromise(operation.pipe(Retry.none, Effect.provide(creds()), Effect.provide(http), Effect.flip));
+const projectId = "11111111-2222-3333-4444-555555555555";
+describe("applyRegion", () => {
+    test("inserts the region into a version-less product host", () => {
+        expect(applyRegion("https://ske.api.stackit.cloud", "eu01")).toBe("https://ske.api.eu01.stackit.cloud");
+        expect(applyRegion("https://load-balancer.api.stackit.cloud/", "eu02")).toBe("https://load-balancer.api.eu02.stackit.cloud/");
+    });
+    test("substitutes a glued {region} template, adding the trailing dot", () => {
+        expect(applyRegion("https://argus.api.{region}stackit.cloud", "eu01")).toBe("https://argus.api.eu01.stackit.cloud");
+        expect(applyRegion("https://argus.api.{region}stackit.cloud", "eu01.")).toBe("https://argus.api.eu01.stackit.cloud");
+    });
+    test("substitutes a non-glued {region} template verbatim", () => {
+        expect(applyRegion("https://example.{region}.stackit.cloud", "eu01")).toBe("https://example.eu01.stackit.cloud");
+    });
+    test("'global' leaves hosts alone and drops a leftover {region}", () => {
+        expect(applyRegion("https://dns.api.stackit.cloud", "global")).toBe("https://dns.api.stackit.cloud");
+        expect(applyRegion("https://argus.api.{region}stackit.cloud", "global")).toBe("https://argus.api.stackit.cloud");
+    });
+    test("leaves non-STACKIT and already-regional hosts alone", () => {
+        expect(applyRegion("https://proxy.example.com", "eu01")).toBe("https://proxy.example.com");
+        expect(applyRegion("https://ske.api.eu01.stackit.cloud", "eu02")).toBe("https://ske.api.eu01.stackit.cloud");
+    });
+});
+describe("request encoding", () => {
+    test("sends Bearer auth to the product host in the default region (eu01)", async () => {
+        const { calls, layer } = fakeStackit(200, JSON.stringify({}));
+        await run(getProject({ id: projectId }), layer);
+        expect(calls[0].headers.authorization).toBe("Bearer stackit-token");
+        expect(calls[0].url.href).toBe(`https://resource-manager.api.eu01.stackit.cloud/v2/projects/${projectId}`);
+    });
+    test("each product uses its own host; the configured region is applied", async () => {
+        const iaas = fakeStackit(200, JSON.stringify({ items: [] }));
+        await run(listServers({ projectId, region: "eu02", details: true }), iaas.layer, creds({ region: "eu02" }));
+        expect(iaas.calls[0].url.href).toBe(`https://iaas.api.eu02.stackit.cloud/v2/projects/${projectId}/regions/eu02/servers?details=true`);
+        const secrets = fakeStackit(200, JSON.stringify({}));
+        await run(getInstance({ projectId, instanceId: "i-1" }), secrets.layer, creds({ region: "eu02" }));
+        expect(secrets.calls[0].url.href).toBe(`https://secrets-manager.api.eu02.stackit.cloud/v1/projects/${projectId}/instances/i-1`);
+    });
+    test("region 'global' keeps the spec host", async () => {
+        const { calls, layer } = fakeStackit(200, JSON.stringify({}));
+        await run(getProject({ id: projectId }), layer, creds({ region: "global" }));
+        expect(calls[0].url.origin).toBe("https://resource-manager.api.stackit.cloud");
+    });
+    test("an explicit apiBaseUrl overrides every product host", async () => {
+        const { calls, layer } = fakeStackit(200, JSON.stringify({}));
+        await run(getInstance({ projectId, instanceId: "i-1" }), layer, creds({ apiBaseUrl: "http://localhost:8080" }));
+        expect(calls[0].url.href).toBe(`http://localhost:8080/v1/projects/${projectId}/instances/i-1`);
+    });
+    test("resolves credentials per request", async () => {
+        const { calls, layer } = fakeStackit(200, JSON.stringify({}));
+        let n = 0;
+        const rotating = Layer.succeed(Credentials, Effect.sync(() => ({ token: Redacted.make(`t${++n}`), region: n === 1 ? "eu01" : "eu02" })));
+        await run(getProject({ id: projectId }), layer, rotating);
+        await run(getProject({ id: projectId }), layer, rotating);
+        expect(calls.map((c) => [c.headers.authorization, c.url.host])).toEqual([
+            ["Bearer t1", "resource-manager.api.eu01.stackit.cloud"],
+            ["Bearer t2", "resource-manager.api.eu02.stackit.cloud"],
+        ]);
+    });
+    test("labels are encoded; array queries repeat; wire query names are used", async () => {
+        const get = fakeStackit(200, JSON.stringify({}));
+        await run(getProject({ id: "a b/c" }), get.layer);
+        expect(get.calls[0].url.pathname).toBe("/v2/projects/a%20b%2Fc");
+        const list = fakeStackit(200, JSON.stringify({ items: [] }));
+        await run(listProjects({
+            containerIds: ["p1", "p2"],
+            limit: 10,
+            creation_time_start: "2024-01-01T00:00:00Z",
+        }), list.layer);
+        const url = list.calls[0].url;
+        expect(url.searchParams.getAll("containerIds")).toEqual(["p1", "p2"]);
+        expect(url.searchParams.get("limit")).toBe("10");
+        expect(url.searchParams.get("creation-time-start")).toBe("2024-01-01T00:00:00Z");
+    });
+});
+describe("{ message, error } failure envelope", () => {
+    test("a declared status class carries `message`", async () => {
+        const { layer } = fakeStackit(404, JSON.stringify({ message: "project not found", error: "Not Found" }));
+        const error = await runFlip(getProject({ id: projectId }), layer);
+        expect(error).toBeInstanceOf(NotFound);
+        expect(error).toMatchObject({ message: "project not found" });
+    });
+    test("409 matches the declared Conflict", async () => {
+        const { layer } = fakeStackit(409, JSON.stringify({ message: "has children", error: "Conflict" }));
+        const error = await runFlip(deleteProject({ id: projectId }), layer);
+        expect(error).toBeInstanceOf(Conflict);
+    });
+    test("400 matches the declared BadRequest", async () => {
+        const { layer } = fakeStackit(400, JSON.stringify({ message: "bad limit", error: "Bad Request" }));
+        const error = await runFlip(listProjects({ limit: -1 }), layer);
+        expect(error).toBeInstanceOf(BadRequest);
+        expect(error).toMatchObject({ message: "bad limit" });
+    });
+    test("undeclared statuses fall back to the core HTTP classes with Retry-After", async () => {
+        const { layer } = fakeStackit(429, JSON.stringify({ message: "slow down" }), {
+            "retry-after": "4",
+        });
+        const error = await runFlip(getProject({ id: projectId }), layer);
+        expect(error).toBeInstanceOf(CoreErrors.TooManyRequests);
+        expect(error).toMatchObject({ message: "slow down" });
+        expect(error.retryAfter).toBeDefined();
+    });
+    test("unmapped 5xx becomes InternalServerError; plain text is the message", async () => {
+        const { layer } = fakeStackit(507, "  insufficient storage\n");
+        const error = await runFlip(getProject({ id: projectId }), layer);
+        expect(error).toBeInstanceOf(CoreErrors.InternalServerError);
+        expect(error).toMatchObject({ message: "insufficient storage" });
+    });
+    test("an empty body uses `HTTP <status>` as message", async () => {
+        const { layer } = fakeStackit(404, "");
+        const error = await runFlip(getProject({ id: projectId }), layer);
+        expect(error).toBeInstanceOf(NotFound);
+        expect(error).toMatchObject({ message: "HTTP 404" });
+    });
+    test("unmapped 4xx becomes UnknownStackitError with `error` as code", async () => {
+        const body = { message: "teapot", error: "I'm a teapot" };
+        const { layer } = fakeStackit(418, JSON.stringify(body));
+        const error = await runFlip(getProject({ id: projectId }), layer);
+        expect(error).toBeInstanceOf(UnknownStackitError);
+        expect(error).toMatchObject({ code: "I'm a teapot", message: "teapot", body });
+    });
+    test("a numeric `code` is stringified when `error` is absent", async () => {
+        const body = { message: "teapot", code: 4180 };
+        const { layer } = fakeStackit(418, JSON.stringify(body));
+        const error = await runFlip(getProject({ id: projectId }), layer);
+        expect(error).toBeInstanceOf(UnknownStackitError);
+        expect(error).toMatchObject({ code: "4180", message: "teapot" });
+    });
+});
+describe("success decoding", () => {
+    test("the 2xx JSON body is the payload; empty bodies decode to {}", async () => {
+        const project = { containerId: "c", projectId, name: "p" };
+        const get = fakeStackit(200, JSON.stringify(project));
+        expect(await run(getProject({ id: projectId }), get.layer)).toEqual(project);
+        for (const [status, body] of [
+            [202, ""],
+            [204, null],
+        ]) {
+            const del = fakeStackit(status, body);
+            expect(await run(deleteProject({ id: projectId }), del.layer)).toEqual({});
+        }
+    });
+    test("strict validation fails a mismatched payload with StackitParseError", async () => {
+        const { layer } = fakeStackit(200, JSON.stringify({ name: 42 }));
+        const error = await Effect.runPromise(getProject({ id: projectId }).pipe(Retry.none, Effect.provide(creds()), Effect.provide(layer), Effect.provide(ResponseValidation.strict), Effect.flip));
+        expect(error).toBeInstanceOf(StackitParseError);
+    });
+});
+//# sourceMappingURL=protocol.test.js.map

package/lib/protocol.test.js.map

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

package/lib/retry.d.ts

@@ -0,0 +1,31 @@
+import { type Policy } from "@distilled.cloud/core/retry";
+/**
+ * STACKIT retry configuration.
+ *
+ * Defines the per-SDK `Retry` Context.Service tag that generated operations
+ * wire into `API.make`. Callers can install a blanket retry policy at the
+ * layer level and have every STACKIT API call below it pick it up:
+ *
+ * @example
+ * ```ts
+ * import * as Stackit from "@distilled.cloud/stackit";
+ *
+ * myEffect.pipe(Stackit.Retry.transient);
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+export { type Options, type Factory, type Policy, makeDefault, jittered, capped, throttlingOptions, transientOptions, throttlingFactory, transientFactory, } from "@distilled.cloud/core/retry";
+declare const Retry_base: Context.ServiceClass<Retry, "StackitRetry", Policy>;
+/** Context tag for configuring retry behavior of STACKIT API calls. */
+export declare class Retry extends Retry_base {
+}
+/** Provides a custom retry policy to every STACKIT API call below it. */
+export declare const policy: (optionsOrFactory: Policy) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/** Disables all automatic retries. */
+export declare const none: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/** Apply the throttling retry policy (retries throttling errors indefinitely). */
+export declare const throttling: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/** Apply the transient retry policy (retries all transient errors indefinitely). */
+export declare const transient: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+//# sourceMappingURL=retry.d.ts.map

package/lib/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAuC,MAAM,6BAA6B,CAAC;AAC/F;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;;AAErC,uEAAuE;AACvE,qBAAa,KAAM,SAAQ,UAAgD;CAAG;AAE9E,yEAAyE;AACzE,eAAO,MAAM,MAAM,qBAAsB,MAAM,sFACS,CAAC;AAEzD,sCAAsC;AACtC,eAAO,MAAM,IAAI,mFAA+D,CAAC;AAEjF,kFAAkF;AAClF,eAAO,MAAM,UAAU,mFAA4B,CAAC;AAEpD,oFAAoF;AACpF,eAAO,MAAM,SAAS,mFAA2B,CAAC"}

package/lib/retry.js

@@ -0,0 +1,31 @@
+import { throttlingFactory, transientFactory } from "@distilled.cloud/core/retry";
+/**
+ * STACKIT retry configuration.
+ *
+ * Defines the per-SDK `Retry` Context.Service tag that generated operations
+ * wire into `API.make`. Callers can install a blanket retry policy at the
+ * layer level and have every STACKIT API call below it pick it up:
+ *
+ * @example
+ * ```ts
+ * import * as Stackit from "@distilled.cloud/stackit";
+ *
+ * myEffect.pipe(Stackit.Retry.transient);
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+export { makeDefault, jittered, capped, throttlingOptions, transientOptions, throttlingFactory, transientFactory, } from "@distilled.cloud/core/retry";
+/** Context tag for configuring retry behavior of STACKIT API calls. */
+export class Retry extends Context.Service()("StackitRetry") {
+}
+/** Provides a custom retry policy to every STACKIT API call below it. */
+export const policy = (optionsOrFactory) => Effect.provide(Layer.succeed(Retry, optionsOrFactory));
+/** Disables all automatic retries. */
+export const none = Effect.provide(Layer.succeed(Retry, { while: () => false }));
+/** Apply the throttling retry policy (retries throttling errors indefinitely). */
+export const throttling = policy(throttlingFactory);
+/** Apply the transient retry policy (retries all transient errors indefinitely). */
+export const transient = policy(transientFactory);
+//# sourceMappingURL=retry.js.map

package/lib/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/F;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAIL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,uEAAuE;AACvE,MAAM,OAAO,KAAM,SAAQ,OAAO,CAAC,OAAO,EAAiB,CAAC,cAAc,CAAC;CAAG;AAE9E,yEAAyE;AACzE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,gBAAwB,EAAE,EAAE,CACjD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEzD,sCAAsC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAEjF,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEpD,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC"}