@zeroxyz/sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,150 @@
+'use strict';
+
+var chunk7STN754W_cjs = require('./chunk-7STN754W.cjs');
+
+// src/status.ts
+var AVAILABILITY_BADGES = {
+  healthy: { symbol: "\u2713", color: "green", label: "Healthy" },
+  unknown: { symbol: "?", color: "yellow", label: "Unknown" },
+  down: { symbol: "\u2717", color: "red", label: "Down" }
+};
+var STATUS_RANK = {
+  healthy: 0,
+  unknown: 1,
+  down: 2
+};
+var rankOf = (status) => (
+  // Missing/null status is treated as `unknown` — "we don't know" ranks
+  // above a confirmed `down` but below a proven `healthy`.
+  status == null ? STATUS_RANK.unknown : STATUS_RANK[status]
+);
+var sortByHealth = (items) => [...items].sort(
+  (a, b) => rankOf(a.availabilityStatus) - rankOf(b.availabilityStatus)
+);
+var preferHealthy = sortByHealth;
+
+Object.defineProperty(exports, "Auth", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.Auth; }
+});
+Object.defineProperty(exports, "AuthDevice", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.AuthDevice; }
+});
+Object.defineProperty(exports, "BUG_REPORT_CATEGORIES", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.BUG_REPORT_CATEGORIES; }
+});
+Object.defineProperty(exports, "BugReports", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.BugReports; }
+});
+Object.defineProperty(exports, "Capabilities", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.Capabilities; }
+});
+Object.defineProperty(exports, "DEFAULT_BASE_URL", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.DEFAULT_BASE_URL; }
+});
+Object.defineProperty(exports, "DEFAULT_MAX_RETRIES", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.DEFAULT_MAX_RETRIES; }
+});
+Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.DEFAULT_TIMEOUT_MS; }
+});
+Object.defineProperty(exports, "FETCH_SKIP_REASONS", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.FETCH_SKIP_REASONS; }
+});
+Object.defineProperty(exports, "FETCH_WARNINGS", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.FETCH_WARNINGS; }
+});
+Object.defineProperty(exports, "Payments", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.Payments; }
+});
+Object.defineProperty(exports, "Runs", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.Runs; }
+});
+Object.defineProperty(exports, "SDK_VERSION", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.SDK_VERSION; }
+});
+Object.defineProperty(exports, "TEMPO_CHAIN_ID", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.TEMPO_CHAIN_ID; }
+});
+Object.defineProperty(exports, "TEMPO_TESTNET_CHAIN_ID", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.TEMPO_TESTNET_CHAIN_ID; }
+});
+Object.defineProperty(exports, "Wallet", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.Wallet; }
+});
+Object.defineProperty(exports, "ZeroApiError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroApiError; }
+});
+Object.defineProperty(exports, "ZeroAuthError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroAuthError; }
+});
+Object.defineProperty(exports, "ZeroClient", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroClient; }
+});
+Object.defineProperty(exports, "ZeroConfigurationError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroConfigurationError; }
+});
+Object.defineProperty(exports, "ZeroError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroError; }
+});
+Object.defineProperty(exports, "ZeroPaymentError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroPaymentError; }
+});
+Object.defineProperty(exports, "ZeroSessionCloseFailedError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroSessionCloseFailedError; }
+});
+Object.defineProperty(exports, "ZeroTimeoutError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroTimeoutError; }
+});
+Object.defineProperty(exports, "ZeroValidationError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroValidationError; }
+});
+Object.defineProperty(exports, "ZeroWalletError", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.ZeroWalletError; }
+});
+Object.defineProperty(exports, "coerceTempoChainId", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.coerceTempoChainId; }
+});
+Object.defineProperty(exports, "createManagedAccount", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.createManagedAccount; }
+});
+Object.defineProperty(exports, "paymentHasAnchor", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.paymentHasAnchor; }
+});
+Object.defineProperty(exports, "tempoChainLabelFromId", {
+  enumerable: true,
+  get: function () { return chunk7STN754W_cjs.tempoChainLabelFromId; }
+});
+exports.AVAILABILITY_BADGES = AVAILABILITY_BADGES;
+exports.preferHealthy = preferHealthy;
+exports.sortByHealth = sortByHealth;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/status.ts"],"names":[],"mappings":";;;;;AAoCO,IAAM,mBAAA,GAAsB;AAAA,EAClC,SAAS,EAAE,MAAA,EAAQ,UAAK,KAAA,EAAO,OAAA,EAAS,OAAO,SAAA,EAAU;AAAA,EACzD,SAAS,EAAE,MAAA,EAAQ,KAAK,KAAA,EAAO,QAAA,EAAU,OAAO,SAAA,EAAU;AAAA,EAC1D,MAAM,EAAE,MAAA,EAAQ,UAAK,KAAA,EAAO,KAAA,EAAO,OAAO,MAAA;AAC3C;AAGA,IAAM,WAAA,GAAkD;AAAA,EACvD,OAAA,EAAS,CAAA;AAAA,EACT,OAAA,EAAS,CAAA;AAAA,EACT,IAAA,EAAM;AACP,CAAA;AAEA,IAAM,SAAS,CAAC,MAAA;AAAA;AAAA;AAAA,EAGf,MAAA,IAAU,IAAA,GAAO,WAAA,CAAY,OAAA,GAAU,YAAY,MAAM;AAAA,CAAA;AAUnD,IAAM,eAAe,CAG3B,KAAA,KAEA,CAAC,GAAG,KAAK,CAAA,CAAE,IAAA;AAAA,EACV,CAAC,GAAG,CAAA,KAAM,MAAA,CAAO,EAAE,kBAAkB,CAAA,GAAI,MAAA,CAAO,CAAA,CAAE,kBAAkB;AACrE;AAMM,IAAM,aAAA,GAAgB","file":"index.cjs","sourcesContent":["/**\n * Capability availability status — the single, consolidated health signal\n * Zero surfaces to clients (ZERO-89 / ZERO-92).\n *\n * - `healthy` — proven live and executable; safe to call.\n * - `unknown` — insufficient evidence either way; usable as a fallback.\n * - `down`    — confirmed dead / failing; avoid.\n *\n * Preference rule for agents: PREFER `healthy`. Fall back to `unknown` only\n * when nothing `healthy` fits the task. Avoid `down`. This is the same rule the\n * server-side visibility filter enforces, surfaced here so agents and UIs can\n * rank consistently.\n */\nexport type AvailabilityStatus = \"healthy\" | \"unknown\" | \"down\";\n\n/** A renderable badge for an {@link AvailabilityStatus}. */\nexport type AvailabilityBadge = {\n\t/** A short glyph suitable for terminals/UI (✓ / ? / ✗). */\n\tsymbol: string;\n\t/**\n\t * A color *name* (not ANSI/hex) — this SDK is environment-agnostic, so\n\t * consumers map the name to whatever their renderer needs.\n\t */\n\tcolor: \"green\" | \"yellow\" | \"red\";\n\t/** Human-readable label. */\n\tlabel: string;\n};\n\n/**\n * Badge metadata for each {@link AvailabilityStatus}. Exhaustively keyed via\n * `satisfies` so adding/removing a status value is a compile error here.\n *\n * - healthy → green check\n * - unknown → yellow question\n * - down    → red cross\n */\nexport const AVAILABILITY_BADGES = {\n\thealthy: { symbol: \"✓\", color: \"green\", label: \"Healthy\" },\n\tunknown: { symbol: \"?\", color: \"yellow\", label: \"Unknown\" },\n\tdown: { symbol: \"✗\", color: \"red\", label: \"Down\" },\n} as const satisfies Record<AvailabilityStatus, AvailabilityBadge>;\n\n// Lower rank sorts first: healthy ahead of unknown ahead of down.\nconst STATUS_RANK: Record<AvailabilityStatus, number> = {\n\thealthy: 0,\n\tunknown: 1,\n\tdown: 2,\n};\n\nconst rankOf = (status: AvailabilityStatus | null | undefined): number =>\n\t// Missing/null status is treated as `unknown` — \"we don't know\" ranks\n\t// above a confirmed `down` but below a proven `healthy`.\n\tstatus == null ? STATUS_RANK.unknown : STATUS_RANK[status];\n\n/**\n * Stable-sort capabilities by health: `healthy` > `unknown` > `down`.\n *\n * Agents should PREFER `healthy` and fall back to `unknown` only when nothing\n * `healthy` fits; `down` is last. A missing/null status is ranked as\n * `unknown`. Returns a NEW array — the input is not mutated. Items of equal\n * rank keep their original relative order (stable).\n */\nexport const sortByHealth = <\n\tT extends { availabilityStatus?: AvailabilityStatus | null },\n>(\n\titems: readonly T[],\n): T[] =>\n\t[...items].sort(\n\t\t(a, b) => rankOf(a.availabilityStatus) - rankOf(b.availabilityStatus),\n\t);\n\n/**\n * Alias for {@link sortByHealth}. The preference rule is \"prefer healthy, fall\n * back to unknown\" — applying it to a list means sorting healthy-first.\n */\nexport const preferHealthy = sortByHealth;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,148 @@
+import { Z as ZeroClient, P as PaymentSessionMeta } from './client-B50UYxPr.cjs';
+export { A as AccountCredentials, g as Auth, h as AuthDevice, _ as BUG_REPORT_CATEGORIES, w as BalanceOptions, x as BalanceReadError, a7 as BatchReviewResponse, $ as BugReportCategory, B as BugReports, i as Capabilities, a2 as CapabilityResponse, E as ClientOptions, a0 as CreateBugReportInput, a1 as CreateBugReportResponse, a8 as CreateReviewInput, a9 as CreateReviewResponse, aa as CreateRunInput, ab as CreateRunResponse, C as Credentials, G as DEFAULT_BASE_URL, H as DEFAULT_MAX_RETRIES, I as DEFAULT_TIMEOUT_MS, a4 as DevicePollResult, a5 as DeviceStartResponse, q as FETCH_SKIP_REASONS, r as FETCH_WARNINGS, F as FetchOptions, b as FetchOutcome, c as FetchResult, y as FundingUrlOptions, a3 as GetCapabilityOptions, Q as InternalUserDto, ac as ListRunsParams, ad as ListRunsResponse, L as LogEvent, K as LogLevel, J as Logger, M as MigrateAuthorization, z as MigrateAuthorizationResponse, N as NoCredentials, O as OnSessionRefreshed, j as PayInput, n as PayResult, k as PaymentChain, l as PaymentProtocol, m as PaymentResult, s as Payments, V as PublicUserDto, ae as RunListItem, R as Runs, af as SearchOptions, ag as SearchResponse, ah as SearchResult, S as SessionCredentials, a as SessionCredentialsInput, a6 as SessionExchangeResponse, o as SessionReceiptPayload, d as SignMessageInput, e as SignTransactionInput, f as SignTypedDataInput, T as TEMPO_CHAIN_ID, u as TEMPO_TESTNET_CHAIN_ID, U as UpstreamError, X as UserWalletDto, D as Wallet, W as WalletBalance, Y as WelcomeBonusSummary, p as coerceTempoChainId, t as paymentHasAnchor, v as tempoChainLabelFromId } from './client-B50UYxPr.cjs';
+import { Address, LocalAccount } from 'viem';
+import { z } from 'zod';
+
+declare const createManagedAccount: (client: ZeroClient, address: Address) => LocalAccount;
+
+type ZeroErrorCode = "api_error" | "auth_error" | "auth_session_expired" | "auth_no_credentials" | "payment_error" | "payment_session_close_failed" | "wallet_error" | "validation_error" | "timeout_error" | "configuration_error";
+type ZeroErrorOptions = {
+    cause?: unknown;
+};
+declare class ZeroError extends Error {
+    readonly code: ZeroErrorCode;
+    constructor(code: ZeroErrorCode, message: string, options?: ZeroErrorOptions);
+}
+type ApiErrorInit = {
+    status: number;
+    requestId?: string | undefined;
+    body?: unknown;
+    cause?: unknown;
+};
+declare class ZeroApiError extends ZeroError {
+    readonly status: number;
+    readonly requestId: string | undefined;
+    readonly body: unknown;
+    constructor(message: string, init: ApiErrorInit);
+}
+type AuthErrorCode = Extract<ZeroErrorCode, "auth_error" | "auth_session_expired" | "auth_no_credentials">;
+declare class ZeroAuthError extends ZeroError {
+    constructor(code: AuthErrorCode, message: string, options?: ZeroErrorOptions);
+}
+declare class ZeroPaymentError extends ZeroError {
+    constructor(message: string, options?: ZeroErrorOptions);
+}
+type SessionCloseFailedInit = {
+    session: PaymentSessionMeta;
+    response: Response;
+    capturedAmount: string;
+    cause?: unknown;
+};
+declare class ZeroSessionCloseFailedError extends ZeroError {
+    readonly session: PaymentSessionMeta;
+    readonly response: Response;
+    readonly capturedAmount: string;
+    constructor(message: string, init: SessionCloseFailedInit);
+}
+declare class ZeroWalletError extends ZeroError {
+    constructor(message: string, options?: ZeroErrorOptions);
+}
+type ValidationErrorOptions = ZeroErrorOptions & {
+    body?: string;
+};
+declare class ZeroValidationError extends ZeroError {
+    readonly body: string | undefined;
+    constructor(message: string, options?: ValidationErrorOptions);
+}
+declare class ZeroTimeoutError extends ZeroError {
+    constructor(message: string, options?: ZeroErrorOptions);
+}
+declare class ZeroConfigurationError extends ZeroError {
+    constructor(message: string, options?: ZeroErrorOptions);
+}
+
+declare const ratingSchema: z.ZodObject<{
+    score: z.ZodString;
+    successRate: z.ZodString;
+    reviews: z.ZodNumber;
+    stars: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    state: z.ZodOptional<z.ZodEnum<{
+        unrated: "unrated";
+        rated: "rated";
+    }>>;
+}, z.core.$strip>;
+type Rating = z.infer<typeof ratingSchema>;
+
+/**
+ * Capability availability status — the single, consolidated health signal
+ * Zero surfaces to clients (ZERO-89 / ZERO-92).
+ *
+ * - `healthy` — proven live and executable; safe to call.
+ * - `unknown` — insufficient evidence either way; usable as a fallback.
+ * - `down`    — confirmed dead / failing; avoid.
+ *
+ * Preference rule for agents: PREFER `healthy`. Fall back to `unknown` only
+ * when nothing `healthy` fits the task. Avoid `down`. This is the same rule the
+ * server-side visibility filter enforces, surfaced here so agents and UIs can
+ * rank consistently.
+ */
+type AvailabilityStatus = "healthy" | "unknown" | "down";
+/** A renderable badge for an {@link AvailabilityStatus}. */
+type AvailabilityBadge = {
+    /** A short glyph suitable for terminals/UI (✓ / ? / ✗). */
+    symbol: string;
+    /**
+     * A color *name* (not ANSI/hex) — this SDK is environment-agnostic, so
+     * consumers map the name to whatever their renderer needs.
+     */
+    color: "green" | "yellow" | "red";
+    /** Human-readable label. */
+    label: string;
+};
+/**
+ * Badge metadata for each {@link AvailabilityStatus}. Exhaustively keyed via
+ * `satisfies` so adding/removing a status value is a compile error here.
+ *
+ * - healthy → green check
+ * - unknown → yellow question
+ * - down    → red cross
+ */
+declare const AVAILABILITY_BADGES: {
+    readonly healthy: {
+        readonly symbol: "✓";
+        readonly color: "green";
+        readonly label: "Healthy";
+    };
+    readonly unknown: {
+        readonly symbol: "?";
+        readonly color: "yellow";
+        readonly label: "Unknown";
+    };
+    readonly down: {
+        readonly symbol: "✗";
+        readonly color: "red";
+        readonly label: "Down";
+    };
+};
+/**
+ * Stable-sort capabilities by health: `healthy` > `unknown` > `down`.
+ *
+ * Agents should PREFER `healthy` and fall back to `unknown` only when nothing
+ * `healthy` fits; `down` is last. A missing/null status is ranked as
+ * `unknown`. Returns a NEW array — the input is not mutated. Items of equal
+ * rank keep their original relative order (stable).
+ */
+declare const sortByHealth: <T extends {
+    availabilityStatus?: AvailabilityStatus | null;
+}>(items: readonly T[]) => T[];
+/**
+ * Alias for {@link sortByHealth}. The preference rule is "prefer healthy, fall
+ * back to unknown" — applying it to a list means sorting healthy-first.
+ */
+declare const preferHealthy: <T extends {
+    availabilityStatus?: AvailabilityStatus | null;
+}>(items: readonly T[]) => T[];
+
+declare const SDK_VERSION: string;
+
+export { AVAILABILITY_BADGES, type AvailabilityBadge, type AvailabilityStatus, PaymentSessionMeta, type Rating, SDK_VERSION, ZeroApiError, ZeroAuthError, ZeroClient, ZeroConfigurationError, ZeroError, type ZeroErrorCode, ZeroPaymentError, ZeroSessionCloseFailedError, ZeroTimeoutError, ZeroValidationError, ZeroWalletError, createManagedAccount, preferHealthy, sortByHealth };

package/dist/index.d.ts

@@ -0,0 +1,148 @@
+import { Z as ZeroClient, P as PaymentSessionMeta } from './client-B50UYxPr.js';
+export { A as AccountCredentials, g as Auth, h as AuthDevice, _ as BUG_REPORT_CATEGORIES, w as BalanceOptions, x as BalanceReadError, a7 as BatchReviewResponse, $ as BugReportCategory, B as BugReports, i as Capabilities, a2 as CapabilityResponse, E as ClientOptions, a0 as CreateBugReportInput, a1 as CreateBugReportResponse, a8 as CreateReviewInput, a9 as CreateReviewResponse, aa as CreateRunInput, ab as CreateRunResponse, C as Credentials, G as DEFAULT_BASE_URL, H as DEFAULT_MAX_RETRIES, I as DEFAULT_TIMEOUT_MS, a4 as DevicePollResult, a5 as DeviceStartResponse, q as FETCH_SKIP_REASONS, r as FETCH_WARNINGS, F as FetchOptions, b as FetchOutcome, c as FetchResult, y as FundingUrlOptions, a3 as GetCapabilityOptions, Q as InternalUserDto, ac as ListRunsParams, ad as ListRunsResponse, L as LogEvent, K as LogLevel, J as Logger, M as MigrateAuthorization, z as MigrateAuthorizationResponse, N as NoCredentials, O as OnSessionRefreshed, j as PayInput, n as PayResult, k as PaymentChain, l as PaymentProtocol, m as PaymentResult, s as Payments, V as PublicUserDto, ae as RunListItem, R as Runs, af as SearchOptions, ag as SearchResponse, ah as SearchResult, S as SessionCredentials, a as SessionCredentialsInput, a6 as SessionExchangeResponse, o as SessionReceiptPayload, d as SignMessageInput, e as SignTransactionInput, f as SignTypedDataInput, T as TEMPO_CHAIN_ID, u as TEMPO_TESTNET_CHAIN_ID, U as UpstreamError, X as UserWalletDto, D as Wallet, W as WalletBalance, Y as WelcomeBonusSummary, p as coerceTempoChainId, t as paymentHasAnchor, v as tempoChainLabelFromId } from './client-B50UYxPr.js';
+import { Address, LocalAccount } from 'viem';
+import { z } from 'zod';
+
+declare const createManagedAccount: (client: ZeroClient, address: Address) => LocalAccount;
+
+type ZeroErrorCode = "api_error" | "auth_error" | "auth_session_expired" | "auth_no_credentials" | "payment_error" | "payment_session_close_failed" | "wallet_error" | "validation_error" | "timeout_error" | "configuration_error";
+type ZeroErrorOptions = {
+    cause?: unknown;
+};
+declare class ZeroError extends Error {
+    readonly code: ZeroErrorCode;
+    constructor(code: ZeroErrorCode, message: string, options?: ZeroErrorOptions);
+}
+type ApiErrorInit = {
+    status: number;
+    requestId?: string | undefined;
+    body?: unknown;
+    cause?: unknown;
+};
+declare class ZeroApiError extends ZeroError {
+    readonly status: number;
+    readonly requestId: string | undefined;
+    readonly body: unknown;
+    constructor(message: string, init: ApiErrorInit);
+}
+type AuthErrorCode = Extract<ZeroErrorCode, "auth_error" | "auth_session_expired" | "auth_no_credentials">;
+declare class ZeroAuthError extends ZeroError {
+    constructor(code: AuthErrorCode, message: string, options?: ZeroErrorOptions);
+}
+declare class ZeroPaymentError extends ZeroError {
+    constructor(message: string, options?: ZeroErrorOptions);
+}
+type SessionCloseFailedInit = {
+    session: PaymentSessionMeta;
+    response: Response;
+    capturedAmount: string;
+    cause?: unknown;
+};
+declare class ZeroSessionCloseFailedError extends ZeroError {
+    readonly session: PaymentSessionMeta;
+    readonly response: Response;
+    readonly capturedAmount: string;
+    constructor(message: string, init: SessionCloseFailedInit);
+}
+declare class ZeroWalletError extends ZeroError {
+    constructor(message: string, options?: ZeroErrorOptions);
+}
+type ValidationErrorOptions = ZeroErrorOptions & {
+    body?: string;
+};
+declare class ZeroValidationError extends ZeroError {
+    readonly body: string | undefined;
+    constructor(message: string, options?: ValidationErrorOptions);
+}
+declare class ZeroTimeoutError extends ZeroError {
+    constructor(message: string, options?: ZeroErrorOptions);
+}
+declare class ZeroConfigurationError extends ZeroError {
+    constructor(message: string, options?: ZeroErrorOptions);
+}
+
+declare const ratingSchema: z.ZodObject<{
+    score: z.ZodString;
+    successRate: z.ZodString;
+    reviews: z.ZodNumber;
+    stars: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    state: z.ZodOptional<z.ZodEnum<{
+        unrated: "unrated";
+        rated: "rated";
+    }>>;
+}, z.core.$strip>;
+type Rating = z.infer<typeof ratingSchema>;
+
+/**
+ * Capability availability status — the single, consolidated health signal
+ * Zero surfaces to clients (ZERO-89 / ZERO-92).
+ *
+ * - `healthy` — proven live and executable; safe to call.
+ * - `unknown` — insufficient evidence either way; usable as a fallback.
+ * - `down`    — confirmed dead / failing; avoid.
+ *
+ * Preference rule for agents: PREFER `healthy`. Fall back to `unknown` only
+ * when nothing `healthy` fits the task. Avoid `down`. This is the same rule the
+ * server-side visibility filter enforces, surfaced here so agents and UIs can
+ * rank consistently.
+ */
+type AvailabilityStatus = "healthy" | "unknown" | "down";
+/** A renderable badge for an {@link AvailabilityStatus}. */
+type AvailabilityBadge = {
+    /** A short glyph suitable for terminals/UI (✓ / ? / ✗). */
+    symbol: string;
+    /**
+     * A color *name* (not ANSI/hex) — this SDK is environment-agnostic, so
+     * consumers map the name to whatever their renderer needs.
+     */
+    color: "green" | "yellow" | "red";
+    /** Human-readable label. */
+    label: string;
+};
+/**
+ * Badge metadata for each {@link AvailabilityStatus}. Exhaustively keyed via
+ * `satisfies` so adding/removing a status value is a compile error here.
+ *
+ * - healthy → green check
+ * - unknown → yellow question
+ * - down    → red cross
+ */
+declare const AVAILABILITY_BADGES: {
+    readonly healthy: {
+        readonly symbol: "✓";
+        readonly color: "green";
+        readonly label: "Healthy";
+    };
+    readonly unknown: {
+        readonly symbol: "?";
+        readonly color: "yellow";
+        readonly label: "Unknown";
+    };
+    readonly down: {
+        readonly symbol: "✗";
+        readonly color: "red";
+        readonly label: "Down";
+    };
+};
+/**
+ * Stable-sort capabilities by health: `healthy` > `unknown` > `down`.
+ *
+ * Agents should PREFER `healthy` and fall back to `unknown` only when nothing
+ * `healthy` fits; `down` is last. A missing/null status is ranked as
+ * `unknown`. Returns a NEW array — the input is not mutated. Items of equal
+ * rank keep their original relative order (stable).
+ */
+declare const sortByHealth: <T extends {
+    availabilityStatus?: AvailabilityStatus | null;
+}>(items: readonly T[]) => T[];
+/**
+ * Alias for {@link sortByHealth}. The preference rule is "prefer healthy, fall
+ * back to unknown" — applying it to a list means sorting healthy-first.
+ */
+declare const preferHealthy: <T extends {
+    availabilityStatus?: AvailabilityStatus | null;
+}>(items: readonly T[]) => T[];
+
+declare const SDK_VERSION: string;
+
+export { AVAILABILITY_BADGES, type AvailabilityBadge, type AvailabilityStatus, PaymentSessionMeta, type Rating, SDK_VERSION, ZeroApiError, ZeroAuthError, ZeroClient, ZeroConfigurationError, ZeroError, type ZeroErrorCode, ZeroPaymentError, ZeroSessionCloseFailedError, ZeroTimeoutError, ZeroValidationError, ZeroWalletError, createManagedAccount, preferHealthy, sortByHealth };

package/dist/index.js

@@ -0,0 +1,26 @@
+export { Auth, AuthDevice, BUG_REPORT_CATEGORIES, BugReports, Capabilities, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, FETCH_SKIP_REASONS, FETCH_WARNINGS, Payments, Runs, SDK_VERSION, TEMPO_CHAIN_ID, TEMPO_TESTNET_CHAIN_ID, Wallet, ZeroApiError, ZeroAuthError, ZeroClient, ZeroConfigurationError, ZeroError, ZeroPaymentError, ZeroSessionCloseFailedError, ZeroTimeoutError, ZeroValidationError, ZeroWalletError, coerceTempoChainId, createManagedAccount, paymentHasAnchor, tempoChainLabelFromId } from './chunk-XQEHJX2X.js';
+
+// src/status.ts
+var AVAILABILITY_BADGES = {
+  healthy: { symbol: "\u2713", color: "green", label: "Healthy" },
+  unknown: { symbol: "?", color: "yellow", label: "Unknown" },
+  down: { symbol: "\u2717", color: "red", label: "Down" }
+};
+var STATUS_RANK = {
+  healthy: 0,
+  unknown: 1,
+  down: 2
+};
+var rankOf = (status) => (
+  // Missing/null status is treated as `unknown` — "we don't know" ranks
+  // above a confirmed `down` but below a proven `healthy`.
+  status == null ? STATUS_RANK.unknown : STATUS_RANK[status]
+);
+var sortByHealth = (items) => [...items].sort(
+  (a, b) => rankOf(a.availabilityStatus) - rankOf(b.availabilityStatus)
+);
+var preferHealthy = sortByHealth;
+
+export { AVAILABILITY_BADGES, preferHealthy, sortByHealth };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/status.ts"],"names":[],"mappings":";;;AAoCO,IAAM,mBAAA,GAAsB;AAAA,EAClC,SAAS,EAAE,MAAA,EAAQ,UAAK,KAAA,EAAO,OAAA,EAAS,OAAO,SAAA,EAAU;AAAA,EACzD,SAAS,EAAE,MAAA,EAAQ,KAAK,KAAA,EAAO,QAAA,EAAU,OAAO,SAAA,EAAU;AAAA,EAC1D,MAAM,EAAE,MAAA,EAAQ,UAAK,KAAA,EAAO,KAAA,EAAO,OAAO,MAAA;AAC3C;AAGA,IAAM,WAAA,GAAkD;AAAA,EACvD,OAAA,EAAS,CAAA;AAAA,EACT,OAAA,EAAS,CAAA;AAAA,EACT,IAAA,EAAM;AACP,CAAA;AAEA,IAAM,SAAS,CAAC,MAAA;AAAA;AAAA;AAAA,EAGf,MAAA,IAAU,IAAA,GAAO,WAAA,CAAY,OAAA,GAAU,YAAY,MAAM;AAAA,CAAA;AAUnD,IAAM,eAAe,CAG3B,KAAA,KAEA,CAAC,GAAG,KAAK,CAAA,CAAE,IAAA;AAAA,EACV,CAAC,GAAG,CAAA,KAAM,MAAA,CAAO,EAAE,kBAAkB,CAAA,GAAI,MAAA,CAAO,CAAA,CAAE,kBAAkB;AACrE;AAMM,IAAM,aAAA,GAAgB","file":"index.js","sourcesContent":["/**\n * Capability availability status — the single, consolidated health signal\n * Zero surfaces to clients (ZERO-89 / ZERO-92).\n *\n * - `healthy` — proven live and executable; safe to call.\n * - `unknown` — insufficient evidence either way; usable as a fallback.\n * - `down`    — confirmed dead / failing; avoid.\n *\n * Preference rule for agents: PREFER `healthy`. Fall back to `unknown` only\n * when nothing `healthy` fits the task. Avoid `down`. This is the same rule the\n * server-side visibility filter enforces, surfaced here so agents and UIs can\n * rank consistently.\n */\nexport type AvailabilityStatus = \"healthy\" | \"unknown\" | \"down\";\n\n/** A renderable badge for an {@link AvailabilityStatus}. */\nexport type AvailabilityBadge = {\n\t/** A short glyph suitable for terminals/UI (✓ / ? / ✗). */\n\tsymbol: string;\n\t/**\n\t * A color *name* (not ANSI/hex) — this SDK is environment-agnostic, so\n\t * consumers map the name to whatever their renderer needs.\n\t */\n\tcolor: \"green\" | \"yellow\" | \"red\";\n\t/** Human-readable label. */\n\tlabel: string;\n};\n\n/**\n * Badge metadata for each {@link AvailabilityStatus}. Exhaustively keyed via\n * `satisfies` so adding/removing a status value is a compile error here.\n *\n * - healthy → green check\n * - unknown → yellow question\n * - down    → red cross\n */\nexport const AVAILABILITY_BADGES = {\n\thealthy: { symbol: \"✓\", color: \"green\", label: \"Healthy\" },\n\tunknown: { symbol: \"?\", color: \"yellow\", label: \"Unknown\" },\n\tdown: { symbol: \"✗\", color: \"red\", label: \"Down\" },\n} as const satisfies Record<AvailabilityStatus, AvailabilityBadge>;\n\n// Lower rank sorts first: healthy ahead of unknown ahead of down.\nconst STATUS_RANK: Record<AvailabilityStatus, number> = {\n\thealthy: 0,\n\tunknown: 1,\n\tdown: 2,\n};\n\nconst rankOf = (status: AvailabilityStatus | null | undefined): number =>\n\t// Missing/null status is treated as `unknown` — \"we don't know\" ranks\n\t// above a confirmed `down` but below a proven `healthy`.\n\tstatus == null ? STATUS_RANK.unknown : STATUS_RANK[status];\n\n/**\n * Stable-sort capabilities by health: `healthy` > `unknown` > `down`.\n *\n * Agents should PREFER `healthy` and fall back to `unknown` only when nothing\n * `healthy` fits; `down` is last. A missing/null status is ranked as\n * `unknown`. Returns a NEW array — the input is not mutated. Items of equal\n * rank keep their original relative order (stable).\n */\nexport const sortByHealth = <\n\tT extends { availabilityStatus?: AvailabilityStatus | null },\n>(\n\titems: readonly T[],\n): T[] =>\n\t[...items].sort(\n\t\t(a, b) => rankOf(a.availabilityStatus) - rankOf(b.availabilityStatus),\n\t);\n\n/**\n * Alias for {@link sortByHealth}. The preference rule is \"prefer healthy, fall\n * back to unknown\" — applying it to a list means sorting healthy-first.\n */\nexport const preferHealthy = sortByHealth;\n"]}

package/dist/testing.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+var chunk7STN754W_cjs = require('./chunk-7STN754W.cjs');
+
+// src/testing/index.ts
+var FALLBACK_HANDLER = (request) => {
+  const url = new URL(request.url);
+  return new Response(
+    JSON.stringify({
+      error: `No mock handler registered for ${request.method} ${url.pathname}`
+    }),
+    {
+      status: 404,
+      headers: { "content-type": "application/json" }
+    }
+  );
+};
+var createMockFetch = (routes) => {
+  const impl = async (input, init) => {
+    const request = new Request(input, init);
+    const url = new URL(request.url);
+    const key = `${request.method} ${url.pathname}`;
+    const handler = routes[key] ?? FALLBACK_HANDLER;
+    return await handler(request);
+  };
+  return impl;
+};
+var respondJson = (body, init) => new Response(JSON.stringify(body), {
+  status: init?.status ?? 200,
+  headers: {
+    "content-type": "application/json",
+    ...init?.headers
+  }
+});
+var createTestClient = (opts = {}) => {
+  const { routes, ...rest } = opts;
+  return new chunk7STN754W_cjs.ZeroClient({
+    ...rest,
+    baseUrl: rest.baseUrl ?? "http://test.zero.local",
+    // Tests should fail fast, not retry-and-mask flakiness.
+    maxRetries: rest.maxRetries ?? 0,
+    timeout: rest.timeout ?? 2e3,
+    fetch: rest.fetch ?? (routes ? createMockFetch(routes) : void 0)
+  });
+};
+
+exports.createMockFetch = createMockFetch;
+exports.createTestClient = createTestClient;
+exports.respondJson = respondJson;
+//# sourceMappingURL=testing.cjs.map
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/index.ts"],"names":["ZeroClient"],"mappings":";;;;;AAeA,IAAM,gBAAA,GAAiC,CAAC,OAAA,KAAY;AACnD,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAC/B,EAAA,OAAO,IAAI,QAAA;AAAA,IACV,KAAK,SAAA,CAAU;AAAA,MACd,OAAO,CAAA,+BAAA,EAAkC,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,IAAI,QAAQ,CAAA;AAAA,KACvE,CAAA;AAAA,IACD;AAAA,MACC,MAAA,EAAQ,GAAA;AAAA,MACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA;AAAmB;AAC/C,GACD;AACD,CAAA;AAKO,IAAM,eAAA,GAAkB,CAAC,MAAA,KAAmC;AAClE,EAAA,MAAM,IAAA,GAAO,OACZ,KAAA,EACA,IAAA,KACuB;AACvB,IAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAQ,KAAA,EAA4B,IAAI,CAAA;AAC5D,IAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAC/B,IAAA,MAAM,MAAM,CAAA,EAAG,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,IAAI,QAAQ,CAAA,CAAA;AAC7C,IAAA,MAAM,OAAA,GAAU,MAAA,CAAO,GAAG,CAAA,IAAK,gBAAA;AAC/B,IAAA,OAAO,MAAM,QAAQ,OAAO,CAAA;AAAA,EAC7B,CAAA;AACA,EAAA,OAAO,IAAA;AACR;AAEO,IAAM,WAAA,GAAc,CAAC,IAAA,EAAe,IAAA,KAC1C,IAAI,QAAA,CAAS,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,EAAG;AAAA,EAClC,MAAA,EAAQ,MAAM,MAAA,IAAU,GAAA;AAAA,EACxB,OAAA,EAAS;AAAA,IACR,cAAA,EAAgB,kBAAA;AAAA,IAChB,GAAI,IAAA,EAAM;AAAA;AAEZ,CAAC;AAQK,IAAM,gBAAA,GAAmB,CAAC,IAAA,GAA0B,EAAC,KAAkB;AAC7E,EAAA,MAAM,EAAE,MAAA,EAAQ,GAAG,IAAA,EAAK,GAAI,IAAA;AAK5B,EAAA,OAAO,IAAIA,4BAAA,CAAW;AAAA,IACrB,GAAG,IAAA;AAAA,IACH,OAAA,EAAS,KAAK,OAAA,IAAW,wBAAA;AAAA;AAAA,IAEzB,UAAA,EAAY,KAAK,UAAA,IAAc,CAAA;AAAA,IAC/B,OAAA,EAAS,KAAK,OAAA,IAAW,GAAA;AAAA,IACzB,OAAO,IAAA,CAAK,KAAA,KAAU,MAAA,GAAS,eAAA,CAAgB,MAAM,CAAA,GAAI,MAAA;AAAA,GACzD,CAAA;AACF","file":"testing.cjs","sourcesContent":["import { ZeroClient } from \"../client\";\nimport type { ClientOptions } from \"../options\";\n\n// Local x402 / MPP test servers live in the workspace-internal\n// `@zero/test-fixtures` package (private, never published). Keeping them out\n// of the SDK keeps the published surface small and avoids pulling hono /\n// @hono/node-server / @x402/hono into partner installs.\n\nexport type RouteHandler = (request: Request) => Response | Promise<Response>;\n\n// Keyed by `\"METHOD pathname\"` (e.g. `\"POST /v1/search\"`). Path is the URL\n// pathname only — query string is ignored for matching, but the handler gets\n// the full Request and can inspect query params via `new URL(req.url)`.\nexport type RouteMap = Record<string, RouteHandler>;\n\nconst FALLBACK_HANDLER: RouteHandler = (request) => {\n\tconst url = new URL(request.url);\n\treturn new Response(\n\t\tJSON.stringify({\n\t\t\terror: `No mock handler registered for ${request.method} ${url.pathname}`,\n\t\t}),\n\t\t{\n\t\t\tstatus: 404,\n\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t},\n\t);\n};\n\n// Minimal fetch substitute for unit tests. For richer mocking (request\n// matching, body assertions, scenario reuse across packages), reach for MSW\n// — this helper is the dependency-free escape hatch.\nexport const createMockFetch = (routes: RouteMap): typeof fetch => {\n\tconst impl = async (\n\t\tinput: Parameters<typeof fetch>[0],\n\t\tinit?: RequestInit,\n\t): Promise<Response> => {\n\t\tconst request = new Request(input as unknown as string, init);\n\t\tconst url = new URL(request.url);\n\t\tconst key = `${request.method} ${url.pathname}`;\n\t\tconst handler = routes[key] ?? FALLBACK_HANDLER;\n\t\treturn await handler(request);\n\t};\n\treturn impl as typeof fetch;\n};\n\nexport const respondJson = (body: unknown, init?: ResponseInit): Response =>\n\tnew Response(JSON.stringify(body), {\n\t\tstatus: init?.status ?? 200,\n\t\theaders: {\n\t\t\t\"content-type\": \"application/json\",\n\t\t\t...(init?.headers as Record<string, string> | undefined),\n\t\t},\n\t});\n\nexport type TestClientOptions = ClientOptions & {\n\t// Convenience: if supplied, builds a mock fetch from the routes and\n\t// installs it on the client. Useful for `createTestClient({ routes: { ... } })`.\n\troutes?: RouteMap;\n};\n\nexport const createTestClient = (opts: TestClientOptions = {}): ZeroClient => {\n\tconst { routes, ...rest } = opts;\n\t// Spread `rest` FIRST, then apply defaults — that way a caller that\n\t// passes `baseUrl: undefined` (common from `{ ...userOpts }` shapes)\n\t// gets the test default rather than falling through to the\n\t// production-pointing ClientOptions default.\n\treturn new ZeroClient({\n\t\t...rest,\n\t\tbaseUrl: rest.baseUrl ?? \"http://test.zero.local\",\n\t\t// Tests should fail fast, not retry-and-mask flakiness.\n\t\tmaxRetries: rest.maxRetries ?? 0,\n\t\ttimeout: rest.timeout ?? 2_000,\n\t\tfetch: rest.fetch ?? (routes ? createMockFetch(routes) : undefined),\n\t});\n};\n"]}

package/dist/testing.d.cts

@@ -0,0 +1,14 @@
+import { E as ClientOptions, Z as ZeroClient } from './client-B50UYxPr.cjs';
+import 'viem';
+import 'zod';
+
+type RouteHandler = (request: Request) => Response | Promise<Response>;
+type RouteMap = Record<string, RouteHandler>;
+declare const createMockFetch: (routes: RouteMap) => typeof fetch;
+declare const respondJson: (body: unknown, init?: ResponseInit) => Response;
+type TestClientOptions = ClientOptions & {
+    routes?: RouteMap;
+};
+declare const createTestClient: (opts?: TestClientOptions) => ZeroClient;
+
+export { type RouteHandler, type RouteMap, type TestClientOptions, createMockFetch, createTestClient, respondJson };

package/dist/testing.d.ts

@@ -0,0 +1,14 @@
+import { E as ClientOptions, Z as ZeroClient } from './client-B50UYxPr.js';
+import 'viem';
+import 'zod';
+
+type RouteHandler = (request: Request) => Response | Promise<Response>;
+type RouteMap = Record<string, RouteHandler>;
+declare const createMockFetch: (routes: RouteMap) => typeof fetch;
+declare const respondJson: (body: unknown, init?: ResponseInit) => Response;
+type TestClientOptions = ClientOptions & {
+    routes?: RouteMap;
+};
+declare const createTestClient: (opts?: TestClientOptions) => ZeroClient;
+
+export { type RouteHandler, type RouteMap, type TestClientOptions, createMockFetch, createTestClient, respondJson };

package/dist/testing.js

@@ -0,0 +1,47 @@
+import { ZeroClient } from './chunk-XQEHJX2X.js';
+
+// src/testing/index.ts
+var FALLBACK_HANDLER = (request) => {
+  const url = new URL(request.url);
+  return new Response(
+    JSON.stringify({
+      error: `No mock handler registered for ${request.method} ${url.pathname}`
+    }),
+    {
+      status: 404,
+      headers: { "content-type": "application/json" }
+    }
+  );
+};
+var createMockFetch = (routes) => {
+  const impl = async (input, init) => {
+    const request = new Request(input, init);
+    const url = new URL(request.url);
+    const key = `${request.method} ${url.pathname}`;
+    const handler = routes[key] ?? FALLBACK_HANDLER;
+    return await handler(request);
+  };
+  return impl;
+};
+var respondJson = (body, init) => new Response(JSON.stringify(body), {
+  status: init?.status ?? 200,
+  headers: {
+    "content-type": "application/json",
+    ...init?.headers
+  }
+});
+var createTestClient = (opts = {}) => {
+  const { routes, ...rest } = opts;
+  return new ZeroClient({
+    ...rest,
+    baseUrl: rest.baseUrl ?? "http://test.zero.local",
+    // Tests should fail fast, not retry-and-mask flakiness.
+    maxRetries: rest.maxRetries ?? 0,
+    timeout: rest.timeout ?? 2e3,
+    fetch: rest.fetch ?? (routes ? createMockFetch(routes) : void 0)
+  });
+};
+
+export { createMockFetch, createTestClient, respondJson };
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/index.ts"],"names":[],"mappings":";;;AAeA,IAAM,gBAAA,GAAiC,CAAC,OAAA,KAAY;AACnD,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAC/B,EAAA,OAAO,IAAI,QAAA;AAAA,IACV,KAAK,SAAA,CAAU;AAAA,MACd,OAAO,CAAA,+BAAA,EAAkC,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,IAAI,QAAQ,CAAA;AAAA,KACvE,CAAA;AAAA,IACD;AAAA,MACC,MAAA,EAAQ,GAAA;AAAA,MACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA;AAAmB;AAC/C,GACD;AACD,CAAA;AAKO,IAAM,eAAA,GAAkB,CAAC,MAAA,KAAmC;AAClE,EAAA,MAAM,IAAA,GAAO,OACZ,KAAA,EACA,IAAA,KACuB;AACvB,IAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAQ,KAAA,EAA4B,IAAI,CAAA;AAC5D,IAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAC/B,IAAA,MAAM,MAAM,CAAA,EAAG,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,IAAI,QAAQ,CAAA,CAAA;AAC7C,IAAA,MAAM,OAAA,GAAU,MAAA,CAAO,GAAG,CAAA,IAAK,gBAAA;AAC/B,IAAA,OAAO,MAAM,QAAQ,OAAO,CAAA;AAAA,EAC7B,CAAA;AACA,EAAA,OAAO,IAAA;AACR;AAEO,IAAM,WAAA,GAAc,CAAC,IAAA,EAAe,IAAA,KAC1C,IAAI,QAAA,CAAS,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,EAAG;AAAA,EAClC,MAAA,EAAQ,MAAM,MAAA,IAAU,GAAA;AAAA,EACxB,OAAA,EAAS;AAAA,IACR,cAAA,EAAgB,kBAAA;AAAA,IAChB,GAAI,IAAA,EAAM;AAAA;AAEZ,CAAC;AAQK,IAAM,gBAAA,GAAmB,CAAC,IAAA,GAA0B,EAAC,KAAkB;AAC7E,EAAA,MAAM,EAAE,MAAA,EAAQ,GAAG,IAAA,EAAK,GAAI,IAAA;AAK5B,EAAA,OAAO,IAAI,UAAA,CAAW;AAAA,IACrB,GAAG,IAAA;AAAA,IACH,OAAA,EAAS,KAAK,OAAA,IAAW,wBAAA;AAAA;AAAA,IAEzB,UAAA,EAAY,KAAK,UAAA,IAAc,CAAA;AAAA,IAC/B,OAAA,EAAS,KAAK,OAAA,IAAW,GAAA;AAAA,IACzB,OAAO,IAAA,CAAK,KAAA,KAAU,MAAA,GAAS,eAAA,CAAgB,MAAM,CAAA,GAAI,MAAA;AAAA,GACzD,CAAA;AACF","file":"testing.js","sourcesContent":["import { ZeroClient } from \"../client\";\nimport type { ClientOptions } from \"../options\";\n\n// Local x402 / MPP test servers live in the workspace-internal\n// `@zero/test-fixtures` package (private, never published). Keeping them out\n// of the SDK keeps the published surface small and avoids pulling hono /\n// @hono/node-server / @x402/hono into partner installs.\n\nexport type RouteHandler = (request: Request) => Response | Promise<Response>;\n\n// Keyed by `\"METHOD pathname\"` (e.g. `\"POST /v1/search\"`). Path is the URL\n// pathname only — query string is ignored for matching, but the handler gets\n// the full Request and can inspect query params via `new URL(req.url)`.\nexport type RouteMap = Record<string, RouteHandler>;\n\nconst FALLBACK_HANDLER: RouteHandler = (request) => {\n\tconst url = new URL(request.url);\n\treturn new Response(\n\t\tJSON.stringify({\n\t\t\terror: `No mock handler registered for ${request.method} ${url.pathname}`,\n\t\t}),\n\t\t{\n\t\t\tstatus: 404,\n\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t},\n\t);\n};\n\n// Minimal fetch substitute for unit tests. For richer mocking (request\n// matching, body assertions, scenario reuse across packages), reach for MSW\n// — this helper is the dependency-free escape hatch.\nexport const createMockFetch = (routes: RouteMap): typeof fetch => {\n\tconst impl = async (\n\t\tinput: Parameters<typeof fetch>[0],\n\t\tinit?: RequestInit,\n\t): Promise<Response> => {\n\t\tconst request = new Request(input as unknown as string, init);\n\t\tconst url = new URL(request.url);\n\t\tconst key = `${request.method} ${url.pathname}`;\n\t\tconst handler = routes[key] ?? FALLBACK_HANDLER;\n\t\treturn await handler(request);\n\t};\n\treturn impl as typeof fetch;\n};\n\nexport const respondJson = (body: unknown, init?: ResponseInit): Response =>\n\tnew Response(JSON.stringify(body), {\n\t\tstatus: init?.status ?? 200,\n\t\theaders: {\n\t\t\t\"content-type\": \"application/json\",\n\t\t\t...(init?.headers as Record<string, string> | undefined),\n\t\t},\n\t});\n\nexport type TestClientOptions = ClientOptions & {\n\t// Convenience: if supplied, builds a mock fetch from the routes and\n\t// installs it on the client. Useful for `createTestClient({ routes: { ... } })`.\n\troutes?: RouteMap;\n};\n\nexport const createTestClient = (opts: TestClientOptions = {}): ZeroClient => {\n\tconst { routes, ...rest } = opts;\n\t// Spread `rest` FIRST, then apply defaults — that way a caller that\n\t// passes `baseUrl: undefined` (common from `{ ...userOpts }` shapes)\n\t// gets the test default rather than falling through to the\n\t// production-pointing ClientOptions default.\n\treturn new ZeroClient({\n\t\t...rest,\n\t\tbaseUrl: rest.baseUrl ?? \"http://test.zero.local\",\n\t\t// Tests should fail fast, not retry-and-mask flakiness.\n\t\tmaxRetries: rest.maxRetries ?? 0,\n\t\ttimeout: rest.timeout ?? 2_000,\n\t\tfetch: rest.fetch ?? (routes ? createMockFetch(routes) : undefined),\n\t});\n};\n"]}