@andrey4emk/npm-app-front-b24 0.3.0 → 0.4.0

package/package.json

@@ -1,27 +1,43 @@
 {
     "name": "@andrey4emk/npm-app-front-b24",
-    "version": "0.3.0",
+    "version": "0.4.0",
     "description": "Vue 3 компоненты для Bitrix24: Subscriptions, ConfigLogs",
-    "types": "./index.d.ts",
     "files": [
         "Subscriptions.vue",
         "ConfigLogs.vue",
-        "index.d.ts",
+        "types",
         "README.md",
         "LICENSE"
     ],
     "exports": {
-        ".": {
-            "types": "./index.d.ts"
+        "./Subscriptions.vue": {
+            "types": "./types/Subscriptions.vue.d.ts",
+            "default": "./Subscriptions.vue"
         },
-        "./Subscriptions.vue": "./Subscriptions.vue",
-        "./ConfigLogs.vue": "./ConfigLogs.vue"
+        "./ConfigLogs.vue": {
+            "types": "./types/ConfigLogs.vue.d.ts",
+            "default": "./ConfigLogs.vue"
+        },
+        "./package.json": "./package.json"
     },
     "scripts": {
-        "lint": "echo \"no lint\""
+        "lint": "echo \"no lint\"",
+        "test": "vitest run",
+        "build:types": "rm -rf types && vue-tsc --declaration --emitDeclarationOnly -p tsconfig.json",
+        "prepublishOnly": "npm run build:types"
     },
     "peerDependencies": {
-        "vue": "^3.0.0"
+        "vue": "^3.5.2"
+    },
+    "devDependencies": {
+        "@vitejs/plugin-vue": "6.0.8",
+        "@vue/test-utils": "2.5.0",
+        "jsdom": "29.1.1",
+        "typescript": "5.9.3",
+        "vite": "8.2.2",
+        "vitest": "5.0.0",
+        "vue": "3.5.42",
+        "vue-tsc": "3.3.11"
     },
     "keywords": [
         "vue",

package/types/ConfigLogs.vue.d.ts

@@ -0,0 +1,33 @@
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    apiBase: {
+        type: StringConstructor;
+        default: string;
+    };
+    secretKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    configName: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    apiBase: {
+        type: StringConstructor;
+        default: string;
+    };
+    secretKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    configName: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    apiBase: string;
+    secretKey: string;
+    configName: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/types/Subscriptions.vue.d.ts

@@ -0,0 +1,167 @@
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    b24: {
+        type: import("vue").PropType<object | null>;
+        required: false;
+    };
+    authConnector: {
+        type: StringConstructor;
+        default: string;
+    };
+    portalDomain: {
+        type: StringConstructor;
+        default: string;
+    };
+    timeZone: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {}, {
+    tabs: {
+        tab1: boolean;
+        tab2: boolean;
+    };
+    events: any[];
+    subscribedEvents: any[];
+    entities: {
+        list: any[];
+        total: number;
+    };
+    autoRefresh: boolean;
+    loading: boolean;
+    busy: boolean;
+    error: string;
+    message: string;
+    refreshTimerId: any;
+    isUnmounted: boolean;
+    loadFailed: boolean;
+    confirmAction: string;
+    confirmTimerId: any;
+}, {
+    b24Client(): any;
+    portalOrigin(): string;
+    confirmAllLabel(): "Точно удалить?" | "Удалить все";
+    confirmEmptyLabel(): "Точно удалить?" | "Удалить все пустые";
+    dateFormatter(): any;
+}, {
+    selectTab(name: any): void;
+    formatDate(timestamp: any): string;
+    pause(ms: any): Promise<any>;
+    clearFeedback(): void;
+    showError(text: any): void;
+    showMessage(text: any): void;
+    /**
+     * Клиент Bitrix24 или null. При отсутствии клиента сам показывает ошибку —
+     * вызывающему остаётся только выйти
+     */
+    ensureClient(): any;
+    errorText(err: any): string;
+    resultErrors(result: any): any;
+    resultErrorsByKey(result: any): {};
+    requestConfirm(action: any): boolean;
+    resetConfirm(): void;
+    /**
+     * Определяет ENTITY_TYPE_ID смарт-процесса: сначала из FIELDS, затем из имени события.
+     * Общий разбор для ссылки и для обновления — иначе событие без ENTITY_TYPE_ID в FIELDS
+     * уходит в ветку сделки. Возвращает "" когда тип определить не удалось.
+     */
+    resolveEntityTypeId(entity: any): string;
+    entityLink(entity: any): string;
+    eventsList(): Promise<void>;
+    subscribeToEvents(event: any): Promise<void>;
+    getSubscribedEvents(): Promise<void>;
+    unbindSubscribedEvents(event: any): Promise<void>;
+    loadOfflineEntitiesList(): Promise<void>;
+    /**
+     * Снимает одну запись из оффлайн-очереди. Возвращает признак успеха.
+     */
+    deleteOfflineEntities(entity: any): Promise<boolean>;
+    /**
+     * Читает страницу очереди. Возвращает { rows, error }: непустой error означает,
+     * что проход надо оборвать
+     */
+    readOfflineQueuePage(b24: any): Promise<{
+        rows: any[];
+        error: any;
+    } | {
+        rows: any;
+        error: string;
+    }>;
+    /**
+     * Уникальные PROCESS_ID страницы и те из них, что ещё не сняты.
+     * Чистая функция от аргументов, поэтому её удобно звать и из отчёта
+     */
+    collectProcessIds(rows: any, clearedProcessIds: any): {
+        processIds: any[];
+        freshProcessIds: any[];
+    };
+    /**
+     * Команды batch для одной пачки PROCESS_ID
+     */
+    buildClearCommands(chunk: any): {};
+    /**
+     * Отправляет один batch и пополняет множество снятых пачек.
+     * Возвращает текст неудачи или "" — пачка снята целиком
+     */
+    sendClearChunk(b24: any, chunk: any, clearedProcessIds: any): Promise<string>;
+    /**
+     * Итоговый отчёт прохода. Возвращает { kind: "error" | "message", text }
+     */
+    buildClearReport({ failures, reachedLimit, stoppedOnRepeat, stoppedOnEmpty, clearedCount }: {
+        failures: any;
+        reachedLimit: any;
+        stoppedOnRepeat: any;
+        stoppedOnEmpty: any;
+        clearedCount: any;
+    }): {
+        kind: string;
+        text: string;
+    };
+    deleteOfflineEntitiesAll(): Promise<void>;
+    deleteOfflineEntitiesAllEmpty(): Promise<void>;
+    isSubscribed(event: any): boolean;
+    startAutoRefresh(): void;
+    stopAutoRefresh(): void;
+    autoRefreshEntities(): void;
+    handleVisibilityChange(): Promise<void>;
+    /**
+     * Перезаписывает смарт-процесс его же заголовком.
+     * true — обновлено, false — отказ (текст ошибки уже показан)
+     */
+    updateSmartProcessEntity(b24: any, entityTypeId: any, entityId: any): Promise<boolean>;
+    /**
+     * Перезаписывает сделку её же заголовком.
+     * true — обновлено, false — отказ (текст ошибки уже показан)
+     */
+    updateDealEntity(b24: any, entityId: any): Promise<boolean>;
+    /**
+     * Снимает обновлённую сущность из очереди и печатает итог операции целиком
+     */
+    finishEntityUpdate(eventEntity: any, entityId: any, failed: any): Promise<void>;
+    /**
+     * Перезаписывает сущность теми же данными и снимает её из оффлайн-очереди.
+     */
+    entityUpdate(eventEntity: any): Promise<void>;
+}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    b24: {
+        type: import("vue").PropType<object | null>;
+        required: false;
+    };
+    authConnector: {
+        type: StringConstructor;
+        default: string;
+    };
+    portalDomain: {
+        type: StringConstructor;
+        default: string;
+    };
+    timeZone: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    authConnector: string;
+    portalDomain: string;
+    timeZone: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/index.d.ts

@@ -1,39 +0,0 @@
-// Типы для потребителей: объявляют props компонентов, которые пакет отдаёт
-// исходными .vue файлами. Подключение на стороне потребителя — либо
-// /// <reference types="@andrey4emk/npm-app-front-b24" /> в его env.d.ts,
-// либо "@andrey4emk/npm-app-front-b24" в compilerOptions.types
-//
-// ВНИМАНИЕ: карта exports не пускает vue-tsc к виртуальному объявлению,
-// поэтому типы берутся только отсюда. При любом изменении props в компонентах
-// этот файл надо править синхронно. Иначе потребитель получит типы,
-// расходящиеся с реальностью, и компилятор об этом не предупредит
-
-declare module "@andrey4emk/npm-app-front-b24/ConfigLogs.vue" {
-    import type { DefineComponent } from "vue";
-
-    const ConfigLogs: DefineComponent<{
-        /** Базовый URL сервера, без хвостового слэша */
-        apiBase?: string;
-        /** Ключ авторизации, уходит в заголовке secret */
-        secretKey?: string;
-        /** Имя конфига без расширения .json */
-        configName?: string;
-    }>;
-
-    export default ConfigLogs;
-}
-
-declare module "@andrey4emk/npm-app-front-b24/Subscriptions.vue" {
-    import type { DefineComponent } from "vue";
-
-    const Subscriptions: DefineComponent<{
-        /** Клиент Bitrix24 REST API, fallback — inject и window.$b24 */
-        b24?: object | null;
-        /** Идентификатор коннектора авторизации */
-        authConnector?: string;
-        /** Домен портала для ссылок на сущности */
-        portalDomain?: string;
-    }>;
-
-    export default Subscriptions;
-}