@intlayer/config 9.3.0 → 9.3.2

package/dist/esm/utils/cacheDisk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cacheDisk.mjs","names":[],"sources":["../../../src/utils/cacheDisk.ts"],"sourcesContent":["import {\n  mkdir,\n  readFile,\n  rename,\n  rm,\n  stat,\n  unlink,\n  writeFile,\n} from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { deserialize, serialize } from 'node:v8';\nimport { gunzipSync, gzipSync } from 'node:zlib';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport configPackageJson from '@intlayer/types/package.json' with {\n  type: 'json',\n};\nimport { type CacheKey, clearAllCache, computeKeyId } from './cacheMemory';\n\n/** ------------------------- Persistence layer ------------------------- **/\n\n/** Cache envelope structure stored on disk */\ntype CacheEnvelope = {\n  /** Version of the config package (for cache invalidation) */\n  version: string;\n  /** Timestamp when the cache entry was created (in milliseconds) */\n  timestamp: number;\n  /** Data payload (the actual cached value) */\n  data: unknown;\n};\n\ntype LocalCacheOptions = {\n  /** Preferred new option name */\n  persistent?: boolean;\n  /** Time-to-live in ms; if expired, disk entry is ignored. */\n  ttlMs?: number;\n  /** Max age in ms based on stored creation timestamp; invalidates on exceed. */\n  maxTimeMs?: number;\n  /** Optional namespace to separate different logical caches. */\n  namespace?: string;\n  /** Gzip values on disk (on by default for blobs > 1KB). */\n  compress?: boolean;\n};\n\nconst DEFAULTS: Required<Pick<LocalCacheOptions, 'compress'>> = {\n  compress: true,\n};\n\nconst ensureDir = async (dir: string) => {\n  await mkdir(dir, { recursive: true });\n};\n\nconst atomicWriteFile = async (\n  file: string,\n  data: Buffer,\n  tempDir?: string\n) => {\n  if (tempDir) {\n    try {\n      await ensureDir(tempDir);\n    } catch {}\n  }\n\n  const tempFileName = `${basename(file)}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  const tmp = tempDir\n    ? join(tempDir, tempFileName)\n    : `${file}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  try {\n    await writeFile(tmp, data);\n    await rename(tmp, file);\n  } catch (error) {\n    try {\n      await rm(tmp, { force: true });\n    } catch {\n      // Ignore\n    }\n    throw error;\n  }\n};\n\nconst shouldUseCompression = (buf: Buffer, force?: boolean) =>\n  force === true || (force !== false && buf.byteLength > 1024);\n\n/** Derive on-disk path from config dir + namespace + key id. */\nconst cachePath = (cacheDir: string, id: string, ns?: string) =>\n  join(cacheDir, ns ? join(ns, id) : id);\n\n/** ------------------------- Local cache facade ------------------------- **/\n\nconst cacheMap = new Map<string, any>();\n\n/** Clears the in-memory portion of the disk cache without touching disk files. */\nexport const clearDiskCacheMemory = (): void => {\n  cacheMap.clear();\n};\n\nexport const cacheDisk = (\n  intlayerConfig: IntlayerConfig,\n  keys: CacheKey[],\n  options?: LocalCacheOptions\n) => {\n  const { cacheDir, tempDir } = intlayerConfig.system;\n  const buildCacheEnabled = intlayerConfig.build.cache ?? true;\n  const persistent =\n    options?.persistent === true ||\n    (typeof options?.persistent === 'undefined' && buildCacheEnabled);\n\n  const { compress, ttlMs, maxTimeMs, namespace } = {\n    ...DEFAULTS,\n    ...options,\n  };\n\n  // single stable id for this key tuple (works for both memory & disk)\n  const id = computeKeyId(keys);\n  const filePath = cachePath(cacheDir, id, namespace);\n\n  const readFromDisk = async (): Promise<unknown | undefined> => {\n    try {\n      const statValue = await stat(filePath).catch(() => undefined);\n\n      if (!statValue) return undefined;\n\n      if (typeof ttlMs === 'number' && ttlMs > 0) {\n        const age = Date.now() - statValue.mtimeMs;\n        if (age > ttlMs) return undefined;\n      }\n      let raw = await readFile(filePath);\n      // header: 1 byte flag (0x00 raw, 0x01 gzip)\n      const flag = raw[0];\n\n      raw = raw.subarray(1);\n\n      const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n      const deserialized = deserialize(payload) as unknown;\n\n      let value: unknown;\n      const maybeObj = deserialized as Record<string, unknown> | null;\n      const isEnvelope =\n        !!maybeObj &&\n        typeof maybeObj === 'object' &&\n        typeof (maybeObj as any).version === 'string' &&\n        typeof (maybeObj as any).timestamp === 'number' &&\n        Object.hasOwn(maybeObj, 'data');\n\n      if (isEnvelope) {\n        const entry = maybeObj as CacheEnvelope;\n\n        if (entry.version !== configPackageJson.version) {\n          try {\n            await unlink(filePath);\n          } catch {}\n          return undefined;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - entry.timestamp;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n\n        value = entry.data;\n      } else {\n        // Backward compatibility: old entries had raw serialized value.\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n        value = deserialized;\n      }\n\n      // hydrate memory cache as well\n      cacheMap.set(id, value);\n      return value;\n    } catch {\n      return undefined;\n    }\n  };\n\n  const writeToDisk = async (value: unknown) => {\n    try {\n      await ensureDir(dirname(filePath));\n      const envelope: CacheEnvelope = {\n        version: configPackageJson.version,\n        timestamp: Date.now(),\n        data: value,\n      };\n      const payload = Buffer.from(serialize(envelope));\n\n      const gz = shouldUseCompression(payload, compress)\n        ? gzipSync(payload)\n        : payload;\n\n      // prepend a 1-byte header indicating compression\n      const buf = Buffer.concat([\n        Buffer.from([gz === payload ? 0x00 : 0x01]),\n        gz,\n      ]);\n\n      await atomicWriteFile(filePath, buf, tempDir);\n    } catch {\n      // swallow disk errors for cache writes\n    }\n  };\n\n  return {\n    /** In-memory first, then disk (if enabled), otherwise undefined. */\n    get: async <T>(): Promise<T | undefined> => {\n      const mem = cacheMap.get(id);\n\n      if (mem !== undefined) return mem as T;\n\n      if (persistent && buildCacheEnabled) {\n        return (await readFromDisk()) as T | undefined;\n      }\n      return undefined;\n    },\n    /** Sets in-memory (always) and persists to disk if enabled. */\n    set: async (value: unknown): Promise<void> => {\n      cacheMap.set(id, value);\n\n      if (persistent && buildCacheEnabled) {\n        await writeToDisk(value);\n      }\n    },\n    /** Clears only this entry from memory and disk. */\n    clear: async (): Promise<void> => {\n      cacheMap.delete(id);\n\n      try {\n        await unlink(filePath);\n      } catch {}\n    },\n    /** Clears ALL cached entries (memory Map and entire cacheDir namespace if persistent). */\n    clearAll: async (): Promise<void> => {\n      clearAllCache();\n      if (persistent && buildCacheEnabled) {\n        // remove only the current namespace (if provided), else the root dir\n        const base = namespace ? join(cacheDir, namespace) : cacheDir;\n\n        try {\n          await rm(base, { recursive: true, force: true });\n        } catch {}\n\n        try {\n          await mkdir(base, { recursive: true });\n        } catch {}\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    isValid: async (): Promise<boolean> => {\n      const cachedValue = cacheMap.get(id);\n      if (cachedValue !== undefined) return true;\n\n      // If persistence is disabled or build cache disabled, only memory can be valid\n      if (!persistent || !buildCacheEnabled) return false;\n\n      try {\n        const statValue = await stat(filePath).catch(() => undefined);\n        if (!statValue) return false;\n\n        if (typeof ttlMs === 'number' && ttlMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > ttlMs) return false;\n        }\n\n        let raw = await readFile(filePath);\n        const flag = raw[0];\n        raw = raw.subarray(1);\n        const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n        const deserialized = deserialize(payload) as unknown;\n\n        const maybeObj = deserialized as Record<string, unknown> | null;\n        const isEnvelope =\n          !!maybeObj &&\n          typeof maybeObj === 'object' &&\n          typeof maybeObj.version === 'string' &&\n          typeof maybeObj.timestamp === 'number' &&\n          Object.hasOwn(maybeObj, 'data');\n\n        if (isEnvelope) {\n          const entry = maybeObj as CacheEnvelope;\n          if (entry.version !== configPackageJson.version) return false;\n\n          if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n            const age = Date.now() - entry.timestamp;\n            if (age > maxTimeMs) return false;\n          }\n          return true;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) return false;\n        }\n        return true;\n      } catch {\n        return false;\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    id,\n    /** Expose the absolute file path for debugging. */\n    filePath,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"cacheDisk.mjs","names":[],"sources":["../../../src/utils/cacheDisk.ts"],"sourcesContent":["import {\n  mkdir,\n  readFile,\n  rename,\n  rm,\n  stat,\n  unlink,\n  writeFile,\n} from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { deserialize, serialize } from 'node:v8';\nimport { gunzipSync, gzipSync } from 'node:zlib';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport configPackageJson from '@intlayer/types/package.json' with {\n  type: 'json',\n};\nimport { type CacheKey, clearAllCache, computeKeyId } from './cacheMemory';\n\n/** ------------------------- Persistence layer ------------------------- **/\n\n/** Cache envelope structure stored on disk */\ntype CacheEnvelope = {\n  /** Version of the config package (for cache invalidation) */\n  version: string;\n  /** Timestamp when the cache entry was created (in milliseconds) */\n  timestamp: number;\n  /** Data payload (the actual cached value) */\n  data: unknown;\n};\n\ntype LocalCacheOptions = {\n  /** Preferred new option name */\n  persistent?: boolean;\n  /** Time-to-live in ms; if expired, disk entry is ignored. */\n  ttlMs?: number;\n  /** Max age in ms based on stored creation timestamp; invalidates on exceed. */\n  maxTimeMs?: number;\n  /** Optional namespace to separate different logical caches. */\n  namespace?: string;\n  /** Gzip values on disk (on by default for blobs > 1KB). */\n  compress?: boolean;\n};\n\nconst DEFAULTS: Required<Pick<LocalCacheOptions, 'compress'>> = {\n  compress: true,\n};\n\nconst ensureDir = async (dir: string) => {\n  await mkdir(dir, { recursive: true });\n};\n\nconst atomicWriteFile = async (\n  file: string,\n  data: Buffer,\n  tempDir?: string\n) => {\n  if (tempDir) {\n    try {\n      await ensureDir(tempDir);\n    } catch {}\n  }\n\n  const tempFileName = `${basename(file)}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  const tmp = tempDir\n    ? join(tempDir, tempFileName)\n    : `${file}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  try {\n    await writeFile(tmp, data);\n    await rename(tmp, file);\n  } catch (error) {\n    try {\n      await rm(tmp, { force: true });\n    } catch {\n      // Ignore\n    }\n    throw error;\n  }\n};\n\nconst shouldUseCompression = (buf: Buffer, force?: boolean) =>\n  force === true || (force !== false && buf.byteLength > 1024);\n\n/** Derive on-disk path from config dir + namespace + key id. */\nconst cachePath = (cacheDir: string, id: string, ns?: string) =>\n  join(cacheDir, ns ? join(ns, id) : id);\n\n/** ------------------------- Local cache facade ------------------------- **/\n\nconst cacheMap = new Map<string, any>();\n\n/** Clears the in-memory portion of the disk cache without touching disk files. */\nexport const clearDiskCacheMemory = (): void => {\n  cacheMap.clear();\n};\n\nexport const cacheDisk = (\n  intlayerConfig: IntlayerConfig,\n  keys: CacheKey[],\n  options?: LocalCacheOptions\n) => {\n  const { cacheDir, tempDir } = intlayerConfig.system;\n  const buildCacheEnabled = intlayerConfig.build.cache ?? true;\n  const persistent =\n    options?.persistent === true ||\n    (typeof options?.persistent === 'undefined' && buildCacheEnabled);\n\n  const { compress, ttlMs, maxTimeMs, namespace } = {\n    ...DEFAULTS,\n    ...options,\n  };\n\n  // single stable id for this key tuple (works for both memory & disk)\n  const id = computeKeyId(keys);\n  const filePath = cachePath(cacheDir, id, namespace);\n\n  const readFromDisk = async (): Promise<unknown | undefined> => {\n    try {\n      const statValue = await stat(filePath).catch(() => undefined);\n\n      if (!statValue) return undefined;\n\n      if (typeof ttlMs === 'number' && ttlMs > 0) {\n        const age = Date.now() - statValue.mtimeMs;\n        if (age > ttlMs) return undefined;\n      }\n      let raw = await readFile(filePath);\n      // header: 1 byte flag (0x00 raw, 0x01 gzip)\n      const flag = raw[0];\n\n      raw = raw.subarray(1);\n\n      const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n      const deserialized = deserialize(payload) as unknown;\n\n      let value: unknown;\n      const maybeObj = deserialized as Record<string, unknown> | null;\n      const isEnvelope =\n        !!maybeObj &&\n        typeof maybeObj === 'object' &&\n        typeof (maybeObj as any).version === 'string' &&\n        typeof (maybeObj as any).timestamp === 'number' &&\n        Object.hasOwn(maybeObj, 'data');\n\n      if (isEnvelope) {\n        const entry = maybeObj as CacheEnvelope;\n\n        if (entry.version !== configPackageJson.version) {\n          try {\n            await unlink(filePath);\n          } catch {}\n          return undefined;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - entry.timestamp;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n\n        value = entry.data;\n      } else {\n        // Backward compatibility: old entries had raw serialized value.\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n        value = deserialized;\n      }\n\n      // hydrate memory cache as well\n      cacheMap.set(id, value);\n      return value;\n    } catch {\n      return undefined;\n    }\n  };\n\n  const writeToDisk = async (value: unknown) => {\n    try {\n      await ensureDir(dirname(filePath));\n      const envelope: CacheEnvelope = {\n        version: configPackageJson.version,\n        timestamp: Date.now(),\n        data: value,\n      };\n      const payload = Buffer.from(serialize(envelope));\n\n      const gz = shouldUseCompression(payload, compress)\n        ? gzipSync(payload)\n        : payload;\n\n      // prepend a 1-byte header indicating compression\n      const buf = Buffer.concat([\n        Buffer.from([gz === payload ? 0x00 : 0x01]),\n        gz,\n      ]);\n\n      await atomicWriteFile(filePath, buf, tempDir);\n    } catch {\n      // swallow disk errors for cache writes\n    }\n  };\n\n  return {\n    /** In-memory first, then disk (if enabled), otherwise undefined. */\n    get: async <T>(): Promise<T | undefined> => {\n      const mem = cacheMap.get(id);\n\n      if (mem !== undefined) return mem as T;\n\n      if (persistent && buildCacheEnabled) {\n        return (await readFromDisk()) as T | undefined;\n      }\n      return undefined;\n    },\n    /** Sets in-memory (always) and persists to disk if enabled. */\n    set: async (value: unknown): Promise<void> => {\n      cacheMap.set(id, value);\n\n      if (persistent && buildCacheEnabled) {\n        await writeToDisk(value);\n      }\n    },\n    /** Clears only this entry from memory and disk. */\n    clear: async (): Promise<void> => {\n      cacheMap.delete(id);\n\n      try {\n        await unlink(filePath);\n      } catch {}\n    },\n    /** Clears ALL cached entries (memory Map and entire cacheDir namespace if persistent). */\n    clearAll: async (): Promise<void> => {\n      clearAllCache();\n      if (persistent && buildCacheEnabled) {\n        // remove only the current namespace (if provided), else the root dir\n        const base = namespace ? join(cacheDir, namespace) : cacheDir;\n\n        try {\n          await rm(base, { recursive: true, force: true });\n        } catch {}\n\n        try {\n          await mkdir(base, { recursive: true });\n        } catch {}\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    isValid: async (): Promise<boolean> => {\n      const cachedValue = cacheMap.get(id);\n      if (cachedValue !== undefined) return true;\n\n      // If persistence is disabled or build cache disabled, only memory can be valid\n      if (!persistent || !buildCacheEnabled) return false;\n\n      try {\n        const statValue = await stat(filePath).catch(() => undefined);\n        if (!statValue) return false;\n\n        if (typeof ttlMs === 'number' && ttlMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > ttlMs) return false;\n        }\n\n        let raw = await readFile(filePath);\n        const flag = raw[0];\n        raw = raw.subarray(1);\n        const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n        const deserialized = deserialize(payload) as unknown;\n\n        const maybeObj = deserialized as Record<string, unknown> | null;\n        const isEnvelope =\n          !!maybeObj &&\n          typeof maybeObj === 'object' &&\n          typeof maybeObj.version === 'string' &&\n          typeof maybeObj.timestamp === 'number' &&\n          Object.hasOwn(maybeObj, 'data');\n\n        if (isEnvelope) {\n          const entry = maybeObj as CacheEnvelope;\n          if (entry.version !== configPackageJson.version) return false;\n\n          if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n            const age = Date.now() - entry.timestamp;\n            if (age > maxTimeMs) return false;\n          }\n          return true;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) return false;\n        }\n        return true;\n      } catch {\n        return false;\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    id,\n    /** Expose the absolute file path for debugging. */\n    filePath,\n  };\n};\n"],"mappings":"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"}

package/dist/esm/utils/getStorageAttributes.mjs

@@ -2,7 +2,7 @@ import { COOKIE_NAME, HEADER_NAME, LOCALE_STORAGE_NAME } from "../defaultValues/
 
 //#region src/utils/getStorageAttributes.ts
 /** Number of seconds in a day, used to convert a `number` of days. */
-const SECONDS_PER_DAY = 3600 * 24;
+const SECONDS_PER_DAY = 86400;
 /**
 * Merges the user-facing `expires` and `maxAge` into a single, normalized and
 * serialization-safe expiry consumed by the client runtime.

package/dist/esm/utils/getStorageAttributes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getStorageAttributes.mjs","names":[],"sources":["../../../src/utils/getStorageAttributes.ts"],"sourcesContent":["import type {\n  CookiesAttributes,\n  ProcessedCookieAttributes,\n  ProcessedStorageAttributes,\n  RoutingStorageInput,\n  StorageAttributes,\n} from '@intlayer/types/config';\nimport {\n  COOKIE_NAME,\n  HEADER_NAME,\n  LOCALE_STORAGE_NAME,\n} from '../defaultValues/routing';\n\n// ============================================================================\n// Types\n// ============================================================================\n\ntype CookieEntry = {\n  name: string;\n  attributes: ProcessedCookieAttributes;\n};\n\n/** Number of seconds in a day, used to convert a `number` of days. */\nconst SECONDS_PER_DAY = 60 * 60 * 24;\n\ntype WebStorageEntry = {\n  name: string;\n};\n\ntype HeaderEntry = {\n  name: string;\n};\n\ntype StorageEntry =\n  | 'cookie'\n  | 'localStorage'\n  | 'sessionStorage'\n  | 'header'\n  | CookiesAttributes\n  | StorageAttributes;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Merges the user-facing `expires` and `maxAge` into a single, normalized and\n * serialization-safe expiry consumed by the client runtime.\n *\n * Precedence and normalization:\n * - `maxAge` (seconds) wins when set and is the internal unit (relative);\n * - `expires` as a `number` is interpreted as **days** and converted to\n *   seconds (relative);\n * - `expires` as a `Date` (possibly a cross-realm instance, since config files\n *   run in a `node:vm` sandbox) or an ISO string becomes an ISO **string**\n *   (absolute). Strings survive `JSON.stringify`, unlike a `Date`.\n *\n * The result is therefore: a `number` = seconds from creation, a `string` =\n * absolute ISO date, or `undefined` for a session cookie.\n */\nconst normalizeCookieExpiry = (\n  expires: CookiesAttributes['expires'],\n  maxAge: CookiesAttributes['maxAge']\n): number | string | undefined => {\n  if (typeof maxAge === 'number') return maxAge;\n  if (expires === undefined) return undefined;\n  if (\n    expires instanceof Date ||\n    Object.prototype.toString.call(expires) === '[object Date]'\n  ) {\n    return (expires as Date).toISOString();\n  }\n  if (typeof expires === 'string') return expires;\n  return expires * SECONDS_PER_DAY;\n};\n\nconst createCookieEntry = (\n  options?: Partial<CookiesAttributes>\n): CookieEntry => {\n  const {\n    name,\n    path = '/',\n    expires,\n    maxAge,\n    domain,\n    secure,\n    sameSite,\n    httpOnly,\n  } = options ?? {};\n  return {\n    name: name ?? COOKIE_NAME,\n    attributes: {\n      path,\n      expires: normalizeCookieExpiry(expires, maxAge),\n      domain,\n      secure,\n      sameSite,\n      httpOnly,\n    },\n  };\n};\n\nconst createWebStorageEntry = (\n  options?: Partial<StorageAttributes>\n): WebStorageEntry => ({\n  name: options?.name ?? LOCALE_STORAGE_NAME,\n});\n\nconst createHeaderEntry = (\n  options?: Partial<StorageAttributes>\n): HeaderEntry => ({\n  name: options?.name ?? HEADER_NAME,\n});\n\nconst isCookieEntry = (entry: unknown): boolean => {\n  if (typeof entry !== 'object' || entry === null) return false;\n  const e = entry as Record<string, unknown>;\n  return (\n    e['type'] === 'cookie' ||\n    'sameSite' in e ||\n    'httpOnly' in e ||\n    'secure' in e\n  );\n};\n\nconst isStorageType = (\n  value: string\n): value is 'cookie' | 'localStorage' | 'sessionStorage' | 'header' =>\n  value === 'cookie' ||\n  value === 'localStorage' ||\n  value === 'sessionStorage' ||\n  value === 'header';\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\nconst processStorageEntry = (\n  entry: StorageEntry\n): Partial<ProcessedStorageAttributes> => {\n  if (typeof entry === 'string') {\n    if (!isStorageType(entry)) {\n      return { cookies: [], localStorage: [], sessionStorage: [], headers: [] };\n    }\n    if (entry === 'cookie') return { cookies: [createCookieEntry()] };\n    if (entry === 'localStorage')\n      return { localStorage: [createWebStorageEntry()] };\n    if (entry === 'sessionStorage')\n      return { sessionStorage: [createWebStorageEntry()] };\n    if (entry === 'header') return { headers: [createHeaderEntry()] };\n  }\n\n  if (typeof entry === 'object' && entry !== null) {\n    const typedEntry = entry as CookiesAttributes | StorageAttributes;\n\n    if (isCookieEntry(typedEntry)) {\n      return { cookies: [createCookieEntry(typedEntry as CookiesAttributes)] };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'localStorage') {\n      return {\n        localStorage: [createWebStorageEntry(typedEntry as StorageAttributes)],\n      };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'sessionStorage') {\n      return {\n        sessionStorage: [\n          createWebStorageEntry(typedEntry as StorageAttributes),\n        ],\n      };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'header') {\n      return { headers: [createHeaderEntry(typedEntry as StorageAttributes)] };\n    }\n    // Default to localStorage for ambiguous objects\n    return {\n      localStorage: [\n        createWebStorageEntry(typedEntry as Omit<StorageAttributes, 'type'>),\n      ],\n    };\n  }\n\n  return { cookies: [], localStorage: [], sessionStorage: [], headers: [] };\n};\n\nconst mergeStorageAttributes = (\n  accumulated: ProcessedStorageAttributes,\n  partial: Partial<ProcessedStorageAttributes>\n): ProcessedStorageAttributes => ({\n  cookies: [...(accumulated.cookies ?? []), ...(partial.cookies ?? [])],\n  localStorage: [\n    ...(accumulated.localStorage ?? []),\n    ...(partial.localStorage ?? []),\n  ],\n  sessionStorage: [\n    ...(accumulated.sessionStorage ?? []),\n    ...(partial.sessionStorage ?? []),\n  ],\n  headers: [...(accumulated.headers ?? []), ...(partial.headers ?? [])],\n});\n\n/**\n * Extracts and normalizes storage configuration into separate arrays for each storage type.\n * Called at config-build time so the result is pre-computed and stored in the config.\n *\n * @param options - The storage configuration from IntlayerConfig\n * @returns An object containing arrays for cookies, localStorage, sessionStorage and headers\n */\nexport const getStorageAttributes = (\n  options: RoutingStorageInput\n): ProcessedStorageAttributes => {\n  const emptyResult: ProcessedStorageAttributes = {\n    cookies: [],\n    localStorage: [],\n    sessionStorage: [],\n    headers: [],\n  };\n\n  if (options === false || options === undefined) return {};\n\n  const result = Array.isArray(options)\n    ? options.reduce<ProcessedStorageAttributes>((acc, entry) => {\n        const partial = processStorageEntry(entry);\n        return mergeStorageAttributes(acc, partial);\n      }, emptyResult)\n    : mergeStorageAttributes(emptyResult, processStorageEntry(options));\n\n  // Remove empty arrays\n  const cleanedResult: ProcessedStorageAttributes = {};\n\n  if (result.cookies && result.cookies.length > 0) {\n    cleanedResult.cookies = result.cookies;\n  }\n\n  if (result.localStorage && result.localStorage.length > 0) {\n    cleanedResult.localStorage = result.localStorage;\n  }\n\n  if (result.sessionStorage && result.sessionStorage.length > 0) {\n    cleanedResult.sessionStorage = result.sessionStorage;\n  }\n\n  if (result.headers && result.headers.length > 0) {\n    cleanedResult.headers = result.headers;\n  }\n\n  return cleanedResult;\n};\n"],"mappings":"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"}
+{"version":3,"file":"getStorageAttributes.mjs","names":[],"sources":["../../../src/utils/getStorageAttributes.ts"],"sourcesContent":["import type {\n  CookiesAttributes,\n  ProcessedCookieAttributes,\n  ProcessedStorageAttributes,\n  RoutingStorageInput,\n  StorageAttributes,\n} from '@intlayer/types/config';\nimport {\n  COOKIE_NAME,\n  HEADER_NAME,\n  LOCALE_STORAGE_NAME,\n} from '../defaultValues/routing';\n\n// ============================================================================\n// Types\n// ============================================================================\n\ntype CookieEntry = {\n  name: string;\n  attributes: ProcessedCookieAttributes;\n};\n\n/** Number of seconds in a day, used to convert a `number` of days. */\nconst SECONDS_PER_DAY = 60 * 60 * 24;\n\ntype WebStorageEntry = {\n  name: string;\n};\n\ntype HeaderEntry = {\n  name: string;\n};\n\ntype StorageEntry =\n  | 'cookie'\n  | 'localStorage'\n  | 'sessionStorage'\n  | 'header'\n  | CookiesAttributes\n  | StorageAttributes;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Merges the user-facing `expires` and `maxAge` into a single, normalized and\n * serialization-safe expiry consumed by the client runtime.\n *\n * Precedence and normalization:\n * - `maxAge` (seconds) wins when set and is the internal unit (relative);\n * - `expires` as a `number` is interpreted as **days** and converted to\n *   seconds (relative);\n * - `expires` as a `Date` (possibly a cross-realm instance, since config files\n *   run in a `node:vm` sandbox) or an ISO string becomes an ISO **string**\n *   (absolute). Strings survive `JSON.stringify`, unlike a `Date`.\n *\n * The result is therefore: a `number` = seconds from creation, a `string` =\n * absolute ISO date, or `undefined` for a session cookie.\n */\nconst normalizeCookieExpiry = (\n  expires: CookiesAttributes['expires'],\n  maxAge: CookiesAttributes['maxAge']\n): number | string | undefined => {\n  if (typeof maxAge === 'number') return maxAge;\n  if (expires === undefined) return undefined;\n  if (\n    expires instanceof Date ||\n    Object.prototype.toString.call(expires) === '[object Date]'\n  ) {\n    return (expires as Date).toISOString();\n  }\n  if (typeof expires === 'string') return expires;\n  return expires * SECONDS_PER_DAY;\n};\n\nconst createCookieEntry = (\n  options?: Partial<CookiesAttributes>\n): CookieEntry => {\n  const {\n    name,\n    path = '/',\n    expires,\n    maxAge,\n    domain,\n    secure,\n    sameSite,\n    httpOnly,\n  } = options ?? {};\n  return {\n    name: name ?? COOKIE_NAME,\n    attributes: {\n      path,\n      expires: normalizeCookieExpiry(expires, maxAge),\n      domain,\n      secure,\n      sameSite,\n      httpOnly,\n    },\n  };\n};\n\nconst createWebStorageEntry = (\n  options?: Partial<StorageAttributes>\n): WebStorageEntry => ({\n  name: options?.name ?? LOCALE_STORAGE_NAME,\n});\n\nconst createHeaderEntry = (\n  options?: Partial<StorageAttributes>\n): HeaderEntry => ({\n  name: options?.name ?? HEADER_NAME,\n});\n\nconst isCookieEntry = (entry: unknown): boolean => {\n  if (typeof entry !== 'object' || entry === null) return false;\n  const e = entry as Record<string, unknown>;\n  return (\n    e['type'] === 'cookie' ||\n    'sameSite' in e ||\n    'httpOnly' in e ||\n    'secure' in e\n  );\n};\n\nconst isStorageType = (\n  value: string\n): value is 'cookie' | 'localStorage' | 'sessionStorage' | 'header' =>\n  value === 'cookie' ||\n  value === 'localStorage' ||\n  value === 'sessionStorage' ||\n  value === 'header';\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\nconst processStorageEntry = (\n  entry: StorageEntry\n): Partial<ProcessedStorageAttributes> => {\n  if (typeof entry === 'string') {\n    if (!isStorageType(entry)) {\n      return { cookies: [], localStorage: [], sessionStorage: [], headers: [] };\n    }\n    if (entry === 'cookie') return { cookies: [createCookieEntry()] };\n    if (entry === 'localStorage')\n      return { localStorage: [createWebStorageEntry()] };\n    if (entry === 'sessionStorage')\n      return { sessionStorage: [createWebStorageEntry()] };\n    if (entry === 'header') return { headers: [createHeaderEntry()] };\n  }\n\n  if (typeof entry === 'object' && entry !== null) {\n    const typedEntry = entry as CookiesAttributes | StorageAttributes;\n\n    if (isCookieEntry(typedEntry)) {\n      return { cookies: [createCookieEntry(typedEntry as CookiesAttributes)] };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'localStorage') {\n      return {\n        localStorage: [createWebStorageEntry(typedEntry as StorageAttributes)],\n      };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'sessionStorage') {\n      return {\n        sessionStorage: [\n          createWebStorageEntry(typedEntry as StorageAttributes),\n        ],\n      };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'header') {\n      return { headers: [createHeaderEntry(typedEntry as StorageAttributes)] };\n    }\n    // Default to localStorage for ambiguous objects\n    return {\n      localStorage: [\n        createWebStorageEntry(typedEntry as Omit<StorageAttributes, 'type'>),\n      ],\n    };\n  }\n\n  return { cookies: [], localStorage: [], sessionStorage: [], headers: [] };\n};\n\nconst mergeStorageAttributes = (\n  accumulated: ProcessedStorageAttributes,\n  partial: Partial<ProcessedStorageAttributes>\n): ProcessedStorageAttributes => ({\n  cookies: [...(accumulated.cookies ?? []), ...(partial.cookies ?? [])],\n  localStorage: [\n    ...(accumulated.localStorage ?? []),\n    ...(partial.localStorage ?? []),\n  ],\n  sessionStorage: [\n    ...(accumulated.sessionStorage ?? []),\n    ...(partial.sessionStorage ?? []),\n  ],\n  headers: [...(accumulated.headers ?? []), ...(partial.headers ?? [])],\n});\n\n/**\n * Extracts and normalizes storage configuration into separate arrays for each storage type.\n * Called at config-build time so the result is pre-computed and stored in the config.\n *\n * @param options - The storage configuration from IntlayerConfig\n * @returns An object containing arrays for cookies, localStorage, sessionStorage and headers\n */\nexport const getStorageAttributes = (\n  options: RoutingStorageInput\n): ProcessedStorageAttributes => {\n  const emptyResult: ProcessedStorageAttributes = {\n    cookies: [],\n    localStorage: [],\n    sessionStorage: [],\n    headers: [],\n  };\n\n  if (options === false || options === undefined) return {};\n\n  const result = Array.isArray(options)\n    ? options.reduce<ProcessedStorageAttributes>((acc, entry) => {\n        const partial = processStorageEntry(entry);\n        return mergeStorageAttributes(acc, partial);\n      }, emptyResult)\n    : mergeStorageAttributes(emptyResult, processStorageEntry(options));\n\n  // Remove empty arrays\n  const cleanedResult: ProcessedStorageAttributes = {};\n\n  if (result.cookies && result.cookies.length > 0) {\n    cleanedResult.cookies = result.cookies;\n  }\n\n  if (result.localStorage && result.localStorage.length > 0) {\n    cleanedResult.localStorage = result.localStorage;\n  }\n\n  if (result.sessionStorage && result.sessionStorage.length > 0) {\n    cleanedResult.sessionStorage = result.sessionStorage;\n  }\n\n  if (result.headers && result.headers.length > 0) {\n    cleanedResult.headers = result.headers;\n  }\n\n  return cleanedResult;\n};\n"],"mappings":"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"}

package/dist/types/extract/constants.d.ts

@@ -0,0 +1,11 @@
+//#region src/extract/constants.d.ts
+/**
+ * Attributes that should be extracted as translatable strings from JSX/HTML elements.
+ * This is the single source of truth shared across all Intlayer compiler packages
+ * (@intlayer/babel, @intlayer/vue-compiler, @intlayer/svelte-compiler, @intlayer/engine)
+ * and the `eslint-plugin-intlayer` `no-raw-text` rule.
+ */
+declare const ATTRIBUTES_TO_EXTRACT: readonly ['title', 'placeholder', 'alt', 'aria-label', 'label'];
+//#endregion
+export { ATTRIBUTES_TO_EXTRACT };
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/extract/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../../src/extract/constants.ts"],"mappings":";;;;;;;cAMa"}

package/dist/types/extract/index.d.ts

@@ -0,0 +1,3 @@
+import { ATTRIBUTES_TO_EXTRACT } from "./constants.js";
+import { shouldExtract } from "./shouldExtract.js";
+export { ATTRIBUTES_TO_EXTRACT, shouldExtract };

package/dist/types/extract/shouldExtract.d.ts

@@ -0,0 +1,15 @@
+//#region src/extract/shouldExtract.d.ts
+/**
+ * Checks whether the given text should be extracted as a translatable string.
+ *
+ * Filters out:
+ * - Empty strings
+ * - Emails
+ * - Single capitalized words (likely brand/proper nouns, e.g. "Intlayer")
+ * - Uncapitalized strings of 2 words or fewer (likely technical terms)
+ * - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)
+ */
+declare const shouldExtract: (text: string) => boolean;
+//#endregion
+export { shouldExtract };
+//# sourceMappingURL=shouldExtract.d.ts.map

package/dist/types/extract/shouldExtract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldExtract.d.ts","names":[],"sources":["../../../src/extract/shouldExtract.ts"],"mappings":";;;;;;;;;;;cAUa,gBAAa"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/config",
-  "version": "9.3.0",
+  "version": "9.3.2",
   "private": false,
   "description": "Retrieve Intlayer configurations and manage environment variables for both server-side and client-side environments.",
   "keywords": [
@@ -57,6 +57,11 @@
       "import": "./dist/esm/callers/index.mjs",
       "require": "./dist/cjs/callers/index.cjs"
     },
+    "./extract": {
+      "types": "./dist/types/extract/index.d.ts",
+      "import": "./dist/esm/extract/index.mjs",
+      "require": "./dist/cjs/extract/index.cjs"
+    },
     "./utils": {
       "types": "./dist/types/utils/index.d.ts",
       "require": "./dist/cjs/utils/index.cjs",
@@ -116,6 +121,9 @@
       "utils": [
         "./dist/types/utils/index.d.ts"
       ],
+      "extract": [
+        "./dist/types/extract/index.d.ts"
+      ],
       "file": [
         "./dist/types/loadExternalFile/index.d.ts"
       ],
@@ -164,7 +172,7 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "9.3.0",
+    "@intlayer/types": "9.3.2",
     "defu": "6.1.7",
     "dotenv": "17.4.2",
     "esbuild": "0.28.2",