@rebasepro/server-postgres 0.22.0 → 0.24.0

package/dist/cli-helpers.d.ts

@@ -1,4 +1,5 @@
 import type { GeneratedColumnDependency } from "./schema/generated-column-conflicts.js";
+import { type ExistingColumnType } from "./schema/destructive-sql.js";
 import type { CollectionConfig } from "@rebasepro/types";
 /**
  * Why is a dependency's binary missing — never installed, or installed with its
@@ -126,10 +127,10 @@ export declare function dropDevDatabase(databaseUrl: string, devDatabaseUrl: str
 /**
  * The generated SQL for the project's `search` blocks, if it has any.
  *
- * @param drizzleDir directory holding the generated SQL. Defaults to `drizzle`
- *        under the working directory.
+ * @param sqlDir directory holding the generated SQL. Defaults to
+ *        `.rebase/sql` under the working directory.
  */
-export declare function readSearchDdl(drizzleDir?: string): string;
+export declare function readSearchDdl(sqlDir?: string): string;
 /**
  * Bring the search column, its index and their helpers up to date.
  *
@@ -143,7 +144,7 @@ export declare function readSearchDdl(drizzleDir?: string): string;
  * silently pushing a schema whose search column never appeared is how a
  * collection ends up with search configured, no error anywhere, and no results.
  */
-export declare function applySearchDdl(databaseUrl: string, drizzleDir?: string): Promise<void>;
+export declare function applySearchDdl(databaseUrl: string, sqlDir?: string): Promise<void>;
 /**
  * Glob patterns keeping Atlas away from the search objects.
  *
@@ -164,6 +165,11 @@ export declare function getSearchExcludes(collectionsPath: string): Promise<stri
  * see `generated-column-conflicts.ts` for why that is necessary at all.
  */
 export declare function queryGeneratedColumnDependencies(databaseUrl: string): Promise<GeneratedColumnDependency[]>;
+/**
+ * Every column in the database with its current type, for the destructive
+ * gate to tell a widening `ALTER COLUMN … TYPE` from one that loses data.
+ */
+export declare function queryColumnTypes(databaseUrl: string): Promise<ExistingColumnType[]>;
 /**
  * Drop the generated columns standing in the way of an apply.
  *
@@ -175,10 +181,10 @@ export declare function dropGeneratedColumns(databaseUrl: string, statements: st
 /**
  * The generated SQL for the project's `vector` properties, if it has any.
  *
- * @param drizzleDir directory holding the generated SQL. Defaults to `drizzle`
- *        under the working directory.
+ * @param sqlDir directory holding the generated SQL. Defaults to
+ *        `.rebase/sql` under the working directory.
  */
-export declare function readVectorDdl(drizzleDir?: string): string;
+export declare function readVectorDdl(sqlDir?: string): string;
 /**
  * Install pgvector and bring the vector columns and their ANN indexes up to
  * date.
@@ -194,7 +200,7 @@ export declare function readVectorDdl(drizzleDir?: string): string;
  * appeared is how a project ends up with vector search configured, no error
  * anywhere, and no results.
  */
-export declare function applyVectorDdl(databaseUrl: string, drizzleDir?: string): Promise<void>;
+export declare function applyVectorDdl(databaseUrl: string, sqlDir?: string): Promise<void>;
 /**
  * Glob patterns keeping Atlas away from the vector objects.
  *
@@ -206,10 +212,10 @@ export declare function getVectorExcludes(collectionsPath: string): Promise<stri
  * The generated SQL for the project's `autoValue: "on_update"` properties, if
  * it has any.
  *
- * @param drizzleDir directory holding the generated SQL. Defaults to `drizzle`
- *        under the working directory.
+ * @param sqlDir directory holding the generated SQL. Defaults to
+ *        `.rebase/sql` under the working directory.
  */
-export declare function readTriggersDdl(drizzleDir?: string): string;
+export declare function readTriggersDdl(sqlDir?: string): string;
 /**
  * Install the `updated_at` trigger function and bind it to every column that
  * asked for one.
@@ -224,7 +230,7 @@ export declare function readTriggersDdl(drizzleDir?: string): string;
  * appeared is how `updated_at` ends up silently stale for every writer that is
  * not the driver, which is the whole reason the trigger exists.
  */
-export declare function applyTriggersDdl(databaseUrl: string, drizzleDir?: string): Promise<void>;
+export declare function applyTriggersDdl(databaseUrl: string, sqlDir?: string): Promise<void>;
 /** @see getSearchExcludes */
 export declare function getTriggerExcludes(collectionsPath: string): Promise<string[]>;
 /**

package/dist/cli-scratch-database.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The scratch database Atlas plans against, for the length of one db command.
+ *
+ * `atlas schema apply` and `atlas migrate diff` need a `--dev-url`: an empty
+ * database they build the desired state in, made as `<db>_dev_diff` beside the
+ * real one. It is a full copy of the schema, so it is removed again once the
+ * command that made it has succeeded — every such command, not only an applied
+ * `db push`: a `--dry-run` that left one behind while saying nothing was
+ * applied, and `db generate`, left one per target on the server.
+ *
+ * Two cases keep it. A command that fails leaves it as the state Atlas was
+ * planning against, which is the one thing worth inspecting. And one this
+ * process did not create — made by hand, the remedy for a role without
+ * `CREATEDB` — is the user's, and dropping it would put them back at the same
+ * refusal next time.
+ */
+export interface ScratchDatabaseOps {
+    /** Create it if it is missing; `true` only when this call created it. */
+    create(databaseUrl: string, devDatabaseUrl: string): Promise<boolean>;
+    drop(databaseUrl: string, devDatabaseUrl: string): Promise<void>;
+}
+export declare class ScratchDatabase {
+    private readonly ops;
+    private created;
+    constructor(ops: ScratchDatabaseOps);
+    /** Make sure it exists before an Atlas call that plans against it. */
+    ensure(databaseUrl: string, devDatabaseUrl: string): Promise<void>;
+    /**
+     * Run a command, then drop the scratch database if the command created it.
+     * A command that throws skips the drop; one that exits the process never
+     * returns here, which is the same thing.
+     */
+    around<T>(command: () => Promise<T>): Promise<T>;
+}