devflare 1.0.0-next.21 → 1.0.0-next.23

package/dist/index-j7x7f72h.js

@@ -0,0 +1,185 @@
+import {
+  resolveConfigForEnvironment
+} from "./index-f46984zs.js";
+
+// src/cli/commands/previews-support/family.ts
+function compareConfiguredWorkerFamilies(left, right) {
+  if (left.role === "primary" && right.role !== "primary") {
+    return -1;
+  }
+  if (left.role !== "primary" && right.role === "primary") {
+    return 1;
+  }
+  return left.baseName.localeCompare(right.baseName);
+}
+function comparePreviewScopeRows(left, right) {
+  const leftTime = left.updatedAt?.getTime() ?? 0;
+  const rightTime = right.updatedAt?.getTime() ?? 0;
+  if (rightTime !== leftTime) {
+    return rightTime - leftTime;
+  }
+  return left.scope.localeCompare(right.scope);
+}
+function collectConfiguredWorkerFamilies(config, environment) {
+  const resolvedConfig = resolveConfigForEnvironment(config, environment);
+  const families = new Map;
+  families.set(resolvedConfig.name, {
+    baseName: resolvedConfig.name,
+    roleLabel: "primary",
+    role: "primary"
+  });
+  for (const [bindingName, binding] of Object.entries(resolvedConfig.bindings?.services ?? {})) {
+    const existing = families.get(binding.service);
+    if (existing) {
+      continue;
+    }
+    families.set(binding.service, {
+      baseName: binding.service,
+      roleLabel: bindingName,
+      role: "service"
+    });
+  }
+  return Array.from(families.values()).sort(compareConfiguredWorkerFamilies);
+}
+function getWorkerUrl(workerName, workersSubdomain) {
+  if (!workersSubdomain) {
+    return;
+  }
+  return `https://${workerName}.${workersSubdomain}.workers.dev`;
+}
+function getWorkerScopeSuffix(workerName, baseName) {
+  if (!workerName.startsWith(`${baseName}-`)) {
+    return;
+  }
+  const suffix = workerName.slice(baseName.length + 1).trim();
+  return suffix || undefined;
+}
+function buildStableWorkerRowsFromLiveWorkers(families, workers, workersSubdomain) {
+  const workersByName = new Map(workers.map((worker) => [worker.name, worker]));
+  return families.map((family) => {
+    const worker = workersByName.get(family.baseName);
+    const status = worker ? "active" : "missing";
+    return {
+      workerName: family.baseName,
+      role: family.roleLabel,
+      status,
+      updatedAt: worker?.modifiedOn,
+      url: worker ? getWorkerUrl(family.baseName, workersSubdomain) : undefined
+    };
+  });
+}
+function getDedicatedPreviewFamilyNamesFromWorkers(families, workers) {
+  const familyNames = new Set;
+  const workerNames = workers.map((worker) => worker.name);
+  for (const family of families) {
+    if (family.role === "primary") {
+      familyNames.add(family.baseName);
+      continue;
+    }
+    if (workerNames.some((workerName) => Boolean(getWorkerScopeSuffix(workerName, family.baseName)))) {
+      familyNames.add(family.baseName);
+    }
+  }
+  return familyNames;
+}
+function buildPreviewScopeRowsFromLiveWorkers(families, workers, workersSubdomain) {
+  const workersByName = new Map(workers.map((worker) => [worker.name, worker]));
+  const previewFamilyNames = getDedicatedPreviewFamilyNamesFromWorkers(families, workers);
+  const expectedFamilies = families.filter((family) => previewFamilyNames.has(family.baseName));
+  const workerCandidatesByScope = buildPreviewWorkerCandidatesByScope(families, workers);
+  return Array.from(workerCandidatesByScope.keys()).map((scope) => {
+    const resolvedFamilies = expectedFamilies.map((family) => ({
+      family,
+      worker: workersByName.get(`${family.baseName}-${scope}`)
+    }));
+    const presentFamilies = resolvedFamilies.filter((entry) => entry.worker);
+    const updatedAt = presentFamilies.reduce((latest, entry) => {
+      const currentDate = entry.worker?.modifiedOn;
+      if (!currentDate) {
+        return latest;
+      }
+      if (!latest || currentDate.getTime() > latest.getTime()) {
+        return currentDate;
+      }
+      return latest;
+    }, undefined);
+    const primaryEntry = resolvedFamilies.find((entry) => entry.family.role === "primary");
+    const entryWorker = primaryEntry?.worker ?? presentFamilies[0]?.worker;
+    const missingLabels = resolvedFamilies.filter((entry) => !entry.worker).map((entry) => entry.family.role === "primary" ? "primary" : entry.family.roleLabel);
+    const notes = [];
+    if (missingLabels.length > 0) {
+      notes.push(`missing ${missingLabels.join(", ")}`);
+    }
+    const strategy = "dedicated workers";
+    const status = presentFamilies.length === resolvedFamilies.length ? "ready" : "partial";
+    return {
+      scope,
+      strategy,
+      workersLabel: `${presentFamilies.length}/${resolvedFamilies.length}`,
+      status,
+      updatedAt,
+      notes: notes.length > 0 ? notes.join(" · ") : undefined,
+      entryUrl: entryWorker ? getWorkerUrl(entryWorker.name, workersSubdomain) : undefined
+    };
+  }).sort(comparePreviewScopeRows);
+}
+function buildPreviewWorkerCandidatesByScope(families, workers) {
+  const candidates = new Map;
+  for (const worker of workers) {
+    for (const family of families) {
+      const scope = getWorkerScopeSuffix(worker.name, family.baseName);
+      if (!scope) {
+        continue;
+      }
+      const names = candidates.get(scope) ?? new Set;
+      names.add(worker.name);
+      candidates.set(scope, names);
+    }
+  }
+  return new Map(Array.from(candidates.entries()).map(([scope, workerNames]) => {
+    return [scope, Array.from(workerNames).sort((left, right) => left.localeCompare(right))];
+  }));
+}
+function orderPreviewWorkerNamesForDeletion(workerNames, scope, families) {
+  const familyPriority = new Map;
+  for (const family of families) {
+    familyPriority.set(family.baseName, {
+      priority: family.role === "primary" ? 0 : 1,
+      roleLabel: family.roleLabel
+    });
+  }
+  const resolveFamilyForWorker = (workerName) => {
+    for (const family of families) {
+      if (getWorkerScopeSuffix(workerName, family.baseName) === scope) {
+        const resolved = familyPriority.get(family.baseName);
+        if (resolved) {
+          return {
+            priority: resolved.priority,
+            roleLabel: resolved.roleLabel,
+            baseName: family.baseName
+          };
+        }
+      }
+    }
+    return {
+      priority: 2,
+      roleLabel: workerName
+    };
+  };
+  return [...workerNames].sort((left, right) => {
+    const leftFamily = resolveFamilyForWorker(left);
+    const rightFamily = resolveFamilyForWorker(right);
+    if (leftFamily.priority !== rightFamily.priority) {
+      return leftFamily.priority - rightFamily.priority;
+    }
+    if (leftFamily.roleLabel !== rightFamily.roleLabel) {
+      return leftFamily.roleLabel.localeCompare(rightFamily.roleLabel);
+    }
+    if (leftFamily.baseName && rightFamily.baseName && leftFamily.baseName !== rightFamily.baseName) {
+      return leftFamily.baseName.localeCompare(rightFamily.baseName);
+    }
+    return left.localeCompare(right);
+  });
+}
+
+export { collectConfiguredWorkerFamilies, buildStableWorkerRowsFromLiveWorkers, buildPreviewScopeRowsFromLiveWorkers, buildPreviewWorkerCandidatesByScope, orderPreviewWorkerNamesForDeletion };

package/dist/index-jkqbjwt2.js

@@ -0,0 +1,476 @@
+import {
+  mergeConfigForEnvironment
+} from "./index-f46984zs.js";
+import {
+  createD1Database,
+  createKVNamespace,
+  createQueue,
+  createR2Bucket,
+  createVectorizeIndex,
+  deleteD1Database,
+  deleteHyperdrive,
+  deleteKVNamespace,
+  deleteQueue,
+  deleteR2Bucket,
+  deleteVectorizeIndex,
+  getEffectiveAccountId,
+  getPrimaryAccount,
+  listD1Databases,
+  listHyperdrives,
+  listKVNamespaces,
+  listQueues,
+  listR2Buckets,
+  listVectorizeIndexes
+} from "./index-1d4jg11n.js";
+import {
+  isPreviewScopedName,
+  materializePreviewScopedConfig,
+  materializePreviewScopedString
+} from "./index-c8p4njqy.js";
+
+// src/config/preview-resources.ts
+var defaultPreviewScopedResourceLifecycleApi = {
+  getPrimaryAccount,
+  getEffectiveAccountId,
+  listKVNamespaces,
+  createKVNamespace,
+  deleteKVNamespace,
+  listD1Databases,
+  createD1Database,
+  deleteD1Database,
+  listR2Buckets,
+  createR2Bucket,
+  deleteR2Bucket,
+  listQueues,
+  createQueue,
+  deleteQueue,
+  listVectorizeIndexes,
+  createVectorizeIndex,
+  deleteVectorizeIndex,
+  listHyperdrives,
+  deleteHyperdrive
+};
+function resolvePreviewScopedResourceLifecycleApi(overrides) {
+  return {
+    ...defaultPreviewScopedResourceLifecycleApi,
+    ...overrides ?? {}
+  };
+}
+function createEmptyPreviewScopedResourceNames() {
+  return {
+    kv: [],
+    d1: [],
+    r2: [],
+    queues: [],
+    vectorize: [],
+    hyperdrive: [],
+    analyticsEngine: [],
+    browser: []
+  };
+}
+function createEmptyPreviewScopedResourcePlan() {
+  return {
+    kv: [],
+    d1: [],
+    r2: [],
+    queues: [],
+    vectorize: [],
+    hyperdrive: [],
+    analyticsEngine: [],
+    browser: []
+  };
+}
+function createPreviewScopedResourceRef(value, bindingName, options) {
+  if (!isPreviewScopedName(value)) {
+    return null;
+  }
+  const baseName = materializePreviewScopedString(value, {
+    env: {}
+  });
+  const previewName = materializePreviewScopedString(value, options);
+  if (!baseName || !previewName || baseName === previewName) {
+    return null;
+  }
+  return {
+    ...bindingName ? { bindingName } : {},
+    baseName,
+    previewName
+  };
+}
+function upsertPreviewScopedQueueRef(queueRefs, value, options) {
+  const ref = createPreviewScopedResourceRef(value, undefined, options);
+  if (!ref) {
+    return;
+  }
+  if (!queueRefs.has(ref.previewName)) {
+    queueRefs.set(ref.previewName, ref);
+  }
+}
+function applyHyperdriveBindingFallbacks(config, hyperdriveBindingFallbacks) {
+  if (!config.bindings?.hyperdrive || Object.keys(hyperdriveBindingFallbacks).length === 0) {
+    return config;
+  }
+  return {
+    ...config,
+    bindings: {
+      ...config.bindings,
+      hyperdrive: Object.fromEntries(Object.entries(config.bindings.hyperdrive).map(([bindingName, bindingConfig]) => {
+        const fallbackName = hyperdriveBindingFallbacks[bindingName];
+        if (!fallbackName) {
+          return [bindingName, bindingConfig];
+        }
+        return [bindingName, fallbackName];
+      }))
+    }
+  };
+}
+function resolvePreviewScopedResourceLifecycleWarnings(plan) {
+  const warnings = [];
+  if (plan.analyticsEngine.length > 0) {
+    warnings.push("Workers Analytics Engine datasets are created automatically on first write, so Devflare does not provision or delete preview-scoped analytics datasets.");
+  }
+  if (plan.browser.length > 0) {
+    warnings.push("Browser Rendering bindings do not own account-scoped resources, so Devflare does not provision or delete preview-scoped browser bindings.");
+  }
+  return warnings;
+}
+function hasPreviewScopedLifecycleResources(plan) {
+  return plan.kv.length > 0 || plan.d1.length > 0 || plan.r2.length > 0 || plan.queues.length > 0 || plan.vectorize.length > 0 || plan.hyperdrive.length > 0;
+}
+async function resolveLifecycleAccountId(config, options, cloudflareApi) {
+  if (options.accountId?.trim()) {
+    return options.accountId.trim();
+  }
+  if (config.accountId?.trim()) {
+    return config.accountId.trim();
+  }
+  const primaryAccount = await cloudflareApi.getPrimaryAccount();
+  if (!primaryAccount) {
+    throw new Error("Could not resolve a Cloudflare account for preview-scoped resource lifecycle management. Set accountId in devflare.config.ts, pass --account, or authenticate with Wrangler.");
+  }
+  const effective = await cloudflareApi.getEffectiveAccountId(primaryAccount.id);
+  return effective.accountId;
+}
+async function loadPreviewScopedResourceLifecycleState(accountId, plan, cloudflareApi) {
+  const [namespaces, databases, buckets, queues, vectorizeIndexes, hyperdrives] = await Promise.all([
+    plan.kv.length > 0 ? cloudflareApi.listKVNamespaces(accountId) : Promise.resolve([]),
+    plan.d1.length > 0 ? cloudflareApi.listD1Databases(accountId) : Promise.resolve([]),
+    plan.r2.length > 0 ? cloudflareApi.listR2Buckets(accountId) : Promise.resolve([]),
+    plan.queues.length > 0 ? cloudflareApi.listQueues(accountId) : Promise.resolve([]),
+    plan.vectorize.length > 0 ? cloudflareApi.listVectorizeIndexes(accountId) : Promise.resolve([]),
+    plan.hyperdrive.length > 0 ? cloudflareApi.listHyperdrives(accountId) : Promise.resolve([])
+  ]);
+  return {
+    namespaces,
+    databases,
+    buckets,
+    queues,
+    vectorizeIndexes,
+    hyperdrives
+  };
+}
+function createPreviewScopedResourceResolutionCloudflareApi(state) {
+  return {
+    listKVNamespaces: async () => state.namespaces,
+    listD1Databases: async () => state.databases,
+    listHyperdrives: async () => state.hyperdrives
+  };
+}
+function findVectorizeIndexByName(indexes, name) {
+  return indexes.find((index) => index.name === name);
+}
+function findKVNamespaceByName(namespaces, name) {
+  return namespaces.find((namespace) => namespace.name === name);
+}
+function findD1DatabaseByName(databases, name) {
+  return databases.find((database) => database.name === name);
+}
+function findR2BucketByName(buckets, name) {
+  return buckets.find((bucket) => bucket.name === name);
+}
+function findQueueByName(queues, name) {
+  return queues.find((queue) => queue.name === name);
+}
+function findHyperdriveByName(hyperdrives, name) {
+  return hyperdrives.find((hyperdrive) => hyperdrive.name === name);
+}
+function collectPreviewScopedResourcePlan(config, options = {}) {
+  const mergedConfig = mergeConfigForEnvironment(config, options.environment);
+  const plan = createEmptyPreviewScopedResourcePlan();
+  const bindings = mergedConfig.bindings;
+  if (!bindings) {
+    return plan;
+  }
+  if (bindings.kv) {
+    plan.kv = Object.entries(bindings.kv).map(([bindingName, bindingConfig]) => {
+      return typeof bindingConfig === "string" ? createPreviewScopedResourceRef(bindingConfig, bindingName, options) : null;
+    }).filter((ref) => ref !== null);
+  }
+  if (bindings.d1) {
+    plan.d1 = Object.entries(bindings.d1).map(([bindingName, bindingConfig]) => {
+      return typeof bindingConfig === "string" ? createPreviewScopedResourceRef(bindingConfig, bindingName, options) : null;
+    }).filter((ref) => ref !== null);
+  }
+  if (bindings.r2) {
+    plan.r2 = Object.entries(bindings.r2).map(([bindingName, bindingConfig]) => {
+      return createPreviewScopedResourceRef(bindingConfig, bindingName, options);
+    }).filter((ref) => ref !== null);
+  }
+  if (bindings.queues) {
+    const queueRefs = new Map;
+    for (const queueName of Object.values(bindings.queues.producers ?? {})) {
+      upsertPreviewScopedQueueRef(queueRefs, queueName, options);
+    }
+    for (const consumer of bindings.queues.consumers ?? []) {
+      upsertPreviewScopedQueueRef(queueRefs, consumer.queue, options);
+      if (consumer.deadLetterQueue) {
+        upsertPreviewScopedQueueRef(queueRefs, consumer.deadLetterQueue, options);
+      }
+    }
+    plan.queues = Array.from(queueRefs.values());
+  }
+  if (bindings.vectorize) {
+    plan.vectorize = Object.entries(bindings.vectorize).map(([bindingName, bindingConfig]) => {
+      return createPreviewScopedResourceRef(bindingConfig.indexName, bindingName, options);
+    }).filter((ref) => ref !== null);
+  }
+  if (bindings.hyperdrive) {
+    plan.hyperdrive = Object.entries(bindings.hyperdrive).map(([bindingName, bindingConfig]) => {
+      if (typeof bindingConfig === "string") {
+        return createPreviewScopedResourceRef(bindingConfig, bindingName, options);
+      }
+      if (bindingConfig && typeof bindingConfig === "object" && "name" in bindingConfig && typeof bindingConfig.name === "string") {
+        if ("previewId" in bindingConfig && typeof bindingConfig.previewId === "string" && bindingConfig.previewId.trim()) {
+          return null;
+        }
+        const ref = createPreviewScopedResourceRef(bindingConfig.name, bindingName, options);
+        if (ref && bindingConfig.previewFallback === "base") {
+          ref.allowBaseFallback = true;
+        }
+        return ref;
+      }
+      return null;
+    }).filter((ref) => ref !== null);
+  }
+  if (bindings.analyticsEngine) {
+    plan.analyticsEngine = Object.entries(bindings.analyticsEngine).map(([bindingName, bindingConfig]) => {
+      return createPreviewScopedResourceRef(bindingConfig.dataset, bindingName, options);
+    }).filter((ref) => ref !== null);
+  }
+  if (bindings.browser) {
+    plan.browser = Object.entries(bindings.browser).map(([bindingName, bindingConfig]) => {
+      if (typeof bindingConfig !== "string") {
+        return null;
+      }
+      return createPreviewScopedResourceRef(bindingConfig, bindingName, options);
+    }).filter((ref) => ref !== null);
+  }
+  return plan;
+}
+async function preparePreviewScopedResourcesForDeploy(config, options = {}) {
+  const mergedConfig = mergeConfigForEnvironment(config, options.environment);
+  const plan = collectPreviewScopedResourcePlan(config, options);
+  const created = createEmptyPreviewScopedResourceNames();
+  const existing = createEmptyPreviewScopedResourceNames();
+  const warnings = resolvePreviewScopedResourceLifecycleWarnings(plan);
+  if (!hasPreviewScopedLifecycleResources(plan)) {
+    return {
+      config: materializePreviewScopedConfig(mergedConfig, options),
+      plan,
+      created,
+      existing,
+      warnings
+    };
+  }
+  const cloudflareApi = resolvePreviewScopedResourceLifecycleApi(options.cloudflare);
+  const accountId = await resolveLifecycleAccountId(config, options, cloudflareApi);
+  const {
+    namespaces,
+    databases,
+    buckets,
+    queues,
+    vectorizeIndexes,
+    hyperdrives
+  } = await loadPreviewScopedResourceLifecycleState(accountId, plan, cloudflareApi);
+  for (const ref of plan.kv) {
+    if (findKVNamespaceByName(namespaces, ref.previewName)) {
+      existing.kv.push(ref.previewName);
+      continue;
+    }
+    const namespace = await cloudflareApi.createKVNamespace(accountId, ref.previewName);
+    created.kv.push(ref.previewName);
+    namespaces.push(namespace);
+  }
+  for (const ref of plan.d1) {
+    if (findD1DatabaseByName(databases, ref.previewName)) {
+      existing.d1.push(ref.previewName);
+      continue;
+    }
+    const database = await cloudflareApi.createD1Database(accountId, ref.previewName);
+    created.d1.push(ref.previewName);
+    databases.push(database);
+  }
+  for (const ref of plan.r2) {
+    if (findR2BucketByName(buckets, ref.previewName)) {
+      existing.r2.push(ref.previewName);
+      continue;
+    }
+    const bucket = await cloudflareApi.createR2Bucket(accountId, ref.previewName);
+    created.r2.push(ref.previewName);
+    buckets.push(bucket);
+  }
+  for (const ref of plan.queues) {
+    if (findQueueByName(queues, ref.previewName)) {
+      existing.queues.push(ref.previewName);
+      continue;
+    }
+    const queue = await cloudflareApi.createQueue(accountId, ref.previewName);
+    created.queues.push(ref.previewName);
+    queues.push(queue);
+  }
+  for (const ref of plan.vectorize) {
+    if (findVectorizeIndexByName(vectorizeIndexes, ref.previewName)) {
+      existing.vectorize.push(ref.previewName);
+      continue;
+    }
+    const baseIndex = findVectorizeIndexByName(vectorizeIndexes, ref.baseName);
+    if (!baseIndex) {
+      throw new Error(`Could not provision preview Vectorize index "${ref.previewName}" because the base index "${ref.baseName}" was not found.`);
+    }
+    const createdIndex = await cloudflareApi.createVectorizeIndex(accountId, {
+      name: ref.previewName,
+      dimensions: baseIndex.dimensions,
+      metric: baseIndex.metric,
+      description: baseIndex.description
+    });
+    created.vectorize.push(ref.previewName);
+    vectorizeIndexes.push(createdIndex);
+  }
+  const hyperdriveBindingFallbacks = {};
+  for (const ref of plan.hyperdrive) {
+    if (findHyperdriveByName(hyperdrives, ref.previewName)) {
+      existing.hyperdrive.push(ref.previewName);
+      continue;
+    }
+    if (!findHyperdriveByName(hyperdrives, ref.baseName)) {
+      throw new Error(`Could not resolve preview Hyperdrive "${ref.previewName}" because neither the preview config nor the base config "${ref.baseName}" exists in this account.`);
+    }
+    if (!ref.allowBaseFallback) {
+      const bindingLabel = ref.bindingName ? `"${ref.bindingName}"` : `for preview name "${ref.previewName}"`;
+      throw new Error(`Preview Hyperdrive binding ${bindingLabel} has no dedicated preview Hyperdrive configuration "${ref.previewName}" in this account. ` + "Either provision a dedicated preview Hyperdrive (or set `previewId` on the binding), " + "or opt in to reusing the base Hyperdrive by setting `previewFallback: 'base'` on the binding.");
+    }
+    if (ref.bindingName) {
+      hyperdriveBindingFallbacks[ref.bindingName] = ref.baseName;
+    }
+    warnings.push(`Preview Hyperdrive "${ref.previewName}" is not auto-provisioned because Cloudflare does not expose stored Hyperdrive credentials for cloning. Devflare will reuse the base Hyperdrive "${ref.baseName}" for binding ${ref.bindingName ?? ref.previewName}.`);
+  }
+  const preparedConfig = applyHyperdriveBindingFallbacks(mergedConfig, hyperdriveBindingFallbacks);
+  return {
+    accountId,
+    config: materializePreviewScopedConfig(preparedConfig, options),
+    resourceResolutionCloudflare: createPreviewScopedResourceResolutionCloudflareApi({
+      namespaces,
+      databases,
+      hyperdrives
+    }),
+    plan,
+    created,
+    existing,
+    warnings
+  };
+}
+async function cleanupPreviewScopedResources(config, options = {}) {
+  const plan = collectPreviewScopedResourcePlan(config, options);
+  const candidates = createEmptyPreviewScopedResourceNames();
+  const deleted = createEmptyPreviewScopedResourceNames();
+  const warnings = resolvePreviewScopedResourceLifecycleWarnings(plan);
+  if (!hasPreviewScopedLifecycleResources(plan)) {
+    return {
+      plan,
+      candidates,
+      deleted,
+      warnings
+    };
+  }
+  const cloudflareApi = resolvePreviewScopedResourceLifecycleApi(options.cloudflare);
+  const accountId = await resolveLifecycleAccountId(config, options, cloudflareApi);
+  const apply = options.apply === true;
+  const {
+    namespaces,
+    databases,
+    buckets,
+    queues,
+    vectorizeIndexes,
+    hyperdrives
+  } = await loadPreviewScopedResourceLifecycleState(accountId, plan, cloudflareApi);
+  const kvCandidates = plan.kv.map((ref) => findKVNamespaceByName(namespaces, ref.previewName)).filter((namespace) => namespace !== undefined);
+  for (const namespace of kvCandidates) {
+    candidates.kv.push(namespace.name);
+    if (!apply) {
+      continue;
+    }
+    await cloudflareApi.deleteKVNamespace(accountId, namespace.id);
+    deleted.kv.push(namespace.name);
+  }
+  const d1Candidates = plan.d1.map((ref) => findD1DatabaseByName(databases, ref.previewName)).filter((database) => database !== undefined);
+  for (const database of d1Candidates) {
+    candidates.d1.push(database.name);
+    if (!apply) {
+      continue;
+    }
+    await cloudflareApi.deleteD1Database(accountId, database.id);
+    deleted.d1.push(database.name);
+  }
+  const r2Candidates = plan.r2.map((ref) => findR2BucketByName(buckets, ref.previewName)).filter((bucket) => bucket !== undefined);
+  for (const bucket of r2Candidates) {
+    candidates.r2.push(bucket.name);
+    if (!apply) {
+      continue;
+    }
+    await cloudflareApi.deleteR2Bucket(accountId, bucket.name);
+    deleted.r2.push(bucket.name);
+  }
+  const queueCandidates = plan.queues.map((ref) => findQueueByName(queues, ref.previewName)).filter((queue) => queue !== undefined);
+  for (const queue of queueCandidates) {
+    candidates.queues.push(queue.name);
+    if (!apply) {
+      continue;
+    }
+    if (!queue.id) {
+      warnings.push(`Skipping queue deletion for "${queue.name}" because Cloudflare did not return a queue id.`);
+      continue;
+    }
+    await cloudflareApi.deleteQueue(accountId, queue.id);
+    deleted.queues.push(queue.name);
+  }
+  const vectorizeCandidates = plan.vectorize.map((ref) => findVectorizeIndexByName(vectorizeIndexes, ref.previewName)).filter((index) => index !== undefined);
+  for (const index of vectorizeCandidates) {
+    candidates.vectorize.push(index.name);
+    if (!apply) {
+      continue;
+    }
+    await cloudflareApi.deleteVectorizeIndex(accountId, index.name);
+    deleted.vectorize.push(index.name);
+  }
+  const hyperdriveCandidates = plan.hyperdrive.map((ref) => findHyperdriveByName(hyperdrives, ref.previewName)).filter((hyperdrive) => hyperdrive !== undefined);
+  for (const hyperdrive of hyperdriveCandidates) {
+    candidates.hyperdrive.push(hyperdrive.name);
+    if (!apply) {
+      continue;
+    }
+    await cloudflareApi.deleteHyperdrive(accountId, hyperdrive.id);
+    deleted.hyperdrive.push(hyperdrive.name);
+  }
+  if (plan.hyperdrive.length > 0) {
+    warnings.push("Preview-scoped Hyperdrive cleanup only deletes preview configs that already exist. Devflare does not auto-provision preview Hyperdrives because Cloudflare does not expose stored Hyperdrive credentials for cloning.");
+  }
+  return {
+    accountId,
+    plan,
+    candidates,
+    deleted,
+    warnings
+  };
+}
+
+export { preparePreviewScopedResourcesForDeploy, cleanupPreviewScopedResources };