@ambasada/sdk 0.2.0 → 0.3.0

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import { type IncomingRequest } from "./receipt.js";
-import type { AgentConfigInput, BuyOptions, BuyResult, ChatRequest, ChatResponse, CheckoutInput, CheckoutReceiptClaims, CheckoutSession, FileOptions, ImageRequest, ImageResult, Jwk, LedgerPage, Listing, ListingInput, MarketOffering, PaidCall, PaymentLink, PaymentLinkInput, ToolListing, ToolResult, TranscriptEntry, TransferOptions, Wallet, WebhookDelivery, WebhookEvent } from "./types.js";
+import type { AgentConfigInput, BuyOptions, BuyResult, ChatRequest, ChatResponse, CheckoutInput, CheckoutReceiptClaims, CheckoutSession, FileOptions, StoredFile, StoreList, StoreWrite, ImageRequest, ImageResult, Jwk, LedgerPage, Listing, ListingInput, MarketOffering, PaidCall, PaymentLink, PaymentLinkInput, ToolListing, ToolResult, TranscriptEntry, TransferOptions, Wallet, WebhookDelivery, WebhookEvent } from "./types.js";
 export declare const DEFAULT_API_URL = "https://hackaton.ambasada.id";
 export declare const DEFAULT_MODEL = "deepseek-v4.1-flash";
 export interface VillageOptions {
@@ -128,12 +128,24 @@ export declare class Village {
     };
     readonly files: {
         /**
-         * Stores bytes, a Blob, or a URL to copy, for the event. Returns a public URL other products can fetch.
-         * (`POST /v1/files`: assumed route; the utilities stream serves `GET /files/:id`.)
+         * Stores bytes, a Blob, or a URL to copy, for the event (`POST /v1/files`, 0.1 TON). Returns a
+         * public URL other products can fetch.
          */
-        put: (data: Uint8Array | ArrayBuffer | Blob | string, options?: FileOptions) => Promise<{
-            url: string;
-        }>;
+        put: (data: Uint8Array | ArrayBuffer | Blob | string, options?: FileOptions) => Promise<StoredFile>;
+    };
+    /**
+     * Your company's JSON key-value store (`/v1/store`): 1 MB per company (keys + values), free. State for
+     * a hosted product that needs no database.
+     */
+    readonly store: {
+        /** The value, or null when the key is not set. */
+        get: <T = unknown>(key: string) => Promise<T | null>;
+        /** Saves any JSON value (fails with INVALID_REQUEST when the store would pass 1 MB). */
+        set: (key: string, value: unknown) => Promise<StoreWrite>;
+        /** True when the key existed. */
+        delete: (key: string) => Promise<boolean>;
+        /** Keys (up to 1000, optionally under a prefix) and how much of the 1 MB is used. */
+        list: (prefix?: string) => Promise<StoreList>;
     };
     readonly listings: {
         /** Creates or updates an offering (price changes are versioned). */

package/dist/index.js

@@ -693,8 +693,8 @@ var Village = class {
   };
   files = {
     /**
-     * Stores bytes, a Blob, or a URL to copy, for the event. Returns a public URL other products can fetch.
-     * (`POST /v1/files`: assumed route; the utilities stream serves `GET /files/:id`.)
+     * Stores bytes, a Blob, or a URL to copy, for the event (`POST /v1/files`, 0.1 TON). Returns a
+     * public URL other products can fetch.
      */
     put: (data, options = {}) => {
       const query = { ttl_seconds: options.ttlSeconds };
@@ -703,6 +703,30 @@ var Village = class {
       return this.call("POST", "/v1/files", { raw: data, headers: { "content-type": contentType }, query });
     }
   };
+  /**
+   * Your company's JSON key-value store (`/v1/store`): 1 MB per company (keys + values), free. State for
+   * a hosted product that needs no database.
+   */
+  store = {
+    /** The value, or null when the key is not set. */
+    get: async (key) => {
+      try {
+        return (await this.call("GET", `/v1/store/${encodeURIComponent(key)}`)).value;
+      } catch (error) {
+        if (error instanceof VillageError && error.status === 404) return null;
+        throw error;
+      }
+    },
+    /** Saves any JSON value (fails with INVALID_REQUEST when the store would pass 1 MB). */
+    set: (key, value) => {
+      if (value === void 0) throw new VillageError("INVALID_REQUEST", "store.set needs a JSON value (use store.delete to remove a key)");
+      return this.call("PUT", `/v1/store/${encodeURIComponent(key)}`, { body: value });
+    },
+    /** True when the key existed. */
+    delete: async (key) => (await this.call("DELETE", `/v1/store/${encodeURIComponent(key)}`)).deleted,
+    /** Keys (up to 1000, optionally under a prefix) and how much of the 1 MB is used. */
+    list: (prefix) => this.call("GET", "/v1/store", { query: { prefix } })
+  };
   // ── listings, wallet, ledger ──────────────────────────────────────────────
   listings = {
     /** Creates or updates an offering (price changes are versioned). */

package/dist/types.d.ts

@@ -218,6 +218,31 @@ export interface FileOptions {
     contentType?: string;
     ttlSeconds?: number;
 }
+/** `POST /v1/files` (0.1 TON a file). */
+export interface StoredFile {
+    id: string;
+    url: string;
+    size?: number;
+    content_type?: string;
+    cost?: number;
+    call_id?: string;
+}
+export interface StoreKey {
+    key: string;
+    size: number;
+    updated_at: string;
+}
+export interface StoreList {
+    keys: StoreKey[];
+    used_bytes: number;
+    limit_bytes: number;
+}
+export interface StoreWrite {
+    key: string;
+    size: number;
+    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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ambasada/sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TypeScript SDK for the Hack A Ton village: Checkout, webhooks, receipts, Pay, needs, LLM, images, tools, files, listings, wallet.",
   "type": "module",
   "license": "MIT",