@yume-chan/struct 0.0.10 → 0.0.12

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.
Files changed (121) hide show
  1. package/CHANGELOG.json +27 -0
  2. package/CHANGELOG.md +16 -1
  3. package/LICENSE +1 -1
  4. package/README.md +102 -53
  5. package/{dts → esm}/basic/definition.d.ts +9 -13
  6. package/esm/basic/definition.d.ts.map +1 -0
  7. package/esm/basic/definition.js +13 -9
  8. package/esm/basic/definition.js.map +1 -1
  9. package/{dts → esm}/basic/field-value.d.ts +8 -8
  10. package/esm/basic/field-value.d.ts.map +1 -0
  11. package/esm/basic/field-value.js +12 -5
  12. package/esm/basic/field-value.js.map +1 -1
  13. package/esm/basic/index.d.ts +6 -0
  14. package/esm/basic/index.d.ts.map +1 -0
  15. package/esm/basic/index.js +5 -4
  16. package/esm/basic/index.js.map +1 -1
  17. package/esm/basic/options.d.ts +10 -0
  18. package/esm/basic/options.d.ts.map +1 -0
  19. package/esm/basic/{context.js → options.js} +1 -1
  20. package/esm/basic/options.js.map +1 -0
  21. package/esm/basic/stream.d.ts +19 -0
  22. package/esm/basic/stream.d.ts.map +1 -0
  23. package/esm/basic/stream.js +2 -0
  24. package/esm/basic/stream.js.map +1 -0
  25. package/{dts → esm}/basic/struct-value.d.ts +3 -3
  26. package/esm/basic/struct-value.d.ts.map +1 -0
  27. package/esm/basic/struct-value.js +7 -9
  28. package/esm/basic/struct-value.js.map +1 -1
  29. package/esm/index.d.ts +14 -0
  30. package/esm/index.d.ts.map +1 -0
  31. package/esm/index.js +5 -5
  32. package/esm/index.js.map +1 -1
  33. package/{dts → esm}/struct.d.ts +16 -12
  34. package/esm/struct.d.ts.map +1 -0
  35. package/esm/struct.js +67 -54
  36. package/esm/struct.js.map +1 -1
  37. package/esm/syncbird.d.ts +65 -0
  38. package/esm/syncbird.d.ts.map +1 -0
  39. package/esm/syncbird.js +15 -4
  40. package/esm/syncbird.js.map +1 -1
  41. package/esm/types/bigint.d.ts +25 -0
  42. package/esm/types/bigint.d.ts.map +1 -0
  43. package/esm/types/bigint.js +45 -0
  44. package/esm/types/bigint.js.map +1 -0
  45. package/esm/types/buffer/base.d.ts +63 -0
  46. package/esm/types/buffer/base.d.ts.map +1 -0
  47. package/esm/types/buffer/base.js +100 -0
  48. package/esm/types/buffer/base.js.map +1 -0
  49. package/esm/types/buffer/fixed-length.d.ts +8 -0
  50. package/esm/types/buffer/fixed-length.d.ts.map +1 -0
  51. package/esm/types/buffer/fixed-length.js +8 -0
  52. package/esm/types/buffer/fixed-length.js.map +1 -0
  53. package/esm/types/buffer/index.d.ts +4 -0
  54. package/esm/types/buffer/index.d.ts.map +1 -0
  55. package/esm/types/buffer/index.js +4 -0
  56. package/esm/types/buffer/index.js.map +1 -0
  57. package/esm/types/buffer/variable-length.d.ts +43 -0
  58. package/esm/types/buffer/variable-length.d.ts.map +1 -0
  59. package/esm/types/buffer/variable-length.js +76 -0
  60. package/esm/types/buffer/variable-length.js.map +1 -0
  61. package/esm/types/index.d.ts +4 -0
  62. package/esm/types/index.d.ts.map +1 -0
  63. package/esm/types/index.js +3 -4
  64. package/esm/types/index.js.map +1 -1
  65. package/{dts → esm}/types/number.d.ts +10 -12
  66. package/esm/types/number.d.ts.map +1 -0
  67. package/esm/types/number.js +21 -14
  68. package/esm/types/number.js.map +1 -1
  69. package/{dts → esm}/utils.d.ts +2 -2
  70. package/{dts → esm}/utils.d.ts.map +1 -1
  71. package/esm/utils.js +9 -3
  72. package/esm/utils.js.map +1 -1
  73. package/package.json +47 -47
  74. package/src/basic/definition.ts +11 -13
  75. package/src/basic/field-value.ts +8 -8
  76. package/src/basic/index.ts +5 -4
  77. package/src/basic/options.ts +19 -0
  78. package/src/basic/stream.ts +19 -0
  79. package/src/basic/struct-value.ts +4 -4
  80. package/src/index.ts +17 -5
  81. package/src/struct.ts +89 -75
  82. package/src/syncbird.ts +86 -10
  83. package/src/types/bigint.ts +102 -0
  84. package/src/types/buffer/base.ts +176 -0
  85. package/src/types/buffer/fixed-length.ts +17 -0
  86. package/src/types/buffer/index.ts +3 -0
  87. package/src/types/{variable-length-array-buffer.ts → buffer/variable-length.ts} +48 -34
  88. package/src/types/index.ts +3 -4
  89. package/src/types/number.ts +27 -26
  90. package/src/utils.ts +13 -5
  91. package/dts/basic/context.d.ts +0 -28
  92. package/dts/basic/context.d.ts.map +0 -1
  93. package/dts/basic/definition.d.ts.map +0 -1
  94. package/dts/basic/field-value.d.ts.map +0 -1
  95. package/dts/basic/index.d.ts +0 -5
  96. package/dts/basic/index.d.ts.map +0 -1
  97. package/dts/basic/struct-value.d.ts.map +0 -1
  98. package/dts/index.d.ts +0 -6
  99. package/dts/index.d.ts.map +0 -1
  100. package/dts/struct.d.ts.map +0 -1
  101. package/dts/syncbird.d.ts +0 -20
  102. package/dts/syncbird.d.ts.map +0 -1
  103. package/dts/types/array-buffer.d.ts +0 -71
  104. package/dts/types/array-buffer.d.ts.map +0 -1
  105. package/dts/types/fixed-length-array-buffer.d.ts +0 -8
  106. package/dts/types/fixed-length-array-buffer.d.ts.map +0 -1
  107. package/dts/types/index.d.ts +0 -5
  108. package/dts/types/index.d.ts.map +0 -1
  109. package/dts/types/number.d.ts.map +0 -1
  110. package/dts/types/variable-length-array-buffer.d.ts +0 -32
  111. package/dts/types/variable-length-array-buffer.d.ts.map +0 -1
  112. package/esm/basic/context.js.map +0 -1
  113. package/esm/types/array-buffer.js +0 -110
  114. package/esm/types/array-buffer.js.map +0 -1
  115. package/esm/types/fixed-length-array-buffer.js +0 -8
  116. package/esm/types/fixed-length-array-buffer.js.map +0 -1
  117. package/esm/types/variable-length-array-buffer.js +0 -71
  118. package/esm/types/variable-length-array-buffer.js.map +0 -1
  119. package/src/basic/context.ts +0 -32
  120. package/src/types/array-buffer.ts +0 -194
  121. package/src/types/fixed-length-array-buffer.ts +0 -17
@@ -1,71 +0,0 @@
1
- import { StructAsyncDeserializeStream, StructDeserializeStream, StructFieldDefinition, StructFieldValue, StructOptions, StructValue } from '../basic';
2
- /**
3
- * Base class for all types that
4
- * can be converted from an ArrayBuffer when deserialized,
5
- * and need to be converted to an ArrayBuffer when serializing
6
- *
7
- * @template TValue The actual TypeScript type of this type
8
- * @template TTypeScriptType Optional another type (should be compatible with `TType`)
9
- * specified by user when creating field definitions.
10
- */
11
- export declare abstract class ArrayBufferLikeFieldType<TValue = unknown, TTypeScriptType = TValue> {
12
- readonly TTypeScriptType: TTypeScriptType;
13
- /**
14
- * When implemented in derived classes, converts the type-specific `value` to an `ArrayBuffer`
15
- *
16
- * This function should be "pure", i.e.,
17
- * same `value` should always be converted to `ArrayBuffer`s that have same content.
18
- */
19
- abstract toArrayBuffer(value: TValue): ArrayBuffer;
20
- /** When implemented in derived classes, converts the `ArrayBuffer` to a type-specific value */
21
- abstract fromArrayBuffer(arrayBuffer: ArrayBuffer): TValue;
22
- /**
23
- * When implemented in derived classes, gets the size in byte of the type-specific `value`.
24
- *
25
- * If the size can't be calculated without first converting the `value` back to an `ArrayBuffer`,
26
- * implementer should returns `-1` so the caller will get its size by first converting it to
27
- * an `ArrayBuffer` (and cache the result).
28
- */
29
- abstract getSize(value: TValue): number;
30
- }
31
- /** An ArrayBufferLike type that's actually an `ArrayBuffer` */
32
- export declare class ArrayBufferFieldType extends ArrayBufferLikeFieldType<ArrayBuffer> {
33
- static readonly instance: ArrayBufferFieldType;
34
- protected constructor();
35
- toArrayBuffer(value: ArrayBuffer): ArrayBuffer;
36
- fromArrayBuffer(arrayBuffer: ArrayBuffer): ArrayBuffer;
37
- getSize(value: ArrayBuffer): number;
38
- }
39
- /** Am ArrayBufferLike type that converts between `ArrayBuffer` and `Uint8ClampedArray` */
40
- export declare class Uint8ClampedArrayFieldType extends ArrayBufferLikeFieldType<Uint8ClampedArray, Uint8ClampedArray> {
41
- static readonly instance: Uint8ClampedArrayFieldType;
42
- protected constructor();
43
- toArrayBuffer(value: Uint8ClampedArray): ArrayBuffer;
44
- fromArrayBuffer(arrayBuffer: ArrayBuffer): Uint8ClampedArray;
45
- getSize(value: Uint8ClampedArray): number;
46
- }
47
- /** An ArrayBufferLike type that converts between `ArrayBuffer` and `string` */
48
- export declare class StringFieldType<TTypeScriptType = string> extends ArrayBufferLikeFieldType<string, TTypeScriptType> {
49
- static readonly instance: StringFieldType<string>;
50
- toArrayBuffer(value: string): ArrayBuffer;
51
- fromArrayBuffer(arrayBuffer: ArrayBuffer): string;
52
- getSize(): number;
53
- }
54
- export declare abstract class ArrayBufferLikeFieldDefinition<TType extends ArrayBufferLikeFieldType<any, any> = ArrayBufferLikeFieldType<unknown, unknown>, TOptions = void, TOmitInitKey extends PropertyKey = never> extends StructFieldDefinition<TOptions, TType['TTypeScriptType'], TOmitInitKey> {
55
- readonly type: TType;
56
- constructor(type: TType, options: TOptions);
57
- protected getDeserializeSize(struct: StructValue): number;
58
- /**
59
- * When implemented in derived classes, creates a `StructFieldValue` for the current field definition.
60
- */
61
- create(options: Readonly<StructOptions>, struct: StructValue, value: TType['TTypeScriptType'], arrayBuffer?: ArrayBuffer): ArrayBufferLikeFieldValue<this>;
62
- deserialize(options: Readonly<StructOptions>, stream: StructDeserializeStream, struct: StructValue): ArrayBufferLikeFieldValue<this>;
63
- deserialize(options: Readonly<StructOptions>, stream: StructAsyncDeserializeStream, struct: StructValue): Promise<ArrayBufferLikeFieldValue<this>>;
64
- }
65
- export declare class ArrayBufferLikeFieldValue<TDefinition extends ArrayBufferLikeFieldDefinition<ArrayBufferLikeFieldType<unknown, unknown>, any, any>> extends StructFieldValue<TDefinition> {
66
- protected arrayBuffer: ArrayBuffer | undefined;
67
- constructor(definition: TDefinition, options: Readonly<StructOptions>, struct: StructValue, value: TDefinition['TValue'], arrayBuffer?: ArrayBuffer);
68
- set(value: TDefinition['TValue']): void;
69
- serialize(dataView: DataView, offset: number): void;
70
- }
71
- //# sourceMappingURL=array-buffer.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"array-buffer.d.ts","sourceRoot":"","sources":["../../src/types/array-buffer.ts"],"names":[],"mappings":"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"}
@@ -1,8 +0,0 @@
1
- import { ArrayBufferLikeFieldDefinition, ArrayBufferLikeFieldType } from './array-buffer';
2
- export interface FixedLengthArrayBufferLikeFieldOptions {
3
- length: number;
4
- }
5
- export declare class FixedLengthArrayBufferLikeFieldDefinition<TType extends ArrayBufferLikeFieldType = ArrayBufferLikeFieldType, TOptions extends FixedLengthArrayBufferLikeFieldOptions = FixedLengthArrayBufferLikeFieldOptions> extends ArrayBufferLikeFieldDefinition<TType, TOptions> {
6
- getSize(): number;
7
- }
8
- //# sourceMappingURL=fixed-length-array-buffer.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"fixed-length-array-buffer.d.ts","sourceRoot":"","sources":["../../src/types/fixed-length-array-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1F,MAAM,WAAW,sCAAsC;IACnD,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,yCAAyC,CAClD,KAAK,SAAS,wBAAwB,GAAG,wBAAwB,EACjE,QAAQ,SAAS,sCAAsC,GAAG,sCAAsC,CAC9F,SAAQ,8BAA8B,CACxC,KAAK,EACL,QAAQ,CACP;IACM,OAAO,IAAI,MAAM;CAG3B"}
@@ -1,5 +0,0 @@
1
- export * from './array-buffer';
2
- export * from './fixed-length-array-buffer';
3
- export * from './number';
4
- export * from './variable-length-array-buffer';
5
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,gCAAgC,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/types/number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAItJ,oBAAY,eAAe,GACvB;KAAG,IAAI,IAAI,MAAM,QAAQ,GAAG,IAAI,SAAS,MAAM,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK;CAAE,CAAC,MAAM,QAAQ,CAAC,CAAC;AAE7F,oBAAY,eAAe,GACvB;KAAG,IAAI,IAAI,MAAM,QAAQ,GAAG,IAAI,SAAS,MAAM,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK;CAAE,CAAC,MAAM,QAAQ,CAAC,CAAC;AAE7F,qBAAa,eAAe,CAAC,eAAe,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAClF,SAAgB,eAAe,EAAG,eAAe,CAAC;IAElD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,SAAgB,cAAc,EAAE,eAAe,CAAC;IAEhD,SAAgB,cAAc,EAAE,eAAe,CAAC;gBAG5C,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,eAAe,EAC/B,cAAc,EAAE,eAAe;IAOnC,gBAAuB,IAAI,0BAAwD;IAEnF,gBAAuB,KAAK,0BAA0D;IAEtF,gBAAuB,KAAK,0BAA0D;IAEtF,gBAAuB,MAAM,0BAA4D;IAEzF,gBAAuB,KAAK,0BAA0D;IAEtF,gBAAuB,MAAM,0BAA4D;IAEzF,gBAAuB,KAAK,0BAAgE;IAE5F,gBAAuB,MAAM,0BAAkE;CAClG;AAED,qBAAa,qBAAqB,CAC9B,KAAK,SAAS,eAAe,GAAG,eAAe,EAC/C,eAAe,GAAG,KAAK,CAAC,iBAAiB,CAAC,CACxC,SAAQ,qBAAqB,CAC/B,IAAI,EACJ,eAAe,CACd;IACD,SAAgB,IAAI,EAAE,KAAK,CAAC;gBAET,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,eAAe;IAK1D,OAAO,IAAI,MAAM;IAIjB,MAAM,CACT,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,GACvB,gBAAgB,CAAC,IAAI,CAAC;IAIT,WAAW,CACvB,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,WAAW,GACpB,gBAAgB,CAAC,IAAI,CAAC;IACT,WAAW,CACvB,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,4BAA4B,EACpC,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;CAiBrC;AAED,qBAAa,gBAAgB,CACzB,WAAW,SAAS,qBAAqB,CAAC,eAAe,EAAE,GAAG,CAAC,CAC7D,SAAQ,gBAAgB,CAAC,WAAW,CAAC;IAChC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAU7D"}
@@ -1,32 +0,0 @@
1
- import { StructFieldDefinition, StructFieldValue, StructOptions, StructValue } from '../basic';
2
- import type { KeysOfType } from '../utils';
3
- import { ArrayBufferLikeFieldDefinition, ArrayBufferLikeFieldType, ArrayBufferLikeFieldValue } from './array-buffer';
4
- export declare type LengthField<TFields> = KeysOfType<TFields, number | string>;
5
- export interface VariableLengthArrayBufferLikeFieldOptions<TFields = object, TLengthField extends LengthField<TFields> = any> {
6
- lengthField: TLengthField;
7
- lengthFieldBase?: number;
8
- }
9
- export declare class VariableLengthArrayBufferLikeFieldDefinition<TType extends ArrayBufferLikeFieldType = ArrayBufferLikeFieldType, TOptions extends VariableLengthArrayBufferLikeFieldOptions = VariableLengthArrayBufferLikeFieldOptions> extends ArrayBufferLikeFieldDefinition<TType, TOptions, TOptions['lengthField']> {
10
- getSize(): number;
11
- protected getDeserializeSize(struct: StructValue): number;
12
- create(options: Readonly<StructOptions>, struct: StructValue, value: TType['TTypeScriptType'], arrayBuffer?: ArrayBuffer): VariableLengthArrayBufferLikeStructFieldValue<this>;
13
- }
14
- export declare class VariableLengthArrayBufferLikeStructFieldValue<TDefinition extends VariableLengthArrayBufferLikeFieldDefinition = VariableLengthArrayBufferLikeFieldDefinition> extends ArrayBufferLikeFieldValue<TDefinition> {
15
- protected length: number | undefined;
16
- protected lengthFieldValue: VariableLengthArrayBufferLikeFieldLengthValue;
17
- constructor(definition: TDefinition, options: Readonly<StructOptions>, struct: StructValue, value: TDefinition['TValue'], arrayBuffer?: ArrayBuffer);
18
- getSize(): number;
19
- set(value: unknown): void;
20
- }
21
- declare type VariableLengthArrayBufferLikeFieldValueLike = StructFieldValue<StructFieldDefinition<VariableLengthArrayBufferLikeFieldOptions, any, any>>;
22
- export declare class VariableLengthArrayBufferLikeFieldLengthValue extends StructFieldValue {
23
- protected originalField: StructFieldValue;
24
- protected arrayBufferField: VariableLengthArrayBufferLikeFieldValueLike;
25
- constructor(originalField: StructFieldValue, arrayBufferField: VariableLengthArrayBufferLikeFieldValueLike);
26
- getSize(): number;
27
- get(): string | number;
28
- set(): void;
29
- serialize(dataView: DataView, offset: number): void;
30
- }
31
- export {};
32
- //# sourceMappingURL=variable-length-array-buffer.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"variable-length-array-buffer.d.ts","sourceRoot":"","sources":["../../src/types/variable-length-array-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAErH,oBAAY,WAAW,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,yCAAyC,CACtD,OAAO,GAAG,MAAM,EAChB,YAAY,SAAS,WAAW,CAAC,OAAO,CAAC,GAAG,GAAG;IAE/C,WAAW,EAAE,YAAY,CAAC;IAE1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,4CAA4C,CACrD,KAAK,SAAS,wBAAwB,GAAG,wBAAwB,EACjE,QAAQ,SAAS,yCAAyC,GAAG,yCAAyC,CACpG,SAAQ,8BAA8B,CACxC,KAAK,EACL,QAAQ,EACR,QAAQ,CAAC,aAAa,CAAC,CACtB;IACM,OAAO,IAAI,MAAM;cAIL,kBAAkB,CAAC,MAAM,EAAE,WAAW;IAQzC,MAAM,CAClB,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAC/B,WAAW,CAAC,EAAE,WAAW,GAC1B,6CAA6C,CAAC,IAAI,CAAC;CASzD;AAED,qBAAa,6CAA6C,CACtD,WAAW,SAAS,4CAA4C,GAAG,4CAA4C,CAC7G,SAAQ,yBAAyB,CAAC,WAAW,CAAC;IAChD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,SAAS,CAAC,gBAAgB,EAAE,6CAA6C,CAAC;gBAGtE,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC5B,WAAW,CAAC,EAAE,WAAW;IAmBb,OAAO;IAYP,GAAG,CAAC,KAAK,EAAE,OAAO;CAKrC;AAGD,aAAK,2CAA2C,GAC5C,gBAAgB,CAAC,qBAAqB,CAAC,yCAAyC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEjG,qBAAa,6CACT,SAAQ,gBAAgB;IACxB,SAAS,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAE1C,SAAS,CAAC,gBAAgB,EAAE,2CAA2C,CAAC;gBAGpE,aAAa,EAAE,gBAAgB,EAC/B,gBAAgB,EAAE,2CAA2C;IAOjD,OAAO;IAIP,GAAG;IAWH,GAAG;IAEnB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;CAI/C"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/basic/context.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,oBAAoB,GAA4B;IACzD,YAAY,EAAE,KAAK;CACtB,CAAC"}
@@ -1,110 +0,0 @@
1
- import { StructFieldDefinition, StructFieldValue } from '../basic';
2
- import { Syncbird } from "../syncbird";
3
- import { decodeUtf8, encodeUtf8 } from "../utils";
4
- /**
5
- * Base class for all types that
6
- * can be converted from an ArrayBuffer when deserialized,
7
- * and need to be converted to an ArrayBuffer when serializing
8
- *
9
- * @template TValue The actual TypeScript type of this type
10
- * @template TTypeScriptType Optional another type (should be compatible with `TType`)
11
- * specified by user when creating field definitions.
12
- */
13
- export class ArrayBufferLikeFieldType {
14
- }
15
- /** An ArrayBufferLike type that's actually an `ArrayBuffer` */
16
- export class ArrayBufferFieldType extends ArrayBufferLikeFieldType {
17
- constructor() {
18
- super();
19
- }
20
- toArrayBuffer(value) {
21
- return value;
22
- }
23
- fromArrayBuffer(arrayBuffer) {
24
- return arrayBuffer;
25
- }
26
- getSize(value) {
27
- return value.byteLength;
28
- }
29
- }
30
- ArrayBufferFieldType.instance = new ArrayBufferFieldType();
31
- /** Am ArrayBufferLike type that converts between `ArrayBuffer` and `Uint8ClampedArray` */
32
- export class Uint8ClampedArrayFieldType extends ArrayBufferLikeFieldType {
33
- constructor() {
34
- super();
35
- }
36
- toArrayBuffer(value) {
37
- return value.buffer;
38
- }
39
- fromArrayBuffer(arrayBuffer) {
40
- return new Uint8ClampedArray(arrayBuffer);
41
- }
42
- getSize(value) {
43
- return value.byteLength;
44
- }
45
- }
46
- Uint8ClampedArrayFieldType.instance = new Uint8ClampedArrayFieldType();
47
- /** An ArrayBufferLike type that converts between `ArrayBuffer` and `string` */
48
- export class StringFieldType extends ArrayBufferLikeFieldType {
49
- toArrayBuffer(value) {
50
- return encodeUtf8(value);
51
- }
52
- fromArrayBuffer(arrayBuffer) {
53
- return decodeUtf8(arrayBuffer);
54
- }
55
- getSize() {
56
- // Return `-1`, so `ArrayBufferLikeFieldDefinition` will
57
- // convert this `value` into an `ArrayBuffer` (and cache the result),
58
- // Then get the size from that `ArrayBuffer`
59
- return -1;
60
- }
61
- }
62
- StringFieldType.instance = new StringFieldType();
63
- const EmptyArrayBuffer = new ArrayBuffer(0);
64
- export class ArrayBufferLikeFieldDefinition extends StructFieldDefinition {
65
- constructor(type, options) {
66
- super(options);
67
- this.type = type;
68
- }
69
- getDeserializeSize(struct) {
70
- return this.getSize();
71
- }
72
- /**
73
- * When implemented in derived classes, creates a `StructFieldValue` for the current field definition.
74
- */
75
- create(options, struct, value, arrayBuffer) {
76
- return new ArrayBufferLikeFieldValue(this, options, struct, value, arrayBuffer);
77
- }
78
- deserialize(options, stream, struct) {
79
- return Syncbird.try(() => {
80
- const size = this.getDeserializeSize(struct);
81
- if (size === 0) {
82
- return EmptyArrayBuffer;
83
- }
84
- else {
85
- return stream.read(size);
86
- }
87
- }).then(arrayBuffer => {
88
- const value = this.type.fromArrayBuffer(arrayBuffer);
89
- return this.create(options, struct, value, arrayBuffer);
90
- }).valueOrPromise();
91
- }
92
- }
93
- export class ArrayBufferLikeFieldValue extends StructFieldValue {
94
- constructor(definition, options, struct, value, arrayBuffer) {
95
- super(definition, options, struct, value);
96
- this.arrayBuffer = arrayBuffer;
97
- }
98
- set(value) {
99
- super.set(value);
100
- this.arrayBuffer = undefined;
101
- }
102
- serialize(dataView, offset) {
103
- if (!this.arrayBuffer) {
104
- this.arrayBuffer = this.definition.type.toArrayBuffer(this.value);
105
- }
106
- new Uint8Array(dataView.buffer)
107
- .set(new Uint8Array(this.arrayBuffer), offset);
108
- }
109
- }
110
- //# sourceMappingURL=array-buffer.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"array-buffer.js","sourceRoot":"","sources":["../../src/types/array-buffer.ts"],"names":[],"mappings":"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"}
@@ -1,8 +0,0 @@
1
- import { ArrayBufferLikeFieldDefinition } from './array-buffer';
2
- export class FixedLengthArrayBufferLikeFieldDefinition extends ArrayBufferLikeFieldDefinition {
3
- getSize() {
4
- return this.options.length;
5
- }
6
- }
7
- ;
8
- //# sourceMappingURL=fixed-length-array-buffer.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"fixed-length-array-buffer.js","sourceRoot":"","sources":["../../src/types/fixed-length-array-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAA4B,MAAM,gBAAgB,CAAC;AAM1F,MAAM,OAAO,yCAGP,SAAQ,8BAGT;IACM,OAAO;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;CACJ;AAAA,CAAC"}
@@ -1,71 +0,0 @@
1
- import { StructFieldValue } from '../basic';
2
- import { ArrayBufferLikeFieldDefinition, ArrayBufferLikeFieldValue } from './array-buffer';
3
- export class VariableLengthArrayBufferLikeFieldDefinition extends ArrayBufferLikeFieldDefinition {
4
- getSize() {
5
- return 0;
6
- }
7
- getDeserializeSize(struct) {
8
- var _a;
9
- let value = struct.value[this.options.lengthField];
10
- if (typeof value === 'string') {
11
- value = Number.parseInt(value, (_a = this.options.lengthFieldBase) !== null && _a !== void 0 ? _a : 10);
12
- }
13
- return value;
14
- }
15
- create(options, struct, value, arrayBuffer) {
16
- return new VariableLengthArrayBufferLikeStructFieldValue(this, options, struct, value, arrayBuffer);
17
- }
18
- }
19
- export class VariableLengthArrayBufferLikeStructFieldValue extends ArrayBufferLikeFieldValue {
20
- constructor(definition, options, struct, value, arrayBuffer) {
21
- super(definition, options, struct, value, arrayBuffer);
22
- if (arrayBuffer) {
23
- this.length = arrayBuffer.byteLength;
24
- }
25
- // Patch the associated length field.
26
- const lengthField = this.definition.options.lengthField;
27
- const originalValue = struct.get(lengthField);
28
- this.lengthFieldValue = new VariableLengthArrayBufferLikeFieldLengthValue(originalValue, this);
29
- struct.set(lengthField, this.lengthFieldValue);
30
- }
31
- getSize() {
32
- if (this.length === undefined) {
33
- this.length = this.definition.type.getSize(this.value);
34
- if (this.length === -1) {
35
- this.arrayBuffer = this.definition.type.toArrayBuffer(this.value);
36
- this.length = this.arrayBuffer.byteLength;
37
- }
38
- }
39
- return this.length;
40
- }
41
- set(value) {
42
- super.set(value);
43
- this.arrayBuffer = undefined;
44
- this.length = undefined;
45
- }
46
- }
47
- export class VariableLengthArrayBufferLikeFieldLengthValue extends StructFieldValue {
48
- constructor(originalField, arrayBufferField) {
49
- super(originalField.definition, originalField.options, originalField.struct, 0);
50
- this.originalField = originalField;
51
- this.arrayBufferField = arrayBufferField;
52
- }
53
- getSize() {
54
- return this.originalField.getSize();
55
- }
56
- get() {
57
- var _a;
58
- let value = this.arrayBufferField.getSize();
59
- const originalValue = this.originalField.get();
60
- if (typeof originalValue === 'string') {
61
- value = value.toString((_a = this.arrayBufferField.definition.options.lengthFieldBase) !== null && _a !== void 0 ? _a : 10);
62
- }
63
- return value;
64
- }
65
- set() { }
66
- serialize(dataView, offset) {
67
- this.originalField.set(this.get());
68
- this.originalField.serialize(dataView, offset);
69
- }
70
- }
71
- //# sourceMappingURL=variable-length-array-buffer.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"variable-length-array-buffer.js","sourceRoot":"","sources":["../../src/types/variable-length-array-buffer.ts"],"names":[],"mappings":"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"}
@@ -1,32 +0,0 @@
1
- export interface StructDeserializeStream {
2
- /**
3
- * Read data from the underlying data source.
4
- *
5
- * Stream must return exactly `length` bytes or data. If that's not possible
6
- * (due to end of file or other error condition), it must throw an error.
7
- */
8
- read(length: number): ArrayBuffer;
9
- }
10
-
11
- export interface StructAsyncDeserializeStream {
12
- /**
13
- * Read data from the underlying data source.
14
- *
15
- * Context must return exactly `length` bytes or data. If that's not possible
16
- * (due to end of file or other error condition), it must throw an error.
17
- */
18
- read(length: number): Promise<ArrayBuffer>;
19
- }
20
-
21
- export interface StructOptions {
22
- /**
23
- * Whether all multi-byte fields in this struct are little-endian encoded.
24
- *
25
- * Default to `false`
26
- */
27
- littleEndian: boolean;
28
- }
29
-
30
- export const StructDefaultOptions: Readonly<StructOptions> = {
31
- littleEndian: false,
32
- };
@@ -1,194 +0,0 @@
1
- import { StructAsyncDeserializeStream, StructDeserializeStream, StructFieldDefinition, StructFieldValue, StructOptions, StructValue } from '../basic';
2
- import { Syncbird } from "../syncbird";
3
- import { decodeUtf8, encodeUtf8, ValueOrPromise } from "../utils";
4
-
5
- /**
6
- * Base class for all types that
7
- * can be converted from an ArrayBuffer when deserialized,
8
- * and need to be converted to an ArrayBuffer when serializing
9
- *
10
- * @template TValue The actual TypeScript type of this type
11
- * @template TTypeScriptType Optional another type (should be compatible with `TType`)
12
- * specified by user when creating field definitions.
13
- */
14
- export abstract class ArrayBufferLikeFieldType<TValue = unknown, TTypeScriptType = TValue> {
15
- public readonly TTypeScriptType!: TTypeScriptType;
16
-
17
- /**
18
- * When implemented in derived classes, converts the type-specific `value` to an `ArrayBuffer`
19
- *
20
- * This function should be "pure", i.e.,
21
- * same `value` should always be converted to `ArrayBuffer`s that have same content.
22
- */
23
- public abstract toArrayBuffer(value: TValue): ArrayBuffer;
24
-
25
- /** When implemented in derived classes, converts the `ArrayBuffer` to a type-specific value */
26
- public abstract fromArrayBuffer(arrayBuffer: ArrayBuffer): TValue;
27
-
28
- /**
29
- * When implemented in derived classes, gets the size in byte of the type-specific `value`.
30
- *
31
- * If the size can't be calculated without first converting the `value` back to an `ArrayBuffer`,
32
- * implementer should returns `-1` so the caller will get its size by first converting it to
33
- * an `ArrayBuffer` (and cache the result).
34
- */
35
- public abstract getSize(value: TValue): number;
36
- }
37
-
38
- /** An ArrayBufferLike type that's actually an `ArrayBuffer` */
39
- export class ArrayBufferFieldType extends ArrayBufferLikeFieldType<ArrayBuffer> {
40
- public static readonly instance = new ArrayBufferFieldType();
41
-
42
- protected constructor() {
43
- super();
44
- }
45
-
46
- public toArrayBuffer(value: ArrayBuffer): ArrayBuffer {
47
- return value;
48
- }
49
-
50
- public fromArrayBuffer(arrayBuffer: ArrayBuffer): ArrayBuffer {
51
- return arrayBuffer;
52
- }
53
-
54
- public getSize(value: ArrayBuffer): number {
55
- return value.byteLength;
56
- }
57
- }
58
-
59
- /** Am ArrayBufferLike type that converts between `ArrayBuffer` and `Uint8ClampedArray` */
60
- export class Uint8ClampedArrayFieldType
61
- extends ArrayBufferLikeFieldType<Uint8ClampedArray, Uint8ClampedArray> {
62
- public static readonly instance = new Uint8ClampedArrayFieldType();
63
-
64
- protected constructor() {
65
- super();
66
- }
67
-
68
- public toArrayBuffer(value: Uint8ClampedArray): ArrayBuffer {
69
- return value.buffer;
70
- }
71
-
72
- public fromArrayBuffer(arrayBuffer: ArrayBuffer): Uint8ClampedArray {
73
- return new Uint8ClampedArray(arrayBuffer);
74
- }
75
-
76
- public getSize(value: Uint8ClampedArray): number {
77
- return value.byteLength;
78
- }
79
- }
80
-
81
- /** An ArrayBufferLike type that converts between `ArrayBuffer` and `string` */
82
- export class StringFieldType<TTypeScriptType = string>
83
- extends ArrayBufferLikeFieldType<string, TTypeScriptType> {
84
- public static readonly instance = new StringFieldType();
85
-
86
- public toArrayBuffer(value: string): ArrayBuffer {
87
- return encodeUtf8(value);
88
- }
89
-
90
- public fromArrayBuffer(arrayBuffer: ArrayBuffer): string {
91
- return decodeUtf8(arrayBuffer);
92
- }
93
-
94
- public getSize(): number {
95
- // Return `-1`, so `ArrayBufferLikeFieldDefinition` will
96
- // convert this `value` into an `ArrayBuffer` (and cache the result),
97
- // Then get the size from that `ArrayBuffer`
98
- return -1;
99
- }
100
- }
101
-
102
- const EmptyArrayBuffer = new ArrayBuffer(0);
103
-
104
- export abstract class ArrayBufferLikeFieldDefinition<
105
- TType extends ArrayBufferLikeFieldType<any, any> = ArrayBufferLikeFieldType<unknown, unknown>,
106
- TOptions = void,
107
- TOmitInitKey extends PropertyKey = never,
108
- > extends StructFieldDefinition<
109
- TOptions,
110
- TType['TTypeScriptType'],
111
- TOmitInitKey
112
- >{
113
- public readonly type: TType;
114
-
115
- public constructor(type: TType, options: TOptions) {
116
- super(options);
117
- this.type = type;
118
- }
119
-
120
- protected getDeserializeSize(struct: StructValue): number {
121
- return this.getSize();
122
- }
123
-
124
- /**
125
- * When implemented in derived classes, creates a `StructFieldValue` for the current field definition.
126
- */
127
- public create(
128
- options: Readonly<StructOptions>,
129
- struct: StructValue,
130
- value: TType['TTypeScriptType'],
131
- arrayBuffer?: ArrayBuffer,
132
- ): ArrayBufferLikeFieldValue<this> {
133
- return new ArrayBufferLikeFieldValue(this, options, struct, value, arrayBuffer);
134
- }
135
-
136
- public override deserialize(
137
- options: Readonly<StructOptions>,
138
- stream: StructDeserializeStream,
139
- struct: StructValue,
140
- ): ArrayBufferLikeFieldValue<this>;
141
- public override deserialize(
142
- options: Readonly<StructOptions>,
143
- stream: StructAsyncDeserializeStream,
144
- struct: StructValue,
145
- ): Promise<ArrayBufferLikeFieldValue<this>>;
146
- public override deserialize(
147
- options: Readonly<StructOptions>,
148
- stream: StructDeserializeStream | StructAsyncDeserializeStream,
149
- struct: StructValue,
150
- ): ValueOrPromise<ArrayBufferLikeFieldValue<this>> {
151
- return Syncbird.try(() => {
152
- const size = this.getDeserializeSize(struct);
153
- if (size === 0) {
154
- return EmptyArrayBuffer;
155
- } else {
156
- return stream.read(size);
157
- }
158
- }).then(arrayBuffer => {
159
- const value = this.type.fromArrayBuffer(arrayBuffer);
160
- return this.create(options, struct, value, arrayBuffer);
161
- }).valueOrPromise();
162
- }
163
- }
164
-
165
- export class ArrayBufferLikeFieldValue<
166
- TDefinition extends ArrayBufferLikeFieldDefinition<ArrayBufferLikeFieldType<unknown, unknown>, any, any>,
167
- > extends StructFieldValue<TDefinition> {
168
- protected arrayBuffer: ArrayBuffer | undefined;
169
-
170
- public constructor(
171
- definition: TDefinition,
172
- options: Readonly<StructOptions>,
173
- struct: StructValue,
174
- value: TDefinition['TValue'],
175
- arrayBuffer?: ArrayBuffer,
176
- ) {
177
- super(definition, options, struct, value);
178
- this.arrayBuffer = arrayBuffer;
179
- }
180
-
181
- public override set(value: TDefinition['TValue']): void {
182
- super.set(value);
183
- this.arrayBuffer = undefined;
184
- }
185
-
186
- public serialize(dataView: DataView, offset: number): void {
187
- if (!this.arrayBuffer) {
188
- this.arrayBuffer = this.definition.type.toArrayBuffer(this.value);
189
- }
190
-
191
- new Uint8Array(dataView.buffer)
192
- .set(new Uint8Array(this.arrayBuffer), offset);
193
- }
194
- }
@@ -1,17 +0,0 @@
1
- import { ArrayBufferLikeFieldDefinition, ArrayBufferLikeFieldType } from './array-buffer';
2
-
3
- export interface FixedLengthArrayBufferLikeFieldOptions {
4
- length: number;
5
- }
6
-
7
- export class FixedLengthArrayBufferLikeFieldDefinition<
8
- TType extends ArrayBufferLikeFieldType = ArrayBufferLikeFieldType,
9
- TOptions extends FixedLengthArrayBufferLikeFieldOptions = FixedLengthArrayBufferLikeFieldOptions,
10
- > extends ArrayBufferLikeFieldDefinition<
11
- TType,
12
- TOptions
13
- > {
14
- public getSize(): number {
15
- return this.options.length;
16
- }
17
- };