@signstack/cli 0.1.1

package/dist/libs/common/base/src/lib/phone-util.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Convert a phone number string to a number string. This function removes all non-digit characters from the phone number string.
+ *
+ * @param phoneNumber The phone number string to convert.
+ *
+ * @returns The converted phone number string.
+ */
+export declare const convertToNumberString: (phoneNumber: string) => string;
+/**
+ * Format a phone number string to a standard format '+1 (XXX) XXX-XXXX'.
+ *
+ * @param phoneNumber The phone number string to format.
+ *
+ * @returns The formatted phone number string.
+ */
+export declare const formatPhoneNumber: (phoneNumber: string, addCountryCode?: boolean) => string;

package/dist/libs/common/base/src/lib/phone-util.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPhoneNumber = exports.convertToNumberString = void 0;
+/**
+ * Convert a phone number string to a number string. This function removes all non-digit characters from the phone number string.
+ *
+ * @param phoneNumber The phone number string to convert.
+ *
+ * @returns The converted phone number string.
+ */
+const convertToNumberString = (phoneNumber) => {
+    if (!phoneNumber) {
+        return '';
+    }
+    // Remove all non-digit characters from the phone number string
+    const cleanedNumber = phoneNumber.replace(/\D/g, '');
+    // Remove the country code (assuming it starts with '1')
+    const numberWithoutCountryCode = cleanedNumber.startsWith('1') && cleanedNumber.length > 10
+        ? cleanedNumber.slice(1)
+        : cleanedNumber;
+    return numberWithoutCountryCode;
+};
+exports.convertToNumberString = convertToNumberString;
+/**
+ * Format a phone number string to a standard format '+1 (XXX) XXX-XXXX'.
+ *
+ * @param phoneNumber The phone number string to format.
+ *
+ * @returns The formatted phone number string.
+ */
+const formatPhoneNumber = (phoneNumber, addCountryCode = false) => {
+    // Handle cases where input is just the country code or country code with space
+    if (phoneNumber.trim() === '+1') {
+        return '';
+    }
+    // Step 1: Normalize input by removing all non-digit characters
+    const digitsOnly = phoneNumber.replace(/\D/g, '');
+    // If after normalization, there are no digits, return an empty string
+    if (digitsOnly.length === 0) {
+        return '';
+    }
+    // Step 2: Limit to first 10 digits after country code
+    const localNumber = digitsOnly.substring(0, addCountryCode ? 11 : 10);
+    let formattedNumber = addCountryCode ? '+1 ' : '';
+    // Apply formatting
+    for (let i = 0; i < localNumber.length; i++) {
+        if (i === 0) {
+            formattedNumber += '(';
+        }
+        else if (i === 3) {
+            formattedNumber += ') ';
+        }
+        else if (i === 6) {
+            formattedNumber += '-';
+        }
+        formattedNumber += localNumber[i];
+    }
+    return formattedNumber;
+};
+exports.formatPhoneNumber = formatPhoneNumber;
+//# sourceMappingURL=phone-util.js.map

package/dist/libs/common/base/src/lib/phone-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-util.js","sourceRoot":"","sources":["../../../../../../../../libs/common/base/src/lib/phone-util.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,qBAAqB,GAAG,CAAC,WAAmB,EAAU,EAAE;IACnE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+DAA+D;IAC/D,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAErD,wDAAwD;IACxD,MAAM,wBAAwB,GAC5B,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,EAAE;QACxD,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACxB,CAAC,CAAC,aAAa,CAAC;IAEpB,OAAO,wBAAwB,CAAC;AAClC,CAAC,CAAC;AAfW,QAAA,qBAAqB,yBAehC;AAEF;;;;;;GAMG;AACI,MAAM,iBAAiB,GAAG,CAC/B,WAAmB,EACnB,iBAA0B,KAAK,EAC/B,EAAE;IACF,+EAA+E;IAC/E,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+DAA+D;IAC/D,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAElD,sEAAsE;IACtE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,sDAAsD;IACtD,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtE,IAAI,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAElD,mBAAmB;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACZ,eAAe,IAAI,GAAG,CAAC;QACzB,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,eAAe,IAAI,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,eAAe,IAAI,GAAG,CAAC;QACzB,CAAC;QACD,eAAe,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC;AAlCW,QAAA,iBAAiB,qBAkC5B"}

package/dist/libs/common/base/src/lib/schema-validation.util.d.ts

@@ -0,0 +1,24 @@
+import Ajv from 'ajv';
+export declare enum JsonSchemaDraft {
+    DRAFT_2020_12 = "2020-12",
+    DRAFT_2019_09 = "2019-09",
+    DRAFT_07 = "draft-07",
+    DRAFT_06 = "draft-06",
+    DRAFT_04 = "draft-04"
+}
+export interface SchemaValidationResult {
+    isValid: boolean;
+    errors?: any[];
+    errorMessage?: string;
+}
+export interface SchemaValidationOptions {
+    allErrors?: boolean;
+    verbose?: boolean;
+    strict?: boolean;
+    validateSchema?: boolean;
+    addFormats?: boolean;
+}
+export declare function validateSchema(schema: object, draft: JsonSchemaDraft, options?: SchemaValidationOptions): SchemaValidationResult;
+export declare function validateDataAgainstSchema(draft: JsonSchemaDraft, schema: object, data: any, options?: SchemaValidationOptions): SchemaValidationResult;
+export declare function createAjvInstance(draft: JsonSchemaDraft, options?: SchemaValidationOptions): Ajv;
+export declare function getDraftFromSchemaUrl(schemaUrl: string): JsonSchemaDraft | null;

package/dist/libs/common/base/src/lib/schema-validation.util.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonSchemaDraft = void 0;
+exports.validateSchema = validateSchema;
+exports.validateDataAgainstSchema = validateDataAgainstSchema;
+exports.createAjvInstance = createAjvInstance;
+exports.getDraftFromSchemaUrl = getDraftFromSchemaUrl;
+const tslib_1 = require("tslib");
+const ajv_1 = tslib_1.__importDefault(require("ajv"));
+const _2020_1 = tslib_1.__importDefault(require("ajv/dist/2020"));
+const _2019_1 = tslib_1.__importDefault(require("ajv/dist/2019"));
+const ajv_draft_04_1 = tslib_1.__importDefault(require("ajv-draft-04"));
+const ajv_formats_1 = tslib_1.__importDefault(require("ajv-formats"));
+var JsonSchemaDraft;
+(function (JsonSchemaDraft) {
+    JsonSchemaDraft["DRAFT_2020_12"] = "2020-12";
+    JsonSchemaDraft["DRAFT_2019_09"] = "2019-09";
+    JsonSchemaDraft["DRAFT_07"] = "draft-07";
+    JsonSchemaDraft["DRAFT_06"] = "draft-06";
+    JsonSchemaDraft["DRAFT_04"] = "draft-04";
+})(JsonSchemaDraft || (exports.JsonSchemaDraft = JsonSchemaDraft = {}));
+function validateSchema(schema, draft, options = {}) {
+    try {
+        const ajv = createAjvInstance(draft, options);
+        const isValid = ajv.validateSchema(schema);
+        if (!isValid) {
+            const errors = ajv.errors || [];
+            const errorMessages = errors
+                .map((error) => {
+                const path = error.instancePath || 'root';
+                return `${path}: ${error.message}`;
+            })
+                .join(', ');
+            return {
+                isValid: false,
+                errors,
+                errorMessage: `Invalid JSON Schema for ${draft}: ${errorMessages}`,
+            };
+        }
+        return {
+            isValid: true,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            isValid: false,
+            errorMessage: `Schema validation error: ${errorMessage}`,
+        };
+    }
+}
+function validateDataAgainstSchema(draft, schema, data, options = {}) {
+    try {
+        const ajv = createAjvInstance(draft, options);
+        const validate = ajv.compile(schema);
+        const isValid = validate(data);
+        if (!isValid) {
+            const errors = validate.errors || [];
+            const errorMessages = errors
+                .map((error) => {
+                const path = error.instancePath || 'root';
+                const keyword = error.keyword;
+                const message = error.message;
+                return `${path} (${keyword}): ${message}`;
+            })
+                .join(', ');
+            return {
+                isValid: false,
+                errors,
+                errorMessage: `Data validation failed: ${errorMessages}`,
+            };
+        }
+        return {
+            isValid: true,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            isValid: false,
+            errorMessage: `Data validation error: ${errorMessage}`,
+        };
+    }
+}
+function createAjvInstance(draft, options = {}) {
+    const { allErrors = true, verbose = true, strict = false, validateSchema = true, addFormats: shouldAddFormats = true, } = options;
+    let ajv;
+    switch (draft) {
+        case JsonSchemaDraft.DRAFT_04:
+            ajv = new ajv_draft_04_1.default({
+                allErrors,
+                verbose,
+                strict,
+                validateSchema,
+            });
+            break;
+        case JsonSchemaDraft.DRAFT_06:
+            ajv = new ajv_1.default({
+                schemaId: 'id',
+                meta: false,
+                allErrors,
+                verbose,
+                strict,
+                validateSchema,
+            });
+            ajv.addMetaSchema(require('ajv/lib/refs/json-schema-draft-06.json'));
+            break;
+        case JsonSchemaDraft.DRAFT_07:
+            ajv = new ajv_1.default({
+                schemaId: '$id',
+                allErrors,
+                verbose,
+                strict,
+                validateSchema,
+            });
+            break;
+        case JsonSchemaDraft.DRAFT_2019_09:
+            ajv = new _2019_1.default({
+                allErrors,
+                verbose,
+                strict,
+                validateSchema,
+            });
+            break;
+        case JsonSchemaDraft.DRAFT_2020_12:
+            ajv = new _2020_1.default({
+                allErrors,
+                verbose,
+                strict,
+                validateSchema,
+                addUsedSchema: false,
+            });
+            break;
+        default:
+            throw new Error(`Unsupported JSON Schema draft: ${draft}`);
+    }
+    if (shouldAddFormats) {
+        (0, ajv_formats_1.default)(ajv);
+    }
+    return ajv;
+}
+function getDraftFromSchemaUrl(schemaUrl) {
+    if (schemaUrl.includes('draft-04'))
+        return JsonSchemaDraft.DRAFT_04;
+    if (schemaUrl.includes('draft-06'))
+        return JsonSchemaDraft.DRAFT_06;
+    if (schemaUrl.includes('draft-07'))
+        return JsonSchemaDraft.DRAFT_07;
+    if (schemaUrl.includes('2019-09'))
+        return JsonSchemaDraft.DRAFT_2019_09;
+    if (schemaUrl.includes('2020-12'))
+        return JsonSchemaDraft.DRAFT_2020_12;
+    return null;
+}
+//# sourceMappingURL=schema-validation.util.js.map

package/dist/libs/common/base/src/lib/schema-validation.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validation.util.js","sourceRoot":"","sources":["../../../../../../../../libs/common/base/src/lib/schema-validation.util.ts"],"names":[],"mappings":"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"}

package/dist/libs/common/base/src/lib/string-builder.d.ts

@@ -0,0 +1,48 @@
+export declare class StringBuilder {
+    private readonly _parts;
+    static readonly newLinePlaceholder = "{newline}";
+    /**
+     * Append a string to the string builder.
+     *
+     * @param value The value to append.
+     */
+    append(value: any): StringBuilder;
+    /**
+     * Append a formatted string to the string builder.
+     *
+     * @param value The value to append.
+     * @param args The arguments to format the string with.
+     */
+    appendFormat(value: any, ...args: any[]): StringBuilder;
+    /**
+     * Append a line to the string builder.
+     *
+     * @param value The value to append.
+     */
+    appendLine(value?: any): StringBuilder;
+    /**
+     * Append a formatted line to the string builder.
+     *
+     * @param value The value to append.
+     * @param args The arguments to format the string with.
+     */
+    appendLineFormat(value: any, ...args: any[]): StringBuilder;
+    /**
+     * Clear the string builder.
+     */
+    clear(): StringBuilder;
+    /**
+     * Get the number of parts in the string builder.
+     *
+     * @returns The number of parts in the string builder.
+     */
+    size(): number;
+    /**
+     * Get the string representation of the string builder.
+     */
+    toString(): any;
+    /**
+     * Get the HTML string representation of the string builder.
+     */
+    toHtmlString(useBrTags?: boolean): any;
+}

package/dist/libs/common/base/src/lib/string-builder.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringBuilder = void 0;
+class StringBuilder {
+    _parts = [];
+    static newLinePlaceholder = '{newline}';
+    /**
+     * Append a string to the string builder.
+     *
+     * @param value The value to append.
+     */
+    append(value) {
+        value = typeof value === 'string' ? value : value.toString();
+        this._parts.push(value);
+        return this;
+    }
+    /**
+     * Append a formatted string to the string builder.
+     *
+     * @param value The value to append.
+     * @param args The arguments to format the string with.
+     */
+    appendFormat(value, ...args) {
+        value = typeof value === 'string' ? value : value.toString;
+        this._parts.push(value.replace(/{(\d+)}/g, (match, index) => {
+            const i = parseInt(index, 10);
+            return typeof args[i] !== 'undefined' ? args[i] : match;
+        }));
+        return this;
+    }
+    /**
+     * Append a line to the string builder.
+     *
+     * @param value The value to append.
+     */
+    appendLine(value = '') {
+        value = typeof value === 'string' ? value : value.toString;
+        this._parts.push(this._parts.length ? StringBuilder.newLinePlaceholder : '', value);
+        return this;
+    }
+    /**
+     * Append a formatted line to the string builder.
+     *
+     * @param value The value to append.
+     * @param args The arguments to format the string with.
+     */
+    appendLineFormat(value, ...args) {
+        value = typeof value === 'string' ? value : value.toString();
+        this._parts.push(this._parts.length ? StringBuilder.newLinePlaceholder : '', value.replace(/{(\d+)}/g, (match, index) => {
+            const i = parseInt(index, 10);
+            return typeof args[i] !== 'undefined' ? args[i] : match;
+        }));
+        return this;
+    }
+    /**
+     * Clear the string builder.
+     */
+    clear() {
+        this._parts.length = 0;
+        return this;
+    }
+    /**
+     * Get the number of parts in the string builder.
+     *
+     * @returns The number of parts in the string builder.
+     */
+    size() {
+        return this._parts.length;
+    }
+    /**
+     * Get the string representation of the string builder.
+     */
+    toString() {
+        return this._parts
+            .join('')
+            .replace(new RegExp(StringBuilder.newLinePlaceholder, 'g'), '\n');
+    }
+    /**
+     * Get the HTML string representation of the string builder.
+     */
+    toHtmlString(useBrTags = false) {
+        return this._parts
+            .join('')
+            .replace(new RegExp(StringBuilder.newLinePlaceholder, 'g'), useBrTags
+            ? '<br>'
+            : '<div class="mb-2" style="margin-bottom: 8px;"></div>');
+    }
+}
+exports.StringBuilder = StringBuilder;
+//# sourceMappingURL=string-builder.js.map

package/dist/libs/common/base/src/lib/string-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-builder.js","sourceRoot":"","sources":["../../../../../../../../libs/common/base/src/lib/string-builder.ts"],"names":[],"mappings":"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"}

package/dist/libs/common/base/src/lib/util.d.ts

@@ -0,0 +1,20 @@
+export declare enum TimeZone {
+    PST = "America/Los_Angeles"
+}
+export interface NumberRange {
+    from?: number;
+    to?: number;
+}
+export declare function formatToUSD(value: number): string;
+export declare function formatToUSDWithoutSymbol(value: number): string;
+export declare function convertCurrencyToWords(amount: number): string;
+export declare function convertNumberToWords(amount: number): string;
+export declare function convertNumberToCompactNumber(value: number): string;
+export declare function toWords(value: number, config?: any): string;
+export declare function isNumber(value: any): boolean;
+export declare function formatNumberRangeToText(range: NumberRange, config: {
+    suffix?: string;
+    prefix?: string;
+}): string;
+export declare function hasSomeValues(obj: object, keys: string[]): boolean;
+export declare function hasAllValues<T extends object>(obj: T | null | undefined, keys: string[]): obj is T;

package/dist/libs/common/base/src/lib/util.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeZone = void 0;
+exports.formatToUSD = formatToUSD;
+exports.formatToUSDWithoutSymbol = formatToUSDWithoutSymbol;
+exports.convertCurrencyToWords = convertCurrencyToWords;
+exports.convertNumberToWords = convertNumberToWords;
+exports.convertNumberToCompactNumber = convertNumberToCompactNumber;
+exports.toWords = toWords;
+exports.isNumber = isNumber;
+exports.formatNumberRangeToText = formatNumberRangeToText;
+exports.hasSomeValues = hasSomeValues;
+exports.hasAllValues = hasAllValues;
+const to_words_1 = require("to-words");
+const lodash_1 = require("lodash");
+var TimeZone;
+(function (TimeZone) {
+    TimeZone["PST"] = "America/Los_Angeles";
+})(TimeZone || (exports.TimeZone = TimeZone = {}));
+function formatToUSD(value) {
+    const currencyFormatter = new Intl.NumberFormat('en-US', {
+        currency: 'USD',
+        style: 'currency',
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+    });
+    return currencyFormatter.format(value);
+}
+function formatToUSDWithoutSymbol(value) {
+    const currencyFormatterWithoutSymbol = new Intl.NumberFormat('en-US', {
+        currency: 'USD',
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+    });
+    return currencyFormatterWithoutSymbol.format(value);
+}
+function convertCurrencyToWords(amount) {
+    return new to_words_1.ToWords({
+        localeCode: 'en-US',
+    }).convert(amount, {
+        currency: true,
+        ignoreDecimal: false,
+        ignoreZeroCurrency: false,
+    });
+}
+function convertNumberToWords(amount) {
+    return new to_words_1.ToWords({
+        localeCode: 'en-US',
+    }).convert(amount);
+}
+function convertNumberToCompactNumber(value) {
+    if (!isNumber(value))
+        return '';
+    return new Intl.NumberFormat('en-US', {
+        notation: 'compact',
+        maximumFractionDigits: 1,
+    }).format(value);
+}
+function toWords(value, config = {}) {
+    if (!value || Number.isNaN(value)) {
+        return '';
+    }
+    return new to_words_1.ToWords({
+        localeCode: 'en-US',
+    }).convert(value, {
+        currency: true,
+        ignoreDecimal: true,
+        ignoreZeroCurrency: false,
+        ...config,
+    });
+}
+function isNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value);
+}
+function formatNumberRangeToText(range, config) {
+    const prefix = config.prefix || '';
+    const suffix = config.suffix ? ` ${config.suffix}` : '';
+    if (!range || (!range.from && !range.to)) {
+        return '';
+    }
+    else if (range.from && range.to) {
+        if (range.from === range.to) {
+            return `${prefix}${range.from.toLocaleString()}${suffix}`;
+        }
+        else {
+            return `${prefix}${range.from.toLocaleString()} - ${prefix}${range.to.toLocaleString()}${suffix}`;
+        }
+    }
+    else if (range.from) {
+        return `from ${prefix}${range.from.toLocaleString()}${suffix}`;
+    }
+    else {
+        return `up to ${prefix}${range.to.toLocaleString()}${suffix}`;
+    }
+}
+function hasSomeValues(obj, keys) {
+    return (0, lodash_1.some)(keys, (k) => {
+        const v = (0, lodash_1.get)(obj, k);
+        return v != null && v !== '';
+    });
+}
+function hasAllValues(obj, keys) {
+    if (obj == null)
+        return false;
+    return (0, lodash_1.every)(keys, (k) => {
+        const v = (0, lodash_1.get)(obj, k);
+        return v != null && v !== '';
+    });
+}
+//# sourceMappingURL=util.js.map

package/dist/libs/common/base/src/lib/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../../../../../libs/common/base/src/lib/util.ts"],"names":[],"mappings":"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"}