devflare 1.0.0-next.4 → 1.0.0-next.40

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

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

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

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

package/dist/config/resolve.d.ts

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

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

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

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

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

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

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