@i18n-micro/utils 1.0.7 → 1.0.8

package/dist/cache-control.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class s{constructor(t){this.cache=new Map,this.expiry=new Map,this.maxSize=0,this.ttlMs=0,t&&this.configure(t)}configure(t){this.maxSize=t.maxSize??0,this.ttlMs=(t.ttl??0)*1e3,this.ttlMs===0&&this.expiry.clear()}get(t){const e=this.cache.get(t);if(e!==void 0){if(this.ttlMs>0){const i=this.expiry.get(t);if(i&&Date.now()>i){this.delete(t);return}this.expiry.set(t,Date.now()+this.ttlMs)}return this.cache.delete(t),this.cache.set(t,e),e}}has(t){if(!this.cache.has(t))return!1;if(this.ttlMs>0){const e=this.expiry.get(t);if(e&&Date.now()>e)return this.delete(t),!1}return!0}set(t,e){if(this.cache.has(t))this.cache.delete(t);else if(this.maxSize>0&&this.cache.size>=this.maxSize){const i=this.cache.keys().next().value;i!==void 0&&this.delete(i)}this.cache.set(t,e),this.ttlMs>0&&this.expiry.set(t,Date.now()+this.ttlMs)}delete(t){return this.expiry.delete(t),this.cache.delete(t)}clear(){this.cache.clear(),this.expiry.clear()}keys(){return this.cache.keys()}get size(){return this.cache.size}}exports.CacheControl=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class s{constructor(t){this.cache=new Map,this.expiry=new Map,this.maxSize=0,this.ttlMs=0,t&&this.configure(t)}configure(t){this.maxSize=t.maxSize??0,this.ttlMs=(t.ttl??0)*1e3,this.ttlMs===0&&this.expiry.clear()}get(t){const e=this.cache.get(t);if(e!==void 0){if(this.ttlMs>0){const i=this.expiry.get(t);if(i&&Date.now()>i){this.delete(t);return}this.expiry.set(t,Date.now()+this.ttlMs)}return this.maxSize>0&&(this.cache.delete(t),this.cache.set(t,e)),e}}has(t){if(!this.cache.has(t))return!1;if(this.ttlMs>0){const e=this.expiry.get(t);if(e&&Date.now()>e)return this.delete(t),!1}return!0}set(t,e){if(this.cache.has(t))this.cache.delete(t);else if(this.maxSize>0&&this.cache.size>=this.maxSize){const i=this.cache.keys().next().value;i!==void 0&&this.delete(i)}this.cache.set(t,e),this.ttlMs>0&&this.expiry.set(t,Date.now()+this.ttlMs)}delete(t){return this.expiry.delete(t),this.cache.delete(t)}clear(){this.cache.clear(),this.expiry.clear()}keys(){return this.cache.keys()}get size(){return this.cache.size}}exports.CacheControl=s;

package/dist/cache-control.mjs

@@ -17,7 +17,7 @@ class h {
         }
         this.expiry.set(t, Date.now() + this.ttlMs);
       }
-      return this.cache.delete(t), this.cache.set(t, e), e;
+      return this.maxSize > 0 && (this.cache.delete(t), this.cache.set(t, e)), e;
     }
   }
   has(t) {

package/dist/deep-merge.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(s,o){const t={...s};for(const e in o){if(e==="__proto__"||e==="constructor")continue;const r=o[e],n=t[e];r!==null&&typeof r=="object"&&!Array.isArray(r)&&n!==null&&typeof n=="object"&&!Array.isArray(n)?t[e]={...n,...r}:t[e]=r}return t}function c(s,o){if(!s||Object.keys(s).length===0)return{...o};const t={...s};for(const e in o){if(e==="__proto__"||e==="constructor")continue;const r=o[e],n=t[e];r&&typeof r=="object"&&!Array.isArray(r)&&n&&typeof n=="object"&&!Array.isArray(n)?t[e]=c(n,r):t[e]=r}return t}exports.deepMergeTranslations=i;exports.deepMergeTranslationsRecursive=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(s,n){const r={...s};for(const e of Object.keys(n)){if(e==="__proto__")continue;const t=n[e],o=r[e];t!==null&&typeof t=="object"&&!Array.isArray(t)&&o!==null&&typeof o=="object"&&!Array.isArray(o)?r[e]={...o,...t}:r[e]=t}return r}function c(s,n){if(!s||Object.keys(s).length===0)return{...n};const r={...s};for(const e of Object.keys(n)){if(e==="__proto__")continue;const t=n[e],o=r[e];t&&typeof t=="object"&&!Array.isArray(t)&&o&&typeof o=="object"&&!Array.isArray(o)?r[e]=c(o,t):r[e]=t}return r}exports.deepMergeTranslations=i;exports.deepMergeTranslationsRecursive=c;

package/dist/deep-merge.mjs

@@ -1,23 +1,23 @@
-function i(s, e) {
-  const o = { ...s };
-  for (const t in e) {
-    if (t === "__proto__" || t === "constructor") continue;
-    const r = e[t], n = o[t];
-    r !== null && typeof r == "object" && !Array.isArray(r) && n !== null && typeof n == "object" && !Array.isArray(n) ? o[t] = { ...n, ...r } : o[t] = r;
+function y(s, n) {
+  const r = { ...s };
+  for (const e of Object.keys(n)) {
+    if (e === "__proto__") continue;
+    const t = n[e], o = r[e];
+    t !== null && typeof t == "object" && !Array.isArray(t) && o !== null && typeof o == "object" && !Array.isArray(o) ? r[e] = { ...o, ...t } : r[e] = t;
   }
-  return o;
+  return r;
 }
-function c(s, e) {
-  if (!s || Object.keys(s).length === 0) return { ...e };
-  const o = { ...s };
-  for (const t in e) {
-    if (t === "__proto__" || t === "constructor") continue;
-    const r = e[t], n = o[t];
-    r && typeof r == "object" && !Array.isArray(r) && n && typeof n == "object" && !Array.isArray(n) ? o[t] = c(n, r) : o[t] = r;
+function c(s, n) {
+  if (!s || Object.keys(s).length === 0) return { ...n };
+  const r = { ...s };
+  for (const e of Object.keys(n)) {
+    if (e === "__proto__") continue;
+    const t = n[e], o = r[e];
+    t && typeof t == "object" && !Array.isArray(t) && o && typeof o == "object" && !Array.isArray(o) ? r[e] = c(o, t) : r[e] = t;
   }
-  return o;
+  return r;
 }
 export {
-  i as deepMergeTranslations,
+  y as deepMergeTranslations,
   c as deepMergeTranslationsRecursive
 };

package/dist/payload-stats.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("node:fs"),s=require("node:path");function r(n,t){for(const e of o.readdirSync(n,{withFileTypes:!0})){const i=s.join(n,e.name);if(e.isDirectory()){r(i,t);continue}e.name.endsWith(".json")&&(t.fileCount+=1,t.totalBytes+=o.statSync(i).size)}}function a(n){const t={fileCount:0,totalBytes:0};return o.existsSync(n)&&r(n,t),t}exports.scanTranslationPayloadDirectory=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("node:crypto"),o=require("node:fs"),l=require("node:zlib"),u=require("node:path");function f(n,t){for(const e of o.readdirSync(n,{withFileTypes:!0})){const s=u.join(n,e.name);e.isDirectory()?f(s,t):e.name.endsWith(".json")&&t.push(s)}}function S(n){const t={fileCount:0,totalBytes:0};if(!o.existsSync(n))return t;const e=[];f(n,e);for(const s of e)t.fileCount+=1,t.totalBytes+=o.statSync(s).size;return t}function d(n,t){const e=y.createHash("sha256");let s=0;for(const c of n){const a=u.join(c,t);if(!o.existsSync(a))continue;const r=[];f(a,r),r.sort();for(const i of r)e.update(u.relative(a,i)),e.update("\0"),e.update(o.readFileSync(i)),s+=1}return s>0?e.digest("hex").slice(0,16):null}const h=1024;function T(n,t){if(!t||!o.existsSync(n))return 0;const e=t===!0||t.gzip!==!1,s=t===!0||t.brotli!==!1;if(!e&&!s)return 0;const c=[];f(n,c);let a=0;for(const r of c){const i=o.readFileSync(r);i.length<h||(e&&o.writeFileSync(`${r}.gz`,l.gzipSync(i,{level:9})),s&&o.writeFileSync(`${r}.br`,l.brotliCompressSync(i,{params:{[l.constants.BROTLI_PARAM_QUALITY]:11,[l.constants.BROTLI_PARAM_SIZE_HINT]:i.length}})),a+=1)}return a}exports.compressTranslationPayloads=T;exports.hashTranslationSources=d;exports.scanTranslationPayloadDirectory=S;

package/dist/payload-stats.d.cts

@@ -1,2 +1,32 @@
 import { TranslationPayloadStats } from './payload-config';
 export declare function scanTranslationPayloadDirectory(dir: string): TranslationPayloadStats;
+/**
+ * Fingerprint of the translation sources, used to cache-bust `_locales` requests.
+ *
+ * The alternative — a build timestamp — changes on every deploy, so browsers and CDNs
+ * throw away a dictionary that may not have changed at all. Hashing the sources means
+ * the URL only moves when the translations actually move.
+ *
+ * Layer order matters (later layers override earlier ones), so paths are hashed in the
+ * order given and relative to their own root: an identical tree checked out elsewhere
+ * must produce the same value.
+ *
+ * Returns `null` when there is nothing to hash, leaving the caller to fall back.
+ */
+export declare function hashTranslationSources(rootDirs: string[], translationDirName: string): string | null;
+/** Nitro's `compressPublicAssets`: `true` means both encodings, an object selects them. */
+export type PublicAssetCompression = boolean | {
+    gzip?: boolean;
+    brotli?: boolean;
+} | undefined;
+/**
+ * Gzip/brotli the translation payloads copied into the public directory.
+ *
+ * Nitro compresses public assets before the `nitro:build:public-assets` hook where the
+ * payloads are copied, so `compressPublicAssets` never reaches them — a static host
+ * would serve the single largest part of the output uncompressed. This applies the
+ * user's setting to those files; it does not turn compression on by itself.
+ *
+ * Returns the number of files actually compressed.
+ */
+export declare function compressTranslationPayloads(dir: string, compression: PublicAssetCompression): number;

package/dist/payload-stats.d.ts

@@ -1,2 +1,32 @@
 import { TranslationPayloadStats } from './payload-config';
 export declare function scanTranslationPayloadDirectory(dir: string): TranslationPayloadStats;
+/**
+ * Fingerprint of the translation sources, used to cache-bust `_locales` requests.
+ *
+ * The alternative — a build timestamp — changes on every deploy, so browsers and CDNs
+ * throw away a dictionary that may not have changed at all. Hashing the sources means
+ * the URL only moves when the translations actually move.
+ *
+ * Layer order matters (later layers override earlier ones), so paths are hashed in the
+ * order given and relative to their own root: an identical tree checked out elsewhere
+ * must produce the same value.
+ *
+ * Returns `null` when there is nothing to hash, leaving the caller to fall back.
+ */
+export declare function hashTranslationSources(rootDirs: string[], translationDirName: string): string | null;
+/** Nitro's `compressPublicAssets`: `true` means both encodings, an object selects them. */
+export type PublicAssetCompression = boolean | {
+    gzip?: boolean;
+    brotli?: boolean;
+} | undefined;
+/**
+ * Gzip/brotli the translation payloads copied into the public directory.
+ *
+ * Nitro compresses public assets before the `nitro:build:public-assets` hook where the
+ * payloads are copied, so `compressPublicAssets` never reaches them — a static host
+ * would serve the single largest part of the output uncompressed. This applies the
+ * user's setting to those files; it does not turn compression on by itself.
+ *
+ * Returns the number of files actually compressed.
+ */
+export declare function compressTranslationPayloads(dir: string, compression: PublicAssetCompression): number;

package/dist/payload-stats.mjs

@@ -1,19 +1,54 @@
-import { existsSync as r, readdirSync as s, statSync as c } from "node:fs";
-import { join as a } from "node:path";
-function i(n, t) {
-  for (const o of s(n, { withFileTypes: !0 })) {
-    const e = a(n, o.name);
-    if (o.isDirectory()) {
-      i(e, t);
-      continue;
-    }
-    o.name.endsWith(".json") && (t.fileCount += 1, t.totalBytes += c(e).size);
+import { createHash as p } from "node:crypto";
+import { existsSync as c, readFileSync as y, writeFileSync as a, statSync as S, readdirSync as m } from "node:fs";
+import { gzipSync as T, brotliCompressSync as d, constants as u } from "node:zlib";
+import { join as h, relative as _ } from "node:path";
+function f(n, t) {
+  for (const e of m(n, { withFileTypes: !0 })) {
+    const o = h(n, e.name);
+    e.isDirectory() ? f(o, t) : e.name.endsWith(".json") && t.push(o);
   }
 }
-function u(n) {
+function A(n) {
   const t = { fileCount: 0, totalBytes: 0 };
-  return r(n) && i(n, t), t;
+  if (!c(n)) return t;
+  const e = [];
+  f(n, e);
+  for (const o of e)
+    t.fileCount += 1, t.totalBytes += S(o).size;
+  return t;
+}
+function B(n, t) {
+  const e = p("sha256");
+  let o = 0;
+  for (const l of n) {
+    const i = h(l, t);
+    if (!c(i)) continue;
+    const s = [];
+    f(i, s), s.sort();
+    for (const r of s)
+      e.update(_(i, r)), e.update("\0"), e.update(y(r)), o += 1;
+  }
+  return o > 0 ? e.digest("hex").slice(0, 16) : null;
+}
+const g = 1024;
+function b(n, t) {
+  if (!t || !c(n)) return 0;
+  const e = t === !0 || t.gzip !== !1, o = t === !0 || t.brotli !== !1;
+  if (!e && !o) return 0;
+  const l = [];
+  f(n, l);
+  let i = 0;
+  for (const s of l) {
+    const r = y(s);
+    r.length < g || (e && a(`${s}.gz`, T(r, { level: 9 })), o && a(
+      `${s}.br`,
+      d(r, { params: { [u.BROTLI_PARAM_QUALITY]: 11, [u.BROTLI_PARAM_SIZE_HINT]: r.length } })
+    ), i += 1);
+  }
+  return i;
 }
 export {
-  u as scanTranslationPayloadDirectory
+  b as compressTranslationPayloads,
+  B as hashTranslationSources,
+  A as scanTranslationPayloadDirectory
 };

package/dist/payload-url.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function r(a,e){const l=a||"index";return e?.[l]??l}function o(a,e,l){return`/${a.replace(/^\/+|\/+$/g,"")}/${e}/${l}/data.json`.replace(/\/{2,}/g,"/")}function n(a){return(a.isServer?a.apiBaseServerHost:a.apiBaseClientHost)??a.baseURL}function t(a){const e=r(a.routeName,a.routesLocaleLinks);return{path:o(a.apiBaseUrl,e,a.locale),baseURL:n(a),params:a.dateBuild?{v:a.dateBuild}:void 0}}exports.buildTranslationPayloadFetchRequest=t;exports.buildTranslationPayloadPath=o;exports.resolveTranslationPayloadBaseURL=n;exports.resolveTranslationPayloadPage=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function r(a,e){const l=a||"index";return e?.[l]??l}function t(a,e,l){return`/${a.replace(/^\/+|\/+$/g,"")}/${e}/${l}/data.json`.replace(/\/{2,}/g,"/")}function n(a){return(a.isServer?a.apiBaseServerHost:a.apiBaseClientHost)??a.baseURL}function o(a){const e=r(a.routeName,a.routesLocaleLinks);return{path:t(a.apiBaseUrl,e,a.locale),baseURL:n(a),params:a.dateBuild?{v:a.dateBuild}:void 0}}function s(a,e=!0){const l=Math.floor(a??0);return!Number.isSafeInteger(l)||l<=0?null:e?`public, max-age=${l}, immutable`:"public, max-age=0, must-revalidate"}exports.buildTranslationPayloadCacheControl=s;exports.buildTranslationPayloadFetchRequest=o;exports.buildTranslationPayloadPath=t;exports.resolveTranslationPayloadBaseURL=n;exports.resolveTranslationPayloadPage=r;

package/dist/payload-url.d.cts

@@ -22,3 +22,15 @@ export declare function buildTranslationPayloadFetchRequest(input: TranslationPa
     baseURL: string;
     params?: Record<string, string | number>;
 };
+/**
+ * Builds `Cache-Control` for `/{apiBaseUrl}/:page/:locale/data.json`.
+ *
+ * `immutable` is only emitted when a cache-buster is active (`hasCacheBuster`),
+ * i.e. requests carry `?v=<dateBuild>`. Without a cache-buster (`dateBuild` set
+ * to `0`/`''`) the URL is stable across deploys, so we intentionally avoid
+ * long-lived caching by returning a conservative `max-age=0` policy.
+ *
+ * Returns `null` when caching should be skipped — non-positive or non-finite
+ * `duration` (guards `NaN`/`Infinity` from producing a malformed header).
+ */
+export declare function buildTranslationPayloadCacheControl(durationSeconds: number | undefined, hasCacheBuster?: boolean): string | null;

package/dist/payload-url.d.ts

@@ -22,3 +22,15 @@ export declare function buildTranslationPayloadFetchRequest(input: TranslationPa
     baseURL: string;
     params?: Record<string, string | number>;
 };
+/**
+ * Builds `Cache-Control` for `/{apiBaseUrl}/:page/:locale/data.json`.
+ *
+ * `immutable` is only emitted when a cache-buster is active (`hasCacheBuster`),
+ * i.e. requests carry `?v=<dateBuild>`. Without a cache-buster (`dateBuild` set
+ * to `0`/`''`) the URL is stable across deploys, so we intentionally avoid
+ * long-lived caching by returning a conservative `max-age=0` policy.
+ *
+ * Returns `null` when caching should be skipped — non-positive or non-finite
+ * `duration` (guards `NaN`/`Infinity` from producing a malformed header).
+ */
+export declare function buildTranslationPayloadCacheControl(durationSeconds: number | undefined, hasCacheBuster?: boolean): string | null;

package/dist/payload-url.mjs

@@ -5,20 +5,25 @@ function l(a, e) {
 function n(a, e, r) {
   return `/${a.replace(/^\/+|\/+$/g, "")}/${e}/${r}/data.json`.replace(/\/{2,}/g, "/");
 }
-function o(a) {
+function t(a) {
   return (a.isServer ? a.apiBaseServerHost : a.apiBaseClientHost) ?? a.baseURL;
 }
-function t(a) {
+function s(a) {
   const e = l(a.routeName, a.routesLocaleLinks);
   return {
     path: n(a.apiBaseUrl, e, a.locale),
-    baseURL: o(a),
+    baseURL: t(a),
     params: a.dateBuild ? { v: a.dateBuild } : void 0
   };
 }
+function i(a, e = !0) {
+  const r = Math.floor(a ?? 0);
+  return !Number.isSafeInteger(r) || r <= 0 ? null : e ? `public, max-age=${r}, immutable` : "public, max-age=0, must-revalidate";
+}
 export {
-  t as buildTranslationPayloadFetchRequest,
+  i as buildTranslationPayloadCacheControl,
+  s as buildTranslationPayloadFetchRequest,
   n as buildTranslationPayloadPath,
-  o as resolveTranslationPayloadBaseURL,
+  t as resolveTranslationPayloadBaseURL,
   l as resolveTranslationPayloadPage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/utils",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Framework-agnostic utilities for Nuxt I18n Micro (granular subpath imports).",
   "keywords": [
     "i18n",
@@ -353,14 +353,14 @@
   },
   "dependencies": {
     "globby": "^14.1.0",
-    "@i18n-micro/types": "1.2.6"
+    "@i18n-micro/types": "1.2.7"
   },
   "devDependencies": {
     "publint": "^0.3.17",
-    "vite": "^7.3.1",
+    "vite": "^7.3.6",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^3.2.4",
-    "@i18n-micro/test-utils": "1.2.2"
+    "vitest": "^4.1.10",
+    "@i18n-micro/test-utils": "1.2.6"
   },
   "engines": {
     "node": ">=18"
@@ -368,7 +368,7 @@
   "scripts": {
     "build": "vite build",
     "check:package": "publint",
-    "test": "jest",
+    "test": "vitest run",
     "test:dist": "vitest run --config vitest.dist.config.ts"
   }
 }