@flighthq/buffer 0.0.0-stage → 0.5.1-edge.4334.2a5a54c

package/LICENSE.md

@@ -0,0 +1,9 @@
+# MIT License
+
+Copyright (c) 2013-2026 Joshua Granick and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+# @flighthq/buffer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Byte-level buffer reading utilities
+
+## Install
+
+```sh
+npm install @flighthq/buffer
+```
+
+Import the supported application-facing API from `@flighthq/buffer`. The `@flighthq/buffer/contract` export is the wider package-to-package contract used to compose Flight itself.
+
+This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
+
+- [Flight project](https://github.com/flighthq/flight)
+- [Source for @flighthq/buffer@0.5.1-edge.4334.2a5a54c](https://github.com/flighthq/flight/tree/2a5a54c3b182bc9c1ac247df07e9c0fcf44e668b/packages/buffer)
+- [License](https://github.com/flighthq/flight/blob/2a5a54c3b182bc9c1ac247df07e9c0fcf44e668b/LICENSE.md)

package/dist/byteReader.d.ts

@@ -0,0 +1,20 @@
+import type { NonEntityCreateResult } from '@flighthq/entity/contract';
+/**
+ * A forward-only little/big-endian cursor over a byte view (TS `ByteReader`), shared by the
+ * binary format parsers.
+ */
+export interface ByteReader {
+    view: Readonly<Uint8Array>;
+    offset: number;
+}
+export declare function createByteReader(bytes: Readonly<Uint8Array>, offset?: number): NonEntityCreateResult<ByteReader, 'descriptor'>;
+export declare function hasByteReaderBytes(reader: Readonly<ByteReader>, count: number): boolean;
+export declare function readByteReaderU16(reader: ByteReader): number;
+export declare function readByteReaderU24(reader: ByteReader): number;
+export declare function readByteReaderU24BigEndian(reader: ByteReader): number;
+export declare function readByteReaderU32(reader: ByteReader): number;
+export declare function readByteReaderU32BigEndian(reader: ByteReader): number;
+export declare function readByteReaderU64(reader: ByteReader): number;
+export declare function readByteReaderU8(reader: ByteReader): number;
+export declare function skipByteReader(reader: ByteReader, count: number): void;
+//# sourceMappingURL=byteReader.d.ts.map

package/dist/byteReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byteReader.d.ts","sourceRoot":"","sources":["../src/byteReader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,MAAM,CAAC,EAAE,MAAM,GACd,qBAAqB,CAAC,UAAU,EAAE,YAAY,CAAC,CAEjD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK5D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAM5D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAMrE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK5D;AAYD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CASrE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAO5D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI3D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEtE"}

package/dist/byteReader.js

@@ -0,0 +1,65 @@
+// Generated from crates/flight-buffer/src/byte_reader.rs by flight-compiler.
+// Rust is authoritative; run `npm run generate` after changing it.
+export function createByteReader(bytes, offset) {
+    return { view: bytes, offset: offset ?? 0 };
+}
+export function hasByteReaderBytes(reader, count) {
+    return reader.offset <= reader.view.length && count <= reader.view.length - reader.offset;
+}
+export function readByteReaderU16(reader) {
+    const offset = reader.offset;
+    const value = (reader.view[offset] & 0xffff) | ((reader.view[offset + 1] & 0xffff) << 8);
+    reader.offset += 2;
+    return value;
+}
+export function readByteReaderU24(reader) {
+    const offset = reader.offset;
+    const value = (reader.view[offset] >>> 0) | ((reader.view[offset + 1] >>> 0) << 8) | ((reader.view[offset + 2] >>> 0) << 16);
+    reader.offset += 3;
+    return value >>> 0;
+}
+export function readByteReaderU24BigEndian(reader) {
+    const offset = reader.offset;
+    const value = ((reader.view[offset] >>> 0) << 16) | ((reader.view[offset + 1] >>> 0) << 8) | (reader.view[offset + 2] >>> 0);
+    reader.offset += 3;
+    return value >>> 0;
+}
+export function readByteReaderU32(reader) {
+    const offset = reader.offset;
+    const value = readByteReaderU32At(reader.view, offset);
+    reader.offset += 4;
+    return value >>> 0;
+}
+function readByteReaderU32At(view, offset) {
+    return (((view[offset] >>> 0) |
+        ((view[offset + 1] >>> 0) << 8) |
+        ((view[offset + 2] >>> 0) << 16) |
+        ((view[offset + 3] >>> 0) << 24)) >>>
+        0);
+}
+export function readByteReaderU32BigEndian(reader) {
+    const offset = reader.offset;
+    const value = ((reader.view[offset] >>> 0) << 24) |
+        ((reader.view[offset + 1] >>> 0) << 16) |
+        ((reader.view[offset + 2] >>> 0) << 8) |
+        (reader.view[offset + 3] >>> 0);
+    reader.offset += 4;
+    return value >>> 0;
+}
+export function readByteReaderU64(reader) {
+    const offset = reader.offset;
+    const low = readByteReaderU32At(reader.view, offset);
+    const high = readByteReaderU32At(reader.view, offset + 4);
+    const value = high * 0x1_0000_0000 + low;
+    reader.offset += 8;
+    return value;
+}
+export function readByteReaderU8(reader) {
+    const value = reader.view[reader.offset];
+    reader.offset += 1;
+    return value;
+}
+export function skipByteReader(reader, count) {
+    reader.offset += count;
+}
+//# sourceMappingURL=byteReader.js.map

package/dist/byteReader.js.map

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

package/dist/contract.d.ts

@@ -0,0 +1,3 @@
+export { createByteReader, hasByteReaderBytes, readByteReaderU16, readByteReaderU24, readByteReaderU24BigEndian, readByteReaderU32, readByteReaderU32BigEndian, readByteReaderU64, readByteReaderU8, skipByteReader, } from './byteReader.ts';
+export type { ByteReader } from './byteReader.ts';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/contract.js

@@ -0,0 +1,4 @@
+// Generated from crates/flight-buffer/src/lib.rs by flight-compiler.
+// Rust is authoritative; run `npm run generate` after changing it.
+export { createByteReader, hasByteReaderBytes, readByteReaderU16, readByteReaderU24, readByteReaderU24BigEndian, readByteReaderU32, readByteReaderU32BigEndian, readByteReaderU64, readByteReaderU8, skipByteReader, } from './byteReader.js';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,mEAAmE;AAEnE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createByteReader, hasByteReaderBytes, readByteReaderU16, readByteReaderU24, readByteReaderU24BigEndian, readByteReaderU32, readByteReaderU32BigEndian, readByteReaderU64, readByteReaderU8, skipByteReader, } from './contract.ts';
+export type { ByteReader } from './contract.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// Generated from crates/flight-buffer/src/lib.rs by flight-compiler.
+// Rust is authoritative; run `npm run generate` after changing it.
+export { createByteReader, hasByteReaderBytes, readByteReaderU16, readByteReaderU24, readByteReaderU24BigEndian, readByteReaderU32, readByteReaderU32BigEndian, readByteReaderU64, readByteReaderU8, skipByteReader, } from './contract.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,mEAAmE;AAEnE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@flighthq/buffer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.1-edge.4334.2a5a54c",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/buffer"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "generate": "tsx ../../scripts/generate-rust-package.ts --crate flight-buffer --package buffer",
+    "generate:check": "tsx ../../scripts/generate-rust-package.ts --crate flight-buffer --package buffer --check",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/entity": "0.5.1-edge.4334.2a5a54c"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  },
+  "description": "Byte-level buffer reading utilities",
+  "sideEffects": false
+}

package/src/byteReader.test.ts

@@ -0,0 +1,134 @@
+// Generated from crates/flight-buffer/tests/byte_reader_test.rs by flight-compiler.
+// Rust is authoritative; run `npm run generate` after changing it.
+
+import { describe, expect, it } from 'vitest';
+
+import {
+  createByteReader,
+  hasByteReaderBytes,
+  readByteReaderU16,
+  readByteReaderU24,
+  readByteReaderU24BigEndian,
+  readByteReaderU32,
+  readByteReaderU32BigEndian,
+  readByteReaderU64,
+  readByteReaderU8,
+  skipByteReader,
+} from './contract.ts';
+
+describe('createByteReader', () => {
+  it('starts at the given offset', () => {
+    const bytes: Uint8Array = new Uint8Array([1, 2, 3, 4]);
+    let reader = createByteReader(bytes, 2);
+    expect(reader.offset).toEqual(2);
+    expect(readByteReaderU8(reader)).toEqual(3);
+  });
+  it('views a subslice at its own start', () => {
+    const backing: Uint8Array = new Uint8Array([9, 9, 0x01, 0x00]);
+    let reader = createByteReader(backing.slice(2), undefined);
+    expect(readByteReaderU16(reader)).toEqual(1);
+  });
+});
+
+describe('hasByteReaderBytes', () => {
+  // Rust-only: rejects a count that would overflow native pointer arithmetic
+  it('reports whether count bytes remain from the current offset', () => {
+    const bytes = new Uint8Array(8).fill(0);
+    const reader = createByteReader(bytes, 4);
+    expect(hasByteReaderBytes(reader, 4)).toBe(true);
+    expect(!hasByteReaderBytes(reader, 5)).toBe(true);
+    expect(hasByteReaderBytes(reader, 0)).toBe(true);
+  });
+});
+
+describe('readByteReaderU16', () => {
+  it('reads little endian and advances two', () => {
+    const bytes: Uint8Array = new Uint8Array([0x34, 0x12]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU16(reader)).toEqual(0x1234);
+    expect(reader.offset).toEqual(2);
+  });
+});
+
+describe('readByteReaderU24', () => {
+  it('reads a three byte little endian value and advances three', () => {
+    const bytes: Uint8Array = new Uint8Array([0x56, 0x34, 0x12]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU24(reader)).toEqual(0x123456);
+    expect(reader.offset).toEqual(3);
+  });
+  it('reads the full unsigned range', () => {
+    const bytes: Uint8Array = new Uint8Array([0xff, 0xff, 0xff]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU24(reader)).toEqual(0xff_ffff);
+  });
+});
+
+describe('readByteReaderU24BigEndian', () => {
+  it('reads a three byte big endian value and advances three', () => {
+    const bytes: Uint8Array = new Uint8Array([0x12, 0x34, 0x56]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU24BigEndian(reader)).toEqual(0x123456);
+    expect(reader.offset).toEqual(3);
+  });
+  it('reads the full unsigned range', () => {
+    const bytes: Uint8Array = new Uint8Array([0xff, 0xff, 0xff]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU24BigEndian(reader)).toEqual(0xff_ffff);
+  });
+});
+
+describe('readByteReaderU32', () => {
+  it('reads little endian and advances four', () => {
+    const bytes: Uint8Array = new Uint8Array([0x78, 0x56, 0x34, 0x12]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU32(reader)).toEqual(0x1234_5678);
+    expect(reader.offset).toEqual(4);
+  });
+});
+
+describe('readByteReaderU32BigEndian', () => {
+  it('reads big endian and advances four', () => {
+    const bytes: Uint8Array = new Uint8Array([0x12, 0x34, 0x56, 0x78]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU32BigEndian(reader)).toEqual(0x1234_5678);
+    expect(reader.offset).toEqual(4);
+  });
+  it('reads the full unsigned range', () => {
+    const bytes: Uint8Array = new Uint8Array([0xff, 0xff, 0xff, 0xff]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU32BigEndian(reader)).toEqual(0xffffffff);
+  });
+});
+
+describe('readByteReaderU64', () => {
+  it('reads little endian exactly and advances eight', () => {
+    const bytes: Uint8Array = new Uint8Array([0, 0x10, 0, 0, 2, 0, 0, 0]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU64(reader)).toEqual(2 * 0x1_0000_0000 + 0x1000);
+    expect(reader.offset).toEqual(8);
+  });
+  it('reads the low word as unsigned when combining the result', () => {
+    const bytes: Uint8Array = new Uint8Array([0xff, 0xff, 0xff, 0xff, 2, 0, 0, 0]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU64(reader)).toEqual(3 * 0x1_0000_0000 - 1);
+  });
+});
+
+describe('readByteReaderU8', () => {
+  it('reads one byte and advances one', () => {
+    const bytes: Uint8Array = new Uint8Array([0xab]);
+    let reader = createByteReader(bytes, undefined);
+    expect(readByteReaderU8(reader)).toEqual(0xab);
+    expect(reader.offset).toEqual(1);
+  });
+});
+
+describe('skipByteReader', () => {
+  it('advances the offset without reading', () => {
+    const bytes = new Uint8Array(8).fill(0);
+    let reader = createByteReader(bytes, undefined);
+    skipByteReader(reader, 3);
+    expect(reader.offset).toEqual(3);
+  });
+});