@hyperscale0/adl 1.0.258 → 1.0.284
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/CHANGELOG.md +17 -0
- package/README.md +1 -1
- package/SECURITY.md +2 -2
- package/docs/authoring-guide.md +20 -11
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,22 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## Since 1.0.123
|
|
4
|
+
|
|
5
|
+
Releases after 1.0.123 shipped without per-release entries. This entry
|
|
6
|
+
summarises what changed in the package surface since then.
|
|
7
|
+
|
|
8
|
+
Added:
|
|
9
|
+
|
|
10
|
+
- `ProviderAdapter.onboarding` declares whether a provider onboards a `person`,
|
|
11
|
+
an `organization` or both. The registry refuses an empty, unknown or repeated
|
|
12
|
+
kind.
|
|
13
|
+
- `conformance/insurance-policy-adapter.ts`, a quote and issuance example with a
|
|
14
|
+
custom vocabulary.
|
|
15
|
+
|
|
16
|
+
Changed:
|
|
17
|
+
|
|
18
|
+
- `BoundaryInstruction.currency` accepts SAR only.
|
|
19
|
+
|
|
3
20
|
## 1.0.123
|
|
4
21
|
|
|
5
22
|
First unified release. Every public Hyperscale package now ships under one
|
package/README.md
CHANGED
|
@@ -44,7 +44,7 @@ bun run conformance -- ./src/boundary-fixture.ts
|
|
|
44
44
|
|
|
45
45
|
## Versioning
|
|
46
46
|
|
|
47
|
-
|
|
47
|
+
Every public Hyperscale package ships under one version that follows the platform release number, so release N is 1.0.N. Removing a value from a vocabulary in `src/vocabulary.ts` breaks existing declarations and is called out in [CHANGELOG.md](CHANGELOG.md).
|
|
48
48
|
|
|
49
49
|
## License and security
|
|
50
50
|
|
package/SECURITY.md
CHANGED
|
@@ -14,8 +14,8 @@ you have. A declaration that triggers the bug is ideal, with every locator
|
|
|
14
14
|
value removed.
|
|
15
15
|
|
|
16
16
|
We acknowledge reports within three working days and tell you what we intend
|
|
17
|
-
to do. Fixes ship
|
|
18
|
-
|
|
17
|
+
to do. Fixes ship in the newest published `1.0.N` release; older releases get
|
|
18
|
+
no backports.
|
|
19
19
|
|
|
20
20
|
## Scope
|
|
21
21
|
|
package/docs/authoring-guide.md
CHANGED
|
@@ -16,35 +16,44 @@ the bound quote. An accepted request without issuance evidence remains pending.
|
|
|
16
16
|
The fixture does not rate a policy, collect premium or register a live engine
|
|
17
17
|
adapter.
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
`
|
|
22
|
-
|
|
19
|
+
`createProviderAdapterRegistry` validates declarations when they load and throws
|
|
20
|
+
on the first error. It checks the provider key, a unique provider and capability
|
|
21
|
+
pair, `onboarding` as `person`, `organization` or both, each operation map key
|
|
22
|
+
against its binding's `operation`, a nonblank `resourceIdPath`, and subject
|
|
23
|
+
requirements against the UDL object field schema. Subject requirements describe
|
|
24
|
+
required authored fields or attachments; they never supply an account or choose
|
|
25
|
+
a party.
|
|
23
26
|
|
|
24
27
|
The [boundary adapter](https://github.com/hyperscale0/hyperscale-adl/blob/main/src/boundary-fixture.ts) declares one boundary
|
|
25
28
|
observation operation with no subject requirements. The
|
|
26
29
|
[subject fixture](../conformance/subject-adapter.ts) shows required subject fields.
|
|
27
30
|
|
|
28
31
|
`adapterConformanceFindings` checks the declaration without contacting a
|
|
29
|
-
provider.
|
|
32
|
+
provider and returns findings instead of throwing. Only it checks that every
|
|
33
|
+
operation's `resourceKind` appears in `bindings`, and that the operation map is
|
|
34
|
+
not empty. It reports a registry refusal as `declaration_invalid`.
|
|
30
35
|
|
|
31
36
|
## Dispatch an instruction
|
|
32
37
|
|
|
33
38
|
`BoundaryInstruction` binds an immutable ID to the environment, tenant, Product,
|
|
34
|
-
retained
|
|
35
|
-
|
|
36
|
-
|
|
39
|
+
retained `productBuildId` and `buildDigest`, target (`kind`, `attachment`,
|
|
40
|
+
`instanceId`), `sourceAccountId`, `destinationAccountId`, positive minor-unit
|
|
41
|
+
`amount`, `currency` and selected `adapter`. The runtime reserves before dispatch.
|
|
42
|
+
An adapter receives the instruction unchanged and cannot choose parties,
|
|
43
|
+
accounts or a replacement binding.
|
|
37
44
|
|
|
38
45
|
`BoundaryAdapter.dispatch` and `BoundaryAdapter.observe` return a
|
|
39
46
|
`BoundaryObservation` or `undefined`. The observation names the adapter,
|
|
40
|
-
|
|
47
|
+
`instructionId`, stable `externalReference`, explicit `outcome` and ISO `observedAt`.
|
|
48
|
+
`BoundaryAdapter.id` identifies the adapter. Observation identity is the pair of
|
|
49
|
+
adapter and external reference; reuse with different contents refuses.
|
|
41
50
|
Its outcome is `acknowledged`, `unknown`, `confirmed` or `rejected`.
|
|
42
51
|
|
|
43
52
|
An acknowledgement or missing result leaves the reservation held. HTTP status
|
|
44
53
|
never supplies a terminal outcome. Only a matching `confirmed` observation can
|
|
45
54
|
authorize posting; an explicit `rejected` observation can authorize voiding.
|
|
46
|
-
|
|
47
|
-
|
|
55
|
+
Observations remain immutable. Storage is separate from consumption; the runtime
|
|
56
|
+
claims settlement evidence once. There is no distributed provider/ledger transaction.
|
|
48
57
|
|
|
49
58
|
## Check the declaration
|
|
50
59
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hyperscale0/adl",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.284",
|
|
4
4
|
"description": "The Adapter Declaration Language: generic evidence, provider declarations and conformance.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"adl",
|
|
@@ -63,7 +63,7 @@
|
|
|
63
63
|
"typecheck": "tsc -p tsconfig.json"
|
|
64
64
|
},
|
|
65
65
|
"dependencies": {
|
|
66
|
-
"@hyperscale0/udl": "1.0.
|
|
66
|
+
"@hyperscale0/udl": "1.0.284",
|
|
67
67
|
"zod": "4.6.5"
|
|
68
68
|
},
|
|
69
69
|
"devDependencies": {
|
|
@@ -76,5 +76,5 @@
|
|
|
76
76
|
"Amir Ayub",
|
|
77
77
|
"Sara AlBakaawi"
|
|
78
78
|
],
|
|
79
|
-
"gitHead": "
|
|
79
|
+
"gitHead": "f4101f194e0e7c24997b0625ab1d48bec1255508"
|
|
80
80
|
}
|