@gooddata/util 11.53.0 → 11.54.0-alpha.1

package/esm/index.d.ts

@@ -11,5 +11,5 @@ export { shallowEqualObjects } from "./objectUtils.js";
 export { type IShortenTextOptions, hashCodeString, randomString, shortenText, escapeRegExp, simplifyText, parseStringToArray, } from "./stringUtils.js";
 export { removeMetadata, sanitizeLocaleForMoment } from "./translationUtils.js";
 export { type GuardType, type EmptyObject, combineGuards } from "./typesUtils.js";
-export { type MatcherFunction, type ConsoleFunction, type Matcher, type SpecificMatcherFunction, type ConsoleType, type WaitForFn, delay, suppressConsole, createTightWaitFor, } from "./testUtils.js";
+export { type MatcherFunction, type ConsoleFunction, type Matcher, type SpecificMatcherFunction, type ConsoleType, type WaitForFn, delay, strictBarrel, suppressConsole, createTightWaitFor, } from "./testUtils.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACH,KAAK,mBAAmB,EACxB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,kBAAkB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,EACL,eAAe,EACf,kBAAkB,GACrB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACH,KAAK,mBAAmB,EACxB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,kBAAkB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,GACrB,MAAM,gBAAgB,CAAC"}

package/esm/index.js

@@ -13,4 +13,4 @@ export { shallowEqualObjects } from "./objectUtils.js";
 export { hashCodeString, randomString, shortenText, escapeRegExp, simplifyText, parseStringToArray, } from "./stringUtils.js";
 export { removeMetadata, sanitizeLocaleForMoment } from "./translationUtils.js";
 export { combineGuards } from "./typesUtils.js";
-export { delay, suppressConsole, createTightWaitFor, } from "./testUtils.js";
+export { delay, strictBarrel, suppressConsole, createTightWaitFor, } from "./testUtils.js";

package/esm/testUtils.d.ts

@@ -5,6 +5,22 @@
  * @internal
  */
 export declare function delay(timeout?: number): Promise<void>;
+/**
+ * Guards a hand-assembled stand-in for a package's barrel so that reaching for an export it does not
+ * carry throws on the spot, naming the package and what is missing.
+ *
+ * @remarks
+ * A test setup can cut a suite's import time by replacing a large barrel with the handful of real modules
+ * it actually uses, reached directly. Left unguarded such a stand-in degrades silently: the day someone
+ * imports something new out of that package the import resolves to `undefined`, and the failure surfaces
+ * somewhere else entirely, in a test that has nothing to do with the change.
+ *
+ * @param packageName - name of the package whose barrel is being stood in for
+ * @param exports - the exports the stand-in carries
+ * @returns the exports, guarded against reads of anything they do not carry
+ * @internal
+ */
+export declare function strictBarrel<T extends object>(packageName: string, exports: T): T;
 /**
  * A matcher for suppressConsole
  *

package/esm/testUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testUtils.d.ts","sourceRoot":"","sources":["../src/testUtils.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhD;AAED;;;;GAIG;AACH,MAAM,MAAM,OAAO,GACb;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAC1B,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,EAC7C,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,KACd,OAAO,CAAC;AAEb;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAwDvD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,EAClC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,uBAAuB,GAC/C,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAElB;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAyCzG;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAChD,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,SAAS,EAClB,QAAQ,GAAE,MAAU,GACrB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAEnD"}
+{"version":3,"file":"testUtils.d.ts","sourceRoot":"","sources":["../src/testUtils.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhD;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAoBjF;AAED;;;;GAIG;AACH,MAAM,MAAM,OAAO,GACb;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAC1B,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,EAC7C,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,KACd,OAAO,CAAC;AAEb;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAwDvD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,EAClC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,uBAAuB,GAC/C,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAElB;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAyCzG;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAChD,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,SAAS,EAClB,QAAQ,GAAE,MAAU,GACrB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAEnD"}

package/esm/testUtils.js

@@ -13,6 +13,43 @@ export function delay(timeout = 0) {
         }, timeout);
     });
 }
+/**
+ * Property reads that the module plumbing (a mock registry, `await import(...)`, React, ...) performs on
+ * a namespace object without meaning to read an export. They must answer `undefined` rather than trip
+ * the guard in {@link strictBarrel}.
+ */
+const NAMESPACE_PROBES = new Set(["then", "default", "__esModule", "$$typeof", "toJSON", "constructor"]);
+/**
+ * Guards a hand-assembled stand-in for a package's barrel so that reaching for an export it does not
+ * carry throws on the spot, naming the package and what is missing.
+ *
+ * @remarks
+ * A test setup can cut a suite's import time by replacing a large barrel with the handful of real modules
+ * it actually uses, reached directly. Left unguarded such a stand-in degrades silently: the day someone
+ * imports something new out of that package the import resolves to `undefined`, and the failure surfaces
+ * somewhere else entirely, in a test that has nothing to do with the change.
+ *
+ * @param packageName - name of the package whose barrel is being stood in for
+ * @param exports - the exports the stand-in carries
+ * @returns the exports, guarded against reads of anything they do not carry
+ * @internal
+ */
+export function strictBarrel(packageName, exports) {
+    return new Proxy(exports, {
+        get(target, property, receiver) {
+            // Own properties only: a real module namespace inherits from nothing, so anything reached
+            // through the stand-in's prototype (`toString`, `valueOf`, ...) is not an export it carries.
+            if (typeof property !== "string" ||
+                Object.hasOwn(target, property) ||
+                NAMESPACE_PROBES.has(property)) {
+                return Reflect.get(target, property, receiver);
+            }
+            throw new Error(`"${packageName}" is routed around its barrel in the test setup to keep the suite's ` +
+                `import time down, and the stand-in does not export "${property}". Add it to the ` +
+                `stand-in, importing it from its own module inside the package rather than from the barrel.`);
+        },
+    });
+}
 function suppressConsoleBase(fn, matcherFn) {
     const types = ["error", "warn", "log", "debug", "info"];
     const originals = {};

package/esm/util.d.ts

@@ -192,6 +192,23 @@ export declare function simplifyText(value: string | number | null): string;
  */
 export declare type SpecificMatcherFunction = (message: string) => boolean;
 
+/**
+ * Guards a hand-assembled stand-in for a package's barrel so that reaching for an export it does not
+ * carry throws on the spot, naming the package and what is missing.
+ *
+ * @remarks
+ * A test setup can cut a suite's import time by replacing a large barrel with the handful of real modules
+ * it actually uses, reached directly. Left unguarded such a stand-in degrades silently: the day someone
+ * imports something new out of that package the import resolves to `undefined`, and the failure surfaces
+ * somewhere else entirely, in a test that has nothing to do with the change.
+ *
+ * @param packageName - name of the package whose barrel is being stood in for
+ * @param exports - the exports the stand-in carries
+ * @returns the exports, guarded against reads of anything they do not carry
+ * @internal
+ */
+export declare function strictBarrel<T extends object>(packageName: string, exports: T): T;
+
 /**
  * Suppresses certain console outputs
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/util",
-  "version": "11.53.0",
+  "version": "11.54.0-alpha.1",
   "description": "GoodData Utility Functions",
   "license": "MIT",
   "author": "GoodData",
@@ -47,8 +47,8 @@
     "oxlint-tsgolint": "0.15.0",
     "typescript": "5.9.3",
     "vitest": "4.1.8",
-    "@gooddata/eslint-config": "11.53.0",
-    "@gooddata/oxlint-config": "11.53.0"
+    "@gooddata/eslint-config": "11.54.0-alpha.1",
+    "@gooddata/oxlint-config": "11.54.0-alpha.1"
   },
   "scripts": {
     "_phase:build": "npm run build",