dochub-sdk 0.1.380 → 0.1.382

package/index.ts

@@ -24,11 +24,13 @@ export * from './metamodel/index';
 export * from './interfaces/ai';
 export * from './interfaces/explainer';
 export * from './interfaces/libraries';
+export * from './interfaces/shared';
 
 export * from './schemas/basetypes';
 export * from './schemas/dochub-yaml';
 
 export * from './plugins/manifest';
+export * from './plugins/module';
 
 export * from './environments/variables';
 

package/interfaces/libraries.ts

@@ -1,48 +1,44 @@
 export type IDocHubLibrary = any;
+export type DocHubLibraryID = string;
+export type DocHubLibraryVersion = string;
+export type DocHubLibraryRequireVersion = string;
+export type DocHubLibraryExportVersion = string;
+
 /**
- * Интерфейсы публикуемых плагинами библиотек
+ * Декларирует публикуемые плагином библиотеки
  */
-export interface IDocHubLibraryExportProfile {
-    /**
-     * Если библиотека имеет исходники для сборки, здесь указывается путь к ним.
-     * Ссылка на исходники позволяет при разработке обращаться к декларациям интерфейсов и функций библиотек,
-     * а также, при необходимости внедрять библиотеки непосредственно в плагины.
-     */
-    srcPath?: string;
-    /**
-     * Реализация загрузки модуля.
-     * В результате вызова данной функции необходимо вернуть ссылку на загруженный модуль.
-     */
-    import(): Promise<IDocHubLibrary>;
+export interface IDocHubLibrariesExport {
+    [id: DocHubLibraryID]: DocHubLibraryExportVersion;
 }
 
 /**
- * Декларирует публикуемые плагином библиотеки
+ * Ручка для разрешения зависимости от библиотеки. Должна возвращать объект module.
  */
-export interface IDocHubLibrariesExport {
-    [id: string]: IDocHubLibraryExportProfile;
+export type IDocHubLibraryResolver = (library: DocHubLibraryID) => Promise<IDocHubLibrary>;
+
+/**
+ * Интерфейс доступа к общим библиотекам, которые предоставляет плагин
+ */
+export interface IDocHubSharedLibraries {
+    resolve: IDocHubLibraryResolver;
+}
+
+/**
+ * Структура перечисления библиотек и их версий
+ */
+export interface IDocHubLibraryRequires {
+    [id: DocHubLibraryID]: DocHubLibraryRequireVersion;
 }
 
 /**
  * Интерфейс управления библиотеками
  */
 export interface IDocHubLibraries {
-    /**
-     * Публикует библиотеки для всех желающих
-     * @param libraries - структура экспорта
-     */
-    export(libraries: IDocHubLibrariesExport);
-    /**
-     * При вызове будет ожидать загрузки необходимых библиотек.
-     * Если загрузка хотя бы одной библиотеки не удастся, возникнет ошибка.
-     * @param libraries - список необходимых библиотек
-     */
-    requires(libraries: string[]): Promise<void>;
     /**
      * Проверяет доступна ли библиотека. 
      * Возвращает структуру где для каждой библиотеки указывается true если она доступна, либо false
      * @param libraries 
      */
-    isAvailable(libraries: string[]): Promise<{ [library: string]: boolean }>;
+    isAvailable(libraries: IDocHubLibraryRequires): Promise<{ [library: string]: boolean }>;
 }
 

package/interfaces/shared.ts

@@ -0,0 +1,21 @@
+/**
+ * Интерфейс для экспорта общих ресурсов из плагинов
+ */
+import { IDocHubLibraryResolver } from "./libraries";
+
+/**
+ * Экспортный метод общих ресурсов плагина
+ */
+export type DocHubSharedResources = () => Promise<IDocHubSharedResources>;
+
+/**
+ * Интерфейс общих ресурсов поставляемый плагином
+ */
+export interface IDocHubSharedResources {
+    /**
+     * Возвращает объект module для экспортируемой библиотеки
+     */
+    libraries?: {
+        resolve: IDocHubLibraryResolver;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dochub-sdk",
-  "version": "0.1.380",
+  "version": "0.1.382",
   "description": "The DocHub System Development Kit.",
   "private": false,
   "main": "index.ts",

package/plugins/manifest.ts

@@ -1,3 +1,4 @@
+import { IDocHubLibrariesExport, IDocHubLibraryRequires } from "../interfaces/libraries";
 import { DocHubJSONSchema, IDocHubJSONSchemaAllOf, IDocHubJSONSchemaAnyOf, IDocHubJSONSchemaArray, IDocHubJSONSchemaBase, IDocHubJSONSchemaBoolean, IDocHubJSONSchemaInteger, IDocHubJSONSchemaNumber, IDocHubJSONSchemaObject, IDocHubJSONSchemaOneOf, IDocHubJSONSchemaString } from "../schemas/basetypes";
 
 /**
@@ -68,8 +69,10 @@ export interface IDocHubPluginManifest {
     }
     // Свойства приложения
     app_props: IDocHubManifestProps;
-    // Подключаемые плагины
-    app_plugins?: IDocHubManifestPlugins;
     // Переменные среды исполнения
     app_environments?: IDocHubManifestEnvironments;
+    // Зависимость от общих библиотек в DocHub
+    DocHubDependencies?: IDocHubLibraryRequires;
+    // Экспортируемые общие библиотеки в DocHub
+    DocHubExport?: IDocHubLibrariesExport;
 }

package/plugins/module.ts

@@ -0,0 +1,31 @@
+/**
+ * Декларирует интерфейс, который должен реализовать js-модуль плагина
+ */
+
+import { IDocHubSharedResources } from "../interfaces/shared";
+
+/**
+ * Функция инициализации плагина в режиме frontend
+ */
+export type DocHubFrontendBootstrap = () => Promise<void>;
+
+/**
+ * Функция инициализации плагина в режиме backend
+ */
+export type DocHubBackendBootstrap = () => Promise<void>;
+
+/**
+ * Загрузочный интерфейс плагина
+ */
+export interface IDocHubPluginBootstrap {
+    frontend?: DocHubFrontendBootstrap;
+    backend?: DocHubBackendBootstrap;
+}
+
+/**
+ * Интерфейс, который обязан реализовать плагин
+ */
+export interface IDocHubPlugin {
+    bootstrap?: IDocHubPluginBootstrap;
+    shared?: IDocHubSharedResources;
+}