breeze-client 2.2.2 → 3.0.0

package/metadata/data-type.js

@@ -0,0 +1,465 @@
+import { core, getUuid } from '../core/core.js';
+import { BreezeEnum } from '../core/enum.js';
+import { Validator } from '../validation/validate.js';
+// A date-time with no zone that ends in fractional seconds, of any length: Json.NET drops trailing
+// zeros, so 500 ms is ".5". It used to be /.\d{3}$/, which needed three digits and, with its
+// unescaped dot, also matched an offset written without a colon ("+0200").
+const _fractionalSecondsRegex = /\d\d\.\d+$/;
+// Names the .NET servers can write in metadata for types the client knows by another name.
+// EF Core writes the CLR type name (MetadataBuilder.NormalizeDataTypeName); NHibernate its own type names.
+const _dataTypeAliases = {
+    TimeSpan: "Time",
+    Char: "String",
+    SByte: "Int16",
+    UInt16: "Int32",
+    UInt32: "Int64",
+    UInt64: "Int64",
+    AnsiString: "String", // NHibernate
+    AnsiChar: "String", // NHibernate
+    StringClob: "String", // NHibernate
+};
+/**
+DataType is an 'Enum' containing all of the supported data types.
+*/
+export class DataType extends BreezeEnum {
+    /**
+    The function Breeze converts `DateTime` and `DateTimeOffset` values from the server with, when it
+    materializes query and save results. Defaults to {@link DataType.parseDateAsUTC}. Replace it at
+    startup, before the first query, to change how a date-time string with no offset is read - for
+    example with {@link DataType.parseDateAsLocal}. It does not affect saves, which always send UTC.
+    */
+    static parseDateFromServer = (value) => DataType.parseDateAsUTC(value);
+    // same effect as above but doesn't give right TSDOC.
+    // static parseDateFromServer = DataType.parseDateAsUTC;
+    /** @hidden @internal */
+    static constants;
+    /** A string (.NET `String`; also `Char`). Default `""`. */
+    static String = new DataType({
+        defaultValue: "",
+        parse: coerceToString,
+        getNext: getNextString
+    });
+    /** A 64-bit integer (.NET `Int64`; also `UInt32` and `UInt64`), held as a JavaScript `number`, so values beyond ±2^53 lose precision. Default `0`. */
+    static Int64 = new DataType({
+        defaultValue: 0,
+        isNumeric: true,
+        isInteger: true,
+        parse: coerceToInt,
+        getNext: getNextNumber
+    });
+    /** A 32-bit integer (.NET `Int32`; also `UInt16`), held as a `number`. Default `0`. */
+    static Int32 = new DataType({
+        defaultValue: 0,
+        isNumeric: true,
+        isInteger: true,
+        parse: coerceToInt,
+        getNext: getNextNumber
+    });
+    /** A 16-bit integer (.NET `Int16`; also `SByte`), held as a `number`. Default `0`. */
+    static Int16 = new DataType({
+        defaultValue: 0,
+        isNumeric: true,
+        isInteger: true,
+        parse: coerceToInt,
+        getNext: getNextNumber
+    });
+    /** An unsigned 8-bit integer, 0 to 255 (.NET `Byte`), held as a `number`. Default `0`. */
+    static Byte = new DataType({
+        defaultValue: 0,
+        isNumeric: true,
+        isInteger: true,
+        parse: coerceToInt,
+    });
+    /** A decimal number (.NET `Decimal`), held as a JavaScript `number` - a double - so digits beyond its precision are lost. Default `0`. */
+    static Decimal = new DataType({
+        defaultValue: 0,
+        isNumeric: true,
+        isFloat: true,
+        parse: coerceToFloat,
+        getNext: getNextNumber
+    });
+    /** A 64-bit floating-point number (.NET `Double`). Also the type Breeze infers for an unmapped property that holds a number. Default `0`. */
+    static Double = new DataType({
+        defaultValue: 0,
+        isNumeric: true,
+        isFloat: true,
+        parse: coerceToFloat,
+        getNext: getNextNumber
+    });
+    /** A 32-bit floating-point number (.NET `Single`), held as a `number`. Default `0`. */
+    static Single = new DataType({
+        defaultValue: 0,
+        isNumeric: true,
+        isFloat: true,
+        parse: coerceToFloat,
+        getNext: getNextNumber
+    });
+    /** A calendar date with no time (.NET `DateOnly`), held as a `Date` at local midnight. Read from the first ten characters (`YYYY-MM-DD`) of the server's value, sent back as `YYYY-MM-DD` from the local date, and compared by date alone. Default 1 January 1900. */
+    static DateOnly = new DataType({
+        defaultValue: new Date(1900, 0, 1),
+        isDate: true,
+        parse: coerceToDateOnly,
+        parseRawValue: parseRawDateOnly,
+        normalize: normalizeDateOnly, // dates don't perform equality comparisons properly
+        getNext: getNextDateTime,
+        getConcurrencyValue: getConcurrencyDateTime
+    });
+    /** A date and time (.NET `DateTime`), held as a `Date`. Read from the server with {@link DataType.parseDateFromServer} and sent as ISO 8601 in UTC. Also the type Breeze infers for an unmapped property that holds a `Date`. Default 1 January 1900, local midnight. */
+    static DateTime = new DataType({
+        defaultValue: new Date(1900, 0, 1),
+        isDate: true,
+        parse: coerceToDate,
+        parseRawValue: parseRawDate,
+        normalize: function (value) { return value && value.getTime && value.getTime(); }, // dates don't perform equality comparisons properly
+        getNext: getNextDateTime,
+        getConcurrencyValue: getConcurrencyDateTime
+    });
+    /** A date and time with an offset (.NET `DateTimeOffset`), held as a `Date`, which has no offset: it is read with {@link DataType.parseDateFromServer} and sent back in UTC, so the original offset is lost. Default 1 January 1900, local midnight. */
+    static DateTimeOffset = new DataType({
+        defaultValue: new Date(1900, 0, 1),
+        isDate: true,
+        parse: coerceToDate,
+        parseRawValue: parseRawDate,
+        normalize: function (value) { return value && value.getTime && value.getTime(); }, // dates don't perform equality comparisons properly
+        getNext: getNextDateTime,
+        getConcurrencyValue: getConcurrencyDateTime
+    });
+    /** A duration (.NET `TimeSpan`), held as the ISO 8601 duration string the server sends, such as `PT4H30M`. Compared as a number of seconds in local queries. Default `PT0S`. */
+    static Time = new DataType({
+        defaultValue: "PT0S",
+        // Looked up on each call, not captured here, so that replacing parseTimeFromServer works.
+        parseRawValue: (value) => DataType.parseTimeFromServer(value)
+    });
+    /** A time of day (.NET `TimeOnly`), held as the string the server sends: "14:30:00" or "01:23:45.678". */
+    static TimeOnly = new DataType({
+        defaultValue: "00:00:00"
+    });
+    /** A `true` or `false` value (.NET `Boolean`). Default `false`. */
+    static Boolean = new DataType({
+        defaultValue: false,
+        parse: coerceToBool,
+    });
+    /** A GUID (.NET `Guid`), held as a lower-case string. Default `"00000000-0000-0000-0000-000000000000"`. */
+    static Guid = new DataType({
+        defaultValue: "00000000-0000-0000-0000-000000000000",
+        parse: coerceToGuid,
+        getNext: getNextGuid,
+        parseRawValue: function (val) { return val.toLowerCase(); },
+        getConcurrencyValue: getUuid
+    });
+    /** Binary data (.NET `byte[]`), such as a SQL `rowversion`, held as the base64 string the server sends. Default `null`. */
+    static Binary = new DataType({
+        defaultValue: null,
+        parseRawValue: parseRawBinary
+    });
+    /** An unknown type: a server type name the client does not recognize (the original is kept in the property's `rawTypeName`), or an unmapped property whose type cannot be inferred. Values are not converted or validated. Default `undefined`. */
+    static Undefined = new DataType({
+        defaultValue: undefined,
+    });
+    /**
+    Returns the function Breeze uses to turn values of a data type into something `===`, `<` and `>`
+    compare correctly, in local queries and when ordering: the data type's `normalize` if it has one,
+    a conversion to seconds for {@link DataType.Time}, and otherwise the value itself. Applications do
+    not normally need it.
+    @param dataType - The data type of the values to compare.
+    */
+    static getComparableFn(dataType) {
+        if (dataType && dataType.normalize) {
+            return dataType.normalize;
+        }
+        else if (dataType === DataType.Time) {
+            // durations must be converted to compare them
+            return function (value) {
+                return value && core.durationToSeconds(value);
+            };
+        }
+        else {
+            // TODO: __identity
+            return function (value) {
+                return value;
+            };
+        }
+    }
+    /**
+    Returns the DataType with the specified name, or undefined if there is none. Also accepts the names the .NET
+    servers use for some types, such as 'TimeSpan' for {@link DataType.Time}.
+    */
+    static fromName(name) {
+        const dt = super.fromName(name) || super.fromName(_dataTypeAliases[name]);
+        return dt instanceof DataType ? dt : undefined;
+    }
+    /** Returns the DataType for a specified input. */
+    static fromValue(val) {
+        if (core.isDate(val))
+            return DataType.DateTime;
+        switch (typeof val) {
+            case "string":
+                if (core.isGuid(val))
+                    return DataType.Guid;
+                // the >3 below is a hack to insure that if we are inferring datatypes that
+                // very short strings that are valid but unlikely ISO encoded Time's are treated as strings instead.
+                else if (core.isDuration(val) && val.length > 3)
+                    return DataType.Time;
+                else if (core.isDateString(val))
+                    return DataType.DateTime;
+                return DataType.String;
+            case "boolean":
+                return DataType.Boolean;
+            case "number":
+                return DataType.Double;
+        }
+        return DataType.Undefined;
+    }
+    /**
+    Converts a {@link DataType.Time} value from the server. By default it returns the value unchanged:
+    a `Time` is held as the ISO 8601 duration string the server sends, such as `PT4H30M`. Replace it
+    at startup, before the first query, to hold durations some other way - as a number of seconds,
+    say, with {@link core.durationToSeconds}.
+    */
+    static parseTimeFromServer(source) {
+        return source;
+    }
+    /**
+    Converts a date-time string from the server to a `Date`. This is the default
+    {@link DataType.parseDateFromServer}.
+    - A string with `Z` or an offset (`2024-03-15T10:30:00Z`, `...10:30:00+02:00`) is read as given.
+    - A string with no offset that ends in fractional seconds, of any length
+      (`2024-03-15T10:30:00.5`, `...00.000`, `...00.1234567`), is read as UTC: Breeze appends `Z`.
+    - Any other string with no offset, such as `2024-03-15T10:30:00`, goes to `Date.parse`
+      unchanged, which reads it as **local** time.
+    @param source - The value from the server.
+    */
+    static parseDateAsUTC(source) {
+        if (typeof source === 'string') {
+            // No zone but fractional seconds: the server wrote UTC without saying so. Append the Z.
+            if (_fractionalSecondsRegex.test(source))
+                source = source + 'Z';
+        }
+        source = new Date(Date.parse(source));
+        return source;
+    }
+    /** Parse as UTC then shift to local time */
+    static parseDateAsLocal(source) {
+        var dt = DataType.parseDateAsUTC(source);
+        if (core.isDate(dt)) {
+            dt = new Date(dt.getTime() + dt.getTimezoneOffset() * 60000);
+        }
+        return dt;
+    }
+    ;
+    /** if val is a Date, return a date-only string e.g. '2023-12-31' */
+    static toDateOnlyString(val) {
+        // DateOnly types should not have time component, but JSON.stringify makes a full ISO string.
+        // We convert it to string here to prevent that, and shift the time zone because toISOString converts to UTC.
+        return val && val.getTime && new Date(val.getTime() - val.getTimezoneOffset() * 60000).toISOString().substring(0, 10) || val;
+    }
+    /** Returns a raw value converted to the specified DataType */
+    static parseRawValue(val, dataType) {
+        // undefined values will be the default for most unmapped properties EXCEPT when they are set
+        // in a jsonResultsAdapter ( an unusual use case).
+        if (val === undefined)
+            return undefined;
+        if (!val)
+            return val;
+        if (dataType && dataType.parseRawValue) {
+            val = dataType.parseRawValue(val);
+        }
+        return val;
+    }
+    /** @hidden @internal */
+    // used during initialization; visible on instance for testing purposes.
+    static _resetConstants() {
+        DataType.constants = {
+            stringPrefix: "K_",
+            nextNumber: -1,
+            nextNumberIncrement: -1
+        };
+    }
+}
+DataType.prototype._$typeName = "DataType";
+DataType._resetConstants();
+DataType.resolveSymbols();
+DataType.getSymbols().forEach((sym) => sym.validatorCtor = getValidatorCtor(sym));
+// private functions;
+function getValidatorCtor(dataType) {
+    switch (dataType) {
+        case DataType.String:
+            return Validator.string;
+        case DataType.Int64:
+            return Validator.int64;
+        case DataType.Int32:
+            return Validator.int32;
+        case DataType.Int16:
+            return Validator.int16;
+        case DataType.Decimal:
+            return Validator.number;
+        case DataType.Double:
+            return Validator.number;
+        case DataType.Single:
+            return Validator.number;
+        case DataType.DateTime:
+            return Validator.date;
+        case DataType.DateTimeOffset:
+            return Validator.date;
+        case DataType.DateOnly:
+            return Validator.date;
+        case DataType.Boolean:
+            return Validator.bool;
+        case DataType.Guid:
+            return Validator.guid;
+        case DataType.Byte:
+            return Validator.byte;
+        case DataType.Binary:
+            // TODO: don't quite know how to validate this yet.
+            return Validator.none;
+        case DataType.Time:
+            return Validator.duration;
+        case DataType.TimeOnly:
+            return timeOnlyValidator;
+        case DataType.Undefined:
+            return Validator.none;
+    }
+}
+/** A .NET TimeOnly as the server writes and reads it: "HH:mm", "HH:mm:ss" or "HH:mm:ss.fffffff". */
+function timeOnlyValidator(context) {
+    return Validator.regularExpression({ ...context, expression: "^([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d{1,7})?)?$" });
+}
+/** Local midnight on the day of a DateOnly value, so that values on the same day compare equal and order correctly. */
+function normalizeDateOnly(value) {
+    if (!(value && value.getTime))
+        return value;
+    const day = new Date(value.getTime());
+    day.setHours(0, 0, 0, 0);
+    return day.getTime();
+}
+function getNextString() {
+    return DataType.constants.stringPrefix + getNextNumber().toString();
+}
+function getNextNumber() {
+    let result = DataType.constants.nextNumber;
+    DataType.constants.nextNumber += DataType.constants.nextNumberIncrement;
+    return result;
+}
+function getNextGuid() {
+    return getUuid();
+}
+function getNextDateTime() {
+    return new Date();
+}
+function getConcurrencyDateTime(val) {
+    // use the current datetime but insure that it is different from previous call.
+    let dt = new Date();
+    let dt2 = new Date();
+    while (dt.getTime() === dt2.getTime()) {
+        dt2 = new Date();
+    }
+    return dt2;
+}
+function coerceToString(source, sourceTypeName) {
+    return (source == null) ? source : source.toString();
+}
+function coerceToGuid(source, sourceTypeName) {
+    if (sourceTypeName === "string") {
+        return source.trim().toLowerCase();
+    }
+    return source;
+}
+function coerceToInt(source, sourceTypeName) {
+    if (sourceTypeName === "string") {
+        let src = source.trim();
+        if (src === "")
+            return null;
+        let val = parseInt(src, 10);
+        return isNaN(val) ? source : val;
+    }
+    else if (sourceTypeName === "number") {
+        return Math.round(source);
+    }
+    // do we want to coerce floats -> ints
+    return source;
+}
+function coerceToFloat(source, sourceTypeName) {
+    if (sourceTypeName === "string") {
+        let src = source.trim();
+        if (src === "")
+            return null;
+        let val = parseFloat(src);
+        return isNaN(val) ? source : val;
+    }
+    return source;
+}
+function coerceToDate(source, sourceTypeName) {
+    let val;
+    if (sourceTypeName === "string") {
+        let src = source.trim();
+        if (!source || !source.trim()) {
+            return null;
+        }
+        val = new Date(Date.parse(src));
+        return core.isDate(val) ? val : source;
+    }
+    else if (sourceTypeName === "number") {
+        val = new Date(source);
+        return core.isDate(val) ? val : source;
+    }
+    return source;
+}
+/** Trim off time portion before parse if source is string */
+function coerceToDateOnly(source, sourceTypeName) {
+    let val;
+    if (sourceTypeName === "string") {
+        if (!source || !source.trim()) {
+            return null;
+        }
+        val = DataType.parseDateAsLocal(source);
+        return core.isDate(val) ? val : source;
+    }
+    else if (sourceTypeName === "number") {
+        val = new Date(source);
+        return core.isDate(val) ? val : source;
+    }
+    return source;
+}
+function coerceToBool(source, sourceTypeName) {
+    if (sourceTypeName === "string") {
+        let src = source.trim().toLowerCase();
+        if (src === "false" || src === "") {
+            return false;
+        }
+        else if (src === "true") {
+            return true;
+        }
+        else {
+            return source;
+        }
+    }
+    return source;
+}
+function parseRawDate(val) {
+    if (!core.isDate(val)) {
+        val = DataType.parseDateFromServer(val);
+    }
+    return val;
+}
+/** Trim off time portion before parse */
+function parseRawDateOnly(val) {
+    if (typeof val === 'string') {
+        if (val.length > 10) {
+            val = val.substring(0, 10);
+        }
+        val = DataType.parseDateAsLocal(val);
+    }
+    return val;
+}
+function parseRawBinary(val) {
+    if (val && val.$value !== undefined) {
+        val = val.$value; // this will be a byte[] encoded as a string
+    }
+    return val;
+}
+//function hasTimeZone(source) {
+//  var ix = source.indexOf("T");
+//  var timePart = source.substring(ix+1);
+//  return  timePart.indexOf("-") >= 0 || timePart.indexOf("+") >= 0 || timePart.indexOf("Z");
+//}
+//# sourceMappingURL=data-type.js.map

package/metadata/data-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-type.js","sourceRoot":"","sources":["../../src/metadata/data-type.ts"],"names":[],"mappings":"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","sourcesContent":["import { core, getUuid } from '../core/core.js';\r\nimport { BreezeEnum } from '../core/enum.js';\r\nimport { Validator } from '../validation/validate.js';\r\n\r\n// A date-time with no zone that ends in fractional seconds, of any length: Json.NET drops trailing\r\n// zeros, so 500 ms is \".5\". It used to be /.\\d{3}$/, which needed three digits and, with its\r\n// unescaped dot, also matched an offset written without a colon (\"+0200\").\r\nconst _fractionalSecondsRegex = /\\d\\d\\.\\d+$/;\r\n\r\n// Names the .NET servers can write in metadata for types the client knows by another name.\r\n// EF Core writes the CLR type name (MetadataBuilder.NormalizeDataTypeName); NHibernate its own type names.\r\nconst _dataTypeAliases: Record<string, string> = {\r\n  TimeSpan: \"Time\",\r\n  Char: \"String\",\r\n  SByte: \"Int16\",\r\n  UInt16: \"Int32\",\r\n  UInt32: \"Int64\",\r\n  UInt64: \"Int64\",\r\n  AnsiString: \"String\",  // NHibernate\r\n  AnsiChar: \"String\",    // NHibernate\r\n  StringClob: \"String\",  // NHibernate\r\n};\r\n\r\n/**  \r\nDataType is an 'Enum' containing all of the supported data types.\r\n*/\r\nexport class DataType extends BreezeEnum {\r\n  /** The default value of this DataType. __Read Only__ */\r\n  declare defaultValue?: any;\r\n  /** Whether this is a 'numeric' DataType. __Read Only__ */\r\n  declare isNumeric?: boolean;\r\n  /** Whether this is an 'integer' DataType. __Read Only__ */\r\n  declare isInteger?: boolean;\r\n\r\n  /** The constructor function to create a {@link Validator} to be used in validating instances of this DataType. */\r\n  validatorCtor?(context?: any): Validator;\r\n  /** \r\n  Optional function to normalize a data value for comparison, if its value cannot be used directly. \r\n  Note that this will be called each time a property is changed, so make it fast.\r\n  @returns value appropriate for this DataType\r\n  */\r\n  normalize?(value: any): any;\r\n  /**\r\n  Optional function to convert a raw (server) value from string to this DataType.\r\n  @returns value appropriate for this DataType\r\n  */\r\n  parseRawValue?(value: any): any;\r\n  /**\r\n  Optional function to convert a value from string to this DataType.  Note that this will be called each time a property is changed, so make it fast.\r\n  @returns value appropriate for this DataType \r\n  */\r\n  parse?(source: any, sourceTypeName: string): any;\r\n  /** \r\n  Optional function to get the next value for key generation, if this datatype is used as a key.  Uses an internal table of previous values.\r\n  @returns value appropriate for this DataType \r\n  */\r\n  getNext?(): any;\r\n  /**\r\n  Optional function to get the next value when the datatype is used as a concurrency property.\r\n  @param previousValue\r\n  @returns the next concurrency value, which may be a function of the previousValue.\r\n  */\r\n  getConcurrencyValue?(previousValue?: any): any;\r\n\r\n  /**\r\n  The function Breeze converts `DateTime` and `DateTimeOffset` values from the server with, when it\r\n  materializes query and save results. Defaults to {@link DataType.parseDateAsUTC}. Replace it at\r\n  startup, before the first query, to change how a date-time string with no offset is read - for\r\n  example with {@link DataType.parseDateAsLocal}. It does not affect saves, which always send UTC.\r\n  */\r\n  static parseDateFromServer = (value: any) => DataType.parseDateAsUTC(value);\r\n  // same effect as above but doesn't give right TSDOC.\r\n  // static parseDateFromServer = DataType.parseDateAsUTC;\r\n\r\n  /** @hidden @internal */\r\n  static constants: { stringPrefix: string, nextNumber: number, nextNumberIncrement: number };\r\n\r\n  /** A string (.NET `String`; also `Char`). Default `\"\"`. */\r\n  static String = new DataType({\r\n    defaultValue: \"\",\r\n    parse: coerceToString,\r\n    getNext: getNextString\r\n  });\r\n\r\n  /** A 64-bit integer (.NET `Int64`; also `UInt32` and `UInt64`), held as a JavaScript `number`, so values beyond ±2^53 lose precision. Default `0`. */\r\n  static Int64 = new DataType({\r\n    defaultValue: 0,\r\n    isNumeric: true,\r\n    isInteger: true,\r\n    parse: coerceToInt,\r\n    getNext: getNextNumber\r\n  });\r\n\r\n  /** A 32-bit integer (.NET `Int32`; also `UInt16`), held as a `number`. Default `0`. */\r\n  static Int32 = new DataType({\r\n    defaultValue: 0,\r\n    isNumeric: true,\r\n    isInteger: true,\r\n    parse: coerceToInt,\r\n    getNext: getNextNumber\r\n  });\r\n\r\n  /** A 16-bit integer (.NET `Int16`; also `SByte`), held as a `number`. Default `0`. */\r\n  static Int16 = new DataType({\r\n    defaultValue: 0,\r\n    isNumeric: true,\r\n    isInteger: true,\r\n    parse: coerceToInt,\r\n    getNext: getNextNumber\r\n  });\r\n\r\n  /** An unsigned 8-bit integer, 0 to 255 (.NET `Byte`), held as a `number`. Default `0`. */\r\n  static Byte = new DataType({\r\n    defaultValue: 0,\r\n    isNumeric: true,\r\n    isInteger: true,\r\n    parse: coerceToInt,\r\n  });\r\n\r\n  /** A decimal number (.NET `Decimal`), held as a JavaScript `number` - a double - so digits beyond its precision are lost. Default `0`. */\r\n  static Decimal = new DataType({\r\n    defaultValue: 0,\r\n    isNumeric: true,\r\n    isFloat: true,\r\n    parse: coerceToFloat,\r\n    getNext: getNextNumber\r\n  });\r\n\r\n  /** A 64-bit floating-point number (.NET `Double`). Also the type Breeze infers for an unmapped property that holds a number. Default `0`. */\r\n  static Double = new DataType({\r\n    defaultValue: 0,\r\n    isNumeric: true,\r\n    isFloat: true,\r\n    parse: coerceToFloat,\r\n    getNext: getNextNumber\r\n  });\r\n\r\n  /** A 32-bit floating-point number (.NET `Single`), held as a `number`. Default `0`. */\r\n  static Single = new DataType({\r\n    defaultValue: 0,\r\n    isNumeric: true,\r\n    isFloat: true,\r\n    parse: coerceToFloat,\r\n    getNext: getNextNumber\r\n  });\r\n\r\n  /** A calendar date with no time (.NET `DateOnly`), held as a `Date` at local midnight. Read from the first ten characters (`YYYY-MM-DD`) of the server's value, sent back as `YYYY-MM-DD` from the local date, and compared by date alone. Default 1 January 1900. */\r\n  static DateOnly = new DataType({\r\n    defaultValue: new Date(1900, 0, 1),\r\n    isDate: true,\r\n    parse: coerceToDateOnly,\r\n    parseRawValue: parseRawDateOnly,\r\n    normalize: normalizeDateOnly, // dates don't perform equality comparisons properly\r\n    getNext: getNextDateTime,\r\n    getConcurrencyValue: getConcurrencyDateTime\r\n  });\r\n\r\n  /** A date and time (.NET `DateTime`), held as a `Date`. Read from the server with {@link DataType.parseDateFromServer} and sent as ISO 8601 in UTC. Also the type Breeze infers for an unmapped property that holds a `Date`. Default 1 January 1900, local midnight. */\r\n  static DateTime = new DataType({\r\n    defaultValue: new Date(1900, 0, 1),\r\n    isDate: true,\r\n    parse: coerceToDate,\r\n    parseRawValue: parseRawDate,\r\n    normalize: function (value: any) { return value && value.getTime && value.getTime(); }, // dates don't perform equality comparisons properly\r\n    getNext: getNextDateTime,\r\n    getConcurrencyValue: getConcurrencyDateTime\r\n  });\r\n\r\n  /** A date and time with an offset (.NET `DateTimeOffset`), held as a `Date`, which has no offset: it is read with {@link DataType.parseDateFromServer} and sent back in UTC, so the original offset is lost. Default 1 January 1900, local midnight. */\r\n  static DateTimeOffset = new DataType({\r\n    defaultValue: new Date(1900, 0, 1),\r\n    isDate: true,\r\n    parse: coerceToDate,\r\n    parseRawValue: parseRawDate,\r\n    normalize: function (value: any) { return value && value.getTime && value.getTime(); }, // dates don't perform equality comparisons properly\r\n    getNext: getNextDateTime,\r\n    getConcurrencyValue: getConcurrencyDateTime\r\n  });\r\n\r\n  /** A duration (.NET `TimeSpan`), held as the ISO 8601 duration string the server sends, such as `PT4H30M`. Compared as a number of seconds in local queries. Default `PT0S`. */\r\n  static Time = new DataType({\r\n    defaultValue: \"PT0S\",\r\n    // Looked up on each call, not captured here, so that replacing parseTimeFromServer works.\r\n    parseRawValue: (value: any) => DataType.parseTimeFromServer(value)\r\n  });\r\n\r\n  /** A time of day (.NET `TimeOnly`), held as the string the server sends: \"14:30:00\" or \"01:23:45.678\". */\r\n  static TimeOnly = new DataType({\r\n    defaultValue: \"00:00:00\"\r\n  });\r\n\r\n  /** A `true` or `false` value (.NET `Boolean`). Default `false`. */\r\n  static Boolean = new DataType({\r\n    defaultValue: false,\r\n    parse: coerceToBool,\r\n  });\r\n\r\n  /** A GUID (.NET `Guid`), held as a lower-case string. Default `\"00000000-0000-0000-0000-000000000000\"`. */\r\n  static Guid = new DataType({\r\n    defaultValue: \"00000000-0000-0000-0000-000000000000\",\r\n    parse: coerceToGuid,\r\n    getNext: getNextGuid,\r\n    parseRawValue: function (val: string) { return val.toLowerCase(); },\r\n    getConcurrencyValue: getUuid\r\n  });\r\n\r\n  /** Binary data (.NET `byte[]`), such as a SQL `rowversion`, held as the base64 string the server sends. Default `null`. */\r\n  static Binary = new DataType({\r\n    defaultValue: null,\r\n    parseRawValue: parseRawBinary\r\n  });\r\n\r\n  /** An unknown type: a server type name the client does not recognize (the original is kept in the property's `rawTypeName`), or an unmapped property whose type cannot be inferred. Values are not converted or validated. Default `undefined`. */\r\n  static Undefined = new DataType({\r\n    defaultValue: undefined,\r\n  });\r\n\r\n  /**\r\n  Returns the function Breeze uses to turn values of a data type into something `===`, `<` and `>`\r\n  compare correctly, in local queries and when ordering: the data type's `normalize` if it has one,\r\n  a conversion to seconds for {@link DataType.Time}, and otherwise the value itself. Applications do\r\n  not normally need it.\r\n  @param dataType - The data type of the values to compare.\r\n  */\r\n  static getComparableFn(dataType?: DataType) {\r\n    if (dataType && dataType.normalize) {\r\n      return dataType.normalize;\r\n    } else if (dataType === DataType.Time) {\r\n      // durations must be converted to compare them\r\n      return function (value: any) {\r\n        return value && core.durationToSeconds(value);\r\n      };\r\n    } else {\r\n      // TODO: __identity\r\n      return function (value: any) {\r\n        return value;\r\n      };\r\n    }\r\n  }\r\n\r\n  /**\r\n  Returns the DataType with the specified name, or undefined if there is none. Also accepts the names the .NET\r\n  servers use for some types, such as 'TimeSpan' for {@link DataType.Time}.\r\n  */\r\n  static fromName(name: string): DataType | undefined {\r\n    const dt = super.fromName(name) || super.fromName(_dataTypeAliases[name]);\r\n    return dt instanceof DataType ? dt : undefined;\r\n  }\r\n\r\n  /** Returns the DataType for a specified input. */\r\n  static fromValue(val: any) {\r\n    if (core.isDate(val)) return DataType.DateTime;\r\n    switch (typeof val) {\r\n      case \"string\":\r\n        if (core.isGuid(val)) return DataType.Guid;\r\n        // the >3 below is a hack to insure that if we are inferring datatypes that\r\n        // very short strings that are valid but unlikely ISO encoded Time's are treated as strings instead.\r\n        else if (core.isDuration(val) && val.length > 3) return DataType.Time;\r\n        else if (core.isDateString(val)) return DataType.DateTime;\r\n        return DataType.String;\r\n      case \"boolean\":\r\n        return DataType.Boolean;\r\n      case \"number\":\r\n        return DataType.Double;\r\n    }\r\n    return DataType.Undefined;\r\n  }\r\n\r\n  /**\r\n  Converts a {@link DataType.Time} value from the server. By default it returns the value unchanged:\r\n  a `Time` is held as the ISO 8601 duration string the server sends, such as `PT4H30M`. Replace it\r\n  at startup, before the first query, to hold durations some other way - as a number of seconds,\r\n  say, with {@link core.durationToSeconds}.\r\n  */\r\n  static parseTimeFromServer(source: any) {\r\n    return source;\r\n  }\r\n\r\n  /**\r\n  Converts a date-time string from the server to a `Date`. This is the default\r\n  {@link DataType.parseDateFromServer}.\r\n  - A string with `Z` or an offset (`2024-03-15T10:30:00Z`, `...10:30:00+02:00`) is read as given.\r\n  - A string with no offset that ends in fractional seconds, of any length\r\n    (`2024-03-15T10:30:00.5`, `...00.000`, `...00.1234567`), is read as UTC: Breeze appends `Z`.\r\n  - Any other string with no offset, such as `2024-03-15T10:30:00`, goes to `Date.parse`\r\n    unchanged, which reads it as **local** time.\r\n  @param source - The value from the server.\r\n  */\r\n  static parseDateAsUTC(source: any) {\r\n    if (typeof source === 'string') {\r\n      // No zone but fractional seconds: the server wrote UTC without saying so. Append the Z.\r\n      if (_fractionalSecondsRegex.test(source)) source = source + 'Z';\r\n    }\r\n    source = new Date(Date.parse(source));\r\n    return source;\r\n  }\r\n\r\n  /** Parse as UTC then shift to local time */\r\n  static parseDateAsLocal(source: string) {\r\n    var dt = DataType.parseDateAsUTC(source);\r\n    if (core.isDate(dt)) {\r\n        dt = new Date(dt.getTime() + dt.getTimezoneOffset()*60000);\r\n    }\r\n    return dt;\r\n  };\r\n\r\n  /** if val is a Date, return a date-only string e.g. '2023-12-31' */\r\n  static toDateOnlyString(val: any) {\r\n    // DateOnly types should not have time component, but JSON.stringify makes a full ISO string.\r\n    // We convert it to string here to prevent that, and shift the time zone because toISOString converts to UTC.\r\n    return val && val.getTime && new Date(val.getTime() - val.getTimezoneOffset()*60000).toISOString().substring(0, 10) || val;\r\n  }\r\n\r\n  /** Returns a raw value converted to the specified DataType */\r\n  static parseRawValue(val: any, dataType?: DataType) {\r\n    // undefined values will be the default for most unmapped properties EXCEPT when they are set\r\n    // in a jsonResultsAdapter ( an unusual use case).\r\n    if (val === undefined) return undefined;\r\n    if (!val) return val;\r\n    if (dataType && dataType.parseRawValue) {\r\n      val = dataType.parseRawValue(val);\r\n    }\r\n    return val;\r\n  }\r\n\r\n  /** @hidden @internal */\r\n  // used during initialization; visible on instance for testing purposes.\r\n  static _resetConstants() {\r\n    DataType.constants = {\r\n      stringPrefix: \"K_\",\r\n      nextNumber: -1,\r\n      nextNumberIncrement: -1\r\n    };\r\n  }\r\n\r\n}\r\nDataType.prototype._$typeName = \"DataType\";\r\nDataType._resetConstants();\r\nDataType.resolveSymbols();\r\nDataType.getSymbols().forEach((sym: DataType) => sym.validatorCtor = getValidatorCtor(sym));\r\n\r\n// private functions;\r\n\r\n\r\nfunction getValidatorCtor(dataType: DataType) {\r\n  switch (dataType) {\r\n    case DataType.String:\r\n      return Validator.string;\r\n    case DataType.Int64:\r\n      return Validator.int64;\r\n    case DataType.Int32:\r\n      return Validator.int32;\r\n    case DataType.Int16:\r\n      return Validator.int16;\r\n    case DataType.Decimal:\r\n      return Validator.number;\r\n    case DataType.Double:\r\n      return Validator.number;\r\n    case DataType.Single:\r\n      return Validator.number;\r\n    case DataType.DateTime:\r\n      return Validator.date;\r\n    case DataType.DateTimeOffset:\r\n      return Validator.date;\r\n    case DataType.DateOnly:\r\n      return Validator.date;\r\n    case DataType.Boolean:\r\n      return Validator.bool;\r\n    case DataType.Guid:\r\n      return Validator.guid;\r\n    case DataType.Byte:\r\n      return Validator.byte;\r\n    case DataType.Binary:\r\n      // TODO: don't quite know how to validate this yet.\r\n      return Validator.none;\r\n    case DataType.Time:\r\n      return Validator.duration;\r\n    case DataType.TimeOnly:\r\n      return timeOnlyValidator;\r\n    case DataType.Undefined:\r\n      return Validator.none;\r\n  }\r\n}\r\n\r\n/** A .NET TimeOnly as the server writes and reads it: \"HH:mm\", \"HH:mm:ss\" or \"HH:mm:ss.fffffff\". */\r\nfunction timeOnlyValidator(context?: any) {\r\n  return Validator.regularExpression({ ...context, expression: \"^([01]\\\\d|2[0-3]):[0-5]\\\\d(:[0-5]\\\\d(\\\\.\\\\d{1,7})?)?$\" });\r\n}\r\n\r\n/** Local midnight on the day of a DateOnly value, so that values on the same day compare equal and order correctly. */\r\nfunction normalizeDateOnly(value: any) {\r\n  if (!(value && value.getTime)) return value;\r\n  const day = new Date(value.getTime());\r\n  day.setHours(0, 0, 0, 0);\r\n  return day.getTime();\r\n}\r\n\r\nfunction getNextString() {\r\n  return DataType.constants.stringPrefix + getNextNumber().toString();\r\n}\r\n\r\nfunction getNextNumber() {\r\n  let result = DataType.constants.nextNumber;\r\n  DataType.constants.nextNumber += DataType.constants.nextNumberIncrement;\r\n  return result;\r\n}\r\n\r\nfunction getNextGuid() {\r\n  return getUuid();\r\n}\r\n\r\nfunction getNextDateTime() {\r\n  return new Date();\r\n}\r\n\r\nfunction getConcurrencyDateTime(val: any) {\r\n  // use the current datetime but insure that it is different from previous call.\r\n  let dt = new Date();\r\n  let dt2 = new Date();\r\n  while (dt.getTime() === dt2.getTime()) {\r\n    dt2 = new Date();\r\n  }\r\n  return dt2;\r\n}\r\n\r\nfunction coerceToString(source: any, sourceTypeName?: string) {\r\n  return (source == null) ? source : source.toString();\r\n}\r\n\r\nfunction coerceToGuid(source: any, sourceTypeName: string) {\r\n  if (sourceTypeName === \"string\") {\r\n    return source.trim().toLowerCase();\r\n  }\r\n  return source;\r\n}\r\n\r\nfunction coerceToInt(source: any, sourceTypeName: string) {\r\n  if (sourceTypeName === \"string\") {\r\n    let src = source.trim();\r\n    if (src === \"\") return null;\r\n    let val = parseInt(src, 10);\r\n    return isNaN(val) ? source : val;\r\n  } else if (sourceTypeName === \"number\") {\r\n    return Math.round(source);\r\n  }\r\n  // do we want to coerce floats -> ints\r\n  return source;\r\n}\r\n\r\nfunction coerceToFloat(source: any, sourceTypeName: string) {\r\n  if (sourceTypeName === \"string\") {\r\n    let src = source.trim();\r\n    if (src === \"\") return null;\r\n    let val = parseFloat(src);\r\n    return isNaN(val) ? source : val;\r\n  }\r\n  return source;\r\n}\r\n\r\nfunction coerceToDate(source: any, sourceTypeName: string) {\r\n  let val: any;\r\n  if (sourceTypeName === \"string\") {\r\n    let src = source.trim();\r\n    if (!source || !source.trim()) { return null; }\r\n    val = new Date(Date.parse(src));\r\n    return core.isDate(val) ? val : source;\r\n  } else if (sourceTypeName === \"number\") {\r\n    val = new Date(source);\r\n    return core.isDate(val) ? val : source;\r\n  }\r\n  return source;\r\n}\r\n\r\n/** Trim off time portion before parse if source is string */\r\nfunction coerceToDateOnly(source: any, sourceTypeName: string) {\r\n  let val: any;\r\n  if (sourceTypeName === \"string\") {\r\n    if (!source || !source.trim()) { return null; }\r\n    val = DataType.parseDateAsLocal(source);\r\n    return core.isDate(val) ? val : source;\r\n  } else if (sourceTypeName === \"number\") {\r\n    val = new Date(source);\r\n    return core.isDate(val) ? val : source;\r\n  }\r\n  return source;\r\n}\r\n\r\nfunction coerceToBool(source: any, sourceTypeName: string) {\r\n  if (sourceTypeName === \"string\") {\r\n    let src = source.trim().toLowerCase();\r\n    if (src === \"false\" || src === \"\") {\r\n      return false;\r\n    } else if (src === \"true\") {\r\n      return true;\r\n    } else {\r\n      return source;\r\n    }\r\n  }\r\n  return source;\r\n}\r\n\r\n\r\nfunction parseRawDate(val: any) {\r\n  if (!core.isDate(val)) {\r\n    val = DataType.parseDateFromServer(val);\r\n  }\r\n  return val;\r\n}\r\n\r\n/** Trim off time portion before parse */\r\nfunction parseRawDateOnly(val: any) {\r\n  if (typeof val === 'string') {\r\n    if (val.length > 10) {\r\n      val = val.substring(0, 10);\r\n    }\r\n    val = DataType.parseDateAsLocal(val);\r\n  }\r\n  return val;\r\n}\r\n\r\nfunction parseRawBinary(val: any) {\r\n  if (val && val.$value !== undefined) {\r\n    val = val.$value; // this will be a byte[] encoded as a string\r\n  }\r\n  return val;\r\n}\r\n\r\n//function hasTimeZone(source) {\r\n//  var ix = source.indexOf(\"T\");\r\n//  var timePart = source.substring(ix+1);\r\n//  return  timePart.indexOf(\"-\") >= 0 || timePart.indexOf(\"+\") >= 0 || timePart.indexOf(\"Z\");\r\n//}\r\n"]}