1 |
|
2 | # Changelog
|
3 |
|
4 | This document maintains a list of changes to the `superstruct` package with each new version. Until `1.0.0` is released, breaking changes will be added as minor version bumps, and smaller changes and fixes won't be detailed.
|
5 |
|
6 |
|
7 | ---
|
8 |
|
9 |
|
10 | ### `0.4.0` — December 1, 2017
|
11 |
|
12 | ###### BREAKING
|
13 |
|
14 | - **`object` structs are no longer optional-ish.** Previously object struct types would not throw if `undefined` was passed and no properties were required. This was not only confusing, but complex to maintain. Now if you want an object struct to be optional, use the `struct.optional(...)` helper.
|
15 |
|
16 | - **Removed the `Struct.default` method.** If you need to get the default value, use the `Struct.validate` or `Struct.assert` methods's return value instead.
|
17 |
|
18 | ###### NEW
|
19 |
|
20 | - **Added the `dict`, `enum`, `intersection`, `union` and `tuple` structs.** These are all available as `struct.dict`, `struct.enum`, etc.
|
21 |
|
22 |
|
23 | ---
|
24 |
|
25 |
|
26 | ### `0.3.0` — November 30, 2017
|
27 |
|
28 | ###### BREAKING
|
29 |
|
30 | - **The `validate()` method now returns `[ error, result ]`.** Previously it only had a single return value, which necessitated extra type checking to see if the value was an error or a result. Now you can just destructure the array to get either return value, for easier coding.
|
31 |
|
32 | - **Errors have been simplified, removing "codes".** Previously there were multiple types of errors that were thrown and you could differentiate between them with the `error.code` property. But the other properties of the error already let you infer the code, so having multiple types of errors made for a larger API surface without much benefit.
|
33 |
|
34 |
|
35 | ---
|
36 |
|
37 |
|
38 | ### `0.2.0` — November 30, 2017
|
39 |
|
40 | ###### BREAKING
|
41 |
|
42 | - **Structs are now functions again.** :smile: They are built on the same underlying schema classes underneath though, since that helps the code structure. But to allow for the `struct = Struct({ ... })` syntax the structs themselves have changed to be function.
|
43 |
|
44 | ###### NEW
|
45 |
|
46 | - **The basic case is now `Struct(data)`.** Previously you had to use `Struct.assert(data)`. Although the `assert` method (and others) are still there, the basic case is a bit terser and more similar to the struct-initializing APIs in other languages.
|
47 |
|
48 |
|
49 | ---
|
50 |
|
51 |
|
52 | ### `0.1.0` — November 29, 2017
|
53 |
|
54 | ###### BREAKING
|
55 |
|
56 | - **Structs are now classes instead of functions.** This is better in terms of the API being a bit less magic-y. It's also useful so that we can add other helpful methods to structs besides the `assert` method. What was previously `struct(data)` is now `struct.assert(data)`.
|
57 |
|
58 |
|
59 | ---
|
60 |
|
61 |
|
62 | ### `0.0.0` — November 24, 2017
|
63 |
|
64 | :tada:
|