@onkernel/sdk 0.123.0 → 0.125.0

package/src/resources/vaults/items.ts

@@ -600,6 +600,44 @@ export interface CollectVaultItemOperationRequest {
   type: 'collect';
 }
 
+/**
+ * Report a real merchant transaction outcome for an issued Kernel Visa credential.
+ * Never infer success from filling checkout or receiving a credential. Supply the
+ * observed status, transaction type, actual amount, currency and timestamp.
+ * Unknown outcomes require manual reconciliation, not retry. Each purchase accepts
+ * one report.
+ */
+export interface ConfirmTransactionVaultItemOperationRequest {
+  /**
+   * Actual transaction amount in minor units, no greater than the approved limit.
+   */
+  amount: number;
+
+  /**
+   * Must match the approved purchase currency.
+   */
+  currency: string;
+
+  /**
+   * Time the merchant outcome was observed.
+   */
+  occurred_at: string;
+
+  status: 'APPROVED' | 'DECLINED' | 'PENDING' | 'ERROR' | 'CANCELLED';
+
+  transaction_type:
+    | 'PURCHASE'
+    | 'AUTHORIZATION'
+    | 'CAPTURE'
+    | 'REFUND'
+    | 'REVERSAL'
+    | 'VERIFICATION'
+    | 'CHARGEBACK'
+    | 'FRAUD';
+
+  type: 'confirm_transaction';
+}
+
 export interface CredentialAccountVaultItem {
   id: string;
 
@@ -652,6 +690,8 @@ export namespace CredentialAccountVaultItem {
 
     type:
       | 'authorize'
+      | 'restart_verification'
+      | 'confirm_transaction'
       | 'collect'
       | 'prepare_checkout'
       | 'fill'
@@ -960,6 +1000,8 @@ export namespace CredentialVaultItem {
 
     type:
       | 'authorize'
+      | 'restart_verification'
+      | 'confirm_transaction'
       | 'collect'
       | 'prepare_checkout'
       | 'fill'
@@ -1177,12 +1219,16 @@ export interface KernelCardState {
   /**
    * pending_authorization on a Visa purchase waits for the cardholder to approve it
    * through the spend_approval action; an unused link expires after 30 minutes.
-   * recovery_required means approving the purchase or issuing the one-time code has
-   * an unresolved outcome. Kernel never approves again or issues another code for
-   * the item automatically, and the item cannot be deleted or replaced until the
-   * original attempt is reconciled with support. When status_reason says the
-   * provider refused retrieval before acceptance, no code was issued and a later
-   * read retries. declined means the card network refused to issue a code.
+   * recovery_required means verification, approving the purchase or issuing the
+   * one-time code has an unresolved outcome. A server-classified initial attestation
+   * failure before intent dispatch may advertise restart_verification to prepare a
+   * fresh local verification link; this does not approve spending or replay any
+   * provider request. Unclassified legacy recovery and uncertain intent creation
+   * cannot restart. Kernel never approves again or issues another code for the item
+   * automatically, and the item cannot be deleted or replaced until the original
+   * attempt is reconciled with support. When status_reason says the provider refused
+   * retrieval before acceptance, no code was issued and a later read retries.
+   * declined means the card network refused to issue a code.
    */
   status:
     | 'requested'
@@ -1257,6 +1303,17 @@ export interface KernelCardVaultItemSpec {
    */
   wallet: string;
 
+  /**
+   * Actual merchant category when known. Omit rather than invent a category.
+   */
+  merchant_category?: string;
+
+  /**
+   * Actual merchant MCC when known. Omit rather than invent a code. 0000 is not
+   * accepted.
+   */
+  merchant_category_code?: string;
+
   /**
    * The merchant's ISO 3166-1 alpha-2 country code. Required for Visa cards, whose
    * one-time code is issued for the merchant's country.
@@ -1847,6 +1904,21 @@ export interface PrepareCheckoutVaultItemOperationRequest {
   type: 'prepare_checkout';
 }
 
+/**
+ * Explicitly prepare a fresh local verification session for the same Kernel Visa
+ * purchase and connected wallet, only when restart_verification is advertised.
+ * Kernel must have durable proof of an initial attestation failure before intent
+ * dispatch. Replaces the spend_approval capability and discards session-bound
+ * verification data without calling the provider or granting spend consent. The
+ * cardholder must use the new link, verify again and explicitly approve the
+ * purchase. Unknown intent creation, legacy unclassified recovery, enrollment
+ * completion, issuance and confirmation cannot restart. Do not automatically retry
+ * this operation.
+ */
+export interface RestartVerificationVaultItemOperationRequest {
+  type: 'restart_verification';
+}
+
 export interface VaultCardAliases {
   cvc: string;
 
@@ -2059,6 +2131,8 @@ export namespace VaultItem {
 
       type:
         | 'authorize'
+        | 'restart_verification'
+        | 'confirm_transaction'
         | 'collect'
         | 'prepare_checkout'
         | 'fill'
@@ -2132,6 +2206,8 @@ export namespace VaultItem {
 
       type:
         | 'authorize'
+        | 'restart_verification'
+        | 'confirm_transaction'
         | 'collect'
         | 'prepare_checkout'
         | 'fill'
@@ -2281,6 +2357,8 @@ export namespace VaultItemOperationResponse {
 
       type:
         | 'authorize'
+        | 'restart_verification'
+        | 'confirm_transaction'
         | 'collect'
         | 'prepare_checkout'
         | 'fill'
@@ -2354,6 +2432,8 @@ export namespace VaultItemOperationResponse {
 
       type:
         | 'authorize'
+        | 'restart_verification'
+        | 'confirm_transaction'
         | 'collect'
         | 'prepare_checkout'
         | 'fill'
@@ -2739,6 +2819,8 @@ export interface ItemEventsParams {
 
 export type ItemPerformOperationParams =
   | ItemPerformOperationParams.AuthorizeVaultItemOperationRequest
+  | ItemPerformOperationParams.RestartVerificationVaultItemOperationRequest
+  | ItemPerformOperationParams.ConfirmTransactionVaultItemOperationRequest
   | ItemPerformOperationParams.CollectVaultItemOperationRequest
   | ItemPerformOperationParams.PrepareCheckoutVaultItemOperationRequest
   | ItemPerformOperationParams.FillVaultItemOperationRequest
@@ -2762,6 +2844,64 @@ export declare namespace ItemPerformOperationParams {
     type: 'authorize';
   }
 
+  export interface RestartVerificationVaultItemOperationRequest {
+    /**
+     * Path param
+     */
+    id_or_name: string;
+
+    /**
+     * Body param
+     */
+    type: 'restart_verification';
+  }
+
+  export interface ConfirmTransactionVaultItemOperationRequest {
+    /**
+     * Path param
+     */
+    id_or_name: string;
+
+    /**
+     * Body param: Actual transaction amount in minor units, no greater than the
+     * approved limit.
+     */
+    amount: number;
+
+    /**
+     * Body param: Must match the approved purchase currency.
+     */
+    currency: string;
+
+    /**
+     * Body param: Time the merchant outcome was observed.
+     */
+    occurred_at: string;
+
+    /**
+     * Body param
+     */
+    status: 'APPROVED' | 'DECLINED' | 'PENDING' | 'ERROR' | 'CANCELLED';
+
+    /**
+     * Body param
+     */
+    transaction_type:
+      | 'PURCHASE'
+      | 'AUTHORIZATION'
+      | 'CAPTURE'
+      | 'REFUND'
+      | 'REVERSAL'
+      | 'VERIFICATION'
+      | 'CHARGEBACK'
+      | 'FRAUD';
+
+    /**
+     * Body param
+     */
+    type: 'confirm_transaction';
+  }
+
   export interface CollectVaultItemOperationRequest {
     /**
      * Path param
@@ -3233,6 +3373,7 @@ export declare namespace Items {
     type CardVaultItemSpec as CardVaultItemSpec,
     type CardVaultItemState as CardVaultItemState,
     type CollectVaultItemOperationRequest as CollectVaultItemOperationRequest,
+    type ConfirmTransactionVaultItemOperationRequest as ConfirmTransactionVaultItemOperationRequest,
     type CredentialAccountVaultItem as CredentialAccountVaultItem,
     type CredentialAccountVaultItemRequest as CredentialAccountVaultItemRequest,
     type CredentialCollectionAction as CredentialCollectionAction,
@@ -3272,6 +3413,7 @@ export declare namespace Items {
     type OnePasswordRecoverVaultItemOperationRequest as OnePasswordRecoverVaultItemOperationRequest,
     type OnePasswordRequestAccessVaultItemOperationRequest as OnePasswordRequestAccessVaultItemOperationRequest,
     type PrepareCheckoutVaultItemOperationRequest as PrepareCheckoutVaultItemOperationRequest,
+    type RestartVerificationVaultItemOperationRequest as RestartVerificationVaultItemOperationRequest,
     type VaultCardAliases as VaultCardAliases,
     type VaultCardFillField as VaultCardFillField,
     type VaultCheckoutContext as VaultCheckoutContext,

package/src/resources/vaults/vaults.ts

@@ -10,6 +10,7 @@ import {
   CardVaultItemSpec,
   CardVaultItemState,
   CollectVaultItemOperationRequest,
+  ConfirmTransactionVaultItemOperationRequest,
   CredentialAccountVaultItem,
   CredentialAccountVaultItemRequest,
   CredentialCollectionAction,
@@ -58,6 +59,7 @@ import {
   OnePasswordRecoverVaultItemOperationRequest,
   OnePasswordRequestAccessVaultItemOperationRequest,
   PrepareCheckoutVaultItemOperationRequest,
+  RestartVerificationVaultItemOperationRequest,
   VaultCardAliases,
   VaultCardFillField,
   VaultCheckoutContext,
@@ -270,6 +272,7 @@ export declare namespace Vaults {
     type CardVaultItemSpec as CardVaultItemSpec,
     type CardVaultItemState as CardVaultItemState,
     type CollectVaultItemOperationRequest as CollectVaultItemOperationRequest,
+    type ConfirmTransactionVaultItemOperationRequest as ConfirmTransactionVaultItemOperationRequest,
     type CredentialAccountVaultItem as CredentialAccountVaultItem,
     type CredentialAccountVaultItemRequest as CredentialAccountVaultItemRequest,
     type CredentialCollectionAction as CredentialCollectionAction,
@@ -309,6 +312,7 @@ export declare namespace Vaults {
     type OnePasswordRecoverVaultItemOperationRequest as OnePasswordRecoverVaultItemOperationRequest,
     type OnePasswordRequestAccessVaultItemOperationRequest as OnePasswordRequestAccessVaultItemOperationRequest,
     type PrepareCheckoutVaultItemOperationRequest as PrepareCheckoutVaultItemOperationRequest,
+    type RestartVerificationVaultItemOperationRequest as RestartVerificationVaultItemOperationRequest,
     type VaultCardAliases as VaultCardAliases,
     type VaultCardFillField as VaultCardFillField,
     type VaultCheckoutContext as VaultCheckoutContext,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.123.0'; // x-release-please-version
+export const VERSION = '0.125.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.123.0";
+export declare const VERSION = "0.125.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.123.0";
+export declare const VERSION = "0.125.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.123.0'; // x-release-please-version
+exports.VERSION = '0.125.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.123.0'; // x-release-please-version
+export const VERSION = '0.125.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map