Skip to content

Commit

Permalink
Release 0.1.5
Browse files Browse the repository at this point in the history
  • Loading branch information
fern-api[bot] committed Jul 17, 2024
1 parent 4f2c664 commit fed0a45
Show file tree
Hide file tree
Showing 3 changed files with 50 additions and 11 deletions.
53 changes: 46 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Crossmint TypeScript Library

[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-SDK%20generated%20by%20Fern-brightgreen)](https://github.com/fern-api/fern)
[![npm shield](https://img.shields.io/npm/v/crossmint)](https://www.npmjs.com/package/crossmint)

The Crossmint TypeScript library provides convenient access to the Crossmint API from TypeScript.

Expand All @@ -18,10 +19,10 @@ Instantiate and use the client with the following:
import { CrossmintClient, Crossmint } from "crossmint";

const client = new CrossmintClient({ apiKey: "YOUR_API_KEY" });
await client.headless.createOrder({
await client.checkout.createOrder({
payment: {
method: Crossmint.PaymentZeroMethod.ArbitrumSepolia,
currency: Crossmint.PaymentZeroCurrency.Eth,
method: Crossmint.EvmPaymentMethods.ArbitrumSepolia,
currency: Crossmint.EvmPaymentCurrency.Eth,
},
lineItems: {
collectionLocator: "crossmint:<collectionId>",
Expand All @@ -37,7 +38,7 @@ following namespace:
```typescript
import { Crossmint } from "crossmint";

const request: Crossmint.CreateOrderRequest = {
const request: Crossmint.CheckoutCreateOrderRequest = {
...
};
```
Expand All @@ -51,7 +52,7 @@ will be thrown.
import { CrossmintError } from "crossmint";

try {
await client.headless.createOrder(...);
await client.checkout.createOrder(...);
} catch (err) {
if (err instanceof CrossmintError) {
console.log(err.statusCode);
Expand Down Expand Up @@ -116,7 +117,7 @@ A request is deemed retriable when any of the following HTTP status codes is ret
Use the `maxRetries` request option to configure this behavior.

```typescript
const response = await client.headless.createOrder(..., {
const response = await client.checkout.createOrder(..., {
maxRetries: 0 // override maxRetries at the request level
});
```
Expand All @@ -126,11 +127,49 @@ const response = await client.headless.createOrder(..., {
The SDK defaults to a 60 second timeout. Use the `timeoutInSeconds` option to configure this behavior.

```typescript
const response = await client.headless.createOrder(..., {
const response = await client.checkout.createOrder(..., {
timeoutInSeconds: 30 // override timeout to 30s
});
```

### Aborting Requests

The SDK allows users to abort requests at any point by passing in an abort signal.

```typescript
const controller = new AbortController();
const response = await client.checkout.createOrder(..., {
abortSignal: controller.signal
});
controller.abort(); // aborts the request
```

### Runtime Compatibility

The SDK defaults to `node-fetch` but will use the global fetch client if present. The SDK works in the following
runtimes:

- Node.js 18+
- Vercel
- Cloudflare Workers
- Deno v1.25+
- Bun 1.0+
- React Native

### Customizing Fetch Client

The SDK provides a way for your to customize the underlying HTTP client / Fetch function. If you're running in an
unsupported environment, this provides a way for you to break glass and ensure the SDK works.

```typescript
import { CrossmintClient } from "crossmint";

const client = new CrossmintClient({
...
fetcher: // provide your implementation here
});
```

## Contributing

While we value open-source contributions to this SDK, this library is generated programmatically.
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "crossmint",
"version": "0.1.4",
"version": "0.1.5",
"private": false,
"repository": "https://github.com/fern-demo/crossmint-typescript-sdk",
"main": "./index.js",
Expand Down
6 changes: 3 additions & 3 deletions src/api/resources/checkout/client/Client.ts
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ export class Checkout {
headers: {
"X-Fern-Language": "JavaScript",
"X-Fern-SDK-Name": "crossmint",
"X-Fern-SDK-Version": "0.1.4",
"X-Fern-SDK-Version": "0.1.5",
"X-Fern-Runtime": core.RUNTIME.type,
"X-Fern-Runtime-Version": core.RUNTIME.version,
...(await this._getCustomAuthorizationHeaders()),
Expand Down Expand Up @@ -176,7 +176,7 @@ export class Checkout {
headers: {
"X-Fern-Language": "JavaScript",
"X-Fern-SDK-Name": "crossmint",
"X-Fern-SDK-Version": "0.1.4",
"X-Fern-SDK-Version": "0.1.5",
"X-Fern-Runtime": core.RUNTIME.type,
"X-Fern-Runtime-Version": core.RUNTIME.version,
...(await this._getCustomAuthorizationHeaders()),
Expand Down Expand Up @@ -292,7 +292,7 @@ export class Checkout {
headers: {
"X-Fern-Language": "JavaScript",
"X-Fern-SDK-Name": "crossmint",
"X-Fern-SDK-Version": "0.1.4",
"X-Fern-SDK-Version": "0.1.5",
"X-Fern-Runtime": core.RUNTIME.type,
"X-Fern-Runtime-Version": core.RUNTIME.version,
...(await this._getCustomAuthorizationHeaders()),
Expand Down

0 comments on commit fed0a45

Please sign in to comment.