@appaflytech/zeyrek-ai-mcp 0.0.51 → 0.0.53

package/dist/knowledge/componentCatalog.js

@@ -502,6 +502,7 @@ export const componentKnowledge = {
         summary: 'Aranabilir çoklu seçim; value bir değer dizisidir, seçilenler etiket (chip) olarak görünür, search olayı sunucu taraflı arama kurmaya yarar.',
         behavior: [
             "Bakma penceresi (lookupMode modal | drawer) tablo kelimelerini (Uygula, Seçimi temizle, ipucu satırı, filtre çubuğu, işleç adları) tablonun satırlarından okur: compProp.datatable.<kelime> (2026-10-15, frontend ADR 0024); bu satırlar bileşenin Translations sekmesinde tablonun anahtarlarıyla listelenir ve bileşen kullanılınca tohumlanır. Düğümün texts'i önce gelir.",
+            "Bakma penceresinde başlık satırının ilk hücresi tümünü seç kutusudur (2026-11-02): süzgece uyan BÜTÜN kayıtları seçer, sonuç sayfaya sığmıyorsa kimlikleri bir kez okur (en çok 1000; fazlasında pencere söyler). Süzgecin dışındaki önceki seçim korunur, yazım yine Uygula iledir. Datatable çoka-çok hücresi ve çoklu filtre penceresi aynı pencereyi kullanır.",
             "value bir DİZİDİR ve üç biçimi de okunur: düz değer (['policies', 7]), şemanın biçimi ([{ value, label }]) ve eski ikizler ([{ id, text }]). Düz değer yazmak 2026-09-11'e kadar etiketi 'undefined' gösteriyordu; artık değer etiketin kendisi olur ve doğru metin options yüklenince gelir (2026-10-01'e kadar gelmiyordu: akışın yazdığı id dizisi seçenekler yüklense de çipte id olarak kalıyordu).",
             "Etiketin metni options'tan tazelenir: aynı value'lu option listede varsa onun label'ı yazılır. Bu arama METİNLEŞTİREREK karşılaştırır (String(a) === String(b)), AMA yalnız etiket metni için: satırın işaretli görünmesi ve seçimin kaldırılması KATI karşılaştırma kullanır. Yani value'da metin '34', options'ta sayı 34 varsa çip doğru etiketle çizilir ama liste satırı işaretsiz kalır ve tıklamak hiçbir şey yapmaz — eşlemeyi akış katmanında aynı tipe getir (CQ-208).",
             "change yükü { value: [{ value, label, id, text }] } taşır ve düğümün value prop'una yazılır: akışta self.value ile okunur. id/text, value/label'ın eski adlı ikizleridir — kayıtlı sayfalar onlarla okuduğu için bilerek korunuyor.",
@@ -578,7 +579,8 @@ export const componentKnowledge = {
             maxChars: "SERT sınır (tarayıcı maxlength): fazlası yazılamaz. Akıştan gelen daha uzun değer aynen gösterilir (sayaç 45/40 okur). validations.maxLength'ten FARKLIDIR: o yalnız doğrular. 0/boş = sınırsız.",
             showCounter: "Kutunun altında sağa dayalı sayaç: maxChars varsa '12/40', yoksa '12'.",
             autofocus: 'Sayfa açılınca odak bu alana gelir (dondurulmuş alanda ve tasarım kanvasında çalışmaz). Sayfada tek alana ver.',
-            isLoading: "Alanı dondurur (readonly, gri değil) ve sağ üstte spinner çizer; changed'e bağlı sorgu sürerken aç, tamamlanınca kapat."
+            isLoading: "Alanı dondurur (readonly, gri değil) ve sağ üstte spinner çizer; changed'e bağlı sorgu sürerken aç, tamamlanınca kapat.",
+            selection: "selection { start, end } (f-07): kullanıcı seçince ya da imleci taşıyınca selectionChange yazar; yazarken kayan imleç yalnız prop'u günceller (akış koşmaz). Alana hiç dokunulmadıysa undefined'dır. Akış Components.<id>.selection'a yazarsa alan seçimi/imleci oraya koyar ve odaklanır (aynı akışta value da yazıldıysa yeni metne göre). Seçili parçayı biçimlemek ('Kalın' düğmesinin click akışı): const v = Components.<alan>.value ?? ''; const s = Components.<alan>.selection ?? { start: v.length, end: v.length }; const yeni = v.slice(0, s.start) + '**' + v.slice(s.start, s.end) + '**' + v.slice(s.end); const imlec = s.start === s.end ? s.start + 2 : s.end + 4; sonra setter ile value = yeni, selection = { start: imlec, end: imlec } (seçimde imleç kapanış işaretinden sonra, boş imleçte iki işaretin arasında). Web ve mobil aynı yükü verir; textinput'ta bu olay YOK."
         }
     },
     texteditor: {

package/dist/knowledge/componentEvents.js

@@ -125,7 +125,19 @@ export const componentEventContracts = {
         focus: NO_DATA,
         blur: NO_DATA
     },
-    textarea: { mount: NO_DATA, change: valueChange('string'), changed: valueChange('string (blur ile kesinleşen değer)'), focus: NO_DATA, blur: NO_DATA },
+    textarea: {
+        mount: NO_DATA,
+        change: valueChange('string'),
+        changed: valueChange('string (blur ile kesinleşen değer)'),
+        focus: NO_DATA,
+        blur: NO_DATA,
+        // f-07 (plans/defter-saha-bulgulari): yük hem prop'a (`self.selection`) hem `params` ile `event.data`ya gider.
+        selectionChange: {
+            payload: {
+                selection: '{ start, end } — seçimin başı ve sonu, UTF-16 indeks (JS `slice` ile aynı birim); imleçte start === end. Aynı değer event.data.start / event.data.end olarak da gelir. Kullanıcı seçince ya da imleci taşıyınca yayılır (iki platformda 50 ms içindeki değişimler tek olay). Yazarken kayan imleç akış KOŞTURMAZ: yalnız self.selection güncellenir (her tuşta akış olmasın); biçim düğmesi seçimi tıklamada Components.<id>.selection\'dan okur'
+            }
+        }
+    },
     password: {
         mount: NO_DATA,
         change: valueChange('string'),

package/dist/knowledge/expressionPrelude.js

@@ -29,6 +29,9 @@ export const EXPRESSION_PRELUDE_NAMES = [
     'Widget',
     'LocalStorage',
     'Device',
+    'Entitlements',
+    'Products',
+    'Balances',
     'Section',
     'Row',
     'RowIndex',

package/dist/knowledge/mobileComponentCatalog.js

@@ -198,7 +198,10 @@ export const mobileComponentKnowledge = {
         differences: [
             WEB_WORDS_NOTE,
             'Yükseklik açıkça verilir (React Native `TextInput` satır sayısını kendi ölçmez): `autoGrow` (web varsayılanı AÇIK) iken içerikle `minLines`–`maxLines` arasında büyür, kapalıyken sabit `lines`. 2026-09-27\'ye dek hep sabit boydu (f-05). Satır yüksekliği `punto × 1,45` stile yazılır ve satır tabanlı boylar iç boşluk + kenarlığı içerir: `maxLines: 5` beş tam satır gösterir (2026-09-29). `autofocus` runtime\'da klavyeyi açar.'
-        ]
+        ],
+        propNotes: {
+            selection: "Web ile aynı sözleşme (componentCatalog textarea.propNotes.selection). Cihazda seçim `onSelectionChange`'ten gelir ve 50 ms içinde tek `selectionChange`'e katlanır; akışın yazdığı seçim `setSelection` ile konur ve alan odaklanır (klavye açılır). Studio önizlemesinde (react-native-web) aynı yol `setSelectionRange`."
+        }
     },
     numberinput: {
         summary: 'Sayısal klavye açan alan; değer `Intl.NumberFormat` ile biçimlenir.',

package/dist/knowledge/mobileStore.js

@@ -97,7 +97,7 @@ export const STORE_FRAME_LAYOUTS = {
     tablet10: { deviceWidth: 0.8, bezel: 0.03, radius: 0.05, cutout: 'none' }
 };
 /** Beyan anahtarları (`MobileStoreSettings.*Declaration`); iOS appPrivacy, ötekiler Android */
-export const DECLARATION_KEYS = ['appPrivacy', 'dataSafety', 'contentRating', 'targetAudience', 'appAccess'];
+export const DECLARATION_KEYS = ['appPrivacy', 'dataSafety', 'contentRating', 'targetAudience', 'appAccess', 'legacyScheme'];
 /**
  * Yuva kuralının istek gitmeden denetlenen kısmı (`MobileStoreAssetValidator`): derleme görseli dil
  * almaz, ekran görüntüsü cihaz sınıfı ister, öteki türler cihaz sınıfı almaz. Ölçü/biçim/alfa
@@ -467,3 +467,260 @@ export const mobileStorePolicyRules = [
         }
     }
 ];
+/**
+ * Uygulama içi satın alma ürünü (kök ADR 0027, `plans/mobil-uygulama-ici-satin-alma` b-01) — backend
+ * `MobileStoreProductConstants` / `MobileStoreProductValidator` aynası; `test/mobile-purchases.test.ts` sabitleri backend
+ * kaynağına bağlar. Katalog Core DB'dedir (`mobile_store_products`, ortam kavramı yok): adım ürünü bu anahtarla anar,
+ * cihaz mağaza kimliğini manifestten çözer.
+ */
+export const PRODUCT_KEY_PATTERN = /^[a-z][a-z0-9_]{1,63}$/;
+export const PRODUCT_NAME_MAX_LENGTH = 30;
+export const PRODUCT_DESCRIPTION_MAX_LENGTH = 45;
+export const PRODUCT_KINDS = ['subscription', 'non_consumable', 'consumable'];
+/** `consumable` ürünün verdiği miktarın üst sınırı (backend `MobileStoreProductConstants.GrantsAmountMax`) */
+export const GRANTS_AMOUNT_MAX = 1_000_000;
+export const PRODUCT_PERIODS = ['week', 'month', 'quarter', 'half_year', 'year'];
+export const PRODUCT_TRIALS = ['none', '3d', '1w', '1m'];
+/** Kabuğun satın almayı taşıyan ilk sürümü (backend `MobileBuildOptions` `PurchasesCapability`; P-23 eski kabukta uyarır) */
+export const PURCHASES_SHELL_VERSION = '0.9.0';
+/** Tür → davranış tablosu (backend `MobileStoreProductConstants.Kinds`, ADR 0027 madde 3): süreli mi, hak mı bakiye mi veriyor */
+export const PRODUCT_KIND_BEHAVIOR = {
+    subscription: { periodic: true, grantsEntitlement: true, grantsBalance: false },
+    non_consumable: { periodic: false, grantsEntitlement: true, grantsBalance: false },
+    consumable: { periodic: false, grantsEntitlement: false, grantsBalance: true }
+};
+/** Ürünün yazılabilir alanları (`MobileStoreProductModel`); yanıttaki mağaza durumu (`ios`/`android`) gövdeye girmez */
+const PRODUCT_MODEL_FIELDS = ['key', 'kind', 'entitlement', 'balance', 'grantsAmount', 'priceTry', 'period', 'trial', 'texts', 'reviewAssetId'];
+const kindBehavior = (kind) => PRODUCT_KINDS.includes(kind) ? PRODUCT_KIND_BEHAVIOR[kind] : undefined;
+/** Mağazaya gitmiş ürün (backend `MobileStoreProduct.IsSent`): bir mağazada `storeId`'si var. Anahtar, tür ve hak kilitlenir */
+export const isProductSent = (product) => (isObject(product.ios) && typeof product.ios.storeId === 'string' && product.ios.storeId !== '') ||
+    (isObject(product.android) && typeof product.android.storeId === 'string' && product.android.storeId !== '');
+/**
+ * Backend `PUT products/{id}` tam modeli yazar: gönderilmeyen alan boşalır (`texts` boşalınca 422). Yama bu yüzden okunan
+ * ürünün üstüne birleştirilir; `texts` dil dil ve alan alan birleşir, `null` dili kaldırır. Süresiz türde (`non_consumable`)
+ * yamada verilmeyen `period`/`trial` boşalır — tür değişiminde eski süre taşınırsa backend 422 verirdi. Aynı gerekçeyle hak vermeyen
+ * türde `entitlement`, bakiye vermeyen türde `balance`/`grantsAmount` boşalır.
+ */
+export function mergeProduct(current, patch) {
+    const base = Object.fromEntries(PRODUCT_MODEL_FIELDS.map(field => [field, current?.[field] ?? null]));
+    const merged = { ...base };
+    for (const field of PRODUCT_MODEL_FIELDS) {
+        if (field !== 'texts' && patch[field] !== undefined)
+            merged[field] = patch[field];
+    }
+    const texts = isObject(base.texts) ? { ...base.texts } : {};
+    for (const [locale, text] of Object.entries(isObject(patch.texts) ? patch.texts : {})) {
+        if (text === null)
+            delete texts[locale];
+        else
+            texts[locale] = { ...(isObject(texts[locale]) ? texts[locale] : {}), ...(isObject(text) ? text : {}) };
+    }
+    merged.texts = texts;
+    const behavior = kindBehavior(merged.kind);
+    if (behavior?.periodic === false) {
+        if (patch.period === undefined)
+            merged.period = null;
+        if (patch.trial === undefined)
+            merged.trial = null;
+    }
+    if (behavior?.grantsEntitlement === false && patch.entitlement === undefined)
+        merged.entitlement = null;
+    if (behavior?.grantsBalance === false) {
+        if (patch.balance === undefined)
+            merged.balance = null;
+        if (patch.grantsAmount === undefined)
+            merged.grantsAmount = null;
+    }
+    for (const field of ['balance', 'grantsAmount'])
+        if (merged[field] === null)
+            delete merged[field];
+    return merged;
+}
+/** Birleşmiş gövdenin okunan üründen farklı alanları (`texts.en.name` gibi yaprak yolla) */
+export function changedProductFields(current, next) {
+    return PRODUCT_MODEL_FIELDS.flatMap((field) => {
+        if (field !== 'texts')
+            return JSON.stringify(next[field] ?? null) === JSON.stringify(current[field] ?? null) ? [] : [field];
+        const before = isObject(current.texts) ? current.texts : {};
+        const after = isObject(next.texts) ? next.texts : {};
+        return [...new Set([...Object.keys(before), ...Object.keys(after)])].flatMap(locale => ['name', 'description']
+            .filter(key => (isObject(before[locale]) ? before[locale][key] : undefined) !== (isObject(after[locale]) ? after[locale][key] : undefined))
+            .map(key => `texts.${locale}.${key}`));
+    });
+}
+/**
+ * `MobileStoreProductValidator` aynası: backend'in 422 vereceği her alan, aynı gerekçeyle. `siblings` uygulamanın öteki
+ * ürünleridir (anahtar tekilliği; bir hak tek türden ürünle verilir — abonelik grubu ile tek seferlik ürün aynı hakkı
+ * paylaşamaz). Fiyat TRY, en çok iki ondalık; mağaza fiyat basamağına eşlemeyi gönderim yapar.
+ */
+export function productFormatErrors(product, siblings = []) {
+    const errors = [];
+    const add = (field, message) => errors.push({ field, message });
+    const key = typeof product.key === 'string' ? product.key : '';
+    if (!PRODUCT_KEY_PATTERN.test(key))
+        add('key', `${PRODUCT_KEY_PATTERN.source} (küçük harf, rakam, alt çizgi; adım bu anahtarla anar)`);
+    else if (siblings.some(sibling => sibling.key === key))
+        add('key', 'bu uygulamada aynı anahtarlı başka ürün var');
+    const behavior = kindBehavior(product.kind);
+    if (!behavior) {
+        add('kind', PRODUCT_KINDS.join(' | '));
+        return errors;
+    }
+    const entitlement = typeof product.entitlement === 'string' ? product.entitlement : '';
+    const other = behavior.grantsEntitlement ? siblings.find(sibling => sibling.entitlement === entitlement && sibling.kind !== product.kind) : undefined;
+    const present = (value) => value !== null && value !== undefined;
+    if (behavior.grantsEntitlement && !PRODUCT_KEY_PATTERN.test(entitlement))
+        add('entitlement', `hak adı ${PRODUCT_KEY_PATTERN.source} (ekranlar Entitlements.<hak> okur)`);
+    else if (other)
+        add('entitlement', `'${entitlement}' hakkını '${String(other.key)}' (${String(other.kind)}) veriyor — bir hak tek türden ürünle verilir (Apple abonelik grubu = hak)`);
+    if (!behavior.grantsEntitlement && present(product.entitlement))
+        add('entitlement', `${String(product.kind)} ürününde hak olmaz — boş bırakın (tüketilen ürün hak değil bakiye verir)`);
+    if (behavior.grantsBalance && !PRODUCT_KEY_PATTERN.test(typeof product.balance === 'string' ? product.balance : ''))
+        add('balance', `bakiye adı ${PRODUCT_KEY_PATTERN.source} (ekranlar Balances.<ad> okur, balance-spend adımı bu adla harcar)`);
+    if (!behavior.grantsBalance && present(product.balance))
+        add('balance', `${String(product.kind)} ürününde bakiye olmaz — yalnız consumable bakiye verir`);
+    const amount = product.grantsAmount;
+    if (behavior.grantsBalance && !(typeof amount === 'number' && Number.isInteger(amount) && amount >= 1 && amount <= GRANTS_AMOUNT_MAX))
+        add('grantsAmount', `her satın almada eklenen miktar, 1–${GRANTS_AMOUNT_MAX} arası tam sayı`);
+    if (!behavior.grantsBalance && present(amount))
+        add('grantsAmount', `${String(product.kind)} ürününde miktar olmaz — yalnız consumable bakiye verir`);
+    const price = product.priceTry;
+    if (typeof price !== 'number' || !Number.isFinite(price) || price <= 0 || Math.round(price * 100) / 100 !== price)
+        add('priceTry', 'sıfırdan büyük TRY fiyatı, en çok iki ondalık (949.99)');
+    if (behavior.periodic && !PRODUCT_PERIODS.includes(product.period))
+        add('period', `abonelikte zorunlu: ${PRODUCT_PERIODS.join(' | ')}`);
+    if (behavior.periodic && product.trial !== null && product.trial !== undefined && !PRODUCT_TRIALS.includes(product.trial))
+        add('trial', `${PRODUCT_TRIALS.join(' | ')} ya da boş`);
+    if (!behavior.periodic && product.period !== null && product.period !== undefined)
+        add('period', `${String(product.kind)} ürününde süre olmaz — boş bırakın`);
+    if (!behavior.periodic && product.trial !== null && product.trial !== undefined)
+        add('trial', `${String(product.kind)} ürününde deneme olmaz — boş bırakın`);
+    const texts = isObject(product.texts) ? product.texts : {};
+    if (Object.keys(texts).length === 0)
+        add('texts', "en az bir dilde ad ve açıklama: { tr: { name, description } } (mağaza metni; ar, en, ru, tr mağazanın diline eşlenir)");
+    for (const [locale, text] of Object.entries(texts)) {
+        const name = isObject(text) && typeof text.name === 'string' ? text.name : '';
+        const description = isObject(text) && typeof text.description === 'string' ? text.description : '';
+        if (!LOCALE_PATTERN.test(locale))
+            add(`texts.${locale}`, `dil kodu ${LOCALE_PATTERN.source}`);
+        if (!name.trim() || name.length > PRODUCT_NAME_MAX_LENGTH)
+            add(`texts.${locale}.name`, `1–${PRODUCT_NAME_MAX_LENGTH} karakter (şimdi ${name.length})`);
+        if (!description.trim() || description.length > PRODUCT_DESCRIPTION_MAX_LENGTH)
+            add(`texts.${locale}.description`, `1–${PRODUCT_DESCRIPTION_MAX_LENGTH} karakter (şimdi ${description.length})`);
+    }
+    return errors;
+}
+/**
+ * Mağazaya gitmiş üründe değişemeyen alanlar (backend `MobileStoreProductLockedException`, 422): mağaza onları ürünün kimliği sayar.
+ * `grantsAmount` kilitli değildir (mağaza alanı değil; eski satışlar eski miktarla kalır).
+ */
+export function productLockedChanges(current, next) {
+    return isProductSent(current) ? ['key', 'kind', 'entitlement', 'balance'].filter(field => (current[field] ?? null) !== (next[field] ?? null)) : [];
+}
+/**
+ * Satın alma hazırlık satırının ne istediği ve kimin yaptığı — anahtarlar backend altın listesi
+ * `TestData/mobile-store/purchase-readiness-rows.json` ile kilitli (`test/mobile-purchases.test.ts`). Gizli bilgi (Apple
+ * satın alma anahtarı, hesaplar) MCP'den yazılmaz; konsol satırları insanın işidir.
+ */
+export const PURCHASE_READINESS_HINTS = {
+    'ios.connection': "Organizasyonun Apple hesabı (App Store Connect API anahtarı) bağlı değil — Studio › Yayınla › Hesaplar (gizli bilgi, MCP yazmaz).",
+    'ios.paidAgreement': "App Store Connect › Business'ta ücretli uygulama sözleşmesi, banka ve vergi bilgisi — insanın işi. missing: son gönderim paid_agreement hatası aldı; sözleşme imzalanınca mobile_product_send { retrySendId }.",
+    'ios.iapKey': "App Store Server API satın alma anahtarı (.p8 + Key ID + Issuer ID) — Studio › Satın almalar › Mağaza hazırlığı'nda yüklenir (gizli bilgi, MCP yazmaz).",
+    'ios.notificationUrl': "App Store Server Notifications V2 adresi: copyValue'yu App Store Connect › Uygulama › App Information'a (production ve sandbox aynı adres) yapıştırın; ilk bildirim gelince ready olur. fix: kayıtlı adres farklı (detail).",
+    'android.connection': "Play hizmet hesabı bağlı değil — Studio › Yayınla › Hesaplar (gizli bilgi, MCP yazmaz).",
+    'android.merchant': "Play Console › Ödeme profili (merchant hesabı) — insanın işi.",
+    'android.billingBuild': `Google ürün açmadan önce faturalandırma izinli (BILLING) bir derlemenin Play'e yüklenmiş olmasını ister: ürün kaydedildikten sonra kabuk ≥ ${PURCHASES_SHELL_VERSION} ile mobile_build_start { platform: 'android', target: 'internal' }; ilk Android ürünü mağazada açılınca ready.`,
+    'android.permissions': "fix: son gönderim Play'den 403 aldı (play_permission) — Play Console › Kullanıcılar ve izinler'de hizmet hesabına uygulama içi ürünleri yönetme izni verin, sonra mobile_product_send { retrySendId }.",
+    'android.rtdnTopic': "Play Console › Para kazanma kurulumu › Gerçek zamanlı geliştirici bildirimleri: Pub/Sub konusu + kimlik doğrulamalı push aboneliği (uç copyValue, hizmet hesabı Zeyrek'e yüklenen Play hesabı) — insanın işi; ilk bildirim gelince ready."
+};
+/**
+ * FLOW-045'in katalog ayağı (araç katmanı — politika kuralı tanımı görür, kataloğu görmez): statik `purchase.value`
+ * uygulamanın ürün anahtarı değilse cihaz ve önizleme `invalid` döner. Backend akış doğrulayıcısı kataloğu okumaz
+ * (iş sahibi kararı b-04, 2026-10-23: Studio → Core bağımlılığı açılmaz; mağaza yayını ön kontrolü P-23
+ * `purchases_unknown_product` uyarır), ajanın yazımını gateway `block` ile durdurur — istek gitmez, hata katalogdaki
+ * anahtarları sayar. Şablonlu değer (`{{ }}`) ve boş değer burada susar (boşu politika kuralı `block` eder); desen dışı ya da
+ * tırnaklı değer de katalogda olamayacağı için durur — nasıl düzeltileceğini politika kuralının uyarısı söyler.
+ */
+export function purchaseCatalogFindings(steps, products) {
+    const keys = products.map(product => String(product.key));
+    return steps.flatMap((step) => {
+        const value = isObject(step.args) && typeof step.args.value === 'string' ? step.args.value.trim() : '';
+        if (!value || value.includes('{{') || keys.includes(value))
+            return [];
+        return [{
+                ruleId: 'FLOW-045',
+                severity: 'block',
+                message: `'${String(step.stepId ?? step.name ?? '?')}' purchase adımının ürünü '${value}' uygulamanın ürün kataloğunda yok — cihaz ve önizleme 'invalid' döner. ${keys.length > 0 ? `Katalog: ${keys.join(', ')}.` : 'Uygulamada hiç ürün yok.'} Ürünü önce mobile_product_upsert ile ekleyin ya da anahtarı katalogdakiyle değiştirin; seçimden gelen anahtar için '{{ … }}' şablonu yazın.`,
+                guide: 'ngapps://guides/mobile-steps'
+            }];
+    });
+}
+const stepText = (step, field) => isObject(step.args) && typeof step.args[field] === 'string' ? step.args[field].trim() : '';
+/** Katalogdaki tüketilen ürünlerin bakiye adları (sırayla, tekrarsız) */
+export const catalogBalances = (products) => [...new Set(products.filter(product => product.kind === 'consumable').map(product => String(product.balance ?? '')).filter(balance => balance !== ''))];
+/** Katalogdaki hak adları (abonelik ve tek seferlik ürünlerin `entitlement`'ı) */
+export const catalogEntitlements = (products) => [...new Set(products.filter(product => product.kind !== 'consumable').map(product => String(product.entitlement ?? '')).filter(entitlement => entitlement !== ''))];
+/**
+ * FLOW-046'nın katalog ayağı (araç katmanı — politika kuralı tanımı görür, kataloğu görmez), FLOW-045'in `purchaseCatalogFindings`
+ * emsali: statik `balance-spend.value` uygulamanın tüketilen ürünlerinden birinin bakiye adı değilse sunucu `invalid` döner
+ * (katalogda olmayan bakiye adı 422). Şablonlu (`{{ }}`) ve boş değer burada susar (boşu politika kuralı `block` eder).
+ * Katalog `block` bulgusu üretir; çağıran yazımdan ÖNCE `applyPolicyMode` + `enforcePolicy` ile uygular.
+ */
+export function balanceCatalogFindings(steps, products) {
+    const balances = catalogBalances(products);
+    return steps.flatMap((step) => {
+        const value = stepText(step, 'value');
+        if (!value || value.includes('{{') || balances.includes(value))
+            return [];
+        return [{
+                ruleId: 'FLOW-046',
+                severity: 'block',
+                message: `'${String(step.stepId ?? step.name ?? '?')}' balance-spend adımının bakiyesi '${value}' uygulamanın tüketilen ürünlerinde yok — sunucu 'invalid' döner. ${balances.length > 0 ? `Katalogdaki bakiyeler: ${balances.join(', ')}.` : 'Uygulamada tüketilen ürün yok (abonelik ve tek seferlik ürün bakiye vermez).'} Önce mobile_product_upsert { kind: 'consumable', balance: '${value}', grantsAmount } ile ürünü ekleyin ya da adı katalogdakiyle değiştirin; seçimden gelen ad için '{{ … }}' şablonu yazın.`,
+                guide: 'ngapps://guides/mobile-steps'
+            }];
+    });
+}
+/**
+ * Workflow `balance` adımı için aynı katalog denetimi (FLOW-046, workflow yüzeyi): girdi `rule.expression` nesne literalidir
+ * (`{ balance: 'kredi', amount: 10, idempotencyKey: … }`), `balanceOperation` işlemi söyler. Statik `balance` (spend/grant/read) tüketilen
+ * ürünün bakiye adı, statik `entitlement` (entitled) bir ürünün hakkı olmalı — olmayan ad sunucuda hata dalına düşer.
+ * `spend`/`grant` `idempotencyKey` vermiyorsa her adım çalışması yeni satır yazar (b-10, tekrar güvenliği varsayılan değildir): uyarı.
+ */
+export function workflowBalanceFindings(sites, products) {
+    const balances = catalogBalances(products);
+    const entitlements = catalogEntitlements(products);
+    const literal = (expression, key) => new RegExp(`(?:^|[{,\\s])${key}\\s*:\\s*(['"\`])([^'"\`]*)\\1`).exec(expression)?.[2];
+    return sites.flatMap(({ label, rule }) => {
+        const operation = String(rule.balanceOperation ?? '');
+        const expression = typeof rule.expression === 'string' ? rule.expression : '';
+        const findings = [];
+        const guide = 'ngapps://guides/workflow';
+        if (operation === 'entitled') {
+            const entitlement = literal(expression, 'entitlement');
+            if (entitlement && !entitlements.includes(entitlement)) {
+                findings.push({ ruleId: 'FLOW-046', severity: 'block', message: `'${label}' balance adımı (entitled) '${entitlement}' hakkını soruyor ama uygulamanın hiçbir ürünü bu hakkı vermiyor — cevap hep false olur. ${entitlements.length > 0 ? `Katalogdaki haklar: ${entitlements.join(', ')}.` : 'Uygulamada hak veren ürün yok.'} Hak adı mobile_product_list'teki ürünün entitlement alanıdır.`, guide });
+            }
+            return findings;
+        }
+        const balance = literal(expression, 'balance');
+        if (balance && !balances.includes(balance)) {
+            findings.push({ ruleId: 'FLOW-046', severity: 'block', message: `'${label}' balance adımı (${operation || '?'}) '${balance}' bakiyesini kullanıyor ama uygulamanın tüketilen ürünlerinde yok — sunucu geçersiz girdi ile hata dalına düşer. ${balances.length > 0 ? `Katalogdaki bakiyeler: ${balances.join(', ')}.` : 'Uygulamada tüketilen ürün yok.'} Önce mobile_product_upsert { kind: 'consumable', balance } ile ürünü ekleyin ya da adı katalogdakiyle değiştirin.`, guide });
+        }
+        if ((operation === 'spend' || operation === 'grant') && !/(?:^|[{,\s])idempotencyKey\s*:/.test(expression)) {
+            findings.push({ ruleId: 'FLOW-046', severity: 'warn', message: `'${label}' balance adımı (${operation}) idempotencyKey vermiyor: anahtar yoksa her adım çalışması YENİ satır yazar — yeniden koşabilen akış (yeniden deneme, döngü, aynı olayın iki kez gelmesi) bakiyeyi iki kez ${operation === 'spend' ? 'düşer' : 'artırır'}. Olayı tanımlayan bir değer verin: idempotencyKey: input.davetId.`, guide });
+        }
+        return findings;
+    });
+}
+/**
+ * MOB-036 (K9): tüketilen ürünü olan ama kullanıcı girişi (access.session.create uçlu microservice) olmayan uygulamada bakiye
+ * yalnız kuruluma yazılır; tüketilen ürün mağazada "geri yüklenemez" — telefon değişince ya da uygulama silinip kurulunca bakiye
+ * gider. `microservices` okunamadıysa `undefined`: bilmediğimizi uyarı diye söylemeyiz.
+ */
+export function balanceWithoutSignInWarnings(products, microservices) {
+    if (!microservices || catalogBalances(products).length === 0)
+        return [];
+    if (microservices.some(service => service.systemOperation === 'access.session.create'))
+        return [];
+    return [`MOB-036: Bu uygulamada tüketilen ürün (${catalogBalances(products).join(', ')}) var ama kullanıcı girişi yok — bakiye yalnız bu telefonun kurulumuna yazılır. Tüketilen ürün mağazada "Geri yükle" ile geri gelmez: kullanıcı telefon değiştirir ya da uygulamayı silip kurarsa satın aldığı kredi gider (K9). Girişli uygulamada bakiye hesaba taşınır: access.session.create uçlu bir giriş (platform_guide('access')) kurun ya da kullanıcıya bakiyenin telefona bağlı olduğunu açıkça söyleyin; satış yapmadan önce karar verin.`];
+}

package/dist/knowledge/normalize.js

@@ -1669,11 +1669,12 @@ const SCREEN_EVENT_NAMES = ['mount', 'destroy'];
  * koşmaz. Web her gezinmede sayfayı baştan kurar (`Runtime.svelte` focus'u tanımaz), layout'un focus'u
  * yoktur. Ayna: `ng-apps-ui-native` `SCREEN_LIFECYCLE_EVENTS` (parite: `test/page-meta.test.ts`).
  */
-const MOBILE_PAGE_EVENT_NAMES = [...SCREEN_EVENT_NAMES, 'focus'];
+const MOBILE_PAGE_EVENT_NAMES = [...SCREEN_EVENT_NAMES, 'focus', 'offlineQueueChange'];
 const SCREEN_EVENT_HINTS = {
     mount: 'mount (yüklendiğinde)',
     destroy: 'destroy (ayrılırken; temizlik akışları için)',
-    focus: 'focus (ekran her göründüğünde — ilk açılış ve geri dönüş; listeyi yeniden okumak için)'
+    focus: 'focus (ekran her göründüğünde — ilk açılış ve geri dönüş; listeyi yeniden okumak için)',
+    offlineQueueChange: 'offlineQueueChange (servis yazma kuyruğu değişince — ağsız kayıt girdi, gönderildi, reddedildi; listeyi yeniden okumak için, sayaç Device.offline)'
 };
 export function screenEventNames(kind, platform) {
     return kind === 'page' && platform === 'mobile' ? MOBILE_PAGE_EVENT_NAMES : SCREEN_EVENT_NAMES;
@@ -1688,7 +1689,7 @@ export function invalidScreenEventNames(events, code, names = SCREEN_EVENT_NAMES
         .map(event => String(event.name ?? ''))
         .filter(name => name !== '' && !names.includes(name))
         .map(name => MOBILE_PAGE_EVENT_NAMES.includes(name)
-        ? `${code}: '${name}' yalnız mobil uygulamanın SAYFASINDA vardır (layout'ta ve web sayfasında yok; web sayfayı her gezinmede baştan kurar, mount yeter) — burada geçerli adlar: ${valid}.`
+        ? `${code}: '${name}' yalnız mobil uygulamanın SAYFASINDA vardır (layout'ta ve web sayfasında yok; ${name === 'offlineQueueChange' ? 'web barındırıcısı servis yazma kuyruğu tutmaz, olay hiç yayılmaz' : 'web sayfayı her gezinmede baştan kurar, mount yeter'}) — burada geçerli adlar: ${valid}.`
         : `${code}: sayfa/layout düzeyinde '${name}' diye bir olay YOK — geçerli adlar: ${valid}. Platform kaydı kabul eder ama bağ sessizce ölü kalır.`);
 }
 const GUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

package/dist/knowledge/platform/mobile.js

@@ -116,7 +116,7 @@ export const mobileProfile = Object.freeze({
     },
     style: { freeStyle: false, hoverStyle: false, resolver: 'native' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back', 'biometric-auth', 'scan-code']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back', 'biometric-auth', 'scan-code', 'purchase', 'restore-purchases', 'balance-spend']),
         aliases: STEP_ALIASES,
         infoOnly: new Set(['download', 'setcookie'])
     },

package/dist/knowledge/platform/mobileRules.js

@@ -144,6 +144,24 @@ export const MOBILE_RULES = {
         severity: 'warn',
         sourceRef: 'docs/adr/0023-mobil-cevrimdisi-yerel-kopya-ve-uygulama-paketi.md K13, K8; zeyrek-frontend/packages/ng-apps-ui-native/src/shell/mobile-offline.ts (okuyucu; ayna mobileOffline.ts); ng-apps-flow tasks/microservice/microservice.ts (error.network yalnız veri önbelleği açıkken)',
         summary: "properties.mobile.offline okunamıyor (nesne değil, boolean olmayan screens/data/banner, 1 | 7 | 30 dışı maxAgeDays, tanınmayan anahtar) — cihaz varsayılana düşer; akış ağ hatasını error.status 503 ile ayırıyor (bilgi: error.network)"
+    },
+    'MOB-034': {
+        id: 'MOB-034',
+        severity: 'warn',
+        sourceRef: 'docs/adr/0027-uygulama-ici-satin-alma.md madde 6 (telefon değişince Geri yükle); App Store Review Guidelines 3.1.1 (geri yüklenebilir satın almada geri yükleme yolu); @ng-apps/flow restore-purchases',
+        summary: 'Satın alma adımı olan ekranda hiçbir akışta restore-purchases yok — mağaza incelemesi geri yükleme yolunu satın alma ekranında arar'
+    },
+    'MOB-036': {
+        id: 'MOB-036',
+        severity: 'warn',
+        sourceRef: 'docs/adr/0027-uygulama-ici-satin-alma.md bakiye bölümü (K9: tüketilen ürün mağazada geri yüklenemez, bakiye telefon değişince yalnız hesapla taşınır); plans/mobil-uygulama-ici-satin-alma README K9; backend 04-bakiye-defteri.md (restore tüketileni geri yüklemez)',
+        summary: 'Tüketilen ürünü olan uygulamada kullanıcı girişi (access.session.create) yok — bakiye yalnız kuruluma yazılır, telefon değişince ya da uygulama silinip kurulunca kaybolur'
+    },
+    'MOB-042': {
+        id: 'MOB-042',
+        severity: 'warn',
+        sourceRef: 'App Store Review Guidelines 3.1.2 (abonelik bilgilendirmesi: süre, yenileme, iptal; kullanım koşulları ve gizlilik bağlantısı); Play abonelik politikası; Studio teklif ekranı şablonu (features/purchases/paywall-template.functions.ts: yenileme metni + gizlilik bağlantısı)',
+        summary: 'Abonelik satan sayfada otomatik yenileme metni ya da koşullar/gizlilik bağlantısı yok'
     }
 };
 /**
@@ -260,3 +278,64 @@ export function mobileComponentNotes(slug) {
         ...(wave === undefined ? [] : [`Mobil bileşen dalgası: ${wave} (plans/mobil-uygulama-expo §11).`])
     ];
 }
+const recordsOf = (value) => (Array.isArray(value) ? value : []).filter((entry) => typeof entry === 'object' && entry !== null && !Array.isArray(entry));
+const flowSteps = (flow) => [...recordsOf(flow.steps), ...recordsOf(flow.errorSteps)];
+/**
+ * MOB-034 — yazılan akışta `purchase` var ve bu ekranın (sayfa, layout ya da widget) hiçbir akışında `restore-purchases`
+ * yok. Uygulama genelinde arayan uç yok (bir uygulamada yüzlerce sayfa var); denetim ekran düzeyindedir ve Apple
+ * incelemesinin baktığı yer de satın alma ekranıdır. Geri yükleme bilinçli olarak başka bir ekrandaysa (Ayarlar) uyarı yok
+ * sayılır — mesaj bunu söyler. `otherFlows` ekranın kayıtlı öteki akışlarıdır (yazılanın eski hâli hariç).
+ * Ekran yalnız tüketilen ürün satıyorsa uyarı susar: tüketilen ürün mağazada geri yüklenmez (K9). `products` okunamadıysa
+ * ürünün türünü bilmiyoruz, uyarı kalır.
+ */
+export function restorePathWarnings(written, otherFlows, products) {
+    const purchases = written.filter(step => step.type === 'purchase');
+    if (purchases.length === 0)
+        return [];
+    const consumables = (products ?? []).filter(product => product.kind === 'consumable').map(product => String(product.key));
+    const sold = [...purchases, ...otherFlows.flatMap(flowSteps).filter(step => step.type === 'purchase')];
+    const onlyConsumables = consumables.length > 0 && sold.every((step) => {
+        const value = typeof step.args?.value === 'string' ? String(step.args.value).trim() : '';
+        return value.includes('{{') ? consumables.length === products?.length : consumables.includes(value);
+    });
+    if (onlyConsumables)
+        return [];
+    if ([...written, ...otherFlows.flatMap(flowSteps)].some(step => step.type === 'restore-purchases'))
+        return [];
+    return [`${MOBILE_RULES['MOB-034'].id}: '${String(purchases[0]?.stepId ?? purchases[0]?.name ?? '?')}' satın alma adımının ekranında hiçbir akışta restore-purchases yok — telefon değiştiren ya da uygulamayı yeniden kuran kullanıcı hakkını yalnız Geri yükle ile alır ve App Store incelemesi satın alma ekranında bu yolu arar. Ekrana bir 'Satın almaları geri yükle' düğmesi ve ona restore-purchases adımlı bir akış ekleyin (always: Entitlements güncellenir; error dalında Steps.<ad>.error.status). Uyarı yalnız satın alma akışı yazılırken denetlenir: geri yükleme akışını önce yazın — sonra yazılırsa bu uyarı eskimiş kalır, yok sayın. Geri yükleme bilinçli olarak başka bir ekrandaysa (Ayarlar) da yok sayın.`];
+}
+/** Otomatik yenileme cümlesi, dört platform dilinde (tr, en, ru, ar) */
+const RENEWAL_TEXT = /yenile[nm]|renew|продл|تجدي|يتجدد|تتجدد/i;
+/** Çeviri anahtarıyla yazılmış metin (`{{ t('…') }}`, prop türü translation): gateway metni okuyamaz */
+const TRANSLATED_TEXT = /\bt\(\s*\\?['"]|"type"\s*:\s*"translation"/;
+/** Dış bağlantı: düğüm prop'u `href` dolu, metindeki bağlantı (markdown, html) */
+const LINK_IN_PAGE = /"href"\s*:\s*(?:"[^"]+"|\{[^{}]*"(?:data|ref)"\s*:\s*"[^"]+")|\]\(https?:|href=\\?["']?https?:/;
+/**
+ * MOB-042 — abonelik satan sayfa (statik anahtarı katalogda abonelik olan ya da şablonlu değerle satan ve katalogda
+ * abonelik bulunan `purchase` adımı) yenileme koşulunu ve koşullar/gizlilik bağlantısını göstermiyor. Kural metinseldir:
+ * sayfa ağacının JSON'unda yenileme sözcüğü ve dolu bir `href` (ya da metin içi bağlantı) aranır; ekranın akışlarından
+ * dışarı açan `redirect` (`https://…`) de bağlantı sayılır. Çeviri anahtarıyla yazılmış sayfada metin okunamaz, yenileme
+ * denetimi susar (bilmediğimizi uyarı diye söylemeyiz).
+ */
+export function subscriptionDisclosureWarnings(written, products, pageNodes, hostFlows) {
+    const purchases = written.filter(step => step.type === 'purchase');
+    const subscriptions = products.filter(product => product.kind === 'subscription').map(product => String(product.key));
+    const sells = purchases.some((step) => {
+        const value = typeof step.args?.value === 'string' ? String(step.args.value).trim() : '';
+        return value.includes('{{') ? subscriptions.length > 0 : subscriptions.includes(value);
+    });
+    if (!sells)
+        return [];
+    // Türkçe büyük harf (`YENİLENİR`) `i` bayrağıyla eşleşmez: metin önce Türkçe küçük harfe çevrilir.
+    const page = JSON.stringify(pageNodes ?? null);
+    const lowered = page.toLocaleLowerCase('tr');
+    const opensOutside = [...written, ...hostFlows.flatMap(flowSteps)]
+        .some(step => step.type === 'redirect' && /^https?:\/\//.test(String(step.args?.path ?? '').trim().replace(/^['"`]/, '')));
+    const missing = [
+        ...(RENEWAL_TEXT.test(lowered) || RENEWAL_TEXT.test(page) || TRANSLATED_TEXT.test(page) ? [] : ['otomatik yenileme metni (dönem sonunda yenilenir, mağaza hesabından iptal edilir)']),
+        ...(LINK_IN_PAGE.test(page) || opensOutside ? [] : ['kullanım koşulları / gizlilik bağlantısı (href taşıyan düğme ya da metin)'])
+    ];
+    if (missing.length === 0)
+        return [];
+    return [`${MOBILE_RULES['MOB-042'].id}: bu sayfa abonelik satıyor ama ekranda ${missing.join(' ve ')} yok — App Store (3.1.2) ve Play abonelik politikası satın alma ekranında süreyi, fiyatı, otomatik yenilemeyi, iptal yolunu ve koşullar/gizlilik bağlantısını ister; eksik ekran incelemeden döner. Fiyat ve süre Products.<anahtar>.price / .period ile yazılır; gizlilik adresi mobile_store_get urls.privacyPolicy. Kalıp: platform_guide('mobile-steps') §Satın alma tarifi. Metin çeviri anahtarıyla yazıldıysa gateway okuyamaz — çeviride varsa yok sayın.`];
+}