@loaders.gl/parquet 4.5.3 → 5.0.0-alpha.10

package/dist/parquetjs/utils/read-utils.js

@@ -3,41 +3,46 @@
 // Copyright (c) vis.gl contributors
 // Copyright (c) 2017 ironSource Ltd.
 // Forked from https://github.com/kbajalc/parquets under MIT license
-import { TBufferedTransport, TCompactProtocol, TFramedTransport, FileMetaData, PageHeader } from "../parquet-thrift/index.js";
-class UFramedTransport extends TFramedTransport {
-    readPos = 0;
-}
+import { ColumnMetaData, FileCryptoMetaData, FileMetaData, PageHeader } from "../parquet-thrift/index.js";
+import { Uint8ArrayCompactProtocol } from "./uint8-array-compact-protocol.js";
+import { Uint8ArrayCompactProtocolWriter } from "./uint8-array-compact-protocol-writer.js";
+import { Uint8ArrayTransport } from "./uint8-array-transport.js";
 /**
  * Helper function that serializes a thrift object into a buffer
  */
 export function serializeThrift(obj) {
-    const output = [];
-    const transport = new TBufferedTransport(undefined, (buf) => {
-        output.push(buf);
-    });
-    const protocol = new TCompactProtocol(transport);
+    const protocol = new Uint8ArrayCompactProtocolWriter();
     obj.write(protocol);
-    transport.flush();
-    return Buffer.concat(output);
+    return protocol.getBytes();
 }
 export function decodeThrift(obj, buf, offset) {
     if (!offset) {
         // tslint:disable-next-line:no-parameter-reassignment
         offset = 0;
     }
-    const transport = new UFramedTransport(buf);
+    const transport = new Uint8ArrayTransport(buf);
     transport.readPos = offset;
-    const protocol = new TCompactProtocol(transport);
+    const protocol = new Uint8ArrayCompactProtocol(transport);
     obj.read(protocol);
     return transport.readPos - offset;
 }
 /**
- * FIXME not ideal that this is linear
+ * Returns the generated TypeScript enum member for a Thrift value.
+ * @param thriftEnum generated numeric enum object
+ * @param value serialized enum value
+ * @returns enum member name
  */
-export function getThriftEnum(klass, value) {
-    for (const k in klass) {
-        if (klass[k] === value) {
-            return k;
+export function getThriftEnum(thriftEnum, value) {
+    const enumValues = thriftEnum;
+    if (typeof value === 'number') {
+        const enumName = enumValues[value];
+        if (typeof enumName === 'string') {
+            return enumName;
+        }
+    }
+    for (const enumName in enumValues) {
+        if (enumValues[enumName] === value) {
+            return enumName;
         }
     }
     throw new Error('Invalid ENUM value');
@@ -47,20 +52,40 @@ export function decodeFileMetadata(buf, offset) {
         // tslint:disable-next-line:no-parameter-reassignment
         offset = 0;
     }
-    const transport = new UFramedTransport(buf);
+    const transport = new Uint8ArrayTransport(buf);
     transport.readPos = offset;
-    const protocol = new TCompactProtocol(transport);
+    const protocol = new Uint8ArrayCompactProtocol(transport);
     const metadata = FileMetaData.read(protocol);
     return { length: transport.readPos - offset, metadata };
 }
+/** Decodes the FileCryptoMetaData prefix used by encrypted-footer files. */
+export function decodeFileCryptoMetadata(buf, offset) {
+    if (!offset)
+        offset = 0;
+    const transport = new Uint8ArrayTransport(buf);
+    transport.readPos = offset;
+    const protocol = new Uint8ArrayCompactProtocol(transport);
+    const metadata = FileCryptoMetaData.read(protocol);
+    return { length: transport.readPos - offset, metadata };
+}
+/** Decodes a serialized ColumnMetaData encryption module. */
+export function decodeColumnMetadata(buf, offset) {
+    if (!offset)
+        offset = 0;
+    const transport = new Uint8ArrayTransport(buf);
+    transport.readPos = offset;
+    const protocol = new Uint8ArrayCompactProtocol(transport);
+    const metadata = ColumnMetaData.read(protocol);
+    return { length: transport.readPos - offset, metadata };
+}
 export function decodePageHeader(buf, offset) {
     if (!offset) {
         // tslint:disable-next-line:no-parameter-reassignment
         offset = 0;
     }
-    const transport = new UFramedTransport(buf);
+    const transport = new Uint8ArrayTransport(buf);
     transport.readPos = offset;
-    const protocol = new TCompactProtocol(transport);
+    const protocol = new Uint8ArrayCompactProtocol(transport);
     const pageHeader = PageHeader.read(protocol);
     return { length: transport.readPos - offset, pageHeader };
 }
@@ -74,27 +99,29 @@ export function getBitWidth(val) {
     }
     return Math.ceil(Math.log2(val + 1));
 }
-// Supports MQTT path wildcards
-// + all immediate children
-// # all descendents
+/**
+ * Finds the selected field path that contains a Parquet leaf path.
+ * A selected parent includes all descendant leaves. MQTT-style `+` and `#` path wildcards are
+ * retained for internal callers (`+` matches one segment and `#` matches all remaining segments).
+ */
 export function fieldIndexOf(arr, elem) {
-    for (let j = 0; j < arr.length; j++) {
-        if (arr[j].length > elem.length) {
-            continue; // eslint-disable-line no-continue
-        }
-        let m = true;
-        for (let i = 0; i < elem.length; i++) {
-            if (arr[j][i] === elem[i] || arr[j][i] === '+' || arr[j][i] === '#') {
-                continue; // eslint-disable-line no-continue
+    for (let fieldIndex = 0; fieldIndex < arr.length; fieldIndex++) {
+        const selectedPath = arr[fieldIndex];
+        let matches = true;
+        for (let pathIndex = 0; pathIndex < selectedPath.length; pathIndex++) {
+            const selectedSegment = selectedPath[pathIndex];
+            if (selectedSegment === '#') {
+                return fieldIndex;
             }
-            if (i >= arr[j].length && arr[j][arr[j].length - 1] === '#') {
-                continue; // eslint-disable-line no-continue
+            if (pathIndex >= elem.length ||
+                (selectedSegment !== '+' && selectedSegment !== elem[pathIndex])) {
+                matches = false;
+                break;
             }
-            m = false;
-            break;
         }
-        if (m)
-            return j;
+        if (matches) {
+            return fieldIndex;
+        }
     }
     return -1;
 }

package/dist/parquetjs/utils/read-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-utils.js","sourceRoot":"","sources":["../../../src/parquetjs/utils/read-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"read-utils.js","sourceRoot":"","sources":["../../../src/parquetjs/utils/read-utils.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AACpC,qCAAqC;AACrC,oEAAoE;AAEpE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACX,mCAAgC;AACjC,OAAO,EAAC,yBAAyB,EAAC,0CAAuC;AACzE,OAAO,EAAC,+BAA+B,EAAC,iDAA8C;AACtF,OAAO,EAAC,mBAAmB,EAAC,mCAAgC;AAE5D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAQ;IACtC,MAAM,QAAQ,GAAG,IAAI,+BAA+B,EAAE,CAAC;IACvD,GAAG,CAAC,KAAK,CAAC,QAAe,CAAC,CAAC;IAC3B,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAQ,EAAE,GAAe,EAAE,MAAe;IACrE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,qDAAqD;QACrD,MAAM,GAAG,CAAC,CAAC;IACb,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/C,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC1D,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnB,OAAO,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,KAAsB;IACtE,MAAM,UAAU,GAAG,UAAsD,CAAC;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YACnC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAe,EAAE,MAAe;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,qDAAqD;QACrD,MAAM,GAAG,CAAC,CAAC;IACb,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/C,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,QAAe,CAAC,CAAC;IACpD,OAAO,EAAC,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAC,CAAC;AACxD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,wBAAwB,CAAC,GAAe,EAAE,MAAe;IACvE,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,CAAC,CAAC;IACxB,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/C,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAe,CAAC,CAAC;IAC1D,OAAO,EAAC,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAC,CAAC;AACxD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,oBAAoB,CAAC,GAAe,EAAE,MAAe;IACnE,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,CAAC,CAAC;IACxB,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/C,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,QAAe,CAAC,CAAC;IACtD,OAAO,EAAC,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,MAAe;IAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,qDAAqD;QACrD,MAAM,GAAG,CAAC,CAAC;IACb,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/C,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,QAAe,CAAC,CAAC;IACpD,OAAO,EAAC,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,MAAM,EAAE,UAAU,EAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QACd,OAAO,CAAC,CAAC;QACT,gDAAgD;IAClD,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAe,EAAE,IAAc;IAC1D,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;QAC/D,MAAM,YAAY,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;YACrE,MAAM,eAAe,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;YAChD,IAAI,eAAe,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,IACE,SAAS,IAAI,IAAI,CAAC,MAAM;gBACxB,CAAC,eAAe,KAAK,GAAG,IAAI,eAAe,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,EAChE,CAAC;gBACD,OAAO,GAAG,KAAK,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/parquetjs/utils/thrift-runtime.d.ts

@@ -0,0 +1,106 @@
+/** Minimal Thrift runtime types needed by the generated Parquet metadata classes. */
+export declare namespace Thrift {
+    /** Thrift wire types used by the Parquet compact protocol. */
+    enum Type {
+        STOP = 0,
+        VOID = 1,
+        BOOL = 2,
+        BYTE = 3,
+        DOUBLE = 4,
+        I16 = 6,
+        I32 = 8,
+        I64 = 10,
+        STRING = 11,
+        STRUCT = 12,
+        MAP = 13,
+        SET = 14,
+        LIST = 15,
+        UTF8 = 16,
+        UTF16 = 17
+    }
+    /** Protocol failure categories retained for generated-code compatibility. */
+    enum TProtocolExceptionType {
+        UNKNOWN = 0,
+        INVALID_DATA = 1,
+        NEGATIVE_SIZE = 2,
+        SIZE_LIMIT = 3,
+        BAD_VERSION = 4,
+        NOT_IMPLEMENTED = 5,
+        DEPTH_LIMIT = 6
+    }
+    /** Error raised when generated metadata cannot be encoded or decoded. */
+    class TProtocolException extends Error {
+        /** Thrift protocol error category. */
+        readonly type: TProtocolExceptionType;
+        /** Creates a protocol exception without importing the Node-oriented thrift package. */
+        constructor(type: TProtocolExceptionType, message?: string);
+    }
+}
+/** Thrift struct descriptor returned by compact-protocol readers. */
+export type TStruct = {
+    fname: string;
+};
+/** Thrift field descriptor returned by compact-protocol readers. */
+export type TField = {
+    fname: string;
+    ftype: Thrift.Type;
+    fid: number;
+};
+/** Thrift map descriptor returned by compact-protocol readers. */
+export type TMap = {
+    ktype: Thrift.Type;
+    vtype: Thrift.Type;
+    size: number;
+};
+/** Thrift list descriptor returned by compact-protocol readers. */
+export type TList = {
+    etype: Thrift.Type;
+    size: number;
+};
+/** Thrift set descriptor returned by compact-protocol readers. */
+export type TSet = TList;
+/**
+ * Compact-protocol surface consumed by the generated Parquet metadata classes.
+ * Binary values use typed-array views and remain browser-native.
+ */
+export interface TProtocol {
+    writeStructBegin(name: string): void;
+    writeStructEnd(): void;
+    writeFieldBegin(name: string, fieldType: Thrift.Type, fieldId: number): void;
+    writeFieldEnd(): void;
+    writeFieldStop(): void;
+    writeMapBegin(keyType: Thrift.Type, valueType: Thrift.Type, size: number): void;
+    writeMapEnd(): void;
+    writeListBegin(elementType: Thrift.Type, size: number): void;
+    writeListEnd(): void;
+    writeSetBegin(elementType: Thrift.Type, size: number): void;
+    writeSetEnd(): void;
+    writeBool(value: boolean): void;
+    writeByte(value: number): void;
+    writeI16(value: number): void;
+    writeI32(value: number): void;
+    writeI64(value: unknown): void;
+    writeDouble(value: number): void;
+    writeString(value: string): void;
+    writeBinary(value: ArrayBuffer | ArrayBufferView): void;
+    readStructBegin(): TStruct;
+    readStructEnd(): void;
+    readFieldBegin(): TField;
+    readFieldEnd(): void;
+    readMapBegin(): TMap;
+    readMapEnd(): void;
+    readListBegin(): TList;
+    readListEnd(): void;
+    readSetBegin(): TSet;
+    readSetEnd(): void;
+    readBool(): boolean;
+    readByte(): number;
+    readI16(): number;
+    readI32(): number;
+    readI64(): any;
+    readDouble(): number;
+    readString(): string;
+    readBinary(): Uint8Array;
+    skip(type: Thrift.Type): void;
+}
+//# sourceMappingURL=thrift-runtime.d.ts.map

package/dist/parquetjs/utils/thrift-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thrift-runtime.d.ts","sourceRoot":"","sources":["../../../src/parquetjs/utils/thrift-runtime.ts"],"names":[],"mappings":"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"}

package/dist/parquetjs/utils/thrift-runtime.js

@@ -0,0 +1,50 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Minimal Thrift runtime types needed by the generated Parquet metadata classes. */
+export var Thrift;
+(function (Thrift) {
+    /** Thrift wire types used by the Parquet compact protocol. */
+    let Type;
+    (function (Type) {
+        Type[Type["STOP"] = 0] = "STOP";
+        Type[Type["VOID"] = 1] = "VOID";
+        Type[Type["BOOL"] = 2] = "BOOL";
+        Type[Type["BYTE"] = 3] = "BYTE";
+        Type[Type["DOUBLE"] = 4] = "DOUBLE";
+        Type[Type["I16"] = 6] = "I16";
+        Type[Type["I32"] = 8] = "I32";
+        Type[Type["I64"] = 10] = "I64";
+        Type[Type["STRING"] = 11] = "STRING";
+        Type[Type["STRUCT"] = 12] = "STRUCT";
+        Type[Type["MAP"] = 13] = "MAP";
+        Type[Type["SET"] = 14] = "SET";
+        Type[Type["LIST"] = 15] = "LIST";
+        Type[Type["UTF8"] = 16] = "UTF8";
+        Type[Type["UTF16"] = 17] = "UTF16";
+    })(Type = Thrift.Type || (Thrift.Type = {}));
+    /** Protocol failure categories retained for generated-code compatibility. */
+    let TProtocolExceptionType;
+    (function (TProtocolExceptionType) {
+        TProtocolExceptionType[TProtocolExceptionType["UNKNOWN"] = 0] = "UNKNOWN";
+        TProtocolExceptionType[TProtocolExceptionType["INVALID_DATA"] = 1] = "INVALID_DATA";
+        TProtocolExceptionType[TProtocolExceptionType["NEGATIVE_SIZE"] = 2] = "NEGATIVE_SIZE";
+        TProtocolExceptionType[TProtocolExceptionType["SIZE_LIMIT"] = 3] = "SIZE_LIMIT";
+        TProtocolExceptionType[TProtocolExceptionType["BAD_VERSION"] = 4] = "BAD_VERSION";
+        TProtocolExceptionType[TProtocolExceptionType["NOT_IMPLEMENTED"] = 5] = "NOT_IMPLEMENTED";
+        TProtocolExceptionType[TProtocolExceptionType["DEPTH_LIMIT"] = 6] = "DEPTH_LIMIT";
+    })(TProtocolExceptionType = Thrift.TProtocolExceptionType || (Thrift.TProtocolExceptionType = {}));
+    /** Error raised when generated metadata cannot be encoded or decoded. */
+    class TProtocolException extends Error {
+        /** Thrift protocol error category. */
+        type;
+        /** Creates a protocol exception without importing the Node-oriented thrift package. */
+        constructor(type, message = 'Thrift protocol error') {
+            super(message);
+            this.name = 'TProtocolException';
+            this.type = type;
+        }
+    }
+    Thrift.TProtocolException = TProtocolException;
+})(Thrift || (Thrift = {}));
+//# sourceMappingURL=thrift-runtime.js.map

package/dist/parquetjs/utils/thrift-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thrift-runtime.js","sourceRoot":"","sources":["../../../src/parquetjs/utils/thrift-runtime.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,qFAAqF;AACrF,MAAM,KAAW,MAAM,CA2CtB;AA3CD,WAAiB,MAAM;IACrB,8DAA8D;IAC9D,IAAY,IAgBX;IAhBD,WAAY,IAAI;QACd,+BAAQ,CAAA;QACR,+BAAQ,CAAA;QACR,+BAAQ,CAAA;QACR,+BAAQ,CAAA;QACR,mCAAU,CAAA;QACV,6BAAO,CAAA;QACP,6BAAO,CAAA;QACP,8BAAQ,CAAA;QACR,oCAAW,CAAA;QACX,oCAAW,CAAA;QACX,8BAAQ,CAAA;QACR,8BAAQ,CAAA;QACR,gCAAS,CAAA;QACT,gCAAS,CAAA;QACT,kCAAU,CAAA;IACZ,CAAC,EAhBW,IAAI,GAAJ,WAAI,KAAJ,WAAI,QAgBf;IAED,6EAA6E;IAC7E,IAAY,sBAQX;IARD,WAAY,sBAAsB;QAChC,yEAAW,CAAA;QACX,mFAAgB,CAAA;QAChB,qFAAiB,CAAA;QACjB,+EAAc,CAAA;QACd,iFAAe,CAAA;QACf,yFAAmB,CAAA;QACnB,iFAAe,CAAA;IACjB,CAAC,EARW,sBAAsB,GAAtB,6BAAsB,KAAtB,6BAAsB,QAQjC;IAED,yEAAyE;IACzE,MAAa,kBAAmB,SAAQ,KAAK;QAC3C,sCAAsC;QAC7B,IAAI,CAAyB;QAEtC,uFAAuF;QACvF,YAAY,IAA4B,EAAE,OAAO,GAAG,uBAAuB;YACzE,KAAK,CAAC,OAAO,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;YACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;KACF;IAVY,yBAAkB,qBAU9B,CAAA;AACH,CAAC,EA3CgB,MAAM,KAAN,MAAM,QA2CtB"}

package/dist/parquetjs/utils/uint8-array-compact-protocol-writer.d.ts

@@ -0,0 +1,78 @@
+import * as thrift from "./thrift-runtime.js";
+type Int64Like = number | bigint | {
+    toString(radix?: number): string;
+    valueOf?: () => number;
+};
+/** Write-only Thrift compact protocol that assembles exact Uint8Array output. */
+export declare class Uint8ArrayCompactProtocolWriter {
+    /** Serialized byte chunks accumulated by thrift write calls. */
+    private readonly chunks;
+    /** Field id at the current nesting depth, used to emit compact field-id deltas. */
+    private lastFieldId;
+    /** Parent struct field ids restored when nested structs end. */
+    private readonly lastFieldIds;
+    /** Boolean field header waiting for the following boolean payload. */
+    private pendingBooleanField;
+    /** Enter a struct and reset the delta-encoded field id state. */
+    writeStructBegin(_name: string): void;
+    /** Exit a struct and restore the parent field id state. */
+    writeStructEnd(): void;
+    /** Write a field header, deferring boolean fields until their value is known. */
+    writeFieldBegin(_name: string, fieldType: thrift.Thrift.Type, fid: number): void;
+    /** Complete the current field; compact protocol has no field-end bytes. */
+    writeFieldEnd(): void;
+    /** Write the stop marker that terminates a thrift struct. */
+    writeFieldStop(): void;
+    /** Write a map header with compact key/value element types. */
+    writeMapBegin(keyType: thrift.Thrift.Type, valueType: thrift.Thrift.Type, size: number): void;
+    /** Complete the current map; compact protocol has no map-end bytes. */
+    writeMapEnd(): void;
+    /** Write a list header with compact element type and element count. */
+    writeListBegin(elementType: thrift.Thrift.Type, size: number): void;
+    /** Complete the current list; compact protocol has no list-end bytes. */
+    writeListEnd(): void;
+    /** Write a set header with compact element type and element count. */
+    writeSetBegin(elementType: thrift.Thrift.Type, size: number): void;
+    /** Complete the current set; compact protocol has no set-end bytes. */
+    writeSetEnd(): void;
+    /** Write a boolean, either inline in its field header or as a value byte. */
+    writeBool(value: boolean): void;
+    /** Write a signed byte. */
+    writeByte(value: number): void;
+    /** Write a signed 16-bit integer as zig-zag varint. */
+    writeI16(value: number): void;
+    /** Write a signed 32-bit integer as zig-zag varint. */
+    writeI32(value: number): void;
+    /** Write a signed 64-bit-like value as zig-zag varint. */
+    writeI64(value: Int64Like): void;
+    /** Write a little-endian 64-bit float. */
+    writeDouble(value: number): void;
+    /** Write a length-prefixed UTF-8 string. */
+    writeString(value: string): void;
+    /** Write a length-prefixed binary payload from any typed-array view. */
+    writeBinary(value: ArrayBuffer | ArrayBufferView): void;
+    /** Return all serialized chunks as one contiguous byte array. */
+    getBytes(): Uint8Array;
+    /** Write a compact collection header for list or set values. */
+    private writeCollectionBegin;
+    /** Write a compact field header using a field-id delta when possible. */
+    private writeFieldHeader;
+    /** Append an already serialized byte range without copying. */
+    private writeBytes;
+    /** Append one byte to the serialized output. */
+    private writeByteDirect;
+    /** Write an unsigned 32-bit value as a compact varint. */
+    private writeVarint32;
+    /** Write an unsigned 64-bit value as a compact varint. */
+    private writeVarint64;
+    /** Encode a signed 32-bit integer as an unsigned zig-zag value. */
+    private encodeZigZag32;
+    /** Encode a signed 64-bit integer as an unsigned zig-zag value. */
+    private encodeZigZag64;
+    /** Normalize thrift int64-like values to bigint before zig-zag encoding. */
+    private toBigInt;
+    /** Convert a generated-thrift type to a compact protocol wire type. */
+    private getCompactType;
+}
+export {};
+//# sourceMappingURL=uint8-array-compact-protocol-writer.d.ts.map

package/dist/parquetjs/utils/uint8-array-compact-protocol-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint8-array-compact-protocol-writer.d.ts","sourceRoot":"","sources":["../../../src/parquetjs/utils/uint8-array-compact-protocol-writer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,4BAAyB;AAiB3C,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,MAAM,CAAA;CAAC,CAAC;AAE9F,iFAAiF;AACjF,qBAAa,+BAA+B;IAC1C,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,mFAAmF;IACnF,OAAO,CAAC,WAAW,CAAK;IAExB,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAE7C,sEAAsE;IACtE,OAAO,CAAC,mBAAmB,CAA8B;IAEzD,iEAAiE;IACjE,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC,2DAA2D;IAC3D,cAAc,IAAI,IAAI;IAItB,iFAAiF;IACjF,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAShF,2EAA2E;IAC3E,aAAa,IAAI,IAAI;IAErB,6DAA6D;IAC7D,cAAc,IAAI,IAAI;IAItB,+DAA+D;IAC/D,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAU7F,uEAAuE;IACvE,WAAW,IAAI,IAAI;IAEnB,uEAAuE;IACvE,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAInE,yEAAyE;IACzE,YAAY,IAAI,IAAI;IAEpB,sEAAsE;IACtE,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlE,uEAAuE;IACvE,WAAW,IAAI,IAAI;IAEnB,6EAA6E;IAC7E,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAW/B,2BAA2B;IAC3B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIhC,0CAA0C;IAC1C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,4CAA4C;IAC5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,wEAAwE;IACxE,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI;IAMvD,iEAAiE;IACjE,QAAQ,IAAI,UAAU;IAItB,gEAAgE;IAChE,OAAO,CAAC,oBAAoB;IAW5B,yEAAyE;IACzE,OAAO,CAAC,gBAAgB;IAWxB,+DAA+D;IAC/D,OAAO,CAAC,UAAU;IAIlB,gDAAgD;IAChD,OAAO,CAAC,eAAe;IAIvB,0DAA0D;IAC1D,OAAO,CAAC,aAAa;IAIrB,0DAA0D;IAC1D,OAAO,CAAC,aAAa;IAarB,mEAAmE;IACnE,OAAO,CAAC,cAAc;IAItB,mEAAmE;IACnE,OAAO,CAAC,cAAc;IAItB,4EAA4E;IAC5E,OAAO,CAAC,QAAQ;IAMhB,uEAAuE;IACvE,OAAO,CAAC,cAAc;CA8BvB"}

package/dist/parquetjs/utils/uint8-array-compact-protocol-writer.js

@@ -0,0 +1,213 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import * as thrift from "./thrift-runtime.js";
+import { concatUint8Arrays, encodeUtf8, toUint8Array, writeDoubleLE } from "./binary-utils.js";
+const COMPACT_TYPE_STOP = 0x00;
+const COMPACT_TYPE_BOOLEAN_TRUE = 0x01;
+const COMPACT_TYPE_BOOLEAN_FALSE = 0x02;
+const COMPACT_TYPE_BYTE = 0x03;
+const COMPACT_TYPE_I16 = 0x04;
+const COMPACT_TYPE_I32 = 0x05;
+const COMPACT_TYPE_I64 = 0x06;
+const COMPACT_TYPE_DOUBLE = 0x07;
+const COMPACT_TYPE_BINARY = 0x08;
+const COMPACT_TYPE_LIST = 0x09;
+const COMPACT_TYPE_SET = 0x0a;
+const COMPACT_TYPE_MAP = 0x0b;
+const COMPACT_TYPE_STRUCT = 0x0c;
+/** Write-only Thrift compact protocol that assembles exact Uint8Array output. */
+export class Uint8ArrayCompactProtocolWriter {
+    /** Serialized byte chunks accumulated by thrift write calls. */
+    chunks = [];
+    /** Field id at the current nesting depth, used to emit compact field-id deltas. */
+    lastFieldId = 0;
+    /** Parent struct field ids restored when nested structs end. */
+    lastFieldIds = [];
+    /** Boolean field header waiting for the following boolean payload. */
+    pendingBooleanField = null;
+    /** Enter a struct and reset the delta-encoded field id state. */
+    writeStructBegin(_name) {
+        this.lastFieldIds.push(this.lastFieldId);
+        this.lastFieldId = 0;
+    }
+    /** Exit a struct and restore the parent field id state. */
+    writeStructEnd() {
+        this.lastFieldId = this.lastFieldIds.pop() || 0;
+    }
+    /** Write a field header, deferring boolean fields until their value is known. */
+    writeFieldBegin(_name, fieldType, fid) {
+        if (fieldType === thrift.Thrift.Type.BOOL) {
+            this.pendingBooleanField = { fid };
+            return;
+        }
+        this.writeFieldHeader(this.getCompactType(fieldType), fid);
+    }
+    /** Complete the current field; compact protocol has no field-end bytes. */
+    writeFieldEnd() { }
+    /** Write the stop marker that terminates a thrift struct. */
+    writeFieldStop() {
+        this.writeByteDirect(COMPACT_TYPE_STOP);
+    }
+    /** Write a map header with compact key/value element types. */
+    writeMapBegin(keyType, valueType, size) {
+        if (size === 0) {
+            this.writeByteDirect(0);
+            return;
+        }
+        this.writeVarint32(size);
+        this.writeByteDirect((this.getCompactType(keyType) << 4) | this.getCompactType(valueType));
+    }
+    /** Complete the current map; compact protocol has no map-end bytes. */
+    writeMapEnd() { }
+    /** Write a list header with compact element type and element count. */
+    writeListBegin(elementType, size) {
+        this.writeCollectionBegin(elementType, size);
+    }
+    /** Complete the current list; compact protocol has no list-end bytes. */
+    writeListEnd() { }
+    /** Write a set header with compact element type and element count. */
+    writeSetBegin(elementType, size) {
+        this.writeCollectionBegin(elementType, size);
+    }
+    /** Complete the current set; compact protocol has no set-end bytes. */
+    writeSetEnd() { }
+    /** Write a boolean, either inline in its field header or as a value byte. */
+    writeBool(value) {
+        const compactType = value ? COMPACT_TYPE_BOOLEAN_TRUE : COMPACT_TYPE_BOOLEAN_FALSE;
+        if (this.pendingBooleanField) {
+            this.writeFieldHeader(compactType, this.pendingBooleanField.fid);
+            this.pendingBooleanField = null;
+            return;
+        }
+        this.writeByteDirect(compactType);
+    }
+    /** Write a signed byte. */
+    writeByte(value) {
+        this.writeByteDirect(value);
+    }
+    /** Write a signed 16-bit integer as zig-zag varint. */
+    writeI16(value) {
+        this.writeI32(value);
+    }
+    /** Write a signed 32-bit integer as zig-zag varint. */
+    writeI32(value) {
+        this.writeVarint32(this.encodeZigZag32(value));
+    }
+    /** Write a signed 64-bit-like value as zig-zag varint. */
+    writeI64(value) {
+        this.writeVarint64(this.encodeZigZag64(this.toBigInt(value)));
+    }
+    /** Write a little-endian 64-bit float. */
+    writeDouble(value) {
+        const bytes = new Uint8Array(8);
+        writeDoubleLE(bytes, value, 0);
+        this.writeBytes(bytes);
+    }
+    /** Write a length-prefixed UTF-8 string. */
+    writeString(value) {
+        this.writeBinary(encodeUtf8(value));
+    }
+    /** Write a length-prefixed binary payload from any typed-array view. */
+    writeBinary(value) {
+        const bytes = toUint8Array(value);
+        this.writeVarint32(bytes.length);
+        this.writeBytes(bytes);
+    }
+    /** Return all serialized chunks as one contiguous byte array. */
+    getBytes() {
+        return concatUint8Arrays(this.chunks);
+    }
+    /** Write a compact collection header for list or set values. */
+    writeCollectionBegin(elementType, size) {
+        const compactType = this.getCompactType(elementType);
+        if (size <= 14) {
+            this.writeByteDirect((size << 4) | compactType);
+            return;
+        }
+        this.writeByteDirect(0xf0 | compactType);
+        this.writeVarint32(size);
+    }
+    /** Write a compact field header using a field-id delta when possible. */
+    writeFieldHeader(compactType, fid) {
+        const fieldIdDelta = fid - this.lastFieldId;
+        if (fieldIdDelta > 0 && fieldIdDelta <= 15) {
+            this.writeByteDirect((fieldIdDelta << 4) | compactType);
+        }
+        else {
+            this.writeByteDirect(compactType);
+            this.writeI16(fid);
+        }
+        this.lastFieldId = fid;
+    }
+    /** Append an already serialized byte range without copying. */
+    writeBytes(bytes) {
+        this.chunks.push(bytes);
+    }
+    /** Append one byte to the serialized output. */
+    writeByteDirect(value) {
+        this.chunks.push(new Uint8Array([value & 0xff]));
+    }
+    /** Write an unsigned 32-bit value as a compact varint. */
+    writeVarint32(value) {
+        this.writeVarint64(BigInt(value >>> 0));
+    }
+    /** Write an unsigned 64-bit value as a compact varint. */
+    writeVarint64(value) {
+        let nextValue = value;
+        while (true) {
+            if ((nextValue & ~0x7fn) === 0n) {
+                this.writeByteDirect(Number(nextValue));
+                return;
+            }
+            this.writeByteDirect(Number((nextValue & 0x7fn) | 0x80n));
+            nextValue >>= 7n;
+        }
+    }
+    /** Encode a signed 32-bit integer as an unsigned zig-zag value. */
+    encodeZigZag32(value) {
+        return ((value << 1) ^ (value >> 31)) >>> 0;
+    }
+    /** Encode a signed 64-bit integer as an unsigned zig-zag value. */
+    encodeZigZag64(value) {
+        return (value << 1n) ^ (value >> 63n);
+    }
+    /** Normalize thrift int64-like values to bigint before zig-zag encoding. */
+    toBigInt(value) {
+        return typeof value === 'bigint' || typeof value === 'number'
+            ? BigInt(value)
+            : BigInt(value.toString());
+    }
+    /** Convert a generated-thrift type to a compact protocol wire type. */
+    getCompactType(thriftType) {
+        switch (thriftType) {
+            case thrift.Thrift.Type.STOP:
+                return COMPACT_TYPE_STOP;
+            case thrift.Thrift.Type.BOOL:
+                return COMPACT_TYPE_BOOLEAN_TRUE;
+            case thrift.Thrift.Type.BYTE:
+                return COMPACT_TYPE_BYTE;
+            case thrift.Thrift.Type.I16:
+                return COMPACT_TYPE_I16;
+            case thrift.Thrift.Type.I32:
+                return COMPACT_TYPE_I32;
+            case thrift.Thrift.Type.I64:
+                return COMPACT_TYPE_I64;
+            case thrift.Thrift.Type.DOUBLE:
+                return COMPACT_TYPE_DOUBLE;
+            case thrift.Thrift.Type.STRING:
+                return COMPACT_TYPE_BINARY;
+            case thrift.Thrift.Type.LIST:
+                return COMPACT_TYPE_LIST;
+            case thrift.Thrift.Type.SET:
+                return COMPACT_TYPE_SET;
+            case thrift.Thrift.Type.MAP:
+                return COMPACT_TYPE_MAP;
+            case thrift.Thrift.Type.STRUCT:
+                return COMPACT_TYPE_STRUCT;
+            default:
+                throw new Error(`Unsupported thrift type: ${thriftType}`);
+        }
+    }
+}
+//# sourceMappingURL=uint8-array-compact-protocol-writer.js.map