x-twitter-scraper 0.3.2 → 0.4.0

package/resources/guest-wallets.d.mts

@@ -0,0 +1,245 @@
+import { APIResource } from "../core/resource.mjs";
+import * as GuestWalletsAPI from "./guest-wallets.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Accountless prepaid access for paid read endpoints
+ */
+export declare class GuestWallets extends APIResource {
+    /**
+     * Create a one-use Stripe-hosted checkout after the user explicitly confirms a
+     * $10-$250 USD amount. This request creates no charge by itself. The user opens
+     * checkout_url on Stripe. This endpoint returns the paid-read API key without
+     * requiring an Xquik account, email, dashboard, or Xquik web page. An idempotent
+     * replay returns the same key.
+     *
+     * @example
+     * ```ts
+     * const guestWallet = await client.guestWallets.create({
+     *   amount_minor: 1000,
+     *   currency: 'usd',
+     *   'Idempotency-Key': 'e1cb97D8-dDF3-4AaA-ad0a-49E4A0d1CfAa',
+     * });
+     * ```
+     */
+    create(params: GuestWalletCreateParams, options?: RequestOptions): APIPromise<GuestWalletCreateResponse>;
+    /**
+     * Poll after Stripe payment. Use usable to decide whether paid reads can run. An
+     * active wallet can remain usable while a top-up is pending. A new wallet becomes
+     * usable only after verified webhook fulfillment. Send the guest key as
+     * Authorization: Bearer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.guestWallets.retrieveStatus();
+     * ```
+     */
+    retrieveStatus(options?: RequestOptions): APIPromise<GuestWalletRetrieveStatusResponse>;
+    /**
+     * Create a one-use Stripe-hosted checkout for an existing paid-read guest key
+     * after the user explicitly confirms a $10-$250 USD amount. The key remains the
+     * same. This request creates no charge by itself and never redirects through an
+     * Xquik web page.
+     *
+     * @example
+     * ```ts
+     * const response = await client.guestWallets.topup({
+     *   amount_minor: 1000,
+     *   currency: 'usd',
+     *   'Idempotency-Key': 'e1cb97D8-dDF3-4AaA-ad0a-49E4A0d1CfAa',
+     * });
+     * ```
+     */
+    topup(params: GuestWalletTopupParams, options?: RequestOptions): APIPromise<GuestWalletTopupResponse>;
+}
+/**
+ * Confirmed USD amount for a guest wallet purchase.
+ */
+export interface GuestWalletAmount {
+    /**
+     * USD amount in cents. Accepted range is $10-$250.
+     */
+    amount_minor: number;
+    currency: 'usd';
+}
+/**
+ * Initial guest wallet response containing the one-time key.
+ */
+export interface GuestWalletCreateResponse {
+    account_required: false;
+    /**
+     * Confirmed USD amount for a guest wallet purchase.
+     */
+    amount: GuestWalletAmount;
+    /**
+     * Paid-read bearer credential returned only by initial creation. Store it as a
+     * secret. Never place it in a URL or log.
+     */
+    api_key: string;
+    authorization: GuestWalletCreateResponse.Authorization;
+    /**
+     * Raw Stripe-hosted checkout URL for user interaction.
+     */
+    checkout_url: string;
+    credential_notice: 'Store api_key and the Idempotency-Key securely before sharing checkout_url. No email recovery is available.';
+    /**
+     * Usage granted after verified payment.
+     */
+    credits: string;
+    /**
+     * Time when the pending checkout expires.
+     */
+    expires_at: string;
+    instructions: 'Give checkout_url to the user. They must complete payment on Stripe. Never submit payment for them. After payment, poll status_url every poll_after_seconds until latest_purchase.status is no longer pending.';
+    /**
+     * Wait at least this long before polling status_url.
+     */
+    poll_after_seconds: 2;
+    purchase_id: string;
+    requires_user_interaction: true;
+    status: 'creating' | 'pending' | 'paid' | 'expired' | 'failed' | 'refunded' | 'disputed';
+    status_url: 'https://xquik.com/api/v1/guest-wallets/status';
+    wallet_id: string;
+}
+export declare namespace GuestWalletCreateResponse {
+    interface Authorization {
+        header: 'Authorization';
+        scheme: 'Bearer';
+    }
+}
+/**
+ * Current balance, usability, and latest guest purchase state.
+ */
+export interface GuestWalletRetrieveStatusResponse {
+    balance: string;
+    /**
+     * Latest guest wallet purchase fulfillment state.
+     */
+    latest_purchase: GuestWalletRetrieveStatusResponse.LatestPurchase | null;
+    /**
+     * Polling delay while payment is pending. Null means stop.
+     */
+    poll_after_seconds: 2 | null;
+    scope: 'paid_reads';
+    /**
+     * Combined wallet and pending-checkout state. A pending top-up can coexist with
+     * usable true. Terminal expired or failed states require a new guest wallet.
+     */
+    status: 'active' | 'pending' | 'expired' | 'failed' | 'frozen' | 'closed';
+    /**
+     * Top-up action when usable and no checkout is pending.
+     */
+    top_up: GuestWalletRetrieveStatusResponse.TopUp | null;
+    /**
+     * Authoritative paid-read readiness. Use instead of status.
+     */
+    usable: boolean;
+    wallet_id: string;
+}
+export declare namespace GuestWalletRetrieveStatusResponse {
+    /**
+     * Latest guest wallet purchase fulfillment state.
+     */
+    interface LatestPurchase {
+        /**
+         * Confirmed USD amount for a guest wallet purchase.
+         */
+        amount: GuestWalletsAPI.GuestWalletAmount;
+        /**
+         * Present only while the purchase is pending.
+         */
+        checkout_url: string | null;
+        credits: string;
+        expires_at: string;
+        purchase_id: string;
+        status: 'creating' | 'pending' | 'paid' | 'expired' | 'failed' | 'refunded' | 'disputed';
+    }
+    /**
+     * Top-up action when usable and no checkout is pending.
+     */
+    interface TopUp {
+        method: 'POST';
+        path: '/api/v1/guest-wallets/topups';
+    }
+}
+/**
+ * Pending Stripe checkout and guest wallet purchase details.
+ */
+export interface GuestWalletTopupResponse {
+    account_required: false;
+    /**
+     * Confirmed USD amount for a guest wallet purchase.
+     */
+    amount: GuestWalletAmount;
+    /**
+     * Raw Stripe-hosted checkout URL for user interaction.
+     */
+    checkout_url: string;
+    /**
+     * Usage granted after verified payment.
+     */
+    credits: string;
+    /**
+     * Time when the pending checkout expires.
+     */
+    expires_at: string;
+    instructions: 'Give checkout_url to the user. They must complete payment on Stripe. Never submit payment for them. After payment, poll status_url every poll_after_seconds until latest_purchase.status is no longer pending.';
+    /**
+     * Wait at least this long before polling status_url.
+     */
+    poll_after_seconds: 2;
+    purchase_id: string;
+    requires_user_interaction: true;
+    status: 'creating' | 'pending' | 'paid' | 'expired' | 'failed' | 'refunded' | 'disputed';
+    status_url: 'https://xquik.com/api/v1/guest-wallets/status';
+    wallet_id: string;
+    /**
+     * Paid-read bearer credential returned only by initial creation. Store it as a
+     * secret. Never place it in a URL or log.
+     */
+    api_key?: string;
+    authorization?: GuestWalletTopupResponse.Authorization;
+    credential_notice?: 'Store api_key and the Idempotency-Key securely before sharing checkout_url. No email recovery is available.';
+}
+export declare namespace GuestWalletTopupResponse {
+    interface Authorization {
+        header: 'Authorization';
+        scheme: 'Bearer';
+    }
+}
+export interface GuestWalletCreateParams {
+    /**
+     * Body param: Confirmed USD amount in cents.
+     */
+    amount_minor: number;
+    /**
+     * Body param
+     */
+    currency: 'usd';
+    /**
+     * Header param: Generate a cryptographically random UUID v4. Reuse it only to
+     * retry the same wallet and amount request. Initial wallet creation can recover
+     * the API key from this value, so store it as a secret and never log it.
+     */
+    'Idempotency-Key': string;
+}
+export interface GuestWalletTopupParams {
+    /**
+     * Body param: Confirmed USD amount in cents.
+     */
+    amount_minor: number;
+    /**
+     * Body param
+     */
+    currency: 'usd';
+    /**
+     * Header param: Generate a cryptographically random UUID v4. Reuse it only to
+     * retry the same wallet and amount request. Initial wallet creation can recover
+     * the API key from this value, so store it as a secret and never log it.
+     */
+    'Idempotency-Key': string;
+}
+export declare namespace GuestWallets {
+    export { type GuestWalletAmount as GuestWalletAmount, type GuestWalletCreateResponse as GuestWalletCreateResponse, type GuestWalletRetrieveStatusResponse as GuestWalletRetrieveStatusResponse, type GuestWalletTopupResponse as GuestWalletTopupResponse, type GuestWalletCreateParams as GuestWalletCreateParams, type GuestWalletTopupParams as GuestWalletTopupParams, };
+}
+//# sourceMappingURL=guest-wallets.d.mts.map

package/resources/guest-wallets.d.mts.map

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

package/resources/guest-wallets.d.ts

@@ -0,0 +1,245 @@
+import { APIResource } from "../core/resource.js";
+import * as GuestWalletsAPI from "./guest-wallets.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Accountless prepaid access for paid read endpoints
+ */
+export declare class GuestWallets extends APIResource {
+    /**
+     * Create a one-use Stripe-hosted checkout after the user explicitly confirms a
+     * $10-$250 USD amount. This request creates no charge by itself. The user opens
+     * checkout_url on Stripe. This endpoint returns the paid-read API key without
+     * requiring an Xquik account, email, dashboard, or Xquik web page. An idempotent
+     * replay returns the same key.
+     *
+     * @example
+     * ```ts
+     * const guestWallet = await client.guestWallets.create({
+     *   amount_minor: 1000,
+     *   currency: 'usd',
+     *   'Idempotency-Key': 'e1cb97D8-dDF3-4AaA-ad0a-49E4A0d1CfAa',
+     * });
+     * ```
+     */
+    create(params: GuestWalletCreateParams, options?: RequestOptions): APIPromise<GuestWalletCreateResponse>;
+    /**
+     * Poll after Stripe payment. Use usable to decide whether paid reads can run. An
+     * active wallet can remain usable while a top-up is pending. A new wallet becomes
+     * usable only after verified webhook fulfillment. Send the guest key as
+     * Authorization: Bearer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.guestWallets.retrieveStatus();
+     * ```
+     */
+    retrieveStatus(options?: RequestOptions): APIPromise<GuestWalletRetrieveStatusResponse>;
+    /**
+     * Create a one-use Stripe-hosted checkout for an existing paid-read guest key
+     * after the user explicitly confirms a $10-$250 USD amount. The key remains the
+     * same. This request creates no charge by itself and never redirects through an
+     * Xquik web page.
+     *
+     * @example
+     * ```ts
+     * const response = await client.guestWallets.topup({
+     *   amount_minor: 1000,
+     *   currency: 'usd',
+     *   'Idempotency-Key': 'e1cb97D8-dDF3-4AaA-ad0a-49E4A0d1CfAa',
+     * });
+     * ```
+     */
+    topup(params: GuestWalletTopupParams, options?: RequestOptions): APIPromise<GuestWalletTopupResponse>;
+}
+/**
+ * Confirmed USD amount for a guest wallet purchase.
+ */
+export interface GuestWalletAmount {
+    /**
+     * USD amount in cents. Accepted range is $10-$250.
+     */
+    amount_minor: number;
+    currency: 'usd';
+}
+/**
+ * Initial guest wallet response containing the one-time key.
+ */
+export interface GuestWalletCreateResponse {
+    account_required: false;
+    /**
+     * Confirmed USD amount for a guest wallet purchase.
+     */
+    amount: GuestWalletAmount;
+    /**
+     * Paid-read bearer credential returned only by initial creation. Store it as a
+     * secret. Never place it in a URL or log.
+     */
+    api_key: string;
+    authorization: GuestWalletCreateResponse.Authorization;
+    /**
+     * Raw Stripe-hosted checkout URL for user interaction.
+     */
+    checkout_url: string;
+    credential_notice: 'Store api_key and the Idempotency-Key securely before sharing checkout_url. No email recovery is available.';
+    /**
+     * Usage granted after verified payment.
+     */
+    credits: string;
+    /**
+     * Time when the pending checkout expires.
+     */
+    expires_at: string;
+    instructions: 'Give checkout_url to the user. They must complete payment on Stripe. Never submit payment for them. After payment, poll status_url every poll_after_seconds until latest_purchase.status is no longer pending.';
+    /**
+     * Wait at least this long before polling status_url.
+     */
+    poll_after_seconds: 2;
+    purchase_id: string;
+    requires_user_interaction: true;
+    status: 'creating' | 'pending' | 'paid' | 'expired' | 'failed' | 'refunded' | 'disputed';
+    status_url: 'https://xquik.com/api/v1/guest-wallets/status';
+    wallet_id: string;
+}
+export declare namespace GuestWalletCreateResponse {
+    interface Authorization {
+        header: 'Authorization';
+        scheme: 'Bearer';
+    }
+}
+/**
+ * Current balance, usability, and latest guest purchase state.
+ */
+export interface GuestWalletRetrieveStatusResponse {
+    balance: string;
+    /**
+     * Latest guest wallet purchase fulfillment state.
+     */
+    latest_purchase: GuestWalletRetrieveStatusResponse.LatestPurchase | null;
+    /**
+     * Polling delay while payment is pending. Null means stop.
+     */
+    poll_after_seconds: 2 | null;
+    scope: 'paid_reads';
+    /**
+     * Combined wallet and pending-checkout state. A pending top-up can coexist with
+     * usable true. Terminal expired or failed states require a new guest wallet.
+     */
+    status: 'active' | 'pending' | 'expired' | 'failed' | 'frozen' | 'closed';
+    /**
+     * Top-up action when usable and no checkout is pending.
+     */
+    top_up: GuestWalletRetrieveStatusResponse.TopUp | null;
+    /**
+     * Authoritative paid-read readiness. Use instead of status.
+     */
+    usable: boolean;
+    wallet_id: string;
+}
+export declare namespace GuestWalletRetrieveStatusResponse {
+    /**
+     * Latest guest wallet purchase fulfillment state.
+     */
+    interface LatestPurchase {
+        /**
+         * Confirmed USD amount for a guest wallet purchase.
+         */
+        amount: GuestWalletsAPI.GuestWalletAmount;
+        /**
+         * Present only while the purchase is pending.
+         */
+        checkout_url: string | null;
+        credits: string;
+        expires_at: string;
+        purchase_id: string;
+        status: 'creating' | 'pending' | 'paid' | 'expired' | 'failed' | 'refunded' | 'disputed';
+    }
+    /**
+     * Top-up action when usable and no checkout is pending.
+     */
+    interface TopUp {
+        method: 'POST';
+        path: '/api/v1/guest-wallets/topups';
+    }
+}
+/**
+ * Pending Stripe checkout and guest wallet purchase details.
+ */
+export interface GuestWalletTopupResponse {
+    account_required: false;
+    /**
+     * Confirmed USD amount for a guest wallet purchase.
+     */
+    amount: GuestWalletAmount;
+    /**
+     * Raw Stripe-hosted checkout URL for user interaction.
+     */
+    checkout_url: string;
+    /**
+     * Usage granted after verified payment.
+     */
+    credits: string;
+    /**
+     * Time when the pending checkout expires.
+     */
+    expires_at: string;
+    instructions: 'Give checkout_url to the user. They must complete payment on Stripe. Never submit payment for them. After payment, poll status_url every poll_after_seconds until latest_purchase.status is no longer pending.';
+    /**
+     * Wait at least this long before polling status_url.
+     */
+    poll_after_seconds: 2;
+    purchase_id: string;
+    requires_user_interaction: true;
+    status: 'creating' | 'pending' | 'paid' | 'expired' | 'failed' | 'refunded' | 'disputed';
+    status_url: 'https://xquik.com/api/v1/guest-wallets/status';
+    wallet_id: string;
+    /**
+     * Paid-read bearer credential returned only by initial creation. Store it as a
+     * secret. Never place it in a URL or log.
+     */
+    api_key?: string;
+    authorization?: GuestWalletTopupResponse.Authorization;
+    credential_notice?: 'Store api_key and the Idempotency-Key securely before sharing checkout_url. No email recovery is available.';
+}
+export declare namespace GuestWalletTopupResponse {
+    interface Authorization {
+        header: 'Authorization';
+        scheme: 'Bearer';
+    }
+}
+export interface GuestWalletCreateParams {
+    /**
+     * Body param: Confirmed USD amount in cents.
+     */
+    amount_minor: number;
+    /**
+     * Body param
+     */
+    currency: 'usd';
+    /**
+     * Header param: Generate a cryptographically random UUID v4. Reuse it only to
+     * retry the same wallet and amount request. Initial wallet creation can recover
+     * the API key from this value, so store it as a secret and never log it.
+     */
+    'Idempotency-Key': string;
+}
+export interface GuestWalletTopupParams {
+    /**
+     * Body param: Confirmed USD amount in cents.
+     */
+    amount_minor: number;
+    /**
+     * Body param
+     */
+    currency: 'usd';
+    /**
+     * Header param: Generate a cryptographically random UUID v4. Reuse it only to
+     * retry the same wallet and amount request. Initial wallet creation can recover
+     * the API key from this value, so store it as a secret and never log it.
+     */
+    'Idempotency-Key': string;
+}
+export declare namespace GuestWallets {
+    export { type GuestWalletAmount as GuestWalletAmount, type GuestWalletCreateResponse as GuestWalletCreateResponse, type GuestWalletRetrieveStatusResponse as GuestWalletRetrieveStatusResponse, type GuestWalletTopupResponse as GuestWalletTopupResponse, type GuestWalletCreateParams as GuestWalletCreateParams, type GuestWalletTopupParams as GuestWalletTopupParams, };
+}
+//# sourceMappingURL=guest-wallets.d.ts.map

package/resources/guest-wallets.d.ts.map

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

package/resources/guest-wallets.js

@@ -0,0 +1,79 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuestWallets = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+/**
+ * Accountless prepaid access for paid read endpoints
+ */
+class GuestWallets extends resource_1.APIResource {
+    /**
+     * Create a one-use Stripe-hosted checkout after the user explicitly confirms a
+     * $10-$250 USD amount. This request creates no charge by itself. The user opens
+     * checkout_url on Stripe. This endpoint returns the paid-read API key without
+     * requiring an Xquik account, email, dashboard, or Xquik web page. An idempotent
+     * replay returns the same key.
+     *
+     * @example
+     * ```ts
+     * const guestWallet = await client.guestWallets.create({
+     *   amount_minor: 1000,
+     *   currency: 'usd',
+     *   'Idempotency-Key': 'e1cb97D8-dDF3-4AaA-ad0a-49E4A0d1CfAa',
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/guest-wallets', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+            __security: {},
+        });
+    }
+    /**
+     * Poll after Stripe payment. Use usable to decide whether paid reads can run. An
+     * active wallet can remain usable while a top-up is pending. A new wallet becomes
+     * usable only after verified webhook fulfillment. Send the guest key as
+     * Authorization: Bearer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.guestWallets.retrieveStatus();
+     * ```
+     */
+    retrieveStatus(options) {
+        return this._client.get('/guest-wallets/status', {
+            ...options,
+            __security: { apiKeyAuth: true, oauthBearerAuth: true },
+        });
+    }
+    /**
+     * Create a one-use Stripe-hosted checkout for an existing paid-read guest key
+     * after the user explicitly confirms a $10-$250 USD amount. The key remains the
+     * same. This request creates no charge by itself and never redirects through an
+     * Xquik web page.
+     *
+     * @example
+     * ```ts
+     * const response = await client.guestWallets.topup({
+     *   amount_minor: 1000,
+     *   currency: 'usd',
+     *   'Idempotency-Key': 'e1cb97D8-dDF3-4AaA-ad0a-49E4A0d1CfAa',
+     * });
+     * ```
+     */
+    topup(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/guest-wallets/topups', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+            __security: { apiKeyAuth: true, oauthBearerAuth: true },
+        });
+    }
+}
+exports.GuestWallets = GuestWallets;
+//# sourceMappingURL=guest-wallets.js.map

package/resources/guest-wallets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guest-wallets.js","sourceRoot":"","sources":["../src/resources/guest-wallets.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAAmD;AAGnD;;GAEG;AACH,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,MAA+B,EAAE,OAAwB;QAC9D,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACzC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAChF,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CAAC,OAAwB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE;YAC/C,GAAG,OAAO;YACV,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,MAA8B,EAAE,OAAwB;QAC5D,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE;YAChD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAChF,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;CACF;AArED,oCAqEC"}

package/resources/guest-wallets.mjs

@@ -0,0 +1,75 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+/**
+ * Accountless prepaid access for paid read endpoints
+ */
+export class GuestWallets extends APIResource {
+    /**
+     * Create a one-use Stripe-hosted checkout after the user explicitly confirms a
+     * $10-$250 USD amount. This request creates no charge by itself. The user opens
+     * checkout_url on Stripe. This endpoint returns the paid-read API key without
+     * requiring an Xquik account, email, dashboard, or Xquik web page. An idempotent
+     * replay returns the same key.
+     *
+     * @example
+     * ```ts
+     * const guestWallet = await client.guestWallets.create({
+     *   amount_minor: 1000,
+     *   currency: 'usd',
+     *   'Idempotency-Key': 'e1cb97D8-dDF3-4AaA-ad0a-49E4A0d1CfAa',
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/guest-wallets', {
+            body,
+            ...options,
+            headers: buildHeaders([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+            __security: {},
+        });
+    }
+    /**
+     * Poll after Stripe payment. Use usable to decide whether paid reads can run. An
+     * active wallet can remain usable while a top-up is pending. A new wallet becomes
+     * usable only after verified webhook fulfillment. Send the guest key as
+     * Authorization: Bearer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.guestWallets.retrieveStatus();
+     * ```
+     */
+    retrieveStatus(options) {
+        return this._client.get('/guest-wallets/status', {
+            ...options,
+            __security: { apiKeyAuth: true, oauthBearerAuth: true },
+        });
+    }
+    /**
+     * Create a one-use Stripe-hosted checkout for an existing paid-read guest key
+     * after the user explicitly confirms a $10-$250 USD amount. The key remains the
+     * same. This request creates no charge by itself and never redirects through an
+     * Xquik web page.
+     *
+     * @example
+     * ```ts
+     * const response = await client.guestWallets.topup({
+     *   amount_minor: 1000,
+     *   currency: 'usd',
+     *   'Idempotency-Key': 'e1cb97D8-dDF3-4AaA-ad0a-49E4A0d1CfAa',
+     * });
+     * ```
+     */
+    topup(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/guest-wallets/topups', {
+            body,
+            ...options,
+            headers: buildHeaders([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+            __security: { apiKeyAuth: true, oauthBearerAuth: true },
+        });
+    }
+}
+//# sourceMappingURL=guest-wallets.mjs.map

package/resources/guest-wallets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"guest-wallets.mjs","sourceRoot":"","sources":["../src/resources/guest-wallets.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAG/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAGnD;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,MAA+B,EAAE,OAAwB;QAC9D,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACzC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAChF,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CAAC,OAAwB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE;YAC/C,GAAG,OAAO;YACV,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,MAA8B,EAAE,OAAwB;QAC5D,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE;YAChD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAChF,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;CACF"}