@flighthq/encoding 0.5.1-edge.685.f72fc7f

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

@@ -0,0 +1,17 @@
+# @flighthq/encoding
+
+Portable UTF-8 conversion between strings and byte arrays
+
+## Install
+
+```sh
+npm install @flighthq/encoding
+```
+
+Import the supported application-facing API from `@flighthq/encoding`. The `@flighthq/encoding/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/encoding@0.5.1-edge.685.f72fc7f](https://github.com/flighthq/flight/tree/f72fc7feaa9653d950f39c7d2fe6365f48e82e51/packages/encoding)
+- [License](https://github.com/flighthq/flight/blob/f72fc7feaa9653d950f39c7d2fe6365f48e82e51/LICENSE.md)

package/dist/contract.d.ts

@@ -0,0 +1,2 @@
+export * from './utf8';
+//# 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":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/contract.js

@@ -0,0 +1,2 @@
+export * from './utf8';
+//# 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,cAAc,QAAQ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './contract';
+//# 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":"AAAA,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './contract';
+//# 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,cAAc,YAAY,CAAC"}

package/dist/utf8.d.ts

@@ -0,0 +1,3 @@
+export declare function decodeUTF8(bytes: Readonly<Uint8Array>, offset?: number, length?: number): string;
+export declare function encodeUTF8(text: string): Uint8Array;
+//# sourceMappingURL=utf8.d.ts.map

package/dist/utf8.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utf8.d.ts","sourceRoot":"","sources":["../src/utf8.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,MAAM,GAAE,MAAU,EAClB,MAAM,GAAE,MAA8B,GACrC,MAAM,CAqER;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAmBnD"}

package/dist/utf8.js

@@ -0,0 +1,147 @@
+export function decodeUTF8(bytes, offset = 0, length = bytes.length - offset) {
+    assertUTF8Window(bytes.length, offset, length);
+    const end = offset + length;
+    let result = '';
+    let index = offset;
+    while (index < end) {
+        const first = bytes[index++];
+        if (first <= 0x7f) {
+            result += String.fromCharCode(first);
+            continue;
+        }
+        if (first >= 0xc2 && first <= 0xdf) {
+            if (index < end) {
+                const second = bytes[index];
+                if (isUTF8Continuation(second)) {
+                    index++;
+                    result += String.fromCharCode(((first & 0x1f) << 6) | (second & 0x3f));
+                    continue;
+                }
+            }
+            result += UTF8_REPLACEMENT_CHARACTER;
+            continue;
+        }
+        if (first >= 0xe0 && first <= 0xef) {
+            const secondMinimum = first === 0xe0 ? 0xa0 : 0x80;
+            const secondMaximum = first === 0xed ? 0x9f : 0xbf;
+            if (index >= end || bytes[index] < secondMinimum || bytes[index] > secondMaximum) {
+                result += UTF8_REPLACEMENT_CHARACTER;
+                continue;
+            }
+            const second = bytes[index++];
+            if (index >= end || !isUTF8Continuation(bytes[index])) {
+                result += UTF8_REPLACEMENT_CHARACTER;
+                continue;
+            }
+            const third = bytes[index++];
+            result += String.fromCharCode(((first & 0x0f) << 12) | ((second & 0x3f) << 6) | (third & 0x3f));
+            continue;
+        }
+        if (first >= 0xf0 && first <= 0xf4) {
+            const secondMinimum = first === 0xf0 ? 0x90 : 0x80;
+            const secondMaximum = first === 0xf4 ? 0x8f : 0xbf;
+            if (index >= end || bytes[index] < secondMinimum || bytes[index] > secondMaximum) {
+                result += UTF8_REPLACEMENT_CHARACTER;
+                continue;
+            }
+            const second = bytes[index++];
+            if (index >= end || !isUTF8Continuation(bytes[index])) {
+                result += UTF8_REPLACEMENT_CHARACTER;
+                continue;
+            }
+            const third = bytes[index++];
+            if (index >= end || !isUTF8Continuation(bytes[index])) {
+                result += UTF8_REPLACEMENT_CHARACTER;
+                continue;
+            }
+            const fourth = bytes[index++];
+            const codePoint = ((first & 0x07) << 18) | ((second & 0x3f) << 12) | ((third & 0x3f) << 6) | (fourth & 0x3f);
+            const pair = codePoint - 0x10000;
+            result += String.fromCharCode(0xd800 | (pair >> 10), 0xdc00 | (pair & 0x3ff));
+            continue;
+        }
+        result += UTF8_REPLACEMENT_CHARACTER;
+    }
+    return result;
+}
+export function encodeUTF8(text) {
+    const result = new Uint8Array(measureUTF8(text));
+    let outputIndex = 0;
+    for (let index = 0; index < text.length; index++) {
+        let codePoint = text.charCodeAt(index);
+        if (codePoint >= 0xd800 && codePoint <= 0xdbff) {
+            const second = index + 1 < text.length ? text.charCodeAt(index + 1) : 0;
+            if (second >= 0xdc00 && second <= 0xdfff) {
+                codePoint = 0x10000 + ((codePoint - 0xd800) << 10) + (second - 0xdc00);
+                index++;
+            }
+            else {
+                codePoint = UTF8_REPLACEMENT_CODE_POINT;
+            }
+        }
+        else if (codePoint >= 0xdc00 && codePoint <= 0xdfff) {
+            codePoint = UTF8_REPLACEMENT_CODE_POINT;
+        }
+        outputIndex = writeUTF8CodePoint(result, outputIndex, codePoint);
+    }
+    return result;
+}
+function assertUTF8Window(byteLength, offset, length) {
+    if (!Number.isInteger(offset) ||
+        !Number.isInteger(length) ||
+        offset < 0 ||
+        length < 0 ||
+        offset + length > byteLength) {
+        throw new RangeError('decodeUTF8 window is outside the byte array');
+    }
+}
+function isUTF8Continuation(byte) {
+    return byte >= 0x80 && byte <= 0xbf;
+}
+function measureUTF8(text) {
+    let byteLength = 0;
+    for (let index = 0; index < text.length; index++) {
+        const codeUnit = text.charCodeAt(index);
+        if (codeUnit <= 0x7f)
+            byteLength++;
+        else if (codeUnit <= 0x7ff)
+            byteLength += 2;
+        else if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {
+            const second = index + 1 < text.length ? text.charCodeAt(index + 1) : 0;
+            if (second >= 0xdc00 && second <= 0xdfff) {
+                byteLength += 4;
+                index++;
+            }
+            else {
+                byteLength += 3;
+            }
+        }
+        else
+            byteLength += 3;
+    }
+    return byteLength;
+}
+function writeUTF8CodePoint(out, offset, codePoint) {
+    if (codePoint <= 0x7f) {
+        out[offset++] = codePoint;
+    }
+    else if (codePoint <= 0x7ff) {
+        out[offset++] = 0xc0 | (codePoint >> 6);
+        out[offset++] = 0x80 | (codePoint & 0x3f);
+    }
+    else if (codePoint <= 0xffff) {
+        out[offset++] = 0xe0 | (codePoint >> 12);
+        out[offset++] = 0x80 | ((codePoint >> 6) & 0x3f);
+        out[offset++] = 0x80 | (codePoint & 0x3f);
+    }
+    else {
+        out[offset++] = 0xf0 | (codePoint >> 18);
+        out[offset++] = 0x80 | ((codePoint >> 12) & 0x3f);
+        out[offset++] = 0x80 | ((codePoint >> 6) & 0x3f);
+        out[offset++] = 0x80 | (codePoint & 0x3f);
+    }
+    return offset;
+}
+const UTF8_REPLACEMENT_CHARACTER = '\ufffd';
+const UTF8_REPLACEMENT_CODE_POINT = 0xfffd;
+//# sourceMappingURL=utf8.js.map

package/dist/utf8.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@flighthq/encoding",
+  "version": "0.5.1-edge.685.f72fc7f",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/encoding"
+  },
+  "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",
+    "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"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Portable UTF-8 conversion between strings and byte arrays",
+  "sideEffects": false
+}

package/src/utf8.test.ts

@@ -0,0 +1,49 @@
+import { decodeUTF8, encodeUTF8 } from './utf8';
+
+describe('decodeUTF8', () => {
+  it('decodes empty and ASCII input', () => {
+    expect(decodeUTF8(new Uint8Array())).toBe('');
+    expect(decodeUTF8(Uint8Array.of(0, 72, 101, 108, 108, 111, 0x7f))).toBe('\0Hello\u007f');
+  });
+
+  it('decodes two-, three-, and four-byte sequences', () => {
+    expect(decodeUTF8(Uint8Array.of(0xc2, 0xa2, 0xe2, 0x82, 0xac, 0xf0, 0x9f, 0x98, 0x80))).toBe('¢€😀');
+  });
+
+  it('replaces malformed and incomplete sequences without consuming the next valid byte', () => {
+    expect(decodeUTF8(Uint8Array.of(0x80, 0xc0, 0xaf))).toBe('���');
+    expect(decodeUTF8(Uint8Array.of(0xe2, 0x28, 0xa1))).toBe('�(�');
+    expect(decodeUTF8(Uint8Array.of(0xed, 0xa0, 0x80))).toBe('���');
+    expect(decodeUTF8(Uint8Array.of(0xe2, 0x82))).toBe('�');
+  });
+
+  it('honors offset and length windows without reading adjacent bytes', () => {
+    const bytes = Uint8Array.of(0xff, 72, 0xc3, 0xa9, 0xff);
+    expect(decodeUTF8(bytes, 1, 3)).toBe('Hé');
+    expect(decodeUTF8(bytes, 1, 0)).toBe('');
+    expect(decodeUTF8(bytes, 5)).toBe('');
+    expect(decodeUTF8(Uint8Array.of(0xe2, 0x82, 0xac), 0, 2)).toBe('�');
+  });
+
+  it('rejects windows outside the byte array', () => {
+    const bytes = Uint8Array.of(65);
+    expect(() => decodeUTF8(bytes, -1)).toThrow(RangeError);
+    expect(() => decodeUTF8(bytes, 0, 2)).toThrow(RangeError);
+  });
+});
+
+describe('encodeUTF8', () => {
+  it('encodes empty and ASCII input', () => {
+    expect(encodeUTF8('')).toEqual(new Uint8Array());
+    expect(encodeUTF8('\0Hello\u007f')).toEqual(Uint8Array.of(0, 72, 101, 108, 108, 111, 0x7f));
+  });
+
+  it('encodes two-, three-, and four-byte sequences', () => {
+    expect(encodeUTF8('¢€😀')).toEqual(Uint8Array.of(0xc2, 0xa2, 0xe2, 0x82, 0xac, 0xf0, 0x9f, 0x98, 0x80));
+  });
+
+  it('encodes unpaired surrogates as the replacement character', () => {
+    expect(encodeUTF8('\ud800A\udc00')).toEqual(Uint8Array.of(0xef, 0xbf, 0xbd, 65, 0xef, 0xbf, 0xbd));
+    expect(encodeUTF8('\ufffd')).toEqual(Uint8Array.of(0xef, 0xbf, 0xbd));
+  });
+});