devflare 1.0.0-next.16 → 1.0.0-next.17

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"}