@cocreate/cli 1.59.0 → 1.62.0

package/src/commands/other/translate.js

@@ -1,147 +1,145 @@
+const { GoogleGenAI, Type } = require("@google/genai");
+const Config = require("@cocreate/config");
+
 /**
- * @fileoverview
- * This script is designed to generate SEO-friendly content for a given HTML source.
- * It uses the Gemini API to translate and generate content based on the provided HTML and languages.
- *
- * Prerequisites:
- * - Node.js installed on your system.
- * - The Google Generative AI library installed:
- * `npm install @google/generative-ai`
- * - A valid Gemini API key.
- *
- * Usage:
- * Import and call the `translateHtml` function with the HTML source, languages array, and options.
+ * Default Gemini model identifier used for language translation tasks.
+ * @type {string}
  */
+const DEFAULT_MODEL = "gemini-2.5-flash-lite";
 
 /**
- * Example for structured data translation:
- *
- * {
- *   "selector": "script[type='application/ld+json']",
- *   "innerHTML": {
- *     "en": {
- *       "@context": "http://schema.org",
- *       "@type": "WebPage",
- *       "name": "Basketball Betting Sportsbook | NBA, EuroLeague, NCAA & Global Leagues",
- *       "description": "Unlock premier basketball betting at Amapola Sportsbook. Get competitive odds for NBA, EuroLeague, NCAA, and global basketball. Enjoy live betting, swift payouts, and insightful picks for an unmatched wagering experience.",
- *       "url": "https://amapolacasino.com/sportsbook/basketball/",
- *       "image": "https://amapolacasino.com/assets/basketball-og.jpg",
- *       "author": {
- *         "@type": "Organization",
- *         "name": "AmapolaCasino"
- *       }
- *     },
- *     "es": { ... },
- *     "fr": { ... },
- *     "pt": { ... },
- *     "ht": { ... },
- *     "nl": { ... },
- *     "gn": { ... }
- *   }
- * }
+ * Translation mapping for a single element's attributes and inner content.
+ * @typedef {Object} ElementTranslations
+ * @property {string|null} [text] - Inner text content or script payload.
+ * @property {string|null} [placeholder] - Input placeholder text.
+ * @property {string|null} [title] - Element title attribute.
+ * @property {string|null} [alt] - Image alternate text.
+ * @property {string|null} ["aria-label"] - ARIA accessibility label.
+ * @property {Record<string, string>} [additionalProperties] - Dynamic attributes (e.g., `aria-description`).
  */
 
-const { GoogleGenerativeAI } = require("@google/generative-ai");
-const Config = require("@cocreate/config");
-const MODEL_NAME = "gemini-2.5-flash-lite";
+/**
+ * Key-value mapping of `i18n` keys to element translations for a specific language.
+ * @typedef {Record<string, ElementTranslations>} LanguageTranslations
+ */
 
-// Send HTML to Gemini AI and get translation JSON
-// Exported function to generate translation object for HTML source and languages
+/**
+ * Language-First dictionary structure mapping language codes (e.g., "en", "es") to their translations.
+ * @typedef {Record<string, LanguageTranslations>} LanguageFirstTranslationMap
+ */
+
+/**
+ * Configuration options for the HTML translation process.
+ * @typedef {Object} TranslateOptions
+ * @property {string} [apiKey] - Google GenAI API key. If omitted, attempts lookup via configuration service.
+ * @property {string} [model] - Gemini model name override (defaults to "gemini-2.5-flash-lite").
+ * @property {number} [temperature] - Model sampling temperature (defaults to 0.2).
+ */
+
+/**
+ * Resolves the Google GenAI API key from explicit options or global configuration.
+ *
+ * @async
+ * @param {TranslateOptions} options - Configuration options passed to the translator.
+ * @returns {Promise<string|undefined>} Resolved API key string or undefined if not found.
+ */
 async function getApiKey(options) {
-	if (options.apiKey) return options.apiKey;
-	const config = await Config.prompt({
-		GoogleGenerativeAIApiKey: {
-			prompt: "Enter your Google Generative AI API key: "
-		}
-	});
-	return config.GoogleGenerativeAIApiKey;
+  if (options?.apiKey) return options.apiKey;
+  if (typeof Config?.get === "function") {
+    return await Config.get("GEMINI_API_KEY") || process.env.GEMINI_API_KEY;
+  }
+  return process.env.GEMINI_API_KEY;
 }
 
+/**
+ * Analyzes HTML source code, extracts `i18n` elements and `<script type="application/ld+json">` data,
+ * and uses Google GenAI to synthesize a Language-First JSON translation dictionary.
+ * 
+ * @async
+ * @param {string} html - Raw HTML source code string containing elements with `i18n` attributes.
+ * @param {string[]} languages - Array of target language codes (e.g., `["en", "es", "fr"]`).
+ * @param {TranslateOptions} [options={}] - Optional configuration parameters for model and authentication.
+ * @returns {Promise<LanguageFirstTranslationMap|null>} Language-First translation map, or `null` if generation fails.
+ * @throws {Error} Throws an error if no API key is provided or resolved.
+ *
+ * @example
+ * const translations = await translateHtml(
+ *   '<h1 i18n="heading">Hello</h1><input i18n="search" placeholder="Search...">',
+ *   ["es", "fr"]
+ * );
+ */
 module.exports = async function translateHtml(html, languages, options = {}) {
-	const apiKey = await getApiKey(options);
-	if (!apiKey)
-		throw new Error(
-			"Google Generative AI API key is required in options.apiKey, process.env, or via prompt."
-		);
-	const genAI = new GoogleGenerativeAI(apiKey);
-	const model =
-		options.model || genAI.getGenerativeModel({ model: MODEL_NAME });
-	const translationObj = await generateTranslationObject(
-		html,
-		model,
-		languages
-	);
-	return translationObj;
-};
-
-// Update generateTranslationObject to accept only html, model, languages
-async function generateTranslationObject(html, model, languages) {
-	const langList = languages.map((l) => `"${l}"`).join(", ");
-	const prompt = `
-You are an expert web localization AI. Given the following HTML file, extract all translatable content (titles, meta tags, headers, buttons, video/image alt/title, labels, aria-label, all aria-* attributes, and placeholders) and generate a JSON object in the following format:
+  const apiKey = await getApiKey(options);
+  if (!apiKey) {
+    throw new Error("Google GenAI API key is required for translateHtml.");
+  }
 
-{
-  "translations": [
-    {
-      "selector": "<css selector>",
-      "innerHTML": {
-        ${languages
-			.map((l) => `\"${l}\"`)
-			.join(
-				", \
-        "
-			)}
-      }
-    },
-    {
-      "selector": "<css selector>",
-      "attributes": {
-        "alt": { ${langList} },
-        "label": { ${langList} },
-        "aria-label": { ${langList} },
-        "aria-*": { ${langList} },
-        "title": { ${langList} },
-        "placeholder": { ${langList} }
-      }
-    },
-    // Example for structured data translation:
-    {
-      "selector": "script[type='application/ld+json']",
-      "innerHTML": {
-        "en": { "@context": "http://schema.org", "@type": "WebPage", "name": "English name", "description": "English description" },
-        "es": { "@context": "http://schema.org", "@type": "WebPage", "name": "Spanish name", "description": "Spanish description" },
-        "fr": { "@context": "http://schema.org", "@type": "WebPage", "name": "French name", "description": "French description" }
-        // ...other languages
-      }
-    }
-    // ...more selectors as needed
-  ]
-}
+  const ai = new GoogleGenAI({ apiKey });
+  const modelName = options.model || DEFAULT_MODEL;
+  const langList = Array.isArray(languages) ? languages.join(", ") : String(languages);
 
-Do not add any extra keys or key names not shown in this structure. Only use the keys: name, directory, path, content-type, translations, selector, innerHTML, attributes, alt, label, aria-label, aria-*, title, placeholder, and the language codes (${languages.join(
-		", "
-	)}).
+  const prompt = `
+You are an expert web localization AI. 
+Analyze the provided HTML and find all elements containing an "i18n" attribute, as well as any <script type="application/ld+json"> tags.
 
-For every translatable item (innerHTML and attributes), provide a translation for each language: ${languages.join(
-		", "
-	)}. Do not leave any language blank. For Guarani (\"gn\"), always translate to Guarani and never leave it in English.
+Target Languages: ${langList}
 
-Only output the JSON object, do not include any explanation or extra text.
+Instructions:
+1. Extract translatable content for each "i18n" key (inner text, alt, title, placeholder, label, aria-label, and aria-* attributes).
+2. For script[type='application/ld+json'], use the key "ld+json" or the element's "i18n" attribute, and translate string fields (like name, description) while keeping schema keywords (@context, @type, url) intact.
+3. Organize the translations into a LANGUAGE-FIRST structure where top-level keys are the target language codes (${langList}).
+4. Inside each language code object, map each "i18n" key to its translated properties (e.g., "text", "placeholder", "alt", "title", "aria-label").
+5. Provide a full translation for EVERY target language requested. Never leave a requested language empty.
 
-HTML:
+HTML Source:
 ${html}
 `;
 
-	try {
-		const result = await model.generateContent(prompt);
-		let jsonText = result.response.candidates[0].content.parts[0].text;
-		// Extract the first JSON object from the response
-		const match = jsonText.match(/\{[\s\S]*\}/);
-		if (!match) throw new Error("No JSON object found in AI response");
-		jsonText = match[0];
-		return JSON.parse(jsonText).translations;
-	} catch (err) {
-		console.log(`AI error:`, err);
-		return null;
-	}
-}
+  /**
+   * JSON Schema enforcing structured Language-First output from Gemini.
+   * @type {import("@google/genai").Schema}
+   */
+  const responseSchema = {
+    type: Type.OBJECT,
+    properties: {
+      translations: {
+        type: Type.OBJECT,
+        description: "Map of language codes (e.g., 'en', 'es') to key-value translation objects",
+        additionalProperties: {
+          type: Type.OBJECT,
+          description: "Map of i18n keys to element translation properties",
+          additionalProperties: {
+            type: Type.OBJECT,
+            properties: {
+              text: { type: Type.STRING, nullable: true },
+              placeholder: { type: Type.STRING, nullable: true },
+              title: { type: Type.STRING, nullable: true },
+              alt: { type: Type.STRING, nullable: true },
+              "aria-label": { type: Type.STRING, nullable: true }
+            },
+            additionalProperties: true
+          }
+        }
+      }
+    },
+    required: ["translations"]
+  };
+
+  try {
+    const response = await ai.models.generateContent({
+      model: modelName,
+      contents: prompt,
+      config: {
+        responseMimeType: "application/json",
+        responseSchema: responseSchema,
+        temperature: options.temperature ?? 0.2
+      }
+    });
+
+    const parsed = JSON.parse(response.text);
+    return parsed.translations;
+  } catch (err) {
+    console.error("Gemini Translation Error:", err);
+    return null;
+  }
+};

package/src/commands/fs/automated.js

@@ -1,159 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-
-function findDirectories(startPath, callback, fileName) {
-  // Resolve relative paths to absolute paths if needed
-  const resolvedPath =
-    startPath.startsWith("./") || startPath.startsWith("../")
-      ? path.resolve(startPath)
-      : startPath;
-
-  const segments = resolvedPath.split("/"); // Split path by '/'
-  let currentPath = "/"; // Start from root
-
-  for (let i = 0; i < segments.length; i++) {
-    const segment = segments[i];
-    const isWildcard = segment === "*";
-
-    if (isWildcard) {
-      // Get all directories at this level
-      const directories = fs
-        .readdirSync(currentPath)
-        .filter((file) =>
-          fs.statSync(path.join(currentPath, file)).isDirectory()
-        );
-
-      // Process each directory and continue along the path
-      directories.forEach((dir) => {
-        findDirectories(
-          path.join(currentPath, dir, ...segments.slice(i + 1)),
-          callback,
-          fileName
-        );
-      });
-      return; // Stop further processing in the loop for wildcard case
-    } else {
-      // Continue to the next part of the path
-      currentPath = path.join(currentPath, segment);
-
-      // If a segment doesn’t exist or isn’t a directory, log an error and stop
-      if (
-        !fs.existsSync(currentPath) ||
-        !fs.statSync(currentPath).isDirectory()
-      ) {
-        console.log(`Directory not found: ${currentPath}`);
-        return;
-      }
-    }
-  }
-
-  // If we reach the end of the path without wildcards, we have a valid directory
-  callback(currentPath, fileName);
-}
-
-function createOrUpdateFile(directoryPath, fileName) {
-  let buildStep = `- name: Build\n        run: yarn build`;
-
-  // Check if webpack config exists to include build step
-  const webpackPath = filePath.replace(fileName, "webpack.config.js");
-  if (!fs.existsSync(webpackPath)) buildStep = "";
-
-  // Define file content (e.g., for YAML or other configuration)
-  const fileContent = `name: Automated Workflow
-on:
-  push:
-    branches:
-      - main
-jobs:
-  about:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 16
-      - name: Jaid/action-sync-node-meta
-        uses: jaid/action-sync-node-meta@v1.4.0
-        with:
-          direction: overwrite-github
-          githubToken: "\${{ secrets.GITHUB }}"
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 14
-      - name: Semantic Release
-        uses: cycjimmy/semantic-release-action@v3
-        id: semantic
-        with:
-          extra_plugins: |
-            @semantic-release/changelog
-            @semantic-release/git
-            @semantic-release/github
-        env:
-          GITHUB_TOKEN: "\${{ secrets.GITHUB }}"
-          NPM_TOKEN: "\${{ secrets.NPM_TOKEN }}"
-    outputs:
-      new_release_published: "\${{ steps.semantic.outputs.new_release_published }}"
-      new_release_version: "\${{ steps.semantic.outputs.new_release_version }}"
-  upload:
-    runs-on: ubuntu-latest
-    needs: release
-    if: needs.release.outputs.new_release_published == 'true'
-    env:
-      VERSION: "\${{ needs.release.outputs.new_release_version }}"
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 16
-      - name: Set npm registry auth
-        run: echo "//registry.npmjs.org/:_authToken=\${{ secrets.NPM_TOKEN }}" > ~/.npmrc
-      - name: Install dependencies
-        run: yarn install
-      ${buildStep}
-      - name: Set Environment Variables
-        run: |
-          echo "organization_id=\${{ secrets.COCREATE_ORGANIZATION_ID }}" >> $GITHUB_ENV
-          echo "key=\${{ secrets.COCREATE_KEY }}" >> $GITHUB_ENV
-          echo "host=\${{ secrets.COCREATE_HOST }}" >> $GITHUB_ENV
-      - name: CoCreate Upload
-        run: coc upload
-`;
-
-  const filePath = path.join(directoryPath, fileName);
-  // Create or update the file
-  if (fs.existsSync(filePath)) fs.unlinkSync(filePath);
-  fs.writeFileSync(filePath, fileContent);
-}
-
-// Define the directories with wildcards
-const directories = [
-  "../../../../../CoCreate-modules/*/",
-  "../../../../../CoCreate-apps/*/",
-  "../../../../../CoCreate-plugins/*/",
-  "../../../../../CoCreateCSS/",
-  "../../../../../CoCreateJS/",
-  "../../../../../CoCreateWS/",
-  "../../../../../YellowOracle/",
-  "../../../../../CoCreate-website/",
-  "../../../../../CoCreate-admin/",
-  "../../../../../CoCreate-website-old/",
-  "../../../../../CoCreate-superadmin/",
-];
-const fileName = "automated.yml";
-
-// Execute directory search and create/update file if the directory exists
-directories.forEach((directory) => {
-  findDirectories(directory, createOrUpdateFile, fileName);
-});
-
-console.log("Finished");

package/src/commands/fs/config.js

@@ -1,133 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-
-function findDirectories(startPath, callback, fileName) {
-  // Resolve relative paths to absolute paths if needed
-  const resolvedPath =
-    startPath.startsWith("./") || startPath.startsWith("../")
-      ? path.resolve(startPath)
-      : startPath;
-
-  const segments = resolvedPath.split("/"); // Split path by '/'
-  let currentPath = "/"; // Start from root
-
-  for (let i = 0; i < segments.length; i++) {
-    const segment = segments[i];
-    const isWildcard = segment === "*";
-
-    if (isWildcard) {
-      // Get all directories at this level
-      const directories = fs
-        .readdirSync(currentPath)
-        .filter((file) =>
-          fs.statSync(path.join(currentPath, file)).isDirectory()
-        );
-
-      // Process each directory and continue along the path
-      directories.forEach((dir) => {
-        findDirectories(
-          path.join(currentPath, dir, ...segments.slice(i + 1)),
-          callback,
-          fileName
-        );
-      });
-      return; // Stop further processing in the loop for wildcard case
-    } else {
-      // Continue to the next part of the path
-      currentPath = path.join(currentPath, segment);
-
-      // If a segment doesn’t exist or isn’t a directory, log an error and stop
-      if (
-        !fs.existsSync(currentPath) ||
-        !fs.statSync(currentPath).isDirectory()
-      ) {
-        console.log(`Directory not found: ${currentPath}`);
-        return;
-      }
-    }
-  }
-
-  // If we reach the end of the path without wildcards, we have a valid directory
-  callback(currentPath, fileName);
-}
-
-function createOrUpdateFile(directoryPath, fileName) {
-  let name = path
-    .basename(path.resolve(path.dirname(directoryPath), "./"))
-    .substring(9);
-  let object = "";
-  let replaceContent = fs.readFileSync(directoryPath).toString();
-
-  // Parse content to extract `object`
-  let content_source = replaceContent.substring(
-    replaceContent.indexOf("sources")
-  );
-  let content1 = content_source.substring(content_source.indexOf("object"));
-  let content2 = content1.substring(content1.indexOf(":"));
-  object = content2.substring(3, content2.indexOf(",") - 4);
-
-  let fileContent = `module.exports = {
-    "config": {
-        "organization_id": "5ff747727005da1c272740ab",
-        "key": "2061acef-0451-4545-f754-60cf8160",
-        "host": "general.cocreate.app"
-    },
-    
-    "sources": [
-        {
-            "array": "files",
-            "object": {
-                "_id": "${object}",
-                "name": "index.html",
-                "path": "/docs/${name}",
-                "pathname": "/docs/${name}/index.html",
-                "src": "{{./docs/index.html}}",
-                "host": [
-                    "general.cocreate.app"
-                ],
-                "directory": "${name}",
-                "content-type": "{{content-type}}",
-                "public": "true"
-            }
-        }
-    ]
-}
-`;
-
-  if (!object.length) {
-    console.log("object Undefined: ", directoryPath);
-  } else if (object.length !== 24) {
-    console.log("object not valid! Please check your config: ", directoryPath);
-  } else {
-    const filePath = path.join(directoryPath, fileName);
-    if (fs.existsSync(filePath)) fs.unlinkSync(filePath);
-    fs.writeFileSync(filePath, fileContent);
-  }
-  const filePath = path.join(directoryPath, fileName);
-  // Create or update the file
-  if (fs.existsSync(filePath)) fs.unlinkSync(filePath);
-  fs.writeFileSync(filePath, fileContent);
-}
-
-// Define the directories with wildcards
-const directories = [
-  "../../../../../CoCreate-modules/*/",
-  "../../../../../CoCreate-apps/*/",
-  "../../../../../CoCreate-plugins/*/",
-  "../../../../../CoCreateCSS/",
-  "../../../../../CoCreateJS/",
-  "../../../../../CoCreateWS/",
-  "../../../../../YellowOracle/",
-  "../../../../../CoCreate-website/",
-  "../../../../../CoCreate-admin/",
-  "../../../../../CoCreate-website-old/",
-  "../../../../../CoCreate-superadmin/",
-];
-const fileName = "CoCreate.config.js";
-
-// Execute directory search and create/update file if the directory exists
-directories.forEach((directory) => {
-  findDirectories(directory, createOrUpdateFile, fileName);
-});
-
-console.log("Finished");

package/src/commands/fs/manual.js

@@ -1,81 +0,0 @@
-let glob = require("glob");
-let fs = require("fs");
-const path = require("path");
-
-function globUpdater(er, files) {
-  if (er) console.log(files, "glob resolving issue");
-  else
-    files.forEach((filename) => {
-      console.log(filename + "/manual.yml", "glob resolving issue");
-      update(filename + "/manual.yml");
-    });
-}
-
-function update(Path) {
-  // component name
-  let name = path
-    .basename(path.resolve(path.dirname(Path), "../.."))
-    .substring(9);
-  let fileContent = `name: Manual Workflow
-on:
-  workflow_dispatch:
-    inputs:
-      invalidations:
-        description: |
-          If set to 'true', invalidates previous upload.
-        default: 'true'
-        required: true
-
-jobs:
-  cdn:
-    runs-on: ubuntu-latest
-    env:
-      DRY_RUN: \${{ github.event.inputs.dry_run }}
-      GITHUB_TOKEN: '\${{ secrets.GITHUB_TOKEN }}'
-      NPM_TOKEN: '\${{ secrets.NPM_TOKEN }}'
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: setup nodejs
-        uses: actions/setup-node@v3
-        with:
-          node-version: 16
-      - name: yarn install
-        run: >
-          echo "//registry.npmjs.org/:_authToken=\${{ secrets.NPM_TOKEN }}" >
-          .npmrc
-
-          yarn install
-      - name: yarn build
-        run: yarn build
-      - name: upload latest bundle
-        uses: CoCreate-app/CoCreate-s3@master
-        with:
-          aws-key-id: '\${{ secrets.AWSACCESSKEYID }}'
-          aws-access-key: '\${{ secrets.AWSSECERTACCESSKEY }}'
-          distributionId: '\${{ secrets.DISTRIBUTION_ID }}'
-          bucket: testcrudbucket
-          source: ./dist
-          destination: /${name}/latest
-          acl: public-read
-          invalidations: \${{ github.event.inputs.invalidations }}
-
-`;
-
-  if (fs.existsSync(Path)) fs.unlinkSync(Path);
-  fs.writeFileSync(Path, fileContent);
-}
-
-// glob("../CoCreate-modules/CoCreate-action/.github/workflows", globUpdater)
-glob("../CoCreate-modules/*/.github/workflows/", globUpdater);
-glob("../CoCreate-apps/*/.github/workflows/", globUpdater);
-glob("../CoCreate-plugins/*/.github/workflows/", globUpdater);
-
-// substrin (9) removes CoCreateC leving namme as SS
-// glob("../CoCreateCSS/.github/workflows/", globUpdater)
-
-// does not need to add name... will require for name to be removed from destination
-// glob("../CoCreateJS/.github/workflows/", globUpdater)
-
-console.log("finished");