alchemy 2.0.0-beta.74 → 2.0.0-beta.76

package/lib/Railway/Service.d.ts

@@ -0,0 +1,444 @@
+import type { Builder, RestartPolicyType } from "@distilled.cloud/railway";
+import * as Effect from "effect/Effect";
+import type * as Redacted from "effect/Redacted";
+import { Platform, type Main, type MainRpc, type PlatformProps } from "../Platform.ts";
+import type { Resource } from "../Resource.ts";
+import type { ServerHost } from "../Server/Process.ts";
+import type { ServiceBinding } from "./MountVolume.ts";
+import type { Project } from "./Project.ts";
+import type { Providers } from "./Providers.ts";
+import { type ExtraFile, type RailwayBuildOptions, type RailwayHostRuntimeContext } from "./hosted.ts";
+/**
+ * A resource-valued prop: the resource itself, or an Effect that produces
+ * it (so `yield* Project(...)` and `Project(...)` both type-check).
+ */
+type Ref<T> = T | Effect.Effect<T, never, Providers>;
+export type { ExtraFile, RailwayBuildOptions };
+/**
+ * Environment identity a Service is deployed into. Accepts a
+ * `Railway.Project` (its primary environment), a `Railway.Environment`,
+ * or an `{ environmentId }` stub.
+ */
+export type ServiceEnvironment = {
+    readonly environmentId: string;
+};
+export interface ServiceProps extends PlatformProps {
+    /**
+     * Parent Railway Project. Accepts a `Railway.Project` or an Effect
+     * that produces one. Changing the Project replaces the Service.
+     */
+    project: Ref<Project>;
+    /**
+     * Environment to deploy the service instance into. Accepts a
+     * `Railway.Project` (primary environment), a `Railway.Environment`, or
+     * `{ environmentId }`. Defaults to the project's primary environment.
+     * Changing it replaces the Service.
+     */
+    environment?: Ref<ServiceEnvironment>;
+    /**
+     * Module entrypoint bundled with rolldown and packed into a generated
+     * Dockerfile. Railway builds that Dockerfile (`railway up`). Typically
+     * `import.meta.url`. Mutually exclusive with the public-image path
+     * (`image` without `main`). A content-hash change updates in place.
+     */
+    main?: string;
+    /**
+     * Docker image Railway should run.
+     *
+     * When `main` is omitted this is `source.image` (e.g.
+     * `hashicorp/http-echo`). When `main` is set this is the generated
+     * Dockerfile's `FROM` (default `node:26-slim`).
+     */
+    image?: string;
+    /**
+     * Region for the service instance (`us-west2`, `us-east4`, …). If
+     * omitted, Railway picks the default. Updates in place.
+     */
+    region?: string;
+    /**
+     * Port the process listens on. Written to `PORT` and used as the
+     * generated `*.up.railway.app` `targetPort`. Default is `3000` for
+     * Effect-native (`main`) Services. Pass `5678` for
+     * `hashicorp/http-echo`.
+     */
+    port?: number;
+    /**
+     * Additional environment variables. Merged after binding-injected
+     * `env`. Upserted as service-scoped Railway variables with
+     * `skipDeploys: true`; this Service owns the subsequent deploy.
+     */
+    env?: Record<string, any>;
+    /**
+     * Private-mesh RPC token. Minted by a child `Alchemy.Random`
+     * (`{logicalId}RpcToken`) and persisted in state. Set automatically.
+     */
+    rpcToken?: Redacted.Redacted<string>;
+    /**
+     * Bundler configuration for `main`: rolldown `input`/`output`
+     * overrides, plus `install` for packages that must ship as real
+     * `node_modules` (see {@link RailwayBuildOptions}).
+     */
+    build?: RailwayBuildOptions;
+    /**
+     * Extra files/directories copied into `/app` in the generated
+     * Dockerfile (`COPY dest /app/dest`). Website composites use this to
+     * bake the framework `clientDirectory` (or Next.js `.next`) so asset
+     * changes rebuild on Railway.
+     */
+    extraFiles?: ReadonlyArray<ExtraFile>;
+    /**
+     * Named export to load from `main`.
+     *
+     * @default "default"
+     */
+    handler?: string;
+    /**
+     * Service name. Unique per Project. If omitted, a unique name is
+     * generated from the stack, stage and logical ID. Changing it updates
+     * in place via `serviceUpdate`.
+     */
+    name?: string;
+    /**
+     * GitHub repository (`owner/repo`). Creates/syncs
+     * `serviceCreate.source.repo` / `serviceInstanceUpdate.source.repo`.
+     * Mutually exclusive with the public-image and `main` paths. Requires a
+     * GitHub connection on the Railway account.
+     */
+    repo?: string;
+    /**
+     * GitHub branch for {@link repo}. Passed as `serviceCreate.branch` and
+     * synced onto the deployment trigger.
+     */
+    branch?: string;
+    /**
+     * Monorepo subdirectory Railway builds from (`rootDirectory`).
+     */
+    rootDirectory?: string;
+    /**
+     * Build command (`pnpm build`). Distinct from hosted
+     * {@link RailwayBuildOptions} (`build.install`).
+     */
+    buildCommand?: string;
+    /**
+     * Start command (`pnpm start`).
+     */
+    startCommand?: string;
+    /**
+     * HTTP healthcheck path (`/health`). Synced via
+     * `serviceInstanceUpdate.healthcheckPath`. Alias of {@link healthcheck}
+     * (Railway IaC `healthcheck: "/health"`).
+     */
+    healthcheckPath?: string;
+    /**
+     * HTTP healthcheck path. Same as {@link healthcheckPath}; matches
+     * Railway IaC `healthcheck`.
+     */
+    healthcheck?: string;
+    /**
+     * Healthcheck timeout in seconds.
+     */
+    healthcheckTimeout?: number;
+    /**
+     * Cron expression (`cronSchedule`). Observed as `cronSchedule` /
+     * `nextCronRunAt`.
+     */
+    cronSchedule?: string;
+    /**
+     * Restart policy (`ALWAYS`, `NEVER`, `ON_FAILURE`).
+     */
+    restartPolicyType?: RestartPolicyType;
+    /**
+     * Max retries when {@link restartPolicyType} is `ON_FAILURE`.
+     */
+    restartPolicyMaxRetries?: number;
+    /**
+     * Drain window in seconds before a replica is stopped.
+     */
+    drainingSeconds?: number;
+    /**
+     * Overlap window in seconds while a new replica starts.
+     */
+    overlapSeconds?: number;
+    /**
+     * Sleep the application when idle.
+     */
+    sleepApplication?: boolean;
+    /**
+     * Auto-deploy on new commits / image tags
+     * (`serviceInstanceAutoDeployUpdate`).
+     */
+    autoUpdates?: boolean;
+    /**
+     * Dockerfile path relative to {@link rootDirectory}.
+     */
+    dockerfilePath?: string;
+    /**
+     * Builder (`RAILPACK`, `NIXPACKS`, `HEROKU`, `PAKETO`).
+     */
+    builder?: Builder;
+    /**
+     * Git watch patterns that trigger a rebuild.
+     */
+    watchPatterns?: string[];
+}
+export type Service = Resource<"Railway.Service", ServiceProps, {
+    /** Railway service id. */
+    serviceId: string;
+    /** Physical service name (unique per project). */
+    name: string;
+    /** Parent Railway project id. */
+    projectId: string;
+    /** Environment the instance is deployed in. */
+    environmentId: string;
+    /** Observed `source.image`, if set. */
+    image: string | undefined;
+    /** Observed `source.repo` (`owner/repo`), if set. */
+    repo: string | undefined;
+    /** Observed healthcheck path. */
+    healthcheckPath: string | undefined;
+    /** Observed healthcheck timeout in seconds. */
+    healthcheckTimeout: number | undefined;
+    /**
+     * Observed replica count. Alchemy does not set this — Railway
+     * load-balances whatever is running (default 1).
+     */
+    replicas: number | undefined;
+    /** Observed build command. */
+    buildCommand: string | undefined;
+    /** Observed start command. */
+    startCommand: string | undefined;
+    /** Observed cron schedule. */
+    cronSchedule: string | undefined;
+    /** Observed root directory. */
+    rootDirectory: string | undefined;
+    /** Observed region, if Railway reported one. */
+    region: string | undefined;
+    /** Port published on the generated service domain. */
+    port: number | undefined;
+    /** Public `https://{domain}` URL (`*.up.railway.app`). */
+    url: string | undefined;
+    /** Generated Railway service domain hostname. */
+    domain: string | undefined;
+    /**
+     * Internal DNS name on the default private mesh
+     * (`{name}.railway.internal`). Derived from the service name — no
+     * extra API call.
+     */
+    dnsName: string;
+    /**
+     * Shared token for private schemaless RPC. Value of the child
+     * `Alchemy.Random` resource. Packed onto callers by `bindService` /
+     * `bindFunction`; never send this to the public internet.
+     */
+    rpcToken: string;
+    /** Railway service domain id. */
+    domainId: string | undefined;
+    /** Latest deployment id, if one exists. */
+    deploymentId: string | undefined;
+    /** Latest deployment status (`SUCCESS`, `DEPLOYING`, …). */
+    deploymentStatus: string | undefined;
+    /** Content hash of the bundled program (empty for public images). */
+    code: {
+        hash: string;
+    };
+}, ServiceBinding, Providers>;
+export declare const isService: (value: unknown) => value is Service;
+export type ServiceServices = ServerHost;
+export type ServiceShape = Main<ServiceServices> & MainRpc<ServiceServices>;
+export type ServiceRuntimeContext = RailwayHostRuntimeContext;
+/**
+ * A Railway.Service is a container in a Project. Point it at a public
+ * image (`hashicorp/http-echo`) or an Effect program (`main`). Alchemy
+ * stamps the name, creates a `*.up.railway.app` domain via
+ * `serviceDomainCreate`, and deploys.
+ *
+ * @see https://docs.railway.com/guides/services
+ *
+ * ### Image service
+ * Pass `image` without `main`. Railway pulls the image and runs it.
+ * `url` is the generated `*.up.railway.app` hostname.
+ *
+ * **Example:** Public image
+ * ```typescript
+ * const site = yield* Railway.Project("Site");
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ * });
+ * ```
+ *
+ * :::caution[Changing `project` replaces the Service]
+ * The Service is created in the new Project. The old Service is deleted.
+ * :::
+ *
+ * ### Effect-native Service
+ * A Service is a class. `main: import.meta.url` is the bundle
+ * entrypoint. Alchemy bundles this file with Rolldown, generates a
+ * Dockerfile (`FROM node:26-slim`), and uploads the context. Railway
+ * builds the image. `build.install: ["pg"]` ships `pg` unbundled.
+ *
+ * **Example:** Class + Project + main
+ * ```typescript
+ * export default class Api extends Railway.Service<Api>()(
+ *   "Api",
+ *   {
+ *     project: Site,
+ *     main: import.meta.url,
+ *     build: { install: ["pg"] },
+ *   },
+ *   Effect.gen(function* () {
+ *     return {
+ *       fetch: Effect.succeed(HttpServerResponse.text("hello")),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * ### The public URL
+ * Yield the Service in the Stack. `api.url` is
+ * `https://{name}.up.railway.app`.
+ *
+ * **Example:** Stack output
+ * ```typescript
+ * export default Alchemy.Stack(
+ *   "MyApp",
+ *   { providers: Railway.providers(), state: Alchemy.localState() },
+ *   Effect.gen(function* () {
+ *     const api = yield* Api;
+ *     return { url: api.url };
+ *   }),
+ * );
+ * ```
+ *
+ * ### Pin a region
+ * Omit `region` to use Railway's default. Updating it is in place.
+ *
+ * **Example:** Region
+ * ```typescript
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ *   region: "us-west2",
+ * });
+ * ```
+ *
+ * ### Healthcheck
+ * `healthcheckPath` (or `healthcheck`, matching Railway IaC) is the
+ * HTTP path Railway probes. Railway load-balances public traffic
+ * across whatever replicas are running. Alchemy does not pin a count.
+ *
+ * **Example:** Healthcheck
+ * ```typescript
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ *   healthcheck: "/health",
+ * });
+ * ```
+ *
+ * :::caution[One volume per service]
+ * Railway does not give each replica its own disk. A second volume
+ * on one Service fails with `Railway.MultipleVolumes`.
+ * :::
+ *
+ * ### GitHub source
+ * `repo` + `branch` is the third source, next to `image` and `main`.
+ * Railway must have GitHub connected to the account.
+ *
+ * **Example:** GitHub repo
+ * ```typescript
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   repo: "acme/web",
+ *   branch: "main",
+ *   rootDirectory: "apps/api",
+ *   buildCommand: "pnpm build",
+ *   startCommand: "pnpm start",
+ * });
+ * ```
+ *
+ * ### Cron
+ * `cronSchedule` runs the service on a cron expression.
+ *
+ * **Example:** Cron schedule
+ * ```typescript
+ * const worker = yield* Railway.Service("Worker", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   cronSchedule: "0 * * * *",
+ * });
+ * ```
+ *
+ * ### Mount a disk
+ * Bind {@link MountVolume} inside init. Provide {@link MountVolumeLive}.
+ *
+ * **Example:** Volume
+ * ```typescript
+ * export default class Api extends Railway.Service<Api>()(
+ *   "Api",
+ *   { project: Site, image: "hashicorp/http-echo", port: 5678 },
+ *   Effect.gen(function* () {
+ *     const disk = yield* Railway.MountVolume(Data, { path: "/data" });
+ *     return {
+ *       fetch: Effect.succeed(HttpServerResponse.text(disk.path)),
+ *     };
+ *   }).pipe(Effect.provide(Railway.MountVolumeLive)),
+ * ) {}
+ * ```
+ *
+ * ### Schemaless RPC
+ * Return methods next to `fetch`. Another Service or Function binds
+ * this class and calls them over `{name}.railway.internal` with a
+ * shared token. Public `*.up.railway.app` requests to `/__rpc__/*`
+ * get 401.
+ *
+ * **Example:** Bind a Service
+ * ```typescript
+ * export default class Query extends Railway.Service<Query>()(
+ *   "Query",
+ *   { project: Site, main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     return {
+ *       greet: (name: string) => Effect.succeed(`hello ${name}`),
+ *     };
+ *   }),
+ * ) {}
+ *
+ * export default class Api extends Railway.Function<Api>()(
+ *   "Api",
+ *   { project: Site, main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const query = yield* Railway.bindService(Query);
+ *     return {
+ *       fetch: query
+ *         .greet("sam")
+ *         .pipe(Effect.map((greeting) => HttpServerResponse.text(greeting))),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * ### Module-scope declarations
+ * Declare the Project once. Pass it into every child. Resource-valued
+ * props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope Service
+ * ```typescript
+ * // src/api.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * export const Api = Railway.Service("Api", {
+ *   project: Site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ * });
+ * ```
+ *
+ * @resource
+ */
+export declare const Service: Platform<Service, ServiceServices, ServiceShape, ServiceRuntimeContext>;
+//# sourceMappingURL=Service.d.ts.map

package/lib/Railway/Service.d.ts.map

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

package/lib/Railway/Service.js

@@ -0,0 +1,229 @@
+import * as Effect from "effect/Effect";
+import { Platform, } from "../Platform.js";
+import { createRailwayHostRuntimeContext, } from "./hosted.js";
+import { serveRailwayRpc } from "./rpc-server.js";
+import { mintRpcToken } from "./rpc-token.js";
+export const isService = (value) => typeof value === "object" &&
+    value !== null &&
+    value.Type === "Railway.Service";
+const createServiceRuntimeContext = (id) => {
+    const base = createRailwayHostRuntimeContext("Railway.Service")(id);
+    const inner = base.serve;
+    return Object.assign(base, {
+        serve: ((handler, options) => inner((options?.shape === undefined
+            ? handler
+            : serveRailwayRpc(options.shape, handler)), options)),
+    });
+};
+/**
+ * A Railway.Service is a container in a Project. Point it at a public
+ * image (`hashicorp/http-echo`) or an Effect program (`main`). Alchemy
+ * stamps the name, creates a `*.up.railway.app` domain via
+ * `serviceDomainCreate`, and deploys.
+ *
+ * @see https://docs.railway.com/guides/services
+ *
+ * ### Image service
+ * Pass `image` without `main`. Railway pulls the image and runs it.
+ * `url` is the generated `*.up.railway.app` hostname.
+ *
+ * **Example:** Public image
+ * ```typescript
+ * const site = yield* Railway.Project("Site");
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ * });
+ * ```
+ *
+ * :::caution[Changing `project` replaces the Service]
+ * The Service is created in the new Project. The old Service is deleted.
+ * :::
+ *
+ * ### Effect-native Service
+ * A Service is a class. `main: import.meta.url` is the bundle
+ * entrypoint. Alchemy bundles this file with Rolldown, generates a
+ * Dockerfile (`FROM node:26-slim`), and uploads the context. Railway
+ * builds the image. `build.install: ["pg"]` ships `pg` unbundled.
+ *
+ * **Example:** Class + Project + main
+ * ```typescript
+ * export default class Api extends Railway.Service<Api>()(
+ *   "Api",
+ *   {
+ *     project: Site,
+ *     main: import.meta.url,
+ *     build: { install: ["pg"] },
+ *   },
+ *   Effect.gen(function* () {
+ *     return {
+ *       fetch: Effect.succeed(HttpServerResponse.text("hello")),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * ### The public URL
+ * Yield the Service in the Stack. `api.url` is
+ * `https://{name}.up.railway.app`.
+ *
+ * **Example:** Stack output
+ * ```typescript
+ * export default Alchemy.Stack(
+ *   "MyApp",
+ *   { providers: Railway.providers(), state: Alchemy.localState() },
+ *   Effect.gen(function* () {
+ *     const api = yield* Api;
+ *     return { url: api.url };
+ *   }),
+ * );
+ * ```
+ *
+ * ### Pin a region
+ * Omit `region` to use Railway's default. Updating it is in place.
+ *
+ * **Example:** Region
+ * ```typescript
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ *   region: "us-west2",
+ * });
+ * ```
+ *
+ * ### Healthcheck
+ * `healthcheckPath` (or `healthcheck`, matching Railway IaC) is the
+ * HTTP path Railway probes. Railway load-balances public traffic
+ * across whatever replicas are running. Alchemy does not pin a count.
+ *
+ * **Example:** Healthcheck
+ * ```typescript
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ *   healthcheck: "/health",
+ * });
+ * ```
+ *
+ * :::caution[One volume per service]
+ * Railway does not give each replica its own disk. A second volume
+ * on one Service fails with `Railway.MultipleVolumes`.
+ * :::
+ *
+ * ### GitHub source
+ * `repo` + `branch` is the third source, next to `image` and `main`.
+ * Railway must have GitHub connected to the account.
+ *
+ * **Example:** GitHub repo
+ * ```typescript
+ * const api = yield* Railway.Service("Api", {
+ *   project: site,
+ *   repo: "acme/web",
+ *   branch: "main",
+ *   rootDirectory: "apps/api",
+ *   buildCommand: "pnpm build",
+ *   startCommand: "pnpm start",
+ * });
+ * ```
+ *
+ * ### Cron
+ * `cronSchedule` runs the service on a cron expression.
+ *
+ * **Example:** Cron schedule
+ * ```typescript
+ * const worker = yield* Railway.Service("Worker", {
+ *   project: site,
+ *   image: "hashicorp/http-echo",
+ *   cronSchedule: "0 * * * *",
+ * });
+ * ```
+ *
+ * ### Mount a disk
+ * Bind {@link MountVolume} inside init. Provide {@link MountVolumeLive}.
+ *
+ * **Example:** Volume
+ * ```typescript
+ * export default class Api extends Railway.Service<Api>()(
+ *   "Api",
+ *   { project: Site, image: "hashicorp/http-echo", port: 5678 },
+ *   Effect.gen(function* () {
+ *     const disk = yield* Railway.MountVolume(Data, { path: "/data" });
+ *     return {
+ *       fetch: Effect.succeed(HttpServerResponse.text(disk.path)),
+ *     };
+ *   }).pipe(Effect.provide(Railway.MountVolumeLive)),
+ * ) {}
+ * ```
+ *
+ * ### Schemaless RPC
+ * Return methods next to `fetch`. Another Service or Function binds
+ * this class and calls them over `{name}.railway.internal` with a
+ * shared token. Public `*.up.railway.app` requests to `/__rpc__/*`
+ * get 401.
+ *
+ * **Example:** Bind a Service
+ * ```typescript
+ * export default class Query extends Railway.Service<Query>()(
+ *   "Query",
+ *   { project: Site, main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     return {
+ *       greet: (name: string) => Effect.succeed(`hello ${name}`),
+ *     };
+ *   }),
+ * ) {}
+ *
+ * export default class Api extends Railway.Function<Api>()(
+ *   "Api",
+ *   { project: Site, main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const query = yield* Railway.bindService(Query);
+ *     return {
+ *       fetch: query
+ *         .greet("sam")
+ *         .pipe(Effect.map((greeting) => HttpServerResponse.text(greeting))),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * ### Module-scope declarations
+ * Declare the Project once. Pass it into every child. Resource-valued
+ * props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope Service
+ * ```typescript
+ * // src/api.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * export const Api = Railway.Service("Api", {
+ *   project: Site,
+ *   image: "hashicorp/http-echo",
+ *   port: 5678,
+ * });
+ * ```
+ *
+ * @resource
+ */
+export const Service = Platform("Railway.Service", {
+    createRuntimeContext: createServiceRuntimeContext,
+    transformProps: (id, props) => Effect.gen(function* () {
+        if (globalThis.__ALCHEMY_RUNTIME__)
+            return props;
+        const project = Effect.isEffect(props.project)
+            ? yield* props.project
+            : props.project;
+        const environment = props.environment === undefined
+            ? undefined
+            : Effect.isEffect(props.environment)
+                ? yield* props.environment
+                : props.environment;
+        const rpcToken = yield* mintRpcToken(id);
+        return { ...props, project, environment, rpcToken };
+    }),
+});
+//# sourceMappingURL=Service.js.map

package/lib/Railway/Service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Service.js","sourceRoot":"","sources":["../../src/Railway/Service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EACL,QAAQ,GAIT,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EACL,+BAA+B,GAIhC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAuP9C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE,CAC5D,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACb,KAA2B,CAAC,IAAI,KAAK,iBAAiB,CAAC;AAQ1D,MAAM,2BAA2B,GAAG,CAAC,EAAU,EAAyB,EAAE;IACxE,MAAM,IAAI,GAAG,+BAA+B,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAC3B,KAAK,CACH,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS;YAC3B,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,eAAe,CACb,OAAO,CAAC,KAAK,EACb,OAAqB,CACtB,CAAmB,EACxB,OAAO,CACR,CAAmC;KACvC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiMG;AACH,MAAM,CAAC,MAAM,OAAO,GAKhB,QAAQ,CAAC,iBAAiB,EAAE;IAC9B,oBAAoB,EAAE,2BAA2B;IACjD,cAAc,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAC5B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,IAAI,UAAU,CAAC,mBAAmB;YAAE,OAAO,KAAK,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;YAC5C,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAmD;YAClE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAClB,MAAM,WAAW,GACf,KAAK,CAAC,WAAW,KAAK,SAAS;YAC7B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;gBAClC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAIZ;gBACH,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACtD,CAAC,CAAC;CACL,CAAC,CAAC"}