better-supabase 0.9.0 → 0.11.0

package/schemas/config-v1.json

@@ -565,9 +565,9 @@
               "values": {
                 "type": "object",
                 "additionalProperties": {
-                  "type": "string"
+                  "$ref": "#/$defs/triggerValue"
                 },
-                "description": "The column per placeholder. Defaults to the placeholder in snake_case."
+                "description": "The column or lookup per placeholder. Defaults to the placeholder in snake_case. A row whose topic comes out null is not sent to it."
               },
               "events": {
                 "type": "array",
@@ -577,19 +577,104 @@
                 }
               },
               "event": {
-                "type": "string",
-                "description": "The broadcast event name. Defaults to the operation."
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "insert": {
+                        "type": "string"
+                      },
+                      "update": {
+                        "type": "string"
+                      },
+                      "delete": {
+                        "type": "string"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ],
+                "description": "The broadcast event name, or one per operation ({ insert, update, delete }). Defaults to the operation."
               },
               "payload": {
-                "enum": ["keys", "row"],
+                "anyOf": [
+                  {
+                    "enum": ["keys", "row"],
+                    "type": "string"
+                  },
+                  {
+                    "type": "object",
+                    "additionalProperties": {
+                      "anyOf": [
+                        {
+                          "$ref": "#/$defs/triggerValue"
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "sql": {
+                              "type": "string"
+                            }
+                          },
+                          "required": ["sql"],
+                          "additionalProperties": false
+                        }
+                      ]
+                    }
+                  }
+                ],
+                "description": "keys (default) sends the primary key and the placeholder values; row sends the whole row, which bypasses column grants. An object is the payload itself: each key is a column, a lookup, or { sql }, an expression on the row {row} (tg_op is the operation)."
+              },
+              "topics": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "topic": {
+                      "type": "string",
+                      "description": "The template of a topic `policies.from` exports."
+                    },
+                    "values": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "$ref": "#/$defs/triggerValue"
+                      },
+                      "description": "The column or lookup per placeholder. Defaults to the placeholder in snake_case."
+                    }
+                  },
+                  "required": ["topic"],
+                  "additionalProperties": false
+                },
+                "description": "More topics the row change goes to, each with its own values."
+              },
+              "functionSchema": {
                 "type": "string",
-                "description": "keys (default) sends the primary key and the placeholder values; row sends the whole row, which bypasses column grants."
+                "description": "Schema for a generated function. Defaults to better_supabase, which the Data API does not expose."
+              },
+              "when": {
+                "type": "object",
+                "properties": {
+                  "changed": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "minItems": 1,
+                    "description": "Columns (database names) whose change lets an UPDATE send. A trigger for updates alone compiles it into its WHEN clause."
+                  }
+                },
+                "required": ["changed"],
+                "additionalProperties": false,
+                "description": "Filters updates: with { changed: [columns] } an UPDATE sends only when one of those columns changed. Inserts and deletes always send."
               }
             },
             "required": ["topic", "table"],
             "additionalProperties": false
           },
-          "description": "Broadcast triggers `sql sync` writes to `policies.output`: each calls better_supabase.broadcast_topic() (the realtime-tables module) for a topic `policies.from` exports."
+          "description": "Broadcast triggers `sql sync` writes to `policies.output` through the topic's trigger(), for topics `policies.from` exports. One topic with column values, a keys or row payload and one event name calls better_supabase.broadcast_topic() (the realtime-tables module); any other trigger gets a generated function."
         }
       },
       "additionalProperties": false,
@@ -1293,6 +1378,22 @@
             "required": ["column"],
             "additionalProperties": false,
             "description": "The rank key column and the column it is grouped by, for `move()`."
+          },
+          "versions": {
+            "type": "object",
+            "properties": {
+              "columns": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "auto": {
+                "type": "boolean"
+              }
+            },
+            "required": ["columns", "auto"],
+            "additionalProperties": false
           }
         },
         "required": ["table"],
@@ -1417,6 +1518,10 @@
                 "identity": {
                   "type": "boolean",
                   "description": "An integer or bigint the database numbers (generated by default as identity)."
+                },
+                "access": {
+                  "enum": ["read", "server"],
+                  "type": "string"
                 }
               },
               "required": ["type"],
@@ -1516,6 +1621,28 @@
               "softDelete": {
                 "type": "boolean",
                 "description": "Adds a deleted_at column that blocks treat as the soft-delete time."
+              },
+              "versions": {
+                "anyOf": [
+                  {
+                    "const": true
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "columns": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "auto": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ]
               }
             },
             "required": ["type"],
@@ -1581,6 +1708,32 @@
               "additionalProperties": false
             },
             "description": "Columns of public.<table>_view read from the row a reference points at (ADR 0044)."
+          },
+          "events": {
+            "anyOf": [
+              {
+                "const": true
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "on": {
+                    "type": "array",
+                    "items": {
+                      "enum": ["created", "updated", "deleted"],
+                      "type": "string"
+                    }
+                  },
+                  "include": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "additionalProperties": false
+              }
+            ]
           }
         },
         "additionalProperties": false
@@ -1696,6 +1849,7 @@
               "updated-at",
               "usage",
               "vector-search",
+              "vercel-marketplace",
               "versions",
               "waitlist",
               "webhook-inbox",
@@ -2018,6 +2172,9 @@
             "vector-search": {
               "$ref": "#/$defs/blocks/vector-search"
             },
+            "vercel-marketplace": {
+              "$ref": "#/$defs/blocks/vercel-marketplace"
+            },
             "versions": {
               "$ref": "#/$defs/blocks/versions"
             },
@@ -2231,6 +2388,15 @@
         },
         "claimsLimit": {
           "type": "number"
+        },
+        "migrationSafety": {
+          "type": "object",
+          "properties": {
+            "since": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
         }
       },
       "additionalProperties": false
@@ -2861,6 +3027,33 @@
       "pattern": "^(?:select|insert|update|delete|(?:select|insert|update)\\s*\\(\\s*(?:[a-z_][a-z0-9_$]*(?:\\s*,\\s*[a-z_][a-z0-9_$]*)*|\\*(?:\\s*,\\s*-\\s*[a-z_][a-z0-9_$]*)*)\\s*\\))$",
       "description": "select, insert, update or delete, a column privilege such as `update(title, body)`, or every declared column but some, such as `select(*, -token_hash)`."
     },
+    "triggerValue": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "from": {
+              "type": "string"
+            },
+            "via": {
+              "$ref": "#/$defs/triggerValue"
+            },
+            "select": {
+              "type": "string"
+            },
+            "key": {
+              "type": "string"
+            }
+          },
+          "required": ["from", "via", "select"],
+          "additionalProperties": false
+        }
+      ],
+      "description": "A column of the changed row, or a lookup: the `select` column of the `from` row (`table` or `schema.table`) whose `key` (default id) equals `via`, a column or another lookup."
+    },
     "blocks": {
       "access": {
         "$ref": "#/$defs/accessBlock",
@@ -3254,7 +3447,11 @@
                 "default": []
               },
               "plans": {},
-              "tenantKey": {}
+              "tenantKey": {},
+              "subscriptions": {
+                "type": "string",
+                "default": "sync-engine"
+              }
             }
           }
         }
@@ -4061,7 +4258,11 @@
           "options": {
             "type": "object",
             "additionalProperties": false,
-            "properties": {}
+            "properties": {
+              "clientIdPattern": {
+                "type": "string"
+              }
+            }
           }
         }
       },
@@ -4932,6 +5133,22 @@
           }
         }
       },
+      "vercel-marketplace": {
+        "$ref": "#/$defs/moduleConfig",
+        "type": "object",
+        "properties": {
+          "options": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "currency": {
+                "type": "string",
+                "default": "usd"
+              }
+            }
+          }
+        }
+      },
       "versions": {
         "$ref": "#/$defs/moduleConfig",
         "type": "object",

package/schemas/doctor-report-v1.json

@@ -77,6 +77,12 @@
               "BS226",
               "BS227",
               "BS228",
+              "BS229",
+              "BS230",
+              "BS231",
+              "BS232",
+              "BS233",
+              "BS234",
               "BS301",
               "BS302",
               "BS303",
@@ -118,6 +124,10 @@
               "BS339",
               "BS340",
               "BS341",
+              "BS342",
+              "BS343",
+              "BS344",
+              "BS345",
               "BS401",
               "BS402",
               "BS403",

package/schemas/snapshot-v2.json

@@ -1313,6 +1313,10 @@
         "large": {
           "description": "Postgres estimates at least 10,000 rows; the unbounded-read lint rule reads it.",
           "const": true
+        },
+        "partitionOf": {
+          "description": "The partitioned parent as schema.name, for a partition. Absent for other tables and in older snapshots.",
+          "type": "string"
         }
       }
     }

package/skills/better-supabase/SKILL.md

@@ -162,6 +162,7 @@ const customers = result.data;
 - `--json` prints one envelope on stdout: `status`, the result under `data`, Problem Details with a `code` under `error`, and the commands to run under `next`. `--yes` and `CI` turn prompts off.
 - Exit codes: 0 success, 1 a failure or finding (`--check` drift, doctor errors), 2 a usage, config or environment problem, 3 when the user has to act. Each error code is listed at https://bettersupabase.com/docs/cli/errors.
 - When the CLI detects an agent it prints JSON and never prompts. Exit code 3 with `input_required` lists `missing` flags and their `choices`; run the `next` command with the value filled in. `consent_required` means the user must agree first (`--force` over their files, `seed --apply` on a remote database): ask them, then run the `next` command with its `--confirm` token. Never pass `--confirm` without asking. See https://bettersupabase.com/docs/cli/agent-mode.
+- `better-supabase mcp` serves the same commands as MCP tools on stdio, read-only unless started with `--allow-writes`. A write tool first returns `consent_required` with a `token`; ask the user, then call it again with the same arguments and `confirm` set to the token. See https://bettersupabase.com/docs/cli/mcp.
 
 ## Don't