devflare 1.0.0-next.16 → 1.0.0-next.18

package/dist/config/compiler.d.ts

@@ -1,4 +1,5 @@
 import { type DevflareConfig } from './schema';
+import type { ResolvedConfig } from './resolve-phased';
 /**
  * Wrangler config type — represents the output format for wrangler.jsonc
  */
@@ -10,14 +11,8 @@ export interface WranglerConfig {
     compatibility_flags?: string[];
     preview_urls?: boolean;
     workers_dev?: boolean;
-    kv_namespaces?: Array<{
-        binding: string;
-        id: string;
-    }>;
-    d1_databases?: Array<{
-        binding: string;
-        database_id: string;
-    }>;
+    kv_namespaces?: WranglerKVNamespaceBinding[];
+    d1_databases?: WranglerD1DatabaseBinding[];
     r2_buckets?: Array<{
         binding: string;
         bucket_name: string;
@@ -57,10 +52,7 @@ export interface WranglerConfig {
         binding: string;
         index_name: string;
     }>;
-    hyperdrive?: Array<{
-        binding: string;
-        id: string;
-    }>;
+    hyperdrive?: WranglerHyperdriveBinding[];
     browser?: {
         binding: string;
     };
@@ -107,14 +99,44 @@ export interface WranglerConfig {
     }>;
     [key: string]: unknown;
 }
+export type WranglerKVNamespaceBinding = {
+    binding: string;
+    id: string;
+} | {
+    binding: string;
+    name: string;
+};
+export type WranglerD1DatabaseBinding = {
+    binding: string;
+    database_id: string;
+} | {
+    binding: string;
+    database_name: string;
+};
+export type WranglerHyperdriveBinding = {
+    binding: string;
+    id: string;
+} | {
+    binding: string;
+    name: string;
+};
 /**
- * Compile DevflareConfig to WranglerConfig
+ * Compile a phase-resolved DevflareConfig to WranglerConfig.
  *
- * @param config - The devflare configuration
+ * R1 step 3 — input is type-narrowed to `ResolvedConfig` (`LocalConfig |
+ * DeployConfig`) so callers cannot accidentally pass a raw `DevflareConfig`
+ * whose KV/D1/Hyperdrive bindings might still be name-only. The runtime
+ * throw remains as a defence-in-depth guard for callers that bypass the
+ * type system (e.g. via `as any`).
+ *
+ * @param config - A phase-resolved devflare configuration (`LocalConfig` or `DeployConfig`)
  * @param environment - Optional environment name for env-specific overrides
  * @returns Wrangler-compatible configuration object
  */
-export declare function compileConfig(config: DevflareConfig, environment?: string): WranglerConfig;
+export declare function compileConfig(config: ResolvedConfig, environment?: string): WranglerConfig;
+export declare function compileBuildConfig(config: DevflareConfig, environment?: string, options?: {
+    alreadyResolved?: boolean;
+}): WranglerConfig;
 /**
  * Compile DevflareConfig to programmatic config for @cloudflare/vite-plugin
  * This is used instead of wrangler.jsonc in dev mode
@@ -123,7 +145,9 @@ export declare function compileConfig(config: DevflareConfig, environment?: stri
  * @param environment - Optional environment name for env-specific overrides
  * @returns Config object compatible with cloudflare({ config: ... })
  */
-export declare function compileToProgrammaticConfig(config: DevflareConfig, environment?: string): Record<string, unknown>;
+export declare function compileToProgrammaticConfig(config: DevflareConfig, environment?: string, options?: {
+    preserveNamedBindings?: boolean;
+}): Record<string, unknown>;
 /**
  * Convert WranglerConfig to JSONC string with comments
  */
@@ -139,19 +163,36 @@ export declare function rebaseWranglerConfigPaths(projectRoot: string, configDir
  * @returns Path to the written file
  */
 export declare function writeWranglerConfig(cwd: string, config: WranglerConfig, filename?: string): Promise<string>;
+export declare function readWranglerConfig(filePath: string): Promise<WranglerConfig>;
 /**
- * Compile DO Worker config from DevflareConfig
- * This creates a separate worker config that exports the DO classes
+ * Compile DO Worker configs from DevflareConfig.
+ *
+ * Each distinct Durable Object class is emitted as its own compiled worker
+ * entry. The worker name is derived from the class being compiled (or from
+ * an explicit `scriptName` on a binding for that class), never from the
+ * first binding encountered.
+ *
+ * **Public-API only.** This helper is exported for downstream tooling that
+ * orchestrates multi-worker DO topologies on top of devflare. The internal
+ * `devflare build` / `devflare deploy` pipeline does **not** call this —
+ * it emits a single Wrangler config and relies on `wrangler` to handle DO
+ * placement. C9 in `REMAINING.md` tracks this caveat: nothing inside the
+ * package exercises this function, so behaviour for current consumers is
+ * defined by the (small) test surface rather than by the build/deploy
+ * happy path. Pass `preserveNamedBindings: true` if you want the same
+ * build-time name preservation that `compileBuildConfig()` uses.
  *
  * @param config - The devflare configuration
  * @param doWorkerEntry - Path to the DO worker entry file (e.g., 'src/workers/do-worker.ts')
  * @param options - Additional options
  * @param options.absoluteMain - If true, resolve main to absolute path using cwd
  * @param options.cwd - Working directory for resolving absolute paths
- * @returns Wrangler config for the DO worker, or null if no DOs configured
+ * @returns Array of Wrangler configs — one per DO class. Empty when no DOs configured.
  */
 export declare function compileDOWorkerConfig(config: DevflareConfig, doWorkerEntry: string, options?: {
     absoluteMain?: boolean;
     cwd?: string;
-}): WranglerConfig | null;
+    environment?: string;
+    preserveNamedBindings?: boolean;
+}): WranglerConfig[];
 //# sourceMappingURL=compiler.d.ts.map

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

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

package/dist/config/deploy-resources.d.ts

@@ -0,0 +1,58 @@
+import { createD1Database, createKVNamespace, createQueue, createR2Bucket, getPrimaryAccount, listD1Databases, listHyperdrives, listKVNamespaces, listQueues, listR2Buckets, listVectorizeIndexes } from '../cloudflare/account';
+import { getEffectiveAccountId } from '../cloudflare/preferences';
+import { type PreviewResolutionOptions } from './preview';
+import { type DevflareConfig } from './schema';
+import { type DeployConfig } from './resolve-phased';
+interface DeployResourcePreparationApi {
+    getPrimaryAccount: typeof getPrimaryAccount;
+    getEffectiveAccountId: typeof getEffectiveAccountId;
+    listKVNamespaces: typeof listKVNamespaces;
+    createKVNamespace: typeof createKVNamespace;
+    listD1Databases: typeof listD1Databases;
+    createD1Database: typeof createD1Database;
+    listR2Buckets: typeof listR2Buckets;
+    createR2Bucket: typeof createR2Bucket;
+    listQueues: typeof listQueues;
+    createQueue: typeof createQueue;
+    listHyperdrives: typeof listHyperdrives;
+    listVectorizeIndexes: typeof listVectorizeIndexes;
+}
+export interface DeployResourceNames {
+    kv: string[];
+    d1: string[];
+    r2: string[];
+    queues: string[];
+    vectorize: string[];
+    hyperdrive: string[];
+}
+export interface PrepareConfigResourcesForDeployOptions {
+    environment?: string;
+    env?: PreviewResolutionOptions['env'];
+    identifier?: string;
+    accountId?: string;
+    cloudflare?: Partial<DeployResourcePreparationApi>;
+    /** C6 — see `PrepareMaterializedConfigResourcesForDeployOptions.describeOnly`. */
+    describeOnly?: boolean;
+}
+export interface PrepareMaterializedConfigResourcesForDeployOptions {
+    accountId?: string;
+    cloudflare?: Partial<DeployResourcePreparationApi>;
+    /**
+     * C6 — describe-only mode. When true, no `create*` Cloudflare APIs are
+     * called. Resources missing in the account are reported via the returned
+     * `created` field (their IDs are placeholder strings prefixed with
+     * `<would-create:>`), so dry-run can render the same plan that a real
+     * deploy would execute without performing any side effects.
+     */
+    describeOnly?: boolean;
+}
+export interface PrepareConfigResourcesForDeployResult {
+    config: DeployConfig;
+    created: DeployResourceNames;
+    existing: DeployResourceNames;
+    warnings: string[];
+}
+export declare function prepareMaterializedConfigResourcesForDeploy(resolvedConfig: DevflareConfig, options?: PrepareMaterializedConfigResourcesForDeployOptions): Promise<PrepareConfigResourcesForDeployResult>;
+export declare function prepareConfigResourcesForDeploy(config: DevflareConfig, options?: PrepareConfigResourcesForDeployOptions): Promise<PrepareConfigResourcesForDeployResult>;
+export {};
+//# sourceMappingURL=deploy-resources.d.ts.map

package/dist/config/deploy-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-resources.d.ts","sourceRoot":"","sources":["../../src/config/deploy-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,oBAAoB,EAOpB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAYjE,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAIN,KAAK,cAAc,EACnB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE3F,UAAU,4BAA4B;IACrC,iBAAiB,EAAE,OAAO,iBAAiB,CAAA;IAC3C,qBAAqB,EAAE,OAAO,qBAAqB,CAAA;IACnD,gBAAgB,EAAE,OAAO,gBAAgB,CAAA;IACzC,iBAAiB,EAAE,OAAO,iBAAiB,CAAA;IAC3C,eAAe,EAAE,OAAO,eAAe,CAAA;IACvC,gBAAgB,EAAE,OAAO,gBAAgB,CAAA;IACzC,aAAa,EAAE,OAAO,aAAa,CAAA;IACnC,cAAc,EAAE,OAAO,cAAc,CAAA;IACrC,UAAU,EAAE,OAAO,UAAU,CAAA;IAC7B,WAAW,EAAE,OAAO,WAAW,CAAA;IAC/B,eAAe,EAAE,OAAO,eAAe,CAAA;IACvC,oBAAoB,EAAE,OAAO,oBAAoB,CAAA;CACjD;AAiBD,MAAM,WAAW,mBAAmB;IACnC,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,sCAAsC;IACtD,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,4BAA4B,CAAC,CAAA;IAClD,kFAAkF;IAClF,YAAY,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,kDAAkD;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAA;IAClD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,qCAAqC;IACrD,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB;AAuRD,wBAAsB,2CAA2C,CAChE,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE,kDAAuD,GAC9D,OAAO,CAAC,qCAAqC,CAAC,CAmLhD;AAED,wBAAsB,+BAA+B,CACpD,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,sCAA2C,GAClD,OAAO,CAAC,qCAAqC,CAAC,CAqBhD"}

package/dist/config/index.d.ts

@@ -1,9 +1,12 @@
 export { defineConfig } from './define';
 export { preview, isPreviewScopedName, resolvePreviewIdentifier, materializePreviewScopedConfig, materializePreviewScopedString, type ResolvedPreviewIdentifier, type PreviewIdentifierSource, type PreviewScopeFn, type PreviewScopeOptions, type PreviewScopedName, type PreviewScopedNameOptions, type PreviewResolutionOptions } from './preview';
 export { configSchema, getLocalHyperdriveConfigIdentifier, getLocalKVNamespaceIdentifier, getSingleBrowserBindingName, getLocalD1DatabaseIdentifier, normalizeHyperdriveBinding, normalizeKVBinding, normalizeD1Binding, normalizeDOBinding, type BrowserBindings, type D1Binding, type HyperdriveBinding, type DevflareConfig, type DevflareConfigInput, type DevflareEnvConfig, type PreviewConfig, type DurableObjectBinding, type KVBinding, type NormalizedHyperdriveBinding, type NormalizedKVBinding, type NormalizedD1Binding, type NormalizedDOBinding, type QueueConsumer, type QueuesConfig, type ServiceBinding, type RouteConfig, type WsRouteConfig, type AssetsConfig, type ViteConfig, type RolldownConfig, type MigrationConfig } from './schema';
-export { compileConfig, stringifyConfig, writeWranglerConfig, type WranglerConfig } from './compiler';
+export { compileBuildConfig, compileConfig, readWranglerConfig, stringifyConfig, writeWranglerConfig, type WranglerConfig, type WranglerD1DatabaseBinding, type WranglerHyperdriveBinding, type WranglerKVNamespaceBinding } from './compiler';
 export { loadConfig, loadResolvedConfig, resolveConfigPath, ConfigNotFoundError, ConfigValidationError, ConfigResourceResolutionError, type LoadConfigOptions } from './loader';
 export { resolveConfigForEnvironment } from './resolve';
-export { resolveConfigForLocalRuntime, resolveMaterializedConfigResources, resolveConfigResources, type LoadResolvedConfigOptions, type ResolveMaterializedConfigResourcesOptions, type ResolveConfigResourcesOptions } from './resource-resolution';
+export { resolveMaterializedConfigResources, type LoadResolvedConfigOptions, type ResolveMaterializedConfigResourcesOptions } from './resource-resolution';
+export { prepareConfigResourcesForDeploy, prepareMaterializedConfigResourcesForDeploy, type DeployResourceNames, type PrepareConfigResourcesForDeployOptions, type PrepareConfigResourcesForDeployResult, type PrepareMaterializedConfigResourcesForDeployOptions } from './deploy-resources';
+export { resolveResources, type BuildConfig, type LocalConfig, type DeployConfig, type Phase, type PhaseConfig, type ResolveResourcesOptions, type ResolveResourcesBuildOptions, type ResolveResourcesLocalOptions, type ResolveResourcesDeployOptions } from './resolve-phased';
+export { collectReferencedServiceNames, validateServiceBindings, ServiceBindingValidationError, type ValidateServiceBindingsOptions } from './service-bindings-validation';
 export { ref, type RefResult, type WorkerBinding, type WorkerBindingAccessor, type DOBindingRef } from './ref';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EACN,OAAO,EACP,mBAAmB,EACnB,wBAAwB,EACxB,8BAA8B,EAC9B,8BAA8B,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,MAAM,WAAW,CAAA;AAClB,OAAO,EACN,YAAY,EACZ,kCAAkC,EAClC,6BAA6B,EAC7B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AACrG,OAAO,EACN,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,iBAAiB,EACtB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EACN,4BAA4B,EAC5B,kCAAkC,EAClC,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,yCAAyC,EAC9C,KAAK,6BAA6B,EAClC,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EACN,GAAG,EACH,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,MAAM,OAAO,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EACN,OAAO,EACP,mBAAmB,EACnB,wBAAwB,EACxB,8BAA8B,EAC9B,8BAA8B,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,MAAM,WAAW,CAAA;AAClB,OAAO,EACN,YAAY,EACZ,kCAAkC,EAClC,6BAA6B,EAC7B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EACN,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,MAAM,YAAY,CAAA;AACnB,OAAO,EACN,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,iBAAiB,EACtB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EACN,kCAAkC,EAClC,KAAK,yBAAyB,EAC9B,KAAK,yCAAyC,EAC9C,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACN,+BAA+B,EAC/B,2CAA2C,EAC3C,KAAK,mBAAmB,EACxB,KAAK,sCAAsC,EAC3C,KAAK,qCAAqC,EAC1C,KAAK,kDAAkD,EACvD,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACN,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACN,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,EAC7B,KAAK,8BAA8B,EACnC,MAAM,+BAA+B,CAAA;AAGtC,OAAO,EACN,GAAG,EACH,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,MAAM,OAAO,CAAA"}

package/dist/config/preview-resources.d.ts

@@ -6,6 +6,12 @@ export interface PreviewScopedResourceRef {
     bindingName?: string;
     baseName: string;
     previewName: string;
+    /**
+     * Hyperdrive-only: the binding explicitly opted in to reusing the base
+     * Hyperdrive configuration when no preview Hyperdrive exists in the
+     * account (via `previewFallback: 'base'` on the binding).
+     */
+    allowBaseFallback?: boolean;
 }
 export interface PreviewScopedResourcePlan {
     kv: PreviewScopedResourceRef[];

package/dist/config/preview-resources.d.ts.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/config/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAI9C,MAAM,WAAW,mBAAmB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,wBAAwB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAOD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IACxC,QAAQ,CAAC,2BAA2B,EAAE,OAAO,MAAM,CAAA;CACnD,CAAA;AAED,MAAM,WAAW,cAAc;IAC9B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAAA;CACzE;AAED,MAAM,WAAW,wBAAwB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,gBAAgB,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,CAAA;AAExH,MAAM,WAAW,yBAAyB;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,uBAAuB,CAAA;CAC/B;AA2FD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,wBAA6B,GAAG,yBAAyB,CAuB1G;AAWD,eAAO,MAAM,OAAO;IACnB,KAAK,YAAW,mBAAmB,GAAQ,cAAc;CAezD,CAAA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6B,GACpC,MAAM,CAWR;AAED,wBAAgB,8BAA8B,CAC7C,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,wBAA6B,GACpC,cAAc,CAyGhB"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/config/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAI9C,MAAM,WAAW,mBAAmB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,wBAAwB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAOD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IACxC,QAAQ,CAAC,2BAA2B,EAAE,OAAO,MAAM,CAAA;CACnD,CAAA;AAED,MAAM,WAAW,cAAc;IAC9B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAAA;CACzE;AAED,MAAM,WAAW,wBAAwB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,gBAAgB,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,CAAA;AAExH,MAAM,WAAW,yBAAyB;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,uBAAuB,CAAA;CAC/B;AA2FD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,wBAA6B,GAAG,yBAAyB,CAuB1G;AAWD,eAAO,MAAM,OAAO;IACnB,KAAK,YAAW,mBAAmB,GAAQ,cAAc;CAezD,CAAA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6B,GACpC,MAAM,CAWR;AAED,wBAAgB,8BAA8B,CAC7C,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,wBAA6B,GACpC,cAAc,CAgHhB"}

package/dist/config/ref.d.ts

@@ -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;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/config/ref.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAM3C;;;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,GAC1C,OAAO,GACP,OAAO,GACP,mBAAmB,CAAA;AAEtB;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,IACpE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAAC,CAAA;AAElC;;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,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,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;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,GAAG,CAAC,OAAO,SAAS,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAAG,mBAAmB,CAAC,EACxG,YAAY,EAAE,MAAM,GAAG,OAAO,EAC9B,WAAW,CAAC,EAAE,OAAO,GACnB,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA"}
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/config/ref.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAM3C;;;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,GAC1C,OAAO,GACP,OAAO,GACP,mBAAmB,CAAA;AAEtB;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,IACpE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAAC,CAAA;AAElC;;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;AA4FD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,GAAG,CAAC,OAAO,SAAS,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAAG,mBAAmB,CAAC,EACxG,YAAY,EAAE,MAAM,GAAG,OAAO,EAC9B,WAAW,CAAC,EAAE,OAAO,GACnB,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';
+import { type PreviewResolutionOptions } from './preview';
+import { type ResolveMaterializedConfigResourcesOptions } from './resource-resolution';
+import type { DevflareConfig } from './schema';
+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":"AAoBA,OAAO,EAEP,KAAK,kDAAkD,EACtD,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAkC,KAAK,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAEzF,OAAO,EAGP,KAAK,yCAAyC,EAC7C,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,IACvC,CAAC,SAAS,OAAO,GAAG,WAAW,GAC7B,CAAC,SAAS,OAAO,GAAG,WAAW,GAC/B,CAAC,SAAS,QAAQ,GAAG,YAAY,GACjC,KAAK,CAAA;AAEP,MAAM,WAAW,6BAA6B;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,wBAAwB,CAAA;CACjC;AAED,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B;IACnF,KAAK,EAAE,OAAO,CAAA;CACb;AAED,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B;IACnF,KAAK,EAAE,OAAO,CAAA;CACb;AAED,MAAM,WAAW,6BACjB,SAAQ,6BAA6B,EACrC,yCAAyC;IACzC,KAAK,EAAE,QAAQ,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,kDAAkD,CAAA;CAC/D;AAED,MAAM,MAAM,uBAAuB,GACjC,4BAA4B,GAC5B,4BAA4B,GAC5B,6BAA6B,CAAA;AAE/B;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,uBAAuB,EACxE,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,CAAC,GACP,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAsClC"}

package/dist/config/resolve.d.ts

@@ -1,4 +1,11 @@
 import type { DevflareConfig } from './schema';
 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

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

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

@@ -2,6 +2,7 @@ import { getPrimaryAccount, listD1Databases, listHyperdrives, listKVNamespaces }
 import { getEffectiveAccountId } from '../cloudflare/preferences';
 import { type LoadConfigOptions } from './loader';
 import { type PreviewResolutionOptions } from './preview';
+import { type DeployConfig, type LocalConfig } from './resolve-phased';
 import { type DevflareConfig } from './schema';
 interface CloudflareConfigResolutionApi {
     getPrimaryAccount: typeof getPrimaryAccount;
@@ -37,24 +38,43 @@ export declare class ConfigResourceResolutionError extends Error {
  * 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): DevflareConfig;
+export declare function resolveConfigForLocalRuntime(config: DevflareConfig, environment?: string): LocalConfig;
 /**
-    * Resolve Cloudflare-backed resource references such as KV/D1/Hyperdrive name bindings into
- * concrete IDs for build, deploy, and automation workflows.
+ * 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<DevflareConfig>;
+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<DevflareConfig>;
+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<DevflareConfig>;
+export declare function loadResolvedConfig(options?: LoadResolvedConfigOptions): Promise<DeployConfig>;
 export {};
 //# sourceMappingURL=resource-resolution.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"resource-resolution.d.ts","sourceRoot":"","sources":["../../src/config/resource-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7G,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,EAAkC,KAAK,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAEzF,OAAO,EAON,KAAK,cAAc,EACnB,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;AAwBD,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;AAkLD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,MAAM,GAClB,cAAc,CAehB;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACvD,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE,yCAA8C,GACrD,OAAO,CAAC,cAAc,CAAC,CAyDzB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,6BAAkC,GACzC,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC,cAAc,CAAC,CAGzB"}
+{"version":3,"file":"resource-resolution.d.ts","sourceRoot":"","sources":["../../src/config/resource-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7G,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAYjE,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAA6D,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEjI,OAAO,EAIN,KAAK,cAAc,EACnB,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;AAkFD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,MAAM,GAClB,WAAW,CAeb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kCAAkC,CACvD,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE,yCAA8C,GACrD,OAAO,CAAC,YAAY,CAAC,CAyDvB;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"}