@storm-software/cloudflare-tools 0.55.60 → 0.55.62

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 # Changelog for Storm Ops - Cloudflare Tools
 
+## [0.55.61](https://github.com/storm-software/storm-ops/releases/tag/cloudflare-tools%400.55.61) (2025-04-16)
+
+### Miscellaneous
+
+- **monorepo:** Regenerate README markdown files
+  ([762e7076f](https://github.com/storm-software/storm-ops/commit/762e7076f))
+
 ## [0.55.60](https://github.com/storm-software/storm-ops/releases/tag/cloudflare-tools%400.55.60) (2025-04-15)
 
 ### Miscellaneous

package/README.md

@@ -21,7 +21,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-0.55.59-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-0.55.61-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/dist/{chunk-QHEOKFFX.mjs → chunk-2AZUPILA.mjs}

@@ -1,21 +1,21 @@
 import {
   getInternalDependencies,
   r2UploadFile
-} from "./chunk-CRVSAZIS.mjs";
+} from "./chunk-ZXMAG5R6.mjs";
 import {
   createCliOptions,
   getPackageInfo
 } from "./chunk-H36VLRVB.mjs";
 import {
   getConfig
-} from "./chunk-4CNZ5PH2.mjs";
+} from "./chunk-MIFPHEJP.mjs";
 import {
   findWorkspaceRoot,
   writeDebug,
   writeInfo,
   writeSuccess,
   writeWarning
-} from "./chunk-Q7EDJLEB.mjs";
+} from "./chunk-ZPJS5XUY.mjs";
 import {
   __name
 } from "./chunk-H2MWLDLR.mjs";

package/dist/{chunk-LLLAUEYO.js → chunk-2P6I2JBP.js}

@@ -8,7 +8,7 @@ var require_package = _chunkJ5SB6L2Ljs.__commonJS.call(void 0, {
   "package.json"(exports, module) {
     module.exports = {
       name: "@storm-software/cloudflare-tools",
-      version: "0.55.60",
+      version: "0.55.62",
       description: "A Nx plugin package that contains various executors, generators, and utilities that assist in managing Cloudflare services.",
       repository: {
         type: "github",

package/dist/{chunk-PXZTPWCU.mjs → chunk-5WRF2CGH.mjs}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-H36VLRVB.mjs";
 import {
   getConfig
-} from "./chunk-4CNZ5PH2.mjs";
+} from "./chunk-MIFPHEJP.mjs";
 import {
   correctPaths,
   findWorkspaceRoot,
@@ -20,7 +20,7 @@ import {
   writeSuccess,
   writeTrace,
   writeWarning
-} from "./chunk-Q7EDJLEB.mjs";
+} from "./chunk-ZPJS5XUY.mjs";
 import {
   __dirname,
   __name,
@@ -636,12 +636,12 @@ import { createTaskGraph, mapTargetDefaultsToDependencies } from "nx/src/tasks-r
 
 // ../esbuild/src/build.ts
 import { watch as createWatcher } from "chokidar";
-import defu2 from "defu";
+import defu3 from "defu";
 import { debounce, flatten } from "es-toolkit";
 import { map } from "es-toolkit/compat";
 import * as esbuild2 from "esbuild";
 import { globbySync } from "globby";
-import { existsSync as existsSync4 } from "node:fs";
+import { existsSync as existsSync5 } from "node:fs";
 import hf from "node:fs/promises";
 import { findWorkspaceRoot as findWorkspaceRoot2 } from "nx/src/utils/find-workspace-root";
 
@@ -1028,7 +1028,7 @@ __name(bundleTypeDefinitions, "bundleTypeDefinitions");
 var tscPlugin = /* @__PURE__ */ __name((options, resolvedOptions) => ({
   name: "storm:tsc",
   setup(build4) {
-    if (options.emitTypes === false) {
+    if (options.dts === false) {
       return;
     }
     build4.onStart(async () => {
@@ -1080,7 +1080,7 @@ var getDefaultBuildPlugins = /* @__PURE__ */ __name((options, resolvedOptions) =
 var DEFAULT_BUILD_OPTIONS = {
   platform: "node",
   target: "node22",
-  format: "cjs",
+  format: "esm",
   external: [],
   logLevel: "error",
   tsconfig: "tsconfig.json",
@@ -1229,6 +1229,155 @@ var shebangRenderer = {
   }
 };
 
+// ../esbuild/src/tsc.ts
+import { loadTsConfig } from "bundle-require";
+import defu2 from "defu";
+import { existsSync as existsSync4, mkdirSync, writeFileSync } from "node:fs";
+import { dirname as dirname2, isAbsolute, join, normalize } from "node:path";
+import ts from "typescript";
+function ensureTempDeclarationDir(workspaceConfig) {
+  const root = workspaceConfig.directories.temp || join(workspaceConfig.workspaceRoot, "tmp");
+  const dirPath = join(root, ".tsc", "declaration");
+  if (existsSync4(dirPath)) {
+    return dirPath;
+  }
+  mkdirSync(dirPath, {
+    recursive: true
+  });
+  const gitIgnorePath = join(root, ".tsc", ".gitignore");
+  writeFileSync(gitIgnorePath, "**/*\n");
+  return dirPath;
+}
+__name(ensureTempDeclarationDir, "ensureTempDeclarationDir");
+function slash(path7) {
+  const isExtendedLengthPath = path7.startsWith("\\\\?\\");
+  if (isExtendedLengthPath) {
+    return path7;
+  }
+  return path7.replace(/\\/g, "/");
+}
+__name(slash, "slash");
+function toAbsolutePath(workspaceConfig, p, cwd) {
+  if (isAbsolute(p)) {
+    return p;
+  }
+  return slash(normalize(join(cwd || workspaceConfig.workspaceRoot, p)));
+}
+__name(toAbsolutePath, "toAbsolutePath");
+var AliasPool = class AliasPool2 {
+  static {
+    __name(this, "AliasPool");
+  }
+  seen = /* @__PURE__ */ new Set();
+  assign(name) {
+    let suffix = 0;
+    let alias = name === "default" ? "default_alias" : name;
+    while (this.seen.has(alias)) {
+      alias = `${name}_alias_${++suffix}`;
+      if (suffix >= 1e3) {
+        throw new Error("Alias generation exceeded limit. Possible infinite loop detected.");
+      }
+    }
+    this.seen.add(alias);
+    return alias;
+  }
+};
+function getExports(workspaceConfig, program, fileMapping) {
+  const checker = program.getTypeChecker();
+  const aliasPool = new AliasPool();
+  const assignAlias = aliasPool.assign.bind(aliasPool);
+  function extractExports(sourceFileName) {
+    const cwd = program.getCurrentDirectory();
+    sourceFileName = toAbsolutePath(workspaceConfig, sourceFileName, cwd);
+    const sourceFile = program.getSourceFile(sourceFileName);
+    if (!sourceFile) {
+      return [];
+    }
+    const destFileName = fileMapping.get(sourceFileName);
+    if (!destFileName) {
+      return [];
+    }
+    const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
+    if (!moduleSymbol) {
+      return [];
+    }
+    const exports = [];
+    const exportSymbols = checker.getExportsOfModule(moduleSymbol);
+    exportSymbols.forEach((symbol) => {
+      const name = symbol.getName();
+      exports.push({
+        kind: "named",
+        sourceFileName,
+        destFileName,
+        name,
+        alias: assignAlias(name),
+        isTypeOnly: false
+      });
+    });
+    return exports;
+  }
+  __name(extractExports, "extractExports");
+  return program.getRootFileNames().flatMap(extractExports);
+}
+__name(getExports, "getExports");
+function emitDtsFiles(workspaceConfig, program, host, emitOnlyDtsFiles = true, customTransformers) {
+  const fileMapping = /* @__PURE__ */ new Map();
+  const writeFile3 = /* @__PURE__ */ __name((fileName, text, writeByteOrderMark, onError, sourceFiles, data) => {
+    const sourceFile = sourceFiles?.[0];
+    const sourceFileName = sourceFile?.fileName;
+    if (sourceFileName && !fileName.endsWith(".map")) {
+      const cwd = program.getCurrentDirectory();
+      fileMapping.set(toAbsolutePath(workspaceConfig, sourceFileName, cwd), toAbsolutePath(workspaceConfig, fileName, cwd));
+    }
+    return host.writeFile(fileName, text, writeByteOrderMark, onError, sourceFiles, data);
+  }, "writeFile");
+  const emitResult = program.emit(void 0, writeFile3, void 0, emitOnlyDtsFiles, customTransformers);
+  const diagnostics = ts.getPreEmitDiagnostics(program).concat(emitResult.diagnostics);
+  const diagnosticMessages = [];
+  diagnostics.forEach((diagnostic) => {
+    if (diagnostic.file) {
+      const { line, character } = ts.getLineAndCharacterOfPosition(diagnostic.file, diagnostic.start);
+      const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
+      diagnosticMessages.push(`${diagnostic.file.fileName} (${line + 1},${character + 1}): ${message}`);
+    } else {
+      const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
+      diagnosticMessages.push(message);
+    }
+  });
+  const diagnosticMessage = diagnosticMessages.join("\n");
+  if (diagnosticMessage) {
+    writeError(`Failed to emit declaration files.
+
+${diagnosticMessage}`, workspaceConfig);
+    throw new Error("TypeScript compilation failed");
+  }
+  return fileMapping;
+}
+__name(emitDtsFiles, "emitDtsFiles");
+function emitDts(workspaceConfig, tsconfig, tsconfigRaw, emitOnlyDtsFiles = true, customTransformers) {
+  const rawTsconfig = loadTsConfig(workspaceConfig.workspaceRoot, tsconfig);
+  if (!rawTsconfig) {
+    throw new Error(`Unable to find ${tsconfig || "tsconfig.json"} in ${workspaceConfig.workspaceRoot}`);
+  }
+  const declarationDir = ensureTempDeclarationDir(workspaceConfig);
+  const parsedTsconfig = ts.parseJsonConfigFileContent(defu2({
+    compilerOptions: {
+      // Enable declaration emit and disable javascript emit
+      noEmit: false,
+      declaration: true,
+      declarationMap: true,
+      declarationDir,
+      emitDeclarationOnly: true
+    }
+  }, tsconfigRaw?.compilerOptions ?? {}, rawTsconfig.data ?? {}), ts.sys, tsconfig ? dirname2(tsconfig) : "./");
+  const options = parsedTsconfig.options;
+  const host = ts.createCompilerHost(options);
+  const program = ts.createProgram(parsedTsconfig.fileNames, options, host);
+  const fileMapping = emitDtsFiles(workspaceConfig, program, host, emitOnlyDtsFiles, customTransformers);
+  return getExports(workspaceConfig, program, fileMapping);
+}
+__name(emitDts, "emitDts");
+
 // ../esbuild/src/utilities/get-entry-points.ts
 import { glob as glob3 } from "glob";
 var getEntryPoints = /* @__PURE__ */ __name(async (config, projectRoot, sourceRoot, entry, emitOnAll = false) => {
@@ -1390,7 +1539,7 @@ var resolveOptions = /* @__PURE__ */ __name(async (userOptions) => {
     exitOnError: true
   });
   const projectJsonPath = joinPaths(workspaceRoot3.dir, projectRoot, "project.json");
-  if (!existsSync4(projectJsonPath)) {
+  if (!existsSync5(projectJsonPath)) {
     throw new Error("Cannot find project.json configuration");
   }
   const projectJsonFile = await hf.readFile(projectJsonPath, "utf8");
@@ -1400,11 +1549,11 @@ var resolveOptions = /* @__PURE__ */ __name(async (userOptions) => {
   if (!projectConfigurations?.projects?.[projectName]) {
     throw new Error("The Build process failed because the project does not have a valid configuration in the project.json file. Check if the file exists in the root of the project.");
   }
-  const options = defu2(userOptions, DEFAULT_BUILD_OPTIONS);
+  const options = defu3(userOptions, DEFAULT_BUILD_OPTIONS);
   options.name ??= `${projectName}-${options.format}`;
   options.target ??= DEFAULT_TARGET;
   const packageJsonPath = joinPaths(workspaceRoot3.dir, options.projectRoot, "package.json");
-  if (!existsSync4(packageJsonPath)) {
+  if (!existsSync5(packageJsonPath)) {
     throw new Error("Cannot find package.json configuration");
   }
   const env = getEnv("esbuild", options);
@@ -1486,11 +1635,11 @@ var resolveOptions = /* @__PURE__ */ __name(async (userOptions) => {
   return result;
 }, "resolveOptions");
 async function generatePackageJson(context2) {
-  if (context2.options.generatePackageJson !== false && existsSync4(joinPaths(context2.options.projectRoot, "package.json"))) {
+  if (context2.options.generatePackageJson !== false && existsSync5(joinPaths(context2.options.projectRoot, "package.json"))) {
     writeDebug("  \u270D\uFE0F   Writing package.json file", context2.options.config);
     const stopwatch = getStopwatch("Write package.json file");
     const packageJsonPath = joinPaths(context2.options.projectRoot, "project.json");
-    if (!existsSync4(packageJsonPath)) {
+    if (!existsSync5(packageJsonPath)) {
       throw new Error("Cannot find package.json configuration");
     }
     const packageJsonFile = await hf.readFile(joinPaths(context2.options.config.workspaceRoot, context2.options.projectRoot, "package.json"), "utf8");
@@ -1561,6 +1710,7 @@ async function executeEsBuild(context2) {
   options.inject === {}) {
     delete options.inject;
   }
+  delete options.dts;
   delete options.env;
   delete options.name;
   delete options.assets;
@@ -1596,6 +1746,16 @@ ${formatLogMessage({
   return context2;
 }
 __name(executeEsBuild, "executeEsBuild");
+async function executeTypescript(context2) {
+  if (context2.result?.errors.length === 0 && context2.options.dts) {
+    writeDebug(`  \u{1F4CB}  Running TypeScript Compiler for ${context2.options.name}`, context2.options.config);
+    const stopwatch = getStopwatch(`${context2.options.name} asset copy`);
+    await emitDts(context2.options.config, context2.options.tsconfig, context2.options.tsconfigRaw, true);
+    stopwatch();
+  }
+  return context2;
+}
+__name(executeTypescript, "executeTypescript");
 async function copyBuildAssets(context2) {
   if (context2.result?.errors.length === 0) {
     writeDebug(`  \u{1F4CB}  Copying asset files to output directory: ${context2.options.outdir}`, context2.options.config);
@@ -1612,6 +1772,9 @@ async function reportResults(context2) {
       writeWarning(`  \u{1F6A7}  The following warnings occurred during the build: ${context2.result.warnings.map((warning) => warning.text).join("\n")}`, context2.options.config);
     }
     writeSuccess(`  \u{1F4E6}  The ${context2.options.name} build completed successfully`, context2.options.config);
+  } else if (context2.result?.errors && context2.result?.errors.length > 0) {
+    writeError(`  \u274C  The ${context2.options.name} build failed with the following errors: ${context2.result.errors.map((error) => error.text).join("\n")}`, context2.options.config);
+    throw new Error(`The ${context2.options.name} build failed with the following errors: ${context2.result.errors.map((error) => error.text).join("\n")}`);
   }
 }
 __name(reportResults, "reportResults");
@@ -1666,7 +1829,7 @@ async function build3(options) {
       throw new Error("No build options were provided");
     }
     void transduce.async(opts, dependencyCheck);
-    await transduce.async(await createOptions(opts), pipe.async(generateContext, cleanOutputPath, generatePackageJson, executeEsBuild, copyBuildAssets, reportResults));
+    await transduce.async(await createOptions(opts), pipe.async(generateContext, cleanOutputPath, generatePackageJson, executeTypescript, executeEsBuild, copyBuildAssets, reportResults));
     writeSuccess("  \u{1F3C1}  ESBuild pipeline build completed successfully");
   } catch (error) {
     writeFatal("Fatal errors that the build process could not recover from have occured. The build process has been terminated.");
@@ -1743,7 +1906,7 @@ import { execSync as execSync4 } from "node:child_process";
 import { readFile as readFile5 } from "node:fs/promises";
 
 // ../workspace-tools/src/utils/pnpm-deps-update.ts
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync6 } from "node:fs";
 import { readFile as readFile4, writeFile as writeFile2 } from "node:fs/promises";
 import { format } from "prettier";
 import readYamlFile from "read-yaml-file";
@@ -1822,7 +1985,7 @@ var executor_default8 = withRunExecutor("Typia runtime validation generator", ty
 });
 
 // ../workspace-tools/src/executors/unbuild/executor.ts
-import { defu as defu3 } from "defu";
+import { defu as defu4 } from "defu";
 import { createJiti } from "jiti";
 async function unbuildExecutorFn(options, context2, config) {
   writeInfo("\u{1F4E6}  Running Storm Unbuild executor on the workspace", config);
@@ -1840,7 +2003,7 @@ async function unbuildExecutorFn(options, context2, config) {
     interopDefault: true
   });
   const stormUnbuild = await jiti.import(jiti.esmResolve("@storm-software/unbuild/build"));
-  await stormUnbuild.build(defu3({
+  await stormUnbuild.build(defu4({
     ...options,
     projectRoot: context2.projectsConfigurations.projects[context2.projectName].root,
     projectName: context2.projectName,
@@ -3306,23 +3469,23 @@ import { retrieveProjectConfigurationsWithoutPluginInference } from "nx/src/proj
 
 // ../workspace-tools/src/utils/lock-file.ts
 import { output as output2, readJsonFile, workspaceRoot as workspaceRoot2 } from "@nx/devkit";
-import { existsSync as existsSync6 } from "node:fs";
-import { join as join2 } from "node:path";
+import { existsSync as existsSync7 } from "node:fs";
+import { join as join3 } from "node:path";
 import { getNpmLockfileDependencies, getNpmLockfileNodes } from "nx/src/plugins/js/lock-file/npm-parser";
 import { getPnpmLockfileDependencies, getPnpmLockfileNodes } from "nx/src/plugins/js/lock-file/pnpm-parser";
 import { getYarnLockfileDependencies, getYarnLockfileNodes } from "nx/src/plugins/js/lock-file/yarn-parser";
 var YARN_LOCK_FILE = "yarn.lock";
 var NPM_LOCK_FILE = "package-lock.json";
 var PNPM_LOCK_FILE = "pnpm-lock.yaml";
-var YARN_LOCK_PATH = join2(workspaceRoot2, YARN_LOCK_FILE);
-var NPM_LOCK_PATH = join2(workspaceRoot2, NPM_LOCK_FILE);
-var PNPM_LOCK_PATH = join2(workspaceRoot2, PNPM_LOCK_FILE);
+var YARN_LOCK_PATH = join3(workspaceRoot2, YARN_LOCK_FILE);
+var NPM_LOCK_PATH = join3(workspaceRoot2, NPM_LOCK_FILE);
+var PNPM_LOCK_PATH = join3(workspaceRoot2, PNPM_LOCK_FILE);
 
 // ../workspace-tools/src/utils/plugin-helpers.ts
 import { readJsonFile as readJsonFile2 } from "@nx/devkit";
-import defu4 from "defu";
-import { existsSync as existsSync7 } from "node:fs";
-import { dirname as dirname2, join as join3 } from "node:path";
+import defu5 from "defu";
+import { existsSync as existsSync8 } from "node:fs";
+import { dirname as dirname3, join as join4 } from "node:path";
 
 // ../workspace-tools/src/utils/typia-transform.ts
 import transform2 from "typia/lib/transform";