@astrojs/db 0.0.0-edge-nested-20240223135627

package/LICENSE

@@ -0,0 +1,59 @@
+MIT License
+
+Copyright (c) 2021 Fred K. Schott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+"""
+This license applies to parts of the `packages/create-astro` and `packages/astro` subdirectories originating from the https://github.com/sveltejs/kit repository:
+
+Copyright (c) 2020 [these people](https://github.com/sveltejs/kit/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+"""
+
+"""
+This license applies to parts of the `packages/create-astro` and `packages/astro` subdirectories originating from the https://github.com/vitejs/vite repository:
+
+MIT License
+
+Copyright (c) 2019-present, Yuxi (Evan) You and Vite contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+"""

package/config-augment.d.ts

@@ -0,0 +1,4 @@
+declare namespace Config {
+	type DBUserConfig = import('./dist/core/types.js').DBUserConfig;
+	export interface Database extends DBUserConfig {}
+}

package/dist/core/cli/commands/gen/index.d.ts

@@ -0,0 +1,6 @@
+import type { AstroConfig } from 'astro';
+import type { Arguments } from 'yargs-parser';
+export declare function cmd({ config }: {
+    config: AstroConfig;
+    flags: Arguments;
+}): Promise<void>;

package/dist/core/cli/commands/gen/index.js

@@ -0,0 +1,39 @@
+import { writeFile } from "node:fs/promises";
+import {
+  MIGRATIONS_CREATED,
+  MIGRATIONS_UP_TO_DATE,
+  getMigrationStatus,
+  initializeMigrationsDirectory
+} from "../../migrations.js";
+import { getMigrationQueries } from "../../migration-queries.js";
+import { bgRed, red, reset } from "kleur/colors";
+async function cmd({ config }) {
+  const migration = await getMigrationStatus(config);
+  if (migration.state === "no-migrations-found") {
+    await initializeMigrationsDirectory(migration.currentSnapshot);
+    console.log(MIGRATIONS_CREATED);
+    return;
+  } else if (migration.state === "up-to-date") {
+    console.log(MIGRATIONS_UP_TO_DATE);
+    return;
+  }
+  const { oldSnapshot, newSnapshot, newFilename, diff } = migration;
+  const { queries: migrationQueries, confirmations } = await getMigrationQueries({
+    oldSnapshot,
+    newSnapshot
+  });
+  confirmations.map((message) => console.log(bgRed(" !!! ") + " " + red(message)));
+  const migrationFileContent = {
+    diff,
+    db: migrationQueries,
+    // TODO(fks): Encode the relevant data, instead of the raw message.
+    // This will give `db push` more control over the formatting of the message.
+    confirm: confirmations.map((c) => reset(c))
+  };
+  const migrationFileName = `./migrations/${newFilename}`;
+  await writeFile(migrationFileName, JSON.stringify(migrationFileContent, void 0, 2));
+  console.log(migrationFileName + " created!");
+}
+export {
+  cmd
+};

package/dist/core/cli/commands/link/index.d.ts

@@ -0,0 +1,8 @@
+import type { AstroConfig } from 'astro';
+import type { Arguments } from 'yargs-parser';
+export declare function cmd({ flags }: {
+    config: AstroConfig;
+    flags: Arguments;
+}): Promise<void>;
+export declare function promptProjectName(defaultName?: string): Promise<string>;
+export declare function promptWorkspaceName(defaultName?: string): Promise<string>;

package/dist/core/cli/commands/link/index.js

@@ -0,0 +1,78 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { bgRed, cyan } from "kleur/colors";
+import prompts from "prompts";
+import { PROJECT_ID_FILE, getSessionIdFromFile } from "../../../tokens.js";
+import { getAstroStudioUrl } from "../../../utils.js";
+import { MISSING_SESSION_ID_ERROR } from "../../../errors.js";
+async function cmd({ flags }) {
+  const linkUrl = new URL(getAstroStudioUrl() + "/auth/cli/link");
+  const sessionToken = await getSessionIdFromFile();
+  if (!sessionToken) {
+    console.error(MISSING_SESSION_ID_ERROR);
+    process.exit(1);
+  }
+  let body = { id: flags._[4] };
+  if (!body.id) {
+    const workspaceIdName = await promptWorkspaceName();
+    const projectIdName = await promptProjectName();
+    body = { projectIdName, workspaceIdName };
+  }
+  const response = await fetch(linkUrl, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${await getSessionIdFromFile()}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok) {
+    if (response.status === 401) {
+      console.error(
+        `${bgRed("Unauthorized")}
+
+  Are you logged in?
+  Run ${cyan(
+          "astro db login"
+        )} to authenticate and then try linking again.
+
+`
+      );
+      process.exit(1);
+    }
+    console.error(`Failed to link project: ${response.status} ${response.statusText}`);
+    process.exit(1);
+  }
+  const { data } = await response.json();
+  await mkdir(new URL(".", PROJECT_ID_FILE), { recursive: true });
+  await writeFile(PROJECT_ID_FILE, `${data.id}`);
+  console.info("Project linked.");
+}
+async function promptProjectName(defaultName) {
+  const { projectName } = await prompts({
+    type: "text",
+    name: "projectName",
+    message: "Project ID",
+    initial: defaultName
+  });
+  if (typeof projectName !== "string") {
+    process.exit(0);
+  }
+  return projectName;
+}
+async function promptWorkspaceName(defaultName) {
+  const { workspaceName } = await prompts({
+    type: "text",
+    name: "workspaceName",
+    message: "Workspace ID",
+    initial: defaultName
+  });
+  if (typeof workspaceName !== "string") {
+    process.exit(0);
+  }
+  return workspaceName;
+}
+export {
+  cmd,
+  promptProjectName,
+  promptWorkspaceName
+};

package/dist/core/cli/commands/login/index.d.ts

@@ -0,0 +1,6 @@
+import type { AstroConfig } from 'astro';
+import type { Arguments } from 'yargs-parser';
+export declare function cmd({ flags }: {
+    config: AstroConfig;
+    flags: Arguments;
+}): Promise<void>;

package/dist/core/cli/commands/login/index.js

@@ -0,0 +1,46 @@
+import { cyan } from "kleur/colors";
+import { mkdir, writeFile } from "node:fs/promises";
+import { createServer } from "node:http";
+import ora from "ora";
+import { getAstroStudioUrl } from "../../../utils.js";
+import open from "open";
+import { SESSION_LOGIN_FILE } from "../../../tokens.js";
+function serveAndResolveSession() {
+  let resolve, reject;
+  const sessionPromise = new Promise((_resolve, _reject) => {
+    resolve = _resolve;
+    reject = _reject;
+  });
+  const server = createServer((req, res) => {
+    res.writeHead(200);
+    res.end();
+    const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+    const session = url.searchParams.get("session");
+    if (!session) {
+      reject();
+    } else {
+      resolve(session);
+    }
+  }).listen(5710, "localhost");
+  return sessionPromise.finally(() => {
+    server.closeAllConnections();
+    server.close();
+  });
+}
+async function cmd({ flags }) {
+  let session = flags.session;
+  const loginUrl = getAstroStudioUrl() + "/auth/cli";
+  if (!session) {
+    console.log(`Opening ${cyan(loginUrl)} in your browser...`);
+    console.log(`If something goes wrong, copy-and-paste the URL into your browser.`);
+    open(loginUrl);
+    const spinner = ora("Waiting for confirmation...");
+    session = await serveAndResolveSession();
+    spinner.succeed("Successfully logged in!");
+  }
+  await mkdir(new URL(".", SESSION_LOGIN_FILE), { recursive: true });
+  await writeFile(SESSION_LOGIN_FILE, `${session}`);
+}
+export {
+  cmd
+};

package/dist/core/cli/commands/logout/index.d.ts

@@ -0,0 +1,6 @@
+import type { AstroConfig } from 'astro';
+import type { Arguments } from 'yargs-parser';
+export declare function cmd({}: {
+    config: AstroConfig;
+    flags: Arguments;
+}): Promise<void>;

package/dist/core/cli/commands/logout/index.js

@@ -0,0 +1,9 @@
+import { unlink } from "node:fs/promises";
+import { SESSION_LOGIN_FILE } from "../../../tokens.js";
+async function cmd({}) {
+  await unlink(SESSION_LOGIN_FILE);
+  console.log("Successfully logged out of Astro Studio.");
+}
+export {
+  cmd
+};

package/dist/core/cli/commands/push/index.d.ts

@@ -0,0 +1,6 @@
+import type { AstroConfig } from 'astro';
+import type { Arguments } from 'yargs-parser';
+export declare function cmd({ config, flags }: {
+    config: AstroConfig;
+    flags: Arguments;
+}): Promise<void>;

package/dist/core/cli/commands/push/index.js

@@ -0,0 +1,209 @@
+import { createClient } from "@libsql/client";
+import { drizzle as drizzleProxy } from "drizzle-orm/sqlite-proxy";
+import { drizzle as drizzleLibsql } from "drizzle-orm/libsql";
+import { SQLiteAsyncDialect } from "drizzle-orm/sqlite-core";
+import { red } from "kleur/colors";
+import prompts from "prompts";
+import { recreateTables, seedData } from "../../../queries.js";
+import { getManagedAppTokenOrExit } from "../../../tokens.js";
+import { tablesSchema } from "../../../types.js";
+import { getRemoteDatabaseUrl } from "../../../utils.js";
+import { getMigrationQueries } from "../../migration-queries.js";
+import {
+  createEmptySnapshot,
+  getMigrations,
+  getMigrationStatus,
+  loadInitialSnapshot,
+  loadMigration,
+  MIGRATION_NEEDED,
+  MIGRATIONS_NOT_INITIALIZED,
+  MIGRATIONS_UP_TO_DATE
+} from "../../migrations.js";
+import { MISSING_SESSION_ID_ERROR } from "../../../errors.js";
+async function cmd({ config, flags }) {
+  const isDryRun = flags.dryRun;
+  const appToken = await getManagedAppTokenOrExit(flags.token);
+  const migration = await getMigrationStatus(config);
+  if (migration.state === "no-migrations-found") {
+    console.log(MIGRATIONS_NOT_INITIALIZED);
+    process.exit(1);
+  } else if (migration.state === "ahead") {
+    console.log(MIGRATION_NEEDED);
+    process.exit(1);
+  }
+  const allLocalMigrations = await getMigrations();
+  let missingMigrations = [];
+  try {
+    const { data } = await prepareMigrateQuery({
+      migrations: allLocalMigrations,
+      appToken: appToken.token
+    });
+    missingMigrations = data;
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.message.startsWith("{")) {
+        const { error: { code } = { code: "" } } = JSON.parse(error.message);
+        if (code === "TOKEN_UNAUTHORIZED") {
+          console.error(MISSING_SESSION_ID_ERROR);
+        }
+      }
+    }
+    console.error(error);
+    process.exit(1);
+  }
+  if (missingMigrations.length === 0) {
+    console.log(MIGRATIONS_UP_TO_DATE);
+  } else {
+    console.log(`Pushing ${missingMigrations.length} migrations...`);
+    await pushSchema({
+      migrations: missingMigrations,
+      appToken: appToken.token,
+      isDryRun,
+      currentSnapshot: migration.currentSnapshot
+    });
+  }
+  console.info("Pushing data...");
+  await pushData({ config, appToken: appToken.token, isDryRun });
+  await appToken.destroy();
+  console.info("Push complete!");
+}
+async function pushSchema({
+  migrations,
+  appToken,
+  isDryRun,
+  currentSnapshot
+}) {
+  const initialSnapshot = migrations.find((m) => m === "0000_snapshot.json");
+  const filteredMigrations = migrations.filter((m) => m !== "0000_snapshot.json");
+  const missingMigrationContents = await Promise.all(filteredMigrations.map(loadMigration));
+  const initialMigrationBatch = initialSnapshot ? (await getMigrationQueries({
+    oldSnapshot: createEmptySnapshot(),
+    newSnapshot: await loadInitialSnapshot()
+  })).queries : [];
+  const confirmations = missingMigrationContents.reduce((acc, curr) => {
+    return [...acc, ...curr.confirm || []];
+  }, []);
+  if (confirmations.length > 0) {
+    const response = await prompts([
+      ...confirmations.map((message, index) => ({
+        type: "confirm",
+        name: String(index),
+        message: red("Warning: ") + message + "\nContinue?",
+        initial: true
+      }))
+    ]);
+    if (Object.values(response).length === 0 || Object.values(response).some((value) => value === false)) {
+      process.exit(1);
+    }
+  }
+  const queries = missingMigrationContents.reduce((acc, curr) => {
+    return [...acc, ...curr.db];
+  }, initialMigrationBatch);
+  await runMigrateQuery({ queries, migrations, snapshot: currentSnapshot, appToken, isDryRun });
+}
+const sqlite = new SQLiteAsyncDialect();
+async function pushData({
+  config,
+  appToken,
+  isDryRun
+}) {
+  const queries = [];
+  if (config.db?.data) {
+    const libsqlClient = createClient({ url: ":memory:" });
+    await recreateTables({
+      db: drizzleLibsql(libsqlClient),
+      tables: tablesSchema.parse(config.db.tables ?? {})
+    });
+    for (const [collectionName, { writable }] of Object.entries(config.db.tables ?? {})) {
+      if (!writable) {
+        queries.push({
+          sql: `DELETE FROM ${sqlite.escapeName(collectionName)}`,
+          args: []
+        });
+      }
+    }
+    const db = await drizzleProxy(async (sqlQuery, params, method) => {
+      const stmt = { sql: sqlQuery, args: params };
+      queries.push(stmt);
+      const { rows } = await libsqlClient.execute(stmt);
+      const rowValues = [];
+      for (const row of rows) {
+        if (row != null && typeof row === "object") {
+          rowValues.push(Object.values(row));
+        }
+      }
+      if (method === "get") {
+        return { rows: rowValues[0] };
+      }
+      return { rows: rowValues };
+    });
+    await seedData({
+      db,
+      mode: "build",
+      data: config.db.data
+    });
+  }
+  const url = new URL("/db/query", getRemoteDatabaseUrl());
+  if (isDryRun) {
+    console.info("[DRY RUN] Batch data seed:", JSON.stringify(queries, null, 2));
+    return new Response(null, { status: 200 });
+  }
+  return await fetch(url, {
+    method: "POST",
+    headers: new Headers({
+      Authorization: `Bearer ${appToken}`
+    }),
+    body: JSON.stringify(queries)
+  });
+}
+async function runMigrateQuery({
+  queries: baseQueries,
+  migrations,
+  snapshot,
+  appToken,
+  isDryRun
+}) {
+  const queries = ["pragma defer_foreign_keys=true;", ...baseQueries];
+  const requestBody = {
+    snapshot,
+    migrations,
+    sql: queries,
+    experimentalVersion: 1
+  };
+  if (isDryRun) {
+    console.info("[DRY RUN] Batch query:", JSON.stringify(requestBody, null, 2));
+    return new Response(null, { status: 200 });
+  }
+  const url = new URL("/migrations/run", getRemoteDatabaseUrl());
+  return await fetch(url, {
+    method: "POST",
+    headers: new Headers({
+      Authorization: `Bearer ${appToken}`
+    }),
+    body: JSON.stringify(requestBody)
+  });
+}
+async function prepareMigrateQuery({
+  migrations,
+  appToken
+}) {
+  const url = new URL("/migrations/prepare", getRemoteDatabaseUrl());
+  const requestBody = {
+    migrations,
+    experimentalVersion: 1
+  };
+  const result = await fetch(url, {
+    method: "POST",
+    headers: new Headers({
+      Authorization: `Bearer ${appToken}`
+    }),
+    body: JSON.stringify(requestBody)
+  });
+  if (result.status >= 400) {
+    throw new Error(await result.text());
+  }
+  return await result.json();
+}
+export {
+  cmd
+};

package/dist/core/cli/commands/shell/index.d.ts

@@ -0,0 +1,6 @@
+import type { AstroConfig } from 'astro';
+import type { Arguments } from 'yargs-parser';
+export declare function cmd({ flags }: {
+    config: AstroConfig;
+    flags: Arguments;
+}): Promise<void>;

package/dist/core/cli/commands/shell/index.js

@@ -0,0 +1,15 @@
+import { sql } from "drizzle-orm";
+import { createRemoteDatabaseClient } from "../../../../runtime/db-client.js";
+import { getManagedAppTokenOrExit } from "../../../tokens.js";
+import { getRemoteDatabaseUrl } from "../../../utils.js";
+async function cmd({ flags }) {
+  const query = flags.query;
+  const appToken = await getManagedAppTokenOrExit(flags.token);
+  const db = createRemoteDatabaseClient(appToken.token, getRemoteDatabaseUrl());
+  const result = await db.run(sql.raw(query));
+  await appToken.destroy();
+  console.log(result);
+}
+export {
+  cmd
+};

package/dist/core/cli/commands/verify/index.d.ts

@@ -0,0 +1,6 @@
+import type { AstroConfig } from 'astro';
+import type { Arguments } from 'yargs-parser';
+export declare function cmd({ config, flags }: {
+    config: AstroConfig;
+    flags: Arguments;
+}): Promise<void>;

package/dist/core/cli/commands/verify/index.js

@@ -0,0 +1,43 @@
+import {
+  getMigrationStatus,
+  MIGRATION_NEEDED,
+  MIGRATIONS_NOT_INITIALIZED,
+  MIGRATIONS_UP_TO_DATE
+} from "../../migrations.js";
+import { getMigrationQueries } from "../../migration-queries.js";
+async function cmd({ config, flags }) {
+  const status = await getMigrationStatus(config);
+  const { state } = status;
+  if (flags.json) {
+    if (state === "ahead") {
+      const { queries: migrationQueries } = await getMigrationQueries({
+        oldSnapshot: status.oldSnapshot,
+        newSnapshot: status.newSnapshot
+      });
+      const newFileContent = {
+        diff: status.diff,
+        db: migrationQueries
+      };
+      status.newFileContent = JSON.stringify(newFileContent, null, 2);
+    }
+    console.log(JSON.stringify(status));
+    process.exit(state === "up-to-date" ? 0 : 1);
+  }
+  switch (state) {
+    case "no-migrations-found": {
+      console.log(MIGRATIONS_NOT_INITIALIZED);
+      process.exit(1);
+    }
+    case "ahead": {
+      console.log(MIGRATION_NEEDED);
+      process.exit(1);
+    }
+    case "up-to-date": {
+      console.log(MIGRATIONS_UP_TO_DATE);
+      return;
+    }
+  }
+}
+export {
+  cmd
+};

package/dist/core/cli/index.d.ts

@@ -0,0 +1,6 @@
+import type { AstroConfig } from 'astro';
+import type { Arguments } from 'yargs-parser';
+export declare function cli({ flags, config }: {
+    flags: Arguments;
+    config: AstroConfig;
+}): Promise<void>;

package/dist/core/cli/index.js

@@ -0,0 +1,68 @@
+import { STUDIO_CONFIG_MISSING_CLI_ERROR } from "../errors.js";
+async function cli({ flags, config }) {
+  const args = flags._;
+  const command = args[2] === "db" ? args[3] : args[2];
+  if (!config.db?.studio) {
+    console.log(STUDIO_CONFIG_MISSING_CLI_ERROR);
+    process.exit(1);
+  }
+  switch (command) {
+    case "shell": {
+      const { cmd } = await import("./commands/shell/index.js");
+      return await cmd({ config, flags });
+    }
+    case "gen":
+    case "sync": {
+      const { cmd } = await import("./commands/gen/index.js");
+      return await cmd({ config, flags });
+    }
+    case "push": {
+      const { cmd } = await import("./commands/push/index.js");
+      return await cmd({ config, flags });
+    }
+    case "verify": {
+      const { cmd } = await import("./commands/verify/index.js");
+      return await cmd({ config, flags });
+    }
+    case "login": {
+      const { cmd } = await import("./commands/login/index.js");
+      return await cmd({ config, flags });
+    }
+    case "logout": {
+      const { cmd } = await import("./commands/logout/index.js");
+      return await cmd({ config, flags });
+    }
+    case "link": {
+      const { cmd } = await import("./commands/link/index.js");
+      return await cmd({ config, flags });
+    }
+    default: {
+      if (command == null) {
+        console.error(`No command provided.
+
+${showHelp()}`);
+      } else {
+        console.error(`Unknown command: ${command}
+
+${showHelp()}`);
+      }
+      return;
+    }
+  }
+  function showHelp() {
+    return `astro db <command>
+		
+Usage:
+
+astro login          Authenticate your machine with Astro Studio
+astro logout         End your authenticated session with Astro Studio
+astro link           Link this directory to an Astro Studio project
+
+astro db gen         Creates snapshot based on your schema
+astro db push        Pushes migrations to Astro Studio
+astro db verify      Verifies migrations have been pushed and errors if not`;
+  }
+}
+export {
+  cli
+};

package/dist/core/cli/migration-queries.d.ts

@@ -0,0 +1,26 @@
+import { type DBTable, type DBSnapshot } from '../types.js';
+/** Dependency injected for unit testing */
+type AmbiguityResponses = {
+    collectionRenames: Record<string, string>;
+    columnRenames: {
+        [collectionName: string]: Record<string, string>;
+    };
+};
+export declare function getMigrationQueries({ oldSnapshot, newSnapshot, ambiguityResponses, }: {
+    oldSnapshot: DBSnapshot;
+    newSnapshot: DBSnapshot;
+    ambiguityResponses?: AmbiguityResponses;
+}): Promise<{
+    queries: string[];
+    confirmations: string[];
+}>;
+export declare function getCollectionChangeQueries({ collectionName, oldCollection, newCollection, ambiguityResponses, }: {
+    collectionName: string;
+    oldCollection: DBTable;
+    newCollection: DBTable;
+    ambiguityResponses?: AmbiguityResponses;
+}): Promise<{
+    queries: string[];
+    confirmations: string[];
+}>;
+export {};