@peac/mappings-acp 0.12.2 → 0.12.4

package/dist/index.d.ts

@@ -54,4 +54,6 @@ export declare function attachReceiptToACPResponse<T extends Record<string, unkn
  * @returns PEAC receipt JWS or null if not present
  */
 export declare function extractReceiptFromACPResponse(response: Record<string, unknown>): string | null;
+export type { ACPSessionState, ACPSessionEvent, ObservedPaymentState, ACPPaymentArtifact, ACPCapabilityNegotiation, ACPIntervention, SessionReceiptInput, } from './session.js';
+export { fromACPSessionLifecycleEvent, fromACPPaymentObservation, fromACPCapabilitySnapshot, fromACPInterventionRequired, } from './session.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,cAAc,UAAU,CAAC;AAGzB,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEpG,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,EAC5B,iCAAiC,EACjC,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB,CAoDlF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,QAAQ,EAAE,CAAC,EACX,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAK9B;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAK9F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,cAAc,UAAU,CAAC;AAGzB,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEpG,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,EAC5B,iCAAiC,EACjC,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB,CAoDlF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,QAAQ,EAAE,CAAC,EACX,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAK9B;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAK9F;AAGD,YAAY,EACV,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -20,7 +20,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AcpCarrierAdapter = exports.extractCarrierFromACPHeadersAsync = exports.extractCarrierFromACPHeaders = exports.attachCarrierToACPMessage = exports.attachCarrierToACPHeaders = exports.ACP_CARRIER_LIMITS = void 0;
+exports.fromACPInterventionRequired = exports.fromACPCapabilitySnapshot = exports.fromACPPaymentObservation = exports.fromACPSessionLifecycleEvent = exports.AcpCarrierAdapter = exports.extractCarrierFromACPHeadersAsync = exports.extractCarrierFromACPHeaders = exports.attachCarrierToACPMessage = exports.attachCarrierToACPHeaders = exports.ACP_CARRIER_LIMITS = void 0;
 exports.fromACPCheckoutSuccess = fromACPCheckoutSuccess;
 exports.attachReceiptToACPResponse = attachReceiptToACPResponse;
 exports.extractReceiptFromACPResponse = extractReceiptFromACPResponse;
@@ -112,4 +112,9 @@ function extractReceiptFromACPResponse(response) {
     }
     return null;
 }
+var session_js_1 = require("./session.js");
+Object.defineProperty(exports, "fromACPSessionLifecycleEvent", { enumerable: true, get: function () { return session_js_1.fromACPSessionLifecycleEvent; } });
+Object.defineProperty(exports, "fromACPPaymentObservation", { enumerable: true, get: function () { return session_js_1.fromACPPaymentObservation; } });
+Object.defineProperty(exports, "fromACPCapabilitySnapshot", { enumerable: true, get: function () { return session_js_1.fromACPCapabilitySnapshot; } });
+Object.defineProperty(exports, "fromACPInterventionRequired", { enumerable: true, get: function () { return session_js_1.fromACPInterventionRequired; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/session.d.ts

@@ -0,0 +1,92 @@
+/**
+ * ACP session lifecycle evidence mapping (DD-188).
+ *
+ * Maps ACP session states to PEAC evidence WITHOUT synthesizing
+ * payment finality from session states. An ACP session "completed"
+ * does NOT prove payment settlement. Payment evidence is only
+ * produced when an explicit payment-bearing artifact with a known
+ * observed payment state is provided by the caller.
+ *
+ * Two separate functions enforce this boundary:
+ * - fromACPSessionLifecycleEvent(): session/access evidence only
+ * - fromACPPaymentObservation(): commerce evidence only with explicit payment artifact
+ */
+import type { PaymentEvidence } from '@peac/schema';
+/**
+ * PEAC Receipt Input (for issue()).
+ * Locally defined to avoid circular import with index.ts.
+ * Structurally identical to PEACReceiptInput in index.ts.
+ */
+export interface SessionReceiptInput {
+    subject_uri: string;
+    amt: number;
+    cur: string;
+    payment: PaymentEvidence;
+}
+/** ACP session states per ACP spec 2026-01-30 */
+export type ACPSessionState = 'created' | 'updated' | 'ready_for_payment' | 'in_progress' | 'completed' | 'canceled' | 'not_ready_for_payment';
+/** ACP session lifecycle event */
+export interface ACPSessionEvent {
+    session_id: string;
+    state: ACPSessionState;
+    resource_uri: string;
+    capabilities?: Record<string, unknown>;
+    intervention_requirements?: Record<string, unknown>;
+    delegated_payment_ref?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+/** Observed payment state from an explicit payment-bearing artifact */
+export type ObservedPaymentState = 'attempted' | 'authorized' | 'captured' | 'settled' | 'failed' | 'refunded';
+/** Payment artifact with observed state */
+export interface ACPPaymentArtifact {
+    rail: string;
+    reference: string;
+    amount: number;
+    currency: string;
+    observed_payment_state: ObservedPaymentState;
+}
+/** ACP capability negotiation snapshot */
+export interface ACPCapabilityNegotiation {
+    session_id: string;
+    seller_capabilities?: Record<string, unknown>;
+    buyer_capabilities?: Record<string, unknown>;
+    negotiated?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+/** ACP intervention requirement */
+export interface ACPIntervention {
+    session_id: string;
+    resource_uri: string;
+    type: string;
+    reason?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Map an ACP session lifecycle event to PEAC evidence.
+ *
+ * Produces session/access evidence ONLY. Never produces commerce evidence.
+ * "completed" means "checkout session completed", NOT "payment settled".
+ * "canceled" means "session canceled", NOT "payment voided".
+ */
+export declare function fromACPSessionLifecycleEvent(event: ACPSessionEvent): SessionReceiptInput;
+/**
+ * Map an ACP session event with explicit payment artifact to PEAC commerce evidence.
+ *
+ * Only called when an explicit payment-bearing artifact with a known
+ * observed payment state is present alongside the session event.
+ * Commerce extension event is derived from observed_payment_state,
+ * NOT from the ACP session state.
+ *
+ * 'attempted' and 'failed' produce access evidence only (no commerce event).
+ */
+export declare function fromACPPaymentObservation(event: ACPSessionEvent, paymentArtifact: ACPPaymentArtifact): SessionReceiptInput;
+/**
+ * Create an audit-friendly snapshot of ACP capability negotiation.
+ */
+export declare function fromACPCapabilitySnapshot(negotiation: ACPCapabilityNegotiation): Record<string, unknown>;
+/**
+ * Map an ACP intervention requirement to PEAC challenge-kind evidence.
+ */
+export declare function fromACPInterventionRequired(intervention: ACPIntervention): SessionReceiptInput;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,CAAC;CAC1B;AAMD,iDAAiD;AACjD,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,SAAS,GACT,mBAAmB,GACnB,aAAa,GACb,WAAW,GACX,UAAU,GACV,uBAAuB,CAAC;AAE5B,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,yBAAyB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,YAAY,GACZ,UAAU,GACV,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,oBAAoB,CAAC;CAC9C;AAED,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAkBD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,GAAG,mBAAmB,CAoCxF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,kBAAkB,GAClC,mBAAmB,CAgDrB;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,wBAAwB,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAMD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,eAAe,GAAG,mBAAmB,CAiC9F"}

package/dist/session.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * ACP session lifecycle evidence mapping (DD-188).
+ *
+ * Maps ACP session states to PEAC evidence WITHOUT synthesizing
+ * payment finality from session states. An ACP session "completed"
+ * does NOT prove payment settlement. Payment evidence is only
+ * produced when an explicit payment-bearing artifact with a known
+ * observed payment state is provided by the caller.
+ *
+ * Two separate functions enforce this boundary:
+ * - fromACPSessionLifecycleEvent(): session/access evidence only
+ * - fromACPPaymentObservation(): commerce evidence only with explicit payment artifact
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromACPSessionLifecycleEvent = fromACPSessionLifecycleEvent;
+exports.fromACPPaymentObservation = fromACPPaymentObservation;
+exports.fromACPCapabilitySnapshot = fromACPCapabilitySnapshot;
+exports.fromACPInterventionRequired = fromACPInterventionRequired;
+// ---------------------------------------------------------------------------
+// Commerce event mapping (payment state -> commerce extension event)
+// ---------------------------------------------------------------------------
+const PAYMENT_STATE_TO_COMMERCE_EVENT = {
+    authorized: 'authorization',
+    captured: 'capture',
+    settled: 'settlement',
+    refunded: 'refund',
+    // 'attempted' and 'failed' do NOT map to commerce events
+};
+// ---------------------------------------------------------------------------
+// Session Lifecycle Evidence (access-kind, never commerce)
+// ---------------------------------------------------------------------------
+/**
+ * Map an ACP session lifecycle event to PEAC evidence.
+ *
+ * Produces session/access evidence ONLY. Never produces commerce evidence.
+ * "completed" means "checkout session completed", NOT "payment settled".
+ * "canceled" means "session canceled", NOT "payment voided".
+ */
+function fromACPSessionLifecycleEvent(event) {
+    if (!event.session_id) {
+        throw new Error('ACP session event missing session_id');
+    }
+    if (!event.resource_uri || !event.resource_uri.startsWith('https://')) {
+        throw new Error('ACP session event missing or invalid resource_uri (must be https://)');
+    }
+    const evidence = {
+        acp_session_id: event.session_id,
+        acp_session_state: event.state,
+    };
+    if (event.delegated_payment_ref) {
+        evidence.delegated_payment_ref = event.delegated_payment_ref;
+    }
+    if (event.created_at)
+        evidence.created_at = event.created_at;
+    if (event.updated_at)
+        evidence.updated_at = event.updated_at;
+    // Access-kind evidence: no commerce extension, no payment rail
+    const payment = {
+        rail: 'acp',
+        reference: event.session_id,
+        amount: 0,
+        currency: 'NONE',
+        asset: 'NONE',
+        env: 'live',
+        evidence,
+    };
+    return {
+        subject_uri: event.resource_uri,
+        amt: 0,
+        cur: 'NONE',
+        payment,
+    };
+}
+// ---------------------------------------------------------------------------
+// Payment Observation (commerce-kind, requires explicit payment artifact)
+// ---------------------------------------------------------------------------
+/**
+ * Map an ACP session event with explicit payment artifact to PEAC commerce evidence.
+ *
+ * Only called when an explicit payment-bearing artifact with a known
+ * observed payment state is present alongside the session event.
+ * Commerce extension event is derived from observed_payment_state,
+ * NOT from the ACP session state.
+ *
+ * 'attempted' and 'failed' produce access evidence only (no commerce event).
+ */
+function fromACPPaymentObservation(event, paymentArtifact) {
+    if (!event.session_id) {
+        throw new Error('ACP session event missing session_id');
+    }
+    if (!event.resource_uri || !event.resource_uri.startsWith('https://')) {
+        throw new Error('ACP session event missing or invalid resource_uri (must be https://)');
+    }
+    if (!paymentArtifact.rail) {
+        throw new Error('Payment artifact missing rail');
+    }
+    if (!paymentArtifact.reference) {
+        throw new Error('Payment artifact missing reference');
+    }
+    if (!paymentArtifact.observed_payment_state) {
+        throw new Error('Payment artifact missing observed_payment_state');
+    }
+    const commerceEvent = PAYMENT_STATE_TO_COMMERCE_EVENT[paymentArtifact.observed_payment_state];
+    const evidence = {
+        acp_session_id: event.session_id,
+        acp_session_state: event.state,
+        observed_payment_state: paymentArtifact.observed_payment_state,
+    };
+    if (commerceEvent) {
+        evidence.commerce_event = commerceEvent;
+    }
+    if (event.delegated_payment_ref) {
+        evidence.delegated_payment_ref = event.delegated_payment_ref;
+    }
+    const payment = {
+        rail: paymentArtifact.rail,
+        reference: paymentArtifact.reference,
+        amount: paymentArtifact.amount,
+        currency: paymentArtifact.currency.toUpperCase(),
+        asset: paymentArtifact.currency.toUpperCase(),
+        env: 'live',
+        evidence,
+    };
+    return {
+        subject_uri: event.resource_uri,
+        amt: paymentArtifact.amount,
+        cur: paymentArtifact.currency.toUpperCase(),
+        payment,
+    };
+}
+// ---------------------------------------------------------------------------
+// Capability Snapshot (audit metadata)
+// ---------------------------------------------------------------------------
+/**
+ * Create an audit-friendly snapshot of ACP capability negotiation.
+ */
+function fromACPCapabilitySnapshot(negotiation) {
+    return {
+        session_id: negotiation.session_id,
+        seller_capabilities: negotiation.seller_capabilities ?? null,
+        buyer_capabilities: negotiation.buyer_capabilities ?? null,
+        negotiated: negotiation.negotiated ?? null,
+        extensions: negotiation.extensions ?? null,
+        snapshot_at: new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Intervention Required (challenge-kind)
+// ---------------------------------------------------------------------------
+/**
+ * Map an ACP intervention requirement to PEAC challenge-kind evidence.
+ */
+function fromACPInterventionRequired(intervention) {
+    if (!intervention.session_id) {
+        throw new Error('ACP intervention missing session_id');
+    }
+    if (!intervention.resource_uri || !intervention.resource_uri.startsWith('https://')) {
+        throw new Error('ACP intervention missing or invalid resource_uri (must be https://)');
+    }
+    const evidence = {
+        acp_session_id: intervention.session_id,
+        intervention_type: intervention.type,
+    };
+    if (intervention.reason)
+        evidence.reason = intervention.reason;
+    if (intervention.metadata) {
+        evidence.intervention_metadata = intervention.metadata;
+    }
+    const payment = {
+        rail: 'acp',
+        reference: intervention.session_id,
+        amount: 0,
+        currency: 'NONE',
+        asset: 'NONE',
+        env: 'live',
+        evidence,
+    };
+    return {
+        subject_uri: intervention.resource_uri,
+        amt: 0,
+        cur: 'NONE',
+        payment,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peac/mappings-acp",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "description": "Agentic Commerce Protocol (ACP) integration for PEAC",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,15 +23,15 @@
     "access": "public"
   },
   "dependencies": {
-    "@peac/kernel": "0.12.2",
-    "@peac/protocol": "0.12.2",
-    "@peac/schema": "0.12.2"
+    "@peac/schema": "0.12.4",
+    "@peac/protocol": "0.12.4",
+    "@peac/kernel": "0.12.4"
   },
   "devDependencies": {
     "@types/node": "^22.19.11",
     "typescript": "^5.3.3",
     "vitest": "^4.0.0",
-    "@peac/crypto": "0.12.2"
+    "@peac/crypto": "0.12.4"
   },
   "scripts": {
     "build": "tsc",