@kanorio/sdk 1.0.0 → 1.2.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 (81) hide show
  1. package/README.md +41 -2
  2. package/dist/customer-oauth.d.ts +21 -21
  3. package/dist/customer-oauth.js +12 -12
  4. package/dist/customer.d.ts +22 -22
  5. package/dist/customer.js +20 -11
  6. package/dist/delivery.d.ts +9 -9
  7. package/dist/delivery.js +6 -6
  8. package/dist/edge.d.ts +25 -21
  9. package/dist/edge.js +36 -20
  10. package/dist/forms.d.ts +33 -14
  11. package/dist/forms.js +20 -14
  12. package/dist/generated/delivery.d.ts +564 -13
  13. package/dist/generated/management.d.ts +790 -81
  14. package/dist/http.d.ts +13 -13
  15. package/dist/http.js +8 -8
  16. package/dist/image.d.ts +77 -0
  17. package/dist/image.js +78 -0
  18. package/dist/index.d.ts +2 -1
  19. package/dist/index.js +4 -3
  20. package/dist/locales.d.ts +22 -22
  21. package/dist/locales.js +12 -12
  22. package/dist/management.d.ts +5 -5
  23. package/dist/management.js +3 -3
  24. package/dist/next.d.ts +66 -0
  25. package/dist/next.js +58 -0
  26. package/dist/paginate.d.ts +3 -3
  27. package/dist/paginate.js +3 -3
  28. package/dist/preview.d.ts +13 -13
  29. package/dist/preview.js +11 -11
  30. package/dist/protection.d.ts +18 -18
  31. package/dist/protection.js +11 -11
  32. package/dist/revalidate.d.ts +22 -22
  33. package/dist/revalidate.js +14 -14
  34. package/dist/seo.d.ts +137 -21
  35. package/dist/seo.js +113 -21
  36. package/dist/server-key.d.ts +2 -2
  37. package/dist/server-key.js +2 -2
  38. package/dist/shared/api/delivery/cache-tags.d.ts +41 -39
  39. package/dist/shared/api/delivery/cache-tags.js +36 -34
  40. package/dist/shared/api/server-key.d.ts +32 -28
  41. package/dist/shared/api/server-key.js +41 -33
  42. package/dist/shared/business-registry/attribution.d.ts +5 -5
  43. package/dist/shared/business-registry/attribution.js +4 -4
  44. package/dist/shared/business-registry/define.d.ts +1 -1
  45. package/dist/shared/business-registry/define.js +1 -1
  46. package/dist/shared/business-registry/formats/eu-vat.js +4 -4
  47. package/dist/shared/business-registry/formats/hk-br.d.ts +2 -2
  48. package/dist/shared/business-registry/formats/hk-br.js +4 -4
  49. package/dist/shared/business-registry/formats/jp-trn.d.ts +3 -3
  50. package/dist/shared/business-registry/formats/jp-trn.js +4 -4
  51. package/dist/shared/business-registry/formats/kr-brn.d.ts +2 -2
  52. package/dist/shared/business-registry/formats/kr-brn.js +3 -3
  53. package/dist/shared/business-registry/formats/my.d.ts +3 -3
  54. package/dist/shared/business-registry/formats/my.js +4 -4
  55. package/dist/shared/business-registry/formats/sg-uen.js +4 -4
  56. package/dist/shared/business-registry/formats/tw-vat.d.ts +5 -5
  57. package/dist/shared/business-registry/formats/tw-vat.js +6 -6
  58. package/dist/shared/business-registry/index.js +1 -1
  59. package/dist/shared/business-registry/lookup-wire.d.ts +9 -9
  60. package/dist/shared/business-registry/lookup-wire.js +4 -4
  61. package/dist/shared/business-registry/normalize.d.ts +3 -3
  62. package/dist/shared/business-registry/normalize.js +4 -4
  63. package/dist/shared/business-registry/registry.d.ts +9 -9
  64. package/dist/shared/business-registry/registry.js +13 -13
  65. package/dist/shared/business-registry/types.d.ts +20 -20
  66. package/dist/shared/business-registry/types.js +6 -6
  67. package/dist/shared/localization/locale-path.d.ts +18 -18
  68. package/dist/shared/localization/locale-path.js +18 -18
  69. package/dist/shared/localization/request-locale.d.ts +16 -16
  70. package/dist/shared/localization/request-locale.js +13 -13
  71. package/dist/shared/seo/alternates.d.ts +26 -26
  72. package/dist/shared/seo/alternates.js +18 -18
  73. package/dist/shared/types/forms-logic.d.ts +28 -28
  74. package/dist/shared/types/forms-logic.js +27 -27
  75. package/dist/shared/types/number-input.d.ts +2 -2
  76. package/dist/shared/types/number-input.js +3 -3
  77. package/dist/shared/utils/redirect-matching.d.ts +33 -24
  78. package/dist/shared/utils/redirect-matching.js +73 -40
  79. package/dist/typed.d.ts +5 -5
  80. package/dist/typed.js +3 -3
  81. package/package.json +15 -10
@@ -130,7 +130,7 @@ export interface paths {
130
130
  path?: never;
131
131
  cookie?: never;
132
132
  };
133
- /** Collections and their fields (self-describing). System collections also list virtualFields (projection-only fields such as blog segments/toc/contentHtml and taxonomy counts) with scope item|fieldData and a TypeScript type literal. */
133
+ /** Collections and their fields (self-describing). System collections also list virtualFields (projection-only fields such as blog segments/toc/contentHtml and taxonomy counts) with scope item|fieldData|expanded and a TypeScript type literal; a field whose shape is fixed (the seo field of blog, categories, tags and authors) carries tsType, and a system field whose value needs explaining (the blog cover_image, which is derived and can be an asset id or a URL) carries tsDoc. */
134
134
  get: operations["delivery_collections_list"];
135
135
  put?: never;
136
136
  post?: never;
@@ -447,7 +447,10 @@ export interface paths {
447
447
  };
448
448
  get?: never;
449
449
  put?: never;
450
- /** Submit answers to an online form */
450
+ /**
451
+ * Submit answers to an online form
452
+ * @description A 200 means the submission was stored. A challenge (or third-party widget token) stores one submission: sending other answers with one that was already used returns 400 VERIFICATION_EXPIRED, while sending exactly the same submission again returns 200 and stores nothing twice. After a rejected submission (INVALID_ANSWERS, DUPLICATE_SUBMISSION, RATE_LIMITED, a server error) the solved built-in challenge can be sent again. A submission is processed no sooner than 5 seconds after its challenge was issued; one that arrives earlier is held until then. Marketing consent is recorded only when consent is sent with the consentTextId from GET /forms/{id}. Requests that no real form produces (a filled honeypot field, a forged protection result, a challenge issued for another form) also get 200 and are discarded.
453
+ */
451
454
  post: operations["delivery_form_submit"];
452
455
  delete?: never;
453
456
  options?: never;
@@ -578,6 +581,521 @@ export interface components {
578
581
  };
579
582
  /** @enum {string} */
580
583
  ErrorCode: "BAD_HOST" | "COLLECTION_NOT_FOUND" | "DUPLICATE_SUBMISSION" | "FILE_TOO_LARGE" | "FILE_TYPE_NOT_ALLOWED" | "FORBIDDEN" | "FORM_NOT_FOUND" | "HEADER_NOT_FOUND" | "INVALID_ANSWERS" | "INVALID_BODY" | "INVALID_CURSOR" | "INVALID_KIND" | "INVALID_LIMIT" | "INVALID_PATH" | "INVALID_QUERY" | "ITEM_NOT_FOUND" | "NOT_PREVIEW" | "PAGE_NOT_FOUND" | "PAYLOAD_TOO_LARGE" | "PRODUCT_NOT_FOUND" | "QUERY_REQUIRED" | "QUERY_TIMEOUT" | "QUERY_TOO_LONG" | "QUERY_TOO_SHORT" | "RATE_LIMITED" | "SEARCH_BUSY" | "SITE_NOT_FOUND" | "TOO_MANY_PARAMS" | "UNAUTHORIZED" | "UNIT_NOT_FOUND" | "UNKNOWN_BOT" | "UNSUPPORTED_LOCALE" | "UPLOAD_UNAVAILABLE" | "UPSTREAM_UNAVAILABLE" | "VALIDATION" | "VERIFICATION_EXPIRED";
584
+ Form: {
585
+ id: string;
586
+ name: string;
587
+ /** @description Text shown under the form name. */
588
+ description: string | null;
589
+ /**
590
+ * @description ACTIVE accepts answers (within settings.openAt, settings.closeAt and settings.maxSubmissions); ARCHIVED is paused. DRAFT forms are not returned.
591
+ * @enum {string}
592
+ */
593
+ status: "DRAFT" | "ACTIVE" | "ARCHIVED";
594
+ /** @description The questions, in display order. Each one is discriminated by `type`. */
595
+ fields: components["schemas"]["FormField"][];
596
+ settings: components["schemas"]["FormSettings"];
597
+ /** @description Submissions received so far, not counting spam; compare with settings.maxSubmissions. */
598
+ submissionCount: number;
599
+ /** @description Id of the consent text for the current settings.marketingConsent mode. Send it back unchanged as consentTextId on submit; consent is recorded only when it matches. Null when consent is off. */
600
+ consentTextId: string | null;
601
+ /** @description The consent text to show the visitor, in the requested locale: the owner's own wording, or the platform default with the site name and submit button text filled in. Null when consent is off. */
602
+ consentText?: string | null;
603
+ /** @description Where to send the visitor after a successful submit, with the locale prefix already added. Null when not set, and null when the address has answers filled in (settings.redirectUrl contains {answers.<id>} or {submissionId}): in that case use redirectUrl of the submit response. The submit response always carries the address to use, so prefer it. */
604
+ redirectUrl?: string | null;
605
+ /** @description ISO 3166-1 alpha-2 country used for a phone question that sets no default country; the server parses national numbers with the same value. */
606
+ defaultPhoneCountry?: string | null;
607
+ /** @description The site's IANA time zone. "From today" bounds of date questions are computed in it, on the server too. */
608
+ timezone?: string | null;
609
+ } & {
610
+ [key: string]: unknown;
611
+ };
612
+ /** @description One question. `type` decides the other keys; `visibleWhen` makes it conditional (evaluate with visibleFieldIds from @kanorio/sdk/forms). */
613
+ FormField: {
614
+ id: string;
615
+ label: string;
616
+ description?: string;
617
+ /** @default false */
618
+ required: boolean;
619
+ contactMapping?: "name" | "email" | "phone" | string;
620
+ visibleWhen?: {
621
+ /**
622
+ * @default all
623
+ * @enum {string}
624
+ */
625
+ match: "all" | "any";
626
+ conditions: {
627
+ /**
628
+ * @default field
629
+ * @enum {string}
630
+ */
631
+ kind: "field" | "hidden";
632
+ ref: string;
633
+ /** @enum {string} */
634
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
635
+ value?: string | number;
636
+ }[];
637
+ };
638
+ /** @constant */
639
+ type: "short_text";
640
+ minLength?: number;
641
+ maxLength?: number;
642
+ pattern?: string;
643
+ patternMessage?: string;
644
+ } | {
645
+ id: string;
646
+ label: string;
647
+ description?: string;
648
+ /** @default false */
649
+ required: boolean;
650
+ contactMapping?: "name" | "email" | "phone" | string;
651
+ visibleWhen?: {
652
+ /**
653
+ * @default all
654
+ * @enum {string}
655
+ */
656
+ match: "all" | "any";
657
+ conditions: {
658
+ /**
659
+ * @default field
660
+ * @enum {string}
661
+ */
662
+ kind: "field" | "hidden";
663
+ ref: string;
664
+ /** @enum {string} */
665
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
666
+ value?: string | number;
667
+ }[];
668
+ };
669
+ /** @constant */
670
+ type: "long_text";
671
+ minLength?: number;
672
+ maxLength?: number;
673
+ } | {
674
+ id: string;
675
+ label: string;
676
+ description?: string;
677
+ required: unknown;
678
+ /**
679
+ * @default email
680
+ * @constant
681
+ */
682
+ contactMapping: "email";
683
+ visibleWhen?: {
684
+ /**
685
+ * @default all
686
+ * @enum {string}
687
+ */
688
+ match: "all" | "any";
689
+ conditions: {
690
+ /**
691
+ * @default field
692
+ * @enum {string}
693
+ */
694
+ kind: "field" | "hidden";
695
+ ref: string;
696
+ /** @enum {string} */
697
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
698
+ value?: string | number;
699
+ }[];
700
+ };
701
+ /** @constant */
702
+ type: "email";
703
+ } | {
704
+ id: string;
705
+ label: string;
706
+ description?: string;
707
+ /** @default false */
708
+ required: boolean;
709
+ /**
710
+ * @default phone
711
+ * @constant
712
+ */
713
+ contactMapping: "phone";
714
+ visibleWhen?: {
715
+ /**
716
+ * @default all
717
+ * @enum {string}
718
+ */
719
+ match: "all" | "any";
720
+ conditions: {
721
+ /**
722
+ * @default field
723
+ * @enum {string}
724
+ */
725
+ kind: "field" | "hidden";
726
+ ref: string;
727
+ /** @enum {string} */
728
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
729
+ value?: string | number;
730
+ }[];
731
+ };
732
+ /** @constant */
733
+ type: "phone";
734
+ defaultCountry?: string;
735
+ } | {
736
+ id: string;
737
+ label: string;
738
+ description?: string;
739
+ /** @default false */
740
+ required: boolean;
741
+ contactMapping?: "name" | "email" | "phone" | string;
742
+ visibleWhen?: {
743
+ /**
744
+ * @default all
745
+ * @enum {string}
746
+ */
747
+ match: "all" | "any";
748
+ conditions: {
749
+ /**
750
+ * @default field
751
+ * @enum {string}
752
+ */
753
+ kind: "field" | "hidden";
754
+ ref: string;
755
+ /** @enum {string} */
756
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
757
+ value?: string | number;
758
+ }[];
759
+ };
760
+ /** @constant */
761
+ type: "choice";
762
+ options: {
763
+ id: string;
764
+ label: string;
765
+ }[];
766
+ /** @default false */
767
+ allowMultiple: boolean;
768
+ /** @default false */
769
+ allowOther: boolean;
770
+ /**
771
+ * @default list
772
+ * @enum {string}
773
+ */
774
+ display: "list" | "dropdown";
775
+ minSelections?: number;
776
+ maxSelections?: number;
777
+ } | {
778
+ id: string;
779
+ label: string;
780
+ description?: string;
781
+ /** @default false */
782
+ required: boolean;
783
+ contactMapping?: "name" | "email" | "phone" | string;
784
+ visibleWhen?: {
785
+ /**
786
+ * @default all
787
+ * @enum {string}
788
+ */
789
+ match: "all" | "any";
790
+ conditions: {
791
+ /**
792
+ * @default field
793
+ * @enum {string}
794
+ */
795
+ kind: "field" | "hidden";
796
+ ref: string;
797
+ /** @enum {string} */
798
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
799
+ value?: string | number;
800
+ }[];
801
+ };
802
+ /** @constant */
803
+ type: "date";
804
+ range?: {
805
+ min?: {
806
+ /** @constant */
807
+ type: "today";
808
+ /** @default 0 */
809
+ offsetDays: number;
810
+ } | {
811
+ /** @constant */
812
+ type: "date";
813
+ value: string;
814
+ };
815
+ max?: {
816
+ /** @constant */
817
+ type: "today";
818
+ /** @default 0 */
819
+ offsetDays: number;
820
+ } | {
821
+ /** @constant */
822
+ type: "date";
823
+ value: string;
824
+ };
825
+ };
826
+ } | {
827
+ id: string;
828
+ label: string;
829
+ description?: string;
830
+ /** @default false */
831
+ required: boolean;
832
+ contactMapping?: "name" | "email" | "phone" | string;
833
+ visibleWhen?: {
834
+ /**
835
+ * @default all
836
+ * @enum {string}
837
+ */
838
+ match: "all" | "any";
839
+ conditions: {
840
+ /**
841
+ * @default field
842
+ * @enum {string}
843
+ */
844
+ kind: "field" | "hidden";
845
+ ref: string;
846
+ /** @enum {string} */
847
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
848
+ value?: string | number;
849
+ }[];
850
+ };
851
+ /** @constant */
852
+ type: "time";
853
+ } | {
854
+ id: string;
855
+ label: string;
856
+ description?: string;
857
+ /** @default false */
858
+ required: boolean;
859
+ contactMapping?: "name" | "email" | "phone" | string;
860
+ visibleWhen?: {
861
+ /**
862
+ * @default all
863
+ * @enum {string}
864
+ */
865
+ match: "all" | "any";
866
+ conditions: {
867
+ /**
868
+ * @default field
869
+ * @enum {string}
870
+ */
871
+ kind: "field" | "hidden";
872
+ ref: string;
873
+ /** @enum {string} */
874
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
875
+ value?: string | number;
876
+ }[];
877
+ };
878
+ /** @constant */
879
+ type: "file";
880
+ /** @default 1 */
881
+ maxFiles: number;
882
+ /** @default [] */
883
+ accept: string[];
884
+ } | {
885
+ id: string;
886
+ label: string;
887
+ description?: string;
888
+ /** @default false */
889
+ required: boolean;
890
+ contactMapping?: "name" | "email" | "phone" | string;
891
+ visibleWhen?: {
892
+ /**
893
+ * @default all
894
+ * @enum {string}
895
+ */
896
+ match: "all" | "any";
897
+ conditions: {
898
+ /**
899
+ * @default field
900
+ * @enum {string}
901
+ */
902
+ kind: "field" | "hidden";
903
+ ref: string;
904
+ /** @enum {string} */
905
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
906
+ value?: string | number;
907
+ }[];
908
+ };
909
+ /** @constant */
910
+ type: "rating";
911
+ /** @default 5 */
912
+ max: number;
913
+ /**
914
+ * @default star
915
+ * @enum {string}
916
+ */
917
+ icon: "star" | "heart" | "thumb";
918
+ } | {
919
+ id: string;
920
+ label: string;
921
+ description?: string;
922
+ /** @default false */
923
+ required: boolean;
924
+ contactMapping?: "name" | "email" | "phone" | string;
925
+ visibleWhen?: {
926
+ /**
927
+ * @default all
928
+ * @enum {string}
929
+ */
930
+ match: "all" | "any";
931
+ conditions: {
932
+ /**
933
+ * @default field
934
+ * @enum {string}
935
+ */
936
+ kind: "field" | "hidden";
937
+ ref: string;
938
+ /** @enum {string} */
939
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
940
+ value?: string | number;
941
+ }[];
942
+ };
943
+ /** @constant */
944
+ type: "number";
945
+ min?: number;
946
+ max?: number;
947
+ /** @default false */
948
+ integer: boolean;
949
+ } | {
950
+ id: string;
951
+ label: string;
952
+ description?: string;
953
+ /** @default false */
954
+ required: boolean;
955
+ contactMapping?: "name" | "email" | "phone" | string;
956
+ visibleWhen?: {
957
+ /**
958
+ * @default all
959
+ * @enum {string}
960
+ */
961
+ match: "all" | "any";
962
+ conditions: {
963
+ /**
964
+ * @default field
965
+ * @enum {string}
966
+ */
967
+ kind: "field" | "hidden";
968
+ ref: string;
969
+ /** @enum {string} */
970
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
971
+ value?: string | number;
972
+ }[];
973
+ };
974
+ /** @constant */
975
+ type: "url";
976
+ } | {
977
+ id: string;
978
+ label: string;
979
+ description?: string;
980
+ /** @default false */
981
+ required: boolean;
982
+ /** @constant */
983
+ contactMapping?: "address";
984
+ visibleWhen?: {
985
+ /**
986
+ * @default all
987
+ * @enum {string}
988
+ */
989
+ match: "all" | "any";
990
+ conditions: {
991
+ /**
992
+ * @default field
993
+ * @enum {string}
994
+ */
995
+ kind: "field" | "hidden";
996
+ ref: string;
997
+ /** @enum {string} */
998
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
999
+ value?: string | number;
1000
+ }[];
1001
+ };
1002
+ /** @constant */
1003
+ type: "address";
1004
+ defaultCountry?: string;
1005
+ /** @default [] */
1006
+ countries: string[];
1007
+ /** @default false */
1008
+ askRecipientName: boolean;
1009
+ } | {
1010
+ id: string;
1011
+ label: string;
1012
+ description?: string;
1013
+ /** @default false */
1014
+ required: boolean;
1015
+ /** @constant */
1016
+ contactMapping?: "tax_identity";
1017
+ visibleWhen?: {
1018
+ /**
1019
+ * @default all
1020
+ * @enum {string}
1021
+ */
1022
+ match: "all" | "any";
1023
+ conditions: {
1024
+ /**
1025
+ * @default field
1026
+ * @enum {string}
1027
+ */
1028
+ kind: "field" | "hidden";
1029
+ ref: string;
1030
+ /** @enum {string} */
1031
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
1032
+ value?: string | number;
1033
+ }[];
1034
+ };
1035
+ /** @constant */
1036
+ type: "tax_id";
1037
+ defaultCountry?: string;
1038
+ /** @default [] */
1039
+ countries: string[];
1040
+ companyNameFieldId?: string;
1041
+ } | {
1042
+ id: string;
1043
+ /** @constant */
1044
+ type: "statement";
1045
+ label: string;
1046
+ description?: string;
1047
+ required: unknown;
1048
+ contactMapping?: unknown;
1049
+ visibleWhen?: {
1050
+ /**
1051
+ * @default all
1052
+ * @enum {string}
1053
+ */
1054
+ match: "all" | "any";
1055
+ conditions: {
1056
+ /**
1057
+ * @default field
1058
+ * @enum {string}
1059
+ */
1060
+ kind: "field" | "hidden";
1061
+ ref: string;
1062
+ /** @enum {string} */
1063
+ op: "answered" | "not_answered" | "includes" | "not_includes" | "equals" | "not_equals" | "contains" | "gt" | "gte" | "lt" | "lte";
1064
+ value?: string | number;
1065
+ }[];
1066
+ };
1067
+ };
1068
+ FormSettings: {
1069
+ submitLabel?: string;
1070
+ successMessage?: string;
1071
+ redirectUrl?: string;
1072
+ /**
1073
+ * @default off
1074
+ * @enum {string}
1075
+ */
1076
+ marketingConsent: "off" | "checkbox" | "submit";
1077
+ consentText?: {
1078
+ checkbox?: string;
1079
+ submit?: string;
1080
+ };
1081
+ /** @default false */
1082
+ limitOnePerContact: boolean;
1083
+ /** Format: date-time */
1084
+ openAt?: string;
1085
+ /** Format: date-time */
1086
+ closeAt?: string;
1087
+ maxSubmissions?: number;
1088
+ /**
1089
+ * @default general
1090
+ * @enum {string}
1091
+ */
1092
+ replyKind: "inquiry" | "booking" | "event" | "application" | "signup" | "feedback" | "general";
1093
+ /** @default [] */
1094
+ hiddenFields: {
1095
+ id: string;
1096
+ label?: string;
1097
+ }[];
1098
+ };
581
1099
  SiteLocale: {
582
1100
  /** @description BCP 47 locale code (`en-US`, `zh-Hant`); pass it (or `pathPrefix`) as `?locale=` */
583
1101
  locale: string;
@@ -879,10 +1397,40 @@ export interface components {
879
1397
  fileSize?: number | null;
880
1398
  kind?: string;
881
1399
  };
882
- ItemsPage: {
883
- data: {
1400
+ /** @description One collection item. System collections add fields of their own at this level (blog: segments, toc, contentHtml, plaintext); GET /collections lists them in virtualFields. */
1401
+ Item: {
1402
+ id: string;
1403
+ /** @description URL slug in the locale of the response */
1404
+ slug: string;
1405
+ /** @description Path of this item's page on the site, in the locale of the response (`/blog/hello`, or `/en/blog/hello` for a secondary locale). It is the address Kanorio lists in the sitemap, site search and JSON-LD, so link to it instead of building the URL from the slug. Present for blog posts, for categories, tags and authors whose listing page is served (see `listings` on /site), and for items of a custom collection that has a `pathTemplate` (primary locale only). Absent when the item has no page of its own. */
1406
+ path?: string;
1407
+ publishedAt: string | null;
1408
+ updatedAt: string;
1409
+ fieldData: {
884
1410
  [key: string]: unknown;
885
- }[];
1411
+ };
1412
+ /** @description References named in `expand`, keyed by field id */
1413
+ expanded?: {
1414
+ [key: string]: unknown;
1415
+ };
1416
+ access?: components["schemas"]["AccessSummary"];
1417
+ /** @description Multilingual sites: the locale this item was served in (the requested locale when a translation exists, otherwise the primary locale) */
1418
+ resolvedLocale?: string;
1419
+ /** @description Multilingual sites: secondary locales that have a published translation of this item */
1420
+ availableLocales?: string[];
1421
+ /** @description Multilingual sites: the slug in every live locale */
1422
+ localeSlugs?: {
1423
+ [key: string]: string;
1424
+ };
1425
+ /** @description Multilingual sites, system collections: `path` in every live locale, for hreflang and a language switcher */
1426
+ localePaths?: {
1427
+ [key: string]: string;
1428
+ };
1429
+ } & {
1430
+ [key: string]: unknown;
1431
+ };
1432
+ ItemsPage: {
1433
+ data: components["schemas"]["Item"][];
886
1434
  /** @description True when another page exists; pass nextCursor to fetch it. */
887
1435
  hasMore: boolean;
888
1436
  /** @description Cursor for the next page, or null on the last page. */
@@ -1493,9 +2041,7 @@ export interface operations {
1493
2041
  };
1494
2042
  content: {
1495
2043
  "application/json": {
1496
- item: {
1497
- [key: string]: unknown;
1498
- };
2044
+ item: components["schemas"]["Item"];
1499
2045
  assets: {
1500
2046
  [key: string]: components["schemas"]["Asset"];
1501
2047
  };
@@ -1875,9 +2421,7 @@ export interface operations {
1875
2421
  };
1876
2422
  content: {
1877
2423
  "application/json": {
1878
- form: {
1879
- [key: string]: unknown;
1880
- };
2424
+ form: components["schemas"]["Form"];
1881
2425
  };
1882
2426
  };
1883
2427
  };
@@ -2116,7 +2660,7 @@ export interface operations {
2116
2660
  * @enum {string}
2117
2661
  */
2118
2662
  consent?: "checked" | "submit_statement";
2119
- /** @description Id of the consent text the visitor saw (from GET /forms/{id}). */
2663
+ /** @description Id of the consent text the visitor saw (consentTextId from GET /forms/{id}, whose consentText is the text to show). Required for consent to be recorded: without it, or when it no longer matches the form's current text, the submission is stored without consent. */
2120
2664
  consentTextId?: string;
2121
2665
  locale?: string;
2122
2666
  /** @description Path of the page the form was on, for the submission record. */
@@ -2146,8 +2690,15 @@ export interface operations {
2146
2690
  };
2147
2691
  content: {
2148
2692
  "application/json": {
2149
- /** @enum {string} */
2693
+ /**
2694
+ * @description Present when the form did not take the submission because of its own state. Nothing was saved.
2695
+ * @enum {string}
2696
+ */
2150
2697
  state?: "closed" | "not_open" | "full";
2698
+ /** @description Id of this submission. Absent when state is present. */
2699
+ submissionId?: string;
2700
+ /** @description Where to send the visitor now, when the form has a redirect after submit: a path on the site (with the locale prefix of the page the form was on) or an https URL, which can be on another site. Answers and the submission id are already filled in and percent-encoded. Absent when the form has no redirect. */
2701
+ redirectUrl?: string;
2151
2702
  };
2152
2703
  };
2153
2704
  };