windmill-utils-internal 1.3.5 → 1.3.7

package/dist/esm/path-utils/path-assigner.d.ts

@@ -29,6 +29,7 @@ export declare const EXTENSION_TO_LANGUAGE: Record<string, SupportedLanguage>;
  * @returns The language, or undefined if not recognized
  */
 export declare function getLanguageFromExtension(ext: string, defaultTs?: "bun" | "deno"): SupportedLanguage | undefined;
+export declare function sanitizeForFilesystem(summary: string): string;
 export interface PathAssigner {
     assignPath(summary: string | undefined, language: SupportedLanguage): [string, string];
 }

package/dist/esm/path-utils/path-assigner.js

@@ -93,6 +93,26 @@ export function getLanguageFromExtension(ext, defaultTs = "bun") {
     }
     return undefined;
 }
+/**
+ * Sanitizes a summary string for use as a filesystem-safe name.
+ * Removes or replaces characters that are invalid on common filesystems.
+ */
+const WINDOWS_RESERVED = /^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/;
+export function sanitizeForFilesystem(summary) {
+    const name = summary
+        .toLowerCase()
+        .replaceAll(" ", "_")
+        // Remove characters invalid on Windows/Unix/Mac: / \ : * ? " < > |
+        // Also remove control characters (0x00-0x1F) and DEL (0x7F)
+        // deno-lint-ignore no-control-regex
+        .replace(/[/\\:*?"<>|\x00-\x1f\x7f]/g, "")
+        // Collapse consecutive underscores
+        .replace(/_+/g, "_")
+        // Trim leading/trailing dots and underscores (hidden files, Windows edge cases)
+        .replace(/^[._]+|[._]+$/g, "");
+    // Prefix Windows reserved device names (CON, PRN, AUX, NUL, COM0-9, LPT0-9)
+    return WINDOWS_RESERVED.test(name) ? `_${name}` : name;
+}
 /**
  * Creates a new path assigner for inline scripts.
  *
@@ -110,7 +130,7 @@ export function newPathAssigner(defaultTs, options) {
     const seen_names = new Set();
     function assignPath(summary, language) {
         let name;
-        name = summary?.toLowerCase()?.replaceAll(" ", "_") ?? "";
+        name = summary ? sanitizeForFilesystem(summary) : "";
         let original_name = name;
         if (name == "") {
             original_name = INLINE_SCRIPT_PREFIX;
@@ -141,7 +161,7 @@ export function newRawAppPathAssigner(defaultTs) {
     const seen_names = new Set();
     function assignPath(summary, language) {
         let name;
-        name = summary?.toLowerCase()?.replaceAll(" ", "_") ?? "";
+        name = summary ? sanitizeForFilesystem(summary) : "";
         let original_name = name;
         if (name == "") {
             original_name = "runnable";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "windmill-utils-internal",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "Internal utility functions for Windmill",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",