@nnilky/structo 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +31 -7
- package/structo/datatypes/containers/__snapshots__/list.test.ts.snap +0 -25
- package/structo/datatypes/containers/__snapshots__/object.test.ts.snap +0 -37
- package/structo/datatypes/containers/array.test.ts +0 -28
- package/structo/datatypes/containers/array.ts +0 -24
- package/structo/datatypes/containers/fastObject.ts +0 -66
- package/structo/datatypes/containers/list.test.ts +0 -44
- package/structo/datatypes/containers/list.ts +0 -29
- package/structo/datatypes/containers/object.test.ts +0 -42
- package/structo/datatypes/containers/object.ts +0 -40
- package/structo/datatypes/containers/sizedbuffer.test.ts +0 -34
- package/structo/datatypes/containers/sizedbuffer.ts +0 -20
- package/structo/datatypes/index.ts +0 -18
- package/structo/datatypes/lazy.ts +0 -0
- package/structo/datatypes/numbers/__snapshots__/bigints.test.ts.snap +0 -261
- package/structo/datatypes/numbers/__snapshots__/floats.test.ts.snap +0 -191
- package/structo/datatypes/numbers/__snapshots__/sints.test.ts.snap +0 -321
- package/structo/datatypes/numbers/__snapshots__/uints.test.ts.snap +0 -321
- package/structo/datatypes/numbers/bigints.test.ts +0 -85
- package/structo/datatypes/numbers/bigints.ts +0 -48
- package/structo/datatypes/numbers/floats.test.ts +0 -91
- package/structo/datatypes/numbers/floats.ts +0 -33
- package/structo/datatypes/numbers/sints.test.ts +0 -109
- package/structo/datatypes/numbers/sints.ts +0 -83
- package/structo/datatypes/numbers/uints.test.ts +0 -110
- package/structo/datatypes/numbers/uints.ts +0 -82
- package/structo/datatypes/transforms/pipe.test.ts +0 -17
- package/structo/datatypes/transforms/pipe.ts +0 -88
- package/structo/datatypes/transforms/readOffset.ts +0 -20
- package/structo/datatypes/transforms/transform.ts +0 -15
- package/structo/datatypes/utils.test.ts +0 -39
- package/structo/datatypes/values/buffer.test.ts +0 -52
- package/structo/datatypes/values/buffer.ts +0 -20
- package/structo/datatypes/values/byteliteral.ts +0 -24
- package/structo/datatypes/values/string.test.ts +0 -22
- package/structo/datatypes/values/string.ts +0 -28
- package/structo/index.ts +0 -11
- package/structo/read.ts +0 -14
- package/structo/types.ts +0 -21
- package/structo/utils.test.ts +0 -0
- package/structo/write.ts +0 -43
|
@@ -1,39 +0,0 @@
|
|
|
1
|
-
//@ts-ignore TODO
|
|
2
|
-
import { describe, it, expect } from "bun:test";
|
|
3
|
-
import * as st from "../index";
|
|
4
|
-
|
|
5
|
-
export const randint = (start: number, end: number) => {
|
|
6
|
-
const range = end - start;
|
|
7
|
-
return Math.floor(start + range * Math.random());
|
|
8
|
-
};
|
|
9
|
-
|
|
10
|
-
export const randbigint = (start: bigint, end: bigint) => {
|
|
11
|
-
const range = end - start;
|
|
12
|
-
const offset = BigInt(Math.floor(Number(range) * Math.random()));
|
|
13
|
-
|
|
14
|
-
return start + offset;
|
|
15
|
-
};
|
|
16
|
-
|
|
17
|
-
export const expectEncode = <T>(serializer: st.Serializer<T>, value: T) => {
|
|
18
|
-
const data = st.write(serializer, value);
|
|
19
|
-
const newValue = st.read(serializer, data);
|
|
20
|
-
expect(value).toEqual(newValue);
|
|
21
|
-
};
|
|
22
|
-
|
|
23
|
-
export const expectEncodeSnapshot = <T>(serializer: st.Serializer<T>, value: T) => {
|
|
24
|
-
const data = st.write(serializer, value);
|
|
25
|
-
expect(data).toMatchSnapshot();
|
|
26
|
-
};
|
|
27
|
-
|
|
28
|
-
export const expectError = (callback: () => void) => {
|
|
29
|
-
try {
|
|
30
|
-
callback();
|
|
31
|
-
} catch {
|
|
32
|
-
return;
|
|
33
|
-
}
|
|
34
|
-
throw new Error("Expected Error");
|
|
35
|
-
};
|
|
36
|
-
|
|
37
|
-
export const bytes = (bytes: number[]) => {
|
|
38
|
-
return new Uint8Array(bytes).buffer;
|
|
39
|
-
};
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
//@ts-ignore TODO
|
|
2
|
-
import { describe, it, expect } from "bun:test";
|
|
3
|
-
import { bytes, expectEncode, expectError, randint } from "../utils.test";
|
|
4
|
-
|
|
5
|
-
import * as st from "../../index";
|
|
6
|
-
|
|
7
|
-
describe("st.buffer", () => {
|
|
8
|
-
const buffer = st.buffer(2);
|
|
9
|
-
|
|
10
|
-
it("encode correctly", () => {
|
|
11
|
-
expectEncode(buffer, bytes([1, 2]));
|
|
12
|
-
});
|
|
13
|
-
|
|
14
|
-
it("encodes empty correctly", () => {
|
|
15
|
-
const spec = st.buffer(0);
|
|
16
|
-
expectEncode(spec, bytes([]));
|
|
17
|
-
});
|
|
18
|
-
|
|
19
|
-
it("holds large data", () => {
|
|
20
|
-
const size = 1024 * 1024 * 8; // 8MB
|
|
21
|
-
const spec = st.buffer(size);
|
|
22
|
-
|
|
23
|
-
const data = new Uint8Array(size);
|
|
24
|
-
data.set([3, 4], 1000);
|
|
25
|
-
data.set([3, 4], 2000);
|
|
26
|
-
expectEncode(spec, data.buffer);
|
|
27
|
-
});
|
|
28
|
-
it("large data writes work", () => {
|
|
29
|
-
const size = 1024 * 1024 * 8; // 8MB
|
|
30
|
-
const spec = st.object({
|
|
31
|
-
before: st.u8(),
|
|
32
|
-
data: st.buffer(size),
|
|
33
|
-
after: st.u8(),
|
|
34
|
-
});
|
|
35
|
-
|
|
36
|
-
const data = new Uint8Array(size);
|
|
37
|
-
data.set([3, 4], 1000);
|
|
38
|
-
data.set([3, 4], 2000);
|
|
39
|
-
expectEncode(spec, {
|
|
40
|
-
before: 1,
|
|
41
|
-
data: data.buffer,
|
|
42
|
-
after: 2,
|
|
43
|
-
});
|
|
44
|
-
});
|
|
45
|
-
|
|
46
|
-
it("errors on invalid length", () => {
|
|
47
|
-
const spec = st.buffer(5);
|
|
48
|
-
expectError(() => {
|
|
49
|
-
st.write(spec, bytes([1, 2, 3, 4]));
|
|
50
|
-
});
|
|
51
|
-
});
|
|
52
|
-
});
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
import type { Serializer } from "../../types";
|
|
2
|
-
|
|
3
|
-
export function buffer(size: number): Serializer<ArrayBuffer> {
|
|
4
|
-
return {
|
|
5
|
-
size,
|
|
6
|
-
write: (ctx, value) => {
|
|
7
|
-
const bytes = new Uint8Array(value);
|
|
8
|
-
if (bytes.length !== size) throw new Error("Invalid Length");
|
|
9
|
-
|
|
10
|
-
ctx.alloc(size);
|
|
11
|
-
new Uint8Array(ctx.buffer).set(bytes, ctx.offset);
|
|
12
|
-
ctx.offset += size;
|
|
13
|
-
},
|
|
14
|
-
read: (ctx) => {
|
|
15
|
-
const slice = ctx.buffer.slice(ctx.offset, ctx.offset + size);
|
|
16
|
-
ctx.offset += size;
|
|
17
|
-
return slice;
|
|
18
|
-
},
|
|
19
|
-
};
|
|
20
|
-
}
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
import type { Serializer } from "../../types";
|
|
2
|
-
|
|
3
|
-
export function byteLiteral(bytes: number[]): Serializer<number[]> {
|
|
4
|
-
const length = bytes.length;
|
|
5
|
-
|
|
6
|
-
return {
|
|
7
|
-
size: bytes.length,
|
|
8
|
-
read: (ctx) => {
|
|
9
|
-
const arr = new Uint8Array(ctx.view.buffer);
|
|
10
|
-
|
|
11
|
-
for (let i = 0; i < length; i++) {
|
|
12
|
-
if (arr[ctx.offset + i] !== bytes[i]) {
|
|
13
|
-
throw new Error("Invalid Value");
|
|
14
|
-
}
|
|
15
|
-
}
|
|
16
|
-
ctx.offset += length;
|
|
17
|
-
return bytes;
|
|
18
|
-
},
|
|
19
|
-
write(ctx) {
|
|
20
|
-
new Uint8Array(ctx.view.buffer).set(bytes, ctx.offset);
|
|
21
|
-
ctx.offset += length;
|
|
22
|
-
},
|
|
23
|
-
};
|
|
24
|
-
}
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
//@ts-ignore TODO
|
|
2
|
-
import { describe, it, expect } from "bun:test";
|
|
3
|
-
import { expectEncode, expectError, randint } from "../utils.test";
|
|
4
|
-
|
|
5
|
-
import * as st from "../../index";
|
|
6
|
-
|
|
7
|
-
describe("st.string", () => {
|
|
8
|
-
const string_u8 = st.string(st.u8());
|
|
9
|
-
const string_u32 = st.string(st.u32());
|
|
10
|
-
|
|
11
|
-
it("encode correctly", () => {
|
|
12
|
-
expectEncode(string_u8, "foo");
|
|
13
|
-
});
|
|
14
|
-
it("works on empty strings", () => {
|
|
15
|
-
expectEncode(string_u32, "");
|
|
16
|
-
});
|
|
17
|
-
it("errors on too long strings", () => {
|
|
18
|
-
expectError(() => {
|
|
19
|
-
st.write(string_u8, "A".repeat(256));
|
|
20
|
-
});
|
|
21
|
-
});
|
|
22
|
-
});
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
import type { Serializer } from "../../types";
|
|
2
|
-
|
|
3
|
-
export function string(length: Serializer<number>): Serializer<string> {
|
|
4
|
-
const { read: readLength, write: writeLength } = length;
|
|
5
|
-
const encoder = new TextEncoder();
|
|
6
|
-
const decoder = new TextDecoder();
|
|
7
|
-
|
|
8
|
-
return {
|
|
9
|
-
write: (ctx, value) => {
|
|
10
|
-
const bytes = encoder.encode(value);
|
|
11
|
-
|
|
12
|
-
writeLength(ctx, bytes.byteLength);
|
|
13
|
-
|
|
14
|
-
ctx.alloc(bytes.byteLength);
|
|
15
|
-
|
|
16
|
-
const arr = new Uint8Array(ctx.view.buffer);
|
|
17
|
-
arr.set(bytes, ctx.offset);
|
|
18
|
-
|
|
19
|
-
ctx.offset += bytes.byteLength;
|
|
20
|
-
},
|
|
21
|
-
read: (ctx) => {
|
|
22
|
-
const length = readLength(ctx);
|
|
23
|
-
const section = ctx.buffer.slice(ctx.offset, ctx.offset + length);
|
|
24
|
-
ctx.offset += length;
|
|
25
|
-
return decoder.decode(section);
|
|
26
|
-
},
|
|
27
|
-
};
|
|
28
|
-
}
|
package/structo/index.ts
DELETED
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
export type {
|
|
2
|
-
InferInput as Infer,
|
|
3
|
-
InferInput,
|
|
4
|
-
InferOutput,
|
|
5
|
-
ReaderContext,
|
|
6
|
-
WriterContext,
|
|
7
|
-
Serializer,
|
|
8
|
-
} from "./types";
|
|
9
|
-
export * from "./datatypes";
|
|
10
|
-
export { write, createdWriterContext } from "./write";
|
|
11
|
-
export { read, createReaderContext } from "./read";
|
package/structo/read.ts
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
import type { Serializer, ReaderContext } from "./types";
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
export function read<T>(serializer: Serializer<T>, buffer: ArrayBuffer): T {
|
|
5
|
-
return serializer.read(createReaderContext(buffer));
|
|
6
|
-
}
|
|
7
|
-
|
|
8
|
-
export function createReaderContext(buffer: ArrayBuffer) {
|
|
9
|
-
return {
|
|
10
|
-
offset: 0,
|
|
11
|
-
buffer,
|
|
12
|
-
view: new DataView(buffer),
|
|
13
|
-
};
|
|
14
|
-
}
|
package/structo/types.ts
DELETED
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
export type Serializer<TIn, TOut = TIn> = {
|
|
2
|
-
size?: number | undefined;
|
|
3
|
-
write: (ctx: WriterContext, value: TIn) => void;
|
|
4
|
-
read: (ctx: ReaderContext) => TOut;
|
|
5
|
-
};
|
|
6
|
-
|
|
7
|
-
export interface WriterContext {
|
|
8
|
-
buffer: ArrayBuffer;
|
|
9
|
-
view: DataView;
|
|
10
|
-
offset: number;
|
|
11
|
-
alloc: (length: number) => void;
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
export interface ReaderContext {
|
|
15
|
-
buffer: ArrayBuffer;
|
|
16
|
-
view: DataView;
|
|
17
|
-
offset: number;
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
export type InferInput<T> = T extends Serializer<infer V> ? V : never;
|
|
21
|
-
export type InferOutput<T> = T extends Serializer<any, infer V> ? V : never;
|
package/structo/utils.test.ts
DELETED
|
File without changes
|
package/structo/write.ts
DELETED
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
import type { WriterContext, Serializer } from "./types";
|
|
2
|
-
|
|
3
|
-
export function write<T>(serializer: Serializer<T>, value: T): ArrayBuffer {
|
|
4
|
-
const ctx = createdWriterContext(serializer);
|
|
5
|
-
serializer.write(ctx, value);
|
|
6
|
-
|
|
7
|
-
if (ctx.buffer.byteLength === ctx.offset) {
|
|
8
|
-
return ctx.buffer;
|
|
9
|
-
} else {
|
|
10
|
-
return ctx.buffer.transfer(ctx.offset);
|
|
11
|
-
}
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
export function createdWriterContext(type: Serializer<any>): WriterContext {
|
|
15
|
-
if (type.size) {
|
|
16
|
-
let buffer = new ArrayBuffer(type.size);
|
|
17
|
-
const view = new DataView(buffer);
|
|
18
|
-
return {
|
|
19
|
-
offset: 0,
|
|
20
|
-
buffer,
|
|
21
|
-
view,
|
|
22
|
-
alloc: Function.prototype as () => void,
|
|
23
|
-
};
|
|
24
|
-
} else {
|
|
25
|
-
let bufferLength = 64;
|
|
26
|
-
let buffer = new ArrayBuffer(bufferLength);
|
|
27
|
-
const view = new DataView(buffer);
|
|
28
|
-
return {
|
|
29
|
-
offset: 0,
|
|
30
|
-
buffer,
|
|
31
|
-
view,
|
|
32
|
-
alloc(length) {
|
|
33
|
-
if (length < 0) return;
|
|
34
|
-
|
|
35
|
-
while (this.offset + length >= bufferLength) {
|
|
36
|
-
bufferLength = this.buffer.byteLength * 2;
|
|
37
|
-
this.buffer = this.buffer.transfer(bufferLength);
|
|
38
|
-
this.view = new DataView(this.buffer);
|
|
39
|
-
}
|
|
40
|
-
},
|
|
41
|
-
};
|
|
42
|
-
}
|
|
43
|
-
}
|