@vansite/ts-sharetribe-flex-sdk 1.0.34 → 2.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 ![TypeScript](https://img.shields.io/badge/TypeScript-4.x-blue)
 ![MIT License](https://img.shields.io/badge/license-MIT-green)
-![Version](https://img.shields.io/badge/version-1.0.34-blue)
+![Version](https://img.shields.io/badge/version-2.0.0-blue)
 
 This is a **TypeScript SDK** for the [Sharetribe Flex API](https://www.sharetribe.com/api-reference/). It simplifies interaction with the API, providing a more user-friendly and intuitive interface for developers and reduces the size of the SDK.
 

package/dist/endpoints/assets/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Provides the AssetsApi class for interacting with the Sharetribe Asset Delivery API.
+ *
+ * @see https://www.sharetribe.com/api-reference/asset-delivery-api.html
+ */
+import type { AxiosResponse } from "axios";
+import SharetribeSdk from "../../sdk";
+import { AssetByAliasParameter, AssetByVersionParameter, AssetResponse, AssetsByAliasParameter, AssetsByVersionParameter } from "../../types";
+declare class AssetsApi {
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(sdk: SharetribeSdk);
+    /**
+     * Fetch a single asset by alias (e.g. "latest")
+     *
+     * @template P
+     * @param {P & AssetByAliasParameter} params
+     * @returns {Promise<AxiosResponse<AssetResponse<"assetByAlias", P & AssetByAliasParameter>>>}
+     */
+    assetByAlias<P extends AssetByAliasParameter>(params: P & AssetByAliasParameter): Promise<AxiosResponse<AssetResponse<"assetByAlias", P & AssetByAliasParameter>>>;
+    /**
+     * Fetch multiple assets by alias from the same directory
+     *
+     * @template P
+     * @param {P & AssetsByAliasParameter} params
+     * @returns {Promise<AxiosResponse<AssetResponse<"assetsByAlias", P & AssetsByAliasParameter>>>}
+     */
+    assetsByAlias<P extends AssetsByAliasParameter>(params: P & AssetsByAliasParameter): Promise<AxiosResponse<AssetResponse<"assetsByAlias", P & AssetsByAliasParameter>>>;
+    /**
+     * Fetch a single asset by version
+     *
+     * @template P
+     * @param {P & AssetByVersionParameter} params
+     * @returns {Promise<AxiosResponse<AssetResponse<"assetByVersion", P & AssetByVersionParameter>>>}
+     */
+    assetByVersion<P extends AssetByVersionParameter>(params: P & AssetByVersionParameter): Promise<AxiosResponse<AssetResponse<"assetByVersion", P & AssetByVersionParameter>>>;
+    /**
+     * Fetch multiple assets by version from the same directory
+     *
+     * @template P
+     * @param {P & AssetsByVersionParameter} params
+     * @returns {Promise<AxiosResponse<AssetResponse<"assetsByVersion", P & AssetsByVersionParameter>>>}
+     */
+    assetsByVersion<P extends AssetsByVersionParameter>(params: P & AssetsByVersionParameter): Promise<AxiosResponse<AssetResponse<"assetsByVersion", P & AssetsByVersionParameter>>>;
+}
+export default AssetsApi;

package/dist/endpoints/auth/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Client for Sharetribe Authentication API (OAuth2)
+ *
+ * @see https://www.sharetribe.com/api-reference/authentication.html
+ */
+import type { AxiosResponse } from "axios";
+import SharetribeSdk from "../../sdk";
+import IntegrationSdk from "../../integrationSdk";
+import { AuthWithIdpParameter, RevokeResponse, TokenDetails, TokenRequest, TokenResponse, UserTokenRequest } from "../../types";
+/**
+ * Encodes object as application/x-www-form-urlencoded
+ */
+export declare const urlEncodeFormData: (obj: Record<string, any> | null) => string;
+declare class AuthenticationApi {
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(sdk: SharetribeSdk | IntegrationSdk);
+    /**
+     * Request a token using any supported OAuth2 grant
+     *
+     * @template T - Token request type
+     * @param {T} params - OAuth2 token request parameters
+     * @returns {Promise<AxiosResponse<TokenResponse<T>>>}
+     */
+    token<T extends TokenRequest>(params: T): Promise<AxiosResponse<TokenResponse<T>>>;
+    /**
+     * Authenticate via external Identity Provider
+     *
+     * @param {AuthWithIdpParameter} params
+     * @returns {Promise<AxiosResponse<TokenResponse<UserTokenRequest>>>}
+     */
+    authWithIdp(params: AuthWithIdpParameter): Promise<AxiosResponse<TokenResponse<UserTokenRequest>>>;
+    /**
+     * Revoke a refresh token
+     *
+     * @param {string} token - Refresh token to revoke
+     */
+    revoke(token: string): Promise<AxiosResponse<RevokeResponse>>;
+    /**
+     * Introspect current access token
+     */
+    details(): Promise<AxiosResponse<TokenDetails>>;
+}
+export default AuthenticationApi;

package/dist/endpoints/integrationApi/AvailabilityExceptions.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Client for managing availability exceptions in the Sharetribe Integration API.
+ *
+ * Availability exceptions override default availability rules for specific time ranges
+ * (e.g. blocking off dates for maintenance or special events).
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#availability-exceptions
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { AvailabilityExceptionsCreateParameter, AvailabilityExceptionsDeleteParameter, AvailabilityExceptionsQueryParameter, AvailabilityExceptionsResponse, ExtraParameter } from "../../types";
+/**
+ * Availability exceptions API client
+ */
+declare class AvailabilityExceptions {
+    readonly authRequired = true;
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Query availability exceptions
+     *
+     * @template P
+     * @param {P & AvailabilityExceptionsQueryParameter} params
+     * @returns {Promise<AxiosResponse<AvailabilityExceptionsResponse<"query", P>>>}
+     *
+     * @example
+     * const { data } = await sdk.availabilityExceptions.query({
+     *   listingId: "123-abc",
+     *   start: "2025-01-01",
+     *   end: "2025-01-31"
+     * });
+     */
+    query<P extends AvailabilityExceptionsQueryParameter>(params: P): Promise<AxiosResponse<AvailabilityExceptionsResponse<"query", P>>>;
+    /**
+     * Create a new availability exception
+     *
+     * @template P
+     * @template EP
+     * @param {P & AvailabilityExceptionsCreateParameter} params
+     * @param {EP} [extraParams] - Optional extra parameters (e.g. expand)
+     * @returns {Promise<AxiosResponse<AvailabilityExceptionsResponse<"create", P, EP>>>}
+     *
+     * @example
+     * await sdk.availabilityExceptions.create({
+     *   listingId: "123-abc",
+     *   start: "2025-12-24",
+     *   end: "2025-12-26",
+     *   seats: 0
+     * });
+     */
+    create<P extends AvailabilityExceptionsCreateParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<AvailabilityExceptionsResponse<"create", P, EP>>>;
+    /**
+     * Delete an availability exception
+     *
+     * @template P
+     * @param {P & AvailabilityExceptionsDeleteParameter} params
+     * @returns {Promise<AxiosResponse<AvailabilityExceptionsResponse<"delete", P>>>}
+     *
+     * @example
+     * await sdk.availabilityExceptions.delete({ id: "exc-456-def" });
+     */
+    delete<P extends AvailabilityExceptionsDeleteParameter>(params: P): Promise<AxiosResponse<AvailabilityExceptionsResponse<"delete", P>>>;
+}
+export default AvailabilityExceptions;

package/dist/endpoints/integrationApi/Events.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Client for querying events in the Sharetribe Integration API.
+ *
+ * The Events API provides a stream of marketplace events (e.g. listing created, transaction transitioned)
+ * for building integrations, webhooks, analytics, or real-time features.
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#events
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { EventsQueryParameter, EventsResponse } from "../../types";
+/**
+ * Events API client
+ */
+declare class Events {
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Query marketplace events
+     *
+     * @template P
+     * @param {P & EventsQueryParameter} params - Query filters and pagination
+     * @returns {Promise<AxiosResponse<EventsResponse<"query">>>}
+     *
+     * @example
+     * // Fetch events after a specific sequence ID
+     * const response = await sdk.events.query({
+     *   startAfterSequenceId: 12345,
+     *   eventTypes: ["transaction/initiated", "booking/created"]
+     * });
+     *
+     * @example
+     * // Fetch recent events for a specific listing
+     * await sdk.events.query({
+     *   resourceId: "listing-abc-123",
+     *   createdAtStart: "2025-01-01T00:00:00Z"
+     * });
+     */
+    query<P extends EventsQueryParameter>(params: P): Promise<AxiosResponse<EventsResponse<"query">>>;
+}
+export default Events;

package/dist/endpoints/integrationApi/Images.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Client for uploading images in the Sharetribe Integration API.
+ *
+ * Images uploaded via this endpoint can be attached to listings, user profiles, or used as assets.
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#images
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { ExtraParameter, ImagesResponse, ImagesUploadParameter } from "../../types";
+/**
+ * Images API client
+ */
+declare class Images {
+    readonly authRequired = true;
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Upload an image
+     *
+     * @template P
+     * @template EP
+     * @param {P & ImagesUploadParameter} params - Upload parameters (must include `image: File`)
+     * @param {EP} [extraParams] - Optional extra parameters (e.g. `expand: true`)
+     * @returns {Promise<AxiosResponse<ImagesResponse<"upload", EP>>>}
+     *
+     * @example
+     * const file = input.files[0];
+     * const { data } = await sdk.images.upload({ image: file });
+     * console.log(data.id); // → "img-abc123"
+     */
+    upload<P extends ImagesUploadParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<ImagesResponse<"upload", EP>>>;
+}
+export default Images;

package/dist/endpoints/integrationApi/Listings.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Client for managing listings in the Sharetribe Integration API.
+ *
+ * This privileged API allows creating, updating, querying, approving, opening, and closing listings
+ * on behalf of users — typically used by admin tools, onboarding flows, or backend services.
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#listings
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { ExtraParameter, ListingsApproveParameter, ListingsCloseParameter, ListingsCreateParameter, ListingsOpenParameter, ListingsQueryParameter, ListingsResponse, ListingsShowParameter, ListingsUpdateParameter } from "../../types";
+/**
+ * Listings API client (privileged)
+ */
+declare class Listings {
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Fetch a single listing by ID
+     *
+     * @template P
+     * @param {P & ListingsShowParameter} params
+     * @returns {Promise<AxiosResponse<ListingsResponse<"show", P>>>}
+     */
+    show<P extends ListingsShowParameter>(params: P): Promise<AxiosResponse<ListingsResponse<"show", P>>>;
+    /**
+     * Query listings with filters
+     *
+     * @template P
+     * @param {P & ListingsQueryParameter} params
+     * @returns {Promise<AxiosResponse<ListingsResponse<"query", P>>>}
+     */
+    query<P extends ListingsQueryParameter>(params: P): Promise<AxiosResponse<ListingsResponse<"query", P>>>;
+    /**
+     * Create a new listing
+     *
+     * @template P
+     * @template EP
+     * @param {P & ListingsCreateParameter} params
+     * @param {EP} [extraParams] - Optional extra parameters (e.g. `expand: true`)
+     * @returns {Promise<AxiosResponse<ListingsResponse<"create", P, EP>>>}
+     */
+    create<P extends ListingsCreateParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<ListingsResponse<"create", P, EP>>>;
+    /**
+     * Update an existing listing
+     *
+     * @template P
+     * @template EP
+     * @param {P & ListingsUpdateParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<ListingsResponse<"update", P, EP>>>}
+     */
+    update<P extends ListingsUpdateParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<ListingsResponse<"update", P, EP>>>;
+    /**
+     * Close a listing
+     *
+     * @template P
+     * @template EP
+     * @param {P & ListingsCloseParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<ListingsResponse<"close", P, EP>>>}
+     */
+    close<P extends ListingsCloseParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<ListingsResponse<"close", P, EP>>>;
+    /**
+     * Open a previously closed listing
+     *
+     * @template P
+     * @template EP
+     * @param {P & ListingsOpenParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<ListingsResponse<"open", P, EP>>>}
+     */
+    open<P extends ListingsOpenParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<ListingsResponse<"open", P, EP>>>;
+    /**
+     * Approve a pending listing (admin only)
+     *
+     * @template P
+     * @template EP
+     * @param {P & ListingsApproveParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<ListingsResponse<"approve", P, EP>>>}
+     */
+    approve<P extends ListingsApproveParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<ListingsResponse<"approve", P, EP>>>;
+}
+export default Listings;

package/dist/endpoints/integrationApi/Marketplace.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Client for fetching marketplace configuration in the Sharetribe Integration API.
+ *
+ * Use this to retrieve metadata about the marketplace (name, description, currency, etc.).
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#marketplace
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { MarketplaceResponse } from "../../types";
+/**
+ * Marketplace API client
+ */
+declare class Marketplace {
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Fetch current marketplace configuration
+     *
+     * @returns {Promise<AxiosResponse<MarketplaceResponse<"show">>>}
+     *
+     * @example
+     * const { data } = await sdk.marketplace.show();
+     * console.log(data.attributes.name); // → "My Awesome Marketplace"
+     */
+    show(): Promise<AxiosResponse<MarketplaceResponse<"show">>>;
+}
+export default Marketplace;

package/dist/endpoints/integrationApi/Stock.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Client for managing stock levels in the Sharetribe Integration API.
+ *
+ * The Stock API provides atomic `compareAndSet` operations to safely update listing stock
+ * in concurrent environments (e.g. during checkout or inventory sync).
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#stock
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { ExtraParameter, StockCompareAndSetParameter, StockResponse } from "../../types";
+/**
+ * Stock API client (privileged)
+ */
+declare class Stock {
+    readonly authRequired = true;
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Atomically update stock using compare-and-set
+     *
+     * Fails if current stock doesn't match `oldTotal` — prevents race conditions.
+     *
+     * @template P
+     * @template EP
+     * @param {P & StockCompareAndSetParameter} params
+     * @param {EP} [extraParams] - Optional extra parameters (e.g. `expand: true`)
+     * @returns {Promise<AxiosResponse<StockResponse<"compareAndSet", EP>>>}
+     *
+     * @example
+     * // Reserve 2 units if current stock is 10
+     * await sdk.stock.compareAndSet({
+     *   listingId: "listing-abc123",
+     *   oldTotal: 10,
+     *   newTotal: 8
+     * });
+     */
+    compareAndSet<P extends StockCompareAndSetParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<StockResponse<"compareAndSet", EP>>>;
+}
+export default Stock;

package/dist/endpoints/integrationApi/StockAdjustments.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Client for managing stock adjustments in the Sharetribe Integration API.
+ *
+ * Stock adjustments are manual changes to listing stock (e.g. restocking, corrections, damage write-offs).
+ * They appear in the stock history and are separate from automatic reservation-based changes.
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#stock-adjustments
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { ExtraParameter, StockAdjustmentsCreateParameter, StockAdjustmentsQueryParameter, StockAdjustmentsResponse } from "../../types";
+/**
+ * Stock Adjustments API client (privileged)
+ */
+declare class StockAdjustments {
+    readonly authRequired = true;
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Query stock adjustment history
+     *
+     * @template P
+     * @param {P & StockAdjustmentsQueryParameter} params
+     * @returns {Promise<AxiosResponse<StockAdjustmentsResponse<"query", P>>>}
+     *
+     * @example
+     * const { data } = await sdk.stockAdjustments.query({
+     *   listingId: "listing-abc123",
+     *   start: "2025-01-01",
+     *   end: "2025-01-31"
+     * });
+     */
+    query<P extends StockAdjustmentsQueryParameter>(params: P): Promise<AxiosResponse<StockAdjustmentsResponse<"query", P>>>;
+    /**
+     * Create a manual stock adjustment
+     *
+     * Positive `quantity` = add stock
+     * Negative `quantity` = remove stock
+     *
+     * @template P
+     * @template EP
+     * @param {P & StockAdjustmentsCreateParameter} params
+     * @param {EP} [extraParams] - Optional extra parameters (e.g. `expand: true`)
+     * @returns {Promise<AxiosResponse<StockAdjustmentsResponse<"create", P, EP>>>}
+     *
+     * @example
+     * // Restock 50 units
+     * await sdk.stockAdjustments.create({
+     *   listingId: "listing-abc123",
+     *   quantity: 50
+     * });
+     *
+     * @example
+     * // Write off 3 damaged units
+     * await sdk.stockAdjustments.create({
+     *   listingId: "listing-abc123",
+     *   quantity: -3
+     * });
+     */
+    create<P extends StockAdjustmentsCreateParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<StockAdjustmentsResponse<"create", P, EP>>>;
+}
+export default StockAdjustments;

package/dist/{types/endpoints/integrationApi/StockReservation.d.ts → endpoints/integrationApi/StockReservations.d.ts}

@@ -7,13 +7,13 @@
  */
 import { AxiosResponse } from "axios";
 import IntegrationApi from "./index";
-import { StockReservationShowParameter, StockReservationsResponse } from "../../types/marketplace/stockReservations";
+import { StockReservationShowParameter, StockReservationsResponse } from "../../types";
 /**
  * Class representing the Stock Reservations API.
  *
  * The Stock Reservations API provides methods to manage stock reservations for marketplace resources.
  */
-declare class StockReservation {
+declare class StockReservations {
     private readonly endpoint;
     private readonly axios;
     private readonly headers;
@@ -39,5 +39,4 @@ declare class StockReservation {
      */
     show<P extends StockReservationShowParameter>(params: P): Promise<AxiosResponse<StockReservationsResponse<"show", P>>>;
 }
-export default StockReservation;
-//# sourceMappingURL=StockReservation.d.ts.map
+export default StockReservations;

package/dist/endpoints/integrationApi/Transactions.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Client for managing transactions in the Sharetribe Integration API.
+ *
+ * This privileged API allows querying, transitioning, and updating metadata for transactions.
+ * Use it for admin tools, backend services, or automated workflows.
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#transactions
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { ExtraParameter, TransactionsQueryParameter, TransactionsResponse, TransactionsShowParameter, TransactionsTransitionParameter, TransactionsTransitionSpeculativeParameter, TransactionsUpdateMetadataParameter } from "../../types";
+/**
+ * Transactions API client (privileged)
+ */
+declare class Transactions {
+    readonly authRequired = true;
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Fetch a single transaction by ID
+     *
+     * @template P
+     * @param {P & TransactionsShowParameter} params
+     * @returns {Promise<AxiosResponse<TransactionsResponse<"show", P>>>}
+     */
+    show<P extends TransactionsShowParameter>(params: P): Promise<AxiosResponse<TransactionsResponse<"show", P>>>;
+    /**
+     * Query transactions with privileged filters
+     *
+     * @template P
+     * @param {P & TransactionsQueryParameter<true>} params - Note: `true` enables privileged fields like `customerId`, `providerId`
+     * @returns {Promise<AxiosResponse<TransactionsResponse<"query", P>>>}
+     */
+    query<P extends TransactionsQueryParameter<true>>(params: P): Promise<AxiosResponse<TransactionsResponse<"query", P>>>;
+    /**
+     * Transition a transaction to a new state
+     *
+     * @template P
+     * @template EP
+     * @param {P & TransactionsTransitionParameter} params
+     * @param {EP} [extraParams] - Optional extra parameters (e.g. `expand: true`)
+     * @returns {Promise<AxiosResponse<TransactionsResponse<"transition", P, EP>>>}
+     *
+     * @example
+     * await sdk.transactions.transition({
+     *   id: "tx-abc123",
+     *   transition: "transition/confirm-payment"
+     * });
+     */
+    transition<P extends TransactionsTransitionParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<TransactionsResponse<"transition", P, EP>>>;
+    /**
+     * Perform a speculative transition (dry-run)
+     *
+     * Does not persist changes — useful for validation before real transition.
+     *
+     * @template P
+     * @template EP
+     * @param {P & TransactionsTransitionSpeculativeParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<TransactionsResponse<"transitionSpeculative", P, EP>>>}
+     */
+    transitionSpeculative<P extends TransactionsTransitionSpeculativeParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<TransactionsResponse<"transitionSpeculative", P, EP>>>;
+    /**
+     * Update transaction metadata
+     *
+     * @template P
+     * @template EP
+     * @param {P & TransactionsUpdateMetadataParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<TransactionsResponse<"updateMetadata", P, EP>>>}
+     */
+    updateMetadata<P extends TransactionsUpdateMetadataParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<TransactionsResponse<"updateMetadata", P, EP>>>;
+}
+export default Transactions;

package/dist/endpoints/integrationApi/Users.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview Client for managing users in the Sharetribe Integration API.
+ *
+ * This privileged API allows querying users, updating profiles, approving accounts,
+ * and managing permissions — typically used by admin tools or backend services.
+ *
+ * @see https://www.sharetribe.com/api-reference/integration.html#users
+ */
+import type { AxiosResponse } from "axios";
+import IntegrationApi from "./index";
+import { ExtraParameter, UsersApproveParameter, UsersQueryParameter, UsersResponse, UsersShowParameter, UsersUpdatePermissionsParameter, UsersUpdateProfileParameter } from "../../types";
+/**
+ * Users API client (privileged)
+ */
+declare class Users {
+    readonly authRequired = true;
+    private readonly axios;
+    private readonly endpoint;
+    private readonly headers;
+    constructor(api: IntegrationApi);
+    /**
+     * Fetch a single user by ID or email
+     *
+     * @template P
+     * @param {P & UsersShowParameter<true>} params - Either `id` or `email` is required
+     * @returns {Promise<AxiosResponse<UsersResponse<"show", P>>>}
+     *
+     * @example
+     * const { data } = await sdk.users.show({ id: "user-abc123" });
+     * const { data: userByEmail } = await sdk.users.show({ email: "john@example.com" });
+     */
+    show<P extends UsersShowParameter<true>>(params: P): Promise<AxiosResponse<UsersResponse<"show", P>>>;
+    /**
+     * Query users with privileged filters
+     *
+     * @template P
+     * @param {P & UsersQueryParameter} params
+     * @returns {Promise<AxiosResponse<UsersResponse<"query", P>>>}
+     */
+    query<P extends UsersQueryParameter>(params: P): Promise<AxiosResponse<UsersResponse<"query", P>>>;
+    /**
+     * Update a user's profile
+     *
+     * @template P
+     * @template EP
+     * @param {P & UsersUpdateProfileParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<UsersResponse<"updateProfile", P, EP>>>}
+     */
+    updateProfile<P extends UsersUpdateProfileParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<UsersResponse<"updateProfile", P, EP>>>;
+    /**
+     * Approve a pending user account
+     *
+     * @template P
+     * @template EP
+     * @param {P & UsersApproveParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<UsersResponse<"approve", P, EP>>>}
+     */
+    approve<P extends UsersApproveParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<UsersResponse<"approve", P, EP>>>;
+    /**
+     * Update a user's permissions
+     *
+     * @template P
+     * @template EP
+     * @param {P & UsersUpdatePermissionsParameter} params
+     * @param {EP} [extraParams]
+     * @returns {Promise<AxiosResponse<UsersResponse<"updatePermissions", P, EP>>>}
+     */
+    updatePermissions<P extends UsersUpdatePermissionsParameter, EP extends ExtraParameter | undefined = undefined>(params: P, extraParams?: EP): Promise<AxiosResponse<UsersResponse<"updatePermissions", P, EP>>>;
+}
+export default Users;