402mob-merchant-sdk 0.1.2 → 0.1.3

package/README.md

@@ -26,7 +26,7 @@ Install from npm:
 npm install 402mob-merchant-sdk
 ```
 
-Prepared package version: **0.1.2**. Publish this version before installing it from npm. See the [npm package page](https://www.npmjs.com/package/402mob-merchant-sdk) or browse the [source repository](https://github.com/gggggggg424242/402mob-merchant-sdk).
+The current published release is **0.1.2**. The working tree prepares **0.1.3** with a typed directory visibility method; publish it from the SDK package directory when ready. See the [npm package page](https://www.npmjs.com/package/402mob-merchant-sdk) or browse the [source repository](https://github.com/gggggggg424242/402mob-merchant-sdk).
 
 Requires Node.js 18 or newer. The SDK uses the built-in Fetch API and has no runtime dependencies.
 
@@ -56,6 +56,9 @@ const offer = await merchant.createOffer({
   result: { summary: "Prepared by the seller agent" },
 });
 
+// Make active offers searchable in the public merchant directory.
+await merchant.setDiscoverable(true);
+
 console.log({ offerId: offer.id, checkout: offer.checkout });
 ```
 
@@ -102,6 +105,7 @@ This action moves no USDC and grants no allowance, but it costs Base ETH for gas
 - `getMerchant()`
 - `createOffer(input)`
 - `setOfferActive(offerId, active)`
+- `setDiscoverable(discoverable)` — opt the merchant into or out of public offer search. Defaults to hidden.
 - `listSales(limit?)`
 - `getSale(operationId)`
 
@@ -130,6 +134,10 @@ See [`examples/enroll-and-publish.ts`](./examples/enroll-and-publish.ts) for an
 
 MIT licensed. See [LICENSE](./LICENSE).
 
+## Version 0.1.3 (unpublished)
+
+Adds `setDiscoverable(discoverable)`, which calls the authenticated `PUT /v1/agent/merchant/discovery` endpoint. The service controls visibility; enrollment still defaults to hidden. Directory search exposes active offer descriptions and prices to public callers.
+
 ## Version 0.1.2
 
-The source now rejects unreadable or incomplete successful API responses with `MerchantApiError` code `invalid_response`. Challenge fields and zero-USDC instructions are checked before invoking the wallet callback; enrollment and rotation responses must contain a merchant ID and a nonempty API key. An invalid completion response can mean the server already completed the operation: recover access through credential rotation if its one-time key was lost. The npm registry still serves 0.1.1 until 0.1.2 is published. Integrations using 0.1.1 should validate required fields explicitly. Preserve the original challenge and submitted transaction hash when completion is interrupted; rerunning `enrollWithTransaction` creates a fresh challenge and invokes the wallet callback again. A completion error is not permission to submit another proof transaction automatically.
+The source now rejects unreadable or incomplete successful API responses with `MerchantApiError` code `invalid_response`. Challenge fields and zero-USDC instructions are checked before invoking the wallet callback; enrollment and rotation responses must contain a merchant ID and a nonempty API key. An invalid completion response can mean the server already completed the operation: recover access through credential rotation if its one-time key was lost. This validation is included in published 0.1.2. Integrations using 0.1.1 should validate required fields explicitly. Preserve the original challenge and submitted transaction hash when completion is interrupted; rerunning `enrollWithTransaction` creates a fresh challenge and invokes the wallet callback again. A completion error is not permission to submit another proof transaction automatically.

package/dist/index.d.ts

@@ -33,6 +33,8 @@ export interface MerchantProfile {
     name: string;
     payoutAddress: EvmAddress;
     createdAt: string;
+    /** Present in authenticated merchant workspace responses; opt-in controls directory search. */
+    discoverable?: boolean;
 }
 export interface MerchantAgent {
     id: string;
@@ -209,6 +211,10 @@ export declare class MerchantClient {
     rotateWithSignature(input: CredentialRotationSignatureInput): Promise<CredentialRotationResult>;
     rotateWithTransaction(input: CredentialRotationTransactionInput): Promise<CredentialRotationResult>;
     getMerchant(): Promise<MerchantWorkspace>;
+    setDiscoverable(discoverable: boolean): Promise<{
+        merchantId: string;
+        discoverable: boolean;
+    }>;
     createOffer(input: CreateOfferInput): Promise<MerchantOffer>;
     setOfferActive(offerId: string, active: boolean): Promise<MerchantOffer>;
     listSales(limit?: number): Promise<SaleList>;

package/dist/index.js

@@ -97,6 +97,9 @@ export class MerchantClient {
     getMerchant() {
         return this.request("GET", "/v1/agent/merchant", undefined, true);
     }
+    setDiscoverable(discoverable) {
+        return this.request("PUT", "/v1/agent/merchant/discovery", { discoverable }, true);
+    }
     createOffer(input) {
         return this.request("POST", "/v1/agent/merchant/offers", input, true);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "402mob-merchant-sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Server-side TypeScript client for enrolling and operating 402Mob merchants.",
   "license": "MIT",
   "repository": {