@ptx-showcase/utils 0.6.0 → 1.1.0

package/README.md

@@ -20,7 +20,12 @@ bun add @ptx-showcase/utils
 
 ## Usage
 
-All utilities can be imported from the root package or from a specific subpath.
+All utilities can be imported from the root package, from a grouping subpath (`/base`, `/admin`, `/core`), or from each utility's own subpath.
+
+- `/base` — types and enums shared across projects (`TableColumnConfig`, `PaginatedList`, `ListQueryParams`, `DISCOUNT_TYPES`, `ORDER_STATUSES`, `SUPPORT_STATUSES`)
+- `/admin` — admin-panel-only concerns (`isAdminToken`, `ADMIN_QUERY_KEYS`); only relevant to admin projects
+- `/core` — every generic utility below, bundled together
+- Each generic utility is also importable on its own (`/cookies`, `/build-query-params`, etc.)
 
 ---
 
@@ -126,6 +131,35 @@ await downloadBlob(blob, { hash: 12345 })
 
 ---
 
+### Flags
+
+Resolves a flag icon URL for a language/country code, with a three-tier fallback: primary source ([flagcdn.com](https://flagcdn.com)) → secondary source ([flagicons.lipis.dev](https://flagicons.lipis.dev)) → an "unknown flag" placeholder. The placeholder is also returned directly when `languageCode` isn't a usable string at runtime (`null`, `undefined`, `NaN`, an object, an empty/whitespace string, etc.) — the functions never throw.
+
+`FLAG_CODE_ALIASES` maps language codes that differ from their representative country's ISO code (e.g. `en` → `gb`, `ja` → `jp`); codes with no entry are used as-is.
+
+```ts
+// from root
+import { getFlagUrl, handleFlagImageError } from '@ptx-showcase/utils'
+
+// from subpath
+import { getFlagUrl, handleFlagImageError } from '@ptx-showcase/utils/flags'
+
+getFlagUrl('fr') // → 'https://flagcdn.com/fr.svg'
+getFlagUrl('en') // → 'https://flagcdn.com/gb.svg' (resolved via FLAG_CODE_ALIASES)
+getFlagUrl(null as unknown as string) // → unknown-flag placeholder URL
+
+// React — escalates primary → fallback → unknown placeholder on load failure
+<img src={getFlagUrl(code)} onError={(e) => handleFlagImageError(e, code)} />
+
+// Vue
+<img :src="getFlagUrl(code)" @error="(e) => handleFlagImageError(e, code)" />
+
+// Svelte
+<img src={getFlagUrl(code)} on:error={(e) => handleFlagImageError(e, code)} />
+```
+
+---
+
 ### getCurrencySymbol
 
 Resolves the symbol for an ISO 4217 currency code via `Intl`. A handful of currencies (`AUD`, `CAD`, `NZD`, `CHF`, etc.) are overridden where the `Intl` narrow symbol would be ambiguous.
@@ -183,6 +217,24 @@ try {
 
 ---
 
+### isAdminToken
+
+Checks whether a JWT access token's payload has the `is_admin` claim set to `true`. Decodes the token locally without verifying its signature, so it only reflects what the token claims — signature verification is expected to have already happened server-side.
+
+```ts
+// from root
+import { isAdminToken } from '@ptx-showcase/utils'
+
+// from subpath
+import { isAdminToken } from '@ptx-showcase/utils/admin'
+
+isAdminToken(adminToken) // → true
+isAdminToken(regularUserToken) // → false
+isAdminToken('not-a-valid-jwt') // → false
+```
+
+---
+
 ### normalizeDecimalInput / normalizePhoneNumberInput
 
 In-place `input`/`change` event handlers that sanitize a text input's value as the user types.
@@ -236,18 +288,21 @@ truncateDecimals(undefined) // → 'N/A'
 
 ## Available modules
 
-| Subpath                                  | Exports                                                          |
-| ---------------------------------------- | ---------------------------------------------------------------- |
-| `@ptx-showcase/utils`                    | all utilities                                                    |
-| `@ptx-showcase/utils/build-query-params` | `buildQueryParams`                                               |
-| `@ptx-showcase/utils/build-sort-param`   | `buildSortParam`                                                 |
-| `@ptx-showcase/utils/cookies`            | `setCookie`, `getCookie`, `deleteCookie`, `defaultCookieOptions` |
-| `@ptx-showcase/utils/currency-symbol`    | `getCurrencySymbol`                                              |
-| `@ptx-showcase/utils/download-file`      | `downloadBlob`                                                   |
-| `@ptx-showcase/utils/handle-api-error`   | `handleApiError`, `initHandleApiError`                           |
-| `@ptx-showcase/utils/normalize-input`    | `normalizeDecimalInput`, `normalizePhoneNumberInput`             |
-| `@ptx-showcase/utils/truncate-decimals`  | `truncateDecimals`                                               |
-| `@ptx-showcase/utils/types`              | `TableColumnConfig`, `PaginatedList`                             |
+| Subpath                                  | Exports                                                                                                         |
+| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `@ptx-showcase/utils`                    | everything below                                                                                                |
+| `@ptx-showcase/utils/base`               | `TableColumnConfig`, `PaginatedList`, `ListQueryParams`, `DISCOUNT_TYPES`, `ORDER_STATUSES`, `SUPPORT_STATUSES` |
+| `@ptx-showcase/utils/admin`              | `isAdminToken`, `ADMIN_QUERY_KEYS` (admin-panel projects only)                                                  |
+| `@ptx-showcase/utils/core`               | every generic utility below, bundled together                                                                   |
+| `@ptx-showcase/utils/build-query-params` | `buildQueryParams`                                                                                              |
+| `@ptx-showcase/utils/build-sort-param`   | `buildSortParam`                                                                                                |
+| `@ptx-showcase/utils/cookies`            | `setCookie`, `getCookie`, `deleteCookie`, `defaultCookieOptions`                                                |
+| `@ptx-showcase/utils/currency-symbol`    | `getCurrencySymbol`                                                                                             |
+| `@ptx-showcase/utils/download-file`      | `downloadBlob`                                                                                                  |
+| `@ptx-showcase/utils/flags`              | `getFlagUrl`, `getFlagFallbackUrl`, `getFlagUnknownUrl`, `handleFlagImageError`, `FLAG_CODE_ALIASES`            |
+| `@ptx-showcase/utils/handle-api-error`   | `handleApiError`, `initHandleApiError`                                                                          |
+| `@ptx-showcase/utils/normalize-input`    | `normalizeDecimalInput`, `normalizePhoneNumberInput`                                                            |
+| `@ptx-showcase/utils/truncate-decimals`  | `truncateDecimals`                                                                                              |
 
 ---
 

package/dist/admin/constants/admin.constant.d.ts

@@ -0,0 +1,18 @@
+export declare const ADMIN_QUERY_KEYS: {
+    readonly USERS: string;
+    readonly SINGLE_USER: string;
+    readonly ORDERS: string;
+    readonly SINGLE_ORDER: string;
+    readonly DISCOUNTS: string;
+    readonly SINGLE_DISCOUNT: string;
+    readonly STATIC: string;
+    readonly SINGLE_STATIC: string;
+    readonly SUPPORT_REQUESTS: string;
+    readonly SINGLE_SUPPORT_REQUEST: string;
+    readonly AVALIABLE_CURRENCIES: string;
+    readonly ACTIVE_CURRENCIES: string;
+    readonly GATEWAYS: string;
+    readonly BANS: string;
+    readonly SWAGGER: string;
+    readonly BULK_EDIT: string;
+};

package/dist/admin/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/admin-DR1tBkNV.cjs");exports.ADMIN_QUERY_KEYS=e.n,exports.isAdminToken=e.t;

package/dist/admin/index.d.ts

@@ -0,0 +1,2 @@
+export { ADMIN_QUERY_KEYS } from './constants/admin.constant';
+export { isAdminToken } from './libs/is-admin-token';

package/dist/admin/index.js

@@ -0,0 +1,2 @@
+import { n as e, t } from "../chunks/admin-B3AZrTOb.es";
+export { e as ADMIN_QUERY_KEYS, t as isAdminToken };

package/dist/admin/libs/is-admin-token/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checks whether a JWT access token carries the `is_admin` claim set to `true`.
+ *
+ * Decodes the token locally without verifying its signature, so this only
+ * tells you what the token claims, not whether the token is trustworthy —
+ * signature verification is expected to have happened server-side already.
+ *
+ * @param accessToken - The JWT access token to check
+ * @returns `true` only if the token decodes successfully and its payload has
+ * `is_admin: true`; `false` if the claim is `false`, missing, or the token
+ * can't be decoded at all
+ *
+ * @example
+ * ```ts
+ * isAdminToken(adminToken) // => true
+ * isAdminToken(regularUserToken) // => false
+ * isAdminToken('not-a-valid-jwt') // => false
+ * ```
+ */
+export declare const isAdminToken: (accessToken: string) => boolean;

package/dist/admin/libs/is-admin-token/types/is-admin-token.type.d.ts

@@ -0,0 +1,4 @@
+import { JwtPayload } from 'jwt-decode';
+export interface JwtAdminPayload extends JwtPayload {
+    is_admin?: boolean;
+}

package/dist/base/constants/base.constant.d.ts

@@ -0,0 +1,15 @@
+export declare const DISCOUNT_TYPES: {
+    readonly MONEY: "money";
+    readonly PERCENT: "percent";
+};
+export declare const ORDER_STATUSES: {
+    readonly PENDING: "PENDING";
+    readonly COMPLETED: "COMPLETED";
+    readonly FAILED: "FAILED";
+    readonly CANCELED: "CANCELED";
+};
+export declare const SUPPORT_STATUSES: {
+    readonly PENDING: "PENDING";
+    readonly SOLVED: "SOLVED";
+    readonly CLOSED: "CLOSED";
+};

package/dist/base/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/base-DLHy3wps.cjs");exports.DISCOUNT_TYPES=e.t,exports.ORDER_STATUSES=e.n,exports.SUPPORT_STATUSES=e.r;

package/dist/base/index.d.ts

@@ -0,0 +1,2 @@
+export { DISCOUNT_TYPES, ORDER_STATUSES, SUPPORT_STATUSES } from './constants/base.constant';
+export type { DiscountType, OrderStatus, SupportStatus, TableColumnConfig, PaginatedList, ListQueryParams } from './types/base.type';

package/dist/base/index.js

@@ -0,0 +1,2 @@
+import { n as e, r as t, t as n } from "../chunks/base-C5926Kyt.es";
+export { n as DISCOUNT_TYPES, e as ORDER_STATUSES, t as SUPPORT_STATUSES };

package/dist/base/types/base.type.d.ts

@@ -0,0 +1,23 @@
+import { DISCOUNT_TYPES, ORDER_STATUSES, SUPPORT_STATUSES } from '../constants/base.constant';
+export interface TableColumnConfig<T, ExtraKeys extends string = never> {
+    id?: number;
+    label: string;
+    key: keyof T | ExtraKeys;
+    sortable?: boolean;
+}
+export interface PaginatedList<T> {
+    items: T[];
+    page: number;
+    per_page: number;
+    total_items: number;
+    total_pages: number;
+}
+export interface ListQueryParams {
+    search?: string;
+    sort?: string;
+    page?: number;
+    per_page?: number;
+}
+export type OrderStatus = (typeof ORDER_STATUSES)[keyof typeof ORDER_STATUSES];
+export type SupportStatus = (typeof SUPPORT_STATUSES)[keyof typeof SUPPORT_STATUSES];
+export type DiscountType = (typeof DISCOUNT_TYPES)[keyof typeof DISCOUNT_TYPES];

package/dist/build-query-params/index.js

@@ -1,4 +1,4 @@
-//#region src/build-query-params/index.ts
+//#region src/core/build-query-params/index.ts
 var e = (e) => {
 	let t = new URLSearchParams();
 	Object.entries(e).forEach(([e, n]) => {

package/dist/build-sort-param/index.js

@@ -1,4 +1,4 @@
-//#region src/build-sort-param/index.ts
+//#region src/core/build-sort-param/index.ts
 var e = (e, t) => {
 	let n = "-" + e, r = (t ?? "").split(",").filter(Boolean);
 	return r.includes(n) ? r.filter((e) => e !== n).join(",") : r.includes(e) ? r.map((t) => t === e ? n : t).join(",") : [e, ...r].join(",");

package/dist/chunks/admin-B3AZrTOb.es

@@ -0,0 +1,28 @@
+import { jwtDecode as e } from "jwt-decode";
+//#region src/admin/constants/admin.constant.ts
+var t = {
+	USERS: "admin-users",
+	SINGLE_USER: "admin-single-user",
+	ORDERS: "admin-orders",
+	SINGLE_ORDER: "admin-single-order",
+	DISCOUNTS: "admin-discounts",
+	SINGLE_DISCOUNT: "admin-single-discount",
+	STATIC: "admin-static",
+	SINGLE_STATIC: "admin-single-static",
+	SUPPORT_REQUESTS: "admin-support-requests",
+	SINGLE_SUPPORT_REQUEST: "admin-support-request",
+	AVALIABLE_CURRENCIES: "admin-available-currencies",
+	ACTIVE_CURRENCIES: "admin-active-currencies",
+	GATEWAYS: "admin-gateways",
+	BANS: "admin-bans",
+	SWAGGER: "admin-swagger",
+	BULK_EDIT: "admin-products-bulk-edit"
+}, n = (t) => {
+	try {
+		return e(t).is_admin === !0;
+	} catch {
+		return !1;
+	}
+};
+//#endregion
+export { t as n, n as t };

package/dist/chunks/admin-DR1tBkNV.cjs

@@ -0,0 +1 @@
+let e=require("jwt-decode");var t={USERS:`admin-users`,SINGLE_USER:`admin-single-user`,ORDERS:`admin-orders`,SINGLE_ORDER:`admin-single-order`,DISCOUNTS:`admin-discounts`,SINGLE_DISCOUNT:`admin-single-discount`,STATIC:`admin-static`,SINGLE_STATIC:`admin-single-static`,SUPPORT_REQUESTS:`admin-support-requests`,SINGLE_SUPPORT_REQUEST:`admin-support-request`,AVALIABLE_CURRENCIES:`admin-available-currencies`,ACTIVE_CURRENCIES:`admin-active-currencies`,GATEWAYS:`admin-gateways`,BANS:`admin-bans`,SWAGGER:`admin-swagger`,BULK_EDIT:`admin-products-bulk-edit`},n=t=>{try{return(0,e.jwtDecode)(t).is_admin===!0}catch{return!1}};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return n}});

package/dist/chunks/base-C5926Kyt.es

@@ -0,0 +1,16 @@
+//#region src/base/constants/base.constant.ts
+var e = {
+	MONEY: "money",
+	PERCENT: "percent"
+}, t = {
+	PENDING: "PENDING",
+	COMPLETED: "COMPLETED",
+	FAILED: "FAILED",
+	CANCELED: "CANCELED"
+}, n = {
+	PENDING: "PENDING",
+	SOLVED: "SOLVED",
+	CLOSED: "CLOSED"
+};
+//#endregion
+export { t as n, n as r, e as t };

package/dist/chunks/base-DLHy3wps.cjs

@@ -0,0 +1 @@
+var e={MONEY:`money`,PERCENT:`percent`},t={PENDING:`PENDING`,COMPLETED:`COMPLETED`,FAILED:`FAILED`,CANCELED:`CANCELED`},n={PENDING:`PENDING`,SOLVED:`SOLVED`,CLOSED:`CLOSED`};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return e}});

package/dist/chunks/{currency-symbol-CBowgXv-.es → currency-symbol-CJp1EcR5.es}

@@ -1,4 +1,4 @@
-//#region src/currency-symbol/constants/currency-symbol.constant.ts
+//#region src/core/currency-symbol/constants/currency-symbol.constant.ts
 var e = {
 	CHF: "₣",
 	AUD: "A$",

package/dist/chunks/flags-BRQ9Jims.cjs

@@ -0,0 +1 @@
+var e={uk:`gb`,en:`gb`,ja:`jp`,zh:`cn`,fr:`fr`,es:`es`,de:`de`,cn:`cn`,ko:`kr`,ar:`sa`,he:`il`,hi:`in`,vi:`vn`,el:`gr`,cs:`cz`,sv:`se`,da:`dk`,fa:`ir`,ur:`pk`,bn:`bd`,ms:`my`,nb:`no`,nn:`no`,ca:`es`,cy:`gb`,ga:`ie`,gd:`gb`,lb:`lu`,eu:`es`,gl:`es`,rm:`ch`,kk:`kz`,hy:`am`,ka:`ge`,sq:`al`,sl:`si`,sr:`rs`,et:`ee`,fil:`ph`,tl:`ph`,sw:`ke`},t=`https://flagcdn.com`,n=`https://flagicons.lipis.dev/flags/4x3`,r=e=>typeof e==`string`&&e.trim().length>0,i=t=>{let n=t.trim().toLowerCase();return Object.hasOwn(e,n)?e[n]:n},a=()=>`${n}/xx.svg`,o=e=>r(e)?`${t}/${i(e)}.svg`:a(),s=e=>r(e)?`${n}/${i(e)}.svg`:a(),c=(e,t)=>{let n=s(t),r=a(),i=e.currentTarget.src;i!==r&&(e.currentTarget.src=i===n?r:n)};Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return s}});

package/dist/chunks/flags-C5E6W9lm.es

@@ -0,0 +1,52 @@
+//#region src/core/flags/constants/flags.constant.ts
+var e = {
+	uk: "gb",
+	en: "gb",
+	ja: "jp",
+	zh: "cn",
+	fr: "fr",
+	es: "es",
+	de: "de",
+	cn: "cn",
+	ko: "kr",
+	ar: "sa",
+	he: "il",
+	hi: "in",
+	vi: "vn",
+	el: "gr",
+	cs: "cz",
+	sv: "se",
+	da: "dk",
+	fa: "ir",
+	ur: "pk",
+	bn: "bd",
+	ms: "my",
+	nb: "no",
+	nn: "no",
+	ca: "es",
+	cy: "gb",
+	ga: "ie",
+	gd: "gb",
+	lb: "lu",
+	eu: "es",
+	gl: "es",
+	rm: "ch",
+	kk: "kz",
+	hy: "am",
+	ka: "ge",
+	sq: "al",
+	sl: "si",
+	sr: "rs",
+	et: "ee",
+	fil: "ph",
+	tl: "ph",
+	sw: "ke"
+}, t = "https://flagcdn.com", n = "https://flagicons.lipis.dev/flags/4x3", r = (e) => typeof e == "string" && e.trim().length > 0, i = (t) => {
+	let n = t.trim().toLowerCase();
+	return Object.hasOwn(e, n) ? e[n] : n;
+}, a = () => `${n}/xx.svg`, o = (e) => r(e) ? `${t}/${i(e)}.svg` : a(), s = (e) => r(e) ? `${n}/${i(e)}.svg` : a(), c = (e, t) => {
+	let n = s(t), r = a(), i = e.currentTarget.src;
+	i !== r && (e.currentTarget.src = i === n ? r : n);
+};
+//#endregion
+export { c as i, a as n, o as r, s as t };

package/dist/chunks/{handle-api-error-CMd_LxPS.es → handle-api-error-BYygTKYM.es}

@@ -1,5 +1,5 @@
 import { isHTTPError as e } from "ky";
-//#region src/handle-api-error/constants/handle-api-error.constant.ts
+//#region src/core/handle-api-error/constants/handle-api-error.constant.ts
 var t = "Something went wrong", n = /* @__PURE__ */ new Set([
 	"message",
 	"detail",

package/dist/chunks/{truncate-decimals-BFMoEzul.es → truncate-decimals-BPaTWeHm.es}

@@ -1,4 +1,4 @@
-//#region src/truncate-decimals/constants/truncate-decimals.constant.ts
+//#region src/core/truncate-decimals/constants/truncate-decimals.constant.ts
 var e = /^-?\d+(\.\d+)?$/, t = (t, r = 2) => typeof t == "number" ? Number.isFinite(t) ? n(String(t), r) : "N/A" : typeof t == "string" && e.test(t.trim()) ? n(t.trim(), r) : "N/A", n = (e, t) => {
 	let [n, r] = e.split(".");
 	return r === void 0 ? e : t > 0 ? `${n}.${r.slice(0, t)}` : n;

package/dist/clean-object/index.js

@@ -1,4 +1,4 @@
-//#region src/clean-object/index.ts
+//#region src/core/clean-object/index.ts
 var e = (e) => {
 	let t = {};
 	return Object.entries(e).forEach(([e, n]) => {

package/dist/core/flags/constants/flags.constant.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Maps an ISO 639-1 language code to the ISO 3166-1 country code of the flag
+ * that should represent it, for languages where the two codes differ.
+ *
+ * Some mappings are inherently ambiguous (e.g. Arabic, Swahili are official in
+ * many countries) — the chosen country is the most common default for that case.
+ */
+export declare const FLAG_CODE_ALIASES: Record<string, string>;
+export declare const FLAGS_BASE_URL: "https://flagcdn.com";
+export declare const FLAGS_FALLBACK_URL: "https://flagicons.lipis.dev/flags/4x3";
+/**
+ * Code for the "unknown flag" placeholder (a plain flag with no country emblem),
+ * only available on {@link FLAGS_FALLBACK_URL} — flagcdn.com has no equivalent.
+ */
+export declare const FLAG_UNKNOWN_CODE: "xx";

package/dist/core/flags/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Returns the "unknown flag" placeholder URL, used when both {@link getFlagUrl}
+ * and {@link getFlagFallbackUrl} fail to load, and as the direct result of either
+ * when `languageCode` isn't a usable string (e.g. `null`, `undefined`, `NaN`, an object).
+ */
+export declare const getFlagUnknownUrl: () => string;
+/**
+ * Returns the primary flag icon URL ({@link FLAGS_BASE_URL}) for the given language/country code.
+ * Falls back to {@link getFlagUnknownUrl} if `languageCode` isn't a non-empty string at runtime.
+ *
+ * @param languageCode - Language or country code (e.g. `en`, `uk`, `fr`)
+ */
+export declare const getFlagUrl: (languageCode: string) => string;
+/**
+ * Returns the fallback flag icon URL ({@link FLAGS_FALLBACK_URL}), used when
+ * the image from {@link getFlagUrl} fails to load. Falls back to {@link getFlagUnknownUrl}
+ * if `languageCode` isn't a non-empty string at runtime.
+ *
+ * @param languageCode - Language or country code (e.g. `en`, `uk`, `fr`)
+ */
+export declare const getFlagFallbackUrl: (languageCode: string) => string;
+/**
+ * `onError` handler for an `<img>` displaying a flag from {@link getFlagUrl}. Escalates
+ * through three tiers, stopping once it reaches the last one to avoid an infinite loop:
+ * primary ({@link getFlagUrl}) → fallback ({@link getFlagFallbackUrl}) → unknown-flag
+ * placeholder ({@link getFlagUnknownUrl}).
+ *
+ * @param event - Image error event (DOM `Event` or React's `SyntheticEvent<HTMLImageElement>`)
+ * @param languageCode - Same code that was passed to {@link getFlagUrl}
+ *
+ * @example React
+ * ```tsx
+ * <img src={getFlagUrl(code)} onError={(e) => handleFlagImageError(e, code)} />
+ * ```
+ *
+ * @example Vue
+ * ```vue
+ * <img :src="getFlagUrl(code)" @error="(e) => handleFlagImageError(e, code)" />
+ * ```
+ *
+ * @example Svelte
+ * ```svelte
+ * <img src={getFlagUrl(code)} on:error={(e) => handleFlagImageError(e, code)} />
+ * ```
+ */
+export declare const handleFlagImageError: (event: {
+    currentTarget: HTMLImageElement;
+}, languageCode: string) => void;

package/dist/core/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../build-query-params/index.cjs"),t=require("../clean-object/index.cjs"),n=require("../cookies/index.cjs"),r=require("../build-sort-param/index.cjs"),i=require("../chunks/currency-symbol-gb63Q_9Q.cjs"),a=require("../download-file/index.cjs"),o=require("../chunks/flags-BRQ9Jims.cjs"),s=require("../chunks/handle-api-error-D714W9rp.cjs"),c=require("../normalize-input/index.cjs"),l=require("../chunks/truncate-decimals-CArL-IeO.cjs");exports.buildQueryParams=e.buildQueryParams,exports.buildSortParam=r.buildSortParam,exports.cleanObject=t.cleanObject,exports.defaultCookieOptions=n.defaultCookieOptions,exports.deleteCookie=n.deleteCookie,exports.downloadBlob=a.downloadBlob,exports.getCookie=n.getCookie,exports.getCurrencySymbol=i.t,exports.getFlagFallbackUrl=o.t,exports.getFlagUnknownUrl=o.n,exports.getFlagUrl=o.r,exports.handleApiError=s.t,exports.handleFlagImageError=o.i,exports.initHandleApiError=s.n,exports.normalizeDecimalInput=c.normalizeDecimalInput,exports.normalizePhoneNumberInput=c.normalizePhoneNumberInput,exports.setCookie=n.setCookie,exports.truncateDecimals=l.t;

package/dist/core/index.d.ts

@@ -0,0 +1,10 @@
+export * from './build-query-params';
+export * from './clean-object';
+export * from './cookies';
+export * from './build-sort-param';
+export * from './currency-symbol';
+export * from './download-file';
+export * from './flags';
+export * from './handle-api-error';
+export * from './normalize-input';
+export * from './truncate-decimals';

package/dist/core/index.js

@@ -0,0 +1,11 @@
+import { buildQueryParams as e } from "../build-query-params/index.js";
+import { cleanObject as t } from "../clean-object/index.js";
+import { defaultCookieOptions as n, deleteCookie as r, getCookie as i, setCookie as a } from "../cookies/index.js";
+import { buildSortParam as o } from "../build-sort-param/index.js";
+import { t as s } from "../chunks/currency-symbol-CJp1EcR5.es";
+import { downloadBlob as c } from "../download-file/index.js";
+import { i as l, n as u, r as d, t as f } from "../chunks/flags-C5E6W9lm.es";
+import { n as p, t as m } from "../chunks/handle-api-error-BYygTKYM.es";
+import { normalizeDecimalInput as h, normalizePhoneNumberInput as g } from "../normalize-input/index.js";
+import { t as _ } from "../chunks/truncate-decimals-BPaTWeHm.es";
+export { e as buildQueryParams, o as buildSortParam, t as cleanObject, n as defaultCookieOptions, r as deleteCookie, c as downloadBlob, i as getCookie, s as getCurrencySymbol, f as getFlagFallbackUrl, u as getFlagUnknownUrl, d as getFlagUrl, m as handleApiError, l as handleFlagImageError, p as initHandleApiError, h as normalizeDecimalInput, g as normalizePhoneNumberInput, a as setCookie, _ as truncateDecimals };

package/dist/currency-symbol/index.js

@@ -1,2 +1,2 @@
-import { t as e } from "../chunks/currency-symbol-CBowgXv-.es";
+import { t as e } from "../chunks/currency-symbol-CJp1EcR5.es";
 export { e as getCurrencySymbol };

package/dist/download-file/index.js

@@ -1,5 +1,5 @@
 import { saveAs as e } from "file-saver";
-//#region src/download-file/index.ts
+//#region src/core/download-file/index.ts
 var t = async (e) => {
 	let t = new TextEncoder().encode(String(e)), n = await crypto.subtle.digest("SHA-1", t);
 	return Array.from(new Uint8Array(n)).map((e) => e.toString(16).padStart(2, "0")).join("");

package/dist/flags/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/flags-BRQ9Jims.cjs");exports.getFlagFallbackUrl=e.t,exports.getFlagUnknownUrl=e.n,exports.getFlagUrl=e.r,exports.handleFlagImageError=e.i;

package/dist/flags/index.js

@@ -0,0 +1,2 @@
+import { i as e, n as t, r as n, t as r } from "../chunks/flags-C5E6W9lm.es";
+export { r as getFlagFallbackUrl, t as getFlagUnknownUrl, n as getFlagUrl, e as handleFlagImageError };

package/dist/handle-api-error/index.js

@@ -1,2 +1,2 @@
-import { n as e, t } from "../chunks/handle-api-error-CMd_LxPS.es";
+import { n as e, t } from "../chunks/handle-api-error-BYygTKYM.es";
 export { t as handleApiError, e as initHandleApiError };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./build-query-params/index.cjs"),t=require("./clean-object/index.cjs"),n=require("./cookies/index.cjs"),r=require("./build-sort-param/index.cjs"),i=require("./chunks/currency-symbol-gb63Q_9Q.cjs"),a=require("./download-file/index.cjs"),o=require("./chunks/handle-api-error-D714W9rp.cjs"),s=require("./normalize-input/index.cjs"),c=require("./chunks/truncate-decimals-CArL-IeO.cjs");exports.buildQueryParams=e.buildQueryParams,exports.buildSortParam=r.buildSortParam,exports.cleanObject=t.cleanObject,exports.defaultCookieOptions=n.defaultCookieOptions,exports.deleteCookie=n.deleteCookie,exports.downloadBlob=a.downloadBlob,exports.getCookie=n.getCookie,exports.getCurrencySymbol=i.t,exports.handleApiError=o.t,exports.initHandleApiError=o.n,exports.normalizeDecimalInput=s.normalizeDecimalInput,exports.normalizePhoneNumberInput=s.normalizePhoneNumberInput,exports.setCookie=n.setCookie,exports.truncateDecimals=c.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/base-DLHy3wps.cjs"),t=require("./chunks/admin-DR1tBkNV.cjs"),n=require("./build-query-params/index.cjs"),r=require("./clean-object/index.cjs"),i=require("./cookies/index.cjs"),a=require("./build-sort-param/index.cjs"),o=require("./chunks/currency-symbol-gb63Q_9Q.cjs"),s=require("./download-file/index.cjs"),c=require("./chunks/flags-BRQ9Jims.cjs"),l=require("./chunks/handle-api-error-D714W9rp.cjs"),u=require("./normalize-input/index.cjs"),d=require("./chunks/truncate-decimals-CArL-IeO.cjs");require("./core/index.cjs"),exports.ADMIN_QUERY_KEYS=t.n,exports.DISCOUNT_TYPES=e.t,exports.ORDER_STATUSES=e.n,exports.SUPPORT_STATUSES=e.r,exports.buildQueryParams=n.buildQueryParams,exports.buildSortParam=a.buildSortParam,exports.cleanObject=r.cleanObject,exports.defaultCookieOptions=i.defaultCookieOptions,exports.deleteCookie=i.deleteCookie,exports.downloadBlob=s.downloadBlob,exports.getCookie=i.getCookie,exports.getCurrencySymbol=o.t,exports.getFlagFallbackUrl=c.t,exports.getFlagUnknownUrl=c.n,exports.getFlagUrl=c.r,exports.handleApiError=l.t,exports.handleFlagImageError=c.i,exports.initHandleApiError=l.n,exports.isAdminToken=t.t,exports.normalizeDecimalInput=u.normalizeDecimalInput,exports.normalizePhoneNumberInput=u.normalizePhoneNumberInput,exports.setCookie=i.setCookie,exports.truncateDecimals=d.t;

package/dist/index.d.ts

@@ -1,10 +1,3 @@
-export * from './build-query-params';
-export * from './clean-object';
-export * from './cookies';
-export type * from './types';
-export * from './build-sort-param';
-export * from './currency-symbol';
-export * from './download-file';
-export * from './handle-api-error';
-export * from './normalize-input';
-export * from './truncate-decimals';
+export * from './base';
+export * from './admin';
+export * from './core';

package/dist/index.js

@@ -1,10 +1,14 @@
-import { buildQueryParams as e } from "./build-query-params/index.js";
-import { cleanObject as t } from "./clean-object/index.js";
-import { defaultCookieOptions as n, deleteCookie as r, getCookie as i, setCookie as a } from "./cookies/index.js";
-import { buildSortParam as o } from "./build-sort-param/index.js";
-import { t as s } from "./chunks/currency-symbol-CBowgXv-.es";
-import { downloadBlob as c } from "./download-file/index.js";
-import { n as l, t as u } from "./chunks/handle-api-error-CMd_LxPS.es";
-import { normalizeDecimalInput as d, normalizePhoneNumberInput as f } from "./normalize-input/index.js";
-import { t as p } from "./chunks/truncate-decimals-BFMoEzul.es";
-export { e as buildQueryParams, o as buildSortParam, t as cleanObject, n as defaultCookieOptions, r as deleteCookie, c as downloadBlob, i as getCookie, s as getCurrencySymbol, u as handleApiError, l as initHandleApiError, d as normalizeDecimalInput, f as normalizePhoneNumberInput, a as setCookie, p as truncateDecimals };
+import { n as e, r as t, t as n } from "./chunks/base-C5926Kyt.es";
+import { n as r, t as i } from "./chunks/admin-B3AZrTOb.es";
+import { buildQueryParams as a } from "./build-query-params/index.js";
+import { cleanObject as o } from "./clean-object/index.js";
+import { defaultCookieOptions as s, deleteCookie as c, getCookie as l, setCookie as u } from "./cookies/index.js";
+import { buildSortParam as d } from "./build-sort-param/index.js";
+import { t as f } from "./chunks/currency-symbol-CJp1EcR5.es";
+import { downloadBlob as p } from "./download-file/index.js";
+import { i as m, n as h, r as g, t as _ } from "./chunks/flags-C5E6W9lm.es";
+import { n as v, t as y } from "./chunks/handle-api-error-BYygTKYM.es";
+import { normalizeDecimalInput as b, normalizePhoneNumberInput as x } from "./normalize-input/index.js";
+import { t as S } from "./chunks/truncate-decimals-BPaTWeHm.es";
+import "./core/index.js";
+export { r as ADMIN_QUERY_KEYS, n as DISCOUNT_TYPES, e as ORDER_STATUSES, t as SUPPORT_STATUSES, a as buildQueryParams, d as buildSortParam, o as cleanObject, s as defaultCookieOptions, c as deleteCookie, p as downloadBlob, l as getCookie, f as getCurrencySymbol, _ as getFlagFallbackUrl, h as getFlagUnknownUrl, g as getFlagUrl, y as handleApiError, m as handleFlagImageError, v as initHandleApiError, i as isAdminToken, b as normalizeDecimalInput, x as normalizePhoneNumberInput, u as setCookie, S as truncateDecimals };

package/dist/normalize-input/index.js

@@ -1,4 +1,4 @@
-//#region src/normalize-input/index.ts
+//#region src/core/normalize-input/index.ts
 var e = (e, t = 2) => {
 	let n = e.target, r = n.value;
 	r = r.replace(",", "."), r = r.replace(/[^0-9.]/g, "");

package/dist/truncate-decimals/index.js

@@ -1,2 +1,2 @@
-import { t as e } from "../chunks/truncate-decimals-BFMoEzul.es";
+import { t as e } from "../chunks/truncate-decimals-BPaTWeHm.es";
 export { e as truncateDecimals };

package/package.json

@@ -2,10 +2,11 @@
 	"name": "@ptx-showcase/utils",
 	"author": "ptx-showcase",
 	"description": "Shared utilities for PTX Showcase projects",
-	"version": "0.6.0",
+	"version": "1.1.0",
 	"private": false,
 	"type": "module",
 	"license": "MIT",
+	"sideEffects": false,
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/gibPerviy/ptx-showcase-utils.git"
@@ -31,60 +32,75 @@
 			"require": "./dist/index.cjs",
 			"types": "./dist/index.d.ts"
 		},
+		"./admin": {
+			"import": "./dist/admin/index.js",
+			"require": "./dist/admin/index.cjs",
+			"types": "./dist/admin/index.d.ts"
+		},
+		"./base": {
+			"import": "./dist/base/index.js",
+			"require": "./dist/base/index.cjs",
+			"types": "./dist/base/index.d.ts"
+		},
+		"./core": {
+			"import": "./dist/core/index.js",
+			"require": "./dist/core/index.cjs",
+			"types": "./dist/core/index.d.ts"
+		},
 		"./cookies": {
 			"import": "./dist/cookies/index.js",
 			"require": "./dist/cookies/index.cjs",
-			"types": "./dist/cookies/index.d.ts"
+			"types": "./dist/core/cookies/index.d.ts"
 		},
 		"./build-query-params": {
 			"import": "./dist/build-query-params/index.js",
 			"require": "./dist/build-query-params/index.cjs",
-			"types": "./dist/build-query-params/index.d.ts"
+			"types": "./dist/core/build-query-params/index.d.ts"
 		},
 		"./build-sort-param": {
 			"import": "./dist/build-sort-param/index.js",
 			"require": "./dist/build-sort-param/index.cjs",
-			"types": "./dist/build-sort-param/index.d.ts"
+			"types": "./dist/core/build-sort-param/index.d.ts"
 		},
 		"./clean-object": {
 			"import": "./dist/clean-object/index.js",
 			"require": "./dist/clean-object/index.cjs",
-			"types": "./dist/clean-object/index.d.ts"
+			"types": "./dist/core/clean-object/index.d.ts"
 		},
 		"./currency-symbol": {
 			"import": "./dist/currency-symbol/index.js",
 			"require": "./dist/currency-symbol/index.cjs",
-			"types": "./dist/currency-symbol/index.d.ts"
+			"types": "./dist/core/currency-symbol/index.d.ts"
 		},
 		"./download-file": {
 			"import": "./dist/download-file/index.js",
 			"require": "./dist/download-file/index.cjs",
-			"types": "./dist/download-file/index.d.ts"
+			"types": "./dist/core/download-file/index.d.ts"
+		},
+		"./flags": {
+			"import": "./dist/flags/index.js",
+			"require": "./dist/flags/index.cjs",
+			"types": "./dist/core/flags/index.d.ts"
 		},
 		"./handle-api-error": {
 			"import": "./dist/handle-api-error/index.js",
 			"require": "./dist/handle-api-error/index.cjs",
-			"types": "./dist/handle-api-error/index.d.ts"
+			"types": "./dist/core/handle-api-error/index.d.ts"
 		},
 		"./normalize-input": {
 			"import": "./dist/normalize-input/index.js",
 			"require": "./dist/normalize-input/index.cjs",
-			"types": "./dist/normalize-input/index.d.ts"
+			"types": "./dist/core/normalize-input/index.d.ts"
 		},
 		"./truncate-decimals": {
 			"import": "./dist/truncate-decimals/index.js",
 			"require": "./dist/truncate-decimals/index.cjs",
-			"types": "./dist/truncate-decimals/index.d.ts"
-		},
-		"./types": {
-			"import": "./dist/types/index.js",
-			"require": "./dist/types/index.cjs",
-			"types": "./dist/types/index.d.ts"
+			"types": "./dist/core/truncate-decimals/index.d.ts"
 		}
 	},
 	"scripts": {
 		"dev": "vite",
-		"test": "vitest",
+		"test": "vitest run",
 		"build": "vite build",
 		"lint": "oxlint",
 		"lint:fix": "oxlint --fix",
@@ -97,20 +113,21 @@
 		"access": "public"
 	},
 	"devDependencies": {
-		"@types/node": "^26.4.0",
-		"bumpp": "^12.2.2",
-		"oxfmt": "^0.65.0",
-		"oxlint": "^1.80.0",
+		"@types/node": "^26.6.1",
+		"bumpp": "^12.3.0",
+		"oxfmt": "^0.68.0",
+		"oxlint": "^1.83.0",
 		"typescript": "~6.0.3",
-		"vite": "^8.2.2",
-		"vite-plugin-dts": "^5.0.3",
-		"vitest": "^4.1.11"
+		"vite": "^8.3.0",
+		"vite-plugin-dts": "^5.1.0",
+		"vitest": "^5.0.1"
 	},
 	"dependencies": {
 		"@types/file-saver": "^2.0.7",
 		"@types/js-cookie": "^3.0.6",
 		"file-saver": "^2.0.5",
 		"js-cookie": "^3.0.8",
+		"jwt-decode": "^4.0.0",
 		"ky": "^2.1.0"
 	}
 }

package/dist/types/index.d.ts

@@ -1,13 +0,0 @@
-export interface TableColumnConfig<T, ExtraKeys extends string = never> {
-    id?: number;
-    label: string;
-    key: keyof T | ExtraKeys;
-    sortable?: boolean;
-}
-export interface PaginatedList<T> {
-    items: T[];
-    page: number;
-    per_page: number;
-    total_items: number;
-    total_pages: number;
-}