You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit d7ce98c
Browse filesBrowse the repository at this point in the historyBrowse files
testdata: a case per response enum, carrying a value no list holds
The shared corpus gains a vocabulary section: an answer per response enum
(the plan's tier, a database's standing, license type and format, a
download's outcome and format) carrying a value no published list holds,
plus the plan's name. A binding reads it back as served once it hands such a
value back rather than failing the call.
Copy file name to clipboardExpand all lines: testdata/testdata.json
+225Lines changed: 225 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -13794,6 +13794,231 @@
13794
13794
]
13795
13795
}
13796
13796
},
13797
+
"vocabulary": {
13798
+
"why": "A closed vocabulary in an ANSWER (a plan's tier, a database's standing and license type, a format, a download's outcome) is the API's to extend. Each case serves a well-formed answer carrying a value no published list holds, and the call must hand that value back as served, a raw string or an unknown case that carries it, and never fail: a binding that refuses it breaks every installed copy of itself the day the API adds a value, and a release cannot reach the copies already installed. A wrong TYPE (a number, a null where the member is required) is still refused, and refusing an unpublished value in a REQUEST before the network is unchanged. Each `expect` key is a path through the answer's wire names, a number indexing a list; each suite reads it through its own typed result. A binding that still fails the call on one reads none of these cases until its release that hands the value back.",
13799
+
"cases": [
13800
+
{
13801
+
"name": "entitlement-plan-name",
13802
+
"why": "The plan's name is what a client shows, and key is what it compares: the free plan's key is free and its name Unlimited. A binding that drops name leaves a client building one from the key, which a renamed plan then gets wrong.",
13803
+
"call": "myEntitlement",
13804
+
"answer": {
13805
+
"org_id": "85bb51e4-2eb6-4a31-8e4d-02ba8b98fe61",
13806
+
"apikey": {
13807
+
"id": "0ab424cc-7619-4dad-b027-afacdc2cedb0",
13808
+
"expires": null,
13809
+
"allowed_cidrs": []
13810
+
},
13811
+
"plan": {
13812
+
"key": "free",
13813
+
"name": "Unlimited",
13814
+
"tier": "free"
13815
+
},
13816
+
"usage": {
13817
+
"requests": 580,
13818
+
"quota": 5000000,
13819
+
"hard_limit": null,
13820
+
"window_start": "2026-11-01T00:00:00Z",
13821
+
"window_end": "2026-12-01T00:00:00Z"
13822
+
}
13823
+
},
13824
+
"expect": {
13825
+
"plan.key": "free",
13826
+
"plan.name": "Unlimited",
13827
+
"plan.tier": "free"
13828
+
}
13829
+
},
13830
+
{
13831
+
"name": "entitlement-tier-unknown",
13832
+
"why": "A plan whose tier no published list holds: the answer reads, and the tier comes back as served.",
13833
+
"call": "myEntitlement",
13834
+
"answer": {
13835
+
"org_id": "85bb51e4-2eb6-4a31-8e4d-02ba8b98fe61",
13836
+
"apikey": {
13837
+
"id": "0ab424cc-7619-4dad-b027-afacdc2cedb0",
13838
+
"expires": null,
13839
+
"allowed_cidrs": []
13840
+
},
13841
+
"plan": {
13842
+
"key": "data",
13843
+
"name": "Data",
13844
+
"tier": "data"
13845
+
},
13846
+
"usage": {
13847
+
"requests": 580,
13848
+
"quota": 5000000,
13849
+
"hard_limit": null,
13850
+
"window_start": "2026-11-01T00:00:00Z",
13851
+
"window_end": "2026-12-01T00:00:00Z"
13852
+
}
13853
+
},
13854
+
"expect": {
13855
+
"plan.key": "data",
13856
+
"plan.name": "Data",
13857
+
"plan.tier": "data"
13858
+
}
13859
+
},
13860
+
{
13861
+
"name": "database-standing-unknown",
13862
+
"why": "A database whose standing no published list holds: the catalog reads, and the standing comes back as served.",
13863
+
"call": "listDatabases",
13864
+
"answer": {
13865
+
"databases": [
13866
+
{
13867
+
"base": "bogon_asn",
13868
+
"name": "Bogon ASN",
13869
+
"summary": "Every reserved or unallocated AS number.",
13870
+
"standing": "suspended",
13871
+
"open": true,
13872
+
"license_type": "standard",
13873
+
"starts": "2026-01-01T00:00:00Z",
13874
+
"expires": null,
13875
+
"renews_at": null,
13876
+
"notice_due_at": null,
13877
+
"versions": [
13878
+
{
13879
+
"id": "bogon_asn_v1",
13880
+
"version": 1,
13881
+
"summary": "The ASN and its reason.",
13882
+
"formats": [
13883
+
"csvgz",
13884
+
"mmdb"
13885
+
]
13886
+
}
13887
+
]
13888
+
}
13889
+
]
13890
+
},
13891
+
"expect": {
13892
+
"databases.0.base": "bogon_asn",
13893
+
"databases.0.standing": "suspended"
13894
+
}
13895
+
},
13896
+
{
13897
+
"name": "database-license-type-unknown",
13898
+
"why": "A license type no published list holds: the catalog reads, and the license type comes back as served.",
13899
+
"call": "listDatabases",
13900
+
"answer": {
13901
+
"databases": [
13902
+
{
13903
+
"base": "bogon_asn",
13904
+
"name": "Bogon ASN",
13905
+
"summary": "Every reserved or unallocated AS number.",
13906
+
"standing": "licensed",
13907
+
"open": true,
13908
+
"license_type": "oem",
13909
+
"starts": "2026-01-01T00:00:00Z",
13910
+
"expires": null,
13911
+
"renews_at": null,
13912
+
"notice_due_at": null,
13913
+
"versions": [
13914
+
{
13915
+
"id": "bogon_asn_v1",
13916
+
"version": 1,
13917
+
"summary": "The ASN and its reason.",
13918
+
"formats": [
13919
+
"csvgz",
13920
+
"mmdb"
13921
+
]
13922
+
}
13923
+
]
13924
+
}
13925
+
]
13926
+
},
13927
+
"expect": {
13928
+
"databases.0.base": "bogon_asn",
13929
+
"databases.0.license_type": "oem"
13930
+
}
13931
+
},
13932
+
{
13933
+
"name": "database-format-unknown",
13934
+
"why": "A version offered in a format no published list holds: the catalog reads, and the format comes back as served beside the known one. Asking for it is still refused before the network.",
13935
+
"call": "listDatabases",
13936
+
"answer": {
13937
+
"databases": [
13938
+
{
13939
+
"base": "bogon_asn",
13940
+
"name": "Bogon ASN",
13941
+
"summary": "Every reserved or unallocated AS number.",
13942
+
"standing": "licensed",
13943
+
"open": true,
13944
+
"license_type": "standard",
13945
+
"starts": "2026-01-01T00:00:00Z",
13946
+
"expires": null,
13947
+
"renews_at": null,
13948
+
"notice_due_at": null,
13949
+
"versions": [
13950
+
{
13951
+
"id": "bogon_asn_v1",
13952
+
"version": 1,
13953
+
"summary": "The ASN and its reason.",
13954
+
"formats": [
13955
+
"csvgz",
13956
+
"parquet"
13957
+
]
13958
+
}
13959
+
]
13960
+
}
13961
+
]
13962
+
},
13963
+
"expect": {
13964
+
"databases.0.versions.0.formats.0": "csvgz",
13965
+
"databases.0.versions.0.formats.1": "parquet"
13966
+
}
13967
+
},
13968
+
{
13969
+
"name": "download-outcome-unknown",
13970
+
"why": "A download whose outcome no published list holds: the log reads, and the outcome comes back as served.",
13971
+
"call": "listDownloads",
13972
+
"answer": {
13973
+
"downloads": [
13974
+
{
13975
+
"dataset_id": "bogon_asn_v1",
13976
+
"format": "csvgz",
13977
+
"outcome": "throttled",
13978
+
"sample": false,
13979
+
"open": true,
13980
+
"bytes": null,
13981
+
"http_status": 429,
13982
+
"apikey_id": null,
13983
+
"client_ip": null,
13984
+
"user_agent": null,
13985
+
"created": "2026-11-17T10:00:00Z"
13986
+
}
13987
+
]
13988
+
},
13989
+
"expect": {
13990
+
"downloads.0.dataset_id": "bogon_asn_v1",
13991
+
"downloads.0.outcome": "throttled"
13992
+
}
13993
+
},
13994
+
{
13995
+
"name": "download-format-unknown",
13996
+
"why": "A download in a format no published list holds: the log reads, and the format comes back as served.",
0 commit comments