@epam/statgpt-shared-toolkit 0.1.0-rc.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 EPAM Systems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# Shared Toolkit
+
+This library contains shared utilities, helper functions,
+and common logic used across multiple modules in the StatGPT portal frontend.
+It promotes code reuse and consistency throughout the project.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/mit)
+[![Typescript](https://img.shields.io/badge/Typescript-5+-61dafb.svg)](https://www.typescriptlang.org/)
+
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Contributing](#contributing)
+- [Security](#security)
+- [License](#license)
+
+## Features
+
+- Common utility functions
+- Shared type definitions
+- Reusable helpers for data processing and formatting
+- Navigation path utilities
+- Lightweight and minimal dependencies
+
+## Installation
+
+```bash
+npm install @epam/statgpt-shared-toolkit
+```
+
+## Usage
+
+```typescript
+import { getConversationNavPath } from '@epam/statgpt-shared-toolkit';
+
+const navPath = getConversationNavPath(folderId, conversationKey);
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://github.com/epam/statgpt-portal-frontend/blob/development/CONTRIBUTING.md) for details on:
+
+- Testing requirements
+- Pull request process
+
+
+## Security
+
+If you discover a security vulnerability, please refer to our [Security Policy](https://github.com/epam/statgpt-portal-frontend/blob/development/SECURITY.md).
+
+
+## License
+
+[MIT](https://github.com/epam/statgpt-portal-frontend/blob/development/LICENSE) - see the [LICENSE](https://github.com/epam/statgpt-portal-frontend/blob/development/LICENSE) file for details.

package/constants/api-urls.d.ts

@@ -0,0 +1,6 @@
+/**
+ * API route constants for Next.js app routes
+ */
+export declare const API_ROUTES: {
+    readonly CHAT: "/api/chat";
+};

package/constants/calendar.d.ts

@@ -0,0 +1 @@
+export declare const CUSTOM_PERIOD = "CUSTOM_PERIOD";

package/constants/format-numbers-default.d.ts

@@ -0,0 +1,2 @@
+import { FormatNumbersType } from '../models/format-numbers-type';
+export declare const defaultFormatNumbers: FormatNumbersType;

package/constants/headers.d.ts

@@ -0,0 +1,4 @@
+export declare const APPLICATION_JSON = "application/json";
+export declare const CONTENT_TYPE_HEADER = "Content-Type";
+export declare const API_KEY_HEADER = "Api-Key";
+export declare const X_CONVERSATION_ID_HEADER = "X-CONVERSATION-ID";

package/constants/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api-urls';
+export * from './calendar';
+export * from './format-numbers-default';
+export * from './headers';

package/index.d.ts

@@ -0,0 +1,4 @@
+export * from './constants';
+export * from './models';
+export * from './types';
+export * from './utils';

package/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S={CHAT:"/api/chat"},s="CUSTOM_PERIOD",o={decimal:"0.0",decimalSymbol:",",digitGroupingSymbol:" "},d="application/json",E="Content-Type",c="Api-Key",u="X-CONVERSATION-ID";var g=(e=>(e.MONTH="month",e.DAY="day",e))(g||{}),T=(e=>(e.UK="uk",e.EN="en",e))(T||{}),C=(e=>(e.IN="in",e.BETWEEN="between",e))(C||{});function O(e,t){const n=e.split("/")[0],r=t.split("/").pop();return`${n}/${r}`}const I=e=>(e==null?void 0:e.toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"-").replace(/^-+|-+$/g,"").replace(/-/g," "))||"";function N(e,t){return`${e==null?void 0:e[0]}/${t}/${e==null?void 0:e[1]}`}const _=(e,t)=>(Math.round(e*10**t)/10**t).toFixed(t),y=(e,t)=>{const n=(t==null?void 0:t.decimal)||o.decimal,r=(t==null?void 0:t.decimalSymbol)||o.decimalSymbol,a=(t==null?void 0:t.digitGroupingSymbol)??o.digitGroupingSymbol,i=Number(e);if(i==null||Number.isNaN(i)||e===null||e==="")return"";const A=n.replace("0.",""),l=`${n==="0"?Math.trunc(i):_(i,A.length)} `.split(".");return l[0]=l[0].replace(/(\d)(?=(\d\d\d)+(?!\d))/g,`$1${a}`),`${l.join(r)}`},R=e=>isNaN(Date.parse(e))?null:new Date(e),D=(e,t,n)=>{const r={[E]:(t==null?void 0:t.contentType)||d};return t!=null&&t.jwt?r.Authorization=`Bearer ${t.jwt}`:e&&(r[c]=e),t!=null&&t.chatReference&&(r[u]=t.chatReference),{...r,...n}},h=e=>{const t={...e};return t[c]&&(t[c]=t[c].substring(0,8)+"...[REDACTED]"),t.Authorization&&(t.Authorization="Bearer [REDACTED]"),t},b=e=>(e==null?void 0:e.toLowerCase())==="true",H=async(e,t,n)=>await fetch(e,{method:n.method||"GET",headers:t,body:n.body?JSON.stringify(n.body):void 0}),$=(e,t)=>{var n,r;return(r=(n=e==null?void 0:e.split("/"))==null?void 0:n.filter(a=>a!==t))==null?void 0:r.join("/")};exports.API_KEY_HEADER=c;exports.API_ROUTES=S;exports.APPLICATION_JSON=d;exports.CONTENT_TYPE_HEADER=E;exports.CUSTOM_PERIOD=s;exports.CalendarResolution=g;exports.Locale=T;exports.QueryFilterType=C;exports.X_CONVERSATION_ID_HEADER=u;exports.defaultFormatNumbers=o;exports.formatNumberBySign=y;exports.getClearedConversationName=I;exports.getConversationId=N;exports.getConversationNavPath=O;exports.getConversationUrlWithoutLocale=$;exports.getHeaders=D;exports.getTimePeriod=R;exports.parseBoolean=b;exports.sanitizeHeaders=h;exports.sendRequest=H;

package/index.mjs

@@ -0,0 +1,63 @@
+const h = {
+  CHAT: "/api/chat"
+}, D = "CUSTOM_PERIOD", o = {
+  decimal: "0.0",
+  decimalSymbol: ",",
+  digitGroupingSymbol: " "
+}, E = "application/json", g = "Content-Type", i = "Api-Key", S = "X-CONVERSATION-ID";
+var a = /* @__PURE__ */ ((t) => (t.MONTH = "month", t.DAY = "day", t))(a || {}), A = /* @__PURE__ */ ((t) => (t.UK = "uk", t.EN = "en", t))(A || {}), T = /* @__PURE__ */ ((t) => (t.IN = "in", t.BETWEEN = "between", t))(T || {});
+function I(t, e) {
+  const n = t.split("/")[0], c = e.split("/").pop();
+  return `${n}/${c}`;
+}
+const O = (t) => (t == null ? void 0 : t.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "").replace(/-/g, " ")) || "";
+function R(t, e) {
+  return `${t == null ? void 0 : t[0]}/${e}/${t == null ? void 0 : t[1]}`;
+}
+const C = (t, e) => (Math.round(t * 10 ** e) / 10 ** e).toFixed(e), N = (t, e) => {
+  const n = (e == null ? void 0 : e.decimal) || o.decimal, c = (e == null ? void 0 : e.decimalSymbol) || o.decimalSymbol, d = (e == null ? void 0 : e.digitGroupingSymbol) ?? o.digitGroupingSymbol, r = Number(t);
+  if (r == null || Number.isNaN(r) || t === null || t === "")
+    return "";
+  const u = n.replace("0.", ""), l = `${n === "0" ? Math.trunc(r) : C(r, u.length)} `.split(".");
+  return l[0] = l[0].replace(
+    /(\d)(?=(\d\d\d)+(?!\d))/g,
+    `$1${d}`
+  ), `${l.join(c)}`;
+}, _ = (t) => isNaN(Date.parse(t)) ? null : new Date(t), $ = (t, e, n) => {
+  const c = {
+    [g]: (e == null ? void 0 : e.contentType) || E
+  };
+  return e != null && e.jwt ? c.Authorization = `Bearer ${e.jwt}` : t && (c[i] = t), e != null && e.chatReference && (c[S] = e.chatReference), { ...c, ...n };
+}, b = (t) => {
+  const e = { ...t };
+  return e[i] && (e[i] = e[i].substring(0, 8) + "...[REDACTED]"), e.Authorization && (e.Authorization = "Bearer [REDACTED]"), e;
+}, s = (t) => (t == null ? void 0 : t.toLowerCase()) === "true", p = async (t, e, n) => await fetch(t, {
+  method: n.method || "GET",
+  headers: e,
+  body: n.body ? JSON.stringify(n.body) : void 0
+}), w = (t, e) => {
+  var n, c;
+  return (c = (n = t == null ? void 0 : t.split("/")) == null ? void 0 : n.filter((d) => d !== e)) == null ? void 0 : c.join("/");
+};
+export {
+  i as API_KEY_HEADER,
+  h as API_ROUTES,
+  E as APPLICATION_JSON,
+  g as CONTENT_TYPE_HEADER,
+  D as CUSTOM_PERIOD,
+  a as CalendarResolution,
+  A as Locale,
+  T as QueryFilterType,
+  S as X_CONVERSATION_ID_HEADER,
+  o as defaultFormatNumbers,
+  N as formatNumberBySign,
+  O as getClearedConversationName,
+  R as getConversationId,
+  I as getConversationNavPath,
+  w as getConversationUrlWithoutLocale,
+  $ as getHeaders,
+  _ as getTimePeriod,
+  s as parseBoolean,
+  b as sanitizeHeaders,
+  p as sendRequest
+};

package/models/api.d.ts

@@ -0,0 +1,7 @@
+import { API_KEY_HEADER, CONTENT_TYPE_HEADER, X_CONVERSATION_ID_HEADER } from '../constants/headers';
+export interface ApiHeaders {
+    Authorization?: string;
+    [CONTENT_TYPE_HEADER]?: string;
+    [API_KEY_HEADER]?: string;
+    [X_CONVERSATION_ID_HEADER]?: string;
+}

package/models/data-query.d.ts

@@ -0,0 +1,33 @@
+import { QueryFilterType } from '../types/query-filter-type';
+export interface DataQuery {
+    title?: string;
+    urn: string;
+    metadata: {
+        countryDimension: string;
+        indicatorDimensions: string[];
+    };
+    filters: QueryFilter[];
+}
+export interface JsonDataQuery {
+    urn: string;
+    metadata: {
+        country_dimension?: string;
+        countryDimension: string;
+        indicator_dimensions?: string[];
+        indicatorDimensions: string[];
+    };
+    filters: JsonQueryFilter[];
+}
+export interface QueryFilter {
+    componentCode: string;
+    operator: QueryFilterType;
+    values: string[];
+}
+export interface JsonQueryFilter extends QueryFilter {
+    component_code: string;
+}
+export interface QueryFilterDetails {
+    id: string;
+    title?: string;
+    valuesTitles?: string[];
+}

package/models/format-numbers-type.d.ts

@@ -0,0 +1,5 @@
+export interface FormatNumbersType {
+    decimal: string;
+    decimalSymbol: string;
+    digitGroupingSymbol: string;
+}

package/models/index.d.ts

@@ -0,0 +1,6 @@
+export * from './api';
+export * from './data-query';
+export * from './format-numbers-type';
+export * from './log-data';
+export * from './request-options';
+export * from './time-range';

package/models/log-data.d.ts

@@ -0,0 +1,6 @@
+export interface LogData {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: unknown;
+}

package/models/request-options.d.ts

@@ -0,0 +1,8 @@
+export interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    body?: unknown;
+    headers?: Record<string, string>;
+    jwt?: string;
+    chatReference?: string;
+    signal?: AbortSignal;
+}

package/models/time-range.d.ts

@@ -0,0 +1,8 @@
+export interface TimeRange {
+    startPeriod: Date | null;
+    endPeriod: Date | null;
+}
+export interface TimeRangeOptions {
+    value: number | string;
+    title: string;
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@epam/statgpt-shared-toolkit",
+  "version": "0.1.0-rc.0",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./index.cjs",
+      "types": "./index.d.ts"
+    }
+  },
+  "main": "./index.cjs",
+  "browser": "./index.mjs",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "dependencies": {
+    "@epam/ai-dial-shared": "^0.34.0"
+  }
+}

package/types/calendar.d.ts

@@ -0,0 +1,4 @@
+export declare enum CalendarResolution {
+    MONTH = "month",
+    DAY = "day"
+}

package/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './calendar';
+export * from './locale';
+export * from './query-filter-type';

package/types/locale.d.ts

@@ -0,0 +1,4 @@
+export declare enum Locale {
+    UK = "uk",
+    EN = "en"
+}

package/types/query-filter-type.d.ts

@@ -0,0 +1,4 @@
+export declare enum QueryFilterType {
+    IN = "in",
+    BETWEEN = "between"
+}

package/utils/conversation-id-to-navigation.d.ts

@@ -0,0 +1 @@
+export declare function getConversationNavPath(folderId: string, conversationKey: string): string;

package/utils/conversation-mapping.d.ts

@@ -0,0 +1,2 @@
+import { ConversationInfo } from '@epam/ai-dial-shared';
+export declare const cleanConversationNames: (conversations: ConversationInfo[]) => ConversationInfo[];

package/utils/conversation-name.d.ts

@@ -0,0 +1 @@
+export declare const getClearedConversationName: (conversationName?: string) => string;

package/utils/conversation-navigation-to-id.d.ts

@@ -0,0 +1 @@
+export declare function getConversationId(idParams: string[], locale: string): string;

package/utils/conversation-url.d.ts

@@ -0,0 +1 @@
+export declare const getConversationUrlWithoutLocale: (resourceUrl: string, locale: string) => string;

package/utils/format-numbers.d.ts

@@ -0,0 +1,2 @@
+import { FormatNumbersType } from '../models/format-numbers-type';
+export declare const formatNumberBySign: (num: string, formatNumbers: FormatNumbersType) => string;

package/utils/get-time-period.d.ts

@@ -0,0 +1 @@
+export declare const getTimePeriod: (timePeriod: string) => Date | null;

package/utils/headers.d.ts

@@ -0,0 +1,7 @@
+import { ApiHeaders } from '../models/api';
+export declare const getHeaders: (apiKey?: string, options?: {
+    jwt?: string;
+    chatReference?: string;
+    contentType?: string;
+}, optionsHeaders?: Record<string, string>) => Record<string, string>;
+export declare const sanitizeHeaders: (headers: ApiHeaders) => Record<string, string>;

package/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from './conversation-id-to-navigation';
+export * from './conversation-name';
+export * from './conversation-navigation-to-id';
+export * from './format-numbers';
+export * from './get-time-period';
+export * from './headers';
+export * from './parse-boolean';
+export * from './send-request';
+export * from './conversation-url';

package/utils/parse-boolean.d.ts

@@ -0,0 +1 @@
+export declare const parseBoolean: (value: string | undefined) => boolean;

package/utils/send-request.d.ts

@@ -0,0 +1,2 @@
+import { RequestOptions } from '../models/request-options';
+export declare const sendRequest: (url: string, headers: Record<string, string>, options: RequestOptions) => Promise<Response>;