@schema-pack/message-pack 0.0.0-commit.7aad9bb7aa476e8148a2e2b9419af9356fd8d8e5 → 0.0.0-commit.fd50c1db034f7ca04b28f01b16e76470ecc500c7

package/README.md

@@ -6,18 +6,7 @@
 
 # @schema-pack/message-pack
 
-<p align="center">
-  <a href='/docs/message-pack'>
-    Documentation
-  </a>
-  |
-  <a href='/docs/message-pack/install'>
-    Quick start
-  </a>
-</p>
-
-Incremental
-[MessagePack](https://github.com/msgpack/msgpack/blob/master/spec.md)
+A [MessagePack](https://github.com/msgpack/msgpack/blob/master/spec.md)
 encoder/decoder for TypeScript and JavaScript. It targets full compliance with
 the MessagePack spec and exposes a pluggable extension system for encoding
 custom types.
@@ -25,9 +14,138 @@ custom types.
 ## Installation
 
 ```bash
-pnpm add @schema-pack/message-pack@next
+pnpm add @schema-pack/message-pack
 ```
 
+## Quick start
+
+```ts
+import { Decoder, Encoder } from '@schema-pack/message-pack';
+
+const encoder = new Encoder();
+const bytes = encoder.encode({ hello: 'world', values: [1, 2, 3] });
+
+const decoder = new Decoder();
+const value = decoder.decode(bytes);
+// { hello: 'world', values: [1, 2, 3] }
+```
+
+## The 64-bit integer caveat
+
+JavaScript numbers are IEEE 754 double-precision floats, so they can only
+represent integers safely between `Number.MIN_SAFE_INTEGER` and
+`Number.MAX_SAFE_INTEGER` (±(2^53 - 1)) — exported here as `INT64_MIN` and
+`UINT64_MAX`. MessagePack's native `uint 64` / `int 64` formats, however, cover
+the _full_ 64-bit range.
+
+By default, the encoder and decoder read and write these formats as regular JS
+`number`s, which is safe as long as your values stay within that safe integer
+range. If you need the full 64-bit range — or want to work with `bigint`
+directly — register the built-in `BigIntExtension`:
+
+```ts
+import { BigIntExtension, Decoder, Encoder } from '@schema-pack/message-pack';
+
+const extension = new BigIntExtension(); // extension type 0-127, defaults to 0
+
+const encoder = new Encoder().addExtension(extension);
+const decoder = new Decoder().addExtension(extension);
+
+const bytes = encoder.encode(123_456_789_012_345_678_901_234_567_890n);
+decoder.decode(bytes); // 123456789012345678901234567890n
+```
+
+Values within the safe integer range are still encoded as native MessagePack
+`uint`/`int` formats even with the extension registered — `BigIntExtension` only
+takes over once a `bigint` value falls outside that range.
+
+## Built-in extensions
+
+- **`BigIntExtension`** — encodes/decodes `bigint` values outside the safe
+  integer range, using a variable-length representation of the value's magnitude
+  plus sign.
+- **`TimestampDateExtension`** — encodes/decodes JS `Date` objects using the
+  standard MessagePack
+  [timestamp extension type](https://github.com/msgpack/msgpack/blob/master/spec.md#timestamp-extension-type)
+  (`-1`), automatically choosing the 32-bit, 64-bit, or 96-bit format based on
+  the date's range and precision. Because it uses the reserved timestamp type,
+  register it as an _internal_ extension:
+
+```ts
+import {
+  Decoder,
+  Encoder,
+  TimestampDateExtension,
+} from '@schema-pack/message-pack';
+
+const extension = new TimestampDateExtension();
+
+const encoder = new Encoder().addInternalExtension(extension);
+const decoder = new Decoder().addInternalExtension(extension);
+
+const bytes = encoder.encode(new Date());
+decoder.decode(bytes); // Date instance
+```
+
+## Writing your own extensions
+
+Implement the `MessagePackExtension<TValue, TBuffer>` interface (or extend the
+abstract `UntypedExtension` helper, which takes care of storing `type`):
+
+```ts
+interface MessagePackExtension<
+  TValue = unknown,
+  TBuffer extends Uint8Array = Uint8Array,
+> {
+  readonly type: number;
+  encode(
+    value: object | bigint,
+    buffer: MessagePackEncoderBuffer<TBuffer>,
+  ): void;
+  decode(decoderBuffer: MessagePackDecoderBuffer, size: number): TValue;
+}
+```
+
+Then register it on both the encoder and the decoder:
+
+- `addExtension(extension)` — custom extension types, in the range `0` to `127`.
+- `addExtensionType(type, extension)` — same as above, with the type passed as a
+  separate argument.
+- `addInternalExtension(extension)` — reserved types, in the range `-128` to
+  `-1`, used for spec-defined extensions such as timestamps.
+- `fetchExtension(type)` — look up a registered extension by its type.
+
+Inside `encode()`, the buffer argument exposes low-level writers (`writeUint8`,
+`writeUint32`, `writeBin`, `ensureCapacity`, `view`, `offset`, etc.) for
+building a custom binary payload — see the `MessagePackEncoderBuffer` interface
+for the full API.
+
+## Encoder options
+
+| Option                    | Default                          | Description                                                                                                                                                                                                               |
+| ------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `initialBufferSize`       | `1024`                           | Initial size of the encoding buffer; grows automatically as needed.                                                                                                                                                       |
+| `newBufferFn`             | `(size) => new Uint8Array(size)` | Factory used to allocate new buffers.                                                                                                                                                                                     |
+| `initialSharedBufferSize` | `1024`                           | Initial size of the shared buffer used when encoding strings, to reduce allocations.                                                                                                                                      |
+| `textEncoder`             | `DefaultTextEncoder`             | Encoder used to turn strings into bytes. A `NodeTextEncoder` is also provided for faster string encoding on Node.                                                                                                         |
+| `sortKeys`                | `false`                          | Sort object keys before encoding, for deterministic output.                                                                                                                                                               |
+| `forceFloat32`            | `false`                          | Always encode floating point numbers as `float32` instead of `float64`. This may lose precision for values that don't fit exactly in 32 bits (e.g. `1.2`) — only enable it if you know your floats can round-trip safely. |
+
+## Decoder options
+
+| Option              | Default                          | Description                                                         |
+| ------------------- | -------------------------------- | ------------------------------------------------------------------- |
+| `initialBufferSize` | `1024`                           | Initial size of the decoding buffer; grows automatically as needed. |
+| `newBufferFn`       | `(size) => new Uint8Array(size)` | Factory used to allocate new buffers.                               |
+
+## Error handling
+
+The encoder and decoder currently throw plain `Error`s for invalid usage — e.g.
+registering a duplicate or out-of-range extension type, looking up an extension
+that isn't registered, or decoding a malformed timestamp payload. There's no
+dedicated error class hierarchy yet, so catch `Error` and inspect `message` if
+you need to branch on failure.
+
 ## License
 
 MIT

package/dist/cjs/{bigInt-BdjzezQQ.d.cts → bigInt-CBB8PGpe.d.cts}

@@ -1,6 +1,6 @@
-import { t as MessagePackDecoderBuffer } from "./messagePackDecoderBuffer-B2rRVlMX.cjs";
-import { i as ExtensionEncoderBuffer } from "./messagePackExtension-Cd99Rw9t.cjs";
-import { t as UntypedExtension } from "./untypedExtension-wx6-_4mg.cjs";
+import { t as MessagePackDecoderBuffer } from "./messagePackDecoderBuffer-CMG0LPbJ.cjs";
+import { i as ExtensionEncoderBuffer } from "./messagePackExtension-C_TQXlEn.cjs";
+import { t as UntypedExtension } from "./untypedExtension-WQvArYoO.cjs";
 //#region src/extensions/bigint/bigInt.d.ts
 /**
  * This class encodes and decodes JavaScript BigInt values that are outside the
@@ -32,4 +32,4 @@ declare class BigIntExtension<TBuffer extends Uint8Array = Uint8Array> extends U
 }
 //#endregion
 export { BigIntExtension as t };
-//# sourceMappingURL=bigInt-BdjzezQQ.d.cts.map
+//# sourceMappingURL=bigInt-CBB8PGpe.d.cts.map

package/dist/{esm/bigInt-D37SPzzB.d.mts.map → cjs/bigInt-CBB8PGpe.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"bigInt-D37SPzzB.d.mts","names":[],"sources":["../../src/extensions/bigint/bigInt.ts"],"mappings":";;;;;;;;;;;;cAcM,gBACJ,gBAAgB,aAAa,oBACrB,yBAAyB;;;;;;;;;;;;EAYjC,OACE,wBACA,QAAQ,uBAAuB;;;;;;EAyBjC,OAAO,QAAQ,0BAA0B"}
+{"version":3,"file":"bigInt-CBB8PGpe.d.cts","names":[],"sources":["../../src/extensions/bigint/bigInt.ts"],"mappings":";;;;;;;;;;;;cAcM,gBACJ,gBAAgB,aAAa,oBACrB,yBAAyB;;;;;;;;;;;;EAYjC,OACE,wBACA,QAAQ,uBAAuB;;;;;;EAyBjC,OAAO,QAAQ,0BAA0B"}

package/dist/{esm/bufferWithExtensions-DzAs7yX1.d.mts → cjs/bufferWithExtensions-BAinwJsn.d.cts}

@@ -1,4 +1,4 @@
-import { o as MessagePackBufferWithExtensions, t as MessagePackExtension } from "./messagePackExtension-fq36EMAg.mjs";
+import { o as MessagePackBufferWithExtensions, t as MessagePackExtension } from "./messagePackExtension-C_TQXlEn.cjs";
 //#region src/bufferWithExtensions.d.ts
 declare abstract class BufferWithExtensions<TBuffer extends Uint8Array = Uint8Array> implements MessagePackBufferWithExtensions<TBuffer> {
   protected extensions: Map<number, MessagePackExtension<unknown, TBuffer>>;
@@ -9,4 +9,4 @@ declare abstract class BufferWithExtensions<TBuffer extends Uint8Array = Uint8Ar
 }
 //#endregion
 export { BufferWithExtensions as t };
-//# sourceMappingURL=bufferWithExtensions-DzAs7yX1.d.mts.map
+//# sourceMappingURL=bufferWithExtensions-BAinwJsn.d.cts.map

package/dist/cjs/{bufferWithExtensions-n6DtcUoA.d.cts.map → bufferWithExtensions-BAinwJsn.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"bufferWithExtensions-n6DtcUoA.d.cts","names":[],"sources":["../../src/bufferWithExtensions.ts"],"mappings":";;uBAGe,qBACb,gBAAgB,aAAa,uBAClB,gCAAgC;YACjC,YAAY,YAAY,8BAA8B;EAEhE;EAIA,aAAa,WAAW,8BAA8B;EAsBtD,qBACE,WAAW,8BAA8B;EAuB3C,eAAe,eAAe,8BAA8B"}
+{"version":3,"file":"bufferWithExtensions-BAinwJsn.d.cts","names":[],"sources":["../../src/bufferWithExtensions.ts"],"mappings":";;uBAGe,qBACb,gBAAgB,aAAa,uBAClB,gCAAgC;YACjC,YAAY,YAAY,8BAA8B;EAEhE;EAIA,aAAa,WAAW,8BAA8B;EAsBtD,qBACE,WAAW,8BAA8B;EAuB3C,eAAe,eAAe,8BAA8B"}

package/dist/cjs/bufferWithExtensions.d.cts

@@ -1,2 +1,2 @@
-import { t as BufferWithExtensions } from "./bufferWithExtensions-n6DtcUoA.cjs";
+import { t as BufferWithExtensions } from "./bufferWithExtensions-BAinwJsn.cjs";
 export = BufferWithExtensions;

package/dist/cjs/decoder/decoder.cjs

@@ -6,7 +6,7 @@ var Decoder = class {
 		this.decoderBuffer = new require_decoder_decoderBuffer(options);
 	}
 	decode(encodedBuffer) {
-		const decoderBuffer = this.decoderBuffer;
+		const { decoderBuffer } = this;
 		decoderBuffer.setBuffer(encodedBuffer);
 		return decoderBuffer.nextValue();
 	}

package/dist/cjs/decoder/decoder.d.cts

@@ -1,2 +1,2 @@
-import { t as Decoder } from "../decoder-3WpVBZjY.cjs";
+import { t as Decoder } from "../decoder-C1cd4I8S.cjs";
 export = Decoder;

package/dist/cjs/decoder/decoderBuffer.cjs

@@ -1,4 +1,5 @@
 const require_bufferWithExtensions = require("../bufferWithExtensions.cjs");
+require("../constants.cjs");
 const require_defaultNewBufferFn = require("../defaultNewBufferFn.cjs");
 const require_symbols = require("../symbols.cjs");
 const require_decoder_textDecoders_defaultTextDecoder = require("./textDecoders/defaultTextDecoder.cjs");
@@ -10,8 +11,8 @@ var DecoderBuffer = class extends require_bufferWithExtensions {
 	textDecoder = new require_decoder_textDecoders_defaultTextDecoder();
 	constructor(options) {
 		super();
-		const bufferFactory = options?.bufferFactory ?? require_defaultNewBufferFn;
-		this.buffer = bufferFactory(0);
+		const newBufferFn = options?.newBufferFn ?? require_defaultNewBufferFn;
+		this.buffer = newBufferFn(options?.initialBufferSize ?? 1024);
 		this.view = new DataView(this.buffer.buffer);
 		this.offset = 0;
 	}

package/dist/cjs/decoder/decoderBuffer.d.cts

@@ -1,2 +1,2 @@
-import { t as DecoderBuffer } from "../decoderBuffer-CJU2hdt2.cjs";
+import { t as DecoderBuffer } from "../decoderBuffer-C9_0y-3q.cjs";
 export = DecoderBuffer;

package/dist/cjs/decoder/index.cjs

@@ -1,11 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_decoder_textDecoders_defaultTextDecoder = require("./textDecoders/defaultTextDecoder.cjs");
-const require_decoder_textDecoders_nodeTextDecoder = require("./textDecoders/nodeTextDecoder.cjs");
 const require_decoder_decoderBuffer = require("./decoderBuffer.cjs");
 const require_decoder_decoder = require("./decoder.cjs");
-const require_decoder_decode = require("./decode.cjs");
 exports.Decoder = require_decoder_decoder;
 exports.DecoderBuffer = require_decoder_decoderBuffer;
-exports.DefaultTextDecoder = require_decoder_textDecoders_defaultTextDecoder;
-exports.NodeTextDecoder = require_decoder_textDecoders_nodeTextDecoder;
-exports.decode = require_decoder_decode;

package/dist/cjs/decoder/index.d.cts

@@ -1,8 +1,5 @@
-import { t as MessagePackTextDecoder } from "../messagePackTextDecoder-J3fr-wQn.cjs";
-import { t as MessagePackDecoderBuffer } from "../messagePackDecoderBuffer-B2rRVlMX.cjs";
-import { t as decode } from "../decode-BraWmoPw.cjs";
-import { t as DefaultTextDecoder } from "../defaultTextDecoder-DY92jDSO.cjs";
-import { t as DecoderBuffer } from "../decoderBuffer-CJU2hdt2.cjs";
-import { t as Decoder } from "../decoder-3WpVBZjY.cjs";
-import { t as NodeTextDecoder } from "../nodeTextDecoder-DrNFdTVk.cjs";
-export { Decoder, DecoderBuffer, DefaultTextDecoder, type MessagePackDecoderBuffer, type MessagePackTextDecoder, NodeTextDecoder, decode };
+import { t as MessagePackTextDecoder } from "../messagePackTextDecoder-CtyB0N6j.cjs";
+import { t as MessagePackDecoderBuffer } from "../messagePackDecoderBuffer-CMG0LPbJ.cjs";
+import { t as DecoderBuffer } from "../decoderBuffer-C9_0y-3q.cjs";
+import { t as Decoder } from "../decoder-C1cd4I8S.cjs";
+export { Decoder, DecoderBuffer, type MessagePackDecoderBuffer, type MessagePackTextDecoder };

package/dist/cjs/decoder/interfaces/index.d.cts

@@ -1,4 +1,4 @@
-import { t as MessagePackTextDecoder } from "../../messagePackTextDecoder-J3fr-wQn.cjs";
-import { t as MessagePackDecoderBuffer } from "../../messagePackDecoderBuffer-B2rRVlMX.cjs";
+import { t as MessagePackTextDecoder } from "../../messagePackTextDecoder-CtyB0N6j.cjs";
+import { t as MessagePackDecoderBuffer } from "../../messagePackDecoderBuffer-CMG0LPbJ.cjs";
 import "../../index-CaxrMD1A.cjs";
 export type { MessagePackDecoderBuffer, MessagePackTextDecoder };

package/dist/cjs/decoder/interfaces/messagePackDecoderBuffer.d.cts

@@ -1,2 +1,2 @@
-import { t as MessagePackDecoderBuffer } from "../../messagePackDecoderBuffer-B2rRVlMX.cjs";
+import { t as MessagePackDecoderBuffer } from "../../messagePackDecoderBuffer-CMG0LPbJ.cjs";
 export = MessagePackDecoderBuffer;

package/dist/cjs/decoder/interfaces/messagePackTextDecoder.d.cts

@@ -1,2 +1,2 @@
-import { t as MessagePackTextDecoder } from "../../messagePackTextDecoder-J3fr-wQn.cjs";
+import { t as MessagePackTextDecoder } from "../../messagePackTextDecoder-CtyB0N6j.cjs";
 export = MessagePackTextDecoder;

package/dist/cjs/decoder/textDecoders/defaultTextDecoder.d.cts

@@ -1,2 +1,2 @@
-import { t as DefaultTextDecoder } from "../../defaultTextDecoder-DY92jDSO.cjs";
+import { t as DefaultTextDecoder } from "../../defaultTextDecoder-Ji2hTZkf.cjs";
 export = DefaultTextDecoder;

package/dist/cjs/decoder/types.d.cts

@@ -1,2 +1,2 @@
-import { t as DecoderBufferOptions } from "../types-CC2wkzZa.cjs";
+import { t as DecoderBufferOptions } from "../types-DHnp4kMw.cjs";
 export { DecoderBufferOptions };

package/dist/cjs/{decoder-3WpVBZjY.d.cts → decoder-C1cd4I8S.d.cts}

@@ -1,6 +1,6 @@
-import { t as MessagePackExtension } from "./messagePackExtension-Cd99Rw9t.cjs";
-import { t as DecoderBufferOptions } from "./types-CC2wkzZa.cjs";
-import { t as DecoderBuffer } from "./decoderBuffer-CJU2hdt2.cjs";
+import { t as MessagePackExtension } from "./messagePackExtension-C_TQXlEn.cjs";
+import { t as DecoderBufferOptions } from "./types-DHnp4kMw.cjs";
+import { t as DecoderBuffer } from "./decoderBuffer-C9_0y-3q.cjs";
 //#region src/decoder/decoder.d.ts
 declare class Decoder<TBuffer extends Uint8Array = Uint8Array> {
   protected decoderBuffer: DecoderBuffer<TBuffer>;
@@ -12,4 +12,4 @@ declare class Decoder<TBuffer extends Uint8Array = Uint8Array> {
 }
 //#endregion
 export { Decoder as t };
-//# sourceMappingURL=decoder-3WpVBZjY.d.cts.map
+//# sourceMappingURL=decoder-C1cd4I8S.d.cts.map

package/dist/cjs/decoder-C1cd4I8S.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder-C1cd4I8S.d.cts","names":[],"sources":["../../src/decoder/decoder.ts"],"mappings":";;;;cAUM,QAAQ,gBAAgB,aAAa;YAC/B,eAAe,cAAc;EAEvC,YAAY,UAAU,qBAAqB;EAK3C,OAAO,kBAAkB,eAAe,UAAU;EAoBlD,aAAa,WAAW,8BAA8B;EAMtD,qBACE,WAAW,8BAA8B;EAO3C,iBACE,cACA,WAAW,KAAK,8BAA8B"}

package/dist/{esm/decoderBuffer-93dMcsbx.d.mts → cjs/decoderBuffer-C9_0y-3q.d.cts}

@@ -1,7 +1,7 @@
-import { t as MessagePackDecoderBuffer } from "./messagePackDecoderBuffer-Cqvg0zW7.mjs";
-import { t as BufferWithExtensions } from "./bufferWithExtensions-DzAs7yX1.mjs";
-import { t as DefaultTextDecoder } from "./defaultTextDecoder-DztyzoBV.mjs";
-import { t as DecoderBufferOptions } from "./types-CNR_qJsr.mjs";
+import { t as MessagePackDecoderBuffer } from "./messagePackDecoderBuffer-CMG0LPbJ.cjs";
+import { t as BufferWithExtensions } from "./bufferWithExtensions-BAinwJsn.cjs";
+import { t as DefaultTextDecoder } from "./defaultTextDecoder-Ji2hTZkf.cjs";
+import { t as DecoderBufferOptions } from "./types-DHnp4kMw.cjs";
 //#region src/decoder/decoderBuffer.d.ts
 declare class DecoderBuffer<TBuffer extends Uint8Array = Uint8Array> extends BufferWithExtensions<TBuffer> implements MessagePackDecoderBuffer<TBuffer> {
   buffer: TBuffer;
@@ -19,4 +19,4 @@ declare class DecoderBuffer<TBuffer extends Uint8Array = Uint8Array> extends Buf
 }
 //#endregion
 export { DecoderBuffer as t };
-//# sourceMappingURL=decoderBuffer-93dMcsbx.d.mts.map
+//# sourceMappingURL=decoderBuffer-C9_0y-3q.d.cts.map

package/dist/cjs/decoderBuffer-C9_0y-3q.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoderBuffer-C9_0y-3q.d.cts","names":[],"sources":["../../src/decoder/decoderBuffer.ts"],"mappings":";;;;;cASM,cAAc,gBAAgB,aAAa,oBACvC,qBAAqB,oBAClB,yBAAyB;EAEpC,QAAQ;EACR;EACA,MAAM;EACN,aAAW;EAEX,YAAY,UAAU,qBAAqB;EAY3C,UAAU,QAAQ;EAYlB,UAAU;EAcV,QAAQ;EAkDR;EAIA,QAAQ,iBAAiB;EAoBzB,kBAAkB;EAgLlB,UAAU,qBAAqB"}

package/dist/{esm/defaultTextDecoder-DztyzoBV.d.mts → cjs/defaultTextDecoder-Ji2hTZkf.d.cts}

@@ -1,4 +1,4 @@
-import { t as MessagePackTextDecoder } from "./messagePackTextDecoder-J3fr-wQn.mjs";
+import { t as MessagePackTextDecoder } from "./messagePackTextDecoder-CtyB0N6j.cjs";
 //#region src/decoder/textDecoders/defaultTextDecoder.d.ts
 declare class DefaultTextDecoder implements MessagePackTextDecoder {
   protected textDecoder: TextDecoder;
@@ -7,4 +7,4 @@ declare class DefaultTextDecoder implements MessagePackTextDecoder {
 }
 //#endregion
 export { DefaultTextDecoder as t };
-//# sourceMappingURL=defaultTextDecoder-DztyzoBV.d.mts.map
+//# sourceMappingURL=defaultTextDecoder-Ji2hTZkf.d.cts.map

package/dist/cjs/{defaultTextDecoder-DY92jDSO.d.cts.map → defaultTextDecoder-Ji2hTZkf.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"defaultTextDecoder-DY92jDSO.d.cts","names":[],"sources":["../../src/decoder/textDecoders/defaultTextDecoder.ts"],"mappings":";;cAEM,8BAA8B;YACxB,aAAa;EAEvB;EAIA,OAAO,QAAQ,YAAY,eAAe"}
+{"version":3,"file":"defaultTextDecoder-Ji2hTZkf.d.cts","names":[],"sources":["../../src/decoder/textDecoders/defaultTextDecoder.ts"],"mappings":";;cAEM,8BAA8B;YACxB,aAAa;EAEvB;EAIA,OAAO,QAAQ,YAAY,eAAe"}

package/dist/cjs/encoder/encoder.cjs

@@ -14,9 +14,9 @@ var Encoder = class {
 		this.buffer = new require_encoder_encoderBuffer(options);
 	}
 	encode(value) {
-		const buffer = this.buffer;
+		const { buffer } = this;
 		buffer.write(value);
-		return buffer.flush();
+		return this.buffer.flush();
 	}
 	addExtension(extension) {
 		this.buffer.addExtension(extension);

package/dist/cjs/encoder/encoder.d.cts

@@ -1,2 +1,2 @@
-import { t as Encoder } from "../encoder-B-rTvI4P.cjs";
+import { t as Encoder } from "../encoder-DXuhGwd7.cjs";
 export = Encoder;

package/dist/cjs/encoder/encoderBuffer.cjs

@@ -39,7 +39,7 @@ var EncoderBuffer = class EncoderBuffer extends require_bufferWithExtensions {
 	* to accommodate the data being written. The function should return a new
 	* instance of TBuffer with the specified size.
 	*/
-	bufferFactory;
+	newBufferFn;
 	textEncoder;
 	buffer;
 	view;
@@ -58,25 +58,25 @@ var EncoderBuffer = class EncoderBuffer extends require_bufferWithExtensions {
 		super();
 		this.offset = 0;
 		this.textEncoder = options?.textEncoder ?? new require_encoder_textEncoders_defaultTextEncoder();
-		this.bufferFactory = options?.bufferFactory ?? require_defaultNewBufferFn;
-		this.buffer = this.bufferFactory(options?.initialBufferSize ?? 1024);
-		this.sharedBuffer = this.bufferFactory(options?.initialSharedBufferSize ?? 1024);
+		this.newBufferFn = options?.newBufferFn ?? require_defaultNewBufferFn;
+		this.buffer = this.newBufferFn(options?.initialBufferSize ?? 1024);
+		this.sharedBuffer = this.newBufferFn(options?.initialSharedBufferSize ?? 1024);
 		this.view = new DataView(this.buffer.buffer, this.buffer.byteOffset, this.buffer.byteLength);
 		this.sortKeys = options?.sortKeys ?? false;
 		this.forceFloat32 = options?.forceFloat32 ?? false;
 	}
 	getExtensionBuffer() {
 		if (!this.#extensionBuffer) this.#extensionBuffer = new EncoderBuffer({
-			bufferFactory: this.bufferFactory,
 			initialBufferSize: this.sharedBuffer.byteLength,
 			initialSharedBufferSize: 0,
+			newBufferFn: this.newBufferFn,
 			sortKeys: this.sortKeys,
 			textEncoder: this.textEncoder
 		});
 		return this.#extensionBuffer;
 	}
 	resizeBuffer(newSize) {
-		const newBuffer = this.bufferFactory(newSize);
+		const newBuffer = this.newBufferFn(newSize);
 		newBuffer.set(this.buffer);
 		this.buffer = newBuffer;
 		this.view = new DataView(this.buffer.buffer, this.buffer.byteOffset, this.buffer.byteLength);
@@ -392,8 +392,8 @@ var EncoderBuffer = class EncoderBuffer extends require_bufferWithExtensions {
 			}
 			this.offset = initialoffset;
 		}
-		if (this.sharedBuffer.byteLength < requiredSize) this.sharedBuffer = this.bufferFactory(requiredSize);
-		const sharedBuffer = this.sharedBuffer;
+		if (this.sharedBuffer.byteLength < requiredSize) this.sharedBuffer = this.newBufferFn(requiredSize);
+		const { sharedBuffer } = this;
 		const byteLength = this.textEncoder.writeBytes(value, sharedBuffer);
 		if (require_utils_fitIn8Bits(byteLength)) {
 			this.ensureCapacity(2 + byteLength);
@@ -462,13 +462,18 @@ var EncoderBuffer = class EncoderBuffer extends require_bufferWithExtensions {
 		} else if (this.forceFloat32) {
 			this.ensureCapacity(5);
 			this.writeFloat32Symbol();
-			return this.writeFloat32(value);
+			this.writeFloat32(value);
+		} else {
+			this.ensureCapacity(9);
+			this.writeFloat64Symbol();
+			this.writeFloat64(value);
 		}
-		this.ensureCapacity(9);
-		this.writeFloat64Symbol();
-		return this.writeFloat64(value);
+		return this;
 	}
-	openMap(keysLength) {
+	writeMap(value) {
+		const keys = Object.keys(value);
+		if (this.sortKeys) keys.sort();
+		const keysLength = keys.length;
 		const requiredSize = keysLength * 4;
 		if (keysLength < 16) {
 			this.ensureCapacity(requiredSize + 1);
@@ -479,21 +484,15 @@ var EncoderBuffer = class EncoderBuffer extends require_bufferWithExtensions {
 		} else if (require_utils_fitIn32Bits(keysLength)) {
 			this.ensureCapacity(requiredSize + 5);
 			this.writeMap32Symbol(keysLength);
-		} else throw new Error(`Map size ${keysLength} exceeds maximum allowed size of ${require_constants.UINT32_MAX}`);
-		return this;
-	}
-	writeMap(value) {
-		const keys = Object.keys(value);
-		if (this.sortKeys) keys.sort();
-		const keysLength = keys.length;
-		this.openMap(keysLength);
+		} else throw new Error(`Map too large to encode: ${keysLength} keys`);
 		for (const key of keys) {
-			this.writeString(key);
+			this.write(key);
 			this.write(value[key]);
 		}
 		return this;
 	}
-	openArray(length) {
+	writeArray(value) {
+		const length = value.length;
 		const requiredSize = length * 4;
 		if (length < 16) {
 			this.ensureCapacity(requiredSize + 1);
@@ -504,12 +503,7 @@ var EncoderBuffer = class EncoderBuffer extends require_bufferWithExtensions {
 		} else if (require_utils_fitIn32Bits(length)) {
 			this.ensureCapacity(requiredSize + 5);
 			this.writeArray32Symbol(length);
-		} else throw new Error(`Array size ${length} exceeds maximum allowed size of ${require_constants.UINT32_MAX}`);
-		return this;
-	}
-	writeArray(value) {
-		const length = value.length;
-		this.openArray(length);
+		} else throw new Error(`Array too large to encode: ${length}`);
 		for (let index = 0; index < length; ++index) this.write(value[index]);
 		return this;
 	}

package/dist/cjs/encoder/encoderBuffer.d.cts

@@ -1,2 +1,2 @@
-import { t as EncoderBuffer } from "../encoderBuffer-3ur0iCYR.cjs";
+import { t as EncoderBuffer } from "../encoderBuffer-DWGIXXjj.cjs";
 export = EncoderBuffer;

package/dist/cjs/encoder/index.cjs

@@ -3,9 +3,7 @@ const require_encoder_textEncoders_defaultTextEncoder = require("./textEncoders/
 const require_encoder_encoderBuffer = require("./encoderBuffer.cjs");
 const require_encoder_encoder = require("./encoder.cjs");
 const require_encoder_textEncoders_nodeTextEncoder = require("./textEncoders/nodeTextEncoder.cjs");
-const require_encoder_encode = require("./encode.cjs");
 exports.DefaultTextEncoder = require_encoder_textEncoders_defaultTextEncoder;
 exports.Encoder = require_encoder_encoder;
 exports.EncoderBuffer = require_encoder_encoderBuffer;
 exports.NodeTextEncoder = require_encoder_textEncoders_nodeTextEncoder;
-exports.encode = require_encoder_encode;

package/dist/cjs/encoder/index.d.cts

@@ -1,8 +1,7 @@
-import { a as OmitByPattern, i as ExtensionEncoderBuffer, n as MessagePackEncoderBuffer, r as EncoderBufferOptions } from "../messagePackExtension-Cd99Rw9t.cjs";
+import { a as OmitByPattern, i as ExtensionEncoderBuffer, n as MessagePackEncoderBuffer, r as EncoderBufferOptions } from "../messagePackExtension-C_TQXlEn.cjs";
 import { t as MessagePackTextEncoder } from "../messagePackTextEncoder-D7iCft_t.cjs";
-import { t as encode } from "../encode-4SxHVw0M.cjs";
-import { t as EncoderBuffer } from "../encoderBuffer-3ur0iCYR.cjs";
-import { t as Encoder } from "../encoder-B-rTvI4P.cjs";
+import { t as EncoderBuffer } from "../encoderBuffer-DWGIXXjj.cjs";
+import { t as Encoder } from "../encoder-DXuhGwd7.cjs";
 import { t as DefaultTextEncoder } from "../defaultTextEncoder-DzdGBX6s.cjs";
 import { t as NodeTextEncoder } from "../nodeTextEncoder-DJzFDBXd.cjs";
-export { DefaultTextEncoder, Encoder, EncoderBuffer, type EncoderBufferOptions, type ExtensionEncoderBuffer, type MessagePackEncoderBuffer, type MessagePackTextEncoder, NodeTextEncoder, type OmitByPattern, encode };
+export { DefaultTextEncoder, Encoder, EncoderBuffer, type EncoderBufferOptions, type ExtensionEncoderBuffer, type MessagePackEncoderBuffer, type MessagePackTextEncoder, NodeTextEncoder, type OmitByPattern };

package/dist/cjs/encoder/interfaces/index.d.cts

@@ -1,4 +1,4 @@
-import { n as MessagePackEncoderBuffer } from "../../messagePackExtension-Cd99Rw9t.cjs";
+import { n as MessagePackEncoderBuffer } from "../../messagePackExtension-C_TQXlEn.cjs";
 import { t as MessagePackTextEncoder } from "../../messagePackTextEncoder-D7iCft_t.cjs";
-import "../../index-DMnXy2Rv.cjs";
+import "../../index-DeSJDZGk.cjs";
 export type { MessagePackEncoderBuffer, MessagePackTextEncoder };

package/dist/cjs/encoder/interfaces/messagePackEncoderBuffer.d.cts

@@ -1,2 +1,2 @@
-import { n as MessagePackEncoderBuffer } from "../../messagePackExtension-Cd99Rw9t.cjs";
+import { n as MessagePackEncoderBuffer } from "../../messagePackExtension-C_TQXlEn.cjs";
 export = MessagePackEncoderBuffer;

package/dist/cjs/encoder/textEncoders/index.d.cts

@@ -1,4 +1,4 @@
 import { t as DefaultTextEncoder } from "../../defaultTextEncoder-DzdGBX6s.cjs";
 import { t as NodeTextEncoder } from "../../nodeTextEncoder-DJzFDBXd.cjs";
-import "../../index-CQnkyOId.cjs";
+import "../../index-DMnXy2Rv.cjs";
 export { DefaultTextEncoder, NodeTextEncoder };

package/dist/cjs/encoder/types.d.cts

@@ -1,2 +1,2 @@
-import { a as OmitByPattern, i as ExtensionEncoderBuffer, r as EncoderBufferOptions } from "../messagePackExtension-Cd99Rw9t.cjs";
+import { a as OmitByPattern, i as ExtensionEncoderBuffer, r as EncoderBufferOptions } from "../messagePackExtension-C_TQXlEn.cjs";
 export { EncoderBufferOptions, ExtensionEncoderBuffer, OmitByPattern };

package/dist/cjs/{encoder-B-rTvI4P.d.cts → encoder-DXuhGwd7.d.cts}

@@ -1,5 +1,5 @@
-import { r as EncoderBufferOptions, t as MessagePackExtension } from "./messagePackExtension-Cd99Rw9t.cjs";
-import { t as EncoderBuffer } from "./encoderBuffer-3ur0iCYR.cjs";
+import { r as EncoderBufferOptions, t as MessagePackExtension } from "./messagePackExtension-C_TQXlEn.cjs";
+import { t as EncoderBuffer } from "./encoderBuffer-DWGIXXjj.cjs";
 //#region src/encoder/encoder.d.ts
 /**
  * The `Encoder` class is responsible for encoding JavaScript values into the
@@ -12,7 +12,7 @@ import { t as EncoderBuffer } from "./encoderBuffer-3ur0iCYR.cjs";
 declare class Encoder<TBuffer extends Uint8Array = Uint8Array> {
   buffer: EncoderBuffer<TBuffer>;
   constructor(options?: Partial<EncoderBufferOptions<TBuffer>>);
-  encode(value: unknown): TBuffer;
+  encode(value: unknown): Uint8Array;
   addExtension(extension: MessagePackExtension<unknown, TBuffer>): this;
   addInternalExtension(extension: MessagePackExtension<unknown, TBuffer>): this;
   addExtensionType(type: number, extension: Omit<MessagePackExtension<unknown, TBuffer>, 'type'>): this;
@@ -20,4 +20,4 @@ declare class Encoder<TBuffer extends Uint8Array = Uint8Array> {
 }
 //#endregion
 export { Encoder as t };
-//# sourceMappingURL=encoder-B-rTvI4P.d.cts.map
+//# sourceMappingURL=encoder-DXuhGwd7.d.cts.map

package/dist/cjs/{encoder-B-rTvI4P.d.cts.map → encoder-DXuhGwd7.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"encoder-B-rTvI4P.d.cts","names":[],"sources":["../../src/encoder/encoder.ts"],"mappings":";;;;;;;;;;;cAYM,QAAQ,gBAAgB,aAAa;EACzC,QAAQ,cAAc;EAEtB,YAAY,UAAU,QAAQ,qBAAqB;EAInD,OAAO,iBAAiB;EAQxB,aAAa,WAAW,8BAA8B;EAMtD,qBACE,WAAW,8BAA8B;EAO3C,iBACE,cACA,WAAW,KAAK,8BAA8B;EAOhD,eAAe,eAAe,8BAA8B"}
+{"version":3,"file":"encoder-DXuhGwd7.d.cts","names":[],"sources":["../../src/encoder/encoder.ts"],"mappings":";;;;;;;;;;;cAYM,QAAQ,gBAAgB,aAAa;EACzC,QAAQ,cAAc;EAEtB,YAAY,UAAU,QAAQ,qBAAqB;EAInD,OAAO,iBAAiB;EAQxB,aAAa,WAAW,8BAA8B;EAMtD,qBACE,WAAW,8BAA8B;EAO3C,iBACE,cACA,WAAW,KAAK,8BAA8B;EAOhD,eAAe,eAAe,8BAA8B"}

package/dist/cjs/{encoderBuffer-3ur0iCYR.d.cts → encoderBuffer-DWGIXXjj.d.cts}

@@ -1,7 +1,7 @@
-import { i as ExtensionEncoderBuffer, n as MessagePackEncoderBuffer, r as EncoderBufferOptions, t as MessagePackExtension } from "./messagePackExtension-Cd99Rw9t.cjs";
-import { t as BufferFactory } from "./types-DTcs4Mkd.cjs";
+import { i as ExtensionEncoderBuffer, n as MessagePackEncoderBuffer, r as EncoderBufferOptions, t as MessagePackExtension } from "./messagePackExtension-C_TQXlEn.cjs";
+import { n as NewBufferFn } from "./types-BJie2edF.cjs";
 import { t as MessagePackTextEncoder } from "./messagePackTextEncoder-D7iCft_t.cjs";
-import { t as BufferWithExtensions } from "./bufferWithExtensions-n6DtcUoA.cjs";
+import { t as BufferWithExtensions } from "./bufferWithExtensions-BAinwJsn.cjs";
 //#region src/encoder/encoderBuffer.d.ts
 declare class EncoderBuffer<TBuffer extends Uint8Array = Uint8Array> extends BufferWithExtensions<TBuffer> implements MessagePackEncoderBuffer<TBuffer> {
   #private;
@@ -35,7 +35,7 @@ declare class EncoderBuffer<TBuffer extends Uint8Array = Uint8Array> extends Buf
    * to accommodate the data being written. The function should return a new
    * instance of TBuffer with the specified size.
    */
-  protected bufferFactory: BufferFactory<TBuffer>;
+  protected newBufferFn: NewBufferFn<TBuffer>;
   readonly textEncoder: MessagePackTextEncoder<TBuffer>;
   buffer: TBuffer;
   view: DataView;
@@ -95,9 +95,7 @@ declare class EncoderBuffer<TBuffer extends Uint8Array = Uint8Array> extends Buf
   writeExt32Symbol(type: number, size: number): this;
   writeString(value: string): this;
   writeNumber(value: number): this;
-  openMap(keysLength: number): this;
   writeMap<TKey extends string | number, TValue>(value: Record<TKey, TValue>): this;
-  openArray(length: number): this;
   writeArray(value: unknown[]): this;
   writeUint8Array(value: Uint8Array): this;
   writeExtension(extension: MessagePackExtension, buffer: ExtensionEncoderBuffer<TBuffer>): this;
@@ -108,4 +106,4 @@ declare class EncoderBuffer<TBuffer extends Uint8Array = Uint8Array> extends Buf
 }
 //#endregion
 export { EncoderBuffer as t };
-//# sourceMappingURL=encoderBuffer-3ur0iCYR.d.cts.map
+//# sourceMappingURL=encoderBuffer-DWGIXXjj.d.cts.map

package/dist/cjs/{encoderBuffer-3ur0iCYR.d.cts.map → encoderBuffer-DWGIXXjj.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"encoderBuffer-3ur0iCYR.d.cts","names":[],"sources":["../../src/encoder/encoderBuffer.ts"],"mappings":";;;;;cAuBM,cAAc,gBAAgB,aAAa,oBACvC,qBAAqB,oBAClB,yBAAyB;;;EAGpC;;;;;;;YAQU,cAAc;;;;;;;WAQf;;;;;;;;WASA;;;;;;;YAQC,eAAe,cAAc;WAE9B,aAAa,uBAAuB;EAE7C,QAAQ;EACR,MAAM;EAcN,YAAY,UAAU,QAAQ,qBAAqB;EAwBnD,sBAAsB,cAAc;EAcpC,aAAa;EAeb,eAAe;EAUf;EAMA,SAAS;EAST,oBAAoB;EAMpB,oBAAoB;EAOpB,SAAS,OAAO;EAQhB,aAAa;EAOb,aAAa;EAOb,WAAW;EAMX,YAAY;EAOZ,YAAY;EAOZ,YAAY;EAaZ,UAAU;EAMV,WAAW;EAOX,WAAW;EAOX,WAAW;EA0BX,SAAS;EAMT;EAMA;EAMA;EAMA,kBAAkB;EAMlB,oBAAoB;EAMpB,kBAAkB;EAMlB,gBAAgB;EAOhB,iBAAiB;EAQjB,iBAAiB;EAQjB;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA,gBAAgB;EAOhB,iBAAiB;EASjB,iBAAiB;EASjB,mBAAmB;EASnB,mBAAmB;EASnB,iBAAiB;EASjB,iBAAiB;EASjB,mBAAmB;EAOnB,mBAAmB;EAOnB,mBAAmB;EAOnB,mBAAmB;EAOnB,oBAAoB;EAOpB,gBAAgB,cAAc;EAQ9B,iBAAiB,cAAc;EAW/B,iBAAiB,cAAc;EAW/B,YAAY;EAyGZ,YAAY;EA0EZ,QAAQ;EAqBR,SAAS,8BAA8B,QACrC,OAAO,OAAO,MAAM;EAqBtB,UAAU;EAqBV,WAAW;EAwBX,gBAAgB,OAAO;EAiBvB,eACE,WAAW,sBACX,QAAQ,uBAAuB;EAiDjC,yBAAyB;EAqBzB,YAAY;EAYZ,YAAY;EAkBZ,MAAM"}
+{"version":3,"file":"encoderBuffer-DWGIXXjj.d.cts","names":[],"sources":["../../src/encoder/encoderBuffer.ts"],"mappings":";;;;;cAsBM,cAAc,gBAAgB,aAAa,oBACvC,qBAAqB,oBAClB,yBAAyB;;;EAGpC;;;;;;;YAQU,cAAc;;;;;;;WAQf;;;;;;;;WASA;;;;;;;YAQC,aAAa,YAAY;WAE1B,aAAa,uBAAuB;EAE7C,QAAQ;EACR,MAAM;EAcN,YAAY,UAAU,QAAQ,qBAAqB;EAwBnD,sBAAsB,cAAc;EAcpC,aAAa;EAeb,eAAe;EAUf;EAMA,SAAS;EAST,oBAAoB;EAMpB,oBAAoB;EAOpB,SAAS,OAAO;EAQhB,aAAa;EAOb,aAAa;EAOb,WAAW;EAMX,YAAY;EAOZ,YAAY;EAOZ,YAAY;EAaZ,UAAU;EAMV,WAAW;EAOX,WAAW;EAOX,WAAW;EA0BX,SAAS;EAMT;EAMA;EAMA;EAMA,kBAAkB;EAMlB,oBAAoB;EAMpB,kBAAkB;EAMlB,gBAAgB;EAOhB,iBAAiB;EAQjB,iBAAiB;EAQjB;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA;EAMA,gBAAgB;EAOhB,iBAAiB;EASjB,iBAAiB;EASjB,mBAAmB;EASnB,mBAAmB;EASnB,iBAAiB;EASjB,iBAAiB;EASjB,mBAAmB;EAOnB,mBAAmB;EAOnB,mBAAmB;EAOnB,mBAAmB;EAOnB,oBAAoB;EAOpB,gBAAgB,cAAc;EAQ9B,iBAAiB,cAAc;EAW/B,iBAAiB,cAAc;EAW/B,YAAY;EAyGZ,YAAY;EA4EZ,SAAS,8BAA8B,QACrC,OAAO,OAAO,MAAM;EAiCtB,WAAW;EAoCX,gBAAgB,OAAO;EAiBvB,eACE,WAAW,sBACX,QAAQ,uBAAuB;EAiDjC,yBAAyB;EAqBzB,YAAY;EAYZ,YAAY;EAkBZ,MAAM"}