ad2app-lib 1.23.0 → 1.25.0

package/dist/analytics/index.d.ts

@@ -36,6 +36,7 @@ export declare const EVENTS: {
     readonly SUBSCRIPTION_CANCELED: "subscription_canceled";
     readonly PAYWALL_SHOWN: "paywall_shown";
     readonly PAYWALL_DISMISSED: "paywall_dismissed";
+    readonly ACCESS_DENIED: "access_denied";
     readonly ONBOARDING_STEP_COMPLETED: "onboarding_step_completed";
     readonly EXIT_INTENT_SHOWN: "exit_intent_shown";
     readonly EXIT_INTENT_DISMISSED: "exit_intent_dismissed";
@@ -194,6 +195,11 @@ export interface EventProperties {
         page_views?: number;
         app_locale: AppLocale;
     };
+    [EVENTS.ACCESS_DENIED]: {
+        reason: 'beta-required' | 'subscription-required';
+        path?: string;
+        app_locale: AppLocale;
+    };
     [EVENTS.PAYWALL_DISMISSED]: {
         surface: 'upgrade_modal' | 'pricing_page';
         trigger: 'user_click' | 'limit_reached' | 'connect_wall';

package/dist/analytics/index.js

@@ -45,6 +45,13 @@ exports.EVENTS = {
     // Measurement baseline (080) — paywall / onboarding / exit-intent (frontend-owned)
     PAYWALL_SHOWN: 'paywall_shown', // any monetization surface is shown (upgrade modal / pricing page)
     PAYWALL_DISMISSED: 'paywall_dismissed', // closed without converting
+    // AD2-1284: an entitlement wall rejected an API READ, which is control flow,
+    // not an error. Distinct from PAYWALL_SHOWN because nothing was shown: the
+    // driver classified a 403 at the choke point and the redirect follows. Before
+    // this event existed the only record was a captured $exception, which put
+    // expected paywall hits into Error Tracking and made that dashboard harder to
+    // trust — it is part of why a REAL retry defect sat unnoticed in the same list.
+    ACCESS_DENIED: 'access_denied', // entitlement 403 at the API choke point (beta wall / subscription)
     ONBOARDING_STEP_COMPLETED: 'onboarding_step_completed', // one step of a multi-step flow (complete-profile)
     EXIT_INTENT_SHOWN: 'exit_intent_shown', // exit-intent capture modal armed (065, verbatim wire values)
     EXIT_INTENT_DISMISSED: 'exit_intent_dismissed',

package/dist/legal/privacy.js

@@ -194,14 +194,16 @@ exports.PRIVACY_SECTIONS = [
             {
                 kind: 'ul',
                 items: [
-                    { text: '**Strictly necessary cookies:** required for authentication sessions and core platform functionality. Cannot be disabled without breaking the Service. Legal basis: Art. 6(1)(b), contract performance; no consent required. Duration: session cookies expire when you close your browser; authentication cookies expire after 30 days of inactivity.' },
+                    { text: '**Strictly necessary cookies and equivalent device storage:** required for authentication sessions and core platform functionality. Cannot be disabled without breaking the Service. Legal basis: Art. 6(1)(b), contract performance; no consent required. Your session token is held in your browser\'s local storage rather than in a cookie; a cookie is used only as a fallback where local storage is unavailable (for example private browsing). Duration: your session expires after 30 days of inactivity. Each time you open the app the 30 days start again, and if you do not return within 30 days you are signed out.' },
                     { text: '**Functional cookies:** set only in direct response to an action you take (e.g. selecting a language or theme preference), and strictly necessary to deliver that specific function you have requested. They do not track you across sessions beyond preserving your chosen setting. Legal basis: strictly necessary to fulfil your explicit request under Art. 173 of the Polish Telecommunications Act (ePrivacy); no separate consent required. Duration: up to 12 months, or cleared when you clear your browser data.' },
                     { text: '**Analytics cookies (PostHog):** collect usage event data in pseudonymised form (other than the identifying flows described in Section 6), enable session replay (with form-field values masked; see Section 3), and capture error reports to help us understand and improve how the Service is used. Legal basis: Art. 6(1)(a), consent. **No analytics cookies are set and no analytics events are captured before you make a choice** in the cookie consent banner shown on first visit. If you accept, PostHog sets a first-party cookie (name beginning `ph_`) on the `ad2.app` domain, valid for up to 1 year, shared between our website and the app so you are not asked twice. If you decline, no analytics cookie is set and no events are collected. Analytics data is processed on PostHog Cloud EU servers in Frankfurt, Germany (see Section 6).' },
                 ],
             },
             { kind: 'p', text: 'You may withdraw or update your cookie consent at any time via the "Cookie settings" link in the footer of our website, or on this Privacy Policy page in the app. Withdrawing analytics consent does not affect platform functionality.' },
-            { kind: 'subheading', text: 'Browser local storage' },
-            { kind: 'p', text: 'In addition to cookies, we use browser local storage to preserve application state between sessions. This includes: your language and theme preferences; a cached copy of your subscription tier and status (retained for up to 30 days then invalidated); and draft campaign deadline data. Local storage data is stored on your device only and is not transmitted to our servers independently of your normal usage. It is cleared when you clear your browser data or log out.' },
+            { kind: 'subheading', text: 'Browser local storage and on-device cache' },
+            { kind: 'p', text: 'In addition to cookies, we use browser local storage to preserve application state between sessions. This includes: your session token (see "Strictly necessary" above); your language and theme preferences; a cached copy of your subscription tier and status (retained for up to 30 days then invalidated); and draft campaign deadline data.' },
+            { kind: 'p', text: 'We also keep a working copy of data you have already loaded in your browser\'s IndexedDB storage, so the app can show your most recent screens immediately when you reopen it instead of leaving you on a loading spinner. This copy holds up to 50 of your most recent responses from our API and can include your posts and drafts, your analytics figures, your connected account details, and your inbox, which contains comments and messages written by other people on your social media posts. It is limited to data your account is already entitled to see, is scoped to the signed-in account so a different user signing in on the same device cannot read it, and is deleted when you sign out, when your session ends, or when you clear your browser data.' },
+            { kind: 'p', text: 'All of the above is stored on your device only and is not transmitted to our servers independently of your normal usage. You can remove it at any time by signing out or clearing your browser data.' },
         ],
     },
     {

package/dist/legal/privacy.pl.js

@@ -206,14 +206,16 @@ exports.PRIVACY_SECTIONS_PL = [
             {
                 kind: 'ul',
                 items: [
-                    { text: '**Pliki cookie ściśle niezbędne:** wymagane do obsługi sesji uwierzytelniania i podstawowych funkcji platformy. Nie można ich wyłączyć bez zakłócenia działania Usługi. Podstawa prawna: art. 6 ust. 1 lit. b, wykonanie umowy; zgoda nie jest wymagana. Czas trwania: sesyjne pliki cookie wygasają po zamknięciu przeglądarki; uwierzytelniające pliki cookie wygasają po 30 dniach bezczynności.' },
+                    { text: '**Pliki cookie ściśle niezbędne i równoważna pamięć urządzenia:** wymagane do obsługi sesji uwierzytelniania i podstawowych funkcji platformy. Nie można ich wyłączyć bez zakłócenia działania Usługi. Podstawa prawna: art. 6 ust. 1 lit. b, wykonanie umowy; zgoda nie jest wymagana. Token Twojej sesji przechowujemy w pamięci lokalnej przeglądarki, a nie w pliku cookie; plik cookie służy wyłącznie jako rozwiązanie zapasowe tam, gdzie pamięć lokalna jest niedostępna (na przykład w trybie prywatnym). Czas trwania: Twoja sesja wygasa po 30 dniach bezczynności. Przy każdym otwarciu aplikacji te 30 dni liczone jest od nowa, a jeżeli nie wrócisz w ciągu 30 dni, nastąpi wylogowanie.' },
                     { text: '**Funkcjonalne pliki cookie:** ustawiane wyłącznie w bezpośredniej reakcji na podjętą przez Ciebie czynność (np. wybór języka lub motywu) i ściśle niezbędne do wykonania tej konkretnej, zażądanej przez Ciebie funkcji. Nie śledzą Cię między sesjami poza zachowaniem wybranego przez Ciebie ustawienia. Podstawa prawna: ścisła niezbędność do spełnienia Twojego wyraźnego żądania na podstawie art. 173 Prawa telekomunikacyjnego (ePrivacy); odrębna zgoda nie jest wymagana. Czas trwania: do 12 miesięcy lub do wyczyszczenia przez Ciebie danych przeglądarki.' },
                     { text: '**Analityczne pliki cookie (PostHog):** zbierają dane o zdarzeniach korzystania w postaci spseudonimizowanej (poza przepływami identyfikującymi opisanymi w sekcji 6), umożliwiają nagrywanie sesji (z maskowaniem wartości wpisywanych w pola formularzy; zobacz sekcję 3) i rejestrują raporty o błędach, abyśmy mogli rozumieć i ulepszać sposób korzystania z Usługi. Podstawa prawna: art. 6 ust. 1 lit. a, zgoda. **Zanim dokonasz wyboru w banerze zgody na pliki cookie, wyświetlanym przy pierwszej wizycie, nie ustawiamy żadnych analitycznych plików cookie i nie rejestrujemy żadnych zdarzeń analitycznych.** Jeżeli wyrazisz zgodę, PostHog ustawia własny plik cookie (o nazwie zaczynającej się od `ph_`) w domenie `ad2.app`, ważny do 1 roku, współdzielony między naszą stroną internetową a aplikacją, aby nie pytać Cię o to dwa razy. Jeżeli odmówisz, żaden analityczny plik cookie nie zostanie ustawiony i żadne zdarzenia nie będą zbierane. Dane analityczne są przetwarzane na serwerach PostHog Cloud EU we Frankfurcie w Niemczech (zobacz sekcję 6).' },
                 ],
             },
             { kind: 'p', text: 'Zgodę na pliki cookie możesz wycofać lub zaktualizować w każdej chwili poprzez link "Ustawienia cookie" w stopce naszej strony internetowej albo na stronie niniejszej Polityki Prywatności w aplikacji. Wycofanie zgody analitycznej nie wpływa na działanie platformy.' },
-            { kind: 'subheading', text: 'Pamięć lokalna przeglądarki' },
-            { kind: 'p', text: 'Poza plikami cookie korzystamy z pamięci lokalnej przeglądarki, aby zachować stan aplikacji między sesjami. Obejmuje to: Twoje preferencje języka i motywu; zbuforowaną kopię poziomu i statusu Twojej subskrypcji (przechowywaną do 30 dni, a następnie unieważnianą); oraz robocze dane o terminach kampanii. Dane z pamięci lokalnej są przechowywane wyłącznie na Twoim urządzeniu i nie są przesyłane na nasze serwery niezależnie od Twojego zwykłego korzystania z Usługi. Są usuwane, gdy wyczyścisz dane przeglądarki lub się wylogujesz.' },
+            { kind: 'subheading', text: 'Pamięć lokalna przeglądarki i podręczna kopia na urządzeniu' },
+            { kind: 'p', text: 'Poza plikami cookie korzystamy z pamięci lokalnej przeglądarki, aby zachować stan aplikacji między sesjami. Obejmuje to: token Twojej sesji (zobacz „ściśle niezbędne" powyżej); Twoje preferencje języka i motywu; zbuforowaną kopię poziomu i statusu Twojej subskrypcji (przechowywaną do 30 dni, a następnie unieważnianą); oraz robocze dane o terminach kampanii.' },
+            { kind: 'p', text: 'Przechowujemy również roboczą kopię danych, które już wcześniej wczytałeś, w pamięci IndexedDB Twojej przeglądarki, aby po ponownym otwarciu aplikacji od razu pokazać Twoje ostatnie ekrany zamiast zostawiać Cię przy animacji ładowania. Kopia ta obejmuje do 50 Twoich najnowszych odpowiedzi z naszego API i może zawierać Twoje posty i wersje robocze, Twoje dane statystyczne, dane połączonych kont oraz Twoją skrzynkę odbiorczą, która zawiera komentarze i wiadomości napisane przez inne osoby pod Twoimi postami w mediach społecznościowych. Ogranicza się do danych, do których Twoje konto i tak ma dostęp, jest przypisana do zalogowanego konta, więc inny użytkownik logujący się na tym samym urządzeniu nie może jej odczytać, i jest usuwana przy wylogowaniu, po zakończeniu sesji oraz po wyczyszczeniu danych przeglądarki.' },
+            { kind: 'p', text: 'Wszystkie powyższe dane są przechowywane wyłącznie na Twoim urządzeniu i nie są przesyłane na nasze serwery niezależnie od Twojego zwykłego korzystania z Usługi. Możesz je w każdej chwili usunąć, wylogowując się lub czyszcząc dane przeglądarki.' },
         ],
     },
     {

package/dist/types/scheduling/I_SchedulingAnalytics.d.ts

@@ -10,6 +10,24 @@
  */
 export declare const ANALYTICS_SOURCES: readonly ["daily-metrics", "follower-stats", "content-decay", "top-posts"];
 export type AnalyticsSource = (typeof ANALYTICS_SOURCES)[number];
+/**
+ * The metrics whose visibility is decided by the connected platform mix rather
+ * than by the data itself.
+ *
+ * Not every metric is here. `engagements` is our own roll-up (likes + comments
+ * + shares + saves) and `followerGrowth` comes from the follower-stats surface,
+ * so neither is platform-reported and neither is gated.
+ */
+export declare const GATED_METRICS: readonly ["impressions", "reach", "likes", "comments", "shares", "saves", "clicks", "views"];
+export type GatedMetric = (typeof GATED_METRICS)[number];
+/**
+ * Which gated metrics the current platform mix can actually report.
+ *
+ * An ABSENT entry means UNKNOWN, never unavailable — the producer omits the map
+ * when it could not determine the platform mix, and a consumer must fall
+ * through to showing the figure rather than withhold on a guess.
+ */
+export type MetricAvailability = Partial<Record<GatedMetric, boolean>>;
 /**
  * Aggregated KPI figures for the selected date range.
  * Returned by GET /social/analytics.
@@ -50,6 +68,16 @@ export declare class SchedulingAnalyticsKpiDTO {
      * Absent/true = available.
      */
     reachAvailable?: boolean;
+    /**
+     * Structural availability for every gated metric, from the backend's
+     * per-platform capability map (spec 111). Supersedes the two flags above,
+     * which stay for consumers that only ever read those two.
+     *
+     * ABSENT means UNKNOWN, not unavailable: the backend omits this whole map
+     * when it could not determine the connected platform mix, and a consumer
+     * must show the figure rather than withhold on a guess.
+     */
+    metricAvailability?: MetricAvailability;
     constructor(data: SchedulingAnalyticsKpiDTO);
 }
 /**

package/dist/types/scheduling/I_SchedulingAnalytics.js

@@ -6,7 +6,7 @@
  * per-post timeline snapshots, content decay windows, and follower stats.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchedulingFollowerStatDTO = exports.SchedulingContentDecayDTO = exports.SchedulingPostTimelineEntryDTO = exports.SchedulingBestTimeSlotDTO = exports.SchedulingAnalyticsParamsDTO = exports.SchedulingAnalyticsEntryDTO = exports.SchedulingAnalyticsKpiDTO = exports.ANALYTICS_SOURCES = void 0;
+exports.SchedulingFollowerStatDTO = exports.SchedulingContentDecayDTO = exports.SchedulingPostTimelineEntryDTO = exports.SchedulingBestTimeSlotDTO = exports.SchedulingAnalyticsParamsDTO = exports.SchedulingAnalyticsEntryDTO = exports.SchedulingAnalyticsKpiDTO = exports.GATED_METRICS = exports.ANALYTICS_SOURCES = void 0;
 // ── Analytics sources (AD2-1045) ──────────────────────────────────────────────
 /**
  * The upstream sources an analytics response aggregates. Used by
@@ -18,6 +18,25 @@ exports.ANALYTICS_SOURCES = [
     'content-decay',
     'top-posts',
 ];
+// ── Per-metric structural availability (spec 111) ─────────────────────────────
+/**
+ * The metrics whose visibility is decided by the connected platform mix rather
+ * than by the data itself.
+ *
+ * Not every metric is here. `engagements` is our own roll-up (likes + comments
+ * + shares + saves) and `followerGrowth` comes from the follower-stats surface,
+ * so neither is platform-reported and neither is gated.
+ */
+exports.GATED_METRICS = [
+    'impressions',
+    'reach',
+    'likes',
+    'comments',
+    'shares',
+    'saves',
+    'clicks',
+    'views',
+];
 // ── SchedulingAnalyticsKpiDTO ─────────────────────────────────────────────────
 /**
  * Aggregated KPI figures for the selected date range.
@@ -43,6 +62,9 @@ class SchedulingAnalyticsKpiDTO {
         if (data.reachAvailable !== undefined) {
             this.reachAvailable = data.reachAvailable;
         }
+        if (data.metricAvailability !== undefined) {
+            this.metricAvailability = data.metricAvailability;
+        }
     }
 }
 exports.SchedulingAnalyticsKpiDTO = SchedulingAnalyticsKpiDTO;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ad2app-lib",
-  "version": "1.23.0",
+  "version": "1.25.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",

package/src/analytics/index.test.ts

@@ -88,6 +88,7 @@ const EVENT_PROPERTY_WITNESS: { [E in keyof EventProperties]: EventProperties[E]
   // 080 measurement baseline
   [EVENTS.PAYWALL_SHOWN]: { surface: "upgrade_modal", trigger: "user_click", hit_number: 1, app_locale: "en" },
   [EVENTS.PAYWALL_DISMISSED]: { surface: "upgrade_modal", trigger: "user_click", hit_number: 1, app_locale: "en" },
+  [EVENTS.ACCESS_DENIED]: { reason: "subscription-required", app_locale: "en" },
   [EVENTS.ONBOARDING_STEP_COMPLETED]: { flow: "complete_profile", step: "role", step_index: 1, app_locale: "en" },
   [EVENTS.EXIT_INTENT_SHOWN]: { surface: "connect_wall" },
   [EVENTS.EXIT_INTENT_DISMISSED]: { surface: "connect_wall" },
@@ -202,6 +203,28 @@ test("080 exit_intent_* wire values match the 065 component verbatim (fidelity g
   assert.equal(shown.surface, "connect_wall");
 });
 
+test("AD2-1284 access_denied is locked, and its reasons mirror the backend's two 403s", () => {
+  // The wire name is final: Error Tracking noise was traded for this event, and
+  // renaming it would orphan whatever reads it.
+  assert.equal(EVENTS.ACCESS_DENIED, "access_denied");
+
+  // Both reasons must type-check — they are the two DIFFERENT 403s the backend
+  // sends, and accessDenied.ts's AccessDenial union is the other copy of this
+  // fact. A drift between them is the defect this pins.
+  const beta: EventProperties["access_denied"] = {
+    reason: "beta-required",
+    path: "/social/inbox/messages",
+    app_locale: "pl",
+  };
+  const sub: EventProperties["access_denied"] = {
+    reason: "subscription-required",
+    app_locale: "en",
+  };
+  assert.equal(beta.reason, "beta-required");
+  assert.equal(beta.path, "/social/inbox/messages");
+  assert.equal(sub.path, undefined);
+});
+
 test("080 PAYWALL_HITS person prop is locked; hit_number stays the event-level truth", () => {
   assert.equal(PERSON_PROPS.PAYWALL_HITS, "paywall_hits");
   // The analytical counter lives on the event (person props are query-time-latest).

package/src/analytics/index.ts

@@ -48,6 +48,13 @@ export const EVENTS = {
   // Measurement baseline (080) — paywall / onboarding / exit-intent (frontend-owned)
   PAYWALL_SHOWN: 'paywall_shown', // any monetization surface is shown (upgrade modal / pricing page)
   PAYWALL_DISMISSED: 'paywall_dismissed', // closed without converting
+  // AD2-1284: an entitlement wall rejected an API READ, which is control flow,
+  // not an error. Distinct from PAYWALL_SHOWN because nothing was shown: the
+  // driver classified a 403 at the choke point and the redirect follows. Before
+  // this event existed the only record was a captured $exception, which put
+  // expected paywall hits into Error Tracking and made that dashboard harder to
+  // trust — it is part of why a REAL retry defect sat unnoticed in the same list.
+  ACCESS_DENIED: 'access_denied', // entitlement 403 at the API choke point (beta wall / subscription)
   ONBOARDING_STEP_COMPLETED: 'onboarding_step_completed', // one step of a multi-step flow (complete-profile)
   EXIT_INTENT_SHOWN: 'exit_intent_shown', // exit-intent capture modal armed (065, verbatim wire values)
   EXIT_INTENT_DISMISSED: 'exit_intent_dismissed',
@@ -241,6 +248,14 @@ export interface EventProperties {
     page_views?: number;
     app_locale: AppLocale;
   };
+  // `reason` mirrors accessDenied.ts's AccessDenial union exactly — the two
+  // different 403s the backend sends. `path` is the request path, never a URL
+  // with query params (no PII in analytics).
+  [EVENTS.ACCESS_DENIED]: {
+    reason: 'beta-required' | 'subscription-required';
+    path?: string;
+    app_locale: AppLocale;
+  };
   [EVENTS.PAYWALL_DISMISSED]: {
     surface: 'upgrade_modal' | 'pricing_page';
     trigger: 'user_click' | 'limit_reached' | 'connect_wall';

package/src/legal/privacy.pl.ts

@@ -205,14 +205,16 @@ export const PRIVACY_SECTIONS_PL: LegalSection[] = [
       {
         kind: 'ul',
         items: [
-          { text: '**Pliki cookie ściśle niezbędne:** wymagane do obsługi sesji uwierzytelniania i podstawowych funkcji platformy. Nie można ich wyłączyć bez zakłócenia działania Usługi. Podstawa prawna: art. 6 ust. 1 lit. b, wykonanie umowy; zgoda nie jest wymagana. Czas trwania: sesyjne pliki cookie wygasają po zamknięciu przeglądarki; uwierzytelniające pliki cookie wygasają po 30 dniach bezczynności.' },
+          { text: '**Pliki cookie ściśle niezbędne i równoważna pamięć urządzenia:** wymagane do obsługi sesji uwierzytelniania i podstawowych funkcji platformy. Nie można ich wyłączyć bez zakłócenia działania Usługi. Podstawa prawna: art. 6 ust. 1 lit. b, wykonanie umowy; zgoda nie jest wymagana. Token Twojej sesji przechowujemy w pamięci lokalnej przeglądarki, a nie w pliku cookie; plik cookie służy wyłącznie jako rozwiązanie zapasowe tam, gdzie pamięć lokalna jest niedostępna (na przykład w trybie prywatnym). Czas trwania: Twoja sesja wygasa po 30 dniach bezczynności. Przy każdym otwarciu aplikacji te 30 dni liczone jest od nowa, a jeżeli nie wrócisz w ciągu 30 dni, nastąpi wylogowanie.' },
           { text: '**Funkcjonalne pliki cookie:** ustawiane wyłącznie w bezpośredniej reakcji na podjętą przez Ciebie czynność (np. wybór języka lub motywu) i ściśle niezbędne do wykonania tej konkretnej, zażądanej przez Ciebie funkcji. Nie śledzą Cię między sesjami poza zachowaniem wybranego przez Ciebie ustawienia. Podstawa prawna: ścisła niezbędność do spełnienia Twojego wyraźnego żądania na podstawie art. 173 Prawa telekomunikacyjnego (ePrivacy); odrębna zgoda nie jest wymagana. Czas trwania: do 12 miesięcy lub do wyczyszczenia przez Ciebie danych przeglądarki.' },
           { text: '**Analityczne pliki cookie (PostHog):** zbierają dane o zdarzeniach korzystania w postaci spseudonimizowanej (poza przepływami identyfikującymi opisanymi w sekcji 6), umożliwiają nagrywanie sesji (z maskowaniem wartości wpisywanych w pola formularzy; zobacz sekcję 3) i rejestrują raporty o błędach, abyśmy mogli rozumieć i ulepszać sposób korzystania z Usługi. Podstawa prawna: art. 6 ust. 1 lit. a, zgoda. **Zanim dokonasz wyboru w banerze zgody na pliki cookie, wyświetlanym przy pierwszej wizycie, nie ustawiamy żadnych analitycznych plików cookie i nie rejestrujemy żadnych zdarzeń analitycznych.** Jeżeli wyrazisz zgodę, PostHog ustawia własny plik cookie (o nazwie zaczynającej się od `ph_`) w domenie `ad2.app`, ważny do 1 roku, współdzielony między naszą stroną internetową a aplikacją, aby nie pytać Cię o to dwa razy. Jeżeli odmówisz, żaden analityczny plik cookie nie zostanie ustawiony i żadne zdarzenia nie będą zbierane. Dane analityczne są przetwarzane na serwerach PostHog Cloud EU we Frankfurcie w Niemczech (zobacz sekcję 6).' },
         ],
       },
       { kind: 'p', text: 'Zgodę na pliki cookie możesz wycofać lub zaktualizować w każdej chwili poprzez link "Ustawienia cookie" w stopce naszej strony internetowej albo na stronie niniejszej Polityki Prywatności w aplikacji. Wycofanie zgody analitycznej nie wpływa na działanie platformy.' },
-      { kind: 'subheading', text: 'Pamięć lokalna przeglądarki' },
-      { kind: 'p', text: 'Poza plikami cookie korzystamy z pamięci lokalnej przeglądarki, aby zachować stan aplikacji między sesjami. Obejmuje to: Twoje preferencje języka i motywu; zbuforowaną kopię poziomu i statusu Twojej subskrypcji (przechowywaną do 30 dni, a następnie unieważnianą); oraz robocze dane o terminach kampanii. Dane z pamięci lokalnej są przechowywane wyłącznie na Twoim urządzeniu i nie są przesyłane na nasze serwery niezależnie od Twojego zwykłego korzystania z Usługi. Są usuwane, gdy wyczyścisz dane przeglądarki lub się wylogujesz.' },
+      { kind: 'subheading', text: 'Pamięć lokalna przeglądarki i podręczna kopia na urządzeniu' },
+      { kind: 'p', text: 'Poza plikami cookie korzystamy z pamięci lokalnej przeglądarki, aby zachować stan aplikacji między sesjami. Obejmuje to: token Twojej sesji (zobacz „ściśle niezbędne" powyżej); Twoje preferencje języka i motywu; zbuforowaną kopię poziomu i statusu Twojej subskrypcji (przechowywaną do 30 dni, a następnie unieważnianą); oraz robocze dane o terminach kampanii.' },
+      { kind: 'p', text: 'Przechowujemy również roboczą kopię danych, które już wcześniej wczytałeś, w pamięci IndexedDB Twojej przeglądarki, aby po ponownym otwarciu aplikacji od razu pokazać Twoje ostatnie ekrany zamiast zostawiać Cię przy animacji ładowania. Kopia ta obejmuje do 50 Twoich najnowszych odpowiedzi z naszego API i może zawierać Twoje posty i wersje robocze, Twoje dane statystyczne, dane połączonych kont oraz Twoją skrzynkę odbiorczą, która zawiera komentarze i wiadomości napisane przez inne osoby pod Twoimi postami w mediach społecznościowych. Ogranicza się do danych, do których Twoje konto i tak ma dostęp, jest przypisana do zalogowanego konta, więc inny użytkownik logujący się na tym samym urządzeniu nie może jej odczytać, i jest usuwana przy wylogowaniu, po zakończeniu sesji oraz po wyczyszczeniu danych przeglądarki.' },
+      { kind: 'p', text: 'Wszystkie powyższe dane są przechowywane wyłącznie na Twoim urządzeniu i nie są przesyłane na nasze serwery niezależnie od Twojego zwykłego korzystania z Usługi. Możesz je w każdej chwili usunąć, wylogowując się lub czyszcząc dane przeglądarki.' },
     ],
   },
   {

package/src/legal/privacy.ts

@@ -193,14 +193,16 @@ export const PRIVACY_SECTIONS: LegalSection[] = [
       {
         kind: 'ul',
         items: [
-          { text: '**Strictly necessary cookies:** required for authentication sessions and core platform functionality. Cannot be disabled without breaking the Service. Legal basis: Art. 6(1)(b), contract performance; no consent required. Duration: session cookies expire when you close your browser; authentication cookies expire after 30 days of inactivity.' },
+          { text: '**Strictly necessary cookies and equivalent device storage:** required for authentication sessions and core platform functionality. Cannot be disabled without breaking the Service. Legal basis: Art. 6(1)(b), contract performance; no consent required. Your session token is held in your browser\'s local storage rather than in a cookie; a cookie is used only as a fallback where local storage is unavailable (for example private browsing). Duration: your session expires after 30 days of inactivity. Each time you open the app the 30 days start again, and if you do not return within 30 days you are signed out.' },
           { text: '**Functional cookies:** set only in direct response to an action you take (e.g. selecting a language or theme preference), and strictly necessary to deliver that specific function you have requested. They do not track you across sessions beyond preserving your chosen setting. Legal basis: strictly necessary to fulfil your explicit request under Art. 173 of the Polish Telecommunications Act (ePrivacy); no separate consent required. Duration: up to 12 months, or cleared when you clear your browser data.' },
           { text: '**Analytics cookies (PostHog):** collect usage event data in pseudonymised form (other than the identifying flows described in Section 6), enable session replay (with form-field values masked; see Section 3), and capture error reports to help us understand and improve how the Service is used. Legal basis: Art. 6(1)(a), consent. **No analytics cookies are set and no analytics events are captured before you make a choice** in the cookie consent banner shown on first visit. If you accept, PostHog sets a first-party cookie (name beginning `ph_`) on the `ad2.app` domain, valid for up to 1 year, shared between our website and the app so you are not asked twice. If you decline, no analytics cookie is set and no events are collected. Analytics data is processed on PostHog Cloud EU servers in Frankfurt, Germany (see Section 6).' },
         ],
       },
       { kind: 'p', text: 'You may withdraw or update your cookie consent at any time via the "Cookie settings" link in the footer of our website, or on this Privacy Policy page in the app. Withdrawing analytics consent does not affect platform functionality.' },
-      { kind: 'subheading', text: 'Browser local storage' },
-      { kind: 'p', text: 'In addition to cookies, we use browser local storage to preserve application state between sessions. This includes: your language and theme preferences; a cached copy of your subscription tier and status (retained for up to 30 days then invalidated); and draft campaign deadline data. Local storage data is stored on your device only and is not transmitted to our servers independently of your normal usage. It is cleared when you clear your browser data or log out.' },
+      { kind: 'subheading', text: 'Browser local storage and on-device cache' },
+      { kind: 'p', text: 'In addition to cookies, we use browser local storage to preserve application state between sessions. This includes: your session token (see "Strictly necessary" above); your language and theme preferences; a cached copy of your subscription tier and status (retained for up to 30 days then invalidated); and draft campaign deadline data.' },
+      { kind: 'p', text: 'We also keep a working copy of data you have already loaded in your browser\'s IndexedDB storage, so the app can show your most recent screens immediately when you reopen it instead of leaving you on a loading spinner. This copy holds up to 50 of your most recent responses from our API and can include your posts and drafts, your analytics figures, your connected account details, and your inbox, which contains comments and messages written by other people on your social media posts. It is limited to data your account is already entitled to see, is scoped to the signed-in account so a different user signing in on the same device cannot read it, and is deleted when you sign out, when your session ends, or when you clear your browser data.' },
+      { kind: 'p', text: 'All of the above is stored on your device only and is not transmitted to our servers independently of your normal usage. You can remove it at any time by signing out or clearing your browser data.' },
     ],
   },
   {

package/src/types/scheduling/I_SchedulingAnalytics.test.ts

@@ -2,7 +2,9 @@ import { test } from 'node:test';
 import assert from 'node:assert/strict';
 import {
   ANALYTICS_SOURCES,
+  GATED_METRICS,
   SchedulingAnalyticsKpiDTO,
+  type MetricAvailability,
 } from './I_SchedulingAnalytics';
 
 // AD2-1045 — the analytics partial-failure signal: a KPI response can name
@@ -89,3 +91,58 @@ test('impressionsAvailable/reachAvailable are optional and absent by default (ba
   assert.equal('impressionsAvailable' in serialized, false);
   assert.equal('reachAvailable' in serialized, false);
 });
+
+// Spec 111 — per-metric structural availability. The two AD2-1078 flags above
+// only ever described impressions and reach; the capability map the backend
+// now derives covers eight metrics, and it travelled as an undeclared field
+// cast onto the DTO on one side and re-widened on the other until this landed.
+
+test('SchedulingAnalyticsKpiDTO carries metricAvailability when provided', () => {
+  const kpi = new SchedulingAnalyticsKpiDTO({
+    impressions: 10,
+    reach: 5,
+    engagements: 4,
+    views: 20,
+    engagementRate: 1.2,
+    followerGrowth: 3,
+    metricAvailability: { reach: false, saves: true, clicks: false },
+  });
+  assert.equal(kpi.metricAvailability?.reach, false);
+  assert.equal(kpi.metricAvailability?.saves, true);
+  assert.equal(kpi.metricAvailability?.clicks, false);
+  assert.deepEqual(
+    JSON.parse(JSON.stringify(kpi)).metricAvailability,
+    { reach: false, saves: true, clicks: false },
+  );
+});
+
+test('metricAvailability is optional and absent by default — absent means UNKNOWN', () => {
+  const kpi = new SchedulingAnalyticsKpiDTO({
+    impressions: 10,
+    reach: 5,
+    engagements: 4,
+    views: 20,
+    engagementRate: 1.2,
+    followerGrowth: 3,
+  });
+  assert.equal(kpi.metricAvailability, undefined);
+  assert.equal('metricAvailability' in JSON.parse(JSON.stringify(kpi)), false);
+});
+
+test('GATED_METRICS names every metric the capability map gates, and nothing else', () => {
+  // engagements is our own roll-up and followerGrowth is a different surface —
+  // neither is platform-reported, so neither may appear here.
+  assert.deepEqual([...GATED_METRICS], [
+    'impressions',
+    'reach',
+    'likes',
+    'comments',
+    'shares',
+    'saves',
+    'clicks',
+    'views',
+  ]);
+  const availability: MetricAvailability = {};
+  for (const metric of GATED_METRICS) availability[metric] = true;
+  assert.equal(Object.keys(availability).length, 8);
+});

package/src/types/scheduling/I_SchedulingAnalytics.ts

@@ -20,6 +20,38 @@ export const ANALYTICS_SOURCES = [
 
 export type AnalyticsSource = (typeof ANALYTICS_SOURCES)[number];
 
+// ── Per-metric structural availability (spec 111) ─────────────────────────────
+
+/**
+ * The metrics whose visibility is decided by the connected platform mix rather
+ * than by the data itself.
+ *
+ * Not every metric is here. `engagements` is our own roll-up (likes + comments
+ * + shares + saves) and `followerGrowth` comes from the follower-stats surface,
+ * so neither is platform-reported and neither is gated.
+ */
+export const GATED_METRICS = [
+  'impressions',
+  'reach',
+  'likes',
+  'comments',
+  'shares',
+  'saves',
+  'clicks',
+  'views',
+] as const;
+
+export type GatedMetric = (typeof GATED_METRICS)[number];
+
+/**
+ * Which gated metrics the current platform mix can actually report.
+ *
+ * An ABSENT entry means UNKNOWN, never unavailable — the producer omits the map
+ * when it could not determine the platform mix, and a consumer must fall
+ * through to showing the figure rather than withhold on a guess.
+ */
+export type MetricAvailability = Partial<Record<GatedMetric, boolean>>;
+
 // ── SchedulingAnalyticsKpiDTO ─────────────────────────────────────────────────
 
 /**
@@ -62,6 +94,16 @@ export class SchedulingAnalyticsKpiDTO {
    * Absent/true = available.
    */
   reachAvailable?: boolean;
+  /**
+   * Structural availability for every gated metric, from the backend's
+   * per-platform capability map (spec 111). Supersedes the two flags above,
+   * which stay for consumers that only ever read those two.
+   *
+   * ABSENT means UNKNOWN, not unavailable: the backend omits this whole map
+   * when it could not determine the connected platform mix, and a consumer
+   * must show the figure rather than withhold on a guess.
+   */
+  metricAvailability?: MetricAvailability;
 
   constructor(data: SchedulingAnalyticsKpiDTO) {
     this.impressions = data.impressions;
@@ -82,6 +124,9 @@ export class SchedulingAnalyticsKpiDTO {
     if (data.reachAvailable !== undefined) {
       this.reachAvailable = data.reachAvailable;
     }
+    if (data.metricAvailability !== undefined) {
+      this.metricAvailability = data.metricAvailability;
+    }
   }
 }