@rebasepro/server-postgres 0.23.0 → 0.24.1-canary.g19596ef

package/dist/cli-prompt-egtNKkZl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-prompt-egtNKkZl.js","names":[],"sources":["../../../node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.js","../src/cli-prompt.ts"],"sourcesContent":["const flagSymbol = Symbol('arg flag');\n\nclass ArgError extends Error {\n\tconstructor(msg, code) {\n\t\tsuper(msg);\n\t\tthis.name = 'ArgError';\n\t\tthis.code = code;\n\n\t\tObject.setPrototypeOf(this, ArgError.prototype);\n\t}\n}\n\nfunction arg(\n\topts,\n\t{\n\t\targv = process.argv.slice(2),\n\t\tpermissive = false,\n\t\tstopAtPositional = false\n\t} = {}\n) {\n\tif (!opts) {\n\t\tthrow new ArgError(\n\t\t\t'argument specification object is required',\n\t\t\t'ARG_CONFIG_NO_SPEC'\n\t\t);\n\t}\n\n\tconst result = { _: [] };\n\n\tconst aliases = {};\n\tconst handlers = {};\n\n\tfor (const key of Object.keys(opts)) {\n\t\tif (!key) {\n\t\t\tthrow new ArgError(\n\t\t\t\t'argument key cannot be an empty string',\n\t\t\t\t'ARG_CONFIG_EMPTY_KEY'\n\t\t\t);\n\t\t}\n\n\t\tif (key[0] !== '-') {\n\t\t\tthrow new ArgError(\n\t\t\t\t`argument key must start with '-' but found: '${key}'`,\n\t\t\t\t'ARG_CONFIG_NONOPT_KEY'\n\t\t\t);\n\t\t}\n\n\t\tif (key.length === 1) {\n\t\t\tthrow new ArgError(\n\t\t\t\t`argument key must have a name; singular '-' keys are not allowed: ${key}`,\n\t\t\t\t'ARG_CONFIG_NONAME_KEY'\n\t\t\t);\n\t\t}\n\n\t\tif (typeof opts[key] === 'string') {\n\t\t\taliases[key] = opts[key];\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet type = opts[key];\n\t\tlet isFlag = false;\n\n\t\tif (\n\t\t\tArray.isArray(type) &&\n\t\t\ttype.length === 1 &&\n\t\t\ttypeof type[0] === 'function'\n\t\t) {\n\t\t\tconst [fn] = type;\n\t\t\ttype = (value, name, prev = []) => {\n\t\t\t\tprev.push(fn(value, name, prev[prev.length - 1]));\n\t\t\t\treturn prev;\n\t\t\t};\n\t\t\tisFlag = fn === Boolean || fn[flagSymbol] === true;\n\t\t} else if (typeof type === 'function') {\n\t\t\tisFlag = type === Boolean || type[flagSymbol] === true;\n\t\t} else {\n\t\t\tthrow new ArgError(\n\t\t\t\t`type missing or not a function or valid array type: ${key}`,\n\t\t\t\t'ARG_CONFIG_VAD_TYPE'\n\t\t\t);\n\t\t}\n\n\t\tif (key[1] !== '-' && key.length > 2) {\n\t\t\tthrow new ArgError(\n\t\t\t\t`short argument keys (with a single hyphen) must have only one character: ${key}`,\n\t\t\t\t'ARG_CONFIG_SHORTOPT_TOOLONG'\n\t\t\t);\n\t\t}\n\n\t\thandlers[key] = [type, isFlag];\n\t}\n\n\tfor (let i = 0, len = argv.length; i < len; i++) {\n\t\tconst wholeArg = argv[i];\n\n\t\tif (stopAtPositional && result._.length > 0) {\n\t\t\tresult._ = result._.concat(argv.slice(i));\n\t\t\tbreak;\n\t\t}\n\n\t\tif (wholeArg === '--') {\n\t\t\tresult._ = result._.concat(argv.slice(i + 1));\n\t\t\tbreak;\n\t\t}\n\n\t\tif (wholeArg.length > 1 && wholeArg[0] === '-') {\n\t\t\t/* eslint-disable operator-linebreak */\n\t\t\tconst separatedArguments =\n\t\t\t\twholeArg[1] === '-' || wholeArg.length === 2\n\t\t\t\t\t? [wholeArg]\n\t\t\t\t\t: wholeArg\n\t\t\t\t\t\t\t.slice(1)\n\t\t\t\t\t\t\t.split('')\n\t\t\t\t\t\t\t.map((a) => `-${a}`);\n\t\t\t/* eslint-enable operator-linebreak */\n\n\t\t\tfor (let j = 0; j < separatedArguments.length; j++) {\n\t\t\t\tconst arg = separatedArguments[j];\n\t\t\t\tconst [originalArgName, argStr] =\n\t\t\t\t\targ[1] === '-' ? arg.split(/=(.*)/, 2) : [arg, undefined];\n\n\t\t\t\tlet argName = originalArgName;\n\t\t\t\twhile (argName in aliases) {\n\t\t\t\t\targName = aliases[argName];\n\t\t\t\t}\n\n\t\t\t\tif (!(argName in handlers)) {\n\t\t\t\t\tif (permissive) {\n\t\t\t\t\t\tresult._.push(arg);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t} else {\n\t\t\t\t\t\tthrow new ArgError(\n\t\t\t\t\t\t\t`unknown or unexpected option: ${originalArgName}`,\n\t\t\t\t\t\t\t'ARG_UNKNOWN_OPTION'\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst [type, isFlag] = handlers[argName];\n\n\t\t\t\tif (!isFlag && j + 1 < separatedArguments.length) {\n\t\t\t\t\tthrow new ArgError(\n\t\t\t\t\t\t`option requires argument (but was followed by another short argument): ${originalArgName}`,\n\t\t\t\t\t\t'ARG_MISSING_REQUIRED_SHORTARG'\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tif (isFlag) {\n\t\t\t\t\tresult[argName] = type(true, argName, result[argName]);\n\t\t\t\t} else if (argStr === undefined) {\n\t\t\t\t\tif (\n\t\t\t\t\t\targv.length < i + 2 ||\n\t\t\t\t\t\t(argv[i + 1].length > 1 &&\n\t\t\t\t\t\t\targv[i + 1][0] === '-' &&\n\t\t\t\t\t\t\t!(\n\t\t\t\t\t\t\t\targv[i + 1].match(/^-?\\d*(\\.(?=\\d))?\\d*$/) &&\n\t\t\t\t\t\t\t\t(type === Number ||\n\t\t\t\t\t\t\t\t\t// eslint-disable-next-line no-undef\n\t\t\t\t\t\t\t\t\t(typeof BigInt !== 'undefined' && type === BigInt))\n\t\t\t\t\t\t\t))\n\t\t\t\t\t) {\n\t\t\t\t\t\tconst extended =\n\t\t\t\t\t\t\toriginalArgName === argName ? '' : ` (alias for ${argName})`;\n\t\t\t\t\t\tthrow new ArgError(\n\t\t\t\t\t\t\t`option requires argument: ${originalArgName}${extended}`,\n\t\t\t\t\t\t\t'ARG_MISSING_REQUIRED_LONGARG'\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\n\t\t\t\t\tresult[argName] = type(argv[i + 1], argName, result[argName]);\n\t\t\t\t\t++i;\n\t\t\t\t} else {\n\t\t\t\t\tresult[argName] = type(argStr, argName, result[argName]);\n\t\t\t\t}\n\t\t\t}\n\t\t} else {\n\t\t\tresult._.push(wholeArg);\n\t\t}\n\t}\n\n\treturn result;\n}\n\narg.flag = (fn) => {\n\tfn[flagSymbol] = true;\n\treturn fn;\n};\n\n// Utility types\narg.COUNT = arg.flag((v, name, existingCount) => (existingCount || 0) + 1);\n\n// Expose error class\narg.ArgError = ArgError;\n\nmodule.exports = arg;\n","/**\n * The one yes/no question the driver CLI asks: before a destructive `db push`,\n * before a `db restore` without `--yes`, before `db branch prune` removes\n * anything, and before `schema introspect` samples rows.\n */\nimport readline from \"readline\";\n\n/**\n * Ask a yes/no question on an interactive terminal; `true` only for \"y\" or\n * \"yes\".\n *\n * The `isTTY` guard is the contract, not an optimisation: non-interactive\n * shells (CI, pipes, agents) can never answer, and `readline` on a non-TTY\n * stdin resolves with whatever the pipe happens to contain, or never resolves\n * at all. Returning false there is what makes an unattended `db push` abort\n * instead of auto-confirming a destructive change. Callers decide first\n * whether interactive confirmation is possible (`decidePushSafety` for a\n * push); this is the backstop.\n *\n * Ctrl-C and Ctrl-D answer no. On a terminal readline reads Ctrl-C as a key,\n * not as a signal, and with nothing listening it only pauses the input: the\n * question never resolves, and the open database connections behind it keep\n * the process alive, so the command hung instead of stopping. Answering no\n * sends it down the path that says \"Aborted\" and cleans up.\n */\nexport async function promptConfirm(question: string): Promise<boolean> {\n    if (!process.stdin.isTTY) return false;\n    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });\n    try {\n        const answer = await new Promise<string>((resolve) => {\n            rl.once(\"SIGINT\", () => {\n                process.stdout.write(\"\\n\");\n                resolve(\"\");\n            });\n            rl.once(\"close\", () => resolve(\"\"));\n            rl.question(question, resolve);\n        });\n        return /^y(es)?$/i.test(answer.trim());\n    } finally {\n        rl.close();\n    }\n}\n"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/cli-prompt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Ask a yes/no question on an interactive terminal; `true` only for "y" or
+ * "yes".
+ *
+ * The `isTTY` guard is the contract, not an optimisation: non-interactive
+ * shells (CI, pipes, agents) can never answer, and `readline` on a non-TTY
+ * stdin resolves with whatever the pipe happens to contain, or never resolves
+ * at all. Returning false there is what makes an unattended `db push` abort
+ * instead of auto-confirming a destructive change. Callers decide first
+ * whether interactive confirmation is possible (`decidePushSafety` for a
+ * push); this is the backstop.
+ *
+ * Ctrl-C and Ctrl-D answer no. On a terminal readline reads Ctrl-C as a key,
+ * not as a signal, and with nothing listening it only pauses the input: the
+ * question never resolves, and the open database connections behind it keep
+ * the process alive, so the command hung instead of stopping. Answering no
+ * sends it down the path that says "Aborted" and cleans up.
+ */
+export declare function promptConfirm(question: string): Promise<boolean>;

package/dist/cli-push.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The steps `rebase db push` takes once the dry-run has been read and gated.
+ *
+ * Callbacks rather than calls, so the order is testable without a database or
+ * an Atlas binary: `cli.ts` itself cannot be loaded by the jest suite.
+ */
+export interface PushApplySteps {
+    /** Drop the generated columns that read a column the plan retypes. */
+    dropRebuildable: () => Promise<void>;
+    /** `atlas schema apply --auto-approve`: Atlas plans again, then applies. */
+    atlasApply: () => Promise<void>;
+    /** Say what the skipped apply would have printed. */
+    reportSynced: () => void;
+    /** Put those generated columns back after a failed apply. */
+    rebuildAfterFailure: () => Promise<void>;
+    /**
+     * Everything Atlas cannot see: RLS locks, auth tables, vector, search,
+     * triggers, policies, the user role. Runs whether or not Atlas had work.
+     */
+    afterApply: () => Promise<void>;
+}
+/**
+ * Apply a planned push.
+ *
+ * A dry-run that answered "Schema is synced" skips the second Atlas run: that
+ * run would plan the same diff again (≈0.9 s at 111 tables, 5.5 s at 411 —
+ * Atlas's cost grows faster than the table count) and then apply nothing. The
+ * steps after it still run, because Atlas cannot see what they own. A plan with
+ * anything in it keeps the old flow, including Atlas re-planning at apply time.
+ *
+ * @returns `"synced"` when Atlas was not run again, `"applied"` otherwise.
+ */
+export declare function applyPushPlan(plan: {
+    dryRun: string;
+    rebuildable: number;
+}, steps: PushApplySteps): Promise<"applied" | "synced">;
+/** The one call {@link applyPoliciesFile} needs from a connection. */
+export interface PolicyConnection {
+    query(text: string): Promise<unknown>;
+}
+/** What {@link applyPoliciesFile} stamps, and how to read the definitions back. */
+export interface PolicyStamping {
+    /**
+     * `policyStampSql` of every table whose policies `policies.sql` creates
+     * exactly as the boot would — see {@link stampableTables}.
+     */
+    statements: string[];
+    /**
+     * The `search_path` a boot reads policies under, when the connection's own
+     * differs. A stamp hashes `pg_get_expr`, which spells a function on the
+     * path unqualified: read under `"$user", public` with a `rebase` role, the
+     * boot's `rebase.uid()` prints as `uid()` and no stamp would ever match.
+     */
+    searchPath?: string;
+}
+/**
+ * The tables whose stamp `db push` may write: those every one of whose planned
+ * statements `policies.sql` carries, verbatim.
+ *
+ * A stamp says "this stored definition is what the plan's statement made". It
+ * is only true of a policy the statement *did* make — and since both are
+ * rendered by the same function from the same collections, a table whose
+ * statements are all in the file is one whose policies the file just created.
+ * Anything else (a hand-edited file, a file generated elsewhere) is not
+ * stamped, and the next boot re-applies that table, as before.
+ */
+export declare function stampableTables<T extends {
+    policyStatements: string[];
+}>(plans: readonly T[], policiesSql: string): T[];
+/**
+ * Run `policies.sql`, then stamp the policies it created the way a boot does,
+ * in the same transaction.
+ *
+ * Before stamps the push's policies carried none, so the first boot after
+ * every push re-applied them all — a DROP and a CREATE per policy, an ACCESS
+ * EXCLUSIVE lock per table. Stamped here, that boot finds them current.
+ *
+ * The file runs in one transaction, as it did as one implicit one: a policy
+ * that fails leaves the previous ones in place. The stamps run after it, under
+ * a savepoint: a stamp that cannot be written costs the next boot a re-apply,
+ * which is what it did before, so it is reported and the policies are kept.
+ * Nothing is left set on the connection: `SET LOCAL` ends with the transaction.
+ */
+export declare function applyPoliciesFile(client: PolicyConnection, policiesSql: string, stamping: PolicyStamping): Promise<{
+    stamped: number;
+    stampError?: string;
+}>;

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

@@ -8,11 +8,16 @@
  * `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.
+ * It is dropped on every way out of the command: success, a destructive push
+ * the user declined or that had no terminal to ask, and a crash. A crash that
+ * kept it left it for good, because the next push finds it already there and
+ * takes it for one made by hand.
+ *
+ * Two cases keep it. An Atlas run that failed against it leaves the state Atlas
+ * was planning, 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. */
@@ -22,13 +27,33 @@ export interface ScratchDatabaseOps {
 export declare class ScratchDatabase {
     private readonly ops;
     private created;
+    private keptAsEvidence;
     constructor(ops: ScratchDatabaseOps);
     /** Make sure it exists before an Atlas call that plans against it. */
     ensure(databaseUrl: string, devDatabaseUrl: string): Promise<void>;
+    /** An Atlas run against it failed: keep it, whatever the command does next. */
+    keepAsEvidence(): 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.
+     * Run a command, then drop the scratch database if the command created it,
+     * whether the command returned or threw. A throw after
+     * {@link keepAsEvidence} keeps it. A command that wants to stop with exit 1
+     * throws {@link CommandStopped} rather than calling `process.exit`, which
+     * would skip this.
      */
     around<T>(command: () => Promise<T>): Promise<T>;
+    /** Drop it now if this process created it. Safe to call twice. */
+    release(): Promise<void>;
+}
+/**
+ * A db command stopping with exit 1 after it has said why: a destructive push
+ * the user declined, or one with no terminal to ask on.
+ *
+ * Thrown instead of `process.exit(1)`, so it unwinds through
+ * {@link ScratchDatabase.around} and the scratch database is dropped on the way
+ * out. `alreadyReported` tells `reportCommandFailure` the explanation is on the
+ * terminal already; the entry point sets the exit code.
+ */
+export declare class CommandStopped extends Error {
+    readonly alreadyReported = true;
+    constructor(reason: string);
 }