@fluidframework/core-utils 2.102.0 → 2.103.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @fluidframework/core-utils
 
+## 2.103.0
+
+Dependency updates only.
+
 ## 2.102.0
 
 ### Minor Changes

package/dist/allOrNone.d.ts

@@ -0,0 +1,39 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Classification returned by {@link validateAllOrNone}.
+ *
+ * - `"all"`: every named key has a defined value.
+ *
+ * - `"none"`: every named key is `undefined`.
+ *
+ * - `"mixed"`: some keys are defined and others are not — the case that
+ * `AllOrNone<T>` from `@fluidframework/core-interfaces` forbids at compile
+ * time but that can still arise when the input is constructed via cast or
+ * crosses an API boundary that erases the discriminated union.
+ *
+ * @internal
+ */
+export type AllOrNoneResult = "all" | "none" | "mixed";
+/**
+ * Runtime validator for the `AllOrNone<T>` type modifier from
+ * `@fluidframework/core-interfaces`.
+ *
+ * Given an object and the set of keys to inspect, classifies the object as
+ * `"all"`, `"none"`, or `"mixed"` based on which of the named keys carry a
+ * defined value. Useful at API entry points that accept a discriminated union
+ * of "supply the whole group, or supply none of it": a `"mixed"` result is
+ * the misuse case and is typically translated by the caller into a single
+ * named `UsageError` instead of letting a partial supply propagate to an
+ * inner layer where the failure surfaces as a less helpful error.
+ *
+ * Only the presence of `obj[key] !== undefined` is consulted — values that
+ * are `null`, `0`, `""`, or `false` count as "defined". Keys not present on
+ * the object at all are treated the same as `undefined`.
+ *
+ * @internal
+ */
+export declare function validateAllOrNone<T extends object>(obj: Partial<T>, keys: readonly (keyof T)[]): AllOrNoneResult;
+//# sourceMappingURL=allOrNone.d.ts.map

package/dist/allOrNone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allOrNone.d.ts","sourceRoot":"","sources":["../src/allOrNone.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EACjD,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACxB,eAAe,CAcjB"}

package/dist/allOrNone.js

@@ -0,0 +1,42 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAllOrNone = void 0;
+/**
+ * Runtime validator for the `AllOrNone<T>` type modifier from
+ * `@fluidframework/core-interfaces`.
+ *
+ * Given an object and the set of keys to inspect, classifies the object as
+ * `"all"`, `"none"`, or `"mixed"` based on which of the named keys carry a
+ * defined value. Useful at API entry points that accept a discriminated union
+ * of "supply the whole group, or supply none of it": a `"mixed"` result is
+ * the misuse case and is typically translated by the caller into a single
+ * named `UsageError` instead of letting a partial supply propagate to an
+ * inner layer where the failure surfaces as a less helpful error.
+ *
+ * Only the presence of `obj[key] !== undefined` is consulted — values that
+ * are `null`, `0`, `""`, or `false` count as "defined". Keys not present on
+ * the object at all are treated the same as `undefined`.
+ *
+ * @internal
+ */
+function validateAllOrNone(obj, keys) {
+    let definedCount = 0;
+    for (const key of keys) {
+        if (obj[key] !== undefined) {
+            definedCount++;
+        }
+    }
+    if (definedCount === 0) {
+        return "none";
+    }
+    if (definedCount === keys.length) {
+        return "all";
+    }
+    return "mixed";
+}
+exports.validateAllOrNone = validateAllOrNone;
+//# sourceMappingURL=allOrNone.js.map

package/dist/allOrNone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allOrNone.js","sourceRoot":"","sources":["../src/allOrNone.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAkBH;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,iBAAiB,CAChC,GAAe,EACf,IAA0B;IAE1B,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5B,YAAY,EAAE,CAAC;QAChB,CAAC;IACF,CAAC;IACD,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IACf,CAAC;IACD,IAAI,YAAY,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAjBD,8CAiBC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Classification returned by {@link validateAllOrNone}.\n *\n * - `\"all\"`: every named key has a defined value.\n *\n * - `\"none\"`: every named key is `undefined`.\n *\n * - `\"mixed\"`: some keys are defined and others are not — the case that\n * `AllOrNone<T>` from `@fluidframework/core-interfaces` forbids at compile\n * time but that can still arise when the input is constructed via cast or\n * crosses an API boundary that erases the discriminated union.\n *\n * @internal\n */\nexport type AllOrNoneResult = \"all\" | \"none\" | \"mixed\";\n\n/**\n * Runtime validator for the `AllOrNone<T>` type modifier from\n * `@fluidframework/core-interfaces`.\n *\n * Given an object and the set of keys to inspect, classifies the object as\n * `\"all\"`, `\"none\"`, or `\"mixed\"` based on which of the named keys carry a\n * defined value. Useful at API entry points that accept a discriminated union\n * of \"supply the whole group, or supply none of it\": a `\"mixed\"` result is\n * the misuse case and is typically translated by the caller into a single\n * named `UsageError` instead of letting a partial supply propagate to an\n * inner layer where the failure surfaces as a less helpful error.\n *\n * Only the presence of `obj[key] !== undefined` is consulted — values that\n * are `null`, `0`, `\"\"`, or `false` count as \"defined\". Keys not present on\n * the object at all are treated the same as `undefined`.\n *\n * @internal\n */\nexport function validateAllOrNone<T extends object>(\n\tobj: Partial<T>,\n\tkeys: readonly (keyof T)[],\n): AllOrNoneResult {\n\tlet definedCount = 0;\n\tfor (const key of keys) {\n\t\tif (obj[key] !== undefined) {\n\t\t\tdefinedCount++;\n\t\t}\n\t}\n\tif (definedCount === 0) {\n\t\treturn \"none\";\n\t}\n\tif (definedCount === keys.length) {\n\t\treturn \"all\";\n\t}\n\treturn \"mixed\";\n}\n"]}

package/dist/index.d.ts

@@ -19,4 +19,5 @@ export { unreachableCase } from "./unreachable.js";
 export { isObject, isPromiseLike } from "./typesGuards.js";
 export { oob } from "./oob.js";
 export { transformMapValues } from "./map.js";
+export { validateAllOrNone, type AllOrNoneResult } from "./allOrNone.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,MAAM,EACN,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,iCAAiC,EACjC,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACN,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,sBAAsB,EACtB,QAAQ,GACR,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,MAAM,EACN,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,iCAAiC,EACjC,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACN,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,sBAAsB,EACtB,QAAQ,GACR,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.transformMapValues = exports.oob = exports.isPromiseLike = exports.isObject = exports.unreachableCase = exports.Timer = exports.setLongTimeout = exports.PromiseTimer = exports.shallowCloneObject = exports.Deferred = exports.PromiseCache = exports.walkList = exports.iterateListValuesWhile = exports.DoublyLinkedList = exports.LazyPromise = exports.Lazy = exports.NumberComparer = exports.Heap = exports.delay = exports.compareArrays = exports.onAssertionFailure = exports.emulateProductionBuild = exports.nonProductionConditionalsIncluded = exports.configureDebugAsserts = exports.debugAssert = exports.fail = exports.assert = void 0;
+exports.validateAllOrNone = exports.transformMapValues = exports.oob = exports.isPromiseLike = exports.isObject = exports.unreachableCase = exports.Timer = exports.setLongTimeout = exports.PromiseTimer = exports.shallowCloneObject = exports.Deferred = exports.PromiseCache = exports.walkList = exports.iterateListValuesWhile = exports.DoublyLinkedList = exports.LazyPromise = exports.Lazy = exports.NumberComparer = exports.Heap = exports.delay = exports.compareArrays = exports.onAssertionFailure = exports.emulateProductionBuild = exports.nonProductionConditionalsIncluded = exports.configureDebugAsserts = exports.debugAssert = exports.fail = exports.assert = void 0;
 var assert_js_1 = require("./assert.js");
 Object.defineProperty(exports, "assert", { enumerable: true, get: function () { return assert_js_1.assert; } });
 Object.defineProperty(exports, "fail", { enumerable: true, get: function () { return assert_js_1.fail; } });
@@ -46,4 +46,6 @@ var oob_js_1 = require("./oob.js");
 Object.defineProperty(exports, "oob", { enumerable: true, get: function () { return oob_js_1.oob; } });
 var map_js_1 = require("./map.js");
 Object.defineProperty(exports, "transformMapValues", { enumerable: true, get: function () { return map_js_1.transformMapValues; } });
+var allOrNone_js_1 = require("./allOrNone.js");
+Object.defineProperty(exports, "validateAllOrNone", { enumerable: true, get: function () { return allOrNone_js_1.validateAllOrNone; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAQqB;AAPpB,mGAAA,MAAM,OAAA;AACN,iGAAA,IAAI,OAAA;AACJ,wGAAA,WAAW,OAAA;AACX,kHAAA,qBAAqB,OAAA;AACrB,8HAAA,iCAAiC,OAAA;AACjC,mHAAA,sBAAsB,OAAA;AACtB,+GAAA,kBAAkB,OAAA;AAEnB,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AACtB,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AAEd,qCAAiD;AAAxC,+FAAA,IAAI,OAAA;AAAE,yGAAA,cAAc,OAAA;AAC7B,qCAA8C;AAArC,+FAAA,IAAI,OAAA;AAAE,sGAAA,WAAW,OAAA;AAC1B,qCAMmB;AALlB,2GAAA,gBAAgB,OAAA;AAGhB,iHAAA,sBAAsB,OAAA;AACtB,mGAAA,QAAQ,OAAA;AAGT,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AACjB,qDAAuD;AAA9C,qHAAA,kBAAkB,OAAA;AAE3B,uCAAiE;AAAxD,wGAAA,YAAY,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,iGAAA,KAAK,OAAA;AAC5C,mDAAmD;AAA1C,iHAAA,eAAe,OAAA;AACxB,mDAA2D;AAAlD,0GAAA,QAAQ,OAAA;AAAE,+GAAA,aAAa,OAAA;AAChC,mCAA+B;AAAtB,6FAAA,GAAG,OAAA;AACZ,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tassert,\n\tfail,\n\tdebugAssert,\n\tconfigureDebugAsserts,\n\tnonProductionConditionalsIncluded,\n\temulateProductionBuild,\n\tonAssertionFailure,\n} from \"./assert.js\";\nexport { compareArrays } from \"./compare.js\";\nexport { delay } from \"./delay.js\";\nexport type { IComparer, IHeapNode } from \"./heap.js\";\nexport { Heap, NumberComparer } from \"./heap.js\";\nexport { Lazy, LazyPromise } from \"./lazy.js\";\nexport {\n\tDoublyLinkedList,\n\ttype ListNode,\n\ttype ListNodeRange,\n\titerateListValuesWhile,\n\twalkList,\n} from \"./list.js\";\nexport type { PromiseCacheExpiry, PromiseCacheOptions } from \"./promiseCache.js\";\nexport { PromiseCache } from \"./promiseCache.js\";\nexport { Deferred } from \"./promises.js\";\nexport { shallowCloneObject } from \"./shallowClone.js\";\nexport type { IPromiseTimer, IPromiseTimerResult, ITimer } from \"./timer.js\";\nexport { PromiseTimer, setLongTimeout, Timer } from \"./timer.js\";\nexport { unreachableCase } from \"./unreachable.js\";\nexport { isObject, isPromiseLike } from \"./typesGuards.js\";\nexport { oob } from \"./oob.js\";\nexport { transformMapValues } from \"./map.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAQqB;AAPpB,mGAAA,MAAM,OAAA;AACN,iGAAA,IAAI,OAAA;AACJ,wGAAA,WAAW,OAAA;AACX,kHAAA,qBAAqB,OAAA;AACrB,8HAAA,iCAAiC,OAAA;AACjC,mHAAA,sBAAsB,OAAA;AACtB,+GAAA,kBAAkB,OAAA;AAEnB,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AACtB,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AAEd,qCAAiD;AAAxC,+FAAA,IAAI,OAAA;AAAE,yGAAA,cAAc,OAAA;AAC7B,qCAA8C;AAArC,+FAAA,IAAI,OAAA;AAAE,sGAAA,WAAW,OAAA;AAC1B,qCAMmB;AALlB,2GAAA,gBAAgB,OAAA;AAGhB,iHAAA,sBAAsB,OAAA;AACtB,mGAAA,QAAQ,OAAA;AAGT,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AACjB,qDAAuD;AAA9C,qHAAA,kBAAkB,OAAA;AAE3B,uCAAiE;AAAxD,wGAAA,YAAY,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,iGAAA,KAAK,OAAA;AAC5C,mDAAmD;AAA1C,iHAAA,eAAe,OAAA;AACxB,mDAA2D;AAAlD,0GAAA,QAAQ,OAAA;AAAE,+GAAA,aAAa,OAAA;AAChC,mCAA+B;AAAtB,6FAAA,GAAG,OAAA;AACZ,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA;AAC3B,+CAAyE;AAAhE,iHAAA,iBAAiB,OAAA","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tassert,\n\tfail,\n\tdebugAssert,\n\tconfigureDebugAsserts,\n\tnonProductionConditionalsIncluded,\n\temulateProductionBuild,\n\tonAssertionFailure,\n} from \"./assert.js\";\nexport { compareArrays } from \"./compare.js\";\nexport { delay } from \"./delay.js\";\nexport type { IComparer, IHeapNode } from \"./heap.js\";\nexport { Heap, NumberComparer } from \"./heap.js\";\nexport { Lazy, LazyPromise } from \"./lazy.js\";\nexport {\n\tDoublyLinkedList,\n\ttype ListNode,\n\ttype ListNodeRange,\n\titerateListValuesWhile,\n\twalkList,\n} from \"./list.js\";\nexport type { PromiseCacheExpiry, PromiseCacheOptions } from \"./promiseCache.js\";\nexport { PromiseCache } from \"./promiseCache.js\";\nexport { Deferred } from \"./promises.js\";\nexport { shallowCloneObject } from \"./shallowClone.js\";\nexport type { IPromiseTimer, IPromiseTimerResult, ITimer } from \"./timer.js\";\nexport { PromiseTimer, setLongTimeout, Timer } from \"./timer.js\";\nexport { unreachableCase } from \"./unreachable.js\";\nexport { isObject, isPromiseLike } from \"./typesGuards.js\";\nexport { oob } from \"./oob.js\";\nexport { transformMapValues } from \"./map.js\";\nexport { validateAllOrNone, type AllOrNoneResult } from \"./allOrNone.js\";\n"]}

package/lib/allOrNone.d.ts

@@ -0,0 +1,39 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Classification returned by {@link validateAllOrNone}.
+ *
+ * - `"all"`: every named key has a defined value.
+ *
+ * - `"none"`: every named key is `undefined`.
+ *
+ * - `"mixed"`: some keys are defined and others are not — the case that
+ * `AllOrNone<T>` from `@fluidframework/core-interfaces` forbids at compile
+ * time but that can still arise when the input is constructed via cast or
+ * crosses an API boundary that erases the discriminated union.
+ *
+ * @internal
+ */
+export type AllOrNoneResult = "all" | "none" | "mixed";
+/**
+ * Runtime validator for the `AllOrNone<T>` type modifier from
+ * `@fluidframework/core-interfaces`.
+ *
+ * Given an object and the set of keys to inspect, classifies the object as
+ * `"all"`, `"none"`, or `"mixed"` based on which of the named keys carry a
+ * defined value. Useful at API entry points that accept a discriminated union
+ * of "supply the whole group, or supply none of it": a `"mixed"` result is
+ * the misuse case and is typically translated by the caller into a single
+ * named `UsageError` instead of letting a partial supply propagate to an
+ * inner layer where the failure surfaces as a less helpful error.
+ *
+ * Only the presence of `obj[key] !== undefined` is consulted — values that
+ * are `null`, `0`, `""`, or `false` count as "defined". Keys not present on
+ * the object at all are treated the same as `undefined`.
+ *
+ * @internal
+ */
+export declare function validateAllOrNone<T extends object>(obj: Partial<T>, keys: readonly (keyof T)[]): AllOrNoneResult;
+//# sourceMappingURL=allOrNone.d.ts.map

package/lib/allOrNone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allOrNone.d.ts","sourceRoot":"","sources":["../src/allOrNone.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EACjD,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACxB,eAAe,CAcjB"}

package/lib/allOrNone.js

@@ -0,0 +1,38 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Runtime validator for the `AllOrNone<T>` type modifier from
+ * `@fluidframework/core-interfaces`.
+ *
+ * Given an object and the set of keys to inspect, classifies the object as
+ * `"all"`, `"none"`, or `"mixed"` based on which of the named keys carry a
+ * defined value. Useful at API entry points that accept a discriminated union
+ * of "supply the whole group, or supply none of it": a `"mixed"` result is
+ * the misuse case and is typically translated by the caller into a single
+ * named `UsageError` instead of letting a partial supply propagate to an
+ * inner layer where the failure surfaces as a less helpful error.
+ *
+ * Only the presence of `obj[key] !== undefined` is consulted — values that
+ * are `null`, `0`, `""`, or `false` count as "defined". Keys not present on
+ * the object at all are treated the same as `undefined`.
+ *
+ * @internal
+ */
+export function validateAllOrNone(obj, keys) {
+    let definedCount = 0;
+    for (const key of keys) {
+        if (obj[key] !== undefined) {
+            definedCount++;
+        }
+    }
+    if (definedCount === 0) {
+        return "none";
+    }
+    if (definedCount === keys.length) {
+        return "all";
+    }
+    return "mixed";
+}
+//# sourceMappingURL=allOrNone.js.map

package/lib/allOrNone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allOrNone.js","sourceRoot":"","sources":["../src/allOrNone.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAChC,GAAe,EACf,IAA0B;IAE1B,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5B,YAAY,EAAE,CAAC;QAChB,CAAC;IACF,CAAC;IACD,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IACf,CAAC;IACD,IAAI,YAAY,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Classification returned by {@link validateAllOrNone}.\n *\n * - `\"all\"`: every named key has a defined value.\n *\n * - `\"none\"`: every named key is `undefined`.\n *\n * - `\"mixed\"`: some keys are defined and others are not — the case that\n * `AllOrNone<T>` from `@fluidframework/core-interfaces` forbids at compile\n * time but that can still arise when the input is constructed via cast or\n * crosses an API boundary that erases the discriminated union.\n *\n * @internal\n */\nexport type AllOrNoneResult = \"all\" | \"none\" | \"mixed\";\n\n/**\n * Runtime validator for the `AllOrNone<T>` type modifier from\n * `@fluidframework/core-interfaces`.\n *\n * Given an object and the set of keys to inspect, classifies the object as\n * `\"all\"`, `\"none\"`, or `\"mixed\"` based on which of the named keys carry a\n * defined value. Useful at API entry points that accept a discriminated union\n * of \"supply the whole group, or supply none of it\": a `\"mixed\"` result is\n * the misuse case and is typically translated by the caller into a single\n * named `UsageError` instead of letting a partial supply propagate to an\n * inner layer where the failure surfaces as a less helpful error.\n *\n * Only the presence of `obj[key] !== undefined` is consulted — values that\n * are `null`, `0`, `\"\"`, or `false` count as \"defined\". Keys not present on\n * the object at all are treated the same as `undefined`.\n *\n * @internal\n */\nexport function validateAllOrNone<T extends object>(\n\tobj: Partial<T>,\n\tkeys: readonly (keyof T)[],\n): AllOrNoneResult {\n\tlet definedCount = 0;\n\tfor (const key of keys) {\n\t\tif (obj[key] !== undefined) {\n\t\t\tdefinedCount++;\n\t\t}\n\t}\n\tif (definedCount === 0) {\n\t\treturn \"none\";\n\t}\n\tif (definedCount === keys.length) {\n\t\treturn \"all\";\n\t}\n\treturn \"mixed\";\n}\n"]}

package/lib/index.d.ts

@@ -19,4 +19,5 @@ export { unreachableCase } from "./unreachable.js";
 export { isObject, isPromiseLike } from "./typesGuards.js";
 export { oob } from "./oob.js";
 export { transformMapValues } from "./map.js";
+export { validateAllOrNone, type AllOrNoneResult } from "./allOrNone.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,MAAM,EACN,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,iCAAiC,EACjC,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACN,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,sBAAsB,EACtB,QAAQ,GACR,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,MAAM,EACN,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,iCAAiC,EACjC,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACN,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,sBAAsB,EACtB,QAAQ,GACR,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/index.js

@@ -16,4 +16,5 @@ export { unreachableCase } from "./unreachable.js";
 export { isObject, isPromiseLike } from "./typesGuards.js";
 export { oob } from "./oob.js";
 export { transformMapValues } from "./map.js";
+export { validateAllOrNone } from "./allOrNone.js";
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,MAAM,EACN,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,iCAAiC,EACjC,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACN,gBAAgB,EAGhB,sBAAsB,EACtB,QAAQ,GACR,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tassert,\n\tfail,\n\tdebugAssert,\n\tconfigureDebugAsserts,\n\tnonProductionConditionalsIncluded,\n\temulateProductionBuild,\n\tonAssertionFailure,\n} from \"./assert.js\";\nexport { compareArrays } from \"./compare.js\";\nexport { delay } from \"./delay.js\";\nexport type { IComparer, IHeapNode } from \"./heap.js\";\nexport { Heap, NumberComparer } from \"./heap.js\";\nexport { Lazy, LazyPromise } from \"./lazy.js\";\nexport {\n\tDoublyLinkedList,\n\ttype ListNode,\n\ttype ListNodeRange,\n\titerateListValuesWhile,\n\twalkList,\n} from \"./list.js\";\nexport type { PromiseCacheExpiry, PromiseCacheOptions } from \"./promiseCache.js\";\nexport { PromiseCache } from \"./promiseCache.js\";\nexport { Deferred } from \"./promises.js\";\nexport { shallowCloneObject } from \"./shallowClone.js\";\nexport type { IPromiseTimer, IPromiseTimerResult, ITimer } from \"./timer.js\";\nexport { PromiseTimer, setLongTimeout, Timer } from \"./timer.js\";\nexport { unreachableCase } from \"./unreachable.js\";\nexport { isObject, isPromiseLike } from \"./typesGuards.js\";\nexport { oob } from \"./oob.js\";\nexport { transformMapValues } from \"./map.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,MAAM,EACN,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,iCAAiC,EACjC,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACN,gBAAgB,EAGhB,sBAAsB,EACtB,QAAQ,GACR,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAwB,MAAM,gBAAgB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tassert,\n\tfail,\n\tdebugAssert,\n\tconfigureDebugAsserts,\n\tnonProductionConditionalsIncluded,\n\temulateProductionBuild,\n\tonAssertionFailure,\n} from \"./assert.js\";\nexport { compareArrays } from \"./compare.js\";\nexport { delay } from \"./delay.js\";\nexport type { IComparer, IHeapNode } from \"./heap.js\";\nexport { Heap, NumberComparer } from \"./heap.js\";\nexport { Lazy, LazyPromise } from \"./lazy.js\";\nexport {\n\tDoublyLinkedList,\n\ttype ListNode,\n\ttype ListNodeRange,\n\titerateListValuesWhile,\n\twalkList,\n} from \"./list.js\";\nexport type { PromiseCacheExpiry, PromiseCacheOptions } from \"./promiseCache.js\";\nexport { PromiseCache } from \"./promiseCache.js\";\nexport { Deferred } from \"./promises.js\";\nexport { shallowCloneObject } from \"./shallowClone.js\";\nexport type { IPromiseTimer, IPromiseTimerResult, ITimer } from \"./timer.js\";\nexport { PromiseTimer, setLongTimeout, Timer } from \"./timer.js\";\nexport { unreachableCase } from \"./unreachable.js\";\nexport { isObject, isPromiseLike } from \"./typesGuards.js\";\nexport { oob } from \"./oob.js\";\nexport { transformMapValues } from \"./map.js\";\nexport { validateAllOrNone, type AllOrNoneResult } from \"./allOrNone.js\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/core-utils",
-  "version": "2.102.0",
+  "version": "2.103.0",
   "description": "Not intended for use outside the Fluid client repo.",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -89,7 +89,7 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
     "@biomejs/biome": "~2.4.5",
-    "@fluid-internal/mocha-test-setup": "~2.102.0",
+    "@fluid-internal/mocha-test-setup": "~2.103.0",
     "@fluid-tools/benchmark": "^0.59.0",
     "@fluid-tools/build-cli": "^0.65.0",
     "@fluidframework/build-common": "^2.0.3",

package/src/allOrNone.ts

@@ -0,0 +1,57 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+/**
+ * Classification returned by {@link validateAllOrNone}.
+ *
+ * - `"all"`: every named key has a defined value.
+ *
+ * - `"none"`: every named key is `undefined`.
+ *
+ * - `"mixed"`: some keys are defined and others are not — the case that
+ * `AllOrNone<T>` from `@fluidframework/core-interfaces` forbids at compile
+ * time but that can still arise when the input is constructed via cast or
+ * crosses an API boundary that erases the discriminated union.
+ *
+ * @internal
+ */
+export type AllOrNoneResult = "all" | "none" | "mixed";
+
+/**
+ * Runtime validator for the `AllOrNone<T>` type modifier from
+ * `@fluidframework/core-interfaces`.
+ *
+ * Given an object and the set of keys to inspect, classifies the object as
+ * `"all"`, `"none"`, or `"mixed"` based on which of the named keys carry a
+ * defined value. Useful at API entry points that accept a discriminated union
+ * of "supply the whole group, or supply none of it": a `"mixed"` result is
+ * the misuse case and is typically translated by the caller into a single
+ * named `UsageError` instead of letting a partial supply propagate to an
+ * inner layer where the failure surfaces as a less helpful error.
+ *
+ * Only the presence of `obj[key] !== undefined` is consulted — values that
+ * are `null`, `0`, `""`, or `false` count as "defined". Keys not present on
+ * the object at all are treated the same as `undefined`.
+ *
+ * @internal
+ */
+export function validateAllOrNone<T extends object>(
+	obj: Partial<T>,
+	keys: readonly (keyof T)[],
+): AllOrNoneResult {
+	let definedCount = 0;
+	for (const key of keys) {
+		if (obj[key] !== undefined) {
+			definedCount++;
+		}
+	}
+	if (definedCount === 0) {
+		return "none";
+	}
+	if (definedCount === keys.length) {
+		return "all";
+	}
+	return "mixed";
+}

package/src/index.ts

@@ -34,3 +34,4 @@ export { unreachableCase } from "./unreachable.js";
 export { isObject, isPromiseLike } from "./typesGuards.js";
 export { oob } from "./oob.js";
 export { transformMapValues } from "./map.js";
+export { validateAllOrNone, type AllOrNoneResult } from "./allOrNone.js";