devflare 1.0.0-next.65 → 1.0.0-next.67

package/dist/_chunks/workspace-Ds3xMjOE.js

@@ -0,0 +1,175 @@
+import { createRequire } from "node:module";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "pathe";
+import { z } from "zod";
+//#region src/config/workspace.ts
+/**
+* Per-app entry in a workspace manifest.
+*
+* A pure worker app is reached directly on {@link WorkspaceApp.port}; a Vite app
+* is served by Vite on {@link WorkspaceApp.vitePort} and reaches its bindings
+* through the gateway bridge on {@link WorkspaceApp.bridgePort}.
+*/
+const workspaceAppSchema = z.object({
+	config: z.string().min(1),
+	name: z.string().min(1).optional(),
+	port: z.number().int().positive().max(65535).optional(),
+	vite: z.boolean().optional(),
+	vitePort: z.number().int().positive().max(65535).optional(),
+	bridgePort: z.number().int().positive().max(65535).optional(),
+	env: z.record(z.string()).optional()
+}).strict();
+const workspaceManifestSchema = z.object({
+	apps: z.array(workspaceAppSchema).min(1),
+	shared: z.object({
+		d1: z.array(z.string()).optional(),
+		r2: z.array(z.string()).optional(),
+		kv: z.array(z.string()).optional()
+	}).strict().optional(),
+	persist: z.string().min(1).optional(),
+	host: z.string().min(1).optional(),
+	entryPort: z.number().int().nonnegative().max(65535).optional()
+}).strict();
+/**
+* Type-safe helper for defining a devflare workspace manifest. Mirrors
+* {@link defineConfig}: it only attaches types and returns the value unchanged.
+*
+* @param manifest - The workspace manifest.
+* @returns The same manifest, typed.
+*
+* @example
+* // devflare.workspace.ts (repo root)
+* export default defineWorkspace({
+*   apps: [
+*     { config: './apps/api/devflare.config.ts', port: 8789, env: { DOC_API_DEV_SEED: '1' } },
+*     { config: './apps/web/devflare.config.ts', vite: true, vitePort: 5173, bridgePort: 8788 }
+*   ],
+*   shared: { d1: ['PLATFORM_DB'], r2: ['MEDIA'] }
+* })
+*/
+function defineWorkspace(manifest) {
+	return manifest;
+}
+/** Manifest file names searched at the workspace root, in priority order. */
+const WORKSPACE_MANIFEST_FILES = [
+	"devflare.workspace.ts",
+	"devflare.workspace.mts",
+	"devflare.workspace.js",
+	"devflare.workspace.mjs"
+];
+/**
+* The browser/direct-socket port a given app is reached on inside the shared
+* instance: `bridgePort` for a Vite app, `port` for a pure worker. Throws a
+* descriptive error when the required port is missing.
+*
+* @param app - A validated workspace app entry.
+* @param label - Human-readable app label for error messages.
+* @returns The direct-socket port for the app's gateway worker.
+* @throws When a Vite app omits `bridgePort` or a worker app omits `port`.
+*/
+function resolveAppDirectSocketPort(app, label) {
+	if (app.vite) {
+		if (app.bridgePort === void 0) throw new Error(`Workspace app "${label}" sets vite: true but is missing "bridgePort".`);
+		return app.bridgePort;
+	}
+	if (app.port === void 0) throw new Error(`Workspace app "${label}" is a pure worker but is missing "port".`);
+	return app.port;
+}
+/**
+* c12 resolves TypeScript/ESM manifests via jiti. Prefer the target project's
+* own `c12` install (mirrors {@link loadConfig}) so a monorepo that vendors
+* devflare per-app still transpiles the manifest; fall back to devflare's own.
+*/
+function resolveC12LoadConfig(cwd) {
+	const requireFromCwd = createRequire(join(cwd, "__devflare_workspace__.cjs"));
+	try {
+		return requireFromCwd("c12").loadConfig;
+	} catch {
+		return createRequire(import.meta.url)("c12").loadConfig;
+	}
+}
+/**
+* Load, transpile, and validate a workspace manifest.
+*
+* @param options - Search directory and optional explicit file.
+* @returns The validated manifest plus its resolved path/dir.
+* @throws {WorkspaceManifestNotFoundError} When no manifest file is found.
+* @throws {WorkspaceManifestValidationError} When the manifest fails schema validation.
+*/
+async function loadWorkspaceManifest(options = {}) {
+	const cwd = resolve(options.cwd ?? process.cwd());
+	const configFile = options.configFile ?? "devflare.workspace";
+	const explicitManifestPath = options.configFile ? resolve(cwd, options.configFile) : void 0;
+	if (!(explicitManifestPath !== void 0 && existsSync(explicitManifestPath) || WORKSPACE_MANIFEST_FILES.some((name) => existsSync(join(cwd, name))))) throw new WorkspaceManifestNotFoundError(cwd);
+	const { config, configFile: loadedFile } = await resolveC12LoadConfig(cwd)({
+		name: "devflare",
+		cwd,
+		configFile,
+		rcFile: false,
+		globalRc: false,
+		dotenv: false
+	});
+	if (!config || !loadedFile) throw new WorkspaceManifestNotFoundError(cwd);
+	const result = workspaceManifestSchema.safeParse(config);
+	if (!result.success) throw new WorkspaceManifestValidationError(result.error.issues, loadedFile);
+	return {
+		manifest: result.data,
+		manifestPath: loadedFile,
+		manifestDir: dirname(loadedFile)
+	};
+}
+/** Error thrown when no workspace manifest file is found. */
+var WorkspaceManifestNotFoundError = class extends Error {
+	code = "WORKSPACE_MANIFEST_NOT_FOUND";
+	constructor(cwd) {
+		super(`No workspace manifest found in ${cwd}.\nExpected one of: ${WORKSPACE_MANIFEST_FILES.join(", ")}\nCreate one that exports \`defineWorkspace({ apps: [...] })\`.`);
+		this.cwd = cwd;
+		this.name = "WorkspaceManifestNotFoundError";
+	}
+};
+/** Error thrown when a workspace manifest fails schema validation. */
+var WorkspaceManifestValidationError = class extends Error {
+	code = "WORKSPACE_MANIFEST_VALIDATION_ERROR";
+	constructor(issues, manifestPath) {
+		const issueMessages = issues.map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`);
+		super(`Invalid workspace manifest in ${manifestPath}:\n${issueMessages.join("\n")}`);
+		this.issues = issues;
+		this.manifestPath = manifestPath;
+		this.name = "WorkspaceManifestValidationError";
+	}
+};
+/**
+* Assert that every binding name listed in `manifest.shared` resolves to the
+* SAME local identifier across the apps that declare it — otherwise the apps
+* would silently get SEPARATE stores. Sharing is by id, so a mismatch is a real
+* bug in the configs, surfaced here as a loud error rather than a subtle
+* "writes don't appear" symptom.
+*
+* @param assertions - The `shared` block from the manifest.
+* @param resolved - Per-app resolved identifiers: `{ appLabel, d1, r2, kv }`
+*   where each map is `bindingName -> localIdentifier` for that app.
+* @throws When a shared binding resolves to differing ids (or is absent everywhere).
+*/
+function assertSharedBindingIds(assertions, resolved) {
+	for (const kind of [
+		"d1",
+		"r2",
+		"kv"
+	]) for (const bindingName of assertions[kind] ?? []) {
+		const seen = [];
+		for (const app of resolved) {
+			const id = app[kind][bindingName];
+			if (id !== void 0) seen.push({
+				appLabel: app.appLabel,
+				id
+			});
+		}
+		if (seen.length === 0) throw new Error(`Workspace "shared.${kind}" lists "${bindingName}", but no app declares that ${kind.toUpperCase()} binding.`);
+		if (new Set(seen.map((entry) => entry.id)).size > 1) {
+			const detail = seen.map((entry) => `${entry.appLabel} → ${entry.id}`).join(", ");
+			throw new Error(`Workspace "shared.${kind}" binding "${bindingName}" resolves to different ids across apps (${detail}); they would NOT share a store. Align the ${kind.toUpperCase()} id in the app configs.`);
+		}
+	}
+}
+//#endregion
+export { resolveAppDirectSocketPort as i, defineWorkspace as n, loadWorkspaceManifest as r, assertSharedBindingIds as t };

package/dist/browser.js

@@ -1,8 +1,8 @@
 import { n as defineConfig, t as ref } from "./_chunks/ref-CYJNAAe_.js";
-import { t as workerName } from "./_chunks/workerName-CFJsLZA-.js";
-import { n as getDurableObjectOptions, t as durableObject } from "./_chunks/decorators-QmV57ixr.js";
-import { F as BridgeClient, I as getClient, M as createEnvProxy, N as initEnv, P as setBindingHints } from "./_chunks/context-CQkLyah9.js";
-import { i as vars, r as env } from "./_chunks/env-_QKteEYJ.js";
+import { t as workerName } from "./_chunks/workerName-kEXwmV2m.js";
+import { n as getDurableObjectOptions, t as durableObject } from "./_chunks/decorators-eXNZ1S0N.js";
+import { F as BridgeClient, I as getClient, M as createEnvProxy, N as initEnv, P as setBindingHints } from "./_chunks/context-ZQydom21.js";
+import { i as vars, r as env } from "./_chunks/env-DyL6JOXI.js";
 //#region src/browser.ts
 function createUnsupportedApiError(name) {
 	return /* @__PURE__ */ new Error(`${name} is not available in browser environments; import from devflare/test or devflare/runtime in a worker/Node context instead.`);

package/dist/cli/commands/workspace.d.ts

@@ -0,0 +1,8 @@
+import { type ConsolaInstance } from 'consola';
+import type { CliOptions, CliResult, ParsedArgs } from '../index.js';
+/**
+ * Run the `workspace` command. Only the `dev` subcommand exists today; any
+ * other (or missing) subcommand prints guidance and exits non-zero.
+ */
+export declare function runWorkspaceCommand(parsed: ParsedArgs, logger: ConsolaInstance, options: CliOptions): Promise<CliResult>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/cli/commands/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/workspace.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,SAAS,CAAA;AAG7D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAGjE;;;GAGG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,CAAC,CAuGpB"}

package/dist/cli/help-pages/pages/core.d.ts

@@ -1,4 +1,4 @@
 import type { HelpPage } from '../types.js';
 export declare const CORE_HELP_PAGES: HelpPage[];
-export declare const CORE_COMMANDS: readonly ["init", "dev", "build", "deploy", "types", "doctor", "config", "account", "login", "previews", "productions", "worker", "tokens", "secrets", "tail", "ai", "remote", "help", "version"];
+export declare const CORE_COMMANDS: readonly ["init", "dev", "workspace", "build", "deploy", "types", "doctor", "config", "account", "login", "previews", "productions", "worker", "tokens", "secrets", "tail", "ai", "remote", "help", "version"];
 //# sourceMappingURL=core.d.ts.map

package/dist/cli/help-pages/pages/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/help-pages/pages/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,eAAO,MAAM,eAAe,EAAE,QAAQ,EAgcrC,CAAA;AAED,eAAO,MAAM,aAAa,mMAAW,CAAA"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/help-pages/pages/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,eAAO,MAAM,eAAe,EAAE,QAAQ,EA6erC,CAAA;AAED,eAAO,MAAM,aAAa,gNAAW,CAAA"}

package/dist/cli/help-pages/shared.d.ts

@@ -1,5 +1,5 @@
 import type { HelpEntry, HelpPage } from './types.js';
-export declare const COMMANDS: readonly ['init', 'dev', 'build', 'deploy', 'types', 'doctor', 'config', 'account', 'login', 'previews', 'productions', 'worker', 'tokens', 'secrets', 'tail', 'ai', 'remote', 'help', 'version'];
+export declare const COMMANDS: readonly ['init', 'dev', 'workspace', 'build', 'deploy', 'types', 'doctor', 'config', 'account', 'login', 'previews', 'productions', 'worker', 'tokens', 'secrets', 'tail', 'ai', 'remote', 'help', 'version'];
 export type Command = (typeof COMMANDS)[number];
 export declare const COMMAND_ALIASES: Record<string, string>;
 export declare const COMMON_OPTIONS: HelpEntry[];

package/dist/cli/help-pages/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/cli/help-pages/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAElD,eAAO,MAAM,QAAQ,YACpB,MAAM,EACN,KAAK,EACL,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,SAAS,CACA,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,CAAA;AAEzD,eAAO,MAAM,cAAc,EAAE,SAAS,EAgBrC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,SAG5B,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,EAM9C,CAAA;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAErE;AAuBD,KAAK,iCAAiC,GAAG,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,CAAC,EAAE,MAAM,EAAE,KACZ,QAAQ,CAAA;AAmBb,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACxB,QAAQ,CAaV;AAED,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,EAAE,MAAM,EAAE,GACb,QAAQ,CAUV;AAED,eAAO,MAAM,2BAA2B,mCAAsD,CAAA;AAE9F,eAAO,MAAM,+BAA+B,mCACW,CAAA"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/cli/help-pages/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAElD,eAAO,MAAM,QAAQ,YACpB,MAAM,EACN,KAAK,EACL,WAAW,EACX,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,SAAS,CACA,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,CAAA;AAEzD,eAAO,MAAM,cAAc,EAAE,SAAS,EAgBrC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,SAG5B,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,EAM9C,CAAA;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAErE;AAuBD,KAAK,iCAAiC,GAAG,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,CAAC,EAAE,MAAM,EAAE,KACZ,QAAQ,CAAA;AAmBb,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACxB,QAAQ,CAaV;AAED,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,EAAE,MAAM,EAAE,GACb,QAAQ,CAUV;AAED,eAAO,MAAM,2BAA2B,mCAAsD,CAAA;AAE9F,eAAO,MAAM,+BAA+B,mCACW,CAAA"}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2BAA2B,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAUD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAgEpD;AAMD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CA4GzF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2BAA2B,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAUD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAgEpD;AAMD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CA+GzF"}

package/dist/cli/index.js

@@ -1,2 +1,2 @@
-import { n as runCli, t as parseArgs } from "../_chunks/cli-z3FJ-9cO.js";
+import { n as runCli, t as parseArgs } from "../_chunks/cli-DXnofibT.js";
 export { parseArgs, runCli };

package/dist/cloudflare/index.js

@@ -1,4 +1,4 @@
-import { n as CloudflareAPIError, t as AuthenticationError } from "../_chunks/api-TzdliH-6.js";
-import { S as DEVFLARE_PREVIEW_REGISTRY_DATABASE, _ as devflarePreviewScopeRecordSchema, a as listTrackedPreviewRecords, b as devflareRecordSourceSchema, c as reconcilePreviewRegistry, d as devflareAccountLayerRecordSchema, f as devflareAccountRecordSchema, g as devflarePreviewRecordSchema, h as devflareDeploymentStatusSchema, i as listTrackedDeploymentRecords, l as retirePreviewRegistry, m as devflareDeploymentRecordSchema, n as ensurePreviewRegistry, o as listTrackedPreviewScopeRecords, p as devflareDeploymentChannelSchema, r as getPreviewRegistryContext, s as listTrackedRegistryState, t as cleanupPreviewRegistry, u as createDevflareAccountRecordSchema, v as devflarePreviewScopeStatusSchema, y as devflarePreviewStatusSchema } from "../_chunks/preview-registry-ClAbLTHH.js";
-import { t as account } from "../_chunks/cloudflare-BaloqI3H.js";
+import { n as CloudflareAPIError, t as AuthenticationError } from "../_chunks/api-BKClUlUf.js";
+import { S as DEVFLARE_PREVIEW_REGISTRY_DATABASE, _ as devflarePreviewScopeRecordSchema, a as listTrackedPreviewRecords, b as devflareRecordSourceSchema, c as reconcilePreviewRegistry, d as devflareAccountLayerRecordSchema, f as devflareAccountRecordSchema, g as devflarePreviewRecordSchema, h as devflareDeploymentStatusSchema, i as listTrackedDeploymentRecords, l as retirePreviewRegistry, m as devflareDeploymentRecordSchema, n as ensurePreviewRegistry, o as listTrackedPreviewScopeRecords, p as devflareDeploymentChannelSchema, r as getPreviewRegistryContext, s as listTrackedRegistryState, t as cleanupPreviewRegistry, u as createDevflareAccountRecordSchema, v as devflarePreviewScopeStatusSchema, y as devflarePreviewStatusSchema } from "../_chunks/preview-registry-CTXU4mBc.js";
+import { t as account } from "../_chunks/cloudflare-Ic5ubQza.js";
 export { AuthenticationError, CloudflareAPIError, DEVFLARE_PREVIEW_REGISTRY_DATABASE, account, cleanupPreviewRegistry, createDevflareAccountRecordSchema, devflareAccountLayerRecordSchema, devflareAccountRecordSchema, devflareDeploymentChannelSchema, devflareDeploymentRecordSchema, devflareDeploymentStatusSchema, devflarePreviewRecordSchema, devflarePreviewScopeRecordSchema, devflarePreviewScopeStatusSchema, devflarePreviewStatusSchema, devflareRecordSourceSchema, ensurePreviewRegistry, getPreviewRegistryContext, listTrackedDeploymentRecords, listTrackedPreviewRecords, listTrackedPreviewScopeRecords, listTrackedRegistryState, reconcilePreviewRegistry, retirePreviewRegistry };

package/dist/config/index.d.ts

@@ -1,4 +1,5 @@
 export { defineConfig, type DefineConfigInput, type TypedConfig } from './define.js';
+export { defineWorkspace, loadWorkspaceManifest, resolveAppDirectSocketPort, assertSharedBindingIds, WorkspaceManifestNotFoundError, WorkspaceManifestValidationError, type WorkspaceManifest, type WorkspaceManifestInput, type WorkspaceApp, type LoadedWorkspaceManifest, type LoadWorkspaceManifestOptions } from './workspace.js';
 export { env, isEnvVarDescriptor, loadDevflareDotenv, loadDevflareDotenvIntoProcess, parseDevflareEnvFile, resolveConfigEnvVars, EnvVarResolutionError, EnvVarParseError, type DevflareVarInput, type DevflareVarsInput, type EnvResolutionMode, type EnvVarDescriptor, type InferConfigVars, type MissingEnvVar, type ResolveConfigEnvVarsOptions } from './env-vars.js';
 export { preview, isPreviewScopedName, resolvePreviewIdentifier, materializePreviewScopedConfig, materializePreviewScopedString, type ResolvedPreviewIdentifier, type PreviewIdentifierSource, type PreviewScopeFn, type PreviewScopeOptions, type PreviewScopedName, type PreviewScopedNameOptions, type PreviewResolutionOptions } from './preview.js';
 export { configSchema, getLocalHyperdriveConfigIdentifier, getLocalKVNamespaceIdentifier, getSingleBrowserBindingName, getLocalD1DatabaseIdentifier, normalizeHyperdriveBinding, normalizeKVBinding, normalizeD1Binding, normalizeR2Binding, normalizeQueueProducer, normalizeDOBinding, normalizeMtlsCertificateBinding, normalizeDispatchNamespaceBinding, normalizeWorkflowBinding, normalizePipelineBinding, normalizeImagesBinding, normalizeMediaBinding, normalizeStreamBinding, normalizeVpcServiceBinding, normalizeVpcNetworkBinding, normalizeFlagshipBinding, normalizeSecretsStoreBinding, normalizeArtifactsBinding, type BrowserBindings, type D1Binding, type HyperdriveBinding, type DevflareConfig, type DevflareConfigInput, type DevflareEnvConfig, type PreviewConfig, type DurableObjectBinding, type KVBinding, type R2Binding, type QueueProducer, type NormalizedHyperdriveBinding, type NormalizedKVBinding, type NormalizedD1Binding, type NormalizedR2Binding, type NormalizedQueueProducer, type NormalizedDOBinding, type NormalizedMtlsCertificateBinding, type NormalizedDispatchNamespaceBinding, type NormalizedWorkflowBinding, type NormalizedPipelineBinding, type NormalizedImagesBinding, type NormalizedMediaBinding, type NormalizedStreamBinding, type NormalizedVpcServiceBinding, type NormalizedVpcNetworkBinding, type NormalizedFlagshipBinding, type NormalizedSecretsStoreBinding, type NormalizedArtifactsBinding, type QueueConsumer, type QueuesConfig, type RateLimitBinding, type VersionMetadataBinding, type WorkerLoaderBinding, type SecretsStoreBinding, type MtlsCertificateBinding, type DispatchNamespaceBinding, type WorkflowBinding, type PipelineBinding, type ImagesBinding, type MediaBinding, type ArtifactsBinding, type StreamBinding, type VpcServiceBinding, type VpcNetworkBinding, type FlagshipBinding, type ServiceBinding, type RouteConfig, type TailConsumerConfig, type WsRouteConfig, type AssetsConfig, type ContainerConfig, type ViteConfig, type RolldownConfig, type MigrationConfig } from './schema.js';

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

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

package/dist/config/workspace.d.ts

@@ -0,0 +1,282 @@
+import { z } from 'zod';
+/**
+ * Per-app entry in a workspace manifest.
+ *
+ * A pure worker app is reached directly on {@link WorkspaceApp.port}; a Vite app
+ * is served by Vite on {@link WorkspaceApp.vitePort} and reaches its bindings
+ * through the gateway bridge on {@link WorkspaceApp.bridgePort}.
+ */
+declare const workspaceAppSchema: z.ZodObject<{
+    /**
+     * Path to the app's `devflare.config.*`, relative to the manifest file
+     * (or absolute). The app's own config stays the single source of truth
+     * for its bindings/DOs/routes.
+     */
+    config: z.ZodString;
+    /**
+     * Namespace used to prefix this app's worker names inside the shared
+     * instance. Defaults to the app config's `name`. Must be unique across
+     * the workspace.
+     */
+    name: z.ZodOptional<z.ZodString>;
+    /**
+     * Browser-reachable direct-socket port for a pure-worker app. Required
+     * when `vite` is not set. This is the origin `portless`/the browser hits
+     * (e.g. `api.ui.localhost` → this port).
+     */
+    port: z.ZodOptional<z.ZodNumber>;
+    /** Spawn a Vite child process for this app (SvelteKit etc.). */
+    vite: z.ZodOptional<z.ZodBoolean>;
+    /** Vite dev-server port for a Vite app (default 5173). */
+    vitePort: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Gateway direct-socket port for a Vite app: the app's SvelteKit bridge
+     * dials `ws://localhost:<bridgePort>` for its bindings, and locally
+     * presigned R2 URLs are minted against it. Required when `vite` is set.
+     */
+    bridgePort: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Extra vars injected into this app's workers (on top of the app
+     * config's `vars`). Handy for one-shot dev seed flags such as
+     * `{ DOC_API_DEV_SEED: '1' }`.
+     */
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    config: string;
+    name?: string | undefined;
+    port?: number | undefined;
+    vite?: boolean | undefined;
+    vitePort?: number | undefined;
+    bridgePort?: number | undefined;
+    env?: Record<string, string> | undefined;
+}, {
+    config: string;
+    name?: string | undefined;
+    port?: number | undefined;
+    vite?: boolean | undefined;
+    vitePort?: number | undefined;
+    bridgePort?: number | undefined;
+    env?: Record<string, string> | undefined;
+}>;
+declare const workspaceManifestSchema: z.ZodObject<{
+    /** The apps co-hosted in one Miniflare instance. At least one. */
+    apps: z.ZodArray<z.ZodObject<{
+        /**
+         * Path to the app's `devflare.config.*`, relative to the manifest file
+         * (or absolute). The app's own config stays the single source of truth
+         * for its bindings/DOs/routes.
+         */
+        config: z.ZodString;
+        /**
+         * Namespace used to prefix this app's worker names inside the shared
+         * instance. Defaults to the app config's `name`. Must be unique across
+         * the workspace.
+         */
+        name: z.ZodOptional<z.ZodString>;
+        /**
+         * Browser-reachable direct-socket port for a pure-worker app. Required
+         * when `vite` is not set. This is the origin `portless`/the browser hits
+         * (e.g. `api.ui.localhost` → this port).
+         */
+        port: z.ZodOptional<z.ZodNumber>;
+        /** Spawn a Vite child process for this app (SvelteKit etc.). */
+        vite: z.ZodOptional<z.ZodBoolean>;
+        /** Vite dev-server port for a Vite app (default 5173). */
+        vitePort: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Gateway direct-socket port for a Vite app: the app's SvelteKit bridge
+         * dials `ws://localhost:<bridgePort>` for its bindings, and locally
+         * presigned R2 URLs are minted against it. Required when `vite` is set.
+         */
+        bridgePort: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Extra vars injected into this app's workers (on top of the app
+         * config's `vars`). Handy for one-shot dev seed flags such as
+         * `{ DOC_API_DEV_SEED: '1' }`.
+         */
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        config: string;
+        name?: string | undefined;
+        port?: number | undefined;
+        vite?: boolean | undefined;
+        vitePort?: number | undefined;
+        bridgePort?: number | undefined;
+        env?: Record<string, string> | undefined;
+    }, {
+        config: string;
+        name?: string | undefined;
+        port?: number | undefined;
+        vite?: boolean | undefined;
+        vitePort?: number | undefined;
+        bridgePort?: number | undefined;
+        env?: Record<string, string> | undefined;
+    }>, "many">;
+    /**
+     * Optional assertion of which binding names are intended to be shared.
+     * Sharing itself is automatic by binding id; this only turns a silent
+     * id-mismatch into a loud error at startup.
+     */
+    shared: z.ZodOptional<z.ZodObject<{
+        d1: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        r2: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        kv: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        d1?: string[] | undefined;
+        r2?: string[] | undefined;
+        kv?: string[] | undefined;
+    }, {
+        d1?: string[] | undefined;
+        r2?: string[] | undefined;
+        kv?: string[] | undefined;
+    }>>;
+    /**
+     * One persist directory for the whole workspace (relative to the
+     * manifest dir, or absolute). Default `.devflare/workspace-data`. A
+     * single instance owns it, so there is no cross-process file contention.
+     */
+    persist: z.ZodOptional<z.ZodString>;
+    /** Host the shared instance binds (entry + direct sockets). Default `127.0.0.1`. */
+    host: z.ZodOptional<z.ZodString>;
+    /**
+     * Port for the shared instance's entry socket. Browsers use the per-app
+     * direct sockets, so this is only for stray top-level requests; default
+     * `0` (ephemeral) avoids clashing with anything.
+     */
+    entryPort: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    apps: {
+        config: string;
+        name?: string | undefined;
+        port?: number | undefined;
+        vite?: boolean | undefined;
+        vitePort?: number | undefined;
+        bridgePort?: number | undefined;
+        env?: Record<string, string> | undefined;
+    }[];
+    shared?: {
+        d1?: string[] | undefined;
+        r2?: string[] | undefined;
+        kv?: string[] | undefined;
+    } | undefined;
+    persist?: string | undefined;
+    host?: string | undefined;
+    entryPort?: number | undefined;
+}, {
+    apps: {
+        config: string;
+        name?: string | undefined;
+        port?: number | undefined;
+        vite?: boolean | undefined;
+        vitePort?: number | undefined;
+        bridgePort?: number | undefined;
+        env?: Record<string, string> | undefined;
+    }[];
+    shared?: {
+        d1?: string[] | undefined;
+        r2?: string[] | undefined;
+        kv?: string[] | undefined;
+    } | undefined;
+    persist?: string | undefined;
+    host?: string | undefined;
+    entryPort?: number | undefined;
+}>;
+/** Validated workspace manifest (output type, defaults applied by the coordinator). */
+export type WorkspaceManifest = z.infer<typeof workspaceManifestSchema>;
+/** Author-facing manifest input (optional fields truly optional). */
+export type WorkspaceManifestInput = z.input<typeof workspaceManifestSchema>;
+/** A single validated app entry. */
+export type WorkspaceApp = z.infer<typeof workspaceAppSchema>;
+/**
+ * Type-safe helper for defining a devflare workspace manifest. Mirrors
+ * {@link defineConfig}: it only attaches types and returns the value unchanged.
+ *
+ * @param manifest - The workspace manifest.
+ * @returns The same manifest, typed.
+ *
+ * @example
+ * // devflare.workspace.ts (repo root)
+ * export default defineWorkspace({
+ *   apps: [
+ *     { config: './apps/api/devflare.config.ts', port: 8789, env: { DOC_API_DEV_SEED: '1' } },
+ *     { config: './apps/web/devflare.config.ts', vite: true, vitePort: 5173, bridgePort: 8788 }
+ *   ],
+ *   shared: { d1: ['PLATFORM_DB'], r2: ['MEDIA'] }
+ * })
+ */
+export declare function defineWorkspace(manifest: WorkspaceManifestInput): WorkspaceManifestInput;
+/**
+ * The browser/direct-socket port a given app is reached on inside the shared
+ * instance: `bridgePort` for a Vite app, `port` for a pure worker. Throws a
+ * descriptive error when the required port is missing.
+ *
+ * @param app - A validated workspace app entry.
+ * @param label - Human-readable app label for error messages.
+ * @returns The direct-socket port for the app's gateway worker.
+ * @throws When a Vite app omits `bridgePort` or a worker app omits `port`.
+ */
+export declare function resolveAppDirectSocketPort(app: WorkspaceApp, label: string): number;
+/** Result of loading a workspace manifest from disk. */
+export interface LoadedWorkspaceManifest {
+    /** The validated manifest. */
+    manifest: WorkspaceManifest;
+    /** Absolute path to the manifest file. */
+    manifestPath: string;
+    /** Directory containing the manifest — app config paths resolve against it. */
+    manifestDir: string;
+}
+/** Options for {@link loadWorkspaceManifest}. */
+export interface LoadWorkspaceManifestOptions {
+    /** Directory to search for the manifest (default: `process.cwd()`). */
+    cwd?: string;
+    /** Explicit manifest file (name or path) overriding auto-discovery. */
+    configFile?: string;
+}
+/**
+ * Load, transpile, and validate a workspace manifest.
+ *
+ * @param options - Search directory and optional explicit file.
+ * @returns The validated manifest plus its resolved path/dir.
+ * @throws {WorkspaceManifestNotFoundError} When no manifest file is found.
+ * @throws {WorkspaceManifestValidationError} When the manifest fails schema validation.
+ */
+export declare function loadWorkspaceManifest(options?: LoadWorkspaceManifestOptions): Promise<LoadedWorkspaceManifest>;
+/** Error thrown when no workspace manifest file is found. */
+export declare class WorkspaceManifestNotFoundError extends Error {
+    readonly cwd: string;
+    readonly code = "WORKSPACE_MANIFEST_NOT_FOUND";
+    constructor(cwd: string);
+}
+/** Error thrown when a workspace manifest fails schema validation. */
+export declare class WorkspaceManifestValidationError extends Error {
+    readonly issues: Array<{
+        path: (string | number)[];
+        message: string;
+    }>;
+    readonly manifestPath: string;
+    readonly code = "WORKSPACE_MANIFEST_VALIDATION_ERROR";
+    constructor(issues: Array<{
+        path: (string | number)[];
+        message: string;
+    }>, manifestPath: string);
+}
+/**
+ * Assert that every binding name listed in `manifest.shared` resolves to the
+ * SAME local identifier across the apps that declare it — otherwise the apps
+ * would silently get SEPARATE stores. Sharing is by id, so a mismatch is a real
+ * bug in the configs, surfaced here as a loud error rather than a subtle
+ * "writes don't appear" symptom.
+ *
+ * @param assertions - The `shared` block from the manifest.
+ * @param resolved - Per-app resolved identifiers: `{ appLabel, d1, r2, kv }`
+ *   where each map is `bindingName -> localIdentifier` for that app.
+ * @throws When a shared binding resolves to differing ids (or is absent everywhere).
+ */
+export declare function assertSharedBindingIds(assertions: NonNullable<WorkspaceManifest['shared']>, resolved: Array<{
+    appLabel: string;
+    d1: Record<string, string>;
+    r2: Record<string, string>;
+    kv: Record<string, string>;
+}>): void;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

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

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

package/dist/config-entry.js

@@ -1,3 +1,3 @@
 import { n as defineConfig, t as ref } from "./_chunks/ref-CYJNAAe_.js";
-import { i as preview, s as env } from "./_chunks/preview-C3Cdr8an.js";
+import { i as preview, s as env } from "./_chunks/preview-j9Kbx4-G.js";
 export { defineConfig as default, defineConfig, env, preview, ref };

package/dist/decorators/index.js

@@ -1,2 +1,2 @@
-import { n as getDurableObjectOptions, t as durableObject } from "../_chunks/decorators-QmV57ixr.js";
+import { n as getDurableObjectOptions, t as durableObject } from "../_chunks/decorators-eXNZ1S0N.js";
 export { durableObject, getDurableObjectOptions };

package/dist/dev-server/miniflare-dev-config.d.ts

@@ -27,6 +27,14 @@ export interface BuildMiniflareDevConfigInput {
      * when the config declares R2 bindings; ignored otherwise.
      */
     r2PresignSecret?: string | null;
+    /**
+     * Extra plain-string vars merged into every worker's `bindings` on top of
+     * the R2-presign vars. Used by the workspace coordinator to inject an app's
+     * manifest `env` (e.g. `DOC_API_DEV_SEED`) as worker-visible vars. The
+     * single-app `devflare dev` path never passes this, so its output is
+     * unchanged.
+     */
+    additionalInjectedVars?: Record<string, string>;
     logger?: ConsolaInstance;
 }
 /**

package/dist/dev-server/miniflare-dev-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"miniflare-dev-config.d.ts","sourceRoot":"","sources":["../../src/dev-server/miniflare-dev-config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAG9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAI/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAgClE,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,wBAAwB,CAAA;AAGvF,KAAK,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,4BAA4B;IAC5C,MAAM,EAAE,cAAc,CAAA;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,sBAAsB,EAAE,kBAAkB,CAAA;IAC1C,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAC7C,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C,wBAAwB,EAAE,MAAM,CAAA;IAChC,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IAC/B,wBAAwB,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAA;IAC1D;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,MAAM,CAAC,EAAE,eAAe,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,YAAY,EAAE,cAAc,CAAC,QAAQ,CAAC,EACtC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACnB,MAAM,CAOR;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,GAAG,CA+QhF"}
+{"version":3,"file":"miniflare-dev-config.d.ts","sourceRoot":"","sources":["../../src/dev-server/miniflare-dev-config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAG9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAI/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAgClE,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,wBAAwB,CAAA;AAGvF,KAAK,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,4BAA4B;IAC5C,MAAM,EAAE,cAAc,CAAA;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,sBAAsB,EAAE,kBAAkB,CAAA;IAC1C,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAC7C,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C,wBAAwB,EAAE,MAAM,CAAA;IAChC,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IAC/B,wBAAwB,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAA;IAC1D;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/C,MAAM,CAAC,EAAE,eAAe,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,YAAY,EAAE,cAAc,CAAC,QAAQ,CAAC,EACtC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACnB,MAAM,CAOR;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,GAAG,CAyRhF"}