@pallasoft/ps-utilities 1.0.7 → 1.2.2

package/dist/client/http-service.d.ts

@@ -0,0 +1,20 @@
+export interface CreateApiClientOptions {
+    apiKey?: string;
+    apiKeyHeader?: string;
+    baseURL?: string;
+}
+export interface PsHttpRequestConfig {
+    headers?: Record<string, string>;
+}
+export declare class HttpService {
+    static createApiClient(options?: CreateApiClientOptions): {
+        get: <T>(url: string, config?: PsHttpRequestConfig) => Promise<{
+            data: T;
+            status: number;
+        }>;
+        post: <T>(url: string, data?: unknown, config?: PsHttpRequestConfig) => Promise<{
+            data: T;
+            status: number;
+        }>;
+    };
+}

package/dist/client/http-service.js

@@ -0,0 +1,98 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpService = void 0;
+var HttpService = /** @class */ (function () {
+    function HttpService() {
+    }
+    HttpService.createApiClient = function (options) {
+        var _this = this;
+        if (options === void 0) { options = {}; }
+        var apiKey = options.apiKey, _a = options.apiKeyHeader, apiKeyHeader = _a === void 0 ? 'X-API-Key' : _a, baseURL = options.baseURL;
+        var request = function (method, url, data, config) { return __awaiter(_this, void 0, void 0, function () {
+            var fullUrl, headers, response, contentType, responseData, _a, error;
+            var _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        fullUrl = baseURL ? "".concat(baseURL).concat(url) : url;
+                        headers = { 'Content-Type': 'application/json' };
+                        if (apiKey)
+                            headers[apiKeyHeader] = apiKey;
+                        if (config === null || config === void 0 ? void 0 : config.headers)
+                            Object.assign(headers, config.headers);
+                        return [4 /*yield*/, fetch(fullUrl, {
+                                method: method,
+                                headers: headers,
+                                body: data !== undefined ? JSON.stringify(data) : undefined,
+                            })];
+                    case 1:
+                        response = _c.sent();
+                        contentType = (_b = response.headers.get('content-type')) !== null && _b !== void 0 ? _b : '';
+                        if (!contentType.includes('application/json')) return [3 /*break*/, 3];
+                        return [4 /*yield*/, response.json()];
+                    case 2:
+                        _a = _c.sent();
+                        return [3 /*break*/, 5];
+                    case 3: return [4 /*yield*/, response.text()];
+                    case 4:
+                        _a = _c.sent();
+                        _c.label = 5;
+                    case 5:
+                        responseData = _a;
+                        if (!response.ok) {
+                            error = new Error("Request failed with status ".concat(response.status));
+                            error.response = { data: responseData, status: response.status };
+                            throw error;
+                        }
+                        return [2 /*return*/, { data: responseData, status: response.status }];
+                }
+            });
+        }); };
+        return {
+            get: function (url, config) {
+                return request('GET', url, undefined, config);
+            },
+            post: function (url, data, config) {
+                return request('POST', url, data, config);
+            },
+        };
+    };
+    return HttpService;
+}());
+exports.HttpService = HttpService;

package/dist/client/index.d.ts

@@ -0,0 +1 @@
+export * from './http-service';

package/dist/client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./http-service"), exports);

package/dist/common/color-service.d.ts

@@ -0,0 +1,3 @@
+export declare class ColorService {
+    static hexToRgb(hex: string): [number, number, number];
+}

package/dist/common/color-service.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColorService = void 0;
+var ColorService = /** @class */ (function () {
+    function ColorService() {
+    }
+    ColorService.hexToRgb = function (hex) {
+        var result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+        return result
+            ? [parseInt(result[1], 16), parseInt(result[2], 16), parseInt(result[3], 16)]
+            : [0, 0, 0];
+    };
+    return ColorService;
+}());
+exports.ColorService = ColorService;

package/dist/common/crypto-service.d.ts

@@ -0,0 +1,19 @@
+export declare class CryptoService {
+    private static _algorithm;
+    private static _keyLength;
+    private static _iterations;
+    private static _ivLength;
+    private static _saltLength;
+    private static _textEncoder;
+    private static _textDecoder;
+    private static _payloadVersion;
+    private static _payloadAlgorithm;
+    private static _aad;
+    private static _toBase64;
+    private static _fromBase64;
+    private static _getAdditionalData;
+    private static _parsePayload;
+    private static _deriveKey;
+    static encryptPayload(payload: Record<string, unknown>, cryptoKey: string): Promise<string>;
+    static decryptPayload<T>(encryptedPayload: string, cryptoKey: string): Promise<T>;
+}

package/dist/common/crypto-service.js

@@ -0,0 +1,158 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CryptoService = void 0;
+var CryptoService = /** @class */ (function () {
+    function CryptoService() {
+    }
+    CryptoService._toBase64 = function (bytes) {
+        var binary = '';
+        for (var index = 0; index < bytes.length; index += 1) {
+            binary += String.fromCharCode(bytes[index]);
+        }
+        return btoa(binary);
+    };
+    CryptoService._fromBase64 = function (value) {
+        var binary = atob(value);
+        var bytes = new Uint8Array(binary.length);
+        for (var index = 0; index < binary.length; index += 1) {
+            bytes[index] = binary.charCodeAt(index);
+        }
+        return bytes;
+    };
+    CryptoService._getAdditionalData = function () {
+        return this._textEncoder.encode(this._aad);
+    };
+    CryptoService._parsePayload = function (encryptedPayload) {
+        var payload = JSON.parse(encryptedPayload);
+        if (payload.v !== this._payloadVersion ||
+            payload.alg !== this._payloadAlgorithm ||
+            !payload.iv ||
+            !payload.salt ||
+            !payload.ciphertext) {
+            throw new Error('Encrypted payload is malformed');
+        }
+        return payload;
+    };
+    CryptoService._deriveKey = function (cryptoKey, salt) {
+        return __awaiter(this, void 0, void 0, function () {
+            var baseKey;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, crypto.subtle.importKey('raw', this._textEncoder.encode(cryptoKey), 'PBKDF2', false, ['deriveKey'])];
+                    case 1:
+                        baseKey = _a.sent();
+                        return [4 /*yield*/, crypto.subtle.deriveKey({
+                                name: 'PBKDF2',
+                                hash: 'SHA-256',
+                                salt: salt,
+                                iterations: this._iterations,
+                            }, baseKey, {
+                                name: this._algorithm,
+                                length: this._keyLength,
+                            }, false, ['encrypt', 'decrypt'])];
+                    case 2: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    CryptoService.encryptPayload = function (payload, cryptoKey) {
+        return __awaiter(this, void 0, void 0, function () {
+            var iv, salt, key, encryptedBuffer, serializedPayload;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        iv = crypto.getRandomValues(new Uint8Array(this._ivLength));
+                        salt = crypto.getRandomValues(new Uint8Array(this._saltLength));
+                        return [4 /*yield*/, this._deriveKey(cryptoKey, salt)];
+                    case 1:
+                        key = _a.sent();
+                        return [4 /*yield*/, crypto.subtle.encrypt({
+                                name: this._algorithm,
+                                iv: iv,
+                                additionalData: this._getAdditionalData(),
+                            }, key, this._textEncoder.encode(JSON.stringify(payload)))];
+                    case 2:
+                        encryptedBuffer = _a.sent();
+                        serializedPayload = {
+                            v: this._payloadVersion,
+                            alg: this._payloadAlgorithm,
+                            iv: this._toBase64(iv),
+                            salt: this._toBase64(salt),
+                            ciphertext: this._toBase64(new Uint8Array(encryptedBuffer)),
+                        };
+                        return [2 /*return*/, JSON.stringify(serializedPayload)];
+                }
+            });
+        });
+    };
+    CryptoService.decryptPayload = function (encryptedPayload, cryptoKey) {
+        return __awaiter(this, void 0, void 0, function () {
+            var payload, key, decryptedBuffer;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        payload = this._parsePayload(encryptedPayload);
+                        return [4 /*yield*/, this._deriveKey(cryptoKey, this._fromBase64(payload.salt))];
+                    case 1:
+                        key = _a.sent();
+                        return [4 /*yield*/, crypto.subtle.decrypt({
+                                name: this._algorithm,
+                                iv: this._fromBase64(payload.iv),
+                                additionalData: this._getAdditionalData(),
+                            }, key, this._fromBase64(payload.ciphertext))];
+                    case 2:
+                        decryptedBuffer = _a.sent();
+                        return [2 /*return*/, JSON.parse(this._textDecoder.decode(decryptedBuffer))];
+                }
+            });
+        });
+    };
+    CryptoService._algorithm = 'AES-GCM';
+    CryptoService._keyLength = 256;
+    CryptoService._iterations = 100000;
+    CryptoService._ivLength = 12;
+    CryptoService._saltLength = 16;
+    CryptoService._textEncoder = new TextEncoder();
+    CryptoService._textDecoder = new TextDecoder();
+    CryptoService._payloadVersion = 1;
+    CryptoService._payloadAlgorithm = 'A256GCM';
+    CryptoService._aad = 'encrypted-form:v1:a256gcm';
+    return CryptoService;
+}());
+exports.CryptoService = CryptoService;

package/dist/common/index.d.ts

@@ -1,3 +1,7 @@
+export * from './color-service';
+export * from './crypto-service';
 export * from './date-service';
+export * from './number-format-service';
+export * from './recaptcha-service';
 export * from './url-service';
 export * from './string-service';

package/dist/common/index.js

@@ -14,6 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./color-service"), exports);
+__exportStar(require("./crypto-service"), exports);
 __exportStar(require("./date-service"), exports);
+__exportStar(require("./number-format-service"), exports);
+__exportStar(require("./recaptcha-service"), exports);
 __exportStar(require("./url-service"), exports);
 __exportStar(require("./string-service"), exports);

package/dist/common/number-format-service.d.ts

@@ -0,0 +1,5 @@
+export declare class NumberFormatService {
+    static formatCurrency(value: number, currencyCode: string, locale?: string, minimumFractionDigits?: number, maximumFractionDigits?: number): string;
+    static formatCompact(value: number, locale?: string): string;
+    static formatPercent(value: number, locale?: string): string;
+}

package/dist/common/number-format-service.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumberFormatService = void 0;
+var NumberFormatService = /** @class */ (function () {
+    function NumberFormatService() {
+    }
+    NumberFormatService.formatCurrency = function (value, currencyCode, locale, minimumFractionDigits, maximumFractionDigits) {
+        if (locale === void 0) { locale = 'en-US'; }
+        if (minimumFractionDigits === void 0) { minimumFractionDigits = 0; }
+        if (maximumFractionDigits === void 0) { maximumFractionDigits = 2; }
+        return new Intl.NumberFormat(locale, {
+            currency: currencyCode,
+            maximumFractionDigits: maximumFractionDigits,
+            minimumFractionDigits: minimumFractionDigits,
+            style: 'currency',
+        }).format(value);
+    };
+    NumberFormatService.formatCompact = function (value, locale) {
+        if (locale === void 0) { locale = 'en-US'; }
+        return new Intl.NumberFormat(locale, {
+            compactDisplay: 'short',
+            notation: 'compact',
+        }).format(value);
+    };
+    NumberFormatService.formatPercent = function (value, locale) {
+        if (locale === void 0) { locale = 'en-US'; }
+        return new Intl.NumberFormat(locale, {
+            maximumFractionDigits: 1,
+            style: 'percent',
+        }).format(value);
+    };
+    return NumberFormatService;
+}());
+exports.NumberFormatService = NumberFormatService;

package/dist/common/recaptcha-service.d.ts

@@ -0,0 +1,8 @@
+export interface RecaptchaVerifyResult {
+    success: boolean;
+    errorCodes: string[];
+}
+export declare class RecaptchaService {
+    private static _verifyUrl;
+    static verify(token: string, secretKey: string, remoteIp?: string): Promise<RecaptchaVerifyResult>;
+}

package/dist/common/recaptcha-service.js

@@ -0,0 +1,76 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecaptchaService = void 0;
+var RecaptchaService = /** @class */ (function () {
+    function RecaptchaService() {
+    }
+    RecaptchaService.verify = function (token, secretKey, remoteIp) {
+        return __awaiter(this, void 0, void 0, function () {
+            var params, response, data;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        params = new URLSearchParams({ secret: secretKey, response: token });
+                        if (remoteIp)
+                            params.set('remoteip', remoteIp);
+                        return [4 /*yield*/, fetch(this._verifyUrl, {
+                                method: 'POST',
+                                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                                body: params.toString(),
+                            })];
+                    case 1:
+                        response = _a.sent();
+                        if (!response.ok) {
+                            return [2 /*return*/, { success: false, errorCodes: ['verification-request-failed'] }];
+                        }
+                        return [4 /*yield*/, response.json()];
+                    case 2:
+                        data = (_a.sent());
+                        return [2 /*return*/, {
+                                success: !!data.success,
+                                errorCodes: data['error-codes'] || [],
+                            }];
+                }
+            });
+        });
+    };
+    RecaptchaService._verifyUrl = 'https://www.google.com/recaptcha/api/siteverify';
+    return RecaptchaService;
+}());
+exports.RecaptchaService = RecaptchaService;

package/dist/index.d.ts

@@ -1 +1,4 @@
-export * as Common from './common';
+import * as ClientNamespace from './client';
+import * as CommonNamespace from './common';
+export declare const Common: typeof CommonNamespace;
+export declare const Client: typeof ClientNamespace;

package/dist/index.js

@@ -33,5 +33,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Common = void 0;
-exports.Common = __importStar(require("./common"));
+exports.Client = exports.Common = void 0;
+var ClientNamespace = __importStar(require("./client"));
+var CommonNamespace = __importStar(require("./common"));
+exports.Common = CommonNamespace;
+exports.Client = ClientNamespace;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pallasoft/ps-utilities",
-	"version": "1.0.7",
+	"version": "1.2.2",
 	"private": false,
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -22,7 +22,8 @@
 		"format:check": "npx prettier --check --ignore-unknown \"src/**/*.{js,ts,json,md}\"",
 		"format:prettier": "npx prettier --write \"**/*.{js,ts,json,md}\"",
 		"lint:eslint": "npx eslint \"**/*.{js,ts}\"",
-		"lint:eslint:fix": "npx eslint --fix \"**/*.{js,ts}\""
+		"lint:eslint:fix": "npx eslint --fix \"**/*.{js,ts}\"",
+		"release": "semantic-release"
 	},
 	"devDependencies": {
 		"@commitlint/cli": "^20.1.0",
@@ -40,11 +41,23 @@
 		"lint-staged": "^16.2.7",
 		"prettier": "^3.6.2",
 		"ts-node": "^10.9.2",
-		"typescript": "^5.9.3"
+		"typescript": "^5.9.3",
+		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/commit-analyzer": "^13.0.0",
+		"@semantic-release/git": "^10.0.1",
+		"@semantic-release/github": "^11.0.1",
+		"@semantic-release/npm": "^12.0.0",
+		"@semantic-release/release-notes-generator": "^14.0.1",
+		"conventional-changelog-conventionalcommits": "^7.0.2",
+		"semantic-release": "^24.2.0"
 	},
 	"dependencies": {
 		"@esbuild-plugins/tsconfig-paths": "^0.1.2",
 		"dayjs": "^1.11.19",
 		"esbuild": "^0.27.0"
+	},
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
 	}
 }