@kwiz/common 1.0.251 → 1.0.252

package/lib/cjs/helpers/exports-index.js

@@ -34,6 +34,7 @@ __exportStar(require("./diagrams"), exports);
 __exportStar(require("./emails"), exports);
 __exportStar(require("./eval"), exports);
 __exportStar(require("./file"), exports);
+__exportStar(require("./file.validation"), exports);
 __exportStar(require("./flatted"), exports);
 __exportStar(require("./functions"), exports);
 __exportStar(require("./http"), exports);

package/lib/cjs/helpers/exports-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"exports-index.js","sourceRoot":"","sources":["../../../src/helpers/exports-index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,qDAAmC;AACnC,4DAA0C;AAC1C,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B;AAC1B,gDAA8B;AAC9B,qDAAmC;AACnC,gDAA8B;AAC9B,0CAAwB;AACxB,4CAA0B;AAC1B,8CAA4B;AAC5B,4CAA0B;AAC1B,2CAAyB;AACzB,yCAAuB;AACvB,0CAAwB;AACxB,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,yCAAuB;AACvB,4CAA0B;AAC1B,8CAA4B;AAC5B,yCAAuB;AACvB,2CAAyB;AACzB,yCAAuB;AACvB,6CAA2B;AAC3B,wCAAsB;AACtB,4CAA0B;AAC1B,6CAA2B;AAC3B,iDAA+B;AAC/B,6CAA2B;AAC3B,2CAAyB;AACzB,+CAA6B;AAC7B,4CAA0B;AAC1B,iDAA+B;AAC/B,wCAAsB;AACtB,8CAA4B"}
+{"version":3,"file":"exports-index.js","sourceRoot":"","sources":["../../../src/helpers/exports-index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,qDAAmC;AACnC,4DAA0C;AAC1C,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B;AAC1B,gDAA8B;AAC9B,qDAAmC;AACnC,gDAA8B;AAC9B,0CAAwB;AACxB,4CAA0B;AAC1B,8CAA4B;AAC5B,4CAA0B;AAC1B,2CAAyB;AACzB,yCAAuB;AACvB,0CAAwB;AACxB,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,yCAAuB;AACvB,oDAAkC;AAClC,4CAA0B;AAC1B,8CAA4B;AAC5B,yCAAuB;AACvB,2CAAyB;AACzB,yCAAuB;AACvB,6CAA2B;AAC3B,wCAAsB;AACtB,4CAA0B;AAC1B,6CAA2B;AAC3B,iDAA+B;AAC/B,6CAA2B;AAC3B,2CAAyB;AACzB,+CAA6B;AAC7B,4CAA0B;AAC1B,iDAA+B;AAC/B,wCAAsB;AACtB,8CAA4B"}

package/lib/cjs/helpers/file.js

@@ -22,6 +22,7 @@ function _getRegexCollection() {
         IsDesktopIni: /^desktop\.ini$/gi
     };
 }
+/** @deprecated use validateFilenameExplicit */
 function validateFilename(fileNameWithExtension) {
     let filenameWithOutExtension = fileNameWithExtension;
     let split = filenameWithOutExtension.split(".");
@@ -36,6 +37,7 @@ function validateFilename(fileNameWithExtension) {
         valid: !hasIllegalCharacter && !hasIllegalName
     };
 }
+/** @deprecated use validateFoldernameExplicit */
 function validateFoldername(folderName) {
     let regexCollection = _getRegexCollection();
     let hasIllegalCharacter = regexCollection.IllegalCharsRegex.test(folderName);

package/lib/cjs/helpers/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/helpers/file.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/helpers/file.ts"],"names":[],"mappings":"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"}

package/lib/cjs/helpers/file.validation.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFoldernameExplicit = validateFoldernameExplicit;
+exports.validateFilenameExplicit = validateFilenameExplicit;
+const typecheckers_1 = require("./typecheckers");
+function _getIllegalCharsRegex(platform) {
+    switch (platform) {
+        case "m365":
+            return /["#%&*:<>?/\\{|}]/;
+        case "sf":
+        case "ns":
+        case "local":
+        case "all":
+        default:
+            return /[<>:"/\\|?*]/;
+    }
+}
+function _validateNameExplicit(name, label, platform) {
+    if ((0, typecheckers_1.isNullOrEmptyString)(name === null || name === void 0 ? void 0 : name.trim()))
+        return { valid: false, error_code: "fname_empty", error: `${label} name cannot be empty` };
+    if (name !== name.trim())
+        return { valid: false, error_code: "fname_trim", error: `${label} name cannot start or end with spaces` };
+    if (name === "." || name === "..")
+        return { valid: false, error_code: "fname_dots", error: `${label} name cannot be . or ..` };
+    if (/[. ]$/.test(name))
+        return { valid: false, error_code: "fname_ending", error: `${label} name cannot end with a period or space` };
+    if (/[\u0000-\u001f]/.test(name))
+        return { valid: false, error_code: "fname_invalid_control", error: `${label} name contains invalid control characters` };
+    if (_getIllegalCharsRegex(platform).test(name))
+        return { valid: false, error_code: "fname_invalid", error: `${label} name contains invalid characters` };
+    return { valid: true };
+}
+function _validateReservedNames(name, label, platform) {
+    const nameToCheck = label === "File" ? name.split(".").slice(0, -1).join(".") || name : name;
+    if (platform === "local" || platform === "m365") {
+        if (/^(CON|PRN|AUX|NUL|COM[0-9]|LPT[0-9])$/i.test(nameToCheck)) {
+            return { valid: false, error_code: "fname_reserved", error: `${label} name uses a reserved name` };
+        }
+    }
+    if (platform === "m365") {
+        if (/^\.lock$/i.test(nameToCheck) || /^desktop\.ini$/i.test(name)) {
+            return { valid: false, error_code: "fname_reserved", error: `${label} name uses a reserved name` };
+        }
+        if (/_vti_/i.test(name)) {
+            return { valid: false, error_code: "fname_vti", error: `${label} name cannot contain _vti_` };
+        }
+    }
+    return { valid: true };
+}
+function _validateFoldernameExplicitByPlatform(folderName, platform) {
+    const baseValidation = _validateNameExplicit(folderName, "Folder", platform);
+    if (!baseValidation.valid)
+        return baseValidation;
+    const reservedValidation = _validateReservedNames(folderName, "Folder", platform);
+    if (!reservedValidation.valid)
+        return reservedValidation;
+    if (platform === "m365" && /^~/.test(folderName))
+        return { valid: false, error_code: "fldname_tilde", error: "Folder name cannot start with ~" };
+    return { valid: true };
+}
+function _validateFilenameExplicitByPlatform(fileName, platform) {
+    const baseValidation = _validateNameExplicit(fileName, "File", platform);
+    if (!baseValidation.valid)
+        return baseValidation;
+    const reservedValidation = _validateReservedNames(fileName, "File", platform);
+    if (!reservedValidation.valid)
+        return reservedValidation;
+    if (platform === "m365" && /^~\$/.test(fileName))
+        return { valid: false, error_code: "flname_tilde", error: "File name cannot start with ~$" };
+    return { valid: true };
+}
+function validateFoldernameExplicit(folderName, platform = "all") {
+    if (platform === "all") {
+        const platforms = ["local", "m365", "sf", "ns"];
+        for (const currentPlatform of platforms) {
+            const result = _validateFoldernameExplicitByPlatform(folderName, currentPlatform);
+            if (!result.valid)
+                return result;
+        }
+        return { valid: true };
+    }
+    return _validateFoldernameExplicitByPlatform(folderName, platform);
+}
+function validateFilenameExplicit(fileName, platform = "all") {
+    if (platform === "all") {
+        const platforms = ["local", "m365", "sf", "ns"];
+        for (const currentPlatform of platforms) {
+            const result = _validateFilenameExplicitByPlatform(fileName, currentPlatform);
+            if (!result.valid)
+                return result;
+        }
+        return { valid: true };
+    }
+    return _validateFilenameExplicitByPlatform(fileName, platform);
+}
+//# sourceMappingURL=file.validation.js.map

package/lib/cjs/helpers/file.validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.validation.js","sourceRoot":"","sources":["../../../src/helpers/file.validation.ts"],"names":[],"mappings":"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"}

package/lib/esm/helpers/exports-index.js

@@ -18,6 +18,7 @@ export * from './diagrams';
 export * from './emails';
 export * from './eval';
 export * from './file';
+export * from './file.validation';
 export * from './flatted';
 export * from './functions';
 export * from './http';

package/lib/esm/helpers/exports-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"exports-index.js","sourceRoot":"","sources":["../../../src/helpers/exports-index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"exports-index.js","sourceRoot":"","sources":["../../../src/helpers/exports-index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC"}

package/lib/esm/helpers/file.js

@@ -15,6 +15,7 @@ function _getRegexCollection() {
         IsDesktopIni: /^desktop\.ini$/gi
     };
 }
+/** @deprecated use validateFilenameExplicit */
 export function validateFilename(fileNameWithExtension) {
     let filenameWithOutExtension = fileNameWithExtension;
     let split = filenameWithOutExtension.split(".");
@@ -29,6 +30,7 @@ export function validateFilename(fileNameWithExtension) {
         valid: !hasIllegalCharacter && !hasIllegalName
     };
 }
+/** @deprecated use validateFoldernameExplicit */
 export function validateFoldername(folderName) {
     let regexCollection = _getRegexCollection();
     let hasIllegalCharacter = regexCollection.IllegalCharsRegex.test(folderName);

package/lib/esm/helpers/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/helpers/file.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/helpers/file.ts"],"names":[],"mappings":"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"}

package/lib/esm/helpers/file.validation.js

@@ -0,0 +1,92 @@
+import { isNullOrEmptyString } from "./typecheckers";
+function _getIllegalCharsRegex(platform) {
+    switch (platform) {
+        case "m365":
+            return /["#%&*:<>?/\\{|}]/;
+        case "sf":
+        case "ns":
+        case "local":
+        case "all":
+        default:
+            return /[<>:"/\\|?*]/;
+    }
+}
+function _validateNameExplicit(name, label, platform) {
+    if (isNullOrEmptyString(name === null || name === void 0 ? void 0 : name.trim()))
+        return { valid: false, error_code: "fname_empty", error: `${label} name cannot be empty` };
+    if (name !== name.trim())
+        return { valid: false, error_code: "fname_trim", error: `${label} name cannot start or end with spaces` };
+    if (name === "." || name === "..")
+        return { valid: false, error_code: "fname_dots", error: `${label} name cannot be . or ..` };
+    if (/[. ]$/.test(name))
+        return { valid: false, error_code: "fname_ending", error: `${label} name cannot end with a period or space` };
+    if (/[\u0000-\u001f]/.test(name))
+        return { valid: false, error_code: "fname_invalid_control", error: `${label} name contains invalid control characters` };
+    if (_getIllegalCharsRegex(platform).test(name))
+        return { valid: false, error_code: "fname_invalid", error: `${label} name contains invalid characters` };
+    return { valid: true };
+}
+function _validateReservedNames(name, label, platform) {
+    const nameToCheck = label === "File" ? name.split(".").slice(0, -1).join(".") || name : name;
+    if (platform === "local" || platform === "m365") {
+        if (/^(CON|PRN|AUX|NUL|COM[0-9]|LPT[0-9])$/i.test(nameToCheck)) {
+            return { valid: false, error_code: "fname_reserved", error: `${label} name uses a reserved name` };
+        }
+    }
+    if (platform === "m365") {
+        if (/^\.lock$/i.test(nameToCheck) || /^desktop\.ini$/i.test(name)) {
+            return { valid: false, error_code: "fname_reserved", error: `${label} name uses a reserved name` };
+        }
+        if (/_vti_/i.test(name)) {
+            return { valid: false, error_code: "fname_vti", error: `${label} name cannot contain _vti_` };
+        }
+    }
+    return { valid: true };
+}
+function _validateFoldernameExplicitByPlatform(folderName, platform) {
+    const baseValidation = _validateNameExplicit(folderName, "Folder", platform);
+    if (!baseValidation.valid)
+        return baseValidation;
+    const reservedValidation = _validateReservedNames(folderName, "Folder", platform);
+    if (!reservedValidation.valid)
+        return reservedValidation;
+    if (platform === "m365" && /^~/.test(folderName))
+        return { valid: false, error_code: "fldname_tilde", error: "Folder name cannot start with ~" };
+    return { valid: true };
+}
+function _validateFilenameExplicitByPlatform(fileName, platform) {
+    const baseValidation = _validateNameExplicit(fileName, "File", platform);
+    if (!baseValidation.valid)
+        return baseValidation;
+    const reservedValidation = _validateReservedNames(fileName, "File", platform);
+    if (!reservedValidation.valid)
+        return reservedValidation;
+    if (platform === "m365" && /^~\$/.test(fileName))
+        return { valid: false, error_code: "flname_tilde", error: "File name cannot start with ~$" };
+    return { valid: true };
+}
+export function validateFoldernameExplicit(folderName, platform = "all") {
+    if (platform === "all") {
+        const platforms = ["local", "m365", "sf", "ns"];
+        for (const currentPlatform of platforms) {
+            const result = _validateFoldernameExplicitByPlatform(folderName, currentPlatform);
+            if (!result.valid)
+                return result;
+        }
+        return { valid: true };
+    }
+    return _validateFoldernameExplicitByPlatform(folderName, platform);
+}
+export function validateFilenameExplicit(fileName, platform = "all") {
+    if (platform === "all") {
+        const platforms = ["local", "m365", "sf", "ns"];
+        for (const currentPlatform of platforms) {
+            const result = _validateFilenameExplicitByPlatform(fileName, currentPlatform);
+            if (!result.valid)
+                return result;
+        }
+        return { valid: true };
+    }
+    return _validateFilenameExplicitByPlatform(fileName, platform);
+}
+//# sourceMappingURL=file.validation.js.map

package/lib/esm/helpers/file.validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.validation.js","sourceRoot":"","sources":["../../../src/helpers/file.validation.ts"],"names":[],"mappings":"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"}

package/lib/types/helpers/exports-index.d.ts

@@ -18,6 +18,7 @@ export * from './diagrams';
 export * from './emails';
 export * from './eval';
 export * from './file';
+export * from './file.validation';
 export * from './flatted';
 export * from './functions';
 export * from './http';

package/lib/types/helpers/file.d.ts

@@ -2,11 +2,13 @@ export declare const ImageFileTypes: string[];
 export declare const DocumentFileTypes: string[];
 export declare const VideoFileTypes: string[];
 export declare const OfficeFileTypes: string[];
+/** @deprecated use validateFilenameExplicit */
 export declare function validateFilename(fileNameWithExtension: string): {
     hasIllegalCharacter: boolean;
     hasIllegalName: boolean;
     valid: boolean;
 };
+/** @deprecated use validateFoldernameExplicit */
 export declare function validateFoldername(folderName: string): {
     hasIllegalCharacter: boolean;
     hasIllegalName: boolean;

package/lib/types/helpers/file.validation.d.ts

@@ -0,0 +1,12 @@
+/** codes will match strings.common.validation_invalid context value */
+export type tValidationErrorCode = "fname_empty" | "fname_trim" | "fname_dots" | "fname_ending" | "fname_invalid_control" | "fname_invalid" | "fname_reserved" | "fname_vti" | "fldname_tilde" | "flname_tilde";
+export type tValidationResult = {
+    valid: false;
+    error: string;
+    error_code: tValidationErrorCode;
+} | {
+    valid: true;
+};
+export type tValidationPlatform = "m365" | "sf" | "ns" | "local" | "all";
+export declare function validateFoldernameExplicit(folderName: string, platform?: tValidationPlatform): tValidationResult;
+export declare function validateFilenameExplicit(fileName: string, platform?: tValidationPlatform): tValidationResult;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kwiz/common",
-    "version": "1.0.251",
+    "version": "1.0.252",
     "description": "KWIZ common utilities and helpers for M365 platform",
     "main": "lib/cjs/index.js",
     "module": "lib/esm/index.js",