@apicity/xai 0.4.1 → 0.4.2

package/README.md

@@ -1,14 +1,13 @@
 # @apicity/xai
 
 [![npm](https://img.shields.io/npm/v/@apicity/xai?color=cb0000)](https://www.npmjs.com/package/@apicity/xai)
-[![dependencies](https://img.shields.io/badge/dependencies-2-blue)](package.json)
+[![dependencies](https://img.shields.io/badge/dependencies-1-blue)](package.json)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue?logo=typescript&logoColor=white)](tsconfig.json)
 
 X.AI / Grok provider for chat and search.
 
 Runtime dependencies:
 
-- `@apicity/cost@workspace:*` — OTP pay-gate (`withPaidGate`) for paid endpoints
 - `zod@^3.24.0` — request schemas attached to every POST endpoint as `.schema`
 
 ## Installation
@@ -144,7 +143,7 @@ console.log(result.usage);
 
 ## API Reference
 
-45 endpoints across 18 groups. Each method mirrors an upstream URL path.
+46 endpoints across 18 groups. Each method mirrors an upstream URL path.
 
 ### apiKey
 
@@ -392,7 +391,7 @@ Source: [`packages/provider/xai/src/xai.ts`](src/xai.ts)
 
 <code>POST https://api.x.ai/v1/images/edits</code>
 
-[Upstream docs ↗](https://docs.x.ai/docs/api-reference)
+[Upstream docs ↗](https://docs.x.ai/developers/rest-api-reference/inference/images)
 
 ```typescript
 const res = await xai.v1.images.edits({ /* ... */ });
@@ -407,7 +406,7 @@ Source: [`packages/provider/xai/src/xai.ts`](src/xai.ts)
 
 <code>POST https://api.x.ai/v1/images/generations</code>
 
-[Upstream docs ↗](https://docs.x.ai/docs/api-reference)
+[Upstream docs ↗](https://docs.x.ai/developers/rest-api-reference/inference/images)
 
 ```typescript
 const res = await xai.v1.images.generations({ /* ... */ });
@@ -857,6 +856,21 @@ Source: [`packages/provider/xai/src/xai.ts`](src/xai.ts)
 
 </details>
 
+<details>
+<summary><code>POST</code> <b><code>xai.v1.videos.generations.imageToVideo</code></b></summary>
+
+<code>POST https://api.x.ai/v1/videos/generations</code>
+
+[Upstream docs ↗](https://docs.x.ai/developers/model-capabilities/video/image-to-video)
+
+```typescript
+const res = await xai.v1.videos.generations.imageToVideo({ /* ... */ });
+```
+
+Source: [`packages/provider/xai/src/xai.ts`](src/xai.ts)
+
+</details>
+
 ## Middleware
 
 ```typescript

package/dist/src/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAiJ7C,CAAC;AAEF,eAAe,QAAQ,CAAC;AAOxB,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CA6ChD"}
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA4I7C,CAAC;AAEF,eAAe,QAAQ,CAAC;AAOxB,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CA6ChD"}

package/dist/src/example.js

@@ -6,9 +6,9 @@
 // hangs the matching entry off each endpoint function as `.example`.
 const EXAMPLES = {
     "POST managementApi.v1.collections": {
-        "source": "xai/collections-docs",
+        "source": "xai/collections-documents-add",
         "payload": {
-            "name": "test-delete-doc-1775143467493"
+            "collection_name": "test-collection-for-docs"
         }
     },
     "POST managementApi.v1.collections.documents": {
@@ -59,23 +59,15 @@ const EXAMPLES = {
             "temperature": 0
         }
     },
-    "POST v1.documents.search": {
-        "source": "xai/documents-search",
-        "payload": {
-            "query": "test",
-            "limit": 10,
-            "filters": {
-                "collection_id": "test-collection"
-            }
-        }
-    },
     "POST v1.images.edits": {
-        "source": "xai/image-edits",
+        "source": "xai/image-edit-single",
         "payload": {
-            "model": "grok-2-image-1212",
-            "image": {},
-            "prompt": "Add a sunset background",
-            "n": 1
+            "prompt": "Render this as a pencil sketch with detailed shading",
+            "model": "grok-imagine-image",
+            "image": {
+                "url": "<inline image/jpeg data URL — replace with a real URL or upload>",
+                "type": "image_url"
+            }
         }
     },
     "POST v1.images.generations": {
@@ -94,10 +86,10 @@ const EXAMPLES = {
         }
     },
     "POST v1.responses": {
-        "source": "xai/responses-crud",
+        "source": "xai/responses-crud-create",
         "payload": {
-            "model": "grok-2",
-            "input": "Delete this"
+            "model": "grok-4-fast",
+            "input": "Hello!"
         }
     },
     "POST v1.tokenizeText": {
@@ -137,10 +129,13 @@ const EXAMPLES = {
         }
     },
     "POST v1.videos.generations": {
-        "source": "xai/video-get",
+        "source": "xai/video-text-to-video",
         "payload": {
-            "model": "grok-video",
-            "prompt": "A cat playing with a ball"
+            "prompt": "A white cat with heterochromia eyes walking across a rooftop at golden hour, cinematic drone shot",
+            "model": "grok-imagine-video",
+            "duration": 10,
+            "aspect_ratio": "16:9",
+            "resolution": "720p"
         }
     },
     "PUT managementApi.v1.collections": {

package/dist/src/example.js.map

@@ -1 +1 @@
-{"version":3,"file":"example.js","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,+DAA+D;AAC/D,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAC3E,qEAAqE;AAOrE,MAAM,QAAQ,GAAoC;IAChD,mCAAmC,EAAE;QACnC,QAAQ,EAAE,sBAAsB;QAChC,SAAS,EAAE;YACT,MAAM,EAAE,+BAA+B;SACxC;KACF;IACD,6CAA6C,EAAE;QAC7C,QAAQ,EAAE,+BAA+B;QACzC,SAAS,EAAE,EAAE;KACd;IACD,iBAAiB,EAAE;QACjB,QAAQ,EAAE,eAAe;QACzB,SAAS,EAAE;YACT,MAAM,EAAE,gBAAgB;SACzB;KACF;IACD,wBAAwB,EAAE;QACxB,QAAQ,EAAE,kBAAkB;QAC5B,SAAS,EAAE,EAAE;KACd;IACD,0BAA0B,EAAE;QAC1B,QAAQ,EAAE,oBAAoB;QAC9B,SAAS,EAAE;YACT,gBAAgB,EAAE;gBAChB;oBACE,kBAAkB,EAAE,YAAY;oBAChC,eAAe,EAAE;wBACf,qBAAqB,EAAE;4BACrB,UAAU,EAAE;gCACV;oCACE,MAAM,EAAE,MAAM;oCACd,SAAS,EAAE,cAAc;iCAC1B;6BACF;4BACD,OAAO,EAAE,QAAQ;yBAClB;qBACF;iBACF;aACF;SACF;KACF;IACD,0BAA0B,EAAE;QAC1B,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE;YACT,OAAO,EAAE,aAAa;YACtB,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,4BAA4B;iBACxC;aACF;YACD,aAAa,EAAE,CAAC;SACjB;KACF;IACD,0BAA0B,EAAE;QAC1B,QAAQ,EAAE,sBAAsB;QAChC,SAAS,EAAE;YACT,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,EAAE;YACX,SAAS,EAAE;gBACT,eAAe,EAAE,iBAAiB;aACnC;SACF;KACF;IACD,sBAAsB,EAAE;QACtB,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE;YACT,OAAO,EAAE,mBAAmB;YAC5B,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,yBAAyB;YACnC,GAAG,EAAE,CAAC;SACP;KACF;IACD,4BAA4B,EAAE;QAC5B,QAAQ,EAAE,0BAA0B;QACpC,SAAS,EAAE;YACT,QAAQ,EAAE,0CAA0C;YACpD,OAAO,EAAE,oBAAoB;YAC7B,GAAG,EAAE,CAAC;SACP;KACF;IACD,gCAAgC,EAAE;QAChC,QAAQ,EAAE,6BAA6B;QACvC,SAAS,EAAE;YACT,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,MAAM;SAChB;KACF;IACD,mBAAmB,EAAE;QACnB,QAAQ,EAAE,oBAAoB;QAC9B,SAAS,EAAE;YACT,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,aAAa;SACvB;KACF;IACD,sBAAsB,EAAE;QACtB,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE;YACT,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,cAAc;SACvB;KACF;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE;YACT,MAAM,EAAE,2CAA2C;YACnD,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,IAAI;SACjB;KACF;IACD,sBAAsB,EAAE;QACtB,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE;YACT,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,kCAAkC;YAC5C,OAAO,EAAE;gBACP,KAAK,EAAE,4DAA4D;aACpE;SACF;KACF;IACD,2BAA2B,EAAE;QAC3B,QAAQ,EAAE,4BAA4B;QACtC,SAAS,EAAE;YACT,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,sEAAsE;YAChF,OAAO,EAAE;gBACP,KAAK,EAAE,4DAA4D;aACpE;YACD,UAAU,EAAE,CAAC;SACd;KACF;IACD,4BAA4B,EAAE;QAC5B,QAAQ,EAAE,eAAe;QACzB,SAAS,EAAE;YACT,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE,2BAA2B;SACtC;KACF;IACD,kCAAkC,EAAE;QAClC,QAAQ,EAAE,4BAA4B;QACtC,SAAS,EAAE;YACT,iBAAiB,EAAE,yBAAyB;SAC7C;KACF;CACF,CAAC;AAEF,eAAe,QAAQ,CAAC;AAExB,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AACzE,0EAA0E;AAC1E,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAAI,QAAW;IAC3C,MAAM,IAAI,GAAG,QAAmC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACrB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAmB;YACjC,IAAI,CAAC,MAAM,CAAC;YACX,IAAI,CAAC,MAAM,CAAyC,EAAE,GAAG;YAC1D,IAAI;SACL,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,SAAS,GAAI,GAA+B,CAAC,MAAM,CAAC,CAAC;gBAC3D,IAAI,SAAS;oBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,EAAE,EAAE,CAAC;gBACP,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/B,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,QAAQ;YAAE,SAAS;QACvB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,SAAS;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,SAAS;YAC9C,MAAM,SAAS,GAAI,GAA+B,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,CAAC,SAAS;gBAAE,SAAS;YACzB,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACrC,IAAI,EAAE,EAAE,CAAC;gBACP,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/B,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,IAAc;IAC9C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAK,KAAgB,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,KAAgD,CAAC;QACjE,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,GAAG,GAAY,KAAK,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACnD,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC;QACrB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACpD,GAAG,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,GAAG,KAAK,UAAU;QAC9B,CAAC,CAAE,GAAuC;QAC1C,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -2,5 +2,5 @@ export { createXai } from "./xai";
 export { XaiError } from "./types";
 export { withRetry, withFallback, withRateLimit, createRateLimiter, XAI_RATE_LIMITS, } from "./middleware";
 export type { RetryOptions, FallbackOptions, RateLimiterOptions, RateLimiter, RateLimitOptions, } from "./middleware";
-export type { XaiOptions, XaiMessage, XaiToolFunction, XaiTool, XaiToolCall, XaiUsage, XaiChatChoice, XaiChatRequest, XaiChatResponse, XaiDeferredChatCompletionResult, XaiImageGenerateRequest, XaiImageEditRequest, XaiImageReference, XaiGeneratedImage, XaiImageResponse, XaiVideoGenerateRequest, XaiVideoEditRequest, XaiVideoExtendRequest, XaiVideoReference, XaiVideoAsyncResponse, XaiVideoData, XaiVideoResult, XaiFileObject, XaiFileListResponse, XaiBatchState, XaiBatch, XaiBatchCreateRequest, XaiBatchListResponse, XaiBatchListParams, XaiBatchRequestMetadata, XaiBatchRequestListResponse, XaiBatchRequestListParams, XaiBatchRequestItem, XaiBatchAddRequestsBody, XaiBatchResultItem, XaiBatchResultListResponse, XaiBatchResultListParams, XaiChunkConfiguration, XaiFieldDefinition, XaiCollectionCreateRequest, XaiCollection, XaiCollectionListParams, XaiCollectionListResponse, XaiCollectionUpdateRequest, XaiDocumentFileMetadata, XaiDocument, XaiDocumentListParams, XaiDocumentListResponse, XaiDocumentAddRequest, XaiDocumentSearchRequest, XaiDocumentSearchMatch, XaiDocumentSearchResponse, XaiResponseRequest, XaiResponseResponse, XaiResponseInputItem, XaiResponseInputMessage, XaiResponseInputContent, XaiResponseInputTextContent, XaiResponseInputImageContent, XaiResponseFunctionCallOutput, XaiResponseItemReference, XaiResponseTool, XaiResponseFunctionTool, XaiResponseWebSearchTool, XaiResponseFileSearchTool, XaiResponseTextFormat, XaiResponseReasoning, XaiResponseSearchParameters, XaiResponseOutputItem, XaiResponseOutputMessage, XaiResponseOutputContent, XaiResponseOutputText, XaiResponseRefusal, XaiResponseAnnotation, XaiResponseFunctionCallItem, XaiResponseWebSearchCallItem, XaiResponseFileSearchCallItem, XaiResponseUsage, XaiResponseDeleteResponse, XaiModel, XaiModelListResponse, XaiLanguageModel, XaiLanguageModelListResponse, XaiImageGenerationModel, XaiImageGenerationModelListResponse, XaiVideoGenerationModel, XaiVideoGenerationModelListResponse, XaiTokenizeTextRequest, XaiToken, XaiTokenizeTextResponse, XaiRealtimeClientSecretRequest, XaiRealtimeClientSecretResponse, XaiRealtimeTurnDetection, XaiRealtimeAudioFormat, XaiRealtimeAudioConfig, XaiRealtimeFunctionTool, XaiRealtimeWebSearchTool, XaiRealtimeXSearchTool, XaiRealtimeFileSearchTool, XaiRealtimeMcpTool, XaiRealtimeTool, XaiRealtimeSession, XaiRealtimeClientEvent, XaiRealtimeSessionUpdate, XaiRealtimeInputAudioBufferAppend, XaiRealtimeInputAudioBufferCommit, XaiRealtimeConversationItemCreate, XaiRealtimeResponseCreate, XaiRealtimeResponseCancel, XaiRealtimeServerEvent, XaiRealtimeConversationCreated, XaiRealtimeSessionUpdated, XaiRealtimeSpeechStarted, XaiRealtimeSpeechStopped, XaiRealtimeAudioBufferCommitted, XaiRealtimeConversationItemAdded, XaiRealtimeTranscriptionCompleted, XaiRealtimeResponseCreated, XaiRealtimeResponseDone, XaiRealtimeOutputItemAdded, XaiRealtimeOutputItemDone, XaiRealtimeAudioDelta, XaiRealtimeAudioDone, XaiRealtimeAudioTranscriptDelta, XaiRealtimeAudioTranscriptDone, XaiRealtimeTextDelta, XaiRealtimeTextDone, XaiRealtimeFunctionCallDelta, XaiRealtimeFunctionCallDone, XaiRealtimeContentPartAdded, XaiRealtimeContentPartDone, XaiRealtimeError, XaiRealtimeConnectOptions, XaiRealtimeConnection, XaiTtsRequest, XaiSttRequest, XaiSttWord, XaiSttResponse, XaiCustomVoiceCreateRequest, XaiCustomVoice, XaiApiKeyInfo, XaiManagementApiKey, XaiManagementApiKeyListParams, XaiManagementApiKeyListResponse, XaiUsdCents, XaiBillingBalanceChangeOrigin, XaiBillingTopupStatus, XaiBillingPaymentProcessor, XaiBillingPrepaidBalanceChange, XaiBillingPrepaidBalanceResponse, XaiBillingInvoiceLine, XaiBillingPostpaidInvoicePreviewResponse, XaiBillingPostpaidSpendingLimitsResponse, XaiBillingUsageDataPoint, XaiBillingUsageTimeSeries, XaiBillingUsageRequest, XaiBillingUsageResponse, XaiProvider, } from "./types";
+export type { XaiOptions, XaiMessage, XaiToolFunction, XaiTool, XaiToolCall, XaiUsage, XaiChatChoice, XaiChatRequest, XaiChatResponse, XaiDeferredChatCompletionResult, XaiImageGenerateRequest, XaiImageEditRequest, XaiImageReference, XaiImageFileOutput, XaiGeneratedImage, XaiImageUsage, XaiImageResponse, XaiVideoGenerateRequest, XaiGrokImagineVideo15ImageToVideoRequest, XaiGrokImagineVideo15ImageToVideoResponse, XaiVideoEditRequest, XaiVideoExtendRequest, XaiVideoReference, XaiVideoReferenceInput, XaiVideoAsyncResponse, XaiVideoData, XaiVideoUsage, XaiVideoResult, XaiFileObject, XaiFileListResponse, XaiBatchState, XaiBatch, XaiBatchCreateRequest, XaiBatchListResponse, XaiBatchListParams, XaiBatchRequestMetadata, XaiBatchRequestListResponse, XaiBatchRequestListParams, XaiBatchRequestItem, XaiBatchAddRequestsBody, XaiBatchResultItem, XaiBatchResultListResponse, XaiBatchResultListParams, XaiChunkConfiguration, XaiFieldDefinition, XaiCollectionCreateRequest, XaiCollection, XaiCollectionListParams, XaiCollectionListResponse, XaiCollectionUpdateRequest, XaiDocumentFileMetadata, XaiDocument, XaiDocumentListParams, XaiDocumentListResponse, XaiDocumentAddRequest, XaiDocumentSearchRequest, XaiDocumentSearchMatch, XaiDocumentSearchResponse, XaiResponseRequest, XaiResponseResponse, XaiResponseInputItem, XaiResponseInputMessage, XaiResponseInputContent, XaiResponseInputTextContent, XaiResponseInputImageContent, XaiResponseFunctionCallOutput, XaiResponseItemReference, XaiResponseTool, XaiResponseFunctionTool, XaiResponseWebSearchTool, XaiResponseFileSearchTool, XaiResponseTextFormat, XaiResponseReasoning, XaiResponseSearchParameters, XaiResponseOutputItem, XaiResponseOutputMessage, XaiResponseOutputContent, XaiResponseOutputText, XaiResponseRefusal, XaiResponseAnnotation, XaiResponseFunctionCallItem, XaiResponseWebSearchCallItem, XaiResponseFileSearchCallItem, XaiResponseUsage, XaiResponseDeleteResponse, XaiModel, XaiModelListResponse, XaiLanguageModel, XaiLanguageModelListResponse, XaiImageGenerationModel, XaiImageGenerationModelListResponse, XaiVideoGenerationModel, XaiVideoGenerationModelListResponse, XaiTokenizeTextRequest, XaiToken, XaiTokenizeTextResponse, XaiRealtimeClientSecretRequest, XaiRealtimeClientSecretResponse, XaiRealtimeTurnDetection, XaiRealtimeAudioFormat, XaiRealtimeAudioConfig, XaiRealtimeFunctionTool, XaiRealtimeWebSearchTool, XaiRealtimeXSearchTool, XaiRealtimeFileSearchTool, XaiRealtimeMcpTool, XaiRealtimeTool, XaiRealtimeSession, XaiRealtimeClientEvent, XaiRealtimeSessionUpdate, XaiRealtimeInputAudioBufferAppend, XaiRealtimeInputAudioBufferCommit, XaiRealtimeConversationItemCreate, XaiRealtimeResponseCreate, XaiRealtimeResponseCancel, XaiRealtimeServerEvent, XaiRealtimeConversationCreated, XaiRealtimeSessionUpdated, XaiRealtimeSpeechStarted, XaiRealtimeSpeechStopped, XaiRealtimeAudioBufferCommitted, XaiRealtimeConversationItemAdded, XaiRealtimeTranscriptionCompleted, XaiRealtimeResponseCreated, XaiRealtimeResponseDone, XaiRealtimeOutputItemAdded, XaiRealtimeOutputItemDone, XaiRealtimeAudioDelta, XaiRealtimeAudioDone, XaiRealtimeAudioTranscriptDelta, XaiRealtimeAudioTranscriptDone, XaiRealtimeTextDelta, XaiRealtimeTextDone, XaiRealtimeFunctionCallDelta, XaiRealtimeFunctionCallDone, XaiRealtimeContentPartAdded, XaiRealtimeContentPartDone, XaiRealtimeError, XaiRealtimeConnectOptions, XaiRealtimeConnection, XaiTtsRequest, XaiSttRequest, XaiSttWord, XaiSttResponse, XaiCustomVoiceCreateRequest, XaiCustomVoice, XaiApiKeyInfo, XaiManagementApiKey, XaiManagementApiKeyListParams, XaiManagementApiKeyListResponse, XaiUsdCents, XaiBillingBalanceChangeOrigin, XaiBillingTopupStatus, XaiBillingPaymentProcessor, XaiBillingPrepaidBalanceChange, XaiBillingPrepaidBalanceResponse, XaiBillingInvoiceLine, XaiBillingPostpaidInvoicePreviewResponse, XaiBillingPostpaidSpendingLimitsResponse, XaiBillingUsageDataPoint, XaiBillingUsageTimeSeries, XaiBillingUsageRequest, XaiBillingUsageResponse, XaiProvider, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,OAAO,EACP,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,eAAe,EACf,+BAA+B,EAC/B,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,wBAAwB,EACxB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,gBAAgB,EAChB,yBAAyB,EACzB,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,EAC5B,uBAAuB,EACvB,mCAAmC,EACnC,uBAAuB,EACvB,mCAAmC,EACnC,sBAAsB,EACtB,QAAQ,EACR,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,iCAAiC,EACjC,iCAAiC,EACjC,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,2BAA2B,EAC3B,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,6BAA6B,EAC7B,+BAA+B,EAC/B,WAAW,EACX,6BAA6B,EAC7B,qBAAqB,EACrB,0BAA0B,EAC1B,8BAA8B,EAC9B,gCAAgC,EAChC,qBAAqB,EACrB,wCAAwC,EACxC,wCAAwC,EACxC,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/paid-endpoints.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Exact paid-endpoint registry.
+ *
+ * Only endpoints listed here are considered paid. All unlisted endpoints
+ * are assumed free and must preserve current behavior with no caller changes.
+ *
+ * Matching is exact: provider + method + dotPath. No regex, prefix,
+ * wildcard, path-family, generated broad match, or fallback-by-method logic.
+ */
+export interface PaidEndpointKey {
+    provider: string;
+    method: string;
+    dotPath: string;
+}
+export interface PaidEndpointInfo {
+    /** Human-readable reason why this endpoint is paid. */
+    reason: string;
+    /** Optional estimator identifier for cost computation. */
+    estimatorId?: string;
+    /** Optional known cost notes (e.g. per-unit billing details). */
+    costNotes?: string;
+}
+export interface PaidEndpointEntry {
+    key: PaidEndpointKey;
+    info: PaidEndpointInfo;
+}
+/**
+ * The canonical list of paid endpoints. Add new entries here only after
+ * review. Keep the list small and explicit.
+ */
+export declare const PAID_ENDPOINTS: readonly PaidEndpointEntry[];
+/**
+ * Look up a paid endpoint by exact key match.
+ *
+ * Returns `PaidEndpointInfo` only when provider, method, and dotPath all match
+ * an entry in `PAID_ENDPOINTS` exactly. Returns `undefined` for every
+ * unlisted endpoint, which callers must treat as free.
+ */
+export declare function lookupPaidEndpoint(provider: string, method: string, dotPath: string): PaidEndpointInfo | undefined;
+/**
+ * Predicate: is this exact endpoint paid?
+ *
+ * Unlisted endpoints return `false` (assumed free).
+ */
+export declare function isPaidEndpoint(provider: string, method: string, dotPath: string): boolean;
+//# sourceMappingURL=paid-endpoints.d.ts.map

package/dist/src/paid-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paid-endpoints.d.ts","sourceRoot":"","sources":["../../src/paid-endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,eAAe,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,iBAAiB,EAqEtD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,gBAAgB,GAAG,SAAS,CAW9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAET"}

package/dist/src/paid-endpoints.js

@@ -0,0 +1,107 @@
+/**
+ * Exact paid-endpoint registry.
+ *
+ * Only endpoints listed here are considered paid. All unlisted endpoints
+ * are assumed free and must preserve current behavior with no caller changes.
+ *
+ * Matching is exact: provider + method + dotPath. No regex, prefix,
+ * wildcard, path-family, generated broad match, or fallback-by-method logic.
+ */
+/**
+ * The canonical list of paid endpoints. Add new entries here only after
+ * review. Keep the list small and explicit.
+ */
+export const PAID_ENDPOINTS = [
+    {
+        key: {
+            provider: "xai",
+            method: "POST",
+            dotPath: "v1.images.generations",
+        },
+        info: {
+            reason: "Image generation task that incurs direct compute cost",
+            costNotes: "Billed per image based on model and resolution",
+        },
+    },
+    {
+        key: {
+            provider: "xai",
+            method: "POST",
+            dotPath: "v1.images.edits",
+        },
+        info: {
+            reason: "Image edit task that incurs direct compute cost",
+            costNotes: "Billed per image edit based on model and resolution",
+        },
+    },
+    {
+        key: {
+            provider: "xai",
+            method: "POST",
+            dotPath: "v1.videos.generations",
+        },
+        info: {
+            reason: "Video generation task that incurs direct compute cost",
+            costNotes: "Billed per video generation based on duration and model",
+        },
+    },
+    {
+        key: {
+            provider: "xai",
+            method: "POST",
+            dotPath: "v1.videos.generations.imageToVideo",
+        },
+        info: {
+            reason: "Grok Imagine image-to-video generation incurs direct compute cost",
+            costNotes: "Billed per video generation based on duration, resolution, and input image",
+        },
+    },
+    {
+        key: {
+            provider: "xai",
+            method: "POST",
+            dotPath: "v1.videos.edits",
+        },
+        info: {
+            reason: "Video edit task that incurs direct compute cost",
+            costNotes: "Billed per video edit based on duration and model",
+        },
+    },
+    {
+        key: {
+            provider: "xai",
+            method: "POST",
+            dotPath: "v1.videos.extensions",
+        },
+        info: {
+            reason: "Video extension task that incurs direct compute cost",
+            costNotes: "Billed per video extension based on duration and model",
+        },
+    },
+];
+/**
+ * Look up a paid endpoint by exact key match.
+ *
+ * Returns `PaidEndpointInfo` only when provider, method, and dotPath all match
+ * an entry in `PAID_ENDPOINTS` exactly. Returns `undefined` for every
+ * unlisted endpoint, which callers must treat as free.
+ */
+export function lookupPaidEndpoint(provider, method, dotPath) {
+    for (const entry of PAID_ENDPOINTS) {
+        if (entry.key.provider === provider &&
+            entry.key.method === method &&
+            entry.key.dotPath === dotPath) {
+            return entry.info;
+        }
+    }
+    return undefined;
+}
+/**
+ * Predicate: is this exact endpoint paid?
+ *
+ * Unlisted endpoints return `false` (assumed free).
+ */
+export function isPaidEndpoint(provider, method, dotPath) {
+    return lookupPaidEndpoint(provider, method, dotPath) !== undefined;
+}
+//# sourceMappingURL=paid-endpoints.js.map

package/dist/src/paid-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paid-endpoints.js","sourceRoot":"","sources":["../../src/paid-endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D;QACE,GAAG,EAAE;YACH,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,uBAAuB;SACjC;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,uDAAuD;YAC/D,SAAS,EAAE,gDAAgD;SAC5D;KACF;IACD;QACE,GAAG,EAAE;YACH,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,iBAAiB;SAC3B;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,iDAAiD;YACzD,SAAS,EAAE,qDAAqD;SACjE;KACF;IACD;QACE,GAAG,EAAE;YACH,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,uBAAuB;SACjC;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,uDAAuD;YAC/D,SAAS,EAAE,yDAAyD;SACrE;KACF;IACD;QACE,GAAG,EAAE;YACH,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,oCAAoC;SAC9C;QACD,IAAI,EAAE;YACJ,MAAM,EACJ,mEAAmE;YACrE,SAAS,EACP,4EAA4E;SAC/E;KACF;IACD;QACE,GAAG,EAAE;YACH,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,iBAAiB;SAC3B;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,iDAAiD;YACzD,SAAS,EAAE,mDAAmD;SAC/D;KACF;IACD;QACE,GAAG,EAAE;YACH,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,sBAAsB;SAChC;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,sDAAsD;YAC9D,SAAS,EAAE,wDAAwD;SACpE;KACF;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,MAAc,EACd,OAAe;IAEf,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IACE,KAAK,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ;YAC/B,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;YAC3B,KAAK,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,EAC7B,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAAc,EACd,OAAe;IAEf,OAAO,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC;AACrE,CAAC"}

package/dist/src/paygate.d.ts

@@ -0,0 +1,160 @@
+/**
+ * OTP payload schema. An OTP commits to an exact
+ * `(provider, method, dotPath, requestHash)` tuple with an expiry, and is
+ * single-use via its `jti`.
+ */
+export interface PayGateOtpPayload {
+    v: 1;
+    jti: string;
+    provider: string;
+    method: string;
+    dotPath: string;
+    requestHash: `sha256:${string}`;
+    iat: number;
+    exp: number;
+}
+/**
+ * Caller-supplied approval object.
+ */
+export interface PayGateApproval {
+    otp: string;
+}
+/**
+ * Single-use replay ledger. The default is an in-process Set scoped to one
+ * provider instance (see `createReplayStore`). Pass a custom store for
+ * cross-process or persistent replay protection.
+ */
+export interface ReplayStore {
+    has(jti: string): boolean;
+    add(jti: string): void;
+}
+/**
+ * Pay-gate configuration supplied by the code client at construction time
+ * (never by the autonomous caller). Holds the shared HMAC secret used to mint
+ * and verify OTPs. No environment variables, no key files.
+ */
+export interface PayGateConfig {
+    /** Shared HMAC secret. The code client holds it; the AI never sees it. */
+    secret: string;
+    /** Replay ledger. Defaults to an in-process Set, per provider instance. */
+    replayStore?: ReplayStore;
+    /** Clock injection for testing. Defaults to `Date.now`. */
+    now?: () => number;
+}
+/**
+ * Error thrown when the pay gate blocks a request.
+ */
+export declare class PayGateError extends Error {
+    readonly provider: string;
+    readonly method: string;
+    readonly dotPath: string;
+    readonly code: "paygate-not-configured" | "otp-missing" | "otp-malformed" | "otp-invalid-signature" | "otp-expired" | "otp-mismatched-request" | "otp-replayed";
+    constructor(provider: string, method: string, dotPath: string, code: PayGateError["code"], message: string);
+}
+/**
+ * Verification-only error codes — the subset of PayGateError codes that the
+ * pure `verifyOtp` can emit. The shell layer ("paygate-not-configured",
+ * "otp-missing") is handled separately in `dispatchWithPaidGate`.
+ */
+export type VerifyFailureCode = "otp-malformed" | "otp-invalid-signature" | "otp-expired" | "otp-mismatched-request" | "otp-replayed";
+/**
+ * Tagged-union result from the pure `verifyOtp` function.
+ */
+export type VerifyResult = {
+    ok: true;
+    jti: string;
+} | {
+    ok: false;
+    code: VerifyFailureCode;
+    message: string;
+};
+/**
+ * Pure inputs to `verifyOtp`. Every dependency is explicit — no env vars,
+ * no `Date.now()`, no filesystem reads.
+ */
+export interface VerifyOtpInput {
+    nowSeconds: number;
+    secret: string;
+    expected: {
+        provider: string;
+        method: string;
+        dotPath: string;
+    };
+    payloadHash: `sha256:${string}`;
+    otp: string;
+    isJtiConsumed: (jti: string) => boolean;
+}
+/**
+ * Canonicalize a JSON value by sorting object keys recursively.
+ * Arrays preserve order. Non-JSON values (undefined, functions, symbols,
+ * circular references) cause a TypeError so the caller can fail closed.
+ */
+export declare function canonicalizeJson(value: unknown): string;
+/**
+ * Compute SHA-256 of canonical JSON, prefixed with `sha256:`.
+ */
+export declare function canonicalHash(value: unknown): `sha256:${string}`;
+/**
+ * Parse a TTL string like "10m", "1h", "30s", "1d" into seconds.
+ */
+export declare function parseTtl(ttl: string): number;
+/**
+ * Parse an OTP envelope: `<base64url(payloadJson)>.<base64url(signature)>`.
+ * Returns the payload object and raw signature bytes.
+ */
+export declare function parseOtp(otp: string): {
+    payload: PayGateOtpPayload;
+    signature: Buffer;
+};
+/**
+ * Create an in-process, single-use replay store backed by a `Set`.
+ * Scoped to whatever holds the reference (typically one provider instance).
+ */
+export declare function createReplayStore(): ReplayStore;
+/**
+ * The exact endpoint an OTP authorizes, plus the request it is bound to.
+ * `provider`/`method` may be omitted when `dotPath` uniquely identifies a
+ * single paid endpoint (it is resolved from `PAID_ENDPOINTS`).
+ */
+export interface OtpCall {
+    provider?: string;
+    method?: string;
+    dotPath: string;
+    request: Record<string, unknown>;
+    /** Time-to-live as seconds or a string like "10m". Defaults to 10m. */
+    ttl?: string | number;
+}
+/**
+ * Mint an OTP for a specific request, signed with the shared HMAC secret.
+ *
+ * Pure and env-free: the secret is passed explicitly. The OTP binds to the
+ * exact request via its canonical hash, so changing any byte of the request
+ * invalidates the token.
+ */
+export declare function mintOtp(secret: string, call: OtpCall): string;
+/**
+ * Pure verification of an OTP against expected request context.
+ *
+ * Returns a tagged-union `VerifyResult` — never throws. The caller is
+ * responsible for converting `{ ok: false }` into a `PayGateError` at the
+ * boundary.
+ */
+export declare function verifyOtp(input: VerifyOtpInput): VerifyResult;
+/**
+ * Wrap a provider network dispatch with the OTP-based paid-endpoint gate.
+ *
+ * Free/unlisted endpoints return `dispatch()` immediately without OTP or
+ * pay-gate configuration.
+ *
+ * Paid endpoints fail closed: if the pay gate is not configured, or the OTP
+ * is missing, invalid, expired, replayed, or mismatched, the call throws
+ * before dispatch runs. This is the "no bypass" guarantee — a paid call cannot
+ * fire without a configured secret and a valid, human/code-client-minted OTP.
+ *
+ * The OTP jti is consumed BEFORE dispatch. If dispatch later fails for any
+ * reason, the jti remains consumed and the caller must mint a fresh OTP to
+ * retry. This is intentional — without it, a hostile caller could replay an
+ * OTP on every transient failure.
+ */
+export declare function dispatchWithPaidGate<T>(provider: string, method: string, dotPath: string, payload: Record<string, unknown>, approval: PayGateApproval | undefined, dispatch: () => Promise<T>, config?: PayGateConfig): Promise<T>;
+//# sourceMappingURL=paygate.d.ts.map

package/dist/src/paygate.d.ts.map

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