@tstdl/base 0.88.7 → 0.89.1

package/injector/index.js

@@ -1,3 +1,8 @@
+/**
+ * Dependency Injection
+ *
+ * @module Injector
+ */
 export * from './decorators.js';
 export * from './inject.js';
 export * from './injector.js';

package/json-path/index.d.ts

@@ -1 +1,6 @@
+/**
+ * JSON Path encoding/decoding
+ *
+ * @module JSON Path
+ */
 export * from './json-path.js';

package/json-path/index.js

@@ -1 +1,6 @@
+/**
+ * JSON Path encoding/decoding
+ *
+ * @module JSON Path
+ */
 export * from './json-path.js';

package/key-value-store/index.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Store key-value pairs
+ *
+ * @module Key-Value Store
+ */
 export * from './key-value-store.provider.js';
 export * from './key-value.store.js';
+export * from './mongo/index.js';

package/key-value-store/index.js

@@ -1,2 +1,8 @@
+/**
+ * Store key-value pairs
+ *
+ * @module Key-Value Store
+ */
 export * from './key-value-store.provider.js';
 export * from './key-value.store.js';
+export * from './mongo/index.js';

package/lock/index.d.ts

@@ -1,2 +1,9 @@
+/**
+ * Resource locking
+ *
+ * @module Lock
+ */
 export * from './lock.js';
+export * from './mongo/index.js';
 export * from './provider.js';
+export * from './web/index.js';

package/lock/index.js

@@ -1,2 +1,9 @@
+/**
+ * Resource locking
+ *
+ * @module Lock
+ */
 export * from './lock.js';
+export * from './mongo/index.js';
 export * from './provider.js';
+export * from './web/index.js';

package/lock/mongo/lock.d.ts

@@ -3,8 +3,7 @@ import { Lock } from '../../lock/index.js';
 import { Logger } from '../../logger/index.js';
 import { MongoLockRepository } from './mongo-lock-repository.js';
 export declare class MongoLock extends Lock {
-    private readonly lockRepository;
-    private readonly logger;
+    #private;
     constructor(lockRepository: MongoLockRepository, resource: string, logger: Logger);
     acquire<Throw extends boolean>(timeout: number | undefined, throwOnFail: Throw): Promise<AcquireResult<Throw>>;
     use<Throw extends boolean, R>(timeout: number | undefined, throwOnFail: Throw, func: LockedFunction<R>): Promise<UsingResult<Throw, R>>;

package/lock/mongo/lock.js

@@ -22,12 +22,12 @@ import { MongoLockProvider } from './provider.js';
 const expirationTime = 10000;
 const renewBuffer = expirationTime / 2;
 let MongoLock = class MongoLock extends Lock {
-    lockRepository;
-    logger;
+    #lockRepository;
+    #logger;
     constructor(lockRepository, resource, logger) {
         super(resource);
-        this.lockRepository = lockRepository;
-        this.logger = logger;
+        this.#lockRepository = lockRepository;
+        this.#logger = logger;
     }
     async acquire(timeout, throwOnFail) {
         const key = getRandomString(15, Alphabet.LowerUpperCaseNumbers);
@@ -69,7 +69,7 @@ let MongoLock = class MongoLock extends Lock {
                     expiration = (refreshResult == false) ? new Date(0) : refreshResult; // eslint-disable-line require-atomic-updates
                 }
                 catch (error) {
-                    this.logger.error(error);
+                    this.#logger.error(error);
                 }
                 finally {
                     await cancelableTimeoutUntil(Math.max(currentTimestamp() + 1000, expiration.valueOf() - renewBuffer), releaseToken);
@@ -92,18 +92,18 @@ let MongoLock = class MongoLock extends Lock {
         }
     }
     async exists() {
-        return this.lockRepository.exists(this.resource);
+        return this.#lockRepository.exists(this.resource);
     }
     async tryAcquireOrRefresh(resource, key) {
         const expirationDate = getExpirationDate();
-        return this.lockRepository.tryInsertOrRefresh(resource, key, expirationDate);
+        return this.#lockRepository.tryInsertOrRefresh(resource, key, expirationDate);
     }
     async tryRefresh(resource, key) {
         const expiration = getExpirationDate();
-        return this.lockRepository.tryUpdateExpiration(resource, key, expiration);
+        return this.#lockRepository.tryUpdateExpiration(resource, key, expiration);
     }
     async release(resource, key) {
-        return this.lockRepository.deleteByResource(resource, key);
+        return this.#lockRepository.deleteByResource(resource, key);
     }
 };
 MongoLock = __decorate([

package/lock/mongo/provider.d.ts

@@ -1,12 +1,8 @@
 import type { Lock } from '../../lock/index.js';
 import { LockProvider } from '../../lock/index.js';
-import { Logger } from '../../logger/index.js';
-import { MongoLockRepository } from './mongo-lock-repository.js';
 export declare class MongoLockProvider extends LockProvider {
-    private readonly lockRepository;
-    private readonly logger;
-    private readonly _prefix;
-    constructor(lockRepository: MongoLockRepository, logger: Logger, prefix?: string);
-    prefix(prefix: string): LockProvider;
+    #private;
+    prefix(prefix: string): MongoLockProvider;
     get(resource: string): Lock;
+    private getResourceString;
 }

package/lock/mongo/provider.js

@@ -4,43 +4,33 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
 var MongoLockProvider_1;
-import { InjectArg, ResolveArg, ResolveArgProvider, Singleton } from '../../injector/decorators.js';
+import { Singleton } from '../../injector/decorators.js';
+import { inject, injectArgument } from '../../injector/inject.js';
+import { Injector } from '../../injector/injector.js';
 import { LockProvider } from '../../lock/index.js';
 import { Logger } from '../../logger/index.js';
 import { assertDefinedPass } from '../../utils/type-guards.js';
 import { MongoLock } from './lock.js';
 import { mongoLockModuleConfig } from './module.js';
 import { MongoLockRepository } from './mongo-lock-repository.js';
-const collectionArgumentProvider = () => assertDefinedPass(mongoLockModuleConfig.lockEntityRepositoryConfig, 'mongo lock module not configured');
 let MongoLockProvider = MongoLockProvider_1 = class MongoLockProvider extends LockProvider {
-    lockRepository;
-    logger;
-    _prefix;
-    constructor(lockRepository, logger, prefix = '') {
-        super();
-        this.lockRepository = lockRepository;
-        this.logger = logger;
-        this._prefix = prefix;
-    }
+    #injector = inject(Injector);
+    #lockRepository = inject(MongoLockRepository, assertDefinedPass(mongoLockModuleConfig.lockEntityRepositoryConfig, 'mongo lock module not configured'));
+    #logger = inject(Logger, 'MongoLock');
+    #prefix = injectArgument(this);
     prefix(prefix) {
-        return new MongoLockProvider_1(this.lockRepository, this.logger, this._prefix + prefix);
+        return this.#injector.resolve(MongoLockProvider_1, this.getResourceString(prefix));
     }
     get(resource) {
-        return new MongoLock(this.lockRepository, this._prefix + resource, this.logger);
+        return new MongoLock(this.#lockRepository, this.getResourceString(resource), this.#logger);
+    }
+    getResourceString(resource) {
+        const prefixDivider = (this.#prefix.length > 0) ? ':' : '';
+        return `${this.#prefix}${prefixDivider}${resource}`;
     }
 };
 MongoLockProvider = MongoLockProvider_1 = __decorate([
-    Singleton(),
-    __param(0, ResolveArgProvider(collectionArgumentProvider)),
-    __param(1, ResolveArg('MongoLock')),
-    __param(2, InjectArg()),
-    __metadata("design:paramtypes", [MongoLockRepository, Logger, String])
+    Singleton()
 ], MongoLockProvider);
 export { MongoLockProvider };

package/logger/index.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Logging
+ *
+ * @module Logger
+ */
+export * from './console/index.js';
 export * from './level.js';
 export * from './logger.js';
+export * from './noop/index.js';
 export * from './tokens.js';

package/logger/index.js

@@ -1,3 +1,10 @@
+/**
+ * Logging
+ *
+ * @module Logger
+ */
+export * from './console/index.js';
 export * from './level.js';
 export * from './logger.js';
+export * from './noop/index.js';
 export * from './tokens.js';

package/mail/index.d.ts

@@ -1,7 +1,12 @@
+/**
+ * Send mails with template support
+ *
+ * @module Mail
+ */
+export * from './clients/index.js';
 export * from './mail.client.js';
 export * from './mail.service.js';
 export * from './models/index.js';
 export * from './module.js';
 export * from './repositories/index.js';
-export * from './repositories/mail-log.repository.js';
 export * from './tokens.js';

package/mail/index.js

@@ -1,7 +1,12 @@
+/**
+ * Send mails with template support
+ *
+ * @module Mail
+ */
+export * from './clients/index.js';
 export * from './mail.client.js';
 export * from './mail.service.js';
 export * from './models/index.js';
 export * from './module.js';
 export * from './repositories/index.js';
-export * from './repositories/mail-log.repository.js';
 export * from './tokens.js';

package/mail/repositories/index.d.ts

@@ -1 +1,2 @@
-export * from './mongo/mongo-mail-log.repository.js';
+export * from './mail-log.repository.js';
+export * from './mongo/index.js';

package/mail/repositories/index.js

@@ -1 +1,2 @@
-export * from './mongo/mongo-mail-log.repository.js';
+export * from './mail-log.repository.js';
+export * from './mongo/index.js';

package/memory/index.d.ts

@@ -1,2 +1,7 @@
+/**
+ * Memory management
+ *
+ * @module Memory
+ */
 export * from './finalization.js';
 export * from './observable-finalization-registry.js';

package/memory/index.js

@@ -1,2 +1,7 @@
+/**
+ * Memory management
+ *
+ * @module Memory
+ */
 export * from './finalization.js';
 export * from './observable-finalization-registry.js';

package/message-bus/index.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Message broadcasting
+ *
+ * @module Message Bus
+ */
+export * from './broadcast-channel/index.js';
+export * from './local/index.js';
 export * from './message-bus-base.js';
 export * from './message-bus-provider.js';
 export * from './message-bus.js';

package/message-bus/index.js

@@ -1,3 +1,10 @@
+/**
+ * Message broadcasting
+ *
+ * @module Message Bus
+ */
+export * from './broadcast-channel/index.js';
+export * from './local/index.js';
 export * from './message-bus-base.js';
 export * from './message-bus-provider.js';
 export * from './message-bus.js';

package/migration/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Application database migration
+ *
+ * @module Migration
+ */
 export * from './migration-state-repository.js';
 export * from './migration-state.js';
 export * from './migrator.js';
+export * from './mongo/index.js';

package/migration/index.js

@@ -1,3 +1,9 @@
+/**
+ * Application database migration
+ *
+ * @module Migration
+ */
 export * from './migration-state-repository.js';
 export * from './migration-state.js';
 export * from './migrator.js';
+export * from './mongo/index.js';

package/module/index.d.ts

@@ -1,4 +1,10 @@
+/**
+ * Application Modules
+ *
+ * @module Module
+ */
 export * from './module-base.js';
 export * from './module-metric-reporter.js';
 export * from './module.js';
+export * from './modules/index.js';
 export * from './utils.js';

package/module/index.js

@@ -1,4 +1,10 @@
+/**
+ * Application Modules
+ *
+ * @module Module
+ */
 export * from './module-base.js';
 export * from './module-metric-reporter.js';
 export * from './module.js';
+export * from './modules/index.js';
 export * from './utils.js';

package/object-storage/index.d.ts

@@ -1,3 +1,9 @@
-export * from './object.js';
-export * from './object-storage.js';
+/**
+ * Storage for objects/files
+ *
+ * @module Object Storage
+ */
 export * from './object-storage-provider.js';
+export * from './object-storage.js';
+export * from './object.js';
+export * from './s3/index.js';

package/object-storage/index.js

@@ -1,3 +1,9 @@
-export * from './object.js';
-export * from './object-storage.js';
+/**
+ * Storage for objects/files
+ *
+ * @module Object Storage
+ */
 export * from './object-storage-provider.js';
+export * from './object-storage.js';
+export * from './object.js';
+export * from './s3/index.js';

package/openid-connect/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * OIDC (OAuth 2.0) client implementation
+ *
+ * @module OpenID Connect
+ */
 export * from './cached-oidc-configuration.service.js';
 export * from './mongo-oidc-state.repository.js';
 export * from './oidc-configuration.service.js';

package/openid-connect/index.js

@@ -1,3 +1,8 @@
+/**
+ * OIDC (OAuth 2.0) client implementation
+ *
+ * @module OpenID Connect
+ */
 import { Injector } from '../injector/injector.js';
 import { CachedOidcConfigurationService } from './cached-oidc-configuration.service.js';
 import { OidcConfigurationService } from './oidc-configuration.service.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tstdl/base",
-  "version": "0.88.7",
+  "version": "0.89.1",
   "author": "Patrick Hein",
   "publishConfig": {
     "access": "public"
@@ -12,7 +12,7 @@
     "build:production": "rm -rf dist && npm run build && npm run build:production:copy-files",
     "build:production:copy-files": "cp package.json .eslintrc.json tsconfig.server.json dist/ && cp tsconfig.base.json dist/tsconfig.json",
     "build:docs": "typedoc",
-    "build:docs-watch": "typedoc --watch",
+    "build:docs:watch": "typedoc --watch",
     "lint": "eslint -c .eslintrc.json --ext .ts .",
     "pub": "npm run build:production && rm -vf dist/test* && npm publish dist/",
     "tsc:watch": "tsc --watch",
@@ -32,12 +32,8 @@
     "./web-types": "./web-types.js",
 
     "./api": "./api/index.js",
-    "./api/client": "./api/client/index.js",
-    "./api/server": "./api/server/index.js",
     "./application": "./application/index.js",
     "./authentication": "./authentication/index.js",
-    "./authentication/client": "./authentication/client/index.js",
-    "./authentication/server": "./authentication/server/index.js",
     "./browser": "./browser/index.js",
     "./cancellation": "./cancellation/index.js",
     "./cookie": "./cookie/index.js",
@@ -51,34 +47,19 @@
     "./error": "./error/index.js",
     "./function": "./function/index.js",
     "./http": "./http/index.js",
-    "./http/client/adapters": "./http/client/adapters/index.js",
-    "./http/server": "./http/server/index.js",
-    "./http/server/node": "./http/server/node/index.js",
+    "./http/adapters/undici": "./http/client/adapters/undici.adapter.ts",
     "./image-service": "./image-service/index.js",
-    "./image-service/imgproxy": "./image-service/imgproxy/index.js",
     "./injector": "./injector/index.js",
     "./json-path": "./json-path/index.js",
     "./key-value-store": "./key-value-store/index.js",
-    "./key-value-store/mongo": "./key-value-store/mongo/index.js",
     "./lock": "./lock/index.js",
-    "./lock/mongo": "./lock/mongo/index.js",
-    "./lock/web": "./lock/web/index.js",
     "./logger": "./logger/index.js",
-    "./logger/console": "./logger/console/index.js",
-    "./logger/noop": "./logger/noop/index.js",
     "./mail": "./mail/index.js",
-    "./mail/clients": "./mail/clients/index.js",
-    "./mail/repositories/mongo": "./mail/repositories/mongo/index.js",
     "./memory": "./memory/index.js",
     "./message-bus": "./message-bus/index.js",
-    "./message-bus/broadcast-channel": "./message-bus/broadcast-channel/index.js",
-    "./message-bus/local": "./message-bus/local/index.js",
     "./migration": "./migration/index.js",
-    "./migration/mongo": "./migration/mongo/index.js",
     "./module": "./module/index.js",
-    "./module/modules": "./module/modules/index.js",
     "./object-storage": "./object-storage/index.js",
-    "./object-storage/s3": "./object-storage/s3/index.js",
     "./openid-connect": "./openid-connect/index.js",
     "./password": "./password/index.js",
     "./pdf": "./pdf/index.js",
@@ -127,6 +108,7 @@
     "type-fest": "^4.3"
   },
   "devDependencies": {
+    "@mxssfd/typedoc-theme": "1.1",
     "@types/chroma-js": "2.4",
     "@types/koa__router": "12.0",
     "@types/luxon": "3.3",
@@ -143,12 +125,13 @@
     "eslint-plugin-import": "2.28",
     "tsc-alias": "1.8",
     "typedoc": "0.25",
+    "typedoc-plugin-missing-exports": "2.1",
     "typescript": "5.2"
   },
   "peerDependencies": {
     "@elastic/elasticsearch": "^8.9",
     "@koa/router": "^12.0",
-    "@tstdl/angular": "^0.88",
+    "@tstdl/angular": "^0.89",
     "@zxcvbn-ts/core": "^3.0",
     "@zxcvbn-ts/language-common": "^3.0",
     "@zxcvbn-ts/language-de": "^3.0",
@@ -164,7 +147,7 @@
     "playwright": "^1.38",
     "preact": "^10.17",
     "preact-render-to-string": "^6.2",
-    "undici": "^5.24",
+    "undici": "^5.25",
     "urlpattern-polyfill": "^9.0"
   },
   "peerDependenciesMeta": {

package/password/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Check password strength
+ *
+ * @module Password
+ */
 export * from './have-i-been-pwned.js';
 export * from './password-check-result.model.js';
 export * from './password-check.js';

package/password/index.js

@@ -1,3 +1,8 @@
+/**
+ * Check password strength
+ *
+ * @module Password
+ */
 export * from './have-i-been-pwned.js';
 export * from './password-check-result.model.js';
 export * from './password-check.js';

package/pdf/pdf.service.d.ts

@@ -1,3 +1,8 @@
+/**
+ * PDF generation
+ *
+ * @module PDF
+ */
 import { BrowserContextController } from '../browser/browser-context-controller.js';
 import type { BrowserControllerArgument } from '../browser/browser-controller.js';
 import { BrowserController } from '../browser/browser-controller.js';

package/pdf/pdf.service.js

@@ -1,3 +1,8 @@
+/**
+ * PDF generation
+ *
+ * @module PDF
+ */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/pool/index.d.ts

@@ -1 +1,6 @@
+/**
+ * Instance Pooling
+ *
+ * @module Pool
+ */
 export * from './pool.js';

package/pool/index.js

@@ -1 +1,6 @@
+/**
+ * Instance Pooling
+ *
+ * @module Pool
+ */
 export * from './pool.js';

package/promise/cancelable-promise.d.ts

@@ -1,7 +1,15 @@
-export type CancelablePromiseResult<T> = {
+import { type CancellationSignal } from '../cancellation/token.js';
+import { CustomPromise } from './custom-promise.js';
+export type CancelablePromiseExecutor<T> = (resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void, cancellationSignal: CancellationSignal) => void;
+export type CancelablePromiseResult<T, R> = {
     canceled: true;
+    reason: R;
 } | {
     canceled: false;
     value: T;
 };
-export declare function cancelablePromise<T>(promise: Promise<T>, cancelationPromise: PromiseLike<void>): Promise<CancelablePromiseResult<T>>;
+export declare class CancelablePromise<T, R = void> extends CustomPromise<CancelablePromiseResult<T, R>> {
+    #private;
+    constructor(executor: CancelablePromiseExecutor<T>);
+    cancel(reason: R): void;
+}

package/promise/cancelable-promise.js

@@ -1,24 +1,28 @@
-// eslint-disable-next-line @typescript-eslint/promise-function-async
-export function cancelablePromise(promise, cancelationPromise) {
-    return new Promise((resolve, reject) => {
-        let pending = true;
-        const pendingResolve = (result) => {
-            if (pending) {
-                resolve(result);
-                pending = false;
+import { CancellationToken } from '../cancellation/token.js';
+import { CustomPromise } from './custom-promise.js';
+export class CancelablePromise extends CustomPromise {
+    #cancellationToken = new CancellationToken();
+    #resolve;
+    #reject;
+    #pending = true;
+    constructor(executor) {
+        super();
+        this.#resolve = (value) => {
+            if (this.#pending) {
+                this.resolve(value);
+                this.#pending = false;
             }
         };
-        const pendingReject = (reason) => {
-            if (pending) {
-                reject(reason);
-                pending = false;
+        this.#reject = (reason) => {
+            if (this.#pending) {
+                this.reject(reason);
+                this.#pending = false;
             }
         };
-        promise
-            .then((value) => pendingResolve({ canceled: false, value }))
-            .catch(pendingReject);
-        // eslint-disable-next-line @typescript-eslint/no-floating-promises
-        cancelationPromise
-            .then(() => pendingResolve({ canceled: true }));
-    });
+        executor((value) => this.#resolve(Promise.resolve(value).then((result) => ({ canceled: false, value: result }))), this.#reject, this.#cancellationToken.signal);
+    }
+    cancel(reason) {
+        this.#cancellationToken.set();
+        this.#resolve({ canceled: true, reason });
+    }
 }

package/promise/custom-promise.d.ts

@@ -0,0 +1,6 @@
+import type { PromiseRejectFunction, PromiseResolveFunction } from './types.js';
+export declare class CustomPromise<T> extends Promise<T> {
+    protected readonly resolve: PromiseResolveFunction<T>;
+    protected readonly reject: PromiseRejectFunction;
+    constructor();
+}

package/promise/custom-promise.js

@@ -0,0 +1,14 @@
+export class CustomPromise extends Promise {
+    resolve;
+    reject;
+    constructor() {
+        let _resolve;
+        let _reject;
+        super((resolve, reject) => {
+            _resolve = resolve;
+            _reject = reject;
+        });
+        this.resolve = _resolve;
+        this.reject = _reject;
+    }
+}