@qrunio/qqq-frontend-core 1.0.128-SNAPSHOT

package/lib/model/metaData/QFieldType.js

@@ -0,0 +1,43 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/*******************************************************************************
+ ** Possible data types for Q-fields.
+ **
+ *******************************************************************************/
+export var QFieldType;
+(function (QFieldType) {
+    QFieldType["BOOLEAN"] = "BOOLEAN";
+    QFieldType["STRING"] = "STRING";
+    QFieldType["INTEGER"] = "INTEGER";
+    QFieldType["LONG"] = "LONG";
+    QFieldType["DECIMAL"] = "DECIMAL";
+    QFieldType["DATE"] = "DATE";
+    QFieldType["TIME"] = "TIME";
+    QFieldType["DATE_TIME"] = "DATE_TIME";
+    QFieldType["TEXT"] = "TEXT";
+    QFieldType["HTML"] = "HTML";
+    QFieldType["PASSWORD"] = "PASSWORD";
+    QFieldType["BLOB"] = "BLOB";
+    ////////////////////////////////////////////////////////////////////////
+    // keep these values in sync with QFieldType.java in qqq-backend-core //
+    ////////////////////////////////////////////////////////////////////////
+})(QFieldType || (QFieldType = {}));
+//# sourceMappingURL=QFieldType.js.map

package/lib/model/metaData/QFieldType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QFieldType.js","sourceRoot":"","sources":["../../../src/model/metaData/QFieldType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;iFAGiF;AACjF,MAAM,CAAN,IAAY,UAgBX;AAhBD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,2BAAa,CAAA;IACb,iCAAmB,CAAA;IACnB,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,qCAAuB,CAAA;IACvB,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,mCAAqB,CAAA;IACrB,2BAAa,CAAA;IACb,wEAAwE;IACxE,wEAAwE;IACxE,wEAAwE;AAC1E,CAAC,EAhBW,UAAU,KAAV,UAAU,QAgBrB"}

package/lib/model/metaData/QFrontendComponent.d.ts

@@ -0,0 +1,10 @@
+import { QComponentType } from "./QComponentType";
+/*******************************************************************************
+ ** Meta-Data to define a component on a screen in a QQQ process.
+ **
+ *******************************************************************************/
+export declare class QFrontendComponent {
+    type: QComponentType;
+    values?: any;
+    constructor(object: any);
+}

package/lib/model/metaData/QFrontendComponent.js

@@ -0,0 +1,35 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/*******************************************************************************
+ ** Meta-Data to define a component on a screen in a QQQ process.
+ **
+ *******************************************************************************/
+var QFrontendComponent = /** @class */ (function () {
+    function QFrontendComponent(object) {
+        this.type = object.type;
+        if (object.values) {
+            this.values = object.values;
+        }
+    }
+    return QFrontendComponent;
+}());
+export { QFrontendComponent };
+//# sourceMappingURL=QFrontendComponent.js.map

package/lib/model/metaData/QFrontendComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QFrontendComponent.js","sourceRoot":"","sources":["../../../src/model/metaData/QFrontendComponent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;;iFAGiF;AACjF;IAKG,4BAAY,MAAW;QAEpB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QAEvB,IAAI,MAAM,CAAC,MAAM,EACjB;YACG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;SAC9B;IACJ,CAAC;IACJ,yBAAC;AAAD,CAAC,AAdD,IAcC"}

package/lib/model/metaData/QFrontendStepMetaData.d.ts

@@ -0,0 +1,18 @@
+import { QFieldMetaData } from "./QFieldMetaData";
+import { QFrontendComponent } from "./QFrontendComponent";
+import { QHelpContent } from "./QHelpContent";
+/*******************************************************************************
+ ** Meta-Data to define a step (for the frontend) in a QQQ process.
+ **
+ *******************************************************************************/
+export declare class QFrontendStepMetaData {
+    name: string;
+    label: string;
+    format: string;
+    components?: QFrontendComponent[];
+    formFields?: QFieldMetaData[];
+    viewFields?: QFieldMetaData[];
+    recordListFields?: QFieldMetaData[];
+    helpContents?: QHelpContent[];
+    constructor(object: any);
+}

package/lib/model/metaData/QFrontendStepMetaData.js

@@ -0,0 +1,62 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { QFieldMetaData } from "./QFieldMetaData";
+import { QFrontendComponent } from "./QFrontendComponent";
+import { QHelpContent } from "./QHelpContent";
+/*******************************************************************************
+ ** Meta-Data to define a step (for the frontend) in a QQQ process.
+ **
+ *******************************************************************************/
+var QFrontendStepMetaData = /** @class */ (function () {
+    function QFrontendStepMetaData(object) {
+        this.name = object.name;
+        this.label = object.label;
+        this.format = object.format;
+        if (object.components) {
+            this.components = [];
+            for (var i = 0; i < object.components.length; i++) {
+                this.components.push(new QFrontendComponent(object.components[i]));
+            }
+        }
+        if (object.formFields) {
+            this.formFields = [];
+            for (var i = 0; i < object.formFields.length; i++) {
+                this.formFields.push(new QFieldMetaData(object.formFields[i]));
+            }
+        }
+        if (object.viewFields) {
+            this.viewFields = [];
+            for (var i = 0; i < object.viewFields.length; i++) {
+                this.viewFields.push(new QFieldMetaData(object.viewFields[i]));
+            }
+        }
+        if (object.recordListFields) {
+            this.recordListFields = [];
+            for (var i = 0; i < object.recordListFields.length; i++) {
+                this.recordListFields.push(new QFieldMetaData(object.recordListFields[i]));
+            }
+        }
+        this.helpContents = QHelpContent.buildArray(object.helpContents);
+    }
+    return QFrontendStepMetaData;
+}());
+export { QFrontendStepMetaData };
+//# sourceMappingURL=QFrontendStepMetaData.js.map

package/lib/model/metaData/QFrontendStepMetaData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QFrontendStepMetaData.js","sourceRoot":"","sources":["../../../src/model/metaData/QFrontendStepMetaData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C;;;iFAGiF;AACjF;IAYG,+BAAY,MAAW;QAEpB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAE5B,IAAI,MAAM,CAAC,UAAU,EACrB;YACG,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;YACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EACjD;gBACG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACrE;SACH;QAED,IAAI,MAAM,CAAC,UAAU,EACrB;YACG,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;YACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EACjD;gBACG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACjE;SACH;QAED,IAAI,MAAM,CAAC,UAAU,EACrB;YACG,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;YACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EACjD;gBACG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACjE;SACH;QAED,IAAI,MAAM,CAAC,gBAAgB,EAC3B;YACG,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,EAAE,EACvD;gBACG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAC7E;SACH;QAED,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IACnE,CAAC;IACJ,4BAAC;AAAD,CAAC,AAxDD,IAwDC"}

package/lib/model/metaData/QHelpContent.d.ts

@@ -0,0 +1,23 @@
+/*******************************************************************************
+ ** Meta-Data to define HelpContent
+ **
+ *******************************************************************************/
+export declare class QHelpContent {
+    content: string;
+    format: string;
+    roles: Set<string>;
+    /*******************************************************************************
+     **
+     *******************************************************************************/
+    constructor(object: any);
+    /*******************************************************************************
+     ** factory method, for building an array of QHelpContent objects from array of
+     ** unstructured data (e.g., as it would come from the backend)
+     *******************************************************************************/
+    static buildArray(helpContents: any[]): QHelpContent[] | undefined;
+    /*******************************************************************************
+     ** factory method, for building an map of QHelpContent objects from map of
+     ** unstructured data (e.g., as it would come from the backend)
+     *******************************************************************************/
+    static buildMap(object: any): Map<string, QHelpContent[]> | undefined;
+}

package/lib/model/metaData/QHelpContent.js

@@ -0,0 +1,82 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/*******************************************************************************
+ ** Meta-Data to define HelpContent
+ **
+ *******************************************************************************/
+var QHelpContent = /** @class */ (function () {
+    /*******************************************************************************
+     **
+     *******************************************************************************/
+    function QHelpContent(object) {
+        this.roles = new Set();
+        this.content = object.content;
+        this.format = object.format;
+        if (object.roles) {
+            for (var i = 0; i < object.roles.length; i++) {
+                this.roles.add(object.roles[i]);
+            }
+        }
+    }
+    /*******************************************************************************
+     ** factory method, for building an array of QHelpContent objects from array of
+     ** unstructured data (e.g., as it would come from the backend)
+     *******************************************************************************/
+    QHelpContent.buildArray = function (helpContents) {
+        var rs;
+        if (helpContents) {
+            rs = [];
+            for (var i = 0; i < helpContents.length; i++) {
+                rs.push(new QHelpContent(helpContents[i]));
+            }
+        }
+        return (rs);
+    };
+    /*******************************************************************************
+     ** factory method, for building an map of QHelpContent objects from map of
+     ** unstructured data (e.g., as it would come from the backend)
+     *******************************************************************************/
+    QHelpContent.buildMap = function (object) {
+        var rs = undefined;
+        if (object) {
+            rs = new Map();
+            for (var key in object) {
+                var list = [];
+                rs.set(key, list);
+                //////////////////////////////////////////////////////////////////////////////////////////////////////
+                // allow object from backend to either be an array or a scalar (for migration from scalar to array) //
+                //////////////////////////////////////////////////////////////////////////////////////////////////////
+                if (object[key].length) {
+                    for (var i = 0; i < object[key].length; i++) {
+                        list.push(new QHelpContent(object[key][i]));
+                    }
+                }
+                else {
+                    list.push(new QHelpContent(object[key]));
+                }
+            }
+        }
+        return (rs);
+    };
+    return QHelpContent;
+}());
+export { QHelpContent };
+//# sourceMappingURL=QHelpContent.js.map

package/lib/model/metaData/QHelpContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QHelpContent.js","sourceRoot":"","sources":["../../../src/model/metaData/QHelpContent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;iFAGiF;AACjF;IAOG;;qFAEiF;IACjF,sBAAY,MAAW;QANvB,UAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAQvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAE5B,IAAI,MAAM,CAAC,KAAK,EAChB;YACG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAC5C;gBACG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aAClC;SACH;IACJ,CAAC;IAGD;;;qFAGiF;IAC1E,uBAAU,GAAjB,UAAkB,YAAmB;QAElC,IAAI,EAA8B,CAAC;QAEnC,IAAI,YAAY,EAChB;YACG,EAAE,GAAG,EAAE,CAAC;YACR,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAC5C;gBACG,EAAE,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAC7C;SACH;QAED,OAAO,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAGD;;;qFAGiF;IAC1E,qBAAQ,GAAf,UAAgB,MAAW;QAExB,IAAI,EAAE,GAAG,SAAS,CAAC;QAEnB,IAAI,MAAM,EACV;YACG,EAAE,GAAG,IAAI,GAAG,EAA0B,CAAC;YACvC,KAAK,IAAM,GAAG,IAAI,MAAM,EACxB;gBACG,IAAM,IAAI,GAAmB,EAAE,CAAC;gBAChC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAElB,sGAAsG;gBACtG,sGAAsG;gBACtG,sGAAsG;gBACtG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EACtB;oBACG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAC3C;wBACG,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;qBAC9C;iBACH;qBAED;oBACG,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBAC3C;aACH;SACH;QAED,OAAO,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAEJ,mBAAC;AAAD,CAAC,AAlFD,IAkFC"}

package/lib/model/metaData/QIcon.d.ts

@@ -0,0 +1,10 @@
+/*******************************************************************************
+ ** Meta-Data to define an icon for use in a QQQ instance
+ **
+ *******************************************************************************/
+export declare class QIcon {
+    name?: string;
+    path?: string;
+    color?: string;
+    constructor(object: any);
+}

package/lib/model/metaData/QIcon.js

@@ -0,0 +1,34 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/*******************************************************************************
+ ** Meta-Data to define an icon for use in a QQQ instance
+ **
+ *******************************************************************************/
+var QIcon = /** @class */ (function () {
+    function QIcon(object) {
+        this.name = object.name;
+        this.path = object.path;
+        this.color = object.color;
+    }
+    return QIcon;
+}());
+export { QIcon };
+//# sourceMappingURL=QIcon.js.map

package/lib/model/metaData/QIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QIcon.js","sourceRoot":"","sources":["../../../src/model/metaData/QIcon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;iFAGiF;AACjF;IAMG,eAAY,MAAW;QAEpB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7B,CAAC;IACJ,YAAC;AAAD,CAAC,AAZD,IAYC"}

package/lib/model/metaData/QInstance.d.ts

@@ -0,0 +1,41 @@
+import { QAppMetaData } from "./QAppMetaData";
+import { QAppTreeNode } from "./QAppTreeNode";
+import { QBrandingMetaData } from "./QBrandingMetaData";
+import { QHelpContent } from "./QHelpContent";
+import { QProcessMetaData } from "./QProcessMetaData";
+import { QReportMetaData } from "./QReportMetaData";
+import { QTableMetaData } from "./QTableMetaData";
+import { QWidgetMetaData } from "./QWidgetMetaData";
+/*******************************************************************************
+ ** Meta-Data definition of a QQQ Instance
+ **
+ *******************************************************************************/
+export declare class QInstance {
+    tables?: Map<string, QTableMetaData>;
+    processes?: Map<string, QProcessMetaData>;
+    reports?: Map<string, QReportMetaData>;
+    widgets?: Map<string, QWidgetMetaData>;
+    apps?: Map<string, QAppMetaData>;
+    appTree?: QAppTreeNode[];
+    branding?: QBrandingMetaData;
+    environmentValues?: Map<string, string>;
+    helpContent?: Map<string, QHelpContent[]>;
+    supplementalInstanceMetaData: Map<String, any>;
+    constructor(object: any);
+    /*******************************************************************************
+     ** Get the full path to an app
+     *******************************************************************************/
+    getAppPath(app: QAppMetaData): string | null;
+    /*******************************************************************************
+     ** Get the full path to a table
+     *******************************************************************************/
+    getTablePath(table: QTableMetaData): string | null;
+    /*******************************************************************************
+     ** Get the full path to a table
+     *******************************************************************************/
+    getTablePathByName(tableName: string): string | null;
+    /*******************************************************************************
+     **
+     *******************************************************************************/
+    private static searchAppTreeForPath;
+}

package/lib/model/metaData/QInstance.js

@@ -0,0 +1,145 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { QAppMetaData } from "./QAppMetaData";
+import { QAppNodeType } from "./QAppNodeType";
+import { QAppTreeNode } from "./QAppTreeNode";
+import { QBrandingMetaData } from "./QBrandingMetaData";
+import { QHelpContent } from "./QHelpContent";
+import { QProcessMetaData } from "./QProcessMetaData";
+import { QReportMetaData } from "./QReportMetaData";
+import { QTableMetaData } from "./QTableMetaData";
+import { QWidgetMetaData } from "./QWidgetMetaData";
+/*******************************************************************************
+ ** Meta-Data definition of a QQQ Instance
+ **
+ *******************************************************************************/
+var QInstance = /** @class */ (function () {
+    function QInstance(object) {
+        this.supplementalInstanceMetaData = new Map();
+        if (object.tables) {
+            this.tables = new Map();
+            for (var key in object.tables) {
+                this.tables.set(key, new QTableMetaData(object.tables[key]));
+            }
+        }
+        if (object.processes) {
+            this.processes = new Map();
+            for (var key in object.processes) {
+                this.processes.set(key, new QProcessMetaData(object.processes[key]));
+            }
+        }
+        if (object.reports) {
+            this.reports = new Map();
+            for (var key in object.reports) {
+                this.reports.set(key, new QReportMetaData(object.reports[key]));
+            }
+        }
+        if (object.apps) {
+            this.apps = new Map();
+            for (var key in object.apps) {
+                this.apps.set(key, new QAppMetaData(object.apps[key]));
+            }
+        }
+        if (object.widgets) {
+            this.widgets = new Map();
+            for (var key in object.widgets) {
+                this.widgets.set(key, new QWidgetMetaData(object.widgets[key]));
+            }
+        }
+        if (object.appTree) {
+            this.appTree = [];
+            for (var i = 0; i < object.appTree.length; i++) {
+                this.appTree.push(new QAppTreeNode(object.appTree[i]));
+            }
+        }
+        if (object.branding) {
+            this.branding = new QBrandingMetaData(object.branding);
+        }
+        if (object.environmentValues) {
+            this.environmentValues = new Map();
+            for (var key in object.environmentValues) {
+                this.environmentValues.set(key, object.environmentValues[key]);
+            }
+        }
+        if (object.supplementalInstanceMetaData) {
+            for (var key in object.supplementalInstanceMetaData) {
+                this.supplementalInstanceMetaData.set(key, object.supplementalInstanceMetaData[key]);
+            }
+        }
+        this.helpContent = QHelpContent.buildMap(object.helpContents);
+    }
+    /*******************************************************************************
+     ** Get the full path to an app
+     *******************************************************************************/
+    QInstance.prototype.getAppPath = function (app) {
+        return QInstance.searchAppTreeForPath(this.appTree, app.name, QAppNodeType.APP, 1, "");
+    };
+    /*******************************************************************************
+     ** Get the full path to a table
+     *******************************************************************************/
+    QInstance.prototype.getTablePath = function (table) {
+        return QInstance.searchAppTreeForPath(this.appTree, table.name, QAppNodeType.TABLE, 1, "");
+    };
+    /*******************************************************************************
+     ** Get the full path to a table
+     *******************************************************************************/
+    QInstance.prototype.getTablePathByName = function (tableName) {
+        return QInstance.searchAppTreeForPath(this.appTree, tableName, QAppNodeType.TABLE, 1, "");
+    };
+    /*******************************************************************************
+     **
+     *******************************************************************************/
+    QInstance.searchAppTreeForPath = function (nodes, name, appNodeType, depth, path) {
+        var _a;
+        if (nodes === undefined) {
+            return (null);
+        }
+        for (var i = 0; i < nodes.length; i++) {
+            if (nodes[i].type === appNodeType && nodes[i].name === name) {
+                /////////////////////////////////////////////////////////////////////////////////
+                // dont show top level apps, unless they don't have any children that are apps //
+                /////////////////////////////////////////////////////////////////////////////////
+                if (appNodeType === QAppNodeType.APP && depth === 1) {
+                    var appChildren = null;
+                    if (nodes[i] && nodes[i].children) {
+                        appChildren = (_a = nodes[i].children) === null || _a === void 0 ? void 0 : _a.filter(function (child) {
+                            return child.type == QAppNodeType.APP;
+                        });
+                    }
+                    if (appChildren && appChildren.length > 0) {
+                        return (null);
+                    }
+                }
+                return ("".concat(path, "/").concat(name));
+            }
+            else if (nodes[i].type === QAppNodeType.APP) {
+                var result = this.searchAppTreeForPath(nodes[i].children, name, appNodeType, depth + 1, "".concat(path, "/").concat(nodes[i].name));
+                if (result !== null) {
+                    return (result);
+                }
+            }
+        }
+        return (null);
+    };
+    return QInstance;
+}());
+export { QInstance };
+//# sourceMappingURL=QInstance.js.map

package/lib/model/metaData/QInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QInstance.js","sourceRoot":"","sources":["../../../src/model/metaData/QInstance.ts"],"names":[],"mappings":"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"}

package/lib/model/metaData/QJoinMetaData.d.ts

@@ -0,0 +1,11 @@
+/*******************************************************************************
+ ** Meta-Data that defines a Join in a QQQ Instance
+ **
+ *******************************************************************************/
+export declare class QJoinMetaData {
+    name: string;
+    type: "ONE_TO_ONE" | "ONE_TO_MANY" | "MANY_TO_ONE";
+    leftTable: string;
+    rightTable: string;
+    constructor(object: any);
+}

package/lib/model/metaData/QJoinMetaData.js

@@ -0,0 +1,35 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/*******************************************************************************
+ ** Meta-Data that defines a Join in a QQQ Instance
+ **
+ *******************************************************************************/
+var QJoinMetaData = /** @class */ (function () {
+    function QJoinMetaData(object) {
+        this.name = object.name;
+        this.type = object.type;
+        this.leftTable = object.leftTable;
+        this.rightTable = object.rightTable;
+    }
+    return QJoinMetaData;
+}());
+export { QJoinMetaData };
+//# sourceMappingURL=QJoinMetaData.js.map

package/lib/model/metaData/QJoinMetaData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QJoinMetaData.js","sourceRoot":"","sources":["../../../src/model/metaData/QJoinMetaData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;iFAGiF;AACjF;IAOG,uBAAY,MAAW;QAEpB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,CAAC;IACJ,oBAAC;AAAD,CAAC,AAdD,IAcC"}

package/lib/model/metaData/QProcessMetaData.d.ts

@@ -0,0 +1,18 @@
+import { QFrontendStepMetaData } from "./QFrontendStepMetaData";
+/*******************************************************************************
+ ** Meta-Data to define a process in a QQQ instance.
+ **
+ *******************************************************************************/
+export declare class QProcessMetaData {
+    name: string;
+    label: string;
+    tableName: string;
+    isHidden: boolean;
+    iconName?: string;
+    frontendSteps?: QFrontendStepMetaData[];
+    hasPermission: boolean;
+    stepFlow: string;
+    minInputRecords?: number;
+    maxInputRecords?: number;
+    constructor(object: any);
+}