@weavix/tracker-core 0.0.1

package/README.md

@@ -0,0 +1,3 @@
+# @weavix/tracker-core
+
+Общие TypeScript-типы для контекстов слотов плагина Tracker.

package/dist/index.d.ts

@@ -0,0 +1,856 @@
+import { BaseMessage } from '@weavix/sdk-core';
+import { ContentSizeUpdateRequest } from '@weavix/sdk-core';
+import { ContextLevel } from '@weavix/sdk-core';
+import { HostInitOptions } from '@weavix/sdk-core';
+import { NavigateRequest } from '@weavix/sdk-core';
+import { Theme } from '@weavix/sdk-core';
+import { UiContract } from '@weavix/sdk-core';
+
+export declare type ApiCallPayload = {
+    version: string;
+    method: string;
+    url: string;
+    pathParams: Record<string, string>;
+    queryParams: Record<string, unknown>;
+    bodyParams: Record<string, unknown>;
+    file?: File;
+};
+
+export declare type ApiCallResult = {
+    data: unknown;
+    headers: Record<string, string>;
+};
+
+export declare type ApiContract = {
+    'api.tracker.call': {
+        payload: ApiCallPayload;
+        result: ApiCallResult;
+    };
+};
+
+export declare type Attachment = {
+    /** Format: uri */
+    self: string;
+    id: string;
+    name: string;
+    /** Format: uri */
+    content: string;
+    /** Format: uri */
+    thumbnail?: string | null;
+    createdBy: UserReferenceV2;
+    createdAt: DateTime;
+    mimetype: string;
+    /** Format: int64 */
+    size: number;
+    metadata: {
+        [key: string]: string;
+    };
+    commentId?: ObjectId;
+    /** @enum {string|null} */
+    status?: 'UPLOADING' | 'CHECK' | 'READY' | 'INFECTED' | 'ERROR' | null;
+    checkMessage?: LocalizedString;
+    downloadable?: boolean | null;
+};
+
+export declare type AttachmentViewerActionClosePayload = {
+    attachments: Attachment[];
+};
+
+export declare type AttachmentViewerActionSlotContext = {
+    attachmentBlob: Blob;
+    meta: {
+        id: string;
+        url: string;
+        date: string;
+        size: number;
+        mimetype: string;
+    };
+};
+
+export declare type BasicWebhookAuthContext = Omit<WebhookAuthContext, 'type'> & {
+    login?: string;
+    password?: string | null;
+    type?: string;
+} & {
+    type: 'basic';
+} & {
+    type: 'basic';
+};
+
+export declare type BoardTabSlotContext = {
+    id: number;
+    name: string;
+    boardType: string;
+    backlogAvailable: boolean;
+    sprintsAvailable: boolean;
+    projectId?: number;
+    activeSprint?: {
+        id: number;
+        name: string;
+        startDate: string;
+        endDate: string;
+        status: string;
+    };
+};
+
+export declare type ClosePluginPayload<TSlot extends keyof SlotContextMap> = PluginClosePayloadMap[TSlot];
+
+export declare type DateTime = string;
+
+export declare type Direction = 'INWARD' | 'OUTWARD';
+
+export declare type EntityLink = {
+    id: Record<string, unknown>;
+    /** Format: uri */
+    self: string;
+};
+
+/**
+ * Маппинг trigger-слотов на тип возвращаемого значения getData.
+ */
+export declare type GetDataResultMap = {
+    'trigger.create.action': TriggerActionData;
+    'trigger.edit.action': TriggerActionData;
+};
+
+/**
+ * Возвращает обработчик getData. При указании TSlot — () => GetDataResultMap[TSlot].
+ */
+export declare function getHandler<TSlot extends keyof GetDataResultMap>(name: 'getData'): (() => GetDataResultMap[TSlot]) | undefined;
+
+export declare function getHandler<TKey extends keyof Handlers>(name: TKey): HandlerFunction<TKey> | undefined;
+
+/**
+ * Получить локализованную строку на основе языка.
+ * Принимает `LocalizedString` из @weavix/tracker-core.
+ */
+export declare function getLocalizedString(value: LocalizedString, language: string | undefined, fallbackLanguage?: string): string;
+
+export declare type GoalSlotContext = MetaEntityV2 & {
+    progress: {
+        closed: number;
+        total: number;
+    };
+};
+
+export declare type HandlerFunction<TKey extends keyof Handlers> = Handlers[TKey];
+
+/**
+ * Обработчики, которые плагин регистрирует для ответов на запросы хоста.
+ * - getData — общий метод получения данных; тип зависит от слота (GetDataResultMap).
+ */
+export declare type Handlers = {
+    getData: () => GetDataResultMap[keyof GetDataResultMap];
+};
+
+/**
+ * Типизированный интерфейс HostApi для публичного API публикуемого core'а.
+ */
+export declare interface HostApi<TSlot extends keyof SlotContextMap = keyof SlotContextMap> {
+    /**
+     * Текущая тема хоста
+     */
+    getTheme(): Promise<Theme>;
+    /**
+     * Текущий язык хоста
+     */
+    getLanguage(): Promise<string>;
+    /**
+     * Id пользователя
+     */
+    getUserId(): Promise<string>;
+    /**
+     * Сборка для ятима
+     */
+    getIsYateam(): Promise<boolean>;
+    /**
+     * Получить текущий контекст, в котором запущен плагин.
+     * Тип возвращаемого значения зависит от слота.
+     */
+    getContext(): Promise<SlotContextMap[TSlot]>;
+    /**
+     * Изменить размер окна, в котором запущен плагин
+     */
+    updateContentSize(payload: ContentSizeUpdateRequest): Promise<void>;
+    /**
+     * Сообщить, что плагин готов к работе
+     */
+    notifyReady(): Promise<void>;
+    /**
+     * Сообщить, что плагин закрыт
+     */
+    close(payload: PluginClosePayloadMap[TSlot]): Promise<void>;
+    /**
+     * Инициализация плагина
+     */
+    init(options: HostInitOptions): void;
+    /**
+     * Текущий слот, в котором открыт плагин.
+     * Вызов до init() приведёт к ошибке.
+     */
+    getSlot(): TSlot;
+    /**
+     * Сервис, в котором открылся плагин.
+     * Вызов до init() приведёт к ошибке.
+     */
+    getService(): string;
+    /**
+     * Origin родительского окна (хоста).
+     * Вызов до init() приведёт к ошибке.
+     */
+    getOrigin(): string;
+    /**
+     * Внутренний урл плагина.
+     * Вызов до init() приведёт к ошибке.
+     */
+    getInnerUrl(): string;
+    /**
+     * Query-параметры плагина.
+     * Вызов до init() приведёт к ошибке.
+     */
+    getQueryParams(): Record<string, string>;
+    /**
+     * Идентификатор сущности, переданный хостом в параметрах iframe.
+     * Доступен сразу после init() без postMessage-запроса.
+     */
+    getEntityId(): string | null;
+    /**
+     * Метаданные сущности, переданные хостом в параметрах iframe.
+     * Доступны сразу после init() без postMessage-запроса.
+     */
+    getEntityMeta(): Record<string, string> | undefined;
+    /**
+     * Уровень контекста, объявленный в манифесте плагина.
+     * 'basic' — только entityId, 'full' — полный контекст слота.
+     */
+    getContextLevel(): ContextLevel;
+    /**
+     * Выключить автоматическое изменение размера контейнера
+     */
+    disableAutoResize(): void;
+}
+
+export declare const hostApi: HostApi;
+
+export declare type HostContract<TSlot extends keyof SlotContextMap = keyof SlotContextMap> = {
+    'theme.get': {
+        payload: never;
+        result: Theme;
+    };
+    'language.get': {
+        payload: never;
+        result: string;
+    };
+    'userId.get': {
+        payload: never;
+        result: string;
+    };
+    'isYateam.get': {
+        payload: never;
+        result: boolean;
+    };
+    'contentSize.update': {
+        payload: ContentSizeUpdateRequest;
+        result: void;
+    };
+    'context.get': {
+        payload: never;
+        result: SlotContextMap[TSlot];
+    };
+    'plugin.ready': {
+        payload: never;
+        result: void;
+    };
+    'plugin.close': {
+        payload: PluginClosePayloadMap[TSlot];
+        result: void;
+    };
+    navigate: {
+        payload: NavigateRequest;
+        result: void;
+    };
+};
+
+export declare type HttpMethod = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'LINK' | 'UNLINK';
+
+export declare type Issue = {
+    expand: string;
+    embed: string;
+    /** Format: uri */
+    self: string;
+    id: string;
+    key: string;
+    /** Format: int64 */
+    version: number;
+    values: {
+        [key: string]: Record<string, unknown>;
+    };
+    attachments?: EntityLink[];
+    comments?: EntityLink[];
+    links?: {
+        /** Format: uri */
+        self: string;
+        id: string;
+        type: IssueLinkType;
+        direction: Direction;
+        object: Reference;
+        display: LocalizedString;
+    }[];
+    localLinkRefs?: {
+        /** Format: uri */
+        self: string;
+        id: string;
+        relationship: Relationship;
+        issueId: ObjectId;
+    }[];
+    remotelinks?: Reference[];
+    transitions?: EntityLink[];
+    permissions?: {
+        /** Format: uri */
+        self: string;
+        /** Format: int64 */
+        version?: number | null;
+        create?: {
+            /** Format: uri */
+            self: string;
+            users?: {
+                /** Format: uri */
+                self: string;
+                id: string;
+                /** Format: int64 */
+                version?: number | null;
+                key?: string | null;
+                display: LocalizedString;
+                department?: Reference;
+                cloudUid?: string | null;
+                /** Format: int64 */
+                passportUid?: number | null;
+            }[];
+            groups?: Reference[];
+            roles?: Reference[];
+        } | null;
+        read?: {
+            /** Format: uri */
+            self: string;
+            users?: {
+                /** Format: uri */
+                self: string;
+                id: string;
+                /** Format: int64 */
+                version?: number | null;
+                key?: string | null;
+                display: LocalizedString;
+                department?: Reference;
+                cloudUid?: string | null;
+                /** Format: int64 */
+                passportUid?: number | null;
+            }[];
+            groups?: Reference[];
+            roles?: Reference[];
+        } | null;
+        writeNoAssign?: {
+            /** Format: uri */
+            self: string;
+            users?: {
+                /** Format: uri */
+                self: string;
+                id: string;
+                /** Format: int64 */
+                version?: number | null;
+                key?: string | null;
+                display: LocalizedString;
+                department?: Reference;
+                cloudUid?: string | null;
+                /** Format: int64 */
+                passportUid?: number | null;
+            }[];
+            groups?: Reference[];
+            roles?: Reference[];
+        } | null;
+        write?: {
+            /** Format: uri */
+            self: string;
+            users?: {
+                /** Format: uri */
+                self: string;
+                id: string;
+                /** Format: int64 */
+                version?: number | null;
+                key?: string | null;
+                display: LocalizedString;
+                department?: Reference;
+                cloudUid?: string | null;
+                /** Format: int64 */
+                passportUid?: number | null;
+            }[];
+            groups?: Reference[];
+            roles?: Reference[];
+        } | null;
+        grant?: {
+            /** Format: uri */
+            self: string;
+            users?: {
+                /** Format: uri */
+                self: string;
+                id: string;
+                /** Format: int64 */
+                version?: number | null;
+                key?: string | null;
+                display: LocalizedString;
+                department?: Reference;
+                cloudUid?: string | null;
+                /** Format: int64 */
+                passportUid?: number | null;
+            }[];
+            groups?: Reference[];
+            roles?: Reference[];
+        } | null;
+        deny?: {
+            /** Format: uri */
+            self: string;
+            users?: {
+                /** Format: uri */
+                self: string;
+                id: string;
+                /** Format: int64 */
+                version?: number | null;
+                key?: string | null;
+                display: LocalizedString;
+                department?: Reference;
+                cloudUid?: string | null;
+                /** Format: int64 */
+                passportUid?: number | null;
+            }[];
+            groups?: Reference[];
+            roles?: Reference[];
+        } | null;
+    } | null;
+    participantPercents?: {
+        user: UserReferenceV2;
+        /** Format: double */
+        value: number;
+        /** Format: double */
+        participationSum: number;
+    }[];
+    favorite: boolean;
+    parentIssueLinkChain?: {
+        id: IssueLinkChainId;
+        chain?: {
+            issue: IssueIndexReference;
+            /** Format: int32 */
+            height: number;
+        }[];
+    } | null;
+    updateLimits?: {
+        /** Format: int32 */
+        eventsCount: number;
+        /** Format: int32 */
+        linksCount: number;
+        /** Format: int32 */
+        externalEventsCount: number;
+        /** Format: int32 */
+        userEventsLimit?: number | null;
+        /** Format: int32 */
+        robotEventsLimit?: number | null;
+        /** Format: int32 */
+        linksLimit?: number | null;
+        /** Format: int32 */
+        externalEventsLimit?: number | null;
+    } | null;
+};
+
+export declare type IssueCommentActionSlotContext = {
+    id: string;
+    createdAt: string;
+    updatedAt: string | null;
+    text: string;
+    type: string;
+    transport: string;
+    attachments: Attachment[];
+    issueVersion: number;
+};
+
+export declare type IssueIndexReference = {
+    id: ObjectId;
+    key: string;
+    summary: string;
+};
+
+export declare type IssueLinkChainId = {
+    issueId: ObjectId;
+    linkField: string | {
+        id?: string;
+    };
+};
+
+export declare type IssueLinkType = {
+    /** Format: uri */
+    self: string;
+    id: string;
+    inward: LocalizedString;
+    outward: LocalizedString;
+};
+
+export declare type LocalizedString = string | {
+    ru?: string;
+    en?: string;
+};
+
+export declare type Message<TSlot extends keyof SlotContextMap = keyof SlotContextMap, M extends keyof TrackerContract<TSlot> = keyof TrackerContract<TSlot>> = BaseMessage & ({
+    type: 'request';
+    result: ResponseDataRequest;
+    error?: string;
+} | {
+    type: 'response';
+    result: TrackerContract<TSlot>[M]['result'] | null;
+    error?: string;
+    errorCode?: number;
+    errorData?: unknown;
+});
+
+export declare type MetaEntityV2 = {
+    /** Format: uri */
+    self: string;
+    id: string;
+    /** Format: int64 */
+    version: number;
+    /** Format: int64 */
+    shortId?: number | null;
+    /** @enum {string} */
+    entityType: 'PROJECT_PORTFOLIO' | 'PROJECT' | 'REPORT' | 'GOAL';
+    createdBy: Reference;
+    createdAt: DateTime;
+    updatedAt: DateTime;
+    fields: {
+        [key: string]: Record<string, unknown>;
+    };
+    attachments?: {
+        /** Format: uri */
+        self: string;
+        id: string;
+        name: string;
+        /** Format: uri */
+        content: string;
+        /** Format: uri */
+        thumbnail?: string | null;
+        createdBy: UserReferenceV2;
+        createdAt: DateTime;
+        mimetype: string;
+        /** Format: int64 */
+        size: number;
+        metadata: {
+            [key: string]: string;
+        };
+        commentId: ObjectId;
+        /** @enum {string|null} */
+        status?: 'UPLOADING' | 'CHECK' | 'READY' | 'INFECTED' | 'ERROR' | null;
+        checkMessage: LocalizedString;
+        downloadable?: boolean | null;
+    }[];
+};
+
+export declare type NoAuthWebhookAuthContext = Omit<WebhookAuthContext, 'type'> & {
+    type?: string;
+} & {
+    type: 'noauth';
+} & {
+    type: 'noauth';
+};
+
+export declare type OAuth2WebhookAuthContext = Omit<WebhookAuthContext, 'type'> & {
+    accessToken?: string | null;
+    headerName?: string;
+    tokenType?: string;
+    refreshToken?: string | null;
+    type?: string;
+} & {
+    type: 'oauth';
+} & {
+    type: 'oauth';
+};
+
+export declare type ObjectId = string;
+
+declare function orgSharedGet(bucket?: string): Promise<StorageRecord | null>;
+
+declare function orgSharedPatch({ bucket, data, version }: PatchOptions): Promise<StorageRecord>;
+
+declare type PatchOptions = {
+    bucket?: string;
+    data: StorageData;
+    version?: number;
+};
+
+export declare type PluginClosePayloadMap = WithUndefinedDefaults<PluginClosePayloadOverrides, keyof SlotContextMap>;
+
+declare type PluginClosePayloadOverrides = {
+    'attachment.viewer.action': AttachmentViewerActionClosePayload;
+};
+
+export declare type PortfolioSlotContext = MetaEntityV2 & {
+    progress: {
+        closed: number;
+        total: number;
+    };
+};
+
+export declare type ProjectSlotContext = MetaEntityV2 & {
+    progress: {
+        closed: number;
+        total: number;
+    };
+    boardId: number;
+};
+
+export declare type Reference = {
+    /** Format: uri */
+    self: string;
+    id: string;
+    /** Format: int64 */
+    version?: number | null;
+    key?: string | null;
+    display: LocalizedString;
+};
+
+export declare type Relationship = 'RELATES' | 'IS_DEPENDENT_BY' | 'DEPENDS_ON' | 'IS_SUBTASK_FOR' | 'IS_PARENT_TASK_FOR' | 'DUPLICATES' | 'IS_DUPLICATED_BY' | 'IS_EPIC_OF' | 'HAS_EPIC' | 'CLONE' | 'ORIGINAL';
+
+export declare type RequestMessage<TSlot extends keyof SlotContextMap = keyof SlotContextMap, M extends keyof TrackerContract<TSlot> = keyof TrackerContract<TSlot>> = BaseMessage & {
+    method: M;
+    payload: TrackerContract<TSlot>[M]['payload'];
+};
+
+export declare type ResponseDataRequest = {
+    method: string;
+    payload: unknown;
+};
+
+/**
+ * Регистрирует обработчик. Тип возвращаемого значения задаётся слотом (GetDataResultMap).
+ */
+export declare function setHandler<TSlot extends keyof GetDataResultMap>(name: 'getData', handler: () => GetDataResultMap[TSlot]): void;
+
+export declare function setHandler<TKey extends keyof Handlers>(name: TKey, handler: HandlerFunction<TKey>): void;
+
+export declare type SlotContextMap = {
+    'issue.action': Issue;
+    'issue.block': Issue;
+    'issue.tab': Issue;
+    navigation: Record<string, never>;
+    'trigger.create.action': TriggerCreateActionsSlotContext;
+    'trigger.edit.action': TriggerEditActionsSlotContext;
+    'portfolio.action': PortfolioSlotContext;
+    'portfolio.block': PortfolioSlotContext;
+    'portfolio.tab': PortfolioSlotContext;
+    'project.action': ProjectSlotContext;
+    'project.block': ProjectSlotContext;
+    'project.tab': ProjectSlotContext;
+    'goal.action': GoalSlotContext;
+    'goal.block': GoalSlotContext;
+    'goal.tab': GoalSlotContext;
+    'attachment.viewer.action': AttachmentViewerActionSlotContext;
+    'issue.comment.action': IssueCommentActionSlotContext;
+    'board.tab': BoardTabSlotContext;
+};
+
+export declare const storageApi: {
+    orgShared: {
+        get: typeof orgSharedGet;
+        patch: typeof orgSharedPatch;
+    };
+};
+
+export declare type StorageContextType = 'orgShared';
+
+declare type StorageContract = {
+    'storage.get': {
+        payload: StorageGetPayload;
+        result: StorageRecord | null;
+    };
+    'storage.patch': {
+        payload: StoragePatchPayload;
+        result: StorageRecord;
+    };
+};
+
+declare type StorageData = Record<string, unknown>;
+
+export declare type StorageGetPayload = {
+    contextType: StorageContextType;
+    bucket?: string;
+};
+
+export declare type StoragePatchPayload = {
+    contextType: StorageContextType;
+    bucket?: string;
+    data: Record<string, unknown>;
+    version: number;
+};
+
+export declare type StorageRecord = {
+    key: Array<{
+        organization_shared: string;
+    }>;
+    version: number;
+    data: Record<string, unknown>;
+    canWrite: boolean;
+    createdAt: string;
+    updatedAt: string;
+};
+
+/**
+ * Untyped runtime API класс. v3-методы возвращают Proxy, который при обращении
+ * по любому ключу строит call. Типизация добавляется в публикуемых пакетах
+ * через cast (см. typed wrapper).
+ */
+declare class TrackerApi {
+    private static readonly V3_VERSION;
+    get v3(): {
+        get: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;
+        post: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;
+        put: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;
+        patch: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;
+        delete: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;
+    };
+    private createMethodProxy;
+    private call;
+}
+
+export declare const trackerApi: TrackerApi;
+
+export declare interface TrackerApiCallOptions {
+    pathParams?: Record<string, string>;
+    queryParams?: Record<string, unknown>;
+    bodyParams?: Record<string, unknown>;
+    file?: File;
+}
+
+export declare interface TrackerApiInitOptions {
+    apiVersion?: string;
+}
+
+export declare type TrackerContract<TSlot extends keyof SlotContextMap = keyof SlotContextMap> = HostContract<TSlot> & ApiContract & UiContract & StorageContract;
+
+export declare type TriggerActionData = Omit<WebhookTriggerActionInput, 'id' | 'type' | 'typeKey'>;
+
+export declare type TriggerActionInput = {
+    /** Format: int32 */
+    id?: number | null;
+    typeKey: string;
+    type: string;
+};
+
+export declare type TriggerCreateActionsSlotContext = {
+    queue: string;
+};
+
+export declare type TriggerEditActionsSlotContext = {
+    queue: string;
+    data: TriggerActionData;
+};
+
+export declare type UserReferenceV2 = {
+    /** Format: uri */
+    self: string;
+    id: string;
+    /** Format: int64 */
+    version?: number | null;
+    key?: string | null;
+    display: LocalizedString;
+    department?: Reference;
+    cloudUid?: string | null;
+    /** Format: int64 */
+    passportUid?: number | null;
+};
+
+export declare type VaultBasicWebhookAuthContext = Omit<WebhookAuthContext, 'type'> & {
+    login?: string;
+    password?: {
+        sourceId?: VaultId;
+        token?: {
+            token?: string;
+            uuid?: string;
+            signature?: string | null;
+        } | null;
+    } | null;
+    type?: string;
+} & {
+    type: 'basic-vault';
+} & {
+    type: 'basic-vault';
+};
+
+export declare type VaultId = {
+    type: string;
+};
+
+export declare type VaultOAuth2WebhookAuthContext = Omit<WebhookAuthContext, 'type'> & {
+    headerName?: string;
+    tokenType?: string;
+    accessToken?: {
+        sourceId?: VaultId;
+        token?: {
+            token?: string;
+            uuid?: string;
+            signature?: string | null;
+        } | null;
+    } | null;
+    type?: string;
+    vaultEntry?: {
+        sourceId?: VaultId;
+        token?: {
+            token?: string;
+            uuid?: string;
+            signature?: string | null;
+        } | null;
+    } | null;
+} & {
+    type: 'oauth-vault';
+} & {
+    type: 'oauth-vault';
+};
+
+export declare type WebhookAuthContext = {
+    type: string;
+};
+
+export declare type WebhookTriggerActionInput = Omit<TriggerActionInput, 'type'> & {
+    endpoint?: string | null;
+    /** @enum {string|null} */
+    method?: 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'LINK' | 'UNLINK' | null;
+    contentType?: string | null;
+    headers?: {
+        [key: string]: string;
+    };
+    variables?: {
+        [key: string]: string;
+    } | null;
+    secrets?: {
+        [key: string]: {
+            sourceId?: VaultId;
+            token?: {
+                token?: string;
+                uuid?: string;
+                signature?: string | null;
+            } | null;
+        };
+    } | null;
+    authContext?: ({
+        type?: string;
+    } & (NoAuthWebhookAuthContext | OAuth2WebhookAuthContext | BasicWebhookAuthContext | VaultOAuth2WebhookAuthContext | VaultBasicWebhookAuthContext)) | null;
+    body?: string | null;
+    retryConfig?: {
+        retry500?: boolean;
+    } | null;
+    plugin?: string | null;
+    typeKey?: string;
+} & {
+    type: 'Webhook';
+} & {
+    type: 'Webhook';
+};
+
+declare type WithUndefinedDefaults<TMap, TKeys extends PropertyKey> = {
+    [K in TKeys]: K extends keyof TMap ? TMap[K] : undefined;
+};
+
+export { }

package/dist/index.mjs

@@ -0,0 +1,97 @@
+import { sendRequest as h, hostApi as y, getHandler as f, setHandler as P, getLocalizedString as p, VERSION_CONFLICT as S } from "@weavix/sdk-core";
+function E(t, e, r = {}, a) {
+  return {
+    version: a,
+    method: t,
+    url: e,
+    pathParams: r.pathParams ?? {},
+    queryParams: r.queryParams ?? {},
+    bodyParams: r.bodyParams ?? {},
+    file: r.file
+  };
+}
+const s = class s {
+  get v3() {
+    return {
+      get: this.createMethodProxy("GET"),
+      post: this.createMethodProxy("POST"),
+      put: this.createMethodProxy("PUT"),
+      patch: this.createMethodProxy("PATCH"),
+      delete: this.createMethodProxy("DELETE")
+    };
+  }
+  createMethodProxy(e) {
+    const r = this;
+    return new Proxy({}, {
+      get(a, o) {
+        return (n) => r.call(e, o, n, s.V3_VERSION);
+      }
+    });
+  }
+  call(e, r, a = {}, o) {
+    const n = E(e, r, a, o);
+    return h("api.tracker.call", n);
+  }
+};
+s.V3_VERSION = "v3";
+let l = s;
+const R = new l(), O = y;
+function V(t, e) {
+  P(t, e);
+}
+function C(t) {
+  return f(t);
+}
+function H(t, e, r = "ru") {
+  return p(t, e, r);
+}
+const d = "orgShared", i = 2;
+async function g(t) {
+  return await h("storage.get", { contextType: d, bucket: t });
+}
+async function u(t, e, r) {
+  return await h("storage.patch", {
+    contextType: d,
+    bucket: t,
+    data: e,
+    version: r
+  });
+}
+function T(t) {
+  return typeof t == "object" && t !== null && t.code === S;
+}
+function x(t) {
+  return g(t);
+}
+async function m({ bucket: t, data: e, version: r }) {
+  if (r !== void 0)
+    return u(t, e, r);
+  let a;
+  for (let o = 0; o <= i; o += 1) {
+    const n = (await g(t))?.version ?? 0;
+    try {
+      return await u(t, e, n);
+    } catch (c) {
+      if (!T(c)) throw c;
+      a = c, o < i && console.warn(
+        `[storageApi] orgShared.patch: VERSION_CONFLICT on version ${n}, retry ${o + 1}/${i}`
+      );
+    }
+  }
+  throw a;
+}
+const I = {
+  orgShared: {
+    get: x,
+    patch: m
+  }
+};
+export {
+  C as getHandler,
+  H as getLocalizedString,
+  O as hostApi,
+  V as setHandler,
+  I as storageApi,
+  R as trackerApi
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/api/trackerApiBase.ts","../src/host/hostApi.ts","../src/handlers/handlers.ts","../src/utils/localization.ts","../src/storage/storageApi.ts"],"sourcesContent":["import { sendRequest } from '@weavix/sdk-core';\nimport type { ApiCallPayload, ApiCallResult } from './types';\n\nexport interface TrackerApiCallOptions {\n    pathParams?: Record<string, string>;\n    queryParams?: Record<string, unknown>;\n    bodyParams?: Record<string, unknown>;\n    file?: File;\n}\n\nfunction buildPayload(\n    method: string,\n    url: string,\n    options: TrackerApiCallOptions = {},\n    version: string,\n): ApiCallPayload {\n    return {\n        version,\n        method,\n        url,\n        pathParams: options.pathParams ?? {},\n        queryParams: options.queryParams ?? {},\n        bodyParams: options.bodyParams ?? {},\n        file: options.file,\n    };\n}\n\nexport interface TrackerApiInitOptions {\n    apiVersion?: string;\n}\n\n/**\n * Untyped runtime API класс. v3-методы возвращают Proxy, который при обращении\n * по любому ключу строит call. Типизация добавляется в публикуемых пакетах\n * через cast (см. typed wrapper).\n */\nexport class TrackerApi {\n    private static readonly V3_VERSION = 'v3';\n\n    get v3(): {\n        get: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;\n        post: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;\n        put: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;\n        patch: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;\n        delete: Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>;\n    } {\n        return {\n            get: this.createMethodProxy('GET'),\n            post: this.createMethodProxy('POST'),\n            put: this.createMethodProxy('PUT'),\n            patch: this.createMethodProxy('PATCH'),\n            delete: this.createMethodProxy('DELETE'),\n        };\n    }\n\n    private createMethodProxy(\n        method: string,\n    ): Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>> {\n        const self = this;\n        return new Proxy({} as Record<string, (opts: TrackerApiCallOptions) => Promise<unknown>>, {\n            get(_, path: string) {\n                return (payload: TrackerApiCallOptions) =>\n                    self.call(method, path, payload, TrackerApi.V3_VERSION);\n            },\n        });\n    }\n\n    private call(\n        method: string,\n        url: string,\n        options: TrackerApiCallOptions = {},\n        requestVersion: string,\n    ): Promise<ApiCallResult> {\n        const payload: ApiCallPayload = buildPayload(method, url, options, requestVersion);\n        return sendRequest('api.tracker.call', payload) as Promise<ApiCallResult>;\n    }\n}\n\nexport const trackerApi = new TrackerApi();\n","import {\n    ContentSizeUpdateRequest,\n    type ContextLevel,\n    type HostInitOptions,\n    Theme,\n    hostApi as hostApiBase,\n} from '@weavix/sdk-core';\nimport type { SlotContextMap } from '../types/SlotContextMap';\nimport type { PluginClosePayloadMap } from './types/ClosePluginPayload';\n\nexport type { HostInitOptions };\n\n/**\n * Типизированный интерфейс HostApi для публичного API публикуемого core'а.\n */\nexport interface HostApi<TSlot extends keyof SlotContextMap = keyof SlotContextMap> {\n    /**\n     * Текущая тема хоста\n     */\n    getTheme(): Promise<Theme>;\n\n    /**\n     * Текущий язык хоста\n     */\n    getLanguage(): Promise<string>;\n\n    /**\n     * Id пользователя\n     */\n    getUserId(): Promise<string>;\n\n    /**\n     * Сборка для ятима\n     */\n    getIsYateam(): Promise<boolean>;\n\n    /**\n     * Получить текущий контекст, в котором запущен плагин.\n     * Тип возвращаемого значения зависит от слота.\n     */\n    getContext(): Promise<SlotContextMap[TSlot]>;\n\n    /**\n     * Изменить размер окна, в котором запущен плагин\n     */\n    updateContentSize(payload: ContentSizeUpdateRequest): Promise<void>;\n\n    /**\n     * Сообщить, что плагин готов к работе\n     */\n    notifyReady(): Promise<void>;\n\n    /**\n     * Сообщить, что плагин закрыт\n     */\n    close(payload: PluginClosePayloadMap[TSlot]): Promise<void>;\n\n    /**\n     * Инициализация плагина\n     */\n    init(options: HostInitOptions): void;\n\n    /**\n     * Текущий слот, в котором открыт плагин.\n     * Вызов до init() приведёт к ошибке.\n     */\n    getSlot(): TSlot;\n\n    /**\n     * Сервис, в котором открылся плагин.\n     * Вызов до init() приведёт к ошибке.\n     */\n    getService(): string;\n\n    /**\n     * Origin родительского окна (хоста).\n     * Вызов до init() приведёт к ошибке.\n     */\n    getOrigin(): string;\n\n    /**\n     * Внутренний урл плагина.\n     * Вызов до init() приведёт к ошибке.\n     */\n    getInnerUrl(): string;\n\n    /**\n     * Query-параметры плагина.\n     * Вызов до init() приведёт к ошибке.\n     */\n    getQueryParams(): Record<string, string>;\n\n    /**\n     * Идентификатор сущности, переданный хостом в параметрах iframe.\n     * Доступен сразу после init() без postMessage-запроса.\n     */\n    getEntityId(): string | null;\n\n    /**\n     * Метаданные сущности, переданные хостом в параметрах iframe.\n     * Доступны сразу после init() без postMessage-запроса.\n     */\n    getEntityMeta(): Record<string, string> | undefined;\n\n    /**\n     * Уровень контекста, объявленный в манифесте плагина.\n     * 'basic' — только entityId, 'full' — полный контекст слота.\n     */\n    getContextLevel(): ContextLevel;\n\n    /**\n     * Выключить автоматическое изменение размера контейнера\n     */\n    disableAutoResize(): void;\n}\n\nexport const hostApi = hostApiBase as unknown as HostApi;\n","import { getHandler as baseGetHandler, setHandler as baseSetHandler } from '@weavix/sdk-core';\nimport type { GetDataResultMap, HandlerFunction, Handlers } from './types';\n\n/**\n * Регистрирует обработчик. Тип возвращаемого значения задаётся слотом (GetDataResultMap).\n */\nexport function setHandler<TSlot extends keyof GetDataResultMap>(\n    name: 'getData',\n    handler: () => GetDataResultMap[TSlot],\n): void;\nexport function setHandler<TKey extends keyof Handlers>(\n    name: TKey,\n    handler: HandlerFunction<TKey>,\n): void;\nexport function setHandler(name: string, handler: (...args: unknown[]) => unknown): void {\n    baseSetHandler(name, handler);\n}\n\n/**\n * Возвращает обработчик getData. При указании TSlot — () => GetDataResultMap[TSlot].\n */\nexport function getHandler<TSlot extends keyof GetDataResultMap>(\n    name: 'getData',\n): (() => GetDataResultMap[TSlot]) | undefined;\nexport function getHandler<TKey extends keyof Handlers>(\n    name: TKey,\n): HandlerFunction<TKey> | undefined;\nexport function getHandler(name: string): ((...args: unknown[]) => unknown) | undefined {\n    return baseGetHandler(name);\n}\n","import {\n    type LocalizedString as StructuralLocalizedString,\n    getLocalizedString as baseGetLocalizedString,\n} from '@weavix/sdk-core';\nimport type { LocalizedString } from '../types/primitives';\n\n/**\n * Получить локализованную строку на основе языка.\n * Принимает `LocalizedString` из @weavix/tracker-core.\n */\nexport function getLocalizedString(\n    value: LocalizedString,\n    language: string | undefined,\n    fallbackLanguage = 'ru',\n): string {\n    return baseGetLocalizedString(value as StructuralLocalizedString, language, fallbackLanguage);\n}\n","import { VERSION_CONFLICT, sendRequest } from '@weavix/sdk-core';\n\nimport type { StorageRecord } from './types';\n\nexport type StorageData = Record<string, unknown>;\n\nexport type PatchOptions = {\n    bucket?: string;\n    data: StorageData;\n    version?: number;\n};\n\nconst CONTEXT_TYPE = 'orgShared' as const;\nconst MAX_RETRIES = 2;\n\nasync function readRecord(bucket: string | undefined): Promise<StorageRecord | null> {\n    const result = await sendRequest('storage.get', { contextType: CONTEXT_TYPE, bucket });\n\n    return result as StorageRecord | null;\n}\n\nasync function patchRecord(\n    bucket: string | undefined,\n    data: StorageData,\n    version: number,\n): Promise<StorageRecord> {\n    const result = await sendRequest('storage.patch', {\n        contextType: CONTEXT_TYPE,\n        bucket,\n        data,\n        version,\n    });\n\n    return result as StorageRecord;\n}\n\nfunction isVersionConflict(err: unknown): boolean {\n    return (\n        typeof err === 'object' &&\n        err !== null &&\n        (err as { code?: unknown }).code === VERSION_CONFLICT\n    );\n}\n\nfunction orgSharedGet(bucket?: string): Promise<StorageRecord | null> {\n    return readRecord(bucket);\n}\n\nasync function orgSharedPatch({ bucket, data, version }: PatchOptions): Promise<StorageRecord> {\n    if (version !== undefined) {\n        return patchRecord(bucket, data, version);\n    }\n\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= MAX_RETRIES; attempt += 1) {\n        const currentVersion = (await readRecord(bucket))?.version ?? 0;\n\n        try {\n            return await patchRecord(bucket, data, currentVersion);\n        } catch (err) {\n            if (!isVersionConflict(err)) throw err;\n            lastError = err;\n\n            if (attempt < MAX_RETRIES) {\n                console.warn(\n                    `[storageApi] orgShared.patch: VERSION_CONFLICT on version ${currentVersion}, retry ${attempt + 1}/${MAX_RETRIES}`,\n                );\n            }\n        }\n    }\n\n    throw lastError;\n}\n\nexport const storageApi = {\n    orgShared: {\n        get: orgSharedGet,\n        patch: orgSharedPatch,\n    },\n};\n"],"names":["buildPayload","method","url","options","version","_TrackerApi","self","_","path","payload","requestVersion","sendRequest","TrackerApi","trackerApi","hostApi","hostApiBase","setHandler","name","handler","baseSetHandler","getHandler","baseGetHandler","getLocalizedString","value","language","fallbackLanguage","baseGetLocalizedString","CONTEXT_TYPE","MAX_RETRIES","readRecord","bucket","patchRecord","data","isVersionConflict","err","VERSION_CONFLICT","orgSharedGet","orgSharedPatch","lastError","attempt","currentVersion","storageApi"],"mappings":"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"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@weavix/tracker-core",
+  "version": "0.0.1",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [],
+  "author": "Tracker Team",
+  "license": "UNLICENSED",
+  "description": "Shared TypeScript types and bridge layer for Tracker plugins",
+  "peerDependencies": {
+    "@weavix/sdk-core": "^0.0.3"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/jest": "*",
+    "@weavix/sdk-core": "0.0.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit"
+  }
+}