@tsed/core 8.33.0 → 8.35.0

package/lib/esm/index.js

@@ -62,6 +62,7 @@ export * from "./utils/isSerializable.js";
 export * from "./utils/isStream.js";
 export * from "./utils/isString.js";
 export * from "./utils/isSymbol.js";
+export * from "./utils/isTemporal.js";
 export * from "./utils/methodsOf.js";
 export * from "./utils/nameOf.js";
 export * from "./utils/objectKeys.js";

package/lib/esm/types/Store.js

@@ -1,11 +1,11 @@
+import { DecoratorTypes } from "./DecoratorTypes.js";
+import { Metadata } from "./Metadata.js";
 import { decoratorTypeOf } from "../utils/decoratorTypeOf.js";
 import { deepClone } from "../utils/deepClone.js";
 import { deepMerge } from "../utils/deepMerge.js";
 import { descriptorOf } from "../utils/descriptorOf.js";
 import { isSymbol } from "../utils/isSymbol.js";
 import { nameOf } from "../utils/nameOf.js";
-import { DecoratorTypes } from "./DecoratorTypes.js";
-import { Metadata } from "./Metadata.js";
 /**
  * Metadata key used to reference the class-level store.
  * @ignore

package/lib/esm/utils/ancestorsOf.js

@@ -1,5 +1,5 @@
-import { getInheritedClass } from "./ancestorOf.js";
 import { classOf } from "./classOf.js";
+import { getInheritedClass } from "./ancestorOf.js";
 import { nameOf } from "./nameOf.js";
 /**
  * Returns all ancestor classes in the prototype chain of the target.

package/lib/esm/utils/isClass.js

@@ -1,11 +1,12 @@
 import { isArrayOrArrayClass } from "./isArray.js";
 import { isArrowFn } from "./isArrowFn.js";
 import { isBuffer } from "./isBuffer.js";
-import { isDate } from "./isDate.js";
 import { isClassObject } from "./isPlainObject.js";
+import { isDate } from "./isDate.js";
 import { isPrimitiveOrPrimitiveClass } from "./isPrimitive.js";
 import { isPromise } from "./isPromise.js";
 import { isSymbol } from "./isSymbol.js";
+import { isTemporal } from "./isTemporal.js";
 /**
  * Determines whether a given value represents a class (constructor function).
  *
@@ -26,6 +27,7 @@ export function isClass(target) {
         isPrimitiveOrPrimitiveClass(target) ||
         isClassObject(target) ||
         isDate(target) ||
+        isTemporal(target) ||
         isPromise(target) ||
         isArrayOrArrayClass(target) ||
         isBuffer(target));

package/lib/esm/utils/isTemporal.js

@@ -0,0 +1,34 @@
+/**
+ * Names of the `Temporal.*` types that serialize to/from an ISO-8601 string. Kept in sync with
+ * the `TemporalMapper` registered by `@tsed/json-mapper`.
+ */
+const TEMPORAL_TYPE_NAMES = [
+    "Instant",
+    "ZonedDateTime",
+    "PlainDate",
+    "PlainDateTime",
+    "PlainTime",
+    "PlainYearMonth",
+    "PlainMonthDay",
+    "Duration"
+];
+/**
+ * Checks if a value is a `Temporal.*` constructor (e.g. `Temporal.Instant`) or an instance of one.
+ *
+ * Like {@link isDate}, these types map to a JSON schema `string`: every `Temporal.*` type exposes a
+ * static `from(string)` factory and an ISO-8601 `toString()`. The global `Temporal` object is
+ * absent on older runtimes (Node < 24), so the check is guarded and returns `false` there.
+ *
+ * @public
+ * @since v8.34.0
+ */
+export function isTemporal(target) {
+    const Temporal = globalThis.Temporal;
+    if (!target || !Temporal) {
+        return false;
+    }
+    return TEMPORAL_TYPE_NAMES.some((name) => {
+        const ctor = Temporal[name];
+        return !!ctor && (target === ctor || target instanceof ctor);
+    });
+}

package/lib/types/index.d.ts

@@ -62,6 +62,7 @@ export * from "./utils/isSerializable.js";
 export * from "./utils/isStream.js";
 export * from "./utils/isString.js";
 export * from "./utils/isSymbol.js";
+export * from "./utils/isTemporal.js";
 export * from "./utils/methodsOf.js";
 export * from "./utils/nameOf.js";
 export * from "./utils/objectKeys.js";

package/lib/types/utils/isTemporal.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Checks if a value is a `Temporal.*` constructor (e.g. `Temporal.Instant`) or an instance of one.
+ *
+ * Like {@link isDate}, these types map to a JSON schema `string`: every `Temporal.*` type exposes a
+ * static `from(string)` factory and an ISO-8601 `toString()`. The global `Temporal` object is
+ * absent on older runtimes (Node < 24), so the check is guarded and returns `false` there.
+ *
+ * @public
+ * @since v8.34.0
+ */
+export declare function isTemporal(target: any): boolean;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@tsed/core",
+  "version": "8.35.0",
   "description": "Core module for Ts.ED Framework",
-  "type": "module",
-  "version": "8.33.0",
   "source": "./src/index.ts",
+  "type": "module",
   "main": "./lib/esm/index.js",
   "module": "./lib/esm/index.js",
   "typings": "./lib/types/index.d.ts",
@@ -39,10 +39,11 @@
     "tslib": ">=2.7.0"
   },
   "devDependencies": {
-    "@tsed/barrels": "8.33.0",
+    "@tsed/barrels": "8.35.0",
     "@tsed/monorepo-utils": "3.0.0",
-    "@tsed/typescript": "8.33.0",
-    "@tsed/vitest": "8.33.0",
+    "@tsed/typescript": "8.35.0",
+    "@tsed/vitest": "8.35.0",
+    "temporal-polyfill": "1.0.1",
     "typescript": "6.0.2",
     "vitest": "4.1.4"
   },

package/vitest.setup.ts

@@ -0,0 +1,6 @@
+import {Temporal} from "temporal-polyfill";
+
+// Provide the global `Temporal` on runtimes that don't ship it natively yet (e.g. Node < 24),
+// so the `isTemporal` specs run in CI instead of throwing. Native `Temporal` (Node >= 24/26) takes
+// precedence and the polyfill is a no-op there.
+(globalThis as {Temporal?: unknown}).Temporal ??= Temporal;