tapimo 0.0.0 → 0.0.2

package/dist/internal/Schema.js

@@ -0,0 +1,360 @@
+import { Hex as core_Hex } from 'ox';
+import { Addresses } from 'viem/tempo';
+import * as z from 'zod/mini';
+/**
+ * Attaches an OpenAPI description to an object/array schema that is later
+ * derived from via `z.partial`/`z.extend`. `zod/mini` exposes descriptions only
+ * through `.check(z.describe(...))`, but that adds a refinement which those
+ * derivations reject. Cloning and registering the description directly (as
+ * classic zod's `.describe()` does) keeps the schema refinement-free. Plain
+ * fields use `.check(z.describe(...))` directly.
+ */
+export function describe(schema, description) {
+    const cloned = schema.clone();
+    z.globalRegistry.add(cloned, { ...z.globalRegistry.get(schema), description });
+    return cloned;
+}
+/** Representative account (EOA) address used as the default OpenAPI example. */
+const accountExample = '0xbe058e1c4df8a4366a387bf595b284246a93039e';
+// Pre-transform input for a 0x-prefixed 20-byte address. The OpenAPI example is
+// attached here (pre-transform) via `z.meta` so it surfaces on path/query
+// params; the lowercasing transform is applied after.
+const address = z.templateLiteral(['0x', z.string().check(z.regex(/^[0-9a-fA-F]{40}$/))]);
+// TODO(ox/zod): replace with ox's `Address` zod schema once ox ships a `zod`
+// entrypoint, so the wire format stays in lockstep with ox/viem.
+/** Lowercase 0x-prefixed 20-byte account address. */
+export const Address = z
+    .pipe(address.check(z.meta({ examples: [accountExample] })), 
+// `String.prototype.toLowerCase` widens its receiver from `Hex.Hex` to
+// `string`. Cast the result back so the schema's inferred output keeps the
+// hex-literal type — this is sound because lowercasing preserves both the
+// `0x` prefix and the upstream regex constraint.
+z.transform((value) => value.toLowerCase()))
+    .check(z.describe('An account address — the `0x`-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.'));
+/**
+ * Lowercase 0x-prefixed 20-byte TIP-20 token contract address. The OpenAPI
+ * example must be attached to the inner pre-transform schema (path/query
+ * params read examples from the pipe input), so callers that need a different
+ * example per field build a fresh `TokenAddress` via `tokenAddress(example)`
+ * instead of overriding via an outer `.check(z.meta(...))`.
+ */
+export const TokenAddress = tokenAddress(Addresses.pathUsd);
+/**
+ * Builds a `TokenAddress`-shaped schema with the given OpenAPI example. Use
+ * when a path/query param wants a different example than the shared
+ * `TokenAddress` default (e.g. the two sides of a trading pair).
+ *
+ * The example must be a TIP-20 token address (`0x20c` prefix); a non-TIP-20
+ * example in the docs would be misleading because the route validates the
+ * value as a TIP-20 token contract at runtime.
+ */
+export function tokenAddress(example) {
+    if (!example.toLowerCase().startsWith('0x20c'))
+        throw new Error(`tokenAddress example ${example} is not a TIP-20 token (must start with 0x20c).`);
+    return z
+        .pipe(address.check(z.meta({ examples: [example] })), z.transform((value) => value.toLowerCase()))
+        .check(z.describe('A TIP-20 token contract address — the `0x`-prefixed 20-byte identifier for the token, returned in lowercase.'));
+}
+/** Maps human-readable chain aliases to their Tempo chain id. */
+export const chainIdAlias = {
+    mainnet: 4217,
+    testnet: 42431,
+};
+/**
+ * Tempo chain id. Accepts a chain alias (`mainnet`/`testnet`) or any positive
+ * integer chain id (a number or numeric string), normalizing all forms to a
+ * numeric chain id. Arbitrary ids are allowed so a self-hosted deployment can
+ * serve a localnet (e.g. `31337`); the deployment must configure an `rpc`/`tidx`
+ * upstream for any chain beyond the built-in public defaults.
+ */
+export const ChainId = z
+    .pipe(z.union([
+    z.pipe(z.enum(['mainnet', 'testnet']), z.transform((alias) => chainIdAlias[alias])),
+    z.coerce.number(),
+]), z.number().check(z.int(), z.positive()))
+    .check(z.describe('Which Tempo network to query. Use the alias `mainnet` or `testnet`, or a numeric chain id (mainnet is `4217`).'), z.meta({ examples: [4217] }));
+/**
+ * Optional `chainId` query parameter shared across endpoints. Accepts a chain
+ * alias (`mainnet`/`testnet`) or a numeric chain id, normalizing both to a
+ * numeric {@link ChainId}.
+ */
+export const ChainIdQuery = z
+    // The default is documented in the description, not the JSON Schema `default`
+    // keyword: zod drops `default`/`examples` from the `anyOf` this pipe produces
+    // in input mode, and only `description` survives onto the generated query
+    // parameter. The runtime fallback for an omitted `chainId` is the app's
+    // configured `defaultChainId` (mainnet unless overridden), not a schema value.
+    .optional(ChainId)
+    .check(z.describe('Which Tempo network to query. Use the alias `mainnet` or `testnet`, or a numeric chain id. Defaults to `mainnet` when omitted.'), z.meta({ examples: [4217] }));
+const booleanQueryBase = z.pipe(z.enum(['true', 'false']), z.transform((value) => value === 'true'));
+/**
+ * Boolean query parameter. Query values arrive as the literal strings
+ * `"true"`/`"false"`, validated strictly and transformed to a real boolean.
+ * `z.boolean()` would reject the incoming string outright and
+ * `z.coerce.boolean()` is unsafe (`Boolean("false") === true`).
+ *
+ * The generated JSON Schema is overridden to a plain `boolean` so the parameter
+ * renders as a boolean — not a string — in the OpenAPI docs (and the generated
+ * CLI coerces it), while the wire format and strict `"true"`/`"false"`
+ * validation stay unchanged. The string `enum` that `z.enum` would emit is
+ * dropped (`enum: undefined`): left in place it makes consumers — e.g. the
+ * generated CLI — build a literal-`boolean` enum that then rejects the incoming
+ * string. Wrap with `z.optional(...)` / `z._default(..., value)` and describe
+ * with `.check(z.describe('…'))` at the call site — the override survives both.
+ * Returns a fresh clone per call so each call site is a distinct schema.
+ */
+export function booleanQuery() {
+    const cloned = booleanQueryBase.clone();
+    z.globalRegistry.add(cloned, {
+        ...z.globalRegistry.get(booleanQueryBase),
+        enum: undefined,
+        type: 'boolean',
+    });
+    return cloned;
+}
+/** One public API error detail. */
+export const ErrorDetail = z
+    .object({
+    message: z
+        .string()
+        .check(z.describe('A specific thing that went wrong, in plain language (e.g. why a field failed validation).')),
+    path: z
+        .optional(z.array(z.union([z.string(), z.number()])))
+        .check(z.describe('Where the problem is, as a path into your request (e.g. `["query", "limit"]`). Present for validation errors.')),
+})
+    .check(z.describe('A single problem with the request.'));
+/**
+ * Builds the global error envelope, optionally enumerating `error.code` to a
+ * fixed set of machine-readable codes. Pass the codes a given status can return
+ * (e.g. `['token_not_found']` for a 404) so the reference and generated clients
+ * narrow the code to a literal union instead of an open `string`. Omit `codes`
+ * for the open-coded envelope.
+ */
+export function errorResponse(codes) {
+    const code = (codes ? z.enum(codes) : z.string()).check(z.describe('A short, stable code you can branch on in your code (e.g. `token_not_found`).'));
+    return z
+        .object({
+        error: z
+            .object({
+            code,
+            details: z
+                .optional(z.array(ErrorDetail))
+                .check(z.describe('A list of specific problems, when the error is about your request (e.g. invalid fields).')),
+            message: z.string().check(z.describe('A human-readable explanation of what went wrong.')),
+        })
+            .check(z.describe('What went wrong.')),
+        requestId: z
+            .string()
+            .check(z.describe('The id of this request — include it when contacting support.')),
+    })
+        .check(z.describe('The standard shape returned for every error response.'));
+}
+/** Global error envelope with an open-coded `error.code`. */
+export const ErrorResponse = errorResponse();
+/** Representative 32-byte hash used as the default OpenAPI example. */
+const hashExample = '0x515801d7f9a5ac705e793e85904c9c69b3f1694b465cc8fb6ba3f0298dc82665';
+// TODO(ox/zod): replace with ox's `Hash` zod schema once ox ships a `zod`
+// entrypoint, so the wire format stays in lockstep with ox/viem.
+/**
+ * Lowercase 0x-prefixed 32-byte hash. The OpenAPI example is attached to the
+ * inner pre-transform schema (path/query params read examples from the pipe
+ * input), so every hash path param surfaces one without per-route overrides.
+ * Callers that need a different example per field build a fresh schema via
+ * `hash(example)` instead of overriding through an outer `.check(z.meta(...))`.
+ */
+export const Hash = hash(hashExample);
+/**
+ * Builds a {@link Hash}-shaped schema with the given OpenAPI example. Use when
+ * a path/query param wants a different example than the shared {@link Hash}
+ * default (e.g. a route that documents a specific real transaction).
+ *
+ * The example must be attached to the inner pre-transform schema because
+ * path/query params read examples from the pipe input.
+ */
+export function hash(example) {
+    return z
+        .pipe(z
+        .templateLiteral(['0x', z.string().check(z.regex(/^[0-9a-fA-F]{64}$/))])
+        .check(z.meta({ examples: [example] })), z.transform((value) => value.toLowerCase()))
+        .check(z.describe('A 32-byte hash, `0x`-prefixed and returned in lowercase — for example a transaction or block hash.'));
+}
+// TODO(ox/zod): replace with ox's `Hex` zod schema once ox ships a `zod`
+// entrypoint, so the wire format stays in lockstep with ox/viem.
+/** Lowercase 0x-prefixed hex byte data (may be empty, `0x`). */
+export const Hex = z
+    .pipe(z.string().check(z.regex(/^0x[0-9a-fA-F]*$/)), z.transform((value) => value.toLowerCase()))
+    .check(z.describe('Raw binary data as a `0x`-prefixed lowercase hex string (may be empty, just `0x`).'), z.meta({ examples: ['0xdeadbeef'] }));
+// TODO(ox/zod): replace with ox's `Quantity` zod schema once ox ships a `zod`
+// entrypoint, so the wire format stays in lockstep with ox/viem.
+/** Hex-encoded integer quantity (a `0x`-prefixed integer, e.g. `0x1a`). */
+export const Quantity = z
+    .templateLiteral(['0x', z.string().check(z.regex(/^[0-9a-fA-F]+$/))])
+    .check(z.describe('A whole number encoded as a `0x`-prefixed hexadecimal string (e.g. `0x1a` is 26).'), z.meta({ examples: ['0x1a'] }));
+/** Non-negative integer as a decimal string (preserves uint256 precision). */
+export const DecimalString = z
+    .string()
+    .check(z.regex(/^\d+$/), z.describe('A non-negative whole number, given as a decimal string so very large token amounts keep full precision. Expressed in the smallest unit of the token (e.g. `1000000` is 1.00 of a 6-decimal stablecoin).'), z.meta({ examples: ['1000000'] }));
+/**
+ * Minimum page size accepted across list endpoints. Floored at 5 because the
+ * indexer rejects signature-decoded `Transfer` queries with `LIMIT < 5`
+ * (HTTP 422); applying it globally keeps pagination uniform and removes the need
+ * for per-endpoint clamping.
+ */
+export const minLimit = 5;
+/** Page-size query parameter shared across list endpoints. */
+export const Limit = z
+    ._default(z.coerce.number().check(z.int(), z.gte(minLimit), z.lte(200)), 10)
+    .check(z.describe('How many items to return per page (5\u2013200, default 10).'), z.meta({ examples: [10] }));
+/** Opaque keyset-pagination cursor query parameter shared across list endpoints. */
+export const Cursor = z
+    .optional(z.string())
+    .check(z.describe('Opaque keyset cursor from a previous response (`nextCursor`); pass it back verbatim to fetch the next page. Omit for the first (head) page.'), z.meta({ examples: ['WzIzNDU2Nzg5LDBd'] }));
+/**
+ * Maximum page window (`page × limit` rows) accepted by positional pagination.
+ * Mirrors the indexer's own 10k row ceiling, and the bounded-window convention
+ * of comparable APIs (Elasticsearch `max_result_window`, Zendesk's 100-page
+ * cap): shallow page-numbered access is served positionally, deep traversal
+ * must use cursors.
+ */
+export const maxPageWindow = 10_000;
+/**
+ * Page-number query parameter (1-indexed) shared by list endpoints that
+ * support shallow positional pagination alongside keyset cursors. Cursors
+ * remain the canonical deep-traversal mode; the page lane exists for
+ * page-numbered UIs that need random access into the head of a feed.
+ */
+export const Page = z
+    .optional(z.coerce.number().check(z.int(), z.gte(1)))
+    .check(z.describe('Page number, 1-indexed (positional pagination for page-numbered access; `page=1` is ' +
+    'the head page). Mutually exclusive with `cursor`, and `page × limit` must be at most ' +
+    `${maxPageWindow} rows — use cursor pagination for deeper traversal. Pages are ` +
+    'positional, so rows arriving at the head of a live feed can shift page contents.'), z.meta({ examples: [1] }));
+/**
+ * Cross-field checks for list query schemas that accept both `cursor` and
+ * `page`: the two are mutually exclusive, and the page window is bounded by
+ * {@link maxPageWindow}. Spread into the query object's `.check(...)`.
+ */
+export function pageChecks() {
+    return [
+        z.refine((query) => query.cursor === undefined || query.page === undefined, {
+            error: '`cursor` and `page` are mutually exclusive; pass one or the other.',
+            path: ['page'],
+        }),
+        z.refine((query) => (query.page ?? 1) * query.limit <= maxPageWindow, {
+            error: `\`page × limit\` must be at most ${maxPageWindow} rows; use cursor pagination for deeper traversal.`,
+            path: ['page'],
+        }),
+    ];
+}
+/** Opaque next-page cursor response field shared across list endpoints. */
+export const NextCursor = z
+    .nullable(z.string())
+    .check(z.describe('Pass this back as the `cursor` query parameter to fetch the next page. `null` once you have reached the end of the list.'), z.meta({ examples: ['WzIzNDU2Nzg5LDBd'] }));
+/**
+ * Upper bound on the matched-row count surfaced by `include=totalCount`. The
+ * count is computed by a capped subquery (`… LIMIT countCap`) so it can't blow
+ * the indexer's execution budget on the 10⁹-plus row tables; when the bound is
+ * hit the count is a lower bound, signalled by `Meta.totalCountCapped`. Mirrors the
+ * indexer's own 10k row ceiling (see {@link maxPageWindow}) and the capped-count
+ * conventions of comparable APIs (Stripe Search's 10k `total_count`,
+ * Elasticsearch `track_total_hits`, Shopify's `Count.precision`).
+ */
+export const countCap = 10_000;
+/**
+ * Total matched-row count response field for list endpoints that support
+ * `include=totalCount`. Exact when {@link TotalCountCapped} is `false`; a lower
+ * bound ("at least this many") when `true`. Independent of pagination —
+ * `nextCursor` remains the only end-of-list signal.
+ */
+export const TotalCount = z
+    .number()
+    .check(z.int(), z.nonnegative(), z.describe('Number of rows matching the query, exact when `totalCountCapped` is false and a lower ' +
+    `bound (at least this many, computed up to ${countCap}) when \`totalCountCapped\` is ` +
+    'true. Independent of pagination: use `nextCursor` to page, not this count.'), z.meta({ examples: [42] }));
+/**
+ * Whether {@link TotalCount} hit the {@link countCap} bound. `true` means the
+ * count is a lower bound ("at least `totalCount` rows match"); `false` means it
+ * is exact.
+ */
+export const TotalCountCapped = z
+    .boolean()
+    .check(z.describe('Whether `totalCount` hit the count cap. When true, `totalCount` is a lower bound rather ' +
+    'than an exact total.'), z.meta({ examples: [false] }));
+/** Sort-direction (`asc`/`desc`) query parameter shared across list endpoints. */
+export const Order = z
+    ._default(z.enum(['asc', 'desc']), 'desc')
+    .check(z.describe('Sort order: `desc` for descending (the default), or `asc` for ascending.'), z.meta({ examples: ['desc'] }));
+/**
+ * Optional inclusive block-number bound query parameter (`blockNumber.from` /
+ * `blockNumber.to`). `noun` is the resource being listed (e.g. `transfers`) so
+ * the description reads naturally across endpoints.
+ */
+export function blockNumberBound(noun, bound) {
+    const direction = bound === 'from' ? 'at or after' : 'at or before';
+    return z
+        .optional(z.coerce.number().check(z.int(), z.nonnegative()))
+        .check(z.describe(`Only include ${noun} ${direction} this block number.`), z.meta({ examples: [bound === 'from' ? 23456789 : 23456999] }));
+}
+/**
+ * Optional inclusive ISO-8601 timestamp bound query parameter (`timestamp.from`
+ * / `timestamp.to`). `noun` is the resource being listed (e.g. `transfers`).
+ */
+export function timestampBound(noun, bound) {
+    const direction = bound === 'from' ? 'at or after' : 'at or before';
+    return z.optional(z.iso.datetime({ offset: true })).check(z.describe(`Only include ${noun} ${direction} this ISO 8601 timestamp.`), z.meta({
+        examples: [bound === 'from' ? '2024-01-01T00:00:00Z' : '2024-12-31T23:59:59Z'],
+    }));
+}
+/**
+ * Builds the schema for a comma-separated opt-in query parameter (e.g.
+ * `?include=token,feeToken`), parsed into a validated array of the given enum's
+ * members. Absent or empty values yield `[]`. Centralizes the splitting,
+ * trimming, and OpenAPI array-enum metadata that every list endpoint otherwise
+ * repeats.
+ *
+ * A repeated parameter (`?include=token&include=feeToken`) arrives from the
+ * validator as a `string[]`, so the input accepts both forms and each entry is
+ * still comma-split — the two styles compose freely.
+ *
+ * Pass the endpoint's `Include` enum — kept local so its members drive both the
+ * parsed type and the docs — plus the param description.
+ */
+export function includeQuery(member, description) {
+    return z
+        .pipe(z.pipe(
+    // `optional(unknown)` keeps the parameter optional in object inputs
+    // while staying opaque to JSON-schema generation — a structural
+    // `string | string[]` union would leak a contradictory `anyOf` next to
+    // the explicit `meta` below, which is the documented contract.
+    z.optional(z.unknown()), z.transform((value) => {
+        const parts = value === undefined ? [] : Array.isArray(value) ? value : [value];
+        return parts
+            .flatMap((entry) => String(entry).split(','))
+            .map((entry) => entry.trim())
+            .filter(Boolean);
+    })), z.array(member))
+        .check(z.meta({
+        type: 'array',
+        items: { type: 'string', enum: member.options },
+        description,
+        examples: [member.options],
+    }));
+}
+/**
+ * Ready-made `include` query parameter for list endpoints whose only optional
+ * resource is the capped total count (`?include=totalCount`). Endpoints that
+ * embed additional resources define their own enum that also lists `totalCount`
+ * (e.g. transfers' `memo,token,totalCount`).
+ */
+export const totalCountInclude = includeQuery(z.enum(['totalCount']).check(z.describe('Optional resources to embed via `include`.')), 'Comma-separated optional resources to embed, e.g. `totalCount`.');
+/**
+ * Response-wide `meta` object for list endpoints whose only embeddable resource
+ * is the capped total count. Present only when `include=totalCount` was
+ * requested; omitted otherwise. Endpoints that embed additional response-wide
+ * resources alongside the count define their own `Meta` that also carries
+ * {@link TotalCount}/{@link TotalCountCapped}.
+ */
+export const CountMeta = z
+    .object({ totalCountCapped: TotalCountCapped, totalCount: TotalCount })
+    .check(z.describe('Response-wide resources embedded on demand via `include`.'));
+//# sourceMappingURL=Schema.js.map

package/dist/internal/Schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.js","sourceRoot":"","sources":["../../src/internal/Schema.ts"],"names":[],"mappings":"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"}

package/dist/internal/Store.d.ts

@@ -0,0 +1,204 @@
+/** Minimal string store contract used by Tempo API internals. */
+export type Store = {
+    /** Deletes a key. */
+    delete(key: string): Promise<void>;
+    /** Gets a string value. Returns `null` for missing or expired keys. */
+    get(key: string): Promise<null | string>;
+    /**
+     * Optional native counter: increments an integer value and returns the new
+     * count. A missing or expired key restarts at `1`; `ttl` applies like
+     * {@link Store.put}. Implement when the backend can execute the
+     * read-modify-write in one place (in-memory, inside a Durable Object);
+     * consumers go through the {@link increment} helper, which falls back to a
+     * get + put when this is absent.
+     */
+    increment?: ((key: string, options?: Store.PutOptions) => Promise<number>) | undefined;
+    /** Lists keys. */
+    list(options?: {
+        /** Restrict results to keys with this prefix. */
+        prefix?: string | undefined;
+    }): Promise<{
+        /** Matching keys. */
+        keys: readonly {
+            /** Key name. */
+            name: string;
+        }[];
+    }>;
+    /** Writes a string value, optionally with a time-to-live. */
+    put(key: string, value: string, options?: Store.PutOptions): Promise<void>;
+    /**
+     * Store kind discriminant. `'state'` marks an authoritative, enumerable
+     * store ({@link State}); `'cache'` marks a cache (e.g. the Web Cache,
+     * which cannot enumerate keys and silently drops entries).
+     */
+    type: Store.Type;
+};
+export declare namespace Store {
+    /** Store kind: `'state'` (authoritative, enumerable) or `'cache'` (a cache). */
+    type Type = 'state' | 'cache';
+    /** Options for writing a value to a store. */
+    type PutOptions = {
+        /**
+         * Time-to-live in milliseconds. After this duration the key is treated as
+         * absent. Production backends should map this to native expiration
+         * (Redis `PEXPIRE`, Cloudflare `expirationTtl`, etc.).
+         */
+        ttl?: number | undefined;
+    };
+}
+/**
+ * An authoritative, enumerable {@link Store} for stateful features (webhook
+ * subscriptions, rate-limit counters, …). Discriminated by `type: 'state'` so
+ * stateful features can require it at the type level and reject cache adapters
+ * like the Web Cache ({@link cache}, `type: 'cache'`), which cannot enumerate
+ * keys and silently drops entries on eviction. `memory`, `cloudflareKv`, and
+ * `durableObject` produce it.
+ */
+export type State = Store & {
+    type: 'state';
+};
+/**
+ * Wraps store operations into a {@link Store}, defaulting to an authoritative
+ * {@link State} store. Omit `type` for the common authoritative case; pass
+ * `type: 'cache'` to opt into a cache-kind store (non-enumerable, lossy — e.g.
+ * the Web Cache).
+ */
+export declare function from<const store extends from.Input>(store: store): from.Output<store>;
+export declare namespace from {
+    /** Store operations with an optional kind discriminant (defaults to `'state'`). */
+    type Input = Omit<Store, 'type'> & {
+        /** Store kind; defaults to `'state'`. Pass `'cache'` for a cache-kind store. */
+        type?: Store.Type | undefined;
+    };
+    /** Resolved store kind: {@link State} unless `type: 'cache'` is provided. */
+    type Output<store extends Input> = store extends {
+        type: 'cache';
+    } ? Store : State;
+}
+/**
+ * Increments an integer counter on a store and returns the new value. A
+ * missing or expired key restarts at `1`; `ttl` applies like {@link Store.put}.
+ *
+ * Uses the store's native {@link Store.increment} when implemented (atomic
+ * where the backend executes it in one place — in-memory, inside a Durable
+ * Object). Otherwise falls back to a get + put read-modify-write, which
+ * costs two round trips on remote stores and can race under concurrency —
+ * fine for dev/in-process backends, not for enforced distributed counters.
+ */
+export declare function increment(store: Store, key: string, options?: Store.PutOptions): Promise<number>;
+/** Creates an in-memory store with TTL support. */
+export declare function memory(options?: memory.Options): State;
+export declare namespace memory {
+    /** Options for creating an in-memory store. */
+    type Options = {
+        /** Initial entries. */
+        entries?: readonly (readonly [string, string])[] | undefined;
+    };
+}
+/**
+ * Creates a store backed by a Web Cache API instance (e.g. Cloudflare's
+ * colo-local `caches.default`). Values are stored as cache entries keyed by a
+ * synthetic URL, with `ttl` mapped to `Cache-Control: max-age`. The Web Cache
+ * cannot enumerate keys, so `list` returns no keys — use this for caching
+ * (get/put/delete) only, e.g. the origin read cache and edge response cache.
+ */
+export declare function cache(webCache: cache.Cache): Store;
+export declare namespace cache {
+    /** Minimal Web Cache API surface used by this adapter. */
+    type Cache = {
+        /** Deletes a cache entry. */
+        delete(request: Request | string): Promise<boolean>;
+        /** Looks up a cache entry. */
+        match(request: Request | string): Promise<Response | undefined>;
+        /** Stores a cache entry. */
+        put(request: Request | string, response: Response): Promise<void>;
+    };
+}
+/** Creates a store backed by a Cloudflare Workers KV namespace. */
+export declare function cloudflareKv(namespace: cloudflareKv.Namespace): State;
+export declare namespace cloudflareKv {
+    /** Minimal Cloudflare Workers KV namespace shape used by this adapter. */
+    type Namespace = {
+        /** Deletes a key. */
+        delete(key: string): Promise<void>;
+        /** Gets a text value. */
+        get(key: string): Promise<null | string>;
+        /** Lists keys. */
+        list(options?: {
+            /** Restrict results to keys with this prefix. */
+            prefix?: string | null | undefined;
+        }): Promise<{
+            /** Matching keys. */
+            keys: readonly {
+                /** Key name. */
+                name: string;
+            }[];
+        }>;
+        /** Writes a text value. */
+        put(key: string, value: string, options?: {
+            /** Native Cloudflare KV TTL in seconds. */
+            expirationTtl?: number | undefined;
+        }): Promise<void>;
+    };
+}
+export declare function durableObject(storage: durableObject.Storage): State;
+export declare function durableObject(namespace: durableObject.Namespace, options: durableObject.Options): State;
+export declare namespace durableObject {
+    /** Minimal Durable Object namespace shape used by this adapter. */
+    type Namespace = {
+        /** Gets the Durable Object stub for a stable object name. */
+        getByName(name: string): Stub;
+    };
+    /** Options for creating a store from a Durable Object namespace. */
+    type Options = {
+        /**
+         * Durable Object name. A static string pins one object holding every key
+         * (enumerable via `list`). A resolver function shards keys across objects
+         * (`name(key)` per operation) so each key's object is created near the
+         * traffic that uses it — sharded stores cannot `list`.
+         */
+        name: string | ((key: string) => string);
+    };
+    /** Minimal Cloudflare Durable Object storage shape used by this adapter. */
+    type Storage = {
+        /** Deletes a key. */
+        delete(key: string): Promise<unknown>;
+        /** Gets a stored value. */
+        get<value = unknown>(key: string): Promise<undefined | value>;
+        /** Lists stored values. */
+        list<value = unknown>(options?: {
+            /** Restrict results to keys with this prefix. */
+            prefix?: string | undefined;
+        }): Promise<Map<string, value>>;
+        /** Writes a stored value. */
+        put<value>(key: string, value: value): Promise<void>;
+    };
+    /**
+     * Minimal Durable Object RPC stub shape used by this adapter — just the store
+     * operations (no `type` discriminant, which an RPC stub doesn't carry).
+     * `increment` is required: the stub mirrors the `tapimo/cloudflare`
+     * `DurableObject` class, whose RPC surface implements it.
+     */
+    type Stub = Omit<Store, 'increment' | 'type'> & {
+        /** Atomically increments an integer counter inside the object. */
+        increment(key: string, options?: Store.PutOptions): Promise<number>;
+    };
+}
+/**
+ * Wraps an async producer with store-backed caching. Returns the cached value if
+ * present and valid; otherwise runs `fetch`, stores the JSON-encoded result
+ * under `key` with `ttl` milliseconds, and returns it.
+ */
+export declare function memoize<value>(fetch: () => Promise<value>, options: memoize.Options): Promise<value>;
+export declare namespace memoize {
+    /** Options for {@link memoize}. */
+    type Options = {
+        /** Cache key. Callers are responsible for namespacing/versioning. */
+        key: string;
+        /** Store used to persist cache entries. */
+        store: Store;
+        /** Time-to-live in milliseconds. */
+        ttl: number;
+    };
+}
+//# sourceMappingURL=Store.d.ts.map

package/dist/internal/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../src/internal/Store.ts"],"names":[],"mappings":"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"}