cborg 4.5.8 → 5.0.1

package/types/lib/taglib.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Decode a positive bignum from bytes (Tag 2)
+ * @param {import('../interface.js').TagDecodeControl} decode
+ * @returns {bigint}
+ */
+export function bigIntDecoder(decode: import("../interface.js").TagDecodeControl): bigint;
+/**
+ * Encode a BigInt, only using tags for values outside 64-bit range (IPLD compatible)
+ * @param {bigint} obj
+ * @returns {Token[]|null}
+ */
+export function bigIntEncoder(obj: bigint): Token[] | null;
+/**
+ * Encode a BigInt, always using tags 2/3 (for extended mode, full round-trip fidelity)
+ * @param {bigint} obj
+ * @returns {Token[]}
+ */
+export function structBigIntEncoder(obj: bigint): Token[];
+/**
+ * Decode a negative bignum from bytes (Tag 3)
+ * @param {import('../interface.js').TagDecodeControl} decode
+ * @returns {bigint}
+ */
+export function bigNegIntDecoder(decode: import("../interface.js").TagDecodeControl): bigint;
+/**
+ * Encode a Date as Tag 1 (epoch seconds as float)
+ * @param {Date} date
+ * @returns {Token[]}
+ */
+export function dateEncoder(date: Date): Token[];
+/**
+ * Decode Tag 1 (epoch seconds) to a Date
+ * @param {import('../interface.js').TagDecodeControl} decode
+ * @returns {Date}
+ */
+export function dateDecoder(decode: import("../interface.js").TagDecodeControl): Date;
+/**
+ * Encode a RegExp as Tag 21066
+ * @param {RegExp} re
+ * @returns {Token[]}
+ */
+export function regExpEncoder(re: RegExp): Token[];
+/**
+ * Decode Tag 21066 to a RegExp
+ * @param {import('../interface.js').TagDecodeControl} decode
+ * @returns {RegExp}
+ */
+export function regExpDecoder(decode: import("../interface.js").TagDecodeControl): RegExp;
+/**
+ * Encode a Set as Tag 258 + array
+ * This is a typeEncoder, receives (obj, typ, options, refStack)
+ * @param {Set<any>} set
+ * @param {string} _typ
+ * @param {import('../interface.js').EncodeOptions} options
+ * @param {import('../interface.js').Reference} [refStack]
+ * @returns {import('../interface.js').TokenOrNestedTokens[]}
+ */
+export function setEncoder(set: Set<any>, _typ: string, options: import("../interface.js").EncodeOptions, refStack?: import("../interface.js").Reference): import("../interface.js").TokenOrNestedTokens[];
+/**
+ * Decode Tag 258 to a Set
+ * @param {import('../interface.js').TagDecodeControl} decode
+ * @returns {Set<any>}
+ */
+export function setDecoder(decode: import("../interface.js").TagDecodeControl): Set<any>;
+/**
+ * Encode a Map as Tag 259 + CBOR map
+ * This is a typeEncoder, receives (obj, typ, options, refStack)
+ * @param {Map<any, any>} map
+ * @param {string} _typ
+ * @param {import('../interface.js').EncodeOptions} options
+ * @param {import('../interface.js').Reference} [refStack]
+ * @returns {import('../interface.js').TokenOrNestedTokens[]}
+ */
+export function mapEncoder(map: Map<any, any>, _typ: string, options: import("../interface.js").EncodeOptions, refStack?: import("../interface.js").Reference): import("../interface.js").TokenOrNestedTokens[];
+/**
+ * Decode Tag 259 to a Map
+ * Uses decode.entries() to preserve key types (integers, etc.) regardless of useMaps setting
+ * @param {import('../interface.js').TagDecodeControl} decode
+ * @returns {Map<any, any>}
+ */
+export function mapDecoder(decode: import("../interface.js").TagDecodeControl): Map<any, any>;
+/**
+ * Encode an Error as Tag 27: [className, message]
+ * @param {Error} err
+ * @returns {Token[]}
+ */
+export function errorEncoder(err: Error): Token[];
+/**
+ * Decode Tag 27 to an Error (or Error subclass)
+ * @param {import('../interface.js').TagDecodeControl} decode
+ * @returns {Error}
+ */
+export function errorDecoder(decode: import("../interface.js").TagDecodeControl): Error;
+/**
+ * Encode a number, preserving -0 as a float
+ * Use this as a typeEncoder for 'number' to preserve -0 fidelity
+ * @param {number} num
+ * @returns {Token[] | null}
+ */
+export function negativeZeroEncoder(num: number): Token[] | null;
+export const TAG_DATE_STRING: 0;
+export const TAG_DATE_EPOCH: 1;
+export const TAG_BIGINT_POS: 2;
+export const TAG_BIGINT_NEG: 3;
+export const TAG_UINT8_ARRAY: 64;
+export const TAG_UINT8_CLAMPED_ARRAY: 68;
+export const TAG_INT8_ARRAY: 72;
+export const TAG_UINT16_ARRAY_LE: 69;
+export const TAG_UINT32_ARRAY_LE: 70;
+export const TAG_BIGUINT64_ARRAY_LE: 71;
+export const TAG_INT16_ARRAY_LE: 77;
+export const TAG_INT32_ARRAY_LE: 78;
+export const TAG_BIGINT64_ARRAY_LE: 79;
+export const TAG_FLOAT32_ARRAY_LE: 85;
+export const TAG_FLOAT64_ARRAY_LE: 86;
+export const TAG_OBJECT_CLASS: 27;
+export const TAG_SET: 258;
+export const TAG_MAP: 259;
+export const TAG_REGEXP: 21066;
+export const uint8ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const uint8ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Uint8Array<ArrayBuffer>;
+export const uint8ClampedArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const uint8ClampedArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Uint8ClampedArray<ArrayBuffer>;
+export const int8ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const int8ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Int8Array<ArrayBuffer>;
+export const uint16ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const uint16ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Uint16Array<ArrayBuffer>;
+export const uint32ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const uint32ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Uint32Array<ArrayBuffer>;
+export const bigUint64ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const bigUint64ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => BigUint64Array<ArrayBuffer>;
+export const int16ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const int16ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Int16Array<ArrayBuffer>;
+export const int32ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const int32ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Int32Array<ArrayBuffer>;
+export const bigInt64ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const bigInt64ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => BigInt64Array<ArrayBuffer>;
+export const float32ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const float32ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Float32Array<ArrayBuffer>;
+export const float64ArrayEncoder: (arr: ArrayBufferView) => Token[];
+export const float64ArrayDecoder: (decode: import("../interface.js").TagDecodeControl) => Float64Array<ArrayBuffer>;
+import { Token } from '../cborg.js';
+//# sourceMappingURL=taglib.d.ts.map

package/types/lib/taglib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taglib.d.ts","sourceRoot":"","sources":["../../lib/taglib.js"],"names":[],"mappings":"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"}

package/types/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../cborg.js","../example.js","../taglib.js","../lib/0uint.js","../lib/1negint.js","../lib/2bytes.js","../lib/3string.js","../lib/4array.js","../lib/5map.js","../lib/6tag.js","../lib/7float.js","../lib/bin.js","../lib/bl.js","../lib/byte-utils.js","../lib/common.js","../lib/decode.js","../lib/diagnostic.js","../lib/diagnostic_test.js","../lib/encode.js","../lib/is.js","../lib/jump.js","../lib/length.js","../lib/token.js","../lib/json/decode.js","../lib/json/encode.js","../lib/json/json.js"],"version":"5.9.3"}
+{"root":["../cborg.js","../interface.ts","../lib/0uint.js","../lib/1negint.js","../lib/2bytes.js","../lib/3string.js","../lib/4array.js","../lib/5map.js","../lib/6tag.js","../lib/7float.js","../lib/bl.js","../lib/byte-utils.js","../lib/common.js","../lib/decode.js","../lib/diagnostic.js","../lib/diagnostic_test.js","../lib/encode.js","../lib/is.js","../lib/jump.js","../lib/length.js","../lib/taglib.js","../lib/token.js","../lib/extended/extended.js","../lib/json/decode.js","../lib/json/encode.js","../lib/json/json.js"],"version":"6.0.2"}

package/taglib.js

@@ -1,73 +0,0 @@
-import { Token, Type } from './cborg.js'
-
-/*
-A collection of some standard CBOR tags.
-
-There are no tags included by default in the cborg encoder or decoder, you have
-to include them by passing options. `typeEncoders` for encode() and `tags` for
-decode().
-
-The encoders here can be included with these options (see the tests for how this
-can be done), or as examples for writing additional tags. Additional standard
-(and reasonable) tags may be added here by pull request.
-*/
-
-/* TAG(2) Bignums https://tools.ietf.org/html/rfc8949#section-3.4.3 */
-const neg1b = BigInt(-1)
-const pos1b = BigInt(1)
-const zerob = BigInt(0)
-// const twob = BigInt(2)
-const eightb = BigInt(8)
-
-/**
- * @param {Uint8Array} bytes
- * @returns {bigint}
- */
-export function bigIntDecoder (bytes) {
-  // TODO: assert that `bytes` is a `Uint8Array`
-  let bi = zerob
-  for (let ii = 0; ii < bytes.length; ii++) {
-    bi = (bi << eightb) + BigInt(bytes[ii])
-  }
-  return bi
-}
-
-/**
- * @param {bigint} bi
- * @returns {Uint8Array}
- */
-function fromBigInt (bi) {
-  const buf = []
-  while (bi > 0) {
-    buf.unshift(Number(bi) & 0xff)
-    bi >>= eightb
-  }
-  return Uint8Array.from(buf)
-}
-
-// assuming that we're receiving a BigInt here, it should be registered for
-// type 'bigint' for this to work.
-const maxSafeBigInt = BigInt('18446744073709551615') // (twob ** BigInt(64)) - pos1b
-const minSafeBigInt = BigInt('-18446744073709551616') // neg1b * (twob ** BigInt(64))
-/**
- * @param {bigint} obj
- * @returns {Token[]|null}
- */
-export function bigIntEncoder (obj) {
-  if (obj >= minSafeBigInt && obj <= maxSafeBigInt) {
-    return null // null = do it the standard way
-  }
-  return [
-    new Token(Type.tag, obj >= zerob ? 2 : 3),
-    new Token(Type.bytes, fromBigInt(obj >= zerob ? obj : obj * neg1b - pos1b))
-  ]
-}
-
-/**
- * TAG(3) Negative Bignums https://tools.ietf.org/html/rfc8949#section-3.4.3
- * @param {Uint8Array} bytes
- * @returns {bigint}
- */
-export function bigNegIntDecoder (bytes) {
-  return neg1b - bigIntDecoder(bytes)
-}

package/types/taglib.d.ts

@@ -1,18 +0,0 @@
-/**
- * @param {Uint8Array} bytes
- * @returns {bigint}
- */
-export function bigIntDecoder(bytes: Uint8Array): bigint;
-/**
- * @param {bigint} obj
- * @returns {Token[]|null}
- */
-export function bigIntEncoder(obj: bigint): Token[] | null;
-/**
- * TAG(3) Negative Bignums https://tools.ietf.org/html/rfc8949#section-3.4.3
- * @param {Uint8Array} bytes
- * @returns {bigint}
- */
-export function bigNegIntDecoder(bytes: Uint8Array): bigint;
-import { Token } from './cborg.js';
-//# sourceMappingURL=taglib.d.ts.map

package/types/taglib.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"taglib.d.ts","sourceRoot":"","sources":["../taglib.js"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,qCAHW,UAAU,GACR,MAAM,CASlB;AAmBD;;;GAGG;AACH,mCAHW,MAAM,GACJ,KAAK,EAAE,GAAC,IAAI,CAUxB;AAED;;;;GAIG;AACH,wCAHW,UAAU,GACR,MAAM,CAIlB;sBAxE2B,YAAY"}