@palbase/backend 39.1.5 → 39.1.6

package/MIGRATION.md

@@ -1,3 +1,217 @@
+# 39.0.0 — `raw(name, up, { down })` KALDIRILDI, `DBOps` bir üye kazandı
+
+## 1. `raw()` artık İKİ argüman alıyor
+
+`down` seçeneği, hiç koşmayan bir down-migration'a besleniyordu: yazarına
+sahip olmadığı bir teardown'a sahip olduğunu düşündürüyordu.
+
+```ts
+// ÖNCE (39.0.0'da derlenmiyor)
+raw("chk_positive", "ALTER TABLE orders ADD CONSTRAINT chk_positive CHECK (total > 0)", {
+  down: "ALTER TABLE orders DROP CONSTRAINT chk_positive",
+});
+
+// SONRA — düşürmeyi BİLDİRİN
+dropConstraints: ["chk_positive"],
+```
+
+Çoğu `raw()` bu majorda zaten gereksiz: tablo düzeyi çok sütunlu `foreignKeys`,
+`index(n).unique().where(...)` (partial UNIQUE), tipli `check(name, expr)`,
+koşullu FK (`freeze`), reddedici `guards`, bir kez koşan `backfills` ve
+`dropConstraints` geldi. Önce bunlara bakın; `raw()` artık bir kaçış kapısı.
+
+## 2. `raw()` gövdeleri bir YETKİ kapısından geçiyor
+
+Rol yaratan, sahiplik devreden, yetki dağıtan ya da `search_path` kaydıran
+ifadeler **push'u reddediyor**. Açık kalan tek grant biçimi:
+
+```sql
+GRANT EXECUTE ON FUNCTION … TO <platform rolü>
+```
+
+Bu bir ALLOWLIST — kapı sınıflandıramadığını reddeder. Reddedilen bir gövdeyi
+"geçici olarak" başka biçimde yazmaya çalışmayın; bildirimsel yüzeyi kullanın.
+
+## 3. Kendi `DBOps` uygulamanız varsa `lockRowsWhere` ekleyin
+
+`DBOps` — ve onun üzerinden `DBClient`, `EnvServiceDatabase`, `EnvTypedDatabase` —
+ZORUNLU bir `lockRowsWhere` üyesi kazandı. Yalnız kendi uygulamasını yazan
+projeleri etkiler; SDK'nın kendi sınıflarını kullanıyorsanız yapacak bir şey yok.
+
+`TableJSON.rawConstraints[]` elemanı da `down` alanını kaybetti — şema JSON'unu
+elle okuyan bir aracınız varsa o alanı beklemeyin.
+
+# 38.0.0 — `push` artık PLAN istiyor (ve `auth` göçü kendini onarıyor)
+
+## 1. `palbase plan` → `palbase push`, bu sırayla
+
+`push` plansız koşmuyor. `palbase plan` yükseltmenin ne yapacağını modül modül
+gösterir ve hedef sürümün her ön kontrolünü yazar; `push` o planı taşır.
+
+```bash
+palbase plan     # ne olacağını OKUYUN
+palbase push     # planı taşır
+```
+
+Bundle, koşan SDK ya da şema planı siz planladıktan sonra kaydıysa push neyin
+değiştiğini ADLANDIRIR ve yeni bir plan ister. Platform da aynı şeyi kontrol
+eder, yani eski bir plan kaymış bir projeye karşı tekrar oynatılamaz.
+
+> Planın nereye yazıldığı 0.62.x'te değişti: artık checkout'unuzda değil,
+> `~/.palbase/checkouts/<hash>/plan.json` altında. Bu bir göç işi değil —
+> eski `.palbase/plan.json` dosyanız varsa silin.
+
+## 2. Yükseltmeler TAKAStan ÖNCE göç ediyor
+
+Bir proje daha yeni bir `@palbase/backend`'e geçtiğinde, o sürümün ihtiyaç
+duyduğu göçler önce canlı veritabanına — yeni sürümün kendi migrator'ıyla —
+uygulanır, ve ancak ondan sonra yeni sürüm devralır. Takas saniyeler süren bir
+restart'tır; istekler düşmez, bekler. Göç koşamazsa **hiçbir şey değişmez**:
+proje tam olduğu gibi servis etmeye devam eder.
+
+Sizin yapacağınız bir şey yok. Yalnız bilin: `push` sonrası kısa bir restart
+normaldir ve bir göç hatası artık projeyi yarıda bırakmaz.
+
+## 3. BREAKING — `auth` şeması, ve sizden bir şey İSTENMİYOR
+
+`000014` sosyal-auth göçü, OAuth yapılandırılmış her projede düpedüz reddediyor
+ve operatörden elle envanter çıkarıp sıfırlamasını istiyordu; red defteri kirli
+bırakıyor ve stack'i açılamaz hâle getiriyordu. Bu davranış kaldırıldı.
+
+# 37.0.0 — OAuth istemcileri PLATFORM BAŞINA yapılandırılıyor
+
+## 1. Sağlayıcı-geneli kimlik bilgisi yüzeyi KALDIRILDI
+
+Web, iOS, macOS ve Android artık mevcut `oauth` yapılandırması ve `palbase link`
+akışı üzerinden AYRI AYRI yapılandırılıyor. Tarayıcı kimlik bilgileri, native
+client ID'leri, Google server client ID'leri, Apple Services ID'leri ve native
+bundle ID'leri birbirinden ayrı kalır.
+
+Eski sağlayıcı-geneli kimlik bilgisi ve token değişim arayüzleri kaldırıldı.
+
+## 2. Göç sırası ÖNEMLİ
+
+```
+1. backend SDK'yı ve istemci SDK'ları BİRLİKTE yükseltin
+2. `palbase link` ile bağlı yapılandırmanızı YENİDEN ÜRETİN
+3. ancak ondan sonra migration 000014
+```
+
+Bu sıra bir öneri değil: SDK'lar 000014'ten önce yükseltilmezse OAuth kaydı
+eski şekilde kalır. OAuth artık seçili-istemci işlemleri kullanıyor — katı
+audience/issuer/nonce/redirect doğrulaması, kalıcı tamamlanma kanıtı, açık
+kimlik bağlama ve MFA-farkında sonuçlar.
+
+# 36.0.0 — `defineQuery` ve `defineWorkload` KALDIRILDI, dönüş tipi ÇIKARIMI geldi
+
+## 1. `Query.run(...)` → sıradan CRUD
+
+`defineQuery`, sorgu manifestleri, hazırlanmış sorgu sarmalayıcıları,
+`defineWorkload` ve atomic `workload`/`conflictKeys` seçenekleri kaldırıldı.
+**Uyumluluk katmanı YOK.**
+
+```ts
+// ÖNCE
+const Query = defineQuery({ /* projeksiyon */ });
+const rows = await Query.run(Database, input);
+
+// SONRA — servis içinde sıradan tipli CRUD
+const rows = await this.todos.findMany({ user_id: userId });
+```
+
+Çakışma için: ilişkili işlemleri AYNI transaction handle'ında tutun ve
+**sıralı** PostgreSQL satır kilitleri kullanın (`$lockRowsWhere`, 39.0.0).
+
+## 2. Controller dönüş anotasyonunu ÇIKARIN
+
+JSON şekli çıkarılabiliyorsa controller'ın dönüş tipini yazmayın: build
+doğrulayıcıyı ve istemci sözleşmesini kendisi türetir.
+
+```ts
+// ÖNCE
+async list(): Promise<TodoListSchema> { … }
+
+// SONRA — tipli CRUD için anotasyonu OMIT edin
+async list() { return this.todos.list(); }
+```
+
+Açık ya da desteklenmeyen sözleşmeler için adlandırılmış Zod şeması yazmaya
+devam edin (bilinmeyen JSON, özyinelemeli değerler, sınıflar). `any` kullanmayın.
+
+> **CLI ve core dev runtime'ı BİRLİKTE yükseltin** — tip çıkarımı ikisinin
+> aynı sürümde olmasını gerektiriyor.
+
+## 3. `workload` bildirimlerini silin
+
+Veritabanı admission'ı artık istek CRUD'u, atomic transaction'lar, service-role
+işlemleri ve zamanlanmış iş arasında PAYLAŞILIYOR ve operatör kuyruk ayarları
+uygulama kodundan ayrı. Kuyruk/eşzamanlılık ayarı core'un işi.
+
+# 35.0.0 — bildirim istemcisi WhatsApp üyesini ZORUNLU kılıyor
+
+Backend bildirim istemcisi, diğer kanallarıyla tutarlı olarak WhatsApp üyesini
+artık zorunlu taşıyor. `PalbaseNotificationsClient`'ın **kendi uygulamasını ya da
+test adaptörünü yazan** projeler o üyeyi eklemeli.
+
+Mevcut `send` imzaları DEĞİŞMEDİ. Bildirim mesajları ve tercihleri artık bir
+teslim-kanalı tipi kullanıyor; Meta şablon çevirileri eski gövde-şablonu
+API'sinden ayrı.
+
+> Sağlayıcı bağlantı ayarları mesaj dili ya da şablon adı TAŞIMAZ — bunlar
+> şablon kataloğuna ve her mesajın locale'ine aittir.
+
+Üyenin zorunlu olması bilinçli: runtime bu istemciyi her zaman yaratır, ve
+opsiyonel işaretlemek çağıranı SDK'nın zaten garanti ettiği bir yeteneği
+test etmeye zorlardı.
+
+# 34.0.0 — transaction SAHİPLİĞİ açık, timestamp'ler mikrosaniye
+
+## 1. Savepoint planında sıfırdan farklı retry REDDEDİLİYOR
+
+`Database.$atomic(async tx => …)` BEGIN'den kalıcı COMMIT'e kadar sahiplenir:
+karar okumaları, izolasyon ve doğrulanmış serialization/deadlock rollback'lerinin
+sınırlı yeniden denemeleri dahil. Kaybolan bir COMMIT onayı bir kez raporlanır
+ve yazma **asla otomatik tekrarlanmaz**.
+
+```ts
+// ÖNCE — artık reddediliyor
+await Database.$transaction(fn, { retries: 3 });
+
+// SONRA
+await Database.$atomic(async (tx) => { … });
+```
+
+İstek yazmaları ve `$transaction` savepoint planları mevcut sınırlarını korur.
+Eski retry sözünü tutmak, bayat bir snapshot'a karşı sessizce yeniden koşardı.
+
+## 2. Timestamp'ler ALTI ondalık basamak, UTC
+
+Şema-farkında timestamp'ler PostgreSQL mikrosaniyelerini korur ve altı
+ondalık basamaklı UTC string'leri döndürür.
+
+```
+ÖNCE:  2026-09-11T18:25:27.193Z      (üç basamak)
+SONRA: 2026-09-11T18:25:27.193920Z   (altı basamak)
+```
+
+Timestamp string'lerini KARŞILAŞTIRAN ya da tam üç basamak BEKLEYEN tüketiciler
+bu daha hassas biçimi kabul etmeli. Ham SQL sürücünün değer sözleşmesini korur.
+
+To-one ilişkileri artık LIMIT'i doğru uyguluyor — `0` dahil.
+
+## 3. Kendi DB adaptörünüz varsa yeni üyeleri ekleyin
+
+`DBOps`, `DBClient`, `TypedDB`, `TypedTable` ve üretilen ortam arayüzlerinin
+kendi uygulamaları, yeni zorunlu sorgu, sayfalama, tekil arama, komut ve
+tanılama üyelerini uygulamalı. Bunları opsiyonel döndürmek, SDK'yı yetenek
+kontrolü olmadan kullanılamaz kılardı.
+
+Pakete gömülü fake, PostgreSQL'e özgü garantileri AÇIKÇA reddeder.
+
+## 4. Sayısal kolonlar callback filtrelerinde METİN operatörlerini reddediyor
+
+TypeScript'in excess-property açığı geçersiz SQL üretiyordu; kapandı.
+
 # 33.0.0 — `Flags.$asService()` TİPTE de var (yayınlanmış bir kusurun düzeltmesi)
 
 32.0.0'da `Flags.$asService()` YAZILDI ama TÜKETİCİYE ULAŞMIYORDU: ambient

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palbase/backend",
-  "version": "39.1.5",
+  "version": "39.1.6",
   "description": "Palbase Backend SDK — class controllers (@Controller/@Get/@Post + @Body/@QueryParams/@Param), error classes, schema DSL",
   "license": "MIT",
   "repository": {