dochub-sdk 0.1.258 → 0.1.260

package/.vscode/settings.json

@@ -9,6 +9,7 @@
         "datalake",
         "eventbus",
         "localstorage",
+        "Nata",
         "PROPFIND"
     ]
 }

package/interfaces/datalake.ts

@@ -257,7 +257,14 @@ export enum DocHubDataLakeDebuggerHandleActions {
     stop = 'stop'   // Прервать выполнение 
 }
 
-export type DocHubDataLakeDebuggerQuery = (expression: DocHubJSONataQuery) => Promise<any>;
+/**
+ * Специальный тип запросов в отладчик.
+ * Если запрос начинается на $, считается, что запрос должен вернуть значение переменной из контекста выполнения
+ */
+export type DocHubDebuggerQuery = `$${string}` | DocHubJSONataQuery;
+
+export type DocHubDataLakeDebuggerQuery = (expression: DocHubDebuggerQuery) => Promise<any>;
+
 
 /**
  * Элемент стека выполнения запросов в DataLake

package/interfaces/datasets.ts

@@ -7,13 +7,65 @@ export type DocHubDataSetID =  string;
  */
 export type DocHubDataSetData = object;
 /**
- * JSONata запрос
+ * JSONata запрос с расширенными свойствами
  */
-export type DocHubJSONataQuery =  `(${string})` | `jsonata(${string})`;
+
+/**
+ * Простое, строковое определение JSONata запроса
+ */
+export type DocHubJSONataQuerySimple = `(${string})` | `jsonata(${string})`;
+
 /**
  * Ссылка на JSONata файл
  */
-export type DocHubJSONataFile =  `${string}.jsonata`;
+export type DocHubJSONataFile = `${string}.jsonata`;
+
+/**
+ * Метаинформация JSONata запроса
+ */
+export interface DocHubJSONataQueryMeta {
+    /**
+     * URI ресурса, где декларирован запрос 
+     */
+    source?: string;
+    /**
+     * Путь к свойству определения
+     */
+    path?: string;
+}
+
+/**
+ * Класс, позволяет создавать запросы с расширенной информацией об источнике его происхождения
+ * для удобства отладки.
+ */
+export class DocHubJSONataQueryObject extends String {
+    /**
+     * URI ресурса, где определен запрос
+     */
+    private uri: string | undefined;
+    /**
+     * Путь к определению запроса
+     */
+    private path: string | undefined;
+    constructor(query: DocHubJSONataQuerySimple, uri?: string, path?: string) {
+        super(query);
+        this.uri = uri;
+        this.path = path;
+        return this;
+    }
+    get __uri__(): string | undefined {
+        return this.uri;
+    }
+    get __path__(): string | undefined {
+        return this.path;
+    }
+}
+
+/**
+ * JSONata запрос
+ */
+export type DocHubJSONataQuery =  DocHubJSONataQuerySimple | DocHubJSONataQueryObject;
+
 /**
  * Ссылка на файл данных
  */

package/package.json

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