lib0 1.0.0-rc.23 → 1.0.0-rc.25

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lib0",
-  "version": "1.0.0-rc.23",
-  "description": "",
+  "version": "1.0.0-rc.25",
+  "description": "isomorphic utility functions",
   "sideEffects": false,
   "type": "module",
   "funding": {
@@ -9,9 +9,9 @@
     "url": "https://github.com/sponsors/dmonad"
   },
   "bin": {
-    "0gentesthtml": "./src/bin/gentesthtml.js",
-    "0serve": "./src/bin/0serve.js",
-    "0ecdsa-generate-keypair": "./src/bin/0ecdsa-generate-keypair.js"
+    "0gentesthtml": "src/bin/gentesthtml.js",
+    "0serve": "src/bin/0serve.js",
+    "0ecdsa-generate-keypair": "src/bin/0ecdsa-generate-keypair.js"
   },
   "files": [
     "dist/**/*.d.ts",

package/src/environment.common.js

@@ -31,7 +31,7 @@ export const globalScope = /* @__PURE__ */(() =>/** @type {any} */ (typeof globa
  * which has `btoa`/`atob`/`fetch` but no DOM). Excludes Node and Deno.
  * @type {boolean}
  */
-/* c8 ignore next */
+/* c8 ignore start */
 export const isBrowser = /* @__PURE__ */(() =>
   !isNode && !isDeno && (
     (typeof window !== 'undefined' && typeof document !== 'undefined') ||
@@ -39,3 +39,4 @@ export const isBrowser = /* @__PURE__ */(() =>
     (typeof globalScope.WorkerGlobalScope !== 'undefined' && globalScope.self instanceof globalScope.WorkerGlobalScope)
   )
 )()
+/* c8 ignore stop */

package/src/schema.js

@@ -5,6 +5,7 @@
  */
 
 import * as arr from './array.js'
+import * as buffer from './buffer.js'
 import * as error from './error.js'
 import * as equalityTraits from './trait/equality.js'
 import * as fun from './function.js'
@@ -1259,6 +1260,8 @@ const _failed = Symbol('schema:coercion failed')
 
 const _bigintRegex = /^[+-]?\d+$/
 
+const _base64Regex = /^[A-Za-z0-9+/]+={0,2}$/
+
 /**
  * Render a value for an error message. Objects are only rendered by kind - printing them adds
  * noise (and `String` throws on null-prototype objects).
@@ -1388,6 +1391,20 @@ const _createCoercer = ($s, cache) => {
       ? o
       : (o === 'true' ? true : (o === 'false' ? false : _fail(ctx, path, o, expected)))
   }
+  if (_isMeta($$uint8Array, $s)) {
+    // the format is checked here (rather than left to the decoder) because the `buffer.fromBase64`
+    // backends disagree on invalid input: `Buffer` silently ignores unexpected characters, `atob` &
+    // `Uint8Array.fromBase64` throw
+    return (o, path, ctx) => {
+      if ($uint8Array.check(o)) return o
+      if (typeof o !== 'string' || !_base64Regex.test(o)) return _fail(ctx, path, o, expected)
+      // base64 encodes 3 bytes as 4 characters. The '=' padding is optional, but when it is there
+      // the length has to be a multiple of 4 - and without it the last chunk must not be a single
+      // character, which carries no full byte.
+      const rest = o.length % 4
+      return (o.endsWith('=') ? rest === 0 : rest !== 1) ? buffer.fromBase64(o) : _fail(ctx, path, o, expected)
+    }
+  }
   if (_isMeta($$literal, $s) || _isMeta($$null, $s) || _isMeta($$undefined, $s)) {
     const literals = /** @type {Array<Primitive>} */ (shape)
     return (o, path, ctx) => {
@@ -1530,8 +1547,9 @@ const _buildCoercer = ($s, cache) => {
  * Unlike `check` (which only validates) a coercion converts values that don't match yet - `'42'`
  * becomes `42` for `$number`, `'true'` becomes `true` for `$boolean`. Values that already match
  * are returned untouched (including object identity). Containers (`$object`, `$array`, `$record`,
- * `$tuple`, `$union`, `$optional`) are coerced recursively. Schemas without a meaningful
- * conversion (`$instanceOf`, `$custom`, ..) simply have to match.
+ * `$tuple`, `$union`, `$optional`) are coerced recursively. `$uint8Array` accepts a base64 string
+ * (padding optional) - the inverse of `buffer.toBase64`. Schemas without a meaningful conversion
+ * (`$instanceOf`, `$custom`, ..) simply have to match.
  *
  * Failures are returned instead of thrown - this is the only api in lib0 that reports errors as a
  * value.