@fragmentsx/fragments-client 0.1.0 → 0.2.0-dev-20260901074721

package/dist/namespaces.d.ts

@@ -0,0 +1,92 @@
+import { FragmentsCacheNamespace } from './$fragments/index';
+import { AreaNamespace } from './$area/index';
+import { CssChunkRef } from './types';
+import { RestResult } from './fetch/restFetcher';
+export type { AreaNamespace } from './$area/index';
+/**
+ * FilterOverrides — форма значений таргетинга, читаемых compiled fetch-транспортом
+ * при построении заголовков `X-Filter-*` (quick 260830-rvp, INT-07: вынесена в
+ * именованный тип, раньше была анонимно вложена в `FragmentsEnv`).
+ */
+export interface FilterOverrides {
+    deviceType?: string;
+    osType?: string;
+    page?: string;
+    geo?: {
+        code?: string;
+    };
+    ip?: string;
+}
+/**
+ * FragmentsEnv — типизированная форма `state.env`, которую читает compiled chain.
+ * Зеркалирует inline buildHeaders(env: {...}) из legacy compiled/$area/index.ts:82-127.
+ * D-05: убирает зависимость от широкого union'а Scalar в state.env.* доступах.
+ */
+export interface FragmentsEnv {
+    backendEndpoint?: string;
+    apiToken?: string;
+    referer?: string;
+    debug?: boolean;
+    timeout?: number;
+    filterOverrides?: FilterOverrides;
+}
+/**
+ * FetchNamespace — низкоуровневый транспорт с тремя capabilities.
+ * Реализуется fetchPlugin (packages/fragments-client/src/fetch/index.ts).
+ *
+ * - get: baseUrl-relative GET с typed-error mapping (D-04, используется $area.resolve)
+ * - sendBeacon: пропускает url+body в navigator.sendBeacon напрямую (CR-01 fix)
+ *   сигнатура (url, body?) => boolean честно отражает реализацию
+ * - getAbsolute: cross-origin fire-and-forget GET без baseUrl prefix (CR-02 fix)
+ *   для ad pixel / third-party tracker URL; mode: no-cors, credentials: omit
+ */
+export interface FetchNamespace {
+    get: <T = unknown>(path: string) => Promise<RestResult<T>>;
+    sendBeacon: (url: string, body?: BodyInit | null) => boolean;
+    getAbsolute?: (url: string) => void;
+}
+/**
+ * CssChunksNamespace — кэш CSS chunk'ов с DOM injection.
+ * Idempotent populate — повторный вызов с тем же id игнорируется.
+ *
+ * quick-260831-etq: `populate` возвращает `Promise<void>` готовности
+ * (settles по `loaded` всех чанков, включая уже закэшированные).
+ */
+export interface CssChunksNamespace {
+    has: (id: number) => boolean;
+    populate: (refs: Record<number, CssChunkRef>) => Promise<void>;
+}
+declare module "@graph-state/core" {
+    interface GraphState {
+        /**
+         * Conditional env shape для compiled-flow.
+         * Не пересекается с widegate Scalar — даёт точные типы при `state.env.filterOverrides.deviceType` и пр.
+         */
+        env?: FragmentsEnv;
+        /**
+         * Namespace resolve compiled area.
+         */
+        $area?: AreaNamespace;
+        /**
+         * Кэш загруженных compiled fragment ComponentType'ов.
+         * Suspense protocol: read() бросает Promise (pending) или Error (error).
+         */
+        $fragments?: FragmentsCacheNamespace;
+        /**
+         * Кэш CSS chunk'ов с DOM injection.
+         */
+        $cssChunks?: CssChunksNamespace;
+        /**
+         * Fetch namespace — низкоуровневый транспорт.
+         */
+        $fetch?: FetchNamespace;
+        /**
+         * quick 260830-rvp, INT-07: живая смена таргетинга. Мержит переданные
+         * overrides поверх текущих на верхнем уровне (`geo` заменяется целиком) —
+         * монтируется createFragmentsClient, потребляется fetchPlugin (buildHeaders
+         * читает `state.env.filterOverrides` лениво, на каждый запрос).
+         */
+        setFilters?: (overrides: Partial<FilterOverrides>) => void;
+    }
+}
+//# sourceMappingURL=namespaces.d.ts.map

package/dist/namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC;IAC7D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,UAAU;QAClB;;;WAGG;QACH,GAAG,CAAC,EAAE,YAAY,CAAC;QACnB;;WAEG;QACH,KAAK,CAAC,EAAE,aAAa,CAAC;QACtB;;;WAGG;QACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;QACrC;;WAEG;QACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;QAChC;;WAEG;QACH,MAAM,CAAC,EAAE,cAAc,CAAC;QACxB;;;;;WAKG;QACH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;KAC5D;CACF"}

package/dist/stylesheet.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Единственный источник истины по seam'у DOM-инъекции CSS/шрифтов и по
+ * построителям ключей `<link>` (BLOCKER-4, key parity — quick-260831-etq).
+ *
+ * Три плагина ($fragments, $cssChunks, $area) и рендер (`FragmentRenderer` в
+ * `@fragmentsx/runtime-react`) обязаны строить ключ ОДНИМ и тем же построителем
+ * — иначе ранний инжект (эта задача) и `<FragmentStylesheet>` в рендере дадут
+ * два `<link>` на один href вместо ref-count дедупа.
+ *
+ * `loaded` в `StylesheetHandle` опционален: граница `fragments-client` не
+ * вправе требовать DOM-возможностей от инжектора — `readyOf` трактует их
+ * отсутствие как «ждать нечего», а не как сбой.
+ */
+/** Handle DOM-инъекции стиля — совместим с `injectStylesheet` из `@fragmentsx/runtime-react`. */
+export type StylesheetHandle = (() => void) & {
+    loaded?: Promise<void>;
+};
+/** DI seam для DOM-инъекции — реализуется `injectStylesheet` (runtime-react). */
+export type InjectFn = (href: string, key: string) => StylesheetHandle;
+/**
+ * Готовность CSS у уже инжектированного handle. Отсутствие канала готовности
+ * (легаси-инжектор/мок без `loaded`) означает «ждать нечего», а не сбой.
+ */
+export declare const readyOf: (handle: StylesheetHandle | undefined) => Promise<void>;
+/** Ключ `<link>` для собственного CSS фрагмента `id`. */
+export declare const fragmentCssKey: (id: number) => string;
+/** Ключ `<link>` для `@font-face` CSS фрагмента `id`. */
+export declare const fragmentFontsKey: (id: number) => string;
+/** Ключ `<link>` для CSS chunk'а `id` — формат, уже используемый `$cssChunks`. */
+export declare const cssChunkKey: (id: number) => string;
+/** Ключ `<link>` для глобального baseline reset CSS области. */
+export declare const AREA_GLOBAL_CSS_KEY = "global";
+//# sourceMappingURL=stylesheet.d.ts.map

package/dist/stylesheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylesheet.d.ts","sourceRoot":"","sources":["../src/stylesheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,iGAAiG;AACjG,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEzE,iFAAiF;AACjF,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,gBAAgB,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,gBAAgB,GAAG,SAAS,KAAG,OAAO,CAAC,IAAI,CACtC,CAAC;AAEtC,yDAAyD;AACzD,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAA8B,CAAC;AAE3E,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,KAAG,MAAgC,CAAC;AAE/E,kFAAkF;AAClF,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,MAAuB,CAAC;AAEjE,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,WAAW,CAAC"}

package/dist/types.d.ts

@@ -66,6 +66,15 @@ export interface AreaResolveResponse {
     areaCode: string;
     /** Идентификатор root фрагмента — ключ в `fragments` map. */
     rootFragmentId: number;
+    /**
+     * Quick 260831-dor (INT-10): id выбранного варианта — вход для атрибуции
+     * на стороне площадки-потребителя.
+     *
+     * Поле аддитивное и опциональное на границе HTTP: старый сервер (до этой
+     * правки) его не отдаёт. Тот же приём, что применён к `props`/`projectProperties`
+     * ниже в этом же интерфейсе.
+     */
+    variantId?: number;
     /** Flat map всех reachable фрагментов (root + все nested). Keyed by fragment id. */
     fragments: Record<number, FragmentRef>;
     /** Flat map CSS chunks. Keyed by chunk id. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;;GAGG;AACH,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB,cAAc,GACd;IAAE,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAAA;CAAE,GACjC,KAAK,CAAC;IAAE,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAAA;CAAE,CAAC,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,UAAU,EAAE,CAAC,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClD;;;;;OAKG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;;GAGG;AACH,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB,cAAc,GACd;IAAE,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAAA;CAAE,GACjC,KAAK,CAAC;IAAE,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAAA;CAAE,CAAC,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,UAAU,EAAE,CAAC,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClD;;;;;OAKG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fragmentsx/fragments-client",
   "private": false,
-  "version": "0.1.0",
+  "version": "0.2.0-dev-20260901074721",
   "license": "MIT",
   "repository": {
     "type": "git",