@evopos/vite-plugin 0.0.0-stage → 0.1.0

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.
@@ -0,0 +1,140 @@
1
+ import { Plugin } from 'vite';
2
+ import { DevSessionResponse } from '@evopos/cli';
3
+
4
+ /** Что плагину нужно от клиента консоли разработчика (тесты подставляют свой). */
5
+ interface SessionClient {
6
+ putDevSession(manifest: unknown, url: string): Promise<DevSessionResponse>;
7
+ deleteDevSession(pluginId?: string): Promise<unknown>;
8
+ }
9
+ interface SessionLogger {
10
+ info(message: string): void;
11
+ warn(message: string): void;
12
+ error(message: string): void;
13
+ }
14
+ interface ClientFactoryInput {
15
+ base: string;
16
+ token: string;
17
+ tokenSource: 'env' | 'file';
18
+ }
19
+ interface ResolveClientOptions {
20
+ /** Адрес API (как `--api`); иначе `EVOPOS_API_BASE`, иначе прод. */
21
+ api?: string | undefined;
22
+ env?: Record<string, string | undefined> | undefined;
23
+ now?: (() => number) | undefined;
24
+ createClient?: ((input: ClientFactoryInput) => SessionClient) | undefined;
25
+ logger: SessionLogger;
26
+ }
27
+ /** Клиент консоли с токеном из `evopos login` / `EVOPOS_TOKEN`; нет токена — подсказка и `null` (режим выключен). */
28
+ declare function resolveSessionClient(options: ResolveClientOptions): SessionClient | null;
29
+ /**
30
+ * Жизненный цикл режима разработки: `start` → PUT, пульс продлевает срок, `update` повторяет PUT при правке манифеста,
31
+ * `stop` снимает сессию (DELETE). Запросы идут по очереди, чтобы DELETE не обогнал PUT.
32
+ */
33
+ declare class DevSessionController {
34
+ private readonly client;
35
+ private readonly logger;
36
+ private manifest;
37
+ private manifestKey;
38
+ private url;
39
+ private timer;
40
+ private queue;
41
+ private active;
42
+ private announced;
43
+ /** Сервер отказал насовсем (нет прав, токен отозван): пульс бессмысленен. */
44
+ private halted;
45
+ constructor(client: SessionClient, logger: SessionLogger);
46
+ get running(): boolean;
47
+ private enqueue;
48
+ /** Зарегистрировать сессию и запустить пульс. */
49
+ start(manifest: {
50
+ id?: unknown;
51
+ }, url: string): Promise<void>;
52
+ /** Манифест исправлен: повторить PUT, если он изменился. */
53
+ update(manifest: {
54
+ id?: unknown;
55
+ }): Promise<void>;
56
+ private schedule;
57
+ private push;
58
+ /** Снять сессию и остановить пульс. Повторный вызов ничего не делает. */
59
+ stop(): Promise<void>;
60
+ }
61
+
62
+ /**
63
+ * Страницы плагина: все `*.html` в корне проекта и `pagesDir/**\/*.html`. Пути относительные, с `/`,
64
+ * отсортированы: так их видят `manifest.json` (`slots[].entry`) и сборка.
65
+ */
66
+ declare function findEntries(root: string, pagesDir?: string): string[];
67
+
68
+ /** Слот манифеста плагина в том виде, который нужен поддельной кассе. */
69
+ interface ManifestSlot {
70
+ slot: string;
71
+ entry: string;
72
+ title?: string;
73
+ }
74
+ /** Проверенный манифест: полей больше, но плагину и поддельной кассе нужны эти. */
75
+ interface ParsedManifest {
76
+ id: string;
77
+ version: string;
78
+ kind?: string;
79
+ name?: Record<string, string>;
80
+ slots?: ManifestSlot[];
81
+ scopes?: string[];
82
+ host_calls?: string[];
83
+ [key: string]: unknown;
84
+ }
85
+ type ManifestState = {
86
+ ok: true;
87
+ manifest: ParsedManifest;
88
+ raw: string;
89
+ } | {
90
+ ok: false;
91
+ errors: string[];
92
+ raw: string | null;
93
+ };
94
+ interface CheckOptions {
95
+ /** Абсолютный путь к манифесту. */
96
+ file: string;
97
+ /** Имя файла для сообщений. */
98
+ label: string;
99
+ /** Страницы проекта (входы сборки), относительные пути с `/`. */
100
+ entries: readonly string[];
101
+ /** Файл драйвера есть в `public/`? (относительный путь) */
102
+ fileExists?: (relative: string) => boolean;
103
+ }
104
+ /** Прочитать и проверить манифест: схема (`validatePluginManifest`/`validateDriverManifest`) и страницы слотов. */
105
+ declare function checkManifest(options: CheckOptions): ManifestState;
106
+ declare function formatErrors(errors: readonly string[]): string;
107
+
108
+ /**
109
+ * CORS dev-сервера для страниц плагина. Iframe кассы идёт с `sandbox="allow-scripts"` (без `allow-same-origin`), поэтому
110
+ * его origin — непрозрачный: браузер шлёт `Origin: null`, и модули `<script type="module">` вместе с websocket HMR
111
+ * Vite без `Access-Control-Allow-Origin: null` не загрузятся. Разрешаем ровно `null` и свою машину
112
+ * (`localhost`, `127.0.0.1`, `[::1]`, `*.localhost`), а не `origin: true`: тот отдавал бы исходники любому сайту,
113
+ * который откроет разработчик в соседней вкладке.
114
+ */
115
+ declare const DEV_CORS_ORIGINS: readonly (string | RegExp)[];
116
+
117
+ interface EvoposViteOptions {
118
+ /** Путь к манифесту относительно корня проекта. По умолчанию `manifest.json`. */
119
+ manifest?: string;
120
+ /** Папка со страницами слотов: все `*.html` в ней (и глубже) становятся входами сборки. По умолчанию `pages`. */
121
+ pagesDir?: string;
122
+ /** Регистрировать dev-сервер в песочнице разработчика (нужен `evopos login` или `EVOPOS_TOKEN`). По умолчанию `true`. */
123
+ devSession?: boolean;
124
+ /** Адрес, который касса песочницы откроет в iframe. Иначе `EVOPOS_DEV_URL`, иначе `http(s)://localhost:<порт>/`. */
125
+ devUrl?: string;
126
+ /** Страница поддельной кассы `/__evopos/`. По умолчанию `true`. */
127
+ fakeKassa?: boolean;
128
+ /** Адрес API разработчика (как `--api` у CLI); иначе `EVOPOS_API_BASE`, иначе прод. */
129
+ api?: string;
130
+ /** Для тестов: свой клиент консоли разработчика вместо настоящего. */
131
+ createClient?: (input: ClientFactoryInput) => SessionClient;
132
+ /** Для тестов: часы (мс), по ним проверяется срок токена. */
133
+ now?: () => number;
134
+ /** Для тестов: переменные окружения вместо `process.env`. */
135
+ env?: Record<string, string | undefined>;
136
+ }
137
+ /** Страницы плагина EvoPOS: сборка, проверка манифеста, поддельная касса и режим разработки в песочнице. */
138
+ declare function evopos(options?: EvoposViteOptions): Plugin[];
139
+
140
+ export { DEV_CORS_ORIGINS, DevSessionController, type EvoposViteOptions, type ManifestState, type ParsedManifest, type SessionClient, type SessionLogger, checkManifest, evopos as default, evopos, findEntries, formatErrors, resolveSessionClient };