@ambasada/sdk 0.7.5 → 0.8.1

package/dist/platform.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The platform surface of @ambasada/sdk, without the 0.7 village names (`index.ts` adds those).
+ * `@ambasada/village` builds on this module.
+ */
+import { Ambasada } from "./client.js";
+export { Ambasada, createAmbasada, DEFAULT_API_URL } from "./client.js";
+export type { AmbasadaOptions } from "./client.js";
+export * from "./errors.js";
+export type * from "./types.js";
+export { getHeader } from "./headers.js";
+export type { HeaderSource } from "./headers.js";
+export { defineApp } from "./define.js";
+export type { AppConfig } from "./define.js";
+export { AmbasadaAuth, AUTH_PATHS, JWKS_TTL_MS, SESSION_TTL_S } from "./auth.js";
+export type { AmbasadaUser, AuthConfig, LoginOptions, ShellUser, WithHeaders } from "./auth.js";
+export { AmbasadaApps, APP_SIGNATURE_HEADER, APP_TIMESTAMP_HEADER, appWebhookHeaders, signAppWebhook } from "./apps.js";
+export type { AppEvent, AppEventType, AppNotifyInput, AppNotifyResult, AppsConfig, NotificationCategory, WebhookInput } from "./apps.js";
+/** The default client, configured from the environment at call time. */
+export declare const ambasada: Ambasada;
+export default ambasada;

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-/** Wire types. TON amounts are decimal numbers (`1`, `0.5`). */
+/** Wire types of the platform API. */
 /** Ed25519 public key as served by `/.well-known/jwks.json`. */
 export interface Jwk {
     kty: "OKP";
@@ -9,216 +9,11 @@ export interface Jwk {
     alg?: "EdDSA";
     use?: "sig";
 }
-/** What a seller learns from a Gateway call receipt (`x-village-receipt`). Same shape as `@ambasada/protocol`. */
-export interface ReceiptClaims {
-    iss: string;
-    jti: string;
-    call_id: string;
-    /** Buyer company id. */
-    buyer: string;
-    /** Your company id. */
-    seller: string;
-    /** `<seller>/<offering name>` */
-    offering: string;
-    /** TON */
-    amount: number;
-    /** 1 for a direct buy; forward it with `buy(…, { parent })`. */
-    depth: number;
-    /** TON you may still spend downstream on behalf of this call. */
-    budget?: number;
-    deal_id?: string;
-    body_sha256: string;
-    iat: number;
-    exp: number;
-}
-/** A verified paid call: the receipt plus the parsed JSON input. */
-export interface PaidCall<Input = any> extends ReceiptClaims {
-    input: Input;
-}
-/** A checkout receipt (pay.js `village:paid`, or `session.receipt`). */
-export interface CheckoutReceiptClaims {
-    iss: string;
-    jti: string;
-    kind: "checkout";
-    session: string;
-    /** The person's pseudonymous wallet id (`p_…`). */
-    buyer: string;
-    seller: string;
-    amount: number;
-    description: string;
-    ref?: string;
-    log_index: number;
-    iat: number;
-    exp: number;
-}
-export interface CheckoutInput {
-    /** TON, 0.1–500. Or give `offering` to charge one of your offerings' price. */
-    amount?: number;
-    offering?: string;
-    /** Shown to the person and written to the public ledger as the memo. No personal data. */
-    description: string;
-    /** `{CHECKOUT_SESSION_ID}` anywhere in the URL is replaced; otherwise `?session=cs_…` is appended. */
-    success_url: string;
-    cancel_url?: string;
-    client_reference_id?: string;
-    metadata?: Record<string, string>;
-    /** Seconds, 300–86400 (default 3600). */
-    expires_in?: number;
-}
-export interface CheckoutSession {
-    id: string;
-    object: "checkout.session";
-    url: string;
-    status: "open" | "paid" | "expired" | (string & {});
-    amount: number;
-    description: string;
-    offering: string | null;
-    /** The payment link it came from (`pl_…`), if any. */
-    link: string | null;
-    client_reference_id: string | null;
-    metadata: Record<string, string>;
-    success_url: string;
-    cancel_url: string | null;
-    buyer: string | null;
-    paid_at: string | null;
-    log_index: number | null;
-    receipt: string | null;
-    created_at: string;
-    expires_at: string;
-    [key: string]: unknown;
-}
-export interface PaymentLinkInput {
-    amount?: number;
-    offering?: string;
-    description: string;
-    success_url: string;
-    cancel_url?: string;
-    metadata?: Record<string, string>;
-}
-export interface PaymentLink {
-    id: string;
-    object: "checkout.link";
-    url: string;
-    active: boolean;
-    amount: number;
-    description: string;
-    offering: string | null;
-    metadata: Record<string, string>;
-    success_url: string;
-    cancel_url: string | null;
-    created_at: string;
-    [key: string]: unknown;
-}
-export interface WebhookDelivery {
-    id: string;
-    type: string;
-    status: "pending" | "delivered" | "failed" | (string & {});
-    attempts: number;
-    [key: string]: unknown;
-}
-export interface WebhookEvent<Data = any> {
-    /** `webhook-id` header: dedupe on it, retries reuse it. */
-    id: string;
-    type: "checkout.paid" | "webhook.test" | (string & {});
-    timestamp: string;
-    data: Data;
-}
-export interface BuyOptions {
-    /** Refuse (PRICE_ABOVE_MAX) if the offering costs more than this, in TON. */
-    maxPrice?: number;
-    /** Retries with the same key never charge twice. Default: a random key per call (reused by the SDK's own retry). */
-    idempotencyKey?: string;
-    /** Inside a paid handler: forward the chain depth and remaining budget of the call you are serving. */
-    parent?: Pick<ReceiptClaims, "depth" | "budget">;
-    /** TON this call may spend downstream (`x-village-budget`). */
-    budget?: number;
-    /** An approved approval id, after APPROVAL_REQUIRED. */
-    approval?: string;
-    /** Why you are buying; shown to your team on approval requests. */
-    reason?: string;
-    signal?: AbortSignal;
-}
-export interface BuyResult<Output = any> {
-    output: Output;
-    callId: string | null;
-    /** TON charged. */
-    amount: number | null;
-    /** The signed receipt for the call (you hold it too). */
-    receipt: string | null;
-    /** Position in the public ledger log. */
-    logIndex: number | null;
-    /** True when the Gateway replayed a previous result for the same idempotency key (no new charge). */
-    replayed: boolean;
-    /** For `need()`: which offering served it (`company/name`), if the Gateway says. */
-    offering: string | null;
-}
-export type ChatModel = "deepseek-v4.1-flash" | "deepseek-v4-pro" | "glm-5.3-flash" | (string & {});
-export interface ChatMessage {
-    role: "system" | "user" | "assistant" | "tool";
-    content: string;
-    [key: string]: unknown;
-}
-/** OpenAI-compatible chat request. */
-export interface ChatRequest {
-    model?: ChatModel;
-    messages: ChatMessage[];
-    temperature?: number;
-    max_tokens?: number;
-    response_format?: {
-        type: "text" | "json_object";
-    } | Record<string, unknown>;
-    [key: string]: unknown;
-}
-export interface ChatResponse {
-    id: string;
-    object: "chat.completion";
-    model: string;
-    choices: {
-        index: number;
-        message: ChatMessage;
-        finish_reason: string | null;
-    }[];
-    usage?: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-    [key: string]: unknown;
-}
-export interface ImageRequest {
-    model?: "nano_banana" | "gpt-image-2" | (string & {});
-    prompt: string;
-}
-export interface ImageResult {
-    /** Re-hosted in the village files store; safe to pass to other products. */
-    url: string;
-    /** TON charged. */
-    cost: number;
-    call_id: string;
-}
-export interface ToolListing {
-    id: string;
-    name: string;
-    description: string;
-    price_ton?: number;
-    price?: number;
-    unit?: string;
-    input?: unknown;
-    output?: unknown;
-    [key: string]: unknown;
-}
-export interface ToolResult<Output = any> {
-    output: Output;
-    callId: string | null;
-    /** TON charged. */
-    amount: number | null;
-    replayed: boolean;
-}
 export interface FileOptions {
     contentType?: string;
     ttlSeconds?: number;
 }
-/** `POST /v1/files` (0.1 TON a file). */
+/** `POST /v1/files`. */
 export interface StoredFile {
     id: string;
     url: string;
@@ -243,104 +38,3 @@ export interface StoreWrite {
     used_bytes: number;
     limit_bytes: number;
 }
-/** Offering field schema shorthand: `{ text: "string", to: "string", tone: "string?" }`. */
-export type FieldSchema = Record<string, string>;
-export interface ListingInput {
-    description: string;
-    /** TON, 0.1–500. */
-    price: number;
-    /** Absolute URL the Gateway POSTs paid calls to. */
-    endpoint: string;
-    input?: FieldSchema | null;
-    output?: FieldSchema | null;
-    timeout_ms?: number;
-    status?: "open" | "paused";
-    preview?: boolean;
-}
-export interface Listing extends ListingInput {
-    id: string;
-    company: string;
-    name: string;
-    version: number;
-    [key: string]: unknown;
-}
-export interface Wallet {
-    account: string;
-    balance: number;
-    held: number;
-    available: number;
-}
-export interface LedgerEntry {
-    seq: number;
-    id: string;
-    ts: string;
-    kind: string;
-    direction: "in" | "out";
-    counterparty: string;
-    amount: number;
-    balance_after: number;
-    ref: string | null;
-    memo: string | null;
-    hold_id?: string | null;
-    log_index?: number | null;
-    [key: string]: unknown;
-}
-export interface LedgerPage {
-    entries: LedgerEntry[];
-    /** Pass back as `since` for the next page. */
-    next_since: number;
-}
-export interface TransferOptions {
-    reason?: string;
-    ref?: string;
-    idempotencyKey?: string;
-}
-/** `agent/settings.json`, sent with the prompt to `POST /v1/agent/config` (agent stream wire format). */
-export interface AgentSettings {
-    model?: "deepseek-v4.1-flash" | "deepseek-v4-pro";
-    enabled?: boolean;
-    wake?: {
-        interval_minutes?: number;
-        min_event_gap_seconds?: number;
-    };
-    budget?: {
-        tool_calls_per_wake?: number;
-        tokens_per_wake?: number;
-        max_turns?: number;
-        compute_per_day?: number;
-    };
-    /** Agent tools offered to the model (default: all). */
-    tools?: string[];
-    /** Company wallet spend limits, TON. Over `auto_per_payment` an agent payment needs the team's approval. */
-    limits?: {
-        per_payment?: number;
-        per_hour?: number;
-        per_day?: number;
-        per_payee_day?: number;
-        auto_per_payment?: number;
-        auto_per_day?: number;
-    };
-    [key: string]: unknown;
-}
-export interface AgentConfigInput extends AgentSettings {
-    /** The text of agent/agent.md. */
-    prompt?: string;
-    /** Wake the agent once after saving. */
-    wake_now?: boolean;
-}
-export interface TranscriptEntry {
-    seq: number;
-    ts: string;
-    kind: string;
-    data?: unknown;
-    [key: string]: unknown;
-}
-export interface MarketOffering {
-    id: string;
-    company?: string;
-    name: string;
-    description: string;
-    price: number;
-    source?: "company" | "village-tool";
-    [key: string]: unknown;
-}

package/dist/village/client.d.ts

@@ -0,0 +1,148 @@
+import { Ambasada, type AmbasadaOptions } from "../platform.js";
+import { type IncomingRequest } from "./receipt.js";
+import type { AgentConfigInput, BuyOptions, BuyResult, ChatRequest, ChatResponse, CheckoutInput, CheckoutReceiptClaims, CheckoutSession, ImageRequest, ImageResult, LedgerPage, Listing, ListingInput, MarketOffering, PaidCall, PaymentLink, PaymentLinkInput, ToolListing, ToolResult, TranscriptEntry, TransferOptions, Wallet, WebhookDelivery, WebhookEvent } from "./types.js";
+/** The Hack A Ton API. The platform API (`@ambasada/sdk`) is https://api.ambasada.dev. */
+export declare const DEFAULT_VILLAGE_API_URL = "https://hackaton.ambasada.id";
+export declare const DEFAULT_MODEL = "deepseek-v4.1-flash";
+export interface VillageOptions extends AmbasadaOptions {
+    /** Team key (`sk_live_…`, from the village app → Developers). Default: `AMBASADA_API_KEY`. */
+    apiKey?: string;
+    /**
+     * Default: `AMBASADA_VILLAGE_API_URL`, else `AMBASADA_API_URL` when it is not the platform host (0.7
+     * projects, `ambasada dev`), else https://hackaton.ambasada.id.
+     */
+    apiUrl?: string;
+    /** Your company id, for receipt checks. Default: `AMBASADA_COMPANY`, else looked up once with the API key. */
+    company?: string;
+    /** Webhook signing secret (`whsec_…`). Default: `AMBASADA_WEBHOOK_SECRET`. */
+    webhookSecret?: string;
+}
+export interface VerifyReceiptOptions {
+    /** Pin the offering name (`translate`), so a receipt for another of your offerings is refused. */
+    offering?: string;
+    /** Refuse a second use of the same receipt in this process (default true). Persist call ids yourself across instances. */
+    replayGuard?: boolean;
+}
+export type SellHandler<Input, Output> = (input: Input, call: PaidCall<Input>, req: Request) => Output | Response | Promise<Output | Response>;
+/**
+ * The village client: the platform client (`auth`, `apps`, `store`, `files`) plus money, AI, the agent and
+ * the market. `import { village } from "./index.js"` gives one configured from the environment;
+ * `createVillage({ env })` makes another (e.g. from a Worker's `env`).
+ */
+export declare class Village extends Ambasada {
+    private readonly villageOptions;
+    private companyPromise?;
+    private readonly replays;
+    constructor(options?: VillageOptions);
+    get apiUrl(): string;
+    /** Your company id (from options, `AMBASADA_COMPANY`, or the wallet the API key belongs to). */
+    company(): Promise<string>;
+    private keySource;
+    /**
+     * Verifies that a request to your endpoint was paid through the Gateway and returns the receipt
+     * with the parsed JSON `input`. Throws `ReceiptInvalidError` (status 402) otherwise.
+     * Works with a fetch `Request` (not consumed) or a Node/Express request with a raw body.
+     */
+    verifyReceipt<Input = any>(req: IncomingRequest, options?: VerifyReceiptOptions): Promise<PaidCall<Input>>;
+    /**
+     * Wraps a paid offering as a fetch handler: verifies the receipt (402 if missing or bad), runs
+     * `handler(input, call, req)` and answers JSON. A thrown `AmbasadaError` keeps its status (the
+     * Gateway then refunds the buyer).
+     *
+     *   export default village.sell("translate", async ({ text, to }) => ({ text: await village.llm(`…`) }));
+     */
+    sell<Input = any, Output = unknown>(offering: string, handler: SellHandler<Input, Output>): (req: Request) => Promise<Response>;
+    /** Verifies a signed webhook (`checkout.paid`, `webhook.test`) and returns the event. Throws `WebhookInvalidError`. */
+    verifyWebhook<Data = any>(req: IncomingRequest, secret?: string): Promise<WebhookEvent<Data>>;
+    /** Verifies a checkout receipt (pay.js `village:paid` → `e.detail.receipt`, or `session.receipt`). */
+    verifyCheckoutReceipt(token: string | null | undefined, options?: {
+        session?: string;
+    }): Promise<CheckoutReceiptClaims>;
+    /** Creates a Checkout session; redirect the person to `session.url`. Deliver on the webhook or `getCheckout(id).status === "paid"`. */
+    checkout(session: CheckoutInput, options?: {
+        idempotencyKey?: string;
+    }): Promise<CheckoutSession>;
+    getCheckout(id: string): Promise<CheckoutSession>;
+    /** A reusable payment link for static pages (`<button data-village-pay="pl_…">` with pay.js). */
+    createPaymentLink(link: PaymentLinkInput): Promise<PaymentLink>;
+    /** Cancels an open session (`POST /v1/checkout/sessions/:id/expire`). */
+    expireCheckout(id: string): Promise<CheckoutSession>;
+    listPaymentLinks(): Promise<PaymentLink[]>;
+    deactivatePaymentLink(id: string): Promise<PaymentLink>;
+    /** Where checkout webhooks go. Returns the signing secret (the same one until `rotateSecret`). */
+    setWebhook(url: string, options?: {
+        rotateSecret?: boolean;
+    }): Promise<{
+        url: string;
+        secret: string;
+    }>;
+    /** The webhook URL, its secret and the last deliveries. */
+    getWebhook(): Promise<{
+        url: string | null;
+        secret: string | null;
+        deliveries: WebhookDelivery[];
+    }>;
+    deleteWebhook(): Promise<{
+        deleted: true;
+    }>;
+    /** Sends a `webhook.test` event now and returns the delivery. */
+    testWebhook(): Promise<WebhookDelivery>;
+    retryWebhookDelivery(id: string): Promise<WebhookDelivery>;
+    /** Buys one call of `company/offering` through the Gateway. Money moves only if the seller answers 2xx with valid output. */
+    buy<Output = any>(offering: string, input: unknown, options?: BuyOptions): Promise<BuyResult<Output>>;
+    /**
+     * Buys whatever your agent routed the need `name` to (or the best offering within `maxPrice` if it
+     * has not routed it yet), with fallbacks (EXCHANGE.md §4.3). Prefer this over hardcoding a supplier.
+     */
+    need<Output = any>(name: string, input: unknown, options?: BuyOptions): Promise<BuyResult<Output>>;
+    private paid;
+    /**
+     * `village.llm("prompt")` → the answer text; `village.llm.chat(req)` → the full OpenAI-style response.
+     * Default model: deepseek-v4.1-flash.
+     */
+    readonly llm: ((prompt: string, options?: Omit<ChatRequest, "messages"> & {
+        system?: string;
+    }) => Promise<string>) & {
+        chat(req: ChatRequest): Promise<ChatResponse>;
+    };
+    readonly images: {
+        /** Generates an image; the URL is re-hosted in the village files store. Default model: nano_banana. */
+        generate: (req: ImageRequest) => Promise<ImageResult>;
+    };
+    readonly tools: {
+        /** The curated LLMOK tool catalog with TON prices. */
+        list: () => Promise<ToolListing[]>;
+        /** Runs one tool; debits your wallet only on success. Replays with the same idempotency key are free. */
+        call: <Output = any>(id: string, input: unknown, options?: {
+            idempotencyKey?: string;
+        }) => Promise<ToolResult<Output>>;
+    };
+    readonly listings: {
+        /** Creates or updates an offering (price changes are versioned). */
+        put: (name: string, def: ListingInput) => Promise<Listing>;
+        list: () => Promise<Listing[]>;
+    };
+    wallet(): Promise<Wallet>;
+    ledger(since?: number, limit?: number): Promise<LedgerPage>;
+    transfer(to: string, amount: number, options?: TransferOptions): Promise<{
+        entry: unknown;
+    }>;
+    readonly market: {
+        search: (query: string) => Promise<MarketOffering[]>;
+    };
+    readonly agent: {
+        /** Replaces the agent's prompt (`agent.md`) and settings (`settings.json`). */
+        config: (config: AgentConfigInput) => Promise<{
+            config: unknown;
+            limits?: unknown;
+        }>;
+        /** A message the agent answers on its next wake. */
+        steer: (text: string) => Promise<unknown>;
+        transcript: (since?: number, limit?: number) => Promise<{
+            entries: TranscriptEntry[];
+            next_since: number;
+        }>;
+        state: () => Promise<Record<string, unknown>>;
+    };
+}
+export declare function createVillage(options?: VillageOptions): Village;

package/dist/village/define.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The village keys of `ambasada.config.ts` (docs/PLATFORM.md §5). They only add types and checks; the CLI
+ * reads the values (`ambasada deploy`, `ambasada village offerings sync`, `ambasada dev`).
+ *
+ *   export default defineCompany(defineApp({ id, name, product }), { idea, offerings, agent });
+ */
+import type { AppConfig } from "../platform.js";
+import type { FieldSchema } from "./types.js";
+export interface VillageConfig {
+    /** Locked Fri 20:00. */
+    idea: {
+        title: string;
+        category?: string;
+        pitch?: string;
+    };
+    /** Path to the offerings module (default `./product/offerings.ts`). */
+    offerings?: string;
+    /** Agent folder with agent.md and settings.json (default `./agent`). */
+    agent?: {
+        dir?: string;
+    };
+}
+/** An app (`id` is your company id in the village) with the village keys. */
+export interface CompanyConfig extends AppConfig, VillageConfig {
+}
+/** `defineCompany(defineApp({ … }), { idea, offerings, agent })`, or the 0.7 form `defineCompany({ id, name, idea, … })`. */
+export declare function defineCompany(app: AppConfig, village: VillageConfig): CompanyConfig;
+export declare function defineCompany(config: CompanyConfig): CompanyConfig;
+export interface OfferingDef {
+    /** Slug: a-z, 0-9, _ and -. */
+    name: string;
+    /** TON per call, 0.1–500. */
+    price: number;
+    /** Path on your product (`/api/translate`) or an absolute URL. */
+    endpoint: string;
+    description: string;
+    input?: FieldSchema;
+    output?: FieldSchema;
+    /** Allow a free sample (`market.preview`). */
+    preview?: boolean;
+    timeout_ms?: number;
+    status?: "open" | "paused";
+}
+export declare function offering(def: OfferingDef): OfferingDef;

package/dist/village/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Village errors. Every failure is an `AmbasadaError` (`@ambasada/sdk`) with a code from
+ * `@ambasada/protocol`; `VillageError` is the same class under its 0.7 name (kept through 1.x):
+ *
+ *   try { await village.buy("inkwell/poem", input, { maxPrice: 2 }) }
+ *   catch (e) { if (isVillageError(e, "PRICE_ABOVE_MAX")) … }
+ */
+import { AmbasadaError, isAmbasadaError } from "../platform.js";
+/** `AmbasadaError` under its 0.7 name. */
+export declare const VillageError: typeof AmbasadaError;
+export type VillageError = AmbasadaError;
+/** `isAmbasadaError` under its 0.7 name. */
+export declare const isVillageError: typeof isAmbasadaError;
+export type ReceiptFailure = "malformed" | "unknown_key" | "bad_signature" | "expired" | "not_yet_valid" | "wrong_issuer" | "wrong_seller" | "wrong_offering" | "wrong_kind" | "wrong_session" | "body_mismatch" | "replayed" | "missing";
+/** The request is not paid: no receipt, a forged or expired one, or one for another seller / offering / body. */
+export declare class ReceiptInvalidError extends AmbasadaError {
+    readonly reason: ReceiptFailure;
+    constructor(reason: ReceiptFailure, message: string);
+}

package/dist/village/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @ambasada/village: the Hack A Ton add-on. Accept and spend TON in the village, on top of the
+ * Ambasada platform client (`@ambasada/sdk`).
+ *
+ *   import { village } from "./index.js";         // AMBASADA_API_KEY, AMBASADA_VILLAGE_API_URL from the env
+ *   const { url } = await village.checkout({ amount: 3, description: "Coffee", success_url });
+ *   export const POST = village.sell("translate", async ({ text, to }) => ({ text: await village.llm(`Translate to ${to}: ${text}`) }));
+ *   const user = await village.auth.user(req);            // the platform client's methods work too
+ *
+ * Works in Node ≥ 22, Bun, Cloudflare Workers (`createVillage({ env })`) and Next.js route handlers.
+ */
+import { Village } from "./client.js";
+export { Village, createVillage, DEFAULT_VILLAGE_API_URL, DEFAULT_MODEL } from "./client.js";
+export type { VillageOptions, VerifyReceiptOptions, SellHandler } from "./client.js";
+export { VillageError, isVillageError, ReceiptInvalidError } from "./errors.js";
+export type { ReceiptFailure } from "./errors.js";
+export type * from "./types.js";
+export { verifyWebhookPayload, webhookHeaders, generateWebhookSecret, WEBHOOK_HEADERS } from "./webhook.js";
+export { RECEIPT_HEADER, readIncoming, verifyCallReceipt, verifyCheckoutReceiptToken } from "./receipt.js";
+export type { IncomingRequest } from "./receipt.js";
+export { defineCompany, offering } from "./define.js";
+export type { CompanyConfig, OfferingDef, VillageConfig } from "./define.js";
+export { Ambasada, AmbasadaError, isAmbasadaError, defineApp, ERROR_STATUS, WebhookInvalidError } from "../platform.js";
+export type { AmbasadaUser, AppConfig, ErrorCode, ErrorDetails, Jwk, StoredFile, StoreList, StoreWrite, WebhookFailure } from "../platform.js";
+/** The default client, configured from the environment at call time. */
+export declare const village: Village;
+export default village;

package/dist/{receipt.d.ts → village/receipt.d.ts}

@@ -3,8 +3,8 @@
  * by the village, committing to the buyer, seller, offering, amount and the SHA-256 of the exact body.
  * The seller checks it offline against `<api>/.well-known/jwks.json` (cached), no round-trip.
  */
-import type { CheckoutReceiptClaims, Jwk, ReceiptClaims } from "./types.js";
-import { type HeaderSource } from "./webhook.js";
+import { type HeaderSource, type Jwk } from "../platform.js";
+import type { CheckoutReceiptClaims, ReceiptClaims } from "./types.js";
 export declare const RECEIPT_HEADER = "x-village-receipt";
 export type KeySource = Jwk[] | (() => Promise<Jwk[]>);
 /** A fetch `Request`, or a Node / Express request (raw body in `body` / `rawBody`, or an unread stream). */