@supabase/pg-delta 0.0.0 → 1.0.0-alpha.1

package/dist/core/objects/procedure/utils.js

@@ -0,0 +1,55 @@
+/**
+ * Format function arguments for CREATE/DROP FUNCTION statements.
+ *
+ * @param argNames - Array of argument names (can be null)
+ * @param argTypes - Array of argument types (required)
+ * @param argModes - Array of argument modes (can be null)
+ * @returns Formatted argument string
+ */
+export function formatFunctionArguments(argNames, argTypes, argModes) {
+    const names = argNames ?? [];
+    const types = argTypes ?? [];
+    const modes = argModes ?? [];
+    if (types.length === 0) {
+        return "";
+    }
+    const modeMap = {
+        i: "IN",
+        o: "OUT",
+        b: "INOUT",
+        v: "VARIADIC",
+        t: "TABLE",
+    };
+    return types
+        .map((type, i) => {
+        const name = names[i] ?? ""; // already quoted in model, if present
+        const mode = modes[i] ? modeMap[modes[i]] : "";
+        const parts = [];
+        if (mode)
+            parts.push(mode);
+        if (name)
+            parts.push(name);
+        parts.push(type);
+        return parts.join(" ");
+    })
+        .join(", ");
+}
+/**
+ * Format a GUC value for SET ... TO ... in function/procedure definitions.
+ * Applies quoting rules consistent with PostgreSQL docs and psql style.
+ */
+export function formatConfigValue(key, rawValue) {
+    const value = rawValue.trim();
+    if (value.length === 0)
+        return value;
+    const lowerKey = key.toLowerCase();
+    if (value.startsWith("'") && value.endsWith("'"))
+        return value;
+    if (/^(true|false|on|off)$/i.test(value))
+        return value.toLowerCase();
+    if (/^-?\d+(?:\.\d+)?$/.test(value))
+        return value;
+    if (lowerKey === "search_path" || value.includes(","))
+        return value;
+    return `'${value.replace(/'/g, "''")}'`;
+}

package/dist/core/objects/publication/changes/publication.alter.d.ts

@@ -0,0 +1,88 @@
+import type { Publication, PublicationTableProps } from "../publication.model.ts";
+import { AlterPublicationChange } from "./publication.base.ts";
+export declare class AlterPublicationSetOptions extends AlterPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    private readonly setPublish;
+    private readonly setPublishViaPartitionRoot;
+    constructor(props: {
+        publication: Publication;
+        setPublish: boolean;
+        setPublishViaPartitionRoot: boolean;
+    });
+    get requires(): `publication:${string}`[];
+    serialize(): string;
+}
+export declare class AlterPublicationSetForAllTables extends AlterPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    constructor(props: {
+        publication: Publication;
+    });
+    get requires(): `publication:${string}`[];
+    serialize(): string;
+}
+export declare class AlterPublicationSetList extends AlterPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    constructor(props: {
+        publication: Publication;
+    });
+    get requires(): string[];
+    serialize(): string;
+}
+export declare class AlterPublicationAddTables extends AlterPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    private readonly tables;
+    constructor(props: {
+        publication: Publication;
+        tables: PublicationTableProps[];
+    });
+    get requires(): string[];
+    serialize(): string;
+}
+export declare class AlterPublicationDropTables extends AlterPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    private readonly tables;
+    constructor(props: {
+        publication: Publication;
+        tables: PublicationTableProps[];
+    });
+    get requires(): string[];
+    serialize(): string;
+}
+export declare class AlterPublicationAddSchemas extends AlterPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    private readonly schemas;
+    constructor(props: {
+        publication: Publication;
+        schemas: string[];
+    });
+    get requires(): (`schema:${string}` | `publication:${string}`)[];
+    serialize(): string;
+}
+export declare class AlterPublicationDropSchemas extends AlterPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    private readonly schemas;
+    constructor(props: {
+        publication: Publication;
+        schemas: string[];
+    });
+    get requires(): (`schema:${string}` | `publication:${string}`)[];
+    serialize(): string;
+}
+export declare class AlterPublicationSetOwner extends AlterPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    private readonly owner;
+    constructor(props: {
+        publication: Publication;
+        owner: string;
+    });
+    get requires(): (`role:${string}` | `publication:${string}`)[];
+    serialize(): string;
+}

package/dist/core/objects/publication/changes/publication.alter.js

@@ -0,0 +1,176 @@
+import { stableId } from "../../utils.js";
+import { formatPublicationObjects, formatPublicationTable, getPublicationOperations, } from "../utils.js";
+import { AlterPublicationChange } from "./publication.base.js";
+export class AlterPublicationSetOptions extends AlterPublicationChange {
+    publication;
+    scope = "object";
+    setPublish;
+    setPublishViaPartitionRoot;
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+        this.setPublish = props.setPublish;
+        this.setPublishViaPartitionRoot = props.setPublishViaPartitionRoot;
+    }
+    get requires() {
+        return [this.publication.stableId];
+    }
+    serialize() {
+        const assignments = [];
+        if (this.setPublish) {
+            const operations = getPublicationOperations(this.publication);
+            assignments.push(`publish = '${operations.join(", ")}'`);
+        }
+        if (this.setPublishViaPartitionRoot) {
+            assignments.push(`publish_via_partition_root = ${this.publication.publish_via_partition_root ? "true" : "false"}`);
+        }
+        return `ALTER PUBLICATION ${this.publication.name} SET (${assignments.join(", ")})`;
+    }
+}
+export class AlterPublicationSetForAllTables extends AlterPublicationChange {
+    publication;
+    scope = "object";
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+    }
+    get requires() {
+        return [this.publication.stableId];
+    }
+    serialize() {
+        return `ALTER PUBLICATION ${this.publication.name} SET FOR ALL TABLES`;
+    }
+}
+export class AlterPublicationSetList extends AlterPublicationChange {
+    publication;
+    scope = "object";
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+    }
+    get requires() {
+        const dependencies = new Set();
+        dependencies.add(this.publication.stableId);
+        for (const table of this.publication.tables) {
+            dependencies.add(stableId.table(table.schema, table.name));
+            if (table.columns) {
+                for (const column of table.columns) {
+                    dependencies.add(stableId.column(table.schema, table.name, column));
+                }
+            }
+        }
+        for (const schema of this.publication.schemas) {
+            dependencies.add(stableId.schema(schema));
+        }
+        return Array.from(dependencies);
+    }
+    serialize() {
+        const clauses = formatPublicationObjects(this.publication.tables, this.publication.schemas);
+        return `ALTER PUBLICATION ${this.publication.name} SET ${clauses.join(", ")}`;
+    }
+}
+export class AlterPublicationAddTables extends AlterPublicationChange {
+    publication;
+    scope = "object";
+    tables;
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+        this.tables = props.tables;
+    }
+    get requires() {
+        const dependencies = new Set();
+        dependencies.add(this.publication.stableId);
+        for (const table of this.tables) {
+            dependencies.add(stableId.table(table.schema, table.name));
+            if (table.columns) {
+                for (const column of table.columns) {
+                    dependencies.add(stableId.column(table.schema, table.name, column));
+                }
+            }
+        }
+        return Array.from(dependencies);
+    }
+    serialize() {
+        const clauses = this.tables.map((table) => formatPublicationTable(table));
+        return `ALTER PUBLICATION ${this.publication.name} ADD ${clauses.join(", ")}`;
+    }
+}
+export class AlterPublicationDropTables extends AlterPublicationChange {
+    publication;
+    scope = "object";
+    tables;
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+        this.tables = props.tables;
+    }
+    get requires() {
+        const dependencies = new Set();
+        dependencies.add(this.publication.stableId);
+        for (const table of this.tables) {
+            dependencies.add(stableId.table(table.schema, table.name));
+        }
+        return Array.from(dependencies);
+    }
+    serialize() {
+        const targets = this.tables.map((table) => `${table.schema}.${table.name}`);
+        return `ALTER PUBLICATION ${this.publication.name} DROP TABLE ${targets.join(", ")}`;
+    }
+}
+export class AlterPublicationAddSchemas extends AlterPublicationChange {
+    publication;
+    scope = "object";
+    schemas;
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+        this.schemas = props.schemas;
+    }
+    get requires() {
+        return [
+            this.publication.stableId,
+            ...this.schemas.map((schema) => stableId.schema(schema)),
+        ];
+    }
+    serialize() {
+        const clauses = this.schemas.map((schema) => `TABLES IN SCHEMA ${schema}`);
+        return `ALTER PUBLICATION ${this.publication.name} ADD ${clauses.join(", ")}`;
+    }
+}
+export class AlterPublicationDropSchemas extends AlterPublicationChange {
+    publication;
+    scope = "object";
+    schemas;
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+        this.schemas = props.schemas;
+    }
+    get requires() {
+        return [
+            this.publication.stableId,
+            ...this.schemas.map((schema) => stableId.schema(schema)),
+        ];
+    }
+    serialize() {
+        const clauses = this.schemas.map((schema) => `TABLES IN SCHEMA ${schema}`);
+        return `ALTER PUBLICATION ${this.publication.name} DROP ${clauses.join(", ")}`;
+    }
+}
+export class AlterPublicationSetOwner extends AlterPublicationChange {
+    publication;
+    scope = "object";
+    owner;
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+        this.owner = props.owner;
+    }
+    get requires() {
+        return [this.publication.stableId, stableId.role(this.owner)];
+    }
+    serialize() {
+        return `ALTER PUBLICATION ${this.publication.name} OWNER TO ${this.owner}`;
+    }
+}

package/dist/core/objects/publication/changes/publication.base.d.ts

@@ -0,0 +1,17 @@
+import { BaseChange } from "../../base.change.ts";
+import type { Publication } from "../publication.model.ts";
+declare abstract class BasePublicationChange extends BaseChange {
+    abstract readonly publication: Publication;
+    abstract readonly scope: "object" | "comment";
+    readonly objectType: "publication";
+}
+export declare abstract class CreatePublicationChange extends BasePublicationChange {
+    readonly operation: "create";
+}
+export declare abstract class AlterPublicationChange extends BasePublicationChange {
+    readonly operation: "alter";
+}
+export declare abstract class DropPublicationChange extends BasePublicationChange {
+    readonly operation: "drop";
+}
+export {};

package/dist/core/objects/publication/changes/publication.base.js

@@ -0,0 +1,13 @@
+import { BaseChange } from "../../base.change.js";
+class BasePublicationChange extends BaseChange {
+    objectType = "publication";
+}
+export class CreatePublicationChange extends BasePublicationChange {
+    operation = "create";
+}
+export class AlterPublicationChange extends BasePublicationChange {
+    operation = "alter";
+}
+export class DropPublicationChange extends BasePublicationChange {
+    operation = "drop";
+}

package/dist/core/objects/publication/changes/publication.comment.d.ts

@@ -0,0 +1,23 @@
+import type { Publication } from "../publication.model.ts";
+import { CreatePublicationChange, DropPublicationChange } from "./publication.base.ts";
+export type CommentPublication = CreateCommentOnPublication | DropCommentOnPublication;
+export declare class CreateCommentOnPublication extends CreatePublicationChange {
+    readonly publication: Publication;
+    readonly scope: "comment";
+    constructor(props: {
+        publication: Publication;
+    });
+    get creates(): `comment:${string}`[];
+    get requires(): `publication:${string}`[];
+    serialize(): string;
+}
+export declare class DropCommentOnPublication extends DropPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "comment";
+    constructor(props: {
+        publication: Publication;
+    });
+    get drops(): `comment:${string}`[];
+    get requires(): (`comment:${string}` | `publication:${string}`)[];
+    serialize(): string;
+}

package/dist/core/objects/publication/changes/publication.comment.js

@@ -0,0 +1,46 @@
+import { quoteLiteral } from "../../base.change.js";
+import { stableId } from "../../utils.js";
+import { CreatePublicationChange, DropPublicationChange, } from "./publication.base.js";
+export class CreateCommentOnPublication extends CreatePublicationChange {
+    publication;
+    scope = "comment";
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+    }
+    get creates() {
+        return [stableId.comment(this.publication.stableId)];
+    }
+    get requires() {
+        return [this.publication.stableId];
+    }
+    serialize() {
+        return [
+            "COMMENT ON PUBLICATION",
+            this.publication.name,
+            "IS",
+            // biome-ignore lint/style/noNonNullAssertion: comment ensured non-null by caller
+            quoteLiteral(this.publication.comment),
+        ].join(" ");
+    }
+}
+export class DropCommentOnPublication extends DropPublicationChange {
+    publication;
+    scope = "comment";
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+    }
+    get drops() {
+        return [stableId.comment(this.publication.stableId)];
+    }
+    get requires() {
+        return [
+            stableId.comment(this.publication.stableId),
+            this.publication.stableId,
+        ];
+    }
+    serialize() {
+        return `COMMENT ON PUBLICATION ${this.publication.name} IS NULL`;
+    }
+}

package/dist/core/objects/publication/changes/publication.create.d.ts

@@ -0,0 +1,17 @@
+import type { Publication } from "../publication.model.ts";
+import { CreatePublicationChange } from "./publication.base.ts";
+/**
+ * Create a logical replication publication.
+ *
+ * @see https://www.postgresql.org/docs/17/sql-createpublication.html
+ */
+export declare class CreatePublication extends CreatePublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    constructor(props: {
+        publication: Publication;
+    });
+    get creates(): `publication:${string}`[];
+    get requires(): string[];
+    serialize(): string;
+}

package/dist/core/objects/publication/changes/publication.create.js

@@ -0,0 +1,61 @@
+import { stableId } from "../../utils.js";
+import { formatPublicationObjects, getPublicationOperations, isDefaultPublicationOperations, } from "../utils.js";
+import { CreatePublicationChange } from "./publication.base.js";
+/**
+ * Create a logical replication publication.
+ *
+ * @see https://www.postgresql.org/docs/17/sql-createpublication.html
+ */
+export class CreatePublication extends CreatePublicationChange {
+    publication;
+    scope = "object";
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+    }
+    get creates() {
+        return [this.publication.stableId];
+    }
+    get requires() {
+        const dependencies = new Set();
+        dependencies.add(stableId.role(this.publication.owner));
+        if (!this.publication.all_tables) {
+            for (const table of this.publication.tables) {
+                dependencies.add(stableId.table(table.schema, table.name));
+                if (table.columns) {
+                    for (const column of table.columns) {
+                        dependencies.add(stableId.column(table.schema, table.name, column));
+                    }
+                }
+            }
+            for (const schema of this.publication.schemas) {
+                dependencies.add(stableId.schema(schema));
+            }
+        }
+        return Array.from(dependencies);
+    }
+    serialize() {
+        const parts = ["CREATE PUBLICATION", this.publication.name];
+        if (this.publication.all_tables) {
+            parts.push("FOR ALL TABLES");
+        }
+        else {
+            const objectClauses = formatPublicationObjects(this.publication.tables, this.publication.schemas);
+            if (objectClauses.length > 0) {
+                parts.push("FOR", objectClauses.join(", "));
+            }
+        }
+        const options = [];
+        if (!isDefaultPublicationOperations(this.publication)) {
+            const operations = getPublicationOperations(this.publication);
+            options.push(`publish = '${operations.join(", ")}'`);
+        }
+        if (this.publication.publish_via_partition_root) {
+            options.push("publish_via_partition_root = true");
+        }
+        if (options.length > 0) {
+            parts.push("WITH", `(${options.join(", ")})`);
+        }
+        return parts.join(" ");
+    }
+}

package/dist/core/objects/publication/changes/publication.drop.d.ts

@@ -0,0 +1,17 @@
+import type { Publication } from "../publication.model.ts";
+import { DropPublicationChange } from "./publication.base.ts";
+/**
+ * Drop a logical replication publication.
+ *
+ * @see https://www.postgresql.org/docs/17/sql-droppublication.html
+ */
+export declare class DropPublication extends DropPublicationChange {
+    readonly publication: Publication;
+    readonly scope: "object";
+    constructor(props: {
+        publication: Publication;
+    });
+    get drops(): `publication:${string}`[];
+    get requires(): `publication:${string}`[];
+    serialize(): string;
+}

package/dist/core/objects/publication/changes/publication.drop.js

@@ -0,0 +1,23 @@
+import { DropPublicationChange } from "./publication.base.js";
+/**
+ * Drop a logical replication publication.
+ *
+ * @see https://www.postgresql.org/docs/17/sql-droppublication.html
+ */
+export class DropPublication extends DropPublicationChange {
+    publication;
+    scope = "object";
+    constructor(props) {
+        super();
+        this.publication = props.publication;
+    }
+    get drops() {
+        return [this.publication.stableId];
+    }
+    get requires() {
+        return [this.publication.stableId];
+    }
+    serialize() {
+        return `DROP PUBLICATION ${this.publication.name}`;
+    }
+}

package/dist/core/objects/publication/changes/publication.types.d.ts

@@ -0,0 +1,5 @@
+import type { AlterPublicationAddSchemas, AlterPublicationAddTables, AlterPublicationDropSchemas, AlterPublicationDropTables, AlterPublicationSetForAllTables, AlterPublicationSetList, AlterPublicationSetOptions, AlterPublicationSetOwner } from "./publication.alter.ts";
+import type { CommentPublication } from "./publication.comment.ts";
+import type { CreatePublication } from "./publication.create.ts";
+import type { DropPublication } from "./publication.drop.ts";
+export type PublicationChange = AlterPublicationAddSchemas | AlterPublicationAddTables | AlterPublicationDropSchemas | AlterPublicationDropTables | AlterPublicationSetForAllTables | AlterPublicationSetList | AlterPublicationSetOptions | AlterPublicationSetOwner | CommentPublication | CreatePublication | DropPublication;

package/dist/core/objects/publication/changes/publication.types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/objects/publication/publication.diff.d.ts

@@ -0,0 +1,5 @@
+import type { PublicationChange } from "./changes/publication.types.ts";
+import type { Publication } from "./publication.model.ts";
+export declare function diffPublications(ctx: {
+    currentUser: string;
+}, main: Record<string, Publication>, branch: Record<string, Publication>): PublicationChange[];