@01.software/sdk 0.49.0 → 0.51.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 (74) hide show
  1. package/CHANGELOG.md +130 -1
  2. package/MIGRATION.md +56 -0
  3. package/README.md +215 -45
  4. package/dist/client.cjs +188 -137
  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 +188 -137
  9. package/dist/client.js.map +1 -1
  10. package/dist/{collection-client-XfGLPuTf.d.cts → collection-client-CWAeuzV4.d.cts} +6 -4
  11. package/dist/{collection-client-DnDt6EQz.d.ts → collection-client-hYvVfHIm.d.ts} +6 -4
  12. package/dist/{const-DCNV5Kq7.d.ts → const-D8LixhAJ.d.cts} +5 -5
  13. package/dist/{const-CBba4lDo.d.cts → const-JD8obaKg.d.ts} +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-CbKyoEzy.d.cts → index-B0Hjh3Ey.d.ts} +72 -10
  33. package/dist/{index-DUuIqUS8.d.ts → index-Bu0kCc6o.d.cts} +72 -10
  34. package/dist/index.cjs +320 -383
  35. package/dist/index.cjs.map +1 -1
  36. package/dist/index.d.cts +8 -66
  37. package/dist/index.d.ts +8 -66
  38. package/dist/index.js +320 -383
  39. package/dist/index.js.map +1 -1
  40. package/dist/{payload-types-MKbx5MuJ.d.cts → payload-types-BOsckg8B.d.cts} +263 -54
  41. package/dist/{payload-types-MKbx5MuJ.d.ts → payload-types-BOsckg8B.d.ts} +263 -54
  42. package/dist/query.cjs +94 -70
  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 +94 -70
  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 +404 -162
  51. package/dist/server.cjs.map +1 -1
  52. package/dist/server.d.cts +7 -7
  53. package/dist/server.d.ts +7 -7
  54. package/dist/server.js +404 -162
  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-L_nh-ED7.d.ts → types-5ZlcAFuU.d.ts} +2 -2
  61. package/dist/{types-BKr_2avj.d.cts → types-B14sEt1z.d.cts} +2 -2
  62. package/dist/{types-1UeOk1Uy.d.cts → types-Bj8j7VHU.d.ts} +79 -23
  63. package/dist/{types-Du4s5anw.d.ts → types-CM5qiR2k.d.cts} +79 -23
  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 +124 -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 +124 -80
  73. package/dist/webhook.js.map +1 -1
  74. package/package.json +23 -2
@@ -62,6 +62,7 @@ interface Config {
62
62
  'payment-event-inbox': PaymentEventInbox;
63
63
  'payment-refund-attempts': PaymentRefundAttempt;
64
64
  'portone-payment-interactions': PortonePaymentInteraction;
65
+ 'commerce-payment-webhook-routes': CommercePaymentWebhookRoute;
65
66
  'payment-kernel-external-integrations': PaymentKernelExternalIntegration;
66
67
  'payment-kernel-owner-identities': PaymentKernelOwnerIdentity;
67
68
  'payment-kernel-provider-connections': PaymentKernelProviderConnection;
@@ -297,6 +298,7 @@ interface Config {
297
298
  'payment-event-inbox': PaymentEventInboxSelect<false> | PaymentEventInboxSelect<true>;
298
299
  'payment-refund-attempts': PaymentRefundAttemptsSelect<false> | PaymentRefundAttemptsSelect<true>;
299
300
  'portone-payment-interactions': PortonePaymentInteractionsSelect<false> | PortonePaymentInteractionsSelect<true>;
301
+ 'commerce-payment-webhook-routes': CommercePaymentWebhookRoutesSelect<false> | CommercePaymentWebhookRoutesSelect<true>;
300
302
  'payment-kernel-external-integrations': PaymentKernelExternalIntegrationsSelect<false> | PaymentKernelExternalIntegrationsSelect<true>;
301
303
  'payment-kernel-owner-identities': PaymentKernelOwnerIdentitiesSelect<false> | PaymentKernelOwnerIdentitiesSelect<true>;
302
304
  'payment-kernel-provider-connections': PaymentKernelProviderConnectionsSelect<false> | PaymentKernelProviderConnectionsSelect<true>;
@@ -688,6 +690,15 @@ interface Tenant {
688
690
  origin: string;
689
691
  id?: string | null;
690
692
  }[] | null;
693
+ /**
694
+ * Managed from the dedicated Console developer-settings screen.
695
+ */
696
+ embeddedAdminApp?: {
697
+ enabled?: boolean | null;
698
+ label?: string | null;
699
+ origin?: string | null;
700
+ path?: string | null;
701
+ };
691
702
  /**
692
703
  * Workspace-wide email sender settings. Applies to every send, including commerce notifications and password resets.
693
704
  */
@@ -814,7 +825,7 @@ interface Tenant {
814
825
  deletedAt?: string | null;
815
826
  }
816
827
  /**
817
- * Manage Admin Panel users and permission details.
828
+ * Manage Console users and permission details.
818
829
  *
819
830
  * This interface was referenced by `Config`'s JSON-Schema
820
831
  * via the `definition` "users".
@@ -842,11 +853,11 @@ interface User {
842
853
  suspendedAt?: string | null;
843
854
  suspendedReason?: string | null;
844
855
  /**
845
- * Timezone used for admin UI and notifications, such as Asia/Seoul.
856
+ * Timezone used for Console UI and notifications, such as Asia/Seoul.
846
857
  */
847
858
  timezone?: string | null;
848
859
  /**
849
- * Admin UI language or locale code, such as ko or en.
860
+ * Console UI language or locale code, such as ko or en.
850
861
  */
851
862
  locale?: string | null;
852
863
  avatar?: (string | null) | Image;
@@ -1044,12 +1055,12 @@ interface CommerceNotificationIntent {
1044
1055
  * Stable key that prevents duplicate notification intents within a tenant.
1045
1056
  */
1046
1057
  dedupeKey: string;
1047
- event: 'orderPaid' | 'orderCanceled' | 'fulfillmentShipped' | 'orderDelivered' | 'returnRequested' | 'returnApproved' | 'returnRejected' | 'returnCanceled' | 'returnCompleted' | 'eventRegistrationConfirmed' | 'eventOccurrenceCanceled';
1058
+ event: 'orderPaid' | 'orderCanceled' | 'fulfillmentShipped' | 'orderDelivered' | 'returnRequested' | 'returnApproved' | 'returnRejected' | 'returnCanceled' | 'returnCompleted' | 'paymentReconciliationRequired' | 'paymentRefundRequiresAttention' | 'eventRegistrationConfirmed' | 'eventOccurrenceCanceled';
1048
1059
  status: 'queued' | 'processing' | 'sent' | 'failed' | 'canceled';
1049
1060
  /**
1050
- * Customer email address targeted by this notification.
1061
+ * Customer email target. Operator-only payment incident notifications leave this empty.
1051
1062
  */
1052
- recipientEmail: string;
1063
+ recipientEmail?: string | null;
1053
1064
  /**
1054
1065
  * Consent classification used by the send-time eligibility gate.
1055
1066
  */
@@ -1359,10 +1370,6 @@ interface Customer {
1359
1370
  customData?: {
1360
1371
  [k: string]: unknown;
1361
1372
  } | unknown[] | string | number | boolean | null;
1362
- /**
1363
- * Marks a minor customer. When enabled, guardian consent fields are managed as compliance evidence.
1364
- */
1365
- isMinor?: boolean | null;
1366
1373
  marketingConsent?: {
1367
1374
  email?: {
1368
1375
  state?: ('not_subscribed' | 'pending' | 'subscribed' | 'unsubscribed') | null;
@@ -1413,27 +1420,6 @@ interface Customer {
1413
1420
  unsubscribedAt?: string | null;
1414
1421
  };
1415
1422
  };
1416
- /**
1417
- * Guardian consent evidence for a minor customer. May contain guardian PII.
1418
- */
1419
- guardianConsent?: {
1420
- /**
1421
- * Whether guardian consent has been collected. Internal compliance marker for minor-customer handling.
1422
- */
1423
- hasGuardianConsent?: boolean | null;
1424
- /**
1425
- * Guardian name. Treat as guardian PII.
1426
- */
1427
- guardianName?: string | null;
1428
- /**
1429
- * Guardian phone number. Treat as guardian PII.
1430
- */
1431
- guardianPhone?: string | null;
1432
- /**
1433
- * Timestamp when guardian consent was recorded. Read-only audit evidence.
1434
- */
1435
- guardianConsentedAt?: string | null;
1436
- };
1437
1423
  acceptsTos?: boolean | null;
1438
1424
  tosVersion?: string | null;
1439
1425
  /**
@@ -3573,10 +3559,10 @@ interface PaymentSession {
3573
3559
  captureSequence?: number | null;
3574
3560
  providerObservedAt?: string | null;
3575
3561
  /**
3576
- * Immutable PortOne capture observation stored before local ledger finalization.
3562
+ * Immutable provider capture observation stored before local ledger finalization.
3577
3563
  */
3578
3564
  providerCaptureEvidence?: {
3579
- provider?: 'portone' | null;
3565
+ provider?: ('portone' | 'toss') | null;
3580
3566
  providerAccount?: (string | null) | CommercePaymentAccount;
3581
3567
  providerAccountKey?: string | null;
3582
3568
  environment?: ('test' | 'live') | null;
@@ -3586,7 +3572,7 @@ interface PaymentSession {
3586
3572
  currency?: string | null;
3587
3573
  observationId?: string | null;
3588
3574
  observedAt?: string | null;
3589
- verificationSource?: ('portone_authenticated_response' | 'portone_authoritative_lookup') | null;
3575
+ verificationSource?: ('portone_authenticated_response' | 'portone_authoritative_lookup' | 'toss_authenticated_response' | 'toss_authoritative_lookup') | null;
3590
3576
  };
3591
3577
  expiresAt?: string | null;
3592
3578
  captureInFlightAt?: string | null;
@@ -3633,12 +3619,12 @@ interface CommercePaymentAccount {
3633
3619
  markets: (string | Market)[];
3634
3620
  tossConfiguration?: {
3635
3621
  /**
3636
- * Toss client key. Must use the test_ / live_ prefix matching the registered environment.
3622
+ * Toss Widget client key. Must use the test_gck_ / live_gck_ prefix matching the registered environment.
3637
3623
  */
3638
3624
  clientKey: string;
3639
3625
  secretKey?: string | null;
3640
3626
  /**
3641
- * Encrypted on save and never shown again. Leave blank to keep the registered key.
3627
+ * Enter the test_gsk_ / live_gsk_ key matching the environment. It is encrypted on save and never shown again; leave blank to keep it.
3642
3628
  */
3643
3629
  secretKeyInput?: string | null;
3644
3630
  /**
@@ -3680,9 +3666,14 @@ interface CommercePaymentAccount {
3680
3666
  };
3681
3667
  };
3682
3668
  /**
3683
- * When enabled, this connection is eligible for new PaymentSessions.
3669
+ * Enabled only by the activation action after configuration attestation. Deactivation is always available.
3684
3670
  */
3685
3671
  isActive?: boolean | null;
3672
+ connectionReadinessState: 'pending' | 'configuration_attested' | 'pre_readiness_accepted';
3673
+ readinessCredentialVersion?: number | null;
3674
+ readinessConfigurationDigest?: string | null;
3675
+ readinessCheckedAt?: string | null;
3676
+ readinessReasonCode?: ('awaiting_verification' | 'configuration_changed' | 'credential_changed' | 'toss_configuration_attestation_v1' | 'toss_widget_render_failed_v1' | 'toss_provider_account_key_mismatch_v1' | 'portone_configuration_acknowledgement_v1' | 'pre_readiness_active_cutover') | null;
3686
3677
  credentialVersion?: number | null;
3687
3678
  credentialState: 'active' | 'archived_refundable' | 'revoked' | 'destruction_pending' | 'destroyed';
3688
3679
  rotatedAt?: string | null;
@@ -3756,6 +3747,15 @@ interface Event {
3756
3747
  */
3757
3748
  timezone?: string | null;
3758
3749
  isAllDay?: boolean | null;
3750
+ /**
3751
+ * Authoritative all-day start date (YYYY-MM-DD).
3752
+ */
3753
+ allDayStartDate?: string | null;
3754
+ /**
3755
+ * Authoritative exclusive all-day end date (YYYY-MM-DD).
3756
+ */
3757
+ allDayEndDateExclusive?: string | null;
3758
+ allDayAuthorityTimezone?: string | null;
3759
3759
  /**
3760
3760
  * Optional. Leave empty for a one-time event.
3761
3761
  */
@@ -3775,6 +3775,10 @@ interface Event {
3775
3775
  endMode?: ('never' | 'count' | 'until') | null;
3776
3776
  count?: number | null;
3777
3777
  until?: string | null;
3778
+ /**
3779
+ * Authoritative all-day recurrence end date. Enter YYYY-MM-DD.
3780
+ */
3781
+ untilDate?: string | null;
3778
3782
  /**
3779
3783
  * RFC 5545 RRULE string for advanced users. Use the repeat fields above for common schedules.
3780
3784
  */
@@ -3992,6 +3996,9 @@ interface EventOccurrence {
3992
3996
  */
3993
3997
  timezone?: string | null;
3994
3998
  isAllDay?: boolean | null;
3999
+ allDayStartDate?: string | null;
4000
+ allDayEndDateExclusive?: string | null;
4001
+ allDayAuthorityTimezone?: string | null;
3995
4002
  status?: ('scheduled' | 'canceled' | 'completed') | null;
3996
4003
  /**
3997
4004
  * Server-derived copy of whether the parent event is exposed to public reads. Follows the event status, visibility, and trashed state automatically.
@@ -4487,7 +4494,7 @@ interface PersonalAccessToken {
4487
4494
  lastUsedIp?: string | null;
4488
4495
  revokedAt?: string | null;
4489
4496
  /**
4490
- * User who revoked the PAT for audit traceability.
4497
+ * User who revoked the PAT. This is null for API-KEY-038 OIDC machine revocation, whose workflow receipt proves the audit actor.
4491
4498
  */
4492
4499
  revokedBy?: (string | null) | User;
4493
4500
  /**
@@ -4529,6 +4536,10 @@ interface AuditLog {
4529
4536
  interface WebhookEvent {
4530
4537
  id: string;
4531
4538
  tenant?: (string | null) | Tenant;
4539
+ /**
4540
+ * New runtime rows require tenant or global. Null marks legacy/old-runtime evidence during expand and is treated as unresolved like unknown.
4541
+ */
4542
+ ownershipScope?: ('tenant' | 'global' | 'unknown') | null;
4532
4543
  /**
4533
4544
  * Provider
4534
4545
  */
@@ -4583,6 +4594,26 @@ interface WebhookDelivery {
4583
4594
  * Operation that produced this delivery attempt.
4584
4595
  */
4585
4596
  operation?: string | null;
4597
+ /**
4598
+ * Semantic event type, recorded for commerce notification deliveries only. Example: commerce.notification. Empty for ordinary collection deliveries.
4599
+ */
4600
+ eventType?: string | null;
4601
+ /**
4602
+ * Commerce notification event, e.g. orderCanceled. A 2xx receiver response does not prove the receiver handled this event.
4603
+ */
4604
+ notificationEvent?: string | null;
4605
+ /**
4606
+ * Notification intent identifier. With the dedupe key it forms the semantic idempotency identity.
4607
+ */
4608
+ notificationIntentId?: string | null;
4609
+ /**
4610
+ * Notification dedupe key. Distinct from delivery id, which identifies the delivery attempt only.
4611
+ */
4612
+ notificationDedupeKey?: string | null;
4613
+ /**
4614
+ * Identifier of the source object that produced this delivery. Its collection is the collection field.
4615
+ */
4616
+ sourceId?: string | null;
4586
4617
  /**
4587
4618
  * Path that produced the delivery attempt.
4588
4619
  */
@@ -4652,13 +4683,13 @@ interface Webhook {
4652
4683
  */
4653
4684
  secretRotatedBy?: (string | null) | User;
4654
4685
  /**
4655
- * Collections to subscribe to. Leave empty to receive every supported collection event.
4686
+ * Collections to subscribe to. Leaving this empty is a wildcard for ordinary collection create/update events only; commerce notifications need an explicit row for their source collection (orders, fulfillments, returns).
4656
4687
  */
4657
4688
  subscriptions?: {
4658
4689
  /**
4659
- * Receives create/update events for this collection.
4690
+ * Receives create/update events for this collection, plus commerce notifications whose source is this collection.
4660
4691
  */
4661
- collection: 'tenant-metadata' | 'tenant-logos' | 'images' | 'products' | 'product-variants' | 'product-options' | 'product-option-values' | 'product-categories' | 'product-tags' | 'product-collections' | 'markets' | 'brands' | 'brand-logos' | 'orders' | 'order-items' | 'transactions' | 'fulfillment-orders' | 'fulfillment-order-items' | 'fulfillments' | 'fulfillment-items' | 'returns' | 'return-items' | 'carts' | 'cart-items' | 'discounts' | 'shipping-policies' | 'shipping-zones' | 'customers' | 'customer-profiles' | 'customer-addresses' | 'playlists' | 'playlist-categories' | 'playlist-tags' | 'tracks' | 'track-categories' | 'track-tags' | 'galleries' | 'gallery-items' | 'gallery-categories' | 'gallery-tags' | 'links' | 'link-categories' | 'link-tags' | 'forms' | 'form-submissions' | 'articles' | 'article-authors' | 'article-categories' | 'article-tags' | 'documents' | 'document-categories' | 'document-types' | 'canvases' | 'canvas-node-types' | 'canvas-edge-types' | 'canvas-categories' | 'canvas-tags' | 'videos' | 'video-categories' | 'video-tags' | 'live-streams' | 'posts' | 'comments' | 'reactions' | 'reaction-types' | 'bookmarks' | 'post-categories' | 'post-tags' | 'customer-profile-stats' | 'customer-profile-lists' | 'event-calendars' | 'events' | 'event-categories' | 'event-occurrences' | 'event-tags' | 'membership-plans' | 'membership-plan-prices' | 'canvas-nodes' | 'canvas-edges';
4692
+ collection: 'tenant-metadata' | 'tenant-logos' | 'images' | 'products' | 'product-variants' | 'product-options' | 'product-option-values' | 'product-categories' | 'product-tags' | 'product-collections' | 'markets' | 'brands' | 'brand-logos' | 'orders' | 'order-items' | 'transactions' | 'fulfillment-orders' | 'fulfillment-order-items' | 'fulfillments' | 'fulfillment-items' | 'returns' | 'return-items' | 'carts' | 'cart-items' | 'discounts' | 'shipping-policies' | 'shipping-zones' | 'customers' | 'customer-profiles' | 'customer-addresses' | 'playlists' | 'playlist-categories' | 'playlist-tags' | 'tracks' | 'track-categories' | 'track-tags' | 'galleries' | 'gallery-items' | 'gallery-categories' | 'gallery-tags' | 'links' | 'link-categories' | 'link-tags' | 'forms' | 'form-submissions' | 'articles' | 'article-authors' | 'article-categories' | 'article-tags' | 'documents' | 'document-categories' | 'document-types' | 'canvases' | 'canvas-node-types' | 'canvas-edge-types' | 'canvas-categories' | 'canvas-tags' | 'videos' | 'video-categories' | 'video-tags' | 'live-streams' | 'posts' | 'comments' | 'reactions' | 'reaction-types' | 'bookmarks' | 'post-categories' | 'post-tags' | 'customer-profile-stats' | 'customer-profile-lists' | 'event-calendars' | 'events' | 'event-categories' | 'event-occurrences' | 'event-tags' | 'membership-plans' | 'membership-plan-prices' | 'canvas-nodes' | 'canvas-edges' | 'payment-sessions' | 'payment-refund-attempts';
4662
4693
  id?: string | null;
4663
4694
  }[] | null;
4664
4695
  isActive?: boolean | null;
@@ -5701,10 +5732,10 @@ interface PaymentRefundAttempt {
5701
5732
  tenant?: (string | null) | Tenant;
5702
5733
  status: 'provider_pending' | 'provider_succeeded' | 'reconciliation_required' | 'local_committed' | 'failed';
5703
5734
  order: string | Order;
5704
- paymentSession: string | PaymentSession;
5735
+ paymentSession?: (string | null) | PaymentSession;
5705
5736
  paymentTransaction: string | Transaction;
5706
- providerAccount: string | CommercePaymentAccount;
5707
- credentialVersion: number;
5737
+ providerAccount?: (string | null) | CommercePaymentAccount;
5738
+ credentialVersion?: number | null;
5708
5739
  provider: string;
5709
5740
  environment: string;
5710
5741
  providerOrderId: string;
@@ -5728,6 +5759,94 @@ interface PaymentRefundAttempt {
5728
5759
  localRefundedAmount?: number | null;
5729
5760
  localCommittedAt?: string | null;
5730
5761
  lastErrorCode?: string | null;
5762
+ returnOperation?: {
5763
+ version: 2;
5764
+ requestFingerprint: string;
5765
+ envelope: {
5766
+ version: 1;
5767
+ tenantId: string;
5768
+ orderId: string;
5769
+ orderNumber: string;
5770
+ source: {
5771
+ kind: 'existing_return';
5772
+ returnId: string;
5773
+ } | {
5774
+ kind: 'direct_return';
5775
+ };
5776
+ payment: {
5777
+ paymentTransactionId: string;
5778
+ paymentSessionId: null | string;
5779
+ providerAccountId: null | string;
5780
+ credentialVersion: null | number;
5781
+ provider: 'toss' | 'portone';
5782
+ environment: 'test' | 'live' | 'legacy';
5783
+ providerOrderId: string;
5784
+ paymentKey: string;
5785
+ pgPaymentId: string;
5786
+ currency: string;
5787
+ };
5788
+ /**
5789
+ * @minItems 1
5790
+ * @maxItems 100
5791
+ */
5792
+ items: [
5793
+ {
5794
+ orderItemId: string;
5795
+ quantity: number;
5796
+ restockAction: 'return_to_stock' | 'discard';
5797
+ restockingFee: number;
5798
+ },
5799
+ ...{
5800
+ orderItemId: string;
5801
+ quantity: number;
5802
+ restockAction: 'return_to_stock' | 'discard';
5803
+ restockingFee: number;
5804
+ }[]
5805
+ ];
5806
+ lineRefundAmount: number;
5807
+ returnShippingFee: number;
5808
+ initialShippingRefundAmount: number;
5809
+ restockingFeeTotal: number;
5810
+ providerRefundAmount: number;
5811
+ metadata: {
5812
+ initialShippingRefundOverrideNote: null | string;
5813
+ reason: null | string;
5814
+ reasonDetail: null | string;
5815
+ refundReceiptUrl: null | string;
5816
+ };
5817
+ actorFingerprint: string;
5818
+ };
5819
+ } | null;
5820
+ returnFinalizationStatus: 'not_applicable' | 'pending' | 'succeeded';
5821
+ finalizedReturn?: (string | null) | Return;
5822
+ returnRefundTransaction?: (string | null) | Transaction;
5823
+ returnFinalizedAt?: string | null;
5824
+ returnLastErrorCode?: string | null;
5825
+ returnSuccessResponse?: {
5826
+ version: 1;
5827
+ body: {
5828
+ return: {
5829
+ id: string;
5830
+ status: 'completed';
5831
+ refundAmount: number;
5832
+ returnShippingFee: number;
5833
+ initialShippingRefundAmount: number;
5834
+ completedAt: string;
5835
+ };
5836
+ transaction: {
5837
+ id: string;
5838
+ type: 'refund';
5839
+ kind: 'refund';
5840
+ status: 'refunded';
5841
+ amount: number;
5842
+ providerEventId: string | null;
5843
+ };
5844
+ refundSeq: number;
5845
+ };
5846
+ } | null;
5847
+ returnResponseOutcome?: {
5848
+ [k: string]: unknown;
5849
+ } | unknown[] | string | number | boolean | null;
5731
5850
  updatedAt: string;
5732
5851
  createdAt: string;
5733
5852
  }
@@ -5774,6 +5893,45 @@ interface PortonePaymentInteraction {
5774
5893
  updatedAt: string;
5775
5894
  createdAt: string;
5776
5895
  }
5896
+ /**
5897
+ * This interface was referenced by `Config`'s JSON-Schema
5898
+ * via the `definition` "commerce-payment-webhook-routes".
5899
+ */
5900
+ interface CommercePaymentWebhookRoute {
5901
+ id: string;
5902
+ tenant?: (string | null) | Tenant;
5903
+ provider: 'portone';
5904
+ /**
5905
+ * PortOne storeId this route serves.
5906
+ */
5907
+ providerAccountKey: string;
5908
+ /**
5909
+ * Server-issued routing identifier for the PortOne console webhook URL path. Not an authentication token.
5910
+ */
5911
+ anchor: string;
5912
+ state: 'pending' | 'verified' | 'draining' | 'revoked';
5913
+ rotationReason: 'initial' | 'normal' | 'compromise';
5914
+ supersedesRoute?: (string | null) | CommercePaymentWebhookRoute;
5915
+ issuedAt?: string | null;
5916
+ verifiedAt?: string | null;
5917
+ testReadbackAttestedAt?: string | null;
5918
+ testLastSignedDeliveryAt?: string | null;
5919
+ liveReadbackAttestedAt?: string | null;
5920
+ liveLastSignedDeliveryAt?: string | null;
5921
+ storeKeyedLastSignedDeliveryAt?: string | null;
5922
+ drainStartedAt?: string | null;
5923
+ revokedAt?: string | null;
5924
+ /**
5925
+ * Webhook URL the operator read back from the PortOne console for that environment.
5926
+ */
5927
+ testReadbackUrl?: string | null;
5928
+ /**
5929
+ * Webhook URL the operator read back from the PortOne console for that environment.
5930
+ */
5931
+ liveReadbackUrl?: string | null;
5932
+ updatedAt: string;
5933
+ createdAt: string;
5934
+ }
5777
5935
  /**
5778
5936
  * This interface was referenced by `Config`'s JSON-Schema
5779
5937
  * via the `definition` "payment-kernel-external-integrations".
@@ -8386,7 +8544,7 @@ interface MembershipCharge {
8386
8544
  id: string;
8387
8545
  tenant?: (string | null) | Tenant;
8388
8546
  membership: string | CustomerMembership;
8389
- customer?: (string | null) | Customer;
8547
+ customer: string | Customer;
8390
8548
  amount: number;
8391
8549
  currency: 'KRW' | 'USD' | 'EUR' | 'JPY';
8392
8550
  status: 'pending' | 'paid' | 'failed' | 'refunded' | 'voided' | 'disputed';
@@ -8396,9 +8554,9 @@ interface MembershipCharge {
8396
8554
  pgRefundId?: string | null;
8397
8555
  pgProvider?: string | null;
8398
8556
  periodStart: string;
8399
- periodEnd?: string | null;
8557
+ periodEnd: string;
8400
8558
  paidAt?: string | null;
8401
- idempotencyKey?: string | null;
8559
+ idempotencyKey: string;
8402
8560
  updatedAt: string;
8403
8561
  createdAt: string;
8404
8562
  }
@@ -9017,6 +9175,7 @@ interface AuditLogsSelect<T extends boolean = true> {
9017
9175
  */
9018
9176
  interface WebhookEventsSelect<T extends boolean = true> {
9019
9177
  tenant?: T;
9178
+ ownershipScope?: T;
9020
9179
  provider?: T;
9021
9180
  eventId?: T;
9022
9181
  receivedAt?: T;
@@ -9038,6 +9197,11 @@ interface WebhookDeliveriesSelect<T extends boolean = true> {
9038
9197
  endpointUrlHash?: T;
9039
9198
  collection?: T;
9040
9199
  operation?: T;
9200
+ eventType?: T;
9201
+ notificationEvent?: T;
9202
+ notificationIntentId?: T;
9203
+ notificationDedupeKey?: T;
9204
+ sourceId?: T;
9041
9205
  source?: T;
9042
9206
  statusCode?: T;
9043
9207
  errorKind?: T;
@@ -9109,6 +9273,12 @@ interface TenantsSelect<T extends boolean = true> {
9109
9273
  origin?: T;
9110
9274
  id?: T;
9111
9275
  };
9276
+ embeddedAdminApp?: T | {
9277
+ enabled?: T;
9278
+ label?: T;
9279
+ origin?: T;
9280
+ path?: T;
9281
+ };
9112
9282
  senderIdentity?: T | {
9113
9283
  displayName?: T;
9114
9284
  replyTo?: T;
@@ -10526,6 +10696,14 @@ interface PaymentRefundAttemptsSelect<T extends boolean = true> {
10526
10696
  localRefundedAmount?: T;
10527
10697
  localCommittedAt?: T;
10528
10698
  lastErrorCode?: T;
10699
+ returnOperation?: T;
10700
+ returnFinalizationStatus?: T;
10701
+ finalizedReturn?: T;
10702
+ returnRefundTransaction?: T;
10703
+ returnFinalizedAt?: T;
10704
+ returnLastErrorCode?: T;
10705
+ returnSuccessResponse?: T;
10706
+ returnResponseOutcome?: T;
10529
10707
  updatedAt?: T;
10530
10708
  createdAt?: T;
10531
10709
  }
@@ -10568,6 +10746,32 @@ interface PortonePaymentInteractionsSelect<T extends boolean = true> {
10568
10746
  updatedAt?: T;
10569
10747
  createdAt?: T;
10570
10748
  }
10749
+ /**
10750
+ * This interface was referenced by `Config`'s JSON-Schema
10751
+ * via the `definition` "commerce-payment-webhook-routes_select".
10752
+ */
10753
+ interface CommercePaymentWebhookRoutesSelect<T extends boolean = true> {
10754
+ tenant?: T;
10755
+ provider?: T;
10756
+ providerAccountKey?: T;
10757
+ anchor?: T;
10758
+ state?: T;
10759
+ rotationReason?: T;
10760
+ supersedesRoute?: T;
10761
+ issuedAt?: T;
10762
+ verifiedAt?: T;
10763
+ testReadbackAttestedAt?: T;
10764
+ testLastSignedDeliveryAt?: T;
10765
+ liveReadbackAttestedAt?: T;
10766
+ liveLastSignedDeliveryAt?: T;
10767
+ storeKeyedLastSignedDeliveryAt?: T;
10768
+ drainStartedAt?: T;
10769
+ revokedAt?: T;
10770
+ testReadbackUrl?: T;
10771
+ liveReadbackUrl?: T;
10772
+ updatedAt?: T;
10773
+ createdAt?: T;
10774
+ }
10571
10775
  /**
10572
10776
  * This interface was referenced by `Config`'s JSON-Schema
10573
10777
  * via the `definition` "payment-kernel-external-integrations_select".
@@ -11157,7 +11361,6 @@ interface CustomersSelect<T extends boolean = true> {
11157
11361
  lastOrderAt?: T;
11158
11362
  profile?: T;
11159
11363
  customData?: T;
11160
- isMinor?: T;
11161
11364
  marketingConsent?: T | {
11162
11365
  email?: T | {
11163
11366
  state?: T;
@@ -11190,12 +11393,6 @@ interface CustomersSelect<T extends boolean = true> {
11190
11393
  unsubscribedAt?: T;
11191
11394
  };
11192
11395
  };
11193
- guardianConsent?: T | {
11194
- hasGuardianConsent?: T;
11195
- guardianName?: T;
11196
- guardianPhone?: T;
11197
- guardianConsentedAt?: T;
11198
- };
11199
11396
  acceptsTos?: T;
11200
11397
  tosVersion?: T;
11201
11398
  withdrawReason?: T;
@@ -12757,6 +12954,9 @@ interface EventsSelect<T extends boolean = true> {
12757
12954
  endsAt?: T;
12758
12955
  timezone?: T;
12759
12956
  isAllDay?: T;
12957
+ allDayStartDate?: T;
12958
+ allDayEndDateExclusive?: T;
12959
+ allDayAuthorityTimezone?: T;
12760
12960
  recurrence?: T | {
12761
12961
  frequency?: T;
12762
12962
  interval?: T;
@@ -12764,6 +12964,7 @@ interface EventsSelect<T extends boolean = true> {
12764
12964
  endMode?: T;
12765
12965
  count?: T;
12766
12966
  until?: T;
12967
+ untilDate?: T;
12767
12968
  rrule?: T;
12768
12969
  rdates?: T | {
12769
12970
  date?: T;
@@ -12904,6 +13105,9 @@ interface EventOccurrencesSelect<T extends boolean = true> {
12904
13105
  endsAt?: T;
12905
13106
  timezone?: T;
12906
13107
  isAllDay?: T;
13108
+ allDayStartDate?: T;
13109
+ allDayEndDateExclusive?: T;
13110
+ allDayAuthorityTimezone?: T;
12907
13111
  status?: T;
12908
13112
  parentPublic?: T;
12909
13113
  locationOverride?: T | {
@@ -13151,6 +13355,11 @@ interface CommercePaymentAccountsSelect<T extends boolean = true> {
13151
13355
  };
13152
13356
  };
13153
13357
  isActive?: T;
13358
+ connectionReadinessState?: T;
13359
+ readinessCredentialVersion?: T;
13360
+ readinessConfigurationDigest?: T;
13361
+ readinessCheckedAt?: T;
13362
+ readinessReasonCode?: T;
13154
13363
  credentialVersion?: T;
13155
13364
  credentialState?: T;
13156
13365
  rotatedAt?: T;