@candlerip/shared 0.0.47 → 0.0.51

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@candlerip/shared",
-  "version": "0.0.47",
+  "version": "0.0.51",
   "type": "module",
   "engines": {
     "node": "=22.19.0"
   },
-  "main": "src/index.js",
   "bin": {
     "crs-cdk-deploy": "devops/cdk/cdk-deploy.sh",
     "crs-create-env-file": "src/devops/env-file/create-env-file/index.js",
@@ -16,14 +15,25 @@
     "crs-tsc-build": "devops/typescript/tsc-build.sh",
     "crs-tsc-watch": "devops/typescript/tsc-watch.sh"
   },
+  "exports": {
+    "./aws": "./dist/aws/index.js",
+    "./backend/cache": "./dist/backend/cache/index.js",
+    "./backend/database": "./dist/backend/database/index.js",
+    "./backend/environment": "./dist/backend/environment/index.js",
+    "./backend/page": "./dist/backend/page/index.js",
+    "./backend/server": "./dist/backend/server/index.js",
+    "./common": "./dist/common/index.js"
+  },
   "scripts": {
     "dev": "sh ./devops/typescript/tsc-watch.sh"
   },
   "dependencies": {
     "@aws-sdk/client-ssm": "^3.917.0",
     "eslint": "^9.28.0",
-    "globals": "^16.2.0",
+    "mongoose": "^8.19.2",
     "prettier": "^3.5.3",
+    "redis": "^5.9.0",
+    "sharp": "^0.34.4",
     "tsc-alias": "^1.8.16",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.33.1",
@@ -31,6 +41,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.9.1",
-    "@types/yargs": "^17.0.34"
+    "@types/yargs": "^17.0.34",
+    "globals": "^16.4.0"
   }
 }

package/src/aws/index.d.ts

@@ -0,0 +1 @@
+export * from './s3/index.js';

package/src/aws/index.js

@@ -0,0 +1 @@
+export * from './s3/index.js';

package/src/aws/s3/index.d.ts

@@ -0,0 +1 @@
+export * from './workers/index.js';

package/src/aws/s3/index.js

@@ -0,0 +1 @@
+export * from './workers/index.js';

package/src/aws/s3/workers/aws-s3-url-worker/configs.d.ts

@@ -0,0 +1,4 @@
+export declare const S3_URL_TEMPLATE = "https://s3.<AWS_REGION>.amazonaws.com";
+export declare const SUBFOLDER_PATH_TEMPLATE: {
+    backgroundImageTemplate: string;
+};

package/src/aws/s3/workers/aws-s3-url-worker/configs.js

@@ -0,0 +1,4 @@
+export const S3_URL_TEMPLATE = `https://s3.<AWS_REGION>.amazonaws.com`;
+export const SUBFOLDER_PATH_TEMPLATE = {
+    backgroundImageTemplate: 'assets/background/<IMAGE_FILENAME>.webp',
+};

package/src/aws/s3/workers/aws-s3-url-worker/index.d.ts

@@ -0,0 +1,2 @@
+import { TAwsS3UrlWorker } from './types.js';
+export declare const AwsS3UrlWorker: TAwsS3UrlWorker;

package/src/aws/s3/workers/aws-s3-url-worker/index.js

@@ -0,0 +1,9 @@
+import { BACKGROUND_IMAGES } from '../../../../common/index.js';
+import { S3_URL_TEMPLATE, SUBFOLDER_PATH_TEMPLATE } from './configs.js';
+export const AwsS3UrlWorker = ({ awsRegion, awsS3ImagesBucketName }) => {
+    const bucketUrl = `${S3_URL_TEMPLATE.replace('<AWS_REGION>', awsRegion)}/${awsS3ImagesBucketName}`;
+    const composeBackgroundImageUrl = (screen) => `${bucketUrl}/${SUBFOLDER_PATH_TEMPLATE.backgroundImageTemplate.replace('<IMAGE_FILENAME>', BACKGROUND_IMAGES[screen])}`;
+    return {
+        composeBackgroundImageUrl,
+    };
+};

package/src/aws/s3/workers/aws-s3-url-worker/types.d.ts

@@ -0,0 +1,8 @@
+import { Screen } from '../../../../common/index.js';
+export type TAwsS3UrlWorker = (props: {
+    awsRegion: string;
+    awsS3ImagesBucketName: string;
+}) => {
+    composeBackgroundImageUrl: ComposeBackgroundImageUrl;
+};
+export type ComposeBackgroundImageUrl = (screen: Screen) => string;

package/src/aws/s3/workers/index.d.ts

@@ -0,0 +1 @@
+export * from './aws-s3-url-worker/index.js';

package/src/aws/s3/workers/index.js

@@ -0,0 +1 @@
+export * from './aws-s3-url-worker/index.js';

package/src/backend/cache/cache/domains.d.ts

@@ -0,0 +1,16 @@
+import { CandlesPageServerData, CountryDictionary, Dictionary, HomePageServerData, PersonsMapPageServerData, PersonsPageServerData } from '../../../common/index.js';
+import { CountryDictionaryCacheKey, PageDictionaryCacheKey } from '../cache-key/index.js';
+export type Cache = {
+    [key in PageDictionaryCacheKey]: Dictionary;
+} & {
+    [key in CountryDictionaryCacheKey]: CountryDictionary;
+} & {
+    'candles-page-server-data-en': CandlesPageServerData;
+    'candles-page-server-data-hu': CandlesPageServerData;
+    'home-page-server-data-en': HomePageServerData;
+    'home-page-server-data-hu': HomePageServerData;
+    'persons-page-server-data-en': PersonsPageServerData;
+    'persons-page-server-data-hu': PersonsPageServerData;
+    'persons-map-page-server-data-en': PersonsMapPageServerData;
+    'persons-map-page-server-data-hu': PersonsMapPageServerData;
+};

package/src/backend/cache/cache/index.d.ts

@@ -0,0 +1,2 @@
+export * from './domains.js';
+export * from './singletons/index.js';

package/src/backend/cache/cache/index.js

@@ -0,0 +1,2 @@
+export * from './domains.js';
+export * from './singletons/index.js';

package/src/backend/cache/cache/singletons/base/index.d.ts

@@ -0,0 +1,12 @@
+import { GetClient, Init } from './type.js';
+export declare const BaseSingleton: {
+    errorWorker: {
+        addErrorInfo: import("../../../../../common/error/workers/type.js").AddErrorInfo;
+        addErrorMessage: import("../../../../../common/error/workers/type.js").AddErrorMessage;
+        composeError: import("../../../../../common/error/workers/type.js").ComposeError;
+        getError: import("../../../../../common/error/workers/type.js").GetError;
+        resetError: import("../../../../../common/error/workers/type.js").ResetError;
+    };
+    getClient: GetClient;
+    init: Init;
+};

package/src/backend/cache/cache/singletons/base/index.js

@@ -0,0 +1,51 @@
+import { createClient } from 'redis';
+import { composeError, ErrorWorker } from '../../../../../common/index.js';
+export const BaseSingleton = (() => {
+    let _client;
+    let _isEnabled;
+    const errorWorker = ErrorWorker();
+    const getClient = () => {
+        const resp = errorWorker.getError();
+        if (resp) {
+            return resp;
+        }
+        if (!_client) {
+            return {
+                error: composeError('CacheSingleton not initialized'),
+            };
+        }
+        return {
+            data: _client,
+        };
+    };
+    const init = (url, password, options) => {
+        const error = errorWorker.getError();
+        if (error) {
+            return error;
+        }
+        _isEnabled = Boolean(options?.isEnabled);
+        if (!_isEnabled) {
+            errorWorker.addErrorMessage('Cache disabled');
+            return errorWorker.getError();
+        }
+        errorWorker.addErrorMessage('Redis initializing...');
+        _client = createClient({
+            password,
+            url,
+        });
+        _client.on('error', (err) => {
+            errorWorker.addErrorMessage('Error connect Redis');
+            errorWorker.addErrorInfo({ err });
+        });
+        _client.on('ready', () => {
+            console.info('Successfully connected to Redis!');
+            errorWorker.resetError();
+        });
+        _client.connect();
+    };
+    return {
+        errorWorker,
+        getClient,
+        init,
+    };
+})();

package/src/backend/cache/cache/singletons/base/type.d.ts

@@ -0,0 +1,9 @@
+import { createClient } from 'redis';
+import { Error, TError } from '../../../../../common/index.js';
+export type RedisClient = ReturnType<typeof createClient>;
+export type GetClient = () => TError<RedisClient>;
+export type Init = (url: string, password: string, options?: {
+    isEnabled?: boolean;
+}) => {
+    error: Error;
+} | undefined;

package/src/backend/cache/cache/singletons/index.d.ts

@@ -0,0 +1,7 @@
+import { GetCache, MGetCache, SetCache } from './type.js';
+export declare const CacheSingleton: {
+    getCache: GetCache;
+    init: import("./base/type.js").Init;
+    mGetCache: MGetCache;
+    setCache: SetCache;
+};

package/src/backend/cache/cache/singletons/index.js

@@ -0,0 +1,92 @@
+import { composeError, ErrorWorker, isArray, isString } from '../../../../common/index.js';
+import { BaseSingleton } from './base/index.js';
+export const CacheSingleton = (() => {
+    const { getClient, init } = BaseSingleton;
+    const getCache = async (key) => {
+        const errorWorker = ErrorWorker();
+        errorWorker.addErrorInfo({ key });
+        const { data: client, error } = getClient();
+        if (error) {
+            return { error };
+        }
+        let data;
+        try {
+            const cache = await client.get(key);
+            if (cache) {
+                data = JSON.parse(cache);
+            }
+        }
+        catch (err) {
+            return {
+                error: composeError('Error get data from Redis', { err }),
+            };
+        }
+        if (!data) {
+            return {
+                error: composeError('No data in Redis'),
+            };
+        }
+        return {
+            data,
+        };
+    };
+    const mGetCache = async (keys) => {
+        const errorWorker = ErrorWorker();
+        errorWorker.addErrorInfo({ keys });
+        const { data: client, error } = getClient();
+        if (error) {
+            return { error };
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const data = {};
+        try {
+            const cache = await client.mGet(keys);
+            if (!isArray(cache, isString)) {
+                return {
+                    error: composeError('Error get data from redis', { cache }),
+                };
+            }
+            cache.forEach((it, i) => {
+                data[keys[i]] = JSON.parse(it);
+            });
+        }
+        catch (err) {
+            return {
+                error: composeError('Error get data from redis', { err }),
+            };
+        }
+        if (Object.keys(data).length !== keys.length) {
+            return {
+                error: composeError('Missing data from redis', { data }),
+            };
+        }
+        return {
+            data,
+        };
+    };
+    const setCache = async (key, data) => {
+        const errorWorker = ErrorWorker();
+        errorWorker.addErrorInfo({ data, key });
+        const { data: client, error } = getClient();
+        if (error) {
+            return { error };
+        }
+        try {
+            await client.set(key, JSON.stringify(data));
+        }
+        catch (err) {
+            return {
+                error: composeError('Error set data to redis', { err }),
+            };
+        }
+        return {
+            data: null,
+        };
+    };
+    return {
+        getCache,
+        init,
+        mGetCache,
+        setCache,
+    };
+})();

package/src/backend/cache/cache/singletons/type.d.ts

@@ -0,0 +1,6 @@
+import { TError } from '../../../../common/index.js';
+import { CacheKey } from '../../cache-key/index.js';
+import { Cache } from '../domains.js';
+export type GetCache = <T extends CacheKey = never, D extends Cache[T] = Cache[T]>(key: T) => Promise<TError<D>>;
+export type MGetCache = <T extends CacheKey = never, D extends Pick<Cache, T> = Pick<Cache, T>>(keys: T[]) => Promise<TError<D>>;
+export type SetCache = <T extends CacheKey = never>(key: T, data: Cache[T]) => Promise<TError<null>>;

package/src/backend/cache/cache-key/configs/cache-keys.d.ts

@@ -0,0 +1 @@
+export declare const CACHE_KEYS: readonly ["country-dictionary-en", "country-dictionary-hu", "add-person-page-dictionary-en", "add-person-page-dictionary-hu", "candle-details-page-dictionary-en", "candle-details-page-dictionary-hu", "candles-page-dictionary-en", "candles-page-dictionary-hu", "contact-page-dictionary-en", "contact-page-dictionary-hu", "cookie-policy-page-dictionary-en", "cookie-policy-page-dictionary-hu", "edit-candle-page-dictionary-en", "edit-candle-page-dictionary-hu", "edit-person-page-dictionary-en", "edit-person-page-dictionary-hu", "light-candle-page-dictionary-en", "light-candle-page-dictionary-hu", "help-page-dictionary-en", "help-page-dictionary-hu", "home-page-dictionary-en", "home-page-dictionary-hu", "person-candles-page-dictionary-en", "person-candles-page-dictionary-hu", "person-details-page-dictionary-en", "person-details-page-dictionary-hu", "persons-page-dictionary-en", "persons-page-dictionary-hu", "persons-map-page-dictionary-en", "persons-map-page-dictionary-hu", "terms-and-conditions-page-dictionary-en", "terms-and-conditions-page-dictionary-hu", "candle-details-page-dictionary-en", "candle-details-page-dictionary-hu", "candles-page-server-data-en", "candles-page-server-data-hu", "home-page-server-data-en", "home-page-server-data-hu", "persons-page-server-data-en", "persons-page-server-data-hu", "persons-map-page-server-data-en", "persons-map-page-server-data-hu"];

package/src/backend/cache/cache-key/configs/cache-keys.js

@@ -0,0 +1,4 @@
+import { COUNTRY_DICTIONARY_CACHE_KEYS } from './country-dictionary-cache-keys.js';
+import { PAGE_DICTIONARY_CACHE_KEYS } from './page-dictionary-cache-keys.js';
+import { PAGE_SERVER_DATA_CACHE_KEYS } from './page-server-data-cache-keys.js';
+export const CACHE_KEYS = [...COUNTRY_DICTIONARY_CACHE_KEYS, ...PAGE_DICTIONARY_CACHE_KEYS, ...PAGE_SERVER_DATA_CACHE_KEYS];

package/src/backend/cache/cache-key/configs/country-dictionary-cache-keys.d.ts

@@ -0,0 +1 @@
+export declare const COUNTRY_DICTIONARY_CACHE_KEYS: readonly ["country-dictionary-en", "country-dictionary-hu"];

package/src/backend/cache/cache-key/configs/country-dictionary-cache-keys.js

@@ -0,0 +1 @@
+export const COUNTRY_DICTIONARY_CACHE_KEYS = ['country-dictionary-en', 'country-dictionary-hu'];

package/src/backend/cache/cache-key/configs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './cache-keys.js';
+export * from './country-dictionary-cache-keys.js';
+export * from './page-dictionary-cache-keys.js';
+export * from './page-server-data-cache-keys.js';

package/src/backend/cache/cache-key/configs/index.js

@@ -0,0 +1,4 @@
+export * from './cache-keys.js';
+export * from './country-dictionary-cache-keys.js';
+export * from './page-dictionary-cache-keys.js';
+export * from './page-server-data-cache-keys.js';

package/src/backend/cache/cache-key/configs/page-dictionary-cache-keys.d.ts

@@ -0,0 +1 @@
+export declare const PAGE_DICTIONARY_CACHE_KEYS: readonly ["add-person-page-dictionary-en", "add-person-page-dictionary-hu", "candle-details-page-dictionary-en", "candle-details-page-dictionary-hu", "candles-page-dictionary-en", "candles-page-dictionary-hu", "contact-page-dictionary-en", "contact-page-dictionary-hu", "cookie-policy-page-dictionary-en", "cookie-policy-page-dictionary-hu", "edit-candle-page-dictionary-en", "edit-candle-page-dictionary-hu", "edit-person-page-dictionary-en", "edit-person-page-dictionary-hu", "light-candle-page-dictionary-en", "light-candle-page-dictionary-hu", "help-page-dictionary-en", "help-page-dictionary-hu", "home-page-dictionary-en", "home-page-dictionary-hu", "person-candles-page-dictionary-en", "person-candles-page-dictionary-hu", "person-details-page-dictionary-en", "person-details-page-dictionary-hu", "persons-page-dictionary-en", "persons-page-dictionary-hu", "persons-map-page-dictionary-en", "persons-map-page-dictionary-hu", "terms-and-conditions-page-dictionary-en", "terms-and-conditions-page-dictionary-hu"];

package/src/backend/cache/cache-key/configs/page-dictionary-cache-keys.js

@@ -0,0 +1,32 @@
+export const PAGE_DICTIONARY_CACHE_KEYS = [
+    'add-person-page-dictionary-en',
+    'add-person-page-dictionary-hu',
+    'candle-details-page-dictionary-en',
+    'candle-details-page-dictionary-hu',
+    'candles-page-dictionary-en',
+    'candles-page-dictionary-hu',
+    'contact-page-dictionary-en',
+    'contact-page-dictionary-hu',
+    'cookie-policy-page-dictionary-en',
+    'cookie-policy-page-dictionary-hu',
+    'edit-candle-page-dictionary-en',
+    'edit-candle-page-dictionary-hu',
+    'edit-person-page-dictionary-en',
+    'edit-person-page-dictionary-hu',
+    'light-candle-page-dictionary-en',
+    'light-candle-page-dictionary-hu',
+    'help-page-dictionary-en',
+    'help-page-dictionary-hu',
+    'home-page-dictionary-en',
+    'home-page-dictionary-hu',
+    'person-candles-page-dictionary-en',
+    'person-candles-page-dictionary-hu',
+    'person-details-page-dictionary-en',
+    'person-details-page-dictionary-hu',
+    'persons-page-dictionary-en',
+    'persons-page-dictionary-hu',
+    'persons-map-page-dictionary-en',
+    'persons-map-page-dictionary-hu',
+    'terms-and-conditions-page-dictionary-en',
+    'terms-and-conditions-page-dictionary-hu',
+];

package/src/backend/cache/cache-key/configs/page-server-data-cache-keys.d.ts

@@ -0,0 +1 @@
+export declare const PAGE_SERVER_DATA_CACHE_KEYS: readonly ["candle-details-page-dictionary-en", "candle-details-page-dictionary-hu", "candles-page-server-data-en", "candles-page-server-data-hu", "home-page-server-data-en", "home-page-server-data-hu", "persons-page-server-data-en", "persons-page-server-data-hu", "persons-map-page-server-data-en", "persons-map-page-server-data-hu"];

package/src/backend/cache/cache-key/configs/page-server-data-cache-keys.js

@@ -0,0 +1,12 @@
+export const PAGE_SERVER_DATA_CACHE_KEYS = [
+    'candle-details-page-dictionary-en',
+    'candle-details-page-dictionary-hu',
+    'candles-page-server-data-en',
+    'candles-page-server-data-hu',
+    'home-page-server-data-en',
+    'home-page-server-data-hu',
+    'persons-page-server-data-en',
+    'persons-page-server-data-hu',
+    'persons-map-page-server-data-en',
+    'persons-map-page-server-data-hu',
+];

package/src/backend/cache/cache-key/domains/cache-key.d.ts

@@ -0,0 +1,4 @@
+import { CountryDictionaryCacheKey } from './country-dictionary-cache-key.js';
+import { PageDictionaryCacheKey } from './page-dictionary-cache-key.js';
+import { PageServerDataCacheKey } from './page-server-data-cache-key.js';
+export type CacheKey = CountryDictionaryCacheKey | PageDictionaryCacheKey | PageServerDataCacheKey;

package/src/backend/cache/cache-key/domains/country-dictionary-cache-key.d.ts

@@ -0,0 +1,2 @@
+import { COUNTRY_DICTIONARY_CACHE_KEYS } from '../configs/index.js';
+export type CountryDictionaryCacheKey = (typeof COUNTRY_DICTIONARY_CACHE_KEYS)[number];

package/src/backend/cache/cache-key/domains/index.d.ts

@@ -0,0 +1,4 @@
+export * from './cache-key.js';
+export * from './country-dictionary-cache-key.js';
+export * from './page-dictionary-cache-key.js';
+export * from './page-server-data-cache-key.js';

package/src/backend/cache/cache-key/domains/index.js

@@ -0,0 +1,4 @@
+export * from './cache-key.js';
+export * from './country-dictionary-cache-key.js';
+export * from './page-dictionary-cache-key.js';
+export * from './page-server-data-cache-key.js';

package/src/backend/cache/cache-key/domains/page-dictionary-cache-key.d.ts

@@ -0,0 +1,2 @@
+import { PAGE_DICTIONARY_CACHE_KEYS } from '../configs/index.js';
+export type PageDictionaryCacheKey = (typeof PAGE_DICTIONARY_CACHE_KEYS)[number];

package/src/backend/cache/cache-key/domains/page-server-data-cache-key.d.ts

@@ -0,0 +1,2 @@
+import { PAGE_SERVER_DATA_CACHE_KEYS } from '../configs/index.js';
+export type PageServerDataCacheKey = (typeof PAGE_SERVER_DATA_CACHE_KEYS)[number];

package/src/backend/cache/cache-key/index.d.ts

@@ -0,0 +1,3 @@
+export * from './configs/index.js';
+export * from './domains/index.js';
+export * from './type-guards.js';

package/src/backend/cache/cache-key/index.js

@@ -0,0 +1,3 @@
+export * from './configs/index.js';
+export * from './domains/index.js';
+export * from './type-guards.js';

package/src/backend/cache/cache-key/type-guards.d.ts

@@ -0,0 +1,2 @@
+import { CacheKey } from './domains/index.js';
+export declare const isCacheKey: (data?: unknown) => data is CacheKey;

package/src/backend/cache/cache-key/type-guards.js

@@ -0,0 +1,2 @@
+import { CACHE_KEYS } from './configs/index.js';
+export const isCacheKey = (data) => CACHE_KEYS.some((it) => data === it);

package/src/backend/cache/index.d.ts

@@ -0,0 +1,2 @@
+export * from './cache/index.js';
+export * from './cache-key/index.js';

package/src/backend/cache/index.js

@@ -0,0 +1,2 @@
+export * from './cache/index.js';
+export * from './cache-key/index.js';

package/src/backend/database/aggregate/candle/index.d.ts

@@ -0,0 +1 @@
+export * from './utils/index.js';

package/src/backend/database/aggregate/candle/index.js

@@ -0,0 +1 @@
+export * from './utils/index.js';

package/src/backend/database/aggregate/candle/utils/compose-get-candle-aggregates/index.d.ts

@@ -0,0 +1,2 @@
+import { ComposeGetCandleAggregates } from './type.js';
+export declare const composeGetCandleAggregates: ComposeGetCandleAggregates;