@01.software/sdk 0.49.0 → 0.56.1

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 (74) hide show
  1. package/CHANGELOG.md +257 -1
  2. package/MIGRATION.md +56 -0
  3. package/README.md +269 -56
  4. package/dist/client.cjs +608 -190
  5. package/dist/client.cjs.map +1 -1
  6. package/dist/client.d.cts +6 -6
  7. package/dist/client.d.ts +6 -6
  8. package/dist/client.js +608 -190
  9. package/dist/client.js.map +1 -1
  10. package/dist/{collection-client-DnDt6EQz.d.ts → collection-client-Bmr53saa.d.ts} +6 -4
  11. package/dist/{collection-client-XfGLPuTf.d.cts → collection-client-DxuBDso_.d.cts} +6 -4
  12. package/dist/{const-CBba4lDo.d.cts → const-BKUqg96Q.d.ts} +5 -5
  13. package/dist/{const-DCNV5Kq7.d.ts → const-Cv1DCsp6.d.cts} +5 -5
  14. package/dist/embedded-admin/server.cjs +306 -0
  15. package/dist/embedded-admin/server.cjs.map +1 -0
  16. package/dist/embedded-admin/server.d.cts +33 -0
  17. package/dist/embedded-admin/server.d.ts +33 -0
  18. package/dist/embedded-admin/server.js +288 -0
  19. package/dist/embedded-admin/server.js.map +1 -0
  20. package/dist/embedded-admin.cjs +400 -0
  21. package/dist/embedded-admin.cjs.map +1 -0
  22. package/dist/embedded-admin.d.cts +61 -0
  23. package/dist/embedded-admin.d.ts +61 -0
  24. package/dist/embedded-admin.js +377 -0
  25. package/dist/embedded-admin.js.map +1 -0
  26. package/dist/errors.cjs +1 -0
  27. package/dist/errors.cjs.map +1 -1
  28. package/dist/errors.d.cts +3 -3
  29. package/dist/errors.d.ts +3 -3
  30. package/dist/errors.js +1 -0
  31. package/dist/errors.js.map +1 -1
  32. package/dist/{index-DUuIqUS8.d.ts → index-CGsT4AQ8.d.cts} +89 -10
  33. package/dist/{index-CbKyoEzy.d.cts → index-DFHLLqYu.d.ts} +89 -10
  34. package/dist/index.cjs +752 -436
  35. package/dist/index.cjs.map +1 -1
  36. package/dist/index.d.cts +12 -69
  37. package/dist/index.d.ts +12 -69
  38. package/dist/index.js +752 -436
  39. package/dist/index.js.map +1 -1
  40. package/dist/{payload-types-MKbx5MuJ.d.cts → payload-types-Bk-duc5k.d.cts} +545 -141
  41. package/dist/{payload-types-MKbx5MuJ.d.ts → payload-types-Bk-duc5k.d.ts} +545 -141
  42. package/dist/query.cjs +108 -71
  43. package/dist/query.cjs.map +1 -1
  44. package/dist/query.d.cts +5 -5
  45. package/dist/query.d.ts +5 -5
  46. package/dist/query.js +108 -71
  47. package/dist/query.js.map +1 -1
  48. package/dist/realtime.d.cts +2 -2
  49. package/dist/realtime.d.ts +2 -2
  50. package/dist/server.cjs +502 -175
  51. package/dist/server.cjs.map +1 -1
  52. package/dist/server.d.cts +9 -8
  53. package/dist/server.d.ts +9 -8
  54. package/dist/server.js +502 -175
  55. package/dist/server.js.map +1 -1
  56. package/dist/storefront-cache.cjs +1 -0
  57. package/dist/storefront-cache.cjs.map +1 -1
  58. package/dist/storefront-cache.js +1 -0
  59. package/dist/storefront-cache.js.map +1 -1
  60. package/dist/{types-1UeOk1Uy.d.cts → types-CEK8uTvU.d.ts} +287 -30
  61. package/dist/{types-BKr_2avj.d.cts → types-CNdpj2fI.d.cts} +2 -2
  62. package/dist/{types-L_nh-ED7.d.ts → types-D4mjGFj4.d.ts} +2 -2
  63. package/dist/{types-Du4s5anw.d.ts → types-Dhk5NX7Z.d.cts} +287 -30
  64. package/dist/ui/form.d.cts +1 -1
  65. package/dist/ui/form.d.ts +1 -1
  66. package/dist/ui/video.d.cts +1 -1
  67. package/dist/ui/video.d.ts +1 -1
  68. package/dist/webhook.cjs +135 -80
  69. package/dist/webhook.cjs.map +1 -1
  70. package/dist/webhook.d.cts +21 -5
  71. package/dist/webhook.d.ts +21 -5
  72. package/dist/webhook.js +135 -80
  73. package/dist/webhook.js.map +1 -1
  74. package/package.json +28 -6
package/dist/query.cjs CHANGED
@@ -598,6 +598,7 @@ var COMMERCE_ERROR_CODES = [
598
598
  "payment_session_not_cancelable",
599
599
  "payment_session_conflict",
600
600
  "provider_identity_mismatch",
601
+ "managed_refund_attestation_forbidden",
601
602
  "payment_method_unavailable",
602
603
  "provider_unavailable",
603
604
  "lock_timeout",
@@ -834,6 +835,10 @@ var operation = (collection, method, path, errorFamily) => Object.freeze({
834
835
  ...errorFamily && { errorFamily }
835
836
  });
836
837
  var strictCommerceOperation = (collection, method, path) => operation(collection, method, path, "commerce");
838
+ var selectiveCommerceOperation = (collection, method, path, typedCommerceErrorReasons) => Object.freeze({
839
+ ...operation(collection, method, path),
840
+ typedCommerceErrorReasons: Object.freeze([...typedCommerceErrorReasons])
841
+ });
837
842
  var COMMERCE_ENDPOINT_OPERATIONS = {
838
843
  products: {
839
844
  detail: operation("products", "get", "/detail"),
@@ -865,7 +870,12 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
865
870
  confirmPayment: operation("orders", "post", "/confirm-payment"),
866
871
  byPayment: operation("orders", "get", "/by-payment"),
867
872
  cancel: operation("orders", "post", "/cancel"),
868
- resolveCancelRefund: operation("orders", "post", "/resolve-cancel-refund"),
873
+ resolveCancelRefund: selectiveCommerceOperation(
874
+ "orders",
875
+ "post",
876
+ "/resolve-cancel-refund",
877
+ ["managed_refund_attestation_forbidden"]
878
+ ),
869
879
  checkout: strictCommerceOperation("orders", "post", "/checkout"),
870
880
  createFulfillment: operation("orders", "post", "/create-fulfillment"),
871
881
  updateFulfillment: operation("orders", "post", "/update-fulfillment")
@@ -874,6 +884,11 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
874
884
  detail: strictCommerceOperation("checkouts", "post", "/detail"),
875
885
  query: strictCommerceOperation("checkouts", "post", "/query")
876
886
  },
887
+ draftOrders: {
888
+ calculate: operation("draft-orders", "post", "/:id/calculate"),
889
+ complete: operation("draft-orders", "post", "/:id/complete"),
890
+ finalize: operation("draft-orders", "post", "/:id/finalize")
891
+ },
877
892
  transactions: {
878
893
  update: operation("transactions", "post", "/update")
879
894
  },
@@ -936,6 +951,16 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
936
951
  "payment-sessions",
937
952
  "post",
938
953
  "/server/confirm"
954
+ ),
955
+ findPortOne: strictCommerceOperation(
956
+ "payment-sessions",
957
+ "post",
958
+ "/server/portone/find"
959
+ ),
960
+ reconcilePortOne: strictCommerceOperation(
961
+ "payment-sessions",
962
+ "post",
963
+ "/server/portone/reconcile"
939
964
  )
940
965
  },
941
966
  custom: {
@@ -955,12 +980,34 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
955
980
  validate: operation("discounts", "post", "/validate")
956
981
  }
957
982
  };
983
+ var portOneStandardActionCapabilityOperations = /* @__PURE__ */ new Set([
984
+ COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.create,
985
+ COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.retrieve,
986
+ COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.create,
987
+ COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.retrieve
988
+ ]);
958
989
  var MEMBERSHIP_ENDPOINT_OPERATIONS = {
959
990
  subscribe: operation(null, "post", "/memberships/subscribe"),
960
991
  cancel: operation(null, "post", "/memberships/:id/cancel"),
961
- me: operation(null, "get", "/memberships/me")
992
+ me: operation(null, "get", "/memberships/me"),
993
+ chargeResult: operation(null, "post", "/memberships/:id/charge-result"),
994
+ refundResult: operation(null, "post", "/memberships/:id/refund-result"),
995
+ revoke: operation(null, "post", "/memberships/:id/revoke")
996
+ };
997
+ var CUSTOMER_GROUP_ENDPOINT_OPERATIONS = {
998
+ members: operation("customer-groups", "get", "/:id/members"),
999
+ grant: operation("customer-groups", "post", "/:id/members/grant"),
1000
+ revoke: operation("customer-groups", "post", "/:id/members/revoke")
1001
+ };
1002
+ var EMBEDDED_ADMIN_ENDPOINT_OPERATIONS = {
1003
+ show: operation("tenants", "get", "/embedded-admin-app"),
1004
+ configure: operation("tenants", "patch", "/embedded-admin-app"),
1005
+ disable: operation("tenants", "delete", "/embedded-admin-app")
962
1006
  };
963
1007
  var EVENTS_ENDPOINT_OPERATIONS = {
1008
+ events: {
1009
+ convertSchedule: operation("events", "post", "/:id/schedule")
1010
+ },
964
1011
  occurrences: {
965
1012
  range: operation("event-occurrences", "get", "/range"),
966
1013
  admissionAvailability: operation(
@@ -998,40 +1045,48 @@ function resolveOperationPath(descriptor, options) {
998
1045
  }
999
1046
 
1000
1047
  // src/core/api/endpoints.ts
1001
- var endpoint = (method, path) => ({ method, path });
1002
1048
  var sharedEndpoint = (descriptor) => descriptor;
1003
- function resolveOperationPath2(descriptor, options) {
1004
- if ("collection" in descriptor) {
1005
- return resolveOperationPath(descriptor, options);
1006
- }
1007
- const query = options?.query?.toString().replace(/^\?/, "");
1008
- return query ? `${descriptor.path}?${query}` : descriptor.path;
1009
- }
1010
1049
  var COMMERCE_ENDPOINTS = {
1011
1050
  products: {
1012
- detail: endpoint("GET", "/api/products/detail"),
1013
- detailCatalog: endpoint("GET", "/api/products/detail/catalog"),
1014
- listingGroups: endpoint("GET", "/api/products/listing-groups"),
1015
- listingGroupsCatalog: endpoint(
1016
- "GET",
1017
- "/api/products/listing-groups/catalog"
1051
+ detail: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.products.detail),
1052
+ detailCatalog: sharedEndpoint(
1053
+ COMMERCE_ENDPOINT_OPERATIONS.products.detailCatalog
1054
+ ),
1055
+ listingGroups: sharedEndpoint(
1056
+ COMMERCE_ENDPOINT_OPERATIONS.products.listingGroups
1018
1057
  ),
1019
- listingGroupsQuery: endpoint("GET", "/api/products/listing-groups/query"),
1020
- listingGroupsQueryCatalog: endpoint(
1021
- "GET",
1022
- "/api/products/listing-groups/query/catalog"
1058
+ listingGroupsCatalog: sharedEndpoint(
1059
+ COMMERCE_ENDPOINT_OPERATIONS.products.listingGroupsCatalog
1023
1060
  ),
1024
- stockCheck: endpoint("POST", "/api/products/stock-check"),
1025
- stockSnapshot: endpoint("GET", "/api/products/stock"),
1026
- upsert: endpoint("POST", "/api/products/upsert")
1061
+ // The manifest keeps the GET read and the POST body-query apart; this
1062
+ // semantic name has always resolved to the GET one.
1063
+ listingGroupsQuery: sharedEndpoint(
1064
+ COMMERCE_ENDPOINT_OPERATIONS.products.listingGroupsQueryGet
1065
+ ),
1066
+ listingGroupsQueryCatalog: sharedEndpoint(
1067
+ COMMERCE_ENDPOINT_OPERATIONS.products.listingGroupsQueryCatalog
1068
+ ),
1069
+ stockCheck: sharedEndpoint(
1070
+ COMMERCE_ENDPOINT_OPERATIONS.products.stockCheck
1071
+ ),
1072
+ stockSnapshot: sharedEndpoint(
1073
+ COMMERCE_ENDPOINT_OPERATIONS.products.stockSnapshot
1074
+ ),
1075
+ upsert: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.products.upsert)
1027
1076
  },
1028
1077
  orders: {
1029
- update: endpoint("POST", "/api/orders/update"),
1030
- byPayment: endpoint("GET", "/api/orders/by-payment"),
1031
- cancel: endpoint("POST", "/api/orders/cancel"),
1032
- resolveCancelRefund: endpoint("POST", "/api/orders/resolve-cancel-refund"),
1033
- createFulfillment: endpoint("POST", "/api/orders/create-fulfillment"),
1034
- updateFulfillment: endpoint("POST", "/api/orders/update-fulfillment")
1078
+ update: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.update),
1079
+ byPayment: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.byPayment),
1080
+ cancel: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.cancel),
1081
+ resolveCancelRefund: sharedEndpoint(
1082
+ COMMERCE_ENDPOINT_OPERATIONS.orders.resolveCancelRefund
1083
+ ),
1084
+ createFulfillment: sharedEndpoint(
1085
+ COMMERCE_ENDPOINT_OPERATIONS.orders.createFulfillment
1086
+ ),
1087
+ updateFulfillment: sharedEndpoint(
1088
+ COMMERCE_ENDPOINT_OPERATIONS.orders.updateFulfillment
1089
+ )
1035
1090
  },
1036
1091
  checkouts: {
1037
1092
  create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.checkout),
@@ -1043,18 +1098,21 @@ var COMMERCE_ENDPOINTS = {
1043
1098
  }
1044
1099
  },
1045
1100
  returns: {
1046
- create: endpoint("POST", "/api/returns/create"),
1047
- update: endpoint("POST", "/api/returns/update"),
1048
- returnRefund: endpoint("POST", "/api/returns/return-refund")
1101
+ create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.returns.create),
1102
+ update: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.returns.update),
1103
+ returnRefund: sharedEndpoint(
1104
+ COMMERCE_ENDPOINT_OPERATIONS.returns.returnRefund
1105
+ )
1049
1106
  },
1050
1107
  fulfillmentOrders: {
1051
- prepare: endpoint(
1052
- "POST",
1053
- "/api/fulfillment-orders/prepare-fulfillment-order"
1108
+ prepare: sharedEndpoint(
1109
+ COMMERCE_ENDPOINT_OPERATIONS.fulfillmentOrders.prepare
1054
1110
  )
1055
1111
  },
1056
1112
  fulfillments: {
1057
- bulkImport: endpoint("POST", "/api/fulfillments/bulk-import")
1113
+ bulkImport: sharedEndpoint(
1114
+ COMMERCE_ENDPOINT_OPERATIONS.fulfillments.bulkImport
1115
+ )
1058
1116
  },
1059
1117
  carts: {
1060
1118
  create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.create),
@@ -1119,57 +1177,36 @@ var COMMERCE_ENDPOINTS = {
1119
1177
  ),
1120
1178
  confirm: sharedEndpoint(
1121
1179
  COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.confirm
1180
+ ),
1181
+ findPortOne: sharedEndpoint(
1182
+ COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.findPortOne
1183
+ ),
1184
+ reconcilePortOne: sharedEndpoint(
1185
+ COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.reconcilePortOne
1122
1186
  )
1123
1187
  }
1124
1188
  },
1125
1189
  shippingPolicies: {
1126
- calculate: endpoint("POST", "/api/shipping-policies/calculate")
1190
+ calculate: sharedEndpoint(
1191
+ COMMERCE_ENDPOINT_OPERATIONS.shippingPolicies.calculate
1192
+ )
1127
1193
  }
1128
1194
  };
1129
- function isCommerceEndpointDescriptor(value) {
1130
- if (!value || typeof value !== "object") return false;
1131
- const candidate = value;
1132
- return typeof candidate.method === "string" && typeof candidate.path === "string";
1133
- }
1134
- function flattenEndpointPaths(value) {
1135
- if (isCommerceEndpointDescriptor(value)) return [resolveOperationPath2(value)];
1136
- if (!value || typeof value !== "object") return [];
1137
- return Object.values(value).flatMap((entry) => flattenEndpointPaths(entry));
1138
- }
1139
- function flattenEndpointDescriptors(value) {
1140
- if (isCommerceEndpointDescriptor(value)) return [value];
1141
- if (!value || typeof value !== "object") return [];
1142
- return Object.values(value).flatMap(
1143
- (entry) => flattenEndpointDescriptors(entry)
1144
- );
1145
- }
1146
- var COMMERCE_ENDPOINT_PATHS = flattenEndpointPaths(COMMERCE_ENDPOINTS);
1147
- var COMMERCE_ENDPOINT_DESCRIPTORS = flattenEndpointDescriptors(COMMERCE_ENDPOINTS);
1148
- var MEMBERSHIP_ENDPOINTS = {
1149
- subscribe: "/api/memberships/subscribe",
1150
- cancel: (id) => `/api/memberships/${id}/cancel`,
1151
- me: "/api/memberships/me"
1152
- };
1153
- var MEMBERSHIP_ENDPOINT_PATHS = [
1154
- MEMBERSHIP_ENDPOINTS.subscribe,
1155
- MEMBERSHIP_ENDPOINTS.cancel(":id"),
1156
- MEMBERSHIP_ENDPOINTS.me
1157
- ];
1158
1195
 
1159
1196
  // src/core/query/query-hooks.ts
1160
1197
  function normalizeMarket(market) {
1161
1198
  const normalized = market?.trim();
1162
1199
  return normalized || void 0;
1163
1200
  }
1164
- function requestCommerceFindEndpoint(collectionClient, endpoint2, options) {
1165
- const path = resolveOperationPath2(endpoint2, { query: options?.query });
1166
- if (endpoint2.method === "get") {
1201
+ function requestCommerceFindEndpoint(collectionClient, endpoint, options) {
1202
+ const path = resolveOperationPath(endpoint, { query: options?.query });
1203
+ if (endpoint.method === "get") {
1167
1204
  return collectionClient.requestFindEndpointGet(path);
1168
1205
  }
1169
- if (endpoint2.method === "post") {
1206
+ if (endpoint.method === "post") {
1170
1207
  return collectionClient.requestFindEndpoint(path, options?.data);
1171
1208
  }
1172
- throw new TypeError(`Unsupported find endpoint method: ${endpoint2.method}`);
1209
+ throw new TypeError(`Unsupported find endpoint method: ${endpoint.method}`);
1173
1210
  }
1174
1211
  function withDefaultMarket(params, market) {
1175
1212
  const defaultMarket = normalizeMarket(market);