@ptx-showcase/utils 1.1.0 → 1.1.1-beta.1

package/README.md

@@ -215,6 +215,13 @@ try {
 }
 ```
 
+If the backend returns messages as a per-language object (`{ "message": { "en": "…", "fr": "…", "it": "…" } }`), pass the language as the second argument. It falls back to `en` when the requested language is missing, and to `Something went wrong` when there is no usable text at all.
+
+```ts
+handleApiError(error, 'fr') // → "Email ou mot de passe incorrect"
+handleApiError(error) // → "Incorrect email or password"
+```
+
 ---
 
 ### isAdminToken

package/dist/chunks/handle-api-error-B-2TPzB6.cjs

@@ -0,0 +1 @@
+let e=require("ky");var t=`Something went wrong`,n=new Set([`message`,`detail`,`error`,`msg`]),r=new Set([`en`,`fr`,`it`]),i=e=>typeof e==`object`&&!!e&&!Array.isArray(e),a=e=>{if(!i(e))return!1;let t=Object.keys(e);return t.length>0&&t.every(e=>r.has(e))},o=(e,t)=>{for(let n of[t,`en`])if(Object.hasOwn(e,n)&&typeof e[n]==`string`&&e[n].trim())return e[n];return null},s=(e,t=`en`)=>a(e)?o(e,t):typeof e==`string`&&e.trim()?e:null,c=(e,t,n=`en`)=>{if(a(e)){let r=o(e,n);return r?[t?`${t}: ${r}`:r]:[]}return typeof e==`string`?e.trim()?[t?`${t}: ${e}`:e]:[]:Array.isArray(e)?e.flatMap(e=>c(e,t,n)):i(e)?Object.entries(e).flatMap(([e,t])=>c(t,e===`non_field_errors`?void 0:e,n)):[]},l=(e,t=`en`)=>{if(!e)return[];if(typeof e==`string`)return[e];if(Array.isArray(e))return e.filter(e=>typeof e==`string`&&!!e.trim());let r=s(e.detail,t)??s(e.message,t)??s(e.error,t)??s(e.msg,t);return[...Object.entries(e).flatMap(([e,r])=>n.has(e)?[]:e===`non_field_errors`||e===`errors`?c(r,void 0,t):c(r,e,t)),...r?[r]:[]]},u=e=>{console.error(e)},d=e=>{u=e},f=()=>u,p=e=>{d(e.notify)},m=(n,r)=>{let i=f();if((0,e.isHTTPError)(n)){let e=n.data,a=[...new Set(l(e,r))];if(a.length>0){a.forEach(e=>i(e));return}i(t);return}if(n instanceof Error){i(n.message||`Something went wrong`);return}i(t)};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return m}});

package/dist/chunks/handle-api-error-CoTTGH3m.es

@@ -0,0 +1,55 @@
+import { isHTTPError as e } from "ky";
+//#region src/core/handle-api-error/constants/handle-api-error.constant.ts
+var t = "Something went wrong", n = /* @__PURE__ */ new Set([
+	"message",
+	"detail",
+	"error",
+	"msg"
+]), r = /* @__PURE__ */ new Set([
+	"en",
+	"fr",
+	"it"
+]), i = (e) => typeof e == "object" && !!e && !Array.isArray(e), a = (e) => {
+	if (!i(e)) return !1;
+	let t = Object.keys(e);
+	return t.length > 0 && t.every((e) => r.has(e));
+}, o = (e, t) => {
+	for (let n of [t, "en"]) if (Object.hasOwn(e, n) && typeof e[n] == "string" && e[n].trim()) return e[n];
+	return null;
+}, s = (e, t = "en") => a(e) ? o(e, t) : typeof e == "string" && e.trim() ? e : null, c = (e, t, n = "en") => {
+	if (a(e)) {
+		let r = o(e, n);
+		return r ? [t ? `${t}: ${r}` : r] : [];
+	}
+	return typeof e == "string" ? e.trim() ? [t ? `${t}: ${e}` : e] : [] : Array.isArray(e) ? e.flatMap((e) => c(e, t, n)) : i(e) ? Object.entries(e).flatMap(([e, t]) => c(t, e === "non_field_errors" ? void 0 : e, n)) : [];
+}, l = (e, t = "en") => {
+	if (!e) return [];
+	if (typeof e == "string") return [e];
+	if (Array.isArray(e)) return e.filter((e) => typeof e == "string" && !!e.trim());
+	let r = s(e.detail, t) ?? s(e.message, t) ?? s(e.error, t) ?? s(e.msg, t);
+	return [...Object.entries(e).flatMap(([e, r]) => n.has(e) ? [] : e === "non_field_errors" || e === "errors" ? c(r, void 0, t) : c(r, e, t)), ...r ? [r] : []];
+}, u = (e) => {
+	console.error(e);
+}, d = (e) => {
+	u = e;
+}, f = () => u, p = (e) => {
+	d(e.notify);
+}, m = (n, r) => {
+	let i = f();
+	if (e(n)) {
+		let e = n.data, a = [...new Set(l(e, r))];
+		if (a.length > 0) {
+			a.forEach((e) => i(e));
+			return;
+		}
+		i(t);
+		return;
+	}
+	if (n instanceof Error) {
+		i(n.message || "Something went wrong");
+		return;
+	}
+	i(t);
+};
+//#endregion
+export { p as n, m as t };

package/dist/core/handle-api-error/constants/handle-api-error.constant.d.ts

@@ -1,2 +1,4 @@
 export declare const DEFAULT_ERROR_MESSAGE: "Something went wrong";
 export declare const SKIPPED_KEYS: Set<string>;
+export declare const DEFAULT_LANGUAGE: "en";
+export declare const LANGUAGES: Set<string>;

package/dist/core/handle-api-error/index.d.ts

@@ -1,3 +1,12 @@
-import { HandleApiErrorConfig } from './types/handle-api-error.type';
+import { HandleApiErrorConfig, Languages } from './types/handle-api-error.type';
 export declare const initHandleApiError: (config: HandleApiErrorConfig) => void;
-export declare const handleApiError: (error: unknown) => void;
+export type { Languages };
+/**
+ * Parses an API error and reports each unique message through the `notify` function set by `initHandleApiError`.
+ * Messages delivered as a per-language object (`{ en, fr, it }`) are shown in `language`, falling back to English;
+ * if nothing usable is found, a default error message is shown.
+ *
+ * @param error - Anything caught from a request, typically ky's `HTTPError`.
+ * @param language - Preferred language for localized messages. Defaults to `'en'`.
+ */
+export declare const handleApiError: (error: unknown, language?: Languages) => void;

package/dist/core/handle-api-error/libs/handle-api-error.lib.d.ts

@@ -1,5 +1,6 @@
-import { ApiErrorData, ApiErrorPrimitive } from '../types/handle-api-error.type';
+import { ApiErrorData, ApiErrorPrimitive, Languages, LocalizedMessage } from '../types/handle-api-error.type';
 export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
-export declare const toMessage: (value: unknown) => string | null;
-export declare const extractMessages: (value: unknown, parentKey?: string) => string[];
-export declare const getHttpErrorMessages: (errorData: ApiErrorData | ApiErrorPrimitive | undefined) => string[];
+export declare const isLocalizedMessage: (value: unknown) => value is LocalizedMessage;
+export declare const toMessage: (value: unknown, language?: Languages) => string | null;
+export declare const extractMessages: (value: unknown, parentKey?: string, language?: Languages) => string[];
+export declare const getHttpErrorMessages: (errorData: ApiErrorData | ApiErrorPrimitive | undefined, language?: Languages) => string[];

package/dist/core/handle-api-error/types/handle-api-error.type.d.ts

@@ -2,6 +2,8 @@ export type NotifyFn = (message: string) => void;
 export interface HandleApiErrorConfig {
     notify: NotifyFn;
 }
+export type Languages = 'en' | 'fr' | 'it';
+export type LocalizedMessage = Partial<Record<Languages, string>>;
 export type ApiErrorPrimitive = string | string[];
 export interface ApiErrorData {
     detail?: string;

package/dist/core/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/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;
+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-B-2TPzB6.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.js

@@ -5,7 +5,7 @@ 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 { n as p, t as m } from "../chunks/handle-api-error-CoTTGH3m.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/handle-api-error/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/handle-api-error-D714W9rp.cjs");exports.handleApiError=e.t,exports.initHandleApiError=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/handle-api-error-B-2TPzB6.cjs");exports.handleApiError=e.t,exports.initHandleApiError=e.n;

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

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

package/dist/index.cjs

@@ -1 +1 @@
-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;
+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-B-2TPzB6.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.js

@@ -7,7 +7,7 @@ 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 { n as v, t as y } from "./chunks/handle-api-error-CoTTGH3m.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";

package/package.json

@@ -2,7 +2,7 @@
 	"name": "@ptx-showcase/utils",
 	"author": "ptx-showcase",
 	"description": "Shared utilities for PTX Showcase projects",
-	"version": "1.1.0",
+	"version": "1.1.1-beta.1",
 	"private": false,
 	"type": "module",
 	"license": "MIT",
@@ -113,13 +113,13 @@
 		"access": "public"
 	},
 	"devDependencies": {
-		"@types/node": "^26.6.1",
+		"@types/node": "^26.6.2",
 		"bumpp": "^12.3.0",
 		"oxfmt": "^0.68.0",
 		"oxlint": "^1.83.0",
 		"typescript": "~6.0.3",
 		"vite": "^8.3.0",
-		"vite-plugin-dts": "^5.1.0",
+		"vite-plugin-dts": "^5.1.1",
 		"vitest": "^5.0.1"
 	},
 	"dependencies": {

package/dist/chunks/handle-api-error-BYygTKYM.es

@@ -1,38 +0,0 @@
-import { isHTTPError as e } from "ky";
-//#region src/core/handle-api-error/constants/handle-api-error.constant.ts
-var t = "Something went wrong", n = /* @__PURE__ */ new Set([
-	"message",
-	"detail",
-	"error",
-	"msg"
-]), r = (e) => typeof e == "object" && !!e && !Array.isArray(e), i = (e) => typeof e == "string" && e.trim() ? e : null, a = (e, t) => typeof e == "string" ? e.trim() ? [t ? `${t}: ${e}` : e] : [] : Array.isArray(e) ? e.flatMap((e) => a(e, t)) : r(e) ? Object.entries(e).flatMap(([e, t]) => a(t, e === "non_field_errors" ? void 0 : e)) : [], o = (e) => {
-	if (!e) return [];
-	if (typeof e == "string") return [e];
-	if (Array.isArray(e)) return e.filter((e) => typeof e == "string" && !!e.trim());
-	let t = i(e.detail) ?? i(e.message) ?? i(e.error) ?? i(e.msg);
-	return [...Object.entries(e).flatMap(([e, t]) => n.has(e) ? [] : e === "non_field_errors" || e === "errors" ? a(t) : a(t, e)), ...t ? [t] : []];
-}, s = (e) => {
-	console.error(e);
-}, c = (e) => {
-	s = e;
-}, l = () => s, u = (e) => {
-	c(e.notify);
-}, d = (n) => {
-	let r = l();
-	if (e(n)) {
-		let e = n.data, i = [...new Set(o(e))];
-		if (i.length > 0) {
-			i.forEach((e) => r(e));
-			return;
-		}
-		r(t);
-		return;
-	}
-	if (n instanceof Error) {
-		r(n.message || "Something went wrong");
-		return;
-	}
-	r(t);
-};
-//#endregion
-export { u as n, d as t };

package/dist/chunks/handle-api-error-D714W9rp.cjs

@@ -1 +0,0 @@
-let e=require("ky");var t=`Something went wrong`,n=new Set([`message`,`detail`,`error`,`msg`]),r=e=>typeof e==`object`&&!!e&&!Array.isArray(e),i=e=>typeof e==`string`&&e.trim()?e:null,a=(e,t)=>typeof e==`string`?e.trim()?[t?`${t}: ${e}`:e]:[]:Array.isArray(e)?e.flatMap(e=>a(e,t)):r(e)?Object.entries(e).flatMap(([e,t])=>a(t,e===`non_field_errors`?void 0:e)):[],o=e=>{if(!e)return[];if(typeof e==`string`)return[e];if(Array.isArray(e))return e.filter(e=>typeof e==`string`&&!!e.trim());let t=i(e.detail)??i(e.message)??i(e.error)??i(e.msg);return[...Object.entries(e).flatMap(([e,t])=>n.has(e)?[]:e===`non_field_errors`||e===`errors`?a(t):a(t,e)),...t?[t]:[]]},s=e=>{console.error(e)},c=e=>{s=e},l=()=>s,u=e=>{c(e.notify)},d=n=>{let r=l();if((0,e.isHTTPError)(n)){let e=n.data,i=[...new Set(o(e))];if(i.length>0){i.forEach(e=>r(e));return}r(t);return}if(n instanceof Error){r(n.message||`Something went wrong`);return}r(t)};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return d}});