@tixprotocol/tdp-sdk 0.3.0 → 0.5.0

package/dist/index.js

@@ -1,50 +1,71 @@
 import {
-  AcceptClaimOffersRequestBodySchema,
-  AcceptClaimOffersResponseSchema,
   ApiKeyHeadersSchema,
+  CreateAndSubmitOrderRequestBodySchema,
+  CreateAndSubmitOrderResponseSchema,
   EventPathParametersSchema,
   GetAddressResponseSchema,
-  GetPurchaseStatusResponseSchema,
+  GetOrderResponseSchema,
   IdempotencyKeyAndApiKeyHeadersSchema,
-  MAX_PERMITS_PER_CLAIM_WALLET,
   NoPathParametersSchema,
+  OrderPathParametersSchema,
   PostIntegratorMetadataRequestBodySchema,
   PostTixIndexerIntegratorMetadataResultSchema,
   SignTenantTransactionRequestBodySchema,
   SignTransactionResponseSchema,
   SubmitTenantTransactionRequestBodySchema,
   SubmitTenantTransactionResponseSchema,
-  TicketPathParametersSchema,
+  TransactionPathParametersSchema,
   WalletPathParametersSchema,
   defineClientRoute,
-  requireUniquePermitKeys,
   solanaDataApiClientRoutes,
   tixIndexerReadApiClientRoutes
-} from "./chunk-QXWVXLHK.js";
+} from "./chunk-MZKCWS5T.js";
 import {
-  WalletCustodyApiError
-} from "./chunk-RLIW34CX.js";
+  TdpApiError,
+  TdpResponseValidationError
+} from "./chunk-7IWD2KHF.js";
+
+// src/utils/usdc-cents.ts
+var USDC_DECIMALS = 6;
+var USDC_MINOR_PER_CENT = 10n ** BigInt(USDC_DECIMALS - 2);
+function usdcMinorToCents(usdcMinor) {
+  return (usdcMinor + USDC_MINOR_PER_CENT / 2n) / USDC_MINOR_PER_CENT;
+}
+function centsToUsdcMinor(cents) {
+  return cents * USDC_MINOR_PER_CENT;
+}
+function convertWireUsdcMinorToCents(usdcMinor) {
+  return Number(usdcMinorToCents(BigInt(usdcMinor)));
+}
 
 // src/solana-data-api/create-solana-client.ts
 function createSolanaClient(tixApi) {
   return {
-    getEvent(pathParams, options) {
-      return tixApi(
+    async getEvent(pathParams, options) {
+      const { min_royalty_floor, ...event } = await tixApi(
         {
           route: "get-event-account",
           pathParams
         },
         options
       );
+      return {
+        ...event,
+        min_royalty_floor_cents: convertWireUsdcMinorToCents(min_royalty_floor)
+      };
     },
-    getListing(pathParams, options) {
-      return tixApi(
+    async getListing(pathParams, options) {
+      const { ask_price_minor, ...listing } = await tixApi(
         {
           route: "get-listing-account",
           pathParams
         },
         options
       );
+      return {
+        ...listing,
+        ask_price_cents: convertWireUsdcMinorToCents(ask_price_minor)
+      };
     },
     getPermit(pathParams, options) {
       return tixApi(
@@ -55,22 +76,47 @@ function createSolanaClient(tixApi) {
         options
       );
     },
-    getProtocolConfig(options) {
-      return tixApi(
+    async getProtocolConfig(options) {
+      const {
+        event_registration_fee_minor,
+        permit_fee_minor,
+        p2p_transfer_fee_minor,
+        ...protocolConfig
+      } = await tixApi(
         {
           route: "get-protocol-config-account"
         },
         options
       );
+      return {
+        ...protocolConfig,
+        event_registration_fee_cents: convertWireUsdcMinorToCents(
+          event_registration_fee_minor
+        ),
+        permit_fee_cents: convertWireUsdcMinorToCents(permit_fee_minor),
+        p2p_transfer_fee_cents: convertWireUsdcMinorToCents(
+          p2p_transfer_fee_minor
+        )
+      };
     },
-    getIntegrator(pathParams, options) {
-      return tixApi(
+    async getIntegrator(pathParams, options) {
+      const { integrator, ...account } = await tixApi(
         {
           route: "get-integrator-account",
           pathParams
         },
         options
       );
+      const { balance, ...registration } = integrator;
+      return {
+        ...account,
+        integrator: {
+          ...registration,
+          balance: {
+            amount_cents: convertWireUsdcMinorToCents(balance.amount_minor)
+          }
+        }
+      };
     }
   };
 }
@@ -96,6 +142,14 @@ var responseBodySchemaByRouteKey2 = Object.fromEntries(
   )
 );
 
+// src/routes/create-tdp-api-error-from-route-failure.ts
+function createTdpApiErrorFromRouteFailure(failure) {
+  return failure.kind === "response-validation" ? new TdpResponseValidationError(failure) : new TdpApiError(failure);
+}
+
+// src/routes/execute-client-route.ts
+import { z } from "zod";
+
 // src/utils/join-url-segments.ts
 function joinUrlSegments(baseUrl, path) {
   return `${baseUrl.replace(/\/+$/, "")}/${path.replace(/^\/+/, "")}`;
@@ -113,6 +167,10 @@ async function readResponsePayload(response) {
 }
 
 // src/routes/execute-client-route.ts
+var ErrorResponseBodySchema = z.looseObject({
+  message: z.string(),
+  code: z.string()
+});
 async function executeClientRoute({
   baseApiUrl,
   fetchImpl,
@@ -147,9 +205,16 @@ async function executeClientRoute({
     path,
     status: response.status,
     statusText: response.statusText,
-    payload
+    payload,
+    requestId: response.headers.get("apigw-requestid") ?? void 0
   };
-  if (!response.ok) throw createError({ kind: "http-status", ...failure });
+  if (!response.ok) {
+    throw createError({
+      kind: "http-status",
+      ...failure,
+      code: ErrorResponseBodySchema.pick({ code: true }).safeParse(payload).data?.code
+    });
+  }
   const parsed = route.responseBodySchema.safeParse(payload);
   if (!parsed.success) {
     throw createError({
@@ -163,7 +228,6 @@ async function executeClientRoute({
 
 // src/tix-api/create-tix-api-client.ts
 var SOLANA_DATA_API_PATH_PREFIX = "solana";
-var TIX_INDEXER_API_PATH_PREFIX = "tix-indexer";
 function createTixApiClientForRoutes({
   routes,
   baseApiUrl,
@@ -178,9 +242,9 @@ function createTixApiClientForRoutes({
     queryParams,
     body
   }, { signal } = {}) {
-    const prefix = route in solanaDataApiClientRoutes ? SOLANA_DATA_API_PATH_PREFIX : TIX_INDEXER_API_PATH_PREFIX;
+    const prefix = route in solanaDataApiClientRoutes ? `/${SOLANA_DATA_API_PATH_PREFIX}` : "";
     return executeClientRoute({
-      baseApiUrl: `${baseApiUrl}/${prefix}`,
+      baseApiUrl: `${baseApiUrl}${prefix}`,
       fetchImpl,
       headers,
       signal,
@@ -193,7 +257,7 @@ function createTixApiClientForRoutes({
         "x-api-key": typeof apiKey === "string" ? apiKey : await apiKey(),
         ...additionalHeaders
       },
-      createError: (failure) => new WalletCustodyApiError(failure)
+      createError: createTdpApiErrorFromRouteFailure
     });
   };
 }
@@ -218,17 +282,48 @@ function createTixApiClient({
   });
 }
 
+// src/tix-indexer-api/create-events-client.ts
+function createEventsClient(tixApi) {
+  return {
+    list(queryParams = {}, options) {
+      return tixApi(
+        {
+          route: "get-events",
+          queryParams
+        },
+        options
+      );
+    },
+    get(pathParams, options) {
+      return tixApi(
+        {
+          route: "get-event",
+          pathParams
+        },
+        options
+      );
+    }
+  };
+}
+
 // src/tix-indexer-api/create-indexer-client.ts
 function createIndexerClient(tixApi) {
   return {
-    listActiveListings(queryParams = {}, options) {
-      return tixApi(
+    async listActiveListings(queryParams, options) {
+      const { items, next_cursor } = await tixApi(
         {
           route: "get-active-listings",
           queryParams
         },
         options
       );
+      return {
+        items: items.map(({ ask_price_minor, ...listing }) => ({
+          ...listing,
+          ask_price_cents: ask_price_minor === null ? null : convertWireUsdcMinorToCents(ask_price_minor)
+        })),
+        next_cursor
+      };
     },
     listUpcomingEvents(queryParams = {}, options) {
       return tixApi(
@@ -255,14 +350,29 @@ function createIndexerClient(tixApi) {
   };
 }
 
+// src/tix-indexer-api/create-integrator-client.ts
+function createIntegratorClient(tixApi) {
+  return {
+    getInfo(options) {
+      return tixApi(
+        {
+          route: "get-integrator"
+        },
+        options
+      );
+    }
+  };
+}
+
 // ../tdp-schemas/src/wallet-custody/api-key-route-keys.ts
 var GET_USER_ADDRESS_ROUTE_KEY = "GET /wallets/users/{subject}/address";
 var GET_INTEGRATOR_ADDRESS_ROUTE_KEY = "GET /wallets/integrators/{subject}/address";
 var SIGN_USER_TRANSACTION_ROUTE_KEY = "POST /wallets/users/{subject}/signatures";
 var SIGN_INTEGRATOR_TRANSACTION_ROUTE_KEY = "POST /wallets/integrators/{subject}/signatures";
 var SUBMIT_TENANT_TRANSACTION_ROUTE_KEY = "POST /transactions/submissions";
-var ACCEPT_CLAIM_OFFERS_ROUTE_KEY = "POST /claim_wallets";
-var GET_PURCHASE_STATUS_ROUTE_KEY = "GET /claim_wallets/purchase-status";
+var GET_TRANSACTION_ROUTE_KEY = "GET /transactions/{id}";
+var CREATE_AND_SUBMIT_ORDER_ROUTE_KEY = "POST /orders";
+var GET_ORDER_ROUTE_KEY = "GET /orders/{id}";
 var GET_FEE_PAYER_ADDRESS_ROUTE_KEY = "GET /wallets/fee-payer/address";
 var GET_PROTOCOL_AUTHORITY_ADDRESS_ROUTE_KEY = "GET /wallets/protocol-authority/address";
 
@@ -316,24 +426,33 @@ var apiKeyWalletCustodyApiClientRoutes = {
     requestBodySchema: SubmitTenantTransactionRequestBodySchema,
     responseBodySchema: SubmitTenantTransactionResponseSchema
   }),
-  "get-purchase-status": defineClientRoute({
-    name: "get-purchase-status",
+  "get-transaction": defineClientRoute({
+    name: "get-transaction",
     method: "GET",
-    routeKey: GET_PURCHASE_STATUS_ROUTE_KEY,
-    pathParamsSchema: NoPathParametersSchema,
-    buildPath: ({ baseApiUrl = "" }) => `${baseApiUrl}/claim_wallets/purchase-status`,
-    headersSchema: IdempotencyKeyAndApiKeyHeadersSchema,
-    responseBodySchema: GetPurchaseStatusResponseSchema
+    routeKey: GET_TRANSACTION_ROUTE_KEY,
+    pathParamsSchema: TransactionPathParametersSchema,
+    buildPath: ({ baseApiUrl = "", id }) => `${baseApiUrl}/transactions/${id}`,
+    headersSchema: ApiKeyHeadersSchema,
+    responseBodySchema: SubmitTenantTransactionResponseSchema
+  }),
+  "get-order": defineClientRoute({
+    name: "get-order",
+    method: "GET",
+    routeKey: GET_ORDER_ROUTE_KEY,
+    pathParamsSchema: OrderPathParametersSchema,
+    buildPath: ({ baseApiUrl = "", id }) => `${baseApiUrl}/orders/${encodeURIComponent(id)}`,
+    headersSchema: ApiKeyHeadersSchema,
+    responseBodySchema: GetOrderResponseSchema
   }),
-  "accept-claim-offers": defineClientRoute({
-    name: "accept-claim-offers",
+  "create-and-submit-order": defineClientRoute({
+    name: "create-and-submit-order",
     method: "POST",
-    routeKey: ACCEPT_CLAIM_OFFERS_ROUTE_KEY,
+    routeKey: CREATE_AND_SUBMIT_ORDER_ROUTE_KEY,
     pathParamsSchema: NoPathParametersSchema,
-    buildPath: ({ baseApiUrl = "" }) => `${baseApiUrl}/claim_wallets`,
+    buildPath: ({ baseApiUrl = "" }) => `${baseApiUrl}/orders`,
     headersSchema: IdempotencyKeyAndApiKeyHeadersSchema,
-    requestBodySchema: AcceptClaimOffersRequestBodySchema,
-    responseBodySchema: AcceptClaimOffersResponseSchema
+    requestBodySchema: CreateAndSubmitOrderRequestBodySchema,
+    responseBodySchema: CreateAndSubmitOrderResponseSchema
   }),
   "get-fee-payer-address": defineClientRoute({
     name: "get-fee-payer-address",
@@ -359,7 +478,7 @@ var apiKeyWalletCustodyApiClientRoutes = {
 function executeWalletCustodyRoute(request) {
   return executeClientRoute({
     ...request,
-    createError: (failure) => new WalletCustodyApiError(failure)
+    createError: createTdpApiErrorFromRouteFailure
   });
 }
 
@@ -393,88 +512,34 @@ function createWalletCustodyApiClient({
   };
 }
 
-// src/wallet-custody/create-claim-wallets-client.ts
-import { z } from "zod";
-
-// src/wallet-custody/resolve-claim-offer.ts
-async function resolveClaimOffer(solana, ticket, protocol, eventResponse, options) {
-  const [listing, event, permit] = await Promise.all([
-    solana.getListing(ticket, options),
-    eventResponse,
-    solana.getPermit(ticket, options)
-  ]);
-  return {
-    event_id: listing.event_id,
-    ticket_id: listing.ticket_id,
-    permit_version: listing.permit_version,
-    seller_payout: listing.payout_ata,
-    royalty_destinations: event.royalty_recipients_count > 0 ? event.royalty_recipients.slice(0, event.royalty_recipients_count).map(({ destination }) => destination) : [protocol.default_royalty_vault],
-    ticket_type_config: permit.ticket_type_config,
-    usdc_mint: protocol.usdc_mint
-  };
-}
-
-// src/wallet-custody/create-claim-wallets-client.ts
-var AcceptOffersBodySchema = AcceptClaimOffersRequestBodySchema.extend({
-  offers: z.array(TicketPathParametersSchema).min(1).max(MAX_PERMITS_PER_CLAIM_WALLET).superRefine(requireUniquePermitKeys)
-});
-function createClaimWalletsClient(walletCustodyApi, solana) {
+// src/wallet-custody/create-orders-client.ts
+function createOrdersClient(walletCustodyApi) {
   return {
-    getPurchaseStatus({
-      idempotencyKey
-    }, options) {
-      return walletCustodyApi(
-        { route: "get-purchase-status", idempotencyKey },
-        options
-      );
-    },
-    async acceptOffers({
+    /** Creates the order and submits its purchase in the same call. */
+    createAndSubmit({
       idempotencyKey,
       body
     }, options) {
-      const parsedBody = AcceptOffersBodySchema.parse(body);
-      const protocol = await solana.getProtocolConfig(options);
-      const events = /* @__PURE__ */ new Map();
-      const offers = await Promise.all(
-        parsedBody.offers.map((ticket) => {
-          const eventId = String(ticket.eventId);
-          const event = events.get(eventId) ?? solana.getEvent({ eventId }, options);
-          events.set(eventId, event);
-          return resolveClaimOffer(solana, ticket, protocol, event, options);
-        })
-      );
       return walletCustodyApi(
-        {
-          route: "accept-claim-offers",
-          body: { ...parsedBody, offers },
-          idempotencyKey
-        },
+        { route: "create-and-submit-order", body, idempotencyKey },
         options
       );
+    },
+    get(pathParams, options) {
+      return walletCustodyApi({ route: "get-order", pathParams }, options);
     }
   };
 }
 
+// src/wallet-custody/const.ts
+var INTEGRATOR_PRIMARY_ADDRESS_SUBJECT = "PRIMARY_ADDRESS";
+
 // src/wallet-custody/create-transactions-client.ts
 function createTransactionsClient(walletCustodyApi) {
   return {
-    signUser({
-      subject,
-      idempotencyKey,
-      body
-    }, options) {
-      return walletCustodyApi(
-        {
-          route: "sign-user-transaction",
-          pathParams: { subject },
-          body,
-          idempotencyKey
-        },
-        options
-      );
-    },
+    /** A `subject` is not necessary. */
     signIntegrator({
-      subject,
+      subject = INTEGRATOR_PRIMARY_ADDRESS_SUBJECT,
       idempotencyKey,
       body
     }, options) {
@@ -514,11 +579,14 @@ function createWalletClient(walletCustodyApi) {
         options
       );
     },
-    getIntegratorAddress(pathParams, options) {
+    /** A `subject` is not necessary. */
+    getIntegratorAddress({
+      subject = INTEGRATOR_PRIMARY_ADDRESS_SUBJECT
+    } = {}, options) {
       return walletCustodyApi(
         {
           route: "get-integrator-address",
-          pathParams
+          pathParams: { subject }
         },
         options
       );
@@ -549,10 +617,13 @@ function createTdpClient(options) {
   const solana = createSolanaClient(tixApi);
   return {
     solana,
+    events: createEventsClient(tixApi),
     indexer: createIndexerClient(tixApi),
+    integrator: createIntegratorClient(tixApi),
     wallets: createWalletClient(walletCustodyApi),
     transactions: createTransactionsClient(walletCustodyApi),
-    claimWallets: createClaimWalletsClient(walletCustodyApi, solana)
+    orders: createOrdersClient(walletCustodyApi),
+    utils: { usdcMinorToCents, centsToUsdcMinor }
   };
 }
 export {