@percayso-community/cayso-contracts 0.23.0 → 0.24.0

package/dist/assurance.js

@@ -488,6 +488,7 @@ export const OPERATION_FOR_ROUTE = {
     placeQuote: 'place-quote',
     withdrawQuote: 'withdraw-quote',
     requestBuyBack: 'request-buy-back',
+    marketplaceOrder: 'settle-marketplace-order',
     version: null,
 };
 /**

package/dist/client.d.ts

@@ -70,6 +70,7 @@
 import type { BuyBackMade, BuyBackRequest, CitizenMarketViewed, QuotePlaced, QuoteRequest, QuoteWithdrawalRequest, QuoteWithdrawn } from './citizen-market.js';
 import type { CitizenshipFounderClaimed, CitizenshipView } from './citizenship.js';
 import type { CommercialPaymentMade, CommercialPaymentRequest } from './commercial-payment.js';
+import type { MarketplaceOrderRequest, MarketplaceOrderSettled } from './marketplace-settlement.js';
 import type { OrganisationView } from './organisation.js';
 import type { PurchaseAuthorised, PurchaseCancelled, PurchaseRequest, PurchaseResult, PurchaseTerminal } from './purchase.js';
 import type { WalletView } from './wallet.js';
@@ -251,6 +252,18 @@ export interface CaysoClient {
      * and means nothing moved and nothing is paid.
      */
     requestBuyBack(req: BuyBackRequest): Promise<BuyBackMade>;
+    /**
+     * Present Store Platform's signed order to settle a house-publisher marketplace sale
+     * under the buyer's assertion (`settle-marketplace-order`, CAY-0082 §2, CAY-0083 §3),
+     * and receive Cayso's signed receipt — or REPLAY a sale already settled.
+     *
+     * Safe to repeat with no key of its own: the idempotency key is inside the signed
+     * order, and presenting the same order again answers the receipt already written
+     * (CAY-0082 §4). A refusal arrives as a thrown {@link CaysoApiError} whose `code` is
+     * a `MarketplaceOrderRefusal` member, one of the gate's codes, or a seam code, and
+     * means nothing moved.
+     */
+    settleMarketplaceOrder(req: MarketplaceOrderRequest): Promise<MarketplaceOrderSettled>;
     getVersion(): Promise<CaysoVersion>;
 }
 /**

package/dist/client.js

@@ -260,6 +260,16 @@ function buildClient(options, internals) {
                 idempotencyKey: req.idempotencyKey,
             });
         },
+        async settleMarketplaceOrder(req) {
+            return requestJson({
+                method: ROUTES.marketplaceOrder.method,
+                path: ROUTES.marketplaceOrder.path,
+                // Safe to repeat: the key is inside the signed order, and the same order
+                // presented again answers the receipt already written, never a second sale.
+                idempotent: true,
+                body: req,
+            });
+        },
         async getPurchase(purchaseId) {
             return requestJson({
                 method: ROUTES.purchaseResult.method,

package/dist/contract-schema.generated.js

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 export const CONTRACT_SCHEMA = {
-    "contractVersion": "0.23.0",
+    "contractVersion": "0.24.0",
     "packageName": "@percayso-community/cayso-contracts",
     "capabilities": {
         "wallet": "cayso.wallet",
@@ -73,6 +73,10 @@ export const CONTRACT_SCHEMA = {
             "method": "POST",
             "path": "/api/buy-backs"
         },
+        "marketplaceOrder": {
+            "method": "POST",
+            "path": "/api/marketplace/orders"
+        },
         "version": {
             "method": "GET",
             "path": "/api/version"
@@ -591,6 +595,15 @@ export const CONTRACT_SCHEMA = {
                     {
                         "literal": "receipt_signing_not_configured"
                     },
+                    {
+                        "literal": "marketplace_order_keys_not_configured"
+                    },
+                    {
+                        "literal": "marketplace_order_store_not_configured"
+                    },
+                    {
+                        "literal": "third_party_marketplace_sale_not_served"
+                    },
                     {
                         "literal": "invalid_request"
                     },

package/dist/errors.d.ts

@@ -151,6 +151,25 @@ export type CaysoApiErrorCode =
  * start.
  */
  | 'receipt_signing_not_configured'
+/**
+ * This deployment holds no registry of Store Platform order keys, so no signed
+ * order can be verified and no marketplace operation is served (CAY-0083 §4).
+ * Empty by default: a closed door, never a permissive one.
+ */
+ | 'marketplace_order_keys_not_configured'
+/**
+ * No marketplace sale store is wired, or this deployment has not been told which
+ * wallet is the Treasury a house-publisher sale is charged to (CAY-0082 §2).
+ */
+ | 'marketplace_order_store_not_configured'
+/**
+ * The signed order pays a Citizen publisher, and this version serves the
+ * house-publisher sale only (CAY-0082 §2). Nothing was checked against the payee and
+ * nothing moved. A seam code rather than a {@link MarketplaceOrderRefusal}, because it
+ * describes this deployment and not the order; the third-party sale retires it when
+ * it ships.
+ */
+ | 'third_party_marketplace_sale_not_served'
 /** The request body or parameters did not satisfy the declared schema. */
  | 'invalid_request'
 /** There is no such purchase under this caller's wallet. */

package/dist/index.d.ts

@@ -71,6 +71,13 @@
  * this money surface gains that Piper's own contracts lack, since theirs share
  * one global version bumped across all twenty-two together (CAY-0026).
  *
+ * `0.23.0` → `0.24.0` SERVES `settle-marketplace-order` for a house-publisher sale
+ * at `ROUTES.marketplaceOrder` (CAY-0082 §2, CAY-0083 §3), with the client method
+ * `settleMarketplaceOrder` and three seam codes: `marketplace_order_keys_not_configured`,
+ * `marketplace_order_store_not_configured` and `third_party_marketplace_sale_not_served`.
+ * It is BREAKING because two closed tables grew: `ROUTES` (so every total map over it,
+ * `OPERATION_FOR_ROUTE` included, needs the entry) and `CaysoApiErrorCode`.
+ *
  * `0.22.0` → `0.23.0` publishes the two money-grade marketplace operations and
  * CAY-0082 §7's closed refusal unions (CAY-0083 §3, #303), and it is BREAKING because
  * three closed tables grew:
@@ -479,7 +486,7 @@
  * have needed a breaking bump on their own. Under semver below `1.0.0` the minor
  * is where a breaking change goes, so the minor moves and the patch does not.
  */
-export declare const CONTRACT_VERSION: "0.23.0";
+export declare const CONTRACT_VERSION: "0.24.0";
 /** The package's own name, so a consumer can name what it depends on. */
 export declare const packageName = "@percayso-community/cayso-contracts";
 /**

package/dist/index.js

@@ -87,6 +87,13 @@
  * this money surface gains that Piper's own contracts lack, since theirs share
  * one global version bumped across all twenty-two together (CAY-0026).
  *
+ * `0.23.0` → `0.24.0` SERVES `settle-marketplace-order` for a house-publisher sale
+ * at `ROUTES.marketplaceOrder` (CAY-0082 §2, CAY-0083 §3), with the client method
+ * `settleMarketplaceOrder` and three seam codes: `marketplace_order_keys_not_configured`,
+ * `marketplace_order_store_not_configured` and `third_party_marketplace_sale_not_served`.
+ * It is BREAKING because two closed tables grew: `ROUTES` (so every total map over it,
+ * `OPERATION_FOR_ROUTE` included, needs the entry) and `CaysoApiErrorCode`.
+ *
  * `0.22.0` → `0.23.0` publishes the two money-grade marketplace operations and
  * CAY-0082 §7's closed refusal unions (CAY-0083 §3, #303), and it is BREAKING because
  * three closed tables grew:
@@ -495,7 +502,7 @@
  * have needed a breaking bump on their own. Under semver below `1.0.0` the minor
  * is where a breaking change goes, so the minor moves and the patch does not.
  */
-export const CONTRACT_VERSION = '0.23.0';
+export const CONTRACT_VERSION = '0.24.0';
 /** The package's own name, so a consumer can name what it depends on. */
 export const packageName = '@percayso-community/cayso-contracts';
 /**

package/dist/marketplace-settlement.d.ts

@@ -10,8 +10,9 @@
  * `ASSURANCE_POLICY`, which is an allowlist, so `dev-bypass` is never admissible and
  * a future method is not admissible without a policy decision (CAY-0029).
  *
- * **This is the contract surface only.** No route serves either operation, and
- * nothing here settles anything. The sale table, the registry of Store Platform order
+ * **This is the contract surface only.** Nothing here settles anything. Since
+ * `0.24.0` a route serves `settle-marketplace-order` for a house-publisher sale
+ * (`ROUTES.marketplaceOrder`); the third-party sale and the refund are not served. The sale table, the registry of Store Platform order
  * keys and the ledger stay in this proprietary tree (CAY-0083 §3).
  *
  * ## Two operations, because two authorities are checked
@@ -33,7 +34,7 @@
  * no way for a re-encoding to disagree with the signer by a space. Piper produces
  * the bytes with Store Platform's own published encoder
  * (`encodeSignedOrderStatement`, `encodeRefundDecisionStatement` in
- * `@percayso/store-contracts`), and never edits them.
+ * `@percayso-community/store-contracts`), and never edits them.
  *
  * The statements' fields are Store Platform's to define (`STO-0043`) and are not
  * restated here: a second copy of another pillar's format is two formats that

package/dist/routes.d.ts

@@ -148,6 +148,10 @@ export declare const ROUTES: {
         readonly method: "POST";
         readonly path: "/api/buy-backs";
     };
+    readonly marketplaceOrder: {
+        readonly method: "POST";
+        readonly path: "/api/marketplace/orders";
+    };
     readonly version: {
         readonly method: "GET";
         readonly path: "/api/version";

package/dist/routes.js

@@ -124,5 +124,6 @@ export const ROUTES = {
     placeQuote: { method: 'POST', path: '/api/quotes' },
     withdrawQuote: { method: 'POST', path: '/api/quote-withdrawals' },
     requestBuyBack: { method: 'POST', path: '/api/buy-backs' },
+    marketplaceOrder: { method: 'POST', path: '/api/marketplace/orders' },
     version: { method: 'GET', path: '/api/version' },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@percayso-community/cayso-contracts",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "The versioned capability contract surface through which anything outside this repository reads a wallet. Published; keep it the Piper-facing surface only.",
   "license": "Apache-2.0",
   "repository": {