@onkernel/sdk 0.139.0 → 0.141.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 (59) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/package.json +1 -1
  3. package/resources/browsers/browsers.d.mts +6 -5
  4. package/resources/browsers/browsers.d.mts.map +1 -1
  5. package/resources/browsers/browsers.d.ts +6 -5
  6. package/resources/browsers/browsers.d.ts.map +1 -1
  7. package/resources/browsers/browsers.js.map +1 -1
  8. package/resources/browsers/browsers.mjs.map +1 -1
  9. package/resources/browsers/webmcp/webmcp.d.mts +10 -6
  10. package/resources/browsers/webmcp/webmcp.d.mts.map +1 -1
  11. package/resources/browsers/webmcp/webmcp.d.ts +10 -6
  12. package/resources/browsers/webmcp/webmcp.d.ts.map +1 -1
  13. package/resources/browsers/webmcp/webmcp.js +7 -3
  14. package/resources/browsers/webmcp/webmcp.js.map +1 -1
  15. package/resources/browsers/webmcp/webmcp.mjs +7 -3
  16. package/resources/browsers/webmcp/webmcp.mjs.map +1 -1
  17. package/resources/search/providers.d.mts +1 -1
  18. package/resources/search/providers.d.mts.map +1 -1
  19. package/resources/search/providers.d.ts +1 -1
  20. package/resources/search/providers.d.ts.map +1 -1
  21. package/resources/search/search.d.mts +1 -124
  22. package/resources/search/search.d.mts.map +1 -1
  23. package/resources/search/search.d.ts +1 -124
  24. package/resources/search/search.d.ts.map +1 -1
  25. package/resources/search/search.js.map +1 -1
  26. package/resources/search/search.mjs.map +1 -1
  27. package/resources/vault-provider-configs.d.mts +59 -2
  28. package/resources/vault-provider-configs.d.mts.map +1 -1
  29. package/resources/vault-provider-configs.d.ts +59 -2
  30. package/resources/vault-provider-configs.d.ts.map +1 -1
  31. package/resources/vaults/index.d.mts +1 -1
  32. package/resources/vaults/index.d.mts.map +1 -1
  33. package/resources/vaults/index.d.ts +1 -1
  34. package/resources/vaults/index.d.ts.map +1 -1
  35. package/resources/vaults/index.js.map +1 -1
  36. package/resources/vaults/index.mjs.map +1 -1
  37. package/resources/vaults/items.d.mts +287 -42
  38. package/resources/vaults/items.d.mts.map +1 -1
  39. package/resources/vaults/items.d.ts +287 -42
  40. package/resources/vaults/items.d.ts.map +1 -1
  41. package/resources/vaults/vaults.d.mts +2 -2
  42. package/resources/vaults/vaults.d.mts.map +1 -1
  43. package/resources/vaults/vaults.d.ts +2 -2
  44. package/resources/vaults/vaults.d.ts.map +1 -1
  45. package/resources/vaults/vaults.js.map +1 -1
  46. package/resources/vaults/vaults.mjs.map +1 -1
  47. package/src/resources/browsers/browsers.ts +6 -5
  48. package/src/resources/browsers/webmcp/webmcp.ts +10 -6
  49. package/src/resources/search/providers.ts +1 -11
  50. package/src/resources/search/search.ts +1 -156
  51. package/src/resources/vault-provider-configs.ts +76 -2
  52. package/src/resources/vaults/index.ts +7 -0
  53. package/src/resources/vaults/items.ts +341 -33
  54. package/src/resources/vaults/vaults.ts +14 -0
  55. package/src/version.ts +1 -1
  56. package/version.d.mts +1 -1
  57. package/version.d.ts +1 -1
  58. package/version.js +1 -1
  59. package/version.mjs +1 -1
@@ -424,7 +424,8 @@ export type CardVaultItemSpec =
424
424
  | CardVaultItemSpec.LinkCardVaultItemSpec
425
425
  | CardVaultItemSpec.AgentCardCardVaultItemSpec
426
426
  | KernelCardVaultItemSpec
427
- | ShopPayCardVaultItemSpec;
427
+ | ShopPayCardVaultItemSpec
428
+ | VgsCardVaultItemSpec;
428
429
 
429
430
  export namespace CardVaultItemSpec {
430
431
  /**
@@ -608,7 +609,8 @@ export type CardVaultItemState =
608
609
  | CardVaultItemState.LinkCardState
609
610
  | CardVaultItemState.AgentCardCardState
610
611
  | KernelCardState
611
- | ShopPayCardState;
612
+ | ShopPayCardState
613
+ | VgsCardState;
612
614
 
613
615
  export namespace CardVaultItemState {
614
616
  /**
@@ -863,6 +865,7 @@ export namespace CredentialAccountVaultItem {
863
865
  | '1pw_fill'
864
866
  | '1pw_recover'
865
867
  | '1pw_update_access_token'
868
+ | 'update_access_token'
866
869
  | 'webmcp_invoke'
867
870
  | 'add_payment_method'
868
871
  | 'remove_payment_method';
@@ -1243,6 +1246,7 @@ export namespace CredentialVaultItem {
1243
1246
  | '1pw_fill'
1244
1247
  | '1pw_recover'
1245
1248
  | '1pw_update_access_token'
1249
+ | 'update_access_token'
1246
1250
  | 'webmcp_invoke'
1247
1251
  | 'add_payment_method'
1248
1252
  | 'remove_payment_method';
@@ -1471,17 +1475,26 @@ export interface FillVaultItemOperationResult {
1471
1475
  }
1472
1476
 
1473
1477
  /**
1474
- * A ready Kernel card supports authorize, fill, then submit checkout. Card details
1475
- * are delivered for a few minutes after fill; submit promptly. Repeated fill is
1476
- * safe and never submits checkout. Visa purchases require a spend_approval action
1477
- * before details are issued; Mastercard purchases need no hosted approval.
1478
- * masks.last4 is the enrolled card's last four digits; masks.token_last4, when
1479
- * present, is the token's last four digits shown to the merchant. Kernel does not
1480
- * observe whether the merchant charged the card.
1478
+ * A ready Kernel card funded by a payment method supports authorize, fill, then
1479
+ * submit checkout. A single-use card (source single_use_card) is ready on
1480
+ * creation, supports only fill, and is expired from expires_at; Kernel deletes its
1481
+ * stored details shortly after expires_at. It has no payment_method_id or
1482
+ * funding_status. Card details are delivered for a few minutes after fill; submit
1483
+ * promptly. Repeated fill is safe and never submits checkout. Visa purchases
1484
+ * require a spend_approval action before details are issued; Mastercard purchases
1485
+ * need no hosted approval. masks.last4 is the enrolled card's last four digits;
1486
+ * masks.token_last4, when present, is the token's last four digits shown to the
1487
+ * merchant. Kernel does not observe whether the merchant charged the card.
1481
1488
  */
1482
1489
  export interface KernelCardState {
1483
1490
  provider: 'kernel';
1484
1491
 
1492
+ /**
1493
+ * payment_method for a purchase funded by a wallet payment method; single_use_card
1494
+ * for a card whose details were supplied with single_use_card.
1495
+ */
1496
+ source: 'payment_method' | 'single_use_card';
1497
+
1485
1498
  /**
1486
1499
  * pending_authorization waits for cardholder approval on Visa purchases or fresh
1487
1500
  * security-code collection on alias-mode purchases through the spend_approval
@@ -1511,7 +1524,9 @@ export interface KernelCardState {
1511
1524
  | 'recovery_required';
1512
1525
 
1513
1526
  /**
1514
- * Informational registrable domain. Fill is locked to merchant_url's exact origin.
1527
+ * Informational registrable domain. Fill is locked to merchant_url's exact origin,
1528
+ * except that a single-use card fills on any https page of this registrable
1529
+ * domain.
1515
1530
  */
1516
1531
  domains?: Array<string>;
1517
1532
 
@@ -1568,7 +1583,18 @@ export namespace KernelCardState {
1568
1583
  * after collection. An expired card requires a new purchase. Fill types those
1569
1584
  * details on merchant_url's origin. The amount, merchant_url and merchant_country
1570
1585
  * are recorded but do not restrict payment requests sent by the browser. Card
1571
- * updates are not supported; delete and create a new item instead.
1586
+ * updates are not supported; delete and create a new item instead. With
1587
+ * single_use_card the item is instead a single-use card whose details the caller
1588
+ * supplies, such as a virtual card from its issuer. It is not funded by a payment
1589
+ * method, is ready on creation, and supports only fill: Kernel stores the details
1590
+ * encrypted, never returns them, and fills them on any https page whose
1591
+ * registrable domain (state.domains) is merchant_url's, including its subdomains.
1592
+ * Fill does not consume it. From expires_at it is expired and can no longer be
1593
+ * filled; Kernel deletes its stored details shortly after expires_at. Deleting the
1594
+ * card, its wallet or its vault deletes them immediately. amount, currency and the
1595
+ * merchant fields are recorded but not enforced. Repeating the identical request
1596
+ * returns the existing card; any other request with the same key returns 409, as
1597
+ * does repeating it once the expired card's details have been deleted.
1572
1598
  */
1573
1599
  export interface KernelCardVaultItemSpec {
1574
1600
  /**
@@ -1597,6 +1623,16 @@ export interface KernelCardVaultItemSpec {
1597
1623
  */
1598
1624
  wallet: string;
1599
1625
 
1626
+ /**
1627
+ * Single-use cards only. From this time the card is expired and can no longer be
1628
+ * filled; Kernel deletes its stored details shortly after. Deleting the card, its
1629
+ * wallet or its vault deletes them immediately. Defaults to 2 hours after
1630
+ * creation, capped at the end of the card's expiry month; a requested time must be
1631
+ * in the future, at most 24 hours after creation, and not after the end of the
1632
+ * card's expiry month. Returned in UTC.
1633
+ */
1634
+ expires_at?: string;
1635
+
1600
1636
  /**
1601
1637
  * Actual merchant category when known. Omit rather than invent a category.
1602
1638
  */
@@ -1619,9 +1655,20 @@ export interface KernelCardVaultItemSpec {
1619
1655
  * Omission selects the wallet's default card, ID card, for compatibility with
1620
1656
  * existing requests; it never falls back to another method, and a wallet without a
1621
1657
  * default card requires the ID. The purchase is bound to the method's enrolled
1622
- * card and network token, so later operations cannot switch funding.
1658
+ * card and network token, so later operations cannot switch funding. Not allowed
1659
+ * with single_use_card.
1623
1660
  */
1624
1661
  payment_method_id?: string;
1662
+
1663
+ /**
1664
+ * Details of a card the caller supplies, such as a single-use virtual card from
1665
+ * its issuer. Mutually exclusive with payment_method_id. The card details are
1666
+ * stored encrypted for fill and never returned; reads return only reference.
1667
+ * Kernel deletes them shortly after the card's expires_at; deleting the card, its
1668
+ * wallet or its vault deletes them immediately. A card whose expiry month has
1669
+ * ended is rejected.
1670
+ */
1671
+ single_use_card?: KernelSingleUseCard;
1625
1672
  }
1626
1673
 
1627
1674
  export interface KernelCredentialVaultItemSpec {
@@ -1738,6 +1785,22 @@ export interface KernelPaymentRequestVaultItemSpec {
1738
1785
  merchant_country?: string;
1739
1786
  }
1740
1787
 
1788
+ /**
1789
+ * Details of a card the caller supplies, such as a single-use virtual card from
1790
+ * its issuer. Mutually exclusive with payment_method_id. The card details are
1791
+ * stored encrypted for fill and never returned; reads return only reference.
1792
+ * Kernel deletes them shortly after the card's expires_at; deleting the card, its
1793
+ * wallet or its vault deletes them immediately. A card whose expiry month has
1794
+ * ended is rejected.
1795
+ */
1796
+ export interface KernelSingleUseCard {
1797
+ /**
1798
+ * The caller's identifier for the card, such as the issuer's card ID. Returned
1799
+ * unchanged on reads.
1800
+ */
1801
+ reference?: string;
1802
+ }
1803
+
1741
1804
  export interface KernelWalletState {
1742
1805
  provider: 'kernel';
1743
1806
 
@@ -2427,10 +2490,12 @@ export namespace OnePasswordCredentialVaultItemState {
2427
2490
 
2428
2491
  /**
2429
2492
  * Fill and submit an approved 1Password login in the selected browser page. The
2430
- * page must share the selected entry's login origin. Supply entry_id when more
2431
- * than one approved entry matches the page origin, and target_id when more than
2432
- * one open page has page_url. The extension selects fields; callers cannot supply
2433
- * selectors or secret values. Submission does not confirm website authentication.
2493
+ * 1Password extension decides whether the approved login matches the page and
2494
+ * refuses pages that don't. Supply entry_id when several entries are approved and
2495
+ * the page origin does not identify exactly one of them, and target_id when more
2496
+ * than one open page has page_url. The extension selects fields; callers cannot
2497
+ * supply selectors or secret values. Submission does not confirm website
2498
+ * authentication.
2434
2499
  */
2435
2500
  export interface OnePasswordFillVaultItemOperationRequest {
2436
2501
  /**
@@ -2447,8 +2512,8 @@ export interface OnePasswordFillVaultItemOperationRequest {
2447
2512
  type: '1pw_fill';
2448
2513
 
2449
2514
  /**
2450
- * ID of an approved request entry. Required when several approved entries have the
2451
- * page's origin.
2515
+ * ID of an approved request entry. Required when several entries are approved and
2516
+ * the page's origin does not match exactly one of them.
2452
2517
  */
2453
2518
  entry_id?: string;
2454
2519
 
@@ -2616,6 +2681,7 @@ export namespace PaymentRequestVaultItem {
2616
2681
  | '1pw_fill'
2617
2682
  | '1pw_recover'
2618
2683
  | '1pw_update_access_token'
2684
+ | 'update_access_token'
2619
2685
  | 'webmcp_invoke'
2620
2686
  | 'add_payment_method'
2621
2687
  | 'remove_payment_method';
@@ -3073,6 +3139,26 @@ export namespace ShopPayWalletVaultItemSpec {
3073
3139
  }
3074
3140
  }
3075
3141
 
3142
+ /**
3143
+ * Billing address filled with the billing\_\* fill fields. Never returned.
3144
+ */
3145
+ export interface SingleUseCardBillingAddress {
3146
+ city?: string;
3147
+
3148
+ /**
3149
+ * ISO 3166-1 alpha-2 code.
3150
+ */
3151
+ country?: string;
3152
+
3153
+ line1?: string;
3154
+
3155
+ line2?: string;
3156
+
3157
+ postal_code?: string;
3158
+
3159
+ state?: string;
3160
+ }
3161
+
3076
3162
  export interface VaultCardAliases {
3077
3163
  cvc: string;
3078
3164
 
@@ -3321,6 +3407,7 @@ export namespace VaultItem {
3321
3407
  | '1pw_fill'
3322
3408
  | '1pw_recover'
3323
3409
  | '1pw_update_access_token'
3410
+ | 'update_access_token'
3324
3411
  | 'webmcp_invoke'
3325
3412
  | 'add_payment_method'
3326
3413
  | 'remove_payment_method';
@@ -3420,6 +3507,7 @@ export namespace VaultItem {
3420
3507
  | '1pw_fill'
3421
3508
  | '1pw_recover'
3422
3509
  | '1pw_update_access_token'
3510
+ | 'update_access_token'
3423
3511
  | 'webmcp_invoke'
3424
3512
  | 'add_payment_method'
3425
3513
  | 'remove_payment_method';
@@ -3611,6 +3699,7 @@ export namespace VaultItemOperationResponse {
3611
3699
  | '1pw_fill'
3612
3700
  | '1pw_recover'
3613
3701
  | '1pw_update_access_token'
3702
+ | 'update_access_token'
3614
3703
  | 'webmcp_invoke'
3615
3704
  | 'add_payment_method'
3616
3705
  | 'remove_payment_method';
@@ -3710,6 +3799,7 @@ export namespace VaultItemOperationResponse {
3710
3799
  | '1pw_fill'
3711
3800
  | '1pw_recover'
3712
3801
  | '1pw_update_access_token'
3802
+ | 'update_access_token'
3713
3803
  | 'webmcp_invoke'
3714
3804
  | 'add_payment_method'
3715
3805
  | 'remove_payment_method';
@@ -3827,6 +3917,166 @@ export interface VaultWebmcpBinding {
3827
3917
  format?: string;
3828
3918
  }
3829
3919
 
3920
+ /**
3921
+ * The card's aliases in the customer's VGS vault, its expiry and last four digits.
3922
+ * Write-only: stored encrypted and never returned in the item, its events or logs.
3923
+ * A repeated PUT with the same key must send the same card.
3924
+ */
3925
+ export interface VgsCardInput {
3926
+ /**
3927
+ * A volatile alias of a freshly collected security code in the customer's vault.
3928
+ * It must still exist when authorize runs.
3929
+ */
3930
+ cvc_alias: string;
3931
+
3932
+ exp_month: number;
3933
+
3934
+ exp_year: number;
3935
+
3936
+ /**
3937
+ * The card number's last four digits, checked against the revealed alias.
3938
+ */
3939
+ last4: string;
3940
+
3941
+ /**
3942
+ * A persistent alias of the card number in the customer's vault.
3943
+ */
3944
+ pan_alias: string;
3945
+ }
3946
+
3947
+ /**
3948
+ * A ready VGS card supports fill, then submit checkout, until expires_at. Kernel
3949
+ * does not observe whether the merchant charged the card. masks.last4 is the
3950
+ * card's last four digits.
3951
+ */
3952
+ export interface VgsCardState {
3953
+ provider: 'vgs';
3954
+
3955
+ /**
3956
+ * requested until authorize reveals the aliases; if the reveal fails before
3957
+ * anything is stored, authorize returns 503 provider_unavailable and the card
3958
+ * stays requested. declined means authorize was refused: invalid_card for aliases
3959
+ * that do not match the card or a card that has expired (fix the input and create
3960
+ * a new card), alias_not_found when the customer's vault has no such alias,
3961
+ * usually an expired CVC alias (collect the CVC again and create a new card), or
3962
+ * provider_credentials_rejected when VGS refused the configuration's service
3963
+ * account (update the provider configuration and create a new card). ready lasts
3964
+ * until the CVC alias expires, then expired.
3965
+ */
3966
+ status: 'requested' | 'pending_authorization' | 'ready' | 'expired' | 'declined' | 'recovery_required';
3967
+
3968
+ /**
3969
+ * Informational registrable domain. Fill is locked to merchant_url's exact origin.
3970
+ */
3971
+ domains?: Array<string>;
3972
+
3973
+ masks?: VgsCardState.Masks;
3974
+
3975
+ status_reason?: string;
3976
+ }
3977
+
3978
+ export namespace VgsCardState {
3979
+ export interface Masks {
3980
+ brand?: string;
3981
+
3982
+ last4?: string;
3983
+
3984
+ /**
3985
+ * Last four digits of the network token presented to the merchant.
3986
+ */
3987
+ token_last4?: string;
3988
+
3989
+ [k: string]: string | undefined;
3990
+ }
3991
+ }
3992
+
3993
+ /**
3994
+ * One live purchase with a card in the customer's VGS vault. authorize reveals
3995
+ * card.pan_alias and card.cvc_alias through Kernel's VGS outbound proxy, which
3996
+ * replaces both with aliases in Kernel's vault before they reach Kernel; Kernel
3997
+ * never receives the card number or security code. The card is then ready with no
3998
+ * further approval, until expires_at, by default five minutes after authorize.
3999
+ * fill types Kernel's aliases on merchant_url's origin, and Kernel's VGS proxy
4000
+ * replaces them with the card's details when the browser submits checkout. An
4001
+ * expired card requires a new purchase with a freshly collected CVC alias. The
4002
+ * amount and merchant are recorded but do not restrict payment requests sent by
4003
+ * the browser. Card updates are not supported; delete and create a new item
4004
+ * instead.
4005
+ */
4006
+ export interface VgsCardVaultItemSpec {
4007
+ /**
4008
+ * Integer amount in minor currency units (at most 1000000).
4009
+ */
4010
+ amount: number;
4011
+
4012
+ /**
4013
+ * ISO 4217 code. Supported: aud, brl, cad, chf, czk, dkk, eur, gbp, hkd, inr, jpy,
4014
+ * krw, mxn, nok, nzd, pln, sek, sgd, usd, zar.
4015
+ */
4016
+ currency: string;
4017
+
4018
+ merchant_name: string;
4019
+
4020
+ /**
4021
+ * Merchant checkout URL. Fill is allowed only on this URL's origin.
4022
+ */
4023
+ merchant_url: string;
4024
+
4025
+ provider: 'vgs';
4026
+
4027
+ /**
4028
+ * Key of the VGS wallet item whose configuration reads the aliases.
4029
+ */
4030
+ wallet: string;
4031
+
4032
+ /**
4033
+ * Required when creating the card. Never returned.
4034
+ */
4035
+ card?: VgsCardInput;
4036
+ }
4037
+
4038
+ export interface VgsWalletState {
4039
+ provider: 'vgs';
4040
+
4041
+ /**
4042
+ * A VGS wallet is connected on creation. pending_authorization or degraded means
4043
+ * its creation did not finish; reading the wallet retries it, and a wallet that
4044
+ * stays degraded can be deleted and created again. Whether its configuration's
4045
+ * credentials still work is checked when a card is authorized.
4046
+ */
4047
+ status: 'pending_authorization' | 'connected' | 'degraded';
4048
+
4049
+ status_reason?: string;
4050
+ }
4051
+
4052
+ /**
4053
+ * Cards kept in the customer's own VGS vault. The wallet binds a VGS provider
4054
+ * configuration and is connected on creation; it holds no cards and has no payment
4055
+ * methods. Each purchase is a card item that carries the card's aliases from the
4056
+ * customer's vault. The configuration binding cannot be changed after creation.
4057
+ */
4058
+ export interface VgsWalletVaultItemSpec {
4059
+ provider: 'vgs';
4060
+
4061
+ /**
4062
+ * Select a VGS configuration. Required, because there are no Kernel-managed VGS
4063
+ * credentials for this provider.
4064
+ */
4065
+ provider_config: VgsWalletVaultItemSpec.ProviderConfig;
4066
+ }
4067
+
4068
+ export namespace VgsWalletVaultItemSpec {
4069
+ /**
4070
+ * Select a VGS configuration. Required, because there are no Kernel-managed VGS
4071
+ * credentials for this provider.
4072
+ */
4073
+ export interface ProviderConfig {
4074
+ id?: string;
4075
+
4076
+ name?: string;
4077
+ }
4078
+ }
4079
+
3830
4080
  /**
3831
4081
  * AgentCard wallet. Omit provider_config to use Kernel-managed credentials, or
3832
4082
  * select a customer-owned configuration. Mode (sandbox vs live) is determined by
@@ -3847,7 +4097,8 @@ export type WalletVaultItemSpec =
3847
4097
  | WalletVaultItemSpec.LinkWalletVaultItemSpec
3848
4098
  | WalletVaultItemSpec.AgentCardWalletVaultItemSpec
3849
4099
  | KernelWalletVaultItemSpec
3850
- | ShopPayWalletVaultItemSpec;
4100
+ | ShopPayWalletVaultItemSpec
4101
+ | VgsWalletVaultItemSpec;
3851
4102
 
3852
4103
  export namespace WalletVaultItemSpec {
3853
4104
  export interface LinkWalletVaultItemSpec {
@@ -3861,6 +4112,14 @@ export namespace WalletVaultItemSpec {
3861
4112
  client: Authorization.KernelManagedOAuthClient | Authorization.CustomerManagedOAuthClient;
3862
4113
 
3863
4114
  method: 'oauth';
4115
+
4116
+ /**
4117
+ * Who refreshes an imported Link grant. kernel (default) means Kernel holds and
4118
+ * rotates the refresh token. customer means your backend keeps the refresh token
4119
+ * and replaces the access token with update_access_token; Kernel never refreshes
4120
+ * or revokes the grant. Fixed at wallet creation.
4121
+ */
4122
+ token_refresh?: 'kernel' | 'customer';
3864
4123
  }
3865
4124
 
3866
4125
  export namespace Authorization {
@@ -3939,7 +4198,8 @@ export type WalletVaultItemState =
3939
4198
  | WalletVaultItemState.LinkWalletState
3940
4199
  | WalletVaultItemState.AgentCardWalletState
3941
4200
  | KernelWalletState
3942
- | ShopPayWalletState;
4201
+ | ShopPayWalletState
4202
+ | VgsWalletState;
3943
4203
 
3944
4204
  export namespace WalletVaultItemState {
3945
4205
  export interface LinkWalletState {
@@ -4187,6 +4447,7 @@ export type ItemPerformOperationParams =
4187
4447
  | ItemPerformOperationParams.OnePasswordFillVaultItemOperationRequest
4188
4448
  | ItemPerformOperationParams.OnePasswordRecoverVaultItemOperationRequest
4189
4449
  | ItemPerformOperationParams.OnePasswordUpdateAccessTokenVaultItemOperationRequest
4450
+ | ItemPerformOperationParams.UpdateAccessTokenVaultItemOperationRequest
4190
4451
  | ItemPerformOperationParams.WebmcpInvokeVaultItemOperationRequest
4191
4452
  | ItemPerformOperationParams.AddPaymentMethodVaultItemOperationRequest
4192
4453
  | ItemPerformOperationParams.RemovePaymentMethodVaultItemOperationRequest;
@@ -4507,8 +4768,8 @@ export declare namespace ItemPerformOperationParams {
4507
4768
  type: '1pw_fill';
4508
4769
 
4509
4770
  /**
4510
- * Body param: ID of an approved request entry. Required when several approved
4511
- * entries have the page's origin.
4771
+ * Body param: ID of an approved request entry. Required when several entries are
4772
+ * approved and the page's origin does not match exactly one of them.
4512
4773
  */
4513
4774
  entry_id?: string;
4514
4775
 
@@ -4560,6 +4821,23 @@ export declare namespace ItemPerformOperationParams {
4560
4821
  access_token_expires_at?: string;
4561
4822
  }
4562
4823
 
4824
+ export interface UpdateAccessTokenVaultItemOperationRequest {
4825
+ /**
4826
+ * Path param
4827
+ */
4828
+ id_or_name: string;
4829
+
4830
+ /**
4831
+ * Body param
4832
+ */
4833
+ access_token: string;
4834
+
4835
+ /**
4836
+ * Body param
4837
+ */
4838
+ type: 'update_access_token';
4839
+ }
4840
+
4563
4841
  export interface WebmcpInvokeVaultItemOperationRequest {
4564
4842
  /**
4565
4843
  * Path param
@@ -4670,7 +4948,8 @@ export declare namespace ItemUpsertParams {
4670
4948
  | WalletVaultItemRequest.LinkWalletVaultItemRequestSpec
4671
4949
  | WalletVaultItemRequest.AgentCardWalletVaultItemSpec
4672
4950
  | KernelWalletVaultItemSpec
4673
- | ShopPayWalletVaultItemSpec;
4951
+ | ShopPayWalletVaultItemSpec
4952
+ | VgsWalletVaultItemSpec;
4674
4953
 
4675
4954
  /**
4676
4955
  * Body param
@@ -4713,7 +4992,16 @@ export declare namespace ItemUpsertParams {
4713
4992
  * wallet with state.status=connected. An expired, invalid, revoked, or
4714
4993
  * insufficiently scoped access token returns 400 and no wallet is created. Refresh
4715
4994
  * expired tokens in your backend before importing them. A failed import does not
4716
- * modify existing wallets. After successful import, Kernel owns subsequent
4995
+ * modify existing wallets. By default (token_refresh=kernel), Kernel owns
4996
+ * subsequent refresh-token rotation after a successful import; the customer must
4997
+ * stop refreshing this grant. With token_refresh=customer, send only the access
4998
+ * token: your backend keeps the refresh token and rotates the grant, and Kernel
4999
+ * never refreshes or revokes it. When Link rejects the stored access token, any
5000
+ * operation that reaches Link, such as creating, authorizing or filling a card,
5001
+ * returns 409 with code access_token_rejected without contacting Link again. Push
5002
+ * a fresh access token with the wallet's update_access_token operation, then retry
5003
+ * the operation. The remainder of this description applies to
5004
+ * token_refresh=kernel. With token_refresh=kernel, Kernel owns subsequent
4717
5005
  * refresh-token rotation; the customer must stop refreshing this grant. Import
4718
5006
  * does not verify the refresh token: if it or the configured client credentials
4719
5007
  * are rejected during a later refresh, the imported wallet becomes degraded. An
@@ -4740,13 +5028,22 @@ export declare namespace ItemUpsertParams {
4740
5028
  method: 'oauth';
4741
5029
 
4742
5030
  /**
4743
- * Send the token pair from your backend. Both tokens must be from the same Link
4744
- * grant under the referenced client. Supply a currently valid access token. Kernel
4745
- * refreshes when needed after import and uses the expiry returned by Link for
4746
- * subsequent tokens. Tokens are never returned in wallet responses, events, or
5031
+ * Send the tokens from your backend. Supply a currently valid access token. With
5032
+ * token_refresh=kernel, also send the refresh token from the same Link grant under
5033
+ * the referenced client; Kernel refreshes when needed after import and uses the
5034
+ * expiry returned by Link for subsequent tokens. With token_refresh=customer, omit
5035
+ * the refresh token. Tokens are never returned in wallet responses, events, or
4747
5036
  * logs.
4748
5037
  */
4749
5038
  tokens: ImportedLinkAuthorizationInput.Tokens;
5039
+
5040
+ /**
5041
+ * Who refreshes an imported Link grant. kernel (default) means Kernel holds and
5042
+ * rotates the refresh token. customer means your backend keeps the refresh token
5043
+ * and replaces the access token with update_access_token; Kernel never refreshes
5044
+ * or revokes the grant. Fixed at wallet creation.
5045
+ */
5046
+ token_refresh?: 'kernel' | 'customer';
4750
5047
  }
4751
5048
 
4752
5049
  export namespace ImportedLinkAuthorizationInput {
@@ -4775,16 +5072,20 @@ export declare namespace ItemUpsertParams {
4775
5072
  }
4776
5073
 
4777
5074
  /**
4778
- * Send the token pair from your backend. Both tokens must be from the same Link
4779
- * grant under the referenced client. Supply a currently valid access token. Kernel
4780
- * refreshes when needed after import and uses the expiry returned by Link for
4781
- * subsequent tokens. Tokens are never returned in wallet responses, events, or
5075
+ * Send the tokens from your backend. Supply a currently valid access token. With
5076
+ * token_refresh=kernel, also send the refresh token from the same Link grant under
5077
+ * the referenced client; Kernel refreshes when needed after import and uses the
5078
+ * expiry returned by Link for subsequent tokens. With token_refresh=customer, omit
5079
+ * the refresh token. Tokens are never returned in wallet responses, events, or
4782
5080
  * logs.
4783
5081
  */
4784
5082
  export interface Tokens {
4785
5083
  access_token: string;
4786
5084
 
4787
- refresh_token: string;
5085
+ /**
5086
+ * Required with token_refresh=kernel; rejected with token_refresh=customer.
5087
+ */
5088
+ refresh_token?: string;
4788
5089
  }
4789
5090
  }
4790
5091
  }
@@ -4951,6 +5252,7 @@ export declare namespace Items {
4951
5252
  type KernelCredentialVaultItemSpecInput as KernelCredentialVaultItemSpecInput,
4952
5253
  type KernelCredentialVaultItemState as KernelCredentialVaultItemState,
4953
5254
  type KernelPaymentRequestVaultItemSpec as KernelPaymentRequestVaultItemSpec,
5255
+ type KernelSingleUseCard as KernelSingleUseCard,
4954
5256
  type KernelWalletState as KernelWalletState,
4955
5257
  type KernelWalletVaultItemSpec as KernelWalletVaultItemSpec,
4956
5258
  type LinkShippingAddress as LinkShippingAddress,
@@ -4982,6 +5284,7 @@ export declare namespace Items {
4982
5284
  type ShopPayCardVaultItemSpec as ShopPayCardVaultItemSpec,
4983
5285
  type ShopPayWalletState as ShopPayWalletState,
4984
5286
  type ShopPayWalletVaultItemSpec as ShopPayWalletVaultItemSpec,
5287
+ type SingleUseCardBillingAddress as SingleUseCardBillingAddress,
4985
5288
  type VaultCardAliases as VaultCardAliases,
4986
5289
  type VaultCardFillField as VaultCardFillField,
4987
5290
  type VaultCheckoutContext as VaultCheckoutContext,
@@ -4993,6 +5296,11 @@ export declare namespace Items {
4993
5296
  type VaultItemOperationResponse as VaultItemOperationResponse,
4994
5297
  type VaultPaymentMethod as VaultPaymentMethod,
4995
5298
  type VaultWebmcpBinding as VaultWebmcpBinding,
5299
+ type VgsCardInput as VgsCardInput,
5300
+ type VgsCardState as VgsCardState,
5301
+ type VgsCardVaultItemSpec as VgsCardVaultItemSpec,
5302
+ type VgsWalletState as VgsWalletState,
5303
+ type VgsWalletVaultItemSpec as VgsWalletVaultItemSpec,
4996
5304
  type WalletVaultItemSpec as WalletVaultItemSpec,
4997
5305
  type WalletVaultItemState as WalletVaultItemState,
4998
5306
  type WebmcpInvokeVaultItemOperationRequest as WebmcpInvokeVaultItemOperationRequest,
@@ -48,6 +48,7 @@ import {
48
48
  KernelCredentialVaultItemSpecInput,
49
49
  KernelCredentialVaultItemState,
50
50
  KernelPaymentRequestVaultItemSpec,
51
+ KernelSingleUseCard,
51
52
  KernelWalletState,
52
53
  KernelWalletVaultItemSpec,
53
54
  LinkShippingAddress,
@@ -79,6 +80,7 @@ import {
79
80
  ShopPayCardVaultItemSpec,
80
81
  ShopPayWalletState,
81
82
  ShopPayWalletVaultItemSpec,
83
+ SingleUseCardBillingAddress,
82
84
  VaultCardAliases,
83
85
  VaultCardFillField,
84
86
  VaultCheckoutContext,
@@ -90,6 +92,11 @@ import {
90
92
  VaultItemOperationResponse,
91
93
  VaultPaymentMethod,
92
94
  VaultWebmcpBinding,
95
+ VgsCardInput,
96
+ VgsCardState,
97
+ VgsCardVaultItemSpec,
98
+ VgsWalletState,
99
+ VgsWalletVaultItemSpec,
93
100
  WalletVaultItemSpec,
94
101
  WalletVaultItemState,
95
102
  WebmcpInvokeVaultItemOperationRequest,
@@ -320,6 +327,7 @@ export declare namespace Vaults {
320
327
  type KernelCredentialVaultItemSpecInput as KernelCredentialVaultItemSpecInput,
321
328
  type KernelCredentialVaultItemState as KernelCredentialVaultItemState,
322
329
  type KernelPaymentRequestVaultItemSpec as KernelPaymentRequestVaultItemSpec,
330
+ type KernelSingleUseCard as KernelSingleUseCard,
323
331
  type KernelWalletState as KernelWalletState,
324
332
  type KernelWalletVaultItemSpec as KernelWalletVaultItemSpec,
325
333
  type LinkShippingAddress as LinkShippingAddress,
@@ -351,6 +359,7 @@ export declare namespace Vaults {
351
359
  type ShopPayCardVaultItemSpec as ShopPayCardVaultItemSpec,
352
360
  type ShopPayWalletState as ShopPayWalletState,
353
361
  type ShopPayWalletVaultItemSpec as ShopPayWalletVaultItemSpec,
362
+ type SingleUseCardBillingAddress as SingleUseCardBillingAddress,
354
363
  type VaultCardAliases as VaultCardAliases,
355
364
  type VaultCardFillField as VaultCardFillField,
356
365
  type VaultCheckoutContext as VaultCheckoutContext,
@@ -362,6 +371,11 @@ export declare namespace Vaults {
362
371
  type VaultItemOperationResponse as VaultItemOperationResponse,
363
372
  type VaultPaymentMethod as VaultPaymentMethod,
364
373
  type VaultWebmcpBinding as VaultWebmcpBinding,
374
+ type VgsCardInput as VgsCardInput,
375
+ type VgsCardState as VgsCardState,
376
+ type VgsCardVaultItemSpec as VgsCardVaultItemSpec,
377
+ type VgsWalletState as VgsWalletState,
378
+ type VgsWalletVaultItemSpec as VgsWalletVaultItemSpec,
365
379
  type WalletVaultItemSpec as WalletVaultItemSpec,
366
380
  type WalletVaultItemState as WalletVaultItemState,
367
381
  type WebmcpInvokeVaultItemOperationRequest as WebmcpInvokeVaultItemOperationRequest,
package/src/version.ts CHANGED
@@ -1 +1 @@
1
- export const VERSION = '0.139.0'; // x-release-please-version
1
+ export const VERSION = '0.141.0'; // x-release-please-version
package/version.d.mts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.139.0";
1
+ export declare const VERSION = "0.141.0";
2
2
  //# sourceMappingURL=version.d.mts.map
package/version.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.139.0";
1
+ export declare const VERSION = "0.141.0";
2
2
  //# sourceMappingURL=version.d.ts.map
package/version.js CHANGED
@@ -1,5 +1,5 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.VERSION = void 0;
4
- exports.VERSION = '0.139.0'; // x-release-please-version
4
+ exports.VERSION = '0.141.0'; // x-release-please-version
5
5
  //# sourceMappingURL=version.js.map