@appaflytech/zeyrek-ai-mcp 0.0.50 → 0.0.52

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/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/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.`];
+}