lawspec 0.25.0 → 0.26.0

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 (149) hide show
  1. package/CHANGELOG.md +43 -1
  2. package/README.md +5 -4
  3. package/api.mjs +0 -8
  4. package/bin/lawspec.mjs +14 -52
  5. package/build.json +77 -105
  6. package/core.wasm +2 -2
  7. package/core_jsffi.js +5 -0
  8. package/examples/native-payments/clojure/lawspec.json +1 -1
  9. package/examples/native-payments/csharp/lawspec.json +1 -1
  10. package/examples/native-payments/elixir/lawspec.json +1 -1
  11. package/examples/native-payments/erlang/lawspec.json +1 -1
  12. package/examples/native-payments/fsharp/lawspec.json +1 -1
  13. package/examples/native-payments/gleam/lawspec.json +1 -1
  14. package/examples/native-payments/go/lawspec.json +1 -1
  15. package/examples/native-payments/groovy/lawspec.json +1 -1
  16. package/examples/native-payments/haskell/lawspec.json +1 -1
  17. package/examples/native-payments/java/lawspec.json +1 -1
  18. package/examples/native-payments/javascript/lawspec.json +1 -1
  19. package/examples/native-payments/kotlin/lawspec.json +1 -1
  20. package/examples/native-payments/python/lawspec.json +1 -1
  21. package/examples/native-payments/rust/lawspec.json +1 -1
  22. package/examples/native-payments/scala/lawspec.json +1 -1
  23. package/examples/native-payments/swift/lawspec.json +1 -1
  24. package/examples/native-payments/typescript/lawspec.json +1 -1
  25. package/examples/packages/orders/lawspec.json +1 -1
  26. package/examples/packages/orders/orders.lawspec +27 -25
  27. package/examples/packages/shop-domain/src/domain.lawspec +15 -14
  28. package/examples/packages/shop-tax-1/src/api.lawspec +1 -0
  29. package/examples/packages/shop-tax-1/src/rates.lawspec +1 -0
  30. package/examples/packages/shop-tax-2/src/api.lawspec +1 -0
  31. package/examples/packages/shop-tax-2/src/rates.lawspec +1 -0
  32. package/examples/rc1/authorization-snapshots.lawspec +24 -23
  33. package/examples/rc1/banner-filenames.lawspec +7 -6
  34. package/examples/rc1/bit-codec.lawspec +12 -11
  35. package/examples/rc1/bounded-witness-search.lawspec +52 -45
  36. package/examples/rc1/conflicting-requirements.lawspec +8 -7
  37. package/examples/rc1/constructive-witnesses.lawspec +40 -33
  38. package/examples/rc1/documentary-review.lawspec +9 -8
  39. package/examples/rc1/empty-domains.lawspec +16 -15
  40. package/examples/rc1/finite-integer-domains.lawspec +24 -23
  41. package/examples/rc1/law-metadata.lawspec +6 -5
  42. package/examples/rc1/native-payments.lawspec +17 -16
  43. package/examples/rc1/nesting/rrr.lawspec +4 -3
  44. package/examples/rc1/nesting/rru.lawspec +7 -6
  45. package/examples/rc1/nesting/rur.lawspec +7 -6
  46. package/examples/rc1/nesting/ruu.lawspec +10 -9
  47. package/examples/rc1/nesting/urr.lawspec +7 -6
  48. package/examples/rc1/nesting/uru.lawspec +10 -9
  49. package/examples/rc1/nesting/uur.lawspec +10 -9
  50. package/examples/rc1/nesting/uuu.lawspec +13 -12
  51. package/examples/rc1/order-workflow.lawspec +18 -17
  52. package/examples/rc1/parcel-measurements.lawspec +14 -13
  53. package/examples/rc1/picture-records.lawspec +6 -5
  54. package/examples/rc1/picture-tuples.lawspec +6 -5
  55. package/examples/rc1/record-payloads.lawspec +12 -11
  56. package/examples/rc1/recursive-records.lawspec +11 -10
  57. package/examples/rc1/refund-conformance.lawspec +7 -6
  58. package/examples/rc1/refund-policy.lawspec +15 -14
  59. package/examples/rc1/requirement-composition.lawspec +26 -25
  60. package/examples/rc1/structural-records.lawspec +13 -12
  61. package/examples/rc1-authoring.lawspec +6 -5
  62. package/examples/specs/abilities.lawspec +67 -65
  63. package/examples/specs/ability_imports.lawspec +58 -57
  64. package/examples/specs/actors.lawspec +23 -22
  65. package/examples/specs/algebra.lawspec +142 -141
  66. package/examples/specs/approvals.lawspec +16 -15
  67. package/examples/specs/async_bindings.lawspec +10 -9
  68. package/examples/specs/async_fetch.lawspec +12 -11
  69. package/examples/specs/atoi_codec.lawspec +16 -15
  70. package/examples/specs/boolean_flags.lawspec +10 -9
  71. package/examples/specs/builtins.lawspec +73 -72
  72. package/examples/specs/canonical_url.lawspec +14 -13
  73. package/examples/specs/collections.lawspec +153 -154
  74. package/examples/specs/composition.lawspec +70 -66
  75. package/examples/specs/concurrent_collections.lawspec +8 -7
  76. package/examples/specs/consistency.lawspec +4 -3
  77. package/examples/specs/contracts.lawspec +80 -79
  78. package/examples/specs/crypto.lawspec +26 -25
  79. package/examples/specs/ctc.lawspec +148 -0
  80. package/examples/specs/currying.lawspec +32 -31
  81. package/examples/specs/data_types.lawspec +50 -49
  82. package/examples/specs/distribution.lawspec +57 -56
  83. package/examples/specs/domain_modeling.lawspec +48 -47
  84. package/examples/specs/durations.lawspec +39 -38
  85. package/examples/specs/equivalent.lawspec +25 -24
  86. package/examples/specs/failures.lawspec +64 -63
  87. package/examples/specs/finite_data.lawspec +32 -31
  88. package/examples/specs/flow_stack.lawspec +64 -63
  89. package/examples/specs/gadt_expressions.lawspec +50 -49
  90. package/examples/specs/generation.lawspec +115 -114
  91. package/examples/specs/handler_bindings.lawspec +42 -40
  92. package/examples/specs/handles.lawspec +2 -1
  93. package/examples/specs/harness.lawspec +45 -43
  94. package/examples/specs/harness_testing.lawspec +18 -13
  95. package/examples/specs/indexed_arithmetic.lawspec +401 -126
  96. package/examples/specs/indexed_families.lawspec +182 -66
  97. package/examples/specs/keywords.lawspec +22 -21
  98. package/examples/specs/limits.lawspec +6 -5
  99. package/examples/specs/list_contracts.lawspec +121 -120
  100. package/examples/specs/list_refinements.lawspec +43 -42
  101. package/examples/specs/lists.lawspec +45 -44
  102. package/examples/specs/matchers.lawspec +79 -78
  103. package/examples/specs/matching.lawspec +43 -42
  104. package/examples/specs/mixed_inputs.lawspec +25 -24
  105. package/examples/specs/models.lawspec +44 -43
  106. package/examples/specs/parse_port.lawspec +28 -27
  107. package/examples/specs/payments.lawspec +55 -54
  108. package/examples/specs/railway.lawspec +59 -58
  109. package/examples/specs/records.lawspec +149 -148
  110. package/examples/specs/records_inner.lawspec +5 -4
  111. package/examples/specs/recursive_refinements.lawspec +30 -29
  112. package/examples/specs/refined_definitions.lawspec +24 -23
  113. package/examples/specs/refinements.lawspec +58 -57
  114. package/examples/specs/resilience.lawspec +159 -158
  115. package/examples/specs/resources.lawspec +61 -60
  116. package/examples/specs/scalar_adapters.lawspec +60 -59
  117. package/examples/specs/scalar_catalog.lawspec +165 -164
  118. package/examples/specs/scalars.lawspec +78 -77
  119. package/examples/specs/scheduling_order.lawspec +8 -7
  120. package/examples/specs/scheduling_overlap.lawspec +5 -4
  121. package/examples/specs/sequences.lawspec +66 -65
  122. package/examples/specs/sessions.lawspec +13 -12
  123. package/examples/specs/slug.lawspec +16 -15
  124. package/examples/specs/sum_refinements.lawspec +42 -41
  125. package/examples/specs/tables.lawspec +29 -28
  126. package/examples/specs/total_functions.lawspec +71 -70
  127. package/examples/specs/workflows.lawspec +101 -100
  128. package/examples-command.mjs +4 -6
  129. package/explain.mjs +6 -4
  130. package/expression-presentation.mjs +8 -8
  131. package/files.mjs +1 -1
  132. package/index.d.ts +4 -527
  133. package/launcher.mjs +9 -2
  134. package/lsp.mjs +10 -6
  135. package/native-examples.mjs +2 -2
  136. package/package.json +1 -1
  137. package/starter-rc1.lawspec +6 -5
  138. package/starter.lawspec +16 -15
  139. package/templates.mjs +4 -2
  140. package/migrate.mjs +0 -135
  141. package/migration-bindings.mjs +0 -86
  142. package/migration-cases.mjs +0 -45
  143. package/migration-collections.mjs +0 -54
  144. package/migration-correspondence.mjs +0 -275
  145. package/migration-generation.mjs +0 -99
  146. package/migration-laws.mjs +0 -102
  147. package/migration-records.mjs +0 -166
  148. package/migration-source.mjs +0 -247
  149. package/migration-write.mjs +0 -156
@@ -44,42 +44,42 @@ end function
44
44
  law sampleWeight is
45
45
  description:
46
46
  "A sample parcel weighs one gram."
47
- end
47
+ end description
48
48
  definition:
49
49
  sampleParcel () must be Parcel record{details = record{
50
50
  weight = Measurement record{reading = record{value = 1}}
51
51
  }}
52
- end
53
- end
52
+ end definition
53
+ end law
54
54
 
55
55
  law positiveWeights is
56
56
  description:
57
57
  "Every accepted parcel measurement has a positive weight."
58
- end
58
+ end description
59
59
  definition:
60
60
  for all (parcel of type record{
61
61
  weight of type (measurement of type Measurement Integer
62
62
  where measurement.reading.value > 0)
63
63
  }) =>
64
64
  weightOf parcel > 0
65
- end
66
- end
65
+ end for all
66
+ end definition
67
67
  expect weightOf parcel = expected
68
68
  in table (parcel, expected):
69
69
  row record{weight = Measurement record{reading = record{value = 1}}}, 1
70
70
  row record{weight = Measurement record{reading = record{value = 3}}}, 3
71
- end
72
- end
71
+ end table
72
+ end law
73
73
 
74
74
  law recipientLabels is
75
75
  description:
76
76
  "Deliveries preserve the recipient written on their label."
77
- end
77
+ end description
78
78
  definition:
79
79
  for all (delivery of type Delivery DeliveryLabel) =>
80
80
  recipient delivery = recipient delivery
81
- end
82
- end
81
+ end for all
82
+ end definition
83
83
  expect recipient delivery = expected
84
84
  in table (delivery, expected):
85
85
  row Delivery record{contents = record{value = DeliveryLabel record{
@@ -88,5 +88,6 @@ law recipientLabels is
88
88
  row Delivery record{contents = record{value = DeliveryLabel record{
89
89
  code = 8, recipient = "Bo"
90
90
  }}}, "Bo"
91
- end
92
- end
91
+ end table
92
+ end law
93
+ end unit
@@ -28,7 +28,7 @@ end function
28
28
  law "|named dimensions determine orientation| is
29
29
  description:
30
30
  "Dimension labels preserve their meaning in either field order."
31
- end
31
+ end description
32
32
  definition:
33
33
  for all (picture of type Picture) =>
34
34
  orientation picture must be
@@ -37,8 +37,8 @@ law "|named dimensions determine orientation| is
37
37
  else Square
38
38
  end if
39
39
  end if
40
- end
41
- end
40
+ end for all
41
+ end definition
42
42
  expect orientation picture = expected
43
43
  in table (picture, expected):
44
44
  row Picture record{fileName = "wide.jpg", dimensions = record{width = 12,
@@ -47,5 +47,6 @@ law "|named dimensions determine orientation| is
47
47
  width = 8}}, Portrait
48
48
  row Picture record{fileName = "square.jpg", dimensions = record{width = 10,
49
49
  height = 10}}, Square
50
- end
51
- end
50
+ end table
51
+ end law
52
+ end unit
@@ -24,7 +24,7 @@ end function
24
24
  law "|tuple dimensions determine orientation| is
25
25
  description:
26
26
  "Width comes first and height second in a picture's dimensions."
27
- end
27
+ end description
28
28
  definition:
29
29
  for all (picture of type Picture) =>
30
30
  orientation picture must be
@@ -36,12 +36,13 @@ law "|tuple dimensions determine orientation| is
36
36
  end if
37
37
  end if
38
38
  end case
39
- end
40
- end
39
+ end for all
40
+ end definition
41
41
  expect orientation picture = expected
42
42
  in table (picture, expected):
43
43
  row Picture record{fileName = "wide.jpg", dimensions = (12, 8)}, Landscape
44
44
  row Picture record{fileName = "tall.jpg", dimensions = (8, 12)}, Portrait
45
45
  row Picture record{fileName = "square.jpg", dimensions = (10, 10)}, Square
46
- end
47
- end
46
+ end table
47
+ end law
48
+ end unit
@@ -28,29 +28,30 @@ function boxedPayload (box of type Box a) -> record{value of type a} is
28
28
  law pictureWidth is definition:
29
29
  width (Picture record{fileName = "photo", dimensions = record{height = 3,
30
30
  width = 2}}) must be 2
31
- end end
31
+ end definition end law
32
32
  law downloadLabel is definition: label (Download record{document = "paper"})
33
- must be "paper" end end
33
+ must be "paper" end definition end law
34
34
  law wrappedText is definition: extract (Envelope record{payload = record{value =
35
- "note", copy = "other"}}) must be "note" end end
35
+ "note", copy = "other"}}) must be "note" end definition end law
36
36
  law wrappedBoolean is definition: extract (Envelope record{payload =
37
- record{value = true, copy = false}}) must be true end end
37
+ record{value = true, copy = false}}) must be true end definition end law
38
38
  law wholeRecord is definition: unpack (Envelope record{payload = record{value =
39
- true, copy = false}}) = record{copy = false, value = true} end end
39
+ true, copy = false}}) = record{copy = false, value = true} end definition end law
40
40
  law boxedResult is definition: boxedPayload (Box record{value = true}) =
41
- record{value = true} end end
41
+ record{value = true} end definition end law
42
42
  law boxedRows is definition: for all (box of type Box Text) => boxedPayload box
43
- = boxedPayload box end end
43
+ = boxedPayload box end for all end definition
44
44
  expect (boxedPayload box).value = expected in table (box, expected):
45
45
  row Box record{value = "note"}, "note"
46
46
  row Box record{value = "paper"}, "paper"
47
- end end
47
+ end table end law
48
48
  law labels is
49
49
  definition: for all (delivery of type Delivery) => label delivery = label
50
- delivery end end
50
+ delivery end for all end definition
51
51
  expect label delivery = expected
52
52
  in table (delivery, expected):
53
53
  row Download record{document = "paper"}, "paper"
54
54
  row Unavailable, "unavailable"
55
- end
56
- end
55
+ end table
56
+ end law
57
+ end unit
@@ -35,23 +35,23 @@ law "|an unissued approval has no finite construction| is
35
35
  definition:
36
36
  for all (approval of type UnissuedApproval) =>
37
37
  false
38
- end
39
- end
40
- end
38
+ end for all
39
+ end definition
40
+ end law
41
41
 
42
42
  law "|mutually dependent snapshots have no first value| is
43
43
  definition:
44
44
  for all (snapshot of type FirstSnapshot) =>
45
45
  false
46
- end
47
- end
48
- end
46
+ end for all
47
+ end definition
48
+ end law
49
49
 
50
50
  law "|a completed chain has no remaining approval| is
51
51
  definition:
52
52
  chainLength (ApprovalChain record{next = Nothing}) must be 0
53
- end
54
- end
53
+ end definition
54
+ end law
55
55
 
56
56
  law "|a pending chain counts each remaining approval| is
57
57
  definition:
@@ -60,5 +60,6 @@ law "|a pending chain counts each remaining approval| is
60
60
  next = Just (ApprovalChain record{next = Nothing})
61
61
  })
62
62
  }) must be 2
63
- end
64
- end
63
+ end definition
64
+ end law
65
+ end unit
@@ -7,16 +7,16 @@ nativeRefund of type policy.RefundRequest -> policy.RefundDecision
7
7
  law "|native refunds conform to the policy| is
8
8
  description:
9
9
  "The application's refund decision agrees with the checked policy."
10
- end
10
+ end description
11
11
  definition:
12
12
  for all (request of type policy.RefundRequest) =>
13
13
  nativeRefund request must be policy.refund request
14
- end
15
- end
14
+ end for all
15
+ end definition
16
16
 
17
17
  references:
18
18
  ref function policy.refund
19
- end
19
+ end references
20
20
 
21
21
  expect nativeRefund request = expected
22
22
  in table (request, expected):
@@ -40,5 +40,6 @@ law "|native refunds conform to the policy| is
40
40
  flagged = false}, policy.Approved
41
41
  row policy.RefundRequest record{capturedAmount = 9007199254740992,
42
42
  requestedAmount = 9007199254740993, flagged = false}, policy.Rejected
43
- end
44
- end
43
+ end table
44
+ end law
45
+ end unit
@@ -25,24 +25,24 @@ end function
25
25
  law "|a zero refund is approved| is
26
26
  description:
27
27
  "A zero request transfers nothing and needs no review."
28
- end
28
+ end description
29
29
  definition:
30
30
  for all (capturedAmount of type Whole) (flagged of type Bool) =>
31
31
  refund (RefundRequest record{
32
32
  capturedAmount = capturedAmount, requestedAmount = 0, flagged = flagged
33
33
  }) must be Approved
34
- end
35
- end
36
- end
34
+ end for all
35
+ end definition
36
+ end law
37
37
 
38
38
  law "|a refund cannot exceed the captured amount| is
39
39
  definition:
40
40
  for all (request of type RefundRequest) =>
41
41
  request.requestedAmount > request.capturedAmount implies
42
42
  refund request must be Rejected
43
- end
44
- end
45
- end
43
+ end for all
44
+ end definition
45
+ end law
46
46
 
47
47
  law "|an eligible flagged refund requires review| is
48
48
  definition:
@@ -50,17 +50,17 @@ law "|an eligible flagged refund requires review| is
50
50
  request.requestedAmount > 0 and
51
51
  request.requestedAmount <= request.capturedAmount and request.flagged
52
52
  implies refund request must be ReviewRequired
53
- end
54
- end
55
- end
53
+ end for all
54
+ end definition
55
+ end law
56
56
 
57
57
  law "|an eligible unflagged refund is approved| is
58
58
  definition:
59
59
  for all (request of type RefundRequest) =>
60
60
  request.requestedAmount <= request.capturedAmount and not request.flagged
61
61
  implies refund request must be Approved
62
- end
63
- end
62
+ end for all
63
+ end definition
64
64
 
65
65
  expect refund request = expected
66
66
  in table (request, expected):
@@ -84,5 +84,6 @@ law "|an eligible unflagged refund is approved| is
84
84
  = false}, Approved
85
85
  row RefundRequest record{capturedAmount = 9007199254740992, requestedAmount
86
86
  = 9007199254740993, flagged = false}, Rejected
87
- end
88
- end
87
+ end table
88
+ end law
89
+ end unit
@@ -8,10 +8,10 @@ law "|each item has a match| (relation of type a -> b -> Bool) is
8
8
  for all (item of type b) =>
9
9
  there exists (witness of type a) such that
10
10
  relation witness item
11
- end
12
- end
13
- end
14
- end
11
+ end exists
12
+ end for all
13
+ end definition
14
+ end law
15
15
 
16
16
  function revokedMatch (authorization of type Authorization)
17
17
  (payment of type Payment) -> Bool is
@@ -26,25 +26,25 @@ law "|matching and readiness agree| is
26
26
  there exists (authorization of type Authorization
27
27
  where active Ready authorization) such that
28
28
  authorizes authorization payment
29
- end
30
- end)
31
- end
29
+ end exists
30
+ end for all)
31
+ end definition
32
32
 
33
33
  description:
34
34
  "Every payment has a matching identity and an active approval when ready."
35
- end
36
- end
35
+ end description
36
+ end law
37
37
 
38
38
  law "|revocation or matching has a complete explanation| is
39
39
  definition:
40
40
  (must not apply law "|each item has a match| revokedMatch)
41
41
  or apply law "|each item has a match| authorizes
42
- end
42
+ end definition
43
43
 
44
44
  description:
45
45
  "Either revoked approvals cannot cover every payment, or matching succeeds."
46
- end
47
- end
46
+ end description
47
+ end law
48
48
 
49
49
  law "|matching implies ready approval coverage| is
50
50
  definition:
@@ -54,36 +54,37 @@ law "|matching implies ready approval coverage| is
54
54
  there exists (authorization of type Authorization
55
55
  where active Ready authorization) such that
56
56
  authorizes authorization payment
57
- end
58
- end)
59
- end
60
- end
57
+ end exists
58
+ end for all)
59
+ end definition
60
+ end law
61
61
 
62
62
  law "|payment and approval identities have separate scopes| is
63
63
  definition:
64
64
  (for all (value of type Payment) =>
65
65
  value = FirstPayment or value = SecondPayment
66
- end)
66
+ end for all)
67
67
  and
68
68
  (for all (value of type Authorization) =>
69
69
  value = FirstApproval or value = SecondApproval
70
- end)
71
- end
72
- end
70
+ end for all)
71
+ end definition
72
+ end law
73
73
 
74
74
  law "|an empty condition does not hide required coverage| is
75
75
  definition:
76
76
  (for all (authorization of type Authorization where false) =>
77
77
  false
78
- end)
78
+ end for all)
79
79
  and
80
80
  (there exists (authorization of type Authorization
81
81
  where active Ready authorization) such that
82
82
  authorizes authorization FirstPayment
83
- end)
84
- end
83
+ end exists)
84
+ end definition
85
85
 
86
86
  rationale:
87
87
  "A vacuous first clause leaves the approval requirement in force."
88
- end
89
- end
88
+ end rationale
89
+ end law
90
+ end unit
@@ -17,37 +17,38 @@ law doubles is
17
17
  definition:
18
18
  for all (value of type record{count of type Integer}) =>
19
19
  (double value).count must be value.count + value.count
20
- end
21
- end
20
+ end for all
21
+ end definition
22
22
 
23
23
  expect double value = expected
24
24
  in table (value, expected):
25
25
  row record{count = -1}, record{count = -2}
26
26
  row record{count = 0}, record{count = 0}
27
27
  row record{count = 1}, record{count = 2}
28
- end
29
- end
28
+ end table
29
+ end law
30
30
 
31
31
  law wraps is
32
32
  definition:
33
33
  (wrap true).wrapped must be true
34
- end
35
- end
34
+ end definition
35
+ end law
36
36
 
37
37
  law ordered is
38
38
  definition:
39
39
  record{a = 1, b = true} must be record{b = true, a = 1}
40
- end
41
- end
40
+ end definition
41
+ end law
42
42
 
43
43
  law nested is
44
44
  definition:
45
45
  record{inner = record{count = 4}}.inner.count must be 4
46
- end
47
- end
46
+ end definition
47
+ end law
48
48
 
49
49
  law empty is
50
50
  definition:
51
51
  record{} must be record{}
52
- end
53
- end
52
+ end definition
53
+ end law
54
+ end unit
@@ -7,21 +7,21 @@ end function
7
7
  law "|addition preserves the inputs| is
8
8
  description:
9
9
  "Adding two amounts gives their mathematical sum."
10
- end
10
+ end description
11
11
 
12
12
  definition:
13
13
  for all (a of type Integer) (b of type Integer) =>
14
14
  a `|adds the values| b must be a + b
15
- end
16
- end
15
+ end for all
16
+ end definition
17
17
 
18
18
  expect "|adds the values| a b = expected
19
19
  in table (a, b, expected):
20
20
  row -1, 1, 0
21
21
  row 0, 0, 0
22
22
  row 1, 2, 3
23
- end
24
- end
23
+ end table
24
+ end law
25
25
 
26
26
  type Picture is a record{
27
27
  fileName of type Text
@@ -54,3 +54,4 @@ function "|picture category| (width of type Nat) -> Text is
54
54
  otherwise "large"
55
55
  end case
56
56
  end function
57
+ end unit
@@ -5,9 +5,9 @@ unit example.abilities
5
5
  -- Gateway says so, and every law about it holds for every lawful handler:
6
6
  -- the native one written by hand, and each spec handler below.
7
7
 
8
- type Payment is | Approved cents :: Int32 | Declined end
9
- type Receipt is Receipt cents :: Int32 end
10
- type PaymentError is | Refused | TooLarge end
8
+ type Payment is one of | Approved of type Int32 | Declined end type
9
+ type Receipt is a record{ cents :: Int32} end type
10
+ type PaymentError is one of | Refused | TooLarge end type
11
11
 
12
12
  -- A payment gateway. Its laws are obligations on every handler.
13
13
  ability Gateway is
@@ -15,89 +15,91 @@ ability Gateway is
15
15
  capture :: Int32 -> Receipt
16
16
  fee :: Int32
17
17
  laws
18
- law `a receipt is for the amount captured` is
19
- definition is `for all` (cents :: Int32) . capture cents = Receipt cents end
20
- end
21
- law `an approval is for the amount asked` is
22
- definition is
23
- `for all` (cents :: Int32) .
24
- (match authorize cents with
25
- | Approved approved -> approved == cents
26
- | Declined -> true
27
- end) = true
28
- end
29
- end
30
- law `the fee is never negative` is
31
- definition is fee >= 0 end
32
- end
33
- end
18
+ law "|a receipt is for the amount captured| is
19
+ definition : for all (cents :: Int32) => capture cents = Receipt record{ cents = cents} end for all end definition
20
+ end law
21
+ law "|an approval is for the amount asked| is
22
+ definition :
23
+ for all (cents :: Int32) =>
24
+ (first matching case of authorize cents :
25
+ when Approved approved then approved = cents
26
+ when Declined then true
27
+ end case) = true end for all
28
+ end definition
29
+ end law
30
+ law "|the fee is never negative| is
31
+ definition : fee >= 0 end definition
32
+ end law
33
+ end laws
34
+ end ability
34
35
 
35
36
  -- A fake for tests: it approves small amounts.
36
37
  handler fakeGateway for Gateway is
37
- authorize cents is if cents <= 10000 then Approved cents else Declined end
38
- capture cents is Receipt cents end
39
- fee is 30 end
40
- end
38
+ operation authorize cents is if cents <= 10000 then Approved cents else Declined end if end operation
39
+ operation capture cents is Receipt record{ cents = cents} end operation
40
+ operation fee is 30 end operation
41
+ end handler
41
42
 
42
43
  -- A handler with state: it keeps every amount it captured.
43
44
  handler keepingGateway for Gateway with state captured :: List Int32 start [] is
44
- authorize cents is Approved cents end
45
- capture cents is ~captured := Cons cents captured; Receipt cents end
46
- fee is 0 end
47
- end
45
+ operation authorize cents is Approved cents end operation
46
+ operation capture cents is ~captured := Cons cents captured; Receipt record{ cents = cents} end operation
47
+ operation fee is 0 end operation
48
+ end handler
48
49
 
49
50
  -- A checked definition that uses Gateway. Its row, {Gateway}, is inferred.
50
- definition checkout (cents :: Int32) :: Bool is
51
- match authorize cents with
52
- | Approved amount -> (match capture amount with | Receipt paid -> paid == cents end)
53
- | Declined -> false
54
- end
55
- end
51
+ procedure checkout (cents :: Int32) -> Bool is
52
+ first matching case of authorize cents :
53
+ when Approved amount then (first matching case of capture amount : when Receipt record{ cents = paid} then paid = cents end case)
54
+ when Declined then false
55
+ end case
56
+ end procedure
56
57
 
57
58
  -- A native adapter that uses Gateway: it gets a handler as its first
58
59
  -- argument.
59
60
  charge :: Int32 -> Bool uses Gateway
60
61
 
61
62
  -- A definition that can fail says what it fails with.
62
- definition pay (cents :: Int32) :: Receipt uses Gateway fails with PaymentError is
63
+ procedure pay (cents :: Int32) -> Receipt uses Gateway fails with PaymentError is
63
64
  if cents > 100000 then raise TooLarge else
64
- match authorize cents with
65
- | Approved amount -> capture amount
66
- | Declined -> raise Refused
67
- end
68
- end
65
+ first matching case of authorize cents :
66
+ when Approved amount then capture amount
67
+ when Declined then raise Refused
68
+ end case end if
69
+ end procedure
69
70
 
70
71
  -- Counting calls is part of the claim, so the law names a recording
71
72
  -- handler. Which gateway it records is left to the harness: each lawful one.
72
- law `checkout captures once, and only when it succeeds` using recording Gateway is
73
- definition is
74
- `for all` (cents :: Int32) .
75
- (if checkout cents then calls of capture with (cents) == 1 else calls of capture == 0) = true
76
- end
77
- end
73
+ law "|checkout captures once, and only when it succeeds| using recording Gateway is
74
+ definition :
75
+ for all (cents :: Int32) =>
76
+ (if checkout cents then calls of capture with (cents) = 1 else calls of capture = 0 end if) = true end for all
77
+ end definition
78
+ end law
78
79
 
79
- law `charge captures once, and only when it succeeds` using recording Gateway is
80
- definition is
81
- `for all` (cents :: Int32) .
82
- (if charge cents then calls of capture with (cents) == 1 else calls of capture == 0) = true
83
- end
84
- end
80
+ law "|charge captures once, and only when it succeeds| using recording Gateway is
81
+ definition :
82
+ for all (cents :: Int32) =>
83
+ (if charge cents then calls of capture with (cents) = 1 else calls of capture = 0 end if) = true end for all
84
+ end definition
85
+ end law
85
86
 
86
87
  -- This law needs the fake's limit, so the fake is part of the claim.
87
- law `large payments fail` using fakeGateway is
88
- definition is
89
- `for all` (cents :: Int32 where cents > 100000) . prelude.attempt (pay cents) = Left TooLarge
90
- end
91
- end
88
+ law "|large payments fail| using fakeGateway is
89
+ definition :
90
+ for all (cents :: Int32 where cents > 100000) => prelude.attempt (pay cents) = Left TooLarge end for all
91
+ end definition
92
+ end law
92
93
 
93
- law `a declined payment is refused` using fakeGateway is
94
- definition is
95
- `for all` (cents :: Int32 where cents > 10000 && cents <= 100000) .
96
- prelude.attempt (pay cents) = Left Refused
97
- end
98
- end
94
+ law "|a declined payment is refused| using fakeGateway is
95
+ definition :
96
+ for all (cents :: Int32 where cents > 10000 && cents <= 100000) =>
97
+ prelude.attempt (pay cents) = Left Refused end for all
98
+ end definition
99
+ end law
99
100
 
100
101
  -- Without `using`, a law runs under each lawful handler in turn.
101
- law `the fee is small` is
102
- definition is fee <= 100 end
103
- end
102
+ law "|the fee is small| is
103
+ definition : fee <= 100 end definition
104
+ end law
105
+ end unit