@serve.zone/platformclient 1.1.2 → 1.1.4

package/readme.md

@@ -1,31 +1,205 @@
 # @serve.zone/platformclient
-a module that makes it really easy to use the serve.zone platform inside your app
-
-## Availabililty and Links
-* [npmjs.org (npm package)](https://www.npmjs.com/package/@serve.zone/platformclient)
-* [gitlab.com (source)](https://gitlab.com/serve.zone/platformclient)
-* [github.com (source mirror)](https://github.com/serve.zone/platformclient)
-* [docs (typedoc)](https://serve.zone.gitlab.io/platformclient/)
-
-## Status for master
-
-Status Category | Status Badge
--- | --
-GitLab Pipelines | [![pipeline status](https://gitlab.com/serve.zone/platformclient/badges/master/pipeline.svg)](https://lossless.cloud)
-GitLab Pipline Test Coverage | [![coverage report](https://gitlab.com/serve.zone/platformclient/badges/master/coverage.svg)](https://lossless.cloud)
-npm | [![npm downloads per month](https://badgen.net/npm/dy/@serve.zone/platformclient)](https://lossless.cloud)
-Snyk | [![Known Vulnerabilities](https://badgen.net/snyk/serve.zone/platformclient)](https://lossless.cloud)
-TypeScript Support | [![TypeScript](https://badgen.net/badge/TypeScript/>=%203.x/blue?icon=typescript)](https://lossless.cloud)
-node Support | [![node](https://img.shields.io/badge/node->=%2010.x.x-blue.svg)](https://nodejs.org/dist/latest-v10.x/docs/api/)
-Code Style | [![Code Style](https://badgen.net/badge/style/prettier/purple)](https://lossless.cloud)
-PackagePhobia (total standalone install weight) | [![PackagePhobia](https://badgen.net/packagephobia/install/@serve.zone/platformclient)](https://lossless.cloud)
-PackagePhobia (package size on registry) | [![PackagePhobia](https://badgen.net/packagephobia/publish/@serve.zone/platformclient)](https://lossless.cloud)
-BundlePhobia (total size when bundled) | [![BundlePhobia](https://badgen.net/bundlephobia/minzip/@serve.zone/platformclient)](https://lossless.cloud)
-
-## Usage
-Use TypeScript for best in class intellisense
-For further information read the linked docs at the top of this readme.
-
-## Legal
-> MIT licensed | **©** [Task Venture Capital GmbH](https://task.vc)
-| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy)
+
+`@serve.zone/platformclient` is the TypeScript SDK for talking to serve.zone platform services from application code. It wraps the serve.zone TypedSocket API and exposes focused connectors for transactional email, SMS, push notifications, and physical letters.
+
+Use it when your app should trigger serve.zone communication workflows without manually wiring TypedRequest methods or transport setup.
+
+## Issue Reporting and Security
+
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
+
+## Installation
+
+```bash
+pnpm add @serve.zone/platformclient
+```
+
+## What It Does
+
+`SzPlatformClient` handles the shared serve.zone platform connection and gives you these connectors:
+
+| Connector | Purpose | TypedRequest method |
+| --- | --- | --- |
+| `emailConnector` | Send transactional email | `sendEmail` |
+| `smsConnector` | Send SMS messages and verification codes | `sendSms`, `sendVerificationCode` |
+| `pushNotificationConnector` | Send push notifications | `sendPushNotification` |
+| `letterConnector` | Send physical letters through the platform | `sendLetter` |
+
+Requests use the types from `@serve.zone/interfaces`, so payloads stay aligned with the serve.zone backend contracts.
+
+## Quick Start
+
+```typescript
+import { SzPlatformClient } from '@serve.zone/platformclient';
+
+const platformClient = new SzPlatformClient(process.env.SERVEZONE_PLATFORM_AUTHORIZATION);
+await platformClient.init();
+
+await platformClient.emailConnector.sendEmail({
+  to: 'user@example.com',
+  from: 'hello@serve.zone',
+  title: 'Welcome to the platform',
+  body: 'Your workspace is ready.',
+});
+```
+
+The client connects to the platform endpoint configured through `SERVEZONE_PLATFORM_URL` or a runtime platform binding.
+
+## Configuration
+
+The client needs two values:
+
+| Value | How to provide it | Notes |
+| --- | --- | --- |
+| Authorization token | Constructor argument, `init()` argument, `SERVEZONE_PLATFORM_AUTHORIZATION`, `SERVEZONE_PLATFORM_TOKEN`, or binding credential env | Loaded on demand through `@push.rocks/qenv`. |
+| Platform URL | Constructor options, `SERVEZONE_PLATFORM_URL`, or binding endpoint | Loaded on demand through `@push.rocks/qenv`. |
+| Runtime bindings | Constructor options, `SERVEZONE_PLATFORM_BINDING`, or `SERVEZONE_PLATFORM_BINDINGS` | Values are JSON-encoded `IPlatformBinding` objects from `@serve.zone/interfaces`. |
+
+```typescript
+const client = new SzPlatformClient();
+await client.init('your-platform-authorization-token');
+```
+
+Constructor and `init()` also accept options:
+
+```typescript
+const client = new SzPlatformClient({
+  token: process.env.SERVEZONE_PLATFORM_TOKEN,
+  platformUrl: process.env.SERVEZONE_PLATFORM_URL,
+});
+await client.init();
+```
+
+## Debug Mode
+
+Pass `test` as the authorization string to enable debug mode. In debug mode, the client does not open a TypedSocket connection and connector methods log or return deterministic test values instead of sending real platform requests.
+
+```typescript
+const client = new SzPlatformClient('test');
+await client.init();
+
+await client.emailConnector.sendEmail({
+  to: 'developer@example.com',
+  from: 'hello@serve.zone',
+  title: 'Preview only',
+  body: 'This message is logged, not sent.',
+});
+
+const verificationCode = await client.smsConnector.sendSmsVerifcation({
+  toNumber: 491234567890,
+  fromName: 'ServeZone',
+});
+// verificationCode === '123456'
+```
+
+## Connector Examples
+
+### Email
+
+```typescript
+await client.emailConnector.sendEmail({
+  to: 'user@example.com',
+  from: 'hello@serve.zone',
+  title: 'Invoice ready',
+  body: 'Your invoice is available in the dashboard.',
+});
+```
+
+### SMS
+
+```typescript
+const status = await client.smsConnector.sendSms({
+  toNumber: 491234567890,
+  fromName: 'ServeZone',
+  messageText: 'Your code is 123456.',
+});
+```
+
+### SMS Verification
+
+```typescript
+const code = await client.smsConnector.sendSmsVerifcation({
+  toNumber: 491234567890,
+  fromName: 'ServeZone',
+});
+```
+
+### Push Notifications
+
+```typescript
+const status = await client.pushNotificationConnector.sendPushNotification({
+  deviceToken: 'device-token-from-your-app',
+  message: 'Deployment complete: your service is live.',
+});
+```
+
+### Letters
+
+```typescript
+await client.letterConnector.sendLetter({
+  description: 'Important account information',
+  needsCover: true,
+  title: 'Account update',
+  coverBody: 'This letter was generated through serve.zone.',
+  service: ['Einschreiben'],
+});
+```
+
+Exact request fields are defined by `@serve.zone/interfaces` and may evolve with the platform API.
+
+## InfoHtml Helper
+
+The repository also contains an `InfoHtml` helper in `ts_infohtml/` for rendering simple branded informational HTML pages from text or option objects.
+
+```typescript
+import { InfoHtml } from './ts_infohtml/index.js';
+
+const infoPage = await InfoHtml.fromOptions({
+  title: 'Service unavailable',
+  heading: 'Maintenance in progress',
+  text: 'Please try again in a few minutes.',
+  redirectTo: 'https://serve.zone',
+});
+
+console.log(infoPage.htmlString);
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm test
+pnpm run build
+```
+
+The package is authored in TypeScript and builds the source folders through `tsbuild tsfolders --web --allowimplicitany`.
+
+## Links
+
+| Resource | URL |
+| --- | --- |
+| npm package | <https://www.npmjs.com/package/@serve.zone/platformclient> |
+| Source | <https://gitlab.com/serve.zone/platformclient> |
+| Source mirror | <https://github.com/serve.zone/platformclient> |
+| Typedoc | <https://serve.zone.gitlab.io/platformclient/> |
+
+## License and Legal Information
+
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [license](./license) file.
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+
+### Company Information
+
+Task Venture Capital GmbH  
+Registered at District Court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@serve.zone/platformclient',
-  version: '1.1.2',
+  version: '1.1.4',
   description: 'a module that makes it really easy to use the serve.zone platform inside your app'
 }

package/ts/classes.platformclient.ts

@@ -4,11 +4,23 @@ import { SzPushNotificationConnector } from './email/classes.pushnotificationcon
 import { SzLetterConnector } from './email/classes.letterconnector.js';
 import * as plugins from './plugins.js';
 
+export interface ISzPlatformClientOptions {
+  authorizationString?: string;
+  authorization?: string;
+  token?: string;
+  url?: string;
+  platformUrl?: string;
+  binding?: plugins.servezoneInterfaces.platform.IPlatformBinding;
+  bindings?: plugins.servezoneInterfaces.platform.IPlatformBinding[];
+}
+
 export class SzPlatformClient {
   public debugMode = false;
-  private authorizationString: string;
-  public typedrouter = new plugins.typedrequest.TypedRouter();
-  public typedsocket: plugins.typedsocket.TypedSocket;
+  private authorizationString?: string;
+  private connectionAddress?: string;
+  public platformBindings: plugins.servezoneInterfaces.platform.IPlatformBinding[] = [];
+  public typedrouter: plugins.typedrequest.TypedRouter = new plugins.typedrequest.TypedRouter();
+  public typedsocket!: plugins.typedsocket.TypedSocket;
   private qenvInstance = new plugins.qenv.Qenv();
 
   public emailConnector = new SzEmailConnector(this);
@@ -16,30 +28,207 @@ export class SzPlatformClient {
   public pushNotificationConnector = new SzPushNotificationConnector(this);
   public letterConnector = new SzLetterConnector(this);
 
-  constructor(authorizationStringArg?: string) {
-    this.authorizationString = authorizationStringArg;
+  constructor(authorizationStringArg?: string | ISzPlatformClientOptions) {
+    this.applyOptions(authorizationStringArg);
   }
 
-  public async init(authorizationStringArg?: string) {
-    if (authorizationStringArg) {
-      this.authorizationString = authorizationStringArg;
+  public async init(authorizationStringArg?: string | ISzPlatformClientOptions) {
+    this.applyOptions(authorizationStringArg);
+    if (!this.authorizationString) {
+      this.authorizationString = await this.getConfiguredAuthorizationString();
+    }
+    if (this.authorizationString === 'test') {
+      this.activateDebugMode();
+      return;
+    }
+
+    this.platformBindings = this.mergePlatformBindings(
+      this.platformBindings,
+      await this.discoverPlatformBindings()
+    );
+    if (!this.authorizationString) {
+      this.authorizationString = this.getAuthorizationStringFromBindings();
     }
-    if (!this.authorizationString)
-      this.authorizationString = process.env.SERVEZONE_PLATFROM_AUTHORIZATION;
     if (!this.authorizationString) throw new Error('authorizationString is required');
     if (this.authorizationString === 'test') {
-      this.debugMode = true;
-      console.log('debug mode activated.');
+      this.activateDebugMode();
       return;
     }
     this.typedsocket = await plugins.typedsocket.TypedSocket.createClient(
-      this.typedrouter,
+      this.typedrouter as any,
       await this.getConnectionAddress()
     );
+    await this.setAuthorizationTag();
+  }
+
+  private activateDebugMode() {
+    this.debugMode = true;
+    console.log('debug mode activated.');
+  }
+
+  public getPlatformBinding(
+    capabilityArg?: plugins.servezoneInterfaces.platform.TPlatformCapability
+  ) {
+    return this.platformBindings.find((bindingArg) => {
+      return (
+        bindingArg.desiredState !== 'disabled' &&
+        bindingArg.status !== 'failed' &&
+        (!capabilityArg || bindingArg.capability === capabilityArg)
+      );
+    });
+  }
+
+  private applyOptions(optionsArg?: string | ISzPlatformClientOptions) {
+    if (!optionsArg) {
+      return;
+    }
+    if (typeof optionsArg === 'string') {
+      this.authorizationString = optionsArg;
+      return;
+    }
+
+    this.authorizationString =
+      optionsArg.authorizationString ||
+      optionsArg.authorization ||
+      optionsArg.token ||
+      this.authorizationString;
+    this.connectionAddress = optionsArg.url || optionsArg.platformUrl || this.connectionAddress;
+    this.platformBindings = this.mergePlatformBindings(
+      this.platformBindings,
+      [optionsArg.binding, ...(optionsArg.bindings || [])].filter(
+        Boolean
+      ) as plugins.servezoneInterfaces.platform.IPlatformBinding[]
+    );
   }
 
   private async getConnectionAddress() {
-    const connectionAddress = await this.qenvInstance.getEnvVarOnDemand('SERVEZONE_API_DOMAIN');
+    const connectionAddress =
+      this.connectionAddress ||
+      (await this.getConfiguredEnvVar('SERVEZONE_PLATFORM_URL')) ||
+      this.getConnectionAddressFromBindings();
+    if (!connectionAddress) throw new Error('SERVEZONE_PLATFORM_URL or platform binding endpoint is required');
     return connectionAddress;
   }
+
+  private getConnectionAddressFromBindings() {
+    for (const binding of this.platformBindings) {
+      if (binding.desiredState === 'disabled' || binding.status === 'failed') {
+        continue;
+      }
+      if (!this.isSupportedConnectorCapability(binding.capability)) {
+        continue;
+      }
+      const endpoint = binding.endpoints?.find((endpointArg) => {
+        return endpointArg.protocol === 'typedrequest' || endpointArg.protocol === 'http';
+      });
+      const endpointUrl = endpoint?.internalUrl || endpoint?.externalUrl;
+      if (endpointUrl) {
+        return endpointUrl;
+      }
+    }
+  }
+
+  private isSupportedConnectorCapability(
+    capabilityArg: plugins.servezoneInterfaces.platform.TPlatformCapability
+  ) {
+    return ['email', 'sms', 'pushnotification', 'letter'].includes(capabilityArg);
+  }
+
+  private async getConfiguredAuthorizationString() {
+    return (
+      (await this.getConfiguredEnvVar('SERVEZONE_PLATFORM_AUTHORIZATION')) ||
+      (await this.getConfiguredEnvVar('SERVEZONE_PLATFORM_TOKEN'))
+    );
+  }
+
+  private getAuthorizationStringFromBindings() {
+    const authEnvNames = [
+      'SERVEZONE_PLATFORM_AUTHORIZATION',
+      'SERVEZONE_PLATFORM_TOKEN',
+      'SERVEZONE_API_TOKEN',
+      'AUTHORIZATION',
+      'TOKEN',
+    ];
+    for (const binding of this.platformBindings) {
+      for (const credential of binding.credentials || []) {
+        for (const envName of authEnvNames) {
+          const value = credential.env?.[envName];
+          if (value) {
+            return value;
+          }
+        }
+      }
+    }
+  }
+
+  private async setAuthorizationTag() {
+    if (!this.authorizationString) {
+      return;
+    }
+    try {
+      await this.typedsocket.setTag('authorization' as any, this.authorizationString);
+    } catch (error) {
+      if (await this.getConfiguredEnvVar('SERVEZONE_PLATFORMCLIENT_DEBUG')) {
+        console.warn('Could not set platform authorization tag:', (error as Error).message);
+      }
+    }
+  }
+
+  private async discoverPlatformBindings() {
+    const bindings: plugins.servezoneInterfaces.platform.IPlatformBinding[] = [];
+    const envBindings = await this.getConfiguredEnvVar('SERVEZONE_PLATFORM_BINDINGS');
+    const envBinding = await this.getConfiguredEnvVar('SERVEZONE_PLATFORM_BINDING');
+
+    if (envBindings) {
+      bindings.push(...this.parsePlatformBindingsEnv('SERVEZONE_PLATFORM_BINDINGS', envBindings));
+    }
+    if (envBinding) {
+      bindings.push(...this.parsePlatformBindingsEnv('SERVEZONE_PLATFORM_BINDING', envBinding));
+    }
+
+    return bindings;
+  }
+
+  private parsePlatformBindingsEnv(envNameArg: string, envValueArg: string) {
+    let parsedValue: unknown;
+    try {
+      parsedValue = JSON.parse(envValueArg);
+    } catch (error) {
+      throw new Error(`${envNameArg} must contain valid JSON`);
+    }
+
+    if (Array.isArray(parsedValue)) {
+      return parsedValue as plugins.servezoneInterfaces.platform.IPlatformBinding[];
+    }
+    if (parsedValue && typeof parsedValue === 'object') {
+      return [parsedValue as plugins.servezoneInterfaces.platform.IPlatformBinding];
+    }
+    throw new Error(`${envNameArg} must contain a platform binding object or array`);
+  }
+
+  private mergePlatformBindings(
+    existingBindingsArg: plugins.servezoneInterfaces.platform.IPlatformBinding[],
+    newBindingsArg: plugins.servezoneInterfaces.platform.IPlatformBinding[]
+  ) {
+    const bindingMap = new Map<string, plugins.servezoneInterfaces.platform.IPlatformBinding>();
+    for (const binding of [...existingBindingsArg, ...newBindingsArg]) {
+      bindingMap.set(binding.id, binding);
+    }
+    return Array.from(bindingMap.values());
+  }
+
+  private async getConfiguredEnvVar(envNameArg: string) {
+    const processValue = this.getProcessEnvVar(envNameArg);
+    if (processValue) {
+      return processValue;
+    }
+    return this.qenvInstance.getEnvVarOnDemand(envNameArg);
+  }
+
+  private getProcessEnvVar(envNameArg: string) {
+    const processEnv = (globalThis as typeof globalThis & {
+      process?: { env?: Record<string, string | undefined> };
+    }).process?.env;
+    return processEnv?.[envNameArg];
+  }
 }

package/ts/email/classes.emailconnector.ts

@@ -11,7 +11,7 @@ export class SzEmailConnector {
   }
 
   public async sendEmail(
-    optionsArg: plugins.servezoneInterfaces.platformservice.mta.IRequest_SendEmail['request']
+    optionsArg: plugins.servezoneInterfaces.platform.email.IReq_SendEmail['request']
   ) {
     if (this.platformClientRef.debugMode) {
       logger.log('info', `sent email with subject ${optionsArg.title} to ${optionsArg.to}
@@ -26,7 +26,7 @@ export class SzEmailConnector {
     }
 
     const typedRequest =
-      this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platformservice.mta.IRequest_SendEmail>(
+      this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platform.email.IReq_SendEmail>(
         'sendEmail'
       );
     const response = await typedRequest.fire(optionsArg);

package/ts/email/classes.letterconnector.ts

@@ -9,7 +9,7 @@ export class SzLetterConnector {
   }
 
   public async sendLetter(
-    optionsArg: plugins.servezoneInterfaces.platformservice.letter.IRequest_SendLetter['request']
+    optionsArg: plugins.servezoneInterfaces.platform.letter.IReq_SendLetter['request']
   ) {
 
     if (this.platformClientRef.debugMode) {
@@ -21,9 +21,9 @@ export class SzLetterConnector {
     }
 
     const typedRequest =
-      this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platformservice.letter.IRequest_SendLetter>(
+      this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platform.letter.IReq_SendLetter>(
         'sendLetter'
       );
     const response = await typedRequest.fire(optionsArg);
   }
-}
+}

package/ts/email/classes.pushnotificationconnector.ts

@@ -9,7 +9,7 @@ export class SzPushNotificationConnector {
   }
 
   public async sendPushNotification(
-    optionsArg: plugins.servezoneInterfaces.platformservice.pushnotification.IRequest_SendPushNotification['request']
+    optionsArg: plugins.servezoneInterfaces.platform.pushnotification.IReq_SendPushNotification['request']
   ) {
     if (this.platformClientRef.debugMode) {
       console.log('sendPushNotification', optionsArg);
@@ -20,7 +20,7 @@ export class SzPushNotificationConnector {
     }
 
     const typedRequest =
-      this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platformservice.pushnotification.IRequest_SendPushNotification>(
+      this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platform.pushnotification.IReq_SendPushNotification>(
         'sendPushNotification'
       );
     const response = await typedRequest.fire(optionsArg);
@@ -31,4 +31,4 @@ export class SzPushNotificationConnector {
 
     return response.status;
   }
-}
+}

package/ts/email/classes.smsconnector.ts

@@ -9,7 +9,7 @@ export class SzSmsConnector {
     this.platformClientRef = platformClientRefArg;
   }
 
-  public async sendSms(messageArg: plugins.servezoneInterfaces.platformservice.sms.IRequest_SendSms['request']) {
+  public async sendSms(messageArg: plugins.servezoneInterfaces.platform.sms.IReq_SendSms['request']) {
     if (this.platformClientRef.debugMode) {
       logger.log('info', `sent sms to ${messageArg.toNumber}}
         body: 
@@ -22,7 +22,7 @@ export class SzSmsConnector {
       return;
     }
     
-    const typedrequest = this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platformservice.sms.IRequest_SendSms>(
+    const typedrequest = this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platform.sms.IReq_SendSms>(
       'sendSms'
     );
     const response = await typedrequest.fire(messageArg);
@@ -31,7 +31,7 @@ export class SzSmsConnector {
   }
 
   public async sendSmsVerifcation(
-    recipientArg: plugins.servezoneInterfaces.platformservice.sms.IRequest_SendVerificationCode['request']
+    recipientArg: plugins.servezoneInterfaces.platform.sms.IReq_SendVerificationCode['request']
   ) {
     if (this.platformClientRef.debugMode) {
       console.log('sendSmsVerifcation', recipientArg, '123456');
@@ -40,7 +40,7 @@ export class SzSmsConnector {
 
 
     const typedrequest =
-      this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platformservice.sms.IRequest_SendVerificationCode>(
+      this.platformClientRef.typedsocket.createTypedRequest<plugins.servezoneInterfaces.platform.sms.IReq_SendVerificationCode>(
         'sendVerificationCode'
       );
     const response = await typedrequest.fire(recipientArg);

package/dist_ts/classes.serviceserver.d.ts

@@ -1,18 +0,0 @@
-import * as plugins from './plugins.js';
-export interface IServiceServerConstructorOptions {
-    addCustomRoutes?: (serverArg: plugins.typedserver.servertools.Server) => Promise<any>;
-    serviceName: string;
-    serviceVersion: string;
-    serviceDomain: string;
-    port?: number;
-}
-/**
- * a server for serving your app to the outside world
- */
-export declare class ServiceServer {
-    options: IServiceServerConstructorOptions;
-    typedServer: plugins.typedserver.TypedServer;
-    constructor(optionsArg: IServiceServerConstructorOptions);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-}

package/dist_ts/classes.serviceserver.js

@@ -1,32 +0,0 @@
-import * as plugins from './plugins.js';
-import { InfoHtml } from './infohtml/index.js';
-/**
- * a server for serving your app to the outside world
- */
-export class ServiceServer {
-    constructor(optionsArg) {
-        this.options = optionsArg;
-    }
-    async start() {
-        console.log('starting lole-serviceserver...');
-        this.typedServer = new plugins.typedserver.TypedServer({
-            cors: true,
-            domain: this.options.serviceDomain,
-            forceSsl: false,
-            port: this.options.port || 3000,
-            robots: true,
-            defaultAnswer: async () => {
-                return (await InfoHtml.fromSimpleText(`${this.options.serviceName} (version ${this.options.serviceVersion})`)).htmlString;
-            },
-        });
-        // lets add any custom routes
-        if (this.options.addCustomRoutes) {
-            await this.options.addCustomRoutes(this.typedServer.server);
-        }
-        await this.typedServer.start();
-    }
-    async stop() {
-        await this.typedServer.stop();
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zZXJ2aWNlc2VydmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2xhc3Nlcy5zZXJ2aWNlc2VydmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQVUvQzs7R0FFRztBQUNILE1BQU0sT0FBTyxhQUFhO0lBSXhCLFlBQVksVUFBNEM7UUFDdEQsSUFBSSxDQUFDLE9BQU8sR0FBRyxVQUFVLENBQUM7SUFDNUIsQ0FBQztJQUVNLEtBQUssQ0FBQyxLQUFLO1FBQ2hCLE9BQU8sQ0FBQyxHQUFHLENBQUMsZ0NBQWdDLENBQUMsQ0FBQTtRQUM3QyxJQUFJLENBQUMsV0FBVyxHQUFHLElBQUksT0FBTyxDQUFDLFdBQVcsQ0FBQyxXQUFXLENBQUM7WUFDckQsSUFBSSxFQUFFLElBQUk7WUFDVixNQUFNLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxhQUFhO1lBQ2xDLFFBQVEsRUFBRSxLQUFLO1lBQ2YsSUFBSSxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxJQUFJLElBQUk7WUFDL0IsTUFBTSxFQUFFLElBQUk7WUFDWixhQUFhLEVBQUUsS0FBSyxJQUFJLEVBQUU7Z0JBQ3hCLE9BQU8sQ0FDTCxNQUFNLFFBQVEsQ0FBQyxjQUFjLENBQzNCLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxXQUFXLGFBQWEsSUFBSSxDQUFDLE9BQU8sQ0FBQyxjQUFjLEdBQUcsQ0FDdkUsQ0FDRixDQUFDLFVBQVUsQ0FBQztZQUNmLENBQUM7U0FDRixDQUFDLENBQUM7UUFFSCw2QkFBNkI7UUFDN0IsSUFBSSxJQUFJLENBQUMsT0FBTyxDQUFDLGVBQWUsRUFBRSxDQUFDO1lBQ2pDLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxlQUFlLENBQUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUM5RCxDQUFDO1FBRUQsTUFBTSxJQUFJLENBQUMsV0FBVyxDQUFDLEtBQUssRUFBRSxDQUFDO0lBQ2pDLENBQUM7SUFFTSxLQUFLLENBQUMsSUFBSTtRQUNmLE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNoQyxDQUFDO0NBQ0YifQ==

package/dist_ts/infohtml/classes.infohtml.d.ts

@@ -1,18 +0,0 @@
-import * as plugins from '../plugins.js';
-export interface IHtmlInfoOptions {
-    text: string;
-    heading?: string;
-    title?: string;
-    sentryMessage?: string;
-    sentryDsn?: string;
-    redirectTo?: string;
-}
-export declare class InfoHtml {
-    static fromSimpleText(textArg: string): Promise<InfoHtml>;
-    static fromOptions(optionsArg: IHtmlInfoOptions): Promise<InfoHtml>;
-    options: IHtmlInfoOptions;
-    smartntmlInstance: plugins.smartntml.Smartntml;
-    htmlString: string;
-    constructor(optionsArg: IHtmlInfoOptions);
-    init(): Promise<string>;
-}