@shapediver/viewer.session-engine.session-engine 1.15.6 → 2.0.1

package/src/implementation/dto/Parameter.ts

@@ -0,0 +1,340 @@
+import { ShapeDiverResponseParameterStructure, ShapeDiverResponseParameterGroup, ShapeDiverResponseParameter } from "@shapediver/api.geometry-api-dto-v2";
+import { Converter, InputValidator, Logger, LOGGING_TOPIC, ShapeDiverBackendError, ShapeDiverViewerError, ShapeDiverViewerSessionError } from "@shapediver/viewer.shared.services";
+import { container } from "tsyringe";
+import { IParameter } from "../../interfaces/dto/IParameter";
+import { ISessionEngine, PARAMETER_TYPE, PARAMETER_VISUALIZATION } from "../../interfaces/ISessionEngine";
+import * as MimeTypeUtils from "@shapediver/viewer.utils.mime-type"
+import { SessionEngine } from "../SessionEngine";
+
+export class Parameter<T> implements IParameter<T> {
+    // #region Properties (24)
+
+    readonly #choices?: string[];
+    readonly #converter: Converter = <Converter>container.resolve(Converter);
+    readonly #decimalplaces?: number;
+    readonly #defaultValue: T | string;
+    readonly #defval: string;
+    readonly #expression?: string;
+    readonly #format?: string[];
+    readonly #group?: ShapeDiverResponseParameterGroup;
+    readonly #id: string;
+    readonly #inputValidator: InputValidator = <InputValidator>container.resolve(InputValidator);
+    readonly #logger: Logger = <Logger>container.resolve(Logger);
+    readonly #max?: number;
+    readonly #min?: number;
+    readonly #name: string;
+    readonly #sessionEngine: SessionEngine;
+    readonly #structure?: ShapeDiverResponseParameterStructure;
+    readonly #type: PARAMETER_TYPE;
+    readonly #visualization?: PARAMETER_VISUALIZATION;
+
+    #displayname?: string;
+    #hidden: boolean = false;
+    #lastValidatedValue: T | string;
+    #order?: number;
+    #sessionValue: T | string;
+    #tooltip?: string;
+    #value: T | string;
+
+    // #endregion Properties (24)
+
+    // #region Constructors (1)
+
+    constructor(paramDef: ShapeDiverResponseParameter, sessionEngine: SessionEngine) {
+        this.#sessionEngine = sessionEngine;
+
+        this.#id = paramDef.id;
+        this.#defval = paramDef.defval;
+        this.#name = paramDef.name;
+        this.#type = <PARAMETER_TYPE>paramDef.type;
+        if (paramDef.choices !== undefined) this.#choices = paramDef.choices;
+        if (paramDef.decimalplaces !== undefined) this.#decimalplaces = +paramDef.decimalplaces;
+        if (paramDef.expression !== undefined) this.#expression = paramDef.expression;
+
+        if (paramDef.format !== undefined)
+            this.#format = MimeTypeUtils.extendMimeTypes(paramDef.format);
+
+        if (paramDef.min !== undefined) this.#min = +paramDef.min;
+        if (paramDef.max !== undefined) this.#max = +paramDef.max;
+        if (paramDef.visualization !== undefined) this.#visualization = <PARAMETER_VISUALIZATION>paramDef.visualization;
+        if (paramDef.structure !== undefined) this.#structure = paramDef.structure;
+        if (paramDef.group !== undefined) this.#group = paramDef.group;
+        if (paramDef.tooltip !== undefined) this.#tooltip = paramDef.tooltip;
+
+        if (paramDef.displayname !== undefined) this.#displayname = paramDef.displayname;
+        if (paramDef.order !== undefined) this.#order = paramDef.order;
+        if (paramDef.hidden !== undefined) this.#hidden = paramDef.hidden;
+
+        if (this.#type === PARAMETER_TYPE.BOOL) {
+            this.#defaultValue = <T><unknown>(this.#defval === 'true');
+        } else if (this.#type === PARAMETER_TYPE.EVEN || this.#type === PARAMETER_TYPE.FLOAT || this.#type === PARAMETER_TYPE.INT || this.#type === PARAMETER_TYPE.ODD) {
+            this.#defaultValue = <T><unknown>+this.#defval;
+        } else {
+            this.#defaultValue = this.#defval;
+        }
+
+        if (this.#type === PARAMETER_TYPE.COLOR) {
+            (<any>this).convertColor = (color: any): string => {
+                return this.#converter.toColor(color);
+            }
+        }
+
+        this.#value = this.#defaultValue;
+        this.#sessionValue = this.#value;
+        this.#lastValidatedValue = this.#value;
+    }
+
+    // #endregion Constructors (1)
+
+    // #region Public Accessors (26)
+
+    public get choices(): string[] | undefined {
+        return this.#choices;
+    }
+
+    public get decimalplaces(): number | undefined {
+        return this.#decimalplaces;
+    }
+
+    public get defval(): string {
+        return this.#defval;
+    }
+
+    public get displayname(): string | undefined {
+        return this.#displayname;
+    }
+
+    public set displayname(value: string | undefined) {
+        this.#displayname = value;
+    }
+
+    public get expression(): string | undefined {
+        return this.#expression;
+    }
+
+    public get format(): string[] | undefined {
+        return this.#format;
+    }
+
+    public get group(): ShapeDiverResponseParameterGroup | undefined {
+        return this.#group;
+    }
+
+    public get hidden(): boolean {
+        return this.#hidden;
+    }
+
+    public set hidden(value: boolean) {
+        this.#hidden = value;
+    }
+
+    public get id(): string {
+        return this.#id;
+    }
+
+    public get lastValidatedValue(): T | string {
+        return this.#lastValidatedValue;
+    }
+
+    public get max(): number | undefined {
+        return this.#max;
+    }
+
+    public get min(): number | undefined {
+        return this.#min;
+    }
+
+    public get name(): string {
+        return this.#name;
+    }
+
+    public get order(): number | undefined {
+        return this.#order;
+    }
+
+    public set order(value: number | undefined) {
+        this.#order = value;
+    }
+
+    public get sessionValue(): T | string {
+        return this.#sessionValue;
+    }
+
+    public set sessionValue(value: T | string) {
+        this.#sessionValue = value;
+    }
+
+    public get structure(): ShapeDiverResponseParameterStructure | undefined {
+        return this.#structure;
+    }
+
+    public get tooltip(): string | undefined {
+        return this.#tooltip;
+    }
+
+    public set tooltip(value: string | undefined) {
+        this.#tooltip = value;
+    }
+
+    public get type(): PARAMETER_TYPE {
+        return this.#type;
+    }
+
+    public get value(): T | string {
+        return this.#value;
+    }
+
+    public set value(value: T | string) {
+        this.#value = value;
+        if(this.#sessionEngine.customizeOnParameterChange) this.#sessionEngine.customize();
+    }
+
+    public get visualization(): PARAMETER_VISUALIZATION | undefined {
+        return this.#visualization;
+    }
+
+    // #endregion Public Accessors (26)
+
+    // #region Public Methods (4)
+
+    public isValid(value: any): boolean {
+        switch (true) {
+            case this.type === PARAMETER_TYPE.BOOL:
+                if (typeof value === 'string') {
+                    if (!(value === 'true' || value === 'false')) {
+                        const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${value} is a string that is neither true or false.`);
+                        throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                    }
+                } else {
+                    this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, value, 'boolean');
+                }
+                break;
+            case this.type === PARAMETER_TYPE.COLOR:
+                this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, value, 'color');
+                break;
+            case this.type === PARAMETER_TYPE.FILE:
+                this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, value, 'file');
+                break;
+            case this.type === PARAMETER_TYPE.EVEN || this.type === PARAMETER_TYPE.FLOAT || this.type === PARAMETER_TYPE.INT || this.type === PARAMETER_TYPE.ODD:
+                let temp: number = value;
+                if (typeof value === 'string')
+                    temp = +value;
+                this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, temp, 'number');
+                if (this.type === PARAMETER_TYPE.EVEN) {
+                    if (temp % 2 !== 0) {
+                        const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${value} is not even.`);
+                        throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                    }
+                } else if (this.type === PARAMETER_TYPE.ODD) {
+                    if (temp % 2 === 0) {
+                        const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${value} is not odd.`);
+                        throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                    }
+                } else if (this.type === PARAMETER_TYPE.INT) {
+                    if (!Number.isInteger(temp)) {
+                        const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${value} is not an integer.`);
+                        throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                    }
+                }
+                if (this.min || this.min === 0)
+                    if (temp < this.min) {
+                        const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${value} is smaller than the minimum ${this.min}.`);
+                        throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                    }
+
+                if (this.max || this.max === 0)
+                    if (temp > this.max) {
+                        const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${value} is larger than the maximum ${this.max}.`);
+                        throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                    }
+
+                if (this.decimalplaces || this.decimalplaces === 0) {
+                    const numStr = temp + '';
+                    let decimalplaces = 0;
+                    if (numStr.includes('.'))
+                        decimalplaces = numStr.split('.')[1].length;
+                    if (this.decimalplaces < decimalplaces) {
+                        const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${value} has not the correct number of decimalplaces (${this.decimalplaces}).`);
+                        throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                    }
+                }
+
+                break;
+            case this.type === PARAMETER_TYPE.STRINGLIST:
+                this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, value, 'string');
+                const choicesChecker = (v: string) => {
+                    // has to be a single value that is
+                    // 1. convertible to number
+                    // 2. between 0 and choices.length -1
+                    const temp = +v;
+                    this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, temp, 'number');
+                    if (temp < 0 || temp > this.choices!.length - 1) {
+                        const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${v} is not within the range of the defined number choices.`);
+                        throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                    }
+                }
+
+                if (this.visualization === PARAMETER_VISUALIZATION.CHECKLIST) {
+                    // comma separated numbers
+                    if (value.includes(',')) {
+                        const values: string[] = value.split(',');
+                        for (let i = 0; i < values.length; i++) {
+                            if (values.filter(item => item === values[i]).length !== 1) {
+                                const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).isValid: The value ${values[i]} exists multiple times, but should only exist once.`);
+                                throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error, false);
+                            }
+                            choicesChecker(values[i]);
+                        }
+                    } else {
+                        // to number
+                        let temp: number = value;
+                        if (typeof value === 'string')
+                            temp = +value;
+                        this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, temp, 'number');
+                        choicesChecker(value);
+                    }
+                } else {
+                    // to number
+                    let temp: number = value;
+                    if (typeof value === 'string')
+                        temp = +value;
+                    this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, temp, 'number');
+                    choicesChecker(value);
+                }
+                break;
+            default:
+                this.#inputValidator.validateAndError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.#id}).isValid`, value, 'string');
+                break;
+        }
+        return true;
+    }
+
+    public resetToDefaultValue() {
+        this.#value = this.#defaultValue;
+    }
+
+    public resetToSessionValue() {
+        this.#value = this.sessionValue;
+    }
+
+    public stringify(): string {
+        switch (true) {
+            case this.type === PARAMETER_TYPE.BOOL:
+                return typeof this.value === 'string' ? this.value : (<boolean><unknown>this.value) + '';
+            case this.type === PARAMETER_TYPE.COLOR:
+                return this.#converter.toHex8Color(this.value);
+            case this.type === PARAMETER_TYPE.FILE:
+                if (typeof this.value !== 'string') {
+                    const error = new ShapeDiverViewerSessionError(`Parameter(${this.#id}).stringify: Error in stringify. Cannot stringify FileParameter that has not been uploaded yet.`);
+                    throw this.#logger.handleError(LOGGING_TOPIC.PARAMETER, `Parameter(${this.id}).value`, error);
+                }
+                return <string>this.value;
+            case this.type === PARAMETER_TYPE.EVEN || this.type === PARAMETER_TYPE.FLOAT || this.type === PARAMETER_TYPE.INT || this.type === PARAMETER_TYPE.ODD:
+                return typeof this.value === 'string' ? this.value : (<number><unknown>this.value) + '';
+            default:
+                return <string>this.value;
+        }
+    }
+
+    // #endregion Public Methods (4)
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+import { SessionEngine } from './implementation/SessionEngine'
+import { ISessionEngine, PARAMETER_TYPE, PARAMETER_VISUALIZATION } from './interfaces/ISessionEngine'
+import { SessionOutputData } from './implementation/SessionOutputData'
+import { SessionData } from './implementation/SessionData'
+import { ISessionData } from './interfaces/ISessionData'
+import { ISessionOutputData } from './interfaces/ISessionOutputData'
+import { Export } from './implementation/dto/Export'
+import { FileParameter } from './implementation/dto/FileParameter'
+import { Output } from './implementation/dto/Output'
+import { Parameter } from './implementation/dto/Parameter'
+import { IExport } from './interfaces/dto/IExport'
+import { IFileParameter } from './interfaces/dto/IFileParameter'
+import { IOutput, ShapeDiverResponseOutputChunk, ShapeDiverResponseOutputContent } from './interfaces/dto/IOutput'
+import { IParameter } from './interfaces/dto/IParameter'
+
+export {
+  ISessionData, SessionData, ISessionOutputData, SessionOutputData
+}
+
+export {
+  ISessionEngine, SessionEngine, IOutput, Output, IParameter, Parameter, IFileParameter, FileParameter, IExport, Export, ShapeDiverResponseOutputContent, ShapeDiverResponseOutputChunk
+}
+
+export {
+  PARAMETER_TYPE, PARAMETER_VISUALIZATION
+}

package/src/interfaces/ISessionData.ts

@@ -0,0 +1,16 @@
+import { ShapeDiverResponseDto } from "@shapediver/sdk.geometry-api-sdk-v2";
+import { ITreeNodeData } from "@shapediver/viewer.shared.node-tree";
+
+export interface ISessionData extends ITreeNodeData {
+    // #region Properties (1)
+
+    responseDto: ShapeDiverResponseDto;
+
+    // #endregion Properties (1)
+
+    // #region Public Methods (1)
+
+    clone(): ISessionData;
+
+    // #endregion Public Methods (1)
+}

package/src/interfaces/ISessionEngine.ts

@@ -0,0 +1,123 @@
+import { ShapeDiverRequestGltfUploadQueryConversion, ShapeDiverResponseDto, ShapeDiverResponseExport, ShapeDiverResponseOutput, ShapeDiverResponseParameter } from '@shapediver/sdk.geometry-api-sdk-v2';
+import { ITreeNode, TreeNode } from '@shapediver/viewer.shared.node-tree'
+import { SettingsEngine } from '@shapediver/viewer.shared.services';
+import { IExport } from './dto/IExport';
+import { IOutput } from './dto/IOutput';
+import { IParameter } from './dto/IParameter';
+
+/**
+ * The type of the parameter.
+ */
+export enum PARAMETER_TYPE {
+  FLOAT = 'Float',
+  INT = 'Int',
+  EVEN = 'Even',
+  ODD = 'Odd',
+  STRING = 'String',
+  COLOR = 'Color',
+  STRINGLIST = 'StringList',
+  BOOL = 'Bool',
+  TIME = 'Time',
+  FILE = 'File',
+  SNUMBER = 'sNumber',
+  SINTEGER = 'sInteger',
+  SSTRING = 'sString',
+  SCOLOR = 'sColor',
+  SBOOL = 'sBool',
+  STIME = 'sTime',
+  SBITMAP = 'sBitmap',
+  SDOMAIN = 'sDomain',
+  SDOMAIN2D = 'sDomain2D',
+  SPOINT = 'sPoint',
+  SLINE = 'sLine',
+  SVECTOR = 'sVector',
+  SBOX = 'sBox',
+  SPLANE = 'sPlane',
+  SRECTANGLE = 'sRectangle',
+  SCURVE = 'sCurve',
+  SCIRCLE = 'sCircle',
+  SMESH = 'sMesh',
+  SSURFACE = 'sSurface',
+  SBREP = 'sBrep',
+  SSUBDIV = 'sSubdiv'
+}
+
+/**
+ * Type of visualization which should be used for UI elements representing the parameter.
+ */
+export enum PARAMETER_VISUALIZATION {
+  SLIDER = 'slider',
+  SEQUENCE = 'sequence',
+  CYCLE = 'cycle',
+  DROPDOWN = 'dropdown',
+  CHECKLIST = 'checklist',
+  CLOCK = 'color',
+  CALENDAR = 'calendar',
+  TOGGLE = 'toggle',
+  SWATCH = 'swatch',
+  BUTTON = 'button',
+  DIAL = 'dial',
+  TEXT = 'text'
+}
+export interface ISessionEngine {
+  // #region Properties (11)
+
+  bearerToken?: string;
+  canUploadGLTF: boolean;
+  exports: { [key: string]: IExport };
+  id: string;
+  initialized: boolean;
+  modelViewUrl: string;
+  outputs: { [key: string]: IOutput };
+  parameters: { [key: string]: IParameter<any> };
+  refreshBearerToken: (() => Promise<string>) | undefined;
+  settingsEngine: SettingsEngine;
+  ticket: string;
+  updateCallback: ((newNode: ITreeNode, oldNode: ITreeNode) => void) | null;
+
+  // #endregion Properties (11)
+
+  // #region Public Methods (18)
+
+  applySettings(response: ShapeDiverResponseDto, sections?: {
+    session?: {
+      parameter?: {
+        displayname?: boolean,
+        order?: boolean,
+        hidden?: boolean,
+        value?: boolean
+      },
+      export?: {
+        displayname?: boolean,
+        order?: boolean,
+        hidden?: boolean
+      }
+    },
+    viewport?: {
+      scene?: boolean,
+      camera?: boolean,
+      light?: boolean,
+      environment?: boolean
+    }
+  }): void;
+  canGoBack(): boolean;
+  canGoForward(): boolean;
+  close(): Promise<void>;
+  customize(): Promise<ITreeNode>;
+  customizeParallel(parameterValues: { [key: string]: string }): Promise<ITreeNode>;
+  goBack(): Promise<ITreeNode>;
+  goForward(): Promise<ITreeNode>;
+  init(parameterValues?: {
+    [key: string]: string;
+  }): Promise<void>;
+  loadOutputs(cancelRequest: () => boolean): Promise<ITreeNode>;
+  requestExport(exportId: string, parameters: { [key: string]: string }, maxWaitTime: number): Promise<ShapeDiverResponseExport>;
+  saveDefaultParameterValues(): Promise<boolean>;
+  saveSettings(viewportId?: string): Promise<boolean>;
+  saveUiProperties(): Promise<boolean>;
+  updateOutputs(): Promise<ITreeNode>;
+  uploadFile(parameterId: string, data: File, type: string): Promise<string>;
+  uploadGLTF(blob: Blob, conversion?: ShapeDiverRequestGltfUploadQueryConversion): Promise<string>;
+
+  // #endregion Public Methods (18)
+}

package/src/interfaces/ISessionOutputData.ts

@@ -0,0 +1,16 @@
+import { ShapeDiverResponseOutput } from "@shapediver/sdk.geometry-api-sdk-v2";
+import { ITreeNodeData } from "@shapediver/viewer.shared.node-tree";
+
+export interface ISessionOutputData extends ITreeNodeData {
+    // #region Properties (1)
+
+    responseOutput: ShapeDiverResponseOutput
+
+    // #endregion Properties (1)
+
+    // #region Public Methods (1)
+
+    clone(): ISessionOutputData;
+
+    // #endregion Public Methods (1)
+}

package/src/interfaces/ISessionTreeNode.ts

@@ -0,0 +1,9 @@
+import { ITreeNode } from "@shapediver/viewer.shared.node-tree";
+
+export interface ISessionTreeNode extends ITreeNode {
+    // #region Properties (1)
+
+    readonly sessionNode: boolean;
+
+    // #endregion Properties (1)
+}

package/src/interfaces/dto/IExport.ts

@@ -0,0 +1,17 @@
+import { ShapeDiverResponseExport } from "@shapediver/sdk.geometry-api-sdk-v2";
+
+export interface IExport extends ShapeDiverResponseExport {
+    // #region Properties (1)
+
+    maxWaitTime: number;
+
+    // #endregion Properties (1)
+
+    // #region Public Methods (2)
+
+    request(parameters?: { [key: string]: string }): Promise<ShapeDiverResponseExport>;
+    updateExport(): void;
+    updateExportDefinition(exportDef: ShapeDiverResponseExport): void;
+
+    // #endregion Public Methods (2)
+}

package/src/interfaces/dto/IFileParameter.ts

@@ -0,0 +1,9 @@
+import { IParameter } from './IParameter'
+
+export interface IFileParameter extends IParameter<File | Blob | string> {
+    // #region Public Methods (1)
+
+    upload(): Promise<string>;
+
+    // #endregion Public Methods (1)
+}

package/src/interfaces/dto/IOutput.ts

@@ -0,0 +1,45 @@
+import { ShapeDiverResponseOutput, ShapeDiverResponseOutputContent as ShapeDiverResponseOutputContentBackend, ShapeDiverResponseOutputChunk as ShapeDiverResponseOutputChunkBackend } from '@shapediver/sdk.geometry-api-sdk-v2';
+import { IAnchor, IMaterialContentData, IMaterialContentDataV1, IMaterialContentDataV2, IMaterialContentDataV3, ITag2D, ITag3D } from '@shapediver/viewer.data-engine.shared-types';
+import { ITreeNode } from '@shapediver/viewer.shared.node-tree';
+
+/**
+ * Extension of the ShapeDiverResponseOutputContent as the viewer already creates types for them
+ */
+export interface ShapeDiverResponseOutputContent extends ShapeDiverResponseOutputContentBackend {
+    // #region Properties (1)
+
+    data?: ITag2D[] | ITag3D[] | IAnchor[] | IMaterialContentData | IMaterialContentDataV1 | IMaterialContentDataV2 | IMaterialContentDataV3 | any;
+
+    // #endregion Properties (1)
+}
+
+/**
+ * Extension of the ShapeDiverResponseOutputChunk with a node
+ */
+export interface ShapeDiverResponseOutputChunk extends ShapeDiverResponseOutputChunkBackend {
+    // #region Properties (1)
+
+    node?: ITreeNode;
+
+    // #endregion Properties (1)
+}
+
+export interface IOutput extends ShapeDiverResponseOutput {
+    // #region Properties (3)
+
+    readonly node?: ITreeNode;
+
+    format: string[];
+    freeze: boolean;
+    updateCallback: ((newNode?: ITreeNode, oldNode?: ITreeNode) => void) | null;
+
+    // #endregion Properties (3)
+
+    // #region Public Methods (1)
+    
+    updateOutput(newNode?: ITreeNode, oldNode?: ITreeNode): void;
+    updateOutputContent(content: ShapeDiverResponseOutputContent[], preventUpdate?: boolean): Promise<ITreeNode | undefined>;
+    updateOutputDefinition(outputDef: ShapeDiverResponseOutput): void;
+
+    // #endregion Public Methods (1)
+}

package/src/interfaces/dto/IParameter.ts

@@ -0,0 +1,19 @@
+import { ShapeDiverResponseParameter } from "@shapediver/sdk.geometry-api-sdk-v2";
+
+export interface IParameter<T> extends ShapeDiverResponseParameter {
+    // #region Properties (2)
+
+    sessionValue: T | string;
+    value: T | string;
+
+    // #endregion Properties (2)
+
+    // #region Public Methods (4)
+
+    isValid(value: any, throwError?: boolean): boolean;
+    resetToDefaultValue(): void;
+    resetToSessionValue(): void;
+    stringify(): string;
+
+    // #endregion Public Methods (4)
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+    "extends": "../../tsconfig.json",
+    "include": [
+        "./**/*.ts"
+    ],
+    "compilerOptions": {
+        "rootDir": "src",
+        "outDir": "dist"
+    },
+    "exclude": [
+        "__tests__",
+        "node_modules",
+        "dist",
+        "dist-dev",
+        "dist-prod"
+    ]
+}

package/dist/implementation/Session.d.ts.map

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