bare-buffer 3.4.4 → 3.5.0

package/binding.c

@@ -144,6 +144,33 @@ bare_buffer_to_string_utf8(js_env_t *env, js_callback_info_t *info) {
   return result;
 }
 
+static js_value_t *
+bare_buffer_validate_utf8(js_env_t *env, js_callback_info_t *info) {
+  int err;
+
+  size_t argc = 2;
+  js_value_t *argv[2];
+
+  err = js_get_callback_info(env, info, &argc, argv, NULL, NULL);
+  assert(err == 0);
+
+  assert(argc == 2);
+
+  utf8_t *buf;
+  err = bare_buffer__get_info(env, argv[0], (void **) &buf, NULL);
+  assert(err == 0);
+
+  int64_t len;
+  err = js_get_value_int64(env, argv[1], &len);
+  assert(err == 0);
+
+  js_value_t *result;
+  err = js_get_boolean(env, utf8_validate(buf, len), &result);
+  assert(err == 0);
+
+  return result;
+}
+
 static int64_t
 bare_buffer_typed_write_utf8(
   js_value_t *receiver,
@@ -741,6 +768,33 @@ bare_buffer_write_hex(js_env_t *env, js_callback_info_t *info) {
   return result;
 }
 
+static js_value_t *
+bare_buffer_validate_ascii(js_env_t *env, js_callback_info_t *info) {
+  int err;
+
+  size_t argc = 2;
+  js_value_t *argv[2];
+
+  err = js_get_callback_info(env, info, &argc, argv, NULL, NULL);
+  assert(err == 0);
+
+  assert(argc == 2);
+
+  ascii_t *buf;
+  err = bare_buffer__get_info(env, argv[0], (void **) &buf, NULL);
+  assert(err == 0);
+
+  int64_t len;
+  err = js_get_value_int64(env, argv[1], &len);
+  assert(err == 0);
+
+  js_value_t *result;
+  err = js_get_boolean(env, ascii_validate(buf, len), &result);
+  assert(err == 0);
+
+  return result;
+}
+
 static inline int
 bare_buffer__memcmp(void *a, size_t a_len, void *b, size_t b_len) {
   int r = memcmp(a, b, a_len < b_len ? a_len : b_len);
@@ -895,6 +949,8 @@ bare_buffer_exports(js_env_t *env, js_value_t *exports) {
 
   V("toStringUTF8", bare_buffer_to_string_utf8, NULL, NULL);
 
+  V("validateUTF8", bare_buffer_validate_utf8, NULL, NULL);
+
   V(
     "writeUTF8",
     bare_buffer_write_utf8,
@@ -992,6 +1048,8 @@ bare_buffer_exports(js_env_t *env, js_value_t *exports) {
     bare_buffer_typed_write_hex
   );
 
+  V("validateAscii", bare_buffer_validate_ascii, NULL, NULL);
+
   V(
     "compare",
     bare_buffer_compare,

package/index.d.ts

@@ -49,6 +49,8 @@ interface Buffer extends Uint8Array<ArrayBuffer> {
 
   toString(encoding?: BufferEncoding, start?: number, end?: number): string
 
+  toJSON(): number[]
+
   readDoubleBE(offset?: number): number
   readDoubleLE(offset?: number): number
 
@@ -151,6 +153,12 @@ declare namespace Buffer {
 
   export function isEncoding(encoding: string): encoding is BufferEncoding
 
+  export function isASCII(buffer: Buffer): boolean
+  export function isAscii(buffer: Buffer): boolean
+
+  export function isUTF8(buffer: Buffer): boolean
+  export function isUtf8(buffer: Buffer): boolean
+
   export function alloc(size: number, fill: string, encoding?: BufferEncoding): Buffer
   export function alloc(size: number, fill?: Buffer | number | boolean): Buffer
 
@@ -177,6 +185,8 @@ declare namespace Buffer {
   export function atob(data: unknown): string
   export function btoa(data: unknown): string
 
+  export function transcode(buffer: Buffer, from: BufferEncoding, to: BufferEncoding): Buffer
+
   export { Buffer, type BufferEncoding, constants }
 }
 

package/index.js

@@ -282,6 +282,10 @@ module.exports = exports = class Buffer extends Uint8Array {
     return codecFor(encoding).toString(buffer)
   }
 
+  toJSON() {
+    return Array.from(this)
+  }
+
   write(string, offset = 0, length = this.byteLength - offset, encoding = 'utf8') {
     // write(string)
     if (arguments.length === 1) return utf8.write(this, string)
@@ -659,6 +663,20 @@ exports.isEncoding = function isEncoding(encoding) {
   }
 }
 
+exports.isASCII = function isASCII(buffer) {
+  return ascii.validate(buffer)
+}
+
+// for Node.js compatibily
+exports.isAscii = exports.isASCII
+
+exports.isUTF8 = function isUTF8(buffer) {
+  return utf8.validate(buffer)
+}
+
+// for Node.js compatibility
+exports.isUtf8 = exports.isUTF8
+
 exports.alloc = function alloc(size, fill, encoding) {
   const buffer = new Buffer(size)
   if (fill !== undefined) buffer.fill(fill, 0, buffer.byteLength, encoding)
@@ -823,6 +841,10 @@ exports.btoa = function btoa(data) {
   return Buffer.from(data, 'latin1').toString('base64')
 }
 
+exports.transcode = function transcode(buffer, from, to) {
+  return Buffer.from(buffer.toString(from), to)
+}
+
 function readInt48BE(view, offset) {
   const hi = view.getUint16(offset, false)
   const lo = view.getUint32(offset + 2, false)

package/lib/ascii.js

@@ -1,3 +1,5 @@
+const binding = require('../binding')
+
 exports.byteLength = function byteLength(string) {
   return string.length
 }
@@ -23,3 +25,7 @@ exports.write = function write(buffer, string) {
 
   return len
 }
+
+exports.validate = function validate(buffer) {
+  return binding.validateAscii(buffer.buffer, buffer.byteLength)
+}

package/lib/utf8.js

@@ -11,3 +11,7 @@ exports.toString = function toString(buffer) {
 exports.write = function write(buffer, string) {
   return binding.writeUTF8(buffer.buffer, buffer.byteOffset, buffer.byteLength, string)
 }
+
+exports.validate = function validate(buffer) {
+  return binding.validateUTF8(buffer.buffer, buffer.byteLength)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bare-buffer",
-  "version": "3.4.4",
+  "version": "3.5.0",
   "description": "Native buffers for JavaScript",
   "exports": {
     "./package": "./package.json",