@privateaim/kit 0.8.21 → 0.8.23

package/src/constants.ts

@@ -11,6 +11,15 @@ export enum EnvironmentName {
     PRODUCTION = 'production',
 }
 
+export enum ProcessStatus {
+    STARTING = 'starting',
+    STARTED = 'started',
+    STOPPING = 'stopping',
+    STOPPED = 'stopped',
+    FINISHED = 'finished',
+    FAILED = 'failed',
+}
+
 export const MINUTE_IN_MS = 1000 * 60;
 export const HOUR_IN_MS = MINUTE_IN_MS * 60;
 export const DAY_IN_MS = HOUR_IN_MS * 24;

package/src/error.ts

@@ -0,0 +1,10 @@
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+export class HubError extends Error {
+
+}

package/src/index.ts

@@ -7,6 +7,7 @@
 
 export * from './crypto';
 export * from './domains';
+export * from './error';
 export * from './domain-event';
 export * from './utils';
 export * from './constants';

package/src/types.ts

@@ -16,3 +16,5 @@ export type ObjectDiff<T extends ObjectLiteral = ObjectLiteral> = {
         previous?: T[K]
     }
 };
+
+export type ToTuple<T> = T extends [unknown, ...unknown[]] | [] ? T : [T];

package/src/utils/file-size.ts

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2026.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+export function humanFileSize(bytes: number, si : boolean = false, dp : number = 1) {
+    const thresh = si ? 1000 : 1024;
+
+    if (Math.abs(bytes) < thresh) {
+        return `${bytes} B`;
+    }
+
+    const units = si ?
+        ['kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'] :
+        ['KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
+    let u = -1;
+    const r = 10 ** dp;
+
+    do {
+        bytes /= thresh;
+        ++u;
+    } while (Math.round(Math.abs(bytes) * r) / r >= thresh && u < units.length - 1);
+
+    return `${bytes.toFixed(dp)} ${units[u]}`;
+}

package/src/utils/index.ts

@@ -7,6 +7,7 @@
 
 export * from './boolean';
 export * from './error';
+export * from './file-size';
 export * from './has-own-property';
 export * from './hex-checker';
 export * from './hostname';

package/dist/index.cjs

@@ -1,575 +0,0 @@
-'use strict';
-
-var coreKit = require('@authup/core-kit');
-var nanoid = require('nanoid');
-
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ var AsymmetricCryptoAlgorithmName = /*#__PURE__*/ function(AsymmetricCryptoAlgorithmName) {
-    AsymmetricCryptoAlgorithmName["RSA_OAEP"] = "RSA-OAEP";
-    AsymmetricCryptoAlgorithmName["ECDH"] = "ECDH";
-    return AsymmetricCryptoAlgorithmName;
-}({});
-
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, key, arg) {
-    try {
-        var info = gen[key](arg);
-        var value = info.value;
-    } catch (error) {
-        reject(error);
-        return;
-    }
-    if (info.done) {
-        resolve(value);
-    } else {
-        Promise.resolve(value).then(_next, _throw);
-    }
-}
-function _async_to_generator$2(fn) {
-    return function() {
-        var self = this, args = arguments;
-        return new Promise(function(resolve, reject) {
-            var gen = fn.apply(self, args);
-            function _next(value) {
-                asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, "next", value);
-            }
-            function _throw(err) {
-                asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, "throw", err);
-            }
-            _next(undefined);
-        });
-    };
-}
-function arrayBufferToBase64(arrayBuffer) {
-    return btoa(String.fromCharCode.apply(null, new Uint8Array(arrayBuffer)));
-}
-function exportAsymmetricPublicKey(key) {
-    return _async_to_generator$2(function*() {
-        const exported = yield crypto.subtle.exportKey('spki', key);
-        return `-----BEGIN PUBLIC KEY-----\n${arrayBufferToBase64(exported)}\n-----END PUBLIC KEY-----`;
-    })();
-}
-function exportAsymmetricPrivateKey(key) {
-    return _async_to_generator$2(function*() {
-        const exported = yield crypto.subtle.exportKey('pkcs8', key);
-        return `-----BEGIN PRIVATE KEY-----\n${arrayBufferToBase64(exported)}\n-----END PRIVATE KEY-----`;
-    })();
-}
-
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
-    try {
-        var info = gen[key](arg);
-        var value = info.value;
-    } catch (error) {
-        reject(error);
-        return;
-    }
-    if (info.done) {
-        resolve(value);
-    } else {
-        Promise.resolve(value).then(_next, _throw);
-    }
-}
-function _async_to_generator$1(fn) {
-    return function() {
-        var self = this, args = arguments;
-        return new Promise(function(resolve, reject) {
-            var gen = fn.apply(self, args);
-            function _next(value) {
-                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "next", value);
-            }
-            function _throw(err) {
-                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "throw", err);
-            }
-            _next(undefined);
-        });
-    };
-}
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _object_spread(target) {
-    for(var i = 1; i < arguments.length; i++){
-        var source = arguments[i] != null ? arguments[i] : {};
-        var ownKeys = Object.keys(source);
-        if (typeof Object.getOwnPropertySymbols === "function") {
-            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
-                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
-            }));
-        }
-        ownKeys.forEach(function(key) {
-            _define_property(target, key, source[key]);
-        });
-    }
-    return target;
-}
-function ownKeys(object, enumerableOnly) {
-    var keys = Object.keys(object);
-    if (Object.getOwnPropertySymbols) {
-        var symbols = Object.getOwnPropertySymbols(object);
-        keys.push.apply(keys, symbols);
-    }
-    return keys;
-}
-function _object_spread_props(target, source) {
-    source = source != null ? source : {};
-    if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-    } else {
-        ownKeys(Object(source)).forEach(function(key) {
-            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
-        });
-    }
-    return target;
-}
-class CryptoAsymmetricAlgorithm {
-    generateKeyPair() {
-        return _async_to_generator$1(function*() {
-            if (this.algorithm.name === AsymmetricCryptoAlgorithmName.RSA_OAEP) {
-                this.keyPair = yield crypto.subtle.generateKey(this.algorithm, true, [
-                    'encrypt',
-                    'decrypt'
-                ]);
-                return this.keyPair;
-            }
-            if (this.algorithm.name === AsymmetricCryptoAlgorithmName.ECDH) {
-                this.keyPair = yield crypto.subtle.generateKey(this.algorithm, true, [
-                    'deriveKey'
-                ]);
-                return this.keyPair;
-            }
-            throw new Error('The algorithm is not supported for key generation.');
-        }).call(this);
-    }
-    constructor(algorithm){
-        _define_property(this, "algorithm", void 0);
-        _define_property(this, "keyPair", void 0);
-        if (algorithm.name === AsymmetricCryptoAlgorithmName.RSA_OAEP) {
-            algorithm = _object_spread_props(_object_spread({}, algorithm), {
-                publicExponent: new Uint8Array([
-                    1,
-                    0,
-                    1
-                ])
-            });
-        }
-        this.algorithm = algorithm;
-    }
-}
-
-/*
- * Copyright (c) 2021-2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ var PermissionName = /*#__PURE__*/ function(PermissionName) {
-    PermissionName["EVENT_CREATE"] = "event_create";
-    PermissionName["EVENT_READ"] = "event_read";
-    PermissionName["EVENT_DELETE"] = "event_delete";
-    PermissionName["BUCKET_CREATE"] = "bucket_create";
-    PermissionName["BUCKET_UPDATE"] = "bucket_update";
-    PermissionName["BUCKET_DELETE"] = "bucket_delete";
-    PermissionName["LOG_CREATE"] = "log_create";
-    PermissionName["LOG_DELETE"] = "log_delete";
-    PermissionName["LOG_READ"] = "log_read";
-    PermissionName["PROJECT_CREATE"] = "project_create";
-    PermissionName["PROJECT_DELETE"] = "project_delete";
-    PermissionName["PROJECT_UPDATE"] = "project_update";
-    PermissionName["PROJECT_APPROVE"] = "project_approve";
-    PermissionName["REGISTRY_MANAGE"] = "registry_manage";
-    PermissionName["REGISTRY_PROJECT_MANAGE"] = "registry_project_manage";
-    PermissionName["NODE_CREATE"] = "node_create";
-    PermissionName["NODE_DELETE"] = "node_delete";
-    PermissionName["NODE_UPDATE"] = "node_update";
-    PermissionName["ANALYSIS_APPROVE"] = "analysis_approve";
-    PermissionName["ANALYSIS_UPDATE"] = "analysis_update";
-    PermissionName["ANALYSIS_CREATE"] = "analysis_create";
-    PermissionName["ANALYSIS_EXECUTION_START"] = "analysis_execution_start";
-    PermissionName["ANALYSIS_EXECUTION_STOP"] = "analysis_execution_stop";
-    PermissionName["ANALYSIS_DELETE"] = "analysis_delete";
-    PermissionName["ANALYSIS_RESULT_READ"] = "analysis_result_read";
-    PermissionName["ANALYSIS_SELF_MESSAGE_BROKER_USE"] = "analysis_self_message_broker_use";
-    PermissionName["ANALYSIS_SELF_STORAGE_USE"] = "analysis_self_storage_use";
-    PermissionName["MASTER_IMAGE_MANAGE"] = "master_image_manage";
-    PermissionName["MASTER_IMAGE_GROUP_MANAGE"] = "master_image_group_manage";
-    PermissionName["SERVICE_MANAGE"] = "service_manage";
-    return PermissionName;
-}({});
-
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function isBoolTrue(input) {
-    return typeof input === 'boolean' && !!input;
-}
-function isBoolFalse(input) {
-    return typeof input === 'boolean' && !input;
-}
-function isBool(input) {
-    return typeof input === 'boolean';
-}
-
-/*
- * Copyright (c) 2021-2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ // eslint-disable-next-line @typescript-eslint/ban-types
-function hasOwnProperty(obj, prop) {
-    return Object.prototype.hasOwnProperty.call(obj, prop);
-}
-function isPropertySet(obj, prop) {
-    return hasOwnProperty(obj, prop);
-}
-
-function isError(e) {
-    return typeof e === 'object' && e && hasOwnProperty(e, 'message');
-}
-function extractErrorMessage(e) {
-    return e.message;
-}
-
-/*
- * Copyright (c) 2021-2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function isHex(value) {
-    return /^[A-Fa-f0-9]+$/i.test(value);
-}
-function hexToUTF8(value) {
-    try {
-        return decodeURIComponent(`%${value.match(/.{1,2}/g).join('%')}`);
-    } catch (e) {
-        if (e instanceof URIError) {
-            return value;
-        }
-        throw e;
-    }
-}
-
-/*
- * Copyright (c) 2022-2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function getHostNameFromString(value) {
-    if (value.startsWith('http://') || value.startsWith('https://')) {
-        const url = new URL(value);
-        value = url.hostname;
-    }
-    return value;
-}
-
-/*
- * Copyright (c) 2025.
- *  Author Peter Placzek (tada5hi)
- *  For the full copyright and license information,
- *  view the LICENSE file that was distributed with this source code.
- */ function isObject(item) {
-    return !!item && typeof item === 'object' && !Array.isArray(item);
-}
-
-function createNanoID(alphabetOrLen, len) {
-    if (typeof alphabetOrLen === 'string') {
-        return nanoid.customAlphabet(alphabetOrLen, len || 21)();
-    }
-    if (typeof alphabetOrLen === 'number') {
-        return nanoid.customAlphabet('0123456789abcdefghijklmnopqrstuvwxyz', alphabetOrLen)();
-    }
-    return nanoid.customAlphabet('0123456789abcdefghijklmnopqrstuvwxyz', len || 21)();
-}
-
-/*
- * Copyright (c) 2025.
- *  Author Peter Placzek (tada5hi)
- *  For the full copyright and license information,
- *  view the LICENSE file that was distributed with this source code.
- */ function nanoSeconds() {
-    return BigInt(Math.floor(performance.timeOrigin)) * 1000000n + BigInt(Math.floor(performance.now() * 1000000));
-}
-
-/*
- * Copyright (c) 2021-2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function nullifyEmptyObjectProperties(data) {
-    const keys = Object.keys(data);
-    for(let i = 0; i < keys.length; i++){
-        const key = keys[i];
-        if (data[key] === '') {
-            data[key] = null;
-        }
-    }
-    return data;
-}
-function deleteUndefinedObjectProperties(data) {
-    const keys = Object.keys(data);
-    for(let i = 0; i < keys.length; i++){
-        if (typeof data[keys[i]] === 'undefined') {
-            delete data[keys[i]];
-        }
-    }
-    return data;
-}
-
-/*
- * Copyright (c) 2021-2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function parseProxyConnectionString(connectionStr) {
-    const match = connectionStr.match(/(?:(https|http):\/\/)(?:(\w+)(?::(\w+))?@)?(?:([^:]+))(?::(\d{1,5}))?$/);
-    if (!match) {
-        return undefined;
-    }
-    return {
-        protocol: match[1],
-        host: match[4],
-        port: parseInt(match[5], 10),
-        auth: {
-            username: match[2],
-            password: match[3]
-        }
-    };
-}
-function detectProxyConnectionConfig() {
-    const envKeys = [
-        'https_proxy',
-        'HTTPS_PROXY',
-        'http_proxy',
-        'HTTP_PROXY'
-    ];
-    let result;
-    for(let i = 0; i < envKeys.length; i++){
-        const envKey = envKeys[i];
-        const envVal = process.env[envKey];
-        if (envVal !== undefined && envVal !== null) {
-            result = result || envVal;
-        }
-    }
-    if (!result) {
-        return undefined;
-    }
-    return parseProxyConnectionString(result);
-}
-
-/*
- * Copyright (c) 2023-2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ const alphaNumHyphenUnderscoreRegex = /^[a-z0-9-_]*$/;
-const registryRobotSecretRegex = /^(?=.*[A-Z])(?=.*[a-z])(?=.*\d).{8,}$/;
-
-/*
- * Copyright (c) 2025.
- *  Author Peter Placzek (tada5hi)
- *  For the full copyright and license information,
- *  view the LICENSE file that was distributed with this source code.
- */ function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
-    try {
-        var info = gen[key](arg);
-        var value = info.value;
-    } catch (error) {
-        reject(error);
-        return;
-    }
-    if (info.done) {
-        resolve(value);
-    } else {
-        Promise.resolve(value).then(_next, _throw);
-    }
-}
-function _async_to_generator(fn) {
-    return function() {
-        var self = this, args = arguments;
-        return new Promise(function(resolve, reject) {
-            var gen = fn.apply(self, args);
-            function _next(value) {
-                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
-            }
-            function _throw(err) {
-                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
-            }
-            _next(undefined);
-        });
-    };
-}
-function wait(ms) {
-    return _async_to_generator(function*() {
-        return new Promise((resolve)=>{
-            setTimeout(resolve, ms);
-        });
-    })();
-}
-
-/**
- * Check if a realm resource is writable.
- *
- * @param realm
- * @param resourceRealmId
- */ function isRealmResourceWritable(realm, resourceRealmId) {
-    if (Array.isArray(resourceRealmId)) {
-        for(let i = 0; i < resourceRealmId.length; i++){
-            if (isRealmResourceWritable(realm, resourceRealmId[i])) {
-                return true;
-            }
-        }
-        return false;
-    }
-    if (!realm) {
-        return false;
-    }
-    if (isPropertySet(realm, 'name') && realm.name === coreKit.REALM_MASTER_NAME) {
-        return true;
-    }
-    return (realm === null || realm === void 0 ? void 0 : realm.id) === resourceRealmId;
-}
-/**
- * Check if realm resource is readable.
- *
- * @param realm
- * @param resourceRealmId
- */ function isRealmResourceReadable(realm, resourceRealmId) {
-    if (Array.isArray(resourceRealmId)) {
-        if (resourceRealmId.length === 0) {
-            return true;
-        }
-        for(let i = 0; i < resourceRealmId.length; i++){
-            if (isRealmResourceReadable(realm, resourceRealmId[i])) {
-                return true;
-            }
-        }
-        return false;
-    }
-    if (typeof realm === 'undefined') {
-        return false;
-    }
-    if (isPropertySet(realm, 'name') && realm.name === coreKit.REALM_MASTER_NAME) {
-        return true;
-    }
-    return !resourceRealmId || (realm === null || realm === void 0 ? void 0 : realm.id) === resourceRealmId;
-}
-
-/*
- * Copyright (c) 2025.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ var DomainEventName = /*#__PURE__*/ function(DomainEventName) {
-    DomainEventName["CREATED"] = "created";
-    DomainEventName["DELETED"] = "deleted";
-    DomainEventName["UPDATED"] = "updated";
-    return DomainEventName;
-}({});
-const DomainEventNamespace = 'resources';
-
-/*
- * Copyright (c) 2025.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function buildDomainChannelName(domain, id) {
-    if (typeof id === 'string' || typeof id === 'number') {
-        return `${domain}:${id}`;
-    }
-    return domain;
-}
-// todo: rename to buildEntityNamespaceName
-function buildDomainNamespaceName(id) {
-    return id ? `/resources:${id}` : '/resources';
-}
-
-/*
- * Copyright (c) 2025.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function buildDomainEventFullName(type, event) {
-    const eventCapitalized = event.substring(0, 1).toUpperCase() + event.substring(1);
-    return type + eventCapitalized;
-}
-
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ var EnvironmentName = /*#__PURE__*/ function(EnvironmentName) {
-    EnvironmentName["TEST"] = "test";
-    EnvironmentName["DEVELOPMENT"] = "development";
-    EnvironmentName["PRODUCTION"] = "production";
-    return EnvironmentName;
-}({});
-const MINUTE_IN_MS = 1000 * 60;
-const HOUR_IN_MS = MINUTE_IN_MS * 60;
-const DAY_IN_MS = HOUR_IN_MS * 24;
-const WEEK_IN_MS = DAY_IN_MS * 7;
-const MONTH_IN_MS = WEEK_IN_MS * 4;
-
-exports.AsymmetricCryptoAlgorithmName = AsymmetricCryptoAlgorithmName;
-exports.CryptoAsymmetricAlgorithm = CryptoAsymmetricAlgorithm;
-exports.DAY_IN_MS = DAY_IN_MS;
-exports.DomainEventName = DomainEventName;
-exports.DomainEventNamespace = DomainEventNamespace;
-exports.EnvironmentName = EnvironmentName;
-exports.HOUR_IN_MS = HOUR_IN_MS;
-exports.MINUTE_IN_MS = MINUTE_IN_MS;
-exports.MONTH_IN_MS = MONTH_IN_MS;
-exports.PermissionName = PermissionName;
-exports.WEEK_IN_MS = WEEK_IN_MS;
-exports.alphaNumHyphenUnderscoreRegex = alphaNumHyphenUnderscoreRegex;
-exports.buildDomainChannelName = buildDomainChannelName;
-exports.buildDomainEventFullName = buildDomainEventFullName;
-exports.buildDomainNamespaceName = buildDomainNamespaceName;
-exports.createNanoID = createNanoID;
-exports.deleteUndefinedObjectProperties = deleteUndefinedObjectProperties;
-exports.detectProxyConnectionConfig = detectProxyConnectionConfig;
-exports.exportAsymmetricPrivateKey = exportAsymmetricPrivateKey;
-exports.exportAsymmetricPublicKey = exportAsymmetricPublicKey;
-exports.extractErrorMessage = extractErrorMessage;
-exports.getHostNameFromString = getHostNameFromString;
-exports.hasOwnProperty = hasOwnProperty;
-exports.hexToUTF8 = hexToUTF8;
-exports.isBool = isBool;
-exports.isBoolFalse = isBoolFalse;
-exports.isBoolTrue = isBoolTrue;
-exports.isError = isError;
-exports.isHex = isHex;
-exports.isObject = isObject;
-exports.isPropertySet = isPropertySet;
-exports.isRealmResourceReadable = isRealmResourceReadable;
-exports.isRealmResourceWritable = isRealmResourceWritable;
-exports.nanoSeconds = nanoSeconds;
-exports.nullifyEmptyObjectProperties = nullifyEmptyObjectProperties;
-exports.parseProxyConnectionString = parseProxyConnectionString;
-exports.registryRobotSecretRegex = registryRobotSecretRegex;
-exports.wait = wait;
-//# sourceMappingURL=index.cjs.map