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

package/dist/{index-q4kaz181.js → index-8evn52g1.js}

@@ -6,19 +6,15 @@ import {
   listWorkerDeployments,
   listWorkerVersions,
   queryD1Database
-} from "./index-xk9djfjp.js";
+} from "./index-gba371j7.js";
 import {
   CloudflareAPIError
-} from "./index-0w826dsr.js";
+} from "./index-abrqnq3e.js";
 
-// src/cli/preview.ts
+// src/cloudflare/preview-urls.ts
 function normalizeWorkersSubdomain(accountSubdomain) {
   return accountSubdomain.trim().replace(/^https?:\/\//i, "").replace(/\.workers\.dev\/?$/i, "");
 }
-function formatPreviewAliasUrl(alias, workerName, accountSubdomain) {
-  const normalizedSubdomain = normalizeWorkersSubdomain(accountSubdomain);
-  return `https://${alias}-${workerName}.${normalizedSubdomain}.workers.dev`;
-}
 function formatWorkersDevUrl(workerName, accountSubdomain) {
   const normalizedSubdomain = normalizeWorkersSubdomain(accountSubdomain);
   return `https://${workerName}.${normalizedSubdomain}.workers.dev`;
@@ -28,90 +24,6 @@ function formatVersionPreviewUrl(versionId, workerName, accountSubdomain) {
   const versionPrefix = versionId.split("-")[0] || versionId;
   return `https://${versionPrefix}-${workerName}.${normalizedSubdomain}.workers.dev`;
 }
-function matchNamedValue(output, patterns) {
-  for (const pattern of patterns) {
-    const match = output.match(pattern);
-    if (match?.[1]) {
-      return match[1];
-    }
-  }
-  return;
-}
-function appendUniqueUrls(target, value) {
-  if (typeof value === "string") {
-    if (value.startsWith("http://") || value.startsWith("https://")) {
-      target.push(value);
-    }
-    return;
-  }
-  if (!Array.isArray(value)) {
-    return;
-  }
-  for (const item of value) {
-    appendUniqueUrls(target, item);
-  }
-}
-function parseWranglerStructuredOutput(output) {
-  const records = output.replace(/\r/g, "").split(`
-`).map((line) => line.trim()).filter(Boolean).map((line) => {
-    try {
-      return JSON.parse(line);
-    } catch {
-      return null;
-    }
-  }).filter((record) => record !== null);
-  const urls = [];
-  let versionId;
-  let previewUrl;
-  for (const record of records) {
-    if (!versionId && typeof record.version_id === "string" && record.version_id.trim()) {
-      versionId = record.version_id.trim();
-    }
-    appendUniqueUrls(urls, record.targets);
-    appendUniqueUrls(urls, record.preview_urls);
-    appendUniqueUrls(urls, record.urls);
-    appendUniqueUrls(urls, record.url);
-    if (!previewUrl && typeof record.preview_url === "string" && record.preview_url.trim()) {
-      previewUrl = record.preview_url.trim();
-    }
-  }
-  const uniqueUrls = [...new Set(urls)];
-  if (!previewUrl) {
-    previewUrl = uniqueUrls.find((url) => url.includes("workers.dev"));
-  }
-  return {
-    versionId,
-    previewUrl,
-    urls: uniqueUrls
-  };
-}
-function mergeParsedWranglerDeployOutputs(...outputs) {
-  const urls = [...new Set(outputs.flatMap((output) => output.urls))];
-  return {
-    versionId: outputs.map((output) => output.versionId).find((value) => Boolean(value)),
-    previewUrl: outputs.map((output) => output.previewUrl).find((value) => Boolean(value)) ?? urls.find((url) => url.includes("workers.dev")),
-    urls
-  };
-}
-function parseWranglerDeployOutput(output) {
-  const normalizedOutput = output.replace(/\r/g, "");
-  const urls = [...new Set(normalizedOutput.match(/https?:\/\/[^\s'"`]+/g) ?? [])];
-  const previewUrl = matchNamedValue(normalizedOutput, [
-    /Preview URL:\s*(https?:\/\/\S+)/i,
-    /Version Preview URL:\s*(https?:\/\/\S+)/i
-  ]) ?? urls.find((url) => url.includes("workers.dev"));
-  const versionId = matchNamedValue(normalizedOutput, [
-    /Worker Version ID:\s*([A-Za-z0-9_-]+)/i,
-    /Version ID:\s*([A-Za-z0-9_-]+)/i,
-    /version(?:_id| id)?\s*[:=]\s*([A-Za-z0-9_-]+)/i,
-    /"id"\s*:\s*"([A-Za-z0-9_-]+)"/i
-  ]);
-  return {
-    versionId,
-    previewUrl,
-    urls
-  };
-}
 
 // src/cloudflare/preview-registry-types.ts
 var DEVFLARE_PREVIEW_REGISTRY_DATABASE = "devflare-registry";
@@ -128,7 +40,7 @@ var branchNameSchema = z.string().min(1);
 var commitShaSchema = z.string().regex(/^[a-f0-9]{7,40}$/i, {
   message: "Commit SHA must be 7 to 40 hexadecimal characters"
 });
-var previewAliasSchema = z.string().regex(/^[a-z][a-z0-9-]*$/, {
+var previewScopeSchema = z.string().regex(/^[a-z][a-z0-9-]*$/, {
   message: "Preview names must start with a lowercase letter and contain only lowercase letters, numbers, and dashes"
 });
 var cloudflareUserIdSchema = z.union([
@@ -159,7 +71,7 @@ var devflarePreviewStatusSchema = z.enum([
   "orphaned",
   "deleted"
 ]);
-var devflarePreviewAliasStatusSchema = z.enum([
+var devflarePreviewScopeStatusSchema = z.enum([
   "active",
   "reassigned",
   "deleted"
@@ -180,34 +92,34 @@ var devflarePreviewRecordSchema = createDevflareAccountRecordSchema({
   workerName: workerNameSchema,
   versionId: cloudflareVersionIdSchema,
   previewUrl: urlSchema,
-  alias: previewAliasSchema.optional(),
-  aliasPreviewUrl: urlSchema.optional(),
+  scope: previewScopeSchema.optional(),
+  scopeUrl: urlSchema.optional(),
   branchName: branchNameSchema.optional(),
   commitSha: commitShaSchema.optional(),
   deploymentId: recordIdSchema.optional(),
   source: devflareRecordSourceSchema.default("unknown"),
   status: devflarePreviewStatusSchema.default("active")
 }).superRefine((record, ctx) => {
-  if (record.aliasPreviewUrl && !record.alias) {
+  if (record.scopeUrl && !record.scope) {
     ctx.addIssue({
       code: "custom",
-      path: ["aliasPreviewUrl"],
-      message: "aliasPreviewUrl requires alias to be set"
+      path: ["scopeUrl"],
+      message: "scopeUrl requires scope to be set"
     });
   }
 });
-var devflarePreviewAliasRecordSchema = createDevflareAccountRecordSchema({
-  kind: z.literal("previewAlias"),
+var devflarePreviewScopeRecordSchema = createDevflareAccountRecordSchema({
+  kind: z.literal("previewScope"),
   accountId: cloudflareAccountIdSchema,
   workerName: workerNameSchema,
-  alias: previewAliasSchema,
-  aliasPreviewUrl: urlSchema,
+  scope: previewScopeSchema,
+  scopeUrl: urlSchema,
   versionId: cloudflareVersionIdSchema,
   previewId: recordIdSchema.optional(),
   branchName: branchNameSchema.optional(),
   commitSha: commitShaSchema.optional(),
   source: devflareRecordSourceSchema.default("unknown"),
-  status: devflarePreviewAliasStatusSchema.default("active")
+  status: devflarePreviewScopeStatusSchema.default("active")
 });
 var devflareDeploymentRecordSchema = createDevflareAccountRecordSchema({
   kind: z.literal("deployment"),
@@ -241,7 +153,7 @@ var devflareDeploymentRecordSchema = createDevflareAccountRecordSchema({
 });
 var devflareAccountLayerRecordSchema = z.discriminatedUnion("kind", [
   devflarePreviewRecordSchema,
-  devflarePreviewAliasRecordSchema,
+  devflarePreviewScopeRecordSchema,
   devflareDeploymentRecordSchema
 ]);
 
@@ -323,7 +235,7 @@ function clearCachedPreviewRegistryContext(accountId, databaseName) {
   writePreviewRegistryCache(cache);
 }
 
-// src/cloudflare/preview-registry-records.ts
+// src/cloudflare/preview-registry-inference.ts
 function toIsoString(date) {
   return date ? date.toISOString() : null;
 }
@@ -345,8 +257,8 @@ function inferRecordSource(explicitSource, fallbackSource) {
 function getPreviewRecordId(workerName, versionId) {
   return `preview:${workerName}:${versionId}`;
 }
-function getPreviewAliasRecordId(workerName, alias) {
-  return `previewAlias:${workerName}:${alias}`;
+function getPreviewScopeRecordId(workerName, scope) {
+  return `previewScope:${workerName}:${scope}`;
 }
 function getPreviewDeploymentId(workerName, versionId) {
   return `preview:${workerName}:${versionId}`;
@@ -355,15 +267,15 @@ function getDeploymentRecordId(workerName, deploymentId) {
   return `deployment:${workerName}:${deploymentId}`;
 }
 function hasRetireSelector(options) {
-  return Boolean(options.branchName || options.previewAlias || options.versionId || options.commitSha);
+  return Boolean(options.branchName || options.previewScope || options.versionId || options.commitSha);
 }
 function matchesRetireSelector(options, candidate) {
-  return options.branchName !== undefined && candidate.branchName === options.branchName || options.previewAlias !== undefined && candidate.previewAlias === options.previewAlias || options.versionId !== undefined && candidate.versionId === options.versionId || options.commitSha !== undefined && candidate.commitSha === options.commitSha;
+  return options.branchName !== undefined && candidate.branchName === options.branchName || options.previewScope !== undefined && candidate.previewScope === options.previewScope || options.versionId !== undefined && candidate.versionId === options.versionId || options.commitSha !== undefined && candidate.commitSha === options.commitSha;
 }
 function getPreviewRetireCandidate(record) {
   return {
     branchName: record.branchName,
-    previewAlias: record.alias,
+    previewScope: record.scope,
     versionId: record.versionId,
     commitSha: record.commitSha
   };
@@ -371,7 +283,7 @@ function getPreviewRetireCandidate(record) {
 function matchesPreviewRetireTarget(record, options) {
   return matchesRetireSelector(options, getPreviewRetireCandidate(record));
 }
-function matchesPreviewAliasRetireTarget(record, options) {
+function matchesPreviewScopeRetireTarget(record, options) {
   return matchesRetireSelector(options, getPreviewRetireCandidate(record));
 }
 function matchesPreviewDeploymentRetireTarget(record, options) {
@@ -380,6 +292,19 @@ function matchesPreviewDeploymentRetireTarget(record, options) {
     commitSha: record.commitSha
   });
 }
+function getExplicitPreviewSyncOverrides(options, versionId) {
+  if (versionId !== options.versionId) {
+    return {};
+  }
+  return {
+    previewScope: options.previewScope,
+    previewUrl: options.previewUrl,
+    previewScopeUrl: options.previewScopeUrl,
+    branchName: options.branchName,
+    commitSha: options.commitSha
+  };
+}
+// src/cloudflare/preview-registry-shape.ts
 function markRecordDeleted(record, now, parser) {
   return parser.parse({
     ...record,
@@ -407,9 +332,10 @@ function createPreviewLinkedRecordBase(options) {
   };
 }
 function buildPreviewRecord(options) {
-  const alias = options.previewAlias ?? options.existing?.alias;
+  const scope = options.previewScope ?? options.existing?.scope;
   const previewUrl = options.previewUrl ?? options.existing?.previewUrl ?? (options.workersSubdomain ? formatVersionPreviewUrl(options.version.id, options.workerName, options.workersSubdomain) : undefined);
-  const aliasPreviewUrl = options.previewAliasUrl ?? options.existing?.aliasPreviewUrl ?? (alias && options.workersSubdomain ? formatPreviewAliasUrl(alias, options.workerName, options.workersSubdomain) : undefined);
+  const scopeChanged = options.previewScope !== undefined && options.previewScope !== options.existing?.scope;
+  const scopeUrl = options.previewScopeUrl ?? (options.previewScope !== undefined ? options.previewUrl : undefined) ?? (!scopeChanged ? options.existing?.scopeUrl : undefined);
   if (!previewUrl) {
     return null;
   }
@@ -425,8 +351,8 @@ function buildPreviewRecord(options) {
     workerName: options.workerName,
     versionId: options.version.id,
     previewUrl,
-    alias,
-    aliasPreviewUrl,
+    scope,
+    scopeUrl,
     branchName: options.branchName ?? options.existing?.branchName,
     commitSha: options.commitSha ?? options.existing?.commitSha,
     deploymentId: options.existing?.deploymentId,
@@ -434,13 +360,13 @@ function buildPreviewRecord(options) {
     status: "active"
   });
 }
-function buildPreviewAliasRecord(options) {
-  if (!options.previewRecord.alias || !options.previewRecord.aliasPreviewUrl) {
+function buildPreviewScopeRecord(options) {
+  if (!options.previewRecord.scope || !options.previewRecord.scopeUrl) {
     return null;
   }
-  return devflarePreviewAliasRecordSchema.parse({
-    id: getPreviewAliasRecordId(options.workerName, options.previewRecord.alias),
-    kind: "previewAlias",
+  return devflarePreviewScopeRecordSchema.parse({
+    id: getPreviewScopeRecordId(options.workerName, options.previewRecord.scope),
+    kind: "previewScope",
     ver: 1,
     ...createPreviewLinkedRecordBase({
       accountId: options.accountId,
@@ -449,8 +375,8 @@ function buildPreviewAliasRecord(options) {
       existingCreatedAt: options.existing?.createdAt,
       now: options.now
     }),
-    alias: options.previewRecord.alias,
-    aliasPreviewUrl: options.previewRecord.aliasPreviewUrl,
+    scope: options.previewRecord.scope,
+    scopeUrl: options.previewRecord.scopeUrl,
     branchName: options.previewRecord.branchName
   });
 }
@@ -470,7 +396,7 @@ function buildPreviewDeploymentRecord(options) {
     deploymentId,
     channel: "preview",
     environment: "preview",
-    url: options.previewRecord.aliasPreviewUrl ?? options.previewRecord.previewUrl,
+    url: options.previewRecord.scopeUrl ?? options.previewRecord.previewUrl,
     message: options.existing?.message
   });
 }
@@ -501,6 +427,16 @@ function buildProductionDeploymentRecord(options) {
     source: inferRecordSource(options.source, options.version?.metadata.source ?? options.deployment.source)
   });
 }
+function markPreviewRecordDeleted(record, now) {
+  return markRecordDeleted(record, now, devflarePreviewRecordSchema);
+}
+function markPreviewScopeRecordDeleted(record, now) {
+  return markRecordDeleted(record, now, devflarePreviewScopeRecordSchema);
+}
+function markDeploymentRecordDeleted(record, now) {
+  return markRecordDeleted(record, now, devflareDeploymentRecordSchema);
+}
+// src/cloudflare/preview-registry-transport.ts
 async function getVersionInfoById(accountId, workerName, versionId, versionMap, apiOptions) {
   const existing = versionMap.get(versionId);
   if (existing) {
@@ -514,96 +450,151 @@ async function getVersionInfoById(accountId, workerName, versionId, versionMap,
     return;
   }
 }
-function markPreviewRecordDeleted(record, now) {
-  return markRecordDeleted(record, now, devflarePreviewRecordSchema);
-}
-function markPreviewAliasRecordDeleted(record, now) {
-  return markRecordDeleted(record, now, devflarePreviewAliasRecordSchema);
-}
-function markDeploymentRecordDeleted(record, now) {
-  return markRecordDeleted(record, now, devflareDeploymentRecordSchema);
-}
-function getExplicitPreviewSyncOverrides(options, versionId) {
-  if (versionId !== options.versionId) {
-    return {};
-  }
-  return {
-    previewAlias: options.previewAlias,
-    previewUrl: options.previewUrl,
-    previewAliasUrl: options.previewAliasUrl,
-    branchName: options.branchName,
-    commitSha: options.commitSha
-  };
-}
-
 // src/cloudflare/preview-registry-store.ts
-var REGISTRY_SCHEMA_STATEMENTS = [
-  `CREATE TABLE IF NOT EXISTS devflare_preview_records (
-		id TEXT PRIMARY KEY,
-		ver INTEGER NOT NULL,
-		account_id TEXT NOT NULL,
-		worker_name TEXT NOT NULL,
-		version_id TEXT NOT NULL UNIQUE,
-		preview_url TEXT NOT NULL,
-		alias TEXT,
-		alias_preview_url TEXT,
-		branch_name TEXT,
-		commit_sha TEXT,
-		deployment_id TEXT,
-		source TEXT NOT NULL,
-		status TEXT NOT NULL,
-		created_by TEXT NOT NULL,
-		created_at TEXT NOT NULL,
-		updated_at TEXT,
-		deleted_at TEXT,
-		payload_json TEXT NOT NULL
-	)`,
-  "CREATE INDEX IF NOT EXISTS idx_devflare_preview_records_account_worker ON devflare_preview_records(account_id, worker_name)",
-  "CREATE INDEX IF NOT EXISTS idx_devflare_preview_records_status ON devflare_preview_records(status)",
-  `CREATE TABLE IF NOT EXISTS devflare_preview_alias_records (
-		id TEXT PRIMARY KEY,
-		ver INTEGER NOT NULL,
-		account_id TEXT NOT NULL,
-		worker_name TEXT NOT NULL,
-		alias TEXT NOT NULL,
-		alias_preview_url TEXT NOT NULL,
-		version_id TEXT NOT NULL,
-		preview_id TEXT,
-		branch_name TEXT,
-		commit_sha TEXT,
-		source TEXT NOT NULL,
-		status TEXT NOT NULL,
-		created_by TEXT NOT NULL,
-		created_at TEXT NOT NULL,
-		updated_at TEXT,
-		deleted_at TEXT,
-		payload_json TEXT NOT NULL
-	)`,
-  "CREATE INDEX IF NOT EXISTS idx_devflare_preview_alias_records_account_worker ON devflare_preview_alias_records(account_id, worker_name)",
-  "CREATE INDEX IF NOT EXISTS idx_devflare_preview_alias_records_alias ON devflare_preview_alias_records(alias)",
-  `CREATE TABLE IF NOT EXISTS devflare_deployment_records (
-		id TEXT PRIMARY KEY,
-		ver INTEGER NOT NULL,
-		account_id TEXT NOT NULL,
-		worker_name TEXT NOT NULL,
-		deployment_id TEXT NOT NULL UNIQUE,
-		channel TEXT NOT NULL,
-		status TEXT NOT NULL,
-		version_id TEXT NOT NULL,
-		preview_id TEXT,
-		environment TEXT,
-		url TEXT,
-		message TEXT,
-		commit_sha TEXT,
-		source TEXT NOT NULL,
-		created_by TEXT NOT NULL,
-		created_at TEXT NOT NULL,
-		updated_at TEXT,
-		deleted_at TEXT,
-		payload_json TEXT NOT NULL
-	)`,
-  "CREATE INDEX IF NOT EXISTS idx_devflare_deployment_records_account_worker ON devflare_deployment_records(account_id, worker_name)",
-  "CREATE INDEX IF NOT EXISTS idx_devflare_deployment_records_channel_status ON devflare_deployment_records(channel, status)"
+var REGISTRY_TABLES = [
+  {
+    name: "devflare_preview_records",
+    createStatement: `CREATE TABLE IF NOT EXISTS devflare_preview_records (
+			id TEXT PRIMARY KEY,
+			ver INTEGER NOT NULL,
+			account_id TEXT NOT NULL,
+			worker_name TEXT NOT NULL,
+			version_id TEXT NOT NULL UNIQUE,
+			preview_url TEXT NOT NULL,
+			scope TEXT,
+			scope_url TEXT,
+			branch_name TEXT,
+			commit_sha TEXT,
+			deployment_id TEXT,
+			source TEXT NOT NULL,
+			status TEXT NOT NULL,
+			created_by TEXT NOT NULL,
+			created_at TEXT NOT NULL,
+			updated_at TEXT,
+			deleted_at TEXT,
+			payload_json TEXT NOT NULL
+		)`,
+    migrationColumns: {
+      id: "id TEXT",
+      ver: "ver INTEGER NOT NULL DEFAULT 1",
+      account_id: `account_id TEXT NOT NULL DEFAULT ''`,
+      worker_name: `worker_name TEXT NOT NULL DEFAULT ''`,
+      version_id: `version_id TEXT NOT NULL DEFAULT ''`,
+      preview_url: `preview_url TEXT NOT NULL DEFAULT ''`,
+      scope: "scope TEXT",
+      scope_url: "scope_url TEXT",
+      branch_name: "branch_name TEXT",
+      commit_sha: "commit_sha TEXT",
+      deployment_id: "deployment_id TEXT",
+      source: `source TEXT NOT NULL DEFAULT ''`,
+      status: `status TEXT NOT NULL DEFAULT ''`,
+      created_by: `created_by TEXT NOT NULL DEFAULT ''`,
+      created_at: `created_at TEXT NOT NULL DEFAULT ''`,
+      updated_at: "updated_at TEXT",
+      deleted_at: "deleted_at TEXT",
+      payload_json: `payload_json TEXT NOT NULL DEFAULT '{}'`
+    },
+    indexStatements: [
+      "CREATE INDEX IF NOT EXISTS idx_devflare_preview_records_account_worker ON devflare_preview_records(account_id, worker_name)",
+      "CREATE INDEX IF NOT EXISTS idx_devflare_preview_records_status ON devflare_preview_records(status)",
+      "CREATE UNIQUE INDEX IF NOT EXISTS idx_devflare_preview_records_version_id ON devflare_preview_records(version_id)"
+    ]
+  },
+  {
+    name: "devflare_preview_scope_records",
+    createStatement: `CREATE TABLE IF NOT EXISTS devflare_preview_scope_records (
+			id TEXT PRIMARY KEY,
+			ver INTEGER NOT NULL,
+			account_id TEXT NOT NULL,
+			worker_name TEXT NOT NULL,
+			scope TEXT NOT NULL,
+			scope_url TEXT NOT NULL,
+			version_id TEXT NOT NULL,
+			preview_id TEXT,
+			branch_name TEXT,
+			commit_sha TEXT,
+			source TEXT NOT NULL,
+			status TEXT NOT NULL,
+			created_by TEXT NOT NULL,
+			created_at TEXT NOT NULL,
+			updated_at TEXT,
+			deleted_at TEXT,
+			payload_json TEXT NOT NULL
+		)`,
+    migrationColumns: {
+      id: "id TEXT",
+      ver: "ver INTEGER NOT NULL DEFAULT 1",
+      account_id: `account_id TEXT NOT NULL DEFAULT ''`,
+      worker_name: `worker_name TEXT NOT NULL DEFAULT ''`,
+      scope: `scope TEXT NOT NULL DEFAULT ''`,
+      scope_url: `scope_url TEXT NOT NULL DEFAULT ''`,
+      version_id: `version_id TEXT NOT NULL DEFAULT ''`,
+      preview_id: "preview_id TEXT",
+      branch_name: "branch_name TEXT",
+      commit_sha: "commit_sha TEXT",
+      source: `source TEXT NOT NULL DEFAULT ''`,
+      status: `status TEXT NOT NULL DEFAULT ''`,
+      created_by: `created_by TEXT NOT NULL DEFAULT ''`,
+      created_at: `created_at TEXT NOT NULL DEFAULT ''`,
+      updated_at: "updated_at TEXT",
+      deleted_at: "deleted_at TEXT",
+      payload_json: `payload_json TEXT NOT NULL DEFAULT '{}'`
+    },
+    indexStatements: [
+      "CREATE INDEX IF NOT EXISTS idx_devflare_preview_scope_records_account_worker ON devflare_preview_scope_records(account_id, worker_name)",
+      "CREATE INDEX IF NOT EXISTS idx_devflare_preview_scope_records_scope ON devflare_preview_scope_records(scope)"
+    ]
+  },
+  {
+    name: "devflare_deployment_records",
+    createStatement: `CREATE TABLE IF NOT EXISTS devflare_deployment_records (
+			id TEXT PRIMARY KEY,
+			ver INTEGER NOT NULL,
+			account_id TEXT NOT NULL,
+			worker_name TEXT NOT NULL,
+			deployment_id TEXT NOT NULL UNIQUE,
+			channel TEXT NOT NULL,
+			status TEXT NOT NULL,
+			version_id TEXT NOT NULL,
+			preview_id TEXT,
+			environment TEXT,
+			url TEXT,
+			message TEXT,
+			commit_sha TEXT,
+			source TEXT NOT NULL,
+			created_by TEXT NOT NULL,
+			created_at TEXT NOT NULL,
+			updated_at TEXT,
+			deleted_at TEXT,
+			payload_json TEXT NOT NULL
+		)`,
+    migrationColumns: {
+      id: "id TEXT",
+      ver: "ver INTEGER NOT NULL DEFAULT 1",
+      account_id: `account_id TEXT NOT NULL DEFAULT ''`,
+      worker_name: `worker_name TEXT NOT NULL DEFAULT ''`,
+      deployment_id: `deployment_id TEXT NOT NULL DEFAULT ''`,
+      channel: `channel TEXT NOT NULL DEFAULT ''`,
+      status: `status TEXT NOT NULL DEFAULT ''`,
+      version_id: `version_id TEXT NOT NULL DEFAULT ''`,
+      preview_id: "preview_id TEXT",
+      environment: "environment TEXT",
+      url: "url TEXT",
+      message: "message TEXT",
+      commit_sha: "commit_sha TEXT",
+      source: `source TEXT NOT NULL DEFAULT ''`,
+      created_by: `created_by TEXT NOT NULL DEFAULT ''`,
+      created_at: `created_at TEXT NOT NULL DEFAULT ''`,
+      updated_at: "updated_at TEXT",
+      deleted_at: "deleted_at TEXT",
+      payload_json: `payload_json TEXT NOT NULL DEFAULT '{}'`
+    },
+    indexStatements: [
+      "CREATE INDEX IF NOT EXISTS idx_devflare_deployment_records_account_worker ON devflare_deployment_records(account_id, worker_name)",
+      "CREATE INDEX IF NOT EXISTS idx_devflare_deployment_records_channel_status ON devflare_deployment_records(channel, status)",
+      "CREATE UNIQUE INDEX IF NOT EXISTS idx_devflare_deployment_records_deployment_id ON devflare_deployment_records(deployment_id)"
+    ]
+  }
 ];
 var schemaEnsuredRegistryIds = new Set;
 async function runQuery(registry, sql, params = [], apiOptions) {
@@ -619,12 +610,32 @@ async function runStatement(registry, sql, params = [], apiOptions) {
     params
   }, apiOptions);
 }
+function quoteSqlIdentifier(value) {
+  return `"${value.replaceAll('"', '""')}"`;
+}
+async function readTableColumnNames(registry, tableName, apiOptions) {
+  const rows = await runQuery(registry, `PRAGMA table_info(${quoteSqlIdentifier(tableName)})`, [], apiOptions);
+  return new Set(rows.map((row) => typeof row.name === "string" ? row.name : undefined).filter((value) => Boolean(value)));
+}
+async function ensureTableColumns(registry, table, apiOptions) {
+  const existingColumnNames = await readTableColumnNames(registry, table.name, apiOptions);
+  for (const [columnName, definition] of Object.entries(table.migrationColumns)) {
+    if (existingColumnNames.has(columnName)) {
+      continue;
+    }
+    await runStatement(registry, `ALTER TABLE ${quoteSqlIdentifier(table.name)} ADD COLUMN ${definition}`, [], apiOptions);
+  }
+}
 async function ensurePreviewRegistrySchema(registry, apiOptions) {
   if (schemaEnsuredRegistryIds.has(registry.databaseId)) {
     return;
   }
-  for (const statement of REGISTRY_SCHEMA_STATEMENTS) {
-    await runStatement(registry, statement, [], apiOptions);
+  for (const table of REGISTRY_TABLES) {
+    await runStatement(registry, table.createStatement, [], apiOptions);
+    await ensureTableColumns(registry, table, apiOptions);
+    for (const statement of table.indexStatements) {
+      await runStatement(registry, statement, [], apiOptions);
+    }
   }
   schemaEnsuredRegistryIds.add(registry.databaseId);
 }
@@ -656,8 +667,8 @@ function isUnavailableRegistryContextError(error) {
 function parseStoredPreviewRecord(row) {
   return devflarePreviewRecordSchema.parse(JSON.parse(row.payload_json));
 }
-function parseStoredPreviewAliasRecord(row) {
-  return devflarePreviewAliasRecordSchema.parse(JSON.parse(row.payload_json));
+function parseStoredPreviewScopeRecord(row) {
+  return devflarePreviewScopeRecordSchema.parse(JSON.parse(row.payload_json));
 }
 function parseStoredDeploymentRecord(row) {
   return devflareDeploymentRecordSchema.parse(JSON.parse(row.payload_json));
@@ -668,11 +679,11 @@ async function readPreviewRows(registry, workerName, apiOptions) {
   const rows = await runQuery(registry, sql, params, apiOptions);
   return rows.map((row) => parseStoredPreviewRecord(row));
 }
-async function readPreviewAliasRows(registry, workerName, apiOptions) {
-  const sql = workerName ? "SELECT payload_json FROM devflare_preview_alias_records WHERE account_id = ? AND worker_name = ? ORDER BY created_at DESC" : "SELECT payload_json FROM devflare_preview_alias_records WHERE account_id = ? ORDER BY created_at DESC";
+async function readPreviewScopeRows(registry, workerName, apiOptions) {
+  const sql = workerName ? "SELECT payload_json FROM devflare_preview_scope_records WHERE account_id = ? AND worker_name = ? ORDER BY created_at DESC" : "SELECT payload_json FROM devflare_preview_scope_records WHERE account_id = ? ORDER BY created_at DESC";
   const params = workerName ? [registry.accountId, workerName] : [registry.accountId];
   const rows = await runQuery(registry, sql, params, apiOptions);
-  return rows.map((row) => parseStoredPreviewAliasRecord(row));
+  return rows.map((row) => parseStoredPreviewScopeRecord(row));
 }
 async function readDeploymentRows(registry, workerName, apiOptions) {
   const sql = workerName ? "SELECT payload_json FROM devflare_deployment_records WHERE account_id = ? AND worker_name = ? ORDER BY created_at DESC" : "SELECT payload_json FROM devflare_deployment_records WHERE account_id = ? ORDER BY created_at DESC";
@@ -689,8 +700,8 @@ async function upsertPreviewRecord(registry, record, apiOptions) {
 			worker_name,
 			version_id,
 			preview_url,
-			alias,
-			alias_preview_url,
+			scope,
+			scope_url,
 			branch_name,
 			commit_sha,
 			deployment_id,
@@ -708,8 +719,8 @@ async function upsertPreviewRecord(registry, record, apiOptions) {
 			worker_name = excluded.worker_name,
 			version_id = excluded.version_id,
 			preview_url = excluded.preview_url,
-			alias = excluded.alias,
-			alias_preview_url = excluded.alias_preview_url,
+			scope = excluded.scope,
+			scope_url = excluded.scope_url,
 			branch_name = excluded.branch_name,
 			commit_sha = excluded.commit_sha,
 			deployment_id = excluded.deployment_id,
@@ -726,8 +737,8 @@ async function upsertPreviewRecord(registry, record, apiOptions) {
     normalizedRecord.workerName,
     normalizedRecord.versionId,
     normalizedRecord.previewUrl,
-    normalizedRecord.alias ?? null,
-    normalizedRecord.aliasPreviewUrl ?? null,
+    normalizedRecord.scope ?? null,
+    normalizedRecord.scopeUrl ?? null,
     normalizedRecord.branchName ?? null,
     normalizedRecord.commitSha ?? null,
     normalizedRecord.deploymentId ?? null,
@@ -740,15 +751,15 @@ async function upsertPreviewRecord(registry, record, apiOptions) {
     JSON.stringify(normalizedRecord)
   ], apiOptions);
 }
-async function upsertPreviewAliasRecord(registry, record, apiOptions) {
-  const normalizedRecord = devflarePreviewAliasRecordSchema.parse(record);
-  await runStatement(registry, `INSERT INTO devflare_preview_alias_records (
+async function upsertPreviewScopeRecord(registry, record, apiOptions) {
+  const normalizedRecord = devflarePreviewScopeRecordSchema.parse(record);
+  await runStatement(registry, `INSERT INTO devflare_preview_scope_records (
 			id,
 			ver,
 			account_id,
 			worker_name,
-			alias,
-			alias_preview_url,
+			scope,
+			scope_url,
 			version_id,
 			preview_id,
 			branch_name,
@@ -765,8 +776,8 @@ async function upsertPreviewAliasRecord(registry, record, apiOptions) {
 			ver = excluded.ver,
 			account_id = excluded.account_id,
 			worker_name = excluded.worker_name,
-			alias = excluded.alias,
-			alias_preview_url = excluded.alias_preview_url,
+			scope = excluded.scope,
+			scope_url = excluded.scope_url,
 			version_id = excluded.version_id,
 			preview_id = excluded.preview_id,
 			branch_name = excluded.branch_name,
@@ -782,8 +793,8 @@ async function upsertPreviewAliasRecord(registry, record, apiOptions) {
     normalizedRecord.ver,
     normalizedRecord.accountId,
     normalizedRecord.workerName,
-    normalizedRecord.alias,
-    normalizedRecord.aliasPreviewUrl,
+    normalizedRecord.scope,
+    normalizedRecord.scopeUrl,
     normalizedRecord.versionId,
     normalizedRecord.previewId ?? null,
     normalizedRecord.branchName ?? null,
@@ -894,14 +905,14 @@ async function withRegistryReadRecovery(registry, apiOptions, operation) {
   }
 }
 async function loadTrackedRegistryRows(registry, workerName, apiOptions) {
-  const [previews, aliases, deployments] = await Promise.all([
+  const [previews, scopes, deployments] = await Promise.all([
     readPreviewRows(registry, workerName, apiOptions),
-    readPreviewAliasRows(registry, workerName, apiOptions),
+    readPreviewScopeRows(registry, workerName, apiOptions),
     readDeploymentRows(registry, workerName, apiOptions)
   ]);
   return {
     previews,
-    aliases,
+    scopes,
     deployments
   };
 }
@@ -909,8 +920,8 @@ async function applyDeletedRecords(registry, options) {
   for (const preview of options.previews) {
     await upsertPreviewRecord(registry, markPreviewRecordDeleted(preview, options.now), options.apiOptions);
   }
-  for (const alias of options.aliases) {
-    await upsertPreviewAliasRecord(registry, markPreviewAliasRecordDeleted(alias, options.now), options.apiOptions);
+  for (const scope of options.scopes) {
+    await upsertPreviewScopeRecord(registry, markPreviewScopeRecordDeleted(scope, options.now), options.apiOptions);
   }
   for (const deployment of options.deployments) {
     await upsertDeploymentRecord(registry, markDeploymentRecordDeleted(deployment, options.now), options.apiOptions);
@@ -976,14 +987,14 @@ async function listTrackedPreviewRecords(options) {
     records: result
   };
 }
-async function listTrackedPreviewAliasRecords(options) {
+async function listTrackedPreviewScopeRecords(options) {
   const registry = await ensurePreviewRegistry({
     accountId: options.accountId,
     databaseName: options.databaseName,
     apiOptions: options.apiOptions,
     skipSchemaIfExisting: true
   });
-  const { registry: resolvedRegistry, result } = await withRegistryReadRecovery(registry, options.apiOptions, (activeRegistry) => readPreviewAliasRows(activeRegistry, options.workerName, options.apiOptions));
+  const { registry: resolvedRegistry, result } = await withRegistryReadRecovery(registry, options.apiOptions, (activeRegistry) => readPreviewScopeRows(activeRegistry, options.workerName, options.apiOptions));
   return {
     registry: resolvedRegistry,
     records: result
@@ -1013,16 +1024,16 @@ async function reconcilePreviewRegistry(options) {
   const workersSubdomain = await getWorkersSubdomain(options.accountId, options.apiOptions);
   const liveVersions = await listWorkerVersions(options.accountId, options.workerName, options.apiOptions);
   const liveDeployments = await listWorkerDeployments(options.accountId, options.workerName, options.apiOptions);
-  const { previews: previewRecords, aliases: aliasRecords, deployments: deploymentRecords } = await loadTrackedRegistryRows(registry, options.workerName, options.apiOptions);
+  const { previews: previewRecords, scopes: scopeRecords, deployments: deploymentRecords } = await loadTrackedRegistryRows(registry, options.workerName, options.apiOptions);
   const previewRecordByVersionId = new Map(previewRecords.map((record) => [record.versionId, record]));
-  const previewAliasRecordByAlias = new Map(aliasRecords.map((record) => [record.alias, record]));
+  const previewScopeRecordByScope = new Map(scopeRecords.map((record) => [record.scope, record]));
   const deploymentRecordById = new Map(deploymentRecords.map((record) => [record.deploymentId, record]));
   const syncedPreviews = [];
-  const syncedAliases = [];
+  const syncedScopes = [];
   const syncedDeployments = [];
   const versionMetadataMap = new Map(liveVersions.map((version) => [version.id, version]));
   const previewVersions = [...liveVersions.filter((candidate) => candidate.metadata.hasPreview)];
-  if (options.versionId && (options.previewUrl || options.previewAliasUrl || options.previewAlias) && !previewVersions.some((version) => version.id === options.versionId)) {
+  if (options.versionId && (options.previewUrl || options.previewScopeUrl || options.previewScope) && !previewVersions.some((version) => version.id === options.versionId)) {
     const explicitPreviewVersion = await getVersionInfoById(options.accountId, options.workerName, options.versionId, versionMetadataMap, options.apiOptions);
     if (explicitPreviewVersion) {
       previewVersions.unshift({
@@ -1051,16 +1062,16 @@ async function reconcilePreviewRegistry(options) {
     }
     await upsertPreviewRecord(registry, previewRecord, options.apiOptions);
     syncedPreviews.push(previewRecord);
-    const aliasRecord = buildPreviewAliasRecord({
+    const scopeRecord = buildPreviewScopeRecord({
       accountId: options.accountId,
       workerName: options.workerName,
       previewRecord,
-      existing: previewRecord.alias ? previewAliasRecordByAlias.get(previewRecord.alias) : undefined,
+      existing: previewRecord.scope ? previewScopeRecordByScope.get(previewRecord.scope) : undefined,
       now
     });
-    if (aliasRecord) {
-      await upsertPreviewAliasRecord(registry, aliasRecord, options.apiOptions);
-      syncedAliases.push(aliasRecord);
+    if (scopeRecord) {
+      await upsertPreviewScopeRecord(registry, scopeRecord, options.apiOptions);
+      syncedScopes.push(scopeRecord);
     }
     const previewDeploymentRecord = buildPreviewDeploymentRecord({
       accountId: options.accountId,
@@ -1097,7 +1108,7 @@ async function reconcilePreviewRegistry(options) {
   return {
     registry,
     previews: syncedPreviews,
-    previewAliases: syncedAliases,
+    previewScopes: syncedScopes,
     deployments: syncedDeployments
   };
 }
@@ -1109,15 +1120,15 @@ async function cleanupPreviewRegistry(options) {
     apiOptions: options.apiOptions,
     logger: options.logger
   });
-  const { previews, aliases, deployments } = await loadTrackedRegistryRows(registry, options.workerName, options.apiOptions);
+  const { previews, scopes, deployments } = await loadTrackedRegistryRows(registry, options.workerName, options.apiOptions);
   const cutoff = new Date(now.getTime() - Math.max(options.days ?? 7, 0) * 24 * 60 * 60 * 1000);
   const previewCandidates = previews.filter((record) => !record.deletedAt && record.createdAt <= cutoff && record.status !== "active");
-  const aliasCandidates = aliases.filter((record) => !record.deletedAt && record.createdAt <= cutoff && record.status !== "active");
+  const scopeCandidates = scopes.filter((record) => !record.deletedAt && record.createdAt <= cutoff && record.status !== "active");
   const deploymentCandidates = deployments.filter((record) => !record.deletedAt && record.createdAt <= cutoff && record.status !== "active");
   if (options.apply) {
     await applyDeletedRecords(registry, {
       previews: previewCandidates,
-      aliases: aliasCandidates,
+      scopes: scopeCandidates,
       deployments: deploymentCandidates,
       now,
       apiOptions: options.apiOptions
@@ -1126,11 +1137,11 @@ async function cleanupPreviewRegistry(options) {
   return {
     registry,
     previews,
-    aliases,
+    scopes,
     deployments,
     candidates: {
       previews: previewCandidates,
-      aliases: aliasCandidates,
+      scopes: scopeCandidates,
       deployments: deploymentCandidates
     },
     applied: options.apply === true
@@ -1138,7 +1149,7 @@ async function cleanupPreviewRegistry(options) {
 }
 async function retirePreviewRegistry(options) {
   if (!hasRetireSelector(options)) {
-    throw new Error("Retiring preview registry records requires at least one selector: branchName, previewAlias, versionId, or commitSha.");
+    throw new Error("Retiring preview registry records requires at least one selector: branchName, previewScope, versionId, or commitSha.");
   }
   const now = options.now ?? new Date;
   const registry = await ensurePreviewRegistry({
@@ -1147,17 +1158,17 @@ async function retirePreviewRegistry(options) {
     apiOptions: options.apiOptions,
     logger: options.logger
   });
-  const { previews, aliases, deployments } = await loadTrackedRegistryRows(registry, options.workerName, options.apiOptions);
+  const { previews, scopes, deployments } = await loadTrackedRegistryRows(registry, options.workerName, options.apiOptions);
   const directlyMatchedPreviews = previews.filter((record) => !record.deletedAt && matchesPreviewRetireTarget(record, options));
-  const directlyMatchedAliases = aliases.filter((record) => !record.deletedAt && matchesPreviewAliasRetireTarget(record, options));
+  const directlyMatchedScopes = scopes.filter((record) => !record.deletedAt && matchesPreviewScopeRetireTarget(record, options));
   const directlyMatchedDeployments = deployments.filter((record) => !record.deletedAt && matchesPreviewDeploymentRetireTarget(record, options));
   const candidatePreviewIds = new Set([
     ...directlyMatchedPreviews.map((record) => record.id),
-    ...directlyMatchedAliases.flatMap((record) => record.previewId ? [record.previewId] : [])
+    ...directlyMatchedScopes.flatMap((record) => record.previewId ? [record.previewId] : [])
   ]);
   const candidateVersionIds = new Set([
     ...directlyMatchedPreviews.map((record) => record.versionId),
-    ...directlyMatchedAliases.map((record) => record.versionId),
+    ...directlyMatchedScopes.map((record) => record.versionId),
     ...directlyMatchedDeployments.map((record) => record.versionId),
     ...options.versionId ? [options.versionId] : []
   ]);
@@ -1169,10 +1180,10 @@ async function retirePreviewRegistry(options) {
     ...candidateVersionIds,
     ...previewCandidates.map((record) => record.versionId)
   ]);
-  const aliasCandidates = aliases.filter((record) => {
-    return !record.deletedAt && (matchesPreviewAliasRetireTarget(record, options) || resolvedVersionIds.has(record.versionId) || record.previewId !== undefined && resolvedPreviewIds.has(record.previewId));
+  const scopeCandidates = scopes.filter((record) => {
+    return !record.deletedAt && (matchesPreviewScopeRetireTarget(record, options) || resolvedVersionIds.has(record.versionId) || record.previewId !== undefined && resolvedPreviewIds.has(record.previewId));
   });
-  for (const record of aliasCandidates) {
+  for (const record of scopeCandidates) {
     resolvedVersionIds.add(record.versionId);
     if (record.previewId) {
       resolvedPreviewIds.add(record.previewId);
@@ -1184,7 +1195,7 @@ async function retirePreviewRegistry(options) {
   if (options.apply) {
     await applyDeletedRecords(registry, {
       previews: previewCandidates,
-      aliases: aliasCandidates,
+      scopes: scopeCandidates,
       deployments: deploymentCandidates,
       now,
       apiOptions: options.apiOptions
@@ -1193,15 +1204,15 @@ async function retirePreviewRegistry(options) {
   return {
     registry,
     previews,
-    aliases,
+    scopes,
     deployments,
     candidates: {
       previews: previewCandidates,
-      aliases: aliasCandidates,
+      scopes: scopeCandidates,
       deployments: deploymentCandidates
     },
     applied: options.apply === true
   };
 }
 
-export { formatWorkersDevUrl, parseWranglerStructuredOutput, mergeParsedWranglerDeployOutputs, parseWranglerDeployOutput, DEVFLARE_PREVIEW_REGISTRY_DATABASE, devflareAccountRecordSchema, createDevflareAccountRecordSchema, devflareRecordSourceSchema, devflarePreviewStatusSchema, devflarePreviewAliasStatusSchema, devflareDeploymentChannelSchema, devflareDeploymentStatusSchema, devflarePreviewRecordSchema, devflarePreviewAliasRecordSchema, devflareDeploymentRecordSchema, devflareAccountLayerRecordSchema, getPreviewRegistryContext, ensurePreviewRegistry, listTrackedRegistryState, listTrackedPreviewRecords, listTrackedPreviewAliasRecords, listTrackedDeploymentRecords, reconcilePreviewRegistry, cleanupPreviewRegistry, retirePreviewRegistry };
+export { formatWorkersDevUrl, DEVFLARE_PREVIEW_REGISTRY_DATABASE, devflareAccountRecordSchema, createDevflareAccountRecordSchema, devflareRecordSourceSchema, devflarePreviewStatusSchema, devflarePreviewScopeStatusSchema, devflareDeploymentChannelSchema, devflareDeploymentStatusSchema, devflarePreviewRecordSchema, devflarePreviewScopeRecordSchema, devflareDeploymentRecordSchema, devflareAccountLayerRecordSchema, getPreviewRegistryContext, ensurePreviewRegistry, listTrackedRegistryState, listTrackedPreviewRecords, listTrackedPreviewScopeRecords, listTrackedDeploymentRecords, reconcilePreviewRegistry, cleanupPreviewRegistry, retirePreviewRegistry };