devflare 1.0.0-next.5 → 1.0.0-next.51

package/dist/config/ref.d.ts

@@ -1,5 +1,5 @@
-import type { DevflareConfigInput } from './schema';
-import type { TypedConfig } from './define';
+import type { TypedConfig } from './define.js';
+import type { DevflareConfigInput } from './schema.js';
 /**
  * Extract entrypoint type from a TypedConfig
  * Falls back to string if no type parameter was provided
@@ -36,8 +36,21 @@ export interface WorkerBinding {
 export interface DOBindingRef {
     /** DO class name */
     readonly className: string;
-    /** Worker name that hosts this DO (for cross-worker access) */
+    /**
+     * Worker name that hosts this DO (for cross-worker access).
+     *
+     * Prefer the `kind` discriminator below for branching; reach for
+     * `scriptName` only when you need the actual script identifier.
+     */
     readonly scriptName: string;
+    /**
+     * Discriminator: `ref()`-produced DO bindings are always
+     * `'cross-worker'` because they target a host worker imported via a
+     * separate `devflare.config`. Bindings on the same worker are emitted
+     * directly via `bindings.durableObjects` and surface as a
+     * `NormalizedDOBinding` with `kind: 'local'`.
+     */
+    readonly kind: 'cross-worker';
     /** @internal Reference for test context setup */
     readonly __ref?: RefResult;
 }
@@ -134,27 +147,5 @@ export interface RefResult<TConfig extends DevflareConfigInput = DevflareConfigI
 export declare function ref<TImport extends () => Promise<{
     default: DevflareConfigInput;
 } | DevflareConfigInput>>(nameOrImport: string | TImport, maybeImport?: TImport): RefResult<ExtractConfig<TImport>>;
-/**
- * @deprecated Use `ref()` instead and call `.resolve()` if you need immediate access.
- */
-export declare function resolveRef<TConfig extends DevflareConfigInput>(configImport: ConfigImport<TConfig>, options?: {
-    workerName?: string;
-    entrypoint?: string;
-}): Promise<RefResult<TConfig>>;
-/**
- * @deprecated Use `refResult.worker` or `refResult.worker('entrypoint')` instead.
- */
-export declare function serviceBinding(refOrLegacy: RefResult | {
-    name: string;
-    entrypoint?: string;
-    config?: unknown;
-    configPath?: string;
-}, options?: {
-    entrypoint?: string;
-}): WorkerBinding;
-/**
- * @deprecated Legacy type alias
- */
-export type ServiceBindingWithRef = WorkerBinding;
 export {};
 //# sourceMappingURL=ref.d.ts.map

package/dist/config/ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/config/ref.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/config/ref.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAMnD;;;GAGG;AACH,KAAK,kBAAkB,CAAC,OAAO,IAAI,OAAO,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;AAEpF;;;GAGG;AACH,KAAK,aAAa,CAAC,OAAO,IAAI,OAAO,SAAS,MAAM,OAAO,CAAC,MAAM,OAAO,CAAC,GACvE,OAAO,SAAS;IAAE,OAAO,EAAE,MAAM,OAAO,CAAA;CAAE,GACzC,OAAO,GACP,OAAO,GACR,mBAAmB,CAAA;AAEtB;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,IAAI,MAAM,OAAO,CACrF;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAClB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,oBAAoB;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC1B;AAED;;;;GAIG;AACH,KAAK,aAAa,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa;IACjG;;;OAGG;IACH,CAAC,UAAU,EAAE,YAAY,GAAG,aAAa,CAAA;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS,CAAC,OAAO,SAAS,mBAAmB,GAAG,mBAAmB;IACnF;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAA;IAEnE;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAEhC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAEzE;;;;OAIG;IACH,QAAQ,EAAE,CAAC,EAAE,aAAa,GAAG,YAAY,CAAA;CACzC;AA0FD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,GAAG,CAClB,OAAO,SAAS,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAAG,mBAAmB,CAAC,EACpF,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA"}

package/dist/config/resolve-phased.d.ts

@@ -0,0 +1,72 @@
+import { type PrepareMaterializedConfigResourcesForDeployOptions } from './deploy-resources.js';
+import { type PreviewResolutionOptions } from './preview.js';
+import { type ResolveMaterializedConfigResourcesOptions } from './resource-resolution.js';
+import type { DevflareConfig } from './schema.js';
+declare const __phaseBrand: unique symbol;
+/**
+ * `DevflareConfig` after the build-phase pipeline. KV/D1/Hyperdrive bindings
+ * may still carry `{ name }`-only entries because the build artefact is
+ * reproducible offline and resolves IDs at deploy.
+ */
+export type BuildConfig = DevflareConfig & {
+    readonly [__phaseBrand]: 'build';
+};
+/**
+ * `DevflareConfig` after the local-phase pipeline. KV/D1/Hyperdrive bindings
+ * have been materialized into stable local identifiers via
+ * `getLocalXIdentifier()` helpers.
+ */
+export type LocalConfig = DevflareConfig & {
+    readonly [__phaseBrand]: 'local';
+};
+/**
+ * `DevflareConfig` after the deploy-phase pipeline. KV/D1/Hyperdrive bindings
+ * have been resolved (and optionally provisioned) against a live Cloudflare
+ * account.
+ */
+export type DeployConfig = DevflareConfig & {
+    readonly [__phaseBrand]: 'deploy';
+};
+export type Phase = 'build' | 'local' | 'deploy';
+/**
+ * Configurations whose KV/D1/Hyperdrive bindings are guaranteed to carry an
+ * `id` field (either a real Cloudflare resource ID or a stable local
+ * identifier). `compileConfig()` requires this brand so that passing a raw
+ * `DevflareConfig` is rejected at compile time rather than runtime.
+ */
+export type ResolvedConfig = LocalConfig | DeployConfig;
+/**
+ * Cast helper used at the resolve-phase boundaries. The brand is a phantom
+ * intersection so this is a zero-cost reinterpretation.
+ */
+export declare function brandAsLocalConfig(config: DevflareConfig): LocalConfig;
+/**
+ * Cast helper used at the resolve-phase boundaries. The brand is a phantom
+ * intersection so this is a zero-cost reinterpretation.
+ */
+export declare function brandAsDeployConfig(config: DevflareConfig): DeployConfig;
+export type PhaseConfig<P extends Phase> = P extends 'build' ? BuildConfig : P extends 'local' ? LocalConfig : P extends 'deploy' ? DeployConfig : never;
+export interface ResolveResourcesCommonOptions {
+    environment?: string;
+    preview?: PreviewResolutionOptions;
+}
+export interface ResolveResourcesBuildOptions extends ResolveResourcesCommonOptions {
+    phase: 'build';
+}
+export interface ResolveResourcesLocalOptions extends ResolveResourcesCommonOptions {
+    phase: 'local';
+}
+export interface ResolveResourcesDeployOptions extends ResolveResourcesCommonOptions, ResolveMaterializedConfigResourcesOptions {
+    phase: 'deploy';
+    provision?: boolean;
+    preparation?: PrepareMaterializedConfigResourcesForDeployOptions;
+}
+export type ResolveResourcesOptions = ResolveResourcesBuildOptions | ResolveResourcesLocalOptions | ResolveResourcesDeployOptions;
+/**
+ * Unified phase-discriminated resource resolver. Facade over the legacy
+ * per-phase helpers; stamps the appropriate phase brand on the returned
+ * config so callers can narrow at the type layer.
+ */
+export declare function resolveResources<O extends ResolveResourcesOptions>(config: DevflareConfig, options: O): Promise<PhaseConfig<O['phase']>>;
+export {};
+//# sourceMappingURL=resolve-phased.d.ts.map

package/dist/config/resolve-phased.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-phased.d.ts","sourceRoot":"","sources":["../../src/config/resolve-phased.ts"],"names":[],"mappings":"AA8BA,OAAO,EACN,KAAK,kDAAkD,EAEvD,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,wBAAwB,EAAkC,MAAM,WAAW,CAAA;AAEzF,OAAO,EACN,KAAK,yCAAyC,EAG9C,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAA;AAEzC;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE/E;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE/E;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEjF,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,YAAY,CAAA;AAEvD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CAEtE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAExE;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,OAAO,GACzD,WAAW,GACX,CAAC,SAAS,OAAO,GAChB,WAAW,GACX,CAAC,SAAS,QAAQ,GACjB,YAAY,GACZ,KAAK,CAAA;AAEV,MAAM,WAAW,6BAA6B;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,wBAAwB,CAAA;CAClC;AAED,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B;IAClF,KAAK,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B;IAClF,KAAK,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,6BAChB,SAAQ,6BAA6B,EACpC,yCAAyC;IAC1C,KAAK,EAAE,QAAQ,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,kDAAkD,CAAA;CAChE;AAED,MAAM,MAAM,uBAAuB,GAChC,4BAA4B,GAC5B,4BAA4B,GAC5B,6BAA6B,CAAA;AAEhC;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,uBAAuB,EACvE,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,CAAC,GACR,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAsClC"}

package/dist/config/resolve.d.ts

@@ -0,0 +1,11 @@
+import type { DevflareConfig } from './schema.js';
+export declare function mergeConfigForEnvironment(config: DevflareConfig, environment?: string): DevflareConfig;
+/**
+ * @internal Prefer the unified `resolveResources(config, { phase: 'build' })`
+ * facade for the env-merge + preview-materialize pipeline. This lower-level
+ * helper remains exported as the implementation that the seam and the
+ * build-time compiler delegate to; it is not part of the recommended public
+ * surface.
+ */
+export declare function resolveConfigForEnvironment(config: DevflareConfig, environment?: string): DevflareConfig;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/config/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AA2C9C,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,MAAM,GAClB,cAAc,CAQhB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,MAAM,GAClB,cAAc,CAMhB"}

package/dist/config/resource-resolution.d.ts

@@ -0,0 +1,80 @@
+import { getPrimaryAccount, listD1Databases, listHyperdrives, listKVNamespaces } from '../cloudflare/account.js';
+import { getEffectiveAccountId } from '../cloudflare/preferences.js';
+import { type LoadConfigOptions } from './loader.js';
+import type { PreviewResolutionOptions } from './preview.js';
+import { type DeployConfig, type LocalConfig } from './resolve-phased.js';
+import { type DevflareConfig } from './schema.js';
+interface CloudflareConfigResolutionApi {
+    getPrimaryAccount: typeof getPrimaryAccount;
+    getEffectiveAccountId: typeof getEffectiveAccountId;
+    listKVNamespaces: typeof listKVNamespaces;
+    listD1Databases: typeof listD1Databases;
+    listHyperdrives: typeof listHyperdrives;
+}
+export interface ResolveConfigResourcesOptions {
+    environment?: string;
+    env?: PreviewResolutionOptions['env'];
+    identifier?: string;
+    accountId?: string;
+    cloudflare?: Partial<CloudflareConfigResolutionApi>;
+}
+export interface ResolveMaterializedConfigResourcesOptions {
+    accountId?: string;
+    cloudflare?: Partial<CloudflareConfigResolutionApi>;
+}
+export interface LoadResolvedConfigOptions extends LoadConfigOptions {
+    env?: PreviewResolutionOptions['env'];
+    identifier?: string;
+    accountId?: string;
+    cloudflare?: Partial<CloudflareConfigResolutionApi>;
+}
+export declare class ConfigResourceResolutionError extends Error {
+    readonly code = "CONFIG_RESOURCE_RESOLUTION_ERROR";
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Resolve environment overrides and normalize KV/D1/Hyperdrive bindings for purely local runtimes.
+ *
+ * Local Miniflare/workerd flows can use either an explicit resource ID or the
+ * stable resource name as the backing identifier, so this path avoids requiring
+ * Cloudflare auth for local development and tests.
+ *
+ * @internal Prefer the unified `resolveResources(config, { phase: 'local' })`
+ * facade. This lower-level helper remains exported for backwards compatibility
+ * and as the implementation that the seam delegates to; it is not part of the
+ * recommended public surface and may be removed in a future major release.
+ */
+export declare function resolveConfigForLocalRuntime(config: DevflareConfig, environment?: string): LocalConfig;
+/**
+ * Resolve Cloudflare-backed resource references such as KV/D1/Hyperdrive
+ * name bindings into concrete IDs.
+ *
+ * Used by the deploy path and by automation/programmatic consumers that need
+ * fully-resolved bindings against a live Cloudflare account. The build path
+ * intentionally does NOT call this — `compileBuildConfig({ preserveNamedBindings: true })`
+ * keeps name-only bindings symbolic in the build artifact so builds remain
+ * reproducible offline. Pick this helper only when ID resolution is desired.
+ *
+ * @internal Prefer the unified `resolveResources(config, { phase: 'deploy' })`
+ * facade. This lower-level helper remains exported as the implementation the
+ * seam delegates to; it is not part of the recommended public surface.
+ */
+export declare function resolveMaterializedConfigResources(resolvedConfig: DevflareConfig, options?: ResolveMaterializedConfigResourcesOptions): Promise<DeployConfig>;
+/**
+ * Resolve Cloudflare-backed resource references such as KV/D1/Hyperdrive name bindings into
+ * concrete IDs for build, deploy, and automation workflows.
+ *
+ * @internal Prefer the unified `resolveResources(config, { phase: 'deploy' })`
+ * facade. This wrapper is now a thin shim over the seam, retained for
+ * backwards compatibility with existing callers (`loadResolvedConfig`, etc.).
+ */
+export declare function resolveConfigResources(config: DevflareConfig, options?: ResolveConfigResourcesOptions): Promise<DeployConfig>;
+/**
+ * Load devflare.config.* and resolve any Cloudflare-backed resource references.
+ *
+ * This is the public Node-side API for external automation that needs the same
+ * resolved values Devflare build/deploy flows use.
+ */
+export declare function loadResolvedConfig(options?: LoadResolvedConfigOptions): Promise<DeployConfig>;
+export {};
+//# sourceMappingURL=resource-resolution.d.ts.map

package/dist/config/resource-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-resolution.d.ts","sourceRoot":"","sources":["../../src/config/resource-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAajE,OAAO,EAAE,KAAK,iBAAiB,EAAc,MAAM,UAAU,CAAA;AAC7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAEzD,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,WAAW,EAIhB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACN,KAAK,cAAc,EAGnB,MAAM,UAAU,CAAA;AAEjB,UAAU,6BAA6B;IACtC,iBAAiB,EAAE,OAAO,iBAAiB,CAAA;IAC3C,qBAAqB,EAAE,OAAO,qBAAqB,CAAA;IACnD,gBAAgB,EAAE,OAAO,gBAAgB,CAAA;IACzC,eAAe,EAAE,OAAO,eAAe,CAAA;IACvC,eAAe,EAAE,OAAO,eAAe,CAAA;CACvC;AAUD,MAAM,WAAW,6BAA6B;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,yCAAyC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IACnE,GAAG,CAAC,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAA;CACnD;AAED,qBAAa,6BAA8B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,sCAAqC;IAElD,YAAY,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAM3C;CACD;AAgFD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,MAAM,GAClB,WAAW,CAiBb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kCAAkC,CACvD,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE,yCAA8C,GACrD,OAAO,CAAC,YAAY,CAAC,CAoEvB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,6BAAkC,GACzC,OAAO,CAAC,YAAY,CAAC,CAYvB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC,YAAY,CAAC,CAGvB"}