Registry / devops / ai-localize-core

ai-localize-core

JSON →
library1.0.0jsnpmunverified

Enterprise-grade deterministic localization and CloudFront migration platform v1.0.0. Synchronizes i18n assets across CDN while providing source-of-truth conflict resolution. Key differentiators include immutability-by-default, probabilistic cache invalidation simulation, and an AI-driven translation memory module. Requires Node >=18, pnpm >=8. Uses ESM-only distribution, no CommonJS support.

devops
npm install ai-localize-core
package ↗
INSTALL
IMPORT
SIG · AI-LOCALIZE-CORE
A
ai-localize-core
devopsjavascriptv1.0.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

localize
✓ import { localize } from 'ai-localize-core'
✗ const { localize } = require('ai-localize-core')
ESM-only module; CommonJS require will produce a runtime error.
CloudFrontSync
✓ import { CloudFrontSync } from 'ai-localize-core'
✗ import CloudFrontSync from 'ai-localize-core'
CloudFrontSync is a named export, not a default export.
ConflictResolver
✓ import { ConflictResolver } from 'ai-localize-core'
Class export, no default export equivalent.

Shows basic setup of CloudFrontSync with AWS credentials and syncing a French locale string.

import { localize, CloudFrontSync } from 'ai-localize-core'; const cfSync = new CloudFrontSync({ distributionId: process.env.CLOUDFRONT_DISTRIBUTION_ID ?? '', accessKeyId: process.env.AWS_ACCESS_KEY_ID ?? '', secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY ?? '', region: 'us-east-1' }); const result = await cfSync.sync({ locale: 'fr-FR', content: { greeting: 'Bonjour le monde' }, strategy: 'deterministic' }); console.log(result); // { status: 'synced', etag: 'abc123' }
Debug
Known issues
breakingPackage is ESM-only, no CommonJS support. Using require() throws error.
fix
Use import syntax and ensure package.json has 'type': 'module' or .mjs extension.
affects: >=1.0.0
deprecatedv1.0.0 uses deprecated 'resolve' parameter in ConflictResolver constructor; will be removed in v2.
fix
Pass conflict resolution strategy via the 'strategy' option in the sync call instead.
affects: 1.0.0
gotchaCloudFront distributionId is required; missing it causes silent failure (returns null).
fix
Always supply distributionId or set environment variable CLOUDFRONT_DISTRIBUTION_ID.
affects: >=1.0.0
gotchaAI translation memory module requires a running Redis instance for cache persistence; default config may cause session data loss.
fix
Set REDIS_URL environment variable or pass redisConfig in LocalizeOptions.
affects: >=1.0.0
Errors
Common errors & fixes
TypeError: ai_localize_core_1.CloudFrontSync is not a constructor
Using CommonJS require() which does not resolve named export correctly.
fix
Switch to ESM import statement: import { CloudFrontSync } from 'ai-localize-core'
Error: ESM modules are not supported in this runtime. Consider enabling '--experimental-modules' flag.
Running with older Node.js (<18) that does not support ESM natively.
fix
Upgrade Node.js to version 18.0.0 or later.
Error: Redis connection failed. Please check REDIS_URL environment variable.
AI translation module attempts to connect to Redis on startup but missing configuration.
fix
Set REDIS_URL environment variable or pass redisConfig in options.
Upgrade
Version history
1.0.0latest on npm
Audit
Dependencies
ai-localize-utilsrequiredCore AI translation memory and diff algorithms
node-fetchoptionalHTTP client for CloudFront API calls
Agent activity
34 hits · last 30 days
node
32
OpenAI (training)
1
Resources
packageai-localize-core ↗
ai-localize-core — npm install ai-localize-core · libregistry