# Buraxılış qeydləri

> CoSuite Connect v1 müqaviləsində və @cosuite/connect paketində 1.0-dan 1.8-ə qədər dəyişikliklər. Hər versiya geriyə uyğundur.

Source: https://cosuite.io/az/developers/release-notes

Aşağıdakı bütün versiyalar **v1** müqaviləsinə (`cosuite-connect/1.0`) aiddir və geriyə uyğundur: əvvəlki versiya üçün qurulmuş tətbiq dəyişiklik etmədən işləməyə davam edir. Yeni funksiyalar yeni istəyə bağlı sahələr və ya yeni imkanlar vasitəsilə yalnız istəyə görə aktivləşir. Bax: [versiyalama qaydaları](https://cosuite.io/az/developers/contract#versioning).

## 1.8.0: müştəri API şlüzü {#v1-8-0}

*28 oktyabr 2026*

- Müştərilər modulunuzun API-sini öz CoSuite açarları ilə `https://api.cosuite.io/v1/apps/{app}/{path}` ünvanından çağırır. Şlüz sorğunu tətbiqinizə Connect imzası və bu başlıqlarla ötürür: `X-CoSuite-Gateway`, `X-CoSuite-Tenant`, `X-CoSuite-Scopes`, `X-CoSuite-Api-Key-Id`. Bax: [Şlüz və müştəri API-si](https://cosuite.io/az/developers/customer-api).
- Yeni ixraclar: `verifyGatewayRequest`, `signGatewayRequest`, `gatewayServer`.
- Uyğunluq testi `api` tərifi olan modulların parametrsiz `GET` əməliyyatlarını üç formada çağırır: test biznesi ilə cavab gözlənilir, naməlum biznes ilə `404 tenant_not_found` gözlənilir, imzasız sorğuda `401` gözlənilir.
- `cosuite` təhlükəsizlik sxemi yekunlaşdı (bearer, CoSuite API açarı).

## 1.7.0: modul tərifi {#v1-7-0}

*28 oktyabr 2026*

- Modullar özlərini manifestdə təsvir edə bilər: `description`, `features`, `api` (OpenAPI 3.1 sənədi və scope-lar), `webhooks`, `provides`, `dataCategories` və `markets`. Bütün sahələr istəyə bağlıdır. Bax: [modul tərifi](https://cosuite.io/az/developers/module-definition).
- Uyğunluq testi modul tərifini (yalnız doldurduğun sahələri) yoxlayır, hər modulun OpenAPI sənədini yükləyib yoxlayır: hər əməliyyat `security: [{ "cosuite": [...] }]` vasitəsilə elan olunmuş scope tələb etməlidir.
- Yeni eksportlar: `checkModuleDefinitions`, `checkOpenApi`, `loadOpenApi`, `PROVIDES`, `DATA_CATEGORIES`.
- Paket MIT lisenziyası ilə dərc olunur.

## 1.6.0: bağlanmış hesabların ayrılması {#v1-6-0}

*27 oktyabr 2026*

- Bağlama kodu ilə bağlanmış hesab üçün `DELETE /tenants/{tenantId}` artıq onu silmir. Hesab **ayrılır**: məlumatlar, istifadəçilər və giriş tətbiqində qalır, ödəniş sənə qayıdır, cavab isə `{ "deleted": false, "detached": true }` olur. Bax: [DELETE /tenants](https://cosuite.io/az/developers/contract#tenants-delete).
- Bağlanmış hesab heç vaxt test hesabı sayılmır.

## 1.5.0: mövcud hesabların bağlanması {#v1-5-0}

*27 oktyabr 2026*

- Yeni `link` imkanı: tətbiqindən artıq istifadə edən biznes yeni, boş hesab almaq əvəzinə mövcud hesabını birdəfəlik kodla CoSuite-ə qoşa bilər. `POST /tenants` `link: { code }` daşıyır. Bax: [mövcud hesabın bağlanması](https://cosuite.io/az/developers/contract#link).
- Yeni xəta kodu `invalid_link_code` (409).
- Uyğunluq: hər tətbiq naməlum bağlama koduna `409 invalid_link_code` ilə cavab verməli və hesab yaratmamalıdır.

## 1.4.0 və 1.4.1 {#v1-4}

*27 oktyabr 2026*

- Partnyor müqaviləsində dəyişiklik yoxdur. Paketdə daxili klient əlavələri.

## 1.3.0: müştəri sinxronizasiyası {#v1-3-0}

*26 oktyabr 2026*

- Yeni `customers` imkanı: `GET /tenants/{tenantId}/customers` (cursor ilə səhifələmə) və `customer.upserted`, `customer.deleted` hadisələri. Müştərilərin CoSuite-in müştəri siyahısında tətbiqinin nişanı ilə görünür. Bax: [müştərilər](https://cosuite.io/az/developers/contract#customers).
- Müqavilənin əsas URL-ləri dəqiqləşdirildi: müqavilənin CoSuite tərəfi `https://api.cosuite.io/connect/v1` ünvanındadır.

## 1.2.1: giriş səhifəsi vasitəsilə SSO {#v1-2-1}

*26 oktyabr 2026*

- Tətbiqin `redirect` ünvanına keçməzdən əvvəl sessiyasını öz giriş səhifəsi vasitəsilə (URL fraqmentində birdəfəlik bilet) qura biləcəyi dəqiqləşdirildi. Uyğunluq testi hər iki axını qəbul edir. Bax: [SSO](https://cosuite.io/az/developers/contract#sso).

## 1.1.0 və 1.2.0 {#v1-1}

*26 oktyabr 2026*

- Partnyor müqaviləsində dəyişiklik yoxdur. Paketə müqavilə snapshot-u və pozucu dəyişikliklərin avtomatik yoxlaması (`contract:check`) əlavə edildi.

## 1.0.0: ilk buraxılış {#v1-0-0}

*26 oktyabr 2026*

- Zaman pəncərəsi və request-id təkrarına qarşı qoruma ilə HMAC-SHA256 sorğu imzası, xəta zərfi və kodları.
- Tətbiq endpoint-ləri: manifest, health, tenants (yaratma, oxuma, yeniləmə, silmə), versiyalı entitlement-lər, üzvlər, istifadə, xülasə, SSO.
- CoSuite endpoint-ləri: entitlement-lər, hadisələr, JWKS.
- ES256 JWT və JWKS ilə SSO.
- `@cosuite/connect`: imzalama, sxemlər, SSO, klientlər, server qabığı, istinad tətbiqi və uyğunluq testi.