@intlayer/ai 7.3.0-canary.0

package/dist/esm/utils/extractJSON.mjs

@@ -0,0 +1,60 @@
+//#region src/utils/extractJSON.ts
+/**
+* Extracts and parses the first valid JSON value (object or array) from a string containing arbitrary text.
+* This is used to safely extract JSON from LLM responses that may contain additional text or markdown.
+*
+* @example
+* // Extracts JSON object from markdown response:
+* ```json
+* {
+*   "title": "Test content declarations",
+*   "description": "A comprehensive test dictionary...",
+*   "tags": ["test tag"]
+* }
+* ```
+*
+* @example
+* // Extracts JSON array:
+* ```json
+* ["item1", "item2", "item3"]
+* ```
+*
+* @example
+* // Extracts JSON from markdown:
+* Here is the response:
+* ```json
+* {"key": "value"}
+* ```
+* End of response.
+*
+* @throws {Error} If no valid JSON object/array is found or if parsing fails
+* @returns {T} The parsed JSON value cast to type T
+*/
+const extractJson = (input) => {
+	const opening = input.match(/[{[]/);
+	if (!opening) throw new Error("No JSON start character ({ or [) found.");
+	const startIdx = opening.index;
+	const openChar = input[startIdx];
+	const closeChar = openChar === "{" ? "}" : "]";
+	let depth = 0;
+	for (let i = startIdx; i < input.length; i++) {
+		const char = input[i];
+		if (char === openChar) depth++;
+		else if (char === closeChar) {
+			depth--;
+			if (depth === 0) {
+				const jsonSubstring = input.slice(startIdx, i + 1);
+				try {
+					return JSON.parse(jsonSubstring);
+				} catch (err) {
+					throw new Error(`Failed to parse JSON: ${err.message}`);
+				}
+			}
+		}
+	}
+	throw new Error("Reached end of input without closing JSON bracket.");
+};
+
+//#endregion
+export { extractJson };
+//# sourceMappingURL=extractJSON.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractJSON.mjs","names":[],"sources":["../../../src/utils/extractJSON.ts"],"sourcesContent":["/**\n * Extracts and parses the first valid JSON value (object or array) from a string containing arbitrary text.\n * This is used to safely extract JSON from LLM responses that may contain additional text or markdown.\n *\n * @example\n * // Extracts JSON object from markdown response:\n * ```json\n * {\n *   \"title\": \"Test content declarations\",\n *   \"description\": \"A comprehensive test dictionary...\",\n *   \"tags\": [\"test tag\"]\n * }\n * ```\n *\n * @example\n * // Extracts JSON array:\n * ```json\n * [\"item1\", \"item2\", \"item3\"]\n * ```\n *\n * @example\n * // Extracts JSON from markdown:\n * Here is the response:\n * ```json\n * {\"key\": \"value\"}\n * ```\n * End of response.\n *\n * @throws {Error} If no valid JSON object/array is found or if parsing fails\n * @returns {T} The parsed JSON value cast to type T\n */\nexport const extractJson = <T = any>(input: string): T => {\n  const opening = input.match(/[{[]/);\n  if (!opening) throw new Error('No JSON start character ({ or [) found.');\n\n  const startIdx = opening.index!;\n  const openChar = input[startIdx];\n  const closeChar = openChar === '{' ? '}' : ']';\n  let depth = 0;\n\n  for (let i = startIdx; i < input.length; i++) {\n    const char = input[i];\n    if (char === openChar) depth++;\n    else if (char === closeChar) {\n      depth--;\n      if (depth === 0) {\n        const jsonSubstring = input.slice(startIdx, i + 1);\n        try {\n          return JSON.parse(jsonSubstring) as T;\n        } catch (err) {\n          throw new Error(`Failed to parse JSON: ${(err as Error).message}`);\n        }\n      }\n    }\n  }\n\n  throw new Error('Reached end of input without closing JSON bracket.');\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,eAAwB,UAAqB;CACxD,MAAM,UAAU,MAAM,MAAM,OAAO;AACnC,KAAI,CAAC,QAAS,OAAM,IAAI,MAAM,0CAA0C;CAExE,MAAM,WAAW,QAAQ;CACzB,MAAM,WAAW,MAAM;CACvB,MAAM,YAAY,aAAa,MAAM,MAAM;CAC3C,IAAI,QAAQ;AAEZ,MAAK,IAAI,IAAI,UAAU,IAAI,MAAM,QAAQ,KAAK;EAC5C,MAAM,OAAO,MAAM;AACnB,MAAI,SAAS,SAAU;WACd,SAAS,WAAW;AAC3B;AACA,OAAI,UAAU,GAAG;IACf,MAAM,gBAAgB,MAAM,MAAM,UAAU,IAAI,EAAE;AAClD,QAAI;AACF,YAAO,KAAK,MAAM,cAAc;aACzB,KAAK;AACZ,WAAM,IAAI,MAAM,yBAA0B,IAAc,UAAU;;;;;AAM1E,OAAM,IAAI,MAAM,qDAAqD"}

package/dist/types/aiSdk.d.ts

@@ -0,0 +1,61 @@
+import { anthropic } from "@ai-sdk/anthropic";
+import { deepseek } from "@ai-sdk/deepseek";
+import { google } from "@ai-sdk/google";
+import { mistral } from "@ai-sdk/mistral";
+import { openai } from "@ai-sdk/openai";
+import { AssistantModelMessage, SystemModelMessage, ToolModelMessage, UserModelMessage, generateText } from "ai";
+
+//#region src/aiSdk.d.ts
+type AnthropicModel = Parameters<typeof anthropic>[0];
+type DeepSeekModel = Parameters<typeof deepseek>[0];
+type MistralModel = Parameters<typeof mistral>[0];
+type OpenAIModel = Parameters<typeof openai>[0];
+type GoogleModel = Parameters<typeof google>[0];
+type Messages = (SystemModelMessage | UserModelMessage | AssistantModelMessage | ToolModelMessage)[];
+/**
+ * Supported AI models
+ */
+type Model = AnthropicModel | DeepSeekModel | MistralModel | OpenAIModel | GoogleModel | (string & {});
+/**
+ * Supported AI SDK providers
+ */
+declare enum AIProvider {
+  OPENAI = "openai",
+  ANTHROPIC = "anthropic",
+  MISTRAL = "mistral",
+  DEEPSEEK = "deepseek",
+  GEMINI = "gemini",
+}
+/**
+ * Common options for all AI providers
+ */
+type AIOptions = {
+  provider?: AIProvider;
+  model?: Model;
+  temperature?: number;
+  apiKey?: string;
+  applicationContext?: string;
+};
+type ChatCompletionRequestMessage = {
+  role: 'system' | 'user' | 'assistant';
+  content: string;
+  timestamp?: Date;
+};
+type AccessType = 'apiKey' | 'registered_user' | 'premium_user' | 'public';
+type AIConfig = Omit<Parameters<typeof generateText>[0], 'prompt'>;
+type AIConfigOptions = {
+  userOptions?: AIOptions;
+  defaultOptions?: AIOptions;
+  accessType?: AccessType[];
+};
+/**
+ * Get AI model configuration based on the selected provider and options
+ * This function handles the configuration for different AI providers
+ *
+ * @param options Configuration options including provider, API keys, models and temperature
+ * @returns Configured AI model ready to use with generateText
+ */
+declare const getAIConfig: (options: AIConfigOptions, isAuthenticated?: boolean) => Promise<AIConfig>;
+//#endregion
+export { AIConfig, AIConfigOptions, AIOptions, AIProvider, ChatCompletionRequestMessage, Messages, Model, getAIConfig };
+//# sourceMappingURL=aiSdk.d.ts.map

package/dist/types/aiSdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSdk.d.ts","names":[],"sources":["../../src/aiSdk.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAaK,cAAA,GAAiB,kBAAkB;KACnC,aAAA,GAAgB,kBAAkB;AAH3B,KAIP,YAAA,GAAe,UAFD,CAAA,OAEmB,OAFhB,CAAA,CAAA,CAAA,CAAA;AAAU,KAG3B,WAAA,GAAc,UAFD,CAAA,OAEmB,MAFhB,CAAA,CAAA,CAAA,CAAA;AAAU,KAG1B,WAAA,GAAc,UAFF,CAAqB,OAED,MAFjB,CAAA,CAAA,CAAA,CAAA;AACf,KAGO,QAAA,GAHI,CAIZ,kBAJe,GAKf,gBALyB,GAMzB,qBANyB,GAOzB,gBAPyB,CAAA,EAAA;AAAA;AAG7B;;AAEI,KAQQ,KAAA,GACR,cATA,GAUA,aAVA,GAWA,YAXA,GAYA,WAZA,GAaA,WAbA,GAAA,CAAA,MAAA,GAAA,CAAA,CAAA,CAAA;;;;AAQQ,aAWA,UAAA;EAVR,MAAA,GAAA,QAAA;EACA,SAAA,GAAA,WAAA;EACA,OAAA,GAAA,SAAA;EACA,QAAA,GAAA,UAAA;EACA,MAAA,GAAA,QAAA;;AAMJ;AAWA;AASA;AAMK,KAfO,SAAA,GAeG;EAiEH,QAAA,CAAA,EA/EC,UA+EO;EAA0B,KAAA,CAAA,EA9EpC,KA8EoC;EAAlB,WAAA,CAAA,EAAA,MAAA;EAAL,MAAA,CAAA,EAAA,MAAA;EAAI,kBAAA,CAAA,EAAA,MAAA;AAK3B,CAAA;AACgB,KA7EJ,4BAAA,GA6EI;EACG,IAAA,EAAA,QAAA,GAAA,MAAA,GAAA,WAAA;EACJ,OAAA,EAAA,MAAA;EAAU,SAAA,CAAA,EA5EX,IA4EW;AAUzB,CAAA;KAnFK,UAAA,GAoFM,QAAA,GAAA,iBAAA,GAAA,cAAA,GAAA,QAAA;AAEA,KArBC,QAAA,GAAW,IAqBZ,CArBiB,UAqBjB,CAAA,OArBmC,YAqBnC,CAAA,CAAA,CAAA,CAAA,EAAA,QAAA,CAAA;AAAR,KAhBS,eAAA,GAgBT;EAAO,WAAA,CAAA,EAfM,SAeN;mBAdS;eACJ;;;;;;;;;cAUF,uBACF,+CAER,QAAQ"}

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

@@ -0,0 +1,36 @@
+import { AIConfig, AIOptions } from "../aiSdk.js";
+
+//#region src/auditDictionaryMetadata/index.d.ts
+type Tag = {
+  key: string;
+  description?: string;
+};
+type AuditDictionaryMetadataOptions = {
+  fileContent: string;
+  tags?: Tag[];
+  aiConfig: AIConfig;
+  applicationContext?: string;
+};
+type AuditFileResultData = {
+  fileContent: {
+    title: string;
+    description: string;
+    tags: string[];
+  };
+  tokenUsed: number;
+};
+declare const aiDefaultOptions: AIOptions;
+/**
+ * Audits a content declaration file by constructing a prompt for AI models.
+ * The prompt includes details about the project's locales, file paths of content declarations,
+ * and requests for identifying issues or inconsistencies.
+ */
+declare const auditDictionaryMetadata: ({
+  fileContent,
+  tags,
+  aiConfig,
+  applicationContext
+}: AuditDictionaryMetadataOptions) => Promise<AuditFileResultData | undefined>;
+//#endregion
+export { AuditDictionaryMetadataOptions, AuditFileResultData, aiDefaultOptions, auditDictionaryMetadata };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/auditDictionaryMetadata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/auditDictionaryMetadata/index.ts"],"sourcesContent":[],"mappings":";;;KAKK,GAAA;;EAAA,WAAG,CAAA,EAAA,MAAA;AAKR,CAAA;AAOY,KAPA,8BAAA,GAOmB;EASlB,WAAA,EAAA,MAEZ;EAOY,IAAA,CAAA,EAvBJ,GAuBI,EAAA;EAAiC,QAAA,EAtBlC,QAsBkC;EAAA,kBAAA,CAAA,EAAA,MAAA;CAAA;AAAA,KAlBlC,mBAAA,GAkBkC;EAK3C,WAAA,EAAA;IACD,KAAA,EAAA,MAAA;IADkC,WAAA,EAAA,MAAA;IAAO,IAAA,EAAA,MAAA,EAAA;;;;cAd9B,kBAAkB;;;;;;cASlB;;;;;GAKV,mCAAiC,QAClC"}

package/dist/types/customQuery.d.ts

@@ -0,0 +1,24 @@
+import { AIConfig, AIOptions, Messages } from "./aiSdk.js";
+
+//#region src/customQuery.d.ts
+type CustomQueryOptions = {
+  messages: Messages;
+  aiConfig: AIConfig;
+};
+type CustomQueryResultData = {
+  fileContent: string;
+  tokenUsed: number;
+};
+declare const aiDefaultOptions: AIOptions;
+/**
+ * CustomQuery a content declaration file by constructing a prompt for AI models.
+ * The prompt includes details about the project's locales, file paths of content declarations,
+ * and requests for identifying issues or inconsistencies.
+ */
+declare const customQuery: ({
+  messages,
+  aiConfig
+}: CustomQueryOptions) => Promise<CustomQueryResultData | undefined>;
+//#endregion
+export { CustomQueryOptions, CustomQueryResultData, aiDefaultOptions, customQuery };
+//# sourceMappingURL=customQuery.d.ts.map

package/dist/types/customQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customQuery.d.ts","names":[],"sources":["../../src/customQuery.ts"],"sourcesContent":[],"mappings":";;;KAGY,kBAAA;YACA;EADA,QAAA,EAEA,QAFA;AAKZ,CAAA;AAKa,KALD,qBAAA,GAKmB;EAUlB,WAAA,EAAA,MAcZ;EAdiC,SAAA,EAAA,MAAA;CAAA;AAG/B,cAbU,gBAaV,EAb4B,SAa5B;;;;;;cAHU;;;GAGV,uBAAqB,QAAQ"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+import { AIConfig, AIConfigOptions, AIOptions, AIProvider, ChatCompletionRequestMessage, Messages, Model, getAIConfig } from "./aiSdk.js";
+import { AuditDictionaryMetadataOptions, AuditFileResultData, auditDictionaryMetadata } from "./auditDictionaryMetadata/index.js";
+import { CustomQueryOptions, CustomQueryResultData, customQuery } from "./customQuery.js";
+import { TranslateJSONOptions, TranslateJSONResultData, translateJSON } from "./translateJSON/index.js";
+import { extractJson } from "./utils/extractJSON.js";
+import { generateText, streamText } from "ai";
+export { AIConfig, AIConfigOptions, AIOptions, AIProvider, type AuditDictionaryMetadataOptions, type AuditFileResultData, ChatCompletionRequestMessage, type CustomQueryOptions, type CustomQueryResultData, Messages, Model, type TranslateJSONOptions, type TranslateJSONResultData, auditDictionaryMetadata, customQuery, extractJson, generateText, getAIConfig, streamText, translateJSON };

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

@@ -0,0 +1,43 @@
+import { AIConfig, AIOptions } from "../aiSdk.js";
+import { Locale } from "@intlayer/types";
+
+//#region src/translateJSON/index.d.ts
+type Tag = {
+  key: string;
+  description?: string;
+};
+type TranslateJSONOptions = {
+  entryFileContent: JSON;
+  presetOutputContent: JSON;
+  dictionaryDescription?: string;
+  entryLocale: Locale;
+  outputLocale: Locale;
+  tags?: Tag[];
+  aiConfig: AIConfig;
+  mode: 'complete' | 'review';
+  applicationContext?: string;
+};
+type TranslateJSONResultData = {
+  fileContent: string;
+  tokenUsed: number;
+};
+declare const aiDefaultOptions: AIOptions;
+/**
+ * TranslateJSONs a content declaration file by constructing a prompt for AI models.
+ * The prompt includes details about the project's locales, file paths of content declarations,
+ * and requests for identifying issues or inconsistencies.
+ */
+declare const translateJSON: ({
+  entryFileContent,
+  presetOutputContent,
+  dictionaryDescription,
+  aiConfig,
+  entryLocale,
+  outputLocale,
+  tags,
+  mode,
+  applicationContext
+}: TranslateJSONOptions) => Promise<TranslateJSONResultData | undefined>;
+//#endregion
+export { TranslateJSONOptions, TranslateJSONResultData, aiDefaultOptions, translateJSON };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/translateJSON/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":[],"mappings":";;;;KAOK,GAAA;;EAAA,WAAG,CAAA,EAAA,MAAA;AAKR,CAAA;AACoB,KADR,oBAAA,GACQ;EACG,gBAAA,EADH,IACG;EAER,mBAAA,EAFQ,IAER;EACC,qBAAA,CAAA,EAAA,MAAA;EACP,WAAA,EAFM,MAEN;EACG,YAAA,EAFI,MAEJ;EAAQ,IAAA,CAAA,EADX,GACW,EAAA;EAKR,QAAA,EALA,QAKA;EAKC,IAAA,EAAA,UAAA,GAGZ,QAAA;EA0CY,kBA0CZ,CAAA,EAAA,MAAA;CA1CmC;AAAA,KAlDxB,uBAAA,GAkDwB;EAAA,WAAA,EAAA,MAAA;EAAA,SAAA,EAAA,MAAA;CAAA;AAAA,cA7CvB,gBA6CuB,EA7CL,SA6CK;;;;;;AAUV,cAVb,aAUa,EAAA,CAAA;EAAA,gBAAA;EAAA,mBAAA;EAAA,qBAAA;EAAA,QAAA;EAAA,WAAA;EAAA,YAAA;EAAA,IAAA;EAAA,IAAA;EAAA;AAAA,CAAA,EAAvB,oBAAuB,EAAA,GAAA,OAAA,CAAQ,uBAAR,GAAA,SAAA,CAAA"}

package/dist/types/utils/extractJSON.d.ts

@@ -0,0 +1,36 @@
+//#region src/utils/extractJSON.d.ts
+/**
+ * Extracts and parses the first valid JSON value (object or array) from a string containing arbitrary text.
+ * This is used to safely extract JSON from LLM responses that may contain additional text or markdown.
+ *
+ * @example
+ * // Extracts JSON object from markdown response:
+ * ```json
+ * {
+ *   "title": "Test content declarations",
+ *   "description": "A comprehensive test dictionary...",
+ *   "tags": ["test tag"]
+ * }
+ * ```
+ *
+ * @example
+ * // Extracts JSON array:
+ * ```json
+ * ["item1", "item2", "item3"]
+ * ```
+ *
+ * @example
+ * // Extracts JSON from markdown:
+ * Here is the response:
+ * ```json
+ * {"key": "value"}
+ * ```
+ * End of response.
+ *
+ * @throws {Error} If no valid JSON object/array is found or if parsing fails
+ * @returns {T} The parsed JSON value cast to type T
+ */
+declare const extractJson: <T = any>(input: string) => T;
+//#endregion
+export { extractJson };
+//# sourceMappingURL=extractJSON.d.ts.map

package/dist/types/utils/extractJSON.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractJSON.d.ts","names":[],"sources":["../../../src/utils/extractJSON.ts"],"sourcesContent":[],"mappings":";;AA+BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,yCAAwC"}

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@intlayer/ai",
+  "version": "7.3.0-canary.0",
+  "private": false,
+  "description": "SDK that provides AI capabilities for Intlayer applications",
+  "keywords": [
+    "intlayer",
+    "application",
+    "ai",
+    "backend",
+    "i18n",
+    "internationalization"
+  ],
+  "homepage": "https://intlayer.org",
+  "bugs": {
+    "url": "https://github.com/aymericzip/intlayer/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aymericzip/intlayer.git"
+  },
+  "license": "Apache-2.0",
+  "author": {
+    "name": "Aymeric PINEAU",
+    "url": "https://github.com/aymericzip"
+  },
+  "contributors": [
+    {
+      "name": "Aymeric Pineau",
+      "email": "ay.pineau@gmail.com",
+      "url": "https://github.com/aymericzip"
+    }
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/cjs/index.cjs",
+      "import": "./dist/esm/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.mjs",
+  "types": "dist/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "package.json": [
+        "./package.json"
+      ]
+    }
+  },
+  "files": [
+    "./dist",
+    "./package.json"
+  ],
+  "scripts": {
+    "build": "tsdown --config tsdown.config.ts",
+    "build:ci": "tsdown --config tsdown.config.ts",
+    "clean": "rimraf ./dist .turbo",
+    "dev": "tsdown --config tsdown.config.ts --watch",
+    "format": "biome format . --check",
+    "format:fix": "biome format --write .",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "prepublish": "cp -f ../../../README.md ./README.md",
+    "publish": "bun publish || true",
+    "publish:canary": "bun publish --access public --tag canary || true",
+    "publish:latest": "bun publish --access public --tag latest || true",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit --project tsconfig.types.json"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "2.0.45",
+    "@ai-sdk/deepseek": "1.0.29",
+    "@ai-sdk/google": "2.0.40",
+    "@ai-sdk/mistral": "2.0.24",
+    "@ai-sdk/openai": "2.0.71",
+    "@intlayer/api": "7.3.0-canary.0",
+    "@intlayer/config": "7.3.0-canary.0",
+    "@intlayer/core": "7.3.0-canary.0",
+    "@intlayer/types": "7.3.0-canary.0",
+    "ai": "5.0.98"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "@utils/ts-config": "1.0.4",
+    "@utils/ts-config-types": "1.0.4",
+    "@utils/tsdown-config": "1.0.4",
+    "rimraf": "6.1.2",
+    "tsdown": "0.16.6",
+    "typescript": "5.9.3",
+    "vitest": "4.0.13"
+  },
+  "engines": {
+    "node": ">=14.18"
+  },
+  "bug": {
+    "url": "https://github.com/aymericzip/intlayer/issues"
+  }
+}