@devoplus/one-sdk 0.0.0-stage → 0.2.0-next.112

package/CHANGELOG.md

@@ -0,0 +1,268 @@
+# @devoplus/one-sdk — sürüm geçmişi
+
+Biçim: [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/); sürümleme [SemVer](https://semver.org/lang/tr/).
+`0.x` sürümlerinde küçük sürüm (minor) artışı kırıcı değişiklik taşıyabilir; kırıcı her değişiklik burada
+**Kırıcı** başlığıyla yazılır.
+
+## [0.2.0] — npm'e çıkan ilk sürüm (kararlı yayın bekliyor)
+
+> 0.1.0 npm'e hiç yayımlanmadı: npm'de görünen ilk sürüm 0.2.0'dır (karar defteri D-94, 20.10.2026). `test` dalından
+> `0.2.0-next.<n>` ön sürümleri `next` etiketiyle çıkar; kararlı 0.2.0 `main`'den `latest` etiketiyle çıkar ve tarihi o
+> zaman yazılır. Aşağıdaki maddeler 0.1.0'dan bu yana birikenlerdir; kararlı yayına kadar yeni maddeler bu başlığa eklenir.
+
+### Değişti (C7 — DEXA sorgusunda uygulamanın bağlam kodu göndermesi, 18.10.2026)
+
+- `queryDexa` / `buildDexaQueryRequest` artık `UserCode` · `CompanyCode` · `CostCenterCode`'u kabul eder (ad harf
+  duyarsız tanınır, olduğu gibi gönderilir). Sunucu bu kodları yalnız kurulumda yönetici **"kodları uygulama belirler"**
+  onayını verdiyse kabul eder (yoksa bugünkü gibi 400 `ONE-APP-E-026`); onaylıysa her kipte (kişi · ajan · arka plan
+  işi) gönderilebilir ve kişi ile şirket kodu kurulumun portalına karşı doğrulanır. Kod gönderilmezse kişi/ajan kipinde
+  oturumdan çözülür, arka plan işinde sorgu reddedilir. `CostCenterCode` bildiren sorgular artık çalışır.
+- **Yeni hata `ONE-SDK-E-140`:** bu üç koddan birinin değeri boş dize ya da yalnız boşluksa istek gönderilmeden
+  reddedilir — boş değer ERP'ye gitmez (sunucu da reddeder). Sıradan parametrelerde boş değer serbest kalır.
+- Yeni sabit `DEXA_APP_CONTEXT_PARAMETERS` (`UserCode` · `CompanyCode` · `CostCenterCode`).
+- **Kırıcı:** `DEXA_RESERVED_PARAMETERS` artık yalnız `['LangCode']`'dur (platformun doldurduğu, uygulamanın
+  gönderemediği parametre; `ONE-SDK-E-043`). Bu sabitten "gönderilmeyecek kodlar" listesi kuran kod üç kodu artık
+  içermez. DEXA işlemleri (`runDexaCommand`) değişmedi.
+
+### Eklendi (C6 — arka plan işinde ve ajan aracında Devoplus servisleri, 18.10.2026)
+
+- **Arka plan işi servisleri:** manifest `jobs.services` (`mail.execute` · `sms.execute` · `push.execute` · `dexa.read`
+  · `ai.use`; her biri `scopes`'ta da beyanlı) ile kuyruk ve zamanlanmış iş Devoplus servislerini **uygulamanın
+  kimliğiyle** çağırabilir. Beyan istektir: servis kurulumda portal yöneticisi onaylamadıkça açılmaz. DEXA'ya yazma bu
+  yolla açılmaz.
+- **Ajan aracında servisler:** araç işleyicisi servisleri aracı çağıran kişi adına çağırabilir; süreli onay gerektiren
+  scope'lar (e-posta · SMS · mobil bildirim · DEXA'ya yazma) bu yolda kullanılamaz. Araç bağlamında `ctx.admin` (kişi
+  kurulumun portalının şirket yöneticisi) ve `ctx.actor` (Vekalet / Yerine Görüntüle) dolu gelir.
+- `OneContext.mode` (`'user' | 'job' | 'agent'`), `OneContext.admin`, `OneContext.jobServices`; tip `OneRequestMode`;
+  `requireServiceScope(ctx, scope)`. `completeAi` artık `requireServiceScope` kullanır: zamanlanmış işte oturum ve
+  belirteç olmadan çalışır.
+
+### Eklendi (S10 — sekme başına izin, 18.10.2026)
+
+- Manifest `navigation[].permission` (uygulamanın beyan edilmiş izin kodu): sekme yalnız izni taşıyana ve yöneticiye
+  görünür. Köprüye `one.setNavigationAccess({ permissions, admin })` eklendi; izinli sekmeler erişim bildirilene kadar
+  menüye konmaz, izin kodu Portal'a gitmez (Portal sözleşmesi `{ path, label }` değişmedi; `one:navigation` yeniden
+  gönderilebilir). Sunucu yardımcıları: `visibleNavigation`, `NAVIGATION_PERMISSION_RE`, tip `OneNavigationAccess`.
+
+### Değişti (S14 · S15 — veri modeli, 18.10.2026)
+
+- **Seçim alanında veritabanı kısıtı yok:** `one data generate` seçim (`choice`) kolonuna CHECK yazmaz; seçenek denetimi
+  `createCrudHandler`'dadır (değişmedi). Seçim alanına yeni değer eklemek artık migration gerektirmez — tipler ve anlık
+  görüntü yenilenir. Değer kaldırmak reddedilir. Önceki sürümün kurduğu tablolarda kısıt durur: anlık görüntü (`v: 2`)
+  o alanları `choiceChecks` ile taşır ve onlara değer eklemek yine reddedilir.
+- **Türkçe katlanmış arama:** her metin alanı (`text` · `longText`) için `<alan>_fold` arama kolonu üretilir;
+  `createCrudHandler` onu yazar, `alan.contains` ve `q` onda arar (büyük/küçük harf ve ç ğ ı İ ö ş ü duyarsız). Kolonu
+  boş kayıt da bulunur. Yeni dışa aktarımlar: `foldSearchText`, `FOLD_COLUMN_SUFFIX`, `DATA_MAX_COLUMNS`,
+  `DATA_SNAPSHOT_VERSION`, `DataLegacy`.
+- **Kırıcı:** alan adı `_fold` ile bitemez; tabloda en çok 100 kolon (arama kolonları dahil) — çok sayıda metin alanı
+  olan varlık (47'den fazla) reddedilir. Eski anlık görüntüyle (`v: 1`) ilk `one data generate` arama kolonlarını ekleyen
+  yeni bir migration yazar; o üretim yapılmadan `one data generate --check` "güncel değil" der.
+
+### Eklendi (D-86 · D-87 — yayın, önizleme, geri alma ve kullanım panosu; ⚠️ öneri, geliştirici onayı bekliyor)
+
+- `one publish` (test ortamına yayın; adres paylaşılabilir önizleme), `one promote` (bir sonraki ortama), `one rollback
+  [--to <x.y.z>] --yes` (önceki sürüme; `--yes` olmadan istek gönderilmez), `one deployments` (yayın istekleri) ve
+  `one status [--days 7]` (kullanım ve hata özeti). Hepsi `[--portal <anahtar>]` · `--app` · `--json` alır.
+- Ortak istemci `@devoplus/one-sdk/app-ops`: `requestDeployment`, `listDeployments`, `getInsights`,
+  `describeDeployment`, `describeDeploymentResult`, `describeInsights`, `previewAddress`, `parseOpsArgs` ve
+  `AppOpsError`. Kısa ad, portal anahtarı, sürüm ve gün sayısı istek gönderilmeden denetlenir.
+- ⚠️ Sunucu uçları henüz yayında değildir; o ortamda yanıt "yapılandırılmamış" ya da bir hata olur.
+
+### Düzeltildi (D-82 — hazır liste bileşeni ile kayıt uçları aynı dili konuşur)
+
+- `createCrudHandler` uçları hazır liste bileşeninin (`<one-table src>`) sorgu lehçesini de kabul eder: `limit` ·
+  `page` · `cursor` (sayfa numarası) · `sort` + `order` · `q` (metin alanlarının herhangi birinde içerir) ·
+  `<alan>From` / `<alan>To` · `lang` · `format=xlsx|csv` (listeyle aynı adreste dışa aktarma). Önce bileşen
+  `src="/api/<varlık>"` ile bağlanınca her istek 400 "Bilinmeyen sorgu parametresi" alıyordu. Liste yanıtı ayrıca
+  `nextCursor` taşır (son sayfada `null`). Eski lehçe (`_page` · `_size` · `_sort` · `.from` / `.to` · `export.xlsx`)
+  aynen çalışır; lehçe adı modeldeki bir alanın adıysa alan süzgeci önceliklidir. Kırıcı değil.
+
+### Eklendi (D-88 — yapay zekâ çift yönlü; ⚠️ öneri, geliştirici onayı bekliyor)
+
+- **Yapay zekâ servisi:** `completeAi(api, ctx, istek)` / `ai.complete` → `One/services/ai` (scope `ai.use`): özet,
+  sınıflandırma, alan çıkarma, metin üretme, sohbet. İstemci sınırları (`ONE-SDK-E-080…086`) ve `OneAiRequest` /
+  `OneAiResult` tipleri.
+- **Devoplus yapay zekâsına açılan araçlar:** `defineAgentTools`, `handleAgentRequest` (`POST /__one/agent/<ad>`; imzalı
+  çağrı işareti, manifest beyanı, oturum, Vekalet kapısı, izin ve girdi şeması denetimi), `agentManifestResponse`
+  (`/.well-known/one-agent.json` + `/.well-known/one-agent.md`), `validateAgentInput` ve `ONE-SDK-E-090…096`.
+
+### Eklendi (D-80 — zamanlanmış görev ve kuyruk)
+
+- `defineJobs({ schedules, queues })` + `handleJobRequest(request, env, execution, definition?)`: manifest `jobs` ile
+  beyan edilen işlerin işleyicileri. Platform işi `POST /__one/jobs/<schedule|queue>/<ad>` ile çağırır; işleyici
+  dönerse iş tamam, 4xx `OneError` kalıcı hata, başka hata yeniden denenir. `job.id` her denemede aynıdır.
+- `enqueue(name, body, { delaySeconds })`: kuyruğa ileti bırakır (gövde ≤ 64 KiB, gecikme ≤ 24 saat) → `{ id }`.
+- Tipler `OneJob`, `OneJobHandler`, `OneJobKind`, `OneJobsDefinition`, `EnqueueOptions`, `EnqueueResult`; sabitler
+  `JOB_NAME_RE`, `JOB_BODY_MAX_BYTES`, `JOB_DELAY_MAX_SECONDS`, `JOB_PATH_PREFIX`; hata kodları `ONE-SDK-E-070…076`.
+- `readContext` kuyruk işinde (`X-One-Auth: job`) iletiyi bırakan kullanıcının `sub` ve yetki alanlarını `user` olarak
+  okur; izin ve yönetici bilgisi taşınmaz. Kırıcı değil.
+
+### Eklendi (D-83 — hazır arayüz bileşenleri)
+
+- **`/one-components.js`** (`ONE_COMPONENTS_SCRIPT`; `clientAssetResponse` sunar): bağımlılıksız bileşenler
+  `<one-table>` (sıralama, metin süzme, imleçli ya da sayfa numaralı uzak liste, yerel veri, satır seçimi, satır
+  tıklama, Excel/CSV dışa aktarma — dosya `one.download` ile), `<one-form>` (alan şeması, Türkçe/İngilizce doğrulama
+  iletileri, sunucunun RFC 9457 `errors` alanının alanlara bağlanması, kaydedilmemiş değişiklik bildirimi, başkası adına
+  açılmış oturumda salt-okunur), `<one-filter>` (metin, seçim, tarih, tarih aralığı, evet/hayır → tabloya bağlanır),
+  `<one-person-picker>` (kişi arama, klavyeyle seçim, çoklu seçim), `<one-file-upload>` (tür/boyut sınırı, ilerleme),
+  `<one-chart>` (çubuk/çizgi/pasta SVG, erişilebilir veri tablosu). Metinler Türkçe + İngilizce, tema/dil Portal'dan.
+- **Kişi arama ucu** `peopleSearchHandler(request, env, ctx)` (`/api/one/people`, scope `orgschema.read`): yalnız
+  aktif kişiler, ad + unvan + departman (e-posta/telefon dönmez), en çok 20 sonuç; saf `searchPeople`. Hata kodları
+  `ONE-SDK-E-090` (arama 2–100 karakter) · `ONE-SDK-E-091` (yalnız GET).
+- Görsel dile bileşen stilleri ve grafik renkleri (`--one-chart-1` … `--one-chart-6`, açık/koyu) eklendi.
+- Bileşen özellik tipleri: `OneTableColumn`, `OneFormField`, `OneFilterField`, `OnePerson`, `OneUploadedFile`,
+  `OneChartData`, `OneComponentEventMap` …
+### Eklendi (D-84 — tanımlayıcı veri modeli; ⚠️ geliştirici onayı bekliyor)
+
+- `one.data.json` veri modeli (varlık + alan: metin, uzun metin, sayı, para, tarih, tarih-saat, evet/hayır, seçim, kişi,
+  dosya; zorunlu, tekil, dizin, varsayılan) ve doğrulayıcısı `parseDataModel`.
+- `one data generate [--check]`: yalnız ekleyen migration (`migrations/NNNN_one_data.sql`), `src/data/types.ts` ve
+  `migrations/.one-data-snapshot.json`. Silme, ad/tür değişikliği, zorunlu yapma ve seçim değeri değişikliği üretilmez,
+  komut nedenini söyleyip durur.
+- `createCrudHandler({ model, entity, records, canRead?, canWrite?, actingSessions? })`: sayfalı liste, süzme, sıralama,
+  kayıt, güncelleme, yumuşak silme; sunucu tarafı doğrulama ve Türkçe alan hataları (`errors`); `ONE-SDK-E-100…110`.
+
+### Eklendi (D-85 — rapor ve dışa aktarma; ⚠️ geliştirici onayı bekliyor)
+
+- `toCsv` (UTF-8 BOM, Türkçede `;` ayırıcı, formül enjeksiyonu koruması), `toXlsx` (bağımlılıksız), `exportResponse`
+  (RFC 6266 Türkçe dosya adı), `downloadFileName`, `renderPrintableReport` (betiksiz yazdırma sayfası; PDF tarayıcının
+  "PDF olarak kaydet"iyle). `ONE-SDK-E-120…121`.
+
+### Değişti (D-78 d — komut satırı kimliği)
+
+- `one login` artık sabit bir istemci kimliği istemez: `--client-id` / `ONE_CLIENT_ID` verilmezse komut kimlik
+  sağlayıcıya bir kez kendini kaydeder (dinamik istemci kaydı, yalnız cihaz kodu + yenileme izni, sırsız) ve kimliği
+  bu bilgisayarda ortam başına saklar (`~/.config/devoplus-one/clients.json`, yalnız sizin okuyabildiğiniz dosya).
+  Saklanan kayıt kimlik sağlayıcıda geçersizleşmişse komut bir kez yeniden kaydolur.
+- İstenen kapsam daraldı: `openid profile email offline_access onedev.write`. Bu oturum yalnız erişim talebi
+  komutlarına (`one request`, `one requests`) yeter; portal verisine erişmez. (D-86 · D-87 ile yayın ve kullanım
+  panosu komutları da bu oturumla çalışır.)
+
+### Eklendi (D-75 — erişim talebi)
+
+- `one login` (tarayıcıda kod onayıyla giriş), `one logout`, `one request <tür>`, `one requests [kimlik]`.
+- `@devoplus/one-sdk/access-request` alt yolu: talep gövdesi kurucusu + istemci (`buildAccessRequest`,
+  `submitAccessRequest`, `listMyAccessRequests`, `getAccessRequest`, `describeAccessRequest`) ve tipleri.
+
+### Eklendi (D-76 — uygulama arayüz standartları)
+
+- **Portal köprüsü** `window.one` (`ONE_BRIDGE_SCRIPT`, `/one-bridge.js`): menü (`one.start({ navigation })`), gezinme
+  (`one.onNavigate`, `one.setRoute`), alt başlık (`one.setTitle`), Portal'da çizilen bildirim ve onay penceresi
+  (`one.toast`, `one.confirm`), indirme (`one.download`, ≤ 25 MB), dış bağlantı (`one.openExternal`, yalnız https),
+  kaydedilmemiş değişiklik (`one.setDirty`), görünen alan (`one.viewport`), belirteçli `one.fetch`. Yükseklik bildirimi
+  köprüye taşındı.
+- **Görsel dil** `ONE_UI_CSS` (`/one-ui.css`): açık/koyu değişkenler + düğme, alan, tablo, kart, mesaj, içerik sekmesi;
+  Portal'ın tasarım değerleri (`one:context.design`) değişkenlere yazılır.
+- Sunucu yardımcıları: `clientAssetResponse`, `scriptResponse`, `navigationFromManifest`, `isRoutePath`, `ROUTE_PATH_RE`,
+  `NAVIGATION_MAX_ITEMS`, `TITLE_MAX_LENGTH`, `DOWNLOAD_MAX_BYTES`.
+- **Vekalet / Yerine Görüntüle bağlamı:** `ctx.actor` (`{ sub, kind }`) ve `isActingSession(ctx)`. Kırıcı değil: alan
+  isteğe bağlıdır; `readContext` her zaman yazar. Bu oturumlar varsayılan salt-okunurdur (platform yazma isteğini 403
+  `ONE-DSP-E-009` ile reddeder; manifest `actingSessions: "write"` açar).
+
+### Kırıcı (D-72 — white label)
+
+- SDK artık çalışma ortamı tiplerini **kendisi** taşır: `OneDatabase` · `OneStatement` · `OneQueryResult` ·
+  `OneFilesBinding` · `OneStoredFile(Body)` · `OneCacheBinding` · `OneExecutionContext` · `OneApp<Env>`. Ek tip paketi
+  eş bağımlılığı kaldırıldı; uygulamanın `tsconfig`'i `"lib": ["ES2022", "WebWorker"]` ve `"types": []` ile yetinir.
+  Uygulamada `Env` tipleri bu adlarla yazılır, giriş noktası `satisfies OneApp<Env>` ile sınanır.
+- `OneFiles` ve `OneCache` kurucuları `OneFilesBinding` / `OneCacheBinding` alır (çalışma ortamının verdiği nesne
+  bunlara uyar; uyum paket içinde ayrıca denetlenir).
+- Manifest servis adları: `services.d1 / r2 / kv` → `services.database / files / cache`. Eski adlar açık bir hatayla
+  reddedilir (sessizce yok sayılsalar uygulama veritabanını ya da dosya deposunu kaybederdi).
+
+### Eklendi (D-72)
+
+- `one` komutu (paketle gelir): `one dev` uygulamayı yerelde çalıştırır, `one migrate` `migrations/`'ı yerel
+  veritabanına uygular, `one build` yükleme provası yapar. Yapılandırma ve yerel veri `.one/` altındadır ve her komutta
+  `one.manifest.json`'dan üretilir; uygulama deposunda çalışma ortamına ait yapılandırma dosyası yoktur.
+
+### Eklendi (D-59 — kullanıcı onayı)
+
+- `CONSENT_SCOPES` ve `awaitsUserConsent(ctx, scope)`: ERP'ye veri yazma ve kullanıcı adına e-posta/SMS/mobil bildirim
+  scope'ları artık kullanıcının ayrıca ve süreli (30 gün, portal başına) onayıyla belirtece girer. Uygulama onay
+  beklenen işin düğmesini kapatıp kullanıcıyı portaldaki "İzinleri incele" düğmesine yönlendirebilir.
+- `requireScope` onaya bağlı scope eksikse aynı kodla (`ONE-SDK-E-003`) ama izni nereden vereceğini söyleyen bir metinle
+  hata verir. Kırıcı değil: kod ve durum aynı.
+
+### Düzeltildi (bağımsız inceleme, D-47/D-49)
+
+- `approvalChain` pasif yöneticiyi fiilen atlayamıyordu: `getOrgUsersWithManagers` ucu varsayılan olarak yalnız aktifleri döner ve zincir pasif yöneticide "bilinmeyen kişi" diye kesiliyordu. `getOrgUsersWithManagers(api, { includeInactive: true })` eklendi; `approvalChainReport` durma nedenini (`top` · `depth` · `unknown` · `cycle`) döner.
+- Bildirim senaryolarında uzun uygulama/kişi adları SMS'te `SMS_NAME_MAX_LENGTH` (40) ile kısaltılır — bağlantı yokken de 300 aşılıp "bağlantıyı kısaltın" hatası veriliyordu. Kısaltma artık bir emojiyi (vekil çift) ortasından bölmez.
+- `hasPermission` açıklaması: yönetici için her kodda `true`; ad alanı süzgeci gizlilik sınırı değildir.
+
+### Düzeltildi (Codex incelemesi, PR #15)
+
+- `problemResponse` `OneError.retryAfterSeconds`'ı düşürüyordu: DEXA işleminin 409 `ERPCMD-APP-E-016` hatası standart
+  rota kalıbıyla (`catch → problemResponse`) tarayıcıya bekleme süresi olmadan ulaşıyordu. Değer pozitif tam sayıysa
+  yanıt artık `Retry-After` başlığını ve gövdede `retryAfterSeconds` alanını taşır; değer yoksa gövde şekli aynıdır.
+- `runDexaCommand` / `getDexaCommandStatus` eksik ya da tutarsız bir 200 yanıtını başarı sayabiliyordu (ör.
+  `{ "outcome": "succeeded" }` ya da başka bir `idempotencyKey`): eksik alanlar boş varsayılanlarla doldurulup
+  `succeeded` dönüyordu. Yanıt artık backend kaydının tiplerine (`ErpCommandResponse` · `ErpCommandStatusResponse`) ve
+  gönderilen anahtarlara göre doğrulanır; uymayan her yanıt `inDoubt` olur ve gövdesinden hiçbir alan taşınmaz.
+  **Kırıcı (yayımlanmamış API):** `normalizeDexaCommandResult(raw, sentIdempotencyKey, sentKey)` üçüncü parametre aldı.
+
+### Eklendi
+
+- **DEXA işlemleri — ERP'ye veri yazma (D-56 — geliştirici onayı bekliyor):** `runDexaCommand(api, key, parameters,
+  { idempotencyKey })` → backend `One/services/dexa/command` (scope `dexa.write`, zorunlu `Idempotency-Key` başlığı) ve
+  `getDexaCommandStatus(api, idempotencyKey)` (kayıt yoksa `null`). Yanıt tipleri backend `ErpCommandResponse` /
+  `ErpCommandStatusResponse` ile alan adı alan adına aynıdır (`DexaCommandResult` · `DexaCommandStatus` ·
+  `DexaCommandErpView`); tanınmayan 200 yanıtı ya da bilinmeyen `outcome` **`inDoubt`** sayılır (yeni anahtarla tekrar
+  denemeye yol açmasın). `newIdempotencyKey()` · `normalizeIdempotencyKey()` (kanonik UUID, boş UUID değil, küçük harf).
+  İstemci kuralları istek gönderilmeden fırlatır (`buildDexaCommandRequest`, `ONE-SDK-E-045…049`): anahtar biçimi,
+  en çok 32 parametre, ad biçimi, değer metin ≤ 65.536 karakter; sorgulardaki ayrılmış bağlam parametresi yasağı
+  işlemlerde yoktur.
+- **Mobil bildirim (D-55 — geliştirici onayı bekliyor):** `sendPush(api, { toSubjects, toOrgUserIds?, title, text })` →
+  backend `One/services/push` (scope `push.execute`); yalnız başlık + metin, derin bağlantı yok. Atlama gerekçesi
+  `not-deliverable`. Senaryolarda `toPush` (başlık ≤ 100 = konu, metin ≤ 300 = SMS metni; `PUSH_TITLE_MAX_LENGTH` ·
+  `PUSH_TEXT_MAX_LENGTH`) ve `notify` `push` kanalı (kanallar bağımsız). ⚠️ Push bugün hiçbir ortamda açık değildir
+  (`ONE-APP-E-029`).
+- **`OneError.retryAfterSeconds`:** `BackendClient` hata yanıtındaki `Retry-After` başlığını (saniye) ya da gövdedeki
+  `retryAfterSeconds`'ı taşır (ör. DEXA işlemi 409 `ERPCMD-APP-E-016`). `OneError` kurucusuna isteğe bağlı dördüncü
+  parametre eklendi; mevcut çağrılar değişmez. Nesne olmayan bir JSON hata gövdesi artık `TypeError` üretmez.
+- **Uygulama izinleri (D-49 — geliştirici onayı bekliyor):** `OneUser.permissions` (yalnız uygulamanın ad alanındaki izinler, dispatch `X-One-Permissions`) + `OneUser.admin` (şirket/küresel yönetici rolü, `X-One-Admin`); `hasPermission` · `requirePermission` (`ONE-SDK-E-004`). Portal yöneticisi her izne sahip sayılır (backend baypası paritesi). ⚠️ Eski dispatch bu başlıkları yazmaz: `permissions` boş, `admin` `false` gelir (fail-closed).
+- **Organizasyon şeması (D-47 — geliştirici onayı bekliyor):** `getOrgSchema` · `getOrgUsersWithManagers` · `getMyOrgContext` (oturumdaki kişinin org kimliği, `Users/me` → `orgContext.legacyUserId`) · `getUserGroupMembers` · `getUserGroupsOfUser` (scope `orgschema.read`) ve saf yardımcılar `managerOf` · `approvalChain` (döngü güvenli, pasif yöneticiyi atlar) · `orgUsersMatching` · `localizedText`. Hata kodları `ONE-SDK-E-050/051`.
+- **Bildirim senaryoları (D-47):** `approvalRequest` · `approvalResult` · `reminder` · `systemNotice` · `operationResult` · `verificationCode` (TR/EN; e-posta + SMS metni tek girdiden, backend sınırlarına göre kırpılır), `toMail` · `toSms` · `notify` (kanallar bağımsız), doğrulama kodu yardımcıları `generateVerificationCode` · `generateSalt` · `hashVerificationCode` · `verificationCodeMatches`. Hata kodları `ONE-SDK-E-060…063`.
+- **Org kimliğiyle alıcı:** `MailRequest` / `SmsRequest` `toOrgUserIds?` alanı (backend D-47); atlama gerekçesi `invalid-org-user`. ⚠️ Alanı tanımayan (D-47 öncesi) backend sürümüne karşı kullanmayın.
+- **Olay kaydı (Event Logger) koruması ve hata kaydı (D-45):** `logError(ctx, message, error, data?)`; `logEvent` /
+  `logError` / `logAudit` `data`daki sır kokan alanları `"[gizli]"` yapar (`redact`) ve 8 KiB üstü `data` yerine boyutu
+  yazar (`safeData`); `problemResponse(error, ctx?)` bilinmeyen hatayı bağlamıyla kaydeder (yığın kırpılmış). Yeni
+  dışa açılanlar: `describeError` · `EVENT_DATA_MAX_BYTES` · `EVENT_MESSAGE_MAX_LENGTH` · `EVENT_STACK_MAX_LENGTH`.
+  Davranış değişikliği: `logEvent` ileti metni 1.000 karakterde kırpılır.
+- **DEXA (ERP okuma) servisi:** `queryDexa(api, key, parameters?)` — backend `One/services/dexa/query` ince istemcisi
+  (scope `dexa.read`; D-09, uç D-42 — geliştirici onayı bekliyor). Yalnız kayıt defterinde izinli, önceden tanımlı
+  QueryStore anahtarları çalışır. Sonuç `DexaQueryResult { columns, rows, unavailable, truncated }`: `unavailable`
+  sorgunun ÇALIŞAMADIĞINI söyler (200 döner, SDK fırlatmaz — boş satır "kayıt yok" sayılmaz), `truncated` 5.000 satır
+  kesmesidir; eksik alan savunmacı okunur (`normalizeDexaQueryResult`). İstemci tarafı kurallar sunucuyla birebir
+  ve istek gönderilmeden fırlatır (`buildDexaQueryRequest`, `ONE-SDK-E-040…044`): anahtar biçimi, en çok 32 parametre,
+  ad biçimi, bağlam parametreleri (`LangCode` · `CompanyCode` · `CostCenterCode` · `UserCode`; harf duyarsız) ve
+  2.000 karakterlik değer. Sabitler: `DEXA_KEY_RE` · `DEXA_PARAMETER_NAME_RE` · `DEXA_MAX_PARAMETERS` ·
+  `DEXA_PARAMETER_VALUE_MAX_LENGTH` · `DEXA_RESERVED_PARAMETERS`.
+- **Denetim günlüğü kalıcılığı:** `recordAudit(api, ctx, action, target?, data?)` — `logAudit` izine ek olarak
+  backend `One/services/audit` ucuna yazar (scope `audit.write`; D-36). Girdi kuralları sunucuyla birebir
+  (`buildAuditRequest`, `ONE-SDK-E-030…032`); uzak yazma best-effort (`recorded:false` + uyarı).
+- **Önbellek servisi:** `OneCache` (kurulum başına KV namespace, binding `CACHE`; D-35): `get` / `put` / `delete`;
+  TTL zorunlu (60 sn … 30 gün, sınır dışı değer hata), değer JSON ≤ 1 MiB, anahtar kuralı fail-closed
+  (`normalizeCacheKey`, 512 bayt). KV nihai tutarlıdır — önbellek olarak kullanılır, kayıt deposu olarak değil.
+
+## [0.1.0] — 2026-10-15
+
+npm'e yayımlanmadı (bkz. 0.2.0). İlk paketlenebilir sürüm (platform deposu `devoplus/devoplus-one`, karar defteri D-11 · D-16 · D-17 · D-32 · D-33).
+
+### Eklendi
+
+- **Kimlik bağlamı:** `readContext(headers)` dispatch Worker'ın yazdığı `X-One-*` başlıklarından `OneContext`
+  üretir; `requireUser` (401) ve `requireScope` (403) kapıları; `OneError(status, code, detail)`.
+- **Backend istemcisi:** `BackendClient` — `api/v1/...` yolları, zarfsız DTO, `204 → undefined`, RFC 9457
+  `ProblemDetails` → `OneError`. Sır taşımaz; platform kimliğini outbound Worker ekler.
+- **Hata yanıtı:** `problemResponse(error)` — `OneError`'ı `application/problem+json` yanıtına çevirir; bilinmeyen
+  hata 500 + sabit metin (iç mesaj sızmaz).
+- **Günlük:** `logEvent` (sistem olayı) ve `logAudit` (kritik kullanıcı işlemi; aktör zorunlu) — yapısal console
+  çıktısı (Workers Logs).
+- **Dosya servisi:** `OneFiles` (kurulum başına R2 kovası, binding `FILES`): `put` / `get` / `head` / `delete` /
+  `list`; anahtar kuralı fail-closed (`normalizeFileKey`: 512 karakter **ve** 1.024 bayt — R2 sınırı UTF-8 ile
+  ölçülür), `sanitizeFileName`, 25 MiB tavan (`FILE_MAX_BYTES`), `put` akış gövde kabul etmez;
+  `readBoundedBody(request, maxBytes)` istek gövdesini sınırı belleğe almadan ÖNCE (Content-Length) ve parçalı
+  akışta okuma SIRASINDA uygulayarak alır.
+- **İletişim servisi:** `sendMail` / `sendSms` — CA backend `One/services/mail|sms` ince istemcisi; alıcılar
+  `sub` listesidir, adres/telefon sunucuda çözülür; yanıt `NotifyResult { queued, skipped[{sub, reason}] }`.