schema-shield 0.0.6 → 1.0.1

package/lib/utils/deep-freeze.ts

@@ -0,0 +1,208 @@
+export function deepFreeze(
+  obj: any,
+  freezeClassInstances: boolean = false,
+  seen = new WeakSet()
+): any {
+  if (
+    obj === null ||
+    typeof obj !== "object" ||
+    seen.has(obj) ||
+    Object.isFrozen(obj)
+  ) {
+    return obj;
+  }
+
+  seen.add(obj);
+
+  if (Array.isArray(obj)) {
+    for (let i = 0, l = obj.length; i < l; i++) {
+      deepFreeze(obj[i], freezeClassInstances, seen);
+    }
+  } else {
+    const props = Reflect.ownKeys(obj);
+    for (let i = 0, l = props.length; i < l; i++) {
+      deepFreeze(obj[props[i]], freezeClassInstances, seen);
+    }
+
+    // If the object is an instance of a class (not a plain object or array) we need to freeze the prototype
+    if (freezeClassInstances) {
+      const proto = Object.getPrototypeOf(obj);
+      if (proto && proto !== Object.prototype) {
+        deepFreeze(proto, freezeClassInstances, seen);
+      }
+    }
+  }
+
+  Object.freeze(obj);
+
+  return obj;
+}
+
+function isPlainObject(value: any): boolean {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+
+export { isPlainObject };
+
+function canUseStructuredClone(value: any): boolean {
+  if (typeof structuredClone !== "function") {
+    return false;
+  }
+
+  if (typeof Buffer !== "undefined" && value instanceof Buffer) {
+    return false;
+  }
+
+  return (
+    Array.isArray(value) ||
+    isPlainObject(value) ||
+    value instanceof Date ||
+    value instanceof RegExp ||
+    value instanceof Map ||
+    value instanceof Set ||
+    value instanceof ArrayBuffer ||
+    ArrayBuffer.isView(value)
+  );
+}
+
+export function deepCloneUnfreeze<T>(
+  obj: T,
+  cloneClassInstances = false,
+  seen = new WeakMap()
+): T {
+  if (typeof obj === "undefined" || obj === null || typeof obj !== "object") {
+    return obj;
+  }
+
+  const source = obj as any;
+
+  if (seen.has(source)) {
+    return seen.get(source);
+  }
+
+  if (canUseStructuredClone(source)) {
+    const cloned = structuredClone(source);
+    seen.set(source, cloned);
+    return cloned;
+  }
+
+  let clone: any;
+
+  switch (true) {
+    case Array.isArray(source): {
+      clone = [];
+      seen.set(source, clone);
+      for (let i = 0, l = source.length; i < l; i++) {
+        clone[i] = deepCloneUnfreeze(source[i], cloneClassInstances, seen);
+      }
+      return clone;
+    }
+    case source instanceof Date: {
+      clone = new Date(source.getTime());
+      seen.set(source, clone);
+      return clone;
+    }
+    case source instanceof RegExp: {
+      clone = new RegExp(source.source, source.flags);
+      seen.set(source, clone);
+      return clone;
+    }
+    case source instanceof Map: {
+      clone = new Map();
+      seen.set(source, clone);
+      for (const [key, value] of source.entries()) {
+        clone.set(
+          deepCloneUnfreeze(key, cloneClassInstances, seen),
+          deepCloneUnfreeze(value, cloneClassInstances, seen)
+        );
+      }
+      return clone;
+    }
+    case source instanceof Set: {
+      clone = new Set();
+      seen.set(source, clone);
+      for (const value of source.values()) {
+        clone.add(deepCloneUnfreeze(value, cloneClassInstances, seen));
+      }
+      return clone;
+    }
+    case source instanceof ArrayBuffer: {
+      clone = source.slice(0);
+      seen.set(source, clone);
+      return clone;
+    }
+    // TypedArrays and DataView
+    case ArrayBuffer.isView(source): {
+      clone = new source.constructor(source.buffer.slice(0));
+      seen.set(source, clone);
+      return clone;
+    }
+    // Node.js Buffer
+    case typeof Buffer !== "undefined" && source instanceof Buffer: {
+      clone = Buffer.from(source);
+      seen.set(source, clone);
+      return clone;
+    }
+    case source instanceof Error: {
+      clone = new source.constructor(source.message);
+      seen.set(source, clone);
+      break;
+    }
+    // Non clonable objects
+    case source instanceof Promise ||
+      source instanceof WeakMap ||
+      source instanceof WeakSet: {
+      clone = source;
+      seen.set(source, clone);
+      return clone;
+    }
+    // Instance of a class
+    case source.constructor && source.constructor !== Object: {
+      if (!cloneClassInstances) {
+        clone = source;
+        seen.set(source, clone);
+        return clone;
+      }
+      clone = Object.create(Object.getPrototypeOf(source));
+      seen.set(source, clone);
+      break;
+    }
+
+    // Plain objects
+    default: {
+      clone = {};
+      seen.set(source, clone);
+
+      const keys = Reflect.ownKeys(source);
+      for (let i = 0, l = keys.length; i < l; i++) {
+        const key = keys[i];
+        clone[key as string] = deepCloneUnfreeze(
+          source[key as string],
+          cloneClassInstances,
+          seen
+        );
+      }
+      return clone;
+    }
+  }
+
+  const descriptors = Object.getOwnPropertyDescriptors(source);
+  for (const key of Reflect.ownKeys(descriptors)) {
+    const descriptor = descriptors[key as string];
+    if ("value" in descriptor) {
+      descriptor.value = deepCloneUnfreeze(
+        descriptor.value,
+        cloneClassInstances,
+        seen
+      );
+    }
+    Object.defineProperty(clone, key, descriptor);
+  }
+
+  return clone;
+}

package/lib/utils/has-changed.ts

@@ -0,0 +1,51 @@
+// Utility function to check if dependencies have changed recursively
+// eslint-disable-next-line sonarjs/cognitive-complexity
+export function hasChanged(prev: any, current: any) {
+  if (Object.is(prev, current)) {
+    return false;
+  }
+
+  if (Array.isArray(prev)) {
+    if (Array.isArray(current) === false) {
+      return true;
+    }
+
+    if (prev.length !== current.length) {
+      return true;
+    }
+
+    for (let i = 0; i < current.length; i++) {
+      if (hasChanged(prev[i], current[i])) {
+        return true;
+      }
+    }
+
+    return false;
+  }
+
+  if (typeof prev === "object" && prev !== null) {
+    if (typeof current !== "object" || current === null) {
+      return true;
+    }
+
+    for (const key in current) {
+      if (hasChanged(prev[key], current[key])) {
+        return true;
+      }
+    }
+
+    for (const key in prev) {
+      if (key in current) {
+        continue;
+      }
+
+      if (hasChanged(prev[key], undefined)) {
+        return true;
+      }
+    }
+
+    return false;
+  }
+
+  return true;
+}

package/lib/utils/index.ts

@@ -0,0 +1,4 @@
+export * from "./main-utils";
+export * from "./has-changed";
+export * from "./deep-freeze";
+export { deepCloneUnfreeze as deepClone } from "./deep-freeze";

package/lib/{utils.ts → utils/main-utils.ts}

@@ -1,4 +1,4 @@
-import { CompiledSchema } from "./index";
+import { CompiledSchema } from "../index";
 
 interface ErrorTree {
   message: string;
@@ -78,18 +78,27 @@ export class ValidationError extends Error {
 
 export interface DefineErrorOptions {
   item?: any; // Final item in the schemaPath
-  cause?: ValidationError; // Cause of the error
+  cause?: ValidationError | true; // Cause of the error
   data?: any; // Data that caused the error
 }
 
 export interface DefineErrorFunction {
-  (message: string, options?: DefineErrorOptions): ValidationError;
+  (
+    message: string,
+    options?: DefineErrorOptions
+  ): ValidationError | void | true;
 }
+const FAIL_FAST_DEFINE_ERROR: DefineErrorFunction = () => true;
 
 export function getDefinedErrorFunctionForKey(
   key: string,
-  schema: CompiledSchema
+  schema: CompiledSchema,
+  failFast: boolean
 ) {
+  if (failFast) {
+    return FAIL_FAST_DEFINE_ERROR;
+  }
+
   const KeywordError = new ValidationError(`Invalid ${key}`);
   KeywordError.keyword = key;
   KeywordError.schema = schema;
@@ -97,7 +106,8 @@ export function getDefinedErrorFunctionForKey(
   const defineError: DefineErrorFunction = (message, options = {}) => {
     KeywordError.message = message;
     KeywordError.item = options.item;
-    KeywordError.cause = options.cause;
+    KeywordError.cause =
+      options.cause && options.cause !== true ? options.cause : undefined;
     KeywordError.data = options.data;
     return KeywordError;
   };
@@ -108,54 +118,6 @@ export function getDefinedErrorFunctionForKey(
   );
 }
 
-export function deepEqual(
-  obj: Array<any> | Record<string, any>,
-  other: Array<any> | Record<string, any>
-) {
-  if (Array.isArray(obj) && Array.isArray(other)) {
-    if (obj.length !== other.length) {
-      return false;
-    }
-
-    for (let i = 0; i < obj.length; i++) {
-      if (!deepEqual(obj[i], other[i])) {
-        return false;
-      }
-    }
-
-    return true;
-  }
-
-  if (typeof obj === "object" && typeof other === "object") {
-    if (obj === null || other === null) {
-      return obj === other;
-    }
-
-    const keys = Object.keys(obj);
-    if (keys.length !== Object.keys(other).length) {
-      return false;
-    }
-
-    for (const key of keys) {
-      if (!deepEqual(obj[key], other[key])) {
-        return false;
-      }
-    }
-
-    return true;
-  }
-
-  return obj === other;
-}
-
-export function isObject(data) {
-  return typeof data === "object" && data !== null && !Array.isArray(data);
-}
-
-export function areCloseEnough(a, b, epsilon = 1e-15) {
-  return Math.abs(a - b) <= epsilon * Math.max(Math.abs(a), Math.abs(b));
-}
-
 export function getUTF16Length(str) {
   let length = 0;
   for (let i = 0; i < str.length; i++) {
@@ -168,37 +130,61 @@ export function getUTF16Length(str) {
   return length;
 }
 
-export function deepClone(obj: any): any {
-  if (Array.isArray(obj)) {
-    const result = [];
-    for (let i = 0; i < obj.length; i++) {
-      result[i] = deepClone(obj[i]);
-    }
-    return result;
-  }
+export function isCompiledSchema(subSchema: any): subSchema is CompiledSchema {
+  return (
+    !!subSchema &&
+    typeof subSchema === "object" &&
+    !Array.isArray(subSchema) &&
+    "$validate" in subSchema
+  );
+}
 
-  // Is class instance of any kind
-  if (obj && obj.constructor && obj.constructor.name !== "Object") {
-    return obj;
+export function getNamedFunction<T>(name: string, fn: T): T {
+  return Object.defineProperty(fn, "name", { value: name });
+}
+
+export function resolvePath(root: any, path: string): any {
+  if (!path || path === "#") {
+    return root;
   }
 
-  if (isObject(obj)) {
-    const result = {
-      ...obj
-    };
-    for (const key in obj) {
-      result[key] = deepClone(obj[key]);
+  // JSON Pointer
+  if (path.startsWith("#/")) {
+    const parts = path.split("/").slice(1);
+    let current = root;
+
+    for (const part of parts) {
+      const decodedUriPart = decodeURIComponent(part);
+      const key = decodedUriPart.replace(/~1/g, "/").replace(/~0/g, "~");
+
+      if (current && typeof current === "object" && key in current) {
+        current = current[key];
+      } else {
+        return;
+      }
     }
-    return result;
+    return current;
   }
 
-  return obj;
-}
+  // Simple lookup by definition name (non-standard, but useful)
+  if (!path.includes("#")) {
+    if (root.definitions && root.definitions[path]) {
+      return root.definitions[path];
+    }
+    if (root.defs && root.defs[path]) {
+      return root.defs[path];
+    }
 
-export function isCompiledSchema(subSchema: any): subSchema is CompiledSchema {
-  return isObject(subSchema) && "$validate" in subSchema;
+    if (root.$id && typeof root.$id === "string") {
+      if (root.$id === path || root.$id.endsWith("/" + path)) {
+        return root;
+      }
+    }
+  }
+
+  return;
 }
 
-export function getNamedFunction<T>(name: string, fn: T): T {
-  return Object.defineProperty(fn, "name", { value: name });
+export function areCloseEnough(a: number, b: number, epsilon = 1e-15): boolean {
+  return Math.abs(a - b) <= epsilon * Math.max(Math.abs(a), Math.abs(b));
 }

package/lib/utils/pattern-matcher.ts

@@ -0,0 +1,66 @@
+const REGEX_META_CHARS = /[\\.^$*+?()[\]{}|]/;
+
+function hasRegexMeta(value: string) {
+  return REGEX_META_CHARS.test(value);
+}
+
+const PATTERN_CACHE = new Map<string, CompiledPatternMatcher>();
+
+export type CompiledPatternMatcher = RegExp | ((value: string) => boolean);
+
+export function compilePatternMatcher(pattern: string): CompiledPatternMatcher {
+  const cached = PATTERN_CACHE.get(pattern);
+  if (cached) {
+    return cached;
+  }
+
+  let compiled: CompiledPatternMatcher;
+
+  if (pattern.length === 0) {
+    compiled = (_value: string) => true;
+  } else if (!hasRegexMeta(pattern)) {
+    compiled = (value: string) => value.includes(pattern);
+  } else {
+    const patternLength = pattern.length;
+
+    if (patternLength >= 2 && pattern[0] === "^" && pattern[patternLength - 1] === "$") {
+      const inner = pattern.slice(1, -1);
+      if (!hasRegexMeta(inner)) {
+        if (inner.length === 0) {
+          compiled = (value: string) => value.length === 0;
+        } else {
+          compiled = (value: string) => value === inner;
+        }
+      } else {
+        compiled = new RegExp(pattern, "u");
+      }
+    } else if (pattern[0] === "^") {
+      const inner = pattern.slice(1);
+      if (!hasRegexMeta(inner)) {
+        if (inner.length === 0) {
+          compiled = (_value: string) => true;
+        } else {
+          compiled = (value: string) => value.startsWith(inner);
+        }
+      } else {
+        compiled = new RegExp(pattern, "u");
+      }
+    } else if (pattern[patternLength - 1] === "$") {
+      const inner = pattern.slice(0, -1);
+      if (!hasRegexMeta(inner)) {
+        if (inner.length === 0) {
+          compiled = (_value: string) => true;
+        } else {
+          compiled = (value: string) => value.endsWith(inner);
+        }
+      } else {
+        compiled = new RegExp(pattern, "u");
+      }
+    } else {
+      compiled = new RegExp(pattern, "u");
+    }
+  }
+
+  PATTERN_CACHE.set(pattern, compiled);
+  return compiled;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schema-shield",
-  "version": "0.0.6",
+  "version": "1.0.1",
   "description": "A fast library that protects your JSON schema from invalid data.",
   "repository": "git@github.com:Masquerade-Circus/schema-shield.git",
   "author": "Masquerade <christian@masquerade-circus.net>",
@@ -74,7 +74,7 @@
     "dev:source": "NODE_ENV=development nodemon --enable-source-maps -e tsx,ts,json,css -w ./lib -w ./www source.js",
     "build": "node source.js",
     "coverage": "nyc report --reporter=lcov",
-    "commit": "git add . && git-cz",
+    "commit": "git add . && git-cz && git push",
     "release": "release-it --verbose",
     "release-test": "release-it --dry-run --verbose"
   },

package/tsconfig.json

@@ -1,12 +1,12 @@
 {
   "compilerOptions": {
     "jsx": "preserve",
-    "target": "ES2021",
-    "moduleResolution": "nodenext",
-    "resolveJsonModule": true,
+    "target": "esnext",
     "allowSyntheticDefaultImports": true,
     "allowJs": true,
-    "esModuleInterop": true
+    "esModuleInterop": true,
+    "noEmit": false,
+    "emitDeclarationOnly": false
   },
   "include": ["lib/**/*"],
   "exclude": ["**/*.spec.ts", "node_modules/**/*", "docs/**/*"],

package/dist/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,CAAM;IACxB,YAAY,EAAE,MAAM,CAAM;IAC1B,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB,OAAO,CAAC,SAAS;IAqBjB,QAAQ,IAAI,eAAe;IAI3B,OAAO,CAAC,QAAQ;IAiBhB,OAAO,IAAI,SAAS;IAKpB,OAAO;;;;CAOR;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAAC;CAClE;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,uBAkBvB;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,WAoCxC;AAED,wBAAgB,QAAQ,CAAC,IAAI,KAAA,WAE5B;AAED,wBAAgB,cAAc,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA,EAAE,OAAO,SAAQ,WAEnD;AAED,wBAAgB,cAAc,CAAC,GAAG,KAAA,UAUjC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAyBvC;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,IAAI,cAAc,CAE5E;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAE1D"}