Upgrading
Upgrade von 0.30 auf 0.31
Upgrade von 0.30 → 0.31
Abschnitt betitelt „Upgrade von 0.30 → 0.31“0.31 macht das Backend Postgres-first. Die Tabellen, die Sie mit defineTable in backend/schema/ deklarieren, sind das Einzige, was das Backend über Ihre Daten weiß; was das Admin-Panel darüber hinaus anzeigt, liegt im Frontend. Fast jeder Eintrag unten ist eine Folge dieser Trennung, und fast alles wird durch einen einzigen Befehl für Sie erledigt.
Die Checkliste pro Projekt
Abschnitt betitelt „Die Checkliste pro Projekt“-
Aktualisieren Sie zuerst jedes
@rebasepro-Paket in jedem Workspace-Paket, damit die Typen, die der Codemod liest, denen von 0.31 entsprechen:pnpm -r up "@rebasepro/*@0.31.0", dannpnpm install. Ein Projekt auf einer Version vor 0.30 wendet zuerst die Codeänderungen der Leitfäden dazwischen an (Upgrades) und erfüllt die Mindestanforderungen der Toolchain von 0.31 – Node 22.22, TypeScript 6, React 19.2.7, React Router 8, Vite 8 (die Liste): Der Codemod lädt einconfig/aus 0.20–0.29 und seine SQL-Prüfung besteht, aber diese Prüfung vergleicht den 0.31-Compiler mit sich selbst – erst Schritt 7 gegen Ihre Datenbank beweist, dass das generierte DDL dem entspricht, was Ihre Datenbank enthält. -
Committen Sie, führen Sie dann den Codemod als Testlauf aus:
rebase migrate collections-to-tables --dry-run. Er gibt die Dateien aus, die er schreiben würde, was er ablehnt (mit Datei und Zeile), die Hinweise und die manuellen Schritte und schreibt nichts. Beheben Sie zuerst inconfig/, was er ablehnt. -
Führen Sie ihn echt aus:
rebase migrate collections-to-tables. Er schreibtbackend/schema/,frontend/src/cms/(mitui-config.json), diebackend/-Module und die Projektdateien, fügtrebaseBackendGuard()zurvite.config.tsdes Scaffolds hinzu, schreibt Ihre SDK-Aufrufe um, verschiebt die Importe von Namen, die 0.31 in ein anderes Paket verschoben hat (Abschnitt 135), und beweist, dass das generierte SQL Byte für Byte identisch ist – oder stellt jede Datei wieder her. Siehe Abschnitt 108. -
Lesen Sie den letzten Abschnitt seiner Ausgabe, „Review before deploying: these rules change meaning“, und entscheiden Sie über jede dort aufgeführte Regel (unten).
-
Führen Sie die ausgegebenen manuellen Schritte der Reihe nach durch. Jeder nennt seine Datei, und die meisten enthalten das zu schreibende Snippet: den
<RebaseCMS>-Mount mittableCustomizationsunduiConfig, wenn IhreApp.tsxnicht die des Scaffolds ist (oder das Panel in einem anderen Modul gemountet ist, das der Schritt nennt),rebaseBackendGuard(), wenn es Ihrevite.config.tsnicht ist und in jeder anderen statischen App ausrebase.json(Abschnitt 130), globale Hooks, einen Import eines von 0.31 entfernten Namens (Abschnitt 135) undrebase skills install, wenn das Projekt Agent-Skills enthält (Abschnitt 128). Führen Siepnpm installaus, wenn die Ausgabe „Dependencies added“ auflistet. Lesen Sie dann zwei Listen im SDK-Teil der Ausgabe:- „Rewritten by name — review“:
.collection(-Aufrufe auf einem Receiver ohne Typ (any), umgeschrieben, weil der ReceiverdataAsAdminheißt oder.datamit einem literalen Tabellennamen ist; dascollection-Member eines Typs, den eindata- /dataAsAdmin-Slot enthält; und Test-Doubles. Prüfen Sie bei jedem, ob es sich um das SDK handelt. - „Left unchanged — check each“:
.collection(-Aufrufe, bei denen der Codemod nicht nachweisen konnte, dass es sich um das SDK handelt, wie etwa ein Aufruf über einen Typ, den Ihr Projekt selbst deklariert. Ein Aufruf, der hier verbleibt und das SDK ist, schlägt unter 0.31 zur Laufzeit fehl: Benennen Sie ihn manuell in.table(um. Code, der prüft, obcollectionexistiert (typeof data.collection === "function"), ist ein manueller Schritt: Unter 0.31 nimmt er stillschweigend den anderen Zweig.
Eine als Build-Ausgabe committete Datei (ein gebündeltes oder minifiziertes
.js) wird niemals bearbeitet: Sie wird aufgelistet, also bauen Sie sie nach der Migration neu und ersetzen Sie eine vendorte Kopie des Clients durch den 0.31-Build. Wiederholte Schritte gleicher Art werden einmal ausgegeben und listen jede betroffene Datei und Zeile auf;--jsongibt jeden Schritt separat aus. Lesen Sie dann Was Projekte manuell geändert haben: die Anpassungen, die reale Projekte nach diesen Schritten noch manuell vorgenommen haben. - „Rewritten by name — review“:
-
Führen Sie die vom Codemod ausgegebene
git rm-Zeile aus, sobald das Diff überprüft wurde undrebase migrate collections-to-tables --checkerfolgreich durchläuft:git rm -r config/collections …und die Verdrahtung, die nachbackend/verschoben wurde, odergit rm -r config, wenn dort nichts Eigenes mehr verbleibt (Abschnitt 109). Die nächsten drei Schritte setzen dies voraus:generate-sdk,db push,doctorundverifyverweigern die Ausführung bei einem Projekt, das nochconfig/collectionsenthält. -
rebase generate-sdk– die Namen des generierten Moduls haben sich geändert (Abschnitt 115). -
Führen Sie gegen Ihre Datenbank
rebase db push --dry-runaus und erwarten Sie „No changes: the database already matches these tables.“, dannrebase doctor --policiesund erwarten Sie keinen Policy-Drift. Die SQL-Prüfung des Codemods beweist die Korrektheit der Konvertierung; diese beiden Befehle prüfen sie gegen die reale Datenbank, und jeder aufgelistete Policy-Unterschied ist eine Änderung daran, wer worauf zugreifen kann. -
rebase verify– liest nun auchfrontend/src/cms: eine Anpassung, die eine nicht existierende Tabelle oder ein nicht existierendes Feld benennt, eine erforderliche Spalte, die im Formular weggelassen wurde, ein fehlenderrebaseBackendGuard(), eine nicht an<RebaseCMS>übergebeneui-config.json. -
Neu bauen und deployen. Ein vor 0.31 erstelltes Bundle startet auf einer 0.31-Runtime nicht (Abschnitt 112). Der erste Start aktualisiert den Schema-Versionsstempel der Datenbank einmalig (Abschnitt 113).
Führen Sie rebase migrate collections-to-tables --check in der CI aus, bis config/ entfernt ist: Dies verifiziert, dass die migrierten Tabellen immer noch dasselbe SQL rendern wie die Collections, aus denen sie hervorgegangen sind, und beendet mit Exit-Code 1, solange eine unter „Review before deploying“ aufgeführte Regel nicht bestätigt wurde – übergeben Sie --accept-rule-changes, sobald Sie diese überprüft haben.
Vor dem Deployment prüfen: Diese Regeln ändern ihre Bedeutung
Abschnitt betitelt „Vor dem Deployment prüfen: Diese Regeln ändern ihre Bedeutung“Der Codemod übernimmt jede Sicherheitsregel unverändert, und jede behält ihren Policy-Namen. Da der 0.30-Compiler jedoch nur die erste gefundene Klausel aus condition, using, access: "public" und ownerField gelesen und keinen anderen access-Wert gekannt hat, gewähren vier Formen von Regeln nun andere Rechte. Zwei davon erweitern den Zugriff:
| Die Regel | 0.30 gewährte | 0.31 gewährt | |
|---|---|---|---|
ein reines access: "authenticated" (ohne roles) |
nichts | jedem angemeldeten Aufrufer, einschließlich Gästen | erweitert |
access + check, keine condition, auf select / update / delete / all |
keine vorhandene Zeile | jede vorhandene Zeile für die access-Aufrufer |
erweitert |
access: "authenticated" + condition |
jedem, der condition erfüllt |
nur angemeldeten Aufrufern, die sie erfüllen | schränkt ein |
access: "authenticated" + check, auf insert |
jedem, der eine passende Zeile einfügt | nur angemeldeten Aufrufern | schränkt ein |
Am häufigsten ist die erste. Schreiben Sie access: "registered", um nur Aufrufern mit einem Konto (keinen anonymen Gästen) Zugriff zu gewähren, oder entfernen Sie die Regel, um weiterhin nichts zu gewähren. access mit roles und eine condition als reines Objekt bedeuten weiterhin dasselbe wie zuvor und werden nicht aufgeführt.
Der Codemod verweigert auch Regeln, die der 0.31-Compiler ablehnt: solche, die Klauseln kombinieren, die der Typ SecurityRule ausschließt (access neben ownerField, using oder withCheck; ownerField neben using, withCheck, condition oder check; condition oder check neben using oder withCheck), sowie solche mit einem ungültigen Wert für access, mode, operation(s) oder roles – ein falsch geschriebenes "restrictive" wurde früher fälschlicherweise als permissiv kompiliert. Siehe Sicherheitsregeln.
Was sich sonst noch anders verhält
Abschnitt betitelt „Was sich sonst noch anders verhält“- Was
GET /api/schema/tableseiner Person mitteilt. Administratoren und Inhaber vonschema:readerhalten jede Tabelle. Jeder andere angemeldete Benutzer, einschließlich Gästen, erhält nur die Tabellen, die seine Rollen erreichen können, mit ausschließlich den Regeln, die auf ihn zutreffen können; Relationen zu anderen Tabellen werden verworfen und Hook-Flags vorenthalten. Ein Frontend, das die Beschreibung einer anderen Tabelle als regulärer Benutzer gelesen hat, erhält weniger;schemaTables: { persons: "all" }in den Backend-Optionen stellt die vollständige Beschreibung wieder her. Siehe Endpunkte. - Relationsnamen sind exakt, und Big-Integer-Fremdschlüssel sind Zahlen (Abschnitt 131).
- Die Historie wird maskiert ausgeliefert (Abschnitt 132).
- MCP-Tool-Namen und die View-Payload ändern sich gemeinsam für den gehosteten Konnektor und die Runtimes, die er erreicht (Abschnitt 122).
- Gezielt eingeschränkt. Audit-Stamps (
.onCreateNow()- /.onUpdateNow()-Spalten) werden standardmäßig aus den Spalten der Listenansicht des Panels ausgeblendet: Eine migrierte Liste, diecreated_atangezeigt hat, verliert diese Spalte, bis Siefields: { created_at: { hidden: false } }in dessencustomizeTableschreiben. Der Codemod verweigert mit Begründung Tupel-JSON-Arrays, einvector/binary/referenceinnerhalb einer Map,databaseIdauf einer Postgres-Collection,isId: "cuid", eine alleinigeisId-Relation unddisableDefaultPolicies: trueohne Regeln. Eine einspaltige Relation zu einer Tabelle mit einem zusammengesetzten Primärschlüssel wird abgelehnt (schreiben Sie sie mitrel.via()). OpenAPI-Tags stammen aus dem Slug, nicht aus dem Anzeigenamen.rebase schema introspectlässt Tabellen ohne Primärschlüssel aus und gibt den Grund an (ein Server, der die Datenbank introspektiert, liefert sie weiterhin aus). Ein Plain-View, derrolesdeklariert, führt zu einem Compiler-Fehler; der Codemod entfernt ihn mit einem Hinweis. - Was reale Projekte dennoch manuell geändert haben – Mindestanforderungen an die Toolchain,
({ entity })in Admin-Code, Includes einer umbenannten Relation, zur Laufzeit geänderte Collection-Objekte, SDK-Aufrufe auf untypisierten Receivern: Was Projekte manuell geändert haben. - Eine Wiederherstellung in einem anderen Cluster. Der Stempel der Standard-Admin-Policies hasht Rollen-OIDs; nach einem Dump oder Point-in-Time-Restore in einen anderen Cluster erstellt das erste
db pushoder der erste Start diese Policies einmalig neu – mit denselben Namen und demselben SQL.
Die Begrifflichkeiten
Abschnitt betitelt „Die Begrifflichkeiten“| Vorher | Jetzt | Wo „collection“ bleibt |
|---|---|---|
eine Collection in config/collections/ |
eine Tabelle (Table) in backend/schema/ (defineTable) |
— |
properties |
columns (col.*) und relations (rel.*) |
— |
securityRules, defaultSecurityRules |
rls (erforderlich), defaultRls |
— |
callbacks, Property.callbacks |
hooks, das .transform() einer Spalte |
— |
der admin-Block |
customizeTable in frontend/src/cms/ |
— |
data.collection(slug) |
data.table(slug) |
— |
| was das Admin-Panel darstellt | eine Collection: eine Tabelle in der Darstellung des Panels oder eine Firestore-Collection | das CMS: CollectionPanel, der Collection Editor, externalCollections |
108. Tables in backend/schema replace config/collections — run the codemod first
Abschnitt betitelt „108. Tables in backend/schema replace config/collections — run the codemod first“Wen dies betrifft: jedes Projekt mit einem config/collections/-Verzeichnis.
Was sich geändert hat: Das Backend liest nur noch backend/schema/index.ts und die von dort exportierten Ergebnisse von defineTable, defineAuthTable und defineView. defineCollection-Dateien werden von nichts mehr gelesen: Die Runtime, jeder CLI-Befehl und die Validierung von rebase.json verweigern die Ausführung bei einem Projekt, das noch config/collections enthält, und verweisen auf den unten stehenden Befehl. rls ist für jede Tabelle erforderlich – eine Liste von Regeln, "admin-only" oder "inherit" für das vom Index exportierte defaultRls – und disableDefaultPolicies heißt nun defaultPolicies: false.
Was zu tun ist:
rebase migrate collections-to-tables # or --dry-run firstEs wird eine Tabelle pro Collection geschrieben, jede physische Spalte explizit an ihrer ursprünglichen Position (sodass die Schlüsselspalte eines belongsTo ausgeschrieben wird), der Index mit defaultRls aus defaultSecurityRules, ein customizeTable für jede Collection, deren Darstellung nicht dem Standard entsprach, und defineFirestoreCollection-Dateien für Firestore-Collections. Die Callbacks einer Collection werden zu den hooks ihrer Tabelle und den .transform()-Methoden ihrer Spalten; die globalen callbacks, die config/index.ts exportiert hat, sind ein manueller Schritt (Abschnitt 109). Anschließend liest der Befehl das Ergebnis über die neue Pipeline ein: DDL, Policies, Search, Vector, Trigger, Views und das Drizzle-Schema müssen Byte für Byte identisch mit dem sein, was die Collections generiert haben, andernfalls wird jede Datei zurückgesetzt und der Durchlauf bricht mit Exit-Code 1 und dem Diff ab.
Er übernimmt auch Dinge, die früher manuelle Arbeit erforderten:
- Callbacks, die durch einen Helper erstellt wurden (
callbacks: softDeleteCallbacks(...)oder ein importiertes Callbacks-Objekt), werden zuhooks:mit demselben Ausdruck, und die Funktionen des Helpers werden dort, wo sie geschrieben sind, in Tabellen-Hook-Props umgewandelt (der Codemod folgt relativen Importen,consts, Eigenschaftszugriffen und einem einzelnenreturn). Wenn er dem Helper nicht folgen kann, nennt ein Schritt die zu prüfenden Hooks. - Ein Funktions-
storagePathmigriert zweigeteilt: Die Funktion wird zumstorage.pathder Anpassung, sodass das Panel weiterhin bestimmt, wohin ein Upload geht, und daspath-Template der Spalte entspricht der Form der Schlüssel, die sie zurückgibt – dem statischen Text ihres Template-Literals mit jedem${…}als{path}(`${owner}/cv`→{path}/cv). Der Server wendet nun die LimitsmaxBytesundacceptder Spalte auf jeden Upload an, dessen Schlüssel zu diesem Template passt, nicht nur auf solche, die die Spalte explizit benennen; die Limits sind somit strikter als unter 0.30. Eine Funktion, deren Ergebnis keinen statischen Text enthält, wird abgelehnt: Vergeben Sie vorher einen. - Ein 0.30
policy.existsIn({ collection })behält seine Tabelle, undauth: { collection: usersCollection }in einem benutzerdefinierten Backend-Einstiegspunkt wird verworfen (dasdefineAuthTableist die Auth-Tabelle). Einecollections-Boot-Option wird zuschemaDir. - Ein
dynamicProps-Builder gibt unter 0.31 eine Feldanpassung mit flachen Schlüsseln zurück ({ readOnly: true }, nicht{ admin: { readOnly: true } }). Der Codemod schreibt Builder um, deren Rückgaben Objektliterale sind, inline oder in einem geteilten Modul, und listet alle anderen auf. - Darstellungslogik, die aus einem geteilten Objekt per Spread eingefügt wurde, wird in die Anpassung übernommen (
….dynamicProps); Darstellung, die eine Wrapper-Funktion berechnet, ist ein zu überprüfender Schritt, führt aber nicht zur Ablehnung des Projekts. Ein Komponentenpfad wird relativ zu dem Modul aufgelöst, das ihn geschrieben hat, und ein Wert, der beim Laden vonconfig/berechnet wird (new Date(),Date.now(), ein Auslesen von Umgebungsvariablen), wird als dessen Ausdruck übernommen und niemals auf den Wert des Durchlaufs festgeschrieben. - Firestore-Collections, die von einer Funktion erzeugt werden (ein
getAllFirestoreCollections(), das die App in das Panel einfügt), werden einzeln indefineFirestoreCollectionkonvertiert, sofern die Datei einer Collection ihr Literal enthält; ein Schritt pro Builder nennt die restlichen und die zu schreibende Form, und ein weiterer nennt Referenzen außerhalb eines konvertierten Literals, die nochpathverwenden würden. - Importe von
config/über einen Pfad-Alias (einpaths-Eintrag in der tsconfig, einresolve.aliasin Vite) werden wie relative Importe umgeschrieben oder aufgelistet, und einstorageAuthorize, dasconfig/index.tsreexportiert, wird nachbackend/storage.tsübertragen. - Eine zu
<key>Relationumbenannte Relation behält ihr Label, ihre Listenspalte und ihren Titel: Die Anpassung benennt den neuen Schlüssel. Code, der sie per Include einbindet, wird nicht automatisch angepasst (was zu ändern ist).
Was nicht exakt übertragen werden kann, wird unter Angabe von Datei und Zeile abgelehnt und es wird nichts geschrieben: eine Collection, die durch Aufruf einer Funktion erstellt wurde, ein Spread oder Accessor, der nicht durchleuchtet werden kann, eine andere Engine als Postgres oder Firestore, eine Ausgabedatei, die bereits mit anderem Inhalt existiert (beiseite schieben oder --force nutzen). Ein unsauberer Git-Tree oder ein Projekt außerhalb von Git wird ebenfalls abgelehnt, damit die Migration ein einziges, überprüfbares Diff darstellt. --json gibt den vollständigen Bericht für ein Skript oder einen Agenten aus. Siehe rebase migrate und Tabellen.
Die generierten Tabellen definieren ihre Spalten so, wie es Drizzles pg-core tut – col.varchar({ length: 160 }), col.timestamp({ withTimezone: true }), col.text().array(), pgEnum(...), .default(sql`…`), .generatedByDefaultAsIdentity() – sodass die Ausgabe keine weiteren Anpassungen benötigt; siehe Spalten. Eine manuell gegen ein 0.31-Pre-Release in der früheren Schreibweise verfasste Tabelle (col.timestamptz(), col.varchar(160), col.array(col.text()), col.enum(values, { name }), .defaultSql(), .identity(), .column("…")) kompiliert nicht mehr: tooling/scripts/drizzle-sweep.mts im Rebase-Repository konvertiert sie, indem es nur die Builder-Chains umschreibt, und beweist mit --verify, dass jede konvertierte Tabelle zum selben Deskriptor kompiliert (npx tsx drizzle-sweep.mts --verify backend/schema).
Der darauffolgende Durchlauf sdk-calls schreibt auch Regelquellen um: existsIn({ collection }) und membership: { collection } werden zu table (Abschnitt 123); --skip-sdk-calls überspringt auch das. Was noch manuell zu tun ist, wird als nummerierte manuelle Schritte ausgegeben, und wenn das Projekt installierte Agent-Skills enthält, ist der letzte Schritt die rebase skills install-Zeile, die diese aktualisiert (Abschnitt 128). Ein einfaches rebase migrate gibt die Hilfe für beide Unterbefehle aus.
109. There is no config package
Abschnitt betitelt „109. There is no config package“Wen dies betrifft: jedes Projekt – config/ war ein eigener Workspace.
0.31 liest config/collections nicht mehr; es verbietet config/ jedoch nicht. Der Codemod entfernt, was Rebase gelesen hat – die Collection-Dateien und die Verdrahtung, die nach backend/ verschoben wird (resources.ts, storage.ts, generated/register.ts und deren Re-Exporte in config/index.ts) – und belässt Ihre eigenen Module in config/ an Ort und Stelle, importierbar wie zuvor: config/ bleibt ein Workspace-Paket, und das Backend kompiliert weiterhin ../config/**/*. Nur Importe von Elementen, die entfallen, werden umgeschrieben: Eine von Backend-Code importierte Collection-Datei verweist auf das Tabellenmodul (ein Schritt listet Verwendungen auf, die sie als Objekt lesen); wird sie von Frontend-Code importiert, wird sie zu einem reinen Typ-Import der Tabelle, sofern sie nur als Typ verwendet wird, oder zu einem Schritt, der die Anpassung benennt; ein Helper innerhalb von config/collections wird neben den Code kopiert, der ihn benötigt.
Was sich geändert hat: Was neben den Collections lag, wandert nach backend/:
| Vorher | Jetzt |
|---|---|
config/resources.ts |
backend/resources.ts |
config/storage.ts, storageAuthorize aus config/index.ts |
backend/storage.ts |
callbacks exportiert aus config/index.ts |
hooks exportiert aus backend/hooks.ts (TableHooks: table statt collection, values statt row) |
config/generated/register.ts |
backend/generated/register.ts |
rebase.json config, usersCollection |
tables (Standard backend/schema); die Auth-Tabelle ist die mit defineAuthTable deklarierte |
Die Runtime liest storageAuthorize und hooks und nichts anderes aus diesen Modulen; jeder andere Export wird beim Start gemeldet. Das Frontend importiert backend/** ausschließlich als Typen – pnpm check:frontend-backend-imports verweigert Wert-Importe, die Server-Code an den Browser ausliefern würden.
Was zu tun ist: Der Codemod verschiebt resources.ts, storage.ts sowie die Registrierung und schreibt rebase.json, package.json, pnpm-workspace.yaml und backend/tsconfig.json um. Die globalen callbacks sind ein ausgegebener manueller Schritt: Verschieben Sie sie manuell nach backend/hooks.ts und fügen Sie hooks.ts zum include von backend/tsconfig.json hinzu, damit tsc sie überprüft. Führen Sie danach die ausgegebene git rm-Zeile aus: git rm -r config/collections …, oder git rm -r config, falls nichts Eigenes mehr übrig ist.
110. Boot options and hooks name tables
Abschnitt betitelt „110. Boot options and hooks name tables“Wen dies betrifft: ein Backend, das Sie selbst starten (initializeRebaseBackend, createRebaseBackend), und Code, der Hooks nach dem Start anhängt.
Was sich geändert hat:
| Vorher | Jetzt |
|---|---|
collections, collectionsDir |
tables, defaultRls, schemaDir |
callbacks |
hooks |
auth.collection |
entfernt: das defineAuthTable in tables |
backend.setCollectionCallbacks(slug, cb) |
backend.setTableHooks(slug, hooks) |
Hook-Props collection, row |
table (der Deskriptor), values |
composeCallbacks |
composeTableHooks aus @rebasepro/common |
openRebase({ collections, callbacks }) |
openRebase({ tables, hooks }), tables aus compileSchema([...]) |
OpenedRebase.collections; die Variable collections in rebase console |
.tables; tables |
await initializeRebaseBackend({ app, server, collectionsDir: "./config/collections", callbacks });await initializeRebaseBackend({ app, server, schemaDir: path.resolve(__dirname, "../schema"), hooks });Hooks, die an ein an einer Aufrufstelle übergebenes Collection-Objekt angehängt wurden, werden nicht mehr ausgeführt: Der Treiber führt die Hooks der Tabellen aus, die er bedient; hängen Sie sie daher mit setTableHooks an.
Was zu tun ist: rebase migrate sdk-calls schreibt setCollectionCallbacks um, passt die Hook-Props an und listet jedes Backend-Optionsobjekt auf, das manuell aktualisiert werden muss. Ein Skript, das die Daten öffnet, kompiliert seine Tabellen:
const rebase = await openRebase({ databaseUrl, collections, callbacks });const rebase = await openRebase({ databaseUrl, tables: compileSchema([products, orders]), hooks });Siehe Skripte. Siehe Backend-Übersicht und Globale Hooks.
111. The admin panel renders the tables the server serves
Abschnitt betitelt „111. The admin panel renders the tables the server serves“Wen dies betrifft: jedes Frontend, das <RebaseCMS> einbindet.
Was sich geändert hat: <RebaseCMS collections> gibt es nicht mehr. Das Panel zeigt jede Tabelle an, die das Backend unter GET /api/schema/tables bereitstellt, ohne eine Datei pro Tabelle, gefolgt von externalCollections (Firestore). tableCustomizations nimmt die customizeTable-Objekte aus frontend/src/cms/ entgegen. Das Vite-Collections-Plugin und virtual:rebase-collections wurden entfernt. CollectionsProvider nimmt dieselben drei Eingaben entgegen (tableCustomizations, externalCollections, tables).
import { collections } from "virtual:rebase-collections";<RebaseCMS collections={collections}/>import { postsCms } from "./cms/posts";<RebaseCMS tableCustomizations={[postsCms]}/>Was zu tun ist: Der Codemod schreibt frontend/src/cms/index.ts, das tableCustomizations (und externalCollections) exportiert, und bindet es in der App.tsx eines Scaffolds selbst ein; eine nicht erkannte App.tsx, das Plugin in vite.config.ts und die virtuelle Moduldeklaration werden als manuelle Schritte ausgegeben. Siehe Eine Tabelle anpassen.
112. Bundle format 3; format-2 bundles are refused
Abschnitt betitelt „112. Bundle format 3; format-2 bundles are refused“Wen dies betrifft: jedes Deployment eines gebauten Bundles – selbst gehostet mit dem Runtime-Image oder auf Rebase Cloud.
Was sich geändert hat: Das Schema eines Bundles ist entry.tables, neben entry.resources, entry.storage und entry.hooks; bundleFormat ist 3 und der Runtime-Vertrag 2. Ein Format-1- oder Format-2-Bundle enthält config/collections, wofür eine 0.31-Runtime keine Leselogik mehr besitzt. Daher verweigert sie den Start mit dem Hinweis auf den Codemod in der Fehlermeldung, anstatt die Datenbank zu introspektieren und eine abweichende API bereitzustellen.
Was zu tun ist: Migrieren Sie den Quellcode, führen Sie dann rebase build aus und deployen Sie. Auf Rebase Cloud baut das Deployment des migrierten Repositorys dieses neu. Siehe Runtime und Bundles.
Auf Rebase Cloud läuft ein Projekt auf 0.30 weiter, kann jedoch nicht deployt werden. Die Plattform liefert weiterhin das vorhandene Bundle aus, und ihre Runtime-Updates stoppen dort (die Konsole weist darauf hin), sie akzeptiert jedoch nur noch Format 3: Ein Deploy über eine 0.30-CLI lädt das gesamte Bundle hoch und wird dann mit BUNDLE_FORMAT_TOO_OLD abgelehnt. Der Weg nach vorn besteht bei jedem Projekt aus denselben drei Befehlen:
pnpm exec rebase upgrade --to latestrebase migrate collections-to-tablesrebase cloud deployEine CLI nach 0.32.0 bricht früher ab, bevor sie etwas baut oder hochlädt: rebase build und rebase cloud deploy bei einem Projekt, dessen Tabellen noch in config/collections liegen, stoppen mit der Nennung des Codemods; ein --bundle-dir, das ein Format-2-Bundle enthält, wird mit „Nothing was uploaded“ abgelehnt, und rebase upgrade nennt den Codemod als nächsten Schritt anstelle von rebase build. (Das eigene rebase upgrade von 0.30 endet noch mit dem Hinweis „Run rebase build“; der Build, auf den es verweist, ist derjenige, der stoppt.)
113. The schema version is computed from tables (v2:)
Abschnitt betitelt „113. The schema version is computed from tables (v2:)“Wen dies betrifft: jede Datenbank, die von einer Runtime vor 0.31 bereitgestellt wurde, und jedes generierte SDK.
Was sich geändert hat: Die Schema-Version hasht die kompilierten Tabellendeskriptoren und beginnt mit v2:. Eine mit v1: gestempelte Datenbank meldet die Modelländerung einmalig – das Boot-Log und rebase doctor weisen darauf hin und erklären, wie neu gestempelt wird – und jedes generierte SDK wird einmalig als veraltet gemeldet.
Was zu tun ist: Einmalig mit der neuen Runtime provisionieren: Starten Sie den Prozess, der das Schema verwaltet, oder führen Sie rebase db push aus. Stempeln Sie bei gesetztem REBASE_REQUIRE_SCHEMA_MATCH=true neu, bevor Sie die anderen Prozesse aktualisieren. Generieren Sie das SDK neu.
114. Error codes name tables
Abschnitt betitelt „114. Error codes name tables“Wen dies betrifft: Code, der anhand eines Fehler-codes verzweigt.
Was sich geändert hat:
| Vorher | Jetzt |
|---|---|
NO_COLLECTIONS (404) |
NO_TABLES |
COLLECTION_READ_ONLY (405) |
TABLE_READ_ONLY |
UNKNOWN_COLLECTION (SDK) |
UNKNOWN_TABLE |
INVALID_COLLECTION_PATH (SDK) |
INVALID_TABLE_PATH |
Was zu tun ist: rebase migrate sdk-calls schreibt die String-Literale um. Siehe Fehler.
115. The SDK addresses a table: data.table(slug)
Abschnitt betitelt „115. The SDK addresses a table: data.table(slug)“Wen dies betrifft: jeden Client, jede Funktion, jeden Cron-Job, jeden Hook und jedes Skript, das eine Tabelle über ihren Slug anspricht oder das generierte Dictionary übergibt.
Was sich geändert hat:
| Vorher | Jetzt |
|---|---|
data.collection(slug) |
data.table(slug) |
createRebaseClient({ collections: collectionsDictionary }) |
createRebaseClient({ tables: tablesDictionary }) |
generiertes CollectionName, CollectionsDictionary |
TableName, TablesDictionary |
Batch { op, collection } (SDK und POST /api/data/_batch) |
{ op, table } |
CollectionClient, SDKCollectionClient, CollectionAccessor, CollectionTrashAccessor |
TableClient, SDKTableClient, TableAccessor, TableTrashAccessor |
Offline maxCachedRowsPerCollection, maxCachedQueriesPerCollection |
…PerTable |
reservierter Accessor <name>Collection; collectionCollection |
<name>Table; die Tabelle collection heißt collection |
const { data } = await client.data.collection("posts").find();const { data } = await client.data.table("posts").find();Typisierte Accessoren (client.data.posts) bleiben unverändert.
Was zu tun ist: Der Codemod führt rebase migrate sdk-calls über Ihren Code aus – führen Sie ihn bei einem bereits migrierten Projekt separat aus – und anschließend rebase generate-sdk. Ein .collection(-Aufruf, dessen Receiver nicht das SDK ist, wird unverändert belassen und aufgelistet. Siehe Typisiertes SDK.
116. CLI flags: --schema-dir, not --collections
Abschnitt betitelt „116. CLI flags: --schema-dir, not --collections“Wen dies betrifft: Skripte und CI-Schritte, die die CLI mit einem Schema-Pfad aufrufen.
Was sich geändert hat: --collections / -c werden bei jedem Befehl, der das Schema liest, mit einem Hinweis auf den Codemod in der Fehlermeldung abgelehnt (generate-sdk ignoriert ein überflüssiges --collections-dir); --schema-dir gibt ein anderes Schema-Verzeichnis als backend/schema an. rebase schema introspect schreibt defineTable-Dateien nach backend/schema/ – --output existiert nicht mehr. REBASE_STRICT_COLLECTION_CONFIG wird nicht mehr ausgewertet: Ein Schema, das nicht kompiliert, verhindert immer den Start.
Was zu tun ist: Ersetzen Sie die Flags. Siehe CLI und Schema-Generierung.
117. The schema editor edits backend/schema with TablePatch
Abschnitt betitelt „117. The schema editor edits backend/schema with TablePatch“Wen dies betrifft: Code, der die Schema-Editor- oder Live-Schema-Routen aufruft, sowie Deployments, die Variablen für die Live-Bearbeitung setzen.
Was sich geändert hat: /api/admin/schema-editor/collection/save, collection/delete, property/save und property/delete sind entfernt. Der Editor bedient GET /tables, POST /preview und POST /apply, und das /plan sowie /apply der Live-Schema-Bearbeitung nehmen { patches: TablePatch[] } anstelle einer Collection oder eines Patches davon entgegen. REBASE_LIVE_SCHEMA_COLLECTIONS_PATH wird beim Start abgewiesen: Es heißt nun REBASE_LIVE_SCHEMA_PATH (Standard backend/schema), und liveSchema.repository.collectionsPath heißt schemaPath. Darstellungseinstellungen sind niemals Schema-Änderungen: Sie werden als UI-Präferenzen gespeichert (/api/admin/ui-config). Eine Bearbeitung, deren Datei sich auf der Festplatte geändert hat, nachdem der Edit vorbereitet wurde (Speichern in der IDE, ein anderer Prozess), antwortet mit 409 SCHEMA_EDIT_STALE_FILE und schreibt nichts; zuvor war dies ein 400 SCHEMA_EDIT_REFUSED.
Was zu tun ist: Benennen Sie die Variable um; schreiben Sie Aufrufer der Routen so um, dass sie TablePatch-Edits senden, und laden Sie bei SCHEMA_EDIT_STALE_FILE neu. Siehe Live-Schema-Bearbeitung.
118. A component slot is a component
Abschnitt betitelt „118. A component slot is a component“Wen dies betrifft: Anpassungen, die eine React-Komponente über einen String-Pfad oder einen Lazy-Thunk () => import(…) angegeben haben.
Was sich geändert hat: Das Field / Preview / Filter eines Feldes, Collection-Actions, entityViews[].Builder, collectionViews[].Builder, formView.Builder und Komponenten-Overrides nehmen die Komponente selbst entgegen. ComponentRef, ComponentLike, LazyComponentRef und isLazyComponentRef (@rebasepro/types), asComponentRef und asReactComponent (@rebasepro/cms-types) sowie resolveComponentRef / useResolvedComponent (@rebasepro/app) wurden entfernt. customizeTable lehnt Strings oder Thunks mit der Meldung „imported by value“ ab.
Was zu tun ist: Importieren Sie die Komponente in der Datei frontend/src/cms/ und übergeben Sie sie direkt. Siehe Benutzerdefinierte Felder.
Der Codemod führt dies für jeden String-Pfad durch und vermerkt jeden einzelnen, da eine importierte Komponente nun typgeprüft an ihren Slot übergeben wird, wo vorher nie eine Typprüfung für Pfade stattfand. Ein Preview, das customProps?: MyProps deklariert, schlägt im tsc Ihres Frontends fehl: Der Slot übergibt customProps als unknown, da nichts die customProps eines Feldes an die Komponente koppelt, die sie liest. Verwenden Sie customProps?: unknown und grenzen Sie den Typ innerhalb der Komponente ein.
119. Panel preferences are UI preferences
Abschnitt betitelt „119. Panel preferences are UI preferences“Wen dies betrifft: Code, der UserConfigurationPersistence implementiert.
Was sich geändert hat: Wie ein Benutzer eine Tabelle in der Größe angepasst oder neu angeordnet hat, ist ein UiTablePreferences-Delta: getTablePreferences / saveTablePreferences ersetzen getCollectionConfig / onCollectionModified, und der partielle Collection-Config-Typ, den dies entgegennahm, wurde entfernt. Der Browser-Store hält diese unter table_preferences::<slug> vor und ignoriert, was ein älteres Panel gespeichert hat, sodass die Spaltenbreiten und Ansichtsmodi jedes Benutzers einmalig zurückgesetzt werden. userSelect auf einem Feld ist entfallen: Eine .userId()-Spalte dient als Benutzerauswahl.
Die Studio-Bridge folgt diesem Schema: StudioSchemaEditing.updateCollection heißt applyTablePatches(slug, patches), und der Collection Editor sendet { patches } an den Schema-Editor.
Was zu tun ist: Portieren Sie eine eigene Persistenz auf die beiden Methoden und ein eigenes StudioSchemaEditing auf applyTablePatches.
120. MongoDB is retired
Abschnitt betitelt „120. MongoDB is retired“Wen dies betrifft: ein Projekt, das auf @rebasepro/server-mongo basiert oder database(…, { engine: "mongodb" }) deklariert.
Was sich geändert hat: Das Paket wurde entfernt, ebenso wie die Mongo-Collection-Typen und der Rest des Mongo-Modells. Postgres ist die einzige Server-Engine: Eine Server-Transportquelle auf einer anderen Engine verweigert den Start unter Nennung der Engine.
Was zu tun ist: Migrieren Sie die Daten nach Postgres. Es gibt keinen migrationsinternen Pfad innerhalb von Rebase.
121. Firestore collections live in the frontend
Abschnitt betitelt „121. Firestore collections live in the frontend“Wen dies betrifft: ein Hybrid-Projekt mit engine: "firestore"-Collections.
Was sich geändert hat: Eine Firestore-Collection ist eine CMS-Quelle, die der Browser direkt liest: defineFirestoreCollection aus @rebasepro/firebase in frontend/src/cms/, übergeben an <RebaseCMS externalCollections>. Eine Referenz zwischen Firestore und einer Postgres-Tabelle wird als ID des Ziels gespeichert, und eine Firestore-Referenz, deren path gleichzeitig ein Postgres-Slug ist, zielt nun auf die Postgres-Tabelle ab.
Was zu tun ist: Der Codemod schreibt die defineFirestoreCollection-Dateien. Verweisen Sie auf eine Firestore-Collection über den Slug dieser Collection. Siehe Firebase.
122. MCP tools are named for tables
Abschnitt betitelt „122. MCP tools are named for tables“Wen dies betrifft: Prompts, Skripte und Allowlisten, die MCP-Tools benennen.
Was sich geändert hat: Remote-/mcp: list_collections, describe_collection, query_collection, show_collection, count_documents, aggregate_documents, get_document, create_document, update_document, delete_document → list_tables, describe_table, query_table, show_table, count_rows, aggregate_rows, get_row, create_row, update_row, delete_row; das Argument collection heißt table, und show_app / save_app akzeptieren tables. Der lokale Server: list_documents → query_table, get_document → get_row, create_document → create_row, update_document → update_row, delete_document → delete_row; rebase_schema_plan nimmt patches entgegen; Ressourcen lauten rebase://tables/{name}. Die MCP-Apps-View-Payload hat die Version 3: für den Aufrufer geschwärzte Tabellendeskriptoren, Pro-Tabelle-Berechtigungen und die UI-Präferenzen jedes Aufrufers unter preferences (file, workspace, user; ein API-Key hat keine User-Ebene), wobei Blöcke und Seeds table benennen. Die View collection-table wurde entfernt. list_tables besitzt keinen title; describe_table fügt primaryKey, relations, das rls des Aufrufers, title und presentation hinzu.
Was zu tun ist: Benennen Sie diese um. Die View und der Server müssen dieselbe Payload-Version sprechen: Ein gehosteter Konnektor und die von ihm erreichten Runtimes werden gemeinsam aktualisiert, und eine im Projekt gebaute MCP-View wird mit den 0.31-Paketen neu gebaut. Siehe MCP-Tool-Referenz und Remote-MCP.
123. The rule vocabulary says table
Abschnitt betitelt „123. The rule vocabulary says table“Wen dies betrifft: Regeln, die policy.existsIn oder einen Membership-Tenanten verwenden, sowie Regeln, die access mit anderen Klauseln kombinieren.
Was sich geändert hat: policy.existsIn({ collection, where }) heißt existsIn({ table, where }), und tenant.from.membership.collection heißt membership.table; Policy-Namen ändern sich nicht. Vier Regelformen gewähren nun andere Berechtigungen, zwei davon mehr (die Tabelle oben): Ein reines { access: "authenticated" }, das früher nichts gewährte, lässt nun jeden angemeldeten Aufrufer zu, und die Verbindungstabellen (Junctions) einer solchen Tabelle erhalten ihre Edge-Write-Policies. Regeln, die Klauseln kombinieren, die der Typ SecurityRule ausschließt, oder die ungültige Werte für access, mode, operation oder roles enthalten, werden abgelehnt.
Was zu tun ist: Der Codemod benennt die Schlüssel um, lehnt ungültige Regeln unter Angabe von Datei und Zeile ab und listet die Regeln, die ihre Bedeutung ändern, unter „Review before deploying“ auf. Behalten Sie jede einzelne bei, ändern Sie sie in access: "registered" (angemeldete Aufrufer mit Konto) oder entfernen Sie sie. Prüfen Sie anschließend rebase db push --dry-run und rebase doctor --policies gegen Ihre Datenbank.
124. Studio reads the tables from the server
Abschnitt betitelt „124. Studio reads the tables from the server“Wen dies betrifft: Studio, das auf ein Backend vor 0.31 gerichtet ist, sowie Studio-JS-Konsolenskripte.
Was sich geändert hat: Jedes schema-bewusste Tool liest GET /api/schema/tables; bei einer Runtime ohne diesen Endpunkt wird ein Upgrade-Hinweis angezeigt. Die deklarierte Seite des RLS-Editors entspricht dem, was der Server kompiliert hat. Ein JS-Konsolenskript erhält context.tables (zuvor context.collections).
Was zu tun ist: Aktualisieren Sie die Runtime zusammen mit dem Panel. Siehe Studio.
125. rls-check --format agent says rls
Abschnitt betitelt „125. rls-check --format agent says rls“Wen dies betrifft: Tools, die rls-check --format agent auslesen.
Was sich geändert hat: remediation.rebase.securityRules heißt nun remediation.rebase.rls, der Auszug ist ein defineTable(…, { rls }), und die Formatversion des Dokuments ist 2. --json bleibt unverändert. Siehe rls-check.
Was zu tun ist: Lesen Sie den neuen Schlüssel aus.
126. @rebasepro/plugin-review: reviewRls
Abschnitt betitelt „126. @rebasepro/plugin-review: reviewRls“Wen dies betrifft: ein Projekt, das das Review-Plugin verwendet.
Was sich geändert hat: reviewSecurityRules(slug, review) heißt nun reviewRls(slug, review) und wird in das rls der Tabelle eingefügt; findReviewConfigProblems und assertReviewConfig nehmen Tabellendeskriptoren entgegen.
Was zu tun ist: Benennen Sie den Aufruf um und übergeben Sie services.tables() oder compileTables(…).
127. @rebasepro/codegen reads descriptors
Abschnitt betitelt „127. @rebasepro/codegen reads descriptors“Wen dies betrifft: Code, der den Generator direkt aufruft.
Was sich geändert hat: generateTypedefs(tables) und generateSDK(tables, options) nehmen TableDescriptor[] entgegen – was compileTables zurückgibt und GET /api/schema/tables ausliefert – anstelle von Collections.
Was zu tun ist: Kompilieren Sie Ihre Definitionen zuerst oder nutzen Sie rebase generate-sdk.
128. The agent skill rebase-collections is rebase-tables
Abschnitt betitelt „128. The agent skill rebase-collections is rebase-tables“Wen dies betrifft: Projekte mit installierten Agent-Skills sowie Prompts oder Anweisungsdateien, die den Skill benennen.
Was sich geändert hat: Der Skill, der das Datenmodell vermittelt, heißt nun rebase-tables: Erstellung von Tabellen, Spalten, Relationen, rls, Hooks und der CMS-Schicht darüber. rebase skills install entfernt die alte rebase-collections-Kopie, auch aus Installationen vor der Einführung des Skills-Manifests, und behält jedes selbst erstellte Verzeichnis dieses Namens bei.
Was zu tun ist: Führen Sie nach dem Upgrade rebase skills install aus. Die von rebase migrate collections-to-tables ausgegebenen Schritte weisen ebenfalls darauf hin. Benennen Sie den Skill in allen Anweisungsdateien um, die ihn erwähnen. Siehe Agent-Skills.
129. useJsonCollectionsConfigController is removed
Abschnitt betitelt „129. useJsonCollectionsConfigController is removed“Wen dies betrifft: ein Projekt, das Collection-Definitionen über @rebasepro/cms als JSON gespeichert hat.
Was sich geändert hat: useJsonCollectionsConfigController wurde entfernt, zusammen mit seinem Optionstyp und der dahinterliegenden JSON-Store-Klasse. Das Schema einer Tabelle liegt in backend/schema, und wie das Panel sie darstellt, wird in UI-Präferenzen gespeichert: frontend/src/cms/ui-config.json in der Entwicklung, die Tabelle rebase.ui_preferences in einem Deployment.
Was zu tun ist: Deklarieren Sie die Tabellen mit defineTable (rebase migrate collections-to-tables schreibt sie anhand der Collection-Definitionen) und übergeben Sie die uiConfig des Scaffolds an <RebaseCMS>. Siehe Eine Tabelle anpassen.
130. rebase build refuses a frontend without rebaseBackendGuard()
Abschnitt betitelt „130. rebase build refuses a frontend without rebaseBackendGuard()“Wen dies betrifft: jedes Projekt mit einem Frontend.
Was sich geändert hat: Das Frontend darf backend/ ausschließlich als Typen importieren. Ein Wert-Import würde Server-Code – Hooks und alle darin gelesenen Secrets – in das Browser-Bundle einbringen. rebaseBackendGuard() aus @rebasepro/app/vitePlugin lässt vite build und vite dev fehlschlagen, wenn ein Frontend-Modul nach backend/ auflöst, und nennt den Importer, den Import und die Datei nach Auflösung von Aliasen, tsconfig-Pfaden, Paket- und absoluten Auflösungen, Globs, ?raw, Re-Exporten und dynamischen Importen. rebase build sowie der Frontend-Build, den rebase cloud deploy ausführt, verweigern die Ausführung bei einem Frontend, dessen Vite-Konfiguration dies nicht nutzt; rebase dev gibt eine Warnung aus; rebase verify meldet cms-backend-guard-missing.
Was zu tun ist: Der Codemod fügt dies zur frontend/vite.config.ts eines Scaffolds hinzu und gibt die Zeilen für jede andere Konfiguration aus:
import { rebaseBackendGuard } from "@rebasepro/app/vitePlugin";
export default defineConfig({ plugins: [react()], plugins: [react(), rebaseBackendGuard()],});Wandeln Sie anschließend jeden Wert-Import von backend/ in ein import type um.
131. Rows on the wire follow their column
Abschnitt betitelt „131. Rows on the wire follow their column“Wen dies betrifft: Clients, die Fremdschlüssel auslesen oder Relationen benennen, sowie Schreibvorgänge, die generierte Spalten oder partielle JSON-Objekte senden.
Was sich geändert hat: Werte durchlaufen beim Senden den Codec ihrer Spalte und beim Empfangen die Regeln der Spalte.
-
Eine von einer Relation generierte
bigint- odernumeric-Fremdschlüsselspalte, die Postgres als Text zurückgibt, wird in REST, im SDK und im Admin-Panel als Zahl ausgeliefert. Explizit deklarierte numerische Schlüssel waren dies bereits. -
Die Elemente eines nativen Arrays werden entsprechend ihrem Skalartyp ausgeliefert, in REST, im SDK, über Sockets und im Treiber:
Spalte 0.30 lieferte 0.31 liefert timestamptz[]["2026-01-02 11:00:00+01"]["2026-01-02T10:00:00.000Z"]numeric[](ein Treiber, der ohne die Boot-Zeit-Einstellung für Numerics geöffnet wurde: Tests, Skripte)["1.50", "2.25"][1.5, 2.25]bigint[]mit einem Null-Element[1, 0, 3][1, null, 3]date[],timestamptz[]oder ein Enum-Array mit einem Null-Element["2026-01-02", "NULL"]["2026-01-02", null]date[],time[],text[],uuid[],boolean[],integer[]unddouble precision[]werden wie bisher ausgeliefert. Was gespeichert wird, ändert sich nicht: Eine gelesene und wieder zurückgespeicherte Zeile speichert dasselbe Array. -
Eine in
include, einem Filter oder einer Sortierung angegebene Relation muss ihren exakten Namen tragen. Die Fallbacks mit dem Slug und der snake_case-Schreibweise wurden entfernt. -
Eine generierte Spalte wird beim Schreiben abgelehnt und aus dem OpenAPI-Eingabeschema weggelassen.
-
Ein Pflichtfeld innerhalb eines JSON-Objekts wird erzwungen;
$incund Array-Elemente auf einer Integer-Spalte müssen ganze Zahlen sein.
Was zu tun ist: Lesen Sie Fremdschlüssel als Zahlen aus, wo Sie bisher Strings verglichen haben, parsen Sie timestamptz[]-Elemente als RFC 3339, behandeln Sie ein Null-Array-Element als null und schreiben Sie Relationsnamen genau so, wie die Tabelle sie deklariert (ihre relations-Schlüssel). Senden Sie keine generierten Spalten mehr.
132. History is served as reads
Abschnitt betitelt „132. History is served as reads“Wen dies betrifft: Leser von Verlaufs-Snapshots und jeden, der einen DataDriver implementiert.
Was sich geändert hat: Verlaufseinträge werden wie reguläre Lesevorgänge ausgeliefert: zuerst Feldzugriff, dann afterRead (global, Tabelle, Spalte). Eine durch einen Hook oder ein .transform({ afterRead }) maskierte Spalte ist in jedem Snapshot maskiert; eine Spalte, die der Aufrufer nicht lesen darf, wird vorenthalten und aus changed_fields weggelassen; Schlüssel gelöschter Spalten werden vorenthalten, und ein Revert schreibt niemals eine Spalte, die der Aufrufer nicht lesen darf. Ein Hook, der bei einem alten Snapshot einen Fehler wirft, lässt die Anfrage fehlschlagen. 0.30 lieferte die gespeicherten Rohwerte aus, daher sollte jedes Projekt mit Verlauf und Maskierungs-Hooks aktualisiert werden.
Ein Eintrag enthält die Zeile so, wie GET /api/data/<table>/<id> sie ohne include liest: einfache Werte, ein belongsTo als dessen Fremdschlüssel. Ein Eintrag, den eine ältere Version mit dem ViewModel des Admin-Panels aufgezeichnet hat, wird als diese Zeile ausgeliefert und zurückgerollt: eine { "__type": "date", "value" }-Hülle als Wert, eine { "__type": "relation" }-Referenz einer besitzenden Relation als Fremdschlüssel unter dem Eigennamen des Schlüssels und jede andere Referenz als Schlüssel der verknüpften Zeile. 0.30 lieferte diese Referenzen wie gespeichert aus.
Ein Treiber stellt den Verlauf über DataDriver.serveStoredRows(path, rows) innerhalb der schreibgeschützten Transaktion des Aufrufers bereit; die Verlaufsrouten antworten mit 501 bei einem Treiber, der dies nicht unterstützt, sodass der Verlauf niemals unmaskiert ausgeliefert wird.
Was zu tun ist: Für den mitgelieferten Postgres-Treiber ist nichts zu tun. Ein benutzerdefinierter Treiber implementiert serveStoredRows. Siehe Verlauf.
133. @rebasepro/server exports name tables
Abschnitt betitelt „133. @rebasepro/server exports name tables“Wen dies betrifft: ein Server, den Sie aus den Komponenten von @rebasepro/server anstelle von initializeRebaseBackend / createRebaseBackend zusammensetzen.
Was sich geändert hat:
| Vorher | Jetzt |
|---|---|
new RestApiGenerator(collections, …) |
new RestApiGenerator(tables, …) (RestTables) |
mountOpenApiDocs({ collections }), createHistoryRoutes({ collections }) |
mountOpenApiDocs({ serverTables }), createHistoryRoutes({ tables }) |
versionProperty, buildCollection*Schema |
versionColumn, buildTable*Schema; Validatoren, Konflikt- und ETag-Helper nehmen einen TableDescriptor entgegen |
auth-collection-writes |
auth-table-writes: createUserThroughAuthTable, isAuthTable, prepareAuthTableUpdates, deletingAuthTableUsers |
Auth-Adapter-Option collectionAuthConfig |
authTableHooks (CompiledAuthHooks) |
McpRoutesConfig.getCollections |
getTables() |
assertUploadWithinPropertyLimits, readUploadPropertyContext |
assertUploadWithinColumnLimits, readUploadColumnContext (gibt { table, column } zurück); Ablehnungsdetails nennen column |
provisionCollectionTables, provisionCollectionPolicies, collectionsStoredBy |
provisionTableSchema, provisionTablePolicies, tablesStoredBy |
handGlobalCallbacksTo, warnOnAuthCollectionDataCallbacks |
handGlobalHooksTo, warnOnAuthTableDataHooks |
SchemaEditingAdmin.planSchemaChange(collections, …) |
planSchemaChange(tables, …) mit CompiledTable[]; EditedSchema.tables |
buildCollectionFromTableMetadata, IntrospectedCollection, IntrospectedRelation |
entfernt: Eine introspektierte Tabelle ist ein TableDescriptor |
createUserThroughAuthCollection; NestedWriteHop.parentCollection / .targetCollection; ContractRoutesConfig.collectionRegistry |
createUserThroughAuthTable; .parent / .target (Deskriptoren); entfernt |
der Collection-Loader: CollectionConfigError, ConfigProblem, applyCollectionDefaults, CollectionDefaults und der Optionstyp des Validators, accessModelFromCollections, loadBundleConfigExports, BundleConfigExports, unknownKeyPolicyFromEnv, UnknownKeyPolicy |
entfernt: compileSchema / loadBackendSchema laden und prüfen backend/schema, und ein SchemaDefinitionError benennt jedes Problem |
Was zu tun ist: Benennen Sie diese um. rebase migrate sdk-calls benennt assertUploadWithinPropertyLimits und die Upload-Feld-Konstanten um (UPLOAD_COLLECTION_FIELD / UPLOAD_PROPERTY_FIELD → UPLOAD_TABLE_FIELD / UPLOAD_COLUMN_FIELD, gleiche Werte) und listet jeden weiteren Import oder jede weitere Option in dieser Tabelle als nummerierten manuellen Schritt auf.
134. @rebasepro/server-postgres exports name tables
Abschnitt betitelt „134. @rebasepro/server-postgres exports name tables“Wen dies betrifft: Code, der den Postgres-Treiber selbst öffnet, den Adapter wrappt oder den Schema-Planner importiert.
Was sich geändert hat:
| Vorher | Jetzt |
|---|---|
die Klasse PostgresCollectionRegistry, getTable(name), registerTable |
PostgresTableRegistry, getPgTable, registerPgTable |
openPostgresDriver(config, { collections }) |
openPostgresDriver(config, { tables }), tables aus compileSchema; Treiberaufrufe führen keine collection-Prop mehr (Abschnitt 137) |
Adapter / Bootstrapper ensureCollectionSchema, ensureCollectionPolicies, readCollectionsSchemaVersion, stampCollectionsSchemaVersion |
ensureTableSchema, ensureTablePolicies, readTablesSchemaVersion, stampTablesSchemaVersion, die CompiledTable[] entgegennehmen |
serializePropertyToServer, parsePropertyFromServer |
serializeColumnToServer(value, column); parsePropertyFromServer wurde entfernt – ein Treiber-Lesevorgang gibt die REST-Zeile zurück (Abschnitt 136) |
ensureCollectionTables, planCollectionSchemaEnsure, planCollectionPolicies, CollectionPolicyPlan, lockCollectionTables |
ensureTables, planTableSchemaEnsure, planTablePolicies, TablePolicyPlan, lockTables |
CollectionIndexSpec, CollectionIndexConfigError, collectionIndexStatements |
TableIndexSpec, TableIndexConfigError, tableIndexStatements |
checkCollectionsVsDatabase / …VsSchema / …VsSdk, columnKeysFromCollections, buildDrizzleRelationsFromCollections, schemaOfCollection, getTableIncludesFromCollections |
checkTablesVs…, columnKeysFromTables, buildDrizzleRelationsFromTables, schemaOfTable, getTableIncludesFromTables |
SchemaDifference.collection, .property (und die Log-Felder der Boot-Drift-Warnung) |
.slug, .key |
createStampKeys, sharedRelationName, isAuthCollection, lowerCompiledTables, buildCollectionIndexPlan |
entfernt |
Das vom Planner gemeldete JSON behält seine Schlüssel: SchemaReconcileColumn.collection und die SchemaChange-Arten bleiben unverändert.
Was zu tun ist: Benennen Sie diese um. Ein Wrapper, der den Adapter in einen BackendBootstrapper umwandelt, muss ensureTableSchema und ensureTablePolicies weiterleiten. Siehe Einbetten des Postgres-Treibers.
135. @rebasepro/types and @rebasepro/common drop the collection model from their roots
Abschnitt betitelt „135. @rebasepro/types and @rebasepro/common drop the collection model from their roots“Wen dies betrifft: Code, der Collection- oder Eigenschaftstypen, Admin-Panel-Helper oder den Lift aus @rebasepro/types oder @rebasepro/common importiert – benutzerdefinierte Felder, Custom Views, Plugins, Tests mit Collection-Fixtures – sowie benutzerdefinierte Treiber, die die Registry implementieren.
Was sich geändert hat: Die Kernel-Pakete beschreiben ausschließlich Tabellen. Was eine Collection in der Darstellung des Admin-Panels beschreibt, liegt in @rebasepro/cms-types:
- Typen, die aus
@rebasepro/typesverschoben wurden:CollectionConfig,PostgresCollectionConfig,FirebaseCollectionConfig,AnyCollectionConfig, jedes…Property(StringProperty,NumberProperty,ArrayProperty, …) undProperties,CollectionCallbacksund deren Hook-Props, die Relationsarten aus 0.30 und ihreResolved…-Formen,CollectionIndex, die Chip-Farben (ColorScheme,ColorKey, …),FieldAccess,EnumValues. - Helper, die aus
@rebasepro/commonverschoben wurden: die collection-spezifischen Policy-Helper (policyToPostgres,compileRulePolicies,getEffectiveSecurityRules,getGeneratedPolicyNames, …),CollectionRegistry,resolveCollectionRelations,resolveRelation,getTableName,findRelation,rowToViewModel,resolvePrimaryKeys, die Feldzugriffsansicht einer Eigenschaft (effectiveAccess,canReadField,canWriteField),evaluateCondition,canEditEntity,resolveProperty,getDefaultValuesFor,getSubcollections,getCopyValues,enumToObjectEntries. Eine aus einem einfachen Ausdruck kompilierte Regel verwendetcompilePolicyExpression(expr)aus@rebasepro/common. composeCallbackskomponiert die Callbacks einer Collection für das Panel und wurde nach@rebasepro/cms-typesverschoben;@rebasepro/serverreexportiert dies nicht mehr. Backend-Code komponiert die Hooks einer Tabelle mitcomposeTableHooksaus@rebasepro/common, und der Codemod führt einen Backend-Import voncomposeCallbacksals entsprechenden manuellen Schritt auf.defineCollectionwurde aus@rebasepro/commonund@rebasepro/cms-typesentfernt: Deklarieren Sie die Tabelle mitdefineTableinbackend/schemaund passen Sie sie mitcustomizeTableinfrontend/src/cmsan; eine Firestore-Collection istdefineFirestoreCollectionaus@rebasepro/firebase.- Der Accessor des Admin-Panels und seine Typen:
Entity,EntityValues,TableAccessor,TableTrashAccessor,FindResponse,QueryBuilderInterface,RebaseDataundAuthStatehaben@rebasepro/typesverlassen;buildRebaseData,wrapAsEntityData,buildRoutedRebaseData,EntityDataOptions,QueryBuilder,RelationRefundcreateRelationRefhaben@rebasepro/commonverlassen. Alle werden nun aus@rebasepro/cms-typesimportiert. Die eigene Datenschicht des SDK –buildSdkData,createDriverTableRows,buildRoutedSdkData, in@rebasepro/common– liefert Zeilen direkt aus und gibt zurück, was sie zuvor zurückgegeben hat. EntityDataOptions.resolveCollectionwird durchprimaryKeysOf,viewModelOf,storedValuesOfundviewModelSourceOfersetzt;collectionEntityDataOptions(resolveCollection, { resolveDataPath, resolveAccessor })aus@rebasepro/cms-typesbaut diese auf.- Der Migrations-Lift (
collectionsToTableDefs,collectionToTableDef,LiftNote,LiftResult,LiftOptions) wurde nach@rebasepro/common/migrateverschoben, neben eine eingefrorene Kopie des Collection-Modells aus 0.30 (Legacy…-Typen) unddefineLegacyCollection. - Ebenfalls aus den Kernel-Roots entfernt und vom Codemod jeweils als manueller Schritt aufgelistet: die Collection-Patch-API von
@rebasepro/types(CollectionPatch,CollectionPatchOp,applyCollectionPatch,collectionPatchProblems,isCollectionPatch,nestCollectionPatchPaths→TablePatch), deren Collection-JSON-Helper (diffCollections,diffJsonValues,toCollectionJson,RUNTIME_ONLY_COLLECTION_KEYS,runtimeOnlyKeyIn), die aus der Mongo-Ära stammendenDocumentAdmin,isDocumentAdminund die FähigkeitsupportsDocumentAdmin, sowieRebaseProjectContract.collectionSlugs/.collections/.generatedAt(/api/meta/contractlieferttablesaus); aus@rebasepro/common:buildTenantSecurityRule→tenantSecurityRule,defaultPoliciesDisabled→tableDefaultPoliciesDisabled,restoresSoftDeletedRow→isSoftDeleteRestore,softDeleteFieldOf→softDeleteColumn,getJunctionConfigForRelation→resolveTableJunctions, undisRelationRequired,relationDeclaringProperty,requireCallbackCollectionohne Nachfolger (lesen Sie denTableDescriptoraus). - Die Registry eines Treibers ist ein
TableRegistryInterface(zuvorCollectionRegistryInterface):setGlobalHooks?undsetTableHooks?ersetzengetGlobalCallbacks/setGlobalCallbacks?.globalHooksAsCallbacks,resolveDriftCheckNameundPENDING_TABLE_FEATURESwurden entfernt.
Was zu tun ist: rebase migrate sdk-calls (Teil von collections-to-tables) verschiebt jeden unten stehenden Import in sein neues Paket – zusammengeführt in einen bereits bestehenden Import dieses Pakets in der Datei, wobei import type, Inline-type und as-Aliase beibehalten werden – und fügt das Paket zu den Abhängigkeiten des importierenden Workspace-Pakets hinzu; führen Sie danach pnpm install aus. Ein Import eines entfernten Namens, ein Namespace-Import (import * as), ein export *, ein dynamisches import() oder ein require(), das einen verschobenen Namen verwendet, wird als nummerierter manueller Schritt ausgegeben. Ein Test, der Collection-Literale als Fixtures vorhält, typisiert diese mit den Legacy…-Typen und führt den Lift über @rebasepro/common/migrate durch.
Verschobene Importe
Abschnitt betitelt „Verschobene Importe“Jeder Name, den 0.31 in ein anderes Paket verschoben oder entfernt hat, ist unter In 0.31 verschobene Importe aufgeführt, inklusive Hinweisen, was für die einzelnen entfernten Namen zu schreiben ist. Die Liste wird aus derselben Tabelle generiert, die der Codemod liest, und entspricht daher exakt dem, was rebase migrate sdk-calls umschreibt.
136. The Postgres driver and the socket’s one-shot reads return the REST row
Abschnitt betitelt „136. The Postgres driver and the socket’s one-shot reads return the REST row“Wen dies betrifft: Funktionen oder Plugins, die über requireDriver(c) / getDriver(c) lesen, Code, der die FETCH_COLLECTION- / FETCH_ONE-Frames des Sockets sendet, und Code, der { __type }-Objekte aus einer Antwort ausliest.
Was sich geändert hat: Es gibt nur noch eine einzige Rückgabeform beim Lesen. fetchCollection und fetchOne auf dem Postgres-Treiber – worüber requireDriver(c) einer Funktion, Plugins, die One-Shot-Frames des Sockets, MCP und der RLS-Simulator lesen – geben das zurück, was GET /api/data/<table> zurückgibt:
| Wert | 0.30 Treiber-Lesevorgang | 0.31 |
|---|---|---|
| ein Zeitstempel | { "__type": "date", "value": … } |
ein RFC 3339-String |
ein belongsTo |
{ "__type": "relation", "id", "path" } unter dem Namen der Relation |
der Fremdschlüssel unter seinem eigenen Schlüssel (authorId) |
| eine verknüpfte Zeile | jede von fetchOne geladene Relation |
nur eine Relation, die include benennt, als eigene Zeile des Ziels |
ein Vektor, ein bytea |
{ "__type": "Vector" }, eine Data-URL |
wie von REST ausgeliefert |
FetchOneProps nimmt include entgegen (ListenOneTarget wurde entfernt: verwenden Sie FetchOneProps). rebase.data, context.data und das SDK gaben diese Form bereits zurück und bleiben unverändert.
@rebasepro/client liest REST-Bodies und Socket-Frames als einfaches JSON: Ein Wert mit einem __type-Schlüssel wird nicht mehr in ein Date, EntityReference, EntityRelation, GeoPoint oder Vector umgewandelt, und ein JSON-Dokument, das einen __type-Schlüssel enthält, wird wie gespeichert zurückgegeben.
Was zu tun ist: Lesen Sie die reine Zeile aus: Parsen Sie Daten aus ihren Strings, lesen Sie einen Fremdschlüssel über seinen eigenen Schlüssel aus und übergeben Sie include für jede Relation, die Sie auslesen:
const article = await requireDriver(c).fetchOne({ path: "articles", id });const authorId = article?.author.id; // a { __type: "relation" } refconst article = await requireDriver(c).fetchOne({ path: "articles", id, include: ["author"] });const authorId = article?.authorId;137. Driver and backend interfaces carry tables, not collections
Abschnitt betitelt „137. Driver and backend interfaces carry tables, not collections“Wen dies betrifft: ein benutzerdefinierter DataDriver, ein Datenbankadapter oder ein Backend, das Sie aus den Modulen von @rebasepro/server zusammensetzen.
Was sich geändert hat:
| Vorher | Jetzt |
|---|---|
die collection-Prop bei DataDriver-Aufrufen (fetch, save, delete, count, search, listen) |
entfernt: Der Treiber liest die von ihm bediente Tabelle über path |
checkUniqueField(path, name, value, id, collection) |
checkUniqueField(path, name, value, id?) |
scanStoredRows({ path, collection, pageSize }) |
scanStoredRows({ path, pageSize }) |
DataDriver.initTextSearch |
entfernt |
DatabaseAdapterInitConfig.collections, .collectionRegistry |
entfernt: Dem Adapter wird CompiledTable[] übergeben |
BackendServices.collections() |
services.tables() |
serializeCollections, deserializeCollections, isSerializedCollectionRef, SerializedCollectionRef |
entfernt: Deskriptoren werden unter GET /api/schema/tables ausgeliefert |
AuthAdapter.prepareUserCreation(values, collectionAuth, options?), describeUserCreationContract(collectionAuth) |
prepareUserCreation(values, options?), describeUserCreationContract() |
initializeDriver mit Rückgabe von { driver, collectionRegistry, … }; BackendInstance.collectionRegistry |
{ driver, tableRegistry, … }; BackendInstance.tableRegistry |
PolicyEvalContext.entity (ein Entity) |
PolicyEvalContext.row (die Werte der Zeile) |
wrapAsSdkData(…) |
buildSdkData(driver); mehrere Datenquellen: buildRoutedSdkData |
FindResponse aus @rebasepro/client |
FindResult |
ListenCollectionRequest, ListenEntityRequest aus @rebasepro/server |
ListenCollectionProps, ListenOneProps |
Was zu tun ist: Entfernen Sie die Argumente und lesen Sie Tabellen über path aus. Der Codemod führt implements DataDriver als manuellen Schritt auf. Siehe Einbetten des Postgres-Treibers.
138. The backend accepts the values the REST API documents, and nothing else
Abschnitt betitelt „138. The backend accepts the values the REST API documents, and nothing else“Wen dies betrifft: Clients, die eine To-One-Relation als Objekt oder einen Vektor als { value } schreiben, Code, der bei einer Relation mit einem Objekt filtert, Code, der die Wertklassen des Admins importiert, und Offline-Apps mit Schreiboperationen, die von 0.30 in die Warteschlange gestellt wurden.
Was sich geändert hat: Ein Schreibvorgang erwartet dieselbe Form, die ein Lesevorgang zurückgibt – ein einheitliches Schreibformat für REST, den Socket, MCP und das prozessinterne SDK:
| Wert | Akzeptiert | Jetzt abgelehnt |
|---|---|---|
eine To-One-Relation (belongsTo, hasOne, ein To-One via) |
der Schlüssel der verknüpften Zeile oder null ("" ist null), unter dem Namen der Relation oder des Fremdschlüssels |
ein Objekt wie etwa { "id": 5 }: 400 VALIDATION_INVALID_VALUE, “‘posts.author’ links one ‘authors’ row: write that row’s key (a string or a number), or null to unlink — not an object.” |
eine To-Many-Relation (hasMany, manyToMany, ein beschreibbares To-Many via) |
eine Liste von Schlüsseln oder von { id, _pivot? } |
— (weitere Schlüssel am Objekt werden wie bisher ignoriert) |
| ein Vektor | eine Liste von Zahlen | ein Vector oder { "value": [...] }: 400, “‘embedding’ expects a vector as a list of numbers” |
| ein Datum, eine Uhrzeit | ISO-Text (Date prozessintern) |
— |
| ein Geopoint | { latitude, longitude } |
— |
ein bytea |
eine data:application/octet-stream;base64,-URL (Buffer / Uint8Array prozessintern) |
— |
| ein Filter auf einer Relation | der Schlüssel | ein Objekt wird nicht mehr aufgelöst: Es wird exakt wie angegeben verglichen |
0.30 akzeptierte eine als Objekt geschriebene To-One-Relation und extrahierte stillschweigend deren id; dieses Format war nie dokumentiert und entsprach dem ViewModel des Admin-Panels. Das Admin-Panel wandelt sein ViewModel nun vor jedem Schreib- und Filtervorgang im Browser in die Werte der Übertragungsschicht um.
Die Wertklassen des Admins wurden zusammen mit dem Rest seines ViewModels verschoben: EntityReference, EntityRelation, GeoPoint, Vector und EntityReferenceProps werden aus @rebasepro/cms-types importiert (sie haben @rebasepro/types verlassen), ebenso wie normalizeToEntityRelation (hat @rebasepro/common verlassen); withRelationReferencesOnly wurde entfernt. Der Verlauf speichert die Zeile so, wie ein Lesevorgang sie zurückgibt; zuvor aufgezeichnete Einträge werden als einfache Werte ausgeliefert und zurückgerollt (Abschnitt 132).
Die Offline-Queue von @rebasepro/client speichert Werte im Übertragungsformat. Ein vom 0.30-SDK offline in die Warteschlange gestellter Schreibvorgang wird beim Zurücklesen und erneuten Abspielen konvertiert: Nichts, was vor dem Upgrade in der Warteschlange lag, geht verloren.
Was zu tun ist: Senden Sie den Schlüssel: { "author": 5 }, nicht { "author": { "id": 5 } }; senden Sie einen Vektor als Liste von Zahlen und filtern Sie eine Relation nach ihrem Schlüssel. rebase migrate sdk-calls verschiebt die Importe der Wertklassen (die Liste). Siehe Schreibvorgänge.
139. /api/docs is served to the schema endpoint’s audience
Abschnitt betitelt „139. /api/docs is served to the schema endpoint’s audience“Wen dies betrifft: Personen oder Tools, die /api/docs lesen oder /api/swagger öffnen – Swagger UI, API-Client-Generatoren, CI-Schritte.
Was sich geändert hat: Wenn enableSwagger nicht gesetzt ist (REBASE_ENABLE_SWAGGER nicht gesetzt), wird das OpenAPI-Dokument in jeder Umgebung denselben Aufrufern ausgeliefert, denen auch GET /api/schema/tables Tabellen beschreibt, mit denselben Ablehnungen – 401 für anonyme Aufrufer, sofern nicht schemaTables.public gilt, 403 für Credentials ohne Schema- oder Daten-Scope – und jeder Aufrufer erhält das Dokument exakt für die Tabellen, Spalten und Relationen, die dieser Endpunkt ihm beschreibt (ein Administrator erhält alles). Es gibt kein Swagger UI. Ein Server ohne konfigurierte Authentifizierung antwortet mit 404 DOCS_UNAVAILABLE. 0.30 stellte in der Entwicklungsumgebung das gesamte Dokument mit jeder bereitgestellten Tabelle und nicht-privaten Spalte anonymen Aufrufern zur Verfügung und beschränkte es in der Produktion auf Administratoren.
enableSwagger / REBASE_ENABLE_SWAGGER |
/api/docs |
/api/swagger |
|---|---|---|
| nicht gesetzt (Standard) | jeder Aufrufer, dem der Schema-Endpunkt Tabellen beschreibt: seine jeweiligen Tabellen | wird nicht ausgeliefert |
true |
das vollständige Dokument für jeden | wird außerhalb der Produktionsumgebung ausgeliefert |
false |
das vollständige Dokument, geschützt hinter dem Admin-Zugang | wird nicht ausgeliefert |
Was zu tun ist: Rufen Sie /api/docs im angemeldeten Zustand auf. Um das gesamte Dokument wie unter 0.30 in der Entwicklung öffentlich bereitzustellen, setzen Sie REBASE_ENABLE_SWAGGER=true (oder enableSwagger: true). Siehe Endpunkte.
140. A many-to-many pivot column may not declare .transform()
Abschnitt betitelt „140. A many-to-many pivot column may not declare .transform()“Wen dies betrifft: ein rel.manyToMany(…, { pivot: { … } }), dessen Pivot-Spalte ein .transform() deklariert.
Was sich geändert hat: Der Compiler verweigert dies („the pivot column “x” declares .transform() …“). Die Transformation einer Pivot-Spalte wurde an keiner Stelle ausgeführt, sodass ein Wert, den Sie maskieren wollten, unmaskiert wie gespeichert ausgeliefert wurde.
Was zu tun ist: Entfernen Sie das .transform() und maskieren Sie _pivot im hooks.afterRead der Zieltabelle. Siehe Relationen.
141. A link is exactly as readable and writable as its key column
Abschnitt betitelt „141. A link is exactly as readable and writable as its key column“Wen dies betrifft: Clients, die ein belongsTo über seinen Relationsnamen schreiben, Relationen lesen oder filtern, deren Schlüsselspalte beschränkt ist, oder sich auf strictWrites: false verlassen.
Was sich geändert hat: Eine Einschränkung auf einer Schlüsselspalte ist eine Einschränkung für jede Schreibweise, die sie liest oder beschreibt.
- Das Schreiben einer Verknüpfung über ihren Relationsnamen (
{ "reviewer": 7 }) unterliegt jeder Regel der Schlüsselspalte, die sie setzt –.readOnly(),.private(),access.write, Erstellungs-Zeitstempeln, der Tenant-Spalte, Schlüssel-Unveränderlichkeit – in REST, Bulk,_batch, dem Socket und MCP. Das Schreiben der Verknüpfung unter beiden Namen ({ "reviewer": 7, "reviewerId": 8 }) mit unterschiedlichen Werten führt zu einem 400VALIDATION_INVALID_VALUE. Das Verschieben einer Zeile zu einem anderen Tenanten über deren Verknüpfung beantwortet der Server mit 400TENANT_IMMUTABLE(zuvor war dies ein 500). - Eine Relation ist nur lesbar, wenn der Aufrufer jede Spalte lesen darf, die ihr Join liest, und zwar auf jeder Tabelle, die sie durchläuft: den Schlüssel eines
belongsTo, den Fremdschlüssel des Ziels bei einemhasMany/hasOne, jede Spalte, über die die Schritte einesviajoinen. Schlägt eine davon fehl, wird sie ausincludeund_countweggelassen, und ein Filter, eine Sortierung oder ein Relationspfad darüber antwortet mitFIELD_NOT_READABLE(eine unbekannte Relation, wenn die Spalte.private()ist). Ein To-One-via-Schreibvorgang, der eine Spalte kopieren würde, die der Aufrufer nicht lesen darf, wird mitFIELD_NOT_READABLEabgelehnt. Die inversen undvia-Fälle waren auch in 0.30.x bereits offen. - Eine Verknüpfung, deren Schlüsselspalte der Aufrufer nicht lesen darf, wird aus
includeweggelassen, und ein Filter, eine Sortierung, einfields-Eintrag oder ein Relationspfad darüber antwortet mitFIELD_NOT_READABLE; eine an einen.private()-Schlüssel gebundene Verknüpfung gilt als unbekannte Relation.GET /api/schema/tables, OpenAPI und das MCP-describe_tablebeschreiben eine Verknüpfung und ihren Schlüssel zusammen, sodass eine Schlüsselspalte, deren Verknüpfung gesperrt ist, auch dort vorenthalten wird. strictWrites: falseentscheidet über genau eine Sache: Ein nicht deklarierter Schlüssel wird an den Treiber weitergegeben (geschrieben, wenn die Datenbank die Spalte besitzt, andernfalls 400VALIDATION_UNKNOWN_FIELDS). Es hebt niemals eine deklarierte Spalte, einen Zeitstempel, den Tenanten, den Schlüssel, ein Relationsziel oder eine_pivot-Regel auf.
Was zu tun ist: Schreiben Sie eine Verknüpfung über einen Namen oder über beide mit demselben Wert; lesen Sie eingeschränkte Verknüpfungen mit einer Rolle aus, die deren Schlüssel lesen darf. Siehe Feldzugriff.