@fragmentsx/fragments-client 0.1.0

package/dist/metrics/__tests__/globalMetrics.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Регрессионные тесты для globalMetricsPlugin (CR-02).
+ *
+ * CR-02 fix: fetcher больше не строит double-prefix URL через state.$fetch.get(absolutePixelUrl).
+ * Вместо этого использует state.$fetch.getAbsolute(pixelUrl) — без baseUrl concat.
+ *
+ * Тесты:
+ * 1. sendAdPixel(pixelUrl) при наличии state.$fetch.getAbsolute → передаёт fetcher в trackAdPixel
+ * 2. restFetcher.getAbsolute не конкатенирует baseUrl (тест на уровне module)
+ * 3. getAbsolute — fire-and-forget, не падает при ошибке fetch
+ * 4. getAbsolute опции: method GET, mode no-cors, credentials omit, keepalive true
+ * 5. state.$fetch mock содержит get, sendBeacon, getAbsolute
+ * 6. Regression-guard CR-02: state.$fetch.get НЕ вызван с абсолютным pixelUrl
+ */
+export {};
+//# sourceMappingURL=globalMetrics.test.d.ts.map

package/dist/metrics/__tests__/globalMetrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalMetrics.test.d.ts","sourceRoot":"","sources":["../../../src/metrics/__tests__/globalMetrics.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/metrics/globalMetrics.d.ts

@@ -0,0 +1,18 @@
+import { Plugin } from '@graph-state/core';
+declare module "@graph-state/core" {
+    interface GraphState {
+        $metrics: {
+            reachGoal: (goal: GoalInfo) => void;
+            trackAdPixel: (pixelUrl: string) => void;
+        };
+    }
+}
+interface GoalInfo {
+    areaId: number;
+    campaignId: number;
+    goalId: number;
+    variantId: number;
+}
+export declare const globalMetricsPlugin: Plugin;
+export {};
+//# sourceMappingURL=globalMetrics.d.ts.map

package/dist/metrics/globalMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalMetrics.d.ts","sourceRoot":"","sources":["../../src/metrics/globalMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,UAAU;QAClB,QAAQ,EAAE;YACR,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;YACpC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;SAC1C,CAAC;KACH;CACF;AAQD,UAAU,QAAQ;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,mBAAmB,EAAE,MAiCjC,CAAC"}

package/dist/metrics/trackAdPixel.d.ts

@@ -0,0 +1,31 @@
+/**
+ * trackAdPixel — отправка рекламного пикселя через доступный транспорт.
+ *
+ * Порядок приоритетов (sendBeacon-first):
+ * 1. customBeacon — capability переданная из globalMetricsPlugin (state.$fetch.sendBeacon)
+ * 2. navigator.sendBeacon — нативный браузерный API
+ * 3. fetcher — fetch-capability переданная как параметр (D-04/CCORE-04: без прямого вызова глобального fetch)
+ * 4. Image pixel fallback — последний резерв
+ *
+ * D-04 / CCORE-04: fetch-fallback маршрутизируется через compiled fetchPlugin (Plan 02), без raw globals.
+ * Вместо этого принимает fetcher как параметр, маршрутизируемый через
+ * compiled fetchPlugin в Plan 02 (zero-fetch target по всему src/).
+ *
+ * TODO(Plan-02): fetcher параметр заполняется из state.$fetch.get в globalMetricsPlugin.
+ */
+type BeaconSender = (url: string) => boolean | void;
+/**
+ * Функция-fetcher для fallback — принимается как параметр (НЕ raw fetch).
+ * В Plan 02 будет маршрутизироваться через compiled fetchPlugin.get().
+ */
+type FetcherFn = (url: string) => void;
+/**
+ * Отправляет ad pixel через доступный транспорт.
+ *
+ * @param pixelUrl - URL рекламного пикселя
+ * @param customBeacon - опциональный beacon sender (state.$fetch.sendBeacon из globalMetricsPlugin)
+ * @param fetcher - опциональный fetch-capability для fallback (маршрутизируется через fetchPlugin в Plan 02)
+ */
+export declare const trackAdPixel: (pixelUrl: string, customBeacon?: BeaconSender, fetcher?: FetcherFn) => void;
+export {};
+//# sourceMappingURL=trackAdPixel.d.ts.map

package/dist/metrics/trackAdPixel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackAdPixel.d.ts","sourceRoot":"","sources":["../../src/metrics/trackAdPixel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;AAEpD;;;GAGG;AACH,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAyDvC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,eAAe,YAAY,EAC3B,UAAU,SAAS,SAoCpB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Runtime contract для `/api/area/<code>/compiled` endpoint (D-03).
+ *
+ * Типы описывают flat manifest ответ backend'а при eager full-graph traversal.
+ * Downstream потребители: `$area.resolve`, `$fragments`, `$cssChunks` namespaces,
+ * хуки `useArea` / `useFragmentComponent` из `@fragmentsx/runtime-react`.
+ *
+ * Ref: Req #2 / D-02 namespace shape (05.2-SPEC.md)
+ */
+/**
+ * Идентификатор поля Object/Array Variable.
+ * Используется в nested `ResolvedValue` как ключ record'а.
+ */
+export type FieldId = string;
+/**
+ * Скалярное resolved значение переменной.
+ * @internal
+ */
+type ResolvedScalar = string | number | boolean | null;
+/**
+ * Resolved значение property уровня — скаляр, объект или массив объектов.
+ *
+ * - scalar: Color/String/Number/Boolean
+ * - Object Variable → Record<FieldId, ResolvedValue> (META-ключи `_type`/`_id`/`parent` отсутствуют)
+ * - Array Variable → Array<Record<FieldId, ResolvedValue>> по definition.fields shape
+ */
+export type ResolvedValue = ResolvedScalar | {
+    [key: FieldId]: ResolvedValue;
+} | Array<{
+    [key: FieldId]: ResolvedValue;
+}>;
+/**
+ * Ссылка на compiled fragment artifact.
+ *
+ * Req #2 + Req #11 fontsUrl slot:
+ * - `moduleUrl` — CDN URL `.js` ESM bundle скомпилированного фрагмента
+ * - `cssUrl` — CDN URL `.css` статического стиля фрагмента
+ * - `fontsUrl` — CDN URL `.fonts.css` с `@font-face` правилами;
+ *   `null` если фрагмент не использует шрифты
+ */
+export interface FragmentRef {
+    id: number;
+    contentHash: string;
+    moduleUrl: string;
+    cssUrl: string;
+    fontsUrl: string | null;
+}
+/**
+ * Ссылка на CSS chunk (общий CSS artifact).
+ */
+export interface CssChunkRef {
+    id: number;
+    cssUrl: string;
+}
+/**
+ * Flat manifest ответ от `/api/area/<code>/compiled` endpoint.
+ *
+ * Req #2 / D-02 namespace shape:
+ * - `apiVersion: 1` — литеральный тип для forward-incompat strict equality (D-14)
+ * - `fragments` — flat map всех reachable фрагментов включая root и nested
+ * - `props` — готовые значения props корневого артефакта (Phase 73, B-02)
+ */
+export interface AreaResolveResponse {
+    /** Версия manifest протокола. Клиент проверяет strict equality. */
+    apiVersion: 1;
+    areaCode: string;
+    /** Идентификатор root фрагмента — ключ в `fragments` map. */
+    rootFragmentId: number;
+    /** Flat map всех reachable фрагментов (root + все nested). Keyed by fragment id. */
+    fragments: Record<number, FragmentRef>;
+    /** Flat map CSS chunks. Keyed by chunk id. */
+    cssChunks: Record<number, CssChunkRef>;
+    /**
+     * Phase 73, B-02/B-06: готовые значения props корневого артефакта — привязки
+     * `{$ref:{scope,name}}` из `Variant.props` уже разрешены сервером
+     * (`resolveVariantProps`, `@fragmentsx/definition`). Автоподстановки по имени
+     * (снятый `_id`-канал) больше нет — B-13.
+     *
+     * Поле аддитивное и опциональное на границе HTTP: старый сервер (до плана
+     * 73-05) его не отдаёт.
+     */
+    props?: Record<string, ResolvedValue>;
+    /**
+     * Phase 72, D-72-01/D-72-02: словарь переменных ПРОЕКТА (ключ — `name`,
+     * значение — голое, без типа/дескриптора переменной) — вход для
+     * `useProjectProperty` из `@fragmentsx/runtime-react`.
+     *
+     * Отдельное поле, а не часть `props`: `props` несёт только резолв конкретных
+     * привязок props корневого артефакта, а этот словарь — строго project-only
+     * (D-72-05) и доступен `useProjectProperty` в любом узле дерева, не только
+     * в props корневого артефакта — одноимённая area-переменная другого типа
+     * через общий каскад уронила бы артефакт целиком, и запрет A-14 её не сторожит.
+     *
+     * Содержимое шейкнуто (D-72-03): в ответ попадают только имена, которые
+     * реально читает хотя бы один TSX-артефакт области, а не весь словарь проекта.
+     *
+     * Поле аддитивное и опциональное: документный путь на него не опирается.
+     */
+    projectProperties?: Record<string, ResolvedValue>;
+    /**
+     * URL к глобальному baseline reset CSS ([data-key^="Text"], [data-key^="Fragment"]).
+     * Аналог `globalStylesheetPlugin` из JIT pipeline, доставляется backend'ом как
+     * статический shared resource (immutable cache).
+     * `null` — backend не настроен возвращать global reset (legacy / dev).
+     */
+    globalCssUrl: string | null;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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"}

package/dist/utils/createConstants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Локальная копия `createConstants` из `@fragmentsx/utils` (quick-260830-kyg,
+ * задача 3) — пакет утилит перестаёт быть зависимостью compile-пути.
+ *
+ * Дженерик переносится дословно, с сигнатурой `<K extends string>` и
+ * возвращаемым отображением `{ [P in K]: P }`: упрощение до `string` молча
+ * лишило бы потребителей (`PLUGIN_TYPES`) литеральных типов.
+ */
+export declare const createConstants: <K extends string>(...constants: K[]) => { [P in K]: P; };
+//# sourceMappingURL=createConstants.d.ts.map

package/dist/utils/createConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createConstants.d.ts","sourceRoot":"","sources":["../../src/utils/createConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,QACtC,CAAC,YAI7B,CAAC"}

package/dist/utils/isBrowser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Локальная копия `isBrowser` из `@fragmentsx/utils` (quick-260830-kyg,
+ * задача 3) — пакет утилит перестаёт быть зависимостью compile-пути.
+ *
+ * Собственная копия здесь обязательна: импортировать `isBrowser` из
+ * `@fragmentsx/runtime-react` нельзя — тот пакет зависит от этого
+ * (`fragments-client`), импорт в обратную сторону дал бы циклическую
+ * зависимость.
+ */
+export declare const isBrowser: boolean;
+//# sourceMappingURL=isBrowser.d.ts.map

package/dist/utils/isBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isBrowser.d.ts","sourceRoot":"","sources":["../../src/utils/isBrowser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,SAAgC,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@fragmentsx/fragments-client",
+  "private": false,
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FireworksX/fragments.git",
+    "directory": "packages/fragments-client"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs.js",
+      "source": "./src/index.ts"
+    }
+  },
+  "dependencies": {
+    "@graph-state/checkers": "^0.1.3",
+    "@graph-state/core": "^0.13.3"
+  },
+  "devDependencies": {
+    "@graph-state/plugin-logger": "^0.3.0",
+    "typescript": "^5.5.4",
+    "vite": "^6.1.0",
+    "vite-plugin-dts": "^4.5.0",
+    "vitest": "^3.1.1",
+    "@fragmentsx/definition": "0.2.3"
+  },
+  "scripts": {
+    "clear": "rm -r -f ./dist",
+    "build": "vite build",
+    "dev": "vite build -w",
+    "test": "vitest --run --config ./vitest.config.ts",
+    "lint": "eslint . --ext .ts,.tsx --fix"
+  }
+}