@optique/config 1.0.0-dev.1163 → 1.0.0-dev.1169

package/dist/index.cjs

@@ -327,6 +327,29 @@ function getTypeName(value) {
 	if (Array.isArray(value)) return "array";
 	return typeof value;
 }
+function isPromiseLike(value) {
+	return value != null && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function";
+}
+/**
+* Detects native Promises and cross-realm Promises.  Cross-realm
+* Promises fail `instanceof Promise` but still carry the spec-required
+* `Symbol.toStringTag === "Promise"`.  Domain objects that merely
+* define a `then()` method are not matched unless they also set
+* `Symbol.toStringTag` to `"Promise"`.
+*/
+function isPromise(value) {
+	if (value instanceof Promise) return true;
+	if (value == null || typeof value !== "object" && typeof value !== "function") return false;
+	return isPromiseLike(value) && value[Symbol.toStringTag] === "Promise";
+}
+function validateLoadResult(loaded) {
+	if (loaded == null || typeof loaded !== "object" || Array.isArray(loaded)) throw new TypeError(`Expected load() to return an object, but got: ${getTypeName(loaded)}.`);
+	if (!("config" in loaded)) throw new TypeError("Expected load() result to have a config property.");
+	const result = loaded;
+	if (isPromise(result.config)) throw new TypeError("Expected config in load() result to not be a Promise. Resolve the Promise before returning.");
+	if (isPromise(result.meta)) throw new TypeError("Expected meta in load() result to not be a Promise. Resolve the Promise before returning.");
+	return loaded;
+}
 function isStandardSchema(value) {
 	if (value == null || typeof value !== "object" && typeof value !== "function") return false;
 	if (!("~standard" in value)) return false;
@@ -426,8 +449,13 @@ function createConfigContext(options) {
 			};
 			if (opts.load) {
 				const loaded = opts.load(parsedPlaceholder);
-				if (loaded instanceof Promise) return loaded.then(({ config, meta }) => validateAndBuildAnnotations(config, meta));
-				return validateAndBuildAnnotations(loaded.config, loaded.meta);
+				if (isPromise(loaded)) return Promise.resolve(loaded).then((resolved) => {
+					const validated$1 = validateLoadResult(resolved);
+					return validateAndBuildAnnotations(validated$1.config, validated$1.meta);
+				});
+				if (isPromiseLike(loaded)) throw new TypeError("Expected load() to return a plain object or Promise, but got a thenable. Use a real Promise instead.");
+				const validated = validateLoadResult(loaded);
+				return validateAndBuildAnnotations(validated.config, validated.meta);
 			}
 			if (opts.getConfigPath) {
 				const configPath = opts.getConfigPath(parsedPlaceholder);

package/dist/index.js

@@ -304,6 +304,29 @@ function getTypeName(value) {
 	if (Array.isArray(value)) return "array";
 	return typeof value;
 }
+function isPromiseLike(value) {
+	return value != null && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function";
+}
+/**
+* Detects native Promises and cross-realm Promises.  Cross-realm
+* Promises fail `instanceof Promise` but still carry the spec-required
+* `Symbol.toStringTag === "Promise"`.  Domain objects that merely
+* define a `then()` method are not matched unless they also set
+* `Symbol.toStringTag` to `"Promise"`.
+*/
+function isPromise(value) {
+	if (value instanceof Promise) return true;
+	if (value == null || typeof value !== "object" && typeof value !== "function") return false;
+	return isPromiseLike(value) && value[Symbol.toStringTag] === "Promise";
+}
+function validateLoadResult(loaded) {
+	if (loaded == null || typeof loaded !== "object" || Array.isArray(loaded)) throw new TypeError(`Expected load() to return an object, but got: ${getTypeName(loaded)}.`);
+	if (!("config" in loaded)) throw new TypeError("Expected load() result to have a config property.");
+	const result = loaded;
+	if (isPromise(result.config)) throw new TypeError("Expected config in load() result to not be a Promise. Resolve the Promise before returning.");
+	if (isPromise(result.meta)) throw new TypeError("Expected meta in load() result to not be a Promise. Resolve the Promise before returning.");
+	return loaded;
+}
 function isStandardSchema(value) {
 	if (value == null || typeof value !== "object" && typeof value !== "function") return false;
 	if (!("~standard" in value)) return false;
@@ -403,8 +426,13 @@ function createConfigContext(options) {
 			};
 			if (opts.load) {
 				const loaded = opts.load(parsedPlaceholder);
-				if (loaded instanceof Promise) return loaded.then(({ config, meta }) => validateAndBuildAnnotations(config, meta));
-				return validateAndBuildAnnotations(loaded.config, loaded.meta);
+				if (isPromise(loaded)) return Promise.resolve(loaded).then((resolved) => {
+					const validated$1 = validateLoadResult(resolved);
+					return validateAndBuildAnnotations(validated$1.config, validated$1.meta);
+				});
+				if (isPromiseLike(loaded)) throw new TypeError("Expected load() to return a plain object or Promise, but got a thenable. Use a real Promise instead.");
+				const validated = validateLoadResult(loaded);
+				return validateAndBuildAnnotations(validated.config, validated.meta);
 			}
 			if (opts.getConfigPath) {
 				const configPath = opts.getConfigPath(parsedPlaceholder);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/config",
-  "version": "1.0.0-dev.1163+65b042cd",
+  "version": "1.0.0-dev.1169+d2c2243d",
   "description": "Configuration file support for Optique with Standard Schema validation",
   "keywords": [
     "CLI",
@@ -59,7 +59,7 @@
     "@standard-schema/spec": "^1.1.0"
   },
   "dependencies": {
-    "@optique/core": "1.0.0-dev.1163+65b042cd"
+    "@optique/core": "1.0.0-dev.1169+d2c2243d"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -67,7 +67,7 @@
     "tsdown": "^0.13.0",
     "typescript": "^5.8.3",
     "zod": "^3.25.0 || ^4.0.0",
-    "@optique/env": "1.0.0-dev.1163+65b042cd"
+    "@optique/env": "1.0.0-dev.1169+d2c2243d"
   },
   "scripts": {
     "build": "tsdown",