@gisatcz/ptr-be-core 0.0.1-dev.1

package/dist/src/coding/code.formating.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Check if the value in included in enum posibilities.
+ * @param value Value we need to check
+ * @param enumEntity Enum type we check againts the value
+ * @returns Is the value in this enum?
+ */
+export declare const isInEnum: (value: any, enumEntity: any) => boolean;
+/**
+ * Sort array of string elements
+ * @param rawArray Raw unsorted array of elements
+ * @returns Sorted string array
+ */
+export declare const sortStringArray: (rawArray: string[]) => string[];
+/**
+ * Remove all duplicity string items from an array
+ * @param arr Original array with duplicities
+ * @returns Array of original values
+ */
+export declare const removeDuplicitiesFromArray: (arr: any[]) => any[];
+/**
+ * Check if the string value is not ` "" `
+ * @param value Value to check
+ * @returns Boolean result about the truth
+ */
+export declare const notEmptyString: (value: string) => boolean;
+/**
+ * Return enum values as array of string
+ * @param enumType Type of the enum from code
+ * @param separator Optional - separator character
+ * @returns Array of enum possible values
+ */
+export declare const enumValuesToString: (enumType: any, separator?: string) => string;
+/**
+ * Return enum values as array of string
+ * @param enumTypes Combination of enum types
+ * @param separator Optional - separator character
+ * @returns Array of enum possible values
+ */
+export declare const enumCombineValuesToString: (enumTypes: any[], separator?: string) => string;
+/**
+ * Return all enum values as array
+ * @param enumType What array we want to work with
+ * @returns Array of enum values
+ */
+export declare const enumValuesToArray: (enumType: any) => string[];
+/**
+ * Return random number (integer) between two values
+ * @param min
+ * @param max
+ * @returns
+ */
+export declare const randomNumberBetween: (min: number, max: number) => number;
+/**
+ * Recursively flattens a nested object. The keys of the resulting object
+ * will be the paths to the original values in the nested object, joined by dots.
+ *
+ * @param obj - The object to flatten.
+ * @param prefix - The prefix to use for the keys in the flattened object. Defaults to an empty string.
+ * @returns A new object with flattened keys.
+ *
+ * @example
+ * ```typescript
+ * const nestedObj = {
+ *   a: {
+ *     b: {
+ *       c: 1
+ *     }
+ *   },
+ *   d: 2
+ * };
+ * const flatObj = flattenObject(nestedObj);
+ * console.log(flatObj);
+ * // Output: { 'a.b.c': 1, 'a.b.d': 2 }
+ * ```
+ */
+export declare const flattenObject: (obj: any, prefix?: string) => Record<string, any>;
+//# sourceMappingURL=code.formating.d.ts.map

package/dist/src/coding/code.formating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.formating.d.ts","sourceRoot":"","sources":["../../../src/coding/code.formating.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,GAAG,EAAE,YAAY,GAAG,YAGjD,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,aAAqB,CAAA;AAEvE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,KAAK,GAAG,EAAE,UAAsB,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,YAAiB,CAAA;AAG7D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,GAAG,EAAE,kBAAgB,WAA4C,CAAA;AAE9G;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,WAAW,GAAG,EAAE,EAAE,kBAAgB,WAAuF,CAAA;AAEnK;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,GAAG,KAAgC,MAAM,EAAE,CAAA;AAEvF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,WAI3D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,GAAG,EAAE,eAAW,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAUvE,CAAA"}

package/dist/src/coding/code.types.d.ts

@@ -0,0 +1,6 @@
+type Nullable<T> = T | null;
+type Unsure<T> = T | undefined;
+type Nullish<T> = T | undefined | null;
+type UsurePromise<T> = Unsure<Promise<T>>;
+export { Nullable, Nullish, Unsure, UsurePromise };
+//# sourceMappingURL=code.types.d.ts.map

package/dist/src/coding/code.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.types.d.ts","sourceRoot":"","sources":["../../../src/coding/code.types.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAC3B,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAA;AAC9B,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAA;AACtC,KAAK,YAAY,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAEzC,OAAO,EACH,QAAQ,EACR,OAAO,EACP,MAAM,EACN,YAAY,EACf,CAAA"}

package/dist/src/logging/logger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @typedef {Object} AppLogOptions
+ * @property {string} label       - The label for the log entry.
+ * @property {string|number|boolean} [key] - Any extra fields.
+ */
+export type AppLogOptions = {
+    label: string;
+    [key: string]: string | number | boolean;
+};
+export declare class AppLogger {
+    static info(message: string, options?: AppLogOptions): void;
+    static warn(message: string, options?: AppLogOptions): void;
+    static error(message: string, options?: AppLogOptions): void;
+    static appStart(host: string, port: number, options?: AppLogOptions): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logging/logger.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAC,MAAM,GAAC,OAAO,CAAA;CACrC,CAAA;AAgBD,qBAAa,SAAS;IACpB,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAmC;IAK9C,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAmC;IAK9C,MAAM,CAAC,KAAK,CACV,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAmC;IAK9C,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAmC;CAI/C"}

package/dist/src/panther/enums.panther.d.ts

@@ -0,0 +1,40 @@
+/**
+ * What types of graph nodes we use in metadata model
+ */
+export declare enum UsedNodeLabels {
+    Application = "application",// Application node (the root of the FE app)
+    Datasource = "datasource",// Datasource node for data including GIS information
+    Place = "place",// Place node for geographical information
+    Period = "period",// Period node for time information
+    AreaTree = "areaTree",// Area tree node for administrative division
+    AreaTreeLevel = "areaTreeLevel",// Area tree level node for administrative division
+    Layer = "layer",// Layer node for map layer (layer have a style and a datasource)
+    Style = "style",// Style node for map layer or a feature
+    Feature = "feature"
+}
+/**
+ * What datasources we use in the system
+ */
+export declare enum UsedDatasourceLabels {
+    Attribute = "attribute",// Column(s) with attribute values
+    Geojson = "geojson",// Geojson for web map
+    WMS = "wms",// WMS online source
+    COG = "cogBitmap",// COG online source
+    MVT = "mvt",// MVT (Mapbox Vector Tiles) source
+    XYZ = "xyz",// XYZ tile source
+    CSV = "csv",// CSV data source
+    GeoTIFF = "geotiff",// GeoTIFF raster data
+    Shapefile = "shapefile",// ESRI Shapefile format
+    PostGIS = "postgis",// PostGIS database source
+    WMTS = "wmts",// Web Map Tile Service
+    WFS = "wfs",// Web Feature Service
+    GeoPackage = "geopackage"
+}
+/**
+ * What types of edges we use in metadata model
+ */
+export declare enum UsedEdgeLabels {
+    RelatedTo = "RELATED",// Generic edge for any relation
+    Has = "HAS"
+}
+//# sourceMappingURL=enums.panther.d.ts.map

package/dist/src/panther/enums.panther.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.panther.d.ts","sourceRoot":"","sources":["../../../src/panther/enums.panther.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,cAAc;IACtB,WAAW,gBAAgB,CAAE,4CAA4C;IACzE,UAAU,eAAe,CAAE,qDAAqD;IAChF,KAAK,UAAU,CAAE,0CAA0C;IAC3D,MAAM,WAAW,CAAE,mCAAmC;IACtD,QAAQ,aAAa,CAAE,6CAA6C;IACpE,aAAa,kBAAkB,CAAE,mDAAmD;IACpF,KAAK,UAAU,CAAE,iEAAiE;IAClF,KAAK,UAAU,CAAE,wCAAwC;IACzD,OAAO,YAAY;CACtB;AAED;;GAEG;AACH,oBAAY,oBAAoB;IAC5B,SAAS,cAAc,CAAI,kCAAkC;IAC7D,OAAO,YAAY,CAAO,sBAAsB;IAChD,GAAG,QAAQ,CAAe,oBAAoB;IAC9C,GAAG,cAAc,CAAS,oBAAoB;IAC9C,GAAG,QAAQ,CAAe,mCAAmC;IAC7D,GAAG,QAAQ,CAAe,kBAAkB;IAC5C,GAAG,QAAQ,CAAe,kBAAkB;IAC5C,OAAO,YAAY,CAAO,sBAAsB;IAChD,SAAS,cAAc,CAAI,wBAAwB;IACnD,OAAO,YAAY,CAAO,0BAA0B;IACpD,IAAI,SAAS,CAAa,uBAAuB;IACjD,GAAG,QAAQ,CAAe,sBAAsB;IAChD,UAAU,eAAe;CAC5B;AAED;;GAEG;AACH,oBAAY,cAAc;IACtB,SAAS,YAAY,CAAE,gCAAgC;IACvD,GAAG,QAAQ;CACd"}

package/dist/src/panther/models.edges.d.ts

@@ -0,0 +1,18 @@
+import { Nullable } from "../coding/code.types";
+import { UsedEdgeLabels } from "./enums.panther";
+/**
+ * Tuple for relation between two graph nodes
+ * It is point to point definition of graph edge
+ */
+export type GraphRelation = [string, string];
+/**
+ * Edge of the graph model.
+ * It connects two graph nodes and have some properties.
+ * Have "key" witch is composed from node keys.
+ */
+export interface GraphEdge {
+    labels: string[] | UsedEdgeLabels[];
+    edgeNodes: GraphRelation;
+    properties: Nullable<object>;
+}
+//# sourceMappingURL=models.edges.d.ts.map

package/dist/src/panther/models.edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.edges.d.ts","sourceRoot":"","sources":["../../../src/panther/models.edges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAG5C;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IACpC,SAAS,EAAE,aAAa,CAAA;IACxB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAC/B"}

package/dist/src/panther/models.nodes.d.ts

@@ -0,0 +1,53 @@
+import { Nullable } from "../coding/code.types";
+import { HasGeometry, HasInterval, HasLevels, HasConfiguration } from "./models.nodes.properties";
+import { UsedNodeLabels, UsedDatasourceLabels } from "./enums.panther";
+/**
+ * General graph node - same for all metadatata entities
+ */
+export interface PantherEntity {
+    labels: Array<string | UsedNodeLabels | UsedDatasourceLabels>;
+    key: string;
+    nameDisplay: string;
+    nameInternal: string;
+    description: Nullable<string>;
+    lastUpdatedAt: number;
+}
+/**
+ * Place node - somewhere in the world
+ */
+export interface Place extends PantherEntity, HasGeometry {
+}
+/**
+ * Period node - selected time in timeline
+ */
+export interface Period extends PantherEntity, HasInterval {
+}
+/**
+ * Area tree node - tree of areas
+ */
+export interface AreaTreeLevel extends PantherEntity, HasLevels {
+}
+/**
+ * Datasource with source configuration
+ */
+export interface Datasource extends PantherEntity, HasConfiguration {
+}
+/**
+ * Application node - main entity in metadata model
+ */
+export interface ApplicationNode extends PantherEntity, HasConfiguration {
+}
+export { UsedNodeLabels, HasInterval, UsedDatasourceLabels };
+/**
+ * Represents a full panther entity which extends the basic PantherEntity
+ * and optionally includes geometry, interval, levels, and configuration properties.
+ *
+ * @extends PantherEntity
+ * @extends Partial<HasGeometry>
+ * @extends Partial<HasInterval>
+ * @extends Partial<HasLevels>
+ * @extends Partial<HasConfiguration>
+ */
+export interface FullPantherEntity extends PantherEntity, Partial<HasGeometry & HasInterval & HasLevels & HasConfiguration> {
+}
+//# sourceMappingURL=models.nodes.d.ts.map

package/dist/src/panther/models.nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.nodes.d.ts","sourceRoot":"","sources":["../../../src/panther/models.nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjG,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,cAAc,GAAG,oBAAoB,CAAC,CAAC;IAC9D,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,aAAa,EAAE,WAAW;CAAI;AAE7D;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,aAAa,EAAE,WAAW;CAAI;AAE9D;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,aAAa,EAAE,SAAS;CAAG;AAElE;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,aAAa,EAAE,gBAAgB;CAAG;AAEtE;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,aAAa,EAAE,gBAAgB;CAAG;AAE3E,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAG5D;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa,EAAE,OAAO,CAAC,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,gBAAgB,CAAC;CAAI"}

package/dist/src/panther/models.nodes.properties.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Entity that has relevant time interval.
+ * Example: Period is connected to some time range.
+ */
+export interface HasInterval {
+    validUtcIntervalIso: string;
+    validFrom: number;
+    validTo: number;
+}
+/**
+ * Entity with custom configuration
+ */
+export interface HasConfiguration {
+    configuration: string;
+}
+/**
+ * Place node - somewhere in the world
+ */
+export interface HasGeometry {
+    geometry: any;
+    bbox: any;
+}
+/**
+ * Place node - somewhere in the world
+ */
+export interface HasLevels {
+    level: number;
+}
+//# sourceMappingURL=models.nodes.properties.d.ts.map

package/dist/src/panther/models.nodes.properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.nodes.properties.d.ts","sourceRoot":"","sources":["../../../src/panther/models.nodes.properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,aAAa,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,GAAG,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB"}

package/doc/npm-refresh.md

@@ -0,0 +1,4 @@
+
+
+npm install lodash luxon pino pino-pretty
+npm install --save-dev @types/lodash @types/luxon @types/node barrelsby ts-node tsc-alias tsconfig-paths tsx typescript

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@gisatcz/ptr-be-core",
+  "version": "0.0.1-dev.1",
+  "description": "Testing the core",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build:clean": "rm -rf dist .rollup.cache tsconfig.tsbuildinfo",
+    "build:barrels": "barrelsby -c barrelsby.json",
+    "build:rollup": "rollup -c",
+    "build": "npm run build:clean && npm run build:barrels && npm run build:rollup"
+  },
+  "author": "",
+  "license": "ISC",
+  "peerDependencies": {
+    "lodash": "^4.17.21",
+    "luxon": "^3.6.1",
+    "pino": "^9.6.0",
+    "pino-pretty": "^13.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/lodash": "^4.17.16",
+    "@types/luxon": "^3.6.2",
+    "@types/node": "^22.15.12",
+    "barrelsby": "^2.8.1",
+    "rollup": "^4.40.2",
+    "ts-node": "^10.9.2",
+    "tsc-alias": "^1.8.16",
+    "tsconfig-paths": "^4.2.0",
+    "tslib": "^2.8.1",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  }
+}

package/rollup.config.js

@@ -0,0 +1,30 @@
+import json from '@rollup/plugin-json';
+import resolve from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import typescript from '@rollup/plugin-typescript';
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url); // Creates a require function
+const pkg = require('./package.json'); // Loads package.json for configuration
+const extensions = ['.js', '.jsx', '.ts', '.tsx'];
+
+export default [
+    {
+        input: 'index.ts',
+        output: [
+            {
+                file: pkg.main,
+                format: 'cjs',
+                sourcemap: true,
+            },
+            {
+                file: pkg.module,
+                format: 'es',
+                sourcemap: true,
+            }
+        ],
+        plugins: [json(), resolve({ extensions }), commonjs(), typescript({
+            tsconfig: './tsconfig.json',
+        })]
+    }
+];

package/src/coding/code.formating.ts

@@ -0,0 +1,104 @@
+import { sortBy } from "lodash"
+
+/**
+ * Check if the value in included in enum posibilities.
+ * @param value Value we need to check
+ * @param enumEntity Enum type we check againts the value
+ * @returns Is the value in this enum?
+ */
+export const isInEnum = (value: any, enumEntity: any) => {
+    const allEnumValues = Object.values(enumEntity) as string[]
+    return allEnumValues.includes(value)
+  }
+
+/**
+ * Sort array of string elements
+ * @param rawArray Raw unsorted array of elements
+ * @returns Sorted string array
+ */
+export const sortStringArray = (rawArray: string[]) => sortBy(rawArray)
+
+/**
+ * Remove all duplicity string items from an array
+ * @param arr Original array with duplicities
+ * @returns Array of original values
+ */
+export const removeDuplicitiesFromArray = (arr: any[]) => [...new Set(arr)]
+
+/**
+ * Check if the string value is not ` "" `
+ * @param value Value to check
+ * @returns Boolean result about the truth
+ */
+export const notEmptyString = (value: string) => value !== ""
+
+
+/**
+ * Return enum values as array of string
+ * @param enumType Type of the enum from code
+ * @param separator Optional - separator character
+ * @returns Array of enum possible values
+ */
+export const enumValuesToString = (enumType: any, separator = ", ") => Object.values(enumType).join(separator)
+
+/**
+ * Return enum values as array of string
+ * @param enumTypes Combination of enum types
+ * @param separator Optional - separator character
+ * @returns Array of enum possible values
+ */
+export const enumCombineValuesToString = (enumTypes: any[], separator = ", ") => enumTypes.map(enumType => enumValuesToString(enumType, separator)).join(separator)
+
+/**
+ * Return all enum values as array
+ * @param enumType What array we want to work with
+ * @returns Array of enum values
+ */
+export const enumValuesToArray = (enumType: any) => Object.values(enumType) as string[]
+
+/**
+ * Return random number (integer) between two values
+ * @param min 
+ * @param max 
+ * @returns 
+ */
+export const randomNumberBetween = (min: number, max: number) => {
+  const minAr = Math.ceil(min)
+  const maxAr = Math.floor(max)
+  return Math.floor(Math.random()*(maxAr - minAr + 1) + min)
+}
+
+/**
+ * Recursively flattens a nested object. The keys of the resulting object
+ * will be the paths to the original values in the nested object, joined by dots.
+ *
+ * @param obj - The object to flatten.
+ * @param prefix - The prefix to use for the keys in the flattened object. Defaults to an empty string.
+ * @returns A new object with flattened keys.
+ *
+ * @example
+ * ```typescript
+ * const nestedObj = {
+ *   a: {
+ *     b: {
+ *       c: 1
+ *     }
+ *   },
+ *   d: 2
+ * };
+ * const flatObj = flattenObject(nestedObj);
+ * console.log(flatObj);
+ * // Output: { 'a.b.c': 1, 'a.b.d': 2 }
+ * ```
+ */
+export const flattenObject = (obj: any, prefix = ''): Record<string, any> => {
+    return Object.keys(obj).reduce((acc: Record<string, any>, key: string) => {
+        const propName = prefix ? `${prefix}.${key}` : key
+        if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {
+            Object.assign(acc, flattenObject(obj[key], propName))
+        } else {
+            acc[propName] = obj[key]
+        }
+        return acc
+    }, {})
+}

package/src/coding/code.types.ts

@@ -0,0 +1,11 @@
+type Nullable<T> = T | null
+type Unsure<T> = T | undefined
+type Nullish<T> = T | undefined | null
+type UsurePromise<T> = Unsure<Promise<T>>
+
+export {
+    Nullable,
+    Nullish,
+    Unsure,
+    UsurePromise
+}

package/src/logging/logger.ts

@@ -0,0 +1,58 @@
+// logger.ts
+import pino, { Logger } from 'pino'
+import pretty from 'pino-pretty'
+
+/**
+ * @typedef {Object} AppLogOptions
+ * @property {string} label       - The label for the log entry.
+ * @property {string|number|boolean} [key] - Any extra fields.
+ */
+export type AppLogOptions = {
+  label: string
+  [key: string]: string|number|boolean
+}
+
+const DEFAULT_LOG_OPTIONS: AppLogOptions = {
+  label: 'App'
+}
+
+// create the pretty‐printing stream once
+const prettyStream = pretty({
+  colorize: true,
+  levelFirst: true,
+  translateTime: 'yyyy-mm-dd HH:MM:ss'
+})
+
+// create your logger once and for all
+const baseLogger: Logger = pino({}, prettyStream)
+
+export class AppLogger {
+  static info(
+    message: string,
+    options: AppLogOptions = DEFAULT_LOG_OPTIONS,
+  ) {
+    baseLogger.info({ ...options, message })
+  }
+
+  static warn(
+    message: string,
+    options: AppLogOptions = DEFAULT_LOG_OPTIONS,
+  ) {
+    baseLogger.warn({ ...options, message })
+  }
+
+  static error(
+    message: string,
+    options: AppLogOptions = DEFAULT_LOG_OPTIONS,
+  ) {
+    baseLogger.error({ ...options, message })
+  }
+
+  static appStart(
+    host: string,
+    port: number,
+    options: AppLogOptions = DEFAULT_LOG_OPTIONS,
+  ) {
+    AppLogger.info(`Application started on ${host}:${port}`, options)
+  }
+}

package/src/panther/SharedFeature.md

@@ -0,0 +1,43 @@
+# Panther Models and Logic
+Panther models are based on graph data structure. Graph structure is flat and very flexible. 
+
+## What are Graphs
+Graph can be visualiset as dots connected by lines. 
+
+Graphs have two parts: 
+- node (dot)
+- edge (line)
+
+Nodes are connected by Edges into a graph. 
+
+## Node Structure
+Node has two main parts:
+- Label(s)
+- Properties
+
+### Labels
+Label is one or more Tags that define a "category" saing "What this Node is". 
+Examples are Place, Period, Datasource etc.
+
+Combination of multiple nodes can be used as multiple-level labeling. Like `[Datasource, WMS]` is combination of two labels for single node.
+
+### Properties
+Can be anything inside the node. Can be `key`, `name` or any general property we need.
+
+## Edge Structure
+Edge is connection betwee two nodes. Can be directed (from-to). 
+
+Same as Nodes, Edge also can have:
+- Label(s)
+- Properties
+
+Works the same as in the node case. 
+
+Example of Edge Labels: `IS_RELATED`, `WAITING_FOR`, `CONTAINS`
+Example of Edge properties: `expiration`, `length`, `priority`, `created`
+
+## Resources
+Please check resorces for visual explanation and many other examples.
+
+- https://neo4j.com/docs/getting-started/graph-database/
+- https://www.mongodb.com/resources/basics/databases/mongodb-graph-database

package/src/panther/enums.panther.ts

@@ -0,0 +1,41 @@
+/**
+ * What types of graph nodes we use in metadata model
+ */
+export enum UsedNodeLabels {
+    Application = "application", // Application node (the root of the FE app)
+    Datasource = "datasource", // Datasource node for data including GIS information
+    Place = "place", // Place node for geographical information
+    Period = "period", // Period node for time information
+    AreaTree = "areaTree", // Area tree node for administrative division
+    AreaTreeLevel = "areaTreeLevel", // Area tree level node for administrative division
+    Layer = "layer", // Layer node for map layer (layer have a style and a datasource)
+    Style = "style", // Style node for map layer or a feature
+    Feature = "feature" // Feature node for map layer
+}
+
+/**
+ * What datasources we use in the system
+ */
+export enum UsedDatasourceLabels {
+    Attribute = "attribute",   // Column(s) with attribute values
+    Geojson = "geojson",      // Geojson for web map
+    WMS = "wms",              // WMS online source
+    COG = "cogBitmap",        // COG online source
+    MVT = "mvt",              // MVT (Mapbox Vector Tiles) source
+    XYZ = "xyz",              // XYZ tile source
+    CSV = "csv",              // CSV data source
+    GeoTIFF = "geotiff",      // GeoTIFF raster data
+    Shapefile = "shapefile",   // ESRI Shapefile format
+    PostGIS = "postgis",      // PostGIS database source
+    WMTS = "wmts",            // Web Map Tile Service
+    WFS = "wfs",              // Web Feature Service
+    GeoPackage = "geopackage" // OGC GeoPackage format
+}
+
+/**
+ * What types of edges we use in metadata model
+ */
+export enum UsedEdgeLabels {
+    RelatedTo = "RELATED", // Generic edge for any relation
+    Has = "HAS", // Edge for ownership relation
+}

package/src/panther/models.edges.ts

@@ -0,0 +1,20 @@
+import { Nullable } from "../coding/code.types"
+import { UsedEdgeLabels } from "./enums.panther"
+
+/**
+ * Tuple for relation between two graph nodes
+ * It is point to point definition of graph edge
+ */
+export type GraphRelation = [string, string]
+
+
+/**
+ * Edge of the graph model.
+ * It connects two graph nodes and have some properties.
+ * Have "key" witch is composed from node keys.
+ */
+export interface GraphEdge{
+    labels: string[] | UsedEdgeLabels[],
+    edgeNodes: GraphRelation
+    properties: Nullable<object>
+}

package/src/panther/models.nodes.properties.ts

@@ -0,0 +1,31 @@
+/**
+ * Entity that has relevant time interval.
+ * Example: Period is connected to some time range.
+ */
+export interface HasInterval {
+    validUtcIntervalIso: string,
+    validFrom: number,
+    validTo: number
+}
+
+/**
+ * Entity with custom configuration
+ */
+export interface HasConfiguration {
+    configuration: string // JSON string
+}
+
+/**
+ * Place node - somewhere in the world
+ */
+export interface HasGeometry {
+    geometry: any,
+    bbox: any,
+}
+
+/**
+ * Place node - somewhere in the world
+ */
+export interface HasLevels {
+    level: number,
+}