@kosdev-code/kos-nx-plugin 2.0.2

package/src/generators/preset/tools/tools/scripts/archiver.js.template

@@ -0,0 +1,79 @@
+/* eslint-disable @typescript-eslint/no-var-requires */
+// require modules
+const fs = require("fs");
+const archiver = require("archiver");
+const path = require("path");
+
+const devkit = require("@nx/devkit");
+const { readCachedProjectGraph } = devkit;
+
+const [, , name] = process.argv;
+
+const graph = readCachedProjectGraph();
+const project = graph.nodes[name];
+
+
+const buildPath = path.resolve(
+  project.data?.targets?.build?.options?.outputPath
+);
+
+const outputPath = path.resolve(
+  project.data?.targets?.zip?.options?.outputPath
+);
+const fileName = project.data?.targets?.zip?.options?.zipName;
+const ZIP = path.resolve(outputPath, fileName);
+
+console.log(ZIP);
+
+if (!fs.existsSync(outputPath)) {
+  fs.mkdirSync(outputPath, { recursive: true });
+}
+
+const output = fs.createWriteStream(ZIP);
+const archive = archiver("zip", {
+  zlib: { level: 9 }, // Sets the compression level.
+});
+
+// listen for all archive data to be written
+// 'close' event is fired only when a file descriptor is involved
+output.on("close", function () {
+  console.log(archive.pointer() + " total bytes");
+  console.log(
+    "archiver has been finalized and the output file descriptor has closed."
+  );
+});
+
+// This event is fired when the data source is drained no matter what was the data source.
+// It is not part of this library but rather from the NodeJS Stream API.
+// @see: https://nodejs.org/api/stream.html#stream_event_end
+output.on("end", function () {
+  console.log("Data has been drained");
+});
+
+// good practice to catch warnings (ie stat failures and other non-blocking errors)
+archive.on("warning", function (err) {
+  if (err.code === "ENOENT") {
+    // log warning
+  } else {
+    // throw error
+    throw err;
+  }
+});
+
+// good practice to catch this error explicitly
+archive.on("error", function (err) {
+  throw err;
+});
+
+// pipe archive data to the file
+archive.pipe(output);
+
+// append a file from stream
+
+console.log(`${buildPath}/`);
+// append files from a sub-directory, putting its contents at the root of archive
+archive.directory(`${buildPath}/`, false);
+
+// finalize the archive (ie we are done appending files but streams have to finish yet)
+// 'close', 'end' or 'finish' may be fired right after calling this method so register to them beforehand
+archive.finalize();

package/src/generators/preset/tools/tools/scripts/descriptor.mjs.template

@@ -0,0 +1,114 @@
+import devkit from '@nx/devkit';
+import { resolve } from 'path';
+const { readCachedProjectGraph } = devkit;
+const [, , name] = process.argv;
+
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  writeFileSync,
+} from 'fs';
+import prettier from 'prettier';
+const graph = readCachedProjectGraph();
+const project = graph.nodes[name];
+
+const dotKabFilePath = resolve(process.cwd(), project.data.root, '.kos.json');
+const dotKabJson = JSON.parse(readFileSync(dotKabFilePath, 'utf8'));
+if (dotKabJson) {
+  dotKabJson.kos = dotKabJson.kos || {};
+  dotKabJson.kos.localization = dotKabJson.kos.localization || {};
+  const localizations = dotKabJson?.kos?.localization?.namespaces || {};
+  if (dotKabJson?.kos?.localization) {
+    dotKabJson.kos.localization.defaultLocale =
+      dotKabJson.kos.localization.defaultLocale || 'en';
+  }
+  const locales = resolve(
+    process.cwd(),
+    project.data.root,
+    'src',
+    'assets',
+    'locales'
+  );
+
+  mkdirSync(locales, { recursive: true });
+  
+  const localesDirs = readdirSync(locales);
+  const mergedNamespaces = localesDirs.reduce(
+    (acc, locale) => {
+      const namespaces = readdirSync(resolve(locales, locale));
+
+      namespaces.forEach((namespaceFile) => {
+        const [namespace] = namespaceFile.split('.');
+        acc.namespaces = [...new Set([...acc.namespaces, namespace])];
+        acc.localizations[namespace] = acc.localizations[namespace] || {
+          locales: {},
+        };
+        acc.localizations[namespace].locales =
+          acc.localizations[namespace].locales || {};
+        acc.localizations[namespace].locales[
+          locale
+        ] = `/assets/locales/${locale}/${namespace}.json`;
+      });
+      return acc;
+    },
+    { localizations, namespaces: [] }
+  );
+
+  console.log(mergedNamespaces.namespaces);
+  const toRemove = Object.keys(localizations).filter(
+    (namespace) => !mergedNamespaces.namespaces.includes(namespace)
+  );
+
+  toRemove.forEach((namespace) => {
+    delete localizations[namespace];
+  });
+  dotKabJson.kos.localization.namespaces = mergedNamespaces.localizations;
+
+  const options = await prettier.resolveConfig(dotKabFilePath);
+
+  const configFile = await prettier.resolveConfigFile(dotKabFilePath);
+
+  const namespaceOverrides = Object.keys(
+    dotKabJson.kos.localization.namespaces
+  ).reduce((acc, namespace) => {
+    acc[namespace] = {};
+    if (dotKabJson.kos.localization.namespaces[namespace].fallbackLocales) {
+      acc[namespace].fallbackLocales =
+        dotKabJson.kos.localization.namespaces[namespace].fallbackLocales;
+    }
+    return acc;
+  }, {});
+
+  const modified = {
+    ...dotKabJson,
+    kos: {
+      ...dotKabJson.kos,
+      localization: {
+        ...dotKabJson.kos.localization,
+        namespaces: namespaceOverrides,
+      },
+    },
+  };
+  const output = await prettier.format(JSON.stringify(modified, null, 2), {
+    ...options,
+    parser: 'json',
+  });
+  writeFileSync(dotKabFilePath, output);
+}
+
+const buildPath = resolve(
+  project.data?.targets?.descriptor?.options?.outputPath
+);
+
+if (!existsSync(buildPath)) {
+  mkdirSync(buildPath, { recursive: true });
+}
+
+if (dotKabJson) {
+  writeFileSync(
+    resolve(buildPath, 'descriptor.json'),
+    JSON.stringify(dotKabJson, null, 2)
+  );
+}

package/src/generators/preset/tools/tools/scripts/generate-api-types.mjs.template

@@ -0,0 +1,25 @@
+import devkit from "@nx/devkit";
+import { mkdirSync, writeFileSync } from "fs";
+import openapiTS, { astToString } from "openapi-typescript";
+import { join } from "path";
+const { readCachedProjectGraph } = devkit;
+const [, , name] = process.argv;
+
+const graph = readCachedProjectGraph();
+const project = graph.nodes[name];
+const host = project.data.targets.api?.options?.host || "http://127.0.0.1:8081";
+const src = project.data.sourceRoot || project.data.root;
+
+const outFile = join(src, "utils", "openapi.d.ts");
+
+mkdirSync(join(src, "utils"), { recursive: true });
+
+console.log(`Generating API types for ${name} at ${outFile} from ${host}`);
+
+const ast = await openapiTS(
+  new URL(`${host}/api/kos/openapi/api`, import.meta.url)
+);
+const contents = astToString(ast);
+
+// (optional) write to file
+writeFileSync(outFile, contents);

package/src/generators/preset/tools/tools/scripts/kabtool.mjs.template

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import devkit from "@nx/devkit";
+import { spawn } from "child_process";
+import fs from "fs";
+import path from "path";
+const { readCachedProjectGraph } = devkit;
+
+import chalk from "chalk";
+import dotenv from "dotenv";
+import dotenvExpand from "dotenv-expand";
+
+const [, , buildType, projectName] = process.argv;
+const graph = readCachedProjectGraph();
+const project = graph.nodes[projectName];
+
+const kabOptions = project.data?.targets?.kab?.options;
+const config = dotenv.config({
+  path: path.resolve(process.cwd(), ".env.local"),
+});
+dotenvExpand.expand(config);
+
+const dotKabFilePath = path.resolve(
+  process.cwd(),
+  project.data.root,
+  ".kos.json"
+);
+
+const dotKabJson = JSON.parse(fs.readFileSync(dotKabFilePath, "utf8"));
+const version = dotKabJson.version;
+const installPath = process.env.KOS_INSTALL_PATH;
+const kabJarPath = process.env.KOS_KABTOOL_JAR;
+const jarLocation =
+  process.platform === "darwin"
+    ? path.join("Contents", "MacOS", "lib", "jars", "kabtool.jar")
+    : path.join("release", "lib", "jars", "kabtool.jar");
+const jarPath = kabJarPath ?? path.resolve(installPath, jarLocation);
+const jar = path.resolve(jarPath);
+const command = process.env.JAVA_CMD;
+
+const name = dotKabJson.name;
+const id = dotKabJson.id;
+const type = dotKabJson.type;
+const qualifier = dotKabJson.qualifier;
+const inputFile = path.resolve(kabOptions.outputPath, kabOptions.zipName);
+const outputFile = path.resolve(kabOptions.outputPath, kabOptions.kabName);
+
+const baseBuildArgs = [
+  "-b",
+  "-t",
+  type,
+  "-n",
+  name,
+  "-v",
+  version,
+  "-z",
+  inputFile,
+];
+
+const qualifierArgs = qualifier ? ["-q", qualifier] : [];
+const idArgs = id ? ["-i", id] : [];
+
+const buildArgs = [...baseBuildArgs, ...qualifierArgs, ...idArgs, outputFile];
+const helpArgs = ["-h"];
+
+const listArgs = ["-l", outputFile];
+const cmdMap = {
+  build: buildArgs,
+  help: helpArgs,
+  list: listArgs,
+};
+const cmdArgs = cmdMap[buildType] || helpArgs;
+
+const args = ["-Dfile.encoding=UTF-8", "-jar", jar, ...cmdArgs];
+
+const ps = spawn(command, args);
+
+ps.stdout.on("data", (data) => {
+  console.log(chalk.blue(`studio: ${data}`));
+});
+
+ps.stderr.on("data", (data) => {
+  console.error(chalk.red(`studio: ${data}`));
+});
+
+ps.on("close", (code) => {
+  console.log(`child process exited with code ${code}`);
+});

package/src/generators/preset/tools/tools/scripts/update.mjs.template

@@ -0,0 +1,67 @@
+import chalk from "chalk";
+import { execSync } from "child_process";
+const [, , sdk, ddk] = process.argv;
+const kos = [
+
+  "@kosdev-code/kos-dispense-sdk",
+
+  "@kosdev-code/kos-ui-sdk",
+
+]
+  .map((dep) => `${dep}@${sdk}`)
+  .join(" ");
+
+const freestyle = [
+  "@kosdev-code/kos-freestyle-sdk",
+]
+  .map((dep) => `${dep}@${sdk}`)
+  .join(" ");
+
+const cms = [
+  "@kosdev-code/kos-cms-sdk",
+]
+  .map((dep) => `${dep}@${sdk}`)
+  .join(" ");
+
+const ddkDeps = [
+  "@kosdev-code/kos-ddk",
+  "@kosdev-code/kos-ddk-components",
+  "@kosdev-code/kos-ddk-models",
+  "@kosdev-code/kos-ddk-model-components",
+  "@kosdev-code/kos-ddk-styles",
+  "@kosdev-code/kos-ui-plugin",
+]
+  .map((dep) => `${dep}@${ddk}`)
+  .join(" ");
+
+const flags = [
+  "--loglevel error",
+  "--no-progress",
+  "--no-audit",
+  "--no-fund",
+].join(" ");
+console.log(chalk.green("Updating dependencies..."));
+console.log(chalk.green("Updating kos dependencies..."));
+execSync(`npm i ${kos}  --save ${flags}`, {
+  stdio: "inherit",
+});
+
+console.log(chalk.green("Updating freestyle dependencies..."));
+execSync(`npm i ${freestyle}  --save ${flags}`, {
+  stdio: "inherit",
+});
+
+console.log(chalk.green("Updating cms dependencies..."));
+execSync(`npm i ${cms} --save ${flags}`, {
+  stdio: "inherit",
+});
+
+console.log(chalk.green("Updating ddk dependencies..."));
+execSync(`npm i ${ddkDeps} --save ${flags}`, {
+  stdio: "inherit",
+});
+
+console.log(chalk.green("Updating kos-ui-cli..."));
+execSync(`npm i -g @kosdev-code/kos-ui-cli@${sdk} ${flags}`, {
+  stdio: "inherit",
+});

package/src/generators/preset/tools/tools/tsconfig.tools.json.template

@@ -0,0 +1,12 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "../dist/out-tsc/tools",
+    "rootDir": ".",
+    "module": "commonjs",
+    "target": "es5",
+    "types": ["node"],
+    "importHelpers": false
+  },
+  "include": ["**/*.ts"]
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/plugins/kos-nx-plugin/src/index.ts"],"names":[],"mappings":""}

package/src/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/plugins/kos-nx-plugin/src/index.ts"],"names":[],"mappings":""}

package/src/migrations/add-overrides/add-overrides.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from "@nx/devkit";
+export default function update(host: Tree): void;
+//# sourceMappingURL=add-overrides.d.ts.map

package/src/migrations/add-overrides/add-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-overrides.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/add-overrides/add-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAOL,MAAM,YAAY,CAAC;AAKpB,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,IAAI,EAAE,IAAI,QAuGxC"}

package/src/migrations/add-overrides/add-overrides.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const devkit_1 = require("@nx/devkit");
+const java_home_1 = require("../../utils/java-home");
+const path = require("path");
+const os = require("os");
+function update(host) {
+    (0, devkit_1.updateJson)(host, "package.json", (pkgJson) => {
+        const newOverrides = {
+            tslib: "^2.6.0",
+        };
+        delete pkgJson.overrides["esbuild"];
+        pkgJson.overrides = { ...pkgJson.overrides, ...newOverrides };
+        // return modified JSON object
+        return pkgJson;
+    });
+    (0, devkit_1.updateJson)(host, "tsconfig.base.json", (tsconfig) => {
+        if (tsconfig.compilerOptions?.paths) {
+            tsconfig.compilerOptions.paths["@kos-ui/kos-dispense-model"] = [
+                "node_modules/@kosdev-code/kos-dispense-sdk/kos-dispenser-model/index.d.ts",
+            ];
+            delete tsconfig.compilerOptions.paths["@kosdev-code/kos-dispense-sdk"];
+        }
+        return tsconfig;
+    });
+    const projectMap = (0, devkit_1.getProjects)(host);
+    Array.from(projectMap.values()).forEach((project) => {
+        if (project.projectType === "application") {
+            const projectName = project.name || "";
+            const newOverrides = {
+                kab: {
+                    command: `node tools/scripts/kabtool.mjs build ${projectName} && node tools/scripts/kabtool.mjs list ${projectName}`,
+                    options: {
+                        outputPath: `dist/archives/packages/${projectName}/`,
+                        zipName: "ui.zip",
+                        kabName: `${projectName}.kab`,
+                    },
+                    dependsOn: ["zip"],
+                },
+                zip: {
+                    command: `node tools/scripts/archiver.js ${projectName}`,
+                    options: {
+                        outputPath: `dist/archives/packages/${projectName}/`,
+                        zipName: "ui.zip",
+                    },
+                    dependsOn: ["build"],
+                },
+            };
+            const targets = project.targets || {};
+            project.targets = { ...newOverrides, ...targets };
+            (0, devkit_1.updateProjectConfiguration)(host, projectName, project);
+            if (!host.exists(path.join(project.root, ".kos.json"))) {
+                (0, devkit_1.generateFiles)(host, path.join(__dirname, "projectFiles"), `${project.root}`, {
+                    template: "",
+                    name: projectName,
+                });
+            }
+        }
+    });
+    (0, devkit_1.removeDependenciesFromPackageJson)(host, ["tslib", "@kosdev-code/kos-dispenser-sdk"], []);
+    (0, devkit_1.addDependenciesToPackageJson)(host, {
+        "@kosdev-code/kos-ui-sdk": "next",
+        "@kosdev-code/kos-dispense-sdk": "next",
+    }, {
+        archiver: "^5.3.1",
+        "dotenv-expand": "^10.0.0",
+        "@kosdev-code/kos-test-utils": "next",
+        "@kosdev-code/kos-nx-plugin": "next",
+    });
+    const homeDir = os.homedir();
+    const installDir = os.platform() === "darwin"
+        ? path.join(homeDir, "Applications", "kosStudio.app")
+        : path.join(homeDir, "kosStudio");
+    const javaHome = (0, java_home_1.findJavaHome)();
+    const javaExecutable = os.platform() === "darwin"
+        ? path.join(javaHome || "", "bin", "java")
+        : path.join(javaHome || "", "bin", "java.exe");
+    (0, devkit_1.generateFiles)(host, path.join(__dirname, "files"), `/`, {
+        installDir: installDir,
+        javaHome: javaExecutable,
+        template: "",
+    });
+}
+exports.default = update;
+//# sourceMappingURL=add-overrides.js.map

package/src/migrations/add-overrides/add-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-overrides.js","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/add-overrides/add-overrides.ts"],"names":[],"mappings":"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"}

package/src/migrations/add-overrides/files/.env.local__template__

@@ -0,0 +1,5 @@
+#  Path to the Java binary
+JAVA_CMD='<%= javaHome %>'
+
+#  Path to the kos installation
+KOS_INSTALL_PATH='<%= installDir %>'

package/src/migrations/add-overrides/files/tools/scripts/archiver.js__template__

@@ -0,0 +1,79 @@
+/* eslint-disable @typescript-eslint/no-var-requires */
+// require modules
+const fs = require("fs");
+const archiver = require("archiver");
+const path = require("path");
+
+const devkit = require("@nx/devkit");
+const { readCachedProjectGraph } = devkit;
+
+const [, , name] = process.argv;
+
+const graph = readCachedProjectGraph();
+const project = graph.nodes[name];
+
+
+const buildPath = path.resolve(
+  project.data?.targets?.build?.options?.outputPath
+);
+
+const outputPath = path.resolve(
+  project.data?.targets?.zip?.options?.outputPath
+);
+const fileName = project.data?.targets?.zip?.options?.zipName;
+const ZIP = path.resolve(outputPath, fileName);
+
+console.log(ZIP);
+
+if (!fs.existsSync(outputPath)) {
+  fs.mkdirSync(outputPath, { recursive: true });
+}
+
+const output = fs.createWriteStream(ZIP);
+const archive = archiver("zip", {
+  zlib: { level: 9 }, // Sets the compression level.
+});
+
+// listen for all archive data to be written
+// 'close' event is fired only when a file descriptor is involved
+output.on("close", function () {
+  console.log(archive.pointer() + " total bytes");
+  console.log(
+    "archiver has been finalized and the output file descriptor has closed."
+  );
+});
+
+// This event is fired when the data source is drained no matter what was the data source.
+// It is not part of this library but rather from the NodeJS Stream API.
+// @see: https://nodejs.org/api/stream.html#stream_event_end
+output.on("end", function () {
+  console.log("Data has been drained");
+});
+
+// good practice to catch warnings (ie stat failures and other non-blocking errors)
+archive.on("warning", function (err) {
+  if (err.code === "ENOENT") {
+    // log warning
+  } else {
+    // throw error
+    throw err;
+  }
+});
+
+// good practice to catch this error explicitly
+archive.on("error", function (err) {
+  throw err;
+});
+
+// pipe archive data to the file
+archive.pipe(output);
+
+// append a file from stream
+
+console.log(`${buildPath}/`);
+// append files from a sub-directory, putting its contents at the root of archive
+archive.directory(`${buildPath}/`, false);
+
+// finalize the archive (ie we are done appending files but streams have to finish yet)
+// 'close', 'end' or 'finish' may be fired right after calling this method so register to them beforehand
+archive.finalize();

package/src/migrations/add-overrides/files/tools/scripts/kabtool.mjs__template__

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+import { spawn } from "child_process";
+import path from "path";
+import fs from "fs";
+import devkit from "@nx/devkit";
+const { readCachedProjectGraph } = devkit;
+
+import chalk from "chalk";
+import dotenv from "dotenv";
+import dotenvExpand from "dotenv-expand";
+
+const [, , buildType, projectName] = process.argv;
+const graph = readCachedProjectGraph();
+const project = graph.nodes[projectName];
+
+const kabOptions = project.data?.targets?.kab?.options;
+const config = dotenv.config({
+  path: path.resolve(process.cwd(), ".env"),
+});
+dotenvExpand.expand(config);
+
+const dotKabFilePath = path.resolve(
+  process.cwd(),
+  project.data.root,
+  ".kos.json"
+);
+
+const dotKabJson = JSON.parse(fs.readFileSync(dotKabFilePath, "utf8"));
+const version = dotKabJson.version;
+const installPath = process.env.KOS_INSTALL_PATH;
+const jarLocation =
+  process.platform === "darwin"
+    ? path.join("Contents", "MacOS", "lib", "jars", "kabtool.jar")
+    : path.join("release", "lib", "jars", "kabtool.jar");
+const jar = path.resolve(installPath, jarLocation);
+const command = process.env.JAVA_CMD;
+
+const name = dotKabJson.name;
+const id = dotKabJson.id;
+const type = dotKabJson.type;
+const qualifier = dotKabJson.qualifier;
+const inputFile = path.resolve(kabOptions.outputPath, kabOptions.zipName);
+const outputFile = path.resolve(kabOptions.outputPath, kabOptions.kabName);
+
+const baseBuildArgs = [
+  "-b",
+  "-t",
+  type,
+  "-n",
+  name,
+  "-v",
+  version,
+  "-z",
+  inputFile,
+];
+
+const qualifierArgs = qualifier ? ["-q", qualifier] : [];
+const idArgs = id ? ["-i", id] : [];
+
+const buildArgs = [...baseBuildArgs, ...qualifierArgs, ...idArgs, outputFile];
+const helpArgs = ["-h"];
+
+const listArgs = ["-l", outputFile];
+const cmdMap = {
+  build: buildArgs,
+  help: helpArgs,
+  list: listArgs,
+};
+const cmdArgs = cmdMap[buildType] || helpArgs;
+
+const args = ["-Dfile.encoding=UTF-8", "-jar", jar, ...cmdArgs];
+
+const ps = spawn(command, args);
+
+ps.stdout.on("data", (data) => {
+  console.log(chalk.blue(`studio: ${data}`));
+});
+
+ps.stderr.on("data", (data) => {
+  console.error(chalk.red(`studio: ${data}`));
+});
+
+ps.on("close", (code) => {
+  console.log(`child process exited with code ${code}`);
+});

package/src/migrations/add-overrides/projectFiles/.kos.json__template__

@@ -0,0 +1,5 @@
+{
+  "name": "<%= name %>",
+  "type": "kos.ui",
+  "version": "0.1.0"
+}