@xyz17711/emoji-match 0.1.1 → 0.1.2

package/README.md

@@ -25,10 +25,13 @@ npm install @xyz17711/emoji-match
 ```typescript
 import { Client } from "@xyz17711/emoji-match";
 
-const client = new Client("https://api.17711.xyz/registry/emoji-match-service");
+const client = new Client(); // talks to https://api.17711.xyz/registry/emoji-match-service by default
 // see the Methods table above for every available call and its request/response type
 ```
 
+Pass another base URL (self-hosted instance, test server) as the first argument:
+`new Client("https://my-host.example/registry/emoji-match-service")`.
+
 ## Paying past the free quota
 
 Every gated tool allows a small number of free calls per day; beyond that it returns a 402
@@ -38,7 +41,7 @@ network, and payee address attached:
 ```typescript
 import { Client, PaymentRequiredError } from "@xyz17711/emoji-match";
 
-const client = new Client("https://api.17711.xyz/registry/emoji-match-service");
+const client = new Client();
 try {
   await client.suggestEmojis(/* ... */);
 } catch (e) {
@@ -54,7 +57,7 @@ own environment/secrets manager, never a literal string in source code:
 ```typescript
 import { Client } from "@xyz17711/emoji-match";
 
-const client = new Client("https://api.17711.xyz/registry/emoji-match-service", {
+const client = new Client({
   x402PrivateKey: process.env.X402_PRIVATE_KEY,
   x402ExpectedNetwork: "eip155:8453", // Base mainnet; use eip155:84532 for Base Sepolia testnet
   x402MaxPaymentUsdc: 0.01,           // refuse any single call above this
@@ -73,7 +76,7 @@ with that same key in this process.
 import { Client } from "@xyz17711/emoji-match";
 import { EmojiMatchToolkit } from "@xyz17711/emoji-match/langchain";
 
-const client = new Client("https://api.17711.xyz/registry/emoji-match-service", { /* ...wallet options... */ });
+const client = new Client({ /* ...wallet options... */ });
 const tools = new EmojiMatchToolkit(client).getTools();
 ```
 

package/dist/index.d.ts

@@ -12,8 +12,17 @@ export interface SuggestEmojisRequest {
     /** The text to analyze. Works best in English or French; best-effort for 16 other languages (see the tool's own description). Truncated to a reasonable length before analysis if very long -- the response reflects the truncated text, not the full input. */
     text: string;
 }
+/** Production base URL of this service; pass another to self-host or test. */
+export declare const DEFAULT_BASE_URL = "https://api.17711.xyz/registry/emoji-match-service";
 /** Typed client for emoji-match-service, e.g. `client.suggestEmojis(...)`. */
 export declare class Client extends BaseClient {
+    /**
+     * `new Client()` talks to the production service. Pass a base URL to target another
+     * instance, and/or wallet options (`new Client({ x402PrivateKey, ... })`) to pay past the
+     * free quota automatically.
+     */
+    constructor(options?: ClientOptions);
+    constructor(baseUrl?: string, options?: ClientOptions);
     /** Emoji suggestion API: text in 18 languages in, the 1 to 5 best matching emoji out, deterministic and fast ($0.002, x402) */
     suggestEmojis(request: SuggestEmojisRequest): Promise<SuggestEmojisResponse>;
 }

package/dist/index.js

@@ -2,8 +2,16 @@
  * Typed HTTP client and request/response interfaces for emoji-match-service.
  */
 import { Client as BaseClient } from "@xyz17711/core";
+/** Production base URL of this service; pass another to self-host or test. */
+export const DEFAULT_BASE_URL = "https://api.17711.xyz/registry/emoji-match-service";
 /** Typed client for emoji-match-service, e.g. `client.suggestEmojis(...)`. */
 export class Client extends BaseClient {
+    constructor(baseUrlOrOptions, options = {}) {
+        const [url, opts] = typeof baseUrlOrOptions === "object"
+            ? [DEFAULT_BASE_URL, baseUrlOrOptions]
+            : [baseUrlOrOptions ?? DEFAULT_BASE_URL, options];
+        super(url, opts);
+    }
     /** Emoji suggestion API: text in 18 languages in, the 1 to 5 best matching emoji out, deterministic and fast ($0.002, x402) */
     async suggestEmojis(request) {
         return this.post("/v1/emoji-match/suggest_emojis", request);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyz17711/emoji-match",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Typed TypeScript client for the 17711.xyz Emoji Match API: pay-per-call, settled in USDC via x402.",
   "license": "MIT",
   "author": "17711 Services",