npm - coreless-lib - Versions diffs - 0.0.1 - Mend

coreless-lib 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,217 @@
+# Coreless Lib - Документация для начинающих
+Библиотека для управления контентом вашего сайта без сложностей.
+Представьте: весь текст, картинки и меню вашего сайта хранятся на сервере, а вы просто "заказываете" их по имени.
+---
+## 🟢 1. Чистый JavaScript (Без сборщиков)
+Самый простой способ — подключить библиотеку прямо в HTML-файл через CDN.
+**Шаг 1. Создайте `index.html`**
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>Мой сайт</title>
+</head>
+<body>
+    <h1 id="title">Загрузка...</h1>
+    <p id="desc"></p>
+    <img id="image" src="" style="display:none; width: 200px;">
+    <!-- Подключаем библиотеку как модуль -->
+    <script type="module">
+        // Импортируем класс Coreless прямо из сети (или локально ./dist/index.js)
+        import { Coreless } from 'https://unpkg.com/coreless-lib?module';
+        // 1. Настройка: куда стучаться за данными?
+        const cms = new Coreless({
+            apiHost: 'http://localhost:8080', // Адрес вашего API
+            projectSlug: '123'                // ID вашего проекта
+        });
+        async function start() {
+            try {
+                // 2. Получаем страницу "home"
+                const page = await cms.getPage('home');
+                // 3. Используем данные
+                // text() - для текста
+                document.getElementById('title').innerText = page.text('hero/title');
+                document.getElementById('desc').innerText = page.text('hero/description');
+                // image() - для картинок
+                const photo = page.image('photo1');
+                if (photo) {
+                    const img = document.getElementById('image');
+                    img.src = photo.url;
+                    img.style.display = 'block';
+                }
+            } catch (error) {
+                console.error('Ошибка:', error);
+                document.getElementById('title').innerText = 'Ошибка загрузки';
+            }
+        }
+        start();
+    </script>
+</body>
+</html>
+```
+---
+## 🔵 2. React (Client Side Rendering)
+Если вы делаете стандартное React-приложение (Create React App, Vite).
+**Установка:**
+```bash
+npm install coreless-lib
+```
+**Шаг 1. Настройте провайдер в `App.tsx` (или `main.tsx`)**
+Это нужно сделать один раз на самом верху приложения.
+```tsx
+import { CorelessProvider, HttpContentFetcher } from 'coreless-lib';
+// Создаем "связиста"
+const fetcher = new HttpContentFetcher({
+  apiHost: 'http://localhost:8080',
+  projectSlug: '123'
+});
+function App() {
+  return (
+    // Оборачиваем все приложение
+    <CorelessProvider fetcher={fetcher}>
+       <HomePage />
+    </CorelessProvider>
+  );
+}
+```
+**Шаг 2. Используйте хук `useContent` в компонентах**
+В любом компоненте внутри провайдера.
+```tsx
+import { useContent } from 'coreless-lib';
+export const HomePage = () => {
+  // Просим данные страницы "home"
+  const content = useContent('home');
+  // Пока грузится — показываем спиннер
+  if (content.loading) return <div>Загрузка...</div>;
+  // Если ошибка — показываем сообщение
+  if (content.error) return <div>Ошибка: {content.error.message}</div>;
+  return (
+    <main>
+      {/* Текст */}
+      <h1>{content.text('header/title')}</h1>
+      {/* Картинка */}
+      <img src={content.image('header/logo')?.url} alt="Logo" />
+      {/* Список (например, блог) */}
+      {content.list('blog').map(post => (
+        <article key={post.slug}>
+           <h2>{post.data.title}</h2>
+        </article>
+      ))}
+    </main>
+  );
+};
+```
+---
+## ⚫ 3. Next.js (Server Side Rendering / App Router)
+Самый современный подход. Данные грузятся **на сервере**, а пользователь получает готовый HTML. Это супер быстро и полезно для SEO.
+**Шаг 1. Создайте файл `lib/cms.ts`**
+Чтобы не создавать подключение каждый раз, сделаем его один раз.
+```ts
+// lib/cms.ts
+import { Coreless } from 'coreless-lib';
+export const cms = new Coreless({
+  apiHost: process.env.CMS_API_HOST || 'http://localhost:8080',
+  projectSlug: '123'
+});
+```
+**Шаг 2. Используйте на странице `app/page.tsx`**
+Заметьте: тут **нет** `useEffect` или `loading`. Функция `async` сама всё подождет.
+```tsx
+// app/page.tsx
+import { cms } from '@/lib/cms';
+// Компонент должен быть async!
+export default async function Page() {
+  // Грузим данные прямо на сервере
+  const page = await cms.getPage('home');
+  return (
+    <main>
+      <h1>{page.text('hero/title')}</h1>
+      <p>{page.text('hero/description')}</p>
+      {/* Таблица */}
+      {(() => {
+        const table = page.table('methods');
+        if (!table) return null;
+        return (
+          <table>
+            <thead>
+              <tr>
+                {table.fields.map(f => <th key={f.slug}>{f.name}</th>)}
+              </tr>
+            </thead>
+            <tbody>
+              {table.rows.map((row: any) => (
+                <tr key={row._id}>
+                  <td>{row.title}</td>
+                  <td>{row.description}</td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        );
+      })()}
+    </main>
+  );
+}
+```
+---
+## 📚 Шпаргалка по методам (API Reference)
+Какой метод выбрать?
+| Тип данных | Метод | Что возвращает | Пример использования |
+| :--- | :--- | :--- | :--- |
+| **Текст** | `content.text('path')` | `string` | Заголовки, описания, имена |
+| **Картинка** | `content.image('path')` | `{ url, width, height... }` | `<img src={...} />` |
+| **Видео** | `content.video('path')` | `{ url, duration... }` | `<video src={...} />` |
+| **Файл** | `content.file('path')` | `{ url, size, name... }` | Скачать PDF, отчет |
+| **Список** | `content.list('path')` | `Array<ContentNode>` | Список новостей, меню, слайдер |
+| **Таблица** | `content.table('path')` | `{ fields, rows }` | Таблицы цен, характеристик |
+| **Сырые данные** | `content.field('path')` | `any` | Если нужно что-то специфичное (настройки, цвета) |
+**Важно:**
+*   Все методы (кроме `list` и `table`) могут вернуть `undefined`, если данных нет.
+*   Используйте `?.` (optional chaining) в JS: `content.image('logo')?.url`.

package/dist/api/client.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+import { ContentNode } from '../core/types';
+export interface ContentFetcher {
+    /**
+     * Загрузка страницы (дерева узлов) по slug проекта
+     */
+    fetch(pageSlug: string): Promise<ContentNode>;
+    /**
+     * Обновление узла (PATCH) по его url
+     */
+    update(url: string, data: Partial<ContentNode>): Promise<ContentNode>;
+}
+export interface HttpContentFetcherConfig {
+    /**
+     * Хост API, например 'http://localhost:8080'
+     */
+    apiHost: string;
+    /**
+     * Идентификатор/slug проекта
+     */
+    projectSlug: string;
+    /**
+     * Дополнительные заголовки запроса
+     */
+    headers?: Record<string, string>;
+}
+export declare class HttpContentFetcher implements ContentFetcher {
+    private apiHost;
+    private projectSlug;
+    private headers;
+    constructor(config: HttpContentFetcherConfig);
+    fetch(pageSlug: string): Promise<ContentNode>;
+    update(url: string, data: Partial<ContentNode>): Promise<ContentNode>;
+}

package/dist/api/client.js ADDED Viewed

@@ -0,0 +1,100 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var HttpContentFetcher = /** @class */ (function () {
+    function HttpContentFetcher(config) {
+        // Удаляем trailing slash если есть
+        this.apiHost = config.apiHost.replace(/\/$/, '');
+        this.projectSlug = config.projectSlug;
+        this.headers = config.headers || {};
+    }
+    HttpContentFetcher.prototype.fetch = function (pageSlug) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url, response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        url = "".concat(this.apiHost, "/content/").concat(this.projectSlug, "/").concat(pageSlug);
+                        return [4 /*yield*/, fetch(url, {
+                                method: 'GET',
+                                headers: __assign({ 'Content-Type': 'application/json' }, this.headers),
+                            })];
+                    case 1:
+                        response = _a.sent();
+                        if (!response.ok) {
+                            throw new Error("Failed to fetch content for page: ".concat(pageSlug, " (project: ").concat(this.projectSlug, ")"));
+                        }
+                        return [2 /*return*/, response.json()];
+                }
+            });
+        });
+    };
+    HttpContentFetcher.prototype.update = function (url, data) {
+        return __awaiter(this, void 0, void 0, function () {
+            var fullUrl, response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        fullUrl = url.startsWith('http') ? url : "".concat(this.apiHost).concat(url);
+                        return [4 /*yield*/, fetch(fullUrl, {
+                                method: 'PATCH',
+                                headers: __assign({ 'Content-Type': 'application/json' }, this.headers),
+                                body: JSON.stringify(data),
+                            })];
+                    case 1:
+                        response = _a.sent();
+                        if (!response.ok) {
+                            throw new Error("Failed to update node at url: ".concat(fullUrl));
+                        }
+                        return [2 /*return*/, response.json()];
+                }
+            });
+        });
+    };
+    return HttpContentFetcher;
+}());
+export { HttpContentFetcher };

package/dist/core/client.d.ts ADDED Viewed

@@ -0,0 +1,81 @@
+import { ContentNode, ContentImage, ContentVideo, ContentFile, ContentTable } from './types';
+export interface IContentClient {
+    node(path: string): ContentNode | null;
+    text(path: string): string | undefined;
+    list(path: string): ContentNode[];
+    image(path: string): ContentImage | undefined;
+    video(path: string): ContentVideo | undefined;
+    file(path: string): ContentFile | undefined;
+    table<T = Record<string, any>>(path: string): ContentTable<T> | undefined;
+    field<T>(path: string): T | undefined;
+}
+export declare class ContentClient implements IContentClient {
+    private root;
+    constructor(root: ContentNode);
+    /**
+     * Получить весь узел целиком по пути.
+     *
+     * @example
+     * content.node('header/logo')
+     * // возвращает { type: 'image', data: { url: '...' }, ... }
+     */
+    node(path: string): ContentNode | null;
+    /**
+     * Получить текст из поля data.content.
+     * Удобно для заголовков, описаний и простых текстовых блоков.
+     *
+     * @example
+     * // Если в 'header/title' лежит { data: { content: "Привет" } }
+     * content.text('header/title')
+     * // вернет "Привет"
+     */
+    text(path: string): string | undefined;
+    /**
+     * Получить список дочерних элементов.
+     * Используется для списков, галерей, меню.
+     *
+     * @example
+     * // Если 'blog' содержит посты 'post-1', 'post-2'
+     * content.list('blog')
+     * // вернет массив [ContentNode, ContentNode]
+     */
+    list(path: string): ContentNode[];
+    /**
+     * Получить данные узла как файл.
+     *
+     * @example
+     * content.file('downloads/report')
+     */
+    file(path: string): ContentFile | undefined;
+    /**
+     * Получить данные узла как изображение.
+     *
+     * @example
+     * content.image('gallery/photo1')
+     */
+    image(path: string): ContentImage | undefined;
+    /**
+     * Получить данные узла как видео.
+     *
+     * @example
+     * content.video('hero/bg-video')
+     */
+    video(path: string): ContentVideo | undefined;
+    /**
+     * Получить данные таблицы.
+     * Возвращает описание полей и массив строк с данными.
+     *
+     * @example
+     * const { fields, rows } = content.table('methods') || {};
+     */
+    table<T = Record<string, any>>(path: string): ContentTable<T> | undefined;
+    /**
+     * Получить конкретные данные узла с типизацией.
+     * Используется для картинок, сложных объектов и кастомных полей.
+     *
+     * @example
+     * content.field<{ url: string }>('header/logo')
+     * // вернет { url: '/img/logo.png' }
+     */
+    field<T>(path: string): T | undefined;
+}

package/dist/core/client.js ADDED Viewed

@@ -0,0 +1,123 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { resolveNode } from './utils';
+var ContentClient = /** @class */ (function () {
+    function ContentClient(root) {
+        this.root = root;
+    }
+    /**
+     * Получить весь узел целиком по пути.
+     *
+     * @example
+     * content.node('header/logo')
+     * // возвращает { type: 'image', data: { url: '...' }, ... }
+     */
+    ContentClient.prototype.node = function (path) {
+        return resolveNode(this.root, path);
+    };
+    /**
+     * Получить текст из поля data.content.
+     * Удобно для заголовков, описаний и простых текстовых блоков.
+     *
+     * @example
+     * // Если в 'header/title' лежит { data: { content: "Привет" } }
+     * content.text('header/title')
+     * // вернет "Привет"
+     */
+    ContentClient.prototype.text = function (path) {
+        var _a;
+        var node = this.node(path);
+        if (!node)
+            return undefined;
+        return (_a = node.data) === null || _a === void 0 ? void 0 : _a.content;
+    };
+    /**
+     * Получить список дочерних элементов.
+     * Используется для списков, галерей, меню.
+     *
+     * @example
+     * // Если 'blog' содержит посты 'post-1', 'post-2'
+     * content.list('blog')
+     * // вернет массив [ContentNode, ContentNode]
+     */
+    ContentClient.prototype.list = function (path) {
+        var node = this.node(path);
+        if (!node || !node.children)
+            return [];
+        return Object.values(node.children);
+    };
+    /**
+     * Получить данные узла как файл.
+     *
+     * @example
+     * content.file('downloads/report')
+     */
+    ContentClient.prototype.file = function (path) {
+        return this.field(path);
+    };
+    /**
+     * Получить данные узла как изображение.
+     *
+     * @example
+     * content.image('gallery/photo1')
+     */
+    ContentClient.prototype.image = function (path) {
+        return this.field(path);
+    };
+    /**
+     * Получить данные узла как видео.
+     *
+     * @example
+     * content.video('hero/bg-video')
+     */
+    ContentClient.prototype.video = function (path) {
+        return this.field(path);
+    };
+    /**
+     * Получить данные таблицы.
+     * Возвращает описание полей и массив строк с данными.
+     *
+     * @example
+     * const { fields, rows } = content.table('methods') || {};
+     */
+    ContentClient.prototype.table = function (path) {
+        var node = this.node(path);
+        if (!node)
+            return undefined;
+        // Сортируем строки по order_index
+        var rows = node.children
+            ? Object.values(node.children)
+                .sort(function (a, b) { var _a, _b; return ((_a = a.order_index) !== null && _a !== void 0 ? _a : 0) - ((_b = b.order_index) !== null && _b !== void 0 ? _b : 0); })
+                .map(function (child) { return (__assign(__assign({}, child.data), { _id: child.id, _slug: child.slug })); })
+            : [];
+        return {
+            fields: (node.data.fields || []),
+            rows: rows
+        };
+    };
+    /**
+     * Получить конкретные данные узла с типизацией.
+     * Используется для картинок, сложных объектов и кастомных полей.
+     *
+     * @example
+     * content.field<{ url: string }>('header/logo')
+     * // вернет { url: '/img/logo.png' }
+     */
+    ContentClient.prototype.field = function (path) {
+        var node = this.node(path);
+        if (!node)
+            return undefined;
+        return node.data;
+    };
+    return ContentClient;
+}());
+export { ContentClient };

package/dist/core/coreless.d.ts ADDED Viewed

@@ -0,0 +1,28 @@
+import { HttpContentFetcherConfig } from '../api/client';
+import { ContentClient, IContentClient } from './client';
+import { ContentNode, ContentFile, ContentImage, ContentVideo, ContentTable } from './types';
+export declare class Coreless implements IContentClient {
+    private fetcher;
+    private currentClient;
+    constructor(config: HttpContentFetcherConfig);
+    /**
+     * Загружает страницу и устанавливает ее как текущую для работы
+     */
+    load(pageSlug: string): Promise<void>;
+    /**
+     * Загружает страницу и возвращает готовый клиент для работы с ней.
+     */
+    getPage(pageSlug: string): Promise<ContentClient>;
+    /**
+     * Проверяет, загружен ли контент
+     */
+    private ensureLoaded;
+    node(path: string): ContentNode | null;
+    text(path: string): string | undefined;
+    list(path: string): ContentNode[];
+    image(path: string): ContentImage | undefined;
+    video(path: string): ContentVideo | undefined;
+    file(path: string): ContentFile | undefined;
+    table<T = Record<string, any>>(path: string): ContentTable<T> | undefined;
+    field<T>(path: string): T | undefined;
+}

package/dist/core/coreless.js ADDED Viewed

@@ -0,0 +1,120 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { HttpContentFetcher } from '../api/client';
+import { ContentClient } from './client';
+var Coreless = /** @class */ (function () {
+    function Coreless(config) {
+        this.currentClient = null;
+        this.fetcher = new HttpContentFetcher(config);
+    }
+    /**
+     * Загружает страницу и устанавливает ее как текущую для работы
+     */
+    Coreless.prototype.load = function (pageSlug) {
+        return __awaiter(this, void 0, void 0, function () {
+            var rootNode;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.fetcher.fetch(pageSlug)];
+                    case 1:
+                        rootNode = _a.sent();
+                        this.currentClient = new ContentClient(rootNode);
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Загружает страницу и возвращает готовый клиент для работы с ней.
+     */
+    Coreless.prototype.getPage = function (pageSlug) {
+        return __awaiter(this, void 0, void 0, function () {
+            var rootNode;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.fetcher.fetch(pageSlug)];
+                    case 1:
+                        rootNode = _a.sent();
+                        return [2 /*return*/, new ContentClient(rootNode)];
+                }
+            });
+        });
+    };
+    /**
+     * Проверяет, загружен ли контент
+     */
+    Coreless.prototype.ensureLoaded = function () {
+        if (!this.currentClient) {
+            throw new Error('Content not loaded. Call load(pageSlug) first or use getPage(pageSlug).');
+        }
+    };
+    // Делегируем методы ContentClient
+    Coreless.prototype.node = function (path) {
+        this.ensureLoaded();
+        return this.currentClient.node(path);
+    };
+    Coreless.prototype.text = function (path) {
+        this.ensureLoaded();
+        return this.currentClient.text(path);
+    };
+    Coreless.prototype.list = function (path) {
+        this.ensureLoaded();
+        return this.currentClient.list(path);
+    };
+    Coreless.prototype.image = function (path) {
+        this.ensureLoaded();
+        return this.currentClient.image(path);
+    };
+    Coreless.prototype.video = function (path) {
+        this.ensureLoaded();
+        return this.currentClient.video(path);
+    };
+    Coreless.prototype.file = function (path) {
+        this.ensureLoaded();
+        return this.currentClient.file(path);
+    };
+    Coreless.prototype.table = function (path) {
+        this.ensureLoaded();
+        return this.currentClient.table(path);
+    };
+    Coreless.prototype.field = function (path) {
+        this.ensureLoaded();
+        return this.currentClient.field(path);
+    };
+    return Coreless;
+}());
+export { Coreless };

package/dist/core/types.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+export type ContentNode = {
+    id: string;
+    slug: string;
+    type: string;
+    data: Record<string, any>;
+    url: string;
+    order_index?: number;
+    children?: Record<string, ContentNode>;
+};
+export interface TableField {
+    name: string;
+    slug: string;
+    default?: any;
+    required?: boolean;
+    field_type: string;
+    hide_in_table?: boolean;
+}
+export interface ContentTable<T = Record<string, any>> {
+    fields: TableField[];
+    rows: T[];
+}
+export interface ContentFile {
+    url: string;
+    size?: number;
+    filename?: string;
+    content_type?: string;
+    width?: number;
+    height?: number;
+    [key: string]: any;
+}
+export type ContentImage = ContentFile;
+export type ContentVideo = ContentFile;

package/dist/core/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/core/utils.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { ContentNode } from './types';
+/**
+ * Резолвит узел по строковому пути.
+ * @param root Корневой узел, от которого начинается поиск
+ * @param path Путь вида "blog/post-1"
+ * @returns Найденный узел или null
+ */
+export declare function resolveNode(root: ContentNode, path: string): ContentNode | null;

package/dist/core/utils.js ADDED Viewed

@@ -0,0 +1,20 @@
+/**
+ * Резолвит узел по строковому пути.
+ * @param root Корневой узел, от которого начинается поиск
+ * @param path Путь вида "blog/post-1"
+ * @returns Найденный узел или null
+ */
+export function resolveNode(root, path) {
+    if (!path || path === '')
+        return root;
+    var segments = path.split('/').filter(Boolean);
+    var current = root;
+    for (var _i = 0, segments_1 = segments; _i < segments_1.length; _i++) {
+        var segment = segments_1[_i];
+        if (!current.children || !current.children[segment]) {
+            return null;
+        }
+        current = current.children[segment];
+    }
+    return current;
+}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export * from './core/types';
+export * from './core/utils';
+export * from './core/client';
+export * from './core/coreless';
+export * from './api/client';
+export * from './react/context';
+export * from './react/hooks';

package/dist/index.js ADDED Viewed

@@ -0,0 +1,10 @@
+// Core
+export * from './core/types';
+export * from './core/utils';
+export * from './core/client';
+export * from './core/coreless';
+// API
+export * from './api/client';
+// React
+export * from './react/context';
+export * from './react/hooks';

package/dist/react/context.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import React from 'react';
+import { ContentFetcher } from '../api/client';
+interface CorelessContextValue {
+    fetcher: ContentFetcher;
+}
+export declare const useCorelessContext: () => CorelessContextValue;
+interface CorelessProviderProps {
+    children: React.ReactNode;
+    fetcher: ContentFetcher;
+}
+export declare const CorelessProvider: React.FC<CorelessProviderProps>;
+export {};

package/dist/react/context.js ADDED Viewed

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+var CorelessContext = createContext(null);
+export var useCorelessContext = function () {
+    var context = useContext(CorelessContext);
+    if (!context) {
+        throw new Error('useCorelessContext must be used within a CorelessProvider');
+    }
+    return context;
+};
+export var CorelessProvider = function (_a) {
+    var children = _a.children, fetcher = _a.fetcher;
+    return (_jsx(CorelessContext.Provider, { value: { fetcher: fetcher }, children: children }));
+};

package/dist/react/hooks.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import { IContentClient } from '../core/client';
+export interface UseContentResult extends IContentClient {
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+/**
+ * Хук для получения контента страницы.
+ * Возвращает интерфейс ContentClient, который безопасен для использования даже во время загрузки
+ * (методы будут возвращать undefined/пустые массивы).
+ */
+export declare function useContent(slug: string): UseContentResult;

package/dist/react/hooks.js ADDED Viewed

@@ -0,0 +1,104 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { useEffect, useState, useMemo } from 'react';
+import { useCorelessContext } from './context';
+import { ContentClient } from '../core/client';
+/**
+ * Хук для получения контента страницы.
+ * Возвращает интерфейс ContentClient, который безопасен для использования даже во время загрузки
+ * (методы будут возвращать undefined/пустые массивы).
+ */
+export function useContent(slug) {
+    var _this = this;
+    var fetcher = useCorelessContext().fetcher;
+    var _a = useState(null), data = _a[0], setData = _a[1];
+    var _b = useState(true), loading = _b[0], setLoading = _b[1];
+    var _c = useState(null), error = _c[0], setError = _c[1];
+    var load = function () { return __awaiter(_this, void 0, void 0, function () {
+        var result, err_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    setLoading(true);
+                    setError(null);
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, 4, 5]);
+                    return [4 /*yield*/, fetcher.fetch(slug)];
+                case 2:
+                    result = _a.sent();
+                    setData(result);
+                    return [3 /*break*/, 5];
+                case 3:
+                    err_1 = _a.sent();
+                    setError(err_1 instanceof Error ? err_1 : new Error('Unknown error'));
+                    return [3 /*break*/, 5];
+                case 4:
+                    setLoading(false);
+                    return [7 /*endfinally*/];
+                case 5: return [2 /*return*/];
+            }
+        });
+    }); };
+    useEffect(function () {
+        load();
+    }, [slug, fetcher]);
+    var client = useMemo(function () {
+        var rootNode = data || {
+            id: '',
+            slug: '',
+            type: 'empty',
+            url: '',
+            data: {},
+            children: {}
+        };
+        return new ContentClient(rootNode);
+    }, [data]);
+    return {
+        loading: loading,
+        error: error,
+        refresh: load,
+        node: function (path) { return client.node(path); },
+        text: function (path) { return client.text(path); },
+        list: function (path) { return client.list(path); },
+        image: function (path) { return client.image(path); },
+        video: function (path) { return client.video(path); },
+        file: function (path) { return client.file(path); },
+        table: function (path) { return client.table(path); },
+        field: function (path) { return client.field(path); },
+    };
+}

package/package.json ADDED Viewed

@@ -0,0 +1,43 @@
+{
+  "name": "coreless-lib",
+  "version": "0.0.1",
+  "description": "Headless CMS Framework Agnostic Library",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}