lib: add internal Temporal utils

Renegade334 · Renegade334 · commit 907a6ebbcd06 · 2026-05-15T00:55:26.000+02:00
Signed-off-by: Renegade334 &lt;contact.9a5d6388@renegade334.me.uk&gt;
diff --git a/lib/internal/process/pre_execution.js b/lib/internal/process/pre_execution.js
@@ -138,6 +138,8 @@ function prepareExecution(options) {
 
   require('internal/dns/utils').initializeDns();
 
+  require('internal/util/temporal').initialize();
+
   if (isMainThread) {
     assert(internalBinding('worker').isMainThread);
     // Worker threads will get the manifest in the message handler.
diff --git a/lib/internal/util/temporal.js b/lib/internal/util/temporal.js
@@ -0,0 +1,98 @@
+'use strict';
+
+// This module is initialized in the pre-execution phase, before user code is
+// run. Since the module namespace is not populated at snapshot time, this
+// module should be not be imported with a destructuring pattern from within
+// snapshotted modules unless imported lazily.
+
+// TODO(Renegade334): Remove typecheck methods once available via V8 API.
+// Replace with primordials if/when temporal_rs becomes a mandatory V8
+// build dependency and the harmony_temporal flag is removed.
+
+const {
+  ArrayPrototypeForEach,
+  FunctionPrototypeCall,
+  ObjectEntries,
+  ObjectGetOwnPropertyDescriptors,
+  SafeMap,
+  StringPrototypeSubstring,
+  StringPrototypeToUpperCase,
+  globalThis,
+  uncurryThis,
+} = primordials;
+
+// The keys of this Map are the Temporal constructor names.
+// The values are the names of the most lightweight brand-aware getter within
+// each prototype, which can be called speculatively as a brand check.
+const constructors = new SafeMap()
+    .set('Duration', 'nanoseconds')
+    .set('Instant', 'epochNanoseconds')
+    .set('PlainDate', 'calendarId')
+    .set('PlainDateTime', 'calendarId')
+    .set('PlainMonthDay', 'calendarId')
+    .set('PlainTime', 'nanosecond')
+    .set('PlainYearMonth', 'calendarId')
+    .set('ZonedDateTime', 'calendarId');
+
+exports.initialize = () => {
+  const { Temporal } = globalThis;
+
+  if (Temporal === undefined) {
+    exports.hasTemporal = false;
+
+    for (const name of constructors.keys()) {
+      exports[`isTemporal${name}`] = () => false;
+    }
+
+    return;
+  }
+
+  exports.hasTemporal = true;
+
+  for (const { 0: name, 1: brandedGetter } of constructors.entries()) {
+    const constructor = Temporal[name];
+    exports[`Temporal${name}`] = constructor;
+
+    ArrayPrototypeForEach(
+      ObjectEntries(ObjectGetOwnPropertyDescriptors(constructor)),
+      ({ 0: key, 1: desc }) => {
+        if (typeof key === 'string' && typeof desc.value === 'function') {
+          exports[`Temporal${name}${capitalizeKey(key)}`] = desc.value;
+        }
+      },
+    );
+
+    ArrayPrototypeForEach(
+      ObjectEntries(ObjectGetOwnPropertyDescriptors(constructor.prototype)),
+      ({ 0: key, 1: desc }) => {
+        if (typeof key !== 'string') return;
+
+        if ('get' in desc) {
+          exports[`Temporal${name}PrototypeGet${capitalizeKey(key)}`] = uncurryThis(desc.get);
+          if (key === brandedGetter) {
+            exports[`isTemporal${name}`] = makeTypeCheckMethod(desc.get);
+          }
+        } else {
+          exports[`Temporal${name}Prototype${capitalizeKey(key)}`] = typeof desc.value === 'function' ?
+            uncurryThis(desc.value) :
+            desc.value;
+        }
+      },
+    );
+  }
+};
+
+function makeTypeCheckMethod(getter) {
+  return (value) => {
+    try {
+      FunctionPrototypeCall(getter, value);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+}
+
+function capitalizeKey(key) {
+  return `${StringPrototypeToUpperCase(key[0])}${StringPrototypeSubstring(key, 1)}`;
+}
diff --git a/test/parallel/test-bootstrap-modules.js b/test/parallel/test-bootstrap-modules.js
@@ -121,6 +121,7 @@ expected.beforePreExec = new Set([
 
 expected.atRunTime = new Set([
   'NativeModule internal/process/pre_execution',
+  'NativeModule internal/util/temporal',
 ]);
 
 const { isMainThread } = require('worker_threads');
diff --git a/test/parallel/test-temporal-utils-no-temporal.js b/test/parallel/test-temporal-utils-no-temporal.js
@@ -0,0 +1,18 @@
+// Flags: --expose-internals --no-harmony-temporal --no-warnings
+
+'use strict';
+
+const common = require('../common');
+const assert = require('assert');
+
+common.allowGlobals(globalThis.Temporal = {
+  Instant: class Instant {},
+});
+
+const instant = new Temporal.Instant();
+
+// Module contents should be independent of global state at require time
+const temporalUtils = require('internal/util/temporal');
+
+assert.strictEqual(temporalUtils.hasTemporal, false);
+assert.strictEqual(temporalUtils.isTemporalInstant(instant), false);
diff --git a/test/parallel/test-temporal-utils.js b/test/parallel/test-temporal-utils.js
@@ -0,0 +1,25 @@
+// Flags: --expose-internals --no-warnings
+
+'use strict';
+
+const common = require('../common');
+const assert = require('assert');
+
+if (!common.hasTemporal) {
+  common.skip('No Temporal support');
+}
+
+const instant = Temporal.Now.instant();
+
+delete globalThis.Temporal;
+assert.strictEqual(typeof Temporal, 'undefined');
+
+// Module contents should be independent of global state at require time
+const temporalUtils = require('internal/util/temporal');
+
+assert.strictEqual(temporalUtils.hasTemporal, true);
+assert.strictEqual(instant.constructor, temporalUtils.TemporalInstant);
+assert.strictEqual(instant.epochNanoseconds,
+                   temporalUtils.TemporalInstantPrototypeGetEpochNanoseconds(instant));
+assert.strictEqual(temporalUtils.isTemporalInstant(instant), true);
+assert.strictEqual(temporalUtils.isTemporalZonedDateTime(instant), false);
