@burdenoff/be-sdk 2026.805.1 → 2026.815.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/dist/{chunk-Q6UAOZFZ.js → chunk-AWPNRV3L.js} +25 -16
  2. package/dist/chunk-AWPNRV3L.js.map +1 -0
  3. package/dist/{chunk-I4PU5B7Q.js → chunk-J4GHZLIY.js} +4 -4
  4. package/dist/{chunk-I4PU5B7Q.js.map → chunk-J4GHZLIY.js.map} +1 -1
  5. package/dist/{chunk-4OPOVK54.js → chunk-U4HHNEFE.js} +3 -3
  6. package/dist/{chunk-4OPOVK54.js.map → chunk-U4HHNEFE.js.map} +1 -1
  7. package/dist/{chunk-ULFFX3YE.js → chunk-UJG32VIP.js} +3 -3
  8. package/dist/chunk-UJG32VIP.js.map +1 -0
  9. package/dist/{chunk-RJK4MPDW.js → chunk-XWVP4MC6.js} +3 -3
  10. package/dist/{chunk-RJK4MPDW.js.map → chunk-XWVP4MC6.js.map} +1 -1
  11. package/dist/{chunk-WW6P2S6L.js → chunk-Z3O32BW6.js} +3 -3
  12. package/dist/{chunk-WW6P2S6L.js.map → chunk-Z3O32BW6.js.map} +1 -1
  13. package/dist/i18n/index.js +1 -1
  14. package/dist/index.js +5 -5
  15. package/dist/init/index.js +3 -3
  16. package/dist/instrumentation/index.js +2 -2
  17. package/dist/metrics/index.js +2 -2
  18. package/dist/resource-caps/index.js +2 -2
  19. package/dist/server/index.js +3 -3
  20. package/dist/telemetry/index.js +3 -3
  21. package/package.json +2 -2
  22. package/dist/chunk-Q6UAOZFZ.js.map +0 -1
  23. package/dist/chunk-ULFFX3YE.js.map +0 -1
package/dist/chunk-UJG32VIP.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/i18n/index.ts","../src/i18n/types.ts","../src/i18n/parser.ts","../src/i18n/loader.ts","../src/i18n/i18n.ts","../src/i18n/helpers.ts"],"names":["RTL_LANGUAGES","getTextDirection","language","includes","parseLocaleString","localeStr","trimmed","trim","localePart","params","split","quality","param","key","value","toLowerCase","parsed","parseFloat","isNaN","locale","parts","region","toUpperCase","normalizedLocale","parseAcceptLanguage","header","locales","part","push","sort","a","b","extractLocaleFromRequest","request","defaultLocale","explicitLocale","headers","get","acceptLanguage","parsedLocales","length","normalizeLocale","getLanguageFromLocale","getRegionFromLocale","findBestMatch","requested","available","availableSet","Set","map","l","req","has","find","langMatch","translationCache","Map","validateFilePath","filePath","baseDir","resolvedBase","resolve","resolvedPath","relativePath","relative","startsWith","Error","safeReadFile","validatedPath","Bun","file","text","safeStat","stat","catch","safeReaddir","dirPath","readdir","flattenDictionary","obj","prefix","result","Object","entries","fullKey","assign","loadTranslationFile","content","data","JSON","parse","error","logger","getCacheKey","namespace","loadTranslationsForLocale","config","cacheKey","enableCache","pathsToTry","join","localesPath","path","stats","isFile","endsWith","translations","flattened","debug","isDirectory","files","extname","basename","keys","fallbackLocale","warn","fallbackTranslations","undefined","set","discoverLocales","validatedBasePath","entry","entryPath","preloadAllTranslations","supportedLocales","info","Promise","all","clearTranslationCache","delete","clear","getCachedTranslations","setCachedTranslations","getEnglishPluralCategory","absCount","getFrenchPluralCategory","getSlavicPluralCategory","mod10","mod100","getArabicPluralCategory","getPolishCzechPluralCategory","getRomanianPluralCategory","getHebrewPluralCategory","getPluralCategory","count","Math","abs","englishLanguages","interpolate","variables","replace","match","String","I18n","currentLocale","initialized","returnKeyOnMissing","logMissing","initialize","lazyLoad","getLocale","setLocale","getSupportedLocales","isSupported","normalized","some","supportedNorm","loadLocale","getTranslations","t","defaultValue","translate","tp","translatePlural","langTranslations","category","pluralKey","createContext","formatNumber","options","Intl","NumberFormat","format","formatCurrency","currency","style","formatDate","date","dateObj","Date","DateTimeFormat","formatRelativeTime","unit","RelativeTimeFormat","numeric","createContextFromRequest","bestMatch","getLanguageInfo","direction","code","globalI18n","initializeI18n","getI18n","createI18n","interpolateVariables","ctx","defaultMessage","i18n","translated","createTranslator","hasI18n","getLanguage","defaultLanguage","Locales","EN_US","EN_GB","EN_AU","EN_CA","EN_IN","ES_ES","ES_MX","FR_FR","FR_CA","DE_DE","DE_AT","DE_CH","IT_IT","PT_PT","PT_BR","RU_RU","ZH_CN","ZH_TW","ZH_HK","JA_JP","KO_KR","AR_SA","AR_AE","HI_IN","TA_IN","NL_NL","PL_PL","TR_TR","VI_VN","TH_TH","ID_ID","HE_IL","UK_UA","DEFAULT_I18N_CONFIG"],"mappings":"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","file":"chunk-UJG32VIP.js","sourcesContent":["/**\n * I18n Module\n *\n * Comprehensive internationalization support for backend services.\n *\n * Features:\n * - Load translations from JSON files\n * - Accept-Language header parsing\n * - Translation with variable interpolation\n * - Pluralization support (CLDR rules)\n * - Locale-aware formatting (numbers, dates, currencies)\n * - Request context integration\n *\n * @example\n * ```typescript\n * import { I18n } from '@burdenoff/be-sdk/i18n';\n *\n * // Initialize\n * const i18n = new I18n({\n * defaultLocale: 'en-US',\n * localesPath: './locales',\n * });\n * await i18n.initialize();\n *\n * // Create context for a request\n * const ctx = i18n.createContextFromRequest(request);\n *\n * // Translate\n * const message = ctx.t('errors.notFound', { resource: 'Tag' });\n * // => \"Tag not found\"\n *\n * // Pluralize\n * const items = ctx.tp('items', 5, { count: 5 });\n * // => \"5 items\"\n * ```\n *\n * @packageDocumentation\n */\n\n// Core i18n class and functions\nexport { I18n, initializeI18n, getI18n, createI18n } from './i18n.js';\n\n// Context-based translation helpers (for use in resolvers/providers)\nexport {\n t,\n createTranslator,\n hasI18n,\n getLocale,\n getLanguage,\n type I18nCapableContext,\n type Translator,\n} from './helpers.js';\n\n// Types\nexport type {\n LocaleCode,\n LanguageCode,\n TranslationDictionary,\n FlatTranslationMap,\n TranslationVariables,\n PluralForms,\n TranslateFunction,\n PluralTranslateFunction,\n I18nConfig,\n ParsedLocale,\n I18nContext,\n II18n,\n TextDirection,\n LanguageInfo,\n} from './types.js';\n\n// Type helpers\nexport { RTL_LANGUAGES, getTextDirection } from './types.js';\n\n// Parser functions\nexport {\n parseLocaleString,\n parseAcceptLanguage,\n extractLocaleFromRequest,\n normalizeLocale,\n getLanguageFromLocale,\n getRegionFromLocale,\n findBestMatch,\n} from './parser.js';\n\n// Loader functions\nexport {\n flattenDictionary,\n loadTranslationFile,\n loadTranslationsForLocale,\n discoverLocales,\n preloadAllTranslations,\n clearTranslationCache,\n getCachedTranslations,\n setCachedTranslations,\n} from './loader.js';\n\n// ============================================================================\n// Re-exports for convenience\n// ============================================================================\n\n/**\n * Common locale codes as constants\n */\nexport const Locales = {\n // English\n EN_US: 'en-US' as const,\n EN_GB: 'en-GB' as const,\n EN_AU: 'en-AU' as const,\n EN_CA: 'en-CA' as const,\n EN_IN: 'en-IN' as const,\n // Spanish\n ES_ES: 'es-ES' as const,\n ES_MX: 'es-MX' as const,\n // French\n FR_FR: 'fr-FR' as const,\n FR_CA: 'fr-CA' as const,\n // German\n DE_DE: 'de-DE' as const,\n DE_AT: 'de-AT' as const,\n DE_CH: 'de-CH' as const,\n // Italian\n IT_IT: 'it-IT' as const,\n // Portuguese\n PT_PT: 'pt-PT' as const,\n PT_BR: 'pt-BR' as const,\n // Russian\n RU_RU: 'ru-RU' as const,\n // Chinese\n ZH_CN: 'zh-CN' as const,\n ZH_TW: 'zh-TW' as const,\n ZH_HK: 'zh-HK' as const,\n // Japanese\n JA_JP: 'ja-JP' as const,\n // Korean\n KO_KR: 'ko-KR' as const,\n // Arabic\n AR_SA: 'ar-SA' as const,\n AR_AE: 'ar-AE' as const,\n // Hindi\n HI_IN: 'hi-IN' as const,\n // Tamil\n TA_IN: 'ta-IN' as const,\n // Dutch\n NL_NL: 'nl-NL' as const,\n // Polish\n PL_PL: 'pl-PL' as const,\n // Turkish\n TR_TR: 'tr-TR' as const,\n // Vietnamese\n VI_VN: 'vi-VN' as const,\n // Thai\n TH_TH: 'th-TH' as const,\n // Indonesian\n ID_ID: 'id-ID' as const,\n // Hebrew\n HE_IL: 'he-IL' as const,\n // Ukrainian\n UK_UA: 'uk-UA' as const,\n} as const;\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_I18N_CONFIG = {\n defaultLocale: 'en-US',\n fallbackLocale: 'en-US',\n enableCache: true,\n lazyLoad: false,\n logMissing: true,\n returnKeyOnMissing: true,\n} as const;\n","/**\n * I18n Module Types\n *\n * Type definitions for internationalization support\n */\n\n/**\n * Supported locale codes (BCP 47 format)\n * Language-Region pattern: xx-XX\n */\nexport type LocaleCode =\n // English variants\n | 'en-US'\n | 'en-GB'\n | 'en-AU'\n | 'en-CA'\n | 'en-IN'\n // Spanish variants\n | 'es-ES'\n | 'es-MX'\n | 'es-AR'\n // French variants\n | 'fr-FR'\n | 'fr-CA'\n | 'fr-BE'\n // German variants\n | 'de-DE'\n | 'de-AT'\n | 'de-CH'\n // Italian\n | 'it-IT'\n // Portuguese variants\n | 'pt-PT'\n | 'pt-BR'\n // Russian\n | 'ru-RU'\n // Chinese variants\n | 'zh-CN'\n | 'zh-TW'\n | 'zh-HK'\n // Japanese\n | 'ja-JP'\n // Korean\n | 'ko-KR'\n // Arabic variants\n | 'ar-SA'\n | 'ar-AE'\n | 'ar-EG'\n // Hindi\n | 'hi-IN'\n // Bengali\n | 'bn-IN'\n | 'bn-BD'\n // Tamil\n | 'ta-IN'\n // Telugu\n | 'te-IN'\n // Malayalam\n | 'ml-IN'\n // Dutch\n | 'nl-NL'\n | 'nl-BE'\n // Polish\n | 'pl-PL'\n // Turkish\n | 'tr-TR'\n // Vietnamese\n | 'vi-VN'\n // Thai\n | 'th-TH'\n // Indonesian\n | 'id-ID'\n // Malay\n | 'ms-MY'\n // Swedish\n | 'sv-SE'\n // Norwegian\n | 'nb-NO'\n // Danish\n | 'da-DK'\n // Finnish\n | 'fi-FI'\n // Greek\n | 'el-GR'\n // Czech\n | 'cs-CZ'\n // Romanian\n | 'ro-RO'\n // Hungarian\n | 'hu-HU'\n // Hebrew\n | 'he-IL'\n // Ukrainian\n | 'uk-UA'\n // Generic fallback (allow any valid BCP 47)\n | string;\n\n/**\n * Language code (ISO 639-1)\n */\nexport type LanguageCode =\n | 'en'\n | 'es'\n | 'fr'\n | 'de'\n | 'it'\n | 'pt'\n | 'ru'\n | 'zh'\n | 'ja'\n | 'ko'\n | 'ar'\n | 'hi'\n | 'bn'\n | 'ta'\n | 'te'\n | 'ml'\n | 'nl'\n | 'pl'\n | 'tr'\n | 'vi'\n | 'th'\n | 'id'\n | 'ms'\n | 'sv'\n | 'nb'\n | 'da'\n | 'fi'\n | 'el'\n | 'cs'\n | 'ro'\n | 'hu'\n | 'he'\n | 'uk'\n | string;\n\n/**\n * Translation dictionary type\n * Supports nested keys like { errors: { notFound: \"...\" } }\n * Includes null to match JSON data which may contain null values\n */\nexport type TranslationDictionary = {\n [key: string]: string | TranslationDictionary | null;\n};\n\n/**\n * Flattened translation map\n */\nexport type FlatTranslationMap = Record<string, string>;\n\n/**\n * Translation variables for interpolation\n */\nexport type TranslationVariables = Record<string, string | number | boolean>;\n\n/**\n * Pluralization rules\n */\nexport interface PluralForms {\n zero?: string;\n one: string;\n two?: string;\n few?: string;\n many?: string;\n other: string;\n}\n\n/**\n * Translation function type\n */\nexport type TranslateFunction = (key: string, variables?: TranslationVariables, defaultValue?: string) => string;\n\n/**\n * Plural translation function type\n */\nexport type PluralTranslateFunction = (key: string, count: number, variables?: TranslationVariables) => string;\n\n/**\n * I18n configuration options\n */\nexport interface I18nConfig {\n /** Default locale if none specified */\n defaultLocale: LocaleCode;\n /** Fallback locale when translation is missing */\n fallbackLocale?: LocaleCode;\n /** Path to locales directory */\n localesPath: string;\n /** Supported locales (if empty, all locales in directory are supported) */\n supportedLocales?: LocaleCode[];\n /** Whether to load translations lazily */\n lazyLoad?: boolean;\n /** Cache translations in memory */\n enableCache?: boolean;\n /** Namespace for this service (e.g., 'tags', 'auth') */\n namespace?: string;\n /** Log missing translations */\n logMissing?: boolean;\n /** Return key on missing translation instead of empty string */\n returnKeyOnMissing?: boolean;\n}\n\n/**\n * Parsed locale information\n */\nexport interface ParsedLocale {\n /** Full locale code (e.g., 'en-US') */\n locale: LocaleCode;\n /** Language code (e.g., 'en') */\n language: LanguageCode;\n /** Region code (e.g., 'US') */\n region?: string;\n /** Quality factor from Accept-Language header (0-1) */\n quality: number;\n}\n\n/**\n * I18n context for requests\n */\nexport interface I18nContext {\n /** Current locale */\n locale: LocaleCode;\n /** Language code */\n language: LanguageCode;\n /** Region code */\n region?: string;\n /** Geography: ISO 3166-1 alpha-2 country code (e.g., 'IN', 'US', 'DE') — from x-geo-country header */\n country?: string;\n /** Geography: ISO 4217 currency code (e.g., 'INR', 'USD', 'EUR') — from x-geo-currency header */\n currency?: string;\n /** Geography: IANA timezone (e.g., 'Asia/Kolkata', 'America/New_York') — from x-geo-timezone header */\n timezone?: string;\n /** Translation function */\n t: TranslateFunction;\n /** Plural translation function */\n tp: PluralTranslateFunction;\n /** Format number for locale */\n formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n /** Format currency for locale */\n formatCurrency: (value: number, currency: string) => string;\n /** Format date for locale */\n formatDate: (date: Date | string, options?: Intl.DateTimeFormatOptions) => string;\n /** Format relative time for locale */\n formatRelativeTime: (value: number, unit: Intl.RelativeTimeFormatUnit) => string;\n}\n\n/**\n * I18n instance interface\n */\nexport interface II18n {\n /** Get current locale */\n getLocale(): LocaleCode;\n /** Set current locale */\n setLocale(locale: LocaleCode): void;\n /** Get supported locales */\n getSupportedLocales(): LocaleCode[];\n /** Check if locale is supported */\n isSupported(locale: LocaleCode): boolean;\n /** Translate a key */\n t: TranslateFunction;\n /** Translate with pluralization */\n tp: PluralTranslateFunction;\n /** Create context for request */\n createContext(locale: LocaleCode): I18nContext;\n /** Load translations for a locale */\n loadLocale(locale: LocaleCode): Promise<void>;\n /** Get all translations for a locale */\n getTranslations(locale: LocaleCode): FlatTranslationMap | undefined;\n}\n\n/**\n * Language direction\n */\nexport type TextDirection = 'ltr' | 'rtl';\n\n/**\n * Language metadata\n */\nexport interface LanguageInfo {\n code: LanguageCode;\n name: string;\n nativeName: string;\n direction: TextDirection;\n locales: LocaleCode[];\n}\n\n/**\n * RTL languages\n */\nexport const RTL_LANGUAGES: LanguageCode[] = ['ar', 'he'];\n\n/**\n * Get text direction for a language\n */\nexport function getTextDirection(language: LanguageCode): TextDirection {\n return RTL_LANGUAGES.includes(language) ? 'rtl' : 'ltr';\n}\n","/**\n * I18n Parser Module\n *\n * Parses Accept-Language headers and locale strings\n */\n\nimport type { LocaleCode, LanguageCode, ParsedLocale } from './types.js';\n\n/**\n * Parse a single locale string (e.g., 'en-US', 'fr;q=0.9')\n */\nexport function parseLocaleString(localeStr: string): ParsedLocale | null {\n const trimmed = localeStr.trim();\n if (!trimmed || trimmed === '*') {\n return null;\n }\n\n // Parse quality factor if present (e.g., 'en-US;q=0.9')\n const [localePart, ...params] = trimmed.split(';');\n let quality = 1.0;\n\n for (const param of params) {\n const [key, value] = param.trim().split('=');\n if (key?.toLowerCase() === 'q' && value) {\n const parsed = parseFloat(value);\n if (!isNaN(parsed) && parsed >= 0 && parsed <= 1) {\n quality = parsed;\n }\n }\n }\n\n const locale = localePart?.trim();\n if (!locale) {\n return null;\n }\n\n // Parse language and region\n const parts = locale.split('-');\n const language = parts[0]?.toLowerCase() as LanguageCode;\n const region = parts[1]?.toUpperCase();\n\n // Reconstruct proper locale code\n const normalizedLocale = region ? `${language}-${region}` : language;\n\n return {\n locale: normalizedLocale,\n language,\n region,\n quality,\n };\n}\n\n/**\n * Parse Accept-Language header\n *\n * Example: 'en-US,en;q=0.9,fr;q=0.8,de;q=0.7'\n *\n * @param header The Accept-Language header value\n * @returns Array of parsed locales sorted by quality (highest first)\n */\nexport function parseAcceptLanguage(header: string | null | undefined): ParsedLocale[] {\n if (!header || header.trim() === '') {\n return [];\n }\n\n const locales: ParsedLocale[] = [];\n\n // Split by comma and parse each part\n const parts = header.split(',');\n for (const part of parts) {\n const parsed = parseLocaleString(part);\n if (parsed) {\n locales.push(parsed);\n }\n }\n\n // Sort by quality factor (highest first)\n locales.sort((a, b) => b.quality - a.quality);\n\n return locales;\n}\n\n/**\n * Extract locale from request headers\n *\n * Checks in order:\n * 1. X-Locale header (explicit override)\n * 2. X-Language header (explicit override)\n * 3. Accept-Language header\n *\n * @param request Web API Request object\n * @param defaultLocale Default locale to return if none found\n * @returns The best matching locale\n */\nexport function extractLocaleFromRequest(request: Request, defaultLocale: LocaleCode = 'en-US'): ParsedLocale {\n // Check explicit locale header first\n const explicitLocale = request.headers.get('x-locale') || request.headers.get('x-language');\n if (explicitLocale) {\n const parsed = parseLocaleString(explicitLocale);\n if (parsed) {\n return parsed;\n }\n }\n\n // Parse Accept-Language header\n const acceptLanguage = request.headers.get('accept-language');\n const parsedLocales = parseAcceptLanguage(acceptLanguage);\n\n if (parsedLocales.length > 0) {\n return parsedLocales[0]!;\n }\n\n // Return default locale\n const [language, region] = defaultLocale.split('-');\n return {\n locale: defaultLocale,\n language: language as LanguageCode,\n region: region,\n quality: 1.0,\n };\n}\n\n/**\n * Normalize a locale code to standard format\n *\n * @param locale The locale to normalize\n * @returns Normalized locale (e.g., 'en-us' -> 'en-US')\n */\nexport function normalizeLocale(locale: string): LocaleCode {\n const parts = locale.trim().split(/[-_]/);\n const language = parts[0]?.toLowerCase();\n const region = parts[1]?.toUpperCase();\n\n if (region) {\n return `${language}-${region}`;\n }\n return language as LocaleCode;\n}\n\n/**\n * Get the language code from a locale\n */\nexport function getLanguageFromLocale(locale: LocaleCode): LanguageCode {\n return locale.split('-')[0] as LanguageCode;\n}\n\n/**\n * Get the region code from a locale\n */\nexport function getRegionFromLocale(locale: LocaleCode): string | undefined {\n const parts = locale.split('-');\n return parts[1];\n}\n\n/**\n * Find the best matching locale from available locales\n *\n * @param requested Requested locales (sorted by preference)\n * @param available Available locales\n * @param defaultLocale Default locale to use if no match\n * @returns The best matching locale\n */\nexport function findBestMatch(\n requested: ParsedLocale[],\n available: LocaleCode[],\n defaultLocale: LocaleCode\n): LocaleCode {\n const availableSet = new Set(available.map((l) => l.toLowerCase()));\n\n for (const req of requested) {\n // Try exact match first (e.g., 'en-US')\n if (availableSet.has(req.locale.toLowerCase())) {\n // Return with proper casing from available\n return available.find((l) => l.toLowerCase() === req.locale.toLowerCase()) || req.locale;\n }\n\n // Try language-only match (e.g., 'en')\n if (availableSet.has(req.language.toLowerCase())) {\n return available.find((l) => l.toLowerCase() === req.language.toLowerCase()) || req.language;\n }\n\n // Try to find any locale with the same language\n const langMatch = available.find((l) => getLanguageFromLocale(l).toLowerCase() === req.language.toLowerCase());\n if (langMatch) {\n return langMatch;\n }\n }\n\n return defaultLocale;\n}\n","/**\n * I18n Loader Module\n *\n * Loads and manages translation files from the filesystem\n */\n\nimport { readdir, stat } from 'fs/promises';\nimport { join, extname, basename, resolve, relative } from 'path';\nimport type { LocaleCode, TranslationDictionary, FlatTranslationMap, I18nConfig } from './types.js';\nimport { normalizeLocale, getLanguageFromLocale } from './parser.js';\nimport { logger } from '../logger/index.js';\n\n/**\n * Translation cache\n */\nconst translationCache = new Map<string, FlatTranslationMap>();\n\n/**\n * Validate that a file path is within the allowed base directory\n * Prevents directory traversal attacks\n *\n * @param filePath The file path to validate\n * @param baseDir The base directory that must contain the file\n * @returns The resolved absolute path if valid\n * @throws Error if path escapes the base directory\n */\nfunction validateFilePath(filePath: string, baseDir: string): string {\n const resolvedBase = resolve(baseDir);\n const resolvedPath = resolve(filePath);\n const relativePath = relative(resolvedBase, resolvedPath);\n\n // If relative path starts with '..' or is absolute, it's outside base directory\n if (relativePath.startsWith('..') || resolve(relativePath) === relativePath) {\n throw new Error(`Invalid file path: ${filePath} is outside base directory ${baseDir}`);\n }\n\n return resolvedPath;\n}\n\n/**\n * Safely read a file with path validation\n * Path is validated before reading to prevent directory traversal attacks\n */\nasync function safeReadFile(filePath: string, baseDir: string): Promise<string> {\n const validatedPath = validateFilePath(filePath, baseDir);\n return Bun.file(validatedPath).text();\n}\n\n/**\n * Safely stat a file with path validation\n * Path is validated before stat to prevent directory traversal attacks\n */\nasync function safeStat(filePath: string, baseDir: string): Promise<Awaited<ReturnType<typeof stat>> | null> {\n const validatedPath = validateFilePath(filePath, baseDir);\n return stat(validatedPath).catch(() => null);\n}\n\n/**\n * Safely read directory with path validation\n * Path is validated before readdir to prevent directory traversal attacks\n */\nasync function safeReaddir(dirPath: string, baseDir: string): Promise<string[]> {\n const validatedPath = validateFilePath(dirPath, baseDir);\n return readdir(validatedPath);\n}\n\n/**\n * Flatten a nested translation dictionary\n *\n * @param obj The nested dictionary\n * @param prefix Current key prefix\n * @returns Flattened key-value map\n */\nexport function flattenDictionary(obj: TranslationDictionary, prefix = ''): FlatTranslationMap {\n const result: FlatTranslationMap = {};\n\n for (const [key, value] of Object.entries(obj)) {\n const fullKey = prefix ? `${prefix}.${key}` : key;\n\n if (typeof value === 'string') {\n result[fullKey] = value;\n } else if (value !== null && typeof value === 'object') {\n // Check null first to avoid different-types-comparison warning\n // (typeof null === 'object' is a JavaScript quirk)\n Object.assign(result, flattenDictionary(value, fullKey));\n }\n }\n\n return result;\n}\n\n/**\n * Load a single translation file\n *\n * @param filePath Path to the translation file\n * @param baseDir Base directory for validation\n * @returns The loaded translations\n */\nexport async function loadTranslationFile(filePath: string, baseDir: string): Promise<TranslationDictionary> {\n try {\n const content = await safeReadFile(filePath, baseDir);\n const data = JSON.parse(content) as TranslationDictionary;\n return data;\n } catch (error) {\n logger.error(`[I18n] Failed to load translation file: ${filePath}`, error);\n return {};\n }\n}\n\n/**\n * Get cache key for translations\n */\nfunction getCacheKey(namespace: string | undefined, locale: LocaleCode): string {\n return namespace ? `${namespace}:${locale}` : locale;\n}\n\n/**\n * Load translations for a locale from a directory\n *\n * Supports multiple file formats:\n * - locales/en-US.json (single file per locale)\n * - locales/en-US/common.json (directory per locale with namespace files)\n * - locales/en.json (language-only fallback)\n *\n * @param config I18n configuration\n * @param locale The locale to load\n * @returns Flattened translations map\n */\nexport async function loadTranslationsForLocale(config: I18nConfig, locale: LocaleCode): Promise<FlatTranslationMap> {\n const cacheKey = getCacheKey(config.namespace, locale);\n\n // Check cache first\n if (config.enableCache !== false && translationCache.has(cacheKey)) {\n return translationCache.get(cacheKey)!;\n }\n\n const normalizedLocale = normalizeLocale(locale);\n const language = getLanguageFromLocale(normalizedLocale);\n const result: FlatTranslationMap = {};\n\n // Try loading in order of specificity\n const pathsToTry = [\n // Most specific: full locale\n join(config.localesPath, `${normalizedLocale}.json`),\n // Directory format\n join(config.localesPath, normalizedLocale),\n // Language only fallback\n join(config.localesPath, `${language}.json`),\n // Language directory\n join(config.localesPath, language),\n ];\n\n for (const path of pathsToTry) {\n try {\n const stats = await safeStat(path, config.localesPath);\n if (!stats) continue;\n\n if (stats.isFile() && path.endsWith('.json')) {\n // Single file\n const translations = await loadTranslationFile(path, config.localesPath);\n const flattened = flattenDictionary(translations);\n Object.assign(result, flattened);\n logger.debug(`[I18n] Loaded translations from ${path}`);\n break;\n } else if (stats.isDirectory()) {\n // Directory with multiple namespace files\n const files = await safeReaddir(path, config.localesPath);\n for (const file of files) {\n if (extname(file) === '.json') {\n const namespace = basename(file, '.json');\n const filePath = join(path, file);\n const translations = await loadTranslationFile(filePath, config.localesPath);\n const flattened = flattenDictionary(translations, namespace);\n Object.assign(result, flattened);\n logger.debug(`[I18n] Loaded namespace ${namespace} from ${filePath}`);\n }\n }\n break;\n }\n } catch {\n // Continue trying next path\n }\n }\n\n // If nothing loaded and we have a fallback, try that\n if (Object.keys(result).length === 0 && config.fallbackLocale && config.fallbackLocale !== locale) {\n logger.warn(`[I18n] No translations found for ${locale}, trying fallback ${config.fallbackLocale}`);\n const fallbackTranslations = await loadTranslationsForLocale(\n { ...config, fallbackLocale: undefined },\n config.fallbackLocale\n );\n Object.assign(result, fallbackTranslations);\n }\n\n // Cache the result\n if (config.enableCache !== false) {\n translationCache.set(cacheKey, result);\n }\n\n return result;\n}\n\n/**\n * Discover available locales in a directory\n *\n * @param localesPath Path to locales directory\n * @returns Array of available locale codes\n */\nexport async function discoverLocales(localesPath: string): Promise<LocaleCode[]> {\n const locales: LocaleCode[] = [];\n\n try {\n const validatedBasePath = resolve(localesPath);\n const entries = await readdir(validatedBasePath);\n\n for (const entry of entries) {\n const entryPath = join(validatedBasePath, entry);\n const stats = await safeStat(entryPath, validatedBasePath);\n if (!stats) continue;\n\n if (stats.isFile() && entry.endsWith('.json')) {\n // Single file: en-US.json or en.json\n const locale = basename(entry, '.json');\n locales.push(normalizeLocale(locale));\n } else if (stats.isDirectory()) {\n // Directory: en-US/ or en/\n locales.push(normalizeLocale(entry));\n }\n }\n } catch (error) {\n logger.error(`[I18n] Failed to discover locales in ${localesPath}`, error);\n }\n\n return locales;\n}\n\n/**\n * Preload all translations for supported locales\n *\n * @param config I18n configuration\n */\nexport async function preloadAllTranslations(config: I18nConfig): Promise<void> {\n const locales = config.supportedLocales || (await discoverLocales(config.localesPath));\n\n logger.info(`[I18n] Preloading translations for ${locales.length} locales...`);\n\n await Promise.all(\n locales.map(async (locale) => {\n try {\n await loadTranslationsForLocale(config, locale);\n } catch (error) {\n logger.error(`[I18n] Failed to preload locale ${locale}`, error);\n }\n })\n );\n\n logger.info(`[I18n] Preloaded translations for: ${locales.join(', ')}`);\n}\n\n/**\n * Clear the translation cache\n *\n * @param namespace Optional namespace to clear (clears all if not provided)\n */\nexport function clearTranslationCache(namespace?: string): void {\n if (namespace) {\n for (const key of translationCache.keys()) {\n if (key.startsWith(`${namespace}:`)) {\n translationCache.delete(key);\n }\n }\n } else {\n translationCache.clear();\n }\n}\n\n/**\n * Get cached translations for a locale\n */\nexport function getCachedTranslations(\n namespace: string | undefined,\n locale: LocaleCode\n): FlatTranslationMap | undefined {\n return translationCache.get(getCacheKey(namespace, locale));\n}\n\n/**\n * Set translations in cache (useful for testing or dynamic loading)\n */\nexport function setCachedTranslations(\n namespace: string | undefined,\n locale: LocaleCode,\n translations: FlatTranslationMap\n): void {\n translationCache.set(getCacheKey(namespace, locale), translations);\n}\n","/**\n * I18n Class\n *\n * Main internationalization class providing translation and formatting functions\n */\n\nimport type {\n LocaleCode,\n LanguageCode,\n I18nConfig,\n I18nContext,\n II18n,\n FlatTranslationMap,\n TranslationVariables,\n TranslateFunction,\n PluralTranslateFunction,\n} from './types.js';\nimport { getTextDirection } from './types.js';\nimport { loadTranslationsForLocale, preloadAllTranslations, discoverLocales, getCachedTranslations } from './loader.js';\nimport {\n normalizeLocale,\n getLanguageFromLocale,\n getRegionFromLocale,\n findBestMatch,\n extractLocaleFromRequest,\n} from './parser.js';\nimport { logger } from '../logger/index.js';\n\n/**\n * Pluralization category based on CLDR rules\n */\ntype PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';\n\n/**\n * English and most Germanic/Romance languages (simple one/other)\n */\nfunction getEnglishPluralCategory(absCount: number): PluralCategory {\n if (absCount === 1) return 'one';\n return 'other';\n}\n\n/**\n * French pluralization (0 or 1 = one, else other)\n */\nfunction getFrenchPluralCategory(absCount: number): PluralCategory {\n if (absCount === 0 || absCount === 1) return 'one';\n return 'other';\n}\n\n/**\n * Slavic languages (Russian, Ukrainian) - complex: one, few, many, other\n */\nfunction getSlavicPluralCategory(absCount: number): PluralCategory {\n const mod10 = absCount % 10;\n const mod100 = absCount % 100;\n\n if (mod10 === 1 && mod100 !== 11) return 'one';\n if (mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)) return 'few';\n if (mod10 === 0 || (mod10 >= 5 && mod10 <= 9) || (mod100 >= 11 && mod100 <= 14)) return 'many';\n return 'other';\n}\n\n/**\n * Arabic pluralization (zero, one, two, few, many, other)\n */\nfunction getArabicPluralCategory(absCount: number): PluralCategory {\n if (absCount === 0) return 'zero';\n if (absCount === 1) return 'one';\n if (absCount === 2) return 'two';\n const mod100 = absCount % 100;\n if (mod100 >= 3 && mod100 <= 10) return 'few';\n if (mod100 >= 11 && mod100 <= 99) return 'many';\n return 'other';\n}\n\n/**\n * Polish/Czech pluralization (one, few, many)\n */\nfunction getPolishCzechPluralCategory(absCount: number): PluralCategory {\n const mod10 = absCount % 10;\n const mod100 = absCount % 100;\n\n if (absCount === 1) return 'one';\n if (mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)) return 'few';\n return 'many';\n}\n\n/**\n * Romanian pluralization (one, few, other)\n */\nfunction getRomanianPluralCategory(absCount: number): PluralCategory {\n if (absCount === 1) return 'one';\n const mod100 = absCount % 100;\n if (absCount === 0 || (mod100 >= 1 && mod100 <= 19)) return 'few';\n return 'other';\n}\n\n/**\n * Hebrew pluralization (one, two, other)\n */\nfunction getHebrewPluralCategory(absCount: number): PluralCategory {\n if (absCount === 1) return 'one';\n if (absCount === 2) return 'two';\n return 'other';\n}\n\n/**\n * Get plural category for a count in a given language\n * Based on CLDR plural rules: https://cldr.unicode.org/index/cldr-spec/plural-rules\n */\nfunction getPluralCategory(language: LanguageCode, count: number): PluralCategory {\n const absCount = Math.abs(count);\n\n // English and most Germanic/Romance languages\n const englishLanguages = [\n 'en',\n 'de',\n 'es',\n 'it',\n 'nl',\n 'sv',\n 'da',\n 'nb',\n 'fi',\n 'pt',\n 'el',\n 'hu',\n 'tr',\n 'id',\n 'ms',\n 'th',\n 'vi',\n 'ko',\n 'zh',\n 'ja',\n ];\n if (englishLanguages.includes(language)) {\n return getEnglishPluralCategory(absCount);\n }\n\n // French\n if (language === 'fr') {\n return getFrenchPluralCategory(absCount);\n }\n\n // Russian, Ukrainian\n if (language === 'ru' || language === 'uk') {\n return getSlavicPluralCategory(absCount);\n }\n\n // Arabic\n if (language === 'ar') {\n return getArabicPluralCategory(absCount);\n }\n\n // Polish, Czech\n if (language === 'pl' || language === 'cs') {\n return getPolishCzechPluralCategory(absCount);\n }\n\n // Romanian\n if (language === 'ro') {\n return getRomanianPluralCategory(absCount);\n }\n\n // Hebrew\n if (language === 'he') {\n return getHebrewPluralCategory(absCount);\n }\n\n // Default: simple singular/plural\n return getEnglishPluralCategory(absCount);\n}\n\n/**\n * Interpolate variables in a translation string\n *\n * Supports:\n * - {{variable}} - simple interpolation\n * - {{variable, number}} - number formatting (future)\n * - {{variable, date}} - date formatting (future)\n */\nfunction interpolate(text: string, variables?: TranslationVariables): string {\n if (!variables || !text) {\n return text;\n }\n\n // Use more specific pattern to avoid catastrophic backtracking\n // Matches {{ variableName }} with word characters (alphanumeric and underscore)\n return text.replace(/\\{\\{\\s*(\\w+)\\s*\\}\\}/g, (match, key: string) => {\n const value = variables[key.trim()];\n if (value !== undefined) {\n return String(value);\n }\n return match; // Keep original if variable not found\n });\n}\n\n/**\n * I18n Class\n *\n * Main class for internationalization functionality\n */\nexport class I18n implements II18n {\n private config: I18nConfig;\n private currentLocale: LocaleCode;\n private supportedLocales: LocaleCode[] = [];\n private initialized = false;\n\n constructor(config: I18nConfig) {\n this.config = {\n ...config,\n fallbackLocale: config.fallbackLocale || 'en-US',\n enableCache: config.enableCache !== false,\n returnKeyOnMissing: config.returnKeyOnMissing !== false,\n logMissing: config.logMissing !== false,\n };\n this.currentLocale = normalizeLocale(config.defaultLocale);\n }\n\n /**\n * Initialize the i18n instance\n * Discovers available locales and optionally preloads translations\n */\n async initialize(): Promise<void> {\n if (this.initialized) return;\n\n // Discover available locales\n if (this.config.supportedLocales && this.config.supportedLocales.length > 0) {\n this.supportedLocales = this.config.supportedLocales;\n } else {\n this.supportedLocales = await discoverLocales(this.config.localesPath);\n }\n\n // Preload translations if not lazy loading\n if (!this.config.lazyLoad) {\n await preloadAllTranslations(this.config);\n }\n\n this.initialized = true;\n logger.info(`[I18n] Initialized with ${this.supportedLocales.length} locales, default: ${this.currentLocale}`);\n }\n\n /**\n * Get current locale\n */\n getLocale(): LocaleCode {\n return this.currentLocale;\n }\n\n /**\n * Set current locale\n */\n setLocale(locale: LocaleCode): void {\n this.currentLocale = normalizeLocale(locale);\n }\n\n /**\n * Get supported locales\n */\n getSupportedLocales(): LocaleCode[] {\n return [...this.supportedLocales];\n }\n\n /**\n * Check if a locale is supported\n */\n isSupported(locale: LocaleCode): boolean {\n const normalized = normalizeLocale(locale);\n const language = getLanguageFromLocale(normalized);\n\n return this.supportedLocales.some((l) => {\n const supportedNorm = normalizeLocale(l);\n // Exact match or language match\n return supportedNorm === normalized || getLanguageFromLocale(supportedNorm) === language;\n });\n }\n\n /**\n * Load translations for a specific locale\n */\n async loadLocale(locale: LocaleCode): Promise<void> {\n await loadTranslationsForLocale(this.config, locale);\n }\n\n /**\n * Get all translations for a locale\n */\n getTranslations(locale: LocaleCode): FlatTranslationMap | undefined {\n return getCachedTranslations(this.config.namespace, locale);\n }\n\n /**\n * Translate a key\n */\n t: TranslateFunction = (key: string, variables?: TranslationVariables, defaultValue?: string): string => {\n return this.translate(this.currentLocale, key, variables, defaultValue);\n };\n\n /**\n * Translate with pluralization\n */\n tp: PluralTranslateFunction = (key: string, count: number, variables?: TranslationVariables): string => {\n return this.translatePlural(this.currentLocale, key, count, variables);\n };\n\n /**\n * Internal translate method\n */\n private translate(locale: LocaleCode, key: string, variables?: TranslationVariables, defaultValue?: string): string {\n const translations = getCachedTranslations(this.config.namespace, locale);\n let text = translations?.[key];\n\n // Try fallback locale if not found\n if (!text && this.config.fallbackLocale && locale !== this.config.fallbackLocale) {\n const fallbackTranslations = getCachedTranslations(this.config.namespace, this.config.fallbackLocale);\n text = fallbackTranslations?.[key];\n }\n\n // Try language-only fallback\n if (!text) {\n const language = getLanguageFromLocale(locale);\n if (language !== locale) {\n const langTranslations = getCachedTranslations(this.config.namespace, language);\n text = langTranslations?.[key];\n }\n }\n\n if (!text) {\n if (this.config.logMissing) {\n logger.warn(`[I18n] Missing translation for key: ${key} in locale: ${locale}`);\n }\n // Return default value, key, or empty string — interpolated.\n //\n // The caller's fallback is a real message, not a placeholder for one, so\n // it gets the same `{{var}}` substitution a found translation does.\n // Without this a missing key degrades to raw markup in user-facing output\n // (e.g. a careers confirmation email reading \"Hi {{name}}, thanks for\n // applying for the {{position}} role\"), which is worse than the untranslated\n // English it was meant to fall back to.\n return interpolate(defaultValue ?? (this.config.returnKeyOnMissing ? key : ''), variables);\n }\n\n return interpolate(text, variables);\n }\n\n /**\n * Internal translate with pluralization\n */\n private translatePlural(locale: LocaleCode, key: string, count: number, variables?: TranslationVariables): string {\n const language = getLanguageFromLocale(locale);\n const category = getPluralCategory(language, count);\n\n // Try plural-specific key first (e.g., 'items.one', 'items.other')\n const pluralKey = `${key}.${category}`;\n let text = this.translate(locale, pluralKey, undefined, '');\n\n // Fallback to 'other' if specific form not found\n if (!text && category !== 'other') {\n text = this.translate(locale, `${key}.other`, undefined, '');\n }\n\n // Final fallback to base key\n if (!text) {\n text = this.translate(locale, key, undefined, key);\n }\n\n return interpolate(text, { ...variables, count });\n }\n\n /**\n * Create an i18n context for a specific locale\n */\n createContext(locale: LocaleCode): I18nContext {\n const normalizedLocale = normalizeLocale(locale);\n const language = getLanguageFromLocale(normalizedLocale);\n const region = getRegionFromLocale(normalizedLocale);\n\n // Create bound translate functions for this locale\n const t: TranslateFunction = (key, variables, defaultValue) => {\n return this.translate(normalizedLocale, key, variables, defaultValue);\n };\n\n const tp: PluralTranslateFunction = (key, count, variables) => {\n return this.translatePlural(normalizedLocale, key, count, variables);\n };\n\n const formatNumber = (value: number, options?: Intl.NumberFormatOptions): string => {\n return new Intl.NumberFormat(normalizedLocale, options).format(value);\n };\n\n const formatCurrency = (value: number, currency: string): string => {\n return new Intl.NumberFormat(normalizedLocale, {\n style: 'currency',\n currency,\n }).format(value);\n };\n\n const formatDate = (date: Date | string, options?: Intl.DateTimeFormatOptions): string => {\n const dateObj = typeof date === 'string' ? new Date(date) : date;\n return new Intl.DateTimeFormat(normalizedLocale, options).format(dateObj);\n };\n\n const formatRelativeTime = (value: number, unit: Intl.RelativeTimeFormatUnit): string => {\n return new Intl.RelativeTimeFormat(normalizedLocale, { numeric: 'auto' }).format(value, unit);\n };\n\n return {\n locale: normalizedLocale,\n language,\n region,\n t,\n tp,\n formatNumber,\n formatCurrency,\n formatDate,\n formatRelativeTime,\n };\n }\n\n /**\n * Create context from a request\n */\n createContextFromRequest(request: Request): I18nContext {\n const parsed = extractLocaleFromRequest(request, this.config.defaultLocale);\n const bestMatch = findBestMatch([parsed], this.supportedLocales, this.config.defaultLocale);\n return this.createContext(bestMatch);\n }\n\n /**\n * Get language metadata\n */\n getLanguageInfo(locale: LocaleCode): {\n code: LanguageCode;\n direction: 'ltr' | 'rtl';\n locale: LocaleCode;\n region?: string;\n } {\n const language = getLanguageFromLocale(locale);\n const region = getRegionFromLocale(locale);\n const direction = getTextDirection(language);\n\n return {\n code: language,\n direction,\n locale,\n region,\n };\n }\n}\n\n/**\n * Singleton instance (optional, for simpler usage)\n */\nlet globalI18n: I18n | null = null;\n\n/**\n * Initialize global i18n instance\n */\nexport async function initializeI18n(config: I18nConfig): Promise<I18n> {\n globalI18n = new I18n(config);\n await globalI18n.initialize();\n return globalI18n;\n}\n\n/**\n * Get global i18n instance\n */\nexport function getI18n(): I18n | null {\n return globalI18n;\n}\n\n/**\n * Create a new i18n instance (for isolated use)\n */\nexport function createI18n(config: I18nConfig): I18n {\n return new I18n(config);\n}\n","/**\n * I18n Translation Helpers\n *\n * Provides utilities for getting translated messages from GraphQL/request context.\n * These helpers work with any context that has an optional `i18n` property.\n *\n * Falls back to the provided default message if i18n is not available or translation is missing.\n *\n * @example\n * ```typescript\n * import { t, createTranslator } from '@burdenoff/be-sdk';\n *\n * // Direct usage with context\n * const message = t(ctx, 'tags.errors.notFound', 'Tag not found');\n * const message = t(ctx, 'tags.errors.keyExists', 'Tag {{key}} already exists', { key: 'my-tag' });\n *\n * // Create a bound translator for a specific context\n * const translate = createTranslator(ctx);\n * const message = translate('tags.errors.notFound', 'Tag not found');\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { I18nContext, TranslationVariables } from './types.js';\n\n/**\n * Context with optional i18n\n * Works with any object that has an optional i18n property\n */\nexport interface I18nCapableContext {\n i18n?: I18nContext;\n}\n\n/**\n * Interpolate variables in a string\n *\n * @param text - Text with {{variable}} placeholders\n * @param variables - Variables to interpolate\n * @returns Interpolated string\n */\nfunction interpolateVariables(text: string, variables?: TranslationVariables): string {\n if (!variables) return text;\n\n return text.replace(/\\{\\{(\\w+)\\}\\}/g, (match, key: string) => {\n const value = variables[key];\n return value !== undefined ? String(value) : match;\n });\n}\n\n/**\n * Get a translated message from context\n *\n * This is the primary function for getting translations in providers and resolvers.\n * It gracefully handles cases where i18n is not available by returning the default message.\n *\n * @param ctx - Context with optional i18n (GraphQL context, request context, etc.)\n * @param key - Translation key (e.g., 'tags.errors.notFound')\n * @param defaultMessage - Fallback message if translation not found\n * @param variables - Optional variables for interpolation\n * @returns Translated message or default message\n *\n * @example\n * ```typescript\n * // Simple usage\n * const message = t(ctx, 'tags.errors.notFound', 'Tag not found');\n *\n * // With variables\n * const message = t(ctx, 'tags.errors.keyAlreadyExists', 'Tag with key {{key}} already exists', { key: 'my-tag' });\n *\n * // In a GraphQL resolver\n * if (!userId) {\n * throw new Error(t(context, 'common.errors.notAuthenticated', 'User not authenticated'));\n * }\n * ```\n */\nexport function t(\n ctx: I18nCapableContext,\n key: string,\n defaultMessage: string,\n variables?: TranslationVariables\n): string {\n // If i18n is not available, interpolate and return default message\n if (!ctx.i18n?.t) {\n return interpolateVariables(defaultMessage, variables);\n }\n\n // Get translation with fallback to default\n const translated = ctx.i18n.t(key, variables, defaultMessage);\n\n // If translation returns the key (not found), use default message\n if (translated === key) {\n return interpolateVariables(defaultMessage, variables);\n }\n\n return translated;\n}\n\n/**\n * Translator function type\n */\nexport type Translator = (key: string, defaultMessage: string, variables?: TranslationVariables) => string;\n\n/**\n * Create a bound translator function for a specific context\n *\n * This is useful when you need to pass a translator to services or\n * when you want to avoid repeating the context parameter.\n *\n * @param ctx - Context with optional i18n\n * @returns Translate function bound to the context\n *\n * @example\n * ```typescript\n * // Create translator\n * const translate = createTranslator(ctx);\n *\n * // Use it multiple times\n * const msg1 = translate('tags.errors.notFound', 'Tag not found');\n * const msg2 = translate('tags.errors.keyExists', 'Key {{key}} exists', { key: 'foo' });\n *\n * // Pass to a service\n * await someService.process(data, { translate });\n * ```\n */\nexport function createTranslator(ctx: I18nCapableContext): Translator {\n return (key: string, defaultMessage: string, variables?: TranslationVariables) => {\n return t(ctx, key, defaultMessage, variables);\n };\n}\n\n/**\n * Check if context has i18n support\n *\n * @param ctx - Context to check\n * @returns True if i18n is available and initialized\n */\nexport function hasI18n(ctx: I18nCapableContext): ctx is I18nCapableContext & { i18n: I18nContext } {\n return ctx.i18n?.t !== undefined;\n}\n\n/**\n * Get the current locale from context\n *\n * @param ctx - Context with optional i18n\n * @param defaultLocale - Default locale if i18n not available\n * @returns Current locale code\n */\nexport function getLocale(ctx: I18nCapableContext, defaultLocale: string = 'en-US'): string {\n return ctx.i18n?.locale ?? defaultLocale;\n}\n\n/**\n * Get the current language from context\n *\n * @param ctx - Context with optional i18n\n * @param defaultLanguage - Default language if i18n not available\n * @returns Current language code\n */\nexport function getLanguage(ctx: I18nCapableContext, defaultLanguage: string = 'en'): string {\n return ctx.i18n?.language ?? defaultLanguage;\n}\n"]}
package/dist/{chunk-RJK4MPDW.js → chunk-XWVP4MC6.js} RENAMED
@@ -1,4 +1,4 @@
1
- import { createCounter } from './chunk-Q6UAOZFZ.js';
1
+ import { createCounter } from './chunk-AWPNRV3L.js';
2
2
  import { logger } from './chunk-CBZNP6RF.js';
3
3
  import { __name } from './chunk-XE4OXN2W.js';
4
4
  import { GraphQLError } from 'graphql';
@@ -447,5 +447,5 @@ function __resetResourceCapsForTests() {
447
447
  __name(__resetResourceCapsForTests, "__resetResourceCapsForTests");
448
448
 
449
449
  export { RESOURCE_CAP_DEFAULTS, ResourceCapExceededError, ResourceCapsModule, __resetResourceCapsForTests, configureResourceCaps, getResourceCaps };
450
- //# sourceMappingURL=chunk-RJK4MPDW.js.map
451
- //# sourceMappingURL=chunk-RJK4MPDW.js.map
450
+ //# sourceMappingURL=chunk-XWVP4MC6.js.map
451
+ //# sourceMappingURL=chunk-XWVP4MC6.js.map
package/dist/{chunk-RJK4MPDW.js.map → chunk-XWVP4MC6.js.map} RENAMED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/resource-caps/index.ts"],"names":["RESOURCE_CAP_DEFAULTS","workspace","free","paidDefault","scope","workspaceMember","sandbox","vibe","agent","conversation","message","tag","file","group","calendar","scheduledTask","form","apiKey","webhook","ResourceCapExceededError","GraphQLError","detail","resource","currentCount","limit","planName","extensions","code","userMessage","technicalMessage","name","PLAN_QUERY","ResourceCapsModule","client","transport","cacheTtlMs","clientlessTier","billingFailureTier","onFallback","onBillingFailure","warnedClientless","planCache","Map","planResolutionCounter","enforcementCounter","config","createCounter","configure","undefined","hasBillingSource","clear","Boolean","getResourceCap","userId","Error","defaults","plan","resolvePlan","override","overrides","planTier","isFallback","fallbackReason","enforceResourceCap","cap","inc","plan_tier","result","getWorkspaceResourceCap","workspaceId","organizationId","workspaceCacheKey","enforceWorkspaceResourceCap","invalidate","delete","invalidateWorkspace","invalidateAll","cacheKey","key","cached","get","Date","now","fetchedAt","fetchPlan","set","warnClientlessOnce","reason","fallbackPlan","planNode","fetchPlanNode","logger","warn","tier","normaliseTier","sanitizeOverrides","resourceCaps","err","data","userBillingPlan","res","query","raw","fallback","lc","toLowerCase","out","value","Object","entries","Number","isFinite","Math","max","floor","defaultInstance","getResourceCaps","configureResourceCaps","instance","__resetResourceCapsForTests"],"mappings":"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","file":"chunk-RJK4MPDW.js","sourcesContent":["/**\n * Resource Caps Module\n *\n * Enforces per-user / per-workspace resource ceilings to prevent unbounded\n * resource use on a multi-tenant SaaS. Caps come from the user's billing plan\n * (resolved via global-billing-svc) and fall back to static defaults defined\n * here when the plan lookup fails or the resource isn't overridden.\n *\n * Two plan tiers exist by default:\n * - free: tight per-user / per-workspace ceilings\n * - paid (default): ~100x looser; individual paid plans can override via the\n * `Plan.resourceCaps` JSON column in global-billing-svc.\n *\n * @example\n * ```ts\n * import { resourceCaps } from '@burdenoff/be-sdk/resource-caps';\n *\n * const { limit } = await resourceCaps.getResourceCap(userId, 'tag');\n * await resourceCaps.enforceResourceCap(userId, 'tag', currentCount);\n * ```\n */\n\nimport { GraphQLError } from 'graphql';\n\nimport type { BurdenoffGraphQLClient } from '../client/graphql.js';\nimport { createCounter } from '../instrumentation/metrics-collector.js';\nimport { logger } from '../logger/index.js';\n\n// ---------------------------------------------------------------------------\n// Resource registry\n// ---------------------------------------------------------------------------\n\n/**\n * Canonical resource names. Adding a new capped resource? Append it here,\n * extend RESOURCE_CAP_DEFAULTS, and reference it from the relevant svc.\n */\nexport type ResourceName =\n | 'workspace' // per user\n | 'workspaceMember' // per workspace\n | 'sandbox' // per user\n | 'vibe' // per user\n | 'agent' // per workspace\n | 'conversation' // per user/day\n | 'message' // per user/day\n | 'tag' // per workspace\n | 'file' // per user (count only)\n | 'group' // per workspace\n | 'calendar' // per user\n | 'scheduledTask' // per user\n | 'form' // per user\n | 'apiKey' // per user\n | 'webhook'; // per workspace\n\nexport type PlanTier = 'free' | 'paid';\n\nexport interface ResourceCapDefaults {\n free: number;\n paidDefault: number;\n /** Optional scope hint used by callers when wiring guards */\n scope: 'user' | 'workspace' | 'user/day';\n}\n\n/**\n * Static fallback caps. Real values may be overridden per plan in\n * global-billing-svc Plan.resourceCaps JSON.\n */\nexport const RESOURCE_CAP_DEFAULTS: Record<ResourceName, ResourceCapDefaults> = {\n workspace: { free: 3, paidDefault: 50, scope: 'user' },\n workspaceMember: { free: 500, paidDefault: 500, scope: 'workspace' },\n sandbox: { free: 2, paidDefault: 50, scope: 'user' },\n vibe: { free: 10, paidDefault: 500, scope: 'user' },\n agent: { free: 2, paidDefault: 20, scope: 'workspace' },\n conversation: { free: 20, paidDefault: 2000, scope: 'user/day' },\n message: { free: 200, paidDefault: 20000, scope: 'user/day' },\n tag: { free: 50, paidDefault: 5000, scope: 'workspace' },\n file: { free: 100, paidDefault: 10000, scope: 'user' },\n group: { free: 5, paidDefault: 500, scope: 'workspace' },\n calendar: { free: 3, paidDefault: 100, scope: 'user' },\n scheduledTask: { free: 5, paidDefault: 500, scope: 'user' },\n form: { free: 5, paidDefault: 500, scope: 'user' },\n apiKey: { free: 2, paidDefault: 50, scope: 'user' },\n webhook: { free: 2, paidDefault: 100, scope: 'workspace' },\n};\n\n// ---------------------------------------------------------------------------\n// Types & errors\n// ---------------------------------------------------------------------------\n\nexport interface ResourceCap {\n resource: ResourceName;\n limit: number;\n planName: string;\n planTier: PlanTier;\n /** True when the cap came from defaults, not from the billing service */\n isFallback: boolean;\n /** Why the fallback was used, when isFallback is true */\n fallbackReason?: 'clientless' | 'billing_error';\n}\n\n/**\n * Scope for workspace-scoped resource caps. The cap is derived from the plan of\n * the workspace's owning organization, not from whichever actor happens to be\n * making the request, so two members of the same workspace always see the same\n * limit (BOFF-4808).\n */\nexport interface WorkspaceResourceCapScope {\n /** Stable workspace identifier; used as the cache key. */\n workspaceId: string;\n /**\n * Organization that owns the workspace and whose billing plan determines the\n * cap. This is the `organizationId` from global-tenant-svc's Workspace type\n * (or `orgId` from wspace-workspace-svc's Workspace type).\n */\n organizationId: string;\n}\n\n/**\n * Layer-aware transport for the `userBillingPlan` lookup. Given the GraphQL\n * document + variables, returns the response `data` object (or null). Preferred\n * over `client`: the SDK bootstrap wires this to a same-layer (global) or\n * cross-layer (wspace→global) gateway call so billing is reachable from every\n * service without any per-call-site wiring (BOFF-4805).\n */\nexport type BillingPlanTransport = (query: string, variables: Record<string, unknown>) => Promise<unknown>;\n\nexport interface ResourceCapsConfig {\n client?: BurdenoffGraphQLClient;\n /** Preferred billing lookup path; see {@link BillingPlanTransport}. */\n transport?: BillingPlanTransport;\n /** Optional in-memory TTL for plan lookups; defaults to 60s */\n cacheTtlMs?: number;\n /**\n * Plan tier used when the module has no billing source (clientless). This is\n * the misconfiguration path: services should always bootstrap with a billing\n * transport. Defaults to `free` so a clientless service is visibly broken in\n * tests, while still not hard-blocking local unit tests.\n */\n clientlessTier?: PlanTier;\n /**\n * Plan tier used when a billing source is configured but the lookup fails\n * (network error, billing service down, etc.). Defaults to `paid` so a\n * transient billing outage does not silently downgrade paid customers to the\n * tightest free-tier caps (fail-open with alerting; BOFF-4805/4809).\n */\n billingFailureTier?: PlanTier;\n /**\n * Telemetry hook invoked when the module cannot reach billing (no transport /\n * client) and collapses to the clientless fallback. Wired to a metric counter\n * by observability so an unwired/broken integration is visible (BOFF-4809).\n */\n onFallback?: () => void;\n /**\n * Telemetry hook invoked when a billing source is configured but the lookup\n * fails (billing error fallback to the paid default).\n */\n onBillingFailure?: () => void;\n}\n\ninterface CachedPlan {\n planName: string;\n planTier: PlanTier;\n overrides: Partial<Record<ResourceName, number>>;\n fetchedAt: number;\n isFallback: boolean;\n fallbackReason?: 'clientless' | 'billing_error';\n}\n\n/**\n * Thrown when an entity create operation would push the user past the cap.\n * The matching GraphQL error has extensions.code = RESOURCE_CAP_EXCEEDED\n * so clients can detect and route to an upgrade flow.\n */\nexport class ResourceCapExceededError extends GraphQLError {\n constructor(detail: { resource: ResourceName; currentCount: number; limit: number; planName: string }) {\n super(\n `Resource cap exceeded for ${detail.resource}: ${detail.currentCount}/${detail.limit} on plan '${detail.planName}'.`,\n {\n extensions: {\n code: 'RESOURCE_CAP_EXCEEDED',\n userMessage: \"You've reached your plan limit. Upgrade your plan to continue.\",\n technicalMessage: `Resource cap exceeded for ${detail.resource}: ${detail.currentCount}/${detail.limit} on plan '${detail.planName}'.`,\n resource: detail.resource,\n currentCount: detail.currentCount,\n limit: detail.limit,\n planName: detail.planName,\n },\n }\n );\n this.name = 'ResourceCapExceededError';\n }\n}\n\n// ---------------------------------------------------------------------------\n// Module\n// ---------------------------------------------------------------------------\n\nconst PLAN_QUERY = /* GraphQL */ `\n query GetUserPlanForCaps($userId: ID!) {\n userBillingPlan(userId: $userId) {\n planName\n tier\n resourceCaps\n }\n }\n`;\n\ninterface PlanQueryResponse {\n userBillingPlan?: {\n planName?: string | null;\n tier?: string | null;\n resourceCaps?: Record<string, number> | null;\n } | null;\n}\n\ntype PlanNode = NonNullable<PlanQueryResponse['userBillingPlan']>;\n\nexport class ResourceCapsModule {\n private client?: BurdenoffGraphQLClient;\n private transport?: BillingPlanTransport;\n private cacheTtlMs: number;\n private clientlessTier: PlanTier;\n private billingFailureTier: PlanTier;\n private onFallback?: () => void;\n private onBillingFailure?: () => void;\n private warnedClientless = false;\n private readonly planCache = new Map<string, CachedPlan>();\n private readonly planResolutionCounter;\n private readonly enforcementCounter;\n\n constructor(config: ResourceCapsConfig = {}) {\n this.client = config.client;\n this.transport = config.transport;\n this.cacheTtlMs = config.cacheTtlMs ?? 60_000;\n this.clientlessTier = config.clientlessTier ?? 'free';\n this.billingFailureTier = config.billingFailureTier ?? 'paid';\n this.onFallback = config.onFallback;\n this.onBillingFailure = config.onBillingFailure;\n this.planResolutionCounter = createCounter(\n 'resource_caps.plan_resolution_total',\n 'Total number of billing plan resolutions for resource caps'\n );\n this.enforcementCounter = createCounter(\n 'resource_caps.enforcement_total',\n 'Total number of resource cap enforcement checks'\n );\n }\n\n /**\n * (Re)bind runtime dependencies on an already-constructed module. The SDK\n * bootstrap uses this to prime the process-wide singleton with a billing\n * transport even if an early caller already lazily created it clientless\n * (a bare `getResourceCaps(config)` ignores config once the instance exists).\n * Clears the plan cache so stale fallback entries don't linger.\n */\n configure(config: ResourceCapsConfig): void {\n if (config.client !== undefined) this.client = config.client;\n if (config.transport !== undefined) this.transport = config.transport;\n if (config.onFallback !== undefined) this.onFallback = config.onFallback;\n if (config.onBillingFailure !== undefined) this.onBillingFailure = config.onBillingFailure;\n if (typeof config.cacheTtlMs === 'number') this.cacheTtlMs = config.cacheTtlMs;\n if (config.clientlessTier) this.clientlessTier = config.clientlessTier;\n if (config.billingFailureTier) this.billingFailureTier = config.billingFailureTier;\n if (this.hasBillingSource()) this.warnedClientless = false;\n this.planCache.clear();\n }\n\n /** True when the module can actually reach billing (has a transport or client). */\n hasBillingSource(): boolean {\n return Boolean(this.transport || this.client);\n }\n\n /**\n * Resolve the cap for a given resource for the supplied user.\n * Order: plan-override → plan-tier-default → static free default.\n */\n async getResourceCap(userId: string, resource: ResourceName): Promise<ResourceCap> {\n if (!userId) {\n throw new Error('getResourceCap: userId is required');\n }\n const defaults = RESOURCE_CAP_DEFAULTS[resource];\n if (!defaults) {\n throw new Error(`getResourceCap: unknown resource '${resource}'`);\n }\n\n const plan = await this.resolvePlan(userId);\n const override = plan.overrides[resource];\n if (typeof override === 'number' && override >= 0) {\n return {\n resource,\n limit: override,\n planName: plan.planName,\n planTier: plan.planTier,\n isFallback: plan.isFallback,\n fallbackReason: plan.fallbackReason,\n };\n }\n\n const limit = plan.planTier === 'paid' ? defaults.paidDefault : defaults.free;\n return {\n resource,\n limit,\n planName: plan.planName,\n planTier: plan.planTier,\n isFallback: plan.isFallback,\n fallbackReason: plan.fallbackReason,\n };\n }\n\n /**\n * Throws ResourceCapExceededError when currentCount >= limit.\n * Use BEFORE the create transaction to avoid orphan rows.\n */\n async enforceResourceCap(userId: string, resource: ResourceName, currentCount: number): Promise<ResourceCap> {\n const cap = await this.getResourceCap(userId, resource);\n if (currentCount >= cap.limit) {\n this.enforcementCounter.inc({\n resource,\n plan_tier: cap.planTier,\n result: 'denied',\n });\n throw new ResourceCapExceededError({\n resource,\n currentCount,\n limit: cap.limit,\n planName: cap.planName,\n });\n }\n this.enforcementCounter.inc({\n resource,\n plan_tier: cap.planTier,\n result: 'allowed',\n });\n return cap;\n }\n\n /**\n * Resolve a workspace-scoped resource cap from the workspace's owner\n * organization plan, regardless of which actor triggered the action.\n *\n * @example\n * ```ts\n * const { limit } = await caps.getWorkspaceResourceCap(\n * { workspaceId: 'ws-1', organizationId: 'org-1' },\n * 'group'\n * );\n * ```\n */\n async getWorkspaceResourceCap(scope: WorkspaceResourceCapScope, resource: ResourceName): Promise<ResourceCap> {\n const { workspaceId, organizationId } = scope;\n if (!workspaceId) {\n throw new Error('getWorkspaceResourceCap: workspaceId is required');\n }\n if (!organizationId) {\n throw new Error('getWorkspaceResourceCap: organizationId is required');\n }\n const defaults = RESOURCE_CAP_DEFAULTS[resource];\n if (!defaults) {\n throw new Error(`getWorkspaceResourceCap: unknown resource '${resource}'`);\n }\n\n const plan = await this.resolvePlan(organizationId, this.workspaceCacheKey(workspaceId));\n const override = plan.overrides[resource];\n if (typeof override === 'number' && override >= 0) {\n return {\n resource,\n limit: override,\n planName: plan.planName,\n planTier: plan.planTier,\n isFallback: plan.isFallback,\n fallbackReason: plan.fallbackReason,\n };\n }\n\n const limit = plan.planTier === 'paid' ? defaults.paidDefault : defaults.free;\n return {\n resource,\n limit,\n planName: plan.planName,\n planTier: plan.planTier,\n isFallback: plan.isFallback,\n fallbackReason: plan.fallbackReason,\n };\n }\n\n /**\n * Throws ResourceCapExceededError when currentCount >= limit for a\n * workspace-scoped resource. The cap is resolved from the workspace owner's\n * organization plan, so the answer is stable across members.\n */\n async enforceWorkspaceResourceCap(\n scope: WorkspaceResourceCapScope,\n resource: ResourceName,\n currentCount: number\n ): Promise<ResourceCap> {\n const cap = await this.getWorkspaceResourceCap(scope, resource);\n if (currentCount >= cap.limit) {\n this.enforcementCounter.inc({\n resource,\n plan_tier: cap.planTier,\n result: 'denied',\n });\n throw new ResourceCapExceededError({\n resource,\n currentCount,\n limit: cap.limit,\n planName: cap.planName,\n });\n }\n this.enforcementCounter.inc({\n resource,\n plan_tier: cap.planTier,\n result: 'allowed',\n });\n return cap;\n }\n\n /** Invalidate cache for a user (e.g. after plan upgrade) */\n invalidate(userId: string): void {\n this.planCache.delete(userId);\n }\n\n /** Invalidate cache for a workspace (e.g. after workspace plan change) */\n invalidateWorkspace(workspaceId: string): void {\n this.planCache.delete(this.workspaceCacheKey(workspaceId));\n }\n\n /** Clear entire plan cache */\n invalidateAll(): void {\n this.planCache.clear();\n }\n\n // -------------------------------------------------------------------------\n // Internals\n // -------------------------------------------------------------------------\n\n private workspaceCacheKey(workspaceId: string): string {\n return `workspace:${workspaceId}`;\n }\n\n private async resolvePlan(userId: string, cacheKey?: string): Promise<CachedPlan> {\n const key = cacheKey ?? userId;\n const cached = this.planCache.get(key);\n if (cached && Date.now() - cached.fetchedAt < this.cacheTtlMs) {\n return cached;\n }\n\n const plan = await this.fetchPlan(userId);\n this.planCache.set(key, plan);\n return plan;\n }\n\n private async fetchPlan(userId: string): Promise<CachedPlan> {\n // No billing source wired → every cap silently collapses to the configured\n // clientless tier. Warn loudly (once) so an unwired/broken integration\n // can't hide in prod (BOFF-4805/4809).\n if (!this.hasBillingSource()) {\n this.warnClientlessOnce();\n this.planResolutionCounter.inc({ result: 'fallback', reason: 'clientless' });\n return this.fallbackPlan(this.clientlessTier, 'clientless');\n }\n try {\n const planNode = await this.fetchPlanNode(userId);\n if (!planNode) {\n logger.warn('resource-caps: plan lookup returned null; falling back to paid defaults', {\n userId,\n });\n this.onBillingFailure?.();\n this.planResolutionCounter.inc({ result: 'fallback', reason: 'billing_error' });\n return this.fallbackPlan(this.billingFailureTier, 'billing_error');\n }\n const tier = normaliseTier(planNode.tier, this.billingFailureTier);\n const overrides = sanitizeOverrides(planNode.resourceCaps);\n this.planResolutionCounter.inc({ result: 'billing' });\n return {\n planName: planNode.planName ?? (tier === 'paid' ? 'paid' : 'free'),\n planTier: tier,\n overrides,\n fetchedAt: Date.now(),\n isFallback: false,\n };\n } catch (err) {\n logger.warn('resource-caps: plan lookup failed; falling back to paid defaults', {\n err,\n userId,\n });\n this.onBillingFailure?.();\n this.planResolutionCounter.inc({ result: 'fallback', reason: 'billing_error' });\n return this.fallbackPlan(this.billingFailureTier, 'billing_error');\n }\n }\n\n /**\n * Resolve the raw `userBillingPlan` node via the injected transport (preferred)\n * or the legacy direct client. Guarded by {@link hasBillingSource} in the\n * caller, so at least one path is present here.\n */\n private async fetchPlanNode(userId: string): Promise<PlanNode | null> {\n if (this.transport) {\n const data = (await this.transport(PLAN_QUERY, { userId })) as PlanQueryResponse | null | undefined;\n return data?.userBillingPlan ?? null;\n }\n if (this.client) {\n const res = await this.client.query<PlanQueryResponse>(PLAN_QUERY, { userId });\n return res?.userBillingPlan ?? null;\n }\n return null;\n }\n\n private warnClientlessOnce(): void {\n if (this.warnedClientless) return;\n this.warnedClientless = true;\n logger.warn(\n 'resource-caps: running WITHOUT a billing transport/client — every resource cap will use the ' +\n 'free-tier fallback regardless of the customer plan. Ensure initializeBurdenoffSDK() ran with a ' +\n 'layer/gateway configured (BOFF-4805).'\n );\n this.onFallback?.();\n }\n\n private fallbackPlan(tier: PlanTier, reason: 'clientless' | 'billing_error'): CachedPlan {\n return {\n planName: tier === 'paid' ? 'fallback-paid' : 'fallback-free',\n planTier: tier,\n overrides: {},\n fetchedAt: Date.now(),\n isFallback: true,\n fallbackReason: reason,\n };\n }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction normaliseTier(raw: string | null | undefined, fallback: PlanTier): PlanTier {\n if (!raw) return fallback;\n const lc = raw.toLowerCase();\n if (lc === 'free' || lc === 'paid') return lc;\n // Treat anything non-free as paid (enterprise, business, pro, etc.)\n if (lc === 'enterprise' || lc === 'business' || lc === 'pro' || lc === 'team') {\n return 'paid';\n }\n return fallback;\n}\n\nfunction sanitizeOverrides(raw: Record<string, number> | null | undefined): Partial<Record<ResourceName, number>> {\n if (!raw || typeof raw !== 'object') return {};\n const out: Partial<Record<ResourceName, number>> = {};\n for (const [key, value] of Object.entries(raw)) {\n if (key in RESOURCE_CAP_DEFAULTS && typeof value === 'number' && Number.isFinite(value)) {\n out[key as ResourceName] = Math.max(0, Math.floor(value));\n }\n }\n return out;\n}\n\n// ---------------------------------------------------------------------------\n// Convenience singleton\n// ---------------------------------------------------------------------------\n\nlet defaultInstance: ResourceCapsModule | null = null;\n\n/**\n * Obtain a process-wide singleton. The first call binds the GraphQL client\n * (typically the SDK's internal client). Later calls return the same instance.\n */\nexport function getResourceCaps(config?: ResourceCapsConfig): ResourceCapsModule {\n if (!defaultInstance) {\n defaultInstance = new ResourceCapsModule(config);\n } else if (config) {\n // Previously the config was silently dropped once the singleton existed —\n // the root cause of BOFF-4805 where the billing client could never be bound\n // after a lazy first construction. Apply it instead.\n defaultInstance.configure(config);\n }\n return defaultInstance;\n}\n\n/**\n * Prime/rebind the process-wide singleton with billing connectivity. Call once\n * during SDK bootstrap. Unlike a bare `getResourceCaps(config)` on a fresh\n * process, this is explicit about the intent to (re)wire and is safe to call\n * after the singleton was already lazily created clientless.\n */\nexport function configureResourceCaps(config: ResourceCapsConfig): ResourceCapsModule {\n const instance = getResourceCaps();\n instance.configure(config);\n return instance;\n}\n\n/** Reset the singleton (for tests) */\nexport function __resetResourceCapsForTests(): void {\n defaultInstance = null;\n}\n"]}
1
+ {"version":3,"sources":["../src/resource-caps/index.ts"],"names":["RESOURCE_CAP_DEFAULTS","workspace","free","paidDefault","scope","workspaceMember","sandbox","vibe","agent","conversation","message","tag","file","group","calendar","scheduledTask","form","apiKey","webhook","ResourceCapExceededError","GraphQLError","detail","resource","currentCount","limit","planName","extensions","code","userMessage","technicalMessage","name","PLAN_QUERY","ResourceCapsModule","client","transport","cacheTtlMs","clientlessTier","billingFailureTier","onFallback","onBillingFailure","warnedClientless","planCache","Map","planResolutionCounter","enforcementCounter","config","createCounter","configure","undefined","hasBillingSource","clear","Boolean","getResourceCap","userId","Error","defaults","plan","resolvePlan","override","overrides","planTier","isFallback","fallbackReason","enforceResourceCap","cap","inc","plan_tier","result","getWorkspaceResourceCap","workspaceId","organizationId","workspaceCacheKey","enforceWorkspaceResourceCap","invalidate","delete","invalidateWorkspace","invalidateAll","cacheKey","key","cached","get","Date","now","fetchedAt","fetchPlan","set","warnClientlessOnce","reason","fallbackPlan","planNode","fetchPlanNode","logger","warn","tier","normaliseTier","sanitizeOverrides","resourceCaps","err","data","userBillingPlan","res","query","raw","fallback","lc","toLowerCase","out","value","Object","entries","Number","isFinite","Math","max","floor","defaultInstance","getResourceCaps","configureResourceCaps","instance","__resetResourceCapsForTests"],"mappings":"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","file":"chunk-XWVP4MC6.js","sourcesContent":["/**\n * Resource Caps Module\n *\n * Enforces per-user / per-workspace resource ceilings to prevent unbounded\n * resource use on a multi-tenant SaaS. Caps come from the user's billing plan\n * (resolved via global-billing-svc) and fall back to static defaults defined\n * here when the plan lookup fails or the resource isn't overridden.\n *\n * Two plan tiers exist by default:\n * - free: tight per-user / per-workspace ceilings\n * - paid (default): ~100x looser; individual paid plans can override via the\n * `Plan.resourceCaps` JSON column in global-billing-svc.\n *\n * @example\n * ```ts\n * import { resourceCaps } from '@burdenoff/be-sdk/resource-caps';\n *\n * const { limit } = await resourceCaps.getResourceCap(userId, 'tag');\n * await resourceCaps.enforceResourceCap(userId, 'tag', currentCount);\n * ```\n */\n\nimport { GraphQLError } from 'graphql';\n\nimport type { BurdenoffGraphQLClient } from '../client/graphql.js';\nimport { createCounter } from '../instrumentation/metrics-collector.js';\nimport { logger } from '../logger/index.js';\n\n// ---------------------------------------------------------------------------\n// Resource registry\n// ---------------------------------------------------------------------------\n\n/**\n * Canonical resource names. Adding a new capped resource? Append it here,\n * extend RESOURCE_CAP_DEFAULTS, and reference it from the relevant svc.\n */\nexport type ResourceName =\n | 'workspace' // per user\n | 'workspaceMember' // per workspace\n | 'sandbox' // per user\n | 'vibe' // per user\n | 'agent' // per workspace\n | 'conversation' // per user/day\n | 'message' // per user/day\n | 'tag' // per workspace\n | 'file' // per user (count only)\n | 'group' // per workspace\n | 'calendar' // per user\n | 'scheduledTask' // per user\n | 'form' // per user\n | 'apiKey' // per user\n | 'webhook'; // per workspace\n\nexport type PlanTier = 'free' | 'paid';\n\nexport interface ResourceCapDefaults {\n free: number;\n paidDefault: number;\n /** Optional scope hint used by callers when wiring guards */\n scope: 'user' | 'workspace' | 'user/day';\n}\n\n/**\n * Static fallback caps. Real values may be overridden per plan in\n * global-billing-svc Plan.resourceCaps JSON.\n */\nexport const RESOURCE_CAP_DEFAULTS: Record<ResourceName, ResourceCapDefaults> = {\n workspace: { free: 3, paidDefault: 50, scope: 'user' },\n workspaceMember: { free: 500, paidDefault: 500, scope: 'workspace' },\n sandbox: { free: 2, paidDefault: 50, scope: 'user' },\n vibe: { free: 10, paidDefault: 500, scope: 'user' },\n agent: { free: 2, paidDefault: 20, scope: 'workspace' },\n conversation: { free: 20, paidDefault: 2000, scope: 'user/day' },\n message: { free: 200, paidDefault: 20000, scope: 'user/day' },\n tag: { free: 50, paidDefault: 5000, scope: 'workspace' },\n file: { free: 100, paidDefault: 10000, scope: 'user' },\n group: { free: 5, paidDefault: 500, scope: 'workspace' },\n calendar: { free: 3, paidDefault: 100, scope: 'user' },\n scheduledTask: { free: 5, paidDefault: 500, scope: 'user' },\n form: { free: 5, paidDefault: 500, scope: 'user' },\n apiKey: { free: 2, paidDefault: 50, scope: 'user' },\n webhook: { free: 2, paidDefault: 100, scope: 'workspace' },\n};\n\n// ---------------------------------------------------------------------------\n// Types & errors\n// ---------------------------------------------------------------------------\n\nexport interface ResourceCap {\n resource: ResourceName;\n limit: number;\n planName: string;\n planTier: PlanTier;\n /** True when the cap came from defaults, not from the billing service */\n isFallback: boolean;\n /** Why the fallback was used, when isFallback is true */\n fallbackReason?: 'clientless' | 'billing_error';\n}\n\n/**\n * Scope for workspace-scoped resource caps. The cap is derived from the plan of\n * the workspace's owning organization, not from whichever actor happens to be\n * making the request, so two members of the same workspace always see the same\n * limit (BOFF-4808).\n */\nexport interface WorkspaceResourceCapScope {\n /** Stable workspace identifier; used as the cache key. */\n workspaceId: string;\n /**\n * Organization that owns the workspace and whose billing plan determines the\n * cap. This is the `organizationId` from global-tenant-svc's Workspace type\n * (or `orgId` from wspace-workspace-svc's Workspace type).\n */\n organizationId: string;\n}\n\n/**\n * Layer-aware transport for the `userBillingPlan` lookup. Given the GraphQL\n * document + variables, returns the response `data` object (or null). Preferred\n * over `client`: the SDK bootstrap wires this to a same-layer (global) or\n * cross-layer (wspace→global) gateway call so billing is reachable from every\n * service without any per-call-site wiring (BOFF-4805).\n */\nexport type BillingPlanTransport = (query: string, variables: Record<string, unknown>) => Promise<unknown>;\n\nexport interface ResourceCapsConfig {\n client?: BurdenoffGraphQLClient;\n /** Preferred billing lookup path; see {@link BillingPlanTransport}. */\n transport?: BillingPlanTransport;\n /** Optional in-memory TTL for plan lookups; defaults to 60s */\n cacheTtlMs?: number;\n /**\n * Plan tier used when the module has no billing source (clientless). This is\n * the misconfiguration path: services should always bootstrap with a billing\n * transport. Defaults to `free` so a clientless service is visibly broken in\n * tests, while still not hard-blocking local unit tests.\n */\n clientlessTier?: PlanTier;\n /**\n * Plan tier used when a billing source is configured but the lookup fails\n * (network error, billing service down, etc.). Defaults to `paid` so a\n * transient billing outage does not silently downgrade paid customers to the\n * tightest free-tier caps (fail-open with alerting; BOFF-4805/4809).\n */\n billingFailureTier?: PlanTier;\n /**\n * Telemetry hook invoked when the module cannot reach billing (no transport /\n * client) and collapses to the clientless fallback. Wired to a metric counter\n * by observability so an unwired/broken integration is visible (BOFF-4809).\n */\n onFallback?: () => void;\n /**\n * Telemetry hook invoked when a billing source is configured but the lookup\n * fails (billing error fallback to the paid default).\n */\n onBillingFailure?: () => void;\n}\n\ninterface CachedPlan {\n planName: string;\n planTier: PlanTier;\n overrides: Partial<Record<ResourceName, number>>;\n fetchedAt: number;\n isFallback: boolean;\n fallbackReason?: 'clientless' | 'billing_error';\n}\n\n/**\n * Thrown when an entity create operation would push the user past the cap.\n * The matching GraphQL error has extensions.code = RESOURCE_CAP_EXCEEDED\n * so clients can detect and route to an upgrade flow.\n */\nexport class ResourceCapExceededError extends GraphQLError {\n constructor(detail: { resource: ResourceName; currentCount: number; limit: number; planName: string }) {\n super(\n `Resource cap exceeded for ${detail.resource}: ${detail.currentCount}/${detail.limit} on plan '${detail.planName}'.`,\n {\n extensions: {\n code: 'RESOURCE_CAP_EXCEEDED',\n userMessage: \"You've reached your plan limit. Upgrade your plan to continue.\",\n technicalMessage: `Resource cap exceeded for ${detail.resource}: ${detail.currentCount}/${detail.limit} on plan '${detail.planName}'.`,\n resource: detail.resource,\n currentCount: detail.currentCount,\n limit: detail.limit,\n planName: detail.planName,\n },\n }\n );\n this.name = 'ResourceCapExceededError';\n }\n}\n\n// ---------------------------------------------------------------------------\n// Module\n// ---------------------------------------------------------------------------\n\nconst PLAN_QUERY = /* GraphQL */ `\n query GetUserPlanForCaps($userId: ID!) {\n userBillingPlan(userId: $userId) {\n planName\n tier\n resourceCaps\n }\n }\n`;\n\ninterface PlanQueryResponse {\n userBillingPlan?: {\n planName?: string | null;\n tier?: string | null;\n resourceCaps?: Record<string, number> | null;\n } | null;\n}\n\ntype PlanNode = NonNullable<PlanQueryResponse['userBillingPlan']>;\n\nexport class ResourceCapsModule {\n private client?: BurdenoffGraphQLClient;\n private transport?: BillingPlanTransport;\n private cacheTtlMs: number;\n private clientlessTier: PlanTier;\n private billingFailureTier: PlanTier;\n private onFallback?: () => void;\n private onBillingFailure?: () => void;\n private warnedClientless = false;\n private readonly planCache = new Map<string, CachedPlan>();\n private readonly planResolutionCounter;\n private readonly enforcementCounter;\n\n constructor(config: ResourceCapsConfig = {}) {\n this.client = config.client;\n this.transport = config.transport;\n this.cacheTtlMs = config.cacheTtlMs ?? 60_000;\n this.clientlessTier = config.clientlessTier ?? 'free';\n this.billingFailureTier = config.billingFailureTier ?? 'paid';\n this.onFallback = config.onFallback;\n this.onBillingFailure = config.onBillingFailure;\n this.planResolutionCounter = createCounter(\n 'resource_caps.plan_resolution_total',\n 'Total number of billing plan resolutions for resource caps'\n );\n this.enforcementCounter = createCounter(\n 'resource_caps.enforcement_total',\n 'Total number of resource cap enforcement checks'\n );\n }\n\n /**\n * (Re)bind runtime dependencies on an already-constructed module. The SDK\n * bootstrap uses this to prime the process-wide singleton with a billing\n * transport even if an early caller already lazily created it clientless\n * (a bare `getResourceCaps(config)` ignores config once the instance exists).\n * Clears the plan cache so stale fallback entries don't linger.\n */\n configure(config: ResourceCapsConfig): void {\n if (config.client !== undefined) this.client = config.client;\n if (config.transport !== undefined) this.transport = config.transport;\n if (config.onFallback !== undefined) this.onFallback = config.onFallback;\n if (config.onBillingFailure !== undefined) this.onBillingFailure = config.onBillingFailure;\n if (typeof config.cacheTtlMs === 'number') this.cacheTtlMs = config.cacheTtlMs;\n if (config.clientlessTier) this.clientlessTier = config.clientlessTier;\n if (config.billingFailureTier) this.billingFailureTier = config.billingFailureTier;\n if (this.hasBillingSource()) this.warnedClientless = false;\n this.planCache.clear();\n }\n\n /** True when the module can actually reach billing (has a transport or client). */\n hasBillingSource(): boolean {\n return Boolean(this.transport || this.client);\n }\n\n /**\n * Resolve the cap for a given resource for the supplied user.\n * Order: plan-override → plan-tier-default → static free default.\n */\n async getResourceCap(userId: string, resource: ResourceName): Promise<ResourceCap> {\n if (!userId) {\n throw new Error('getResourceCap: userId is required');\n }\n const defaults = RESOURCE_CAP_DEFAULTS[resource];\n if (!defaults) {\n throw new Error(`getResourceCap: unknown resource '${resource}'`);\n }\n\n const plan = await this.resolvePlan(userId);\n const override = plan.overrides[resource];\n if (typeof override === 'number' && override >= 0) {\n return {\n resource,\n limit: override,\n planName: plan.planName,\n planTier: plan.planTier,\n isFallback: plan.isFallback,\n fallbackReason: plan.fallbackReason,\n };\n }\n\n const limit = plan.planTier === 'paid' ? defaults.paidDefault : defaults.free;\n return {\n resource,\n limit,\n planName: plan.planName,\n planTier: plan.planTier,\n isFallback: plan.isFallback,\n fallbackReason: plan.fallbackReason,\n };\n }\n\n /**\n * Throws ResourceCapExceededError when currentCount >= limit.\n * Use BEFORE the create transaction to avoid orphan rows.\n */\n async enforceResourceCap(userId: string, resource: ResourceName, currentCount: number): Promise<ResourceCap> {\n const cap = await this.getResourceCap(userId, resource);\n if (currentCount >= cap.limit) {\n this.enforcementCounter.inc({\n resource,\n plan_tier: cap.planTier,\n result: 'denied',\n });\n throw new ResourceCapExceededError({\n resource,\n currentCount,\n limit: cap.limit,\n planName: cap.planName,\n });\n }\n this.enforcementCounter.inc({\n resource,\n plan_tier: cap.planTier,\n result: 'allowed',\n });\n return cap;\n }\n\n /**\n * Resolve a workspace-scoped resource cap from the workspace's owner\n * organization plan, regardless of which actor triggered the action.\n *\n * @example\n * ```ts\n * const { limit } = await caps.getWorkspaceResourceCap(\n * { workspaceId: 'ws-1', organizationId: 'org-1' },\n * 'group'\n * );\n * ```\n */\n async getWorkspaceResourceCap(scope: WorkspaceResourceCapScope, resource: ResourceName): Promise<ResourceCap> {\n const { workspaceId, organizationId } = scope;\n if (!workspaceId) {\n throw new Error('getWorkspaceResourceCap: workspaceId is required');\n }\n if (!organizationId) {\n throw new Error('getWorkspaceResourceCap: organizationId is required');\n }\n const defaults = RESOURCE_CAP_DEFAULTS[resource];\n if (!defaults) {\n throw new Error(`getWorkspaceResourceCap: unknown resource '${resource}'`);\n }\n\n const plan = await this.resolvePlan(organizationId, this.workspaceCacheKey(workspaceId));\n const override = plan.overrides[resource];\n if (typeof override === 'number' && override >= 0) {\n return {\n resource,\n limit: override,\n planName: plan.planName,\n planTier: plan.planTier,\n isFallback: plan.isFallback,\n fallbackReason: plan.fallbackReason,\n };\n }\n\n const limit = plan.planTier === 'paid' ? defaults.paidDefault : defaults.free;\n return {\n resource,\n limit,\n planName: plan.planName,\n planTier: plan.planTier,\n isFallback: plan.isFallback,\n fallbackReason: plan.fallbackReason,\n };\n }\n\n /**\n * Throws ResourceCapExceededError when currentCount >= limit for a\n * workspace-scoped resource. The cap is resolved from the workspace owner's\n * organization plan, so the answer is stable across members.\n */\n async enforceWorkspaceResourceCap(\n scope: WorkspaceResourceCapScope,\n resource: ResourceName,\n currentCount: number\n ): Promise<ResourceCap> {\n const cap = await this.getWorkspaceResourceCap(scope, resource);\n if (currentCount >= cap.limit) {\n this.enforcementCounter.inc({\n resource,\n plan_tier: cap.planTier,\n result: 'denied',\n });\n throw new ResourceCapExceededError({\n resource,\n currentCount,\n limit: cap.limit,\n planName: cap.planName,\n });\n }\n this.enforcementCounter.inc({\n resource,\n plan_tier: cap.planTier,\n result: 'allowed',\n });\n return cap;\n }\n\n /** Invalidate cache for a user (e.g. after plan upgrade) */\n invalidate(userId: string): void {\n this.planCache.delete(userId);\n }\n\n /** Invalidate cache for a workspace (e.g. after workspace plan change) */\n invalidateWorkspace(workspaceId: string): void {\n this.planCache.delete(this.workspaceCacheKey(workspaceId));\n }\n\n /** Clear entire plan cache */\n invalidateAll(): void {\n this.planCache.clear();\n }\n\n // -------------------------------------------------------------------------\n // Internals\n // -------------------------------------------------------------------------\n\n private workspaceCacheKey(workspaceId: string): string {\n return `workspace:${workspaceId}`;\n }\n\n private async resolvePlan(userId: string, cacheKey?: string): Promise<CachedPlan> {\n const key = cacheKey ?? userId;\n const cached = this.planCache.get(key);\n if (cached && Date.now() - cached.fetchedAt < this.cacheTtlMs) {\n return cached;\n }\n\n const plan = await this.fetchPlan(userId);\n this.planCache.set(key, plan);\n return plan;\n }\n\n private async fetchPlan(userId: string): Promise<CachedPlan> {\n // No billing source wired → every cap silently collapses to the configured\n // clientless tier. Warn loudly (once) so an unwired/broken integration\n // can't hide in prod (BOFF-4805/4809).\n if (!this.hasBillingSource()) {\n this.warnClientlessOnce();\n this.planResolutionCounter.inc({ result: 'fallback', reason: 'clientless' });\n return this.fallbackPlan(this.clientlessTier, 'clientless');\n }\n try {\n const planNode = await this.fetchPlanNode(userId);\n if (!planNode) {\n logger.warn('resource-caps: plan lookup returned null; falling back to paid defaults', {\n userId,\n });\n this.onBillingFailure?.();\n this.planResolutionCounter.inc({ result: 'fallback', reason: 'billing_error' });\n return this.fallbackPlan(this.billingFailureTier, 'billing_error');\n }\n const tier = normaliseTier(planNode.tier, this.billingFailureTier);\n const overrides = sanitizeOverrides(planNode.resourceCaps);\n this.planResolutionCounter.inc({ result: 'billing' });\n return {\n planName: planNode.planName ?? (tier === 'paid' ? 'paid' : 'free'),\n planTier: tier,\n overrides,\n fetchedAt: Date.now(),\n isFallback: false,\n };\n } catch (err) {\n logger.warn('resource-caps: plan lookup failed; falling back to paid defaults', {\n err,\n userId,\n });\n this.onBillingFailure?.();\n this.planResolutionCounter.inc({ result: 'fallback', reason: 'billing_error' });\n return this.fallbackPlan(this.billingFailureTier, 'billing_error');\n }\n }\n\n /**\n * Resolve the raw `userBillingPlan` node via the injected transport (preferred)\n * or the legacy direct client. Guarded by {@link hasBillingSource} in the\n * caller, so at least one path is present here.\n */\n private async fetchPlanNode(userId: string): Promise<PlanNode | null> {\n if (this.transport) {\n const data = (await this.transport(PLAN_QUERY, { userId })) as PlanQueryResponse | null | undefined;\n return data?.userBillingPlan ?? null;\n }\n if (this.client) {\n const res = await this.client.query<PlanQueryResponse>(PLAN_QUERY, { userId });\n return res?.userBillingPlan ?? null;\n }\n return null;\n }\n\n private warnClientlessOnce(): void {\n if (this.warnedClientless) return;\n this.warnedClientless = true;\n logger.warn(\n 'resource-caps: running WITHOUT a billing transport/client — every resource cap will use the ' +\n 'free-tier fallback regardless of the customer plan. Ensure initializeBurdenoffSDK() ran with a ' +\n 'layer/gateway configured (BOFF-4805).'\n );\n this.onFallback?.();\n }\n\n private fallbackPlan(tier: PlanTier, reason: 'clientless' | 'billing_error'): CachedPlan {\n return {\n planName: tier === 'paid' ? 'fallback-paid' : 'fallback-free',\n planTier: tier,\n overrides: {},\n fetchedAt: Date.now(),\n isFallback: true,\n fallbackReason: reason,\n };\n }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction normaliseTier(raw: string | null | undefined, fallback: PlanTier): PlanTier {\n if (!raw) return fallback;\n const lc = raw.toLowerCase();\n if (lc === 'free' || lc === 'paid') return lc;\n // Treat anything non-free as paid (enterprise, business, pro, etc.)\n if (lc === 'enterprise' || lc === 'business' || lc === 'pro' || lc === 'team') {\n return 'paid';\n }\n return fallback;\n}\n\nfunction sanitizeOverrides(raw: Record<string, number> | null | undefined): Partial<Record<ResourceName, number>> {\n if (!raw || typeof raw !== 'object') return {};\n const out: Partial<Record<ResourceName, number>> = {};\n for (const [key, value] of Object.entries(raw)) {\n if (key in RESOURCE_CAP_DEFAULTS && typeof value === 'number' && Number.isFinite(value)) {\n out[key as ResourceName] = Math.max(0, Math.floor(value));\n }\n }\n return out;\n}\n\n// ---------------------------------------------------------------------------\n// Convenience singleton\n// ---------------------------------------------------------------------------\n\nlet defaultInstance: ResourceCapsModule | null = null;\n\n/**\n * Obtain a process-wide singleton. The first call binds the GraphQL client\n * (typically the SDK's internal client). Later calls return the same instance.\n */\nexport function getResourceCaps(config?: ResourceCapsConfig): ResourceCapsModule {\n if (!defaultInstance) {\n defaultInstance = new ResourceCapsModule(config);\n } else if (config) {\n // Previously the config was silently dropped once the singleton existed —\n // the root cause of BOFF-4805 where the billing client could never be bound\n // after a lazy first construction. Apply it instead.\n defaultInstance.configure(config);\n }\n return defaultInstance;\n}\n\n/**\n * Prime/rebind the process-wide singleton with billing connectivity. Call once\n * during SDK bootstrap. Unlike a bare `getResourceCaps(config)` on a fresh\n * process, this is explicit about the intent to (re)wire and is safe to call\n * after the singleton was already lazily created clientless.\n */\nexport function configureResourceCaps(config: ResourceCapsConfig): ResourceCapsModule {\n const instance = getResourceCaps();\n instance.configure(config);\n return instance;\n}\n\n/** Reset the singleton (for tests) */\nexport function __resetResourceCapsForTests(): void {\n defaultInstance = null;\n}\n"]}
package/dist/{chunk-WW6P2S6L.js → chunk-Z3O32BW6.js} RENAMED
@@ -1,4 +1,4 @@
1
- import { updateInstrumentationConfig, resetMetricsRegistry, resetInstrumentationConfig, isMetricsRegistryInitialized, isInstrumentationConfigInitialized, isFeatureEnabled, initializeMetricsRegistry, initializeInstrumentationConfig, getMetricsRegistry, getInstrumentationConfig, createUpDownCounter, createHistogram, createGauge, createCounter, buildTracingConfig, buildMetricsConfig, buildInstrumentationConfig, buildGraphQLConfig, buildFeatureFlags, buildDatabaseConfig, MetricsRegistry, ENV_VARS, DEFAULT_TRACING_CONFIG, DEFAULT_METRICS_CONFIG, DEFAULT_LOGGING_CONFIG, DEFAULT_HTTP_CONFIG, DEFAULT_GRAPHQL_CONFIG, DEFAULT_FEATURE_FLAGS, DEFAULT_EVENT_QUEUE_CONFIG, DEFAULT_DATABASE_CONFIG, DEFAULT_CACHE_CONFIG } from './chunk-Q6UAOZFZ.js';
1
+ import { updateInstrumentationConfig, resetMetricsRegistry, resetInstrumentationConfig, isMetricsRegistryInitialized, isInstrumentationConfigInitialized, isFeatureEnabled, initializeMetricsRegistry, initializeInstrumentationConfig, getMetricsRegistry, getInstrumentationConfig, createUpDownCounter, createHistogram, createGauge, createCounter, buildTracingConfig, buildMetricsConfig, buildInstrumentationConfig, buildGraphQLConfig, buildFeatureFlags, buildDatabaseConfig, MetricsRegistry, ENV_VARS, DEFAULT_TRACING_CONFIG, DEFAULT_METRICS_CONFIG, DEFAULT_LOGGING_CONFIG, DEFAULT_HTTP_CONFIG, DEFAULT_GRAPHQL_CONFIG, DEFAULT_FEATURE_FLAGS, DEFAULT_EVENT_QUEUE_CONFIG, DEFAULT_DATABASE_CONFIG, DEFAULT_CACHE_CONFIG } from './chunk-AWPNRV3L.js';
2
2
  import { logger } from './chunk-CBZNP6RF.js';
3
3
  import { __export, __name } from './chunk-XE4OXN2W.js';
4
4
  import { createRequire } from 'module';
@@ -1620,5 +1620,5 @@ function setupInstrumentation(serviceName, options) {
1620
1620
  __name(setupInstrumentation, "setupInstrumentation");
1621
1621
 
1622
1622
  export { Instrument, Log, Metric, STANDARD_METRICS, SpanKind, SpanStatus, Trace, Tracer, createApolloInlineTracePlugin, createGraphQLInstrumentationPlugin, createPrometheusPlugin, extractOperationInfo, extractTraceContext, getGraphQLOperationFromContext, getGraphQLSpanFromContext, getLogger, getTraceContext, getTracer, initializeInstrumentation, initializeTracer, injectTraceContext, instrumentResolver, instrumentResolverMap, instrumentation_exports, instrumented, isApolloInlineTraceAvailable, isInstrumentationInitialized, isPrometheusAvailable, isTracerInitialized, resetInstrumentation, setActiveTelemetryLogger, setupInstrumentation, startSpan, traced, withSpan };
1623
- //# sourceMappingURL=chunk-WW6P2S6L.js.map
1624
- //# sourceMappingURL=chunk-WW6P2S6L.js.map
1623
+ //# sourceMappingURL=chunk-Z3O32BW6.js.map
1624
+ //# sourceMappingURL=chunk-Z3O32BW6.js.map